@cratis/screenplay-language 4.0.1 → 4.2.0

package/completion-items.ts

@@ -20,12 +20,14 @@ export const topLevelItems: CompletionEntry[] = [
 ];
 
 export const conceptItems: CompletionEntry[] = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'pii reason', insertText: 'pii reason "${1:why this is personal data, its purpose and lawful basis}"', documentation: 'Records why the `@pii` marker applies — purpose, lawful basis, whose subject it lives under.' },
     { label: 'sensitive reason', insertText: 'sensitive reason "${1:why this value is sensitive}"', documentation: 'Records why the `@sensitive` marker applies.' },
     { label: 'validate', insertText: 'validate\n    ${1:not empty} message "${2:message}"', documentation: 'Validation rules that travel with the value everywhere it appears.' },
 ];
 
 export const typeItems: CompletionEntry[] = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'description', insertText: 'description "${1:what this shape represents}"', documentation: 'A human-readable description of the type.' },
     { label: 'property', insertText: '${1:property} ${2:Type}', documentation: 'A property of the type — a name and a type reference.' },
 ];
@@ -44,6 +46,7 @@ export const featureItems: CompletionEntry[] = [
 ];
 
 export const sliceItems: CompletionEntry[] = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'event', insertText: 'event ${1:Name}\n    ${2:property} ${3:Type}', documentation: 'Declares an event type — an immutable, past-tense fact.' },
     { label: 'command', insertText: 'command ${1:Name}\n    ${2:property} ${3:Type}', documentation: 'Declares a command — an imperative intent that produces events.' },
     { label: 'query', insertText: 'query ${1:Name} => ${2:ReadModel}', documentation: 'Declares a read-side entry point mapping to a return type.' },
@@ -112,11 +115,13 @@ export const reactionTriggerItems: CompletionEntry[] = [
 ];
 
 export const triggerItems: CompletionEntry[] = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'description', insertText: 'description "${1:when this occurs}"', documentation: 'What makes an occurrence of this trigger happen.' },
     { label: 'value', insertText: '${1:name} ${2:Type}', documentation: 'A value an occurrence hands the reaction. The type is optional.' },
 ];
 
 export const specificationItems: CompletionEntry[] = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'given', insertText: 'given ${1:EventType}\n    ${2:property} = ${3:value}', documentation: 'Establishes prior state by replaying an event before the command runs.' },
     { label: 'given readmodel', insertText: 'given readmodel ${1:ReadModelType}\n    ${2:property} = ${3:value}', documentation: 'Establishes prior read model state directly.' },
     { label: 'when', insertText: 'when ${1:CommandType}\n    ${2:property} = ${3:value}', documentation: 'The command being exercised.' },

package/dist/completion-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion-items.d.ts","sourceRoot":"","sources":["../completion-items.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,aAAa,EAAE,eAAe,EAQ1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAIzC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,eAAe,EAGtC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAGxC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAMzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAUvC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAQzC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAE1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAGzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAOvC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAAe,EAI3C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAAe,EAI5C,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAM1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAMjD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAGzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAQ/C,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,eAAe,EAGtC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAKxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAU1C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAYxC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAGxC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAGvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAiBjD,CAAC"}
+{"version":3,"file":"completion-items.d.ts","sourceRoot":"","sources":["../completion-items.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,aAAa,EAAE,eAAe,EAQ1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAKzC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,eAAe,EAItC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAGxC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAMzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAWvC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAQzC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAE1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAGzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAOvC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAAe,EAI3C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAAe,EAI5C,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAM1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAMjD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAAe,EAIzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAS/C,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,eAAe,EAGtC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAKxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAU1C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAYxC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAAe,EAGxC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAAe,EAGvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAiBjD,CAAC"}

package/dist/completion-items.js

@@ -11,11 +11,13 @@ export const topLevelItems = [
     { label: 'module', insertText: 'module ${1:Name}\n    ', documentation: 'Declares the top-level namespace — maps to a bounded context.' },
 ];
 export const conceptItems = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'pii reason', insertText: 'pii reason "${1:why this is personal data, its purpose and lawful basis}"', documentation: 'Records why the `@pii` marker applies — purpose, lawful basis, whose subject it lives under.' },
     { label: 'sensitive reason', insertText: 'sensitive reason "${1:why this value is sensitive}"', documentation: 'Records why the `@sensitive` marker applies.' },
     { label: 'validate', insertText: 'validate\n    ${1:not empty} message "${2:message}"', documentation: 'Validation rules that travel with the value everywhere it appears.' },
 ];
 export const typeItems = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'description', insertText: 'description "${1:what this shape represents}"', documentation: 'A human-readable description of the type.' },
     { label: 'property', insertText: '${1:property} ${2:Type}', documentation: 'A property of the type — a name and a type reference.' },
 ];
