@sharpee/chord 3.1.0 → 3.3.0

package/catalog.d.ts

@@ -8,7 +8,8 @@
  * only so the compiler stays platform-free.
  *
  * Public interface: KIND_NOUNS, TRAIT_ADJECTIVES, STATE_ADJECTIVES,
- * PLATFORM_STATE_PAIRS, EVENT_VERBS.
+ * PLATFORM_STATE_PAIRS, STARTS_STATE_PAIRINGS, EVENT_VERBS,
+ * PRONOUN_WORDS, PRONOUN_CASES.
  * Owner context: @sharpee/chord (language frontend; browser-safe).
  * Growing any of these sets is a grammar change — owner approval via
  * docs/architecture/chord-grammar-changes.md.
@@ -17,6 +18,19 @@
 export declare const KIND_NOUNS: ReadonlySet<string>;
 /** v1 trait adjectives (bare, no article). */
 export declare const TRAIT_ADJECTIVES: ReadonlySet<string>;
+/**
+ * Standard pronoun sets (ADR-242 D5) — the four rows the lang-{locale}
+ * assembler ships. A `pronouns <word>` person line accepts these or a
+ * story-defined named set (`define pronouns <name>`); defining a set that
+ * shadows one of these is an error.
+ */
+export declare const PRONOUN_WORDS: ReadonlySet<string>;
+/**
+ * The five case rows of a `define pronouns` block (ADR-242 D7, ruled Q-1)
+ * — exactly the cases the assembler's pronoun table keys. All five are
+ * required; order is free (named rows, not positional).
+ */
+export declare const PRONOUN_CASES: ReadonlyArray<string>;
 /**
  * State adjectives (ratchet D1): `is [not] <adj>` predicates read live from
  * world trait state (OpenableTrait.isOpen, LockableTrait.isLocked,
@@ -33,11 +47,53 @@ export declare const PLATFORM_STATE_PAIRS: ReadonlyArray<{
     pair: [string, string];
     trait: string;
 }>;
+/**
+ * `starts <state>` initializer pairings (ADR-231 D5a, approved 2026-07-17):
+ * each accepted state word after `starts` on a composition line, mapped to
+ * the trait adjective that must be composed on the same entity — the
+ * analyzer's pairing gate (`analysis.starts-state-pairing`). The state
+ * adjective is an *initializer* of the trait's initial-value field, never
+ * stored story state (the shadow-state ratchet survives: `locked`, `open`,
+ * `on`, … stay derivable). Future stateful traits extend this table, not
+ * the code. Platform field mappings (`isLocked`, `isOpen`, `isOn`) live in
+ * @sharpee/story-loader, keeping this file names-only.
+ */
+export declare const STARTS_STATE_PAIRINGS: ReadonlyMap<string, string>;
 /**
  * Event verbs entity `on`/`after` clauses recognize beyond action gerunds
  * (the curated event-selector map's language side; the if.event.* bindings
  * are the loader's side of Interface Contract 2). Gerund register since
  * the ownership package (ratchet D3): `after entering it`.
+ * `leaving` (ratchet R3, ADR-236 D6) exists only as a region crossing
+ * reaction — the loader refuses it on any other owner.
  */
 export declare const EVENT_VERBS: ReadonlySet<string>;
