@cratis/screenplay-language 4.51.0 → 4.53.0

package/for_fileReferences/when_scanning_a_document/with_a_file_directive.ts

@@ -1,30 +0,0 @@
-// 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

@@ -1,25 +0,0 @@
-// 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

@@ -1,25 +0,0 @@
-// 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

@@ -1,41 +0,0 @@
-// 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/for_importablePaths/when_listing_what_a_document_can_import.ts

@@ -1,34 +0,0 @@
-// 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 { importablePaths } from '../file-imports';
-
-describe('when listing what a document can import', () => {
-    let paths: string[];
-
-    beforeEach(() => {
-        paths = importablePaths('Ordering/Ordering.play', [
-            'application.play',
-            'Ordering/Ordering.play',
-            'Ordering/Orders/PlaceOrder.play',
-            'Ordering/notes.md',
-            'Shared/Concepts.play',
-        ]);
-    });
-
-    it('should name every other play file relative to the document, with globs for the folders on the way', () => {
-        paths.should.deep.equal([
-            '**/*.play',
-            '../**/*.play',
-            '../*.play',
-            '../Shared/**/*.play',
-            '../Shared/*.play',
-            '../Shared/Concepts.play',
-            '../application.play',
-            'Orders/**/*.play',
-            'Orders/*.play',
-            'Orders/PlaceOrder.play',
-        ]);
-    });
-});

package/for_inlineEvents/when_analyzing_many_inline_events.ts

@@ -1,59 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { describe, expect, it, vi } from 'vitest';
-import * as context from '../document-context';
-import { destinationHints } from '../production-destinations';
-import { scanDocument } from '../symbols';
-import { validateLines } from '../validation';
-
-function document(count: number, malformedDocumentation = false): string[] {
-    return ['module Projects', '  feature Naming', ...Array.from({ length: count }, (_, index) => [
-        `    slice StateChange Rename${index}`,
-        `      command Rename${index}`,
-        '        projectId Uuid identifier',
-        '        name String',
-        `          produces event Renamed${index}`,
-        '            name String = name',
-        malformedDocumentation ? '            documentation "details"' : '            // mapping complete',
-    ]).flat()];
-}
-
-// Count actual work, not elapsed time: indentation visits catch ancestry walks,
-// replacements catch whole-document normalization per event, and filter input
-// sizes catch rebuilding/scanning the event catalog for every declaration.
-function work(action: () => void): number {
-    const indentation = vi.spyOn(context, 'indentOf');
-    const replacements = vi.spyOn(String.prototype, 'replace');
-    const trims = vi.spyOn(String.prototype, 'trim');
-    const filters = vi.spyOn(Array.prototype, 'filter');
-    try {
-        action();
-        return indentation.mock.calls.length + replacements.mock.calls.length + trims.mock.calls.length +
-            filters.mock.contexts.reduce<number>((sum, receiver) => sum + (receiver as unknown[]).length, 0);
-    } finally {
-        indentation.mockRestore();
-        replacements.mockRestore();
-        trims.mockRestore();
-        filters.mockRestore();
-    }
-}
-
-describe('when analyzing many inline events', () => {
-    it.each(['validation', 'destination hints', 'malformed documentation'])('should keep %s work linear', path => {
-        const measure = (count: number) => {
-            const lines = document(count, path === 'malformed documentation');
-            const application = scanDocument(Array.from({ length: count }, (_, index) => `import Other.Imported${index}`));
-            let results = 0;
-            const units = work(() => {
-                results = path === 'destination hints' ? destinationHints(lines).length : validateLines(lines, { application }).length;
-            });
-            expect(results).toBe(path === 'validation' ? 0 : count);
-            return units;
-        };
-        const small = measure(100);
-        const large = measure(200);
-        expect(small).toBeGreaterThan(0);
-        expect(large).toBeLessThan(small * 2.2);
-    });
-});

package/for_inlineEvents/when_authoring_inline_events.ts