@@ -31,6 +33,7 @@ export const featureItems = [
     { label: 'slice Translate', insertText: 'slice Translate ${1:Name}\n    ', documentation: 'A capture; converts external data into events.' },
 ];
 export const sliceItems = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'event', insertText: 'event ${1:Name}\n    ${2:property} ${3:Type}', documentation: 'Declares an event type — an immutable, past-tense fact.' },
     { label: 'command', insertText: 'command ${1:Name}\n    ${2:property} ${3:Type}', documentation: 'Declares a command — an imperative intent that produces events.' },
     { label: 'query', insertText: 'query ${1:Name} => ${2:ReadModel}', documentation: 'Declares a read-side entry point mapping to a return type.' },
@@ -90,10 +93,12 @@ export const reactionTriggerItems = [
     { label: 'csharp', insertText: fenced('csharp'), documentation: 'Inline C# returning event side effects.' },
 ];
 export const triggerItems = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'description', insertText: 'description "${1:when this occurs}"', documentation: 'What makes an occurrence of this trigger happen.' },
     { label: 'value', insertText: '${1:name} ${2:Type}', documentation: 'A value an occurrence hands the reaction. The type is optional.' },
 ];
 export const specificationItems = [
+    { label: 'file', insertText: 'file ${1:Path}', documentation: 'Names the repository relative file this declaration is realized by, so the document can be navigated back to the code.' },
     { label: 'given', insertText: 'given ${1:EventType}\n    ${2:property} = ${3:value}', documentation: 'Establishes prior state by replaying an event before the command runs.' },
     { label: 'given readmodel', insertText: 'given readmodel ${1:ReadModelType}\n    ${2:property} = ${3:value}', documentation: 'Establishes prior read model state directly.' },
     { label: 'when', insertText: 'when ${1:CommandType}\n    ${2:property} = ${3:value}', documentation: 'The command being exercised.' },

package/dist/completion-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"completion-items.js","sourceRoot":"","sources":["../completion-items.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"completion-items.js","sourceRoot":"","sources":["../completion-items.ts"],"names":[],"mappings":"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"}

package/dist/file-references.d.ts

@@ -0,0 +1,11 @@
+export declare const fileReferenceKeyword = "file";
+export interface FileReference {
+    path: string;
+    line: number;
+    startColumn: number;
+    endColumn: number;
+}
+export declare function isAbsoluteFileReferencePath(path: string): boolean;
+export declare function fileReferenceOn(line: string, lineIndex: number): FileReference | undefined;
+export declare function fileReferences(lines: string[]): FileReference[];
+//# sourceMappingURL=file-references.d.ts.map

package/dist/file-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-references.d.ts","sourceRoot":"","sources":["../file-references.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAK3C,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAYD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AA0BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAe1F;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAW/D"}

package/dist/file-references.js

@@ -0,0 +1,70 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { fenceMap, firstWord, indentOf } from './document-context';
+// The keyword the directive opens with — the single word the language points at a file with.
+export const fileReferenceKeyword = 'file';
+// `file String` is a property named `file`; `file Invoices/Register.cs` is the directive. The two are
+// told apart by shape, the way the compiler tells them apart: a type reference is a bare identifier,
+// so anything carrying a separator or an extension is a path and nothing else. The property wins the
+// tie, because a document that used the name before the directive existed keeps meaning what it meant.
+const typeReferencePattern = /^[A-Za-z_]\w*(?:\[\])?\??$/;
+// A path naming a place on one machine rather than a place in the repository. The compiler warns about
+// these; nothing here rejects one, so a resolver can still probe it and come up empty on other machines.
+const absolutePathPattern = /^(?:[/\\]|[A-Za-z]:[/\\]|~[/\\])/;
+export function isAbsoluteFileReferencePath(path) {
+    return absolutePathPattern.test(path);
+}
+// Drops a trailing `//` comment without cutting into a string or a template, mirroring how the
+// compiler strips one before it reads the line.
+function withoutComment(text) {
+    let inString = false;
+    let inTemplate = false;
+    for (let index = 0; index < text.length; index++) {
+        const current = text[index];
+        if (current === '\\' && inString && index + 1 < text.length) {
+            index++;
+        }
+        else if (current === '"' && !inTemplate) {
+            inString = !inString;
+        }
+        else if (current === '`' && !inString) {
+            inTemplate = !inTemplate;
+        }
+        else if (!inString && !inTemplate && current === '/' && text[index + 1] === '/') {
+            return text.slice(0, index);
+        }
+    }
+    return text;
+}
+// The `file` directive on a single line, or undefined when the line is not one. Callers that scan a
+// whole document go through fileReferences instead, so code fences are accounted for.
+export function fileReferenceOn(line, lineIndex) {
+    const indent = indentOf(line);
+    const content = withoutComment(line.slice(indent)).trimEnd();
+    if (firstWord(content) !== fileReferenceKeyword)
+        return undefined;
+    const afterKeyword = content.slice(fileReferenceKeyword.length);
+    const path = afterKeyword.trim();
+    // A bare `file` leaves the word available as a name to whatever the enclosing block reads a bare
+    // word as, and a bare identifier after it is a property type rather than a path.
+    if (path.length === 0 || typeReferencePattern.test(path))
+        return undefined;
+    const separatorLength = afterKeyword.length - afterKeyword.trimStart().length;
+    const startColumn = indent + fileReferenceKeyword.length + separatorLength + 1;
+    return { path, line: lineIndex, startColumn, endColumn: startColumn + path.length };
+}
+// Every `file` directive in a document, in document order. Lines inside a code fence are skipped, so
+// a `file` line in an inline C# or TypeScript block is never mistaken for one of ours.
+export function fileReferences(lines) {
+    const fences = fenceMap(lines);
+    const references = [];
+    for (let index = 0; index < lines.length; index++) {
+        if (fences[index])
+            continue;
+        const reference = fileReferenceOn(lines[index], index);
+        if (reference)
+            references.push(reference);
+    }
+    return references;
+}
+//# sourceMappingURL=file-references.js.map

package/dist/file-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-references.js","sourceRoot":"","sources":["../file-references.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { cdl } from './sub-languages/cdl';
 export { screenplayDarkThemeName } from './themes/screenplay-dark';
 export { screenplayLightThemeName } from './themes/screenplay-light';
 export { enclosingChain, fenceMap, firstWord, indentOf } from './document-context';
+export { fileReferenceKeyword, fileReferenceOn, fileReferences, isAbsoluteFileReferencePath, } from './file-references';
+export type { FileReference } from './file-references';
 export { builtInTriggerNames, knownEventNames, knownTriggerNames, knownTypeNames, scanDocument } from './symbols';
 export type { CommandSymbol, ConceptSymbol, DocumentSymbols, EventSymbol, ImportSymbol, NamedSymbol, PolicySymbol, PropertySymbol, QuerySymbol, TypeSymbol, } from './symbols';
 export { attributeDocs, contextVariableDocs, keywordDocs } from './keyword-docs';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,MAAM,EAIT,MAAM,YAAY,CAAC;AA2BpB,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAe7C;AAED,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EACR,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClH,YAAY,EACR,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,UAAU,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,MAAM,EAIT,MAAM,YAAY,CAAC;AA2BpB,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAe7C;AAED,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EACR,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EACH,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,2BAA2B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClH,YAAY,EACR,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,UAAU,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -45,6 +45,7 @@ export { cdl } from './sub-languages/cdl';
 export { screenplayDarkThemeName } from './themes/screenplay-dark';
 export { screenplayLightThemeName } from './themes/screenplay-light';
 export { enclosingChain, fenceMap, firstWord, indentOf } from './document-context';
+export { fileReferenceKeyword, fileReferenceOn, fileReferences, isAbsoluteFileReferencePath, } from './file-references';
 export { builtInTriggerNames, knownEventNames, knownTriggerNames, knownTypeNames, scanDocument } from './symbols';
 export { attributeDocs, contextVariableDocs, keywordDocs } from './keyword-docs';
 export { contextVariableItems, producesItems } from './completion-items';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/file-references.ts

@@ -0,0 +1,87 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { fenceMap, firstWord, indentOf } from './document-context';
+
+// The keyword the directive opens with — the single word the language points at a file with.
+export const fileReferenceKeyword = 'file';
+
+// A `file <path>` directive, with the path exactly as written and the span it occupies on its line.
+// The span is measured against the raw line, and its columns are one-based like every other position
+// this package reports, so an editor places a range on it the same way it does a validation issue.
+export interface FileReference {
+    path: string;
+    line: number;
+    startColumn: number;
+    endColumn: number;
+}
+
+// `file String` is a property named `file`; `file Invoices/Register.cs` is the directive. The two are
+// told apart by shape, the way the compiler tells them apart: a type reference is a bare identifier,
+// so anything carrying a separator or an extension is a path and nothing else. The property wins the
+// tie, because a document that used the name before the directive existed keeps meaning what it meant.
+const typeReferencePattern = /^[A-Za-z_]\w*(?:\[\])?\??$/;
+
+// A path naming a place on one machine rather than a place in the repository. The compiler warns about
+// these; nothing here rejects one, so a resolver can still probe it and come up empty on other machines.
+const absolutePathPattern = /^(?:[/\\]|[A-Za-z]:[/\\]|~[/\\])/;
+
+export function isAbsoluteFileReferencePath(path: string): boolean {
+    return absolutePathPattern.test(path);
+}
+
+// Drops a trailing `//` comment without cutting into a string or a template, mirroring how the
+// compiler strips one before it reads the line.
+function withoutComment(text: string): string {
+    let inString = false;
+    let inTemplate = false;
+
+    for (let index = 0; index < text.length; index++) {
+        const current = text[index];
+        if (current === '\\' && inString && index + 1 < text.length) {
+            index++;
+        } else if (current === '"' && !inTemplate) {
+            inString = !inString;
+        } else if (current === '`' && !inString) {
+            inTemplate = !inTemplate;
+        } else if (!inString && !inTemplate && current === '/' && text[index + 1] === '/') {
+            return text.slice(0, index);
+        }
+    }
+
+    return text;
+}
+
+// The `file` directive on a single line, or undefined when the line is not one. Callers that scan a
+// whole document go through fileReferences instead, so code fences are accounted for.
+export function fileReferenceOn(line: string, lineIndex: number): FileReference | undefined {
+    const indent = indentOf(line);
+    const content = withoutComment(line.slice(indent)).trimEnd();
+    if (firstWord(content) !== fileReferenceKeyword) return undefined;
+
+    const afterKeyword = content.slice(fileReferenceKeyword.length);
+    const path = afterKeyword.trim();
+
+    // A bare `file` leaves the word available as a name to whatever the enclosing block reads a bare
+    // word as, and a bare identifier after it is a property type rather than a path.
+    if (path.length === 0 || typeReferencePattern.test(path)) return undefined;
+
+    const separatorLength = afterKeyword.length - afterKeyword.trimStart().length;
+    const startColumn = indent + fileReferenceKeyword.length + separatorLength + 1;
+    return { path, line: lineIndex, startColumn, endColumn: startColumn + path.length };
+}
+
+// Every `file` directive in a document, in document order. Lines inside a code fence are skipped, so
+// a `file` line in an inline C# or TypeScript block is never mistaken for one of ours.
+export function fileReferences(lines: string[]): FileReference[] {
+    const fences = fenceMap(lines);
+    const references: FileReference[] = [];
+
+    for (let index = 0; index < lines.length; index++) {
+        if (fences[index]) continue;
+        const reference = fileReferenceOn(lines[index], index);
+        if (reference) references.push(reference);
+    }
+
+    return references;
+}

package/for_fileReferences/when_recognizing_an_absolute_path/with_paths_of_every_shape.ts

@@ -0,0 +1,26 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, it } from 'vitest';
+import { isAbsoluteFileReferencePath } from '../../file-references';
+
+// A reference is relative to the repository root, so it means the same thing on every machine. An
+// absolute one names a place on one machine and is wrong without looking anything up.
+describe('when recognizing an absolute path', () => {
+    it('should recognize a posix path', () => {
+        isAbsoluteFileReferencePath('/Users/someone/Invoices/Register.cs').should.be.true;
+    });
+
+    it('should recognize a windows path', () => {
+        isAbsoluteFileReferencePath('C:/repos/Invoices/Register.cs').should.be.true;
+        isAbsoluteFileReferencePath('C:\\repos\\Invoices\\Register.cs').should.be.true;
+    });
+
+    it('should recognize a home-relative path', () => {
+        isAbsoluteFileReferencePath('~/repos/Invoices/Register.cs').should.be.true;
+    });
+
+    it('should not recognize a repository-relative path', () => {
+        isAbsoluteFileReferencePath('Invoices/Register.cs').should.be.false;
+    });
+});

package/for_fileReferences/when_scanning_a_document/inside_a_code_fence.ts

@@ -0,0 +1,26 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+// An inline C# block may well contain the word `file` at the start of a line — it is a C# modifier —
+// and none of it is Screenplay.
+describe('when scanning a document with a file line inside a code fence', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences([
+            'handler',
+            '    ```',
+            '    file static class Helpers/NotAPath.cs',
+            '    ```',
+            '    file Handlers/Real.cs',
+        ]);
+    });
+
+    it('should find only the reference outside the fence', () => {
+        result.should.have.lengthOf(1);
+        result[0].path.should.equal('Handlers/Real.cs');
+    });
+});

