ddd-ts-kit 0.0.0-stage → 0.1.1

package/dist/check/rules/test-builder-required.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import { inContext } from '../support/in-context.js';
+import { perFile } from '../support/per-file.js';
+const AGGREGATE_SUFFIX = '.aggregate.ts';
+const BUILDER_SUFFIX = '.builder.ts';
+export const testBuilderRequired = {
+    id: 'test/builder-required',
+    description: 'An aggregate has a test data builder in test/builders/.',
+    scope: 'project',
+    run(project) {
+        const { contextsDir } = project.config;
+        const builders = buildersOf(project.contextEntries, contextsDir);
+        return perFile(project, this.id, (file) => {
+            const aggregate = aggregateOf(file);
+            if (aggregate === undefined || builders.has(`${aggregate.context}/${aggregate.base}`)) {
+                return [];
+            }
+            const directory = `${contextsDir}/${aggregate.context}/test/builders/`;
+            const fix = `Create ${directory}${aggregate.base}${BUILDER_SUFFIX} with valid defaults and methods named in the ubiquitous language, building through the public API of the aggregate.`;
+            return [{ line: 1, message: `The aggregate ${aggregate.name} has no builder in ${directory}.`, fix }];
+        });
+    },
+};
+/** `<context>/<aggregate>` for every builder found on disk. */
+function buildersOf(entries, contextsDir) {
+    const builders = entries.flatMap((entry) => {
+        const [context = '', top, folder, ...rest] = entry.slice(contextsDir.length + 1).split('/');
+        const name = rest.at(-1) ?? '';
+        return top === 'test' && folder === 'builders' && name.endsWith(BUILDER_SUFFIX)
+            ? [`${context}/${name.slice(0, -BUILDER_SUFFIX.length)}`]
+            : [];
+    });
+    return new Set(builders);
+}
+function aggregateOf(file) {
+    if (!inContext(file.location) || file.isTest) {
+        return undefined;
+    }
+    const { context, layer, inside } = file.location;
+    const name = path.posix.basename(file.path);
+    if (layer !== 'domain' || inside[0] !== 'aggregates' || !name.endsWith(AGGREGATE_SUFFIX)) {
+        return undefined;
+    }
+    return { context, name, base: name.slice(0, -AGGREGATE_SUFFIX.length) };
+}
+//# sourceMappingURL=test-builder-required.js.map

package/dist/check/rules/test-builder-required.js.map

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

package/dist/check/rules/test-coverage-governed.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const testCoverageGoverned: Rule;
+//# sourceMappingURL=test-coverage-governed.d.ts.map

package/dist/check/rules/test-coverage-governed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-coverage-governed.d.ts","sourceRoot":"","sources":["../../../src/check/rules/test-coverage-governed.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,eAAO,MAAM,oBAAoB,EAAE,IAiBlC,CAAC"}

package/dist/check/rules/test-coverage-governed.js

@@ -0,0 +1,20 @@
+import { ignoreHints } from '../coverage/ignore-hints.js';
+import { runnerSettings } from '../coverage/runner-settings.js';
+import { scriptFlags } from '../coverage/script-flags.js';
+import { DecisionRecords } from '../governance/decision-records.js';
+import { perFile } from '../support/per-file.js';
+import { reporter } from '../support/reporter.js';
+export const testCoverageGoverned = {
+    id: 'test/coverage-governed',
+    description: 'Coverage cannot be gamed by exclusion: the test runner config reads the measured layers and their thresholds from ddd-ts-kit.config.json and writes no include, exclude or thresholds by hand, no script sets them by a flag, and no production source carries a coverage ignore comment without a decision record.',
+    scope: 'file',
+    run(project) {
+        const records = new DecisionRecords(project.root);
+        return perFile(project, this.id, (file) => ignoreHints(file, records));
+    },
+    acrossProject(project) {
+        const report = reporter(project, this.id);
+        return [...runnerSettings(project), ...scriptFlags(project)].map(({ file, line, message, fix }) => report({ file, line }, message, fix));
+    },
+};
+//# sourceMappingURL=test-coverage-governed.js.map

