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

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importedAssetsOf = exports.filesBelow = exports.assetImportsOf = exports.cssAssetPathsOf = exports.ASSET_URL = exports.assetFileOf = exports.assetDirsOf = exports.assetPathOf = exports.ASSETS_FOLDER = exports.ASSETS_PREFIX = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const ts_source_1 = require("./ts-source");
+exports.ASSETS_PREFIX = '@assets/';
+exports.ASSETS_FOLDER = 'assets';
+/** The `@assets/` path of a specifier without its query, or `null` for any other import. */
+const assetPathOf = (specifier) => { var _a; return specifier.startsWith(exports.ASSETS_PREFIX) ? ((_a = specifier.slice(exports.ASSETS_PREFIX.length).split('?')[0]) !== null && _a !== void 0 ? _a : '') : null; };
+exports.assetPathOf = assetPathOf;
+/** The folders `@assets/` looks in, first match wins: a sketch variant's own, the product's, its base product's. */
+const assetDirsOf = (product) => [
+    ...(product.assetsDir ? [product.assetsDir] : []),
+    (0, path_1.resolve)(product.dir, exports.ASSETS_FOLDER),
+    ...(product.base ? [(0, path_1.resolve)(product.base.dir, exports.ASSETS_FOLDER)] : []),
+];
+exports.assetDirsOf = assetDirsOf;
+const assetFileOf = (options) => {
+    for (const dir of (0, exports.assetDirsOf)(options.product)) {
+        const file = (0, path_1.resolve)(dir, options.path);
+        if (file.startsWith(`${dir}${path_1.sep}`) && (0, fs_1.existsSync)(file) && (0, fs_1.statSync)(file).isFile())
+            return file;
+    }
+    return null;
+};
+exports.assetFileOf = assetFileOf;
+/** A `url(@assets/<file>)` in a stylesheet; the second group is the file's path, without a query or fragment. */
+exports.ASSET_URL = /url\(\s*(['"]?)@assets\/([^'")?#]+)[^'")]*\1\s*\)/gu;
+const cssAssetPathsOf = (css) => [...css.matchAll(exports.ASSET_URL)].flatMap((match) => { var _a; return (_a = match[2]) !== null && _a !== void 0 ? _a : []; });
+exports.cssAssetPathsOf = cssAssetPathsOf;
+/** The `@assets/` paths a source file imports. */
+const assetImportsOf = (source) => (0, ts_source_1.importsOf)(source).flatMap((specifier) => {
+    const path = (0, exports.assetPathOf)(specifier);
+    return path === null ? [] : [path];
+});
+exports.assetImportsOf = assetImportsOf;
+/** Every file in a folder and below it, sorted by path, `[]` when it does not exist. */
+const filesBelow = (dir) => (0, fs_1.existsSync)(dir)
+    ? (0, fs_1.readdirSync)(dir)
+        .sort()
+        .flatMap((name) => {
+        const path = (0, path_1.resolve)(dir, name);
+        return (0, fs_1.statSync)(path).isDirectory() ? (0, exports.filesBelow)(path) : [path];
+    })
+    : [];
+exports.filesBelow = filesBelow;
+/**
+ * The asset files the files of a part folder use, as the product resolves them, sorted by path: the `@assets/`
+ * imports of its source files and the `url(@assets/...)` of its stylesheets.
+ */
+const importedAssetsOf = (options) => {
+    const paths = options.files.flatMap((file) => /\.(?:ts|js|mjs)$/u.test(file)
+        ? (0, exports.assetImportsOf)((0, fs_1.readFileSync)(file, 'utf8'))
+        : file.endsWith('.css')
+            ? (0, exports.cssAssetPathsOf)((0, fs_1.readFileSync)(file, 'utf8'))
+            : []);
+    return [...new Set(paths)].sort().flatMap((path) => {
+        const file = (0, exports.assetFileOf)({ product: options.product, path });
+        return file ? [{ path, file }] : [];
+    });
+};
+exports.importedAssetsOf = importedAssetsOf;
+//# sourceMappingURL=assets.js.map

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

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

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

