@ethlete/cli 3.0.0-next.21 → 3.0.0-next.23

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

@@ -0,0 +1,104 @@
+import { Interaction } from '../force-interactions';
+import { DesignPreset } from '../paths';
+import { Problem } from './problem';
+import { PartOrigin, ResolvedPart } from './resolve-product';
+import { SystemModules } from './system-modules';
+export declare const SYSTEM_PATH = "/__design/system";
+export type ListedPart = {
+    layer: string;
+    name: string;
+    origin: PartOrigin;
+    note: string | null;
+    /** The model ids that drew the part, written by the last sketch merge; empty when none is known. */
+    madeBy: string[];
+    states: string[];
+    /** The container widths the part is drawn at, when it declares valid ones. */
+    widths?: number[];
+    /** The interactions the part is drawn in besides rest, in the order it declares them. */
+    interactions: Interaction[];
+    /** The states the part draws as one table in rest, when it declares a `grid` that places any. */
+    grid?: ListedGrid;
+    /** The calls of wireframe kit parts in a page's source; a page with any is a wireframe. */
+    kitUses: number;
+    /** The pages that import the part, directly or through another part: of its own product, and of each product that draws it as its base part. */
+    usedIn: PageUse[];
+    /** Whether the part changed since its last sketch merge while no open sketch holds it. */
+    changedOutsideSketch: boolean;
+    problems: Problem[];
+};
+export type ListedGrid = {
+    columns: string[];
+    rows: string[];
+    cells: {
+        row: string;
+        column: string;
+        state: string;
+    }[];
+};
+export type PageUse = {
+    product: string;
+    part: string;
+};
+export type ListedProduct = {
+    name: string;
+    base: string | null;
+    presets: Record<string, DesignPreset>;
+    themes: {
+        surface: string[];
+        color: string[];
+    };
+    parts: ListedPart[];
+    problems: Problem[];
+};
+/** Answers with the module of a part file as one product draws it. */
+export type PartLoader = (options: {
+    file: string;
+    product: string;
+}) => Promise<unknown>;
+/** The cells of a declared grid that name a listed column and a known state, each state in its first cell only. */
+export declare const gridOf: (grid: unknown, states: string[]) => Pick<ListedPart, "grid">;
+export declare const gridReportOf: (grid: unknown, states: string[]) => {
+    line: string;
+    problems: string[];
+    warnings: string[];
+} | null;
+/** The note, state names, widths, interactions and grid a part module declares, or the problem that kept it from loading. */
+export declare const readPartModule: (options: {
+    part: Pick<ResolvedPart, "file">;
+    product: string;
+    load: PartLoader;
+}) => Promise<{
+    note: null;
+    madeBy: never[];
+    states: never[];
+    interactions: never[];
+    problem: string;
+} | {
+    problem: null;
+    grid?: ListedGrid | undefined;
+    interactions: ("hover" | "focus-visible" | "active" | "disabled")[];
+    widths: number[];
+    note: string | null;
+    madeBy: string[];
+    states: string[];
+} | {
+    problem: null;
+    grid?: ListedGrid | undefined;
+    interactions: ("hover" | "focus-visible" | "active" | "disabled")[];
+    widths?: undefined;
+    note: string | null;
+    madeBy: string[];
+    states: string[];
+}>;
+/**
+ * Each named product of a workspace with its own theme names and its resolved parts: where each
+ * comes from, its note, the names of its states, and the problems the rules and the loading of its
+ * module find in it. Base parts draw under the product's themes, so a base's themes are not inherited.
+ * Problem files are relative to the workspace.
+ */
+export declare const listSystem: (options: {
+    target: string;
+    system: SystemModules;
+    products: string[];
+    load: PartLoader;
+}) => Promise<ListedProduct[]>;

package/src/lib/design/system/list-system.js

