@_linked/cli 1.46.2 → 1.47.0

package/lib/esm/localize/ensure.js

@@ -1,151 +0,0 @@
-/**
- * One copy, always: every package the app provides loads once, whichever tool
- * runs the code -- Vite, `tsc`, plain Node, `tsx`, a test runner.
- *
- * Two halves:
- *
- * - **`ensure(entry)`** -- the ONLY way a checkout gets installed: `npm
- *   install` inside it, then prune it (prune.ts). localize's install step,
- *   `--relink`'s reinstall and `linked localize --reinstall <pkg>` all go
- *   through it, so the copies an install puts back exist only until it
- *   returns. Hand-running `npm install` in a checkout is what `--reinstall`
- *   replaces.
- * - **`checkOneCopy(appRoot)`** -- the run-time check. Before `linked start`,
- *   `script`, `call` and `build-all` (a commander `preAction` in cli.ts), and
- *   as `linked localize --ensure` for an app's npm `pre*` scripts. It plans
- *   the prune (prune.ts `planPrune`) without touching anything -- per-owner
- *   candidates, the same range guard, the same "would its dependencies
- *   resolve elsewhere" check -- and only when that plan removes something does
- *   it prune, and say so in one line on stderr. A copy prune would keep costs
- *   a stat and, at most, one requirement index per `node_modules` (read from
- *   npm's hidden lockfile), so a tree full of kept copies stays cheap. It
- *   never runs npm, prints nothing when there is nothing to do (or no
- *   manifest), skips a checkout recorded with `prune: false`, and never
- *   throws: a run command must not fail over a developer's private checkout
- *   state.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { EXIT_INSTALL_FAILED, EXIT_REFUSED, EXIT_WARNED, LocalizeError, } from './errors.js';
-import { manifestPath, readManifest } from './manifest.js';
-import { readJson } from './fsops.js';
-import { newPruneCache, planPrune, pruneProvided, prunesEntry, shouldPrune, } from './prune.js';
-import { defaultDeps } from './run.js';
-import { reportError } from './localize.js';
-/**
- * `npm install --no-save` inside the checkout at `entry.path`, then prune it.
- *
- * `--no-save` keeps the checkout's tracked files out of it: npm installs what
- * the committed lockfile says and writes neither `package.json` nor
- * `package-lock.json` (only the gitignored hidden lockfile). Without it every
- * relink left a lockfile diff in each checkout it reinstalled, written in the
- * dialect of whichever npm was first on PATH -- measured: Node 22's bundled
- * npm 10.9.9 drops every `"libc"` field an npm 12 lockfile records, and any
- * npm syncs a lockfile header the release workflow bumped. Changing a
- * checkout's dependencies is a deliberate `npm install <dep>` inside it.
- *
- * `--include=dev` because this runs from the app's npm lifecycle hooks, and
- * npm exports the outer command's config to them as `npm_config_*`: measured,
- * `npm install --omit=dev` at the app root arrives as `npm_config_omit=dev`,
- * and an inner install that inherits it skips the checkout's
- * devDependencies, so the checkout no longer builds. A checkout is a
- * development copy; it always needs them.
- *
- * The package's name is read from the checkout's own `package.json`; the
- * other localized packages (siblings) from the manifest, so a checkout being
- * localized right now prunes before the manifest records it.
- *
- * @returns 0, or `EXIT_WARNED` when the prune failed (the install stands).
- * @throws {LocalizeError} `EXIT_INSTALL_FAILED` when `npm install` fails.
- */
-export function ensure(entry, deps, opts = {}) {
-    var _a;
-    const pkgDir = path.join(deps.appRoot, entry.path);
-    deps.log(`[localize] npm install in ${entry.path}`);
-    const install = deps.run('npm', ['install', '--no-save', '--include=dev', '--no-audit', '--no-fund'], { cwd: pkgDir });
-    if (install.status !== 0) {
-        throw new LocalizeError(`npm install failed in ${entry.path}:\n${(install.stderr || install.stdout).trim()}`, EXIT_INSTALL_FAILED);
-    }
-    if (!shouldPrune(opts) || !prunesEntry(entry))
-        return 0;
-    const name = (_a = readJson(path.join(pkgDir, 'package.json'))) === null || _a === void 0 ? void 0 : _a.name;
-    if (typeof name !== 'string')
-        return 0;
-    try {
-        const entries = Object.assign(Object.assign({}, recordedEntries(deps)), { [name]: entry });
-        pruneProvided(entries, opts, deps, { owners: [name] });
-        return 0;
-    }
-    catch (e) {
-        deps.warn(`[localize] pruning ${entry.path} failed, its node_modules are as npm left them: ${e.message}`);
-        return EXIT_WARNED;
-    }
-}
-/** `linked localize --reinstall <pkg>`: `ensure` for one recorded package. */
-export function reinstall(name, opts, deps) {
-    try {
-        const entry = readManifest(deps.appRoot, deps).entries[name];
-        if (!entry) {
-            throw new LocalizeError(`${name} is not localized here, so there is no checkout to reinstall. ` +
-                '`linked localize --list` shows what is.', EXIT_REFUSED);
-        }
-        if (!fs.existsSync(path.join(deps.appRoot, entry.path, 'package.json'))) {
-            throw new LocalizeError(`${name} is recorded at ${entry.path}, which has no package.json.`, EXIT_REFUSED);
-        }
-        return ensure(entry, deps, opts);
-    }
-    catch (e) {
-        return reportError(e, deps);
-    }
-}
-/**
- * The run-time check: remove every recorded checkout's own copy of what the
- * app provides -- exactly what `pruneProvided` would remove, decided first
- * without it, so the common case (nothing to remove, some copies kept) never
- * reaches the prune.
- *
- * @returns what was removed, as `<checkout>/node_modules/<name>@<version>`.
- */
-export function checkOneCopy(appRoot = process.cwd(), deps = defaultDeps(appRoot)) {
-    var _a;
-    try {
-        if (!fs.existsSync(manifestPath(appRoot)))
-            return { pruned: [] };
-        const entries = readManifest(appRoot, { warn: () => { } }).entries;
-        const owners = Object.keys(entries);
-        if (!owners.length)
-            return { pruned: [] };
-        if (!Object.values(entries).some(prunesEntry))
-            return { pruned: [] };
-        const cache = newPruneCache();
-        const plan = planPrune(entries, { appRoot }, {}, cache);
-        if (!plan.remove.length)
-            return { pruned: [] };
-        // Prune's own report is per checkout and also speaks of what it keeps;
-        // here only what went is worth a line, on every run command.
-        const quiet = { appRoot, log: () => { }, warn: () => { } };
-        const { removed } = pruneProvided(entries, {}, quiet, {
-            owners: [...new Set(plan.remove.map((d) => d.ownerName))],
-            deps: [...new Set(plan.remove.map((d) => d.dep))],
-        }, cache);
-        const pruned = removed.map((r) => `${r.where}@${r.version}`);
-        if (pruned.length) {
-            deps.warn(`[localize] one copy: removed ${pruned.join(', ')} — the app provides ` +
-                `${pruned.length === 1 ? 'it' : 'them'}.`);
-        }
-        return { pruned };
-    }
-    catch (e) {
-        deps.warn(`[localize] one-copy check failed, nothing more was removed: ${(_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : e}`);
-        return { pruned: [] };
-    }
-}
-function recordedEntries(deps) {
-    try {
-        return readManifest(deps.appRoot, { warn: () => { } }).entries;
-    }
-    catch (_a) {
-        return {};
-    }
-}
-//# sourceMappingURL=ensure.js.map

