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

package/src/lib/design/system/demo-backdrop.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.demoBackdropGapsOf = exports.findDemoBackdrop = void 0;
+const TRANSPARENT = new Set(['transparent', 'rgba(0, 0, 0, 0)']);
+/**
+ * A page script over the frame root `root`: the `data-et-part` root of `part` when it paints the very fill of the
+ * surface it sits on, as `{ path, fill }`, else `null`. A control or a surface root is never one.
+ */
+const findDemoBackdrop = (part) => `((root) => {
+  const own = [root, ...root.querySelectorAll('[data-et-part]')].find((element) => (element.getAttribute('data-et-part') ?? '').split(' ').includes(${JSON.stringify(part)}));
+  if (!own || !own.parentElement || own.hasAttribute('data-et-control') || own.hasAttribute('data-et-surface')) return null;
+  const fill = getComputedStyle(own).backgroundColor;
+  if (${JSON.stringify([...TRANSPARENT])}.includes(fill)) return null;
+  const probe = document.createElement('div');
+  probe.style.backgroundColor = 'rgb(var(--et-surface-background))';
+  own.parentElement.appendChild(probe);
+  const under = getComputedStyle(probe).backgroundColor;
+  probe.remove();
+  if (under !== fill) return null;
+  const cls = [...own.classList].find((name) => /^[a-z][\\w-]*$/i.test(name));
+  return { path: own.tagName.toLowerCase() + (cls ? '.' + cls : ''), fill };
+})`;
+exports.findDemoBackdrop = findDemoBackdrop;
+/** A `DEMO-BACKDROP` gap when a drawn frame of `part` paints its root in the fill of the surface under it. */
+const demoBackdropGapsOf = (options) => {
+    var _a;
+    const painted = options.frames.filter((frame) => frame.backdrop);
+    const first = (_a = painted[0]) === null || _a === void 0 ? void 0 : _a.backdrop;
+    if (!first)
+        return [];
+    const states = [...new Set(painted.map((frame) => frame.state))];
+    return [
+        {
+            code: 'DEMO-BACKDROP',
+            target: options.part,
+            detail: `${states.join(', ')}: the part root ${first.path} paints the surface it sits on (${first.fill}), a demo backdrop the app part does not draw - drop the fill from the drawing and let the part stay transparent`,
+        },
+    ];
+};
+exports.demoBackdropGapsOf = demoBackdropGapsOf;
+//# sourceMappingURL=demo-backdrop.js.map

package/src/lib/design/system/demo-backdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-backdrop.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/demo-backdrop.ts"],"names":[],"mappings":";;;AAEA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEjE;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;sJACoG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;QAGlK,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;;;;;;;;;GASrC,CAAC;AAbS,QAAA,gBAAgB,oBAazB;AAEJ,8GAA8G;AACvG,MAAM,kBAAkB,GAAG,CAAC,OAA8C,EAAqB,EAAE;;IACtG,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,CAAC,CAAC,0CAAE,QAAQ,CAAC;IAEnC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL;YACE,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,OAAO,CAAC,IAAI;YACpB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,mCAAmC,KAAK,CAAC,IAAI,kHAAkH;SACzN;KACF,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,kBAAkB,sBAe7B"}

package/src/lib/design/system/design-hash.d.ts

