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

package/src/lib/design/system/sketch/no-visible-change.d.ts

@@ -0,0 +1,15 @@
+import { PictureOf } from '../../merge-compare';
+import { ResolvedProduct } from '../resolve-product';
+import { Sketch } from './sketch';
+import { SketchPartLoader } from './unchanged-states';
+/**
+ * `true` when every state of every variant of the sketch draws the same pixels as the product does now, in
+ * every frame; otherwise why not. A variant that holds another part than the target, or a state that fails to
+ * draw, counts as a change.
+ */
+export declare const sketchShowsNoChange: (options: {
+    product: ResolvedProduct;
+    sketch: Sketch;
+    load: SketchPartLoader;
+    pictureOf: PictureOf;
+}) => Promise<true | string>;

package/src/lib/design/system/sketch/no-visible-change.js

@@ -0,0 +1,70 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sketchShowsNoChange = void 0;
+const list_system_1 = require("../list-system");
+const product_1 = require("../product");
+const resolve_product_1 = require("../resolve-product");
+const overlay_1 = require("./overlay");
+const sketch_1 = require("./sketch");
+const unchanged_states_1 = require("./unchanged-states");
+const variantChangeOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { product, sketch, variant, load, pictureOf } = options;
+    const others = (0, product_1.partFilesOf)((0, sketch_1.variantDirOf)(sketch, variant))
+        .parts.map(resolve_product_1.partKeyOf)
+        .filter((key) => key !== sketch.target);
+    if (others.length > 0)
+        return `variant ${variant} also holds ${others.join(', ')}`;
+    const file = (_a = (0, overlay_1.overlaySketch)({ product, sketch, variant }).parts.find((part) => (0, resolve_product_1.partKeyOf)(part) === sketch.target)) === null || _a === void 0 ? void 0 : _a.file;
+    if (!file)
+        return `variant ${variant} does not draw ${sketch.target}`;
+    const read = yield (0, list_system_1.readPartModule)({
+        part: { file },
+        product: product.name,
+        load: () => load({ file, product: product.name, sketch: { target: sketch.target, variant } }),
+    });
+    if (read.problem)
+        return `variant ${variant} does not load: ${read.problem}`;
+    if (read.states.length === 0)
+        return `variant ${variant} has no states`;
+    const failures = new Set();
+    const recording = (picture) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            return yield pictureOf(picture);
+        }
+        catch (error) {
+            failures.add(error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    });
+    const unchanged = yield (0, unchanged_states_1.unchangedStatesOf)({ product, sketch, variant, load, pictureOf: recording });
+    const changed = read.states.filter((state) => !unchanged.includes(state));
+    if (changed.length === 0)
+        return null;
+    const failed = failures.size > 0 ? ` - a shot failed: ${[...failures].join('; ')}` : '';
+    return `variant ${variant} changes ${changed.join(', ')}${failed}`;
+});
+/**
+ * `true` when every state of every variant of the sketch draws the same pixels as the product does now, in
+ * every frame; otherwise why not. A variant that holds another part than the target, or a state that fails to
+ * draw, counts as a change.
+ */
+const sketchShowsNoChange = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { sketch } = options;
+    if (sketch.variants.length === 0)
+        return 'the sketch has no variant';
+    const changes = yield Promise.all(sketch.variants.map((variant) => variantChangeOf(Object.assign(Object.assign({}, options), { variant }))));
+    const found = changes.filter((change) => change !== null);
+    return found.length === 0 ? true : found.join('; ');
+});
+exports.sketchShowsNoChange = sketchShowsNoChange;
+//# sourceMappingURL=no-visible-change.js.map

package/src/lib/design/system/sketch/no-visible-change.js.map

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

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

