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

package/src/lib/design/system/action-cache.d.ts

@@ -0,0 +1,45 @@
+/** The cache folder name of the action check results compare keeps per state. */
+export declare const COMPARE_ACTIONS = "compare-actions";
+/** A design input an action check read while it ran: a design picture, an embedded part's states, or the embedders. */
+export type ActionDep = {
+    kind: 'draw';
+    state: string;
+    opened: Record<string, unknown> | null;
+} | {
+    kind: 'expected';
+    owner: string;
+    state: string;
+} | {
+    kind: 'embedders';
+};
+export type ActionCacheEntry = {
+    key: string;
+    value: unknown;
+    deps: {
+        dep: ActionDep;
+        print: string;
+    }[];
+};
+/** Action check results on disk, each under the hash of its fixed inputs. Reading and writing never throw. */
+export type ActionCache = {
+    read: (key: string) => ActionCacheEntry | null;
+    write: (entry: ActionCacheEntry) => void;
+};
+/** A disk cache of action check results under `dir`; the oldest entries go past `limit` entries. */
+export declare const createActionCache: (dir: string, limit?: number) => ActionCache;
+/**
+ * The value `run` returns for `key`, kept in `cache` while every input `run` tracked prints the same through `printOf`.
+ * A `keep: false` result, or one of an aborted run, is not kept. Without a cache `run` always runs.
+ */
+export declare const cachedActionsOf: <T>(options: {
+    cache: ActionCache | null;
+    key: string;
+    printOf: (dep: ActionDep) => Promise<string>;
+    run: (track: (dep: ActionDep, print: string) => void) => Promise<{
+        value: T;
+        keep: boolean;
+    }>;
+}) => Promise<{
+    value: T;
+    hit: boolean;
+}>;

package/src/lib/design/system/action-cache.js

@@ -0,0 +1,72 @@
+"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.cachedActionsOf = exports.createActionCache = exports.COMPARE_ACTIONS = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const cache_entry_1 = require("../cache-entry");
+/** The cache folder name of the action check results compare keeps per state. */
+exports.COMPARE_ACTIONS = 'compare-actions';
+const ENTRY_LIMIT = 4096;
+const ENTRY_SUFFIX = '.json';
+/** A disk cache of action check results under `dir`; the oldest entries go past `limit` entries. */
+const createActionCache = (dir, limit = ENTRY_LIMIT) => {
+    const evict = () => {
+        const entries = (0, fs_1.readdirSync)(dir)
+            .filter((name) => name.endsWith(ENTRY_SUFFIX))
+            .map((name) => ({ name, mtimeMs: (0, fs_1.statSync)((0, path_1.join)(dir, name)).mtimeMs }))
+            .sort((a, b) => a.mtimeMs - b.mtimeMs);
+        for (const entry of entries.slice(0, Math.max(0, entries.length - limit)))
+            (0, fs_1.rmSync)((0, path_1.join)(dir, entry.name), { force: true });
+    };
+    return {
+        read: (key) => {
+            const path = (0, path_1.join)(dir, `${key}${ENTRY_SUFFIX}`);
+            try {
+                const entry = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+                if (entry.key !== key || !Array.isArray(entry.deps))
+                    return null;
+                const now = new Date();
+                (0, fs_1.utimesSync)(path, now, now);
+                return entry;
+            }
+            catch (_a) {
+                return null;
+            }
+        },
+        write: (entry) => {
+            if ((0, cache_entry_1.writeCacheEntry)(dir, { name: `${entry.key}${ENTRY_SUFFIX}`, text: JSON.stringify(entry) }))
+                evict();
+        },
+    };
+};
+exports.createActionCache = createActionCache;
+/**
+ * The value `run` returns for `key`, kept in `cache` while every input `run` tracked prints the same through `printOf`.
+ * A `keep: false` result, or one of an aborted run, is not kept. Without a cache `run` always runs.
+ */
+const cachedActionsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { cache, key, printOf, run } = options;
+    const kept = (_a = cache === null || cache === void 0 ? void 0 : cache.read(key)) !== null && _a !== void 0 ? _a : null;
+    if (kept) {
+        const prints = yield Promise.all(kept.deps.map(({ dep }) => printOf(dep).catch(() => null)));
+        if (prints.every((print, at) => { var _a; return print === ((_a = kept.deps[at]) === null || _a === void 0 ? void 0 : _a.print); }))
+            return { value: kept.value, hit: true };
+    }
+    const deps = new Map();
+    const { value, keep } = yield run((dep, print) => deps.set(JSON.stringify(dep), { dep, print }));
+    if (cache && keep)
+        cache.write({ key, value, deps: [...deps.values()] });
+    return { value, hit: false };
+});
+exports.cachedActionsOf = cachedActionsOf;
+//# sourceMappingURL=action-cache.js.map