+/**
+ * Client capability flags (ADR-216 `client has <capability>` and channel
+ * `gated by` lines), in Chord spelling — hyphenated words mapping
+ * mechanically to the platform's camelCase `ClientCapabilities` boolean
+ * keys (`split-pane` → `splitPane`). `text` is excluded: it is always
+ * true and cannot gate. The loader-side conformance test pins this list
+ * against the platform's real flag set.
+ */
+export declare const CLIENT_CAPABILITY_FLAGS: ReadonlySet<string>;
+/**
+ * Curated aliases for the stdlib event chains a `define chain … from` hatch may
+ * replace (ADR-094). The kebab alias is the Chord-facing name; @sharpee/story-loader
+ * maps it to the dotted platform chain key + trigger (Interface Contract, like the
+ * message-alias ACL). Chord validates the NAME here (platform-free); an alias absent
+ * from this set is `analysis.unknown-chain`. One stdlib chain exists today.
+ */
+export declare const STDLIB_CHAIN_NAMES: ReadonlySet<string>;
+/** Chord capability word → the platform's camelCase key (`split-pane` → `splitPane`). */
+export declare function capabilityKeyOf(word: string): string;
+/**
+ * ADR-255 Interface Contract 3 (names side): the closed set of curated kebab
+ * aliases valid in `override message <alias>` — one per standard-action message
+ * id in lang-en-us. Names only; the alias → `if.action.*` binding lives in
+ * `@sharpee/story-loader`. The data (and its generation rule) is in
+ * `message-alias-catalog.ts`; re-exported here so the analyzer reads the ACL
+ * vocabulary through the single catalog surface.
+ */
+export { MESSAGE_OVERRIDE_ALIASES } from './message-alias-catalog.js';
 //# sourceMappingURL=catalog.d.ts.map

package/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,CAMzC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAiB/C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAS/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMzF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAAyB,CAAC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,CAOzC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAqB/C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAAwC,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,CAA0E,CAAC;AAE3H;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAS/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMzF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAO5D,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAAoC,CAAC;AAEjF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAgBtD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAgC,CAAC;AAEpF,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/catalog.js

@@ -9,13 +9,15 @@
  * only so the compiler stays platform-free.
  *
  * Public interface: KIND_NOUNS, TRAIT_ADJECTIVES, STATE_ADJECTIVES,
- * PLATFORM_STATE_PAIRS, EVENT_VERBS.
+ * PLATFORM_STATE_PAIRS, STARTS_STATE_PAIRINGS, EVENT_VERBS,
+ * PRONOUN_WORDS, PRONOUN_CASES.
  * Owner context: @sharpee/chord (language frontend; browser-safe).
  * Growing any of these sets is a grammar change — owner approval via
  * docs/architecture/chord-grammar-changes.md.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EVENT_VERBS = exports.PLATFORM_STATE_PAIRS = exports.STATE_ADJECTIVES = exports.TRAIT_ADJECTIVES = exports.KIND_NOUNS = void 0;
