@ethlete/cli 3.0.0-next.26 → 3.0.0-next.27

package/src/lib/design/system/unchanged-rows.js

@@ -0,0 +1,134 @@
+"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.drawnStateNamesOf = exports.unchangedRowStatesOf = exports.forcesOnlyUnchangedControls = void 0;
+const force_interactions_1 = require("../force-interactions");
+const TAG = /<(\/?)([a-zA-Z][\w:.-]*)((?:[^>"']|"[^"]*"|'[^']*')*)>/g;
+const ATTRIBUTE = /([^\s=/"'>]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
+const VOID_ELEMENTS = new Set([
+    'area',
+    'base',
+    'br',
+    'col',
+    'embed',
+    'hr',
+    'img',
+    'input',
+    'link',
+    'meta',
+    'param',
+    'source',
+    'track',
+    'wbr',
+]);
+const tagsOf = (markup) => [...markup.replace(/<!--[\s\S]*?-->/g, '').matchAll(TAG)].map(([, slash, name = '', rest = '']) => ({
+    name: name.toLowerCase(),
+    closing: slash === '/',
+    selfClosing: rest.trimEnd().endsWith('/') || VOID_ELEMENTS.has(name.toLowerCase()),
+    attributes: new Map([...rest.matchAll(ATTRIBUTE)].map(([, attribute = '', double, single, bare]) => {
+        var _a, _b;
+        return [
+            attribute.toLowerCase(),
+            (_b = (_a = double !== null && double !== void 0 ? double : single) !== null && _a !== void 0 ? _a : bare) !== null && _b !== void 0 ? _b : '',
+        ];
+    })),
+}));
+const customClassesOf = (tag) => { var _a; return ((_a = tag.attributes.get('class')) !== null && _a !== void 0 ? _a : '').split(/\s+/u).filter((name) => name !== '' && !name.startsWith('et-')); };
+const isStyled = (tag) => { var _a; return customClassesOf(tag).length > 0 || ((_a = tag.attributes.get('style')) !== null && _a !== void 0 ? _a : '').trim() !== ''; };
+const isSdkComponent = (tag) => tag.attributes.has('data-et-ng') &&
+    (tag.name.startsWith('et-') || [...tag.attributes.keys()].some((name) => name.startsWith('et-')));
+/** The open tags inside the element opened at `start`, leaving out `svg` and embedded `data-et-part` subtrees. */
+const contentOf = (tags, start) => {
+    const content = [];
+    let depth = 0;
+    let skippedAt = null;
+    for (const tag of tags.slice(start + 1)) {
+        if (tag.closing) {
+            if (depth === 0)
+                break;
+            depth--;
+            if (skippedAt === depth)
+                skippedAt = null;
+            continue;
+        }
+        if (skippedAt === null && (tag.name === 'svg' || tag.attributes.has('data-et-part')))
+            skippedAt = depth;
+        if (skippedAt === null)
+            content.push(tag);
+        if (!tag.selfClosing)
+            depth++;
+        else if (skippedAt === depth)
+            skippedAt = null;
+    }
+    return content;
+};
+/**
+ * Whether every element a body forces into an interaction is an SDK component the part renders through `ng()` and does
+ * not style: an `et-` element or attribute with no custom class or inline style, and no styled content outside icons and
+ * embedded parts. `body` is the markup a part draws outside a browser, where `ng()` marks each element `data-et-ng`.
+ * `false` when the body forces nothing.
+ */
+const forcesOnlyUnchangedControls = (markup) => {
+    const tags = tagsOf(markup);
+    const forced = tags.flatMap((tag, index) => (!tag.closing && tag.attributes.has(force_interactions_1.FORCE_ATTRIBUTE) ? [index] : []));
+    return (forced.length > 0 &&
+        forced.every((index) => {
+            const tag = tags[index];
+            return isSdkComponent(tag) && !isStyled(tag) && !contentOf(tags, index).some(isStyled);
+        }));
+};
+exports.forcesOnlyUnchangedControls = forcesOnlyUnchangedControls;
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const bodyOf = (render, props) => __awaiter(void 0, void 0, void 0, function* () {
+    const drawn = yield render(props);
+    return isRecord(drawn) && typeof drawn['body'] === 'string' ? drawn['body'] : null;
+});
+/**
+ * The interaction states of each grid row whose forced elements are only SDK components the part leaves unchanged, so
+ * the row draws nothing the part styles: the grid shows such a row at rest only, and no tool draws or judges its
+ * interaction states. Read from the unrendered markup of the row's first interaction state.
+ */
+const unchangedRowStatesOf = (definition) => __awaiter(void 0, void 0, void 0, function* () {
+    const dropped = new Set();
+    if (!isRecord(definition) || typeof definition['render'] !== 'function')
+        return dropped;
+    const { states, grid } = definition;
+    const render = definition['render'];
+    if (!isRecord(states) || !isRecord(grid) || !Array.isArray(grid['columns']) || !isRecord(grid['rows']))
+        return dropped;
+    const interactions = grid['columns'].filter((column) => typeof column === 'string' && column !== 'rest');
+    for (const cells of Object.values(grid['rows'])) {
+        if (!isRecord(cells))
+            continue;
+        const forced = interactions
+            .map((column) => cells[column])
+            .filter((state) => typeof state === 'string' && state in states);
+        const first = forced[0];
+        if (first === undefined)
+            continue;
+        const body = yield bodyOf(render, states[first]).catch(() => null);
+        if (body !== null && (0, exports.forcesOnlyUnchangedControls)(body))
+            for (const state of forced)
+                dropped.add(state);
+    }
+    return dropped;
+});
+exports.unchangedRowStatesOf = unchangedRowStatesOf;
+/** The names of the states of a part definition every tool draws: its `states` without the unchanged row states. */
+const drawnStateNamesOf = (definition) => __awaiter(void 0, void 0, void 0, function* () {
+    const states = isRecord(definition) ? definition['states'] : undefined;
+    if (!isRecord(states) || Array.isArray(states))
+        return [];
+    const dropped = yield (0, exports.unchangedRowStatesOf)(definition);
+    return Object.keys(states).filter((state) => !dropped.has(state));
+});
+exports.drawnStateNamesOf = drawnStateNamesOf;
+//# sourceMappingURL=unchanged-rows.js.map

package/src/lib/design/system/unchanged-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unchanged-rows.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/unchanged-rows.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8DAAwD;AAIxD,MAAM,GAAG,GAAG,yDAAyD,CAAC;AACtE,MAAM,SAAS,GAAG,6DAA6D,CAAC;AAChF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,MAAc,EAAS,EAAE,CACvC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;IACxB,OAAO,EAAE,KAAK,KAAK,GAAG;IACtB,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAClF,UAAU,EAAE,IAAI,GAAG,CACjB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;;QAAC,OAAA;YAC9E,SAAS,CAAC,WAAW,EAAE;YACvB,MAAA,MAAA,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,MAAM,mCAAI,IAAI,mCAAI,EAAE;SAC/B,CAAA;KAAA,CAAC,CACH;CACF,CAAC,CAAC,CAAC;AAEN,MAAM,eAAe,GAAG,CAAC,GAAQ,EAAE,EAAE,WACnC,OAAA,CAAC,MAAA,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA,EAAA,CAAC;AAE7G,MAAM,QAAQ,GAAG,CAAC,GAAQ,EAAE,EAAE,WAAC,OAAA,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAA,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA,EAAA,CAAC;AAEpH,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAE,EAAE,CAClC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;IAChC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpG,kHAAkH;AAClH,MAAM,SAAS,GAAG,CAAC,IAAW,EAAE,KAAa,EAAE,EAAE;IAC/C,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,KAAK,KAAK,CAAC;gBAAE,MAAM;YACvB,KAAK,EAAE,CAAC;YACR,IAAI,SAAS,KAAK,KAAK;gBAAE,SAAS,GAAG,IAAI,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAAE,SAAS,GAAG,KAAK,CAAC;QACxG,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,KAAK,EAAE,CAAC;aACzB,IAAI,SAAS,KAAK,KAAK;YAAE,SAAS,GAAG,IAAI,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,2BAA2B,GAAG,CAAC,MAAc,EAAE,EAAE;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,oCAAe,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElH,OAAO,CACL,MAAM,CAAC,MAAM,GAAG,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAQ,CAAC;YAE/B,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzF,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,2BAA2B,+BAYtC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAEnH,MAAM,MAAM,GAAG,CAAO,MAAmC,EAAE,KAAc,EAAE,EAAE;IAC3E,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC,CAAA,CAAC;AAEF;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAO,UAAmB,EAAwB,EAAE;IACtF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAExF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAgC,CAAC;IAEnE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpG,OAAO,OAAO,CAAC;IAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CACzC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,CAC9E,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAE/B,MAAM,MAAM,GAAG,YAAY;aACxB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAElC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEnE,IAAI,IAAI,KAAK,IAAI,IAAI,IAAA,mCAA2B,EAAC,IAAI,CAAC;YAAE,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAA,CAAC;AA/BW,QAAA,oBAAoB,wBA+B/B;AAEF,oHAAoH;AAC7G,MAAM,iBAAiB,GAAG,CAAO,UAAmB,EAAqB,EAAE;IAChF,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1D,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAoB,EAAC,UAAU,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpE,CAAC,CAAA,CAAC;AARW,QAAA,iBAAiB,qBAQ5B"}

package/src/lib/design/system/uncommitted-decisions.d.ts

@@ -0,0 +1,6 @@
+import { ResolvedProduct } from './resolve-product';
+/** The decision files at the root of a product folder; none of them is an input of a drawing. */
+export declare const ROOT_DECISION_FILES: string[];
+/** The decision files of a product, relative to its folder, that differ from HEAD or are untracked; none outside git. */
+export declare const uncommittedDecisionsOf: (product: ResolvedProduct) => string[];
+export declare const uncommittedDecisionsWarningOf: (product: ResolvedProduct) => string | null;

package/src/lib/design/system/uncommitted-decisions.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uncommittedDecisionsWarningOf = exports.uncommittedDecisionsOf = exports.ROOT_DECISION_FILES = void 0;
+const child_process_1 = require("child_process");
+/** The decision files at the root of a product folder; none of them is an input of a drawing. */
+exports.ROOT_DECISION_FILES = ['go.json', 'accepted.json', 'merged.json', 'pictures.json'];
+const DECISION_FILES = [...exports.ROOT_DECISION_FILES, ':(glob)sketches/*/sketch.json'];
+const gitLines = (cwd, args) => (0, child_process_1.execFileSync)('git', [...args, '--', ...DECISION_FILES], {
+    cwd,
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'ignore'],
+})
+    .split('\n')
+    .filter(Boolean);
+/** The decision files of a product, relative to its folder, that differ from HEAD or are untracked; none outside git. */
+const uncommittedDecisionsOf = (product) => {
+    try {
+        return [
+            ...new Set([
+                ...gitLines(product.dir, ['diff', '--name-only', '--relative', 'HEAD']),
+                ...gitLines(product.dir, ['ls-files', '--others', '--exclude-standard']),
+            ]),
+        ].sort();
+    }
+    catch (_a) {
+        return [];
+    }
+};
+exports.uncommittedDecisionsOf = uncommittedDecisionsOf;
+const uncommittedDecisionsWarningOf = (product) => {
+    const files = (0, exports.uncommittedDecisionsOf)(product);
+    return files.length === 0
+        ? null
+        : `WARNING UNCOMMITTED-DECISIONS ${product.name}: ${files.join(', ')} differ from HEAD - Studio or Tom commits ` +
+            'them; an agent never commits go.json';
+};
+exports.uncommittedDecisionsWarningOf = uncommittedDecisionsWarningOf;
+//# sourceMappingURL=uncommitted-decisions.js.map

package/src/lib/design/system/uncommitted-decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncommitted-decisions.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/uncommitted-decisions.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAG7C,iGAAiG;AACpF,QAAA,mBAAmB,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;AAEhG,MAAM,cAAc,GAAG,CAAC,GAAG,2BAAmB,EAAE,+BAA+B,CAAC,CAAC;AAEjF,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAC/C,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,EAAE;IACtD,GAAG;IACH,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;CACpC,CAAC;KACC,KAAK,CAAC,IAAI,CAAC;KACX,MAAM,CAAC,OAAO,CAAC,CAAC;AAErB,yHAAyH;AAClH,MAAM,sBAAsB,GAAG,CAAC,OAAwB,EAAY,EAAE;IAC3E,IAAI,CAAC;QACH,OAAO;YACL,GAAG,IAAI,GAAG,CAAC;gBACT,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;gBACvE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;aACzE,CAAC;SACH,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,sBAAsB,0BAWjC;AAEK,MAAM,6BAA6B,GAAG,CAAC,OAAwB,EAAiB,EAAE;IACvF,MAAM,KAAK,GAAG,IAAA,8BAAsB,EAAC,OAAO,CAAC,CAAC;IAE9C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,iCAAiC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,4CAA4C;YAC5G,sCAAsC,CAAC;AAC/C,CAAC,CAAC;AAPW,QAAA,6BAA6B,iCAOxC"}

package/src/lib/design/system/uncovered-regions.d.ts

@@ -0,0 +1,61 @@
+import { Browser } from '../thumb';
+import { ResolvedProduct } from './resolve-product';
+type Page = Awaited<ReturnType<Awaited<ReturnType<Browser['newContext']>>['newPage']>>;
+export type RegionBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** One visible element of the app page as the uncovered-region check reads it. */
+export type RegionNode = {
+    tag: string;
+    className: string;
+    box: RegionBox;
+    covered: boolean;
+    paints: boolean;
+    children: RegionNode[];
+};
+export type UncoveredRegion = {
+    element: string;
+    component: string | null;
+    box: RegionBox;
+};
+/** An app region that is meant to have no part, with the reason the live spec gives. */
+export type Partless = {
+    selector: string;
+    reason: string;
+};
+export declare const MIN_REGION_SIDE = 4;
+/**
+ * The topmost visible regions of `tree` that no covered element holds: an element with no covered element inside that
+ * paints something and measures at least `minSide` on both sides. An element that holds a covered one is a layout
+ * wrapper, so the check looks at its children instead.
+ */
+export declare const uncoveredRegionsOf: (tree: RegionNode, minSide?: number) => UncoveredRegion[];
+/** What covers an app region: part component selectors, and the names of sketched parts no component implements yet. */
+export type PartCover = {
+    selectors: string[];
+    names: string[];
+};
+/**
+ * What covers the app regions of `product`: the selector of each component a part implements, by route or by
+ * component, and for each target of an open sketch the selector its variants implement or, without one, its name,
+ * which matches an element named `<name>` or `<prefix>-<name>`.
+ */
+export declare const partCoverOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+}) => PartCover;
+/** The element, its component and its box, as a report names one uncovered region. */
+export declare const regionTextOf: (region: UncoveredRegion) => string;
+export declare const UNCOVERED_HINT = "no part covers this visible app region; add a part that implements its component, or list it under \"partless\" in the live spec with a reason if it stays undesigned";
+/** The line that reports one uncovered region of the page at `address`. */
+export declare const uncoveredLineOf: (region: UncoveredRegion, address: string) => string;
+/** The visible regions of the open app page that no part, no open sketch's part and no `partless` selector covers. */
+export declare const uncoveredRegionsOnPage: (options: {
+    page: Page;
+    parts: PartCover;
+    partless: Partless[];
+}) => Promise<UncoveredRegion[]>;
+export {};

package/src/lib/design/system/uncovered-regions.js

@@ -0,0 +1,171 @@
+"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.uncoveredRegionsOnPage = exports.uncoveredLineOf = exports.UNCOVERED_HINT = exports.regionTextOf = exports.partCoverOf = exports.uncoveredRegionsOf = exports.MIN_REGION_SIDE = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const actions_1 = require("./actions");
+const part_definition_1 = require("./sketch/part-definition");
+const sketch_1 = require("./sketch/sketch");
+exports.MIN_REGION_SIDE = 4;
+const REGION_TREE_SCRIPT = `(({ covered, named }) => {
+  const SKIP = new Set(['script', 'style', 'template', 'link', 'meta', 'noscript']);
+  const PAINTED = new Set(['img', 'svg', 'canvas', 'video', 'iframe', 'input', 'textarea', 'select', 'picture']);
+  const matches = (element) => named.some((name) => element.localName === name || element.localName.endsWith('-' + name)) ||
+    covered.some((selector) => {
+      try {
+        return element.matches(selector);
+      } catch {
+        return false;
+      }
+    });
+  const visibleBoxOf = (element) => {
+    const box = element.getBoundingClientRect();
+    let left = Math.max(box.left, 0);
+    let top = Math.max(box.top, 0);
+    let right = Math.min(box.right, innerWidth);
+    let bottom = Math.min(box.bottom, innerHeight);
+
+    for (let current = element.parentElement; current; current = current.parentElement) {
+      const style = getComputedStyle(current);
+
+      if (style.overflowX === 'visible' && style.overflowY === 'visible') continue;
+
+      const clip = current.getBoundingClientRect();
+
+      left = Math.max(left, clip.left);
+      top = Math.max(top, clip.top);
+      right = Math.min(right, clip.right);
+      bottom = Math.min(bottom, clip.bottom);
+    }
+
+    return { x: left, y: top, width: Math.max(right - left, 0), height: Math.max(bottom - top, 0) };
+  };
+  const transparent = (color) => color === 'transparent' || /rgba\\([^)]*,\\s*0\\)$/.test(color);
+  const paints = (element) => {
+    if (PAINTED.has(element.localName)) return true;
+
+    const style = getComputedStyle(element);
+
+    if (!transparent(style.backgroundColor) || style.backgroundImage !== 'none' || style.boxShadow !== 'none')
+      return true;
+    if (['Top', 'Right', 'Bottom', 'Left'].some((side) =>
+      parseFloat(style['border' + side + 'Width']) > 0 && style['border' + side + 'Style'] !== 'none' &&
+      !transparent(style['border' + side + 'Color'])))
+      return true;
+
+    return [...element.childNodes].some((node) => node.nodeType === Node.TEXT_NODE && node.textContent.trim() !== '');
+  };
+  const nodeOf = (element) => {
+    if (SKIP.has(element.localName)) return null;
+    if (!element.checkVisibility({ opacityProperty: true, visibilityProperty: true })) return null;
+
+    const isCovered = matches(element);
+
+    return {
+      tag: element.localName,
+      className: (element.getAttribute('class') ?? '').trim(),
+      box: visibleBoxOf(element),
+      covered: isCovered,
+      paints: !isCovered && paints(element),
+      children: isCovered ? [] : [...element.children].map(nodeOf).filter((node) => node !== null),
+    };
+  };
+
+  return nodeOf(document.body);
+})`;
+const hasCovered = (node) => node.covered || node.children.some(hasCovered);
+const paintsAny = (node) => node.paints || node.children.some(paintsAny);
+const describe = (node) => `<${node.tag}${node.className ? ` class="${node.className}"` : ''}>`;
+/**
+ * The topmost visible regions of `tree` that no covered element holds: an element with no covered element inside that
+ * paints something and measures at least `minSide` on both sides. An element that holds a covered one is a layout
+ * wrapper, so the check looks at its children instead.
+ */
+const uncoveredRegionsOf = (tree, minSide = exports.MIN_REGION_SIDE) => {
+    const visit = (node, component) => {
+        if (node.covered)
+            return [];
+        const owner = node.tag.includes('-') ? node.tag : component;
+        const big = node.box.width >= minSide && node.box.height >= minSide;
+        if (!hasCovered(node) && big)
+            return paintsAny(node)
+                ? [
+                    {
+                        element: describe(node),
+                        component: owner,
+                        box: {
+                            x: Math.round(node.box.x),
+                            y: Math.round(node.box.y),
+                            width: Math.round(node.box.width),
+                            height: Math.round(node.box.height),
+                        },
+                    },
+                ]
+                : [];
+        return node.children.flatMap((child) => visit(child, owner));
+    };
+    return visit(tree, null);
+};
+exports.uncoveredRegionsOf = uncoveredRegionsOf;
+const selectorOfLink = (target, source) => {
+    const link = (0, part_definition_1.partLinkOf)(source);
+    const path = link.kind === 'component' ? link.path : link.kind === 'route' ? link.component : null;
+    const file = path === null ? null : (0, path_1.resolve)(target, path);
+    return file && (0, fs_1.existsSync)(file) ? (0, actions_1.componentSelectorOf)((0, fs_1.readFileSync)(file, 'utf8')) : null;
+};
+/**
+ * What covers the app regions of `product`: the selector of each component a part implements, by route or by
+ * component, and for each target of an open sketch the selector its variants implement or, without one, its name,
+ * which matches an element named `<name>` or `<prefix>-<name>`.
+ */
+const partCoverOf = (options) => {
+    const { target, product } = options;
+    const selectors = product.parts.flatMap((part) => { var _a; return (_a = selectorOfLink(target, part.source)) !== null && _a !== void 0 ? _a : []; });
+    const names = [];
+    for (const sketch of (0, sketch_1.listSketches)({ productDir: product.dir, product: product.name })) {
+        if (typeof sketch === 'string')
+            continue;
+        for (const key of sketch.targets) {
+            const parsed = (0, sketch_1.parseTarget)(key);
+            if (typeof parsed === 'string')
+                continue;
+            const linked = sketch.variants.flatMap((variant) => {
+                var _a;
+                const file = (0, path_1.resolve)((0, sketch_1.variantDirOf)(sketch, variant), parsed.layer, parsed.name, `${parsed.name}.ts`);
+                return (0, fs_1.existsSync)(file) ? ((_a = selectorOfLink(target, (0, fs_1.readFileSync)(file, 'utf8'))) !== null && _a !== void 0 ? _a : []) : [];
+            });
+            if (linked.length > 0)
+                selectors.push(...linked);
+            else
+                names.push(parsed.name);
+        }
+    }
+    return { selectors: [...new Set(selectors)], names: [...new Set(names)] };
+};
+exports.partCoverOf = partCoverOf;
+/** The element, its component and its box, as a report names one uncovered region. */
+const regionTextOf = (region) => `${region.element}${region.component && !region.element.startsWith(`<${region.component}`) ? ` in <${region.component}>` : ''} at ${region.box.x},${region.box.y} ${region.box.width}x${region.box.height}`;
+exports.regionTextOf = regionTextOf;
+exports.UNCOVERED_HINT = 'no part covers this visible app region; add a part that implements its component, or list it under "partless" in the live spec with a reason if it stays undesigned';
+/** The line that reports one uncovered region of the page at `address`. */
+const uncoveredLineOf = (region, address) => `UNCOVERED: ${(0, exports.regionTextOf)(region)} on ${address} - ${exports.UNCOVERED_HINT}`;
+exports.uncoveredLineOf = uncoveredLineOf;
+/** The visible regions of the open app page that no part, no open sketch's part and no `partless` selector covers. */
+const uncoveredRegionsOnPage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const tree = (yield options.page.evaluate(`${REGION_TREE_SCRIPT}(${JSON.stringify({
+        covered: [...options.parts.selectors, ...options.partless.map((entry) => entry.selector)],
+        named: options.parts.names,
+    })})`));
+    return tree ? (0, exports.uncoveredRegionsOf)(tree) : [];
+});
+exports.uncoveredRegionsOnPage = uncoveredRegionsOnPage;
+//# sourceMappingURL=uncovered-regions.js.map