package/src/lib/design/system/action-cache.js.map

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

package/src/lib/design/system/action-lost.d.ts

@@ -0,0 +1,61 @@
+import { DesignConfig } from '../design-config';
+import { Problem } from './problem';
+import { ResolvedProduct } from './resolve-product';
+import { WarmDraw } from '../warm-draw';
+/** Loads the module of a part file as `product` draws it. */
+export type PartModuleLoader = (options: {
+    file: string;
+    product: string;
+}) => Promise<unknown>;
+/** The sorted, distinct `data-et-action` values of a markup string. */
+export declare const actionKeysOfMarkup: (markup: string) => string[];
+/**
+ * The sorted action keys a part definition declares across all its states, read from the markup its `render` returns
+ * outside a browser. A state whose render throws declares nothing.
+ */
+export declare const declaredActionsOf: (definition: unknown) => Promise<string[]>;
+/** The declared action keys of one part, or why they could not be read. */
+export declare const partActionsOf: (options: {
+    load: PartModuleLoader;
+    product: ResolvedProduct;
+    part: string;
+}) => Promise<string[] | string>;
+/** Every action key some part of the product declares now; a part that cannot be loaded declares nothing. */
+export declare const productActionsOf: (options: {
+    load: PartModuleLoader;
+    product: ResolvedProduct;
+}) => Promise<Set<string>>;
+/** Runs `use` with a loader on a design server of its own, closed afterwards. */
+export declare const withPartLoader: <T>(options: {
+    target: string;
+    config: DesignConfig;
+    warm?: WarmDraw;
+}, use: (load: PartModuleLoader) => Promise<T>) => Promise<T>;
+/**
+ * An ACTION-LOST problem for every action key a check record in the product's ready.json holds that no part of the
+ * product declares now, at the part's file. A record without actions is skipped.
+ */
+export declare const actionLostOf: (options: {
+    product: ResolvedProduct;
+    declared: ReadonlySet<string>;
+    invocation: string;
+    part?: string;
+}) => Problem[];
+/** The ACTION-LOST problems of a product, against the actions its parts declare now. */
+export declare const actionLostProblemsOf: (options: {
+    target: string;
+    config: DesignConfig;
+    product: ResolvedProduct;
+    invocation: string;
+    part?: string;
+    load?: PartModuleLoader;
+    warm?: WarmDraw;
+}) => Promise<Problem[]>;
+/** Reads the declared action keys of a part on a design server, or why not; the check record holds them. */
+export declare const declaredPartActionsOf: (options: {
+    target: string;
+    config: DesignConfig;
+    product: ResolvedProduct;
+    part: string;
+    warm?: WarmDraw;
+}) => Promise<string | string[]>;

package/src/lib/design/system/action-lost.js

