@sharpee/chord 3.0.0

package/analyzer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * analyzer.ts — Chord semantic analysis: two-pass resolution, the load-time
+ * gates, and Story IR construction (design.md §5.2/§5.3).
+ *
+ * Pass 1 collects declarations (entities + aliases + states, phrases per
+ * locale, named conditions, hatches, flags). Pass 2 resolves every
+ * reference with article stripping and builds the IR, reporting the AC-3
+ * gate classes as errors with `.story` spans:
+ *   missing phrase key · unknown predicate value (nearest-valid suggestion)
+ *   · undeclared state · ambiguous entity reference (rename suggestion)
+ *   · refusal after mutation (phase-order rule) · unbound `{…}` marker.
+ *
+ * Public interface: analyze().
+ * Owner context: @sharpee/chord (language frontend; browser-safe).
+ *
+ * Invariants:
+ * - Ambiguity is an error with a suggestion, never a guess.
+ * - The returned IR is pure JSON data (round-trips through JSON.stringify).
+ * - Diagnostics gate the load (atomic): callers must check hasErrors().
+ */
+import { StoryFile } from './ast';
+import { DiagnosticBag } from './diagnostics';
+import { StoryIR } from './ir';
+/**
+ * Analyze a parsed story and build its IR.
+ * @param ast parser output (may be partial when parse errors occurred)
+ * @param diagnostics receives load-time gate errors
+ * @returns the IR — meaningful only when diagnostics has no errors (atomic load)
+ */
+export declare function analyze(ast: StoryFile, diagnostics: DiagnosticBag): StoryIR;
+//# sourceMappingURL=analyzer.d.ts.map

package/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../repos/sharpee_v2/packages/chord/src/analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAYL,SAAS,EAIV,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAWL,OAAO,EACR,MAAM,MAAM,CAAC;AAsMd;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,GAAG,OAAO,CAE3E"}