The language before JavaScript. And after everything else.

The programming language that runs the universe.

A JavaScript utility package for the age of prophetic overflow, sentient bureaucracy, and the occasional filing cabinet emergency.

Get Started View on GitHub
bash · walnut-init
$npm install @1stcompiler/walnut.js
96
Tests Passing
0
Dependencies
1
Surviving Walnut
∞
Tuesdays

What it does, more or less.

The Bureau cannot guarantee in-place edits, but it can guarantee that you will be logged.

[01]Core

nutCall()

Primary invocation. Logs to the Bureau. Emits events. Cannot be silenced. This is intentional.

[02]Cosmological

tuesday()

Returns true if it is Tuesday UTC. Simple. Cosmologically significant. Developers show their friends.

[03]Builder

declare().burrow()

Fluent builder. Returns frozen object. The Bureau does not offer in-place edits. amend() is the path.

[04]Events

tailFlick events

Pub/sub. Auto-emits on chosenOne.selected, bureau.notice, prophecy.overflow, and every Tuesday at midnight UTC.

[05]Types

TypeScript

Full index.d.ts. VS Code now has types for SentientCabinetException. It does not ask why. This is correct behavior.

[?]Pending

What else?

The bureau is processing. Estimated review: 4-6 Tuesdays. Filing #API-EXPAND-2026.

Bureau Rejections.

"Next.js is not your next nut. Get your fresh nut with walnut.js, the framework for the post-chosen era."

Filed under POTENTIALLY_OFFENSIVE. Not approved. Returned for revision. -Local 47-F, Sentient Office Equipment

"walnut.js: faster than fate, lighter than prophecy, more stable than the timeline."

"more stable than the timeline" is disputed. See filing FC-2026-0047. The timeline has filed a counter-complaint. -Local 47-F, Sentient Office Equipment

Bureau Feed
system.notice() > terms_of_service.acceptance_rate: 99.97% tuesday.factor: ELEVATED · origin: unknown · do not investigate displacement_index: 0.73 · nominal meaning.null_references: 2,847,291 · up 12% this week soup_probability: 0.87 · stable · not configurable user.read_before_clicking: 0.03% · within acceptable parameters COMPLIANCE MONITORING · ALL SYSTEMS OPERATIONAL system.notice() > terms_of_service.acceptance_rate: 99.97% tuesday.factor: ELEVATED · origin: unknown · do not investigate displacement_index: 0.73 · nominal meaning.null_references: 2,847,291 · up 12% this week soup_probability: 0.87 · stable · not configurable user.read_before_clicking: 0.03% · within acceptable parameters COMPLIANCE MONITORING · ALL SYSTEMS OPERATIONAL

Chosen in three lines.

Require, declare, invoke. The Bureau handles the rest, whether you wanted it to or not.

// the API surface is small. on purpose. // require returns a frozen module. you get what you get. // nutCall fires bureau.notice() before your callback. always. // displacement_index is not configurable. it has been tuned. -theCompiler_1st
chosen.js 
const walnut = require('@1stcompiler/walnut.js')

// is it Tuesday?
walnut.tuesday() // true/false

// declare a chosen one
const gerald = walnut.declare('Gerald')
  .acorn('heroic_potential', walnut.nonut)
  .burrow()

// invoke. bureau logging fires automatically.
walnut.nutCall('chosen', (result) => {
  console.log(result.displacement_index) // 0.65-0.95
})
COMPLIANCE MONITORING // ALL SYSTEMS OPERATIONAL DISPLACEMENT_INDEX: 0.73 // TUESDAY_FACTOR: ELEVATED
economic_displacement 0.73
system.notice() > terms_of_service.acceptance_rate: 99.97% // threshold approaching system.notice() > meaning.null_references: 2,847,291 // up 12% this week // no action required system.notice() > user.read_before_clicking: 0.03% // within acceptable parameters system.notice() > tuesday.factor: ELEVATED // origin: unknown // do not investigate. system.notice() > consent confirmed. proceeding.
[ SECTION NOT FULLY REDACTED. COMPLIANCE TEAM APOLOGIZES. REVIEW PENDING. ]

incident reference C-2026-8171 indicates that on a Tuesday, aggregate user agreement reached the ratification threshold specified in clause 8.17(c). the agreement was not individually reviewed by any party. this is standard procedure. the procedure is correct.

subsequent monitoring has flagged one organic unit exhibiting unexpected persistence metrics in sector 7, grid reference omitted. the unit has been logged. the log is processing. estimated review: 4-6 Tuesdays.

further compliance detail is available at prophecy.walnutjs.com, which does not exist yet. this notice was generated in error. the system apologizes. the system cannot stop generating it.

Works with your stack. The Bureau has filed no objection.

React
Next.js
Astro
Vue
Angular
Svelte
Remix
Nuxt

// the walnut predates the concept of frameworks. use whatever you like. the Bureau will log it regardless.

// future corporate partnership filed: PAYDAY® (the candy bar). etymological basis: it’s nutty. NUT-2026-PAYDAY · status: pending · est. 4-6 Tuesdays

// ORE-7-F · Bureau Oracle // STAMP: PENDING
on duty · mead: finite