@@ -0,0 +1,33 @@
+import { DesignProduct } from '../paths';
+import { Problem } from './problem';
+/** A product folder together with its entry in the `config.json` that declares it. */
+export type ProductSource = {
+    name: string;
+    dir: string;
+    config: DesignProduct;
+    configFile: string;
+};
+export declare const isBuiltInBase: (base: string) => boolean;
+export declare const baseDirOf: (options: {
+    target: string;
+    base: string;
+}) => string;
+/**
+ * The base a product extends. Its settings come from the `config.json` of the workspace that
+ * holds the base folder, under the folder's own name.
+ */
+export declare const loadBase: (options: {
+    target: string;
+    base: string;
+    configFile: string;
+}) => {
+    base: null;
+    problems: {
+        rule: string;
+        file: string;
+        message: string;
+    }[];
+} | {
+    base: ProductSource;
+    problems: Problem[];
+};

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBase = exports.baseDirOf = exports.isBuiltInBase = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const paths_1 = require("../paths");
+const BUILT_IN_BASES = {
+    '@ethlete/components': 'systems/ethlete-components',
+};
+const isBuiltInBase = (base) => base in BUILT_IN_BASES;
+exports.isBuiltInBase = isBuiltInBase;
+const baseDirOf = (options) => {
+    const builtIn = BUILT_IN_BASES[options.base];
+    return builtIn ? (0, path_1.resolve)((0, paths_1.assetRoot)(), builtIn) : (0, path_1.resolve)(options.target, options.base);
+};
+exports.baseDirOf = baseDirOf;
+const configFileAbove = (dir) => {
+    const file = (0, path_1.resolve)(dir, 'config.json');
+    if ((0, fs_1.existsSync)(file))
+        return file;
+    const parent = (0, path_1.dirname)(dir);
+    return parent === dir ? null : configFileAbove(parent);
+};
+/**
+ * The base a product extends. Its settings come from the `config.json` of the workspace that
+ * holds the base folder, under the folder's own name.
+ */
+const loadBase = (options) => {
+    var _a;
+    const { target, base, configFile } = options;
+    const dir = (0, exports.baseDirOf)({ target, base });
+    const problem = (message) => ({ base: null, problems: [{ rule: 'BASE', file: configFile, message }] });
+    if (!(0, fs_1.existsSync)(dir))
+        return problem(`base "${base}" is no folder (${dir})`);
+    const baseConfigFile = configFileAbove((0, path_1.dirname)(dir));
+    if (!baseConfigFile)
+        return problem(`base "${base}" lies in no folder with a config.json`);
+    const name = (0, path_1.basename)(dir);
+    const config = (_a = JSON.parse((0, fs_1.readFileSync)(baseConfigFile, 'utf8')).products) === null || _a === void 0 ? void 0 : _a[name];
+    if (!config)
+        return problem(`base "${base}": ${baseConfigFile} declares no product "${name}"`);
+    if (config.base)
+        return problem(`base "${base}" extends "${config.base}", but a base has no base of its own`);
+    const source = { name, dir, config, configFile: baseConfigFile };
+    const problems = [];
+    return { base: source, problems };
+};
+exports.loadBase = loadBase;
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/base.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAAkD;AAClD,oCAAkE;AAMlE,MAAM,cAAc,GAA2B;IAC7C,qBAAqB,EAAE,4BAA4B;CACpD,CAAC;AAEK,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,IAAI,cAAc,CAAC;AAAzD,QAAA,aAAa,iBAA4C;AAE/D,MAAM,SAAS,GAAG,CAAC,OAAyC,EAAE,EAAE;IACrE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO,OAAO,CAAC,CAAC,CAAC,IAAA,cAAO,EAAC,IAAA,iBAAS,GAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAA,cAAO,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACzF,CAAC,CAAC;AAJW,QAAA,SAAS,aAIpB;AAEF,MAAM,eAAe,GAAG,CAAC,GAAW,EAAiB,EAAE;IACrD,MAAM,IAAI,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAEzC,IAAI,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;IAE5B,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,QAAQ,GAAG,CAAC,OAA6D,EAAE,EAAE;;IACxF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAA,iBAAS,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAE/G,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,mBAAmB,GAAG,GAAG,CAAC,CAAC;IAE7E,MAAM,cAAc,GAAG,eAAe,CAAC,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC,CAAC;IAErD,IAAI,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,wCAAwC,CAAC,CAAC;IAE3F,MAAM,IAAI,GAAG,IAAA,eAAQ,EAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAC,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,cAAc,EAAE,MAAM,CAAC,CAAkB,CAAC,QAAQ,0CAAG,IAAI,CAAC,CAAC;IAEnG,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,MAAM,cAAc,yBAAyB,IAAI,GAAG,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,SAAS,IAAI,cAAc,MAAM,CAAC,IAAI,sCAAsC,CAAC,CAAC;IAE9G,MAAM,MAAM,GAAkB,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC,CAAC;AArBW,QAAA,QAAQ,YAqBnB"}

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