@@ -0,0 +1,20 @@
+import { ResolvedProduct } from '../resolve-product';
+import { Sketch } from './sketch';
+export type SketchedProduct = ResolvedProduct & {
+    sketched: string[];
+    sharedDir: string;
+    variantSharedDir: string;
+    assetsDir: string;
+};
+/**
+ * The product as one variant of a sketch draws it: each part the variant holds replaces the part the
+ * product resolves under the same name, or joins it when the product has none. `sketched` names the
+ * parts the variant holds, `sharedDir` the sketch's `shared/` folder its parts import as `@shared/...` (the
+ * variant's own `variantSharedDir` first), and
+ * `assetsDir` the variant's own `assets/` folder, which `@assets/...` looks in first.
+ */
+export declare const overlaySketch: (options: {
+    product: ResolvedProduct;
+    sketch: Sketch;
+    variant: string;
+}) => SketchedProduct;

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overlaySketch = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const assets_1 = require("../assets");
+const layers_1 = require("../layers");
+const product_1 = require("../product");
+const resolve_product_1 = require("../resolve-product");
+const sketch_1 = require("./sketch");
+const mayChange = (sketch, part) => (0, resolve_product_1.partKeyOf)(part) === sketch.target || part.layer === sketch.layer || layers_1.LAYER_USES[sketch.layer].includes(part.layer);
+/**
+ * The product as one variant of a sketch draws it: each part the variant holds replaces the part the
+ * product resolves under the same name, or joins it when the product has none. `sketched` names the
+ * parts the variant holds, `sharedDir` the sketch's `shared/` folder its parts import as `@shared/...` (the
+ * variant's own `variantSharedDir` first), and
+ * `assetsDir` the variant's own `assets/` folder, which `@assets/...` looks in first.
+ */
+const overlaySketch = (options) => {
+    var _a;
+    const { product, sketch, variant } = options;
+    const dir = (0, sketch_1.variantDirOf)(sketch, variant);
+    const own = (0, product_1.partFilesOf)(dir);
+    const baseKeys = new Set(product.parts.filter((part) => part.origin !== 'product').map(resolve_product_1.partKeyOf));
+    const sketched = own.parts.map((file) => (Object.assign(Object.assign({}, file), { origin: baseKeys.has((0, resolve_product_1.partKeyOf)(file)) ? 'overridden' : 'product', source: (0, fs_1.readFileSync)(file.file, 'utf8'), cssSource: file.css && (0, fs_1.existsSync)(file.css) ? (0, fs_1.readFileSync)(file.css, 'utf8') : null })));
+    const keys = new Set(sketched.map(resolve_product_1.partKeyOf));
+    const parts = [...product.parts.filter((part) => !keys.has((0, resolve_product_1.partKeyOf)(part))), ...sketched].sort((a, b) => layers_1.LAYERS.indexOf(a.layer) - layers_1.LAYERS.indexOf(b.layer) || a.name.localeCompare(b.name));
+    const outside = sketched
+        .filter((part) => !mayChange(sketch, part))
+        .map((part) => ({
+        rule: 'SKETCH',
+        file: part.file,
+        message: `a sketch on ${sketch.target} may change ${sketch.layer} and the layers below it, not ${(0, resolve_product_1.partKeyOf)(part)}`,
+    }));
+    return Object.assign(Object.assign({}, product), { parts, fixtures: (_a = (0, product_1.fixturesOf)(dir)) !== null && _a !== void 0 ? _a : product.fixtures, problems: [...product.problems, ...own.problems, ...outside], sketched: [...keys], sharedDir: (0, sketch_1.sharedDirOf)(sketch), variantSharedDir: (0, sketch_1.variantSharedDirOf)(sketch, variant), assetsDir: (0, path_1.resolve)(dir, assets_1.ASSETS_FOLDER) });
+};
+exports.overlaySketch = overlaySketch;
+//# sourceMappingURL=overlay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../../../../../../libs/cli/src/lib/design/system/sketch/overlay.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAA+B;AAC/B,sCAA0C;AAC1C,sCAA+C;AAC/C,wCAAqD;AAErD,wDAA8E;AAC9E,qCAAiF;AASjF,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,IAAsD,EAAE,EAAE,CAC3F,IAAA,2BAAS,EAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,IAAI,mBAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEpH;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAAC,OAI7B,EAAmB,EAAE;;IACpB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAA,qBAAW,EAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,2BAAS,CAAC,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAgB,EAAE,CAAC,iCAClD,IAAI,KACP,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAA,2BAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAChE,MAAM,EAAE,IAAA,iBAAY,EAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EACvC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,IAAA,eAAU,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAY,EAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IACnF,CAAC,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,2BAAS,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAA,2BAAS,EAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAC7F,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,eAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC5F,CAAC;IACF,MAAM,OAAO,GAAc,QAAQ;SAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,eAAe,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,KAAK,iCAAiC,IAAA,2BAAS,EAAC,IAAI,CAAC,EAAE;KACnH,CAAC,CAAC,CAAC;IAEN,uCACK,OAAO,KACV,KAAK,EACL,QAAQ,EAAE,MAAA,IAAA,oBAAU,EAAC,GAAG,CAAC,mCAAI,OAAO,CAAC,QAAQ,EAC7C,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,EAC5D,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,EACnB,SAAS,EAAE,IAAA,oBAAW,EAAC,MAAM,CAAC,EAC9B,gBAAgB,EAAE,IAAA,2BAAkB,EAAC,MAAM,EAAE,OAAO,CAAC,EACrD,SAAS,EAAE,IAAA,cAAO,EAAC,GAAG,EAAE,sBAAa,CAAC,IACtC;AACJ,CAAC,CAAC;AArCW,QAAA,aAAa,iBAqCxB"}