@@ -0,0 +1,116 @@
+"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.declaredPartActionsOf = exports.actionLostProblemsOf = exports.actionLostOf = exports.withPartLoader = exports.productActionsOf = exports.partActionsOf = exports.declaredActionsOf = exports.actionKeysOfMarkup = void 0;
+const path_1 = require("path");
+const build_ready_contract_1 = require("./build-ready-contract");
+const part_ready_1 = require("./part-ready");
+const resolve_product_1 = require("./resolve-product");
+const system_modules_1 = require("./system-modules");
+const warm_draw_1 = require("../warm-draw");
+const ACTION_ATTRIBUTE = /\sdata-et-action\s*=\s*(?:"([^"]*)"|'([^']*)')/gu;
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/** The sorted, distinct `data-et-action` values of a markup string. */
+const actionKeysOfMarkup = (markup) => [
+    ...new Set([...markup.matchAll(ACTION_ATTRIBUTE)].map((match) => { var _a, _b; return ((_b = (_a = match[1]) !== null && _a !== void 0 ? _a : match[2]) !== null && _b !== void 0 ? _b : '').trim(); }).filter(Boolean)),
+].sort((a, b) => a.localeCompare(b));
+exports.actionKeysOfMarkup = actionKeysOfMarkup;
+/**
+ * The sorted action keys a part definition declares across all its states, read from the markup its `render` returns
+ * outside a browser. A state whose render throws declares nothing.
+ */
+const declaredActionsOf = (definition) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!isRecord(definition) || typeof definition['render'] !== 'function' || !isRecord(definition['states']))
+        return [];
+    const render = definition['render'];
+    const keys = new Set();
+    for (const props of Object.values(definition['states'])) {
+        const drawn = yield Promise.resolve()
+            .then(() => render(props))
+            .catch(() => null);
+        if (isRecord(drawn) && typeof drawn['body'] === 'string')
+            for (const key of (0, exports.actionKeysOfMarkup)(drawn['body']))
+                keys.add(key);
+    }
+    return [...keys].sort((a, b) => a.localeCompare(b));
+});
+exports.declaredActionsOf = declaredActionsOf;
+const definitionOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const module = yield options.load({ file: options.part.file, product: options.product.name });
+    return isRecord(module) ? module['default'] : undefined;
+});
+/** The declared action keys of one part, or why they could not be read. */
+const partActionsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const resolved = options.product.parts.find((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === options.part);
+    if (!resolved)
+        return `product "${options.product.name}" has no part "${options.part}"`;
+    try {
+        return yield (0, exports.declaredActionsOf)(yield definitionOf(Object.assign(Object.assign({}, options), { part: resolved })));
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+});
+exports.partActionsOf = partActionsOf;
+/** Every action key some part of the product declares now; a part that cannot be loaded declares nothing. */
+const productActionsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const keys = new Set();
+    for (const part of options.product.parts) {
+        const declared = yield (0, exports.partActionsOf)(Object.assign(Object.assign({}, options), { part: (0, resolve_product_1.partKeyOf)(part) }));
+        if (typeof declared !== 'string')
+            for (const key of declared)
+                keys.add(key);
+    }
+    return keys;
+});
+exports.productActionsOf = productActionsOf;
+/** Runs `use` with a loader on a design server of its own, closed afterwards. */
+const withPartLoader = (options, use) => __awaiter(void 0, void 0, void 0, function* () {
+    return (0, warm_draw_1.loadingOn)(options, (server) => use(({ file, product }) => server.ssrLoadModule((0, system_modules_1.productModuleIdOf)({ file, product }))));
+});
+exports.withPartLoader = withPartLoader;
+/**
+ * An ACTION-LOST problem for every action key a check record in the product's ready.json holds that no part of the
+ * product declares now, at the part's file. A record without actions is skipped.
+ */
+const actionLostOf = (options) => {
+    const { product, declared, invocation } = options;
+    return Object.entries((0, part_ready_1.readRecordedActions)(product.dir))
+        .filter(([part]) => !options.part || part === options.part)
+        .flatMap(([part, record]) => {
+        var _a, _b;
+        const file = (_b = (_a = product.parts.find((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === part)) === null || _a === void 0 ? void 0 : _a.file) !== null && _b !== void 0 ? _b : (0, path_1.resolve)(product.dir, part_ready_1.READY_FILE);
+        return record.actions
+            .filter((key) => !declared.has(key))
+            .map((key) => ({
+            rule: build_ready_contract_1.ACTION_LOST_RULE,
+            file,
+            at: `${part} ${key}`,
+            message: `action "${key}" is in the check record of ${part} from ${record.at.slice(0, 10)} and exists nowhere in ${product.name} now - draw it again, or confirm the removal: delete it from the actions of ${part} in ${part_ready_1.READY_FILE} and run ${invocation} check --product ${product.name}`,
+        }));
+    });
+};
+exports.actionLostOf = actionLostOf;
+/** The ACTION-LOST problems of a product, against the actions its parts declare now. */
+const actionLostProblemsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const recorded = Object.values((0, part_ready_1.readRecordedActions)(options.product.dir)).some((record) => record.actions.length > 0);
+    if (!recorded)
+        return [];
+    const declared = options.load
+        ? yield (0, exports.productActionsOf)({ load: options.load, product: options.product })
+        : yield (0, exports.withPartLoader)(options, (load) => (0, exports.productActionsOf)({ load, product: options.product }));
+    return (0, exports.actionLostOf)(Object.assign(Object.assign({}, options), { declared }));
+});
+exports.actionLostProblemsOf = actionLostProblemsOf;
+/** Reads the declared action keys of a part on a design server, or why not; the check record holds them. */
+const declaredPartActionsOf = (options) => (0, exports.withPartLoader)(options, (load) => (0, exports.partActionsOf)({ load, product: options.product, part: options.part }));
+exports.declaredPartActionsOf = declaredPartActionsOf;
+//# sourceMappingURL=action-lost.js.map

