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

package/src/lib/design/system/harness-config.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesPattern = exports.appStylesheetOf = exports.harnessProblemOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const isRepoPath = (path) => typeof path === 'string' &&
+    path.trim() === path &&
+    path !== '' &&
+    !path.startsWith('/') &&
+    !path.includes('\\') &&
+    !path_1.posix.normalize(path).startsWith('..');
+/** Why a product's `harness` entry is unusable, or `null` when it is a valid `{ app, map, shared? }` of repo paths. */
+const harnessProblemOf = (harness) => {
+    if (typeof harness !== 'object' || harness === null || Array.isArray(harness))
+        return `harness must be { "app": "<repo path of the app>", "map": "<repo path of the generated .ts file>" }`;
+    const { app, map, shared, live, hosts, specs, baseBranch } = harness;
+    if (!isRepoPath(app))
+        return `harness.app must be a repo path, got ${JSON.stringify(app)}`;
+    if (!isRepoPath(map) || !map.endsWith('.ts') || map.endsWith('.d.ts'))
+        return `harness.map must be the repo path of a .ts file, got ${JSON.stringify(map)}`;
+    const inside = path_1.posix.relative(path_1.posix.normalize(app), path_1.posix.normalize(map));
+    if (inside.startsWith('..'))
+        return `harness.map ${map} must lie inside harness.app ${app}`;
+    if (live !== undefined &&
+        (!isRepoPath(live) ||
+            !live.endsWith('.json') ||
+            path_1.posix.relative(path_1.posix.normalize(app), path_1.posix.normalize(live)).startsWith('..')))
+        return `harness.live must be the repo path of a .json file inside harness.app ${app}, got ${JSON.stringify(live)}`;
+    if (hosts !== undefined &&
+        (!Array.isArray(hosts) || hosts.some((host) => typeof host !== 'string' || host === '' || /\s/.test(host))))
+        return `harness.hosts must be a list of accessible names without whitespace, got ${JSON.stringify(hosts)}`;
+    if (specs !== undefined && !isRepoPath(specs))
+        return `harness.specs must be the repo path of a vitest config, got ${JSON.stringify(specs)}`;
+    if (baseBranch !== undefined && (typeof baseBranch !== 'string' || baseBranch.trim() === ''))
+        return `harness.baseBranch must be a branch name, got ${JSON.stringify(baseBranch)}`;
+    if (shared === undefined)
+        return null;
+    if (!Array.isArray(shared))
+        return `harness.shared must be a list of repo paths, got ${JSON.stringify(shared)}`;
+    const outside = shared.find((path) => !isRepoPath(path) || path_1.posix.relative(path_1.posix.normalize(app), path_1.posix.normalize(path)).startsWith('..'));
+    if (outside !== undefined)
+        return `harness.shared ${JSON.stringify(outside)} must be a repo path inside harness.app ${app}`;
+    return null;
+};
+exports.harnessProblemOf = harnessProblemOf;
+/** The repo path of the first global stylesheet the harness app's `project.json` builds with, or `null`. */
+const appStylesheetOf = (options) => {
+    var _a, _b, _c;
+    const project = (0, path_1.resolve)(options.target, options.app, 'project.json');
+    if (!(0, fs_1.existsSync)(project))
+        return null;
+    const styles = (_c = (_b = (_a = JSON.parse((0, fs_1.readFileSync)(project, 'utf8')).targets) === null || _a === void 0 ? void 0 : _a.build) === null || _b === void 0 ? void 0 : _b.options) === null || _c === void 0 ? void 0 : _c.styles;
+    const first = Array.isArray(styles) ? styles.find((style) => typeof style === 'string') : undefined;
+    return first !== null && first !== void 0 ? first : null;
+};
+exports.appStylesheetOf = appStylesheetOf;
+/** Whether a repo path matches a pattern of `allowedFilesOf`: `<folder>/**`, or a path where `*` stands for one segment's characters. */
+const matchesPattern = (file, pattern) => {
+    if (pattern.endsWith('/**'))
+        return file.startsWith(pattern.slice(0, -2));
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*');
+    return new RegExp(`^${escaped}$`).test(file);
+};
+exports.matchesPattern = matchesPattern;
+//# sourceMappingURL=harness-config.js.map