@@ -0,0 +1,52 @@
+import { ResolvedPart, ResolvedProduct } from './resolve-product';
+/** The content hash of each file, under its path from the repository root. */
+export type FileHashes = Record<string, string>;
+/**
+ * The hashes a record written while the design hash still covered `implements` links holds at: whole design hashes,
+ * the hashes of each linked file, and folder-only hashes.
+ */
+export type EarlierHashes = {
+    hashes: string[];
+    files: Record<string, string[]>;
+    legacy: string[];
+};
+/**
+ * A part's design hash, the file hashes it covers, and the folder-only hash records from before file lists. None of
+ * them covers the `implements` field of a `definePart`: a link-only change is not a design edit. `withLinks` is the
+ * design hash with the links, for caches whose results depend on what a part links.
+ */
+export type DesignHash = {
+    hash: string;
+    files: FileHashes;
+    legacy: string;
+    earlier: EarlierHashes;
+    withLinks: string;
+};
+/** A stored mark: one with `files` holds at the design hash, one without at the folder-only hash. */
+export type HashRecord = {
+    hash: string;
+    files?: FileHashes;
+};
+export declare const sha16: (data: string | Buffer) => string;
+/** Whether a stored `files` value is absent or a valid file hash map, for the readers of the mark files. */
+export declare const isOptionalFileHashes: (value: unknown) => value is FileHashes | undefined;
+/** The hash of each existing file in `files`, keyed by its `/`-separated path from `root`, sorted. */
+export declare const fileHashesOf: (root: string, files: Iterable<string>) => FileHashes;
+export declare const hashOfFiles: (files: FileHashes) => string;
+/**
+ * The design hash of a part: its folder, the shared and asset files it reaches, and every file it reaches through
+ * imports - other `@system` parts, `@ethlete/<lib>/design` mocks and the fixtures - with the hash of each file.
+ */
+export declare const designHashOf: (options: {
+    product: ResolvedProduct;
+    part: ResolvedPart;
+}) => DesignHash;
+/** Whether a stored design hash without its file list still matches the part. */
+export declare const designHolds: (hash: string, now: DesignHash) => boolean;
+/** Whether a stored folder-only hash still matches the part. */
+export declare const legacyHolds: (hash: string, now: DesignHash) => boolean;
+/** The paths of a stored file hash map whose file changed since, a change of only its `implements` link aside. */
+export declare const changedDesignFilesOf: (before: FileHashes, now: DesignHash) => string[];
+export declare const recordHolds: (record: HashRecord, now: DesignHash) => boolean;
+/** The paths whose hash differs between two file hash maps, added and removed paths included, sorted. */
+export declare const changedFilesOf: (before: FileHashes, now: FileHashes) => string[];

