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

package/src/lib/design/system/reach.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACH_STATEMENTS = exports.UNREACHABLE_RULE = exports.COVERED_RULE = void 0;
+const see_through_1 = require("./see-through");
+/** The rule a declared action or a projected region breaks when an opaque element of another subtree paints above it. */
+exports.COVERED_RULE = 'COVERED';
+/** The rule a declared action breaks when the state that draws it hides it, fades it out, shrinks it to nothing or buries it. */
+exports.UNREACHABLE_RULE = 'UNREACHABLE';
+const ACTION_SAMPLES_PER_SIDE = 3;
+const REGION_SAMPLES_PER_SIDE = 5;
+const OPAQUE = 0.95;
+const PAN_STEP = 32;
+const PAN_MAX_STEPS = 200;
+/**
+ * The statements of the reach check inside the frame script of `render-check`. They use `root`, `report` and
+ * `pathOf` of that script. Each `data-et-action` element must be shown, sized and hit by a click at some point of its
+ * unclipped box; each point where an opaque element of another subtree paints above an action, or above a projected
+ * region nested in another projected region from inside that outer region, is a cover. An action inside such a nested
+ * region is preview content and is not judged. The click pass runs before `pointer-events` is forced on for the paint pass, and the force is removed.
+ */
+exports.REACH_STATEMENTS = `
+  {
+    const floating = ${JSON.stringify(see_through_1.OVERLAY_PANE_SELECTOR + ', [role="tooltip"]')};
+    const alphaOf = (colour) => {
+      if (colour === 'transparent') return 0;
+      const slash = /\\/\\s*([\\d.]+)(%?)\\s*\\)$/.exec(colour);
+      if (slash) return parseFloat(slash[1]) / (slash[2] ? 100 : 1);
+      const rgba = /^rgba\\([^,]+,[^,]+,[^,]+,\\s*([\\d.]+)\\s*\\)$/.exec(colour);
+      return rgba ? parseFloat(rgba[1]) : 1;
+    };
+    const opacityOf = (element) => {
+      let opacity = 1;
+      for (let at = element; at; at = at.parentElement) opacity *= parseFloat(getComputedStyle(at).opacity);
+      return opacity;
+    };
+    const solid = (element) => {
+      const style = getComputedStyle(element);
+      const paints = element.matches('img, video, canvas, iframe, object, embed') || style.backgroundImage !== 'none' || alphaOf(style.backgroundColor) >= ${OPAQUE};
+      return paints && style.visibility === 'visible' && opacityOf(element) >= ${OPAQUE};
+    };
+    const layer = '[aria-modal="true"]';
+    let passive = new Set();
+    const coverOf = (hit, target, opaqueOnly, within) => {
+      if (!hit || target.contains(hit) || hit.contains(target) || hit.closest(floating) || hit.closest(layer) || !within.contains(hit)) return null;
+      if (passive.has(hit) && hit.closest('[aria-hidden="true"]')) return null;
+      const skip = hit.closest('[data-et-skip~="COVERED"]');
+      if (skip && !skip.contains(target)) return null;
+      for (let at = hit; at && !at.contains(target); at = at.parentElement) if (!opaqueOnly || solid(at)) return at;
+      return null;
+    };
+    const visibleBoxOf = (element) => {
+      const rect = element.getBoundingClientRect();
+      const box = { left: Math.max(rect.left, 0), top: Math.max(rect.top, 0), right: Math.min(rect.right, innerWidth), bottom: Math.min(rect.bottom, innerHeight) };
+      for (let at = element.parentElement; at && at !== document.documentElement; at = at.parentElement) {
+        const style = getComputedStyle(at);
+        if (style.overflowX === 'visible' && style.overflowY === 'visible') continue;
+        const clip = at.getBoundingClientRect();
+        const left = clip.left + at.clientLeft;
+        const top = clip.top + at.clientTop;
+        if (style.overflowX !== 'visible') [box.left, box.right] = [Math.max(box.left, left), Math.min(box.right, left + at.clientWidth)];
+        if (style.overflowY !== 'visible') [box.top, box.bottom] = [Math.max(box.top, top), Math.min(box.bottom, top + at.clientHeight)];
+      }
+      return box.right - box.left > 2 && box.bottom - box.top > 2 ? box : null;
+    };
+    const pointsOf = (box, perSide) => {
+      const points = [];
+      for (let x = 0; x < perSide; x++)
+        for (let y = 0; y < perSide; y++)
+          points.push([box.left + 1 + ((box.right - box.left - 2) * (x + 0.5)) / perSide, box.top + 1 + ((box.bottom - box.top - 2) * (y + 0.5)) / perSide]);
+      return points;
+    };
+    const coversOf = (target, box, perSide, opaqueOnly, within = document.documentElement) => {
+      const covers = new Map();
+      const points = pointsOf(box, perSide);
+      for (const [x, y] of points) {
+        const cover = coverOf(document.elementFromPoint(x, y), target, opaqueOnly, within);
+        if (cover) covers.set(cover, (covers.get(cover) ?? 0) + 1);
+      }
+      const hits = [...covers.values()].reduce((sum, count) => sum + count, 0);
+      const most = [...covers.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? null;
+      return { hits, total: points.length, most };
+    };
+    const labelOf = (element) => {
+      const text = (element.getAttribute('aria-label') || element.textContent || '').trim().replace(/\\s+/g, ' ');
+      const short = text.length > 32 ? text.slice(0, 31) + '…' : text;
+      return (short ? '"' + short + '" ' : '') + '(' + element.getAttribute('data-et-action') + ')';
+    };
+    const hiddenOf = (element) => {
+      let gone = null;
+      for (let at = element; at && at !== root; at = at.parentElement) {
+        if (at.hasAttribute('hidden') || at.matches('template')) return { skip: true };
+        if (!gone && getComputedStyle(at).display === 'none') gone = at;
+      }
+      if (gone) return { why: 'not displayed (display: none on ' + pathOf(gone) + ')' };
+      const style = getComputedStyle(element);
+      if (style.visibility !== 'visible') return { why: 'hidden (visibility: ' + style.visibility + ')' };
+      for (let at = element; at && at !== root; at = at.parentElement)
+        if (parseFloat(getComputedStyle(at).opacity) === 0) return { why: 'invisible (opacity 0 on ' + pathOf(at) + ')' };
+      const rect = element.getBoundingClientRect();
+      if (rect.width < 1 || rect.height < 1) return { why: 'zero-size (' + Math.round(rect.width) + 'x' + Math.round(rect.height) + ')' };
+      if (style.pointerEvents === 'none') return { why: 'not clickable (pointer-events: none)' };
+      return null;
+    };
+    const previewed = (element) => element.closest('[data-et-projected]')?.parentElement?.closest('[data-et-projected]');
+    const actions = reachableControlsOf(root, '[data-et-action]', true).filter((element) => !previewed(element));
+    const shownActions = [];
+    for (const element of actions) {
+      const hidden = hiddenOf(element);
+      if (hidden?.skip) continue;
+      if (hidden) report('${exports.UNREACHABLE_RULE}', element, labelOf(element) + ' is ' + hidden.why + ' in a state that declares it, so it can not be pressed');
+      else shownActions.push(element);
+    }
+    const force = document.createElement('style');
+    force.textContent = '* { pointer-events: auto !important; }';
+    const judge = (pose) => {
+      passive = new Set([...root.querySelectorAll('*')].filter((element) => getComputedStyle(element).pointerEvents === 'none'));
+      const sampled = [];
+      for (const element of shownActions) {
+        const box = visibleBoxOf(element);
+        if (box) sampled.push({ element, points: pointsOf(box, ${ACTION_SAMPLES_PER_SIDE}).map((point) => ({ point, click: null, cover: null })) });
+      }
+      for (const { points, element } of sampled)
+        for (const sample of points) sample.click = coverOf(document.elementFromPoint(...sample.point), element, false, document.documentElement);
+      document.head.append(force);
+      try {
+        for (const { points, element } of sampled)
+          for (const sample of points) sample.cover = coverOf(document.elementFromPoint(...sample.point), element, true, document.documentElement) ?? sample.click;
+      } finally {
+        force.remove();
+      }
+      for (const { element, points } of sampled) {
+        const counts = new Map();
+        for (const { cover } of points) if (cover) counts.set(cover, (counts.get(cover) ?? 0) + 1);
+        const hits = [...counts.values()].reduce((sum, count) => sum + count, 0);
+        if (hits === 0) continue;
+        const most = [...counts.entries()].sort((a, b) => b[1] - a[1])[0][0];
+        if (points.every(({ click }) => click)) {
+          report('${exports.UNREACHABLE_RULE}', element, labelOf(element) + ' is covered: a click at any point of it lands on ' + pathOf(most) + pose);
+          continue;
+        }
+        const under = solid(most) ? 'the opaque ' + pathOf(most) : pathOf(most) + ', which takes the click there';
+        report('${exports.COVERED_RULE}', element, labelOf(element) + ': ' + hits + ' of ' + points.length + ' points lie under ' + under + pose);
+      }
+    };
+    judge('');
+    const placesOf = (elements) => elements.map((element) => element.getBoundingClientRect()).map((rect) => [rect.left, rect.top]);
+    const wheel = (canvas, x, y) => canvas.dispatchEvent(new WheelEvent('wheel', { deltaX: x, deltaY: y, bubbles: true, cancelable: true }));
+    const canvases = new Set();
+    for (const element of shownActions)
+      for (let at = element.parentElement; at && at !== root; at = at.parentElement) {
+        const style = getComputedStyle(at);
+        if (style.overflowX !== 'visible' || style.overflowY !== 'visible') canvases.add(at);
+      }
+    for (const canvas of canvases) {
+      const inside = shownActions.filter((element) => canvas.contains(element));
+      for (const [dx, dy, way] of [[1, 0, 'right'], [-1, 0, 'left'], [0, 1, 'down'], [0, -1, 'up']]) {
+        const start = placesOf(inside);
+        for (let step = 1; step <= ${PAN_MAX_STEPS}; step++) {
+          const before = placesOf(inside).join(' ');
+          wheel(canvas, dx * ${PAN_STEP}, dy * ${PAN_STEP});
+          if (placesOf(inside).join(' ') === before) break;
+          judge(' when ' + pathOf(canvas) + ' is panned ' + step * ${PAN_STEP} + 'px ' + way);
+        }
+        const back = placesOf(inside)
+          .map(([left, top], index) => [left - start[index][0], top - start[index][1]])
+          .sort((a, b) => Math.abs(b[0]) + Math.abs(b[1]) - Math.abs(a[0]) - Math.abs(a[1]))[0];
+        if (back[0] || back[1]) wheel(canvas, back[0], back[1]);
+      }
+    }
+    document.head.append(force);
+    try {
+      for (const element of root.querySelectorAll('[data-et-projected]')) {
+        const outer = element.parentElement?.closest('[data-et-projected]');
+        if (!outer || element.closest('[inert], [aria-hidden="true"]') || element.getClientRects().length === 0) continue;
+        const box = visibleBoxOf(element);
+        if (!box) continue;
+        const covered = coversOf(element, box, ${REGION_SAMPLES_PER_SIDE}, true, outer);
+        if (covered.hits > 0)
+          report('${exports.COVERED_RULE}', element, 'the projected region "' + element.getAttribute('data-et-projected') + '": ' + covered.hits + ' of ' + covered.total + ' points lie under the opaque ' + pathOf(covered.most));
+      }
+    } finally {
+      force.remove();
+    }
+  }
+`;
+//# sourceMappingURL=reach.js.map