package/dist/check/rules/test-coverage-governed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-coverage-governed.js","sourceRoot":"","sources":["../../../src/check/rules/test-coverage-governed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,EAAE,EAAE,wBAAwB;IAC5B,WAAW,EACT,qTAAqT;IACvT,KAAK,EAAE,MAAM;IACb,GAAG,CAAC,OAAO;QACT,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAElD,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,aAAa,CAAC,OAAO;QACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1C,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAChG,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CACrC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/check/rules/test-no-mocks.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const testNoMocks: Rule;
+//# sourceMappingURL=test-no-mocks.d.ts.map

package/dist/check/rules/test-no-mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-no-mocks.d.ts","sourceRoot":"","sources":["../../../src/check/rules/test-no-mocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAuB7C,eAAO,MAAM,WAAW,EAAE,IA4BzB,CAAC"}

package/dist/check/rules/test-no-mocks.js

@@ -0,0 +1,42 @@
+import { inContext } from '../support/in-context.js';
+import { perFile } from '../support/per-file.js';
+const MOCK_CALL = /(?<![\w$.])(vi|jest)\s*\.\s*(mock|doMock|unstable_mockModule|fn|spyOn|mocked)(?![\w$])/g;
+const MOCKING_LIBRARIES = new Set([
+    'sinon',
+    'ts-mockito',
+    'jest-mock',
+    'jest-mock-extended',
+    'vitest-mock-extended',
+    'testdouble',
+    'ts-auto-mock',
+    'typemoq',
+    'moq.ts',
+    '@golevelup/ts-jest',
+    '@golevelup/ts-vitest',
+]);
+const FIX = 'Use the fake of the port from test/fakes (a working in-memory implementation) and assert its state, the events on the in-memory bus or the returned value instead of calls.';
+export const testNoMocks = {
+    id: 'test/no-mocks',
+    description: "No vi.mock, jest.mock, vi.fn, jest.fn, vi.spyOn, jest.spyOn or mocking library in a context's tests: use the fake of the port.",
+    scope: 'file',
+    run(project) {
+        return perFile(project, this.id, (file) => {
+            if (!inContext(file.location) || !file.isTest) {
+                return [];
+            }
+            const calls = [...file.scan.code.matchAll(MOCK_CALL)].map((match) => ({
+                line: file.scan.lineAt(match.index),
+                message: `The test uses ${match[1] ?? ''}.${match[2] ?? ''}.`,
+                fix: FIX,
+            }));
+            const libraries = file.imports.flatMap(({ target, line }) => {
+                if (target.kind !== 'package' || !MOCKING_LIBRARIES.has(target.name)) {
+                    return [];
+                }
+                return [{ line, message: `The test imports the mocking library "${target.name}".`, fix: FIX }];
+            });
+            return [...calls, ...libraries];
+        });
+    },
+};
+//# sourceMappingURL=test-no-mocks.js.map

package/dist/check/rules/test-no-mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-no-mocks.js","sourceRoot":"","sources":["../../../src/check/rules/test-no-mocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,SAAS,GAAG,yFAAyF,CAAC;AAE5G,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,OAAO;IACP,YAAY;IACZ,WAAW;IACX,oBAAoB;IACpB,sBAAsB;IACtB,YAAY;IACZ,cAAc;IACd,SAAS;IACT,QAAQ;IACR,oBAAoB;IACpB,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,GAAG,GACP,6KAA6K,CAAC;AAEhL,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,eAAe;IACnB,WAAW,EACT,gIAAgI;IAClI,KAAK,EAAE,MAAM;IACb,GAAG,CAAC,OAAO;QACT,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACpE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACnC,OAAO,EAAE,iBAAiB,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG;gBAC7D,GAAG,EAAE,GAAG;aACT,CAAC,CAAC,CAAC;YAEJ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrE,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAED,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,yCAAyC,MAAM,CAAC,IAAI,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACjG,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/check/rules/test-spec-required.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const testSpecRequired: Rule;
+//# sourceMappingURL=test-spec-required.d.ts.map

package/dist/check/rules/test-spec-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spec-required.d.ts","sourceRoot":"","sources":["../../../src/check/rules/test-spec-required.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAgB7C,eAAO,MAAM,gBAAgB,EAAE,IA0B9B,CAAC"}

package/dist/check/rules/test-spec-required.js