package/src/lib/design/system/action-lost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-lost.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/action-lost.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAA+B;AAE/B,iEAA0D;AAC1D,6CAA+D;AAE/D,uDAA6E;AAC7E,qDAAqD;AACrD,4CAAmD;AAKnD,MAAM,gBAAgB,GAAG,kDAAkD,CAAC;AAE5E,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAEnH,uEAAuE;AAChE,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,EAAE,CACnD;IACE,GAAG,IAAI,GAAG,CACR,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,eAAC,OAAA,CAAC,MAAA,MAAA,KAAK,CAAC,CAAC,CAAC,mCAAI,KAAK,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA,EAAA,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAC3G;CACF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAL1B,QAAA,kBAAkB,sBAKQ;AAEvC;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAO,UAAmB,EAAqB,EAAE;IAChF,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAgC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE;aAClC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACzB,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAErB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;YACtD,KAAK,MAAM,GAAG,IAAI,IAAA,0BAAkB,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC,CAAA,CAAC;AAhBW,QAAA,iBAAiB,qBAgB5B;AAEF,MAAM,YAAY,GAAG,CAAO,OAAiF,EAAE,EAAE;IAC/G,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC,CAAA,CAAC;AAEF,2EAA2E;AACpE,MAAM,aAAa,GAAG,CAAO,OAInC,EAA8B,EAAE;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,2BAAS,EAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElG,IAAI,CAAC,QAAQ;QAAE,OAAO,YAAY,OAAO,CAAC,OAAO,CAAC,IAAI,kBAAkB,OAAO,CAAC,IAAI,GAAG,CAAC;IAExF,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,yBAAiB,EAAC,MAAM,YAAY,iCAAM,OAAO,KAAE,IAAI,EAAE,QAAQ,IAAG,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;AACH,CAAC,CAAA,CAAC;AAdW,QAAA,aAAa,iBAcxB;AAEF,6GAA6G;AACtG,MAAM,gBAAgB,GAAG,CAAO,OAA6D,EAAE,EAAE;IACtG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAa,kCAAM,OAAO,KAAE,IAAI,EAAE,IAAA,2BAAS,EAAC,IAAI,CAAC,IAAG,CAAC;QAE5E,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,KAAK,MAAM,GAAG,IAAI,QAAQ;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAA,CAAC;AAVW,QAAA,gBAAgB,oBAU3B;AAEF,iFAAiF;AAC1E,MAAM,cAAc,GAAG,CAC5B,OAAkE,EAClE,GAA2C,EAC3C,EAAE;IACF,OAAA,IAAA,qBAAS,EAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAC5B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAA,kCAAiB,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CACvF,CAAA;EAAA,CAAC;AANS,QAAA,cAAc,kBAMvB;AAEJ;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,OAK5B,EAAa,EAAE;IACd,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAElD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAA,gCAAmB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC;SAC1D,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;;QAC1B,MAAM,IAAI,GACR,MAAA,MAAA,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,2BAAS,EAAC,SAAS,CAAC,KAAK,IAAI,CAAC,0CAAE,IAAI,mCAAI,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,uBAAU,CAAC,CAAC;QAE7G,OAAO,MAAM,CAAC,OAAO;aAClB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACnC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,uCAAgB;YACtB,IAAI;YACJ,EAAE,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE;YACpB,OAAO,EAAE,WAAW,GAAG,+BAA+B,IAAI,SAAS,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,OAAO,CAAC,IAAI,+EAA+E,IAAI,OAAO,uBAAU,YAAY,UAAU,oBAAoB,OAAO,CAAC,IAAI,EAAE;SAC5R,CAAC,CAAC,CAAC;IACR,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAvBW,QAAA,YAAY,gBAuBvB;AAEF,wFAAwF;AACjF,MAAM,oBAAoB,GAAG,CAAO,OAQ1C,EAAE,EAAE;IACH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAA,gCAAmB,EAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErH,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;QAC3B,CAAC,CAAC,MAAM,IAAA,wBAAgB,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1E,CAAC,CAAC,MAAM,IAAA,sBAAc,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,wBAAgB,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAElG,OAAO,IAAA,oBAAY,kCAAM,OAAO,KAAE,QAAQ,IAAG,CAAC;AAChD,CAAC,CAAA,CAAC;AAlBW,QAAA,oBAAoB,wBAkB/B;AAEF,4GAA4G;AACrG,MAAM,qBAAqB,GAAG,CAAC,OAMrC,EAAE,EAAE,CAAC,IAAA,sBAAc,EAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,qBAAa,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AANlG,QAAA,qBAAqB,yBAM6E"}

