@aftertext/runtime 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +1 -1
  2. package/dist/execution/advance.d.ts +2 -2
  3. package/dist/execution/advance.d.ts.map +1 -1
  4. package/dist/execution/advance.js +22 -4
  5. package/dist/execution/advance.js.map +1 -1
  6. package/dist/execution/choice.d.ts +1 -1
  7. package/dist/execution/choice.js +1 -1
  8. package/dist/execution/cursor.d.ts +3 -3
  9. package/dist/execution/errors.d.ts +3 -2
  10. package/dist/execution/errors.d.ts.map +1 -1
  11. package/dist/execution/errors.js +3 -0
  12. package/dist/execution/errors.js.map +1 -1
  13. package/dist/execution/expression.d.ts +2 -2
  14. package/dist/execution/memory-queries.d.ts +1 -1
  15. package/dist/execution/memory-queries.d.ts.map +1 -1
  16. package/dist/execution/memory-queries.js +4 -3
  17. package/dist/execution/memory-queries.js.map +1 -1
  18. package/dist/execution/navigate.d.ts +7 -3
  19. package/dist/execution/navigate.d.ts.map +1 -1
  20. package/dist/execution/navigate.js +7 -3
  21. package/dist/execution/navigate.js.map +1 -1
  22. package/dist/execution/result.d.ts +13 -3
  23. package/dist/execution/result.d.ts.map +1 -1
  24. package/dist/execution/variant.d.ts +1 -1
  25. package/dist/execution/variant.js +1 -1
  26. package/dist/index.d.ts +1 -1
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js.map +1 -1
  29. package/dist/reader/own-entry.d.ts +8 -0
  30. package/dist/reader/own-entry.d.ts.map +1 -0
  31. package/dist/reader/own-entry.js +10 -0
  32. package/dist/reader/own-entry.js.map +1 -0
  33. package/dist/reader/scene-memory.d.ts.map +1 -1
  34. package/dist/reader/scene-memory.js +4 -3
  35. package/dist/reader/scene-memory.js.map +1 -1
  36. package/dist/reader/variant-memory.d.ts +3 -3
  37. package/dist/reader/variant-memory.d.ts.map +1 -1
  38. package/dist/reader/variant-memory.js +7 -6
  39. package/dist/reader/variant-memory.js.map +1 -1
  40. package/dist/state/reader-state.d.ts +1 -1
  41. package/package.json +2 -2
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  Pure narrative execution for compiled AfterText `StoryDocument` values,
4
4
  including story state, reader memory, choices, variants, and navigation.
5
5
 
6
- > v0.1 foundation: the public API is early and may change.
6
+ > v0.3.0: the public API is early and may change.
7
7
 
8
8
  ## Install
9
9
 