package/src/lib/design/system/sketch/part-definition.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The state names a part file declares in `definePart({ states: { … } })`, read without running it.
+ * `null` when the states are not written as an object literal there, so they cannot be known.
+ */
+export declare const stateNamesOf: (source: string) => string[] | null;
+/** The model ids in the `madeBy` literal of a part file; none when it has no such array of strings. */
+export declare const madeByOf: (source: string) => string[];
+/** The `note` literal of a part file's `definePart({ … })`; `null` when it holds none. */
+export declare const noteOf: (source: string) => string | null;
+/** The part file with its `note` replaced, or `null` when it holds no `definePart({ note: '…' })` literal. */
+export declare const withNote: (source: string, note: string) => string | null;
+/**
+ * The part file with `madeBy` in its `definePart({ … })` set to the model ids, written next to `note`; an empty
+ * list removes it. `null` when the file holds no `definePart({ note })` to write it next to.
+ */
+export declare const withMadeBy: (source: string, madeBy: string[]) => string | null;
+/**
+ * Whether the `widths` a part file writes in `definePart({ widths })` break the rule: a literal that
+ * is not a non-empty list of positive numbers. A `widths` held in a variable cannot be read and passes.
+ */
+export declare const hasBadWidths: (source: string) => boolean;
+/**
+ * The widths a part file writes as a literal in `definePart({ widths: [...] })`, read without running it.
+ * An empty list when it has none; `null` when they are not a literal list of numbers, so they cannot be known.
+ */
+export declare const widthsOf: (source: string) => number[] | null;
+/**
+ * The names a part file writes as string literals in `definePart({ interactions: [...] })`, read
+ * without running it. An empty list when it has none or they are not written as a literal list.
+ */
+export declare const interactionNamesOf: (source: string) => string[];