package/src/lib/design/system/action-press.d.ts

@@ -0,0 +1,29 @@
+import { Browser } from '../thumb';
+type Page = Awaited<ReturnType<Awaited<ReturnType<Browser['newContext']>>['newPage']>>;
+export declare const OVERLAY_ROOTS = ".et-overlay-runtime-root, .cdk-overlay-container";
+export declare const EMIT_WAIT_MS = 400;
+/** An init script that records each key whose keydown default the page prevented in `window.__etPrevented`. */
+export declare const INIT_SCRIPT = "window.__etPrevented = [];\nwindow.addEventListener('keydown', (event) => { if (event.defaultPrevented) window.__etPrevented.push(event.key); });";
+/** A page-side predicate: a finite, time-based animation that is still running. A scroll-driven one never ends. */
+export declare const UNSETTLED_ANIMATION = "((animation) => animation.playState === 'running' &&\n  animation.effect?.getTiming().iterations !== Infinity &&\n  !(typeof ScrollTimeline !== 'undefined' && animation.timeline instanceof ScrollTimeline))";
+export declare const SETTLE_TIMEOUT_MS = 3000;
+export declare class SettleTimeoutError extends Error {
+}
+/**
+ * Waits until no finite, time-based animation runs for a few frames. Throws a `SettleTimeoutError` when they still run
+ * after `timeout`, capped at `SETTLE_TIMEOUT_MS`.
+ */
+export declare const settle: (page: Page, timeout: number) => Promise<void>;
+/** Starts recording DOM changes on the page, for `awaitOutput`. Call it right before the press. */
+export declare const watchMutations: (page: Page) => Promise<unknown>;
+/**
+ * Waits until `output` fired, or the DOM did not change for a few frames since `watchMutations`, or `EMIT_WAIT_MS`
+ * passes.
+ */
+export declare const awaitOutput: (page: Page, output: string | null) => Promise<void>;
+/**
+ * Blurs the element that shows a keyboard focus ring, so a picture after a key press compares against a goal state
+ * the design draws unfocused.
+ */
+export declare const dropKeyboardFocus: (page: Page) => Promise<unknown>;
+export {};

package/src/lib/design/system/action-press.js

