@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/src/lib/utils/project-json-files.d.ts

@@ -0,0 +1,23 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Every project.json in the tree (any depth; skips build output, node_modules and dot folders).
+ * Walks the tree instead of getProjects(), which needs Nx's native file globbing.
+ */
+export declare function projectJsonFiles(tree: Tree, dir?: string): string[];
+export interface ReadProject {
+    /** project.json name, else its folder name. */
+    name: string;
+    /** Folder of the project.json. */
+    root: string;
+    json: Record<string, unknown>;
+}
+/**
+ * Every project of the tree with its name; throws naming the file when a project.json cannot be
+ * read (JSON with comments is fine) and when two projects share a name.
+ */
+export declare function readProjects(tree: Tree): ReadProject[];
+/**
+ * Like readProjects, but never throws: unreadable project.json files (templates, broken JSON)
+ * are skipped and duplicate names are kept. For best-effort scans (ports, shared folders).
+ */
+export declare function scanProjects(tree: Tree): ReadProject[];

package/dist/src/lib/utils/project-json-files.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanProjects = exports.readProjects = exports.projectJsonFiles = void 0;
+const devkit_1 = require("@nx/devkit");
+const SKIP = new Set(['node_modules', 'dist', 'tmp', 'coverage']);
+/**
+ * Every project.json in the tree (any depth; skips build output, node_modules and dot folders).
+ * Walks the tree instead of getProjects(), which needs Nx's native file globbing.
+ */
+function projectJsonFiles(tree, dir = '') {
+    const out = [];
+    for (const child of tree.children(dir)) {
+        const rel = dir ? `${dir}/${child}` : child;
+        if (tree.isFile(rel)) {
+            if (child === 'project.json')
+                out.push(rel);
+        }
+        else if (!SKIP.has(child) && !child.startsWith('.')) {
+            out.push(...projectJsonFiles(tree, rel));
+        }
+    }
+    return out;
+}
+exports.projectJsonFiles = projectJsonFiles;
+/**
+ * Every project of the tree with its name; throws naming the file when a project.json cannot be
+ * read (JSON with comments is fine) and when two projects share a name.
+ */
+function readProjects(tree) {
+    const seen = new Map();
+    return projectJsonFiles(tree).map((file) => {
+        const root = file.slice(0, -'/project.json'.length) || '.';
+        let json;
+        try {
+            json = (0, devkit_1.readJson)(tree, file);
+        }
+        catch (err) {
+            throw new Error(`${file}: ${err.message.split('\n')[0]}`);
+        }
+        const name = typeof json['name'] === 'string' ? json['name'] : root.split('/').pop() ?? root;
+        const other = seen.get(name);
+        if (other !== undefined) {
+            throw new Error(`two projects are named "${name}" (${other}, ${root}); set "name" in one`);
+        }
+        seen.set(name, root);
+        return { name, root, json };
+    });
+}
+exports.readProjects = readProjects;
+/**
+ * Like readProjects, but never throws: unreadable project.json files (templates, broken JSON)
+ * are skipped and duplicate names are kept. For best-effort scans (ports, shared folders).
+ */
+function scanProjects(tree) {
+    const out = [];
+    for (const file of projectJsonFiles(tree)) {
+        const root = file.slice(0, -'/project.json'.length) || '.';
+        let json;
+        try {
+            json = (0, devkit_1.readJson)(tree, file);
+        }
+        catch {
+            continue;
+        }
+        if (typeof json !== 'object' || json === null || Array.isArray(json))
+            continue;
+        const name = typeof json['name'] === 'string' ? json['name'] : root.split('/').pop() ?? root;
+        out.push({ name, root, json });
+    }
+    return out;
+}
+exports.scanProjects = scanProjects;
+//# sourceMappingURL=project-json-files.js.map

package/dist/src/lib/utils/project-json-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-json-files.js","sourceRoot":"","sources":["../../../../src/lib/utils/project-json-files.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/utils/quality.d.ts

