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

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

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appFilesOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const typescript_1 = __importDefault(require("typescript"));
+const vite_paths_1 = require("../vite-paths");
+const design_hash_1 = require("./design-hash");
+const ts_source_1 = require("./ts-source");
+const pathsOf = (root) => {
+    var _a, _b;
+    const file = (0, path_1.resolve)(root, 'tsconfig.base.json');
+    if (!(0, fs_1.existsSync)(file))
+        return {};
+    const parsed = typescript_1.default.parseConfigFileTextToJson(file, (0, fs_1.readFileSync)(file, 'utf8')).config;
+    return (_b = (_a = parsed === null || parsed === void 0 ? void 0 : parsed.compilerOptions) === null || _a === void 0 ? void 0 : _a.paths) !== null && _b !== void 0 ? _b : {};
+};
+const mappedFileOf = (options) => {
+    const { root, paths, specifier } = options;
+    for (const [pattern, targets] of Object.entries(paths)) {
+        const star = pattern.indexOf('*');
+        const matched = star === -1
+            ? pattern === specifier
+                ? ''
+                : null
+            : specifier.startsWith(pattern.slice(0, star)) && specifier.endsWith(pattern.slice(star + 1))
+                ? specifier.slice(star, specifier.length - (pattern.length - star - 1))
+                : null;
+        if (matched === null)
+            continue;
+        for (const target of targets) {
+            const found = (0, vite_paths_1.sourceFileOf)((0, path_1.resolve)(root, target.replace('*', matched)).replace(/\.ts$/u, ''));
+            if (found)
+                return found;
+        }
+    }
+    return null;
+};
+const ownedResourcesOf = (file, source) => /\b(?:styleUrls?|templateUrl)\s*:/u.test(source)
+    ? (0, ts_source_1.textsOf)(source)
+        .filter((text) => /^\.{1,2}\/[^\s'"]+\.(?:css|html)$/u.test(text))
+        .map((text) => (0, path_1.resolve)((0, path_1.dirname)(file), text))
+    : [];
+const reExportsOf = (source) => (0, ts_source_1.sourceFileOf)(source).statements.flatMap((statement) => {
+    if (!typescript_1.default.isExportDeclaration(statement) || !statement.moduleSpecifier)
+        return [];
+    if (!typescript_1.default.isStringLiteral(statement.moduleSpecifier))
+        return [];
+    const clause = statement.exportClause;
+    const names = !clause
+        ? null
+        : typescript_1.default.isNamedExports(clause)
+            ? clause.elements.map((element) => {
+                var _a;
+                return ({
+                    exported: element.name.text,
+                    local: ((_a = element.propertyName) !== null && _a !== void 0 ? _a : element.name).text,
+                });
+            })
+            : [{ exported: clause.name.text, local: '*' }];
+    return [{ specifier: statement.moduleSpecifier.text, names }];
+});
+const stampOf = (file) => {
+    try {
+        return (0, fs_1.statSync)(file).mtimeMs;
+    }
+    catch (_a) {
+        return -1;
+    }
+};
+const reached = new Map();
+const reachedFilesOf = (options) => {
+    const { root } = options;
+    const paths = pathsOf(root);
+    const sources = new Map();
+    const read = (file) => {
+        const known = sources.get(file);
+        if (known !== undefined)
+            return known;
+        const source = (0, fs_1.existsSync)(file) ? (0, fs_1.readFileSync)(file, 'utf8') : '';
+        sources.set(file, source);
+        return source;
+    };
+    const targetOf = (from, specifier) => specifier.startsWith('.')
+        ? (0, vite_paths_1.sourceFileOf)((0, path_1.resolve)((0, path_1.dirname)(from), specifier))
+        : mappedFileOf({ root, paths, specifier });
+    const declaringFilesOf = (at, seen) => {
+        var _a;
+        const { file, name } = at;
+        const key = `${file}\0${name}`;
+        if (seen.has(key))
+            return [];
+        seen.add(key);
+        const source = read(file);
+        const reExports = reExportsOf(source);
+        const forwarded = new Set(reExports.flatMap(({ names }) => (names !== null && names !== void 0 ? names : []).map(({ exported }) => exported)));
+        if ((0, ts_source_1.exportedNamesOf)(source).some((exported) => exported === name && !forwarded.has(exported)))
+            return [file];
+        for (const { specifier, names } of reExports) {
+            const target = targetOf(file, specifier);
+            const local = names === null ? name : (_a = names.find((entry) => entry.exported === name)) === null || _a === void 0 ? void 0 : _a.local;
+            if (!target || local === undefined)
+                continue;
+            if (local === '*')
+                return [target];
+            const found = declaringFilesOf({ file: target, name: local }, seen);
+            if (found.length > 0)
+                return found;
+        }
+        return [];
+    };
+    const filesOfName = (file, name) => {
+        const found = declaringFilesOf({ file, name }, new Set());
+        return found.length > 0 || (0, ts_source_1.sourceFileOf)(read(file)).statements.every(typescript_1.default.isExportDeclaration) ? found : [file];
+    };
+    const files = new Set();
+    const queue = [(0, path_1.resolve)(root, options.component)];
+    for (let file = queue.shift(); file !== undefined; file = queue.shift()) {
+        if (files.has(file) || !(0, fs_1.existsSync)(file))
+            continue;
+        files.add(file);
+        if (!file.endsWith('.ts'))
+            continue;
+        const source = read(file);
+        queue.push(...ownedResourcesOf(file, source));
+        for (const [specifier, names] of (0, ts_source_1.importedNamesOf)(source)) {
+            const target = targetOf(file, specifier);
+            if (!target)
+                continue;
+            if (names.has('*')) {
+                queue.push(target);
+                continue;
+            }
+            for (const name of names)
+                queue.push(...filesOfName(target, name));
+        }
+    }
+    return [...files];
+};
+/**
+ * The files of a repository an Angular component reaches: relative imports, `templateUrl` and `styleUrl` files, and
+ * for an import through a `tsconfig.base.json` path (an `@ethlete/<lib>` entry point) or a barrel, only the files that
+ * declare the imported names, not the whole barrel. Each reached file adds its own imports the same way.
+ */
+const appFilesOf = (options) => {
+    const key = `${options.root}\0${options.component}`;
+    const known = reached.get(key);
+    if (known && known.stamps.every(([file, stamp]) => stampOf(file) === stamp))
+        return known.hashes;
+    const files = reachedFilesOf(options);
+    const hashes = (0, design_hash_1.fileHashesOf)(options.root, files);
+    reached.set(key, { stamps: files.map((file) => [file, stampOf(file)]), hashes });
+    return hashes;
+};
+exports.appFilesOf = appFilesOf;
+//# sourceMappingURL=app-files.js.map

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

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

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

@@ -0,0 +1,30 @@
+import { DesignConfig } from '../paths';
+import { Problem } from './problem';
+import { ResolvedProduct } from './resolve-product';
+export type BespokeControl = {
+    id: string;
+    why: string;
+};
+/**
+ * Browser source of `({ root, part, ids }) => BespokeControl[]`: why each control of `ids` that `part` draws itself
+ * under `root` is no SDK component used through its props - an element with no `et-` class, `et-` classes mixed with
+ * custom ones, or custom-classed content outside icons and embedded parts.
+ */
+export declare const BESPOKE_CONTROLS_IN = "(({ root, part, ids }) => {\n  const partsOf = (element) => (element.getAttribute('data-et-part') ?? '').split(' ');\n  const customOf = (element) => [...element.classList].filter((name) => !name.startsWith('et-'));\n  const isOwn = (element) => {\n    const owner = element.closest('[data-et-part]');\n    return owner === null || partsOf(owner).includes(part);\n  };\n  const contentOf = (element) =>\n    [...element.children].flatMap((child) =>\n      child.hasAttribute('data-et-part') || child.localName === 'svg' ? [] : [child, ...contentOf(child)],\n    );\n  const describe = (element) => element.localName + customOf(element).map((name) => '.' + name).join('');\n  const found = [];\n  for (const id of ids) {\n    const element = [...root.querySelectorAll('[data-et-control=\"' + id + '\"]')].find(isOwn);\n    if (!element || (element.hasAttribute('data-et-part') && !partsOf(element).includes(part))) continue;\n    const custom = customOf(element);\n    const styled = contentOf(element).filter((child) => customOf(child).length > 0);\n    if (![...element.classList].some((name) => name.startsWith('et-')))\n      found.push({ id, why: 'is drawn markup (' + describe(element) + '), no SDK component' });\n    else if (custom.length > 0)\n      found.push({ id, why: 'is an SDK component with the custom class' + (custom.length > 1 ? 'es ' : ' ') + custom.join(' ') });\n    else if (styled.length > 0)\n      found.push({ id, why: 'is an SDK component with drawn content (' + styled.map(describe).join(', ') + ')' });\n  }\n  return found;\n})";
+/** The own controls of a part to check: none on a page or a part with one control, which may draw its own. */
+export declare const composedControlsOf: (options: {
+    part: string;
+    controls: unknown;
+    states: string[];
+}) => string[];
+export declare const bespokeControlMessageOf: (part: string, { id, why }: BespokeControl) => string;
+/**
+ * `CONTROL-STATE` for each control a part with several controls and interaction states draws as its own markup, read
+ * from the drawn states until every own control was seen.
+ */
+export declare const bespokeControlProblemsOf: (options: {
+    target: string;
+    config: DesignConfig;
+    product: ResolvedProduct;
+    part?: string;
+}) => Promise<Problem[]>;

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

@@ -0,0 +1,147 @@
+"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.bespokeControlProblemsOf = exports.bespokeControlMessageOf = exports.composedControlsOf = exports.BESPOKE_CONTROLS_IN = void 0;
+const browser_1 = require("../browser");
+const serve_1 = require("../serve");
+const shot_1 = require("../shot");
+const thumb_1 = require("../thumb");
+const compare_command_1 = require("./compare-command");
+const complete_1 = require("./complete");
+const resolve_product_1 = require("./resolve-product");
+const system_modules_1 = require("./system-modules");
+/**
+ * Browser source of `({ root, part, ids }) => BespokeControl[]`: why each control of `ids` that `part` draws itself
+ * under `root` is no SDK component used through its props - an element with no `et-` class, `et-` classes mixed with
+ * custom ones, or custom-classed content outside icons and embedded parts.
+ */
+exports.BESPOKE_CONTROLS_IN = `(({ root, part, ids }) => {
+  const partsOf = (element) => (element.getAttribute('data-et-part') ?? '').split(' ');
+  const customOf = (element) => [...element.classList].filter((name) => !name.startsWith('et-'));
+  const isOwn = (element) => {
+    const owner = element.closest('[data-et-part]');
+    return owner === null || partsOf(owner).includes(part);
+  };
+  const contentOf = (element) =>
+    [...element.children].flatMap((child) =>
+      child.hasAttribute('data-et-part') || child.localName === 'svg' ? [] : [child, ...contentOf(child)],
+    );
+  const describe = (element) => element.localName + customOf(element).map((name) => '.' + name).join('');
+  const found = [];
+  for (const id of ids) {
+    const element = [...root.querySelectorAll('[data-et-control="' + id + '"]')].find(isOwn);
+    if (!element || (element.hasAttribute('data-et-part') && !partsOf(element).includes(part))) continue;
+    const custom = customOf(element);
+    const styled = contentOf(element).filter((child) => customOf(child).length > 0);
+    if (![...element.classList].some((name) => name.startsWith('et-')))
+      found.push({ id, why: 'is drawn markup (' + describe(element) + '), no SDK component' });
+    else if (custom.length > 0)
+      found.push({ id, why: 'is an SDK component with the custom class' + (custom.length > 1 ? 'es ' : ' ') + custom.join(' ') });
+    else if (styled.length > 0)
+      found.push({ id, why: 'is an SDK component with drawn content (' + styled.map(describe).join(', ') + ')' });
+  }
+  return found;
+})`;
+/** The own controls of a part to check: none on a page or a part with one control, which may draw its own. */
+const composedControlsOf = (options) => {
+    var _a;
+    const declared = Object.entries((_a = (0, complete_1.declaredControlsOf)(options.controls)) !== null && _a !== void 0 ? _a : {});
+    if (options.part.startsWith('pages/') || declared.length < 2 || !options.states.some(complete_1.isInteractionState))
+        return [];
+    return declared.filter(([, control]) => control.part === null).map(([id]) => id);
+};
+exports.composedControlsOf = composedControlsOf;
+const bespokeControlMessageOf = (part, { id, why }) => `control "${id}" ${why} - ${part} declares several controls, and a declared control counts for its interaction states only as an embedded part or an SDK component used through its props - extract ${id} as its own control part and draw its states there`;
+exports.bespokeControlMessageOf = bespokeControlMessageOf;
+/**
+ * `CONTROL-STATE` for each control a part with several controls and interaction states draws as its own markup, read
+ * from the drawn states until every own control was seen.
+ */
+const bespokeControlProblemsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    const { target, config, product } = options;
+    const own = product.parts.filter((part) => part.origin !== 'base' && (!options.part || (0, resolve_product_1.partKeyOf)(part) === options.part));
+    if (own.length === 0 || !(yield (0, browser_1.chromiumOf)(target)))
+        return [];
+    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 } = (_a = server.httpServer) === null || _a === void 0 ? void 0 : _a.address();
+        const partShooter = (shooter = (0, shot_1.createPartShooter)({
+            target,
+            base: `http://localhost:${port}`,
+            system: (0, system_modules_1.createSystemModules)({ target, config }),
+            queue,
+        }));
+        const problems = [];
+        for (const part of own) {
+            const key = (0, resolve_product_1.partKeyOf)(part);
+            const module = (yield server
+                .ssrLoadModule((0, system_modules_1.productModuleIdOf)({ file: part.file, product: product.name }))
+                .catch(() => null));
+            const loaded = (_b = module === null || module === void 0 ? void 0 : module.default) === null || _b === void 0 ? void 0 : _b.states;
+            const states = loaded && typeof loaded === 'object' && !Array.isArray(loaded) ? Object.keys(loaded) : [];
+            const ids = (0, exports.composedControlsOf)({ part: key, controls: (_c = module === null || module === void 0 ? void 0 : module.default) === null || _c === void 0 ? void 0 : _c.controls, states });
+            const frame = (0, compare_command_1.compareFrameOf)({ presets: product.presets, part: key, preset: null });
+            if (ids.length === 0 || typeof frame === 'string')
+                continue;
+            const unseen = new Set(ids);
+            const found = [];
+            for (const state of states) {
+                if (unseen.size === 0)
+                    break;
+                const { markup } = yield partShooter.pictureOf({
+                    product: product.name,
+                    part: key,
+                    state,
+                    preset: frame.preset,
+                    width: null,
+                    sketch: null,
+                    interaction: null,
+                    bare: true,
+                    emptySlots: true,
+                    checker: false,
+                    params: new URLSearchParams(),
+                });
+                if (markup === undefined)
+                    continue;
+                const drawn = yield queue.run((browser) => __awaiter(void 0, void 0, void 0, function* () {
+                    const page = yield browser.newPage();
+                    try {
+                        return (yield page.evaluate(`(() => {
+                const body = new DOMParser().parseFromString(${JSON.stringify(markup)}, 'text/html').body;
+                const seen = [...body.querySelectorAll('[data-et-control]')].map((element) => element.getAttribute('data-et-control'));
+                return { found: ${exports.BESPOKE_CONTROLS_IN}({ root: body, part: ${JSON.stringify(key)}, ids: ${JSON.stringify([...unseen])} }), seen };
+              })()`));
+                    }
+                    finally {
+                        yield page.close();
+                    }
+                }));
+                found.push(...drawn.found);
+                for (const id of drawn.seen)
+                    unseen.delete(id);
+            }
+            for (const control of found)
+                problems.push({ rule: 'CONTROL-STATE', file: part.file, message: (0, exports.bespokeControlMessageOf)(key, control) });
+        }
+        return problems;
+    }
+    finally {
+        yield (shooter === null || shooter === void 0 ? void 0 : shooter.close());
+        yield queue.close();
+        yield server.close();
+    }
+});
+exports.bespokeControlProblemsOf = bespokeControlProblemsOf;
+//# sourceMappingURL=bespoke-controls.js.map

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

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