@@ -1,149 +0,0 @@
-// 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, expect } from 'vitest';
-import { planCompletions } from '../completion-planner';
-import { hoverContent } from '../hover-content';
-import { destinationHints } from '../production-destinations';
-import { scanDocument } from '../symbols';
-import { validateLines } from '../validation';
-
-const source = [
-    'command Rename', '  projectId Uuid identifier', '  name String', '  produces event Renamed',
-    '    description "A new name"', '    documentation', '      ```markdown', '      event NotADeclaration', '      ```',
-    '    @tag String = name', '    name String = name',
-];
-
-describe('when authoring inline events', () => {
-    it('should index the event and its typed properties, not its prose', () => {
-        const symbols = scanDocument(source);
-        expect(symbols.events.map(event => event.name)).toEqual(['Renamed']);
-        expect(symbols.events[0].properties.map(property => property.name)).toEqual(['tag', 'name']);
-        expect(symbols.commands[0].properties.map(property => property.name)).toEqual(['projectId', 'name']);
-    });
-    it('should validate its metadata without false positives', () => expect(validateLines(source)).toEqual([]));
-    it.each([
-        ['    documentation "details"'],
-        ['    documentation'],
-        ['    documentation', '      ```text', '      Details', '      ```'],
-        ['    documentation', '    ```markdown', '    Details', '    ```'],
-        ['    documentation', '      ```markdown', '      ', '      ```'],
-        ['    documentation', '      ```markdown', '      Details'],
-    ])('should reject malformed documentation without searching later declarations for its fence', (...body) => {
-        const lines = ['command Rename', '  produces event Renamed', ...body];
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0477').map(issue => issue.line)).toEqual([2]);
-    });
-    it('should distinguish adjacent complete documentation blocks from malformed directives', () => {
-        const lines = ['event First', '  documentation "details"', 'event Second', '  documentation',
-            '    ```markdown', '    Details', '    ```', 'event Third', '  documentation',
-            '    ```markdown', '    ', '    ```', 'event Fourth', '  documentation', '',
-            '    ```markdown', '    More details', '    ```'];
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0477').map(issue => issue.line)).toEqual([1, 8]);
-    });
-    it('should offer event metadata and typed mappings inside the body', () => {
-        const plan = planCompletions([...source, '    '], source.length, '    ');
-        expect(plan.kind).toBe('entries');
-        if (plan.kind === 'entries') expect(plan.entries.map(entry => entry.label)).toEqual(expect.arrayContaining(['description', 'documentation', 'id', 'tag', 'for', 'property mapping']));
-    });
-    it('should show the implicit command identifier', () => expect(destinationHints(source).map(hint => hint.label)).toEqual(['for projectId']));
-    it('should suppress hints for uncertain mixed destinations', () => expect(destinationHints([...source, '  produces Another', '    for otherId'])).toEqual([]));
-    it('should suppress hints for incomplete and repeated explicit destinations', () => {
-        expect(destinationHints([...source, '    for'])).toEqual([]);
-        expect(destinationHints([...source, '    for projectId', '    for projectId'])).toEqual([]);
-    });
-    it('should not hint a header that has no event name', () => expect(destinationHints(['command Rename', '  produces'])).toEqual([]));
-    it('should explain the new declaration form', () => expect(hoverContent(source, 3, 'produces', 3, 11)).toContain('produces event'));
-    it('should preserve information severity for redundant pins', () => expect(validateLines([...source, '    id "Renamed"']).find(issue => issue.code === 'PLAY0471')?.severity).toBe('information'));
-    it.each(['namespace', 'sequence', 'correlation', 'causation', 'causedBy', 'occurred'])('should reject %s as system metadata', keyword => {
-        expect(validateLines([...source, `    ${keyword} = name`]).map(issue => issue.code)).toContain('PLAY0476');
-    });
-    it('should warn about identifier duplication', () => expect(validateLines([...source, '    projectId Uuid = projectId']).find(issue => issue.code === 'PLAY0469')?.severity).toBe('warning'));
-    it('should reject an inline event in a reaction', () => expect(validateLines(['reaction React', '  every 1 day', '    produces event Done']).map(issue => issue.code)).toContain('PLAY0474'));
-    it('should require explicit destinations for mixed inline and plain omissions', () => {
-        const lines = [...source, '  produces Legacy // retained allocation'];
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0470').map(issue => issue.message)).toContain("Production 'Legacy' must state for explicitly when destinations differ.");
-        expect(destinationHints(lines)).toEqual([]);
-    });
-    it('should suppress legacy allocation hints when a sibling can promote a destination', () => {
-        expect(destinationHints(['command Rename', '  projectId Uuid identifier', '  produces First', '    for projectId', '  produces Legacy'])).toEqual([]);
-    });
-    it.each([
-        ['  produces First', '    name = name', '      for projectId', '  produces Legacy'],
-        ['  produces First', '      name = name', '    for projectId', '  produces Legacy'],
-        ['    produces First', '      name = name', '        for projectId', '  produces Legacy'],
-        ['  produces when name != ""', '    First', '      name = name', '        for projectId', '  produces Legacy'],
-    ])('should not hint allocation when a differently indented destination is promoted', (...productions) => {
-        const lines = ['command Rename', '  projectId Uuid identifier', '  name String', ...productions];
-        expect(scanDocument(lines).commands[0].produces?.[0].target).toBe('projectId');
-        expect(destinationHints(lines)).toEqual([]);
-    });
-    it('should see deeper destinations after fenced event documentation', () => {
-        const lines = ['command Rename', '  projectId Uuid identifier', '  produces event Renamed',
-            '    documentation', '      ```markdown', '      Details', '      ```', '      for otherId', '  produces Legacy'];
-        expect(scanDocument(lines).commands[0].produces?.[0].target).toBe('otherId');
-        expect(destinationHints(lines)).toEqual([]);
-    });
-    it('should suppress hints when a sibling production cannot be classified', () => {
-        expect(destinationHints(['command Rename', '  projectId Uuid identifier', '  produces First', '  produces event'])).toEqual([]);
-        expect(destinationHints(['command Rename', '  projectId Uuid identifier', '  produces event'])).toEqual([]);
-        expect(destinationHints(['command Rename', '  produces First', '  produces when'])).toEqual([]);
-    });
-    it('should place a destination hint before a trailing comment', () => {
-        const lines = ['command Rename', '  projectId Uuid identifier', '  produces event Renamed // note'];
-        expect(destinationHints(lines)).toEqual([{ line: 2, column: '  produces event Renamed'.length + 1, label: 'for projectId' }]);
-    });
-    it('should report duplicate typed properties at the repeated mapping', () => {
-        const lines = [...source, '      name Uuid = otherId // duplicate'];
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0168').map(issue => ({ line: issue.line, severity: issue.severity })))
-            .toEqual([{ line: source.length, severity: 'error' }]);
-    });
-    it('should treat escaped and unescaped inline property names as the same name', () => {
-        expect(validateLines([...source, '    @name String = name']).filter(issue => issue.code === 'PLAY0168').map(issue => issue.line)).toEqual([source.length]);
-    });
-    it('should detect collisions with commented imports in the document', () => {
-        expect(validateLines(['import Other.Renamed // note', ...source]).filter(issue => issue.code === 'PLAY0473').map(issue => issue.line)).toEqual([4]);
-    });
-    it('should detect collisions with commented imports from other files', () => {
-        const application = scanDocument(['import Other.Renamed // note']);
-        expect(validateLines(source, { application }).filter(issue => issue.code === 'PLAY0473').map(issue => issue.line)).toEqual([3]);
-    });
-    it('should not scan imports inside event documentation', () => {
-        const lines = source.map(line => line === '      event NotADeclaration' ? '      import Other.Renamed // prose' : line);
-        expect(scanDocument(lines).imports).toEqual([]);
-        expect(validateLines(lines)).toEqual([]);
-    });
-    it('should hint allocation when all plain productions omit destinations', () => {
-        expect(destinationHints(['command Rename', '  produces First', '  produces Legacy']).map(hint => hint.label)).toEqual(['for <new event source>', 'for <new event source>']);
-    });
-    it('should analyze commented headers, destinations, mappings and metadata like the compiler', () => {
-        const lines = source.map(line => line === '    documentation' ? `${line} // details` : line);
-        lines.push('    projectId Uuid = projectId // note', '  produces Other // sibling', '    for projectId // same identifier');
-        expect(validateLines(lines).filter(issue => ['PLAY0470', 'PLAY0477'].includes(issue.code ?? ''))).toEqual([]);
-        expect(validateLines(lines).find(issue => issue.code === 'PLAY0469')?.severity).toBe('warning');
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-    });
-    it('should suppress hints when a commented sibling targets another source', () => {
-        const lines = [...source, '  produces Other // sibling', '    for otherId // other source'];
-        expect(validateLines(lines).some(issue => issue.code === 'PLAY0470')).toBe(true);
-        expect(destinationHints(lines)).toEqual([]);
-    });
-    it('should preserve comment markers inside strings and templates and ignore fences', () => {
-        const lines = [...source, '    url String = "https://example.org" // url', '    template String = `https://{name}` // template'];
-        expect(scanDocument(lines).commands[0].produces?.[0].mappings.map(mapping => mapping.source)).toContain('"https://example.org"');
-        expect(scanDocument(lines).commands[0].produces?.[0].mappings.map(mapping => mapping.source)).toContain('`https://{name}`');
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-        const fenced = ['command Rename', '  documentation', '    ```markdown', '  produces event Fake', '    for otherId', '    ```'];
-        expect(destinationHints(fenced)).toEqual([]);
-        expect(validateLines(fenced).filter(issue => issue.code?.startsWith('PLAY047'))).toEqual([]);
-    });
-    it('should show metadata hover only on event directives', () => {
-        expect(hoverContent(['event Done', '  id "Old"'], 1, 'id', 3, 5)).toContain('rename');
-        expect(hoverContent(['event Done', '  documentation'], 1, 'documentation', 3, 16)).not.toBeNull();
-        for (const line of ['  id String', '  key id', '  name String = id', '  id String = name']) {
-            const start = line.indexOf('id') + 1;
-            expect(hoverContent(['event Done', line], 1, 'id', start, start + 2)).toBeNull();
-        }
-        expect(hoverContent(['command Done', '  documentation'], 1, 'documentation', 3, 16)).toBeNull();
-    });
-    it('should retain standalone property-shaped id and documentation names', () => expect(scanDocument(['event Done', '  id String', '  documentation String']).events[0].properties.map(property => property.name)).toEqual(['id', 'documentation']));
-});