@@ -0,0 +1,71 @@
+import { Tree } from '@nx/devkit';
+import { Deps } from './dependencies';
+/** `typecheck` target: tsc without output over the project's app or lib tsconfig. */
+export declare function typecheckTarget(tsconfig: string): {
+    executor: string;
+    options: {
+        command: string;
+    };
+};
+/** The tsconfig a project's typecheck uses (tsconfig.app.json, else tsconfig.lib.json), if any. */
+export declare function typecheckTsconfig(tree: Tree, root: string): string | undefined;
+/** Adds a typecheck target to the project at `root` when it has none; returns whether it did. */
+export declare function addTypecheckTarget(tree: Tree, root: string): boolean;
+/** Adds typecheck targets to every project that has a tsconfig.app/lib.json and no target. */
+export declare function addTypecheckTargets(tree: Tree): string[];
+export declare const TYPECHECK_TARGET_DEFAULTS: {
+    cache: boolean;
+    inputs: string[];
+};
+/** nx.json: typecheck cached (targetDefaults, and cacheableOperations when the workspace uses them). */
+export declare function addTypecheckNxDefaults(tree: Tree): boolean;
+export declare const CI_FILES: string[];
+/** Adds typecheck to the affected step of the CI files; returns [changed, without the step]. */
+export declare function addTypecheckToCi(tree: Tree): {
+    changed: string[];
+    unknown: string[];
+};
+export declare const QUALITY_RULES: {
+    readonly 'import/no-unresolved': "warn";
+    readonly 'unused-imports/no-unused-imports': "warn";
+};
+export declare const QUALITY_ESLINT_OVERRIDE: {
+    files: string[];
+    plugins: string[];
+    settings: {
+        'import/resolver': {
+            typescript: {
+                alwaysTryTypes: boolean;
+                project: string;
+            };
+        };
+    };
+    rules: {
+        'import/no-unresolved': "warn";
+        'unused-imports/no-unused-imports': "warn";
+    };
+};
+export type EslintResult = 'added' | 'present' | 'no-json-config' | 'has-comments';
+/** Adds the quality override to the root .eslintrc.json unless one of its rules is configured. */
+export declare function addQualityEslintRules(tree: Tree): EslintResult;
+/** eslint-plugin-unused-imports major matching @typescript-eslint (its peer). */
+export declare function unusedImportsVersion(tree: Tree): string;
+/** Packages the quality ESLint override needs. */
+export declare function qualityEslintDependencies(tree: Tree): Deps;
+export declare const LINT_STAGED_ESLINT_SCRIPT = "tools/scripts/lint-staged-eslint.js";
+export declare const LINT_STAGED_MODES: readonly ["warn", "block"];
+export type LintStagedMode = (typeof LINT_STAGED_MODES)[number];
+/** The ESLint step of each mode (extra flags are appended). */
+export declare const LINT_STAGED_ESLINT_COMMAND: Record<LintStagedMode, string>;
+/**
+ * Runs the workspace's ESLint (never npx or a shell: paths with spaces stay one argument) on the
+ * staged files. Lint problems (exit 1) are reported without blocking the commit; ESLint that
+ * cannot be found or crashes (exit 2) still blocks.
+ */
+export declare const LINT_STAGED_ESLINT_JS = "#!/usr/bin/env node\n// Written by nx-polystack. lint-staged runs it for staged *.ts files: ESLint fixes what it can and\n// reports the rest without blocking the commit.\nconst { spawnSync } = require('child_process');\n\nconst args = process.argv.slice(2);\nif (!args.some((a) => !a.startsWith('-'))) process.exit(0);\nlet eslint;\ntry {\n  eslint = require.resolve('eslint/bin/eslint.js', { paths: [process.cwd()] });\n} catch {\n  console.error('lint-staged-eslint: ESLint is not installed in this workspace (npm install).');\n  process.exit(2);\n}\nconst r = spawnSync(process.execPath, [eslint, ...args], { stdio: 'inherit' });\nif (r.error) {\n  console.error('lint-staged-eslint: could not run ESLint: ' + r.error.message);\n  process.exit(2);\n}\nif (r.status === 1) {\n  console.warn(\n    '\\nESLint found problems (shown above); the commit is not blocked. ' +\n      'To block commits on ESLint errors: pstack infra --lint-staged=block',\n  );\n  process.exit(0);\n}\nprocess.exit(r.status === null ? 2 : r.status);\n";
+export type LintStagedResult = 'set' | 'unchanged' | 'other-config' | 'no-config' | 'no-eslint-step';
+/**
+ * Switches the ESLint steps of the package.json lint-staged config to the mode, keeping their
+ * other flags and every other command (and writes the warn script).
+ */
+export declare function setLintStagedMode(tree: Tree, mode: LintStagedMode): LintStagedResult;