@@ -0,0 +1,52 @@
+import path from 'node:path';
+import { roleOf } from '../canonical/role-of.js';
+import { inContext } from '../support/in-context.js';
+import { perFile } from '../support/per-file.js';
+import { roleDirectory } from '../support/role-directory.js';
+const SPEC = /\.(?:spec|test)\.ts$/;
+export const testSpecRequired = {
+    id: 'test/spec-required',
+    description: "Every aggregate, value object, domain service, command handler, query handler, domain event handler, integration event handler and job has a *.spec.ts in the context's test/.",
+    scope: 'project',
+    run(project) {
+        const { contextsDir } = project.config;
+        const specs = specsOf(project.contextEntries, contextsDir);
+        return perFile(project, this.id, (file) => {
+            const subject = subjectOf(file);
+            if (subject === undefined ||
+                specs.has(`${subject.context}/${subject.base}`) ||
+                specs.has(`${subject.context}/${subject.short}`)) {
+                return [];
+            }
+            const directory = `${contextsDir}/${subject.context}/test/`;
+            const fix = `Create ${directory}unit/${subject.base}.spec.ts that names the expected behaviour in business language and exercises it without mocks.`;
+            return [{ line: 1, message: `${subject.name} has no spec in ${directory}.`, fix }];
+        });
+    },
+};
+/** `<context>/<name without .spec.ts>` for every spec found on disk. */
+function specsOf(entries, contextsDir) {
+    const specs = entries.flatMap((entry) => {
+        const [context = '', top, ...rest] = entry.slice(contextsDir.length + 1).split('/');
+        const name = rest.at(-1) ?? '';
+        return top === 'test' && SPEC.test(name) ? [`${context}/${name.replace(SPEC, '')}`] : [];
+    });
+    return new Set(specs);
+}
+function subjectOf(file) {
+    if (!inContext(file.location) || file.isTest) {
+        return undefined;
+    }
+    const name = path.posix.basename(file.path);
+    const suffix = roleOf(roleDirectory(file.location))?.specFor?.find((candidate) => name.endsWith(candidate));
+    if (suffix === undefined) {
+        return undefined;
+    }
+    return {
+        context: file.location.context,
+        name,
+        base: name.slice(0, -'.ts'.length),
+        short: name.slice(0, -suffix.length),
+    };
+}
+//# sourceMappingURL=test-spec-required.js.map

package/dist/check/rules/test-spec-required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spec-required.js","sourceRoot":"","sources":["../../../src/check/rules/test-spec-required.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,IAAI,GAAG,sBAAsB,CAAC;AAUpC,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,oBAAoB;IACxB,WAAW,EACT,gLAAgL;IAClL,KAAK,EAAE,SAAS;IAChB,GAAG,CAAC,OAAO;QACT,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAE3D,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAEhC,IACE,OAAO,KAAK,SAAS;gBACrB,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/C,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,EAChD,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,OAAO,QAAQ,CAAC;YAC5D,MAAM,GAAG,GAAG,UAAU,SAAS,QAAQ,OAAO,CAAC,IAAI,iGAAiG,CAAC;YAErJ,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,mBAAmB,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,wEAAwE;AACxE,SAAS,OAAO,CAAC,OAA0B,EAAE,WAAmB;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE/B,OAAO,GAAG,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAE5G,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;QAC9B,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/check/rules/tracing-platform-only.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const tracingPlatformOnly: Rule;
+//# sourceMappingURL=tracing-platform-only.d.ts.map

package/dist/check/rules/tracing-platform-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-platform-only.d.ts","sourceRoot":"","sources":["../../../src/check/rules/tracing-platform-only.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,eAAO,MAAM,mBAAmB,EAAE,IAuBjC,CAAC"}

package/dist/check/rules/tracing-platform-only.js