package/src/lib/design/system/harness-config.js.map

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

package/src/lib/design/system/harness-inputs.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The files of the checkout a build of the app at `app` can read, from `files` (repo path to content sha): every
+ * root-level file except Markdown, the whole app folder, and every file its build sources reach through a relative
+ * path or a tsconfig `paths` alias, followed transitively. Specs, stories and test setups are inputs but not followed.
+ */
+export declare const harnessInputsOf: (options: {
+    files: ReadonlyMap<string, string>;
+    app: string;
+    read: (path: string) => string;
+}) => Map<string, string>;
+/**
+ * Whether an incremental Angular watch build of `app` misses a change of the input `path`: configs, root-level files
+ * and files under dot folders, which its watcher ignores.
+ */
+export declare const restartsWatchBuild: (path: string) => boolean;
+/** Reads a repo path of the checkout at `root`. */
+export declare const repoReaderOf: (root: string) => (path: string) => string;

package/src/lib/design/system/harness-inputs.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repoReaderOf = exports.restartsWatchBuild = exports.harnessInputsOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const typescript_1 = __importDefault(require("typescript"));
+const SCANNED = /\.(?:[cm]?[jt]s|css|scss|html)$/u;
+const SCRIPT = /\.[cm]?[jt]s$/u;
+const UNBUILT = /(?:\.(?:spec|test|stories)\.[cm]?[jt]s|(?:^|\/)(?:test-setup|(?:eslint|vite|vitest|jest|playwright|karma)\.config)\.[cm]?[jt]s)$|(?:^|\/)(?:e2e|src-tauri)\//u;
+const SPECIFIER = /["'`]([^"'`\s]+)["'`]/gu;
+const RELATIVE = /["'`](\.{1,2}\/[^"'`\s]*)["'`]/gu;
+const SUFFIXES = ['', '.ts', '.mts', '.js', '.mjs', '.css', '.scss', '.json', '/index.ts', '/index.js'];
+const CONFIGS = /(?:^|\/)(?:tsconfig[^/]*\.json|project\.json|package\.json)$/u;
+const specifiersBySha = new Map();
+const scannedOf = (path, source) => SCRIPT.test(path)
+    ? [
+        ...typescript_1.default.preProcessFile(source, true, true).importedFiles.map((file) => file.fileName),
+        ...[...source.matchAll(RELATIVE)].map((match) => match[1]),
+    ]
+    : [...source.matchAll(SPECIFIER)].map((match) => match[1]);
+const specifiersOf = (options) => {
+    const { path, sha, read } = options;
+    let found = specifiersBySha.get(sha);
+    if (!found) {
+        found = [...new Set(scannedOf(path, read()))];
+        specifiersBySha.set(sha, found);
+    }
+    return found;
+};
+const jsonOf = (path, read) => {
+    try {
+        return typescript_1.default.parseConfigFileTextToJson(path, read(path)).config;
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const pathsOf = (options) => {
+    var _a, _b, _c;
+    const paths = [];
+    for (const config of options.configs) {
+        if (!options.has(config))
+            continue;
+        const compilerOptions = (_a = jsonOf(config, options.read)) === null || _a === void 0 ? void 0 : _a['compilerOptions'];
+        const base = path_1.posix.join(path_1.posix.dirname(config), (_b = compilerOptions === null || compilerOptions === void 0 ? void 0 : compilerOptions.baseUrl) !== null && _b !== void 0 ? _b : '.');
+        for (const [pattern, targets] of Object.entries((_c = compilerOptions === null || compilerOptions === void 0 ? void 0 : compilerOptions.paths) !== null && _c !== void 0 ? _c : {}))
+            paths.push({ pattern, targets: targets.map((target) => path_1.posix.join(base, target)) });
+    }
+    return paths;
+};
+const mappedOf = (paths, specifier) => paths.flatMap(({ pattern, targets }) => {
+    const star = pattern.indexOf('*');
+    if (star === -1)
+        return pattern === specifier ? targets : [];
+    if (!specifier.startsWith(pattern.slice(0, star)) || !specifier.endsWith(pattern.slice(star + 1)))
+        return [];
+    const matched = specifier.slice(star, specifier.length - (pattern.length - star - 1));
+    return targets.map((target) => target.replace('*', matched));
+});
+/**
+ * The files of the checkout a build of the app at `app` can read, from `files` (repo path to content sha): every
+ * root-level file except Markdown, the whole app folder, and every file its build sources reach through a relative
+ * path or a tsconfig `paths` alias, followed transitively. Specs, stories and test setups are inputs but not followed.
+ */
+const harnessInputsOf = (options) => {
+    var _a, _b, _c, _d, _e, _f;
+    const { files, read } = options;
+    const app = path_1.posix.normalize(options.app).replace(/\/$/u, '');
+    const has = (path) => files.has(path);
+    const paths = pathsOf({
+        configs: ['tsconfig.base.json', 'tsconfig.json', `${app}/tsconfig.json`, `${app}/tsconfig.app.json`],
+        read,
+        has,
+    });
+    const all = [...files.keys()];
+    const dirs = new Set();
+    const single = new Set();
+    const queue = [];
+    const inDir = (path) => {
+        for (let dir = path_1.posix.dirname(path); dir !== '.'; dir = path_1.posix.dirname(dir))
+            if (dirs.has(dir))
+                return true;
+        return false;
+    };
+    const addFile = (path) => {
+        if (single.has(path) || inDir(path))
+            return;
+        single.add(path);
+        queue.push(path);
+    };
+    const addDir = (dir) => {
+        if (dirs.has(dir) || inDir(`${dir}/.`))
+            return;
+        dirs.add(dir);
+        for (const path of all)
+            if (path.startsWith(`${dir}/`))
+                queue.push(path);
+    };
+    const folders = new Set();
+    for (const path of all)
+        for (let dir = path_1.posix.dirname(path); dir !== '.'; dir = path_1.posix.dirname(dir))
+            folders.add(dir);
+    const reach = (target) => {
+        const path = target.replace(/\/+$/u, '');
+        if (path.startsWith('..') || path === '.' || path === '')
+            return;
+        const file = SUFFIXES.map((suffix) => `${path}${suffix}`).find(has);
+        if (file)
+            addFile(file);
+        else if (folders.has(path))
+            addDir(path);
+    };
+    for (const path of all)
+        if (!path.includes('/') && !path.endsWith('.md'))
+            single.add(path);
+    addDir(app);
+    const project = jsonOf(`${app}/project.json`, read);
+    for (const input of (_c = (_b = (_a = project === null || project === void 0 ? void 0 : project.targets) === null || _a === void 0 ? void 0 : _a.build) === null || _b === void 0 ? void 0 : _b.inputs) !== null && _c !== void 0 ? _c : [])
+        if (typeof input === 'string' && input.startsWith('{workspaceRoot}/') && !/[*{]/u.test(input.slice(16)))
+            reach(path_1.posix.normalize(input.slice(16)));
+    for (const value of Object.values((_f = (_e = (_d = project === null || project === void 0 ? void 0 : project.targets) === null || _d === void 0 ? void 0 : _d.build) === null || _e === void 0 ? void 0 : _e.options) !== null && _f !== void 0 ? _f : {}))
+        for (const entry of [value].flat())
+            if (typeof entry === 'string' && entry.length > 0)
+                reach(path_1.posix.normalize(entry));
+    for (let path = queue.shift(); path !== undefined; path = queue.shift()) {
+        const sha = files.get(path);
+        if (sha === undefined || !SCANNED.test(path) || UNBUILT.test(path))
+            continue;
+        for (const specifier of specifiersOf({ path, sha, read: () => read(path) })) {
+            if (specifier.startsWith('./') || specifier.startsWith('../')) {
+                reach(path_1.posix.join(path_1.posix.dirname(path), specifier.replace(/[?#].*$/u, '')));
+                continue;
+            }
+            for (const mapped of mappedOf(paths, specifier))
+                reach(path_1.posix.normalize(mapped));
+        }
+    }
+    return new Map([...files].filter(([path]) => single.has(path) || inDir(path)));
+};
+exports.harnessInputsOf = harnessInputsOf;
+/**
+ * Whether an incremental Angular watch build of `app` misses a change of the input `path`: configs, root-level files
+ * and files under dot folders, which its watcher ignores.
+ */
+const restartsWatchBuild = (path) => !path.includes('/') || CONFIGS.test(path) || path.split('/').some((segment) => segment.startsWith('.'));
+exports.restartsWatchBuild = restartsWatchBuild;
+/** Reads a repo path of the checkout at `root`. */
+const repoReaderOf = (root) => (path) => {
+    try {
+        return (0, fs_1.readFileSync)(path_1.posix.join(root, path), 'utf8');
+    }
+    catch (_a) {
+        return '';
+    }
+};
+exports.repoReaderOf = repoReaderOf;
+//# sourceMappingURL=harness-inputs.js.map

package/src/lib/design/system/harness-inputs.js.map

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

package/src/lib/design/system/harness-map.d.ts

@@ -0,0 +1,44 @@
+import { DesignHarness } from '../design-config';
+import { ResolvedProduct } from './resolve-product';
+export type HarnessEntry = {
+    part: string;
+    specifier: string;
+    component: string;
+};
+/** The `harness` a product declares in config.json, `null` without one, or why it is unusable. */
+export declare const harnessOf: (product: ResolvedProduct) => DesignHarness | null | string;
+/** One entry per part whose `implements` names a component, sorted by part; a route-only link has none. */
+export declare const harnessEntriesOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+    map: string;
+}) => HarnessEntry[] | string;
+/** The unformatted source of a harness map. */
+export declare const harnessMapSourceOf: (options: {
+    product: string;
+    entries: HarnessEntry[];
+}) => string;
+export type HarnessMap = {
+    file: string;
+    text: string;
+    current: boolean;
+};
+/** The formatted harness map of a product, where it goes, and whether the file on disk already holds it. */
+export declare const harnessMapOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+}) => HarnessMap | null | string;
+export declare const writeHarnessMap: (map: HarnessMap) => void;
+/** Why compare cannot trust the product's harness map, or `null` when it is current or the product has no harness. */
+export declare const harnessStaleOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+}) => string | null;
+/**
+ * Rewrites the product's harness map when it is stale. Answers `true` when it rewrote it, `false` when it was current or the
+ * product has no harness, or why it could not, ending in the command that regenerates it.
+ */
+export declare const refreshHarnessMap: (options: {
+    target: string;
+    product: ResolvedProduct;
+}) => boolean | string;

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

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshHarnessMap = exports.harnessStaleOf = exports.writeHarnessMap = exports.harnessMapOf = exports.harnessMapSourceOf = exports.harnessEntriesOf = exports.harnessOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const harness_config_1 = require("./harness-config");
+const prettier_1 = require("./prettier");
+const resolve_product_1 = require("./resolve-product");
+const part_definition_1 = require("./sketch/part-definition");
+const ts_source_1 = require("./ts-source");
+/** The `harness` a product declares in config.json, `null` without one, or why it is unusable. */
+const harnessOf = (product) => {
+    const harness = product.config.harness;
+    if (harness === undefined)
+        return null;
+    const problem = (0, harness_config_1.harnessProblemOf)(harness);
+    return problem === null ? harness : `product "${product.name}": ${problem}`;
+};
+exports.harnessOf = harnessOf;
+const specifierOf = (options) => {
+    const path = (0, path_1.relative)((0, path_1.dirname)(options.map), options.component).split(path_1.sep).join('/').replace(/\.ts$/, '');
+    return path.startsWith('.') ? path : `./${path}`;
+};
+/** One entry per part whose `implements` names a component, sorted by part; a route-only link has none. */
+const harnessEntriesOf = (options) => {
+    var _a;
+    const { target, product, map } = options;
+    const entries = [];
+    const errors = [];
+    for (const part of product.parts) {
+        const key = (0, resolve_product_1.partKeyOf)(part);
+        const link = (0, part_definition_1.partLinkOf)(part.source);
+        if (link.kind === 'unreadable') {
+            errors.push(`${key} has an implements link that is not a literal`);
+            continue;
+        }
+        const path = link.kind === 'component' ? link.path : link.kind === 'route' ? link.component : null;
+        if (path === null)
+            continue;
+        const file = (0, path_1.resolve)(target, path);
+        if (!(0, fs_1.existsSync)(file)) {
+            errors.push(`${key} implements ${path}, which does not exist`);
+            continue;
+        }
+        const classes = (0, ts_source_1.exportedComponentClassesOf)((0, fs_1.readFileSync)(file, 'utf8'));
+        if (classes.length !== 1) {
+            errors.push(`${key} implements ${path}, which exports ${classes.length === 0 ? 'no' : classes.length} @Component classes - it needs exactly one`);
+            continue;
+        }
+        entries.push({
+            part: key,
+            specifier: specifierOf({ map: (0, path_1.resolve)(target, map), component: file }),
+            component: (_a = classes[0]) !== null && _a !== void 0 ? _a : '',
+        });
+    }
+    if (errors.length > 0)
+        return errors.join('\n');
+    return entries.sort((a, b) => (a.part < b.part ? -1 : a.part > b.part ? 1 : 0));
+};
+exports.harnessEntriesOf = harnessEntriesOf;
+/** The unformatted source of a harness map. */
+const harnessMapSourceOf = (options) => [
+    `// Generated by \`et design harness --product ${options.product}\` from the parts' implements links. Do not edit.`,
+    `import { Type } from '@angular/core';`,
+    ``,
+    `export const DESIGN_HARNESS_PARTS: Record<string, () => Promise<Type<unknown>>> = {`,
+    ...options.entries.map((entry) => `  '${entry.part}': () => import('${entry.specifier}').then((m) => m.${entry.component}),`),
+    `};`,
+    ``,
+].join('\n');
+exports.harnessMapSourceOf = harnessMapSourceOf;
+/** The formatted harness map of a product, where it goes, and whether the file on disk already holds it. */
+const harnessMapOf = (options) => {
+    const { target, product } = options;
+    const harness = (0, exports.harnessOf)(product);
+    if (harness === null || typeof harness === 'string')
+        return harness;
+    const entries = (0, exports.harnessEntriesOf)({ target, product, map: harness.map });
+    if (typeof entries === 'string')
+        return entries;
+    const file = (0, path_1.resolve)(target, harness.map);
+    const text = (0, prettier_1.formattedTextOf)({ target, file, text: (0, exports.harnessMapSourceOf)({ product: product.name, entries }) });
+    if (typeof text !== 'string')
+        return `cannot format ${harness.map}: ${text.error}`;
+    return { file, text, current: (0, fs_1.existsSync)(file) && (0, fs_1.readFileSync)(file, 'utf8') === text };
+};
+exports.harnessMapOf = harnessMapOf;
+const writeHarnessMap = (map) => {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(map.file), { recursive: true });
+    (0, fs_1.writeFileSync)(map.file, map.text);
+};
+exports.writeHarnessMap = writeHarnessMap;
+/** Why compare cannot trust the product's harness map, or `null` when it is current or the product has no harness. */
+const harnessStaleOf = (options) => {
+    const map = (0, exports.harnessMapOf)(options);
+    if (map === null)
+        return null;
+    if (typeof map === 'string')
+        return map;
+    if (map.current)
+        return null;
+    return `the harness map ${(0, path_1.relative)(options.target, map.file)} is stale - run et design harness --product ${options.product.name}`;
+};
+exports.harnessStaleOf = harnessStaleOf;
+/**
+ * Rewrites the product's harness map when it is stale. Answers `true` when it rewrote it, `false` when it was current or the
+ * product has no harness, or why it could not, ending in the command that regenerates it.
+ */
+const refreshHarnessMap = (options) => {
+    try {
+        const map = (0, exports.harnessMapOf)(options);
+        if (map === null)
+            return false;
+        if (typeof map === 'string')
+            return `${map} - fix it, then run et design harness --product ${options.product.name}`;
+        if (map.current)
+            return false;
+        (0, exports.writeHarnessMap)(map);
+        return true;
+    }
+    catch (error) {
+        return `cannot write the harness map: ${error instanceof Error ? error.message : String(error)} - run et design harness --product ${options.product.name}`;
+    }
+};
+exports.refreshHarnessMap = refreshHarnessMap;
+//# sourceMappingURL=harness-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-map.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/system/harness-map.ts"],"names":[],"mappings":";;;AAAA,2BAAwE;AACxE,+BAAuD;AAEvD,qDAAoD;AACpD,yCAA6C;AAC7C,uDAA+D;AAC/D,8DAAsD;AACtD,2CAAyD;AAIzD,kGAAkG;AAC3F,MAAM,SAAS,GAAG,CAAC,OAAwB,EAAiC,EAAE;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAEvC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,OAAO,GAAG,IAAA,iCAAgB,EAAC,OAAO,CAAC,CAAC;IAE1C,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,IAAI,MAAM,OAAO,EAAE,CAAC;AAC9E,CAAC,CAAC;AARW,QAAA,SAAS,aAQpB;AAEF,MAAM,WAAW,GAAG,CAAC,OAA2C,EAAE,EAAE;IAClE,MAAM,IAAI,GAAG,IAAA,eAAQ,EAAC,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,UAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEzG,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AACnD,CAAC,CAAC;AAEF,2GAA2G;AACpG,MAAM,gBAAgB,GAAG,CAAC,OAIhC,EAA2B,EAAE;;IAC5B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAA,2BAAS,EAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAA,4BAAU,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,+CAA+C,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAEnG,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAE5B,MAAM,IAAI,GAAG,IAAA,cAAO,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,IAAI,wBAAwB,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,sCAA0B,EAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAEvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,GAAG,GAAG,eAAe,IAAI,mBAAmB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,4CAA4C,CACrI,CAAC;YACF,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG;YACT,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,IAAA,cAAO,EAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACtE,SAAS,EAAE,MAAA,OAAO,CAAC,CAAC,CAAC,mCAAI,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAhDW,QAAA,gBAAgB,oBAgD3B;AAEF,+CAA+C;AACxC,MAAM,kBAAkB,GAAG,CAAC,OAAqD,EAAE,EAAE,CAC1F;IACE,iDAAiD,OAAO,CAAC,OAAO,mDAAmD;IACnH,uCAAuC;IACvC,EAAE;IACF,qFAAqF;IACrF,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CACpB,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,oBAAoB,KAAK,CAAC,SAAS,oBAAoB,KAAK,CAAC,SAAS,IAAI,CACtG;IACD,IAAI;IACJ,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAXF,QAAA,kBAAkB,sBAWhB;AAIf,4GAA4G;AACrG,MAAM,YAAY,GAAG,CAAC,OAAqD,EAA8B,EAAE;IAChH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpC,MAAM,OAAO,GAAG,IAAA,iBAAS,EAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEpE,MAAM,OAAO,GAAG,IAAA,wBAAgB,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAExE,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEhD,MAAM,IAAI,GAAG,IAAA,cAAO,EAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAA,0BAAe,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAA,0BAAkB,EAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAE7G,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,iBAAiB,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IAEnF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAA,eAAU,EAAC,IAAI,CAAC,IAAI,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;AAC1F,CAAC,CAAC;AAhBW,QAAA,YAAY,gBAgBvB;AAEK,MAAM,eAAe,GAAG,CAAC,GAAe,EAAE,EAAE;IACjD,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAA,kBAAa,EAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAHW,QAAA,eAAe,mBAG1B;AAEF,sHAAsH;AAC/G,MAAM,cAAc,GAAG,CAAC,OAAqD,EAAiB,EAAE;IACrG,MAAM,GAAG,GAAG,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IAElC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE7B,OAAO,mBAAmB,IAAA,eAAQ,EAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,+CAA+C,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACpI,CAAC,CAAC;AARW,QAAA,cAAc,kBAQzB;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,OAAqD,EAAoB,EAAE;IAC3G,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;QAElC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,GAAG,mDAAmD,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpH,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE9B,IAAA,uBAAe,EAAC,GAAG,CAAC,CAAC;QAErB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7J,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,iBAAiB,qBAc5B"}

package/src/lib/design/system/harness-samples.d.ts

@@ -0,0 +1,20 @@
+import { ResolvedProduct } from './resolve-product';
+/**
+ * The props the harness samples function of `part` consumes: the names its parameter destructures, or reads off it by
+ * name, in the `DESIGN_HARNESS_SAMPLES` object a source exports.
+ */
+export declare const harnessSampledPropsOf: (options: {
+    source: string;
+    part: string;
+}) => string[];
+/** The source file beside the harness map that exports `DESIGN_HARNESS_SAMPLES`, or `null` without one. */
+export declare const harnessSamplesFileOf: (options: {
+    target: string;
+    map: string;
+}) => string | null;
+/** The props of `part` the product's harness samples consume, so compare need not find an input for them. */
+export declare const productSampledPropsOf: (options: {
+    target: string;
+    product: ResolvedProduct;
+    part: string;
+}) => string[];

package/src/lib/design/system/harness-samples.js

@@ -0,0 +1,92 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productSampledPropsOf = exports.harnessSamplesFileOf = exports.harnessSampledPropsOf = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const typescript_1 = __importDefault(require("typescript"));
+const harness_map_1 = require("./harness-map");
+const ts_source_1 = require("./ts-source");
+const SAMPLES_EXPORT = 'DESIGN_HARNESS_SAMPLES';
+const samplesObjectOf = (source) => {
+    for (const statement of (0, ts_source_1.sourceFileOf)(source).statements) {
+        if (!typescript_1.default.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations)
+            if (typescript_1.default.isIdentifier(declaration.name) &&
+                declaration.name.text === SAMPLES_EXPORT &&
+                declaration.initializer &&
+                typescript_1.default.isObjectLiteralExpression(declaration.initializer))
+                return declaration.initializer;
+    }
+    return null;
+};
+const readPropsOf = (body, parameter) => {
+    const names = [];
+    const visit = (node) => {
+        if (typescript_1.default.isElementAccessExpression(node) && typescript_1.default.isIdentifier(node.expression) && node.expression.text === parameter) {
+            if (typescript_1.default.isStringLiteralLike(node.argumentExpression))
+                names.push(node.argumentExpression.text);
+        }
+        else if (typescript_1.default.isPropertyAccessExpression(node) &&
+            typescript_1.default.isIdentifier(node.expression) &&
+            node.expression.text === parameter)
+            names.push(node.name.text);
+        typescript_1.default.forEachChild(node, visit);
+    };
+    visit(body);
+    return names;
+};
+/**
+ * The props the harness samples function of `part` consumes: the names its parameter destructures, or reads off it by
+ * name, in the `DESIGN_HARNESS_SAMPLES` object a source exports.
+ */
+const harnessSampledPropsOf = (options) => {
+    var _a;
+    const samples = samplesObjectOf(options.source);
+    const property = samples === null || samples === void 0 ? void 0 : samples.properties.find((candidate) => typescript_1.default.isPropertyAssignment(candidate) &&
+        (typescript_1.default.isStringLiteralLike(candidate.name) || typescript_1.default.isIdentifier(candidate.name)) &&
+        candidate.name.text === options.part);
+    const sample = property === null || property === void 0 ? void 0 : property.initializer;
+    if (!sample || !(typescript_1.default.isArrowFunction(sample) || typescript_1.default.isFunctionExpression(sample)))
+        return [];
+    const parameter = (_a = sample.parameters[0]) === null || _a === void 0 ? void 0 : _a.name;
+    if (!parameter)
+        return [];
+    if (typescript_1.default.isIdentifier(parameter))
+        return [...new Set(readPropsOf(sample.body, parameter.text))];
+    if (!typescript_1.default.isObjectBindingPattern(parameter))
+        return [];
+    return parameter.elements.flatMap((element) => {
+        var _a;
+        if (element.dotDotDotToken)
+            return [];
+        const name = (_a = element.propertyName) !== null && _a !== void 0 ? _a : element.name;
+        return typescript_1.default.isIdentifier(name) || typescript_1.default.isStringLiteralLike(name) ? [name.text] : [];
+    });
+};
+exports.harnessSampledPropsOf = harnessSampledPropsOf;
+/** The source file beside the harness map that exports `DESIGN_HARNESS_SAMPLES`, or `null` without one. */
+const harnessSamplesFileOf = (options) => {
+    const dir = (0, path_1.dirname)((0, path_1.resolve)(options.target, options.map));
+    if (!(0, fs_1.existsSync)(dir))
+        return null;
+    const file = (0, fs_1.readdirSync)(dir)
+        .filter((name) => name.endsWith('.ts') && !name.endsWith('.spec.ts'))
+        .map((name) => (0, path_1.join)(dir, name))
+        .find((path) => samplesObjectOf((0, fs_1.readFileSync)(path, 'utf8')) !== null);
+    return file !== null && file !== void 0 ? file : null;
+};
+exports.harnessSamplesFileOf = harnessSamplesFileOf;
+/** The props of `part` the product's harness samples consume, so compare need not find an input for them. */
+const productSampledPropsOf = (options) => {
+    const harness = (0, harness_map_1.harnessOf)(options.product);
+    if (harness === null || typeof harness === 'string')
+        return [];
+    const file = (0, exports.harnessSamplesFileOf)({ target: options.target, map: harness.map });
+    return file === null ? [] : (0, exports.harnessSampledPropsOf)({ source: (0, fs_1.readFileSync)(file, 'utf8'), part: options.part });
+};
+exports.productSampledPropsOf = productSampledPropsOf;
+//# sourceMappingURL=harness-samples.js.map

package/src/lib/design/system/harness-samples.js.map

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

package/src/lib/design/system/harness-server.d.ts

@@ -0,0 +1,51 @@
+import { Server } from 'http';
+import { ResolvedProduct } from './resolve-product';
+export declare const RESERVED_PORTS: readonly number[];
+/** A served harness app; `root` is the folder of built files it serves, absent for a dev server. */
+export type HarnessServer = {
+    url: string;
+    stop: () => Promise<void>;
+    root?: string;
+};
+export type StartHarnessServer = (options: {
+    target: string;
+    product: ResolvedProduct;
+}) => Promise<HarnessServer | string>;
+export type BuildCommandOf = (options: {
+    target: string;
+    project: string;
+    outputPath: string;
+}) => {
+    command: string;
+    args: string[];
+};
+/** A free local port the OS hands out, never one of the `RESERVED_PORTS` the user's own servers use. */
+export declare const freePortOf: (probe?: () => Promise<number>) => Promise<number>;
+export declare const NX_BUSY: RegExp;
+export declare const nxBuildCommandOf: BuildCommandOf;
+export declare const killGroup: (pid: number, signal: NodeJS.Signals) => void;
+export declare const stopGroup: (pid: number) => Promise<void>;
+export declare const projectOf: (target: string, app: string) => string | {
+    name: string;
+};
+export declare const servingOf: (url: string) => Promise<boolean>;
+export declare const serveStatic: (root: string, port: number) => Promise<Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>>;
+/**
+ * Builds the product's harness app in development mode and serves it on a free port, answering unknown paths with its
+ * index.html. Reuses the last build while no input of it changed. The caller must `stop` it.
+ */
+export declare const startHarnessServer: (options: {
+    target: string;
+    product: ResolvedProduct;
+    commandOf?: BuildCommandOf;
+    timeout?: number;
+    cacheDir?: string;
+}) => Promise<HarnessServer | string>;
+/** Runs `run` with `url`, or without one with the URL of a harness server it starts and always stops afterwards. */
+export declare const withHarnessUrl: <T>(options: {
+    target: string;
+    product: ResolvedProduct;
+    url: string | undefined;
+    start?: StartHarnessServer;
+    run: (url: string, root: string | null) => Promise<T>;
+}) => Promise<T | string>;