package/for_fileReferences/when_scanning_a_document/with_a_bare_file_keyword.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+// A bare `file` carries no path, so it leaves the word available as a name to whatever the enclosing
+// block reads a bare word as.
+describe('when scanning a document with a bare file keyword', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences(['reaction', '    file', '    file   ', 'filename Something.cs']);
+    });
+
+    it('should find no reference', () => {
+        result.should.be.empty;
+    });
+});

package/for_fileReferences/when_scanning_a_document/with_a_file_directive.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+describe('when scanning a document with a file directive', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences(['command RegisterInvoice', '    handler', '        file Handlers/RegisterInvoice.cs']);
+    });
+
+    it('should find the reference', () => {
+        result.should.have.lengthOf(1);
+    });
+
+    it('should carry the declared path verbatim', () => {
+        result[0].path.should.equal('Handlers/RegisterInvoice.cs');
+    });
+
+    it('should report the line it sits on', () => {
+        result[0].line.should.equal(2);
+    });
+
+    it('should span the path and not the keyword', () => {
+        result[0].startColumn.should.equal(14);
+        result[0].endColumn.should.equal(14 + 'Handlers/RegisterInvoice.cs'.length);
+    });
+});

package/for_fileReferences/when_scanning_a_document/with_a_property_named_file.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+// `file String` declares a property called `file`; only a path is the directive. The two are told
+// apart by shape, and the property has to keep winning the tie.
+describe('when scanning a document with a property named file', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences([
+            'type Attachment',
+            '    file String',
+            '    name String',
+            '    thumbnails String[]',
+            '    caption String?',
+        ]);
+    });
+
+    it('should find no reference', () => {
+        result.should.be.empty;
+    });
+});

