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

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

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

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

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

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

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

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

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

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

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

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

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

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

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