package/src/lib/design/system/build-ready-contract.d.ts

@@ -0,0 +1,27 @@
+import { Problem } from './problem';
+import { ResolvedProduct } from './resolve-product';
+export type BlockerKind = 'stale-record' | 'open-point' | 'action' | 'embedded' | 'problem' | 'compare' | 'sdk-error' | 'pending';
+/** One reason a part is not build-ready; `part` names the embedded part it comes from, if any. */
+export type Blocker = {
+    kind: BlockerKind;
+    text: string;
+    part?: string;
+};
+/** Whether a part may be built now, or every blocker that keeps it from that. */
+export type BuildReady = {
+    ready: true;
+} | {
+    ready: false;
+    blockers: Blocker[];
+};
+/** The slow-rule problems of a part from the last slow run, or `'pending'` while that result is missing or stale. */
+export type SlowProblemsOf = (options: {
+    product: ResolvedProduct;
+    part: string;
+}) => Problem[] | 'pending';
+/** The rule of a slow problem from `design compare`; it blocks as `compare`. */
+export declare const COMPARE_RULE = "COMPARE";
+/** The rule of a slow problem from the harness SDK-error watch; it blocks as `sdk-error`. */
+export declare const SDK_ERROR_RULE = "SDK-ERROR";
+export declare const blockerKindOfRule: (rule: string) => BlockerKind;
+export { slowProblemsOf } from './slow-checks';