package/for_inlineEvents/when_completing_many_events.ts

@@ -1,49 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { describe, expect, it, vi } from 'vitest';
-import type { editor, languages, Position } from 'monaco-editor';
-import { createCompletionProvider } from '../completions';
-import { Monaco } from '../language';
-
-const monaco = {
-    Range: class {},
-    languages: { CompletionItemKind: { Event: 1 }, CompletionItemInsertTextRule: { InsertAsSnippet: 1 } },
-} as unknown as Monaco;
-
-function complete(count: number, inline: boolean): { work: number; suggestions: languages.CompletionItem[] } {
-    const lines = [...Array.from({ length: count }, (_, index) => inline ? `command Record${index}\n  produces event Recorded${index}` : `event Recorded${index}`).join('\n').split('\n'),
-        'constraint Unique', '  on '];
-    const model = {
-        getLinesContent: () => lines,
-        getWordUntilPosition: () => ({ word: '', startColumn: 6, endColumn: 6 }),
-    } as unknown as editor.ITextModel;
-    const searches = vi.spyOn(Array.prototype, 'some');
-    const filters = vi.spyOn(Array.prototype, 'filter');
-    const membership = vi.spyOn(Set.prototype, 'has');
-    try {
-        const result = createCompletionProvider(monaco).provideCompletionItems(model, { lineNumber: lines.length, column: 6 } as Position, {} as languages.CompletionContext, {} as never) as languages.CompletionList;
-        return {
-            suggestions: result.suggestions,
-            work: [...searches.mock.contexts, ...filters.mock.contexts].reduce<number>((sum, receiver) => sum + (receiver as unknown[]).length, 0) + membership.mock.calls.length,
-        };
-    } finally {
-        searches.mockRestore();
-        filters.mockRestore();
-        membership.mockRestore();
-    }
-}
-
-describe('when completing many event names in Monaco', () => {
-    it.each([false, true])('should keep completion work linear for inline declarations: %s', inline => {
-        const small = complete(500, inline);
-        const medium = complete(1000, inline);
-        const large = complete(2000, inline);
-        expect(small.work).toBeGreaterThan(0);
-        expect(medium.work).toBeLessThan(small.work * 2.2);
-        expect(large.work).toBeLessThan(medium.work * 2.2);
-        expect(large.suggestions).toHaveLength(2000);
-        expect(large.suggestions.map(item => item.label)).toEqual(Array.from({ length: 2000 }, (_, index) => `Recorded${index}`));
-        expect(large.suggestions.every(item => item.detail === (inline ? 'inline event' : 'event'))).toBe(true);
-    });
-});