package/lib/esm/localize/ensure.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../../src/localize/ensure.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One copy, always: every package the app provides loads once, whichever tool\n * runs the code -- Vite, `tsc`, plain Node, `tsx`, a test runner.\n *\n * Two halves:\n *\n * - **`ensure(entry)`** -- the ONLY way a checkout gets installed: `npm\n *   install` inside it, then prune it (prune.ts). localize's install step,\n *   `--relink`'s reinstall and `linked localize --reinstall <pkg>` all go\n *   through it, so the copies an install puts back exist only until it\n *   returns. Hand-running `npm install` in a checkout is what `--reinstall`\n *   replaces.\n * - **`checkOneCopy(appRoot)`** -- the run-time check. Before `linked start`,\n *   `script`, `call` and `build-all` (a commander `preAction` in cli.ts), and\n *   as `linked localize --ensure` for an app's npm `pre*` scripts. It plans\n *   the prune (prune.ts `planPrune`) without touching anything -- per-owner\n *   candidates, the same range guard, the same \"would its dependencies\n *   resolve elsewhere\" check -- and only when that plan removes something does\n *   it prune, and say so in one line on stderr. A copy prune would keep costs\n *   a stat and, at most, one requirement index per `node_modules` (read from\n *   npm's hidden lockfile), so a tree full of kept copies stays cheap. It\n *   never runs npm, prints nothing when there is nothing to do (or no\n *   manifest), skips a checkout recorded with `prune: false`, and never\n *   throws: a run command must not fail over a developer's private checkout\n *   state.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {\n  EXIT_INSTALL_FAILED,\n  EXIT_REFUSED,\n  EXIT_WARNED,\n  LocalizeError,\n} from './errors.js';\nimport {manifestPath, readManifest} from './manifest.js';\nimport type {ManifestEntry} from './manifest.js';\nimport {readJson} from './fsops.js';\nimport {\n  newPruneCache,\n  planPrune,\n  pruneProvided,\n  prunesEntry,\n  shouldPrune,\n} from './prune.js';\nimport type {PruneOptions} from './prune.js';\nimport {defaultDeps} from './run.js';\nimport type {Deps} from './run.js';\nimport {reportError} from './localize.js';\n\n/**\n * `npm install --no-save` inside the checkout at `entry.path`, then prune it.\n *\n * `--no-save` keeps the checkout's tracked files out of it: npm installs what\n * the committed lockfile says and writes neither `package.json` nor\n * `package-lock.json` (only the gitignored hidden lockfile). Without it every\n * relink left a lockfile diff in each checkout it reinstalled, written in the\n * dialect of whichever npm was first on PATH -- measured: Node 22's bundled\n * npm 10.9.9 drops every `\"libc\"` field an npm 12 lockfile records, and any\n * npm syncs a lockfile header the release workflow bumped. Changing a\n * checkout's dependencies is a deliberate `npm install <dep>` inside it.\n *\n * `--include=dev` because this runs from the app's npm lifecycle hooks, and\n * npm exports the outer command's config to them as `npm_config_*`: measured,\n * `npm install --omit=dev` at the app root arrives as `npm_config_omit=dev`,\n * and an inner install that inherits it skips the checkout's\n * devDependencies, so the checkout no longer builds. A checkout is a\n * development copy; it always needs them.\n *\n * The package's name is read from the checkout's own `package.json`; the\n * other localized packages (siblings) from the manifest, so a checkout being\n * localized right now prunes before the manifest records it.\n *\n * @returns 0, or `EXIT_WARNED` when the prune failed (the install stands).\n * @throws {LocalizeError} `EXIT_INSTALL_FAILED` when `npm install` fails.\n */\nexport function ensure(\n  entry: Pick<ManifestEntry, 'path' | 'subdir' | 'prune'>,\n  deps: Deps,\n  opts: PruneOptions = {},\n): number {\n  const pkgDir = path.join(deps.appRoot, entry.path);\n  deps.log(`[localize] npm install in ${entry.path}`);\n  const install = deps.run(\n    'npm',\n    ['install', '--no-save', '--include=dev', '--no-audit', '--no-fund'],\n    {cwd: pkgDir},\n  );\n  if (install.status !== 0) {\n    throw new LocalizeError(\n      `npm install failed in ${entry.path}:\\n${(install.stderr || install.stdout).trim()}`,\n      EXIT_INSTALL_FAILED,\n    );\n  }\n  if (!shouldPrune(opts) || !prunesEntry(entry)) return 0;\n\n  const name = readJson(path.join(pkgDir, 'package.json'))?.name;\n  if (typeof name !== 'string') return 0;\n  try {\n    const entries = {...recordedEntries(deps), [name]: entry as ManifestEntry};\n    pruneProvided(entries, opts, deps, {owners: [name]});\n    return 0;\n  } catch (e) {\n    deps.warn(\n      `[localize] pruning ${entry.path} failed, its node_modules are as npm left them: ${e.message}`,\n    );\n    return EXIT_WARNED;\n  }\n}\n\n/** `linked localize --reinstall <pkg>`: `ensure` for one recorded package. */\nexport function reinstall(\n  name: string,\n  opts: PruneOptions,\n  deps: Deps,\n): number {\n  try {\n    const entry = readManifest(deps.appRoot, deps).entries[name];\n    if (!entry) {\n      throw new LocalizeError(\n        `${name} is not localized here, so there is no checkout to reinstall. ` +\n          '`linked localize --list` shows what is.',\n        EXIT_REFUSED,\n      );\n    }\n    if (!fs.existsSync(path.join(deps.appRoot, entry.path, 'package.json'))) {\n      throw new LocalizeError(\n        `${name} is recorded at ${entry.path}, which has no package.json.`,\n        EXIT_REFUSED,\n      );\n    }\n    return ensure(entry, deps, opts);\n  } catch (e) {\n    return reportError(e, deps);\n  }\n}\n\n/**\n * The run-time check: remove every recorded checkout's own copy of what the\n * app provides -- exactly what `pruneProvided` would remove, decided first\n * without it, so the common case (nothing to remove, some copies kept) never\n * reaches the prune.\n *\n * @returns what was removed, as `<checkout>/node_modules/<name>@<version>`.\n */\nexport function checkOneCopy(\n  appRoot: string = process.cwd(),\n  deps: Pick<Deps, 'log' | 'warn'> = defaultDeps(appRoot),\n): {pruned: string[]} {\n  try {\n    if (!fs.existsSync(manifestPath(appRoot))) return {pruned: []};\n    const entries = readManifest(appRoot, {warn: () => {}}).entries;\n    const owners = Object.keys(entries);\n    if (!owners.length) return {pruned: []};\n\n    if (!Object.values(entries).some(prunesEntry)) return {pruned: []};\n\n    const cache = newPruneCache();\n    const plan = planPrune(entries, {appRoot}, {}, cache);\n    if (!plan.remove.length) return {pruned: []};\n\n    // Prune's own report is per checkout and also speaks of what it keeps;\n    // here only what went is worth a line, on every run command.\n    const quiet = {appRoot, log: () => {}, warn: () => {}};\n    const {removed} = pruneProvided(\n      entries,\n      {},\n      quiet,\n      {\n        owners: [...new Set(plan.remove.map((d) => d.ownerName))],\n        deps: [...new Set(plan.remove.map((d) => d.dep))],\n      },\n      cache,\n    );\n    const pruned = removed.map((r) => `${r.where}@${r.version}`);\n    if (pruned.length) {\n      deps.warn(\n        `[localize] one copy: removed ${pruned.join(', ')} — the app provides ` +\n          `${pruned.length === 1 ? 'it' : 'them'}.`,\n      );\n    }\n    return {pruned};\n  } catch (e) {\n    deps.warn(\n      `[localize] one-copy check failed, nothing more was removed: ${e?.message ?? e}`,\n    );\n    return {pruned: []};\n  }\n}\n\nfunction recordedEntries(deps: Deps): Record<string, ManifestEntry> {\n  try {\n    return readManifest(deps.appRoot, {warn: () => {}}).entries;\n  } catch {\n    return {};\n  }\n}\n"]}

package/lib/esm/localize/manifest.d.ts

@@ -1,63 +0,0 @@
-export declare const MANIFEST_FILENAME = "local-packages.json";
-/** One recorded package: where its checkout is, and where it came from. */
-export interface ManifestEntry {
-    /** Absent for an adopted checkout with no remote. */
-    repo?: string;
-    /** The package directory, relative to the app root. */
-    path: string;
-    branch: string;
-    /** The package's directory inside the clone, for a monorepo. */
-    subdir?: string;
-    /** The range the app declared when it was localized. */
-    range?: string;
-    /**
-     * `false` when the package was localized or adopted with `--no-prune`: its
-     * checkout's `node_modules` stay as npm installed them -- no prune after
-     * `--relink` or `--reinstall`, and the run-time check (`--ensure`, before
-     * `linked start` etc.) skips it. Absent means on; localizing or adopting it
-     * again without `--no-prune` turns it back on. Optional, so schema version 1
-     * readers that do not know it simply ignore it.
-     */
-    prune?: false;
-}
-export interface Manifest {
-    file: string;
-    exists: boolean;
-    version: number;
-    dir: string;
-    entries: Record<string, ManifestEntry>;
-    malformed: {
-        name: string;
-        reason: string;
-    }[];
-}
-/** The only schema version this build understands. */
-export declare const SCHEMA_VERSION = 1;
-/** Default checkout directory, relative to the consumer root. */
-export declare const DEFAULT_DIR = "packages-local";
-export declare function manifestPath(appRoot: string): string;
-/**
- * Read and validate the manifest.
- *
- * A missing file is NOT an error: it is the CI case and the fresh-clone case,
- * and reads as an empty set. That is also why no `if (CI)` branch exists
- * anywhere in this package -- the file is gitignored, so CI is a natural no-op.
- *
- * @throws {LocalizeError} code 3. Nothing is written in any failure case.
- */
-export declare function readManifest(appRoot: string, io?: {
-    warn: (message: string) => void;
-}): Manifest;
-/**
- * Write the manifest atomically: a `.tmp` in the SAME directory, so `rename`
- * is atomic on one filesystem, then `rename` over the original.
- *
- * An empty `packages` object is written rather than the file being deleted, so
- * a non-default `dir` survives delocalizing the last entry.
- */
-export declare function writeManifest(appRoot: string, data: {
-    version?: number;
-    dir?: string;
-    packages?: Record<string, ManifestEntry>;
-}): string;
-//# sourceMappingURL=manifest.d.ts.map

package/lib/esm/localize/manifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/localize/manifest.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,EAAE,CAAC;CAC7C;AAED,sDAAsD;AACtD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,EAAE,GAAE;IAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAwB,GAC3D,QAAQ,CAyFV;AAiBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC1C,GACA,MAAM,CAcR"}

package/lib/esm/localize/manifest.js

@@ -1,133 +0,0 @@
-/**
- * `local-packages.json` -- the record of which packages are currently localized.
- *
- * The filename and schema are deliberately the SAME as the ones `@semantu/cli`
- * already writes (schema version 1, keys are npm package names). A developer
- * with a half-localized tree must be able to switch tools without re-cloning,
- * and the consumer's `postinstall` must keep working across the switch.
- *
- * One relaxation since 0.1.0: `repo` is optional, because an adopted checkout
- * may have no remote. localize 0.1.0 skips such an entry as partial, with a
- * warning, and keeps the rest; other readers of this schema were not checked.
- *
- * Two properties are load-bearing:
- *
- * 1. **It is never repaired.** Unparseable JSON, an unknown `version` or a
- *    `packages` that is not an object is a refusal (exit 3) with no write.
- *    This file is the only record of what a developer intended; silently
- *    resetting it is how a half-localized tree becomes invisible.
- * 2. **Writes are atomic** -- `<file>.tmp` then `rename` -- so a killed run
- *    cannot leave a truncated file behind.
- *
- * A *partial entry* is different from a malformed file: it is skipped with a
- * warning and its siblings still process, because one bad entry must not cost
- * a developer the other nine.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { EXIT_BAD_FILE, LocalizeError } from './errors.js';
-export const MANIFEST_FILENAME = 'local-packages.json';
-/** The only schema version this build understands. */
-export const SCHEMA_VERSION = 1;
-/** Default checkout directory, relative to the consumer root. */
-export const DEFAULT_DIR = 'packages-local';
-export function manifestPath(appRoot) {
-    return path.join(appRoot, MANIFEST_FILENAME);
-}
-/**
- * Read and validate the manifest.
- *
- * A missing file is NOT an error: it is the CI case and the fresh-clone case,
- * and reads as an empty set. That is also why no `if (CI)` branch exists
- * anywhere in this package -- the file is gitignored, so CI is a natural no-op.
- *
- * @throws {LocalizeError} code 3. Nothing is written in any failure case.
- */
-export function readManifest(appRoot, io = { warn: console.warn }) {
-    const file = manifestPath(appRoot);
-    if (!fs.existsSync(file)) {
-        return {
-            file,
-            exists: false,
-            version: SCHEMA_VERSION,
-            dir: DEFAULT_DIR,
-            entries: {},
-            malformed: [],
-        };
-    }
-    const raw = fs.readFileSync(file, 'utf8');
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (e) {
-        throw new LocalizeError(`${file} is not valid JSON: ${e.message}\n` +
-            `Refusing to read or rewrite it -- it is the only record of what was localized. ` +
-            `Fix it by hand, or delete it to start over.`, EXIT_BAD_FILE);
-    }
-    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new LocalizeError(`${file} does not contain a JSON object.\n` +
-            `Refusing to read or rewrite it. Expected {"version":${SCHEMA_VERSION},"packages":{…}}.`, EXIT_BAD_FILE);
-    }
-    if (parsed.version !== SCHEMA_VERSION) {
-        throw new LocalizeError(`${file} has schema version ${JSON.stringify(parsed.version)}; this version of localize understands ` +
-            `only version ${SCHEMA_VERSION}.\n` +
-            `Refusing to read or rewrite it -- guessing at a schema it did not write is how intent ` +
-            `gets lost. Upgrade localize, or delete the file and re-localize.`, EXIT_BAD_FILE);
-    }
-    if (parsed.packages === null ||
-        typeof parsed.packages !== 'object' ||
-        Array.isArray(parsed.packages)) {
-        throw new LocalizeError(`${file} has a "packages" field that is not an object (found ` +
-            `${Array.isArray(parsed.packages) ? 'an array' : typeof parsed.packages}).\n` +
-            `Refusing to read or rewrite it.`, EXIT_BAD_FILE);
-    }
-    const dir = typeof parsed.dir === 'string' && parsed.dir.length > 0
-        ? parsed.dir
-        : DEFAULT_DIR;
-    const entries = {};
-    const malformed = [];
-    for (const [name, value] of Object.entries(parsed.packages)) {
-        const reason = validateEntry(value);
-        if (reason) {
-            malformed.push({ name, reason });
-            io.warn(`[localize] ${name}: malformed entry in ${MANIFEST_FILENAME} (${reason}) -- skipped. ` +
-                `The other entries are unaffected. \`linked localize ${name}\` rewrites it.`);
-            continue;
-        }
-        entries[name] = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (typeof value.repo === 'string' && value.repo
-            ? { repo: value.repo }
-            : {})), { path: value.path, branch: value.branch }), (typeof value.subdir === 'string' ? { subdir: value.subdir } : {})), (typeof value.range === 'string' ? { range: value.range } : {})), (value.prune === false ? { prune: false } : {}));
-    }
-    return { file, exists: true, version: SCHEMA_VERSION, dir, entries, malformed };
-}
-/**
- * @returns {string|null} a reason the entry is unusable, else null.
- *
- * `repo` is optional: an adopted checkout may have no remote at all -- a
- * package created locally that has not been pushed anywhere yet.
- */
-function validateEntry(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return 'not an object';
-    const missing = ['path', 'branch'].filter((k) => typeof value[k] !== 'string' || value[k].length === 0);
-    return missing.length ? `missing ${missing.join(', ')}` : null;
-}
-/**
- * Write the manifest atomically: a `.tmp` in the SAME directory, so `rename`
- * is atomic on one filesystem, then `rename` over the original.
- *
- * An empty `packages` object is written rather than the file being deleted, so
- * a non-default `dir` survives delocalizing the last entry.
- */
-export function writeManifest(appRoot, data) {
-    var _a;
-    const target = manifestPath(appRoot);
-    const tmp = `${target}.tmp`;
-    const out = Object.assign(Object.assign({ version: SCHEMA_VERSION }, (data.dir && data.dir !== DEFAULT_DIR ? { dir: data.dir } : {})), { packages: (_a = data.packages) !== null && _a !== void 0 ? _a : {} });
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.writeFileSync(tmp, JSON.stringify(out, null, 2) + '\n', 'utf8');
-    fs.renameSync(tmp, target);
-    return target;
-}
-//# sourceMappingURL=manifest.js.map