package/src/lib/design/system/design-hash.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changedFilesOf = exports.recordHolds = exports.changedDesignFilesOf = exports.legacyHolds = exports.designHolds = exports.designHashOf = exports.hashOfFiles = exports.fileHashesOf = exports.isOptionalFileHashes = exports.sha16 = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const assets_1 = require("./assets");
+const imports_1 = require("./imports");
+const inventory_approval_1 = require("./inventory-approval");
+const link_free_1 = require("./link-free");
+const reachable_files_1 = require("./reachable-files");
+const baseline_1 = require("./sketch/baseline");
+const ts_source_1 = require("./ts-source");
+const sha16 = (data) => (0, crypto_1.createHash)('sha256').update(data).digest('hex').slice(0, 16);
+exports.sha16 = sha16;
+const isFileHashes = (value) => !!value &&
+    typeof value === 'object' &&
+    !Array.isArray(value) &&
+    Object.values(value).every((hash) => typeof hash === 'string');
+/** Whether a stored `files` value is absent or a valid file hash map, for the readers of the mark files. */
+const isOptionalFileHashes = (value) => value === undefined || isFileHashes(value);
+exports.isOptionalFileHashes = isOptionalFileHashes;
+/** The hash of each existing file in `files`, keyed by its `/`-separated path from `root`, sorted. */
+const fileHashesOf = (root, files) => Object.fromEntries([...new Set(files)]
+    .map((file) => [(0, path_1.relative)(root, file).split(path_1.sep).join('/'), file])
+    .sort(([a], [b]) => a.localeCompare(b))
+    .flatMap(([path, file]) => {
+    try {
+        return [[path, (0, exports.sha16)((0, fs_1.readFileSync)(file))]];
+    }
+    catch (_a) {
+        return [];
+    }
+}));
+exports.fileHashesOf = fileHashesOf;
+const designFileHashesOf = (root, files) => {
+    const hashes = {};
+    const linked = {};
+    for (const [path, file] of [...new Set(files)]
+        .map((file) => [(0, path_1.relative)(root, file).split(path_1.sep).join('/'), file])
+        .sort(([a], [b]) => a.localeCompare(b))) {
+        let bytes;
+        try {
+            bytes = (0, fs_1.readFileSync)(file);
+        }
+        catch (_a) {
+            continue;
+        }
+        hashes[path] = (0, exports.sha16)((0, link_free_1.linkFreeContentOf)(file, bytes));
+        const contents = (0, link_free_1.linkedContentsOf)(file, bytes);
+        if (contents)
+            linked[path] = { current: (0, exports.sha16)(contents.current), older: contents.older.map(exports.sha16) };
+    }
+    return { hashes, linked };
+};
+const linkHashesOf = (files, linked) => {
+    const entries = Object.entries(linked);
+    const withLinks = Object.assign(Object.assign({}, files), Object.fromEntries(entries.map(([path, { current }]) => [path, current])));
+    const withLinksHash = (0, exports.hashOfFiles)(withLinks);
+    return {
+        withLinks: withLinksHash,
+        earlier: entries.length === 0
+            ? []
+            : [
+                ...new Set([
+                    withLinksHash,
+                    ...entries.flatMap(([path, { older }]) => older.map((hash) => (0, exports.hashOfFiles)(Object.assign(Object.assign({}, withLinks), { [path]: hash })))),
+                ]),
+            ],
+    };
+};
+const hashOfFiles = (files) => (0, exports.sha16)(Object.entries(files)
+    .map(([path, hash]) => `${path}\0${hash}\n`)
+    .join(''));
+exports.hashOfFiles = hashOfFiles;
+/**
+ * The design hash of a part: its folder, the shared and asset files it reaches, and every file it reaches through
+ * imports - other `@system` parts, `@ethlete/<lib>/design` mocks and the fixtures - with the hash of each file.
+ */
+const designHashOf = (options) => {
+    const { product, part } = options;
+    const owner = (0, inventory_approval_1.partOwnerOf)({ product, part });
+    const dir = (0, path_1.dirname)(part.file);
+    const inputs = (0, baseline_1.partInputsOf)({ product: owner, dir });
+    const reachable = (0, reachable_files_1.reachableFilesOf)(product, [part]);
+    const reached = [...reachable.files.keys()];
+    const fixtures = product.fixtures && [...reachable.files.values()].some((source) => (0, ts_source_1.importsOf)(source).includes(imports_1.FIXTURES_SPECIFIER))
+        ? [product.fixtures]
+        : [];
+    const files = [
+        ...inputs.files,
+        ...inputs.shared.map(({ file }) => file),
+        ...inputs.assets.map(({ file }) => file),
+        ...reached,
+        ...(0, assets_1.importedAssetsOf)({ product: owner, files: reached }).map(({ file }) => file),
+        ...reachable.sdkDesign.keys(),
+        ...fixtures,
+    ].filter((file) => !inputs.generated.has(file));
+    const { hashes, linked } = designFileHashesOf((0, reachable_files_1.repoRootOf)(product), files);
+    const links = linkHashesOf(hashes, linked);
+    return {
+        hash: (0, exports.hashOfFiles)(hashes),
+        files: hashes,
+        legacy: (0, baseline_1.partHashOf)({ product: owner, dir }),
+        earlier: {
+            hashes: links.earlier,
+            files: Object.fromEntries(Object.entries(linked).map(([path, { current, older }]) => [path, [current, ...older]])),
+            legacy: (0, baseline_1.earlierPartHashesOf)({ product: owner, dir }),
+        },
+        withLinks: links.withLinks,
+    };
+};
+exports.designHashOf = designHashOf;
+/** Whether a stored design hash without its file list still matches the part. */
+const designHolds = (hash, now) => hash === now.hash || now.earlier.hashes.includes(hash);
+exports.designHolds = designHolds;
+/** Whether a stored folder-only hash still matches the part. */
+const legacyHolds = (hash, now) => hash === now.legacy || now.earlier.legacy.includes(hash);
+exports.legacyHolds = legacyHolds;
+/** The paths of a stored file hash map whose file changed since, a change of only its `implements` link aside. */
+const changedDesignFilesOf = (before, now) => (0, exports.changedFilesOf)(before, now.files).filter((path) => { var _a, _b; return !((_a = now.earlier.files[path]) === null || _a === void 0 ? void 0 : _a.includes((_b = before[path]) !== null && _b !== void 0 ? _b : '')); });
+exports.changedDesignFilesOf = changedDesignFilesOf;
+const recordHolds = (record, now) => record.files
+    ? record.hash === now.hash || (0, exports.changedDesignFilesOf)(record.files, now).length === 0
+    : (0, exports.legacyHolds)(record.hash, now);
+exports.recordHolds = recordHolds;
+/** The paths whose hash differs between two file hash maps, added and removed paths included, sorted. */
+const changedFilesOf = (before, now) => [...new Set([...Object.keys(before), ...Object.keys(now)])]
+    .filter((path) => before[path] !== now[path])
+    .sort((a, b) => a.localeCompare(b));
+exports.changedFilesOf = changedFilesOf;
+//# sourceMappingURL=design-hash.js.map