@@ -0,0 +1,88 @@
+"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.dropKeyboardFocus = exports.awaitOutput = exports.watchMutations = exports.settle = exports.SettleTimeoutError = exports.SETTLE_TIMEOUT_MS = exports.UNSETTLED_ANIMATION = exports.INIT_SCRIPT = exports.EMIT_WAIT_MS = exports.OVERLAY_ROOTS = void 0;
+const wait_1 = require("../wait");
+exports.OVERLAY_ROOTS = '.et-overlay-runtime-root, .cdk-overlay-container';
+exports.EMIT_WAIT_MS = 400;
+const SETTLED_FRAMES = 2;
+const QUIET_FRAMES = 2;
+/** An init script that records each key whose keydown default the page prevented in `window.__etPrevented`. */
+exports.INIT_SCRIPT = `window.__etPrevented = [];
+window.addEventListener('keydown', (event) => { if (event.defaultPrevented) window.__etPrevented.push(event.key); });`;
+/** A page-side predicate: a finite, time-based animation that is still running. A scroll-driven one never ends. */
+exports.UNSETTLED_ANIMATION = `((animation) => animation.playState === 'running' &&
+  animation.effect?.getTiming().iterations !== Infinity &&
+  !(typeof ScrollTimeline !== 'undefined' && animation.timeline instanceof ScrollTimeline))`;
+exports.SETTLE_TIMEOUT_MS = 3000;
+class SettleTimeoutError extends Error {
+}
+exports.SettleTimeoutError = SettleTimeoutError;
+/**
+ * Waits until no finite, time-based animation runs for a few frames. Throws a `SettleTimeoutError` when they still run
+ * after `timeout`, capped at `SETTLE_TIMEOUT_MS`.
+ */
+const settle = (page, timeout) => __awaiter(void 0, void 0, void 0, function* () {
+    const cap = Math.min(timeout, exports.SETTLE_TIMEOUT_MS);
+    yield page
+        .waitForFunction(`(() => {
+        const settled = !document.getAnimations().some(${exports.UNSETTLED_ANIMATION});
+        window.__etActionFrames = settled ? (window.__etActionFrames ?? 0) + 1 : 0;
+        return window.__etActionFrames >= ${SETTLED_FRAMES};
+      })()`, undefined, { timeout: (0, wait_1.playwrightTimeoutOf)(cap), polling: 'raf' })
+        .catch((error) => {
+        if (error instanceof Error && error.name === 'TimeoutError') {
+            throw new SettleTimeoutError(`the page did not settle its animations within ${cap} ms`);
+        }
+    });
+});
+exports.settle = settle;
+/** Starts recording DOM changes on the page, for `awaitOutput`. Call it right before the press. */
+const watchMutations = (page) => page.evaluate(`(() => {
+    window.__etMutated = true;
+    window.__etQuietFrames = 0;
+    window.__etMutations?.disconnect();
+    window.__etMutations = new MutationObserver(() => (window.__etMutated = true));
+    window.__etMutations.observe(document, { subtree: true, childList: true, attributes: true, characterData: true });
+  })()`);
+exports.watchMutations = watchMutations;
+/**
+ * Waits until `output` fired, or the DOM did not change for a few frames since `watchMutations`, or `EMIT_WAIT_MS`
+ * passes.
+ */
+const awaitOutput = (page, output) => __awaiter(void 0, void 0, void 0, function* () {
+    const expected = JSON.stringify(output);
+    yield page
+        .waitForFunction(`(() => {
+        const fired = [...(window.__etDesignEmits ?? []).map((emit) => emit.output), ...(window.__etEmbeddedEmits ?? [])];
+
+        if (${expected} !== null && fired.includes(${expected})) return true;
+
+        window.__etQuietFrames = window.__etMutated ? 0 : (window.__etQuietFrames ?? 0) + 1;
+        window.__etMutated = false;
+
+        return window.__etQuietFrames >= ${QUIET_FRAMES};
+      })()`, undefined, { timeout: exports.EMIT_WAIT_MS, polling: 'raf' })
+        .catch(() => undefined);
+    yield page.evaluate('window.__etMutations?.disconnect()');
+});
+exports.awaitOutput = awaitOutput;
+/**
+ * Blurs the element that shows a keyboard focus ring, so a picture after a key press compares against a goal state
+ * the design draws unfocused.
+ */
+const dropKeyboardFocus = (page) => page.evaluate(`(() => {
+    const focused = document.activeElement;
+
+    if (focused instanceof HTMLElement && focused.matches(':focus-visible')) focused.blur();
+  })()`);
+exports.dropKeyboardFocus = dropKeyboardFocus;
+//# sourceMappingURL=action-press.js.map

package/src/lib/design/system/action-press.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-press.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/action-press.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,kCAA8C;AAIjC,QAAA,aAAa,GAAG,kDAAkD,CAAC;AAEnE,QAAA,YAAY,GAAG,GAAG,CAAC;AAEhC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,+GAA+G;AAClG,QAAA,WAAW,GAAG;sHAC2F,CAAC;AAEvH,mHAAmH;AACtG,QAAA,mBAAmB,GAAG;;4FAEyD,CAAC;AAEhF,QAAA,iBAAiB,GAAG,IAAK,CAAC;AAEvC,MAAa,kBAAmB,SAAQ,KAAK;CAAG;AAAhD,gDAAgD;AAEhD;;;GAGG;AACI,MAAM,MAAM,GAAG,CAAO,IAAU,EAAE,OAAe,EAAE,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,yBAAiB,CAAC,CAAC;IAEjD,MAAM,IAAI;SACP,eAAe,CACd;yDACmD,2BAAmB;;4CAEhC,cAAc;WAC/C,EACL,SAAS,EACT,EAAE,OAAO,EAAE,IAAA,0BAAmB,EAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CACtD;SACA,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5D,MAAM,IAAI,kBAAkB,CAAC,iDAAiD,GAAG,KAAK,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC,CAAA,CAAC;AAlBW,QAAA,MAAM,UAkBjB;AAEF,mGAAmG;AAC5F,MAAM,cAAc,GAAG,CAAC,IAAU,EAAE,EAAE,CAC3C,IAAI,CAAC,QAAQ,CAAC;;;;;;OAMT,CAAC,CAAC;AAPI,QAAA,cAAc,kBAOlB;AAET;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAO,IAAU,EAAE,MAAqB,EAAE,EAAE;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,IAAI;SACP,eAAe,CACd;;;cAGQ,QAAQ,+BAA+B,QAAQ;;;;;2CAKlB,YAAY;WAC5C,EACL,SAAS,EACT,EAAE,OAAO,EAAE,oBAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAC1C;SACA,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAC5D,CAAC,CAAA,CAAC;AApBW,QAAA,WAAW,eAoBtB;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAU,EAAE,EAAE,CAC9C,IAAI,CAAC,QAAQ,CAAC;;;;OAIT,CAAC,CAAC;AALI,QAAA,iBAAiB,qBAKrB"}