package/src/lib/design/system/reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/reach.ts"],"names":[],"mappings":";;;AAAA,+CAAsD;AAEtD,yHAAyH;AAC5G,QAAA,YAAY,GAAG,SAAS,CAAC;AAEtC,iIAAiI;AACpH,QAAA,gBAAgB,GAAG,aAAa,CAAC;AAE9C,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;;;;GAMG;AACU,QAAA,gBAAgB,GAAG;;uBAET,IAAI,CAAC,SAAS,CAAC,mCAAqB,GAAG,oBAAoB,CAAC;;;;;;;;;;;;;;;6JAe0E,MAAM;iFAClF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAuE3D,wBAAgB;;;;;;;;;;iEAUqB,uBAAuB;;;;;;;;;;;;;;;;;;oBAkBpE,wBAAgB;;;;kBAIlB,oBAAY;;;;;;;;;;;;;;;;qCAgBO,aAAa;;+BAEnB,QAAQ,UAAU,QAAQ;;qEAEY,QAAQ;;;;;;;;;;;;;;;iDAe5B,uBAAuB;;oBAEpD,oBAAY;;;;;;CAM/B,CAAC"}

package/src/lib/design/system/reachable-controls.d.ts

@@ -0,0 +1,6 @@
+/**
+ * In-page statements that define `reachableControlsOf(scope, selector, keepHidden)`: the elements of `scope` matching
+ * `selector` that a render rule may judge. Subtrees under `[inert]` or `[aria-hidden="true"]` never count; elements
+ * under `hidden` or `display: none` are dropped unless `keepHidden` is set, for rules that report them as unreachable.
+ */
+export declare const REACHABLE_CONTROLS_STATEMENTS = "\n  const reachableControlsOf = (scope, selector, keepHidden) =>\n    [...scope.querySelectorAll(selector)].filter((control) => {\n      if (control.closest('[inert], [aria-hidden=\"true\"]')) return false;\n      if (keepHidden) return true;\n      for (let at = control; at && at !== scope.parentElement; at = at.parentElement)\n        if (at.hasAttribute('hidden') || getComputedStyle(at).display === 'none') return false;\n      return true;\n    });\n";