package/src/lib/design/system/uncovered-regions.js.map

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

package/src/lib/design/system/unused-base-parts.d.ts

@@ -0,0 +1,7 @@
+import { ResolvedProduct } from './resolve-product';
+/**
+ * The keys of the base parts that no own part or token part of the product imports, directly or
+ * through other parts, and whose same-named `@ethlete/<lib>/design` module none of them reaches either. A
+ * `controls[*].part` ref or an `ng(…, { imports: ['X_IMPORTS'] })` name in such a part counts as use too.
+ */
+export declare const unusedBasePartsOf: (product: ResolvedProduct) => Set<string>;

package/src/lib/design/system/unused-base-parts.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unusedBasePartsOf = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const reachable_files_1 = require("./reachable-files");
+const resolve_product_1 = require("./resolve-product");
+const ts_source_1 = require("./ts-source");
+const drawsReachedModule = (options) => (0, ts_source_1.importsOf)(options.part.source).some((specifier) => {
+    const file = (0, reachable_files_1.sdkDesignFileOf)(options.root, specifier);
+    return file !== null && specifier.endsWith(`/${options.part.name}`) && options.reached.has(file);
+});
+const propertyNameOf = (node) => typescript_1.default.isPropertyAssignment(node) && (typescript_1.default.isIdentifier(node.name) || typescript_1.default.isStringLiteral(node.name))
+    ? node.name.text
+    : null;
+const kebabOf = (name) => name.toLowerCase().replace(/_/gu, '-');
+/** The part keys a source names in a `controls[*].part` and the `X_IMPORTS` names of its `ng(…, { imports })` calls. */
+const namedUsesOf = (source) => {
+    const parts = new Set();
+    const imports = new Set();
+    const visit = (node, inControls) => {
+        if (typescript_1.default.isPropertyAssignment(node) && propertyNameOf(node) === 'controls')
+            inControls = true;
+        if (inControls && typescript_1.default.isPropertyAssignment(node) && propertyNameOf(node) === 'part') {
+            if (typescript_1.default.isStringLiteralLike(node.initializer))
+                parts.add(node.initializer.text);
+        }
+        if (typescript_1.default.isCallExpression(node) && typescript_1.default.isIdentifier(node.expression) && node.expression.text === 'ng') {
+            for (const argument of node.arguments) {
+                if (!typescript_1.default.isObjectLiteralExpression(argument))
+                    continue;
+                for (const property of argument.properties) {
+                    if (propertyNameOf(property) !== 'imports' || !typescript_1.default.isPropertyAssignment(property))
+                        continue;
+                    if (!typescript_1.default.isArrayLiteralExpression(property.initializer))
+                        continue;
+                    for (const element of property.initializer.elements) {
+                        if (typescript_1.default.isStringLiteralLike(element) && element.text.endsWith('_IMPORTS')) {
+                            imports.add(kebabOf(element.text.slice(0, -'_IMPORTS'.length)));
+                        }
+                    }
+                }
+            }
+        }
+        typescript_1.default.forEachChild(node, (child) => visit(child, inControls));
+    };
+    visit((0, ts_source_1.sourceFileOf)(source), false);
+    return { parts, imports };
+};
+/**
+ * The keys of the base parts that no own part or token part of the product imports, directly or
+ * through other parts, and whose same-named `@ethlete/<lib>/design` module none of them reaches either. A
+ * `controls[*].part` ref or an `ng(…, { imports: ['X_IMPORTS'] })` name in such a part counts as use too.
+ */
+const unusedBasePartsOf = (product) => {
+    const base = product.parts.filter((part) => part.origin === 'base');
+    if (base.length === 0)
+        return new Set();
+    const tokens = new Set(product.tokens);
+    const roots = product.parts.filter((part) => part.origin !== 'base' || tokens.has((0, resolve_product_1.partKeyOf)(part)));
+    const { files, sdkDesign } = (0, reachable_files_1.reachableFilesOf)(product, roots);
+    const named = [...files].filter(([file]) => !file.endsWith('.css')).map(([, source]) => namedUsesOf(source));
+    const namedKeys = new Set(named.flatMap((uses) => [...uses.parts]));
+    const namedImports = new Set(named.flatMap((uses) => [...uses.imports]));
+    const root = (0, reachable_files_1.repoRootOf)(product);
+    return new Set(base
+        .filter((part) => !files.has(part.file) &&
+        !drawsReachedModule({ part, root, reached: sdkDesign }) &&
+        !namedKeys.has((0, resolve_product_1.partKeyOf)(part)) &&
+        !(part.layer === 'components' && namedImports.has(part.name)))
+        .map(resolve_product_1.partKeyOf));
+};
+exports.unusedBasePartsOf = unusedBasePartsOf;
+//# sourceMappingURL=unused-base-parts.js.map

