@ethlete/cli 3.0.0-next.21 → 3.0.0-next.22

package/src/lib/design/system/rules/unused-shared-export.d.ts

@@ -0,0 +1,18 @@
+import { Problem } from '../problem';
+import { ResolvedProduct } from '../resolve-product';
+/**
+ * Each export of a `shared/` file that no file of `importers` imports, named or through the whole module.
+ * `resolveSpecifier` turns a specifier of an importing file into a path, or `null` for one that cannot reach `shared/`;
+ * `scope` names the importers in the message, as in "nothing in variant a imports it".
+ */
+export declare const unusedExportsOf: (options: {
+    sharedDir: string;
+    importers: string[];
+    resolveSpecifier: (options: {
+        file: string;
+        specifier: string;
+    }) => string | null;
+    scope?: string;
+}) => Problem[];
+/** Each export of a file in a part's own `shared/` folder that no file of the part imports. */
+export declare const unusedSharedExportsOf: (product: ResolvedProduct) => Problem[];

package/src/lib/design/system/rules/unused-shared-export.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unusedSharedExportsOf = exports.unusedExportsOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const sketch_1 = require("../sketch/sketch");
+const ts_source_1 = require("../ts-source");
+const tsFilesIn = (dir) => (0, fs_1.existsSync)(dir)
+    ? (0, fs_1.readdirSync)(dir, { recursive: true })
+        .filter((path) => path.endsWith('.ts') && !path.endsWith('.d.ts'))
+        .map((path) => (0, path_1.resolve)(dir, path))
+        .sort()
+    : [];
+const candidatesOf = (path) => [path, `${path}.ts`, (0, path_1.resolve)(path, 'index.ts')];
+/**
+ * Each export of a `shared/` file that no file of `importers` imports, named or through the whole module.
+ * `resolveSpecifier` turns a specifier of an importing file into a path, or `null` for one that cannot reach `shared/`;
+ * `scope` names the importers in the message, as in "nothing in variant a imports it".
+ */
+const unusedExportsOf = (options) => {
+    var _a, _b;
+    const { sharedDir, importers, resolveSpecifier, scope } = options;
+    const shared = tsFilesIn(sharedDir);
+    if (shared.length === 0)
+        return [];
+    const taken = new Map();
+    for (const file of new Set([...importers, ...shared]))
+        for (const [specifier, names] of (0, ts_source_1.importedNamesOf)((0, fs_1.readFileSync)(file, 'utf8'))) {
+            const path = resolveSpecifier({ file, specifier: (_a = specifier.split('?')[0]) !== null && _a !== void 0 ? _a : specifier });
+            const target = path === null ? undefined : candidatesOf(path).find((candidate) => shared.includes(candidate));
+            if (!target)
+                continue;
+            const known = (_b = taken.get(target)) !== null && _b !== void 0 ? _b : new Set();
+            names.forEach((name) => known.add(name));
+            taken.set(target, known);
+        }
+    return shared.flatMap((file) => {
+        var _a;
+        const used = (_a = taken.get(file)) !== null && _a !== void 0 ? _a : new Set();
+        return used.has('*')
+            ? []
+            : (0, ts_source_1.exportedNamesOf)((0, fs_1.readFileSync)(file, 'utf8'))
+                .filter((name) => !used.has(name))
+                .map((name) => ({
+                rule: 'UNUSED-EXPORT',
+                file,
+                message: `${name} is exported, but nothing ${scope ? `${scope} ` : ''}imports it - delete it or drop the export`,
+            }));
+    });
+};
+exports.unusedExportsOf = unusedExportsOf;
+const relativeOf = ({ file, specifier }) => specifier.startsWith('.') ? (0, path_1.resolve)((0, path_1.dirname)(file), specifier) : null;
+/** Each export of a file in a part's own `shared/` folder that no file of the part imports. */
+const unusedSharedExportsOf = (product) => [...new Set(product.parts.map((part) => (0, path_1.dirname)(part.file)))].flatMap((folder) => (0, exports.unusedExportsOf)({
+    sharedDir: (0, path_1.resolve)(folder, sketch_1.SHARED_FOLDER),
+    importers: tsFilesIn(folder),
+    resolveSpecifier: relativeOf,
+}));
+exports.unusedSharedExportsOf = unusedSharedExportsOf;
+//# sourceMappingURL=unused-shared-export.js.map