package/src/lib/design/system/reachable-controls.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACHABLE_CONTROLS_STATEMENTS = void 0;
+/**
+ * In-page statements that define `reachableControlsOf(scope, selector, keepHidden)`: the elements of `scope` matching
+ * `selector` that a render rule may judge. Subtrees under `[inert]` or `[aria-hidden="true"]` never count; elements
+ * under `hidden` or `display: none` are dropped unless `keepHidden` is set, for rules that report them as unreachable.
+ */
+exports.REACHABLE_CONTROLS_STATEMENTS = `
+  const reachableControlsOf = (scope, selector, keepHidden) =>
+    [...scope.querySelectorAll(selector)].filter((control) => {
+      if (control.closest('[inert], [aria-hidden="true"]')) return false;
+      if (keepHidden) return true;
+      for (let at = control; at && at !== scope.parentElement; at = at.parentElement)
+        if (at.hasAttribute('hidden') || getComputedStyle(at).display === 'none') return false;
+      return true;
+    });
+`;
+//# sourceMappingURL=reachable-controls.js.map

package/src/lib/design/system/reachable-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reachable-controls.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/reachable-controls.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,6BAA6B,GAAG;;;;;;;;;CAS5C,CAAC"}

package/src/lib/design/system/reachable-files.d.ts