@@ -0,0 +1,46 @@
+import { isUnder } from '../project/is-under.js';
+import { perFile } from '../support/per-file.js';
+const TRACING_PACKAGE = '@ddd-ts-kit/tracing';
+const OPEN_TELEMETRY_SCOPE = '@opentelemetry/';
+export const tracingPlatformOnly = {
+    id: 'tracing/platform-only',
+    description: 'Tracing is wired once: @ddd-ts-kit/tracing and @opentelemetry/* are imported only by the platform directory, main.ts and apps/.',
+    scope: 'file',
+    run(project) {
+        const { platformDir } = project.config;
+        const fix = `Remove the import: adapters are wrapped by the \`decorate\` hook of the composition root and use cases by a bus middleware; what has to open a span of its own lives in ${platformDir}/.`;
+        return perFile(project, this.id, (file) => {
+            if (!isJudged(file, project)) {
+                return [];
+            }
+            return file.imports
+                .filter(({ target }) => target.kind === 'package' && isTracing(target.name))
+                .map(({ line, specifier }) => ({
+                line,
+                message: `"${specifier}" is imported in ${placeOf(file)}: tracing is wired once, by the platform.`,
+                fix,
+            }));
+        });
+    },
+};
+/** Every source under the source root, tests included, but the platform, `main.ts` and the entry points under `apps/`. */
+function isJudged({ location, path }, { config }) {
+    const isWiring = location.area === 'platform' || location.area === 'main' || isUnder(path, `${config.sourceRoot}/apps`);
+    return path.startsWith(`${config.sourceRoot}/`) && !isWiring;
+}
+function isTracing(packageName) {
+    return packageName === TRACING_PACKAGE || packageName.startsWith(OPEN_TELEMETRY_SCOPE);
+}
+function placeOf({ location, path }) {
+    if (location.area === 'shared-kernel') {
+        return 'the shared kernel';
+    }
+    if (location.area !== 'context') {
+        return path;
+    }
+    if (location.layer === 'module') {
+        return `the module file of "${location.context}"`;
+    }
+    return location.layer === 'root' ? path : `${location.layer}/`;
+}
+//# sourceMappingURL=tracing-platform-only.js.map

package/dist/check/rules/tracing-platform-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-platform-only.js","sourceRoot":"","sources":["../../../src/check/rules/tracing-platform-only.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,EAAE,EAAE,uBAAuB;IAC3B,WAAW,EACT,iIAAiI;IACnI,KAAK,EAAE,MAAM;IACb,GAAG,CAAC,OAAO;QACT,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACvC,MAAM,GAAG,GAAG,2KAA2K,WAAW,IAAI,CAAC;QAEvM,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,IAAI,CAAC,OAAO;iBAChB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;iBAC3E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7B,IAAI;gBACJ,OAAO,EAAE,IAAI,SAAS,oBAAoB,OAAO,CAAC,IAAI,CAAC,2CAA2C;gBAClG,GAAG;aACJ,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,0HAA0H;AAC1H,SAAS,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAc,EAAE,EAAE,MAAM,EAAW;IACnE,MAAM,QAAQ,GACZ,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,OAAO,CAAC,CAAC;IAEzG,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC/D,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,OAAO,WAAW,KAAK,eAAe,IAAI,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAc;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACtC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,uBAAuB,QAAQ,CAAC,OAAO,GAAG,CAAC;IACpD,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC;AACjE,CAAC"}

package/dist/check/rules/tree-closed.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const treeClosed: Rule;
+//# sourceMappingURL=tree-closed.d.ts.map

package/dist/check/rules/tree-closed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-closed.d.ts","sourceRoot":"","sources":["../../../src/check/rules/tree-closed.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAY7C,eAAO,MAAM,UAAU,EAAE,IA+BxB,CAAC"}

package/dist/check/rules/tree-closed.js

