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

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

@@ -3,7 +3,59 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.coloursIn = void 0;
 const HEX = /(?<![&\w/])#(?:[0-9a-f]{8}|[0-9a-f]{6}|[0-9a-f]{3,4})(?![\w-])/gi;
 const FUNCTION = /(?<![\w-])(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\(/gi;
-/** The hex colours and colour functions written in a piece of text. */
-const coloursIn = (text) => [...text.matchAll(HEX), ...text.matchAll(FUNCTION)].map((match) => match[0]);
+const VAR = /var\(/giy;
+const closingParenOf = (text, open) => {
+    let depth = 0;
+    for (let index = open; index < text.length; index++) {
+        if (text[index] === '(')
+            depth++;
+        else if (text[index] === ')' && --depth === 0)
+            return index;
+    }
+    return -1;
+};
+const withoutVars = (text) => {
+    let out = '';
+    let index = 0;
+    while (index < text.length) {
+        VAR.lastIndex = index;
+        if (!VAR.test(text)) {
+            out += text[index++];
+            continue;
+        }
+        const close = closingParenOf(text, index + 'var'.length);
+        if (close === -1)
+            return null;
+        out += ' ';
+        index = close + 1;
+    }
+    return out;
+};
+const channelsOf = (rest) => {
+    const slash = rest.indexOf('/');
+    if (slash !== -1)
+        return rest.slice(0, slash);
+    const comma = rest.lastIndexOf(',');
+    return comma === -1 ? rest : rest.slice(0, comma);
+};
+const isTokenRgb = (text, match) => {
+    if (!/^rgba?\($/iu.test(match[0]))
+        return false;
+    const open = match.index + match[0].length - 1;
+    const close = closingParenOf(text, open);
+    if (close === -1)
+        return false;
+    const args = text.slice(open + 1, close);
+    const rest = withoutVars(args);
+    return rest !== null && rest !== args && /^[\s,]*$/u.test(channelsOf(rest));
+};
+/**
+ * The hex colours and colour functions written in a piece of text. An `rgb()` or `rgba()` whose channels all come from
+ * `var()` is a token colour and does not count; its alpha may be a literal.
+ */
+const coloursIn = (text) => [
+    ...[...text.matchAll(HEX)].map((match) => match[0]),
+    ...[...text.matchAll(FUNCTION)].filter((match) => !isTokenRgb(text, match)).map((match) => match[0]),
+];
 exports.coloursIn = coloursIn;
 //# sourceMappingURL=colour.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"colour.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/colour.ts"],"names":[],"mappings":";;;AAAA,MAAM,GAAG,GAAG,kEAAkE,CAAC;AAC/E,MAAM,QAAQ,GAAG,6DAA6D,CAAC;AAE/E,uEAAuE;AAChE,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAA3G,QAAA,SAAS,aAAkG"}
+{"version":3,"file":"colour.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/colour.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 import { chromiumOf } from '../browser';
-export declare const COMPLETE_USAGE = "complete <layer>/<name> [--product <name>]";
+export declare const COMPLETE_USAGE = "complete <layer>/<name> [--variant <key> | --handoff] [--product <name>] | complete --handoff [--product <name>] | complete --request <layer>/<name>.<control>.<requirement> --reason <text> [--product <name>]";
 /** `et design complete <layer>/<name>` exits 1 while a control the part declares lacks a drawn, reviewed state or surface. */
 export declare const designComplete: (options: {
     target: string;

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

@@ -11,16 +11,26 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.designComplete = exports.COMPLETE_USAGE = void 0;
 const complete_1 = require("./complete");
+const exceptions_1 = require("./exceptions");
+const handoff_1 = require("./handoff");
 const resolve_product_1 = require("./resolve-product");
 const cli_args_1 = require("./sketch/cli-args");
 const sketch_1 = require("./sketch/sketch");
-exports.COMPLETE_USAGE = 'complete <layer>/<name> [--product <name>]';
+exports.COMPLETE_USAGE = 'complete <layer>/<name> [--variant <key> | --handoff] [--product <name>] | complete --handoff [--product <name>] | complete --request <layer>/<name>.<control>.<requirement> --reason <text> [--product <name>]';
 /** `et design complete <layer>/<name>` exits 1 while a control the part declares lacks a drawn, reviewed state or surface. */
 const designComplete = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e;
     const { target, argv, invocation } = options;
-    const args = (0, cli_args_1.argsOf)(argv, ['--product']);
+    const args = (0, cli_args_1.argsOf)(argv, ['--product', '--request', '--reason', '--variant']);
     const usage = `usage: ${invocation} ${exports.COMPLETE_USAGE}`;
-    if (typeof args === 'string' || args.positional.length !== 1) {
+    const request = typeof args === 'string' ? undefined : args.values['--request'];
+    const handoff = typeof args !== 'string' && args.flags.has('--handoff');
+    if (typeof args === 'string' ||
+        args.positional.length > (request === undefined ? 1 : 0) ||
+        (args.positional.length === 0 && request === undefined && !handoff) ||
+        (handoff && (request !== undefined || args.values['--variant'] !== undefined)) ||
+        (request === undefined) !== (args.values['--reason'] === undefined) ||
+        (request !== undefined && args.values['--variant'] !== undefined)) {
         if (typeof args === 'string')
             console.error(args);
         console.error(usage);
@@ -31,6 +41,58 @@ const designComplete = (options) => __awaiter(void 0, void 0, void 0, function*
         console.error(config);
         return 1;
     }
+    if (request !== undefined) {
+        const product = (0, cli_args_1.oneProductOf)({ target, config, asked: args.values['--product'] });
+        const requested = typeof product === 'string'
+            ? product
+            : (0, exceptions_1.requestException)({ product, key: request, reason: (_a = args.values['--reason']) !== null && _a !== void 0 ? _a : '' });
+        if (typeof requested === 'string') {
+            console.error(requested);
+            return 1;
+        }
+        console.log(`requested exception ${request} - design complete still fails on it until the user approves it in Studio`);
+        return 0;
+    }
+    if (args.positional[0] === undefined) {
+        const product = (0, cli_args_1.oneProductOf)({ target, config, asked: args.values['--product'] });
+        if (typeof product === 'string') {
+            console.error(product);
+            return 1;
+        }
+        const parts = Object.keys((0, handoff_1.readHandoff)(product.dir));
+        let failed = 0;
+        for (const part of parts) {
+            const result = yield (0, complete_1.completenessOf)({ target, config, product, part, chromiumOf: options.chromiumOf });
+            if ('unavailable' in result) {
+                console.error(`design complete needs a browser: ${result.unavailable}`);
+                return 1;
+            }
+            if ('problem' in result) {
+                failed++;
+                console.error(`HANDOFF ${part} regressed - ${result.problem}`);
+                continue;
+            }
+            for (const exception of (_b = result.exceptions) !== null && _b !== void 0 ? _b : [])
+                console.log((0, exceptions_1.exceptionLineOf)(exception));
+            for (const gap of result.gaps)
+                console.error((0, complete_1.completenessGapLineOf)(gap));
+            for (const hint of (_c = result.hints) !== null && _c !== void 0 ? _c : [])
+                console.log(hint);
+            if (result.gaps.length > 0) {
+                failed++;
+                console.error(`HANDOFF ${part} regressed - ${result.gaps.length} gap(s)`);
+            }
+            else {
+                console.log(`HANDOFF ${part} complete`);
+            }
+        }
+        if (failed > 0) {
+            console.error(`${failed} of ${parts.length} handoff part(s) in ${product.name} are no longer design complete`);
+            return 1;
+        }
+        console.log(`${parts.length} handoff part(s) in ${product.name} are design complete`);
+        return 0;
+    }
     const parsed = (0, sketch_1.parseTarget)(args.positional[0]);
     if (typeof parsed === 'string') {
         console.error(parsed);
@@ -42,7 +104,10 @@ const designComplete = (options) => __awaiter(void 0, void 0, void 0, function*
         return 1;
     }
     const part = (0, resolve_product_1.partKeyOf)(parsed);
-    const result = yield (0, complete_1.completenessOf)({ target, config, product, part, chromiumOf: options.chromiumOf });
+    const variant = args.values['--variant'];
+    const sketch = variant === undefined ? null : { target: part, variant };
+    const result = yield (0, complete_1.completenessOf)({ target, config, product, part, sketch, chromiumOf: options.chromiumOf });
+    const what = sketch ? `variant ${variant} of ${part}` : part;
     if ('problem' in result) {
         console.error(result.problem);
         return 1;
@@ -51,13 +116,22 @@ const designComplete = (options) => __awaiter(void 0, void 0, void 0, function*
         console.error(`design complete needs a browser: ${result.unavailable}`);
         return 1;
     }
+    for (const exception of (_d = result.exceptions) !== null && _d !== void 0 ? _d : [])
+        console.log((0, exceptions_1.exceptionLineOf)(exception));
     for (const gap of result.gaps)
         console.error((0, complete_1.completenessGapLineOf)(gap));
+    for (const hint of (_e = result.hints) !== null && _e !== void 0 ? _e : [])
+        console.log(hint);
     if (result.gaps.length > 0) {
-        console.error(`${part} in ${product.name} is not design complete: ${result.gaps.length} gap(s)`);
+        console.error(`${what} in ${product.name} is not design complete: ${result.gaps.length} gap(s)`);
         return 1;
     }
-    console.log(`${part} in ${product.name} is design complete`);
+    if (handoff) {
+        (0, handoff_1.recordHandoff)({ productDir: product.dir, part });
+        console.log(`${what} in ${product.name} is design complete and has the handoff status`);
+        return 0;
+    }
+    console.log(`${what} in ${product.name} is design complete`);
     return 0;
 });
 exports.designComplete = designComplete;

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

@@ -1 +1 @@
-{"version":3,"file":"complete-command.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/complete-command.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,yCAAmE;AACnE,uDAA8C;AAC9C,gDAAmE;AACnE,4CAA8C;AAEjC,QAAA,cAAc,GAAG,4CAA4C,CAAC;AAE3E,8HAA8H;AACvH,MAAM,cAAc,GAAG,CAAO,OAKpC,EAAE,EAAE;IACH,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAA,iBAAM,EAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,UAAU,IAAI,sBAAc,EAAE,CAAC;IAEvD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,mBAAQ,EAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAElF,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,2BAAS,EAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAc,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEvG,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,aAAa,IAAI,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAExE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,IAAA,gCAAqB,EAAC,GAAG,CAAC,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,IAAI,4BAA4B,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC;QAEjG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,IAAI,qBAAqB,CAAC,CAAC;IAE7D,OAAO,CAAC,CAAC;AACX,CAAC,CAAA,CAAC;AApEW,QAAA,cAAc,kBAoEzB"}
+{"version":3,"file":"complete-command.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/complete-command.ts"],"names":[],"mappings":"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"}

package/src/lib/design/system/complete.d.ts

@@ -1,16 +1,28 @@
 import { chromiumOf } from '../browser';
 import { DesignConfig } from '../paths';
-import { ResolvedProduct } from './resolve-product';
+import { Browser } from '../thumb';
+import { ResolvedPart, ResolvedProduct } from './resolve-product';
+import { SketchVariant, SystemModules } from './system-modules';
+import { ListedException } from './exceptions';
+import { InventoryState } from './inventory-approval';
 /** One requirement of a part that `design complete` finds without evidence. `target` is `<part>[.<control>[.<requirement>]]`. */
 export type CompletenessGap = {
     code: string;
     target: string;
     detail: string;
 };
+/** A box in the pixels of a drawn frame, as its `/__design/shot` picture shows it. */
+export type FrameBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
 /**
  * An element of a drawn frame that looks interactive. `control` is a native control, an interactive role or a known
  * SDK control; `unclassified` has a pointer cursor or a matched `:hover` rule and sits in no control. `marked` is the
- * `data-et-control` that declares it, `within` every `data-et-control` around it, nearest first.
+ * `data-et-control` that declares it, `within` every `data-et-control` around it, nearest first. `owner` is the
+ * embedded part whose `data-et-part` root draws it, or `null` for the frame's own part.
  */
 export type FoundControl = {
     kind: 'control' | 'unclassified';
@@ -18,6 +30,37 @@ export type FoundControl = {
     path: string;
     marked: string | null;
     within: string[];
+    owner?: string | null;
+    box?: FrameBox | null;
+};
+/** A rule of the part's own stylesheet that sets `properties` on `path`, an element the embedded part `owner` draws. */
+export type FoundOverride = {
+    owner: string;
+    selector: string;
+    path: string;
+    properties: string[];
+};
+/**
+ * A forced interaction on a drawn element: whether its box differs from rest, which colours change in one frame, and
+ * the classes of that interaction's variant no stylesheet defines when it does not differ.
+ */
+export type SeenForce = {
+    interaction: string;
+    differs: boolean;
+    still?: string[];
+    undefinedClasses?: string[];
+};
+/**
+ * An option or menu item inside a drawn surface. `selected` is its ARIA selected, checked, pressed or current
+ * state, `look` its computed colours, so two options can be told apart without their text. `named` is set when an
+ * `aria-activedescendant` in the frame names its id, `keyboard` when it carries `data-active-source="keyboard"`.
+ */
+export type SeenOption = {
+    selected: boolean;
+    look: string;
+    forced: SeenForce[];
+    named?: boolean;
+    keyboard?: boolean;
 };
 /** What one drawn frame of a state shows of the controls and surfaces its markup marks. */
 export type SeenFrame = {
@@ -25,20 +68,69 @@ export type SeenFrame = {
     interaction: string | null;
     controls: {
         id: string;
-        forced: {
-            interaction: string;
-            differs: boolean;
-            still?: string[];
-        }[];
+        forced: SeenForce[];
+        selected?: boolean;
+        disabled?: boolean;
+        look?: string;
+        keyboard?: boolean;
+        box?: FrameBox | null;
     }[];
     surfaces: {
         id: string;
         shown: boolean;
+        options?: SeenOption[];
     }[];
     found?: FoundControl[];
+    overrides?: FoundOverride[];
+};
+export type DeclaredControl = {
+    kind: string;
+    input: string[];
+    part: string | null;
+    surfaces: Record<string, string>;
+    disabled: boolean;
 };
 /** The gaps of each part a control names in `part`, or why it could not be checked. */
 export type ReferencedParts = Record<string, CompletenessGap[] | string>;
+export declare const declaredControlsOf: (value: unknown) => Record<string, DeclaredControl> | null;
+/**
+ * Whether a state name shows an interaction: its last word, split at `-`, `_`, spaces and camelCase, or the whole name
+ * is hover, hovered, focus, focused, pressed, active or selected. `row-hover`, `collapseFocus` and `focus-visible`
+ * are; `active-only` and `inactive` are not.
+ */
+export declare const isInteractionState: (state: string) => boolean;
+/** Whether a part may draw interaction states: it is no page, and its `controls` declare a control of a checked kind. */
+export declare const isControlPart: (options: {
+    part: string;
+    controls: unknown;
+}) => boolean;
+/**
+ * One `CONTROL-STATE` gap per element whose interaction states a part draws that is no control part. The element is
+ * the state name without its interaction words (`row-hover` names the row), or `control` when nothing is left.
+ */
+export declare const controlStateGapsOf: (options: {
+    part: string;
+    controls: unknown;
+    states: string[];
+}) => CompletenessGap[];
+/** How much of its frame one rest state changes against `base`, the first state of its part, from 0 to 1. */
+export type StateChange = {
+    state: string;
+    base: string;
+    share: number;
+};
+/**
+ * One hint per state of an element or component that is no control part whose pixels differ from its first state in
+ * under a tenth of the frame. Pages compose parts, so they get none; interaction states are left to `CONTROL-STATE`.
+ */
+export declare const smallChangeHintsOf: (options: {
+    part: string;
+    controls: unknown;
+    changes: StateChange[];
+}) => string[];
+/** Whether a discovered element is an undeclared or unclassified finding of the part, not owned or declared. */
+export declare const isFindingOf: (declared: Record<string, DeclaredControl>) => (found: FoundControl) => boolean;
+export declare const findingKeyOf: (found: FoundControl) => string;
 /**
  * The gaps of one part, from its `controls` declaration, its state names and what each drawn frame showed.
  * A part that is not `reviewed` (its files differ from its merged.json hash) has no reviewed evidence at all.
@@ -51,23 +143,94 @@ export declare const completenessGapsOf: (options: {
     reviewed: boolean;
     grid?: unknown;
     referenced?: ReferencedParts;
+    inventory?: InventoryState;
 }) => CompletenessGap[];
 export declare const completenessGapLineOf: (gap: CompletenessGap) => string;
+/** Whether a gap is a declared control that no state draws, or that lacks a drawn interaction, look or surface. */
+export declare const isMissingStateGap: (gap: CompletenessGap) => boolean;
+export declare const SDK_CONTROLS: string[];
+export declare const PLAIN_CONTROL_SELECTOR: string;
+/** Where a rest frame of a part is drawn: its state at a preset, or at a width, as `/__design/shot` takes it. */
+export type FrameAddress = {
+    state: string;
+    preset: string | null;
+    width: number | null;
+};
+/**
+ * Draws every state of one part of the product, at rest and, unless `restOnly`, in each interaction it declares,
+ * once at its first preset or width, and answers what each frame showed, or why its module did not load as a string.
+ */
+export declare const seePart: (options: {
+    product: ResolvedProduct;
+    part: ResolvedPart;
+    system: SystemModules;
+    base: string;
+    load: (id: string) => Promise<unknown>;
+    draw: <T>(job: (browser: Browser) => Promise<T>) => Promise<T>;
+    restOnly?: boolean;
+    sketch?: SketchVariant | null;
+}) => Promise<string | {
+    definition: {
+        states?: unknown;
+        interactions?: unknown;
+        widths?: unknown;
+        controls?: unknown;
+        grid?: unknown;
+    } | undefined;
+    states: string[];
+    seen: SeenFrame[];
+    refused: string[];
+    changes: StateChange[];
+    addresses: FrameAddress[];
+    owner: ResolvedProduct | {
+        dir: string;
+        base: null;
+    };
+    hash: string;
+}>;
+/** The control ids a page draws at rest, the set its inventory approval holds. */
+export declare const inventoryIdsOf: (frames: SeenFrame[]) => string[];
 /**
  * Draws every state of one part, at rest and in each interaction it declares, once at its first preset or width,
- * and answers the gaps of its `controls` declaration, or why it could not draw. A part a control names in `part`
- * is checked the same way, and its gaps fail the control.
+ * and answers the gaps of its `controls` declaration, or why it could not draw. A part a control names in `part`,
+ * and an embedded part whose `data-et-part` root draws a control, is checked the same way, and its gaps fail it -
+ * unless it is a part of the product's base, whose gaps stay its own.
+ * A page fails until the user approves its control inventory in Studio. An exception the user approved in Studio
+ * drops the gap it names until the part changes; a pending one still fails. With `sketch`, every part is drawn as
+ * that variant draws it, and a part the variant changes is not merged yet, so it never fails as unreviewed.
+ * A drawn control that no `controls` entry declares is a hint; the sketch check fails on one a sketch adds.
  */
 export declare const completenessOf: (options: {
     target: string;
     config: DesignConfig;
     product: ResolvedProduct;
     part: string;
+    sketch?: SketchVariant | null;
     chromiumOf?: typeof chromiumOf;
 }) => Promise<{
     gaps: CompletenessGap[];
+    exceptions?: ListedException[];
+    hints?: string[];
 } | {
     unavailable: string;
 } | {
     problem: string;
 }>;
+/**
+ * Checks each named part as `completenessOf` does, sharing one server, browser and cache, and answers the gaps of
+ * each part, or why it could not be checked as a string.
+ */
+export declare const partsCompletenessOf: (options: {
+    target: string;
+    config: DesignConfig;
+    product: ResolvedProduct;
+    parts: string[];
+    sketch?: SketchVariant | null;
+    chromiumOf?: typeof chromiumOf;
+}) => Promise<{
+    gaps: Map<string, CompletenessGap[] | string>;
+    exceptions: ListedException[];
+    hints: Map<string, string[]>;
+} | {
+    unavailable: string;
+}>;