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

package/src/lib/design/system/part-ready.js

@@ -0,0 +1,101 @@
+"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.markPartReady = exports.readyPartsOf = exports.drawnPartPointsOf = exports.readyMarkOf = exports.readyPartOf = exports.readReady = exports.READY_FILE = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const drawn_open_points_1 = require("./drawn-open-points");
+const inventory_approval_1 = require("./inventory-approval");
+const read_open_points_1 = require("./read-open-points");
+const resolve_product_1 = require("./resolve-product");
+const baseline_1 = require("./sketch/baseline");
+exports.READY_FILE = 'ready.json';
+const readyFileOf = (dir) => (0, path_1.resolve)(dir, exports.READY_FILE);
+const isReady = (value) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const { hash, by, at } = value;
+    return typeof hash === 'string' && typeof by === 'string' && typeof at === 'string';
+};
+const readReady = (dir) => {
+    const file = readyFileOf(dir);
+    if (!(0, fs_1.existsSync)(file))
+        return {};
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? Object.fromEntries(Object.entries(parsed).filter((entry) => isReady(entry[1])))
+            : {};
+    }
+    catch (_a) {
+        return {};
+    }
+};
+exports.readReady = readReady;
+/** The part hash of a part and the directory whose ready.json holds it, or why the product has no such part. */
+const readyPartOf = (options) => {
+    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}"`;
+    const owner = (0, inventory_approval_1.partOwnerOf)({ product: options.product, part: resolved });
+    return { dir: owner.dir, hash: (0, baseline_1.partHashOf)({ product: owner, dir: (0, path_1.dirname)(resolved.file) }) };
+};
+exports.readyPartOf = readyPartOf;
+/** The ready mark of a part while its hash still matches, `null` when it has none or the part changed since. */
+const readyMarkOf = (options) => {
+    const found = (0, exports.readyPartOf)(options);
+    if (typeof found === 'string')
+        return null;
+    const mark = (0, exports.readReady)(found.dir)[options.part];
+    return (mark === null || mark === void 0 ? void 0 : mark.hash) === found.hash ? mark : null;
+};
+exports.readyMarkOf = readyMarkOf;
+/** Draws a part and answers its whole open-point list, or why it could not be drawn. */
+const drawnPartPointsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const findings = yield (0, drawn_open_points_1.drawnFindingsOf)(Object.assign(Object.assign({}, options), { parts: [options.part] }));
+    return 'unavailable' in findings ? findings : (0, read_open_points_1.partPointsOf)((0, read_open_points_1.readOpenPoints)(options.product, findings), options.part);
+});
+exports.drawnPartPointsOf = drawnPartPointsOf;
+/** The parts of a product whose ready mark still holds. */
+const readyPartsOf = (product) => product.parts.map(resolve_product_1.partKeyOf).filter((part) => (0, exports.readyMarkOf)({ product, part }) !== null);
+exports.readyPartsOf = readyPartsOf;
+/**
+ * Marks a part ready at `hash`, or answers why not: 400 without `by` or `hash`, 404 for an unknown part, 409 when the
+ * part changed since `hash`, 422 while `pointsOf` lists any open point. `pointsOf` runs only after the hash holds.
+ */
+const markPartReady = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { product, part, hash, by } = options;
+    if (typeof by !== 'string' || by.trim() === '')
+        return { status: 400, error: 'by is required' };
+    if (typeof hash !== 'string' || hash === '')
+        return { status: 400, error: 'hash is required' };
+    const found = (0, exports.readyPartOf)({ product, part });
+    if (typeof found === 'string')
+        return { status: 404, error: found };
+    if (hash !== found.hash)
+        return { status: 409, error: `${part} changed since its open points were shown - reload and check it again` };
+    const points = yield options.pointsOf();
+    if (!Array.isArray(points))
+        return points;
+    if (points.length > 0)
+        return {
+            status: 422,
+            error: `${part} has ${points.length} open point${points.length === 1 ? '' : 's'} - close them before ready`,
+            points,
+        };
+    const mark = { hash, by: by.trim(), at: (_a = options.at) !== null && _a !== void 0 ? _a : new Date().toISOString() };
+    const marks = Object.entries(Object.assign(Object.assign({}, (0, exports.readReady)(found.dir)), { [part]: mark })).sort(([a], [b]) => a.localeCompare(b));
+    (0, fs_1.writeFileSync)(readyFileOf(found.dir), `${JSON.stringify(Object.fromEntries(marks), null, 2)}\n`);
+    return mark;
+});
+exports.markPartReady = markPartReady;
+//# sourceMappingURL=part-ready.js.map