package/lib/esm/localize/manifest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/localize/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `local-packages.json` -- the record of which packages are currently localized.\n *\n * The filename and schema are deliberately the SAME as the ones `@semantu/cli`\n * already writes (schema version 1, keys are npm package names). A developer\n * with a half-localized tree must be able to switch tools without re-cloning,\n * and the consumer's `postinstall` must keep working across the switch.\n *\n * One relaxation since 0.1.0: `repo` is optional, because an adopted checkout\n * may have no remote. localize 0.1.0 skips such an entry as partial, with a\n * warning, and keeps the rest; other readers of this schema were not checked.\n *\n * Two properties are load-bearing:\n *\n * 1. **It is never repaired.** Unparseable JSON, an unknown `version` or a\n *    `packages` that is not an object is a refusal (exit 3) with no write.\n *    This file is the only record of what a developer intended; silently\n *    resetting it is how a half-localized tree becomes invisible.\n * 2. **Writes are atomic** -- `<file>.tmp` then `rename` -- so a killed run\n *    cannot leave a truncated file behind.\n *\n * A *partial entry* is different from a malformed file: it is skipped with a\n * warning and its siblings still process, because one bad entry must not cost\n * a developer the other nine.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {EXIT_BAD_FILE, LocalizeError} from './errors.js';\n\nexport const MANIFEST_FILENAME = 'local-packages.json';\n\n/** One recorded package: where its checkout is, and where it came from. */\nexport interface ManifestEntry {\n  /** Absent for an adopted checkout with no remote. */\n  repo?: string;\n  /** The package directory, relative to the app root. */\n  path: string;\n  branch: string;\n  /** The package's directory inside the clone, for a monorepo. */\n  subdir?: string;\n  /** The range the app declared when it was localized. */\n  range?: string;\n  /**\n   * `false` when the package was localized or adopted with `--no-prune`: its\n   * checkout's `node_modules` stay as npm installed them -- no prune after\n   * `--relink` or `--reinstall`, and the run-time check (`--ensure`, before\n   * `linked start` etc.) skips it. Absent means on; localizing or adopting it\n   * again without `--no-prune` turns it back on. Optional, so schema version 1\n   * readers that do not know it simply ignore it.\n   */\n  prune?: false;\n}\n\nexport interface Manifest {\n  file: string;\n  exists: boolean;\n  version: number;\n  dir: string;\n  entries: Record<string, ManifestEntry>;\n  malformed: {name: string; reason: string}[];\n}\n\n/** The only schema version this build understands. */\nexport const SCHEMA_VERSION = 1;\n\n/** Default checkout directory, relative to the consumer root. */\nexport const DEFAULT_DIR = 'packages-local';\n\nexport function manifestPath(appRoot: string): string {\n  return path.join(appRoot, MANIFEST_FILENAME);\n}\n\n/**\n * Read and validate the manifest.\n *\n * A missing file is NOT an error: it is the CI case and the fresh-clone case,\n * and reads as an empty set. That is also why no `if (CI)` branch exists\n * anywhere in this package -- the file is gitignored, so CI is a natural no-op.\n *\n * @throws {LocalizeError} code 3. Nothing is written in any failure case.\n */\nexport function readManifest(\n  appRoot: string,\n  io: {warn: (message: string) => void} = {warn: console.warn},\n): Manifest {\n  const file = manifestPath(appRoot);\n\n  if (!fs.existsSync(file)) {\n    return {\n      file,\n      exists: false,\n      version: SCHEMA_VERSION,\n      dir: DEFAULT_DIR,\n      entries: {},\n      malformed: [],\n    };\n  }\n\n  const raw = fs.readFileSync(file, 'utf8');\n  let parsed;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (e) {\n    throw new LocalizeError(\n      `${file} is not valid JSON: ${e.message}\\n` +\n        `Refusing to read or rewrite it -- it is the only record of what was localized. ` +\n        `Fix it by hand, or delete it to start over.`,\n      EXIT_BAD_FILE,\n    );\n  }\n\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new LocalizeError(\n      `${file} does not contain a JSON object.\\n` +\n        `Refusing to read or rewrite it. Expected {\"version\":${SCHEMA_VERSION},\"packages\":{…}}.`,\n      EXIT_BAD_FILE,\n    );\n  }\n\n  if (parsed.version !== SCHEMA_VERSION) {\n    throw new LocalizeError(\n      `${file} has schema version ${JSON.stringify(parsed.version)}; this version of localize understands ` +\n        `only version ${SCHEMA_VERSION}.\\n` +\n        `Refusing to read or rewrite it -- guessing at a schema it did not write is how intent ` +\n        `gets lost. Upgrade localize, or delete the file and re-localize.`,\n      EXIT_BAD_FILE,\n    );\n  }\n\n  if (\n    parsed.packages === null ||\n    typeof parsed.packages !== 'object' ||\n    Array.isArray(parsed.packages)\n  ) {\n    throw new LocalizeError(\n      `${file} has a \"packages\" field that is not an object (found ` +\n        `${Array.isArray(parsed.packages) ? 'an array' : typeof parsed.packages}).\\n` +\n        `Refusing to read or rewrite it.`,\n      EXIT_BAD_FILE,\n    );\n  }\n\n  const dir =\n    typeof parsed.dir === 'string' && parsed.dir.length > 0\n      ? parsed.dir\n      : DEFAULT_DIR;\n\n  const entries: Record<string, ManifestEntry> = {};\n  const malformed: Manifest['malformed'] = [];\n\n  for (const [name, value] of Object.entries<any>(parsed.packages)) {\n    const reason = validateEntry(value);\n    if (reason) {\n      malformed.push({name, reason});\n      io.warn(\n        `[localize] ${name}: malformed entry in ${MANIFEST_FILENAME} (${reason}) -- skipped. ` +\n          `The other entries are unaffected. \\`linked localize ${name}\\` rewrites it.`,\n      );\n      continue;\n    }\n    entries[name] = {\n      ...(typeof value.repo === 'string' && value.repo\n        ? {repo: value.repo}\n        : {}),\n      path: value.path,\n      branch: value.branch,\n      ...(typeof value.subdir === 'string' ? {subdir: value.subdir} : {}),\n      ...(typeof value.range === 'string' ? {range: value.range} : {}),\n      ...(value.prune === false ? {prune: false as const} : {}),\n    };\n  }\n\n  return {file, exists: true, version: SCHEMA_VERSION, dir, entries, malformed};\n}\n\n/**\n * @returns {string|null} a reason the entry is unusable, else null.\n *\n * `repo` is optional: an adopted checkout may have no remote at all -- a\n * package created locally that has not been pushed anywhere yet.\n */\nfunction validateEntry(value) {\n  if (value === null || typeof value !== 'object' || Array.isArray(value))\n    return 'not an object';\n  const missing = ['path', 'branch'].filter(\n    (k) => typeof value[k] !== 'string' || value[k].length === 0,\n  );\n  return missing.length ? `missing ${missing.join(', ')}` : null;\n}\n\n/**\n * Write the manifest atomically: a `.tmp` in the SAME directory, so `rename`\n * is atomic on one filesystem, then `rename` over the original.\n *\n * An empty `packages` object is written rather than the file being deleted, so\n * a non-default `dir` survives delocalizing the last entry.\n */\nexport function writeManifest(\n  appRoot: string,\n  data: {\n    version?: number;\n    dir?: string;\n    packages?: Record<string, ManifestEntry>;\n  },\n): string {\n  const target = manifestPath(appRoot);\n  const tmp = `${target}.tmp`;\n\n  const out = {\n    version: SCHEMA_VERSION,\n    ...(data.dir && data.dir !== DEFAULT_DIR ? {dir: data.dir} : {}),\n    packages: data.packages ?? {},\n  };\n\n  fs.mkdirSync(path.dirname(target), {recursive: true});\n  fs.writeFileSync(tmp, JSON.stringify(out, null, 2) + '\\n', 'utf8');\n  fs.renameSync(tmp, target);\n  return target;\n}\n"]}