package/for_fileReferences/when_scanning_a_document/with_a_trailing_comment.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+describe('when scanning a document with a trailing comment after a file directive', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences(['    file Screens/InvoiceLineReport.tsx  // generated by Arc']);
+    });
+
+    it('should find the reference', () => {
+        result.should.have.lengthOf(1);
+    });
+
+    it('should leave the comment out of the path', () => {
+        result[0].path.should.equal('Screens/InvoiceLineReport.tsx');
+    });
+
+    it('should span only the path', () => {
+        result[0].endColumn.should.equal(result[0].startColumn + 'Screens/InvoiceLineReport.tsx'.length);
+    });
+});

package/for_fileReferences/when_scanning_a_document/with_directives_on_several_constructs.ts

@@ -0,0 +1,41 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { describe, beforeEach, it } from 'vitest';
+import { FileReference, fileReferences } from '../../file-references';
+
+// The shape a captured application actually has — the directive appears under validation rules,
+// constraints, handlers, screens, performers and reactions alike, at whatever depth they sit.
+describe('when scanning a document with directives on several constructs', () => {
+    let result: FileReference[];
+
+    beforeEach(() => {
+        result = fileReferences([
+            'rule BeUnusedInvoiceNumber',
+            '            file Validations/BeUnusedInvoiceNumber.cs',
+            'constraint InvoiceStatusTransition',
+            '        file Constraints/InvoiceStatusTransitionConstraint.cs',
+            'screen InvoiceLineReport',
+            '        file Screens/InvoiceLineReport.tsx',
+            'performer',
+            '          file Queries/InvoiceSummaryPerformer.cs',
+        ]);
+    });
+
+    it('should find every reference', () => {
+        result.should.have.lengthOf(4);
+    });
+
+    it('should find them in document order', () => {
+        result.map((reference) => reference.path).should.deep.equal([
+            'Validations/BeUnusedInvoiceNumber.cs',
+            'Constraints/InvoiceStatusTransitionConstraint.cs',
+            'Screens/InvoiceLineReport.tsx',
+            'Queries/InvoiceSummaryPerformer.cs',
+        ]);
+    });
+
+    it('should report the line each one sits on', () => {
+        result.map((reference) => reference.line).should.deep.equal([1, 3, 5, 7]);
+    });
+});