package/src/lib/design/system/rules/unused-shared-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-shared-export.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/rules/unused-shared-export.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/rules/upward-dependency.d.ts

@@ -0,0 +1,4 @@
+import { Problem } from '../problem';
+import { ResolvedProduct } from '../resolve-product';
+/** A part that imports a part of a layer its own layer may not use. */
+export declare const upwardDependenciesOf: (product: ResolvedProduct) => Problem[];

package/src/lib/design/system/rules/upward-dependency.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upwardDependenciesOf = void 0;
+const imports_1 = require("../imports");
+const layers_1 = require("../layers");
+/** A part that imports a part of a layer its own layer may not use. */
+const upwardDependenciesOf = (product) => product.parts.flatMap((part) => (0, imports_1.partDependenciesOf)(part).flatMap((dependency) => (0, layers_1.isLayer)(dependency.layer) && !(0, layers_1.mayUse)({ from: part.layer, to: dependency.layer })
+    ? [
+        {
+            rule: 'UPWARD-DEPENDENCY',
+            file: part.file,
+            message: `${part.layer} may use ${layers_1.LAYER_USES[part.layer].join(', ') || 'no other layer'}, not ${dependency.specifier}`,
+        },
+    ]
+    : []));
+exports.upwardDependenciesOf = upwardDependenciesOf;
+//# sourceMappingURL=upward-dependency.js.map

package/src/lib/design/system/rules/upward-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upward-dependency.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/rules/upward-dependency.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAChD,sCAAwD;AAIxD,uEAAuE;AAChE,MAAM,oBAAoB,GAAG,CAAC,OAAwB,EAAa,EAAE,CAC1E,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAA,4BAAkB,EAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAC9C,IAAA,gBAAO,EAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAA,eAAM,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAC9E,CAAC,CAAC;QACE;YACE,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,YAAY,mBAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,SAAS,UAAU,CAAC,SAAS,EAAE;SACvH;KACF;IACH,CAAC,CAAC,EAAE,CACP,CACF,CAAC;AAbS,QAAA,oBAAoB,wBAa7B"}

package/src/lib/design/system/rules/widths.d.ts

@@ -0,0 +1,4 @@
+import { Problem } from '../problem';
+import { ResolvedProduct } from '../resolve-product';
+/** A part whose `widths` are not a non-empty list of positive numbers. */
+export declare const badWidthsOf: (product: ResolvedProduct) => Problem[];

package/src/lib/design/system/rules/widths.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.badWidthsOf = void 0;
+const part_definition_1 = require("../sketch/part-definition");
+/** A part whose `widths` are not a non-empty list of positive numbers. */
+const badWidthsOf = (product) => product.parts
+    .filter((part) => (0, part_definition_1.hasBadWidths)(part.source))
+    .map((part) => ({
+    rule: 'WIDTHS',
+    file: part.file,
+    message: 'widths must be a non-empty list of positive numbers, for example widths: [280, 480, 720]',
+}));
+exports.badWidthsOf = badWidthsOf;
+//# sourceMappingURL=widths.js.map

package/src/lib/design/system/rules/widths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widths.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/rules/widths.ts"],"names":[],"mappings":";;;AAEA,+DAAyD;AAEzD,0EAA0E;AACnE,MAAM,WAAW,GAAG,CAAC,OAAwB,EAAa,EAAE,CACjE,OAAO,CAAC,KAAK;KACV,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,8BAAY,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;KAC3C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,OAAO,EAAE,0FAA0F;CACpG,CAAC,CAAC,CAAC;AAPK,QAAA,WAAW,eAOhB"}

package/src/lib/design/system/sketch/baseline.d.ts