package/for_inlineEvents/when_indexing_command_production_ownership.ts

@@ -1,79 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { describe, expect, it } from 'vitest';
-import { destinationHints } from '../production-destinations';
-import { scanDocument } from '../symbols';
-import { validateLines } from '../validation';
-
-describe('when indexing command production ownership', () => {
-    it('should keep the documented multiline authorization out of command properties', () => {
-        const lines = ['policy IsAccountant', '  require role "Accountant"', 'policy IsCustomerSelf', '  require authenticated',
-            'command Rename', '  projectId Uuid identifier',
-            '  authorize IsAccountant', '            or IsCustomerSelf', '  produces event Renamed'];
-        const command = scanDocument(lines).commands[0];
-        expect(command.properties.map(property => property.name)).toEqual(['projectId']);
-        expect(command.produces?.map(production => production.name)).toEqual(['Renamed']);
-        expect(validateLines(lines)).toEqual([]);
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-    });
-
-    it.each(['or IsCustomerSelf', 'and IsCustomerSelf', 'IsCustomerSelf', '(IsCustomerSelf)', 'or IsCüstomerSelf', 'produces Ghost'])('should consume %s as an authorization continuation', continuation => {
-        const lines = ['command Rename', '  authorize IsAccountant', `    ${continuation}`, '  produces Legacy'];
-        const command = scanDocument(lines).commands[0];
-        expect(command.properties).toEqual([]);
-        expect(command.productionHeaders).toEqual([3]);
-        expect(destinationHints(lines).map(hint => hint.line)).toEqual([3]);
-    });
-
-    it('should end authorization ownership at the first nonmatching line, not merely a dedent', () => {
-        const lines = ['command Rename', '  projectId Uuid identifier', '  authorize IsAccountant',
-            '    or IsCustomerSelf // continuation', '    names String[]', '    produces event Renamed'];
-        const command = scanDocument(lines).commands[0];
-        expect(command.properties.map(property => property.name)).toEqual(['projectId', 'names']);
-        expect(command.productionHeaders).toEqual([5]);
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-    });
-
-    it.each([
-        [['  description "Rename the project"']],
-        [['  description', '    ```text', '    produces Ghost', '    ```']],
-    ])('should leave deeper syntax after a description in its command', description => {
-        const lines = ['command Rename', '  projectId Uuid identifier', ...description, '    produces event Renamed'];
-        const command = scanDocument(lines).commands[0];
-        expect(command.properties.map(property => property.name)).toEqual(['projectId']);
-        expect(command.produces?.map(production => production.name)).toEqual(['Renamed']);
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-    });
-
-    it.each(['validate', 'handler', 'concurrency', 'name'])('should keep a deeper production after the %s property in its command', name => {
-        const lines = ['command Rename', '  projectId Uuid identifier', `  ${name} String`,
-            '    produces event Renamed', '      value String = "renamed"'];
-        expect(scanDocument(lines).commands[0].produces?.map(production => production.name)).toEqual(['Renamed']);
-        expect(validateLines(lines)).toEqual([]);
-        expect(destinationHints(lines).map(hint => hint.label)).toEqual(['for projectId']);
-    });
-
-    it.each(['validate', 'handler', 'concurrency'])('should not hint allocation after a deeper destination beneath the %s property', name => {
-        const lines = ['command Rename', '  projectId Uuid identifier', `  ${name} String // a property, not a block`,
-            '    produces First', '      for projectId', '  produces Legacy'];
-        expect(scanDocument(lines).commands[0].produces?.map(production => [production.name, production.target]))
-            .toEqual([['First', 'projectId'], ['Legacy', undefined]]);
-        expect(destinationHints(lines)).toEqual([]);
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0478').map(issue => issue.line)).toEqual([5]);
-    });
-
-    it.each(['validate', 'handler', 'concurrency'])('should suppress hints for an unclassifiable production beneath the %s property', name => {
-        expect(destinationHints(['command Rename', '  projectId Uuid identifier', `  ${name} String`,
-            '    produces event', '  produces Legacy'])).toEqual([]);
-    });
-
-    it.each(['validate', 'validate csharp', 'handler', 'concurrency'])('should keep the %s block opaque to command ownership', directive => {
-        const lines = ['command Rename', `  ${directive}`, '    ghost Uuid identifier', '    produces First', '      for ghost', '  produces Legacy'];
-        const command = scanDocument(lines).commands[0];
-        expect(command.properties).toEqual([]);
-        expect(command.produces?.map(production => production.name)).toEqual(['Legacy']);
-        expect(destinationHints(lines).map(hint => hint.line)).toEqual([5]);
-        expect(validateLines(lines).filter(issue => issue.code === 'PLAY0478')).toEqual([]);
-    });
-});