@@ -0,0 +1,212 @@
+"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());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSystem = exports.readPartModule = exports.gridReportOf = exports.gridOf = exports.SYSTEM_PATH = void 0;
+const path_1 = require("path");
+const force_interactions_1 = require("../force-interactions");
+const check_system_1 = require("./check-system");
+const imports_1 = require("./imports");
+const kit_1 = require("./kit");
+const resolve_product_1 = require("./resolve-product");
+const merged_parts_1 = require("./sketch/merged-parts");
+exports.SYSTEM_PATH = '/__design/system';
+const madeByOf = (madeBy) => Array.isArray(madeBy) ? madeBy.filter((author) => typeof author === 'string' && author !== '') : [];
+const widthsOf = (widths) => Array.isArray(widths) &&
+    widths.length > 0 &&
+    widths.every((width) => typeof width === 'number' && Number.isFinite(width) && width > 0)
+    ? { widths: widths }
+    : {};
+const isInteraction = (name) => force_interactions_1.INTERACTIONS.some((known) => known === name);
+const interactionsOf = (interactions) => Array.isArray(interactions) ? [...new Set(interactions.filter(isInteraction))] : [];
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/** The cells of a declared grid that name a listed column and a known state, each state in its first cell only. */
+const gridOf = (grid, states) => {
+    if (!isRecord(grid) || !Array.isArray(grid['columns']) || !isRecord(grid['rows']))
+        return {};
+    const columns = [...new Set(grid['columns'].filter((column) => typeof column === 'string'))];
+    const placed = new Set();
+    const cells = Object.entries(grid['rows']).flatMap(([row, cellsOfRow]) => isRecord(cellsOfRow)
+        ? columns.flatMap((column) => {
+            const state = cellsOfRow[column];
+            if (typeof state !== 'string' || !states.includes(state) || placed.has(state))
+                return [];
+            placed.add(state);
+            return [{ row, column, state }];
+        })
+        : []);
+    if (cells.length === 0)
+        return {};
+    return { grid: { columns, rows: [...new Set(cells.map((cell) => cell.row))], cells } };
+};
+exports.gridOf = gridOf;
+const countOf = (count, noun) => `${count} ${noun}${count === 1 ? '' : 's'}`;
+/**
+ * The summary line of a part's `grid` and the problems that fail it: a state in two cells, a cell
+ * naming no state. `null` when the part declares no grid.
+ */
+const isInteractionColumn = (column) => column === 'rest' || force_interactions_1.INTERACTIONS.some((interaction) => interaction === column);
+const coverageWarningsOf = (columns, rows) => {
+    var _a;
+    const interactions = columns.filter(isInteractionColumn);
+    if (interactions.length < 2)
+        return [];
+    const filled = rows.map(([row, cells]) => {
+        const has = (column) => isRecord(cells) && typeof cells[column] === 'string';
+        return {
+            row,
+            missing: interactions.filter((column) => !has(column)),
+            interactive: interactions.some((column) => column !== 'rest' && has(column)),
+        };
+    });
+    const full = filled.filter(({ missing }) => missing.length === 0).map(({ row }) => row);
+    const partial = filled.filter(({ missing, interactive }) => interactive && missing.length > 0);
+    if (full.length === 0 || partial.length === 0)
+        return [];
+    const byMissing = new Map();
+    for (const { row, missing } of partial)
+        byMissing.set(missing.join(', '), [...((_a = byMissing.get(missing.join(', '))) !== null && _a !== void 0 ? _a : []), row]);
+    const skips = [...byMissing].map(([missing, skipping]) => skipping.length === 1
+        ? `row ${skipping[0]} leaves out ${missing}`
+        : `rows ${skipping.join(', ')} leave out ${missing}`);
+    return [
+        `grid ${skips.join('; ')}, which ${full.join(', ')} ${full.length === 1 ? 'fills' : 'fill'} - a state can break there unseen`,
+    ];
+};
+const gridReportOf = (grid, states) => {
+    var _a;
+    if (!isRecord(grid) || !Array.isArray(grid['columns']) || !isRecord(grid['rows']))
+        return null;
+    const columns = grid['columns'].filter((column) => typeof column === 'string');
+    const rows = Object.entries(grid['rows']);
+    const cellsOf = new Map();
+    const problems = [];
+    for (const [row, cells] of rows)
+        for (const column of columns) {
+            const state = isRecord(cells) ? cells[column] : undefined;
+            if (typeof state !== 'string')
+                continue;
+            if (!states.includes(state))
+                problems.push(`grid cell ${row} ${column} names ${state}, which is no state`);
+            else
+                cellsOf.set(state, [...((_a = cellsOf.get(state)) !== null && _a !== void 0 ? _a : []), `${row} ${column}`]);
+        }
+    const twice = [...cellsOf].flatMap(([state, cells]) => cells.length > 1
+        ? [
+            `grid names the state ${state} ${cells.length === 2 ? 'twice' : `${cells.length} times`} (${cells.join(', ')})`,
+        ]
+        : []);
+    const left = states.filter((state) => !cellsOf.has(state));
+    const size = `grid ${countOf(rows.length, 'row')} x ${countOf(columns.length, 'column')}`;
+    return {
+        line: left.length === 0 ? `${size} ok` : `${size}, leaves out ${left.join(', ')}`,
+        problems: [...twice, ...problems],
+        warnings: coverageWarningsOf(columns, rows),
+    };
+};
+exports.gridReportOf = gridReportOf;
+const pageReachOf = (system) => system.products().flatMap((name) => {
+    const product = system.productOf(name);
+    if (!product)
+        return [];
+    const tokenParts = new Set((0, resolve_product_1.tokenPartsOf)(product.config));
+    const tokens = product.parts.filter((part) => tokenParts.has((0, resolve_product_1.partKeyOf)(part)));
+    return product.parts
+        .filter((part) => part.layer === 'pages')
+        .map((page) => ({
+        use: { product: name, part: (0, resolve_product_1.partKeyOf)(page) },
+        files: new Set([...(0, imports_1.partsReachedFrom)({ product, from: page }), ...tokens].map((part) => part.file)),
+    }));
+});
+const belongsTo = (part, problem) => problem.file === part.file || problem.file.startsWith(`${(0, path_1.dirname)(part.file)}${path_1.sep}`);
+/** The note, state names, widths, interactions and grid a part module declares, or the problem that kept it from loading. */
+const readPartModule = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { part, product, load } = options;
+    try {
+        const loaded = (yield load({ file: part.file, product })).default;
+        const states = loaded === null || loaded === void 0 ? void 0 : loaded.states;
+        if (!states || typeof states !== 'object') {
+            return {
+                note: null,
+                madeBy: [],
+                states: [],
+                interactions: [],
+                problem: 'default-exports no definePart({ note, states, render })',
+            };
+        }
+        const names = Object.keys(states);
+        return Object.assign(Object.assign(Object.assign(Object.assign({ note: typeof loaded.note === 'string' ? loaded.note : null, madeBy: madeByOf(loaded.madeBy), states: names }, widthsOf(loaded.widths)), { interactions: interactionsOf(loaded.interactions) }), (0, exports.gridOf)(loaded.grid, names)), { problem: null });
+    }
+    catch (error) {
+        return {
+            note: null,
+            madeBy: [],
+            states: [],
+            interactions: [],
+            problem: error instanceof Error ? error.message : String(error),
+        };
+    }
+});
+exports.readPartModule = readPartModule;
+/**
+ * Each named product of a workspace with its own theme names and its resolved parts: where each
+ * comes from, its note, the names of its states, and the problems the rules and the loading of its
+ * module find in it. Base parts draw under the product's themes, so a base's themes are not inherited.
+ * Problem files are relative to the workspace.
+ */
+const listSystem = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { target, system, products, load } = options;
+    const relativeTo = (problem) => (Object.assign(Object.assign({}, problem), { file: (0, path_1.relative)(target, problem.file) }));
+    const pages = pageReachOf(system);
+    const usedInOf = (part) => pages.filter(({ files }) => files.has(part.file)).map(({ use }) => use);
+    return Promise.all(products.flatMap((name) => {
+        const product = system.productOf(name);
+        if (!product)
+            return [];
+        const problems = (0, check_system_1.ruleProblemsOf)(product);
+        const changedOutsideSketch = new Set((0, merged_parts_1.changedOutsideSketchOf)(product));
+        return [
+            (() => __awaiter(void 0, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e;
+                return ({
+                    name,
+                    base: (_a = product.config.base) !== null && _a !== void 0 ? _a : null,
+                    presets: product.presets,
+                    themes: { surface: (_c = (_b = product.config.themes) === null || _b === void 0 ? void 0 : _b.surface) !== null && _c !== void 0 ? _c : [], color: (_e = (_d = product.config.themes) === null || _d === void 0 ? void 0 : _d.color) !== null && _e !== void 0 ? _e : [] },
+                    parts: yield Promise.all(product.parts.map((part) => __awaiter(void 0, void 0, void 0, function* () {
+                        const _a = yield (0, exports.readPartModule)({
+                            part,
+                            product: name,
+                            load,
+                        }), { note, madeBy, states, interactions, problem } = _a, layout = __rest(_a, ["note", "madeBy", "states", "interactions", "problem"]);
+                        const own = problems.filter((found) => belongsTo(part, found));
+                        return Object.assign(Object.assign({ layer: part.layer, name: part.name, origin: part.origin, note,
+                            madeBy,
+                            states }, layout), { interactions, kitUses: part.layer === 'pages' ? (0, kit_1.kitUsesOf)(part.source) : 0, usedIn: usedInOf(part), changedOutsideSketch: changedOutsideSketch.has((0, resolve_product_1.partKeyOf)(part)), problems: [...own, ...(problem ? [{ rule: 'LOAD', file: part.file, message: problem }] : [])].map(relativeTo) });
+                    }))),
+                    problems: problems.filter((found) => !product.parts.some((part) => belongsTo(part, found))).map(relativeTo),
+                });
+            }))(),
+        ];
+    }));
+});
+exports.listSystem = listSystem;
+//# sourceMappingURL=list-system.js.map