package/lib/esm/localize/one-copy-hook.d.ts

@@ -1,16 +0,0 @@
-/**
- * Which `linked` commands run the one-copy check (`checkOneCopy`, ensure.ts)
- * first: the ones that run the app's code. Kept apart from `cli.ts`, which
- * builds and parses the real program on import, so a test can install the
- * hook on a program of its own and see exactly which commands trigger it.
- */
-import type { Command } from 'commander';
-/** `linked start`, `script`, `call` and `build-all`, and nothing else. */
-export declare const ONE_COPY_COMMANDS: ReadonlySet<string>;
-/**
- * Before one of `ONE_COPY_COMMANDS`, remove any localized checkout's own copy
- * of what the app provides. Never runs npm, silent when there is nothing to
- * remove, a no-op with no local-packages.json, and it never throws.
- */
-export declare function installOneCopyHook(program: Command, check?: (appRoot: string) => unknown): void;
-//# sourceMappingURL=one-copy-hook.d.ts.map

package/lib/esm/localize/one-copy-hook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"one-copy-hook.d.ts","sourceRoot":"","sources":["../../../src/localize/one-copy-hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAIvC,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAKhD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAsB,GACjD,IAAI,CAIN"}

package/lib/esm/localize/one-copy-hook.js

@@ -1,20 +0,0 @@
-import { checkOneCopy } from './ensure.js';
-/** `linked start`, `script`, `call` and `build-all`, and nothing else. */
-export const ONE_COPY_COMMANDS = new Set([
-    'start',
-    'script',
-    'call',
-    'build-all',
-]);
-/**
- * Before one of `ONE_COPY_COMMANDS`, remove any localized checkout's own copy
- * of what the app provides. Never runs npm, silent when there is nothing to
- * remove, a no-op with no local-packages.json, and it never throws.
- */
-export function installOneCopyHook(program, check = checkOneCopy) {
-    program.hook('preAction', (_program, actionCommand) => {
-        if (ONE_COPY_COMMANDS.has(actionCommand.name()))
-            check(process.cwd());
-    });
-}
-//# sourceMappingURL=one-copy-hook.js.map

