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

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-map.d.ts

@@ -0,0 +1,44 @@
+import { DesignHarness } from '../paths';
+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":"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"}

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,40 @@
+import { ResolvedProduct } from './resolve-product';
+export declare const RESERVED_PORTS: readonly number[];
+export type HarnessServer = {
+    url: string;
+    stop: () => Promise<void>;
+};
+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 nxBuildCommandOf: BuildCommandOf;
+/**
+ * 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) => Promise<T>;
+}) => Promise<T | string>;