package/src/lib/design/system/sketch/part-definition.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interactionNamesOf = exports.widthsOf = exports.hasBadWidths = exports.withMadeBy = exports.withNote = exports.noteOf = exports.madeByOf = exports.stateNamesOf = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const definitionOf = (source) => {
+    const file = typescript_1.default.createSourceFile('part.ts', source, typescript_1.default.ScriptTarget.Latest, true);
+    let found = null;
+    const visit = (node) => {
+        if (found)
+            return;
+        if (typescript_1.default.isCallExpression(node) &&
+            typescript_1.default.isIdentifier(node.expression) &&
+            node.expression.text === 'definePart' &&
+            node.arguments[0] &&
+            typescript_1.default.isObjectLiteralExpression(node.arguments[0])) {
+            found = node.arguments[0];
+            return;
+        }
+        typescript_1.default.forEachChild(node, visit);
+    };
+    visit(file);
+    return { file, definition: found };
+};
+const nameOf = (name) => typescript_1.default.isIdentifier(name) || typescript_1.default.isStringLiteral(name) || typescript_1.default.isNumericLiteral(name) ? name.text : null;
+const propertyOf = (definition, name) => definition.properties.find((property) => typescript_1.default.isPropertyAssignment(property) && nameOf(property.name) === name);
+/**
+ * The state names a part file declares in `definePart({ states: { … } })`, read without running it.
+ * `null` when the states are not written as an object literal there, so they cannot be known.
+ */
+const stateNamesOf = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const states = definition ? (_a = propertyOf(definition, 'states')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!states || !typescript_1.default.isObjectLiteralExpression(states))
+        return null;
+    const names = states.properties.map((property) => (typescript_1.default.isPropertyAssignment(property) || typescript_1.default.isShorthandPropertyAssignment(property)) && property.name
+        ? nameOf(property.name)
+        : null);
+    return names.includes(null) ? null : names;
+};
+exports.stateNamesOf = stateNamesOf;
+/** The model ids in the `madeBy` literal of a part file; none when it has no such array of strings. */
+const madeByOf = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const current = definition ? (_a = propertyOf(definition, 'madeBy')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!current || !typescript_1.default.isArrayLiteralExpression(current))
+        return [];
+    return current.elements.flatMap((element) => (typescript_1.default.isStringLiteralLike(element) ? [element.text] : []));
+};
+exports.madeByOf = madeByOf;
+/** The `note` literal of a part file's `definePart({ … })`; `null` when it holds none. */
+const noteOf = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const current = definition ? (_a = propertyOf(definition, 'note')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    return current && (typescript_1.default.isStringLiteral(current) || typescript_1.default.isNoSubstitutionTemplateLiteral(current)) ? current.text : null;
+};
+exports.noteOf = noteOf;
+const quoted = (text) => `'${text.replace(/\\/gu, '\\\\').replace(/'/gu, "\\'").replace(/\r?\n/gu, '\\n')}'`;
+/** The part file with its `note` replaced, or `null` when it holds no `definePart({ note: '…' })` literal. */
+const withNote = (source, note) => {
+    var _a;
+    const { file, definition } = definitionOf(source);
+    const current = definition ? (_a = propertyOf(definition, 'note')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!current || !(typescript_1.default.isStringLiteral(current) || typescript_1.default.isNoSubstitutionTemplateLiteral(current)))
+        return null;
+    return `${source.slice(0, current.getStart(file))}${quoted(note)}${source.slice(current.getEnd())}`;
+};
+exports.withNote = withNote;
+const lineStartOf = (source, position) => {
+    const newline = source.lastIndexOf('\n', position - 1);
+    return newline === -1 ? position : newline;
+};
+/**
+ * The part file with `madeBy` in its `definePart({ … })` set to the model ids, written next to `note`; an empty
+ * list removes it. `null` when the file holds no `definePart({ note })` to write it next to.
+ */
+const withMadeBy = (source, madeBy) => {
+    var _a, _b;
+    const { file, definition } = definitionOf(source);
+    const note = definition ? propertyOf(definition, 'note') : undefined;
+    if (!definition || !note)
+        return null;
+    const current = propertyOf(definition, 'madeBy');
+    const value = `madeBy: [${madeBy.map(quoted).join(', ')}]`;
+    if (current) {
+        if (madeBy.length > 0)
+            return `${source.slice(0, current.getStart(file))}${value}${source.slice(current.getEnd())}`;
+        const end = source[current.getEnd()] === ',' ? current.getEnd() + 1 : current.getEnd();
+        return `${source.slice(0, lineStartOf(source, current.getStart(file)))}${source.slice(end)}`;
+    }
+    if (madeBy.length === 0)
+        return source;
+    const start = note.getStart(file);
+    const indent = (_b = (_a = /^\n?([ \t]*)/u.exec(source.slice(lineStartOf(source, start), start))) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : '';
+    return `${source.slice(0, note.getEnd())},\n${indent}${value}${source.slice(note.getEnd())}`;
+};
+exports.withMadeBy = withMadeBy;
+const LITERALS = [
+    typescript_1.default.SyntaxKind.StringLiteral,
+    typescript_1.default.SyntaxKind.NoSubstitutionTemplateLiteral,
+    typescript_1.default.SyntaxKind.NumericLiteral,
+    typescript_1.default.SyntaxKind.TrueKeyword,
+    typescript_1.default.SyntaxKind.FalseKeyword,
+    typescript_1.default.SyntaxKind.NullKeyword,
+    typescript_1.default.SyntaxKind.ObjectLiteralExpression,
+    typescript_1.default.SyntaxKind.TemplateExpression,
+];
+const isPositiveNumber = (node) => typescript_1.default.isNumericLiteral(node) && Number(node.text) > 0;
+/**
+ * Whether the `widths` a part file writes in `definePart({ widths })` break the rule: a literal that
+ * is not a non-empty list of positive numbers. A `widths` held in a variable cannot be read and passes.
+ */
+const hasBadWidths = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const widths = definition ? (_a = propertyOf(definition, 'widths')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!widths)
+        return false;
+    if (typescript_1.default.isArrayLiteralExpression(widths))
+        return widths.elements.length === 0 || !widths.elements.every(isPositiveNumber);
+    return LITERALS.includes(widths.kind);
+};
+exports.hasBadWidths = hasBadWidths;
+/**
+ * The widths a part file writes as a literal in `definePart({ widths: [...] })`, read without running it.
+ * An empty list when it has none; `null` when they are not a literal list of numbers, so they cannot be known.
+ */
+const widthsOf = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const widths = definition ? (_a = propertyOf(definition, 'widths')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!widths)
+        return [];
+    if (!typescript_1.default.isArrayLiteralExpression(widths) || !widths.elements.every(typescript_1.default.isNumericLiteral))
+        return null;
+    return widths.elements.map((element) => Number(element.text));
+};
+exports.widthsOf = widthsOf;
+/**
+ * The names a part file writes as string literals in `definePart({ interactions: [...] })`, read
+ * without running it. An empty list when it has none or they are not written as a literal list.
+ */
+const interactionNamesOf = (source) => {
+    var _a;
+    const { definition } = definitionOf(source);
+    const interactions = definition ? (_a = propertyOf(definition, 'interactions')) === null || _a === void 0 ? void 0 : _a.initializer : undefined;
+    if (!interactions || !typescript_1.default.isArrayLiteralExpression(interactions))
+        return [];
+    return interactions.elements.flatMap((element) => typescript_1.default.isStringLiteral(element) || typescript_1.default.isNoSubstitutionTemplateLiteral(element) ? [element.text] : []);
+};
+exports.interactionNamesOf = interactionNamesOf;
+//# sourceMappingURL=part-definition.js.map