package/src/lib/design/system/list-system.js.map

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

package/src/lib/design/system/notes/note.d.ts

@@ -0,0 +1,53 @@
+import { CommentPoint, CommentSize } from '../comments/comment';
+import { ResolvedProduct } from '../resolve-product';
+/** A note on a state of a part; a pointed note names the `size` it was written at and shows only there. */
+export type NoteFile = {
+    part: string;
+    state: string;
+    point?: CommentPoint;
+    size?: CommentSize;
+    text: string;
+};
+export type DesignNote = NoteFile & {
+    id: string;
+    file: string;
+};
+/** What a change sets: a new text, a new point at a size, or `point: null` to pin the note to the whole state. */
+export type NoteChange = {
+    text?: string;
+    point?: CommentPoint | null;
+    size?: CommentSize;
+};
+export declare const notesDirOf: (productDir: string) => string;
+/** A new note id: the time it was written and a random suffix, as comment ids are. */
+export declare const newNoteId: () => string;
+export declare const MISSING_NOTE_SIZE = "a pointed note needs the size it was written at - add size: a preset name, a width in CSS pixels or \"fitted\"";
+/** Why a note points at nothing: its part, state or size is gone, or a pointed note names no size. `null` when it does. */
+export declare const noteProblemOf: (options: {
+    product: ResolvedProduct;
+    note: NoteFile;
+}) => string | null;
+/** Every note on a state of a product, `<product>/notes/<id>.json`; a file that cannot be read answers with its problem. */
+export declare const listNotes: (productDir: string) => {
+    notes: DesignNote[];
+    unreadable: {
+        file: string;
+        problem: string;
+    }[];
+};
+/** Writes a note on a state of a part, or answers with why it cannot: a bad shape or a part or state that is gone. */
+export declare const createNote: (options: {
+    product: ResolvedProduct;
+    note: NoteFile;
+}) => DesignNote | string;
+/** Changes the text or the point of a note and keeps the rest of it. Answers with the changed note. */
+export declare const changeNote: (options: {
+    productDir: string;
+    id: string;
+    change: NoteChange;
+}) => DesignNote | string;
+/** Deletes a note by its id. Answers with the deleted note. */
+export declare const deleteNote: (options: {
+    productDir: string;
+    id: string;
+}) => DesignNote | string;