package/src/lib/design/system/build-ready-contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slowProblemsOf = exports.blockerKindOfRule = exports.SDK_ERROR_RULE = exports.COMPARE_RULE = void 0;
+/** The rule of a slow problem from `design compare`; it blocks as `compare`. */
+exports.COMPARE_RULE = 'COMPARE';
+/** The rule of a slow problem from the harness SDK-error watch; it blocks as `sdk-error`. */
+exports.SDK_ERROR_RULE = 'SDK-ERROR';
+const blockerKindOfRule = (rule) => rule === exports.COMPARE_RULE ? 'compare' : rule === exports.SDK_ERROR_RULE ? 'sdk-error' : 'problem';
+exports.blockerKindOfRule = blockerKindOfRule;
+var slow_checks_1 = require("./slow-checks");
+Object.defineProperty(exports, "slowProblemsOf", { enumerable: true, get: function () { return slow_checks_1.slowProblemsOf; } });
+//# sourceMappingURL=build-ready-contract.js.map

package/src/lib/design/system/build-ready-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ready-contract.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/build-ready-contract.ts"],"names":[],"mappings":";;;AAeA,gFAAgF;AACnE,QAAA,YAAY,GAAG,SAAS,CAAC;AAEtC,6FAA6F;AAChF,QAAA,cAAc,GAAG,WAAW,CAAC;AAEnC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAe,EAAE,CAC7D,IAAI,KAAK,oBAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAD3E,QAAA,iBAAiB,qBAC0D;AAExF,6CAA+C;AAAtC,6GAAA,cAAc,OAAA"}