@@ -0,0 +1,88 @@
+import path from 'node:path';
+import { barrelFile } from '../../declared/index.js';
+import { isCanonicalDirectory } from '../canonical/is-canonical-directory.js';
+import { OPEN_DIRECTORIES } from '../canonical/open-directories.js';
+import { roleOf } from '../canonical/role-of.js';
+import { reporter } from '../support/reporter.js';
+export const treeClosed = {
+    id: 'tree/closed',
+    description: 'A context holds only the canonical directories (plus its declared extraDirectories), and no source file outside a role directory.',
+    scope: 'project',
+    run(project) {
+        const report = reporter(project, this.id);
+        // A rejected directory is reported once: what it holds is not reported again.
+        const rejected = [];
+        return project.contextEntries.flatMap((entry) => {
+            const placed = place(entry, project.config);
+            if (placed === undefined || rejected.some((parent) => entry.startsWith(parent))) {
+                return [];
+            }
+            const isDirectory = entry.endsWith('/');
+            const flaw = isDirectory ? strayDirectory(placed) : straySource(placed);
+            if (flaw === undefined) {
+                return [];
+            }
+            if (isDirectory) {
+                rejected.push(entry);
+            }
+            return [report({ file: entry.replace(/\/$/, ''), line: 1 }, flaw.message, flaw.fix)];
+        });
+    },
+};
+function place(entry, { contextsDir, contexts, stack }) {
+    const [context = '', ...rest] = entry
+        .slice(contextsDir.length + 1)
+        .replace(/\/$/, '')
+        .split('/');
+    if (rest.length === 0) {
+        return undefined;
+    }
+    return {
+        context,
+        declared: stack.style === 'declared',
+        inside: rest.join('/'),
+        extras: contexts[context]?.extraDirectories ?? [],
+    };
+}
+function strayDirectory({ context, inside, extras }) {
+    if (isCanonicalDirectory(inside) || coveredByExtra(extras, inside)) {
+        return undefined;
+    }
+    return {
+        message: `"${inside}" is not a directory of the canonical tree.`,
+        fix: `Move its files to the canonical directory of their role (see \`ddd-ts-kit explain tree/closed\`), or, if this is a design decision, add "${inside}" to contexts.${context}.extraDirectories in ddd-ts-kit.config.json.`,
+    };
+}
+function straySource(placed) {
+    const { inside, extras } = placed;
+    if (!inside.endsWith('.ts')) {
+        return undefined;
+    }
+    const directory = path.posix.dirname(inside);
+    if (directory === '.') {
+        return atContextRoot(placed);
+    }
+    const open = OPEN_DIRECTORIES.some((root) => directory === root || directory.startsWith(`${root}/`));
+    if (open || roleOf(directory) !== undefined || coveredByExtra(extras, directory)) {
+        return undefined;
+    }
+    return {
+        message: `"${inside}" is not in a role directory.`,
+        fix: `Move it one level down into the directory of its role (for example ${directory.split('/')[0] ?? directory}/<role>/), so that its suffix and its tests can be checked.`,
+    };
+}
+function atContextRoot({ context, declared, inside: file }) {
+    const barrel = barrelFile(context);
+    if (file === `${context}.module.ts` || (declared && file === barrel)) {
+        return undefined;
+    }
+    const allowed = declared ? `CONTEXT.md, ${barrel} and ${context}.module.ts` : `CONTEXT.md and ${context}.module.ts`;
+    return {
+        message: `"${file}" sits at the root of the context.`,
+        fix: `Move it into the directory of its role; only ${allowed} live at the root of a context.`,
+    };
+}
+function coveredByExtra(extras, directory) {
+    return extras.some((extra) => directory === extra || directory.startsWith(`${extra}/`) || extra.startsWith(`${directory}/`));
+}
+//# sourceMappingURL=tree-closed.js.map

package/dist/check/rules/tree-closed.js.map

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

package/dist/check/rules/tree-context-doc.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const treeContextDoc: Rule;
+//# sourceMappingURL=tree-context-doc.d.ts.map

package/dist/check/rules/tree-context-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-context-doc.d.ts","sourceRoot":"","sources":["../../../src/check/rules/tree-context-doc.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,eAAO,MAAM,cAAc,EAAE,IA+B5B,CAAC"}

package/dist/check/rules/tree-context-doc.js