package/src/lib/design/system/design-hash.js.map

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

package/src/lib/design/system/disabled-interaction.d.ts

@@ -0,0 +1,8 @@
+/** The rule a disabled control breaks when a forced hover or active changes how it looks. */
+export declare const DISABLED_INTERACTION_RULE = "DISABLED-INTERACTION";
+/**
+ * The statements of the disabled-interaction check inside the frame script of `render-check`. They use `root` and
+ * `report` of that script. They measure each disabled element plain, then with `data-et-force` hover and active, and
+ * restore the element, so they run last.
+ */
+export declare const DISABLED_INTERACTION_STATEMENTS = "\n  const disabledLook = (element) => {\n    const style = getComputedStyle(element);\n    return ['backgroundColor', 'color', 'borderColor', 'boxShadow', 'outline', 'opacity', 'transform'].map((name) => [name, style[name]]);\n  };\n  for (const element of root.querySelectorAll(':disabled, [aria-disabled=\"true\"]')) {\n    if (element.getClientRects().length === 0) continue;\n    const before = element.getAttribute('data-et-force');\n    const transition = element.style.transition;\n    element.style.transition = 'none';\n    element.removeAttribute('data-et-force');\n    const plain = disabledLook(element);\n    const changed = new Set();\n    for (const interaction of ['hover', 'active']) {\n      element.setAttribute('data-et-force', interaction);\n      disabledLook(element).forEach(([name, value], index) => {\n        if (value !== plain[index][1]) changed.add(name);\n      });\n    }\n    if (before === null) element.removeAttribute('data-et-force');\n    else element.setAttribute('data-et-force', before);\n    element.style.transition = transition;\n    if (changed.size > 0)\n      report('DISABLED-INTERACTION', element, 'hover/active styles apply while disabled - add a :not([disabled]) guard (changes ' + [...changed].join(', ') + ')');\n  }\n";

package/src/lib/design/system/disabled-interaction.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISABLED_INTERACTION_STATEMENTS = exports.DISABLED_INTERACTION_RULE = void 0;
+/** The rule a disabled control breaks when a forced hover or active changes how it looks. */
+exports.DISABLED_INTERACTION_RULE = 'DISABLED-INTERACTION';
+/**
+ * The statements of the disabled-interaction check inside the frame script of `render-check`. They use `root` and
+ * `report` of that script. They measure each disabled element plain, then with `data-et-force` hover and active, and
+ * restore the element, so they run last.
+ */
+exports.DISABLED_INTERACTION_STATEMENTS = `
+  const disabledLook = (element) => {
+    const style = getComputedStyle(element);
+    return ['backgroundColor', 'color', 'borderColor', 'boxShadow', 'outline', 'opacity', 'transform'].map((name) => [name, style[name]]);
+  };
+  for (const element of root.querySelectorAll(':disabled, [aria-disabled="true"]')) {
+    if (element.getClientRects().length === 0) continue;
+    const before = element.getAttribute('data-et-force');
+    const transition = element.style.transition;
+    element.style.transition = 'none';
+    element.removeAttribute('data-et-force');
+    const plain = disabledLook(element);
+    const changed = new Set();
+    for (const interaction of ['hover', 'active']) {
+      element.setAttribute('data-et-force', interaction);
+      disabledLook(element).forEach(([name, value], index) => {
+        if (value !== plain[index][1]) changed.add(name);
+      });
+    }
+    if (before === null) element.removeAttribute('data-et-force');
+    else element.setAttribute('data-et-force', before);
+    element.style.transition = transition;
+    if (changed.size > 0)
+      report('${exports.DISABLED_INTERACTION_RULE}', element, 'hover/active styles apply while disabled - add a :not([disabled]) guard (changes ' + [...changed].join(', ') + ')');
+  }
+`;
+//# sourceMappingURL=disabled-interaction.js.map