package/src/lib/design/system/action-undeclared.d.ts

@@ -0,0 +1,34 @@
+import { RenderIssue } from './render-check';
+/** The rule an interactive design element breaks when it declares no `data-et-action`. */
+export declare const ACTION_UNDECLARED_RULE = "ACTION-UNDECLARED";
+/**
+ * A script for the frame's init: it records every element a click listener is added to, for the
+ * ACTION-UNDECLARED statements. It has to run before the drawing's `setup`.
+ */
+export declare const CLICK_LISTENER_INIT_SCRIPT = "(() => {\n  const clicked = new WeakSet();\n  const add = EventTarget.prototype.addEventListener;\n  Object.defineProperty(window, '__etClickListened', { value: clicked });\n  EventTarget.prototype.addEventListener = function (type, ...rest) {\n    if (type === 'click' && this instanceof Element) clicked.add(this);\n    return add.call(this, type, ...rest);\n  };\n})()";
+/**
+ * The statements of the ACTION-UNDECLARED check inside the frame script of `render-check`. They use `root`, `partRoot`,
+ * `options`, `report`, `ownedOf` and `textOf` of that script. A part whose root is the control leaves its action to the
+ * part that uses it, and a click listener on an element around other interactive ones delegates.
+ */
+export declare const ACTION_UNDECLARED_STATEMENTS: string;
+/** The ACTION-UNDECLARED summary of one part whose go still holds, for `design check` to warn with. */
+export type ActionUndeclaredWarning = {
+    product: string;
+    part: string;
+    line: string;
+};
+/**
+ * Splits the ACTION-UNDECLARED issues of the parts whose go still holds off `issues`, as one warning line per part with
+ * the hit count and the first element. The issues of every other part stay errors.
+ */
+export declare const actionUndeclaredUnderGoOf: (options: {
+    issues: RenderIssue[];
+    isGo: (at: {
+        product: string;
+        part: string;
+    }) => boolean;
+}) => {
+    issues: RenderIssue[];
+    warnings: ActionUndeclaredWarning[];
+};