@@ -0,0 +1,38 @@
+import { PartFile } from '../product';
+import { ResolvedProduct } from '../resolve-product';
+export declare const FIXTURES_KEY = "fixtures.ts";
+/**
+ * The content hash of a part folder together with the bytes of each `@assets/` file it imports, as `product` resolves
+ * them. A part that imports no asset hashes as its folder alone.
+ */
+export declare const partHashOf: (options: {
+    product: Pick<ResolvedProduct, "dir" | "base">;
+    dir: string;
+}) => string;
+/**
+ * The content hash of each part the product resolves (its folder and the assets it imports), and of its fixture set,
+ * under the part key and `fixtures.ts`. A sketch keeps it to tell when a part it replaces changed in the product.
+ */
+export declare const baselineOf: (product: ResolvedProduct) => Record<string, string>;
+/**
+ * The parts, and `fixtures.ts`, a variant replaces whose state in the product differs from the
+ * sketch's baseline: changed, added or removed since the sketch was created.
+ */
+export declare const conflictsOf: (options: {
+    product: ResolvedProduct;
+    baseline: Record<string, string>;
+    parts: PartFile[];
+    fixtures: boolean;
+}) => string[];
+/**
+ * The parts, and `fixtures.ts`, any variant of the sketch replaces that changed in the product since its
+ * baseline, or `[]` when it records none. `null` while the baseline is current and a merge needs no rebase.
+ */
+export declare const staleBaselineOf: (options: {
+    product: ResolvedProduct;
+    sketch: {
+        dir: string;
+        variants: string[];
+        baseline?: Record<string, string>;
+    };
+}) => string[] | null;

package/src/lib/design/system/sketch/baseline.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staleBaselineOf = exports.conflictsOf = exports.baselineOf = exports.partHashOf = exports.FIXTURES_KEY = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const assets_1 = require("../assets");
+const product_1 = require("../product");
+const resolve_product_1 = require("../resolve-product");
+exports.FIXTURES_KEY = 'fixtures.ts';
+const hashOf = (paths) => {
+    var _a;
+    const hash = (0, crypto_1.createHash)('sha256');
+    for (const file of paths.files)
+        hash.update(`${(0, path_1.relative)(paths.root, file)}\0`).update((0, fs_1.readFileSync)(file));
+    for (const asset of (_a = paths.assets) !== null && _a !== void 0 ? _a : [])
+        hash.update(`${assets_1.ASSETS_PREFIX}${asset.path}\0`).update((0, fs_1.readFileSync)(asset.file));
+    return hash.digest('hex').slice(0, 16);
+};
+/**
+ * The content hash of a part folder together with the bytes of each `@assets/` file it imports, as `product` resolves
+ * them. A part that imports no asset hashes as its folder alone.
+ */
+const partHashOf = (options) => {
+    const files = (0, assets_1.filesBelow)(options.dir);
+    return hashOf({ root: options.dir, files, assets: (0, assets_1.importedAssetsOf)({ product: options.product, files }) });
+};
+exports.partHashOf = partHashOf;
+/**
+ * The content hash of each part the product resolves (its folder and the assets it imports), and of its fixture set,
+ * under the part key and `fixtures.ts`. A sketch keeps it to tell when a part it replaces changed in the product.
+ */
+const baselineOf = (product) => (Object.assign(Object.assign({}, Object.fromEntries(product.parts.map((part) => [(0, resolve_product_1.partKeyOf)(part), (0, exports.partHashOf)({ product, dir: (0, path_1.dirname)(part.file) })]))), (product.fixtures
+    ? { [exports.FIXTURES_KEY]: hashOf({ root: (0, path_1.dirname)(product.fixtures), files: [product.fixtures] }) }
+    : {})));
+exports.baselineOf = baselineOf;
+/**
+ * The parts, and `fixtures.ts`, a variant replaces whose state in the product differs from the
+ * sketch's baseline: changed, added or removed since the sketch was created.
+ */
+const conflictsOf = (options) => {
+    const { product, baseline, parts, fixtures } = options;
+    const now = (0, exports.baselineOf)(product);
+    return [...parts.map(resolve_product_1.partKeyOf), ...(fixtures ? [exports.FIXTURES_KEY] : [])].filter((key) => now[key] !== baseline[key]);
+};
+exports.conflictsOf = conflictsOf;
+/**
+ * The parts, and `fixtures.ts`, any variant of the sketch replaces that changed in the product since its
+ * baseline, or `[]` when it records none. `null` while the baseline is current and a merge needs no rebase.
+ */
+const staleBaselineOf = (options) => {
+    const { product, sketch } = options;
+    if (!sketch.baseline)
+        return [];
+    const dirs = sketch.variants.map((variant) => (0, path_1.resolve)(sketch.dir, variant));
+    const changed = (0, exports.conflictsOf)({
+        product,
+        baseline: sketch.baseline,
+        parts: dirs.flatMap((dir) => (0, product_1.partFilesOf)(dir).parts),
+        fixtures: dirs.some((dir) => (0, product_1.fixturesOf)(dir) !== null),
+    });
+    const unique = [...new Set(changed)];
+    return unique.length > 0 ? unique : null;
+};
+exports.staleBaselineOf = staleBaselineOf;
+//# sourceMappingURL=baseline.js.map