package/dist/src/lib/utils/quality.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLintStagedMode = exports.LINT_STAGED_ESLINT_JS = exports.LINT_STAGED_ESLINT_COMMAND = exports.LINT_STAGED_MODES = exports.LINT_STAGED_ESLINT_SCRIPT = exports.qualityEslintDependencies = exports.unusedImportsVersion = exports.addQualityEslintRules = exports.QUALITY_ESLINT_OVERRIDE = exports.QUALITY_RULES = exports.addTypecheckToCi = exports.CI_FILES = exports.addTypecheckNxDefaults = exports.TYPECHECK_TARGET_DEFAULTS = exports.addTypecheckTargets = exports.addTypecheckTarget = exports.typecheckTsconfig = exports.typecheckTarget = void 0;
+const devkit_1 = require("@nx/devkit");
+const dependencies_1 = require("./dependencies");
+const lint_staged_1 = require("./lint-staged");
+const project_json_files_1 = require("./project-json-files");
+// ── typecheck ────────────────────────────────────────────────────────────────
+/** `typecheck` target: tsc without output over the project's app or lib tsconfig. */
+function typecheckTarget(tsconfig) {
+    return {
+        executor: 'nx:run-commands',
+        options: { command: `tsc --noEmit -p ${tsconfig}` },
+    };
+}
+exports.typecheckTarget = typecheckTarget;
+/** The tsconfig a project's typecheck uses (tsconfig.app.json, else tsconfig.lib.json), if any. */
+function typecheckTsconfig(tree, root) {
+    const base = root === '.' ? '' : `${root}/`;
+    return [`${base}tsconfig.app.json`, `${base}tsconfig.lib.json`].find((f) => tree.exists(f));
+}
+exports.typecheckTsconfig = typecheckTsconfig;
+/** Adds a typecheck target to the project at `root` when it has none; returns whether it did. */
+function addTypecheckTarget(tree, root) {
+    const file = root === '.' ? 'project.json' : `${root}/project.json`;
+    const tsconfig = typecheckTsconfig(tree, root);
+    if (!tsconfig || !tree.exists(file))
+        return false;
+    let json;
+    try {
+        json = (0, devkit_1.readJson)(tree, file); // project.json may hold comments
+    }
+    catch {
+        return false;
+    }
+    const targets = (json['targets'] ?? {});
+    if (targets['typecheck'] !== undefined)
+        return false;
+    json['targets'] = { ...targets, typecheck: typecheckTarget(tsconfig) };
+    tree.write(file, JSON.stringify(json, null, 2) + '\n');
+    return true;
+}
+exports.addTypecheckTarget = addTypecheckTarget;
+/** Adds typecheck targets to every project that has a tsconfig.app/lib.json and no target. */
+function addTypecheckTargets(tree) {
+    return (0, project_json_files_1.scanProjects)(tree)
+        .filter((p) => addTypecheckTarget(tree, p.root))
+        .map((p) => p.name);
+}
+exports.addTypecheckTargets = addTypecheckTargets;
+exports.TYPECHECK_TARGET_DEFAULTS = {
+    cache: true,
+    inputs: [
+        'default',
+        '^production',
+        '{workspaceRoot}/tsconfig.base.json',
+        // App env files live in the workspace-root environments/ folder (no project owns them).
+        '{workspaceRoot}/environments/**/*',
+    ],
+};
+/** nx.json: typecheck cached (targetDefaults, and cacheableOperations when the workspace uses them). */
+function addTypecheckNxDefaults(tree) {
+    if (!tree.exists('nx.json'))
+        return false;
+    let nx; // eslint-disable-line @typescript-eslint/no-explicit-any
+    try {
+        nx = (0, devkit_1.readJson)(tree, 'nx.json');
+    }
+    catch {
+        return false;
+    }
+    let changed = false;
+    nx['targetDefaults'] = nx['targetDefaults'] ?? {};
+    if (nx['targetDefaults']['typecheck'] === undefined) {
+        // Nx refuses an input it does not know: ^production only when the workspace defines it.
+        const named = (nx['namedInputs'] ?? {});
+        const own = named['default'] ? 'default' : '{projectRoot}/**/*';
+        const deps = named['production'] ? ['^production'] : named['default'] ? ['^default'] : [];
+        const rest = exports.TYPECHECK_TARGET_DEFAULTS.inputs.filter((i) => i.startsWith('{workspaceRoot}'));
+        nx['targetDefaults']['typecheck'] = { cache: true, inputs: [own, ...deps, ...rest] };
+        changed = true;
+    }
+    for (const runner of Object.values(nx['tasksRunnerOptions'] ?? {})) {
+        // eslint-disable-line @typescript-eslint/no-explicit-any
+        const ops = runner?.['options']?.['cacheableOperations'];
+        if (Array.isArray(ops) && !ops.includes('typecheck')) {
+            ops.push('typecheck');
+            changed = true;
+        }
+    }
+    if (changed)
+        tree.write('nx.json', JSON.stringify(nx, null, 2) + '\n');
+    return changed;
+}
+exports.addTypecheckNxDefaults = addTypecheckNxDefaults;
+// ── CI ───────────────────────────────────────────────────────────────────────
+exports.CI_FILES = ['.github/workflows/ci.yml', 'Jenkinsfile'];
+const AFFECTED_STEP = /nx affected -t lint test build\b/;
+/** Adds typecheck to the affected step of the CI files; returns [changed, without the step]. */
+function addTypecheckToCi(tree) {
+    const changed = [];
+    const unknown = [];
+    for (const file of exports.CI_FILES) {
+        const text = tree.read(file, 'utf8');
+        if (text === null)
+            continue;
+        if (/nx affected[^\n]*-t [^\n]*typecheck/.test(text))
+            continue;
+        if (!AFFECTED_STEP.test(text)) {
+            unknown.push(file);
+            continue;
+        }
+        tree.write(file, text.replace(new RegExp(AFFECTED_STEP.source, 'g'), 'nx affected -t lint typecheck test build'));
+        changed.push(file);
+    }
+    return { changed, unknown };
+}
+exports.addTypecheckToCi = addTypecheckToCi;
+// ── ESLint ───────────────────────────────────────────────────────────────────
+exports.QUALITY_RULES = {
+    'import/no-unresolved': 'warn',
+    'unused-imports/no-unused-imports': 'warn',
+};
+exports.QUALITY_ESLINT_OVERRIDE = {
+    files: ['*.ts', '*.tsx'],
+    plugins: ['import', 'unused-imports'],
+    settings: {
+        'import/resolver': { typescript: { alwaysTryTypes: true, project: 'tsconfig.base.json' } },
+    },
+    rules: { ...exports.QUALITY_RULES },
+};
+/** ESLint config files other than .eslintrc.json that the override cannot be merged into. */
+const OTHER_ESLINT_CONFIGS = [
+    '.eslintrc.js',
+    '.eslintrc.cjs',
+    '.eslintrc.yaml',
+    '.eslintrc.yml',
+    '.eslintrc',
+    'eslint.config.js',
+    'eslint.config.mjs',
+    'eslint.config.cjs',
+];
+/** Adds the quality override to the root .eslintrc.json unless one of its rules is configured. */
+function addQualityEslintRules(tree) {
+    const text = tree.read('.eslintrc.json', 'utf8');
+    if (text === null) {
+        return OTHER_ESLINT_CONFIGS.some((f) => tree.exists(f)) ? 'no-json-config' : 'present';
+    }
+    if (Object.keys(exports.QUALITY_RULES).some((rule) => text.includes(`"${rule}"`)))
+        return 'present';
+    let config;
+    try {
+        config = JSON.parse(text);
+    }
+    catch {
+        try {
+            (0, devkit_1.parseJson)(text);
+            return 'has-comments'; // valid with comments: rewriting would drop them
+        }
+        catch {
+            return 'no-json-config';
+        }
+    }
+    const overrides = Array.isArray(config['overrides']) ? config['overrides'] : [];
+    const override = JSON.parse(JSON.stringify(exports.QUALITY_ESLINT_OVERRIDE));
+    // Angular CLI style workspaces keep their paths in tsconfig.json.
+    if (!tree.exists('tsconfig.base.json') && tree.exists('tsconfig.json')) {
+        override.settings['import/resolver'].typescript.project = 'tsconfig.json';
+    }
+    overrides.push(override);
+    config['overrides'] = overrides;
+    tree.write('.eslintrc.json', JSON.stringify(config, null, 2) + '\n');
+    return 'added';
+}
+exports.addQualityEslintRules = addQualityEslintRules;
+/** eslint-plugin-unused-imports major matching @typescript-eslint (its peer). */
+function unusedImportsVersion(tree) {
+    const ts = ['@typescript-eslint/eslint-plugin', '@typescript-eslint/parser', 'typescript-eslint']
+        .map((p) => (0, dependencies_1.declaredVersion)(tree, p))
+        .find((v) => v !== undefined && /\d/.test(v)) ?? '';
+    const major = Number(/(\d+)/.exec(ts)?.[1] ?? '5');
+    if (major >= 8)
+        return '^4.1.4';
+    if (major >= 6)
+        return '^3.2.0';
+    return '^2.0.0';
+}
+exports.unusedImportsVersion = unusedImportsVersion;
+/** Packages the quality ESLint override needs. */
+function qualityEslintDependencies(tree) {
+    return {
+        'eslint-plugin-import': '^2.29.1',
+        'eslint-import-resolver-typescript': '^3.6.1',
+        'eslint-plugin-unused-imports': unusedImportsVersion(tree),
+    };
+}
+exports.qualityEslintDependencies = qualityEslintDependencies;
+// ── lint-staged ──────────────────────────────────────────────────────────────
+exports.LINT_STAGED_ESLINT_SCRIPT = 'tools/scripts/lint-staged-eslint.js';
+exports.LINT_STAGED_MODES = ['warn', 'block'];
+/** The ESLint step of each mode (extra flags are appended). */
+exports.LINT_STAGED_ESLINT_COMMAND = {
+    warn: `node ${exports.LINT_STAGED_ESLINT_SCRIPT} --fix`,
+    block: 'eslint --fix',
+};
+/**
+ * Runs the workspace's ESLint (never npx or a shell: paths with spaces stay one argument) on the
+ * staged files. Lint problems (exit 1) are reported without blocking the commit; ESLint that
+ * cannot be found or crashes (exit 2) still blocks.
+ */
+exports.LINT_STAGED_ESLINT_JS = `#!/usr/bin/env node
+// Written by nx-polystack. lint-staged runs it for staged *.ts files: ESLint fixes what it can and
+// reports the rest without blocking the commit.
+const { spawnSync } = require('child_process');
+
+const args = process.argv.slice(2);
+if (!args.some((a) => !a.startsWith('-'))) process.exit(0);
+let eslint;
+try {
+  eslint = require.resolve('eslint/bin/eslint.js', { paths: [process.cwd()] });
+} catch {
+  console.error('lint-staged-eslint: ESLint is not installed in this workspace (npm install).');
+  process.exit(2);
+}
+const r = spawnSync(process.execPath, [eslint, ...args], { stdio: 'inherit' });
+if (r.error) {
+  console.error('lint-staged-eslint: could not run ESLint: ' + r.error.message);
+  process.exit(2);
+}
+if (r.status === 1) {
+  console.warn(
+    '\\nESLint found problems (shown above); the commit is not blocked. ' +
+      'To block commits on ESLint errors: pstack infra --lint-staged=block',
+  );
+  process.exit(0);
+}
+process.exit(r.status === null ? 2 : r.status);
+`;
+/** An ESLint step of lint-staged: [prefix, extra flags], or null. */
+function eslintStep(cmd) {
+    const script = new RegExp(`^node\\s+(?:\\./)?${exports.LINT_STAGED_ESLINT_SCRIPT.replace(/[./]/g, '\\$&')}(?=\\s|$)`);
+    const m = script.exec(cmd) ?? /^(?:npx\s+(?:--no-install\s+|--no\s+)?)?eslint(?=\s|$)/.exec(cmd);
+    if (!m)
+        return null;
+    return cmd
+        .slice(m[0].length)
+        .trim()
+        .split(/\s+/)
+        .filter((f) => f && f !== '--fix')
+        .join(' ');
+}
+/**
+ * Switches the ESLint steps of the package.json lint-staged config to the mode, keeping their
+ * other flags and every other command (and writes the warn script).
+ */
+function setLintStagedMode(tree, mode) {
+    if (!tree.exists('package.json'))
+        return 'no-config';
+    const pkg = JSON.parse(tree.read('package.json', 'utf8') ?? '{}');
+    const config = pkg['lint-staged'];
+    if (config === undefined)
+        return (0, lint_staged_1.hasLintStagedConfig)(tree) ? 'other-config' : 'no-config';
+    if (typeof config !== 'object' || config === null || Array.isArray(config))
+        return 'other-config';
+    let changed = false;
+    let found = false;
+    for (const [glob, cmds] of Object.entries(config)) {
+        const list = Array.isArray(cmds) ? cmds : [cmds];
+        const next = list.map((c) => {
+            if (typeof c !== 'string')
+                return c;
+            const flags = eslintStep(c.trim());
+            if (flags === null)
+                return c;
+            found = true;
+            return [exports.LINT_STAGED_ESLINT_COMMAND[mode], flags].filter(Boolean).join(' ');
+        });
+        if (JSON.stringify(next) !== JSON.stringify(list)) {
+            config[glob] = Array.isArray(cmds) ? next : next[0];
+            changed = true;
+        }
+    }
+    if (!found)
+        return 'no-eslint-step';
+    if (mode === 'warn' && tree.read(exports.LINT_STAGED_ESLINT_SCRIPT, 'utf8') !== exports.LINT_STAGED_ESLINT_JS) {
+        tree.write(exports.LINT_STAGED_ESLINT_SCRIPT, exports.LINT_STAGED_ESLINT_JS);
+        changed = true;
+    }
+    if (!changed)
+        return 'unchanged';
+    tree.write('package.json', JSON.stringify(pkg, null, 2) + '\n');
+    return 'set';
+}
+exports.setLintStagedMode = setLintStagedMode;
+//# sourceMappingURL=quality.js.map