package/src/lib/design/system/action-undeclared.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionUndeclaredUnderGoOf = exports.ACTION_UNDECLARED_STATEMENTS = exports.CLICK_LISTENER_INIT_SCRIPT = exports.ACTION_UNDECLARED_RULE = void 0;
+const actions_1 = require("./actions");
+const render_check_1 = require("./render-check");
+/** The rule an interactive design element breaks when it declares no `data-et-action`. */
+exports.ACTION_UNDECLARED_RULE = 'ACTION-UNDECLARED';
+const DRAWN_INTERACTIVE_SELECTOR = `:is(${actions_1.INTERACTIVE_SELECTOR}, [aria-expanded])`;
+/**
+ * A script for the frame's init: it records every element a click listener is added to, for the
+ * ACTION-UNDECLARED statements. It has to run before the drawing's `setup`.
+ */
+exports.CLICK_LISTENER_INIT_SCRIPT = `(() => {
+  const clicked = new WeakSet();
+  const add = EventTarget.prototype.addEventListener;
+  Object.defineProperty(window, '__etClickListened', { value: clicked });
+  EventTarget.prototype.addEventListener = function (type, ...rest) {
+    if (type === 'click' && this instanceof Element) clicked.add(this);
+    return add.call(this, type, ...rest);
+  };
+})()`;
+/**
+ * The statements of the ACTION-UNDECLARED check inside the frame script of `render-check`. They use `root`, `partRoot`,
+ * `options`, `report`, `ownedOf` and `textOf` of that script. A part whose root is the control leaves its action to the
+ * part that uses it, and a click listener on an element around other interactive ones delegates.
+ */
+exports.ACTION_UNDECLARED_STATEMENTS = `
+  if (options.part !== null) {
+    const interactive = ${JSON.stringify(DRAWN_INTERACTIVE_SELECTOR)};
+    const clicked = window.__etClickListened;
+    const candidates = [...root.querySelectorAll('*')].filter((element) =>
+      element.matches(interactive) || (clicked?.has(element) && !element.querySelector(interactive)));
+    const embedded = (element) => {
+      for (let at = element.closest('[data-et-control]'); at; at = at.parentElement?.closest('[data-et-control]') ?? null)
+        if (options.embedControls.includes(at.getAttribute('data-et-control'))) return true;
+      return false;
+    };
+    for (const element of candidates) {
+      if (element.hasAttribute('data-et-action') || element.getClientRects().length === 0 || !ownedOf(element)) continue;
+      if (element.matches(':disabled, [aria-disabled="true"]') || element.closest('[inert], [aria-hidden="true"]')) continue;
+      if (element === partRoot || embedded(element)) continue;
+      const text = (element.getAttribute('aria-label') || textOf(element).trim()).replace(/\\s+/g, ' ');
+      const cls = [...element.classList].find((name) => !/^et-(surface|color)--/.test(name));
+      const named = element.tagName.toLowerCase() + (cls ? '.' + cls : '') + (text ? ' "' + (text.length > 32 ? text.slice(0, 31) + '…' : text) + '"' : '');
+      report('${exports.ACTION_UNDECLARED_RULE}', element, named + ' is interactive but declares no action - add data-et-action="<state>" or "emit:<output>"');
+    }
+  }
+`;
+/**
+ * Splits the ACTION-UNDECLARED issues of the parts whose go still holds off `issues`, as one warning line per part with
+ * the hit count and the first element. The issues of every other part stay errors.
+ */
+const actionUndeclaredUnderGoOf = (options) => {
+    var _a;
+    const issues = [];
+    const groups = new Map();
+    for (const issue of options.issues) {
+        const at = { product: issue.product, part: (0, render_check_1.ownerPartOf)(issue) };
+        if (issue.rule !== exports.ACTION_UNDECLARED_RULE || !options.isGo(at)) {
+            issues.push(issue);
+            continue;
+        }
+        const key = JSON.stringify([at.product, at.part]);
+        const group = (_a = groups.get(key)) !== null && _a !== void 0 ? _a : Object.assign(Object.assign({}, at), { found: [] });
+        group.found.push(issue);
+        groups.set(key, group);
+    }
+    const warnings = [...groups.values()].map(({ product, part, found }) => {
+        const [first] = found;
+        const elements = new Set(found.map((issue) => JSON.stringify([issue.part, issue.path]))).size;
+        const named = first.detail.split(' - ')[0];
+        return {
+            product,
+            part,
+            line: `WARNING ${exports.ACTION_UNDECLARED_RULE} ${product} ${part}: ${found.length} hit${found.length === 1 ? '' : 's'} on ${elements} element${elements === 1 ? '' : 's'}, unchanged since its go - first ${first.path}: ${named}`,
+        };
+    });
+    return { issues, warnings };
+};
+exports.actionUndeclaredUnderGoOf = actionUndeclaredUnderGoOf;
+//# sourceMappingURL=action-undeclared.js.map

package/src/lib/design/system/action-undeclared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-undeclared.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/action-undeclared.ts"],"names":[],"mappings":";;;AAAA,uCAAiD;AACjD,iDAA0D;AAE1D,0FAA0F;AAC7E,QAAA,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D,MAAM,0BAA0B,GAAG,OAAO,8BAAoB,oBAAoB,CAAC;AAEnF;;;GAGG;AACU,QAAA,0BAA0B,GAAG;;;;;;;;KAQrC,CAAC;AAEN;;;;GAIG;AACU,QAAA,4BAA4B,GAAG;;0BAElB,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC;;;;;;;;;;;;;;;;gBAgBpD,8BAAsB;;;CAGrC,CAAC;AAKF;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAC,OAGzC,EAAE,EAAE;;IACH,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmE,CAAC;IAE1F,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAA,0BAAW,EAAC,KAAK,CAAC,EAAE,CAAC;QAEhE,IAAI,KAAK,CAAC,IAAI,KAAK,8BAAsB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,mEAAS,EAAE,KAAE,KAAK,EAAE,EAAE,GAAE,CAAC;QAEtD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAA2B,EAAE;QAC9F,MAAM,CAAC,KAAK,CAAC,GAAG,KAAwC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9F,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3C,OAAO;YACL,OAAO;YACP,IAAI;YACJ,IAAI,EAAE,WAAW,8BAAsB,IAAI,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,WAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oCAAoC,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;SAC7N,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC,CAAC;AAnCW,QAAA,yBAAyB,6BAmCpC"}