package/src/lib/design/system/disabled-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disabled-interaction.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/disabled-interaction.ts"],"names":[],"mappings":";;;AAAA,6FAA6F;AAChF,QAAA,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE;;;;GAIG;AACU,QAAA,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;gBAuB/B,iCAAyB;;CAExC,CAAC"}

package/src/lib/design/system/dom-command.d.ts

@@ -0,0 +1,36 @@
+import { DesignConfig } from '../design-config';
+import { StartHarnessServer } from './harness-server';
+import { PointerOpen } from './part-compare';
+import { ResolvedProduct } from './resolve-product';
+export declare const DOM_USAGE = "dom <layer>/<name> --product <name> [--state <name>] [--app] [--url <app dev server url>]";
+export type ReadDom = (options: {
+    target: string;
+    config: DesignConfig;
+    product: ResolvedProduct;
+    part: string;
+    state: string | null;
+    app: boolean;
+    url: string;
+}) => Promise<{
+    state: string;
+    html: string;
+} | string>;
+/** The reason `--app` cannot print a state: compare forces its hover, active or focus, or clicks a trigger to open it. */
+export declare const appRefusalOf: (options: {
+    part: string;
+    state: string;
+    markup: string;
+    open: PointerOpen | string | undefined;
+}) => string | null;
+export declare const readDom: ReadDom;
+/**
+ * `et design dom <layer>/<name> …` prints the pretty-printed HTML of one state of a part: its rendered design, or
+ * with `--app` the harness host element of the app that compare shoots.
+ */
+export declare const designDom: (options: {
+    target: string;
+    argv: string[];
+    invocation: string;
+    read?: ReadDom;
+    start?: StartHarnessServer;
+}) => Promise<0 | 1 | 2>;

package/src/lib/design/system/dom-command.js