package/src/lib/design/system/sketch/part-definition.js.map

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

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

@@ -0,0 +1,9 @@
+import { SketchedProduct } from './overlay';
+/**
+ * A warning for each selector in a stylesheet of a variant whose subject is a class the sketch's `shared/` stylesheets
+ * define: the variant restyles shared code, and that coupling stays hidden after a merge.
+ */
+export declare const sharedClassWarningsOf: (options: {
+    target: string;
+    product: SketchedProduct;
+}) => string[];

package/src/lib/design/system/sketch/shared-class.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sharedClassWarningsOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const css_source_1 = require("../css-source");
+const resolve_product_1 = require("../resolve-product");
+const duplicate_class_1 = require("./duplicate-class");
+const withoutParens = (selector) => {
+    let depth = 0;
+    let kept = '';
+    for (const char of selector) {
+        if (char === '(')
+            depth++;
+        if (depth === 0)
+            kept += char;
+        if (char === ')')
+            depth = Math.max(0, depth - 1);
+    }
+    return kept;
+};
+const subjectClassesOf = (selector) => selector.split(',').flatMap((part) => {
+    var _a;
+    return (0, css_source_1.classesOf)((_a = withoutParens(part)
+        .trim()
+        .split(/\s*[\s>+~]\s*/u)
+        .pop()) !== null && _a !== void 0 ? _a : '');
+});
+const sharedCssOf = (sharedDir) => (0, fs_1.existsSync)(sharedDir)
+    ? (0, fs_1.readdirSync)(sharedDir, { recursive: true })
+        .filter((path) => path.endsWith('.css'))
+        .map((path) => (0, path_1.resolve)(sharedDir, path))
+        .map((file) => ({
+        file,
+        classes: new Set((0, css_source_1.cssBlocksOf)((0, fs_1.readFileSync)(file, 'utf8')).selectors.flatMap(css_source_1.classesOf)),
+    }))
+    : [];
+/**
+ * A warning for each selector in a stylesheet of a variant whose subject is a class the sketch's `shared/` stylesheets
+ * define: the variant restyles shared code, and that coupling stays hidden after a merge.
+ */
+const sharedClassWarningsOf = (options) => {
+    const { target, product } = options;
+    const shared = [...sharedCssOf(product.variantSharedDir), ...sharedCssOf(product.sharedDir)];
+    if (shared.length === 0)
+        return [];
+    return product.parts
+        .filter((part) => product.sketched.includes((0, resolve_product_1.partKeyOf)(part)))
+        .flatMap((part) => {
+        const stylesheets = (0, duplicate_class_1.stylesheetsOf)({ product, part });
+        return stylesheets
+            .filter((file) => !shared.some((entry) => entry.file === file))
+            .flatMap((file) => (0, css_source_1.cssBlocksOf)((0, fs_1.readFileSync)(file, 'utf8')).selectors.flatMap((selector) => subjectClassesOf(selector).flatMap((name) => {
+            const owner = shared.find((entry) => entry.classes.has(name));
+            const reportedAsDuplicate = owner && stylesheets.includes(owner.file) && /^\.[\w-]+$/u.test(selector.trim());
+            return owner && !reportedAsDuplicate
+                ? [
+                    `WARNING ${(0, resolve_product_1.partKeyOf)(part)}: ${(0, path_1.relative)(target, file)} restyles .${name} of ${(0, path_1.relative)(target, owner.file)} - change it in shared/ or give the variant a class of its own`,
+                ]
+                : [];
+        })));
+    });
+};
+exports.sharedClassWarningsOf = sharedClassWarningsOf;
+//# sourceMappingURL=shared-class.js.map

package/src/lib/design/system/sketch/shared-class.js.map

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