package/for_planCompletions/when_completing_a_file_import.ts

@@ -1,26 +0,0 @@
-// 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 { completionEntriesFor, planCompletions } from '../completion-planner';
-import { hoverContent } from '../hover-content';
-
-describe('when completing a file import', () => {
-    it('should complete a path inside the quotes, replacing what is typed', () => {
-        planCompletions(['module Ordering', '  import "Ord'], 1, '  import "Ord').should.deep.equal({ kind: 'playFiles', replaceLength: 3 });
-    });
-
-    it('should offer nothing after a quote outside an import', () => {
-        planCompletions(['module Ordering', '  description "'], 1, '  description "').should.deep.equal({ kind: 'none' });
-    });
-
-    for (const [chain, scope] of [[[], 'top level'], [['module'], 'module'], [['feature', 'module'], 'feature']] as const) {
-        it(`should offer a file import at the ${scope}`, () => {
-            completionEntriesFor([...chain]).some((entry) => entry.label === 'import "…"').should.be.true;
-        });
-    }
-
-    it('should document both kinds of import on hover', () => {
-        hoverContent(['import "**/*.play"'], 0, 'import', 1, 7)!.should.contain('places the imported files there');
-    });
-});

package/for_planCompletions/when_completing_a_specification_query.ts

@@ -1,24 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { beforeEach, describe, it } from 'vitest';
-import { completionEntriesFor, CompletionPlan, planCompletions } from '../completion-planner';
-
-describe('when completing a specification query', () => {
-    let plan: CompletionPlan;
-
-    beforeEach(() => {
-        plan = planCompletions([
-            'specification LookingUpAProject',
-            '  then query Pro',
-        ], 1, '  then query Pro');
-    });
-
-    it('should offer the queries declared by the document', () => {
-        plan.kind.should.equal('queries');
-    });
-
-    it('should offer a query assertion in a specification', () => {
-        completionEntriesFor(['specification']).some(entry => entry.label === 'then query').should.be.true;
-    });
-});

