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
99
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

Chosen in three lines

// 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.
// ORE-7-F · Bureau Oracle // STAMP: PENDING
on duty · mead: finite
[ 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. the rest is at prophecy.walnutjs.com.

[ Read the unredacted record ]