package/src/lib/design/system/check-rules.d.ts

@@ -0,0 +1 @@
+export declare const CHECK_RULES: readonly ["ACTION-LOST", "ACTION-UNDECLARED", "APP-SPEC", "CANONICAL-CLASS", "CAPABILITY-PLACE", "CLASS-GLUED-INTERPOLATION", "CLASS-UNDEFINED", "COMPONENT-COPY", "CONTROL-GRID-MISSING", "CONTROL-KIND", "CONTROL-OVERRIDDEN", "CONTROL-PART-INCOMPLETE", "CONTROL-PART-INPUT", "CONTROL-PART-MISSING", "CONTROL-STATE", "CONTROL-TRANSITION-MISSING", "CONTROL-UNCLASSIFIED", "CONTROL-UNDECLARED", "CONTROL-UNDRAWN", "CONTROL-UNKNOWN", "CUT-CONTROL", "DEMO-BACKDROP", "DENIED-CLASS", "DENIED-CLASS-CONFIG", "DENIED-STYLESHEET", "DISABLED-INTERACTION", "DROPPED-PROP", "EMBED-SCALE", "GRID-COVERAGE", "HARD-CODED-COLOUR", "HARD-CODED-MOTION", "IMPLEMENTS-MISSING", "IMPLEMENTS-SHAPE", "INLINE-SVG", "INLINE-UI-IN-PAGE", "INVENTORY-UNAPPROVED", "LOST-SURFACE", "MOTION-INSTANT", "MOTION-NAME", "MOTION-STATE", "MOTION-UNREACHABLE-LITERAL", "MOTION-UNREACHABLE-REASON", "MOTION-UNREACHABLE-STATE", "NATIVE-TITLE", "NESTED-SCROLL", "NESTED-SURFACE", "OPTION-OMITS-LITERAL", "OPTION-OMITS-REASON", "OPTION-OMITS-VALUE", "OPTION-VALUE-MISSING", "ORPHAN-ENDPOINT", "PART-REWRITE", "RENDER-TIMEOUT", "REQUIREMENT-MISSING", "SAMPLE-DEFAULT", "SEE-THROUGH", "SKETCH-BASE-STALE", "SKIP-SCOPE", "STALE-REPLACE", "STATE-NOT-IN-COMPONENT", "SVG-ASSET", "TOKEN-SELECTOR", "TOP-LEVEL-AWAIT", "TYPE-ERROR", "UNBOUND-INPUT", "UNDEFINED-CLASS", "UNCOVERED-REGION", "UNDEFINED-TOKEN", "UNKNOWN-THEME", "UNSTYLED-SDK", "UNUSED-EXPORT", "UPWARD-DEPENDENCY", "UTILITY-CSS", "VISIBLE-CHANGE", "WIREFRAME-KIT", "ZERO-SIZE"];