@@ -0,0 +1,67 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CLASSIFICATIONS } from '../../config/index.js';
+import { CONTEXT_DOC_HEADINGS } from '../canonical/context-doc-headings.js';
+import { reporter } from '../support/reporter.js';
+import { toViolations } from '../support/to-violations.js';
+export const treeContextDoc = {
+    id: 'tree/context-doc',
+    description: 'Every context has a CONTEXT.md with the required sections and the classification declared in the config.',
+    scope: 'project',
+    run(project) {
+        const report = reporter(project, this.id);
+        return project.contextsOnDisk.flatMap((context) => {
+            const file = `${project.config.contextsDir}/${context}/CONTEXT.md`;
+            const text = readIfPresent(path.join(project.root, file));
+            if (text === undefined) {
+                return [
+                    report({ file, line: 1 }, `The context "${context}" has no CONTEXT.md.`, `Create ${file} with the sections ${CONTEXT_DOC_HEADINGS.join(', ')}.`),
+                ];
+            }
+            const lines = text.split('\n').map((line) => line.trim());
+            const expected = project.config.contexts[context]?.classification;
+            return toViolations(report, file, [
+                ...missingSections(lines),
+                ...(expected === undefined ? [] : otherClassification(lines, context, expected)),
+            ]);
+        });
+    },
+};
+function readIfPresent(file) {
+    try {
+        return fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function missingSections(lines) {
+    return CONTEXT_DOC_HEADINGS.filter((heading) => !lines.some((line) => line.toLowerCase() === heading.toLowerCase())).map((heading) => ({
+        line: 1,
+        message: `CONTEXT.md lacks the section "${heading}".`,
+        fix: `Add a "${heading}" section and fill it in with the domain expert's words.`,
+    }));
+}
+function otherClassification(lines, context, expected) {
+    const at = lines.findIndex((line) => line.toLowerCase() === '## classification');
+    if (at === -1) {
+        return [];
+    }
+    const end = lines.findIndex((line, index) => index > at && line.startsWith('## '));
+    const section = lines
+        .slice(at + 1, end === -1 ? undefined : end)
+        .join(' ')
+        .toLowerCase();
+    const stated = CLASSIFICATIONS.filter((candidate) => new RegExp(`\\b${candidate}\\b`).test(section));
+    if (stated.length === 1 && stated[0] === expected) {
+        return [];
+    }
+    return [
+        {
+            line: at + 1,
+            message: `CONTEXT.md states the classification "${stated.join(', ') || 'none'}" but the config says "${expected}".`,
+            fix: `Write "${expected}" under "## Classification", or change contexts.${context}.classification in ddd-ts-kit.config.json if the strategic decision changed.`,
+        },
+    ];
+}
+//# sourceMappingURL=tree-context-doc.js.map

package/dist/check/rules/tree-context-doc.js.map

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

package/dist/check/scan/blank.d.ts

@@ -0,0 +1,3 @@
+/** The same text with everything but its line breaks turned into spaces: offsets and lines are preserved. */
+export declare function blank(text: string): string;
+//# sourceMappingURL=blank.d.ts.map

package/dist/check/scan/blank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank.d.ts","sourceRoot":"","sources":["../../../src/check/scan/blank.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C"}

package/dist/check/scan/blank.js

@@ -0,0 +1,5 @@
+/** The same text with everything but its line breaks turned into spaces: offsets and lines are preserved. */
+export function blank(text) {
+    return text.replace(/[^\n]/g, ' ');
+}
+//# sourceMappingURL=blank.js.map

package/dist/check/scan/blank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank.js","sourceRoot":"","sources":["../../../src/check/scan/blank.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/check/scan/block-comment-record.d.ts

@@ -0,0 +1,11 @@
+export interface BlockCommentRecord {
+    /** Line of the opening delimiter. */
+    readonly line: number;
+    readonly endLine: number;
+    /** Content between the delimiters, untouched. */
+    readonly text: string;
+    readonly jsdoc: boolean;
+    /** Offset just after the closing delimiter. */
+    readonly end: number;
+}
+//# sourceMappingURL=block-comment-record.d.ts.map

package/dist/check/scan/block-comment-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-comment-record.d.ts","sourceRoot":"","sources":["../../../src/check/scan/block-comment-record.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/check/scan/block-comment-record.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-comment-record.js.map

package/dist/check/scan/block-comment-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-comment-record.js","sourceRoot":"","sources":["../../../src/check/scan/block-comment-record.ts"],"names":[],"mappings":""}

package/dist/check/scan/clause-names.d.ts

@@ -0,0 +1,7 @@
+/** The local names an import clause binds, and the ones among them written `type X`. */
+export interface ClauseNames {
+    readonly names: string[];
+    readonly typeNames: string[];
+}
+export declare function clauseNames(clause: string): ClauseNames;
+//# sourceMappingURL=clause-names.d.ts.map

package/dist/check/scan/clause-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clause-names.d.ts","sourceRoot":"","sources":["../../../src/check/scan/clause-names.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;CAC9B;AAID,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAYvD"}

package/dist/check/scan/clause-names.js

@@ -0,0 +1,24 @@
+const IDENTIFIER = /^[\w$]+$/;
+export function clauseNames(clause) {
+    const braces = /\{([^}]*)\}/.exec(clause)?.[1] ?? '';
+    const named = braces
+        .split(',')
+        .map(namedBinding)
+        .filter((binding) => IDENTIFIER.test(binding.local));
+    return {
+        names: [...defaultAndNamespaceNames(clause.replace(/\{[^}]*\}/, ' ')), ...named.map((binding) => binding.local)],
+        typeNames: named.filter((binding) => binding.isType).map((binding) => binding.local),
+    };
+}
+function namedBinding(part) {
+    const trimmed = part.trim();
+    const cleaned = trimmed.replace(/^type\s+/, '');
+    return { local: /\bas\s+([\w$]+)$/.exec(cleaned)?.[1] ?? cleaned, isType: cleaned !== trimmed };
+}
+function defaultAndNamespaceNames(outsideBraces) {
+    return outsideBraces
+        .split(',')
+        .map((part) => /\*\s*as\s+([\w$]+)/.exec(part)?.[1] ?? part.trim())
+        .filter((word) => IDENTIFIER.test(word) && word !== 'type');
+}
+//# sourceMappingURL=clause-names.js.map