package/lib/esm/localize/one-copy-hook.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"one-copy-hook.js","sourceRoot":"","sources":["../../../src/localize/one-copy-hook.ts"],"names":[],"mappings":"AAQA,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IAC5D,OAAO;IACP,QAAQ;IACR,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,QAAsC,YAAY;IAElD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE;QACpD,IAAI,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Which `linked` commands run the one-copy check (`checkOneCopy`, ensure.ts)\n * first: the ones that run the app's code. Kept apart from `cli.ts`, which\n * builds and parses the real program on import, so a test can install the\n * hook on a program of its own and see exactly which commands trigger it.\n */\nimport type {Command} from 'commander';\n\nimport {checkOneCopy} from './ensure.js';\n\n/** `linked start`, `script`, `call` and `build-all`, and nothing else. */\nexport const ONE_COPY_COMMANDS: ReadonlySet<string> = new Set([\n  'start',\n  'script',\n  'call',\n  'build-all',\n]);\n\n/**\n * Before one of `ONE_COPY_COMMANDS`, remove any localized checkout's own copy\n * of what the app provides. Never runs npm, silent when there is nothing to\n * remove, a no-op with no local-packages.json, and it never throws.\n */\nexport function installOneCopyHook(\n  program: Command,\n  check: (appRoot: string) => unknown = checkOneCopy,\n): void {\n  program.hook('preAction', (_program, actionCommand) => {\n    if (ONE_COPY_COMMANDS.has(actionCommand.name())) check(process.cwd());\n  });\n}\n"]}