@@ -0,0 +1,178 @@
+"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.designDom = exports.readDom = exports.appRefusalOf = exports.DOM_USAGE = void 0;
+const browser_1 = require("../browser");
+const serve_1 = require("../serve");
+const shot_1 = require("../shot");
+const thumb_1 = require("../thumb");
+const harness_shot_1 = require("./harness-shot");
+const harness_map_1 = require("./harness-map");
+const harness_server_1 = require("./harness-server");
+const part_compare_1 = require("./part-compare");
+const prettier_1 = require("./prettier");
+const resolve_product_1 = require("./resolve-product");
+const cli_args_1 = require("./sketch/cli-args");
+const sketch_1 = require("./sketch/sketch");
+const system_modules_1 = require("./system-modules");
+exports.DOM_USAGE = 'dom <layer>/<name> --product <name> [--state <name>] [--app] [--url <app dev server url>]';
+const messageOf = (error) => (error instanceof Error ? error.message : String(error));
+const refusedOf = ({ part, what, detail = '' }) => `design dom --app cannot render ${what} of ${part}${detail} yet; run it without --app for the design markup`;
+/** The reason `--app` cannot print a state: compare forces its hover, active or focus, or clicks a trigger to open it. */
+const appRefusalOf = (options) => {
+    const { part, state, markup, open } = options;
+    if ((0, part_compare_1.forcedElementsOf)(markup).length > 0)
+        return refusedOf({ part, what: `the forced state ${state}` });
+    if (open === undefined)
+        return null;
+    return refusedOf({
+        part,
+        what: `the click-opened state ${state}`,
+        detail: ` (${typeof open === 'string' ? open : `a click on ${open.control}`})`,
+    });
+};
+exports.appRefusalOf = appRefusalOf;
+const readDom = (_a) => __awaiter(void 0, [_a], void 0, function* ({ target, config, product, part, state: asked, app, url }) {
+    var _b, _c, _d, _e, _f, _g;
+    const frame = (0, harness_shot_1.compareFrameOf)({ presets: product.presets, part, preset: null });
+    if (typeof frame === 'string')
+        return frame;
+    if (!(yield (0, browser_1.chromiumOf)(target)))
+        return 'dom needs playwright or playwright-core in the checkout';
+    const queue = (0, thumb_1.createDrawQueue)({ target });
+    const server = yield (0, serve_1.createDesignServer)({ target, config, listen: true, port: 0 });
+    let shooter;
+    try {
+        yield server.listen();
+        const { port } = (_b = server.httpServer) === null || _b === void 0 ? void 0 : _b.address();
+        const partShooter = (shooter = (0, shot_1.createPartShooter)({
+            target,
+            base: `http://localhost:${port}`,
+            system: (0, system_modules_1.createSystemModules)({ target, config }),
+            queue,
+        }));
+        const file = (_d = (_c = product.parts.find((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === part)) === null || _c === void 0 ? void 0 : _c.file) !== null && _d !== void 0 ? _d : '';
+        const module = (yield server.ssrLoadModule((0, system_modules_1.productModuleIdOf)({ file, product: product.name })));
+        const loaded = (_e = module.default) === null || _e === void 0 ? void 0 : _e.states;
+        const states = loaded && typeof loaded === 'object' && !Array.isArray(loaded) ? loaded : {};
+        const state = asked !== null && asked !== void 0 ? asked : Object.keys(states)[0];
+        if (state === undefined || !(state in states))
+            return `${part} has no state "${asked !== null && asked !== void 0 ? asked : ''}" - its states: ${Object.keys(states).join(', ')}`;
+        const designOf = (name) => partShooter.pictureOf({
+            product: product.name,
+            part,
+            state: name,
+            preset: frame.preset,
+            width: null,
+            sketch: null,
+            interaction: null,
+            bare: true,
+            emptySlots: true,
+            checker: false,
+            params: new URLSearchParams(),
+        });
+        if (!app) {
+            const design = yield designOf(state);
+            return design.markup === undefined
+                ? `the design of ${part} state ${state} drew no markup`
+                : { state, html: design.markup };
+        }
+        const markups = Object.fromEntries(yield Promise.all(Object.keys(states).map((name) => __awaiter(void 0, void 0, void 0, function* () { var _a; return [name, (_a = (yield designOf(name)).markup) !== null && _a !== void 0 ? _a : '']; }))));
+        const opens = (0, part_compare_1.pointerOpensOf)({
+            states,
+            controls: (_f = module.default) === null || _f === void 0 ? void 0 : _f.controls,
+            drawn: Object.fromEntries(Object.entries(markups).map(([name, markup]) => [name, (0, part_compare_1.drawnSurfacesOf)(markup)])),
+        });
+        const refusal = (0, exports.appRefusalOf)({ part, state, markup: (_g = markups[state]) !== null && _g !== void 0 ? _g : '', open: opens[state] });
+        if (refusal !== null)
+            return refusal;
+        const pageUrl = (0, part_compare_1.harnessUrlOf)({ url, part, state, props: states[state], layout: frame.layout });
+        const html = yield queue.run((browser) => __awaiter(void 0, void 0, void 0, function* () {
+            const context = yield browser.newContext({ viewport: (0, shot_1.viewportOf)(frame.size), deviceScaleFactor: 1 });
+            try {
+                const page = yield context.newPage();
+                yield page.goto(pageUrl, { timeout: thumb_1.DRAW_TIMEOUT_MS });
+                yield page.locator(part_compare_1.HARNESS_HOST_SELECTOR).first().waitFor({ state: 'visible', timeout: thumb_1.DRAW_TIMEOUT_MS });
+                yield (0, thumb_1.awaitFonts)(page);
+                return (yield page.evaluate(`document.querySelector(${JSON.stringify(part_compare_1.HARNESS_HOST_SELECTOR)})?.outerHTML ?? null`));
+            }
+            finally {
+                yield context.close();
+            }
+        }));
+        return html === null ? `the harness page ${pageUrl} showed no ${part_compare_1.HARNESS_HOST_SELECTOR} element` : { state, html };
+    }
+    catch (error) {
+        return messageOf(error);
+    }
+    finally {
+        yield (shooter === null || shooter === void 0 ? void 0 : shooter.close());
+        yield queue.close();
+        yield server.close();
+    }
+});
+exports.readDom = readDom;
+/**
+ * `et design dom <layer>/<name> …` prints the pretty-printed HTML of one state of a part: its rendered design, or
+ * with `--app` the harness host element of the app that compare shoots.
+ */
+const designDom = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { target, invocation } = options;
+    const args = (0, cli_args_1.argsOf)(options.argv, { values: ['--product', '--state', '--url'], switches: ['--app'] });
+    if (typeof args === 'string' || args.positional.length !== 1) {
+        if (typeof args === 'string')
+            console.error(args);
+        console.error(`usage: ${invocation} ${exports.DOM_USAGE}`);
+        return 2;
+    }
+    const config = (0, cli_args_1.configOf)(target);
+    const parsed = (0, sketch_1.parseTarget)(args.positional[0]);
+    if (typeof config === 'string' || typeof parsed === 'string') {
+        console.error(typeof config === 'string' ? config : parsed);
+        return 1;
+    }
+    const product = (0, cli_args_1.oneProductOf)({ target, config, asked: args.values['--product'] });
+    if (typeof product === 'string') {
+        console.error(product);
+        return 1;
+    }
+    const app = args.flags.has('--app');
+    const part = (0, resolve_product_1.partKeyOf)(parsed);
+    const known = product.parts.some((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === part);
+    const refusal = !known
+        ? `product "${product.name}" has no part "${part}"`
+        : app
+            ? (0, harness_map_1.harnessStaleOf)({ target, product })
+            : null;
+    if (refusal !== null) {
+        console.error(refusal);
+        return 1;
+    }
+    const read = (_a = options.read) !== null && _a !== void 0 ? _a : exports.readDom;
+    const run = (url) => { var _a; return read({ target, config, product, part, state: (_a = args.values['--state']) !== null && _a !== void 0 ? _a : null, app, url }); };
+    const result = app
+        ? yield (0, harness_server_1.withHarnessUrl)({ target, product, url: args.values['--url'], start: options.start, run })
+        : yield run('');
+    if (typeof result === 'string') {
+        console.error(result);
+        return 1;
+    }
+    const formatted = (0, prettier_1.formattedTextOf)({ target, file: 'dom.html', text: result.html });
+    if (typeof formatted !== 'string') {
+        console.error(formatted.error);
+        return 1;
+    }
+    console.log(formatted.trimEnd());
+    return 0;
+});
+exports.designDom = designDom;
+//# sourceMappingURL=dom-command.js.map