package/dist/src/lib/utils/quality.js.map

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

package/dist/src/lib/utils/serve-port.d.ts

@@ -0,0 +1,28 @@
+import { Tree } from '@nx/devkit';
+/** Port Angular's dev-server and the flutter-build serve use when none is set. */
+export declare const DEFAULT_SERVE_PORT = 4200;
+type Target = {
+    executor?: string;
+    options?: Record<string, unknown>;
+};
+/** Angular/Ionic dev-server (Angular CLI or @nx/angular builder) or a Flutter serve target. */
+export declare function isServeTarget(target: Target | undefined): boolean;
+/** The serve target of a project.json (the `serve` target first, else any serve-like target). */
+export declare function serveTargetOf(json: Record<string, unknown>): Target | undefined;
+/** The port a serve target listens on (4200 when unset or not a number). */
+export declare function portOf(target: Target): number;
+/** The port set on a serve target (a number or a numeric string), else undefined. */
+export declare function explicitPort(target: Target): number | undefined;
+export interface UsedPort {
+    project: string;
+    port: number;
+    /** false when the port is the default because none is set. */
+    explicit: boolean;
+}
+/** Every app serve port of the workspace. */
+export declare function usedServePorts(tree: Tree): UsedPort[];
+/** The lowest port from `start` not in `used`. */
+export declare function nextFreePort(used: Iterable<number>, start?: number): number;
+/** Why `port` cannot be an app's dev-server port, or null. */
+export declare function portProblem(port: unknown): string | null;
+export {};