package/src/lib/design/system/check-rules.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECK_RULES = void 0;
+exports.CHECK_RULES = [
+    'ACTION-LOST',
+    'ACTION-UNDECLARED',
+    'APP-SPEC',
+    'CANONICAL-CLASS',
+    'CAPABILITY-PLACE',
+    'CLASS-GLUED-INTERPOLATION',
+    'CLASS-UNDEFINED',
+    'COMPONENT-COPY',
+    'CONTROL-GRID-MISSING',
+    'CONTROL-KIND',
+    'CONTROL-OVERRIDDEN',
+    'CONTROL-PART-INCOMPLETE',
+    'CONTROL-PART-INPUT',
+    'CONTROL-PART-MISSING',
+    'CONTROL-STATE',
+    'CONTROL-TRANSITION-MISSING',
+    'CONTROL-UNCLASSIFIED',
+    'CONTROL-UNDECLARED',
+    'CONTROL-UNDRAWN',
+    'CONTROL-UNKNOWN',
+    'CUT-CONTROL',
+    'DEMO-BACKDROP',
+    'DENIED-CLASS',
+    'DENIED-CLASS-CONFIG',
+    'DENIED-STYLESHEET',
+    'DISABLED-INTERACTION',
+    'DROPPED-PROP',
+    'EMBED-SCALE',
+    'GRID-COVERAGE',
+    'HARD-CODED-COLOUR',
+    'HARD-CODED-MOTION',
+    'IMPLEMENTS-MISSING',
+    'IMPLEMENTS-SHAPE',
+    'INLINE-SVG',
+    'INLINE-UI-IN-PAGE',
+    'INVENTORY-UNAPPROVED',
+    'LOST-SURFACE',
+    'MOTION-INSTANT',
+    'MOTION-NAME',
+    'MOTION-STATE',
+    'MOTION-UNREACHABLE-LITERAL',
+    'MOTION-UNREACHABLE-REASON',
+    'MOTION-UNREACHABLE-STATE',
+    'NATIVE-TITLE',
+    'NESTED-SCROLL',
+    'NESTED-SURFACE',
+    'OPTION-OMITS-LITERAL',
+    'OPTION-OMITS-REASON',
+    'OPTION-OMITS-VALUE',
+    'OPTION-VALUE-MISSING',
+    'ORPHAN-ENDPOINT',
+    'PART-REWRITE',
+    'RENDER-TIMEOUT',
+    'REQUIREMENT-MISSING',
+    'SAMPLE-DEFAULT',
+    'SEE-THROUGH',
+    'SKETCH-BASE-STALE',
+    'SKIP-SCOPE',
+    'STALE-REPLACE',
+    'STATE-NOT-IN-COMPONENT',
+    'SVG-ASSET',
+    'TOKEN-SELECTOR',
+    'TOP-LEVEL-AWAIT',
+    'TYPE-ERROR',
+    'UNBOUND-INPUT',
+    'UNDEFINED-CLASS',
+    'UNCOVERED-REGION',
+    'UNDEFINED-TOKEN',
+    'UNKNOWN-THEME',
+    'UNSTYLED-SDK',
+    'UNUSED-EXPORT',
+    'UPWARD-DEPENDENCY',
+    'UTILITY-CSS',
+    'VISIBLE-CHANGE',
+    'WIREFRAME-KIT',
+    'ZERO-SIZE',
+];
+//# sourceMappingURL=check-rules.js.map