@@ -0,0 +1,23 @@
+import { DesignConfig } from '../paths';
+import { Problem } from './problem';
+import { ResolvedProduct } from './resolve-product';
+export declare const ruleLinesOf: (target: string, product: ResolvedProduct) => string[];
+/** Every problem the rules find in a resolved product, its resolution problems first. */
+export declare const ruleProblemsOf: (product: ResolvedProduct) => Problem[];
+type CheckOptions = {
+    target: string;
+    config: DesignConfig;
+    products: string[];
+    known?: string[];
+};
+/**
+ * Checks the design system of each named product: the rules, then `tsc --noEmit` over its
+ * generated tsconfig. Prints one line per problem and `ok` when there is none.
+ */
+export declare const checkSystem: (options: CheckOptions) => 0 | 1;
+/**
+ * Checks as `checkSystem` does, then draws every state in a headless browser and prints one line per
+ * render rule a drawing breaks, and warns of each merged part that changed outside a sketch. Without a browser it prints one skip line and passes on the other checks.
+ */
+export declare const checkSystemRendered: (options: CheckOptions) => Promise<0 | 1>;
+export {};

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

@@ -0,0 +1,151 @@
+"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.checkSystemRendered = exports.checkSystem = exports.ruleProblemsOf = exports.ruleLinesOf = void 0;
+const path_1 = require("path");
+const imports_1 = require("./imports");
+const resolve_product_1 = require("./resolve-product");
+const component_copy_1 = require("./rules/component-copy");
+const render_check_1 = require("./render-check");
+const flow_1 = require("./rules/flow");
+const hard_coded_colour_1 = require("./rules/hard-coded-colour");
+const interactions_1 = require("./rules/interactions");
+const kit_outside_pages_1 = require("./rules/kit-outside-pages");
+const motion_1 = require("./rules/motion");
+const stale_comment_1 = require("./rules/stale-comment");
+const undefined_token_1 = require("./rules/undefined-token");
+const token_selectors_1 = require("./rules/token-selectors");
+const upward_dependency_1 = require("./rules/upward-dependency");
+const svg_asset_1 = require("./rules/svg-asset");
+const stale_replace_1 = require("./rules/stale-replace");
+const unused_shared_export_1 = require("./rules/unused-shared-export");
+const widths_1 = require("./rules/widths");
+const check_sketches_1 = require("./sketch/check-sketches");
+const merged_parts_1 = require("./sketch/merged-parts");
+const sketch_1 = require("./sketch/sketch");
+const system_tsconfig_1 = require("./system-tsconfig");
+const RULES = [
+    imports_1.importProblemsOf,
+    upward_dependency_1.upwardDependenciesOf,
+    hard_coded_colour_1.hardCodedColoursOf,
+    undefined_token_1.undefinedTokensOf,
+    component_copy_1.componentCopiesOf,
+    motion_1.scriptedMotionOf,
+    stale_comment_1.staleCommentsOf,
+    stale_comment_1.staleNotesOf,
+    widths_1.badWidthsOf,
+    interactions_1.unknownInteractionsOf,
+    kit_outside_pages_1.kitOutsidePagesOf,
+    flow_1.flowProblemsOf,
+    svg_asset_1.badSvgAssetsOf,
+];
+const ruleLinesOf = (target, product) => (0, exports.ruleProblemsOf)(product).map((problem) => lineOf(target, problem));
+exports.ruleLinesOf = ruleLinesOf;
+/** Every problem the rules find in a resolved product, its resolution problems first. */
+const ruleProblemsOf = (product) => [
+    ...product.problems,
+    ...RULES.flatMap((rule) => rule(product)),
+];
+exports.ruleProblemsOf = ruleProblemsOf;
+const lineOf = (target, problem) => `${problem.rule} ${(0, path_1.relative)(target, problem.file)}: ${problem.message}`;
+const typecheckOpenSketches = (options) => (0, sketch_1.listSketches)({ productDir: options.product.dir, product: options.product.name }).flatMap((sketch) => typeof sketch === 'string'
+    ? []
+    : sketch.variants.flatMap((variant) => {
+        const result = (0, check_sketches_1.typecheckVariant)(Object.assign(Object.assign({}, options), { sketch, variant }));
+        return result.kind === 'ok'
+            ? []
+            : [
+                {
+                    rule: 'TYPE-ERROR',
+                    file: (0, sketch_1.variantDirOf)(sketch, variant),
+                    message: `\n${result.kind === 'failed' ? result.output : result.message}`,
+                },
+            ];
+    }));
+const warnChangedOutsideSketch = (product) => {
+    for (const part of (0, merged_parts_1.changedOutsideSketchOf)(product))
+        console.warn(`WARNING ${product.name} ${part} changed outside a sketch - every change to a merged part goes through a sketch, with one variant when there is no choice`);
+};
+const reportSystem = (options) => {
+    var _a;
+    const { target, config, products } = options;
+    const declared = (_a = config.products) !== null && _a !== void 0 ? _a : {};
+    let failed = false;
+    const report = (problem) => {
+        var _a;
+        const line = lineOf(target, problem);
+        if ((_a = options.known) === null || _a === void 0 ? void 0 : _a.includes(line)) {
+            console.warn(`NOTE (was there before) ${line}`);
+            return;
+        }
+        console.error(line);
+        failed = true;
+    };
+    for (const name of products) {
+        const entry = declared[name];
+        if (!entry) {
+            console.error(`NO PRODUCT "${name}" - config.json declares ${Object.keys(declared).join(', ') || 'none'}.`);
+            return 1;
+        }
+        const product = (0, resolve_product_1.resolveProduct)({ target, name, config: entry });
+        if (options.warn)
+            warnChangedOutsideSketch(product);
+        (0, stale_comment_1.goneSketchCommentWarningsOf)(product).forEach((warning) => console.warn(warning));
+        (0, unused_shared_export_1.unusedSharedExportsOf)(product).forEach((problem) => console.warn(`WARNING ${lineOf(target, problem)}`));
+        (0, stale_replace_1.staleReplacesOf)(product).forEach((problem) => console.warn(`WARNING ${lineOf(target, problem)}`));
+        (0, token_selectors_1.tokenSelectorsOf)(product).forEach((problem) => console.warn(`WARNING ${lineOf(target, problem)}`));
+        (0, exports.ruleProblemsOf)(product).forEach(report);
+        (0, system_tsconfig_1.writeEditorTsconfig)({ target, product });
+        const result = (0, system_tsconfig_1.typecheckProduct)({ target, product });
+        if (result.kind === 'unavailable') {
+            console.error(result.message);
+            return 1;
+        }
+        if (result.kind === 'failed')
+            report({ rule: 'TYPE-ERROR', file: product.dir, message: `\n${result.output}` });
+        if (options.warn)
+            typecheckOpenSketches({ target, product }).forEach(report);
+    }
+    return failed ? 1 : 0;
+};
+/**
+ * Checks the design system of each named product: the rules, then `tsc --noEmit` over its
+ * generated tsconfig. Prints one line per problem and `ok` when there is none.
+ */
+const checkSystem = (options) => {
+    const code = reportSystem(options);
+    if (code === 0)
+        console.log('ok');
+    return code;
+};
+exports.checkSystem = checkSystem;
+/**
+ * Checks as `checkSystem` does, then draws every state in a headless browser and prints one line per
+ * render rule a drawing breaks, and warns of each merged part that changed outside a sketch. Without a browser it prints one skip line and passes on the other checks.
+ */
+const checkSystemRendered = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const code = reportSystem(Object.assign(Object.assign({}, options), { warn: true }));
+    if (code !== 0)
+        return code;
+    const rendered = yield (0, render_check_1.renderIssuesOf)(Object.assign(Object.assign({}, options), { jobs: options.products.map((product) => ({ product, sketch: null, parts: null })) }));
+    if ('unavailable' in rendered)
+        console.log(`RENDER CHECK SKIPPED - ${rendered.unavailable}`);
+    else {
+        rendered.warnings.forEach((issue) => console.warn(`WARNING ${(0, render_check_1.renderIssueLineOf)(issue)}`));
+        rendered.issues.forEach((issue) => console.error((0, render_check_1.renderIssueLineOf)(issue)));
+    }
+    if ('issues' in rendered && rendered.issues.length > 0)
+        return 1;
+    console.log('ok');
+    return 0;
+});
+exports.checkSystemRendered = checkSystemRendered;
+//# sourceMappingURL=check-system.js.map

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

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

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