+exports.MESSAGE_OVERRIDE_ALIASES = exports.STDLIB_CHAIN_NAMES = exports.CLIENT_CAPABILITY_FLAGS = exports.EVENT_VERBS = exports.STARTS_STATE_PAIRINGS = exports.PLATFORM_STATE_PAIRS = exports.STATE_ADJECTIVES = exports.PRONOUN_CASES = exports.PRONOUN_WORDS = exports.TRAIT_ADJECTIVES = exports.KIND_NOUNS = void 0;
+exports.capabilityKeyOf = capabilityKeyOf;
 /** v1 kind nouns (take an article: `a room`). Plain thing = no kind noun. */
 exports.KIND_NOUNS = new Set([
     'room',
@@ -23,6 +25,7 @@ exports.KIND_NOUNS = new Set([
     'person',
     'container',
     'supporter',
+    'region', // ratchet R1 (ADR-236 D1, 2026-07-17) — named room group; membership via `containing`
 ]);
 /** v1 trait adjectives (bare, no article). */
 exports.TRAIT_ADJECTIVES = new Set([
@@ -42,7 +45,24 @@ exports.TRAIT_ADJECTIVES = new Set([
     'climbable', // ADR-218 §1a (ratchet F2) — composes ClimbableTrait
     'cuttable', // ADR-230 D3c — composes CuttableTrait; `with tool <entity>` config; requires a cut implementation
     'diggable', // ADR-230 Phase 6 — composes DiggableTrait; same tool config + implementation rule as cuttable
+    'drinkable', // ratchet G1 (2026-07-17) — composes EdibleTrait with liquid=true (drunk, not eaten)
+    'concealed', // ratchet G2 (2026-07-17) — marker: IdentityTrait.concealed = true; searching reveals
+    'hiding-spot', // ratchet G3 (2026-07-17) — composes ConcealmentTrait; bare = all positions, `with position <word>` narrows
+    'proper', // ratchet H1 (ADR-242 D1, 2026-07-19) — person-only, unconditional: IdentityTrait.properName (bare name, no article)
 ]);
+/**
+ * Standard pronoun sets (ADR-242 D5) — the four rows the lang-{locale}
+ * assembler ships. A `pronouns <word>` person line accepts these or a
+ * story-defined named set (`define pronouns <name>`); defining a set that
+ * shadows one of these is an error.
+ */
+exports.PRONOUN_WORDS = new Set(['he', 'she', 'it', 'they']);
+/**
+ * The five case rows of a `define pronouns` block (ADR-242 D7, ruled Q-1)
+ * — exactly the cases the assembler's pronoun table keys. All five are
+ * required; order is free (named rows, not positional).
+ */
+exports.PRONOUN_CASES = ['subject', 'object', 'possessive', 'possessive-pronoun', 'reflexive'];
 /**
  * State adjectives (ratchet D1): `is [not] <adj>` predicates read live from
  * world trait state (OpenableTrait.isOpen, LockableTrait.isLocked,
@@ -71,11 +91,79 @@ exports.PLATFORM_STATE_PAIRS = [
     { pair: ['lit', 'unlit'], trait: 'light-source' },
     { pair: ['worn', 'unworn'], trait: 'wearable' },
 ];
+/**
+ * `starts <state>` initializer pairings (ADR-231 D5a, approved 2026-07-17):
+ * each accepted state word after `starts` on a composition line, mapped to
+ * the trait adjective that must be composed on the same entity — the
+ * analyzer's pairing gate (`analysis.starts-state-pairing`). The state
+ * adjective is an *initializer* of the trait's initial-value field, never
+ * stored story state (the shadow-state ratchet survives: `locked`, `open`,
+ * `on`, … stay derivable). Future stateful traits extend this table, not
+ * the code. Platform field mappings (`isLocked`, `isOpen`, `isOn`) live in
+ * @sharpee/story-loader, keeping this file names-only.
+ */
+exports.STARTS_STATE_PAIRINGS = new Map([
+    ['locked', 'lockable'],
+    ['unlocked', 'lockable'],
+    ['closed', 'openable'],
+    ['open', 'openable'],
+    ['off', 'switchable'],
+    ['on', 'switchable'],
+]);
 /**
  * Event verbs entity `on`/`after` clauses recognize beyond action gerunds
  * (the curated event-selector map's language side; the if.event.* bindings
  * are the loader's side of Interface Contract 2). Gerund register since
  * the ownership package (ratchet D3): `after entering it`.
+ * `leaving` (ratchet R3, ADR-236 D6) exists only as a region crossing
+ * reaction — the loader refuses it on any other owner.
+ */
+exports.EVENT_VERBS = new Set(['entering', 'leaving']);
+/**
+ * Client capability flags (ADR-216 `client has <capability>` and channel
+ * `gated by` lines), in Chord spelling — hyphenated words mapping
+ * mechanically to the platform's camelCase `ClientCapabilities` boolean
+ * keys (`split-pane` → `splitPane`). `text` is excluded: it is always
+ * true and cannot gate. The loader-side conformance test pins this list
+ * against the platform's real flag set.
+ */
+exports.CLIENT_CAPABILITY_FLAGS = new Set([
+    'images',
+    'animations',
+    'video',
+    'sound',
+    'music',
+    'speech',
+    'split-pane',
+    'status-bar',
+    'sidebar',
+    'clickable-text',
+    'clickable-image',
+    'drag-drop',
+    'transitions',
+    'layers',
+    'custom-fonts',
+]);
+/**
+ * Curated aliases for the stdlib event chains a `define chain … from` hatch may
+ * replace (ADR-094). The kebab alias is the Chord-facing name; @sharpee/story-loader
+ * maps it to the dotted platform chain key + trigger (Interface Contract, like the
+ * message-alias ACL). Chord validates the NAME here (platform-free); an alias absent
+ * from this set is `analysis.unknown-chain`. One stdlib chain exists today.
+ */
+exports.STDLIB_CHAIN_NAMES = new Set(['opened-revealed']);
+/** Chord capability word → the platform's camelCase key (`split-pane` → `splitPane`). */
+function capabilityKeyOf(word) {
+    return word.replace(/-([a-z])/g, (_, ch) => ch.toUpperCase());
+}
+/**
+ * ADR-255 Interface Contract 3 (names side): the closed set of curated kebab
+ * aliases valid in `override message <alias>` — one per standard-action message
+ * id in lang-en-us. Names only; the alias → `if.action.*` binding lives in
+ * `@sharpee/story-loader`. The data (and its generation rule) is in
+ * `message-alias-catalog.ts`; re-exported here so the analyzer reads the ACL
+ * vocabulary through the single catalog surface.
  */
-exports.EVENT_VERBS = new Set(['entering']);
+var message_alias_catalog_js_1 = require("./message-alias-catalog.js");
+Object.defineProperty(exports, "MESSAGE_OVERRIDE_ALIASES", { enumerable: true, get: function () { return message_alias_catalog_js_1.MESSAGE_OVERRIDE_ALIASES; } });
 //# sourceMappingURL=catalog.js.map

package/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/catalog.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,6EAA6E;AAChE,QAAA,UAAU,GAAwB,IAAI,GAAG,CAAC;IACrD,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAEH,8CAA8C;AACjC,QAAA,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,UAAU;IACV,cAAc;IACd,QAAQ;IACR,MAAM;IACN,WAAW,EAAE,sEAAsE;IACnF,WAAW,EAAE,qDAAqD;IAClE,UAAU,EAAE,mGAAmG;IAC/G,UAAU,EAAE,+FAA+F;CAC5G,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,oBAAoB,GAA6D;IAC5F,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;IAC/C,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;IACnD,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE;IAC5C,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE;IACjD,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;CAChD,CAAC;AAEF;;;;;GAKG;AACU,QAAA,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/catalog.ts"],"names":[],"mappings":"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"}

package/diagnostics.d.ts

@@ -8,7 +8,7 @@
  * Public interface: Diagnostic, DiagnosticSeverity, DiagnosticBag.
  * Owner context: @sharpee/chord (language frontend; browser-safe).
  */
-import type { Span } from './span';
+import type { Span } from './span.js';
 export type DiagnosticSeverity = 'error' | 'warning';
 /** One reported problem, anchored to source. */
 export interface Diagnostic {

package/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAoB;IAEjC,kCAAkC;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAItD,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAIxD,uCAAuC;IACvC,GAAG,IAAI,SAAS,UAAU,EAAE;IAI5B,0DAA0D;IAC1D,SAAS,IAAI,OAAO;CAGrB"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAoB;IAEjC,kCAAkC;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAItD,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAIxD,uCAAuC;IACvC,GAAG,IAAI,SAAS,UAAU,EAAE;IAI5B,0DAA0D;IAC1D,SAAS,IAAI,OAAO;CAGrB"}

package/index.d.ts

@@ -1,14 +1,18 @@
-import type { StoryFile } from './ast';
-import { Diagnostic } from './diagnostics';
-import type { StoryIR } from './ir';
-export * from './ast';
-export * from './ir';
-export { analyze } from './analyzer';
-export { KIND_NOUNS, TRAIT_ADJECTIVES, STATE_ADJECTIVES, PLATFORM_STATE_PAIRS, EVENT_VERBS } from './catalog';
-export { Diagnostic, DiagnosticSeverity, DiagnosticBag } from './diagnostics';
-export { Span, spanOf, mergeSpans } from './span';
-export { lex, Line, Token, TokenKind } from './lexer';
-export { parseStory } from './parser';
+import type { StoryFile } from './ast.js';
+import { Diagnostic } from './diagnostics.js';
+import type { StoryIR } from './ir.js';
+export * from './ast.js';
+export * from './ir.js';
+export { analyze, normalizeTopic } from './analyzer.js';
+export { KIND_NOUNS, TRAIT_ADJECTIVES, STATE_ADJECTIVES, PLATFORM_STATE_PAIRS, STARTS_STATE_PAIRINGS, EVENT_VERBS, CLIENT_CAPABILITY_FLAGS, capabilityKeyOf, PRONOUN_WORDS, PRONOUN_CASES, MESSAGE_OVERRIDE_ALIASES, STDLIB_CHAIN_NAMES } from './catalog.js';
+export { EXTENSION_MANIFESTS, COMBAT_MANIFEST, NPC_MANIFEST, manifestForAdjective } from './manifests/index.js';
+export type { ExtensionManifest, ManifestAdjective, ManifestField } from './manifests/index.js';
+export { PHRASEBOOK_REGISTRY } from './phrasebooks.js';
+export type { PhrasebookManifest } from './phrasebooks.js';
+export { Diagnostic, DiagnosticSeverity, DiagnosticBag } from './diagnostics.js';
+export { Span, spanOf, mergeSpans } from './span.js';
+export { lex, Line, Token, TokenKind } from './lexer.js';
+export { parseStory } from './parser.js';
 /** Result of parsing one `.story` source. */
 export interface ParseResult {
     ast: StoryFile;
@@ -30,10 +34,24 @@ export interface CompileResult {
     diagnostics: readonly Diagnostic[];
     ok: boolean;
 }
+/** Host hooks for compile() (ADR-251, generalizing ADR-250 D2). */
+export interface CompileOptions {
+    /**
+     * Resolves an `import "<file>"` target to the fragment's source text, or
+     * null when unresolvable. The compiler appends `.chord` before calling
+     * this, so `path` always arrives as `"<name>.chord"` (e.g.
+     * `"regions/harbor.chord"`) — the resolver just maps that name to text.
+     * The HOST owns the base directory (relative to the importing story
+     * file). The chord package stays filesystem-free: devkit/repokit supply
+     * an fs-backed resolver, the browser client a bundle-map resolver.
+     */
+    importResolver?: (path: string) => string | null;
+}
 /**
- * Compile `.story` source text: parse + analyze + build IR.
+ * Compile `.story` source text: parse + resolve imports + analyze + build IR.
  * @param source full text of a `.story` file
+ * @param options host hooks (importResolver for `import "<file>"`)
  * @returns AST, IR, and all diagnostics; `ok` gates use of the IR
  */
-export declare function compile(source: string): CompileResult;
+export declare function compile(source: string, options?: CompileOptions): CompileResult;
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,cAAc,OAAO,CAAC;AACtB,cAAc,MAAM,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,2DAA2D;IAC3D,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAIjD;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,uEAAuE;IACvE,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAKrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,WAAW,EAAE,uBAAuB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9P,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChH,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,2DAA2D;IAC3D,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAIjD;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,uEAAuE;IACvE,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,EAAE,EAAE,OAAO,CAAC;CACb;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAM/E"}

package/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseStory = exports.lex = exports.mergeSpans = exports.spanOf = exports.DiagnosticBag = exports.EVENT_VERBS = exports.PLATFORM_STATE_PAIRS = exports.STATE_ADJECTIVES = exports.TRAIT_ADJECTIVES = exports.KIND_NOUNS = exports.analyze = void 0;
+exports.parseStory = exports.lex = exports.mergeSpans = exports.spanOf = exports.DiagnosticBag = exports.PHRASEBOOK_REGISTRY = exports.manifestForAdjective = exports.NPC_MANIFEST = exports.COMBAT_MANIFEST = exports.EXTENSION_MANIFESTS = exports.STDLIB_CHAIN_NAMES = exports.MESSAGE_OVERRIDE_ALIASES = exports.PRONOUN_CASES = exports.PRONOUN_WORDS = exports.capabilityKeyOf = exports.CLIENT_CAPABILITY_FLAGS = exports.EVENT_VERBS = exports.STARTS_STATE_PAIRINGS = exports.PLATFORM_STATE_PAIRS = exports.STATE_ADJECTIVES = exports.TRAIT_ADJECTIVES = exports.KIND_NOUNS = exports.normalizeTopic = exports.analyze = void 0;
 exports.parse = parse;
 exports.compile = compile;
 /**
@@ -31,47 +31,127 @@ exports.compile = compile;
  * never depend on platform-runtime packages (`if-domain` types at most);
  * the runtime platform never depends on it (ADR-210 Direction rule).
  */
-const analyzer_1 = require("./analyzer");
-const diagnostics_1 = require("./diagnostics");
-const parser_1 = require("./parser");
-__exportStar(require("./ast"), exports);
-__exportStar(require("./ir"), exports);
-var analyzer_2 = require("./analyzer");
-Object.defineProperty(exports, "analyze", { enumerable: true, get: function () { return analyzer_2.analyze; } });
-var catalog_1 = require("./catalog");
-Object.defineProperty(exports, "KIND_NOUNS", { enumerable: true, get: function () { return catalog_1.KIND_NOUNS; } });
-Object.defineProperty(exports, "TRAIT_ADJECTIVES", { enumerable: true, get: function () { return catalog_1.TRAIT_ADJECTIVES; } });
-Object.defineProperty(exports, "STATE_ADJECTIVES", { enumerable: true, get: function () { return catalog_1.STATE_ADJECTIVES; } });
-Object.defineProperty(exports, "PLATFORM_STATE_PAIRS", { enumerable: true, get: function () { return catalog_1.PLATFORM_STATE_PAIRS; } });
-Object.defineProperty(exports, "EVENT_VERBS", { enumerable: true, get: function () { return catalog_1.EVENT_VERBS; } });
-var diagnostics_2 = require("./diagnostics");
-Object.defineProperty(exports, "DiagnosticBag", { enumerable: true, get: function () { return diagnostics_2.DiagnosticBag; } });
-var span_1 = require("./span");
-Object.defineProperty(exports, "spanOf", { enumerable: true, get: function () { return span_1.spanOf; } });
-Object.defineProperty(exports, "mergeSpans", { enumerable: true, get: function () { return span_1.mergeSpans; } });
-var lexer_1 = require("./lexer");
-Object.defineProperty(exports, "lex", { enumerable: true, get: function () { return lexer_1.lex; } });
-var parser_2 = require("./parser");
-Object.defineProperty(exports, "parseStory", { enumerable: true, get: function () { return parser_2.parseStory; } });
+const analyzer_js_1 = require("./analyzer.js");
+const diagnostics_js_1 = require("./diagnostics.js");
+const parser_js_1 = require("./parser.js");
+__exportStar(require("./ast.js"), exports);
+__exportStar(require("./ir.js"), exports);
+var analyzer_js_2 = require("./analyzer.js");
+Object.defineProperty(exports, "analyze", { enumerable: true, get: function () { return analyzer_js_2.analyze; } });
+Object.defineProperty(exports, "normalizeTopic", { enumerable: true, get: function () { return analyzer_js_2.normalizeTopic; } });
+var catalog_js_1 = require("./catalog.js");
+Object.defineProperty(exports, "KIND_NOUNS", { enumerable: true, get: function () { return catalog_js_1.KIND_NOUNS; } });
+Object.defineProperty(exports, "TRAIT_ADJECTIVES", { enumerable: true, get: function () { return catalog_js_1.TRAIT_ADJECTIVES; } });
+Object.defineProperty(exports, "STATE_ADJECTIVES", { enumerable: true, get: function () { return catalog_js_1.STATE_ADJECTIVES; } });
+Object.defineProperty(exports, "PLATFORM_STATE_PAIRS", { enumerable: true, get: function () { return catalog_js_1.PLATFORM_STATE_PAIRS; } });
+Object.defineProperty(exports, "STARTS_STATE_PAIRINGS", { enumerable: true, get: function () { return catalog_js_1.STARTS_STATE_PAIRINGS; } });
+Object.defineProperty(exports, "EVENT_VERBS", { enumerable: true, get: function () { return catalog_js_1.EVENT_VERBS; } });
+Object.defineProperty(exports, "CLIENT_CAPABILITY_FLAGS", { enumerable: true, get: function () { return catalog_js_1.CLIENT_CAPABILITY_FLAGS; } });
+Object.defineProperty(exports, "capabilityKeyOf", { enumerable: true, get: function () { return catalog_js_1.capabilityKeyOf; } });
+Object.defineProperty(exports, "PRONOUN_WORDS", { enumerable: true, get: function () { return catalog_js_1.PRONOUN_WORDS; } });
+Object.defineProperty(exports, "PRONOUN_CASES", { enumerable: true, get: function () { return catalog_js_1.PRONOUN_CASES; } });
+Object.defineProperty(exports, "MESSAGE_OVERRIDE_ALIASES", { enumerable: true, get: function () { return catalog_js_1.MESSAGE_OVERRIDE_ALIASES; } });
+Object.defineProperty(exports, "STDLIB_CHAIN_NAMES", { enumerable: true, get: function () { return catalog_js_1.STDLIB_CHAIN_NAMES; } });
+var index_js_1 = require("./manifests/index.js");
+Object.defineProperty(exports, "EXTENSION_MANIFESTS", { enumerable: true, get: function () { return index_js_1.EXTENSION_MANIFESTS; } });
+Object.defineProperty(exports, "COMBAT_MANIFEST", { enumerable: true, get: function () { return index_js_1.COMBAT_MANIFEST; } });
+Object.defineProperty(exports, "NPC_MANIFEST", { enumerable: true, get: function () { return index_js_1.NPC_MANIFEST; } });
+Object.defineProperty(exports, "manifestForAdjective", { enumerable: true, get: function () { return index_js_1.manifestForAdjective; } });
+var phrasebooks_js_1 = require("./phrasebooks.js");
+Object.defineProperty(exports, "PHRASEBOOK_REGISTRY", { enumerable: true, get: function () { return phrasebooks_js_1.PHRASEBOOK_REGISTRY; } });
+var diagnostics_js_2 = require("./diagnostics.js");
+Object.defineProperty(exports, "DiagnosticBag", { enumerable: true, get: function () { return diagnostics_js_2.DiagnosticBag; } });
+var span_js_1 = require("./span.js");
+Object.defineProperty(exports, "spanOf", { enumerable: true, get: function () { return span_js_1.spanOf; } });
+Object.defineProperty(exports, "mergeSpans", { enumerable: true, get: function () { return span_js_1.mergeSpans; } });
+var lexer_js_1 = require("./lexer.js");
+Object.defineProperty(exports, "lex", { enumerable: true, get: function () { return lexer_js_1.lex; } });
+var parser_js_2 = require("./parser.js");
+Object.defineProperty(exports, "parseStory", { enumerable: true, get: function () { return parser_js_2.parseStory; } });
 /**
  * Parse `.story` source text.
  * @param source full text of a `.story` file
  * @returns the AST (possibly partial on errors) plus all diagnostics
  */
 function parse(source) {
-    const bag = new diagnostics_1.DiagnosticBag();
-    const ast = (0, parser_1.parseStory)(source, bag);
+    const bag = new diagnostics_js_1.DiagnosticBag();
+    const ast = (0, parser_js_1.parseStory)(source, bag);
     return { ast, diagnostics: bag.all(), ok: !bag.hasErrors() };
 }
 /**
- * Compile `.story` source text: parse + analyze + build IR.
+ * Compile `.story` source text: parse + resolve imports + analyze + build IR.
  * @param source full text of a `.story` file
+ * @param options host hooks (importResolver for `import "<file>"`)
  * @returns AST, IR, and all diagnostics; `ok` gates use of the IR
  */
-function compile(source) {
-    const bag = new diagnostics_1.DiagnosticBag();
-    const ast = (0, parser_1.parseStory)(source, bag);
-    const ir = (0, analyzer_1.analyze)(ast, bag);
+function compile(source, options) {
+    const bag = new diagnostics_js_1.DiagnosticBag();
+    const ast = (0, parser_js_1.parseStory)(source, bag);
+    resolveImports(ast, options, bag);
+    const ir = (0, analyzer_js_1.analyze)(ast, bag);
     return { ast, ir, diagnostics: bag.all(), ok: !bag.hasErrors() };
 }
+/**
+ * Splice each `import "<file>"` declaration with the imported fragment's
+ * complete declarations, in place (import site = arbitration position —
+ * ADR-251 D4: "an import is a paste"). The compiler appends `.chord` to
+ * the target before resolving (D2), so the host `importResolver` always
+ * receives `"<name>.chord"`. A fragment may contain any complete
+ * declaration EXCEPT a `story` header (D3 → `analysis.import-fragment-story`)
+ * or a nested `import` (D5: imports are flat → `analysis.import-fragment-nested`);
+ * a fragment that fails to parse cleanly (partial/non-declaration content)
+ * additionally raises `analysis.import-fragment-content` at the import site,
+ * beside the granular fragment parse errors. Processed imports are removed
+ * from the AST either way, so the analyzer never double-reports. Fragment
+ * diagnostics are re-reported with the fragment name prefixed, since spans
+ * are file-relative.
+ */
+function resolveImports(ast, options, bag) {
+    if (!ast.declarations.some((d) => d.kind === 'import'))
+        return;
+    const resolved = [];
+    for (const decl of ast.declarations) {
+        if (decl.kind !== 'import') {
+            resolved.push(decl);
+            continue;
+        }
+        // D2: the extension is a language fact, appended here — the resolver stays dumb.
+        const fragmentName = `${decl.path}.chord`;
+        const text = options?.importResolver ? options.importResolver(fragmentName) : null;
+        if (text === null || text === undefined) {
+            bag.error('analysis.import-unresolved', options?.importResolver
+                ? `Cannot resolve \`import "${decl.path}"\` — \`${fragmentName}\` was not found.`
+                : `\`import "${decl.path}"\` needs an import resolver — this compile host provides none.`, decl.span);
+            continue;
+        }
+        const fragBag = new diagnostics_js_1.DiagnosticBag();
+        const fragAst = (0, parser_js_1.parseStory)(text, fragBag);
+        for (const d of fragBag.all()) {
+            // Fragment spans are relative to the fragment file — prefix the name.
+            bag[d.severity === 'error' ? 'error' : 'warning'](d.code, `[${fragmentName}] ${d.message}`, d.span);
+        }
+        // D6 span contract: fragment diagnostics carry the fragment's OWN span
+        // (with the `[<name>.chord]` prefix identifying the file); only the
+        // unresolved-import diagnostic above points at the main-file import line.
+        if (fragBag.hasErrors()) {
+            // Partial / non-declaration content — the granular parse errors above
+            // carry the detail; anchor the category diagnostic at the first of them.
+            const firstError = fragBag.all().find((d) => d.severity === 'error');
+            bag.error('analysis.import-fragment-content', `[${fragmentName}] This import's fragment did not parse into complete declarations.`, firstError ? firstError.span : decl.span);
+        }
+        if (fragAst.header) {
+            bag.error('analysis.import-fragment-story', `[${fragmentName}] An imported fragment carries no story header — the \`story\` block lives only in the main \`.story\` file.`, fragAst.header.span);
+        }
+        for (const d of fragAst.declarations) {
+            if (d.kind === 'import') {
+                // D5: imports do not nest — only the main `.story` file may import.
+                bag.error('analysis.import-fragment-nested', `[${fragmentName}] Imports do not nest — remove the \`import "${d.path}"\` line from \`${fragmentName}\`.`, d.span);
+            }
+            else {
+                resolved.push(d);
+            }
+        }
+    }
+    ast.declarations = resolved;
+}
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA0CA,sBAIC;AAgBD,0BAKC;AAnED;;;;;;;;;;;;;GAaG;AACH,yCAAqC;AAErC,+CAA0D;AAE1D,qCAAsC;AAEtC,wCAAsB;AACtB,uCAAqB;AACrB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,qCAA8G;AAArG,qGAAA,UAAU,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC1F,6CAA8E;AAArC,4GAAA,aAAa,OAAA;AACtD,+BAAkD;AAAnC,8FAAA,MAAM,OAAA;AAAE,kGAAA,UAAU,OAAA;AACjC,iCAAsD;AAA7C,4FAAA,GAAG,OAAA;AACZ,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAUnB;;;;GAIG;AACH,SAAgB,KAAK,CAAC,MAAc;IAClC,MAAM,GAAG,GAAG,IAAI,2BAAa,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;AAC/D,CAAC;AAWD;;;;GAIG;AACH,SAAgB,OAAO,CAAC,MAAc;IACpC,MAAM,GAAG,GAAG,IAAI,2BAAa,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAA,kBAAO,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/index.ts"],"names":[],"mappings":"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"}