@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.
- package/README.md +1 -1
- package/dist/execution/advance.d.ts +2 -2
- package/dist/execution/advance.d.ts.map +1 -1
- package/dist/execution/advance.js +22 -4
- package/dist/execution/advance.js.map +1 -1
- package/dist/execution/choice.d.ts +1 -1
- package/dist/execution/choice.js +1 -1
- package/dist/execution/cursor.d.ts +3 -3
- package/dist/execution/errors.d.ts +3 -2
- package/dist/execution/errors.d.ts.map +1 -1
- package/dist/execution/errors.js +3 -0
- package/dist/execution/errors.js.map +1 -1
- package/dist/execution/expression.d.ts +2 -2
- package/dist/execution/memory-queries.d.ts +1 -1
- package/dist/execution/memory-queries.d.ts.map +1 -1
- package/dist/execution/memory-queries.js +4 -3
- package/dist/execution/memory-queries.js.map +1 -1
- package/dist/execution/navigate.d.ts +7 -3
- package/dist/execution/navigate.d.ts.map +1 -1
- package/dist/execution/navigate.js +7 -3
- package/dist/execution/navigate.js.map +1 -1
- package/dist/execution/result.d.ts +13 -3
- package/dist/execution/result.d.ts.map +1 -1
- package/dist/execution/variant.d.ts +1 -1
- package/dist/execution/variant.js +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/reader/own-entry.d.ts +8 -0
- package/dist/reader/own-entry.d.ts.map +1 -0
- package/dist/reader/own-entry.js +10 -0
- package/dist/reader/own-entry.js.map +1 -0
- package/dist/reader/scene-memory.d.ts.map +1 -1
- package/dist/reader/scene-memory.js +4 -3
- package/dist/reader/scene-memory.js.map +1 -1
- package/dist/reader/variant-memory.d.ts +3 -3
- package/dist/reader/variant-memory.d.ts.map +1 -1
- package/dist/reader/variant-memory.js +7 -6
- package/dist/reader/variant-memory.js.map +1 -1
- package/dist/state/reader-state.d.ts +1 -1
- 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.
|
|
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/
|
|
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/
|
|
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;
|
|
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/
|
|
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
|
|
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/
|
|
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).
|
package/dist/execution/choice.js
CHANGED
|
@@ -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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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;
|
|
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"}
|
package/dist/execution/errors.js
CHANGED
|
@@ -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":"
|
|
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/
|
|
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/
|
|
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/
|
|
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,
|
|
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/
|
|
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/
|
|
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
|
-
|
|
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":"AAGA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C;;;;;;GAMG;AACH,MAAM,cAAc,GAAqI;IACvJ,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IAC7E,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IACpF,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IACnF,wBAAwB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;CAC1G,CAAC;AAEF,SAAS,WAAW,CAAC,QAAuB,EAAE,OAAe;IAC3D,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,+GAA+G;AAC/G,SAAS,eAAe,CAAC,MAA6B,EAAE,SAAiB;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACxC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC7D,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACxC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,QAAuB,EAAE,SAAiB;IAC/D,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAoB,EACpB,QAAuB,EACvB,MAAmB;IAEnB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;
|
|
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/
|
|
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;
|
|
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/
|
|
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
|
|
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/
|
|
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;
|
|
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/
|
|
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/
|
|
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";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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;
|
|
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;
|
|
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
|
|
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
|
|
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
|
|
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":"
|
|
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/
|
|
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/
|
|
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/
|
|
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;
|
|
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
|
|
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
|
|
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/
|
|
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
|
|
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/
|
|
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
|
|
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":"
|
|
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/
|
|
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.
|
|
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.
|
|
33
|
+
"@aftertext/compiler": "^0.3.0"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
36
36
|
"@types/node": "^22.7.5",
|