package/src/lib/design/system/sketch/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/sketch/baseline.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/sketch/check-format.d.ts

@@ -0,0 +1,17 @@
+import { Problem } from '../problem';
+import { Sketch } from './sketch';
+/**
+ * The source files of a variant that the checkout's own Prettier would reformat. A checkout
+ * without Prettier has no format to hold a variant to, so it reports nothing.
+ */
+export declare const formatProblemsOf: (options: {
+    target: string;
+    sketch: Sketch;
+    variant: string;
+}) => Problem[];
+/** Writes the variants, the `shared/` folder and `sketch.json` of a sketch in the checkout's Prettier format, when the checkout has Prettier. */
+export declare const formatSketch: (options: {
+    target: string;
+    sketch: Sketch;
+    variants: string[];
+}) => void;

package/src/lib/design/system/sketch/check-format.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSketch = exports.formatProblemsOf = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const typecheck_1 = require("../../typecheck");
+const sketch_1 = require("./sketch");
+const FORMATTED = /\.(ts|css|html|json)$/u;
+const filesOf = (dir) => (0, fs_1.readdirSync)(dir, { withFileTypes: true }).flatMap((entry) => entry.isDirectory() ? filesOf((0, path_1.join)(dir, entry.name)) : FORMATTED.test(entry.name) ? [(0, path_1.join)(dir, entry.name)] : []);
+/**
+ * The source files of a variant that the checkout's own Prettier would reformat. A checkout
+ * without Prettier has no format to hold a variant to, so it reports nothing.
+ */
+const formatProblemsOf = (options) => {
+    const { target, sketch, variant } = options;
+    const prettier = (0, typecheck_1.binaryOf)({ target, pkg: 'prettier', bin: 'prettier' });
+    if (!prettier)
+        return [];
+    const files = filesOf((0, sketch_1.variantDirOf)(sketch, variant));
+    if (files.length === 0)
+        return [];
+    const result = (0, child_process_1.spawnSync)(process.execPath, [prettier, '--list-different', ...files], {
+        cwd: target,
+        encoding: 'utf8',
+    });
+    if (result.status !== 1)
+        return [];
+    return result.stdout
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map((line) => {
+        const file = (0, path_1.resolve)(target, line.trim());
+        return {
+            rule: 'FORMAT',
+            file,
+            message: `is not formatted - run sketch check ${sketch.target} --fix`,
+        };
+    });
+};
+exports.formatProblemsOf = formatProblemsOf;
+/** Writes the variants, the `shared/` folder and `sketch.json` of a sketch in the checkout's Prettier format, when the checkout has Prettier. */
+const formatSketch = (options) => {
+    const { target, sketch, variants } = options;
+    const prettier = (0, typecheck_1.binaryOf)({ target, pkg: 'prettier', bin: 'prettier' });
+    if (!prettier)
+        return;
+    const dirs = [...variants.map((variant) => (0, sketch_1.variantDirOf)(sketch, variant)), (0, sketch_1.sharedDirOf)(sketch)].filter(fs_1.existsSync);
+    const files = [...dirs.flatMap(filesOf), (0, path_1.resolve)(sketch.dir, sketch_1.SKETCH_FILE)];
+    (0, child_process_1.spawnSync)(process.execPath, [prettier, '--write', '--log-level', 'warn', ...files], {
+        cwd: target,
+        encoding: 'utf8',
+    });
+};
+exports.formatSketch = formatSketch;
+//# sourceMappingURL=check-format.js.map

package/src/lib/design/system/sketch/check-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-format.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/sketch/check-format.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/sketch/check-sketches.d.ts

