@sharpee/chord 3.1.0 → 3.5.0

package/phrasebooks.d.ts

@@ -0,0 +1,28 @@
+/**
+ * phrasebooks.ts — the packaged-phrasebook manifest registry (ADR-250 D3).
+ *
+ * Purpose: compile-time knowledge of the packaged phrasebooks a story may
+ * `use` — name plus covered key list. This is the ADR-215
+ * names-vs-mappings split applied to books: the manifest is DATA the
+ * analyzer reads (so a key supplied only by a used book still passes the
+ * missing-phrase gate), while the loader's data registry carries the
+ * actual entries and is conformance-checked against these keys at load
+ * (mismatch = LoadError). Initially empty — no books ship in this gate;
+ * hosts and tests register through this seam.
+ *
+ * Public interface: PhrasebookManifest, PHRASEBOOK_REGISTRY.
+ * Owner context: @sharpee/chord (language frontend; browser-safe).
+ *
+ * Invariants:
+ * - Keys are story-namespace keys (single kebab-case words) — never
+ *   dotted platform message IDs (ADR-250 D1, David 2026-07-21).
+ */
+export interface PhrasebookManifest {
+    /** Single kebab-case book name (extension-name form). */
+    name: string;
+    /** Story-namespace keys the book covers — the book's documented surface. */
+    keys: string[];
+}
+/** name → manifest. Mutable by design: hosts and tests register here. */
+export declare const PHRASEBOOK_REGISTRY: Map<string, PhrasebookManifest>;
+//# sourceMappingURL=phrasebooks.d.ts.map

package/phrasebooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrasebooks.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/phrasebooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,iCAAwC,CAAC"}

package/phrasebooks.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHRASEBOOK_REGISTRY = void 0;
+/** name → manifest. Mutable by design: hosts and tests register here. */
+exports.PHRASEBOOK_REGISTRY = new Map();
+//# sourceMappingURL=phrasebooks.js.map

package/phrasebooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrasebooks.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/phrasebooks.ts"],"names":[],"mappings":";;;AA0BA,yEAAyE;AAC5D,QAAA,mBAAmB,GAAG,IAAI,GAAG,EAA8B,CAAC"}

package/version.d.ts

@@ -0,0 +1,38 @@
+/**
+ * version.ts — the Chord LANGUAGE version (ADR-257).
+ *
+ * Chord the language carries its own semantic version, **independent of the
+ * `@sharpee/*` lockstep** package version: the `@sharpee/chord` npm package
+ * rides the platform release train (3.x), while this tracks *the language* and
+ * moves only when the author-visible surface changes.
+ *
+ * Hand-maintained — **not** stamped by the release tooling (`tsf version` /
+ * repokit `stampVersions`). Bumped on semver rules (ADR-257 D2): a new construct
+ * or additive syntax → **minor**; a removed/renamed construct or a syntax an
+ * existing story relied on that no longer parses → **major**; a spec/doc
+ * correction with no grammar change → **patch**. Compiler bug fixes, IR-shape
+ * refactors, and platform releases do NOT bump it.
+ *
+ * Distinct from `IR_FORMAT` (ir.ts) — the loader's wire-compat gate. The two move
+ * on different triggers (ADR-257 D3): a purely additive language feature bumps
+ * this version without touching the format. The `chord.ebnf` surface pin
+ * (`tests/language-version.test.ts`, ADR-257 D5) fails the build if the grammar
+ * changes without a bump here.
+ *
+ * **1.1.0 is a recorded one-time override of D2** (ADR-261 Consequences,
+ * 2026-07-23). ADR-261 D4's `use scoring` gate stops previously-valid stories
+ * from compiling, which D2 defines as a *major*; the owner ruled it ships as a
+ * minor anyway rather than amending the rule or softening the gate. The next
+ * construct that stops compiling is still a major unless someone rules
+ * otherwise again — the exception is cross-noted at ADR-257 D2 so it is
+ * discoverable from the rule.
+ *
+ * **1.2.0** adds the `, announce <mode>` suffix on a `use` line (ADR-262 D3) —
+ * purely additive optional grammar, so a minor bump by D2's ordinary rule.
+ *
+ * **1.3.0** adds the `use hunger` body (ADR-263 D1): `grows N each turn`,
+ * `<band> at <n> [says <key>]` rungs, and `fatal at N` — additive grammar, a
+ * minor bump.
+ */
+export declare const CHORD_LANGUAGE_VERSION = "1.3.0";
+//# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC"}

package/version.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHORD_LANGUAGE_VERSION = void 0;
+/**
+ * version.ts — the Chord LANGUAGE version (ADR-257).
+ *
+ * Chord the language carries its own semantic version, **independent of the
+ * `@sharpee/*` lockstep** package version: the `@sharpee/chord` npm package
+ * rides the platform release train (3.x), while this tracks *the language* and
+ * moves only when the author-visible surface changes.
+ *
+ * Hand-maintained — **not** stamped by the release tooling (`tsf version` /
+ * repokit `stampVersions`). Bumped on semver rules (ADR-257 D2): a new construct
+ * or additive syntax → **minor**; a removed/renamed construct or a syntax an
+ * existing story relied on that no longer parses → **major**; a spec/doc
+ * correction with no grammar change → **patch**. Compiler bug fixes, IR-shape
+ * refactors, and platform releases do NOT bump it.
+ *
+ * Distinct from `IR_FORMAT` (ir.ts) — the loader's wire-compat gate. The two move
+ * on different triggers (ADR-257 D3): a purely additive language feature bumps
+ * this version without touching the format. The `chord.ebnf` surface pin
+ * (`tests/language-version.test.ts`, ADR-257 D5) fails the build if the grammar
+ * changes without a bump here.
+ *
+ * **1.1.0 is a recorded one-time override of D2** (ADR-261 Consequences,
+ * 2026-07-23). ADR-261 D4's `use scoring` gate stops previously-valid stories
+ * from compiling, which D2 defines as a *major*; the owner ruled it ships as a
+ * minor anyway rather than amending the rule or softening the gate. The next
+ * construct that stops compiling is still a major unless someone rules
+ * otherwise again — the exception is cross-noted at ADR-257 D2 so it is
+ * discoverable from the rule.
+ *
+ * **1.2.0** adds the `, announce <mode>` suffix on a `use` line (ADR-262 D3) —
+ * purely additive optional grammar, so a minor bump by D2's ordinary rule.
+ *
+ * **1.3.0** adds the `use hunger` body (ADR-263 D1): `grows N each turn`,
+ * `<band> at <n> [says <key>]` rungs, and `fatal at N` — additive grammar, a
+ * minor bump.
+ */
+exports.CHORD_LANGUAGE_VERSION = '1.3.0';
+//# sourceMappingURL=version.js.map

package/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/version.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACU,QAAA,sBAAsB,GAAG,OAAO,CAAC"}