@@ -0,0 +1,14 @@
+import { ProductSource } from './base';
+import { SharedDirs } from './imports';
+import { ResolvedPart, ResolvedProduct } from './resolve-product';
+export declare const repoRootOf: (source: ProductSource) => string;
+/** The source file of an `@ethlete/<lib>/design[/<path>]` specifier in the repo at `root`, or `null` for any other specifier. */
+export declare const sdkDesignFileOf: (root: string, specifier: string) => string | null;
+/**
+ * The files the parts in `from` reach through relative, shared and system imports, with their
+ * sources, and the `@ethlete/<lib>/design` module files they reach. `from` defaults to every part.
+ */
+export declare const reachableFilesOf: (product: ResolvedProduct & SharedDirs, from?: ResolvedPart[]) => {
+    files: Map<string, string>;
+    sdkDesign: Map<string, string>;
+};

package/src/lib/design/system/reachable-files.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reachableFilesOf = exports.sdkDesignFileOf = exports.repoRootOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const postcss_1 = __importDefault(require("postcss"));
+const vite_paths_1 = require("../vite-paths");
+const imports_1 = require("./imports");
+const resolve_product_1 = require("./resolve-product");
+const ts_source_1 = require("./ts-source");
+const SDK_DESIGN_MODULE = /^@ethlete\/([\w-]+)\/design((?:\/[\w-]+)*)$/u;
+const repoRootOf = (source) => (0, path_1.resolve)((0, path_1.dirname)(source.configFile), '../..');
+exports.repoRootOf = repoRootOf;
+const stylesheetImportsOf = (css) => {
+    const imports = [];
+    try {
+        postcss_1.default.parse(css).walkAtRules('import', (rule) => {
+            var _a;
+            const match = /^(?:url\(\s*)?(?:['"]([^'"]+)['"]|([^'"\s)]+))/u.exec(rule.params.trim());
+            const specifier = (_a = match === null || match === void 0 ? void 0 : match[1]) !== null && _a !== void 0 ? _a : match === null || match === void 0 ? void 0 : match[2];
+            if (specifier)
+                imports.push(specifier);
+        });
+    }
+    catch (_a) {
+        return [];
+    }
+    return imports;
+};
+const relativeFileOf = (file, specifier) => {
+    var _a;
+    const path = (0, path_1.resolve)((0, path_1.dirname)(file), (_a = specifier.split('?')[0]) !== null && _a !== void 0 ? _a : specifier);
+    return path.endsWith('.css') ? ((0, fs_1.existsSync)(path) ? path : null) : (0, vite_paths_1.sourceFileOf)(path);
+};
+/** The source file of an `@ethlete/<lib>/design[/<path>]` specifier in the repo at `root`, or `null` for any other specifier. */
+const sdkDesignFileOf = (root, specifier) => {
+    var _a, _b;
+    const match = SDK_DESIGN_MODULE.exec(specifier);
+    return match ? (0, vite_paths_1.sourceFileOf)((0, path_1.resolve)(root, 'libs', (_a = match[1]) !== null && _a !== void 0 ? _a : '', `design${(_b = match[2]) !== null && _b !== void 0 ? _b : ''}`)) : null;
+};
+exports.sdkDesignFileOf = sdkDesignFileOf;
+const sdkDesignFilesOf = (root, specifiers) => {
+    const files = new Map();
+    const queue = specifiers.flatMap((specifier) => { var _a; return (_a = (0, exports.sdkDesignFileOf)(root, specifier)) !== null && _a !== void 0 ? _a : []; });
+    for (let file = queue.shift(); file !== undefined; file = queue.shift()) {
+        if (files.has(file) || !(0, fs_1.existsSync)(file))
+            continue;
+        const source = (0, fs_1.readFileSync)(file, 'utf8');
+        files.set(file, source);
+        const imports = file.endsWith('.css') ? stylesheetImportsOf(source) : (0, ts_source_1.importsOf)(source);
+        for (const specifier of imports) {
+            const found = specifier.startsWith('.') ? relativeFileOf(file, specifier) : (0, exports.sdkDesignFileOf)(root, specifier);
+            if (found && !files.has(found))
+                queue.push(found);
+        }
+    }
+    return files;
+};
+/**
+ * The files the parts in `from` reach through relative, shared and system imports, with their
+ * sources, and the `@ethlete/<lib>/design` module files they reach. `from` defaults to every part.
+ */
+const reachableFilesOf = (product, from = product.parts) => {
+    var _a, _b;
+    const parts = new Map(product.parts.map((part) => [(0, resolve_product_1.partKeyOf)(part), part]));
+    const files = new Map();
+    const packages = new Set();
+    const queue = from.flatMap((part) => [part.file, ...(part.css ? [part.css] : [])]);
+    for (let file = queue.shift(); file !== undefined; file = queue.shift()) {
+        if (files.has(file) || !(0, fs_1.existsSync)(file))
+            continue;
+        const source = (0, fs_1.readFileSync)(file, 'utf8');
+        files.set(file, source);
+        const specifiers = file.endsWith('.css') ? stylesheetImportsOf(source) : (0, ts_source_1.importsOf)(source);
+        for (const specifier of specifiers) {
+            const imported = (0, imports_1.classifyImport)(specifier);
+            let found = null;
+            if (imported.kind === 'relative') {
+                found = relativeFileOf(file, specifier);
+            }
+            else if (imported.kind === 'other') {
+                packages.add(specifier);
+            }
+            else if (imported.kind === 'shared') {
+                found = (0, imports_1.sharedFileOf)({ dirs: (0, imports_1.sharedDirsOf)(product), path: imported.path });
+            }
+            else if (imported.kind === 'part') {
+                const part = parts.get((0, resolve_product_1.partKeyOf)(imported));
+                found = imported.stylesheet ? ((_a = part === null || part === void 0 ? void 0 : part.css) !== null && _a !== void 0 ? _a : null) : ((_b = part === null || part === void 0 ? void 0 : part.file) !== null && _b !== void 0 ? _b : null);
+            }
+            if (found && !files.has(found))
+                queue.push(found);
+        }
+    }
+    return { files, sdkDesign: sdkDesignFilesOf((0, exports.repoRootOf)(product), [...packages]) };
+};
+exports.reachableFilesOf = reachableFilesOf;
+//# sourceMappingURL=reachable-files.js.map

package/src/lib/design/system/reachable-files.js.map

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

package/src/lib/design/system/reached-state.d.ts

@@ -0,0 +1,23 @@
+import { PixelCompare } from './part-compare';
+/**
+ * What an app drawing that missed `goal` reached instead: the declared state it matches exactly, or the closest one by
+ * differing pixels. `compare` compares the app drawing with one state's design; a state it fails to draw is skipped.
+ */
+export declare const reachedStateOf: (options: {
+    goal: string;
+    states: readonly string[];
+    compare: (state: string) => Promise<PixelCompare | null>;
+}) => Promise<string>;
+/**
+ * What a live page that missed `goal` reached instead, read from its `aria-expanded` controls: the declared states whose
+ * drawn controls it all shows, or the closest one by differing controls. A state that draws none is never reached.
+ */
+export declare const reachedExpandedStateOf: (options: {
+    goal: string;
+    states: readonly string[];
+    expectedOf: (state: string) => Promise<Record<string, string>>;
+    after: readonly {
+        key: string;
+        expanded: string | null;
+    }[];
+}) => Promise<string>;

package/src/lib/design/system/reached-state.js

@@ -0,0 +1,53 @@
+"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.reachedExpandedStateOf = exports.reachedStateOf = void 0;
+/**
+ * What an app drawing that missed `goal` reached instead: the declared state it matches exactly, or the closest one by
+ * differing pixels. `compare` compares the app drawing with one state's design; a state it fails to draw is skipped.
+ */
+const reachedStateOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { goal, states, compare } = options;
+    const compared = yield Promise.all(states.map((state) => __awaiter(void 0, void 0, void 0, function* () { return ({ state, result: yield compare(state).catch(() => null) }); })));
+    const exact = compared.find(({ state, result }) => state !== goal && (result === null || result === void 0 ? void 0 : result.kind) === 'ok');
+    if (exact)
+        return `reaches state ${exact.state} instead`;
+    const closest = compared
+        .flatMap(({ state, result }) => ((result === null || result === void 0 ? void 0 : result.kind) === 'diff' ? [{ state, pixels: result.pixels }] : []))
+        .sort((a, b) => a.pixels - b.pixels)[0];
+    return closest
+        ? `reaches no declared state (closest ${closest.state}, ${closest.pixels} px)`
+        : 'reaches no declared state';
+});
+exports.reachedStateOf = reachedStateOf;
+/**
+ * What a live page that missed `goal` reached instead, read from its `aria-expanded` controls: the declared states whose
+ * drawn controls it all shows, or the closest one by differing controls. A state that draws none is never reached.
+ */
+const reachedExpandedStateOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { goal, states, expectedOf, after } = options;
+    const compared = (yield Promise.all(states.map((state) => __awaiter(void 0, void 0, void 0, function* () { return ({ state, expected: yield expectedOf(state).catch(() => null) }); })))).flatMap(({ state, expected }) => {
+        const keys = Object.keys(expected !== null && expected !== void 0 ? expected : {});
+        if (!expected || keys.length === 0)
+            return [];
+        const differing = keys.filter((key) => { var _a, _b; return ((_b = (_a = after.find((control) => control.key === key)) === null || _a === void 0 ? void 0 : _a.expanded) !== null && _b !== void 0 ? _b : 'absent') !== expected[key]; }).length;
+        return [{ state, differing }];
+    });
+    const exact = compared.filter(({ state, differing }) => state !== goal && differing === 0).map(({ state }) => state);
+    if (exact.length > 0)
+        return `reaches state ${exact.join(' or ')} instead`;
+    const closest = compared.sort((a, b) => a.differing - b.differing)[0];
+    return closest
+        ? `reaches no declared state (closest ${closest.state}, ${closest.differing} control${closest.differing === 1 ? ' differs' : 's differ'})`
+        : 'reaches no declared state';
+});
+exports.reachedExpandedStateOf = reachedExpandedStateOf;
+//# sourceMappingURL=reached-state.js.map

