@aftertext/compiler 0.0.0-stage → 0.1.1

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 (99) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +68 -2
  3. package/dist/ast/expression.d.ts +55 -0
  4. package/dist/ast/expression.d.ts.map +1 -0
  5. package/dist/ast/expression.js +2 -0
  6. package/dist/ast/expression.js.map +1 -0
  7. package/dist/ast/index.d.ts +6 -0
  8. package/dist/ast/index.d.ts.map +1 -0
  9. package/dist/ast/index.js +2 -0
  10. package/dist/ast/index.js.map +1 -0
  11. package/dist/ast/inline.d.ts +39 -0
  12. package/dist/ast/inline.d.ts.map +1 -0
  13. package/dist/ast/inline.js +2 -0
  14. package/dist/ast/inline.js.map +1 -0
  15. package/dist/ast/presentation.d.ts +41 -0
  16. package/dist/ast/presentation.d.ts.map +1 -0
  17. package/dist/ast/presentation.js +8 -0
  18. package/dist/ast/presentation.js.map +1 -0
  19. package/dist/ast/span.d.ts +19 -0
  20. package/dist/ast/span.d.ts.map +1 -0
  21. package/dist/ast/span.js +2 -0
  22. package/dist/ast/span.js.map +1 -0
  23. package/dist/ast/story.d.ts +354 -0
  24. package/dist/ast/story.d.ts.map +1 -0
  25. package/dist/ast/story.js +2 -0
  26. package/dist/ast/story.js.map +1 -0
  27. package/dist/compile.d.ts +25 -0
  28. package/dist/compile.d.ts.map +1 -0
  29. package/dist/compile.js +19 -0
  30. package/dist/compile.js.map +1 -0
  31. package/dist/diagnostics/codes.d.ts +26 -0
  32. package/dist/diagnostics/codes.d.ts.map +1 -0
  33. package/dist/diagnostics/codes.js +69 -0
  34. package/dist/diagnostics/codes.js.map +1 -0
  35. package/dist/diagnostics/index.d.ts +3 -0
  36. package/dist/diagnostics/index.d.ts.map +1 -0
  37. package/dist/diagnostics/index.js +2 -0
  38. package/dist/diagnostics/index.js.map +1 -0
  39. package/dist/diagnostics/types.d.ts +19 -0
  40. package/dist/diagnostics/types.d.ts.map +1 -0
  41. package/dist/diagnostics/types.js +2 -0
  42. package/dist/diagnostics/types.js.map +1 -0
  43. package/dist/index.d.ts +5 -0
  44. package/dist/index.d.ts.map +1 -0
  45. package/dist/index.js +11 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/parser/blocks.d.ts +40 -0
  48. package/dist/parser/blocks.d.ts.map +1 -0
  49. package/dist/parser/blocks.js +927 -0
  50. package/dist/parser/blocks.js.map +1 -0
  51. package/dist/parser/directive-line.d.ts +21 -0
  52. package/dist/parser/directive-line.d.ts.map +1 -0
  53. package/dist/parser/directive-line.js +50 -0
  54. package/dist/parser/directive-line.js.map +1 -0
  55. package/dist/parser/document.d.ts +13 -0
  56. package/dist/parser/document.d.ts.map +1 -0
  57. package/dist/parser/document.js +28 -0
  58. package/dist/parser/document.js.map +1 -0
  59. package/dist/parser/expression-lexer.d.ts +44 -0
  60. package/dist/parser/expression-lexer.d.ts.map +1 -0
  61. package/dist/parser/expression-lexer.js +166 -0
  62. package/dist/parser/expression-lexer.js.map +1 -0
  63. package/dist/parser/expression-parser.d.ts +13 -0
  64. package/dist/parser/expression-parser.d.ts.map +1 -0
  65. package/dist/parser/expression-parser.js +201 -0
  66. package/dist/parser/expression-parser.js.map +1 -0
  67. package/dist/parser/frontmatter.d.ts +23 -0
  68. package/dist/parser/frontmatter.d.ts.map +1 -0
  69. package/dist/parser/frontmatter.js +158 -0
  70. package/dist/parser/frontmatter.js.map +1 -0
  71. package/dist/parser/index.d.ts +2 -0
  72. package/dist/parser/index.d.ts.map +1 -0
  73. package/dist/parser/index.js +2 -0
  74. package/dist/parser/index.js.map +1 -0
  75. package/dist/parser/lexical-primitives.d.ts +38 -0
  76. package/dist/parser/lexical-primitives.d.ts.map +1 -0
  77. package/dist/parser/lexical-primitives.js +46 -0
  78. package/dist/parser/lexical-primitives.js.map +1 -0
  79. package/dist/parser/lines.d.ts +32 -0
  80. package/dist/parser/lines.d.ts.map +1 -0
  81. package/dist/parser/lines.js +60 -0
  82. package/dist/parser/lines.js.map +1 -0
  83. package/dist/parser/markdown.d.ts +19 -0
  84. package/dist/parser/markdown.d.ts.map +1 -0
  85. package/dist/parser/markdown.js +221 -0
  86. package/dist/parser/markdown.js.map +1 -0
  87. package/dist/parser/serializer-safety.d.ts +57 -0
  88. package/dist/parser/serializer-safety.d.ts.map +1 -0
  89. package/dist/parser/serializer-safety.js +66 -0
  90. package/dist/parser/serializer-safety.js.map +1 -0
  91. package/dist/validation/index.d.ts +2 -0
  92. package/dist/validation/index.d.ts.map +1 -0
  93. package/dist/validation/index.js +2 -0
  94. package/dist/validation/index.js.map +1 -0
  95. package/dist/validation/validate.d.ts +4 -0
  96. package/dist/validation/validate.d.ts.map +1 -0
  97. package/dist/validation/validate.js +221 -0
  98. package/dist/validation/validate.js.map +1 -0
  99. package/package.json +43 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"expression-parser.js","sourceRoot":"","sources":["../../src/parser/expression-parser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { StoryMetadata, StoryStateDefinition } from "../ast/story.js";
2
+ import type { Diagnostic } from "../diagnostics/types.js";
3
+ import { type SourceLine } from "./lines.js";
4
+ export interface FrontmatterResult {
5
+ readonly metadata: StoryMetadata;
6
+ readonly initialState: StoryStateDefinition;
7
+ /** Source lines that remain to be parsed as the story body. */
8
+ readonly bodyLines: readonly SourceLine[];
9
+ readonly diagnostics: Diagnostic[];
10
+ }
11
+ /**
12
+ * Extracts and parses a leading `--- ... ---` YAML frontmatter block, if
13
+ * present, normalizing it into a StoryMetadata plus a first-class initial
14
+ * state map. Unsupported state values (arrays, nested objects, YAML
15
+ * timestamps/binary/aliases, ...) are reported as AT1201 diagnostics and
16
+ * dropped from the state map rather than throwing. If the YAML itself has
17
+ * syntax errors, only AT1202 is reported for `state:` — semantic
18
+ * validation of its (possibly parser-recovered, unreliable) contents is
19
+ * skipped to avoid a misleading AT1201 cascade. Returns the remaining
20
+ * body lines (frontmatter stripped) for the block parser to consume.
21
+ */
22
+ export declare function extractFrontmatter(source: string): FrontmatterResult;
23
+ //# sourceMappingURL=frontmatter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAgD,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;CACpC;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAgHpE"}
@@ -0,0 +1,158 @@
1
+ import { isMap, isScalar, LineCounter, parseDocument } from "yaml";
2
+ import { Diagnostics } from "../diagnostics/codes.js";
3
+ import { variableNameProblem } from "./expression-lexer.js";
4
+ import { joinLineText, lineEnd, lineStart, splitLines } from "./lines.js";
5
+ const DELIMITER = "---";
6
+ /** A YAML scalar resolving to one of v0.1's allowed initial-state value types. */
7
+ function isAllowedScalarNode(node) {
8
+ if (!node || !isScalar(node))
9
+ return false;
10
+ const value = node.value;
11
+ return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
12
+ }
13
+ function keyName(key) {
14
+ return isScalar(key) ? String(key.value) : String(key);
15
+ }
16
+ /**
17
+ * The state key exactly as the author wrote it. The YAML core schema reads an
18
+ * unquoted `TRUE`, `False`, `Null`, or `~` as a boolean/null and `0x10` as a
19
+ * number, so `String(key.value)` would silently turn the declared key `TRUE`
20
+ * into `"true"`. For plain scalars the original source text is the key; quoted
21
+ * scalars already carry their text as the value.
22
+ */
23
+ function stateKeyName(key) {
24
+ if (isScalar(key) && key.type === "PLAIN" && typeof key.source === "string")
25
+ return key.source;
26
+ return keyName(key);
27
+ }
28
+ /**
29
+ * `__proto__` is rejected as a state key, but not as a `@set` name: assigned
30
+ * through the plain-object initial-state map it would silently vanish (or,
31
+ * for `null`, change the map's prototype), so the declaration could not be
32
+ * trusted to round-trip. See CORE_SPEC Section 12.
33
+ */
34
+ const FORBIDDEN_STATE_KEY = "__proto__";
35
+ /** The reason a frontmatter `state:` key is not a valid state variable name, if any. */
36
+ function stateKeyProblem(key) {
37
+ if (key === FORBIDDEN_STATE_KEY)
38
+ return `"${FORBIDDEN_STATE_KEY}" is not allowed as a state key.`;
39
+ switch (variableNameProblem(key)) {
40
+ case "invalid-identifier":
41
+ return "state keys must match [A-Za-z_][A-Za-z0-9_]*.";
42
+ case "reserved-literal":
43
+ return `"${key}" is a reserved literal and cannot be a state variable name.`;
44
+ default:
45
+ return undefined;
46
+ }
47
+ }
48
+ /**
49
+ * Extracts and parses a leading `--- ... ---` YAML frontmatter block, if
50
+ * present, normalizing it into a StoryMetadata plus a first-class initial
51
+ * state map. Unsupported state values (arrays, nested objects, YAML
52
+ * timestamps/binary/aliases, ...) are reported as AT1201 diagnostics and
53
+ * dropped from the state map rather than throwing. If the YAML itself has
54
+ * syntax errors, only AT1202 is reported for `state:` — semantic
55
+ * validation of its (possibly parser-recovered, unreliable) contents is
56
+ * skipped to avoid a misleading AT1201 cascade. Returns the remaining
57
+ * body lines (frontmatter stripped) for the block parser to consume.
58
+ */
59
+ export function extractFrontmatter(source) {
60
+ const lines = splitLines(source);
61
+ const diagnostics = [];
62
+ const emptyMetadata = { title: undefined, entry: undefined, span: undefined };
63
+ const empty = { metadata: emptyMetadata, initialState: {}, bodyLines: lines, diagnostics };
64
+ if (lines.length === 0 || lines[0].text.trim() !== DELIMITER) {
65
+ return empty;
66
+ }
67
+ let closingIndex = -1;
68
+ for (let i = 1; i < lines.length; i++) {
69
+ if (lines[i].text.trim() === DELIMITER) {
70
+ closingIndex = i;
71
+ break;
72
+ }
73
+ }
74
+ if (closingIndex === -1) {
75
+ // No closing delimiter: treat the whole thing as body (best-effort recovery).
76
+ return empty;
77
+ }
78
+ const openLine = lines[0];
79
+ const closeLine = lines[closingIndex];
80
+ const yamlLines = lines.slice(1, closingIndex);
81
+ const yamlText = joinLineText(yamlLines);
82
+ const span = { start: lineStart(openLine), end: lineEnd(closeLine) };
83
+ const bodyLines = lines.slice(closingIndex + 1);
84
+ const anchorLine = yamlLines.length > 0 ? yamlLines[0].number : openLine.number + 1;
85
+ const anchorOffset = yamlLines.length > 0 ? yamlLines[0].startOffset : closeLine.startOffset;
86
+ const lineCounter = new LineCounter();
87
+ const doc = parseDocument(yamlText, { lineCounter, prettyErrors: false });
88
+ function positionAt(offset) {
89
+ const local = lineCounter.linePos(offset);
90
+ return { line: anchorLine + (local.line - 1), column: local.col, offset: anchorOffset + offset };
91
+ }
92
+ function spanOfNode(node) {
93
+ const range = node.range;
94
+ if (!range) {
95
+ const fallback = positionAt(0);
96
+ return { start: fallback, end: fallback };
97
+ }
98
+ return { start: positionAt(range[0]), end: positionAt(range[1]) };
99
+ }
100
+ // YAML syntax errors (e.g. an unclosed flow sequence) don't throw — the
101
+ // `yaml` package collects them here and still returns a best-effort,
102
+ // partially-resolved document. Surface each as an AT1202 diagnostic
103
+ // rather than silently continuing on possibly-broken content.
104
+ const hasYamlSyntaxErrors = doc.errors.length > 0;
105
+ for (const error of doc.errors) {
106
+ const errorSpan = { start: positionAt(error.pos[0]), end: positionAt(error.pos[1]) };
107
+ diagnostics.push(Diagnostics.invalidFrontmatter(error.message, errorSpan));
108
+ }
109
+ let title;
110
+ let entry;
111
+ const state = {};
112
+ if (isMap(doc.contents)) {
113
+ for (const pair of doc.contents.items) {
114
+ const key = keyName(pair.key);
115
+ const value = pair.value;
116
+ if (key === "title" && isAllowedScalarNode(value) && typeof value.value === "string") {
117
+ title = value.value;
118
+ }
119
+ else if (key === "entry" && isAllowedScalarNode(value) && typeof value.value === "string") {
120
+ entry = value.value;
121
+ }
122
+ else if (key === "state" && !hasYamlSyntaxErrors) {
123
+ // Skip semantic validation of `state:` entirely when the YAML
124
+ // itself failed to parse cleanly — the tree the parser recovers
125
+ // around a syntax error doesn't reflect the author's intent, and
126
+ // validating it would only produce misleading AT1201 diagnostics
127
+ // cascading from the real AT1202 syntax error.
128
+ if (value && isMap(value)) {
129
+ for (const statePair of value.items) {
130
+ const stateKey = stateKeyName(statePair.key);
131
+ const stateValue = statePair.value;
132
+ const keyProblem = stateKeyProblem(stateKey);
133
+ if (keyProblem !== undefined) {
134
+ // One diagnostic per bad entry, on the key itself; the entry is
135
+ // dropped so the initial state never holds an unreferenceable key.
136
+ const keyNode = statePair.key;
137
+ diagnostics.push(Diagnostics.unsupportedStateKey(stateKey, keyProblem, spanOfNode(keyNode ?? stateValue ?? value)));
138
+ }
139
+ else if (isAllowedScalarNode(stateValue)) {
140
+ state[stateKey] = stateValue.value;
141
+ }
142
+ else {
143
+ diagnostics.push(Diagnostics.unsupportedStateValue(stateKey, spanOfNode(stateValue ?? value)));
144
+ }
145
+ }
146
+ }
147
+ else if (value && !(isScalar(value) && value.value === null)) {
148
+ // `state:` with no value at all resolves to a null scalar — treated
149
+ // as "no initial state", not a malformed declaration.
150
+ diagnostics.push(Diagnostics.unsupportedStateValue("state", spanOfNode(value)));
151
+ }
152
+ }
153
+ }
154
+ }
155
+ const metadata = { title, entry, span };
156
+ return { metadata, initialState: state, bodyLines, diagnostics };
157
+ }
158
+ //# sourceMappingURL=frontmatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { parseDocument, type ParseResult } from "./document.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { parseDocument } from "./document.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,eAAe,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Pure, dependency-free lexical facts shared between the block parser
3
+ * (`blocks.ts`) and the public serializer-safety predicates
4
+ * (`serializer-safety.ts`, docs/CORE_SPEC.md Section 25.40's "Serializer
5
+ * Injection Safety Amendment"). Deliberately has zero imports — in
6
+ * particular, no `remark`/`mdast` dependency — so it can be safely reached
7
+ * from the public compiler surface (`src/index.ts`) without pulling in
8
+ * anything `parseProseChunk`/`markdown.ts` needs.
9
+ *
10
+ * `blocks.ts` and `serializer-safety.ts` both import these two facts from
11
+ * here rather than each defining/scanning for them independently, so the
12
+ * parser's actual tokenization behavior and the tooling-facing boundary-
13
+ * safety predicates cannot silently drift apart.
14
+ */
15
+ /**
16
+ * The exact separator-whitespace definition Presentation argument
17
+ * tokenization (`tokenizePresentationArgs`) and Choice tail parsing
18
+ * (`CHOICE_TAIL_PATTERN`'s `if`-separator) both use to recognize a token
19
+ * boundary — expressed as raw regex source so it can be interpolated into a
20
+ * larger composite pattern (`CHOICE_TAIL_PATTERN`) as well as used directly
21
+ * via `SEPARATOR_WHITESPACE_PATTERN`. Keeping one source string, rather than
22
+ * a hardcoded `\s` duplicated at each use site, is what makes it a true
23
+ * single source of truth — a `RegExp` object alone cannot be spliced into
24
+ * another pattern's literal source.
25
+ */
26
+ export declare const SEPARATOR_WHITESPACE_SOURCE: string;
27
+ /** The exact separator-whitespace definition Presentation argument tokenization (`tokenizePresentationArgs`) and Choice tail parsing both use to recognize a token boundary. */
28
+ export declare const SEPARATOR_WHITESPACE_PATTERN: RegExp;
29
+ /**
30
+ * Finds the last `->` in `text` that isn't escaped as `\->`, scanning left
31
+ * to right so an escaped arrow inside display text (`A \-> B`) is skipped
32
+ * and only a real, unescaped arrow can act as the Choice item delimiter.
33
+ * Using the *last* unescaped arrow (rather than the first) means display
34
+ * text is free to contain its own literal `->` via escaping without
35
+ * confusing the split. Returns -1 if no unescaped arrow exists.
36
+ */
37
+ export declare function findLastUnescapedArrow(text: string): number;
38
+ //# sourceMappingURL=lexical-primitives.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lexical-primitives.d.ts","sourceRoot":"","sources":["../../src/parser/lexical-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAE1D,gLAAgL;AAChL,eAAO,MAAM,4BAA4B,QAA0C,CAAC;AAEpF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ3D"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Pure, dependency-free lexical facts shared between the block parser
3
+ * (`blocks.ts`) and the public serializer-safety predicates
4
+ * (`serializer-safety.ts`, docs/CORE_SPEC.md Section 25.40's "Serializer
5
+ * Injection Safety Amendment"). Deliberately has zero imports — in
6
+ * particular, no `remark`/`mdast` dependency — so it can be safely reached
7
+ * from the public compiler surface (`src/index.ts`) without pulling in
8
+ * anything `parseProseChunk`/`markdown.ts` needs.
9
+ *
10
+ * `blocks.ts` and `serializer-safety.ts` both import these two facts from
11
+ * here rather than each defining/scanning for them independently, so the
12
+ * parser's actual tokenization behavior and the tooling-facing boundary-
13
+ * safety predicates cannot silently drift apart.
14
+ */
15
+ /**
16
+ * The exact separator-whitespace definition Presentation argument
17
+ * tokenization (`tokenizePresentationArgs`) and Choice tail parsing
18
+ * (`CHOICE_TAIL_PATTERN`'s `if`-separator) both use to recognize a token
19
+ * boundary — expressed as raw regex source so it can be interpolated into a
20
+ * larger composite pattern (`CHOICE_TAIL_PATTERN`) as well as used directly
21
+ * via `SEPARATOR_WHITESPACE_PATTERN`. Keeping one source string, rather than
22
+ * a hardcoded `\s` duplicated at each use site, is what makes it a true
23
+ * single source of truth — a `RegExp` object alone cannot be spliced into
24
+ * another pattern's literal source.
25
+ */
26
+ export const SEPARATOR_WHITESPACE_SOURCE = String.raw `\s`;
27
+ /** The exact separator-whitespace definition Presentation argument tokenization (`tokenizePresentationArgs`) and Choice tail parsing both use to recognize a token boundary. */
28
+ export const SEPARATOR_WHITESPACE_PATTERN = new RegExp(SEPARATOR_WHITESPACE_SOURCE);
29
+ /**
30
+ * Finds the last `->` in `text` that isn't escaped as `\->`, scanning left
31
+ * to right so an escaped arrow inside display text (`A \-> B`) is skipped
32
+ * and only a real, unescaped arrow can act as the Choice item delimiter.
33
+ * Using the *last* unescaped arrow (rather than the first) means display
34
+ * text is free to contain its own literal `->` via escaping without
35
+ * confusing the split. Returns -1 if no unescaped arrow exists.
36
+ */
37
+ export function findLastUnescapedArrow(text) {
38
+ let lastIndex = -1;
39
+ for (let i = 0; i < text.length - 1; i++) {
40
+ if (text[i] === "-" && text[i + 1] === ">" && text[i - 1] !== "\\") {
41
+ lastIndex = i;
42
+ }
43
+ }
44
+ return lastIndex;
45
+ }
46
+ //# sourceMappingURL=lexical-primitives.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lexical-primitives.js","sourceRoot":"","sources":["../../src/parser/lexical-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,GAAG,CAAA,IAAI,CAAC;AAE1D,gLAAgL;AAChL,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnE,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
@@ -0,0 +1,32 @@
1
+ import type { SourcePosition } from "../ast/span.js";
2
+ /** One physical line of source, with its absolute offsets in the full source string. */
3
+ export interface SourceLine {
4
+ /** 1-based line number. */
5
+ readonly number: number;
6
+ /** Offset of the first character of this line (before any trailing \r\n stripping). */
7
+ readonly startOffset: number;
8
+ /** Offset just past the last content character, excluding the line terminator. */
9
+ readonly endOffset: number;
10
+ /** Line text with any trailing \r\n / \n stripped. */
11
+ readonly text: string;
12
+ /** Length of the line terminator that followed this line: 0, 1 (\n) or 2 (\r\n). */
13
+ readonly newlineLength: 0 | 1 | 2;
14
+ }
15
+ /**
16
+ * Splits source into lines while tracking absolute offsets, so downstream
17
+ * AST nodes can carry accurate SourceSpans back into the original text.
18
+ */
19
+ export declare function splitLines(source: string): SourceLine[];
20
+ /** The position of the start of a line (column 1). */
21
+ export declare function lineStart(line: SourceLine): SourcePosition;
22
+ /** The position just past the end of a line's content. */
23
+ export declare function lineEnd(line: SourceLine): SourcePosition;
24
+ /**
25
+ * Reconstructs the exact original source text spanned by a contiguous run
26
+ * of lines (including original line terminators), so it can be re-parsed
27
+ * (e.g. by remark) with offsets that stay in lockstep with the full source.
28
+ */
29
+ export declare function joinLineText(lines: readonly SourceLine[]): string;
30
+ /** Position of a given 0-based character index within a line's text. */
31
+ export declare function positionAt(line: SourceLine, charIndex: number): SourcePosition;
32
+ //# sourceMappingURL=lines.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../src/parser/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CA0BvD;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAE1D;AAED,0DAA0D;AAC1D,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAIjE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAM9E"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Splits source into lines while tracking absolute offsets, so downstream
3
+ * AST nodes can carry accurate SourceSpans back into the original text.
4
+ */
5
+ export function splitLines(source) {
6
+ const lines = [];
7
+ let start = 0;
8
+ let lineNumber = 1;
9
+ for (let i = 0; i <= source.length; i++) {
10
+ if (i === source.length || source[i] === "\n") {
11
+ let end = i;
12
+ let newlineLength = i === source.length ? 0 : 1;
13
+ if (end > start && source[end - 1] === "\r") {
14
+ end -= 1;
15
+ newlineLength = 2;
16
+ }
17
+ lines.push({
18
+ number: lineNumber,
19
+ startOffset: start,
20
+ endOffset: end,
21
+ text: source.slice(start, end),
22
+ newlineLength
23
+ });
24
+ lineNumber += 1;
25
+ start = i + 1;
26
+ }
27
+ }
28
+ return lines;
29
+ }
30
+ /** The position of the start of a line (column 1). */
31
+ export function lineStart(line) {
32
+ return { line: line.number, column: 1, offset: line.startOffset };
33
+ }
34
+ /** The position just past the end of a line's content. */
35
+ export function lineEnd(line) {
36
+ return {
37
+ line: line.number,
38
+ column: line.endOffset - line.startOffset + 1,
39
+ offset: line.endOffset
40
+ };
41
+ }
42
+ /**
43
+ * Reconstructs the exact original source text spanned by a contiguous run
44
+ * of lines (including original line terminators), so it can be re-parsed
45
+ * (e.g. by remark) with offsets that stay in lockstep with the full source.
46
+ */
47
+ export function joinLineText(lines) {
48
+ return lines
49
+ .map((line) => line.text + (line.newlineLength === 2 ? "\r\n" : line.newlineLength === 1 ? "\n" : ""))
50
+ .join("");
51
+ }
52
+ /** Position of a given 0-based character index within a line's text. */
53
+ export function positionAt(line, charIndex) {
54
+ return {
55
+ line: line.number,
56
+ column: charIndex + 1,
57
+ offset: line.startOffset + charIndex
58
+ };
59
+ }
60
+ //# sourceMappingURL=lines.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/parser/lines.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,IAAI,aAAa,GAAc,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,IAAI,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC5C,GAAG,IAAI,CAAC,CAAC;gBACT,aAAa,GAAG,CAAC,CAAC;YACpB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,UAAU;gBAClB,WAAW,EAAE,KAAK;gBAClB,SAAS,EAAE,GAAG;gBACd,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;gBAC9B,aAAa;aACd,CAAC,CAAC;YACH,UAAU,IAAI,CAAC,CAAC;YAChB,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;AACpE,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,OAAO,CAAC,IAAgB;IACtC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,MAAM,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC;QAC7C,MAAM,EAAE,IAAI,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAA4B;IACvD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACrG,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,SAAiB;IAC5D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,MAAM,EAAE,SAAS,GAAG,CAAC;QACrB,MAAM,EAAE,IAAI,CAAC,WAAW,GAAG,SAAS;KACrC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { StoryBlock } from "../ast/story.js";
2
+ import type { Diagnostic } from "../diagnostics/types.js";
3
+ interface ChunkAnchor {
4
+ /** 1-based line number of the chunk's first line in the full document. */
5
+ readonly startLine: number;
6
+ /** Absolute character offset of the chunk's first character in the full document. */
7
+ readonly startOffset: number;
8
+ }
9
+ /**
10
+ * Parses a contiguous run of prose source text (already known to contain no
11
+ * AfterText directives) as Markdown, converting the result into
12
+ * AfterText-owned StoryBlock nodes anchored back to the full document via
13
+ * `anchor`. Constructs outside v0.1's supported subset (lists, blockquotes,
14
+ * images, code blocks, ...) still fall back to flattened plain text, but
15
+ * emit an AT3001 warning rather than changing document meaning silently.
16
+ */
17
+ export declare function parseProseChunk(text: string, anchor: ChunkAnchor, diagnostics: Diagnostic[]): StoryBlock[];
18
+ export type { ChunkAnchor };
19
+ //# sourceMappingURL=markdown.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/parser/markdown.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAA8B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAY1D,UAAU,WAAW;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AA6ND;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAI1G;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}