@ddd-ts-kit/eslint-plugin 0.0.0-stage → 0.1.0

package/dist/project/linted-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linted-file.d.ts","sourceRoot":"","sources":["../../src/project/linted-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B"}

package/dist/project/linted-file.js

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

package/dist/project/linted-file.js.map

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

package/dist/project/locate.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from './config.js';
+import type { Location } from './location.js';
+/** Same decision table as `locate` of the CLI: a file is classified by its path alone. */
+export declare function locate(config: Config, file: string): Location;
+//# sourceMappingURL=locate.d.ts.map

package/dist/project/locate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../../src/project/locate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW9C,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAkB7D"}

package/dist/project/locate.js

@@ -0,0 +1,47 @@
+const LAYERS = [
+    'domain',
+    'application',
+    'infrastructure',
+    'presentation',
+    'published-language',
+    'test',
+];
+/** Same decision table as `locate` of the CLI: a file is classified by its path alone. */
+export function locate(config, file) {
+    if (isUnder(file, config.contextsDir)) {
+        return locateInContexts(config, file);
+    }
+    if (isUnder(file, config.sharedKernelDir)) {
+        return { area: 'shared-kernel' };
+    }
+    if (isUnder(file, config.platformDir)) {
+        return { area: 'platform' };
+    }
+    if (file === `${config.sourceRoot}/main.ts`) {
+        return { area: 'main' };
+    }
+    return { area: 'other' };
+}
+function locateInContexts(config, file) {
+    const [context, first, ...rest] = file.slice(config.contextsDir.length + 1).split('/');
+    if (context === undefined || context === '' || first === undefined) {
+        return { area: 'other' };
+    }
+    if (rest.length === 0) {
+        return locateAtContextRoot(context, first);
+    }
+    const layer = LAYERS.find((candidate) => candidate === first) ?? 'root';
+    return { area: 'context', context, layer, inside: layer === 'root' ? [first, ...rest] : rest };
+}
+/** A directory import (`../billing/published-language`) names the layer without a file. */
+function locateAtContextRoot(context, entry) {
+    if (entry === `${context}.module.ts`) {
+        return { area: 'context', context, layer: 'module', inside: [] };
+    }
+    const named = LAYERS.find((candidate) => candidate === entry.replace(/\.ts$/, ''));
+    return { area: 'context', context, layer: named ?? 'root', inside: [] };
+}
+function isUnder(file, directory) {
+    return file === directory || file.startsWith(`${directory}/`);
+}
+//# sourceMappingURL=locate.js.map

package/dist/project/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/project/locate.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAqB;IAC/B,QAAQ;IACR,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,oBAAoB;IACpB,MAAM;CACP,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,IAAY;IACjD,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,UAAU,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,IAAY;IACpD,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEvF,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC;IAExE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjG,CAAC;AAED,2FAA2F;AAC3F,SAAS,mBAAmB,CAAC,OAAe,EAAE,KAAa;IACzD,IAAI,KAAK,KAAK,GAAG,OAAO,YAAY,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,SAAiB;IAC9C,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/project/location.d.ts

@@ -0,0 +1,11 @@
+import type { Layer } from './layer.js';
+export interface ContextLocation {
+    readonly area: 'context';
+    readonly context: string;
+    readonly layer: Layer;
+    readonly inside: readonly string[];
+}
+export type Location = ContextLocation | {
+    readonly area: 'shared-kernel' | 'platform' | 'main' | 'other';
+};
+//# sourceMappingURL=location.d.ts.map

package/dist/project/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/project/location.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/project/location.js

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

package/dist/project/location.js.map

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

package/dist/project/parse-allowed-file.d.ts

@@ -0,0 +1,4 @@
+import type { AllowedFile } from './config.js';
+/** An entry without a file or without a reason allows nothing: `ddd-ts-kit check` reports it as `config/valid`. */
+export declare function parseAllowedFile(value: unknown): AllowedFile[];
+//# sourceMappingURL=parse-allowed-file.d.ts.map

package/dist/project/parse-allowed-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-allowed-file.d.ts","sourceRoot":"","sources":["../../src/project/parse-allowed-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAQ9D"}

package/dist/project/parse-allowed-file.js