package/dist/src/lib/utils/serve-port.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.portProblem = exports.nextFreePort = exports.usedServePorts = exports.explicitPort = exports.portOf = exports.serveTargetOf = exports.isServeTarget = exports.DEFAULT_SERVE_PORT = void 0;
+const project_json_files_1 = require("./project-json-files");
+/** Port Angular's dev-server and the flutter-build serve use when none is set. */
+exports.DEFAULT_SERVE_PORT = 4200;
+/** Angular/Ionic dev-server (Angular CLI or @nx/angular builder) or a Flutter serve target. */
+function isServeTarget(target) {
+    if (!target || typeof target.executor !== 'string')
+        return false;
+    if (/^(@angular-devkit\/build-angular|@angular\/build|@nx\/angular):dev-server$/.test(target.executor)) {
+        return true;
+    }
+    return (target.executor === '@mouryaamit/nx-polystack:flutter-build' &&
+        target.options?.['serve'] === true);
+}
+exports.isServeTarget = isServeTarget;
+/** The serve target of a project.json (the `serve` target first, else any serve-like target). */
+function serveTargetOf(json) {
+    const targets = (json['targets'] ?? {});
+    if (isServeTarget(targets['serve']))
+        return targets['serve'];
+    return Object.values(targets).find((t) => isServeTarget(t));
+}
+exports.serveTargetOf = serveTargetOf;
+/** The port a serve target listens on (4200 when unset or not a number). */
+function portOf(target) {
+    return explicitPort(target) ?? exports.DEFAULT_SERVE_PORT;
+}
+exports.portOf = portOf;
+/** The port set on a serve target (a number or a numeric string), else undefined. */
+function explicitPort(target) {
+    const p = target.options?.['port'];
+    const n = typeof p === 'string' && /^\d+$/.test(p.trim()) ? Number(p) : p;
+    return typeof n === 'number' && Number.isInteger(n) ? n : undefined;
+}
+exports.explicitPort = explicitPort;
+/** Every app serve port of the workspace. */
+function usedServePorts(tree) {
+    const out = [];
+    for (const p of (0, project_json_files_1.scanProjects)(tree)) {
+        const serve = serveTargetOf(p.json);
+        if (!serve)
+            continue;
+        out.push({
+            project: p.name,
+            port: portOf(serve),
+            explicit: explicitPort(serve) !== undefined,
+        });
+    }
+    return out;
+}
+exports.usedServePorts = usedServePorts;
+/** The lowest port from `start` not in `used`. */
+function nextFreePort(used, start = exports.DEFAULT_SERVE_PORT) {
+    const taken = new Set(used);
+    let port = start;
+    while (taken.has(port))
+        port++;
+    if (port > 65535)
+        throw new Error('no free dev-server port left');
+    return port;
+}
+exports.nextFreePort = nextFreePort;
+/** Why `port` cannot be an app's dev-server port, or null. */
+function portProblem(port) {
+    if (typeof port !== 'number' || !Number.isInteger(port) || port < 1024 || port > 65535) {
+        return `--port must be a whole number from 1024 to 65535 (got ${String(port)})`;
+    }
+    return null;
+}
+exports.portProblem = portProblem;
+//# sourceMappingURL=serve-port.js.map