package/src/lib/design/system/notes/note.js

@@ -0,0 +1,116 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteNote = exports.changeNote = exports.createNote = exports.listNotes = exports.noteProblemOf = exports.MISSING_NOTE_SIZE = exports.newNoteId = exports.notesDirOf = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const comment_1 = require("../comments/comment");
+const NOTE_ID = /^[A-Za-z0-9-]+$/u;
+const notesDirOf = (productDir) => (0, path_1.resolve)(productDir, 'notes');
+exports.notesDirOf = notesDirOf;
+/** A new note id: the time it was written and a random suffix, as comment ids are. */
+const newNoteId = () => `${new Date()
+    .toISOString()
+    .replace(/[-:]/gu, '')
+    .replace(/\.\d+Z$/u, 'Z')}-${(0, crypto_1.randomBytes)(2).toString('hex')}`;
+exports.newNoteId = newNoteId;
+const SIZE_PROBLEM = `size must be a preset name, a width in CSS pixels or "${comment_1.FITTED}"`;
+exports.MISSING_NOTE_SIZE = `a pointed note needs the size it was written at - add size: a preset name, a width in CSS pixels or "${comment_1.FITTED}"`;
+const shapeProblemOf = (value) => {
+    for (const key of ['part', 'state', 'text'])
+        if (typeof value[key] !== 'string' || value[key].trim() === '')
+            return `${key} must be a non-empty string`;
+    if (value.point !== undefined && !(0, comment_1.isPoint)(value.point))
+        return 'point must be { x, y } in CSS pixels, both >= 0';
+    return value.size !== undefined && !(0, comment_1.isSize)(value.size) ? SIZE_PROBLEM : null;
+};
+/** Why a note points at nothing: its part, state or size is gone, or a pointed note names no size. `null` when it does. */
+const noteProblemOf = (options) => {
+    var _a, _b;
+    const { product, note } = options;
+    return ((_b = (_a = (0, comment_1.goneStateOf)({ product, part: note.part, state: note.state })) !== null && _a !== void 0 ? _a : (note.point && note.size === undefined ? exports.MISSING_NOTE_SIZE : null)) !== null && _b !== void 0 ? _b : (note.point && note.size !== undefined ? (0, comment_1.goneSizeOf)({ product, part: note.part, size: note.size }) : null));
+};
+exports.noteProblemOf = noteProblemOf;
+const writeNote = (file, note) => (0, fs_1.writeFileSync)(file, `${JSON.stringify(note, null, 2)}\n`);
+/** Every note on a state of a product, `<product>/notes/<id>.json`; a file that cannot be read answers with its problem. */
+const listNotes = (productDir) => {
+    const dir = (0, exports.notesDirOf)(productDir);
+    const files = (0, fs_1.existsSync)(dir) ? (0, fs_1.readdirSync)(dir).filter((name) => name.endsWith('.json')) : [];
+    const read = files.sort().map((name) => {
+        const file = (0, path_1.resolve)(dir, name);
+        try {
+            const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+            const problem = shapeProblemOf(parsed);
+            return problem ? { file, problem } : Object.assign(Object.assign({}, parsed), { id: name.slice(0, -'.json'.length), file });
+        }
+        catch (error) {
+            return { file, problem: `is no JSON: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    });
+    return {
+        notes: read.filter((entry) => !('problem' in entry)),
+        unreadable: read.filter((entry) => 'problem' in entry),
+    };
+};
+exports.listNotes = listNotes;
+/** Writes a note on a state of a part, or answers with why it cannot: a bad shape or a part or state that is gone. */
+const createNote = (options) => {
+    var _a;
+    const { product } = options;
+    const { part, state, point, size, text } = options.note;
+    const note = Object.assign(Object.assign({ part,
+        state }, (point === undefined ? {} : Object.assign({ point }, (size === undefined ? {} : { size })))), { text });
+    const problem = (_a = shapeProblemOf(note)) !== null && _a !== void 0 ? _a : (0, exports.noteProblemOf)({ product, note });
+    if (problem)
+        return problem;
+    const dir = (0, exports.notesDirOf)(product.dir);
+    const id = (0, exports.newNoteId)();
+    const file = (0, path_1.resolve)(dir, `${id}.json`);
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    writeNote(file, note);
+    return Object.assign(Object.assign({}, note), { id, file });
+};
+exports.createNote = createNote;
+const findNote = (productDir, id) => {
+    var _a;
+    if (!NOTE_ID.test(id))
+        return `"${id}" is no note id`;
+    return (_a = (0, exports.listNotes)(productDir).notes.find((note) => note.id === id)) !== null && _a !== void 0 ? _a : `no note "${id}"`;
+};
+/** Changes the text or the point of a note and keeps the rest of it. Answers with the changed note. */
+const changeNote = (options) => {
+    const found = findNote(options.productDir, options.id);
+    if (typeof found === 'string')
+        return found;
+    const { text = found.text, point, size } = options.change;
+    const { id, file, point: before, size: sizeBefore } = found, rest = __rest(found, ["id", "file", "point", "size"]);
+    const kept = point === undefined ? before : (point !== null && point !== void 0 ? point : undefined);
+    const keptSize = size !== null && size !== void 0 ? size : sizeBefore;
+    const note = Object.assign(Object.assign(Object.assign({}, rest), (kept ? Object.assign({ point: kept }, (keptSize === undefined ? {} : { size: keptSize })) : {})), { text });
+    const problem = shapeProblemOf(note);
+    if (problem)
+        return problem;
+    writeNote(file, note);
+    return Object.assign(Object.assign({}, note), { id, file });
+};
+exports.changeNote = changeNote;
+/** Deletes a note by its id. Answers with the deleted note. */
+const deleteNote = (options) => {
+    const found = findNote(options.productDir, options.id);
+    if (typeof found !== 'string')
+        (0, fs_1.rmSync)(found.file);
+    return found;
+};
+exports.deleteNote = deleteNote;
+//# sourceMappingURL=note.js.map

package/src/lib/design/system/notes/note.js.map

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

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

@@ -0,0 +1,7 @@
+export declare const PART_USAGE = "part remove <layer>/<name> --by <model id> [--product <name>]";
+/** `et design part remove <layer>/<name> …` deletes a part of a product with its `merged.json` entry, and resolves its comments. */
+export declare const designPart: (options: {
+    target: string;
+    argv: string[];
+    invocation: string;
+}) => 0 | 1 | 2;