package/lib/esm/localize/provided.d.ts

@@ -1,28 +0,0 @@
-/** A dependency the app has, left out because some localized checkout asks a range it misses. */
-export interface ProvidedSkip {
-    name: string;
-    reason: 'range';
-    /** The localized checkouts whose range the app's version does not satisfy. */
-    asks: {
-        from: string;
-        range: string;
-    }[];
-    appVersion: string;
-}
-export interface Provided {
-    /** Sorted: the localized packages, the dependencies the app provides, react/react-dom. */
-    names: string[];
-    skipped: ProvidedSkip[];
-    /** The localized packages among `names` (installed at the app root). */
-    localized: string[];
-    /** The names in `names` that are there as a localized checkout's dependency. */
-    dependencies: string[];
-}
-/**
- * @param appRoot  the app root (where `local-packages.json` and `node_modules` are)
- * @param localizedNames  the localized package names; defaults to the
- *   manifest's. Pruning passes the entries it is working on, so a checkout
- *   being localized right now counts before the manifest records it.
- */
-export declare function providedPackages(appRoot: string, localizedNames?: string[]): Provided;
-//# sourceMappingURL=provided.d.ts.map

package/lib/esm/localize/provided.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provided.d.ts","sourceRoot":"","sources":["../../../src/localize/provided.ts"],"names":[],"mappings":"AAsCA,iGAAiG;AACjG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wEAAwE;IACxE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gFAAgF;IAChF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAA2B,GAChD,QAAQ,CAuCV"}

