squiffy-compiler 7.0.0-beta.5 → 7.0.0-beta.6
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 +10 -2
- package/dist/analyse.d.ts +3 -0
- package/dist/analyse.js +59 -11
- package/dist/compiler.d.ts +8 -2
- package/dist/compiler.js +4 -2
- package/dist/emit.d.ts +6 -0
- package/dist/emit.js +17 -1
- package/dist/language-service.js +17 -3
- package/dist/node.d.ts +7 -1
- package/dist/node.js +16 -5
- package/dist/parse.js +11 -2
- package/dist/project.d.ts +54 -0
- package/dist/project.js +145 -15
- package/dist/quest/aslx.d.ts +50 -0
- package/dist/quest/aslx.js +181 -0
- package/dist/quest/convert.d.ts +20 -0
- package/dist/quest/convert.js +475 -0
- package/dist/quest/script.d.ts +92 -0
- package/dist/quest/script.js +453 -0
- package/dist/quest/scripts.d.ts +24 -0
- package/dist/quest/scripts.js +501 -0
- package/dist/quest/text.d.ts +17 -0
- package/dist/quest/text.js +305 -0
- package/dist/setters.js +3 -0
- package/dist/story-graph.d.ts +2 -1
- package/dist/story-graph.js +2 -0
- package/dist/syntax.d.ts +14 -2
- package/dist/text.d.ts +2 -0
- package/dist/text.js +7 -5
- package/dist/twine/convert.d.ts +7 -0
- package/dist/twine/convert.js +132 -14
- package/dist/twine/expression.d.ts +6 -0
- package/dist/twine/expression.js +14 -0
- package/dist/twine/harlowe.d.ts +1 -0
- package/dist/twine/harlowe.js +60 -4
- package/dist/twine/sugarcube.d.ts +1 -0
- package/dist/twine/sugarcube.js +45 -8
- package/dist/v5.js +2 -1
- package/package.json +3 -2
- package/syntaxes/squiffy.tmLanguage.json +1 -1
package/README.md
CHANGED
|
@@ -1,3 +1,11 @@
|
|
|
1
|
-
|
|
1
|
+
# squiffy-compiler
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Compiles Squiffy story files into JavaScript. See [the main README](../README.md) and the [docs](https://squiffystory.com).
|
|
4
|
+
|
|
5
|
+
## Tests
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm test
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
`test/fixtures/` has a small story for each feature. `compiler.test.ts` compiles each of them, and the complete stories in `../examples`, and compares the output with its snapshots. The fixtures have no `squiffy.json`, so they use Squiffy 6's rules for setters. `warnings/` has stories that should produce warnings.
|
package/dist/analyse.d.ts
CHANGED
|
@@ -35,6 +35,8 @@ export interface Analysis {
|
|
|
35
35
|
sections: SectionSymbol[];
|
|
36
36
|
start: string;
|
|
37
37
|
expressions: boolean;
|
|
38
|
+
stylesheets: string[];
|
|
39
|
+
scripts: string[];
|
|
38
40
|
}
|
|
39
41
|
export declare class Story {
|
|
40
42
|
sections: Record<string, Section>;
|
|
@@ -69,6 +71,7 @@ export declare class Passage extends TextContainer {
|
|
|
69
71
|
name: string;
|
|
70
72
|
line: number;
|
|
71
73
|
node: PassageNode;
|
|
74
|
+
repeat: boolean;
|
|
72
75
|
constructor(name: string, line: number, node: PassageNode);
|
|
73
76
|
}
|
|
74
77
|
export interface AnalysisInternals {
|
package/dist/analyse.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { parse } from "./parse.js";
|
|
2
2
|
import { positionMapper, transformText } from "./text.js";
|
|
3
|
-
import { PROJECT_FILENAME } from "./project.js";
|
|
3
|
+
import { isScriptPath, isSquiffyPath, isStylesheetPath, PROJECT_FILENAME } from "./project.js";
|
|
4
4
|
import { findV5Syntax } from "./v5.js";
|
|
5
5
|
import { attributesSetIn, BUILT_IN_ATTRIBUTES, findAtAttributes, findBuiltInAttributeSets, findUnquotedText } from "./setters.js";
|
|
6
6
|
// Caches the syntax tree of each file by filename, reparsing a file only when its text changes.
|
|
@@ -183,6 +183,13 @@ export class Passage extends TextContainer {
|
|
|
183
183
|
writable: true,
|
|
184
184
|
value: node
|
|
185
185
|
});
|
|
186
|
+
// @repeat: its links stay clickable (#104)
|
|
187
|
+
Object.defineProperty(this, "repeat", {
|
|
188
|
+
enumerable: true,
|
|
189
|
+
configurable: true,
|
|
190
|
+
writable: true,
|
|
191
|
+
value: false
|
|
192
|
+
});
|
|
186
193
|
}
|
|
187
194
|
}
|
|
188
195
|
export const analysisInternals = new WeakMap();
|
|
@@ -212,6 +219,23 @@ export async function analyse(settings) {
|
|
|
212
219
|
// The .squiffy files processed so far, so a story file the main file has already @imported
|
|
213
220
|
// isn't processed again
|
|
214
221
|
const processed = new Set();
|
|
222
|
+
// Files read by @ui, which in folder mode aren't added to the page as scripts too
|
|
223
|
+
const uiFiles = new Set();
|
|
224
|
+
// The .css and .js files added to the page so far, named as getMatchingFilenames names them
|
|
225
|
+
const stylesheetFiles = [];
|
|
226
|
+
const scriptFiles = [];
|
|
227
|
+
// Adds a stylesheet or script to the page. An @import adds it every time, as in Squiffy 6, but
|
|
228
|
+
// folder mode only adds one that isn't there already.
|
|
229
|
+
const addPageFile = (filename, externalFiles, imported) => {
|
|
230
|
+
const [names, local] = isStylesheetPath(filename)
|
|
231
|
+
? [stylesheetFiles, story.stylesheets]
|
|
232
|
+
: [scriptFiles, story.scripts];
|
|
233
|
+
if (names.includes(filename) && !imported)
|
|
234
|
+
return;
|
|
235
|
+
if (!names.includes(filename))
|
|
236
|
+
names.push(filename);
|
|
237
|
+
local.push(externalFiles.getLocalFilename(filename));
|
|
238
|
+
};
|
|
215
239
|
async function processFile(text, filename, isFirst) {
|
|
216
240
|
const file = cache.parse(text, filename);
|
|
217
241
|
files.push(file);
|
|
@@ -317,6 +341,13 @@ export async function analyse(settings) {
|
|
|
317
341
|
return true;
|
|
318
342
|
case "ui-file":
|
|
319
343
|
if (settings.externalFiles) {
|
|
344
|
+
// In folder mode, the file isn't also added to the page as a script, so it
|
|
345
|
+
// doesn't run twice. Its name is looked up before it's read, as reading it
|
|
346
|
+
// can leave it out of getMatchingFilenames.
|
|
347
|
+
if (storyFiles) {
|
|
348
|
+
for (const match of await settings.externalFiles.getMatchingFilenames(node.path))
|
|
349
|
+
uiFiles.add(match);
|
|
350
|
+
}
|
|
320
351
|
story.uiJs.push(await settings.externalFiles.getContent(node.path));
|
|
321
352
|
}
|
|
322
353
|
else {
|
|
@@ -334,6 +365,14 @@ export async function analyse(settings) {
|
|
|
334
365
|
passage.clear = true;
|
|
335
366
|
}
|
|
336
367
|
return true;
|
|
368
|
+
case "repeat":
|
|
369
|
+
if (!passage) {
|
|
370
|
+
report("warning", "squiffy/repeat-not-in-passage", filename, lineRange(node), "@repeat only works in a passage, so this was ignored.", lineCount);
|
|
371
|
+
}
|
|
372
|
+
else {
|
|
373
|
+
passage.repeat = true;
|
|
374
|
+
}
|
|
375
|
+
return true;
|
|
337
376
|
case "end":
|
|
338
377
|
// Only for the language service's dead end check
|
|
339
378
|
if (!passage) {
|
|
@@ -362,23 +401,18 @@ export async function analyse(settings) {
|
|
|
362
401
|
return true;
|
|
363
402
|
}
|
|
364
403
|
const matches = await settings.externalFiles.getMatchingFilenames(node.pattern);
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
&& squiffyMatches.every(m => storyFiles.has(m))) {
|
|
368
|
-
report("hint", "squiffy/redundant-import", filename, lineRange(node), `${squiffyMatches.length == 1 ? "This file is" : "These files are"} already part of the story, as ${PROJECT_FILENAME} includes every .squiffy file in the folder, so this @import isn't needed.`, lineCount);
|
|
404
|
+
if (storyFiles && matches.length && matches.every(m => storyFiles.has(m))) {
|
|
405
|
+
report("hint", "squiffy/redundant-import", filename, lineRange(node), `${matches.length == 1 ? "This file is" : "These files are"} already part of the story, as ${PROJECT_FILENAME} includes every .squiffy, .css and .js file in the folder, so this @import isn't needed.`, lineCount);
|
|
369
406
|
}
|
|
370
407
|
for (const importFilename of matches) {
|
|
371
|
-
if (importFilename
|
|
408
|
+
if (isSquiffyPath(importFilename)) {
|
|
372
409
|
const content = await settings.externalFiles.getContent(importFilename);
|
|
373
410
|
const success = await processFile(content, importFilename, false);
|
|
374
411
|
if (!success && !settings.recover)
|
|
375
412
|
return false;
|
|
376
413
|
}
|
|
377
|
-
else if (importFilename
|
|
378
|
-
|
|
379
|
-
}
|
|
380
|
-
else if (importFilename.endsWith(".css")) {
|
|
381
|
-
story.stylesheets.push(settings.externalFiles.getLocalFilename(importFilename));
|
|
414
|
+
else if (isStylesheetPath(importFilename) || isScriptPath(importFilename)) {
|
|
415
|
+
addPageFile(importFilename, settings.externalFiles, true);
|
|
382
416
|
}
|
|
383
417
|
}
|
|
384
418
|
return true;
|
|
@@ -552,6 +586,13 @@ export async function analyse(settings) {
|
|
|
552
586
|
warn("squiffy/unknown-goto", goto.start, goto.end, `${where} there is a {{goto "${goto.name}"}}, but no section with that name exists${passage}`);
|
|
553
587
|
}
|
|
554
588
|
}
|
|
589
|
+
// {{deactivate}} disables links to a passage in this section, or in the master section
|
|
590
|
+
const masterPassages = story.sections[""]?.passages ?? {};
|
|
591
|
+
for (const deactivate of result.deactivates) {
|
|
592
|
+
if (!(deactivate.name in section.passages) && !(deactivate.name in masterPassages)) {
|
|
593
|
+
warn("squiffy/unknown-deactivate", deactivate.start, deactivate.end, `${where} there is a {{deactivate "${deactivate.name}"}}, but no passage with that name exists in this section`);
|
|
594
|
+
}
|
|
595
|
+
}
|
|
555
596
|
}
|
|
556
597
|
// With recover, processFile carries on after errors, so check for them too
|
|
557
598
|
let success = await processFile(settings.script, settings.scriptBaseFilename, true);
|
|
@@ -565,6 +606,11 @@ export async function analyse(settings) {
|
|
|
565
606
|
report("warning", "squiffy/external-files-unavailable", settings.scriptBaseFilename, { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } }, "The story's other files were ignored, as other files can't be loaded here", 1);
|
|
566
607
|
break;
|
|
567
608
|
}
|
|
609
|
+
if (!isSquiffyPath(storyFile)) {
|
|
610
|
+
if (!uiFiles.has(storyFile))
|
|
611
|
+
addPageFile(storyFile, settings.externalFiles, false);
|
|
612
|
+
continue;
|
|
613
|
+
}
|
|
568
614
|
const content = await settings.externalFiles.getContent(storyFile);
|
|
569
615
|
success = await processFile(content, storyFile, false) && success;
|
|
570
616
|
}
|
|
@@ -606,6 +652,8 @@ export async function analyse(settings) {
|
|
|
606
652
|
})),
|
|
607
653
|
start: story.start,
|
|
608
654
|
expressions: settings.expressions ?? false,
|
|
655
|
+
stylesheets: stylesheetFiles,
|
|
656
|
+
scripts: scriptFiles,
|
|
609
657
|
};
|
|
610
658
|
analysisInternals.set(analysis, { story, legacyErrors, legacyWarnings });
|
|
611
659
|
return analysis;
|
package/dist/compiler.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { ExternalFiles, ParseCache } from "./analyse.js";
|
|
2
2
|
import { CompileSuccess } from "./emit.js";
|
|
3
3
|
import type { Diagnostic } from "./syntax.js";
|
|
4
|
+
import type { Panel } from "./project.js";
|
|
4
5
|
export { findV5Syntax, convertV5Syntax } from "./v5.js";
|
|
5
6
|
export type { V5SyntaxMatch, V5ConversionProblem, V5ConversionResult } from "./v5.js";
|
|
6
7
|
export { convertSetters, convertSetter } from "./setters.js";
|
|
@@ -8,6 +9,9 @@ export { convertTwine, convertTwineStory, formatTwineProblems } from "./twine/co
|
|
|
8
9
|
export type { TwineConversionResult, TwineConversionProblem, TwineConversionOptions } from "./twine/convert.js";
|
|
9
10
|
export { parseTwine, isTwineSource, TwineParseError } from "./twine/story.js";
|
|
10
11
|
export type { TwineStory, TwinePassage } from "./twine/story.js";
|
|
12
|
+
export { convertQuestGamebook, formatQuestProblems } from "./quest/convert.js";
|
|
13
|
+
export type { QuestConversionResult, QuestConversionProblem, QuestConversionOptions } from "./quest/convert.js";
|
|
14
|
+
export { isQuestSource, QuestParseError } from "./quest/aslx.js";
|
|
11
15
|
export type { SetterConversion, SetterConversionProblem, SetterConversionResult } from "./setters.js";
|
|
12
16
|
export { parse } from "./parse.js";
|
|
13
17
|
export { analyse, ParseCache } from "./analyse.js";
|
|
@@ -15,8 +19,8 @@ export type { AnalyseSettings, Analysis, ExternalFiles, SectionSymbol, PassageSy
|
|
|
15
19
|
export { emit } from "./emit.js";
|
|
16
20
|
export type { EmitSettings, Output, UiInfo, CompileSuccess } from "./emit.js";
|
|
17
21
|
export { formatDiagnostic } from "./syntax.js";
|
|
18
|
-
export { PROJECT_FILENAME, PROJECT_FILE_VERSION, PROJECT_SCHEMA_URL, parseProjectFile, getStoryFiles, isExcluded, isAlwaysSkipped, formatProjectFile, updateProjectFile, } from "./project.js";
|
|
19
|
-
export type { MapPositions, ProjectFile, ParsedProjectFile, StoryFiles } from "./project.js";
|
|
22
|
+
export { PROJECT_FILENAME, PROJECT_FILE_VERSION, PROJECT_SCHEMA_URL, parseProjectFile, getStoryFiles, isExcluded, isAlwaysSkipped, formatProjectFile, updateProjectFile, PAGE_STRINGS, PANEL_ICONS, storyFileList, BUILD_FOLDER, } from "./project.js";
|
|
23
|
+
export type { MapPositions, PageStringName, PageStrings, Panel, PanelIcon, ProjectFile, ParsedProjectFile, StoryFiles } from "./project.js";
|
|
20
24
|
export type * from "./syntax.js";
|
|
21
25
|
interface CompilerSettings {
|
|
22
26
|
scriptBaseFilename?: string;
|
|
@@ -27,6 +31,8 @@ interface CompilerSettings {
|
|
|
27
31
|
parseCache?: ParseCache;
|
|
28
32
|
storyFiles?: string[];
|
|
29
33
|
expressions?: boolean;
|
|
34
|
+
projectId?: string;
|
|
35
|
+
panels?: Panel[];
|
|
30
36
|
}
|
|
31
37
|
export interface CompileError {
|
|
32
38
|
success: false;
|
package/dist/compiler.js
CHANGED
|
@@ -4,6 +4,8 @@ export { findV5Syntax, convertV5Syntax } from "./v5.js";
|
|
|
4
4
|
export { convertSetters, convertSetter } from "./setters.js";
|
|
5
5
|
export { convertTwine, convertTwineStory, formatTwineProblems } from "./twine/convert.js";
|
|
6
6
|
export { parseTwine, isTwineSource, TwineParseError } from "./twine/story.js";
|
|
7
|
+
export { convertQuestGamebook, formatQuestProblems } from "./quest/convert.js";
|
|
8
|
+
export { isQuestSource, QuestParseError } from "./quest/aslx.js";
|
|
7
9
|
// The compiler works in three stages, which can also be used separately:
|
|
8
10
|
// - parse() turns one file into a syntax tree, with a source range on every node
|
|
9
11
|
// - analyse() resolves @imports, builds the story's sections and passages, and reports diagnostics
|
|
@@ -12,7 +14,7 @@ export { parse } from "./parse.js";
|
|
|
12
14
|
export { analyse, ParseCache } from "./analyse.js";
|
|
13
15
|
export { emit } from "./emit.js";
|
|
14
16
|
export { formatDiagnostic } from "./syntax.js";
|
|
15
|
-
export { PROJECT_FILENAME, PROJECT_FILE_VERSION, PROJECT_SCHEMA_URL, parseProjectFile, getStoryFiles, isExcluded, isAlwaysSkipped, formatProjectFile, updateProjectFile, } from "./project.js";
|
|
17
|
+
export { PROJECT_FILENAME, PROJECT_FILE_VERSION, PROJECT_SCHEMA_URL, parseProjectFile, getStoryFiles, isExcluded, isAlwaysSkipped, formatProjectFile, updateProjectFile, PAGE_STRINGS, PANEL_ICONS, storyFileList, BUILD_FOLDER, } from "./project.js";
|
|
16
18
|
export async function compile(settings) {
|
|
17
19
|
const analysis = await analyse(settings);
|
|
18
20
|
const { legacyErrors, legacyWarnings } = analysisInternals.get(analysis);
|
|
@@ -28,5 +30,5 @@ export async function compile(settings) {
|
|
|
28
30
|
diagnostics: analysis.diagnostics,
|
|
29
31
|
};
|
|
30
32
|
}
|
|
31
|
-
return emit(analysis, { globalJs: settings.globalJs });
|
|
33
|
+
return emit(analysis, { globalJs: settings.globalJs, projectId: settings.projectId, panels: settings.panels });
|
|
32
34
|
}
|
package/dist/emit.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { Analysis } from "./analyse.js";
|
|
2
2
|
import type { Diagnostic } from "./syntax.js";
|
|
3
|
+
import type { Panel } from "./project.js";
|
|
3
4
|
export interface Output {
|
|
4
5
|
story: OutputStory;
|
|
5
6
|
js: string[][];
|
|
@@ -7,8 +8,10 @@ export interface Output {
|
|
|
7
8
|
interface OutputStory {
|
|
8
9
|
start: string;
|
|
9
10
|
id: string | null;
|
|
11
|
+
projectId?: string;
|
|
10
12
|
uiJsIndex?: number;
|
|
11
13
|
expressions?: boolean;
|
|
14
|
+
panels?: Panel[];
|
|
12
15
|
sections: Record<string, OutputSection>;
|
|
13
16
|
}
|
|
14
17
|
interface OutputSection {
|
|
@@ -22,6 +25,7 @@ interface OutputSection {
|
|
|
22
25
|
interface OutputPassage {
|
|
23
26
|
text?: string;
|
|
24
27
|
clear?: boolean;
|
|
28
|
+
repeat?: boolean;
|
|
25
29
|
attributes?: string[];
|
|
26
30
|
jsIndex?: number;
|
|
27
31
|
}
|
|
@@ -32,6 +36,8 @@ export interface UiInfo {
|
|
|
32
36
|
}
|
|
33
37
|
export interface EmitSettings {
|
|
34
38
|
globalJs?: boolean;
|
|
39
|
+
projectId?: string;
|
|
40
|
+
panels?: Panel[];
|
|
35
41
|
}
|
|
36
42
|
export interface CompileSuccess {
|
|
37
43
|
success: true;
|
package/dist/emit.js
CHANGED
|
@@ -22,6 +22,12 @@ export function emit(analysis, settings = {}) {
|
|
|
22
22
|
if (analysis.expressions) {
|
|
23
23
|
output.story.expressions = true;
|
|
24
24
|
}
|
|
25
|
+
if (settings.projectId) {
|
|
26
|
+
output.story.projectId = settings.projectId;
|
|
27
|
+
}
|
|
28
|
+
if (settings.panels?.length) {
|
|
29
|
+
output.story.panels = settings.panels;
|
|
30
|
+
}
|
|
25
31
|
if (story.uiJs.length > 0) {
|
|
26
32
|
output.js.push(story.uiJs);
|
|
27
33
|
output.story.uiJsIndex = output.js.length - 1;
|
|
@@ -44,7 +50,8 @@ export function emit(analysis, settings = {}) {
|
|
|
44
50
|
if ("@last" in section.passages) {
|
|
45
51
|
let passageCount = 0;
|
|
46
52
|
for (const passageName of Object.keys(section.passages)) {
|
|
47
|
-
|
|
53
|
+
// A passage with @repeat doesn't count, as clicking it doesn't use it up
|
|
54
|
+
if (passageName.length > 0 && passageName?.substring(0, 1) !== "@" && !section.passages[passageName].repeat) {
|
|
48
55
|
passageCount++;
|
|
49
56
|
}
|
|
50
57
|
}
|
|
@@ -60,6 +67,9 @@ export function emit(analysis, settings = {}) {
|
|
|
60
67
|
if (passage.clear) {
|
|
61
68
|
outputPassage.clear = true;
|
|
62
69
|
}
|
|
70
|
+
if (passage.repeat) {
|
|
71
|
+
outputPassage.repeat = true;
|
|
72
|
+
}
|
|
63
73
|
outputPassage.text = passage.output;
|
|
64
74
|
if (passage.attributes.length > 0) {
|
|
65
75
|
outputPassage.attributes = passage.attributes;
|
|
@@ -83,12 +93,18 @@ export function emit(analysis, settings = {}) {
|
|
|
83
93
|
outputJs.push("export const story = {};");
|
|
84
94
|
}
|
|
85
95
|
outputJs.push(`story.id = ${JSON.stringify(output.story.id, null, 4)};`);
|
|
96
|
+
if (output.story.projectId) {
|
|
97
|
+
outputJs.push(`story.projectId = ${JSON.stringify(output.story.projectId)};`);
|
|
98
|
+
}
|
|
86
99
|
if (output.story.uiJsIndex !== undefined) {
|
|
87
100
|
outputJs.push(`story.uiJsIndex = ${output.story.uiJsIndex};`);
|
|
88
101
|
}
|
|
89
102
|
if (output.story.expressions) {
|
|
90
103
|
outputJs.push("story.expressions = true;");
|
|
91
104
|
}
|
|
105
|
+
if (output.story.panels) {
|
|
106
|
+
outputJs.push(`story.panels = ${JSON.stringify(output.story.panels, null, 4)};`);
|
|
107
|
+
}
|
|
92
108
|
outputJs.push(`story.start = ${JSON.stringify(output.story.start, null, 4)};`);
|
|
93
109
|
outputJs.push(`story.sections = ${JSON.stringify(output.story.sections, null, 4)};`);
|
|
94
110
|
outputJs.push("story.js = [");
|
package/dist/language-service.js
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
//
|
|
7
7
|
// Positions and ranges are zero-based { line, character }, following LSP conventions.
|
|
8
8
|
import { analyse, ParseCache } from "./analyse.js";
|
|
9
|
-
import { getStoryFiles, globToRegExp, parseProjectFile, PROJECT_FILENAME } from "./project.js";
|
|
9
|
+
import { getStoryFiles, globToRegExp, parseProjectFile, PROJECT_FILENAME, storyFileList } from "./project.js";
|
|
10
10
|
import { convertV5Syntax, findV5Syntax } from "./v5.js";
|
|
11
11
|
import { findUnquotedText } from "./setters.js";
|
|
12
12
|
import { buildStoryGraph, storyGraphDiagnostics } from "./story-graph.js";
|
|
13
13
|
const sameSymbol = (a, b) => a.kind == b.kind && a.name == b.name && (a.kind == "section" || a.section == b.section);
|
|
14
|
-
const usageRange = (usage) => (usage.link ?? usage.embed ?? usage.goto).range;
|
|
14
|
+
const usageRange = (usage) => (usage.link ?? usage.embed ?? usage.goto ?? usage.deactivate).range;
|
|
15
15
|
// Directives, for completion, with what they do
|
|
16
16
|
const DIRECTIVES = [
|
|
17
17
|
["title", "Sets the story's title"],
|
|
@@ -22,6 +22,7 @@ const DIRECTIVES = [
|
|
|
22
22
|
["inc", "Adds to an attribute"],
|
|
23
23
|
["dec", "Subtracts from an attribute"],
|
|
24
24
|
["clear", "Clears the screen"],
|
|
25
|
+
["repeat", "Lets the player click this passage's links again"],
|
|
25
26
|
["end", "Marks this section as an ending"],
|
|
26
27
|
["ui", "JavaScript for the story's user interface"],
|
|
27
28
|
];
|
|
@@ -156,7 +157,7 @@ export function createLanguageService(options) {
|
|
|
156
157
|
return { ...fallback, error: parsed.error };
|
|
157
158
|
const project = parsed.project;
|
|
158
159
|
const story = getStoryFiles(project, paths);
|
|
159
|
-
return { projectFile: project, mainFile: project.main, storyFiles: story
|
|
160
|
+
return { projectFile: project, mainFile: project.main, storyFiles: storyFileList(story), excludedFiles: story.excluded };
|
|
160
161
|
}
|
|
161
162
|
async function buildIndex() {
|
|
162
163
|
const texts = new Map();
|
|
@@ -238,6 +239,9 @@ export function createLanguageService(options) {
|
|
|
238
239
|
for (const goto of container.gotos) {
|
|
239
240
|
index.usages.push({ file: path, container, sectionNode: node, goto });
|
|
240
241
|
}
|
|
242
|
+
for (const deactivate of container.deactivates) {
|
|
243
|
+
index.usages.push({ file: path, container, sectionNode: node, deactivate });
|
|
244
|
+
}
|
|
241
245
|
for (const statement of container.body) {
|
|
242
246
|
if (statement.type == "attribute") {
|
|
243
247
|
const name = attributeName(statement.value);
|
|
@@ -312,6 +316,11 @@ export function createLanguageService(options) {
|
|
|
312
316
|
const name = usage.goto.name;
|
|
313
317
|
return name && index.sections.has(name) ? { kind: "section", name } : undefined;
|
|
314
318
|
}
|
|
319
|
+
if (usage.deactivate) {
|
|
320
|
+
const name = usage.deactivate.name;
|
|
321
|
+
const passages = passagesOf(index, usage.sectionNode);
|
|
322
|
+
return sectionName !== undefined && passages?.has(name) ? { kind: "passage", section: sectionName, name } : undefined;
|
|
323
|
+
}
|
|
315
324
|
const link = usage.link;
|
|
316
325
|
if (link.linkType == "section") {
|
|
317
326
|
if (link.form == "next") {
|
|
@@ -385,6 +394,8 @@ export function createLanguageService(options) {
|
|
|
385
394
|
return usage.embed.nameRange;
|
|
386
395
|
if (usage.goto)
|
|
387
396
|
return usage.goto.nameRange;
|
|
397
|
+
if (usage.deactivate)
|
|
398
|
+
return usage.deactivate.nameRange;
|
|
388
399
|
const link = usage.link;
|
|
389
400
|
if (link.form == "next")
|
|
390
401
|
return undefined;
|
|
@@ -589,6 +600,9 @@ export function createLanguageService(options) {
|
|
|
589
600
|
if ((match = /\{\{~?\s*goto\s+["']([^"']*)$/.exec(prefix))) {
|
|
590
601
|
return sectionItems(match[1]);
|
|
591
602
|
}
|
|
603
|
+
if ((match = /\{\{~?\s*deactivate\s+["']([^"']*)$/.exec(prefix))) {
|
|
604
|
+
return passageItems(match[1]);
|
|
605
|
+
}
|
|
592
606
|
if ((match = /\[\[[^\]]*\]\]\(([^),]*)$/.exec(prefix))) {
|
|
593
607
|
return sectionItems(match[1]);
|
|
594
608
|
}
|
package/dist/node.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type PageStrings, type Panel } from "./project.js";
|
|
1
2
|
export interface StoryOnDisk {
|
|
2
3
|
mainFile: string;
|
|
3
4
|
storyFiles?: string[];
|
|
@@ -5,11 +6,16 @@ export interface StoryOnDisk {
|
|
|
5
6
|
note?: string;
|
|
6
7
|
expressions: boolean;
|
|
7
8
|
backButton?: boolean;
|
|
9
|
+
strings?: PageStrings;
|
|
10
|
+
saveButton?: boolean;
|
|
11
|
+
projectId?: string;
|
|
12
|
+
panels?: Panel[];
|
|
8
13
|
}
|
|
9
14
|
export declare class StoryNotFoundError extends Error {
|
|
10
15
|
}
|
|
11
16
|
export interface FindStoryOptions {
|
|
12
17
|
skip?: string[];
|
|
13
18
|
}
|
|
14
|
-
export declare
|
|
19
|
+
export declare const listSquiffyFiles: (folder: string) => Promise<string[]>;
|
|
20
|
+
export declare const listStoryFiles: (folder: string) => Promise<string[]>;
|
|
15
21
|
export declare function findStory(input: string, options?: FindStoryOptions): Promise<StoryOnDisk>;
|
package/dist/node.js
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
// rest of the compiler stays free of Node dependencies.
|
|
5
5
|
import fs from "fs/promises";
|
|
6
6
|
import path from "path";
|
|
7
|
-
import { getStoryFiles, isAlwaysSkipped, parseProjectFile, PROJECT_FILENAME } from "./project.js";
|
|
7
|
+
import { getStoryFiles, isAlwaysSkipped, isSquiffyPath, isStoryFilePath, parseProjectFile, PROJECT_FILENAME, storyFileList, } from "./project.js";
|
|
8
8
|
// A problem finding the story, with a message to show the author as is
|
|
9
9
|
export class StoryNotFoundError extends Error {
|
|
10
10
|
}
|
|
@@ -37,7 +37,11 @@ async function findProjectFile(folder) {
|
|
|
37
37
|
}
|
|
38
38
|
// Every .squiffy file in a folder and its subfolders, relative to it with "/" separators, without
|
|
39
39
|
// looking inside the folders that are never part of a story.
|
|
40
|
-
export
|
|
40
|
+
export const listSquiffyFiles = (folder) => listFiles(folder, isSquiffyPath);
|
|
41
|
+
// Every .squiffy, .css and .js file in a folder and its subfolders, as listSquiffyFiles, and any
|
|
42
|
+
// index.html, which getStoryFiles needs to see to leave out an old build
|
|
43
|
+
export const listStoryFiles = (folder) => listFiles(folder, name => isStoryFilePath(name) || name == "index.html");
|
|
44
|
+
async function listFiles(folder, include) {
|
|
41
45
|
const result = [];
|
|
42
46
|
const walk = async (relative) => {
|
|
43
47
|
const entries = await fs.readdir(path.join(folder, relative), { withFileTypes: true });
|
|
@@ -47,7 +51,7 @@ export async function listSquiffyFiles(folder) {
|
|
|
47
51
|
if (!isAlwaysSkipped(`${child}/x`))
|
|
48
52
|
await walk(child);
|
|
49
53
|
}
|
|
50
|
-
else if (entry.name
|
|
54
|
+
else if (include(entry.name)) {
|
|
51
55
|
result.push(child);
|
|
52
56
|
}
|
|
53
57
|
}
|
|
@@ -69,10 +73,17 @@ async function folderStory(projectFile, options) {
|
|
|
69
73
|
if (!await exists(mainFile)) {
|
|
70
74
|
throw new StoryNotFoundError(`The main file in ${projectFile}, ${project.main}, doesn't exist.`);
|
|
71
75
|
}
|
|
72
|
-
|
|
76
|
+
// Absolute paths to skip are made relative to the project, and any outside it are ignored
|
|
77
|
+
const skip = (options.skip ?? []).map(file => path.isAbsolute(file) ? path.relative(root, file).split(path.sep).join("/") : file)
|
|
78
|
+
.filter(file => file && !file.startsWith("..") && !path.isAbsolute(file));
|
|
79
|
+
const story = getStoryFiles(project, await listStoryFiles(root), skip);
|
|
73
80
|
return {
|
|
74
|
-
mainFile, storyFiles: story.
|
|
81
|
+
mainFile, storyFiles: storyFileList(story).map(file => path.resolve(root, file)), projectFile, expressions: true,
|
|
75
82
|
...(project.backButton !== undefined ? { backButton: project.backButton } : {}),
|
|
83
|
+
...(project.strings !== undefined ? { strings: project.strings } : {}),
|
|
84
|
+
...(project.saveButton !== undefined ? { saveButton: project.saveButton } : {}),
|
|
85
|
+
...(project.id !== undefined ? { projectId: project.id } : {}),
|
|
86
|
+
...(project.panels !== undefined ? { panels: project.panels } : {}),
|
|
76
87
|
};
|
|
77
88
|
}
|
|
78
89
|
// Finds the story to build from what the author gave: a folder with a squiffy.json in it, or a
|
package/dist/parse.js
CHANGED
|
@@ -123,7 +123,7 @@ export function parse(text, filename) {
|
|
|
123
123
|
body: [],
|
|
124
124
|
links: [],
|
|
125
125
|
embeds: [],
|
|
126
|
-
gotos: [],
|
|
126
|
+
gotos: [], deactivates: [],
|
|
127
127
|
};
|
|
128
128
|
section.passages.push(passage);
|
|
129
129
|
textStarted = false;
|
|
@@ -159,6 +159,9 @@ export function parse(text, filename) {
|
|
|
159
159
|
haveSection = true;
|
|
160
160
|
add({ type: "clear", range });
|
|
161
161
|
}
|
|
162
|
+
else if (stripLine == "@repeat") {
|
|
163
|
+
add({ type: "repeat", range });
|
|
164
|
+
}
|
|
162
165
|
else if (stripLine == "@end") {
|
|
163
166
|
if (!passage)
|
|
164
167
|
haveSection = true;
|
|
@@ -233,7 +236,7 @@ export function parse(text, filename) {
|
|
|
233
236
|
return file;
|
|
234
237
|
}
|
|
235
238
|
function newSection(kind, range) {
|
|
236
|
-
return { type: "section", kind, range, body: [], passages: [], links: [], embeds: [], gotos: [] };
|
|
239
|
+
return { type: "section", kind, range, body: [], passages: [], links: [], embeds: [], gotos: [], deactivates: [] };
|
|
237
240
|
}
|
|
238
241
|
// Fills in the links, embeds and gotos in a section's or passage's text.
|
|
239
242
|
function findLinks(node, lines) {
|
|
@@ -269,4 +272,10 @@ function findLinks(node, lines) {
|
|
|
269
272
|
range: toRange(goto.start, goto.end),
|
|
270
273
|
nameRange: toRange(goto.nameStart, goto.nameEnd),
|
|
271
274
|
}));
|
|
275
|
+
node.deactivates = result.deactivates.map((deactivate) => ({
|
|
276
|
+
type: "deactivate",
|
|
277
|
+
name: deactivate.name,
|
|
278
|
+
range: toRange(deactivate.start, deactivate.end),
|
|
279
|
+
nameRange: toRange(deactivate.nameStart, deactivate.nameEnd),
|
|
280
|
+
}));
|
|
272
281
|
}
|
package/dist/project.d.ts
CHANGED
|
@@ -3,11 +3,55 @@ export declare const PROJECT_FILE_VERSION = 1;
|
|
|
3
3
|
export declare const PROJECT_SCHEMA_URL = "https://squiffystory.com/schema/squiffy.json";
|
|
4
4
|
export interface ProjectFile {
|
|
5
5
|
version: number;
|
|
6
|
+
id?: string;
|
|
6
7
|
main: string;
|
|
7
8
|
exclude: string[];
|
|
8
9
|
map?: MapPositions;
|
|
9
10
|
backButton?: boolean;
|
|
11
|
+
saveButton?: boolean;
|
|
12
|
+
strings?: PageStrings;
|
|
13
|
+
panels?: Panel[];
|
|
10
14
|
}
|
|
15
|
+
export declare const PANEL_ICONS: readonly ["bag", "person", "map", "help", "info", "list", "book", "star", "heart"];
|
|
16
|
+
export type PanelIcon = typeof PANEL_ICONS[number];
|
|
17
|
+
export interface Panel {
|
|
18
|
+
passage: string;
|
|
19
|
+
label: string;
|
|
20
|
+
position?: "side" | "button";
|
|
21
|
+
icon?: PanelIcon;
|
|
22
|
+
}
|
|
23
|
+
export type PageStringName = keyof typeof PAGE_STRINGS;
|
|
24
|
+
export type PageStrings = Partial<Record<PageStringName, string>>;
|
|
25
|
+
export declare const PAGE_STRINGS: {
|
|
26
|
+
back: string;
|
|
27
|
+
restart: string;
|
|
28
|
+
restartConfirm: string;
|
|
29
|
+
switchToDark: string;
|
|
30
|
+
switchToLight: string;
|
|
31
|
+
saves: string;
|
|
32
|
+
saveName: string;
|
|
33
|
+
save: string;
|
|
34
|
+
noSaves: string;
|
|
35
|
+
savedGame: string;
|
|
36
|
+
savedToday: string;
|
|
37
|
+
savedYesterday: string;
|
|
38
|
+
load: string;
|
|
39
|
+
loadConfirm: string;
|
|
40
|
+
saveOptions: string;
|
|
41
|
+
overwrite: string;
|
|
42
|
+
overwriteConfirm: string;
|
|
43
|
+
rename: string;
|
|
44
|
+
newName: string;
|
|
45
|
+
saveToFile: string;
|
|
46
|
+
loadFromFile: string;
|
|
47
|
+
delete: string;
|
|
48
|
+
deleteConfirm: string;
|
|
49
|
+
cancel: string;
|
|
50
|
+
close: string;
|
|
51
|
+
wrongStory: string;
|
|
52
|
+
notASave: string;
|
|
53
|
+
cantSave: string;
|
|
54
|
+
};
|
|
11
55
|
export interface MapPositions {
|
|
12
56
|
sections: Record<string, [number, number]>;
|
|
13
57
|
passages: Record<string, Record<string, [number, number]>>;
|
|
@@ -23,17 +67,27 @@ export declare function parseProjectFile(text: string): ParsedProjectFile;
|
|
|
23
67
|
export declare function globToRegExp(pattern: string): RegExp;
|
|
24
68
|
export declare function isExcluded(path: string, exclude: string[]): boolean;
|
|
25
69
|
export declare function isAlwaysSkipped(path: string): boolean;
|
|
70
|
+
export declare const BUILD_FOLDER = "build";
|
|
71
|
+
export declare const isSquiffyPath: (path: string) => boolean;
|
|
72
|
+
export declare const isStylesheetPath: (path: string) => boolean;
|
|
73
|
+
export declare const isScriptPath: (path: string) => boolean;
|
|
74
|
+
export declare const isStoryFilePath: (path: string) => boolean;
|
|
26
75
|
export interface StoryFiles {
|
|
27
76
|
main: string;
|
|
28
77
|
included: string[];
|
|
78
|
+
stylesheets: string[];
|
|
79
|
+
scripts: string[];
|
|
29
80
|
excluded: string[];
|
|
30
81
|
}
|
|
31
82
|
export declare const comparePaths: (a: string, b: string) => 1 | 0 | -1;
|
|
32
83
|
export declare function getStoryFiles(project: ProjectFile, paths: Iterable<string>, skip?: string[]): StoryFiles;
|
|
84
|
+
export declare const storyFileList: (story: StoryFiles) => string[];
|
|
33
85
|
export declare function formatProjectFile(project: {
|
|
34
86
|
main: string;
|
|
35
87
|
exclude?: string[];
|
|
36
88
|
map?: MapPositions;
|
|
89
|
+
id?: string;
|
|
90
|
+
panels?: Panel[];
|
|
37
91
|
}): string;
|
|
38
92
|
export declare function updateProjectFile(text: string, changes: {
|
|
39
93
|
main?: string;
|