@@ -0,0 +1,11 @@
+import { posix } from './posix.js';
+import { isRecord } from './is-record.js';
+/** An entry without a file or without a reason allows nothing: `ddd-ts-kit check` reports it as `config/valid`. */
+export function parseAllowedFile(value) {
+    if (!isRecord(value) || typeof value['file'] !== 'string' || typeof value['reason'] !== 'string') {
+        return [];
+    }
+    const allowed = { file: posix(value['file']), reason: value['reason'].trim() };
+    return allowed.file === '' || allowed.reason === '' ? [] : [allowed];
+}
+//# sourceMappingURL=parse-allowed-file.js.map

package/dist/project/parse-allowed-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-allowed-file.js","sourceRoot":"","sources":["../../src/project/parse-allowed-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,mHAAmH;AACnH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QACjG,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAE/E,OAAO,OAAO,CAAC,IAAI,KAAK,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/project/parse-config.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from './config.js';
+/** No function is longer, whatever the config says: `clean/function-size` reads a higher limit as this one. */
+export declare const FUNCTION_LINES_CEILING = 100;
+/**
+ * Mirrors `parseConfig` of the CLI key by key, minus the stack choices that only the
+ * generator needs: of `stack`, the style, the assembly and the ORM are kept. A malformed value falls back to its default: `ddd-ts-kit check` reports it
+ * as `config/valid`, a linter run must not stop on it.
+ */
+export declare function parseConfig(raw: unknown): Config;
+//# sourceMappingURL=parse-config.d.ts.map

package/dist/project/parse-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-config.d.ts","sourceRoot":"","sources":["../../src/project/parse-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO/G,+GAA+G;AAC/G,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAkB1C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAuBhD"}

package/dist/project/parse-config.js

@@ -0,0 +1,113 @@
+import { parseAllowedFile } from './parse-allowed-file.js';
+import { posix } from './posix.js';
+import { isRecord } from './is-record.js';
+const DEFAULT_LIMITS = { maxParameters: 3, maxFunctionLines: 30 };
+/** No function is longer, whatever the config says: `clean/function-size` reads a higher limit as this one. */
+export const FUNCTION_LINES_CEILING = 100;
+const STYLES = ['declared', 'explicit'];
+const ASSEMBLIES = ['barrel', 'discovery'];
+const KERNEL = ['@ddd-ts-kit/kernel'];
+/** The application layer declares its permissions and policies with `@ddd-ts-kit/auth`, which imports the kernel only. */
+const APPLICATION = [...KERNEL, '@ddd-ts-kit/auth'];
+const SCHEMA_LIBRARIES = {
+    zod: ['zod'],
+    'class-validator': ['class-validator', 'class-transformer'],
+    'standard-schema': [],
+    none: [],
+};
+/**
+ * Mirrors `parseConfig` of the CLI key by key, minus the stack choices that only the
+ * generator needs: of `stack`, the style, the assembly and the ORM are kept. A malformed value falls back to its default: `ddd-ts-kit check` reports it
+ * as `config/valid`, a linter run must not stop on it.
+ */
+export function parseConfig(raw) {
+    const source = isRecord(raw) ? raw : {};
+    const sourceRoot = posix(text(source['sourceRoot'], 'src'));
+    return {
+        sourceRoot,
+        contextsDir: posix(text(source['contextsDir'], `${sourceRoot}/contexts`)),
+        sharedKernelDir: posix(text(source['sharedKernelDir'], `${sourceRoot}/shared-kernel`)),
+        platformDir: posix(text(source['platformDir'], `${sourceRoot}/platform`)),
+        importAlias: text(source['importAlias'], '@/'),
+        contexts: mapEntries(source['contexts'], parseContext),
+        rules: mapEntries(source['rules'], String),
+        domainAllowedPackages: strings(source['domainAllowedPackages'], KERNEL),
+        applicationAllowedPackages: strings(source['applicationAllowedPackages'], APPLICATION),
+        publishedLanguageAllowedPackages: strings(source['publishedLanguageAllowedPackages'], contractPackages(source['stack'])),
+        limits: parseLimits(source['limits']),
+        onePerFile: parseOnePerFile(source['onePerFile']),
+        stack: parseStack(source['stack']),
+        standardInterfaces: parseStandardInterfaces(source['standardInterfaces']),
+    };
+}
+function parseStack(value) {
+    const raw = isRecord(value) ? value : {};
+    return {
+        style: oneOf(STYLES, raw['style'], 'explicit'),
+        assembly: oneOf(ASSEMBLIES, raw['assembly'], 'barrel'),
+        orm: text(raw['orm'], 'drizzle'),
+    };
+}
+function contractPackages(stack) {
+    const validation = isRecord(stack) ? text(stack['validation'], 'zod') : 'zod';
+    return [...KERNEL, '@ddd-ts-kit/events', '@ddd-ts-kit/validation', ...(SCHEMA_LIBRARIES[validation] ?? [])];
+}
+function parseContext(value) {
+    const raw = isRecord(value) ? value : {};
+    const upstreams = Array.isArray(raw['upstreams']) ? raw['upstreams'] : [];
+    const extra = Array.isArray(raw['extraDirectories']) ? raw['extraDirectories'] : [];
+    return {
+        classification: text(raw['classification'], ''),
+        upstreams: upstreams.map(parseUpstream).filter((upstream) => upstream !== undefined),
+        extraDirectories: extra.map(parseExtraDirectory).filter((directory) => directory !== undefined),
+    };
+}
+function parseUpstream(value) {
+    if (typeof value === 'string') {
+        return { context: value, relationship: 'published-language' };
+    }
+    if (!isRecord(value) || typeof value['context'] !== 'string') {
+        return undefined;
+    }
+    return { context: value['context'], relationship: text(value['relationship'], 'published-language') };
+}
+function parseExtraDirectory(value) {
+    if (typeof value === 'string') {
+        return posix(value);
+    }
+    if (isRecord(value) && typeof value['path'] === 'string') {
+        return posix(value['path']);
+    }
+    return undefined;
+}
+function parseStandardInterfaces(value) {
+    const entries = Object.entries(isRecord(value) ? value : {}).flatMap(([name, instead]) => instead === false || (typeof instead === 'string' && instead !== '') ? [[name, instead]] : []);
+    return Object.fromEntries(entries);
+}
+function parseLimits(value) {
+    const raw = isRecord(value) ? value : {};
+    return {
+        maxParameters: positive(raw['maxParameters'], DEFAULT_LIMITS.maxParameters),
+        maxFunctionLines: Math.min(positive(raw['maxFunctionLines'], DEFAULT_LIMITS.maxFunctionLines), FUNCTION_LINES_CEILING),
+    };
+}
+function parseOnePerFile(value) {
+    const allow = isRecord(value) && Array.isArray(value['allow']) ? value['allow'] : [];
+    return { allow: allow.flatMap(parseAllowedFile) };
+}
+function positive(candidate, fallback) {
+    return typeof candidate === 'number' && Number.isInteger(candidate) && candidate > 0 ? candidate : fallback;
+}
+function mapEntries(value, parse) {
+    return isRecord(value) ? Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, parse(entry)])) : {};
+}
+function strings(value, fallback) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : fallback;
+}
+function oneOf(values, candidate, fallback) {
+    return values.find((value) => value === candidate) ?? fallback;
+}
+function text(value, fallback) {
+    return typeof value === 'string' ? value : fallback;
+}
+//# sourceMappingURL=parse-config.js.map