@@ -0,0 +1,38 @@
+import { TypecheckResult } from '../../typecheck';
+import { Problem } from '../problem';
+import { ResolvedProduct } from '../resolve-product';
+import { Sketch } from './sketch';
+/** `problems` are the ones a variant brings in; `before` are the ones the product already has, which do not fail the variant. */
+export type VariantProblems = {
+    sketch: Sketch;
+    variant: string;
+    problems: Problem[];
+    before: Problem[];
+};
+/** The rule problems of each variant of a sketch laid over the product, and the states it drops from a part. */
+export declare const variantProblemsOf: (options: {
+    product: ResolvedProduct;
+    sketch: Sketch;
+}) => VariantProblems[];
+/** Warnings that do not fail a variant: a class two stylesheets of one part both define, a class of `shared/` the variant restyles, a file nothing imports. */
+export declare const variantWarningsOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+    sketch: Sketch;
+    variant: string;
+}) => string[];
+/**
+ * The rule problems of every variant of every open sketch of a product. A sketch folder that
+ * cannot be read is a `SKETCH` problem of its own.
+ */
+export declare const openSketchProblemsOf: (product: ResolvedProduct) => {
+    unreadable: Problem[];
+    variants: VariantProblems[];
+};
+/** Runs `tsc` over one variant laid over the product, with a tsconfig of its own. */
+export declare const typecheckVariant: (options: {
+    target: string;
+    product: ResolvedProduct;
+    sketch: Sketch;
+    variant: string;
+}) => TypecheckResult;