package/src/lib/design/system/check-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-rules.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/check-rules.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,aAAa;IACb,mBAAmB;IACnB,UAAU;IACV,iBAAiB;IACjB,kBAAkB;IAClB,2BAA2B;IAC3B,iBAAiB;IACjB,gBAAgB;IAChB,sBAAsB;IACtB,cAAc;IACd,oBAAoB;IACpB,yBAAyB;IACzB,oBAAoB;IACpB,sBAAsB;IACtB,eAAe;IACf,4BAA4B;IAC5B,sBAAsB;IACtB,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,cAAc;IACd,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;IACtB,cAAc;IACd,aAAa;IACb,eAAe;IACf,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;IACnB,sBAAsB;IACtB,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,4BAA4B;IAC5B,2BAA2B;IAC3B,0BAA0B;IAC1B,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;IACb,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,wBAAwB;IACxB,WAAW;IACX,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,WAAW;CACH,CAAC"}

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

@@ -1,27 +1,82 @@
+import { chromiumOf } from '../browser';
 import { DesignConfig } from '../paths';
+import { DrawStates } from './accepted-pictures';
+import { PartOpenPoints } from './open-points';
+import { BuildReadyInputs } from './part-build-ready';
 import { Problem } from './problem';
 import { ResolvedProduct } from './resolve-product';