package/dist/check/scan/clause-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clause-names.js","sourceRoot":"","sources":["../../../src/check/scan/clause-names.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAErD,MAAM,KAAK,GAAG,MAAM;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,YAAY,CAAC;SACjB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvD,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChH,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEhD,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,wBAAwB,CAAC,aAAqB;IACrD,OAAO,aAAa;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;SAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/check/scan/comment-record.d.ts

@@ -0,0 +1,9 @@
+export interface CommentRecord {
+    readonly line: number;
+    readonly text: string;
+    /** False for a comment that shares its line with code. */
+    readonly ownLine: boolean;
+    /** Offset just after the comment. */
+    readonly end: number;
+}
+//# sourceMappingURL=comment-record.d.ts.map

package/dist/check/scan/comment-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-record.d.ts","sourceRoot":"","sources":["../../../src/check/scan/comment-record.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/check/scan/comment-record.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=comment-record.js.map

package/dist/check/scan/comment-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-record.js","sourceRoot":"","sources":["../../../src/check/scan/comment-record.ts"],"names":[],"mappings":""}

package/dist/check/scan/find-imports.d.ts

@@ -0,0 +1,5 @@
+import type { ImportRecord } from './import-record.js';
+import type { StringRecord } from './string-record.js';
+/** The import and export statements of a blanked source: one record per string literal that is a module specifier. */
+export declare function findImports(code: string, strings: readonly StringRecord[], lineAt: (offset: number) => number): ImportRecord[];
+//# sourceMappingURL=find-imports.d.ts.map

package/dist/check/scan/find-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-imports.d.ts","sourceRoot":"","sources":["../../../src/check/scan/find-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,sHAAsH;AACtH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GACjC,YAAY,EAAE,CAMhB"}

package/dist/check/scan/find-imports.js

@@ -0,0 +1,9 @@
+import { statementOf } from './statement-of.js';
+/** The import and export statements of a blanked source: one record per string literal that is a module specifier. */
+export function findImports(code, strings, lineAt) {
+    return strings.flatMap((literal) => {
+        const found = statementOf(code, literal);
+        return found === undefined ? [] : [{ ...found.record, specifier: literal.value, line: lineAt(found.offset) }];
+    });
+}
+//# sourceMappingURL=find-imports.js.map

package/dist/check/scan/find-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-imports.js","sourceRoot":"","sources":["../../../src/check/scan/find-imports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,sHAAsH;AACtH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,OAAgC,EAChC,MAAkC;IAElC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/check/scan/found-statement.d.ts

@@ -0,0 +1,8 @@
+import type { ImportRecord } from './import-record.js';
+/** The statement a module specifier belongs to. */
+export interface FoundStatement {
+    readonly record: Omit<ImportRecord, 'specifier' | 'line'>;
+    /** Offset of the statement keyword in the blanked source. */
+    readonly offset: number;
+}
+//# sourceMappingURL=found-statement.d.ts.map