package/src/lib/design/system/unused-base-parts.js.map

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

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

@@ -0,0 +1,48 @@
+import { DesignConfig } from '../paths';
+import { ShootStates } from './compare-command';
+import { StartHarnessServer } from './harness-server';
+import { SketchEvidence, VisibleChangeVerdict } from './visible-change';
+/**
+ * The commit the gate compares HEAD with: `base`, else the merge base of HEAD and `branch` (a product's
+ * `harness.baseBranch`), else of HEAD and the branch `origin/HEAD` names.
+ */
+export declare const baseCommitOf: (options: {
+    root: string;
+    base: string | undefined;
+    branch?: string;
+}) => string;
+/** Each `sketch.json` of the product a commit in base..HEAD touched, as that commit left it or, if it deleted it, as before. */
+export declare const sketchEvidenceOf: (options: {
+    root: string;
+    base: string;
+    productDir: string;
+}) => SketchEvidence[];
+/** The parts a sketch merge recorded in the product's `merged.json` in base..HEAD, also of a sketch never committed. */
+export declare const mergedInRangeOf: (options: {
+    root: string;
+    base: string;
+    productDir: string;
+}) => Set<string>;
+/**
+ * `et design check --product <name>… --visible-change [--base <rev>] [--part <part>…]` draws each harness part's states in the app at
+ * the base commit and at HEAD, against HEAD's design, and fails a part that looks different unless a picked or merged
+ * sketch of it is in base..HEAD or every changed state moved closer to the design.
+ */
+export declare const checkVisibleChange: (options: {
+    target: string;
+    config: DesignConfig;
+    products: string[];
+    base: string | undefined;
+    parts?: string[];
+    shoot?: ShootStates;
+    start?: StartHarnessServer;
+    onVerdict?: (options: {
+        product: string;
+        verdict: VisibleChangeVerdict;
+        line: string;
+    }) => void;
+    onProblem?: (options: {
+        product: string;
+        line: string;
+    }) => void;
+}) => Promise<number>;