package/lib/esm/localize/provided.js

@@ -1,89 +0,0 @@
-/**
- * THE rule for what an app provides to its localized checkouts -- the one list
- * that pruning (prune.ts), the run-time one-copy check (ensure.ts) and Vite's
- * `resolve.dedupe` (`../localized-dedupe.ts`) all start from.
- *
- * - every localized package the app has installed -- always, whatever a range
- *   says: the live checkout is the point of localizing it, for every importer;
- * - every runtime dependency a localized checkout declares (`dependencies`,
- *   `peerDependencies`, `optionalDependencies` -- what its source imports) that
- *   the app has at a version satisfying EVERY localized checkout's range for
- *   it. A range the app's version does not satisfy (or that cannot be read)
- *   leaves the name out, as `skipped`, with who asks what;
- * - `react` and `react-dom` when the app has them.
- *
- * Scoped to what is localized on purpose: a duplicate comes from a checkout's
- * own `npm install`, so the checkouts' declarations are what can produce one.
- * The server's "installed N times" warning stays as the cross-check for
- * anything this misses (a linked package hoisted into a checkout only
- * transitively).
- *
- * Synchronous and cheap -- the manifest, one `package.json` per localized
- * package and one per dependency it names -- because the run-time check calls
- * it before every `linked start`.
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { readInstalledPkgSync } from '../installed-packages.js';
-import { readManifest } from './manifest.js';
-import { readJson } from './fsops.js';
-import { satisfies } from './prune.js';
-const RUNTIME_FIELDS = [
-    'dependencies',
-    'peerDependencies',
-    'optionalDependencies',
-];
-/**
- * @param appRoot  the app root (where `local-packages.json` and `node_modules` are)
- * @param localizedNames  the localized package names; defaults to the
- *   manifest's. Pruning passes the entries it is working on, so a checkout
- *   being localized right now counts before the manifest records it.
- */
-export function providedPackages(appRoot, localizedNames = manifestNames(appRoot)) {
-    var _a, _b, _c, _d, _e;
-    const localized = localizedNames.filter((name) => fs.existsSync(path.join(appRoot, 'node_modules', name, 'package.json')));
-    const names = new Set(localized);
-    const skipped = [];
-    const dependencies = [];
-    // name -> every localized checkout's runtime range for it
-    const asks = new Map();
-    for (const from of localized) {
-        const pkg = (_a = readJson(path.join(appRoot, 'node_modules', from, 'package.json'))) !== null && _a !== void 0 ? _a : {};
-        for (const field of RUNTIME_FIELDS) {
-            for (const [dep, range] of Object.entries((_b = pkg[field]) !== null && _b !== void 0 ? _b : {})) {
-                if (names.has(dep))
-                    continue;
-                const list = (_c = asks.get(dep)) !== null && _c !== void 0 ? _c : [];
-                if (!list.some((a) => a.from === from))
-                    list.push({ from, range });
-                asks.set(dep, list);
-            }
-        }
-    }
-    for (const [name, ranges] of asks) {
-        const appVersion = (_e = (_d = readInstalledPkgSync(name, appRoot)) === null || _d === void 0 ? void 0 : _d.json) === null || _e === void 0 ? void 0 : _e.version;
-        if (!appVersion)
-            continue; // the app does not provide it
-        const unmet = ranges.filter((a) => satisfies(appVersion, a.range) !== true);
-        if (unmet.length)
-            skipped.push({ name, reason: 'range', asks: unmet, appVersion });
-        else {
-            names.add(name);
-            dependencies.push(name);
-        }
-    }
-    for (const name of ['react', 'react-dom']) {
-        if (readInstalledPkgSync(name, appRoot))
-            names.add(name);
-    }
-    return { names: [...names].sort(), skipped, localized, dependencies };
-}
-function manifestNames(appRoot) {
-    try {
-        return Object.keys(readManifest(appRoot, { warn: () => { } }).entries);
-    }
-    catch (_a) {
-        return [];
-    }
-}
-//# sourceMappingURL=provided.js.map