package/src/lib/design/system/sketch/check-sketches.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typecheckVariant = exports.openSketchProblemsOf = exports.variantWarningsOf = exports.variantProblemsOf = void 0;
+const check_system_1 = require("../check-system");
+const path_1 = require("path");
+const resolve_product_1 = require("../resolve-product");
+const stale_comment_1 = require("../rules/stale-comment");
+const system_tsconfig_1 = require("../system-tsconfig");
+const duplicate_class_1 = require("./duplicate-class");
+const overlay_1 = require("./overlay");
+const shared_class_1 = require("./shared-class");
+const unused_files_1 = require("./unused-files");
+const part_definition_1 = require("./part-definition");
+const sketch_1 = require("./sketch");
+const droppedStatesOf = (options) => {
+    const { product, overlaid, allowed } = options;
+    return overlaid.parts
+        .filter((part) => overlaid.sketched.includes((0, resolve_product_1.partKeyOf)(part)))
+        .flatMap((part) => {
+        const own = product.parts.find((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === (0, resolve_product_1.partKeyOf)(part));
+        const before = own ? (0, part_definition_1.stateNamesOf)(own.source) : null;
+        const after = (0, part_definition_1.stateNamesOf)(part.source);
+        if (before === null || after === null)
+            return [];
+        const dropped = before.filter((state) => !after.includes(state) && !allowed.includes(state));
+        return dropped.length === 0
+            ? []
+            : [
+                {
+                    rule: 'STATES',
+                    file: part.file,
+                    message: `drops the state${dropped.length === 1 ? '' : 's'} ${dropped.join(', ')} that ${(0, resolve_product_1.partKeyOf)(part)} has in ${product.name} - a variant keeps every state of the part`,
+                },
+            ];
+    });
+};
+/** The rule problems of each variant of a sketch laid over the product, and the states it drops from a part. */
+const variantProblemsOf = (options) => {
+    const keyOf = (dir, problem) => `${problem.rule} ${(0, path_1.relative)(dir, problem.file)}: ${problem.message}`;
+    const had = new Set((0, check_system_1.ruleProblemsOf)(options.product).map((problem) => keyOf(options.product.dir, problem)));
+    return options.sketch.variants.map((variant) => {
+        var _a;
+        const overlaid = (0, overlay_1.overlaySketch)(Object.assign(Object.assign({}, options), { variant }));
+        const round = options.sketch.rounds.find((entry) => { var _a; return entry.key === ((_a = options.sketch.variantInfo[variant]) === null || _a === void 0 ? void 0 : _a.round); });
+        const variantDir = (0, sketch_1.variantDirOf)(options.sketch, variant);
+        const wasThere = (problem) => had.has(keyOf((0, path_1.relative)(variantDir, problem.file).startsWith('..') ? options.product.dir : variantDir, problem));
+        const found = (0, check_system_1.ruleProblemsOf)(overlaid);
+        const target = overlaid.parts.find((part) => (0, resolve_product_1.partKeyOf)(part) === options.sketch.target);
+        const metadataProblem = target && ((0, part_definition_1.withNote)(target.source, '') === null || (0, part_definition_1.withMadeBy)(target.source, ['author']) === null)
+            ? [
+                {
+                    rule: 'SKETCH',
+                    file: target.file,
+                    message: `merge cannot write metadata to ${options.sketch.target} - define it with definePart({ ..., note: '...' }) in this file`,
+                },
+            ]
+            : [];
+        return {
+            sketch: options.sketch,
+            variant,
+            problems: [
+                ...found.filter((problem) => !wasThere(problem)),
+                ...metadataProblem,
+                ...droppedStatesOf({ product: options.product, overlaid, allowed: (_a = round === null || round === void 0 ? void 0 : round.drops) !== null && _a !== void 0 ? _a : [] }),
+            ],
+            before: found.filter(wasThere),
+        };
+    });
+};
+exports.variantProblemsOf = variantProblemsOf;
+/** Warnings that do not fail a variant: a class two stylesheets of one part both define, a class of `shared/` the variant restyles, a file nothing imports. */
+const variantWarningsOf = (options) => {
+    const overlaid = (0, overlay_1.overlaySketch)(options);
+    return [
+        ...(0, duplicate_class_1.duplicateClassWarningsOf)({ target: options.target, product: overlaid }),
+        ...(0, shared_class_1.sharedClassWarningsOf)({ target: options.target, product: overlaid }),
+        ...(0, unused_files_1.unusedFileWarningsOf)(options),
+        ...(0, stale_comment_1.goneSketchCommentWarningsOf)(options.product),
+    ];
+};
+exports.variantWarningsOf = variantWarningsOf;
+/**
+ * The rule problems of every variant of every open sketch of a product. A sketch folder that
+ * cannot be read is a `SKETCH` problem of its own.
+ */
+const openSketchProblemsOf = (product) => {
+    const sketches = (0, sketch_1.listSketches)({ productDir: product.dir, product: product.name });
+    return {
+        unreadable: sketches.flatMap((sketch) => typeof sketch === 'string' ? [{ rule: 'SKETCH', file: product.dir, message: sketch }] : []),
+        variants: sketches.flatMap((sketch) => (typeof sketch === 'string' ? [] : (0, exports.variantProblemsOf)({ product, sketch }))),
+    };
+};
+exports.openSketchProblemsOf = openSketchProblemsOf;
+/** Runs `tsc` over one variant laid over the product, with a tsconfig of its own. */
+const typecheckVariant = (options) => {
+    const { target, product, sketch, variant } = options;
+    const overlaid = (0, overlay_1.overlaySketch)({ product, sketch, variant });
+    return (0, system_tsconfig_1.typecheckProduct)({
+        target,
+        product: Object.assign(Object.assign({}, overlaid), { name: `${product.name}.sketch.${(0, sketch_1.sketchFolderOf)(sketch)}.${variant}` }),
+    });
+};
+exports.typecheckVariant = typecheckVariant;
+//# sourceMappingURL=check-sketches.js.map

package/src/lib/design/system/sketch/check-sketches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-sketches.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/sketch/check-sketches.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/sketch/cli-args.d.ts

@@ -0,0 +1,26 @@
+import { DesignConfig } from '../../paths';
+import { ResolvedProduct } from '../resolve-product';
+/** `values` holds the last value of each flag, `repeated` every value in order. */
+export type Args = {
+    positional: string[];
+    values: Record<string, string>;
+    repeated: Record<string, string[]>;
+    flags: Set<string>;
+};
+/** Splits an argument list into positionals, the flags that take a value, and switches. */
+export declare const argsOf: (argv: string[], valueFlags: string[]) => Args | string;
+/** The model id `--by` names, the agent that runs a write command; `null` when it is missing or blank. */
+export declare const authorOf: (args: Args) => string | null;
+export declare const NEEDS_AUTHOR = "needs --by <model id>: the exact model id the coordinator gave you, e.g. claude-opus-5-5. Never guess it.";
+export declare const configOf: (target: string) => DesignConfig | string;
+/** The products a command runs on: the one `--product` names, else every product of the config. */
+export declare const productNamesOf: (options: {
+    config: DesignConfig;
+    asked: string | undefined;
+}) => string[] | string;
+/** The one product a command works on: the one `--product` names, or the only one the config declares. */
+export declare const oneProductOf: (options: {
+    target: string;
+    config: DesignConfig;
+    asked: string | undefined;
+}) => ResolvedProduct | string;

package/src/lib/design/system/sketch/cli-args.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneProductOf = exports.productNamesOf = exports.configOf = exports.NEEDS_AUTHOR = exports.authorOf = exports.argsOf = void 0;
+const paths_1 = require("../../paths");
+const resolve_product_1 = require("../resolve-product");
+/** Splits an argument list into positionals, the flags that take a value, and switches. */
+const argsOf = (argv, valueFlags) => {
+    var _a, _b;
+    const args = { positional: [], values: {}, repeated: {}, flags: new Set() };
+    for (let index = 0; index < argv.length; index++) {
+        const arg = (_a = argv[index]) !== null && _a !== void 0 ? _a : '';
+        if (valueFlags.includes(arg)) {
+            const value = argv[index + 1];
+            if (value === undefined)
+                return `${arg} needs a value`;
+            args.values[arg] = value;
+            args.repeated[arg] = [...((_b = args.repeated[arg]) !== null && _b !== void 0 ? _b : []), value];
+            index++;
+        }
+        else if (arg.startsWith('--')) {
+            args.flags.add(arg);
+        }
+        else {
+            args.positional.push(arg);
+        }
+    }
+    return args;
+};
+exports.argsOf = argsOf;
+/** The model id `--by` names, the agent that runs a write command; `null` when it is missing or blank. */
+const authorOf = (args) => { var _a; return ((_a = args.values['--by']) === null || _a === void 0 ? void 0 : _a.trim()) || null; };
+exports.authorOf = authorOf;
+exports.NEEDS_AUTHOR = 'needs --by <model id>: the exact model id the coordinator gave you, e.g. claude-opus-5-5. Never guess it.';
+const configOf = (target) => { var _a; return (_a = (0, paths_1.readConfig)(target)) !== null && _a !== void 0 ? _a : `design-explore: no config at ${(0, paths_1.configPathOf)(target)}`; };
+exports.configOf = configOf;
+const declaredOf = (config) => { var _a; return Object.keys((_a = config.products) !== null && _a !== void 0 ? _a : {}); };
+/** The products a command runs on: the one `--product` names, else every product of the config. */
+const productNamesOf = (options) => {
+    const declared = declaredOf(options.config);
+    if (options.asked === undefined)
+        return declared;
+    if (!declared.includes(options.asked))
+        return `NO PRODUCT "${options.asked}" - config.json declares ${declared.join(', ') || 'none'}.`;
+    return [options.asked];
+};
+exports.productNamesOf = productNamesOf;
+/** The one product a command works on: the one `--product` names, or the only one the config declares. */
+const oneProductOf = (options) => {
+    var _a;
+    const { target, config, asked } = options;
+    const declared = declaredOf(config);
+    const name = asked !== null && asked !== void 0 ? asked : (declared.length === 1 ? declared[0] : undefined);
+    if (name === undefined)
+        return declared.length > 1
+            ? `more than one product - pass --product <name>; config.json declares ${declared.join(', ')}.`
+            : `pass --product <name> - config.json declares none.`;
+    const entry = (_a = config.products) === null || _a === void 0 ? void 0 : _a[name];
+    if (!entry)
+        return `NO PRODUCT "${name}" - config.json declares ${declared.join(', ') || 'none'}.`;
+    return (0, resolve_product_1.resolveProduct)({ target, name, config: entry });
+};
+exports.oneProductOf = oneProductOf;
+//# sourceMappingURL=cli-args.js.map

package/src/lib/design/system/sketch/cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/sketch/cli-args.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/sketch/duplicate-class.d.ts

@@ -0,0 +1,14 @@
+import { ResolvedPart } from '../resolve-product';
+import { SketchedProduct } from './overlay';
+export declare const stylesheetsOf: (options: {
+    product: SketchedProduct;
+    part: ResolvedPart;
+}) => string[];
+/**
+ * A warning for each class that two stylesheets loaded by one part of a variant both define as a
+ * selector of its own: the later one silently changes the earlier.
+ */
+export declare const duplicateClassWarningsOf: (options: {
+    target: string;
+    product: SketchedProduct;
+}) => string[];