package/for_planCompletions/when_completing_a_specification_step.ts

@@ -1,42 +0,0 @@
-// 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 { completionEntriesFor, planCompletions } from '../completion-planner';
-import { hoverContent } from '../hover-content';
-
-const specification = ['slice StateView Hours', '  specification AtOpening'];
-const labelsAfter = (textBefore: string): string[] => {
-    const plan = planCompletions([...specification, textBefore], 2, textBefore);
-    return plan.kind === 'entries' ? plan.entries.map((entry) => entry.label) : [plan.kind];
-};
-
-describe('when completing a specification step', () => {
-    it('should offer what can follow given', () => {
-        labelsAfter('    given ').should.include.members(['clock', 'capture']);
-    });
-
-    it('should offer what can follow when', () => {
-        labelsAfter('    when ').should.include.members(['clock', 'trigger', 'capture', 'query']);
-    });
-
-    it('should offer what can follow then', () => {
-        labelsAfter('    then res').should.include.members(['result', 'result exactly', 'no result']);
-    });
-
-    it('should offer the queries after when query', () => {
-        labelsAfter('    when query Opening').should.deep.equal(['queries']);
-    });
-
-    it('should offer every step on an empty line', () => {
-        completionEntriesFor(['specification']).map((entry) => entry.label).should.include.members(['given clock', 'when trigger', 'when capture', 'when query', 'then result', 'then no result']);
-    });
-
-    it('should document a step word in a specification', () => {
-        hoverContent([...specification, '    when trigger NightlySync'], 2, 'trigger', 10, 17)!.should.contain('application trigger fires');
-    });
-
-    it('should document a step word not in a specification as the keyword', () => {
-        hoverContent(['trigger NightlySync'], 0, 'trigger', 1, 8)!.should.not.contain('application trigger fires');
-    });
-});

package/for_planCompletions/when_completing_an_absent_read_model.ts

@@ -1,14 +0,0 @@
-// 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 { completionEntriesFor } from '../completion-planner';
-
-// VS Code uses the same @cratis/screenplay-language completion entries as Monaco.
-describe('when completing a keyed absence assertion', () => {
-    it('should offer the entire keyed form without child mappings', () => {
-        const entry = completionEntriesFor(['specification']).find(item => item.label === 'then no readmodel');
-        (entry !== undefined).should.be.true;
-        entry!.insertText.should.equal('then no readmodel ${1:ReadModelType} for ${2:key}');
-    });
-});