+export declare const warningProblemsOf: (product: ResolvedProduct) => Problem[];
 export declare const ruleLinesOf: (target: string, product: ResolvedProduct) => string[];
+/** Runs only the static rules of `products` - no draw, no tsc - and prints each problem a product's own files hold; exits 1 on one. */
+export declare const checkRules: (options: {
+    target: string;
+    config: DesignConfig;
+    products: string[];
+}) => 0 | 1;
 /** Every problem the rules find in a resolved product, its resolution problems first. */
 export declare const ruleProblemsOf: (product: ResolvedProduct) => Problem[];
+/** Build-ready inputs from the open points of `points`, read without a draw by default, and the static rules. */
+export declare const buildReadyInputsOf: (product: ResolvedProduct, points?: PartOpenPoints[]) => BuildReadyInputs;
+/** What `design check` found per part of each product: the rules of its problems, its warnings and open points. */
+type PartTally = {
+    problems: string[];
+    warnings: number;
+    open: number;
+};
+type Tally = Map<string, Map<string, PartTally>>;
 type CheckOptions = {
     target: string;
     config: DesignConfig;
     products: string[];
     known?: string[];
-    complete?: boolean;
+    /** Only this part's findings, `<layer>/<name>`. */
+    part?: string;
+    tally?: Tally;
+    drawPictures?: DrawStates;
+    /** How the repo runs `et design`; defaults to the one its package.json implies. */
+    invocation?: string;
+    chromiumOf?: typeof chromiumOf;
 };