package/src/lib/design/system/reached-state.js.map

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

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

@@ -0,0 +1,33 @@
+import { CompletenessGap } from './complete';
+import { OpenPoint, OpenPointsInput, PartOpenPoints } from './open-points';
+import { RenderIssue } from './render-check';
+import { ResolvedProduct } from './resolve-product';
+/**
+ * The open points of every part of a product, read from its part files, comments and sketches, plus the
+ * `rendered` findings of a check that drew the parts.
+ */
+export declare const readOpenPoints: (product: ResolvedProduct, rendered?: Pick<OpenPointsInput, "missingStates" | "contrasts" | "busyStates">) => PartOpenPoints[];
+/** The points of one part, or none when it has no open point. */
+export declare const partPointsOf: (list: PartOpenPoints[], part: string) => OpenPoint[];
+/** The `CONTRAST` findings of a render check, once per part, state and path. */
+export declare const contrastsOf: (issues: RenderIssue[]) => NonNullable<OpenPointsInput["contrasts"]>;
+/** The controls of each part that lack a drawn state, from the gaps of a completeness check. */
+export declare const missingStatesOf: (gaps: Map<string, CompletenessGap[] | string>) => NonNullable<OpenPointsInput["missingStates"]>;
+/**
+ * The open points of `targets` as a sketch variant draws them, of the kinds the sketch closes itself, split into the
+ * ones the variant adds to the merged parts and the ones it inherits from them. `busy` names the drawn states of each
+ * side whose render shows ongoing work.
+ */
+export declare const sketchOpenPointsOf: ({ merged, variant, targets, busy, }: {
+    merged: ResolvedProduct;
+    variant: ResolvedProduct;
+    targets: string[];
+    busy?: Record<"merged" | "variant", NonNullable<OpenPointsInput["busyStates"]>>;
+}) => {
+    added: PartOpenPoints[];
+    inherited: PartOpenPoints[];
+};
+/** The own parts outside `foundations/` that have no `implements` link; parts from the base product are left out. */
+export declare const unlinkedPartsOf: (product: ResolvedProduct) => string[];
+/** One line per part of `targets` that declares instant state switches, with its reason. */
+export declare const instantLinesOf: (product: ResolvedProduct, targets: string[]) => string[];