package/src/lib/design/system/part-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part-ready.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/part-ready.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2BAA6D;AAC7D,+BAAwC;AAExC,2DAAsD;AACtD,6DAAmD;AAEnD,yDAAkE;AAClE,uDAA+D;AAC/D,gDAA+C;AAElC,QAAA,UAAU,GAAG,YAAY,CAAC;AAOvC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAA,cAAO,EAAC,GAAG,EAAE,kBAAU,CAAC,CAAC;AAE9D,MAAM,OAAO,GAAG,CAAC,KAAc,EAAsB,EAAE;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9E,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,KAAgC,CAAC;IAE1D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC;AACtF,CAAC,CAAC;AAEK,MAAM,SAAS,GAAG,CAAC,GAAW,EAA6B,EAAE;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAE/D,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAgC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/G,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,SAAS,aAcpB;AAEF,gHAAgH;AACzG,MAAM,WAAW,GAAG,CAAC,OAAmD,EAAE,EAAE;IACjF,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,MAAM,KAAK,GAAG,IAAA,gCAAW,EAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,IAAA,qBAAU,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAA,cAAO,EAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/F,CAAC,CAAC;AARW,QAAA,WAAW,eAQtB;AAEF,gHAAgH;AACzG,MAAM,WAAW,GAAG,CAAC,OAAmD,EAAoB,EAAE;IACnG,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,IAAI,GAAG,IAAA,iBAAS,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,OAAO,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC,CAAC;AARW,QAAA,WAAW,eAQtB;AAEF,wFAAwF;AACjF,MAAM,iBAAiB,GAAG,CAAO,OAKvC,EAAkD,EAAE;IACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,mCAAe,kCAAM,OAAO,KAAE,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAG,CAAC;IAE9E,OAAO,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAA,+BAAY,EAAC,IAAA,iCAAc,EAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACtH,CAAC,CAAA,CAAC;AATW,QAAA,iBAAiB,qBAS5B;AAEF,2DAA2D;AACpD,MAAM,YAAY,GAAG,CAAC,OAAwB,EAAE,EAAE,CACvD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,2BAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;AAD5E,QAAA,YAAY,gBACgE;AAEzF;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAO,OAOnC,EAAqC,EAAE;;IACtC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAE5C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAChG,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAE/F,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACpE,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI;QACrB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,uEAAuE,EAAE,CAAC;IAEhH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IAExC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,4BAA4B;YAC3G,MAAM;SACP,CAAC;IAEJ,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAA,OAAO,CAAC,EAAE,mCAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,iCAAM,IAAA,iBAAS,EAAC,KAAK,CAAC,GAAG,CAAC,KAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/G,IAAA,kBAAa,EAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAEjG,OAAO,IAAI,CAAC;AACd,CAAC,CAAA,CAAC;AAnCW,QAAA,aAAa,iBAmCxB"}

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

@@ -0,0 +1,27 @@
+import { CompletenessGap } from './complete';
+import { OpenPoint, OpenPointsInput, PartOpenPoints } from './open-points';
+import { RenderIssue } from './render-check';
+import { ResolvedProduct } from './resolve-product';
+/**
+ * The open points of every part of a product, read from its part files, comments and sketches, plus the
+ * `rendered` findings of a check that drew the parts.
+ */
+export declare const readOpenPoints: (product: ResolvedProduct, rendered?: Pick<OpenPointsInput, "missingStates" | "contrasts">) => PartOpenPoints[];
+/** The points of one part, or none when it has no open point. */
+export declare const partPointsOf: (list: PartOpenPoints[], part: string) => OpenPoint[];
+/** The `CONTRAST` findings of a render check, once per part, state and path. */
+export declare const contrastsOf: (issues: RenderIssue[]) => NonNullable<OpenPointsInput["contrasts"]>;
+/** The controls of each part that lack a drawn state, from the gaps of a completeness check. */
+export declare const missingStatesOf: (gaps: Map<string, CompletenessGap[] | string>) => NonNullable<OpenPointsInput["missingStates"]>;
+/**
+ * The open points of `targets` as a sketch variant draws them, of the kinds the sketch closes itself, split into the
+ * ones the variant adds to the merged parts and the ones it inherits from them.
+ */
+export declare const sketchOpenPointsOf: ({ merged, variant, targets, }: {
+    merged: ResolvedProduct;
+    variant: ResolvedProduct;
+    targets: string[];
+}) => {
+    added: PartOpenPoints[];
+    inherited: PartOpenPoints[];
+};

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

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

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

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

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