package/index.ts

@@ -79,6 +79,13 @@ export { cdl } from './sub-languages/cdl';
 export { screenplayDarkThemeName } from './themes/screenplay-dark';
 export { screenplayLightThemeName } from './themes/screenplay-light';
 export { enclosingChain, fenceMap, firstWord, indentOf } from './document-context';
+export {
+    fileReferenceKeyword,
+    fileReferenceOn,
+    fileReferences,
+    isAbsoluteFileReferencePath,
+} from './file-references';
+export type { FileReference } from './file-references';
 export { builtInTriggerNames, knownEventNames, knownTriggerNames, knownTypeNames, scanDocument } from './symbols';
 export type {
     CommandSymbol,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/screenplay-language",
-    "version": "4.0.1",
+    "version": "4.2.0",
     "description": "Monaco language service for the Cratis Screenplay DSL — syntax highlighting, IntelliSense, hover and diagnostics for .play files",
     "license": "MIT",
     "repository": {
@@ -33,16 +33,20 @@
         "**/*.ts"
     ],
     "scripts": {
-        "build": "tsc -p tsconfig.json",
+        "build": "tsc -p tsconfig.build.json",
         "compile": "tsc --noEmit -p tsconfig.json",
         "lint": "yarn g:lint",
-        "lint:ci": "yarn g:lint:ci"
+        "lint:ci": "yarn g:lint:ci",
+        "test": "vitest run"
     },
     "peerDependencies": {
         "monaco-editor": ">=0.44.0"
     },
     "devDependencies": {
+        "@types/chai": "^5.2.3",
+        "chai": "^6.2.2",
         "monaco-editor": "^0.55.1",
-        "typescript": "6.0.3"
+        "typescript": "6.0.3",
+        "vitest": "^4.1.11"
     }
 }

package/vitest.setup.ts

@@ -0,0 +1,5 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// Installs Chai's `.should` fluent interface, which every spec asserts through.
+import 'chai/register-should';