+/** The key of the part whose folder holds `file`, the innermost one, or `(product)` for a file outside every part. */
+export declare const partOfFile: (product: ResolvedProduct, file: string) => string;
+/**
+ * One line per part with findings, then one line with the count of clean parts; with `only`, one line for that part
+ * even when it is clean.
+ */
+export declare const summaryText: (options: {
+    product: string;
+    parts: string[];
+    tally: Tally;
+    only?: string;
+    done?: number;
+}) => string[];
+/** One line per rule with how many problems this run found, zeros included, rules outside `CHECK_RULES` after them. */
+export declare const ruleSummaryText: (tally: Tally) => string[];
+/**
+ * One SKETCH-BASE-STALE problem, with its printed line, per undiscarded sketch (open or picked) whose base changed since it was drawn or
+ * rebased; with `parts`, only the sketches where one of those parts changed; with `targets`, only the sketches on those targets.
+ */
+export declare const staleSketchBasesOf: (options: {
+    product: ResolvedProduct;
+    invocation: string;
+    parts?: Set<string>;
+    targets?: Set<string>;
+}) => (Problem & {
+    line: string;
+})[];
 /**
  * Checks the design system of each named product: the rules, then `tsc --noEmit` over its
  * generated tsconfig. Prints one line per problem and `ok` when there is none. The problems of a part the
  * product takes from its base are counted in one line and do not fail it.
  */
-export declare const checkSystem: (options: CheckOptions) => 0 | 1;
+export declare const checkSystem: (options: CheckOptions) => number;
 /**
  * Checks as `checkSystem` does, then draws every state in a headless browser and prints one line per
- * render rule a drawing breaks, and warns of each merged part that changed outside a sketch. Without a browser it prints one skip line and passes on the other checks.
- * It then lists the open points of each product's parts, with the contrasts the drawing found and, with `complete`,
- * the missing states of each component part as `design complete` draws them; they do not change the exit code.
+ * render rule a drawing breaks, also when a static rule failed, and warns of each merged part that changed outside a sketch. A part that does not
+ * draw, each state that does not draw, or every part without a browser, gets one `NOT CHECKED` line; without a browser it passes on the other checks.
+ * It then lists the open points of each product's parts, with the contrasts the drawing found and the missing states
+ * of each component part as `design complete` draws them, the blockers `design ready` refuses on; they do not change
+ * the exit code.
  */
-export declare const checkSystemRendered: (options: CheckOptions) => Promise<number>;
+export declare const checkSystemRendered: (options: CheckOptions) => Promise<0 | 1>;
 export {};