package/lib/esm/localize/provided.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"provided.js","sourceRoot":"","sources":["../../../src/localize/provided.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * THE rule for what an app provides to its localized checkouts -- the one list\n * that pruning (prune.ts), the run-time one-copy check (ensure.ts) and Vite's\n * `resolve.dedupe` (`../localized-dedupe.ts`) all start from.\n *\n * - every localized package the app has installed -- always, whatever a range\n *   says: the live checkout is the point of localizing it, for every importer;\n * - every runtime dependency a localized checkout declares (`dependencies`,\n *   `peerDependencies`, `optionalDependencies` -- what its source imports) that\n *   the app has at a version satisfying EVERY localized checkout's range for\n *   it. A range the app's version does not satisfy (or that cannot be read)\n *   leaves the name out, as `skipped`, with who asks what;\n * - `react` and `react-dom` when the app has them.\n *\n * Scoped to what is localized on purpose: a duplicate comes from a checkout's\n * own `npm install`, so the checkouts' declarations are what can produce one.\n * The server's \"installed N times\" warning stays as the cross-check for\n * anything this misses (a linked package hoisted into a checkout only\n * transitively).\n *\n * Synchronous and cheap -- the manifest, one `package.json` per localized\n * package and one per dependency it names -- because the run-time check calls\n * it before every `linked start`.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {readInstalledPkgSync} from '../installed-packages.js';\nimport {readManifest} from './manifest.js';\nimport {readJson} from './fsops.js';\nimport {satisfies} from './prune.js';\n\nconst RUNTIME_FIELDS = [\n  'dependencies',\n  'peerDependencies',\n  'optionalDependencies',\n];\n\n/** A dependency the app has, left out because some localized checkout asks a range it misses. */\nexport interface ProvidedSkip {\n  name: string;\n  reason: 'range';\n  /** The localized checkouts whose range the app's version does not satisfy. */\n  asks: {from: string; range: string}[];\n  appVersion: string;\n}\n\nexport interface Provided {\n  /** Sorted: the localized packages, the dependencies the app provides, react/react-dom. */\n  names: string[];\n  skipped: ProvidedSkip[];\n  /** The localized packages among `names` (installed at the app root). */\n  localized: string[];\n  /** The names in `names` that are there as a localized checkout's dependency. */\n  dependencies: string[];\n}\n\n/**\n * @param appRoot  the app root (where `local-packages.json` and `node_modules` are)\n * @param localizedNames  the localized package names; defaults to the\n *   manifest's. Pruning passes the entries it is working on, so a checkout\n *   being localized right now counts before the manifest records it.\n */\nexport function providedPackages(\n  appRoot: string,\n  localizedNames: string[] = manifestNames(appRoot),\n): Provided {\n  const localized = localizedNames.filter((name) =>\n    fs.existsSync(path.join(appRoot, 'node_modules', name, 'package.json')),\n  );\n  const names = new Set<string>(localized);\n  const skipped: ProvidedSkip[] = [];\n  const dependencies: string[] = [];\n\n  // name -> every localized checkout's runtime range for it\n  const asks = new Map<string, {from: string; range: string}[]>();\n  for (const from of localized) {\n    const pkg =\n      readJson(path.join(appRoot, 'node_modules', from, 'package.json')) ?? {};\n    for (const field of RUNTIME_FIELDS) {\n      for (const [dep, range] of Object.entries<string>(pkg[field] ?? {})) {\n        if (names.has(dep)) continue;\n        const list = asks.get(dep) ?? [];\n        if (!list.some((a) => a.from === from)) list.push({from, range});\n        asks.set(dep, list);\n      }\n    }\n  }\n\n  for (const [name, ranges] of asks) {\n    const appVersion = readInstalledPkgSync(name, appRoot)?.json?.version;\n    if (!appVersion) continue; // the app does not provide it\n    const unmet = ranges.filter((a) => satisfies(appVersion, a.range) !== true);\n    if (unmet.length)\n      skipped.push({name, reason: 'range', asks: unmet, appVersion});\n    else {\n      names.add(name);\n      dependencies.push(name);\n    }\n  }\n\n  for (const name of ['react', 'react-dom']) {\n    if (readInstalledPkgSync(name, appRoot)) names.add(name);\n  }\n  return {names: [...names].sort(), skipped, localized, dependencies};\n}\n\nfunction manifestNames(appRoot: string): string[] {\n  try {\n    return Object.keys(readManifest(appRoot, {warn: () => {}}).entries);\n  } catch {\n    return [];\n  }\n}\n"]}