package/src/lib/design/system/read-open-points.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instantLinesOf = exports.unlinkedPartsOf = exports.sketchOpenPointsOf = exports.missingStatesOf = exports.contrastsOf = exports.partPointsOf = exports.readOpenPoints = void 0;
+const comment_1 = require("./comments/comment");
+const complete_1 = require("./complete");
+const open_points_1 = require("./open-points");
+const resolve_product_1 = require("./resolve-product");
+const part_definition_1 = require("./sketch/part-definition");
+const merged_parts_1 = require("./sketch/merged-parts");
+const sketch_1 = require("./sketch/sketch");
+const isPair = (pair) => pair.from !== null && pair.to !== null;
+const motionOf = (source) => {
+    var _a;
+    const states = (0, part_definition_1.stateNamesOf)(source);
+    if (!states)
+        return {};
+    return {
+        motion: {
+            states,
+            motions: (0, part_definition_1.motionRefsOf)(source).motions.filter(isPair),
+            unreachable: ((_a = (0, part_definition_1.unreachableOf)(source)) !== null && _a !== void 0 ? _a : []).filter((pair) => { var _a; return !!((_a = pair.reason) === null || _a === void 0 ? void 0 : _a.trim()); }).filter(isPair),
+            instant: (0, part_definition_1.instantOf)(source).kind === 'declared',
+        },
+    };
+};
+const partInputsOf = (product) => product.parts.map((part) => (Object.assign({ key: (0, resolve_product_1.partKeyOf)(part), layer: part.layer, controls: (0, part_definition_1.declaresControlsOf)(part.source), declaredNoControls: (0, part_definition_1.declaresNoControlsOf)(part.source) }, motionOf(part.source))));
+/**
+ * The open points of every part of a product, read from its part files, comments and sketches, plus the
+ * `rendered` findings of a check that drew the parts.
+ */
+const readOpenPoints = (product, rendered = {}) => {
+    const source = { productDir: product.dir, product: product.name };
+    const directEdits = (0, merged_parts_1.directEditsOf)(product);
+    const editSketches = new Set(directEdits.flatMap(({ sketch }) => (sketch ? [sketch] : [])));
+    return (0, open_points_1.openPointsOf)(Object.assign({ parts: partInputsOf(product), comments: (0, comment_1.listComments)(Object.assign(Object.assign({}, source), { all: true })).comments.map((comment) => ({
+            id: comment.id,
+            part: comment.part,
+            state: comment.state,
+            answered: comment.addressed !== undefined,
+            resolved: comment.resolved !== undefined,
+        })), sketches: (0, sketch_1.listSketches)(source).flatMap((sketch) => {
+            var _a, _b;
+            return typeof sketch === 'string' || editSketches.has(sketch.target)
+                ? []
+                : [
+                    {
+                        name: sketch.name,
+                        target: sketch.target,
+                        targets: sketch.targets,
+                        status: sketch.status,
+                        decision: (_b = (_a = sketch.decision) === null || _a === void 0 ? void 0 : _a.kind) !== null && _b !== void 0 ? _b : null,
+                    },
+                ];
+        }), directEdits }, rendered));
+};
+exports.readOpenPoints = readOpenPoints;
+/** The points of one part, or none when it has no open point. */
+const partPointsOf = (list, part) => { var _a, _b; return (_b = (_a = list.find((entry) => entry.part === part)) === null || _a === void 0 ? void 0 : _a.points) !== null && _b !== void 0 ? _b : []; };
+exports.partPointsOf = partPointsOf;
+/** The `CONTRAST` findings of a render check, once per part, state and path. */
+const contrastsOf = (issues) => {
+    const seen = new Set();
+    return issues.flatMap(({ rule, part, state, path }) => {
+        const key = `${part} ${state} ${path}`;
+        if (rule !== 'CONTRAST' || seen.has(key))
+            return [];
+        seen.add(key);
+        return [{ part, state, path }];
+    });
+};
+exports.contrastsOf = contrastsOf;
+/** The controls of each part that lack a drawn state, from the gaps of a completeness check. */
+const missingStatesOf = (gaps) => [...gaps].flatMap(([part, found]) => typeof found === 'string'
+    ? []
+    : [...new Set(found.filter(complete_1.isMissingStateGap).map((gap) => gap.target.slice(part.length + 1)))].map((control) => ({ part, control })));
+exports.missingStatesOf = missingStatesOf;
+/**
+ * The open points of `targets` as a sketch variant draws them, of the kinds the sketch closes itself, split into the
+ * ones the variant adds to the merged parts and the ones it inherits from them. `busy` names the drawn states of each
+ * side whose render shows ongoing work.
+ */
+const sketchOpenPointsOf = ({ merged, variant, targets, busy = { merged: [], variant: [] }, }) => {
+    const ownOf = (product, busyStates) => (0, open_points_1.openPointsOf)({
+        parts: partInputsOf(product).filter((part) => targets.includes(part.key)),
+        comments: [],
+        sketches: [],
+        busyStates,
+    }).flatMap(({ part, points }) => {
+        const own = points.filter((point) => open_points_1.SKETCH_KINDS.includes(point.kind));
+        return own.length > 0 ? [{ part, points: own }] : [];
+    });
+    return (0, open_points_1.sketchAddedPointsOf)(ownOf(merged, busy.merged), ownOf(variant, busy.variant));
+};
+exports.sketchOpenPointsOf = sketchOpenPointsOf;
+/** The own parts outside `foundations/` that have no `implements` link; parts from the base product are left out. */
+const unlinkedPartsOf = (product) => product.parts
+    .filter((part) => part.origin !== 'base' && part.layer !== 'foundations' && (0, part_definition_1.partLinkOf)(part.source).kind === 'none')
+    .map(resolve_product_1.partKeyOf);
+exports.unlinkedPartsOf = unlinkedPartsOf;
+/** One line per part of `targets` that declares instant state switches, with its reason. */
+const instantLinesOf = (product, targets) => product.parts
+    .filter((part) => targets.includes((0, resolve_product_1.partKeyOf)(part)))
+    .flatMap((part) => {
+    const instant = (0, part_definition_1.instantOf)(part.source);
+    return instant.kind === 'declared'
+        ? [`${(0, resolve_product_1.partKeyOf)(part)} declares instant state switches (no motion between its states): ${instant.reason}`]
+        : [];
+});
+exports.instantLinesOf = instantLinesOf;
+//# sourceMappingURL=read-open-points.js.map

package/src/lib/design/system/read-open-points.js.map

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

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

@@ -0,0 +1,11 @@
+export declare const READY_USAGE = "ready <layer>/<name> --product <name> [--url <app dev server url>]";
+/**
+ * `et design ready <layer>/<name> …` checks a part and writes its check record, and exits 1 with its open points, its
+ * other blockers or its failed `design actions` lines while it has any. It runs the slow rules of the part first when
+ * their result is missing or stale.
+ */
+export declare const designReady: (options: {
+    target: string;
+    argv: string[];
+    invocation: string;
+}) => Promise<0 | 1 | 2>;