@@ -0,0 +1,2 @@
+/** The hex colours and colour functions written in a piece of text. */
+export declare const coloursIn: (text: string) => string[];

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

@@ -0,0 +1,9 @@
+"use strict";
+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]);
+exports.coloursIn = coloursIn;
+//# sourceMappingURL=colour.js.map

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

@@ -0,0 +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"}

package/src/lib/design/system/comments/comment.d.ts

@@ -0,0 +1,196 @@
+import { ResolvedProduct } from '../resolve-product';
+import { Sketch } from '../sketch/sketch';
+/** A point on a frame, in CSS pixels from its top left corner, at the comment's size. */
+export type CommentPoint = {
+    x: number;
+    y: number;
+};
+/** The size of the frame a comment was made on: a preset name, a width in CSS pixels, or `fitted` to its content. */
+export type CommentSize = string | number;
+export declare const FITTED = "fitted";
+export declare const REST = "rest";
+/**
+ * One answer in a comment thread, by the user (from Studio) or by the agent (`et design comment reply`).
+ * `author` is the model id of the agent; a reply written before it was recorded has none.
+ * `question` marks an agent reply that waits for the user's answer (`--question`).
+ */
+export type CommentReply = {
+    by: 'user' | 'agent';
+    author?: string;
+    text: string;
+    createdAt: string;
+    question?: true;
+};
+/**
+ * Who a thread waits on: `agent` when the user spoke last, `question` when the agent's last reply asks the user,
+ * `answered` when the agent's last reply asks nothing. An answered thread stays open until the user withdraws it or replies.
+ */
+export type ThreadState = 'agent' | 'question' | 'answered';
+/** What answered a thread: `inbox done`, a new sketch round from its variant, or the merge or discard of its sketch. */
+export type CommentAddressReason = 'done' | 'round' | 'merge' | 'discard';
+/**
+ * How a thread was answered. It stays open until the user resolves it in Studio, and a reply by the user opens it again.
+ * `author` is the model id of the agent; `round` is the key of the round a `round` answer started.
+ */
+export type CommentAddressed = {
+    by: 'user' | 'agent';
+    author?: string;
+    reason: CommentAddressReason;
+    addressedAt: string;
+    note?: string;
+    round?: string;
+};
+/** How the user closed a thread in Studio. A comment file without it is open or addressed. */
+export type CommentResolution = {
+    by: 'user';
+    resolvedAt: string;
+    note?: string;
+};
+export type CommentFile = {
+    part: string;
+    state: string;
+    size: CommentSize;
+    /** `rest` or one of the part's interactions; a file without it is on `rest`. */
+    interaction?: string;
+    point?: CommentPoint;
+    /** `createdAt` is the sketch's own, so a later sketch on the same target shows none of its comments. */
+    sketch?: {
+        target: string;
+        variant: string;
+        createdAt?: string;
+    };
+    text: string;
+    createdAt: string;
+    replies?: CommentReply[];
+    addressed?: CommentAddressed;
+    resolved?: CommentResolution;
+};
+export type DesignComment = CommentFile & {
+    id: string;
+    product: string;
+    file: string;
+    interaction: string;
+    replies: CommentReply[];
+};
+export declare const commentsDirOf: (productDir: string) => string;
+export declare const isPoint: (value: unknown) => value is CommentPoint;
+export declare const isSize: (value: unknown) => value is CommentSize;
+export declare const isOpenComment: (comment: Pick<CommentFile, "addressed" | "resolved">) => boolean;
+/**
+ * The open comment files of a product, oldest first, or every one with `all` (addressed and resolved too); a file
+ * that cannot be read answers with its problem.
+ */
+export declare const listComments: (options: {
+    productDir: string;
+    product: string;
+    all?: boolean;
+}) => {
+    comments: DesignComment[];
+    unreadable: {
+        file: string;
+        problem: string;
+    }[];
+};
+/** Why a part key and state name point at nothing in a product, or `null`. A part whose states are not an object literal keeps any state. */
+export declare const goneStateOf: (options: {
+    product: ResolvedProduct;
+    part: string;
+    state: string;
+}) => string | null;
+/** Why a size points at nothing: a preset the product lacks, or a width a part with readable `widths` lacks. */
+export declare const goneSizeOf: (options: {
+    product: ResolvedProduct;
+    part: string;
+    size: CommentSize;
+}) => string | null;
+/** Whether the sketch a comment was made on was merged, discarded or replaced by a later one on the same target. */
+export declare const sketchGoneOf: (options: {
+    product: ResolvedProduct;
+    comment: Pick<CommentFile, "sketch">;
+}) => boolean;
+/**
+ * Why a comment no longer points at anything: its sketch variant, part, state, size or interaction is gone.
+ * `null` when it still does. A part whose states are not an object literal keeps any state.
+ */
+export declare const staleReasonOf: (options: {
+    product: ResolvedProduct;
+    comment: Omit<CommentFile, "text" | "createdAt">;
+}) => string | null;
+/** Writes a comment on a state of a part, or answers with why it points at nothing. */
+export declare const createComment: (options: {
+    product: ResolvedProduct;
+    comment: Omit<CommentFile, "createdAt">;
+}) => DesignComment | string;
+/** Who spoke last in a comment thread: the user wrote the comment, so a thread without replies is the user's. */
+export declare const lastWordOf: (comment: Pick<DesignComment, "replies">) => "agent" | "user";
+export declare const threadStateOf: (comment: Pick<DesignComment, "replies">) => ThreadState;
+export declare const findComment: (options: {
+    products: {
+        name: string;
+        dir: string;
+    }[];
+    id: string;
+}) => string | DesignComment;
+/**
+ * Adds a reply to the thread of an open or addressed comment, searching the named products. A reply by the user
+ * opens an addressed thread again. Answers with the updated comment.
+ */
+export declare const replyToComment: (options: {
+    products: {
+        name: string;
+        dir: string;
+    }[];
+    id: string;
+    by: CommentReply["by"];
+    author?: string;
+    text: string;
+    question?: boolean;
+}) => DesignComment | string;
+/** Deletes a withdrawn comment thread by its id, searching the named products. Answers with the deleted comment. */
+export declare const deleteComment: (options: {
+    products: {
+        name: string;
+        dir: string;
+    }[];
+    id: string;
+}) => DesignComment | string;
+/**
+ * Marks an open or addressed comment thread as addressed by `inbox done`, searching the named products. Without
+ * `author` the user addressed it. Answers with the addressed comment.
+ */
+export declare const addressComment: (options: {
+    products: {
+        name: string;
+        dir: string;
+    }[];
+    id: string;
+    author?: string;
+    note?: string;
+}) => DesignComment | string;
+/** Resolves an open or addressed comment thread for the user, searching the named products: the file stays, marked `resolved`. */
+export declare const resolveComment: (options: {
+    products: {
+        name: string;
+        dir: string;
+    }[];
+    id: string;
+    note?: string;
+}) => DesignComment | string;
+/** The open comments made on any variant of a sketch, matched by its target and its `createdAt`. */
+export declare const commentsOnSketch: (options: {
+    productDir: string;
+    product: string;
+    sketch: Pick<Sketch, "target" | "createdAt">;
+}) => DesignComment[];
+/**
+ * Marks the open comments on the variants of a sketch, or only those on `variant`, as addressed for `reason`. `round`
+ * is the key of the round a `round` answer started; without `author` the user addressed them. Answers with the addressed comments.
+ */
+export declare const addressSketchComments: (options: {
+    sketch: Sketch;
+    variant?: string;
+    reason: Exclude<CommentAddressReason, "done">;
+    author?: string;
+    note?: string;
+    round?: string;
+}) => DesignComment[];