package/dist/src/lib/utils/serve-port.js.map

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

package/dist/src/lib/utils/shared-libs.d.ts

@@ -0,0 +1,37 @@
+import { Tree } from '@nx/devkit';
+export declare const SHARED_ASSETS_OUTPUT = "assets/shared";
+/** Files of the shared assets folder that are not app assets (lib config, docs, sources). */
+export declare const SHARED_ASSETS_IGNORE: string[];
+export interface SharedLib {
+    /** Workspace-relative folder wired into apps (the project's sourceRoot when it has one). */
+    dir: string;
+    /** Nx project name of the folder, when it has a project.json. */
+    project?: string;
+}
+export interface SharedLibs {
+    assets: SharedLib;
+    styles: SharedLib;
+    /** Files written (folders created on first use). */
+    created: string[];
+    notes: string[];
+}
+/** Workspace-relative path without ./, duplicate or trailing slashes. */
+export declare function normPath(p: string): string;
+/**
+ * libs/shared/assets and libs/shared/styles, or a migrated workspace's libs/assets and
+ * libs/styles; creates what is missing (seed file and project.json). A folder that is already an
+ * Nx project is wired through its sourceRoot.
+ */
+export declare function ensureSharedLibs(tree: Tree): SharedLibs;
+type BuildTarget = {
+    executor?: string;
+    options?: Record<string, unknown>;
+};
+/** The Angular browser build target of a project.json (`build` first), or undefined. */
+export declare function angularBuildTargetOf(json: Record<string, unknown>): BuildTarget | undefined;
+/**
+ * Wires the shared folders into an app's project.json (build assets, Sass include path,
+ * implicitDependencies); returns false when it already was.
+ */
+export declare function wireSharedLibs(json: Record<string, unknown>, build: BuildTarget, libs: Pick<SharedLibs, 'assets' | 'styles'>): boolean;
+export {};