@@ -7,7 +7,7 @@ export interface AdvanceOptions {
7
7
  * Overrides the internal step-budget default — intended for tests that
8
8
  * need to deterministically exercise step-limit exhaustion without
9
9
  * constructing a pathologically large scene. Not a specification-level
10
- * constant (docs/PROJECT_SPEC.md Section 17.12 deliberately commits to
10
+ * constant (docs/CORE_SPEC.md Section 17.12 deliberately commits to
11
11
  * no numeric default).
12
12
  */
13
13
  readonly stepBudget?: number;
@@ -16,7 +16,7 @@ export interface AdvanceOptions {
16
16
  * Walks a compiled `StoryDocument`'s blocks, automatically executing
17
17
  * non-suspending work (`@set`, Conditional/Variant branch selection) until
18
18
  * it reaches content, presentation, a choice, a navigation, `completed`,
19
- * or a runtime error (docs/PROJECT_SPEC.md Sections 17.5–17.7).
19
+ * or a runtime error (docs/CORE_SPEC.md Sections 17.5–17.7).
20
20
  *
21
21
  * Pure: never mutates `runtimeState`/`cursor`. Progressive, not
22
22
  * transactional (17.11): automatic operations completed earlier in this
@@ -1 +1 @@
1
- {"version":3,"file":"advance.d.ts","sourceRoot":"","sources":["../../src/execution/advance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkD,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAuBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,eAAgC,EACxC,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CA4Jf"}
1
+ {"version":3,"file":"advance.d.ts","sourceRoot":"","sources":["../../src/execution/advance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkD,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,eAAgC,EACxC,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CA0Kf"}
@@ -23,11 +23,17 @@ function selectConditionalBranch(node, context) {
23
23
  }
24
24
  return undefined; // no branch matched — not an error
25
25
  }
26
+ function describeBlock(block) {
27
+ if (typeof block !== "object" || block === null)
28
+ return "a missing or non-object block";
29
+ const type = block.type;
30
+ return typeof type === "string" ? `block of unknown type "${type}"` : "a block without a string type";
31
+ }
26
32
  /**
27
33
  * Walks a compiled `StoryDocument`'s blocks, automatically executing
28
34
  * non-suspending work (`@set`, Conditional/Variant branch selection) until
29
35
  * it reaches content, presentation, a choice, a navigation, `completed`,
30
- * or a runtime error (docs/PROJECT_SPEC.md Sections 17.5–17.7).
36
+ * or a runtime error (docs/CORE_SPEC.md Sections 17.5–17.7).
31
37
  *
32
38
  * Pure: never mutates `runtimeState`/`cursor`. Progressive, not
33
39
  * transactional (17.11): automatic operations completed earlier in this
@@ -109,7 +115,7 @@ export function advance(document, runtimeState, cursor = INITIAL_CURSOR, options
109
115
  continue;
110
116
  }
111
117
  const block = top.blocks[top.index];
112
- switch (block.type) {
118
+ switch (block?.type) {
113
119
  case "Paragraph":
114
120
  case "Heading": {
115
121
  frames = withNextIndex(frames);
@@ -121,6 +127,11 @@ export function advance(document, runtimeState, cursor = INITIAL_CURSOR, options
121
127
  frames = recordObservableExposure(frames);
122
128
  return commit(frames, { type: "presentation", command: block.command });
123
129
  }
130
+ case "Dialogue": {
131
+ frames = withNextIndex(frames);
132
+ frames = recordObservableExposure(frames);
133
+ return commit(frames, { type: "dialogue", speaker: block.speaker, content: block.content });
134
+ }
124
135
  case "Set": {
125
136
  if (budget <= 0)
126
137
  return commit(frames, { type: "error", error: RuntimeErrors.stepLimitExceeded() });
@@ -179,7 +190,7 @@ export function advance(document, runtimeState, cursor = INITIAL_CURSOR, options
179
190
  if (!filtered.ok)
180
191
  return commit(frames, { type: "error", error: filtered.error });
181
192
  if (filtered.items.length === 0) {
182
- return commit(frames, { type: "error", error: RuntimeErrors.emptyChoice() });
193
+ return commit(frames, { type: "error", error: RuntimeErrors.emptyChoice(block.span) });
183
194
  }
184
195
  // Cursor is intentionally left pointing at this ChoiceNode — resuming
185
196
  // past it only ever happens via selectChoice's shared navigateTo,
@@ -188,7 +199,14 @@ export function advance(document, runtimeState, cursor = INITIAL_CURSOR, options
188
199
  return commit(frames, { type: "choice", items: filtered.items });
189
200
  }
190
201
  case "Goto": {
191
- return navigateTo(document, { ...runtimeState, story, reader }, frames, block.target);
202
+ return navigateTo(document, { ...runtimeState, story, reader }, frames, block.target, block.targetSourceSpan);
203
+ }
204
+ default: {
205
+ // Invariant violation (17.11): a block the interpreter cannot execute
206
+ // (a type from another compiler version, or a malformed cursor index
207
+ // that no longer points at a block). Stop here — cursor and state are
208
+ // returned as they stand — rather than loop without progress (17.12).
209
+ return commit(frames, { type: "error", error: RuntimeErrors.invalidExecutionBlock(describeBlock(block)) });
192
210
  }
193
211
  }
194
212
  }
@@ -1 +1 @@
1
- {"version":3,"file":"advance.js","sourceRoot":"","sources":["../../src/execution/advance.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"advance.js","sourceRoot":"","sources":["../../src/execution/advance.ts"],"names":[],"mappings":"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"}
@@ -21,7 +21,7 @@ export declare function filterChoiceItems(node: ChoiceNode, context: EvaluationC
21
21
  /**
22
22
  * Resolves an explicit Choice selection against the *exact* suspension
23
23
  * `advance()` returned — never by re-locating the source `ChoiceNode` or
24
- * re-evaluating its conditions (docs/PROJECT_SPEC.md Section 17.7). The
24
+ * re-evaluating its conditions (docs/CORE_SPEC.md Section 17.7). The
25
25
  * runtime core has no global "current suspension"; an older but internally
26
26
  * valid suspension may be replayed/forked from — that is not itself an
27
27
  * error here (17.7's replay clarification).
@@ -26,7 +26,7 @@ export function filterChoiceItems(node, context) {
26
26
  /**
27
27
  * Resolves an explicit Choice selection against the *exact* suspension
28
28
  * `advance()` returned — never by re-locating the source `ChoiceNode` or
29
- * re-evaluating its conditions (docs/PROJECT_SPEC.md Section 17.7). The
29
+ * re-evaluating its conditions (docs/CORE_SPEC.md Section 17.7). The
30
30
  * runtime core has no global "current suspension"; an older but internally
31
31
  * valid suspension may be replayed/forked from — that is not itself an
32
32
  * error here (17.7's replay clarification).
@@ -1,6 +1,6 @@
1
1
  import type { StoryBlock } from "@aftertext/compiler";
2
2
  /**
3
- * Reader-Memory-integration provenance for one frame (docs/PROJECT_SPEC.md
3
+ * Reader-Memory-integration provenance for one frame (docs/CORE_SPEC.md
4
4
  * Section 17.9). Purely runtime-internal bookkeeping — never a `ReaderState`
5
5
  * value itself, only whether/what to record:
6
6
  *
@@ -35,7 +35,7 @@ export interface CursorFrame {
35
35
  }
36
36
  /**
37
37
  * Ephemeral structural execution position within a scene's block tree
38
- * (docs/PROJECT_SPEC.md Section 17.10). A stack of frames — the top is the
38
+ * (docs/CORE_SPEC.md Section 17.10). A stack of frames — the top is the
39
39
  * deepest active nested branch. Exists separately from `RuntimeState`, is
40
40
  * never persisted, and must never be written into `ReaderState`: it is
41
41
  * *structural* position (plus, per 17.9, ephemeral recording provenance),
@@ -57,7 +57,7 @@ export declare function withNextIndex(cursor: ExecutionCursor): ExecutionCursor;
57
57
  * active scene-entry episode (frame 0), if not yet recorded, plus every
58
58
  * active Variant-branch frame not yet recorded, at any depth — including
59
59
  * beneath an untagged (Conditional) frame, so a nested construct inside a
60
- * selected Variant branch still attributes correctly (docs/PROJECT_SPEC.md
60
+ * selected Variant branch still attributes correctly (docs/CORE_SPEC.md
61
61
  * Section 17.9, "Nested Variants"). A pure query — records nothing itself.
62
62
  */
63
63
  export interface PendingExposure {
@@ -3,10 +3,10 @@ import type { SourceSpan } from "@aftertext/compiler";
3
3
  * Narrow runtime execution error categories — deliberately not a code
4
4
  * registry mirroring the compiler's `Diagnostic`. Runtime execution errors
5
5
  * are a distinct concern from compiler diagnostics: different producer,
6
- * different audience, different lifecycle (docs/PROJECT_SPEC.md Section
6
+ * different audience, different lifecycle (docs/CORE_SPEC.md Section
7
7
  * 17.11).
8
8
  */
9
- export type RuntimeExecutionErrorKind = "unknown-identifier" | "type-mismatch" | "division-by-zero" | "invalid-arithmetic-result" | "empty-choice" | "invalid-choice-selection" | "invalid-scene-target" | "step-limit-exceeded" | "unknown-builtin" | "invalid-variant-reference";
9
+ export type RuntimeExecutionErrorKind = "unknown-identifier" | "type-mismatch" | "division-by-zero" | "invalid-arithmetic-result" | "empty-choice" | "invalid-choice-selection" | "invalid-scene-target" | "step-limit-exceeded" | "unknown-builtin" | "invalid-variant-reference" | "invalid-execution-block";
10
10
  export interface RuntimeExecutionError {
11
11
  readonly kind: RuntimeExecutionErrorKind;
12
12
  readonly message: string;
@@ -23,5 +23,6 @@ export declare const RuntimeErrors: {
23
23
  readonly stepLimitExceeded: () => RuntimeExecutionError;
24
24
  readonly unknownBuiltin: (name: string, span?: SourceSpan) => RuntimeExecutionError;
25
25
  readonly invalidVariantReference: (variantId: string, span?: SourceSpan) => RuntimeExecutionError;
26
+ readonly invalidExecutionBlock: (description: string, span?: SourceSpan) => RuntimeExecutionError;
26
27
  };
27
28
  //# sourceMappingURL=errors.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/execution/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC,oBAAoB,GACpB,eAAe,GACf,kBAAkB,GAClB,2BAA2B,GAC3B,cAAc,GACd,0BAA0B,GAC1B,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAMD,eAAO,MAAM,aAAa;uCACA,MAAM,SAAS,UAAU,KAAG,qBAAqB;qCAGnD,MAAM,SAAS,UAAU,KAAG,qBAAqB;qCAGjD,UAAU,KAAG,qBAAqB;8CAGzB,UAAU,KAAG,qBAAqB;kCAO9C,UAAU,KAAG,qBAAqB;+CAGrB,MAAM,KAAG,qBAAqB;0CAGnC,MAAM,SAAS,UAAU,KAAG,qBAAqB;sCAGvD,qBAAqB;oCAGrB,MAAM,SAAS,UAAU,KAAG,qBAAqB;kDAGnC,MAAM,SAAS,UAAU,KAAG,qBAAqB;CAG5E,CAAC"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/execution/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC,oBAAoB,GACpB,eAAe,GACf,kBAAkB,GAClB,2BAA2B,GAC3B,cAAc,GACd,0BAA0B,GAC1B,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,GACjB,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAMD,eAAO,MAAM,aAAa;uCACA,MAAM,SAAS,UAAU,KAAG,qBAAqB;qCAGnD,MAAM,SAAS,UAAU,KAAG,qBAAqB;qCAGjD,UAAU,KAAG,qBAAqB;8CAGzB,UAAU,KAAG,qBAAqB;kCAO9C,UAAU,KAAG,qBAAqB;+CAGrB,MAAM,KAAG,qBAAqB;0CAGnC,MAAM,SAAS,UAAU,KAAG,qBAAqB;sCAGvD,qBAAqB;oCAGrB,MAAM,SAAS,UAAU,KAAG,qBAAqB;kDAGnC,MAAM,SAAS,UAAU,KAAG,qBAAqB;kDAGjD,MAAM,SAAS,UAAU,KAAG,qBAAqB;CAG5E,CAAC"}
@@ -31,6 +31,9 @@ export const RuntimeErrors = {
31
31
  },
32
32
  invalidVariantReference(variantId, span) {
33
33
  return error("invalid-variant-reference", `Reference to unknown Variant "${variantId}".`, span);
34
+ },
35
+ invalidExecutionBlock(description, span) {
36
+ return error("invalid-execution-block", `Cannot execute ${description}.`, span);
34
37
  }
35
38
  };
36
39
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/execution/errors.ts"],"names":[],"mappings":"AA2BA,SAAS,KAAK,CAAC,IAA+B,EAAE,OAAe,EAAE,IAAiB;IAChF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,CAAC,IAAY,EAAE,IAAiB;QAC/C,OAAO,KAAK,CAAC,oBAAoB,EAAE,uBAAuB,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,YAAY,CAAC,OAAe,EAAE,IAAiB;QAC7C,OAAO,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,cAAc,CAAC,IAAiB;QAC9B,OAAO,KAAK,CAAC,kBAAkB,EAAE,6BAA6B,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,uBAAuB,CAAC,IAAiB;QACvC,OAAO,KAAK,CACV,2BAA2B,EAC3B,+DAA+D,EAC/D,IAAI,CACL,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,IAAiB;QAC3B,OAAO,KAAK,CAAC,cAAc,EAAE,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,sBAAsB,CAAC,OAAe;QACpC,OAAO,KAAK,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IACD,kBAAkB,CAAC,MAAc,EAAE,IAAiB;QAClD,OAAO,KAAK,CAAC,sBAAsB,EAAE,iBAAiB,MAAM,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,iBAAiB;QACf,OAAO,KAAK,CAAC,qBAAqB,EAAE,oEAAoE,CAAC,CAAC;IAC5G,CAAC;IACD,cAAc,CAAC,IAAY,EAAE,IAAiB;QAC5C,OAAO,KAAK,CAAC,iBAAiB,EAAE,yBAAyB,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;IACD,uBAAuB,CAAC,SAAiB,EAAE,IAAiB;QAC1D,OAAO,KAAK,CAAC,2BAA2B,EAAE,iCAAiC,SAAS,IAAI,EAAE,IAAI,CAAC,CAAC;IAClG,CAAC;CACO,CAAC"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/execution/errors.ts"],"names":[],"mappings":"AA4BA,SAAS,KAAK,CAAC,IAA+B,EAAE,OAAe,EAAE,IAAiB;IAChF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,CAAC,IAAY,EAAE,IAAiB;QAC/C,OAAO,KAAK,CAAC,oBAAoB,EAAE,uBAAuB,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,YAAY,CAAC,OAAe,EAAE,IAAiB;QAC7C,OAAO,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,cAAc,CAAC,IAAiB;QAC9B,OAAO,KAAK,CAAC,kBAAkB,EAAE,6BAA6B,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,uBAAuB,CAAC,IAAiB;QACvC,OAAO,KAAK,CACV,2BAA2B,EAC3B,+DAA+D,EAC/D,IAAI,CACL,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,IAAiB;QAC3B,OAAO,KAAK,CAAC,cAAc,EAAE,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,sBAAsB,CAAC,OAAe;QACpC,OAAO,KAAK,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IACD,kBAAkB,CAAC,MAAc,EAAE,IAAiB;QAClD,OAAO,KAAK,CAAC,sBAAsB,EAAE,iBAAiB,MAAM,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,iBAAiB;QACf,OAAO,KAAK,CAAC,qBAAqB,EAAE,oEAAoE,CAAC,CAAC;IAC5G,CAAC;IACD,cAAc,CAAC,IAAY,EAAE,IAAiB;QAC5C,OAAO,KAAK,CAAC,iBAAiB,EAAE,yBAAyB,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;IACD,uBAAuB,CAAC,SAAiB,EAAE,IAAiB;QAC1D,OAAO,KAAK,CAAC,2BAA2B,EAAE,iCAAiC,SAAS,IAAI,EAAE,IAAI,CAAC,CAAC;IAClG,CAAC;IACD,qBAAqB,CAAC,WAAmB,EAAE,IAAiB;QAC1D,OAAO,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,WAAW,GAAG,EAAE,IAAI,CAAC,CAAC;IAClF,CAAC;CACO,CAAC"}
@@ -3,7 +3,7 @@ import type { ReaderState } from "../state/reader-state.js";
3
3
  import type { StoryState, StoryValue } from "../state/story-state.js";
4
4
  import type { RuntimeExecutionError } from "./errors.js";
5
5
  /**
6
- * Everything expression evaluation may read (docs/PROJECT_SPEC.md Section
6
+ * Everything expression evaluation may read (docs/CORE_SPEC.md Section
7
7
  * 17.17). Responsibilities are strictly partitioned: `story` backs
8
8
  * `Identifier` resolution (unchanged since before Reader Memory queries
9
9
  * existed); `reader` backs Reader Memory builtin values, reachable only
@@ -20,7 +20,7 @@ export interface EvaluationContext {
20
20
  }
21
21
  /**
22
22
  * Pure evaluator for the compiler's existing `ExpressionNode` against an
23
- * `EvaluationContext`. Implements docs/PROJECT_SPEC.md Section 17.8 exactly:
23
+ * `EvaluationContext`. Implements docs/CORE_SPEC.md Section 17.8 exactly:
24
24
  * explicit, deterministic rules, never implicit JavaScript truthiness or
25
25
  * coercion. Result-typed rather than throwing, matching this package's
26
26
  * existing no-throw, pure-function style. `Call` (Reader Memory queries)
@@ -10,7 +10,7 @@ export type MemoryQueryOutcome = {
10
10
  readonly error: RuntimeExecutionError;
11
11
  };
12
12
  /**
13
- * Evaluates a Reader Memory builtin call (docs/PROJECT_SPEC.md Sections
13
+ * Evaluates a Reader Memory builtin call (docs/CORE_SPEC.md Sections
14
14
  * 17.14–17.16). Defensive: the compiler is expected to have already
15
15
  * rejected an unknown callee, wrong arity, a non-literal argument, or an
16
16
  * unknown Scene/Variant reference — this still re-checks each, exactly as
@@ -1 +1 @@
1
- {"version":3,"file":"memory-queries.d.ts","sourceRoot":"","sources":["../../src/execution/memory-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAiDlE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB,kBAAkB,CA0BpB"}
1
+ {"version":3,"file":"memory-queries.d.ts","sourceRoot":"","sources":["../../src/execution/memory-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAiDlE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB,kBAAkB,CA2BpB"}
@@ -2,7 +2,7 @@ import { hasVisitedScene, getSceneVisitCount } from "../reader/scene-memory.js";
2
2
  import { hasSeenVariant, getLastSeenVariantBranch } from "../reader/variant-memory.js";
3
3
  import { RuntimeErrors } from "./errors.js";
4
4
  /**
5
- * The fixed Reader Memory query builtin registry (docs/PROJECT_SPEC.md
5
+ * The fixed Reader Memory query builtin registry (docs/CORE_SPEC.md
6
6
  * Section 17.15) — exactly four entries, not author-extensible. This is
7
7
  * implementation code, not a dynamic function-lookup mechanism: adding a
8
8
  * builtin means adding an entry here, never resolving a JS function by an
@@ -49,14 +49,15 @@ function variantExists(document, variantId) {
49
49
  return document.scenes.some((scene) => containsVariant(scene.blocks, variantId));
50
50
  }
51
51
  /**
52
- * Evaluates a Reader Memory builtin call (docs/PROJECT_SPEC.md Sections
52
+ * Evaluates a Reader Memory builtin call (docs/CORE_SPEC.md Sections
53
53
  * 17.14–17.16). Defensive: the compiler is expected to have already
54
54
  * rejected an unknown callee, wrong arity, a non-literal argument, or an
55
55
  * unknown Scene/Variant reference — this still re-checks each, exactly as
56
56
  * `navigateTo` defensively re-checks a Goto/Choice target (17.11).
57
57
  */
58
58
  export function evaluateMemoryQuery(call, document, reader) {
59
- const query = MEMORY_QUERIES[call.callee];
59
+ // Own keys only: an inherited name (`constructor`, `toString`, ...) is not a builtin.
60
+ const query = Object.hasOwn(MEMORY_QUERIES, call.callee) ? MEMORY_QUERIES[call.callee] : undefined;
60
61
  if (!query) {
61
62
  return { ok: false, error: RuntimeErrors.unknownBuiltin(call.callee, call.span) };
62
63
  }
@@ -1 +1 @@
1
- {"version":3,"file":"memory-queries.js","sourceRoot":"","sources":["../../src/execution/memory-queries.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"memory-queries.js","sourceRoot":"","sources":["../../src/execution/memory-queries.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,10 @@
1
- import type { StoryDocument } from "@aftertext/compiler";
1
+ import type { SourceSpan, StoryDocument } from "@aftertext/compiler";
2
2
  import type { RuntimeState } from "../state/runtime-state.js";
3
3
  import { type ExecutionCursor } from "./cursor.js";
4
4
  import type { ExecutionStep } from "./result.js";
5
5
  /**
6
6
  * Shared internal navigation operation used identically by `GotoNode`
7
- * handling and by a resolved Choice selection (docs/PROJECT_SPEC.md
7
+ * handling and by a resolved Choice selection (docs/CORE_SPEC.md
8
8
  * Section 17.7: "share one navigation rule"). Not part of the public
9
9
  * barrel.
10
10
  *
@@ -14,10 +14,14 @@ import type { ExecutionStep } from "./result.js";
14
14
  * the walk. Never touches `ReaderState.visitedScenes`
15
15
  * (`navigated != experienced`).
16
16
  *
17
+ * `span` is the authored range of the target when the caller has one (a
18
+ * `GotoNode`'s `targetSourceSpan`); a Choice selection has none, since an
19
+ * offered item carries no source position, and the error stays spanless.
20
+ *
17
21
  * On an invalid target, `runtimeState`/`cursor` are echoed back exactly as
18
22
  * given — execution is progressive, not transactional (17.11): any
19
23
  * automatic work already completed earlier in the same call is preserved
20
24
  * in what the caller passes in here.
21
25
  */
22
- export declare function navigateTo(document: StoryDocument, runtimeState: RuntimeState, cursor: ExecutionCursor, target: string): ExecutionStep;
26
+ export declare function navigateTo(document: StoryDocument, runtimeState: RuntimeState, cursor: ExecutionCursor, target: string, span?: SourceSpan): ExecutionStep;
23
27
  //# sourceMappingURL=navigate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/execution/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,aAAa,CAYf"}
1
+ {"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/execution/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,UAAU,GAChB,aAAa,CAYf"}
@@ -2,7 +2,7 @@ import { INITIAL_CURSOR } from "./cursor.js";
2
2
  import { RuntimeErrors } from "./errors.js";
3
3
  /**
4
4
  * Shared internal navigation operation used identically by `GotoNode`
5
- * handling and by a resolved Choice selection (docs/PROJECT_SPEC.md
5
+ * handling and by a resolved Choice selection (docs/CORE_SPEC.md
6
6
  * Section 17.7: "share one navigation rule"). Not part of the public
7
7
  * barrel.
8
8
  *
@@ -12,15 +12,19 @@ import { RuntimeErrors } from "./errors.js";
12
12
  * the walk. Never touches `ReaderState.visitedScenes`
13
13
  * (`navigated != experienced`).
14
14
  *
15
+ * `span` is the authored range of the target when the caller has one (a
16
+ * `GotoNode`'s `targetSourceSpan`); a Choice selection has none, since an
17
+ * offered item carries no source position, and the error stays spanless.
18
+ *
15
19
  * On an invalid target, `runtimeState`/`cursor` are echoed back exactly as
16
20
  * given — execution is progressive, not transactional (17.11): any
17
21
  * automatic work already completed earlier in the same call is preserved
18
22
  * in what the caller passes in here.
19
23
  */
20
- export function navigateTo(document, runtimeState, cursor, target) {
24
+ export function navigateTo(document, runtimeState, cursor, target, span) {
21
25
  const targetScene = document.scenes.find((scene) => scene.id === target);
22
26
  if (!targetScene) {
23
- return { runtimeState, cursor, result: { type: "error", error: RuntimeErrors.invalidSceneTarget(target) } };
27
+ return { runtimeState, cursor, result: { type: "error", error: RuntimeErrors.invalidSceneTarget(target, span) } };
24
28
  }
25
29
  const from = runtimeState.navigation.sceneId;
26
30
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../src/execution/navigate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACxB,QAAuB,EACvB,YAA0B,EAC1B,MAAuB,EACvB,MAAc;IAEd,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IAC9G,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;IAC7C,OAAO;QACL,YAAY,EAAE,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAClE,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE;KACjD,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../src/execution/navigate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,UAAU,CACxB,QAAuB,EACvB,YAA0B,EAC1B,MAAuB,EACvB,MAAc,EACd,IAAiB;IAEjB,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IACpH,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;IAC7C,OAAO;QACL,YAAY,EAAE,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAClE,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE;KACjD,CAAC;AACJ,CAAC"}
@@ -1,11 +1,11 @@
1
- import type { HeadingNode, ParagraphNode, PresentationCommand } from "@aftertext/compiler";
1
+ import type { HeadingNode, InlineNode, ParagraphNode, PresentationCommand } from "@aftertext/compiler";
2
2
  import type { RuntimeState } from "../state/runtime-state.js";
3
3
  import type { ExecutionCursor } from "./cursor.js";
4
4
  import type { RuntimeExecutionError } from "./errors.js";
5
5
  /**
6
6
  * One item offered by a Choice suspension. `index` is a transient
7
7
  * request/response correlator scoped to that one suspension — never a
8
- * stable identity, never persisted (docs/PROJECT_SPEC.md Section 17.7).
8
+ * stable identity, never persisted (docs/CORE_SPEC.md Section 17.7).
9
9
  */
10
10
  export interface AvailableChoiceItem {
11
11
  readonly index: number;
@@ -20,6 +20,16 @@ export interface PresentationResult {
20
20
  readonly type: "presentation";
21
21
  readonly command: PresentationCommand;
22
22
  }
23
+ /**
24
+ * Deliberately flattened — not `{ type: "dialogue", block: DialogueNode }`
25
+ * (docs/CORE_SPEC.md Section 32.16, locked). `content` carries the lifted
26
+ * inline children directly, the same shape Section 32's own contract names.
27
+ */
28
+ export interface DialogueResult {
29
+ readonly type: "dialogue";
30
+ readonly speaker: string;
31
+ readonly content: readonly InlineNode[];
32
+ }
23
33
  export interface ChoiceResult {
24
34
  readonly type: "choice";
25
35
  readonly items: readonly AvailableChoiceItem[];
@@ -41,7 +51,7 @@ export interface ErrorResult {
41
51
  * call. Runtime errors are their own variant (`ErrorResult`) — always
42
52
  * distinguishable from a valid suspension via `result.type`.
43
53
  */
44
- export type ExecutionResult = ContentResult | PresentationResult | ChoiceResult | NavigationResult | CompletedResult | ErrorResult;
54
+ export type ExecutionResult = ContentResult | PresentationResult | DialogueResult | ChoiceResult | NavigationResult | CompletedResult | ErrorResult;
45
55
  export interface ExecutionStep {
46
56
  readonly runtimeState: RuntimeState;
47
57
  readonly cursor: ExecutionCursor;
@@ -1 +1 @@
1
- {"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/execution/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,kBAAkB,GAClB,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC"}
1
+ {"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/execution/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,kBAAkB,GAClB,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC"}
@@ -14,7 +14,7 @@ export type VariantResolution = {
14
14
  readonly error: RuntimeExecutionError;
15
15
  };
16
16
  /**
17
- * Pure Variant resolution (docs/PROJECT_SPEC.md Section 17.7): `@when`
17
+ * Pure Variant resolution (docs/CORE_SPEC.md Section 17.7): `@when`
18
18
  * conditions evaluated in source order, first match wins, `@otherwise` is
19
19
  * the fallback. If nothing matches and there is no `@otherwise`,
20
20
  * `resolved` is `undefined` — a graceful "no match," not an error. Never
@@ -1,6 +1,6 @@
1
1
  import { evaluateCondition } from "./expression.js";
2
2
  /**
3
- * Pure Variant resolution (docs/PROJECT_SPEC.md Section 17.7): `@when`
3
+ * Pure Variant resolution (docs/CORE_SPEC.md Section 17.7): `@when`
4
4
  * conditions evaluated in source order, first match wins, `@otherwise` is
5
5
  * the fallback. If nothing matches and there is no `@otherwise`,
6
6
  * `resolved` is `undefined` — a graceful "no match," not an error. Never
package/dist/index.d.ts CHANGED
@@ -9,7 +9,7 @@ export { recordVariantSeen, hasVariantChangedSinceRead, hasSeenVariant, getLastS
9
9
  export { createRuntimeState } from "./create-runtime-state.js";
10
10
  export type { ExecutionCursor } from "./execution/cursor.js";
11
11
  export { INITIAL_CURSOR } from "./execution/cursor.js";
12
- export type { AvailableChoiceItem, ContentResult, PresentationResult, ChoiceResult, NavigationResult, CompletedResult, ErrorResult, ExecutionResult, ExecutionStep } from "./execution/result.js";
12
+ export type { AvailableChoiceItem, ContentResult, PresentationResult, DialogueResult, ChoiceResult, NavigationResult, CompletedResult, ErrorResult, ExecutionResult, ExecutionStep } from "./execution/result.js";
13
13
  export type { RuntimeExecutionErrorKind, RuntimeExecutionError } from "./execution/errors.js";
14
14
  export { RuntimeErrors } from "./execution/errors.js";
15
15
  export type { EvaluationContext } from "./execution/expression.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAK/D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAetD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEjG,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAK/D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAetD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,wEAAwE;AACxE,mCAAmC;AAQnC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkBtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,wEAAwE;AACxE,mCAAmC;AAQnC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAgBvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkBtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Reads `record[key]` only when `key` is an own property. Reader Memory is
3
+ * keyed by author-supplied ids, so an id such as `constructor` or `toString`
4
+ * must not resolve to something inherited from `Object.prototype` and look
5
+ * like an existing entry. Internal — not part of the public barrel.
6
+ */
7
+ export declare function ownEntry<T>(record: Readonly<Record<string, T>>, key: string): T | undefined;
8
+ //# sourceMappingURL=own-entry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"own-entry.d.ts","sourceRoot":"","sources":["../../src/reader/own-entry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE3F"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Reads `record[key]` only when `key` is an own property. Reader Memory is
3
+ * keyed by author-supplied ids, so an id such as `constructor` or `toString`
4
+ * must not resolve to something inherited from `Object.prototype` and look
5
+ * like an existing entry. Internal — not part of the public barrel.
6
+ */
7
+ export function ownEntry(record, key) {
8
+ return Object.hasOwn(record, key) ? record[key] : undefined;
9
+ }
10
+ //# sourceMappingURL=own-entry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"own-entry.js","sourceRoot":"","sources":["../../src/reader/own-entry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,MAAmC,EAAE,GAAW;IAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"scene-memory.d.ts","sourceRoot":"","sources":["../../src/reader/scene-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CASlF;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E"}
1
+ {"version":3,"file":"scene-memory.d.ts","sourceRoot":"","sources":["../../src/reader/scene-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CASlF;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E"}
@@ -1,9 +1,10 @@
1
+ import { ownEntry } from "./own-entry.js";
1
2
  /**
2
3
  * Records a visit to `sceneId`, returning a new `ReaderState` with that
3
4
  * scene's visit count incremented. Pure — `reader` is never mutated.
4
5
  */
5
6
  export function recordSceneVisit(reader, sceneId) {
6
- const previousCount = reader.visitedScenes[sceneId]?.visitCount ?? 0;
7
+ const previousCount = ownEntry(reader.visitedScenes, sceneId)?.visitCount ?? 0;
7
8
  return {
8
9
  ...reader,
9
10
  visitedScenes: {
@@ -14,10 +15,10 @@ export function recordSceneVisit(reader, sceneId) {
14
15
  }
15
16
  /** Whether the reader has entered `sceneId` at least once. */
16
17
  export function hasVisitedScene(reader, sceneId) {
17
- return reader.visitedScenes[sceneId] !== undefined;
18
+ return ownEntry(reader.visitedScenes, sceneId) !== undefined;
18
19
  }
19
20
  /** How many times the reader has entered `sceneId` (0 if never). */
20
21
  export function getSceneVisitCount(reader, sceneId) {
21
- return reader.visitedScenes[sceneId]?.visitCount ?? 0;
22
+ return ownEntry(reader.visitedScenes, sceneId)?.visitCount ?? 0;
22
23
  }
23
24
  //# sourceMappingURL=scene-memory.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"scene-memory.js","sourceRoot":"","sources":["../../src/reader/scene-memory.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,OAAe;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;IACrE,OAAO;QACL,GAAG,MAAM;QACT,aAAa,EAAE;YACb,GAAG,MAAM,CAAC,aAAa;YACvB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,EAAE;SAC7C;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,OAAe;IAClE,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AACrD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,OAAe;IACrE,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;AACxD,CAAC"}
1
+ {"version":3,"file":"scene-memory.js","sourceRoot":"","sources":["../../src/reader/scene-memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO1C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,OAAe;IACnE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;IAC/E,OAAO;QACL,GAAG,MAAM;QACT,aAAa,EAAE;YACb,GAAG,MAAM,CAAC,aAAa;YACvB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,EAAE;SAC7C;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,OAAe;IAClE,OAAO,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,OAAe;IACrE,OAAO,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;AAClE,CAAC"}
@@ -2,7 +2,7 @@ import type { ReaderState } from "../state/reader-state.js";
2
2
  /**
3
3
  * What the reader remembers of one Variant. Deliberately narrow: the
4
4
  * first and last branch seen, plus a count — not full branch history,
5
- * not timestamps. See `docs/PROJECT_SPEC.md` (Runtime Principles) for the
5
+ * not timestamps. See `docs/CORE_SPEC.md` (Runtime Principles) for the
6
6
  * rationale.
7
7
  */
8
8
  export interface VariantMemory {
@@ -28,14 +28,14 @@ export declare function recordVariantSeen(reader: ReaderState, variantId: string
28
28
  export declare function hasVariantChangedSinceRead(reader: ReaderState, variantId: string, currentBranchId: string): boolean;
29
29
  /**
30
30
  * Whether the reader has ever seen `variantId` at least once. Backs the
31
- * `seen_variant(...)` Reader Memory query (docs/PROJECT_SPEC.md Section
31
+ * `seen_variant(...)` Reader Memory query (docs/CORE_SPEC.md Section
32
32
  * 17.15). A pure query — it never records anything itself.
33
33
  */
34
34
  export declare function hasSeenVariant(reader: ReaderState, variantId: string): boolean;
35
35
  /**
36
36
  * The branch id the reader most recently saw for `variantId`, or `null`
37
37
  * if it has never been seen. Backs the `last_seen_variant_branch(...)`
38
- * Reader Memory query (docs/PROJECT_SPEC.md Section 17.15). A pure query —
38
+ * Reader Memory query (docs/CORE_SPEC.md Section 17.15). A pure query —
39
39
  * it never records anything itself.
40
40
  */
41
41
  export declare function getLastSeenVariantBranch(reader: ReaderState, variantId: string): string | null;
@@ -1 +1 @@
1
- {"version":3,"file":"variant-memory.d.ts","sourceRoot":"","sources":["../../src/reader/variant-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAUvG;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9F"}
1
+ {"version":3,"file":"variant-memory.d.ts","sourceRoot":"","sources":["../../src/reader/variant-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAUvG;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9F"}
@@ -1,3 +1,4 @@
1
+ import { ownEntry } from "./own-entry.js";
1
2
  /**
2
3
  * Records that the reader has now experienced `branchId` of `variantId`,
3
4
  * returning a new `ReaderState`. Pure — `reader` is never mutated.
@@ -8,7 +9,7 @@
8
9
  * the reader.
9
10
  */
10
11
  export function recordVariantSeen(reader, variantId, branchId) {
11
- const previous = reader.seenVariants[variantId];
12
+ const previous = ownEntry(reader.seenVariants, variantId);
12
13
  const memory = previous
13
14
  ? { firstSeenBranchId: previous.firstSeenBranchId, lastSeenBranchId: branchId, seenCount: previous.seenCount + 1 }
14
15
  : { firstSeenBranchId: branchId, lastSeenBranchId: branchId, seenCount: 1 };
@@ -23,26 +24,26 @@ export function recordVariantSeen(reader, variantId, branchId) {
23
24
  * query — it never records anything itself (see `recordVariantSeen`).
24
25
  */
25
26
  export function hasVariantChangedSinceRead(reader, variantId, currentBranchId) {
26
- const previous = reader.seenVariants[variantId];
27
+ const previous = ownEntry(reader.seenVariants, variantId);
27
28
  if (!previous)
28
29
  return false;
29
30
  return previous.lastSeenBranchId !== currentBranchId;
30
31
  }
31
32
  /**
32
33
  * Whether the reader has ever seen `variantId` at least once. Backs the
33
- * `seen_variant(...)` Reader Memory query (docs/PROJECT_SPEC.md Section
34
+ * `seen_variant(...)` Reader Memory query (docs/CORE_SPEC.md Section
34
35
  * 17.15). A pure query — it never records anything itself.
35
36
  */
36
37
  export function hasSeenVariant(reader, variantId) {
37
- return reader.seenVariants[variantId] !== undefined;
38
+ return ownEntry(reader.seenVariants, variantId) !== undefined;
38
39
  }
39
40
  /**
40
41
  * The branch id the reader most recently saw for `variantId`, or `null`
41
42
  * if it has never been seen. Backs the `last_seen_variant_branch(...)`
42
- * Reader Memory query (docs/PROJECT_SPEC.md Section 17.15). A pure query —
43
+ * Reader Memory query (docs/CORE_SPEC.md Section 17.15). A pure query —
43
44
  * it never records anything itself.
44
45
  */
45
46
  export function getLastSeenVariantBranch(reader, variantId) {
46
- return reader.seenVariants[variantId]?.lastSeenBranchId ?? null;
47
+ return ownEntry(reader.seenVariants, variantId)?.lastSeenBranchId ?? null;
47
48
  }
48
49
  //# sourceMappingURL=variant-memory.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"variant-memory.js","sourceRoot":"","sources":["../../src/reader/variant-memory.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,SAAiB,EAAE,QAAgB;IACxF,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,MAAM,GAAkB,QAAQ;QACpC,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE;QAClH,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE9E,OAAO;QACL,GAAG,MAAM;QACT,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE;KAC9D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAmB,EACnB,SAAiB,EACjB,eAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,gBAAgB,KAAK,eAAe,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,SAAiB;IACnE,OAAO,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAmB,EAAE,SAAiB;IAC7E,OAAO,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,gBAAgB,IAAI,IAAI,CAAC;AAClE,CAAC"}
1
+ {"version":3,"file":"variant-memory.js","sourceRoot":"","sources":["../../src/reader/variant-memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAc1C;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,SAAiB,EAAE,QAAgB;IACxF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAkB,QAAQ;QACpC,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE;QAClH,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE9E,OAAO;QACL,GAAG,MAAM;QACT,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE;KAC9D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAmB,EACnB,SAAiB,EACjB,eAAuB;IAEvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,gBAAgB,KAAK,eAAe,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,SAAiB;IACnE,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,KAAK,SAAS,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAmB,EAAE,SAAiB;IAC7E,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,gBAAgB,IAAI,IAAI,CAAC;AAC5E,CAAC"}
@@ -2,7 +2,7 @@ import type { SceneVisitMemory } from "../reader/scene-memory.js";
2
2
  import type { VariantMemory } from "../reader/variant-memory.js";
3
3
  /**
4
4
  * Facts about what the reader has experienced — distinct from `StoryState`
5
- * (the current truth of the story world). See `docs/PROJECT_SPEC.md`:
5
+ * (the current truth of the story world). See `docs/CORE_SPEC.md`:
6
6
  * `StoryState != ReaderState` is a locked architectural requirement.
7
7
  *
8
8
  * `VariantMemory` is nested here rather than being an independent
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aftertext/runtime",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "description": "AfterText runtime domain foundation: StoryState, ReaderState, and NavigationState derived from a compiled StoryDocument.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -30,7 +30,7 @@
30
30
  "test": "vitest run"
31
31
  },
32
32
  "dependencies": {
33
- "@aftertext/compiler": "^0.1.0"
33
+ "@aftertext/compiler": "^0.3.0"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@types/node": "^22.7.5",