package/src/lib/design/system/dom-command.js.map

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

package/src/lib/design/system/drawn-open-points.d.ts

@@ -1,10 +1,32 @@
-import { DesignConfig } from '../paths';
+import { DesignConfig } from '../design-config';
+import { CompletenessGap } from './complete';
 import { OpenPointsInput } from './open-points';
+import { BusyState, RenderIssue } from './render-check';
 import { ResolvedProduct } from './resolve-product';
-export type DrawnFindings = Required<Pick<OpenPointsInput, 'missingStates' | 'contrasts'>>;
+export type DrawnFindings = Required<Pick<OpenPointsInput, 'missingStates' | 'contrasts' | 'busyStates'>>;
+/** Whether a render issue says a whole part did not draw. */
+export declare const isPartUndrawn: (issue: RenderIssue) => boolean;
+/** Whether a render issue says one state of a part did not draw. */
+export declare const isStateUndrawn: (issue: RenderIssue) => boolean;
+/** The parts of a product whose control states the completeness check draws, of `parts` when given. */
+export declare const statefulPartsOf: (product: ResolvedProduct, parts: string[] | null) => string[];
 /**
- * Draws the named parts of a product as `design check --complete` does and answers their contrasts and missing
- * control states, or why they could not be drawn.
+ * The open-point findings of a drawn product: the contrasts its render `issues` found, the states its `busy` marks name, the missing control states in
+ * the `gaps` of its completeness check, and one `<part>: <why>` line per part or state the render issues say did not
+ * draw and per stateful part the completeness check could not draw.
+ */
+export declare const drawnFindingsFrom: (options: {
+    product: ResolvedProduct;
+    issues: RenderIssue[];
+    busy?: BusyState[];
+    gaps: Map<string, CompletenessGap[] | string> | null;
+    stateful: string[];
+}) => DrawnFindings & {
+    failed: string[];
+};
+/**
+ * Draws the named parts of a product as `design check` does and answers their contrasts and missing control states,
+ * or why they could not be drawn.
  */
 export declare const drawnFindingsOf: (options: {
     target: string;