@@ -0,0 +1,7 @@
+export declare const READY_USAGE = "ready <layer>/<name> --product <name> --by <name>";
+/** `et design ready <layer>/<name> …` marks a part ready, and exits 1 with its open points while it has any. */
+export declare const designReady: (options: {
+    target: string;
+    argv: string[];
+    invocation: string;
+}) => Promise<0 | 1 | 2>;

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

@@ -0,0 +1,65 @@
+"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.designReady = exports.READY_USAGE = void 0;
+const open_points_1 = require("./open-points");
+const part_ready_1 = require("./part-ready");
+const resolve_product_1 = require("./resolve-product");
+const cli_args_1 = require("./sketch/cli-args");
+const sketch_1 = require("./sketch/sketch");
+exports.READY_USAGE = 'ready <layer>/<name> --product <name> --by <name>';
+/** `et design ready <layer>/<name> …` marks a part ready, and exits 1 with its open points while it has any. */
+const designReady = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { target, argv, invocation } = options;
+    const args = (0, cli_args_1.argsOf)(argv, ['--product', '--by']);
+    const usage = `usage: ${invocation} ${exports.READY_USAGE}`;
+    if (typeof args === 'string' || (0, cli_args_1.authorOf)(args) === null || args.positional.length !== 1) {
+        if (typeof args === 'string')
+            console.error(args);
+        else if ((0, cli_args_1.authorOf)(args) === null)
+            console.error(`ready ${cli_args_1.NEEDS_AUTHOR}`);
+        console.error(usage);
+        return 2;
+    }
+    const config = (0, cli_args_1.configOf)(target);
+    const parsed = (0, sketch_1.parseTarget)(args.positional[0]);
+    if (typeof config === 'string' || typeof parsed === 'string') {
+        console.error(typeof config === 'string' ? config : parsed);
+        return 1;
+    }
+    const product = (0, cli_args_1.oneProductOf)({ target, config, asked: args.values['--product'] });
+    if (typeof product === 'string') {
+        console.error(product);
+        return 1;
+    }
+    const part = (0, resolve_product_1.partKeyOf)(parsed);
+    const located = (0, part_ready_1.readyPartOf)({ product, part });
+    const marked = yield (0, part_ready_1.markPartReady)({
+        product,
+        part,
+        hash: typeof located === 'string' ? '-' : located.hash,
+        by: (0, cli_args_1.authorOf)(args),
+        pointsOf: () => __awaiter(void 0, void 0, void 0, function* () {
+            const points = yield (0, part_ready_1.drawnPartPointsOf)({ target, config, product, part });
+            return 'unavailable' in points ? { status: 503, error: `cannot draw ${part}: ${points.unavailable}` } : points;
+        }),
+    });
+    if ('status' in marked) {
+        if (marked.points)
+            (0, open_points_1.openPointsText)(product.name, [{ part, points: marked.points }]).forEach((line) => console.error(line));
+        console.error(marked.error);
+        return 1;
+    }
+    console.log(`${part} is ready in ${product.name}`);
+    return 0;
+});
+exports.designReady = designReady;
+//# sourceMappingURL=ready-command.js.map

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

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

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

@@ -25,6 +25,8 @@ export type RenderedGrid = Pick<RenderIssue, 'product' | 'part' | 'sketch'> & {
     line: string;
 };
 export declare const renderIssueLineOf: (issue: RenderIssue) => string;
+/** The render issues as lines, one per finding that repeats across states, sizes, schemes and variants, with where it was found. */
+export declare const groupedIssueLinesOf: (issues: RenderIssue[]) => string[];
 /**
  * Draws every state of the parts of each job in one headless Chromium, on one page of a design server of
  * its own: a page at each product preset, a part with `widths` at each width, any other part fitted to