package/dist/project/parse-config.js.map

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

package/dist/project/plugin-settings.d.ts

@@ -0,0 +1,8 @@
+/** `settings['ddd-ts-kit']`: lets a test or an editor inject what is otherwise read from disk. */
+export interface PluginSettings {
+    readonly config?: unknown;
+    readonly rootDir?: string;
+    /** Posix path relative to the project root, used instead of the real file name. */
+    readonly filename?: string;
+}
+//# sourceMappingURL=plugin-settings.d.ts.map

package/dist/project/plugin-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings.d.ts","sourceRoot":"","sources":["../../src/project/plugin-settings.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/project/plugin-settings.js

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

package/dist/project/plugin-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-settings.js","sourceRoot":"","sources":["../../src/project/plugin-settings.ts"],"names":[],"mappings":""}

package/dist/project/posix.d.ts

@@ -0,0 +1,2 @@
+export declare function posix(value: string): string;
+//# sourceMappingURL=posix.d.ts.map

package/dist/project/posix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.d.ts","sourceRoot":"","sources":["../../src/project/posix.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/project/posix.js

@@ -0,0 +1,4 @@
+export function posix(value) {
+    return value.replaceAll('\\', '/').replace(/^\.\//, '').replace(/\/+$/, '');
+}
+//# sourceMappingURL=posix.js.map

package/dist/project/posix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.js","sourceRoot":"","sources":["../../src/project/posix.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/project/resolve-import.d.ts

@@ -0,0 +1,15 @@
+import type { Config } from './config.js';
+import type { Location } from './location.js';
+export type ImportTarget = {
+    readonly kind: 'file';
+    readonly path: string;
+    readonly location: Location;
+} | {
+    readonly kind: 'package';
+    readonly name: string;
+} | {
+    readonly kind: 'builtin';
+    readonly name: string;
+};
+export declare function resolveImport(config: Config, fromFile: string, specifier: string): ImportTarget;
+//# sourceMappingURL=resolve-import.d.ts.map

package/dist/project/resolve-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../src/project/resolve-import.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMxD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAoB/F"}

package/dist/project/resolve-import.js

@@ -0,0 +1,32 @@
+import { builtinModules } from 'node:module';
+import path from 'node:path';
+import { aliasRoots } from './alias-roots.js';
+import { locate } from './locate.js';
+const SOURCE = /\.(?:ts|mts|cts)$/;
+const BUILTINS = new Set(builtinModules);
+export function resolveImport(config, fromFile, specifier) {
+    if (specifier.startsWith('.')) {
+        return fileTarget(config, path.posix.join(path.posix.dirname(fromFile), specifier));
+    }
+    const root = aliasRoots(config).find(({ prefix }) => prefix !== '' && specifier.startsWith(prefix));
+    if (root !== undefined) {
+        return fileTarget(config, path.posix.join(root.directory, specifier.slice(root.prefix.length)));
+    }
+    if (specifier.startsWith('node:')) {
+        return { kind: 'builtin', name: specifier };
+    }
+    if (BUILTINS.has(packageName(specifier))) {
+        return { kind: 'builtin', name: `node:${specifier}` };
+    }
+    return { kind: 'package', name: packageName(specifier) };
+}
+function fileTarget(config, target) {
+    const clean = path.posix.normalize(target).replace(/\.(?:js|mjs|cjs)$/, '.ts');
+    const withExtension = SOURCE.test(clean) || path.posix.extname(clean) !== '' ? clean : `${clean}.ts`;
+    return { kind: 'file', path: withExtension, location: locate(config, withExtension) };
+}
+function packageName(specifier) {
+    const [first = '', second] = specifier.split('/');
+    return first.startsWith('@') && second !== undefined ? `${first}/${second}` : first;
+}
+//# sourceMappingURL=resolve-import.js.map

package/dist/project/resolve-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-import.js","sourceRoot":"","sources":["../../src/project/resolve-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,MAAM,MAAM,GAAG,mBAAmB,CAAC;AAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB,EAAE,SAAiB;IAC/E,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpG,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,SAAS,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,MAAc;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC;IAErG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC"}

package/dist/project/to-alias.d.ts

@@ -0,0 +1,7 @@
+import type { AliasRoot } from './alias-root.js';
+/**
+ * The specifier that names a file of the project, given by its path from the project root with
+ * or without its extension; nothing when the file is under no aliased tree.
+ */
+export declare function toAlias(roots: readonly AliasRoot[], file: string): string | undefined;
+//# sourceMappingURL=to-alias.d.ts.map

package/dist/project/to-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-alias.d.ts","sourceRoot":"","sources":["../../src/project/to-alias.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrF"}

package/dist/project/to-alias.js

@@ -0,0 +1,13 @@
+const EXTENSION = /\.(?:ts|js)$/;
+/**
+ * The specifier that names a file of the project, given by its path from the project root with
+ * or without its extension; nothing when the file is under no aliased tree.
+ */
+export function toAlias(roots, file) {
+    const root = roots.find(({ directory }) => file.startsWith(`${directory}/`));
+    if (root === undefined) {
+        return undefined;
+    }
+    return `${root.prefix}${file.slice(root.directory.length + 1).replace(EXTENSION, '')}.js`;
+}
+//# sourceMappingURL=to-alias.js.map

package/dist/project/to-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-alias.js","sourceRoot":"","sources":["../../src/project/to-alias.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAA2B,EAAE,IAAY;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;IAE7E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC;AAC5F,CAAC"}

package/dist/project/to-posix.d.ts

@@ -0,0 +1,2 @@
+export declare function toPosix(file: string): string;
+//# sourceMappingURL=to-posix.d.ts.map

package/dist/project/to-posix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-posix.d.ts","sourceRoot":"","sources":["../../src/project/to-posix.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/project/to-posix.js

@@ -0,0 +1,5 @@
+import path from 'node:path';
+export function toPosix(file) {
+    return file.split(path.sep).join('/');
+}
+//# sourceMappingURL=to-posix.js.map

package/dist/project/to-posix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-posix.js","sourceRoot":"","sources":["../../src/project/to-posix.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC"}

package/dist/rules/application-command-query-separation.d.ts

@@ -0,0 +1,6 @@
+interface Options {
+    readonly mutators?: readonly string[];
+}
+export declare const applicationCommandQuerySeparation: import("@typescript-eslint/utils/ts-eslint").RuleModule<"mutation", [Options], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=application-command-query-separation.d.ts.map

package/dist/rules/application-command-query-separation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-command-query-separation.d.ts","sourceRoot":"","sources":["../../src/rules/application-command-query-separation.ts"],"names":[],"mappings":"AAKA,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAID,eAAO,MAAM,iCAAiC,2KAmD5C,CAAC"}

package/dist/rules/application-command-query-separation.js

@@ -0,0 +1,49 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { defineRule } from '../support/rule/define-rule.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { startsAtThis } from '../support/members/starts-at-this.js';
+const DEFAULT_MUTATORS = ['save', 'delete', 'publish'];
+export const applicationCommandQuerySeparation = defineRule({
+    id: 'application/command-query-separation',
+    type: 'problem',
+    recommended: 'warn',
+    description: 'A query never changes state: nothing under application/queries calls `save`, `delete` or `publish` on a dependency.',
+    messages: {
+        mutation: 'The query side calls {{call}}(): a query answers and never changes state. Move the change to a command handler (`ddd-ts-kit generate command {{context}} <UseCase>`) and let the caller send it.',
+    },
+    schema: [
+        {
+            type: 'object',
+            additionalProperties: false,
+            properties: { mutators: { type: 'array', items: { type: 'string' }, uniqueItems: true } },
+        },
+    ],
+    defaultOptions: [{}],
+    create({ file, sourceCode, options: [options], report }) {
+        const { location } = file;
+        if (location.area !== 'context' ||
+            location.layer !== 'application' ||
+            file.isTest ||
+            location.inside[0] !== 'queries') {
+            return {};
+        }
+        const mutators = options.mutators ?? DEFAULT_MUTATORS;
+        return {
+            CallExpression(node) {
+                const { callee } = node;
+                // Only dependencies held by the handler are judged: `seen.delete(id)` on a local Set changes nothing outside.
+                if (callee.type !== AST_NODE_TYPES.MemberExpression || !startsAtThis(callee.object)) {
+                    return;
+                }
+                if (mutators.includes(propertyName(callee) ?? '')) {
+                    report({
+                        node,
+                        messageId: 'mutation',
+                        data: { call: sourceCode.getText(callee), context: location.context },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=application-command-query-separation.js.map

package/dist/rules/application-command-query-separation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-command-query-separation.js","sourceRoot":"","sources":["../../src/rules/application-command-query-separation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMpE,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,iCAAiC,GAAG,UAAU,CAAwB;IACjF,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,MAAM;IACnB,WAAW,EACT,qHAAqH;IACvH,QAAQ,EAAE;QACR,QAAQ,EACN,kMAAkM;KACrM;IACD,MAAM,EAAE;QACN;YACE,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE;SAC1F;KACF;IACD,cAAc,EAAE,CAAC,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE;QACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;YAC3B,QAAQ,CAAC,KAAK,KAAK,aAAa;YAChC,IAAI,CAAC,MAAM;YACX,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,EAChC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAEtD,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBAExB,8GAA8G;gBAC9G,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpF,OAAO;gBACT,CAAC;gBAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBAClD,MAAM,CAAC;wBACL,IAAI;wBACJ,SAAS,EAAE,UAAU;wBACrB,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;qBACtE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/application-handler-shape.d.ts

@@ -0,0 +1,4 @@
+type MessageId = 'noHandler' | 'severalClasses' | 'missingExecute' | 'extraPublicMethod';
+export declare const applicationHandlerShape: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageId, [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=application-handler-shape.d.ts.map

package/dist/rules/application-handler-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-handler-shape.d.ts","sourceRoot":"","sources":["../../src/rules/application-handler-shape.ts"],"names":[],"mappings":"AAQA,KAAK,SAAS,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAEzF,eAAO,MAAM,uBAAuB,mKA6BlC,CAAC"}

package/dist/rules/application-handler-shape.js

@@ -0,0 +1,51 @@
+import { className } from '../support/classes/class-name.js';
+import { exportedClasses } from '../support/classes/exported-classes.js';
+import { isCallable } from '../support/classes/is-callable.js';
+import { memberName } from '../support/classes/member-name.js';
+import { visibilityOf } from '../support/classes/visibility-of.js';
+import { defineRule } from '../support/rule/define-rule.js';
+export const applicationHandlerShape = defineRule({
+    id: 'application/handler-shape',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A `*.handler.ts` file exports exactly one class whose single public method is `execute`.',
+    messages: {
+        noHandler: 'This handler file exports no class. Export one class named after the use case, with a single public method `execute`.',
+        severalClasses: 'This handler file also exports {{className}}. Keep one handler per file: move {{className}} to its own use case folder.',
+        missingExecute: '{{className}} has no public `execute` method. A handler is called by the bus through `execute(command)` or `execute(query)`: name its entry point that way.',
+        extraPublicMethod: '{{className}} exposes {{name}} besides `execute`. Make it private if it is a step of the use case, or move it to the domain if it is a business decision: a handler has one entry point.',
+    },
+    create({ file, report }) {
+        const { location } = file;
+        if (location.area !== 'context' ||
+            location.layer !== 'application' ||
+            file.isTest ||
+            !file.path.endsWith('.handler.ts')) {
+            return {};
+        }
+        return { Program: (program) => judgeHandlerFile(program, report) };
+    },
+});
+function judgeHandlerFile(program, report) {
+    const [handler, ...others] = exportedClasses(program);
+    if (handler === undefined) {
+        report({ loc: { line: 1, column: 0 }, messageId: 'noHandler' });
+        return;
+    }
+    for (const other of others) {
+        report({ node: other.id ?? other, messageId: 'severalClasses', data: { className: className(other) } });
+    }
+    const publicMethods = handler.body.body.filter((member) => isCallable(member) && visibilityOf(member) === 'public');
+    const owner = className(handler);
+    if (!publicMethods.some((member) => memberName(member) === 'execute')) {
+        report({ node: handler.id ?? handler, messageId: 'missingExecute', data: { className: owner } });
+    }
+    for (const member of publicMethods.filter((candidate) => memberName(candidate) !== 'execute')) {
+        report({
+            node: member,
+            messageId: 'extraPublicMethod',
+            data: { className: owner, name: memberName(member) ?? 'a computed method' },
+        });
+    }
+}
+//# sourceMappingURL=application-handler-shape.js.map

package/dist/rules/application-handler-shape.js.map

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

package/dist/rules/aspects-outside-in.d.ts

@@ -0,0 +1,2 @@
+export declare const aspectsOutsideIn: import("@typescript-eslint/utils/ts-eslint").RuleModule<"decorators", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=aspects-outside-in.d.ts.map

package/dist/rules/aspects-outside-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspects-outside-in.d.ts","sourceRoot":"","sources":["../../src/rules/aspects-outside-in.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB,sKAoB3B,CAAC"}

package/dist/rules/aspects-outside-in.js

@@ -0,0 +1,45 @@
+import { defineRule } from '../support/rule/define-rule.js';
+import { importListener } from '../support/imports/import-listener.js';
+import { inSourceRoot } from '../support/imports/in-source-root.js';
+import { ASPECTS_PACKAGE } from '../support/outside-concerns/outside-concern.js';
+const DECORATORS = `${ASPECTS_PACKAGE}/decorators`;
+export const aspectsOutsideIn = defineRule({
+    id: 'aspects/outside-in',
+    type: 'problem',
+    recommended: 'error',
+    description: 'The decorator form of an aspect is imported only by an adapter in infrastructure/ or by the platform; everywhere else an aspect is applied at the composition root.',
+    messages: {
+        decorators: `"${DECORATORS}" is imported in {{place}}: an aspect decorator belongs on an adapter class. Apply the aspect at the composition root instead (\`.with(...)\` on the binding, or the \`decorate\` hook), or move the decorated class to infrastructure/ of its context or to the platform.`,
+    },
+    create({ file, report }) {
+        if (!isJudged(file)) {
+            return {};
+        }
+        return importListener(file, ({ node, specifier }) => {
+            if (specifier === DECORATORS || specifier.startsWith(`${DECORATORS}/`)) {
+                report({ node, messageId: 'decorators', data: { place: placeOf(file) } });
+            }
+        });
+    },
+});
+/** domain/ and application/ are left to the layer rules, which refuse every entry of the package: one import, one report. */
+function isJudged(file) {
+    const { location } = file;
+    if (file.isTest || !inSourceRoot(file) || location.area === 'platform') {
+        return false;
+    }
+    return location.area !== 'context' || !['infrastructure', 'domain', 'application'].includes(location.layer);
+}
+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=aspects-outside-in.js.map