@_linked/cli 1.38.0 → 1.40.0

package/lib/esm/localized-dedupe.js

@@ -0,0 +1,182 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * What Vite's `resolve.dedupe` lists: the packages a LOCALIZED checkout could
+ * otherwise load a second copy of.
+ *
+ * The duplicates come from localization, not from being a linked package. A
+ * localized checkout (`linked localize`) is a git clone under the app root with
+ * its own `npm install`, so its `node_modules` holds its own copy of what it
+ * depends on — often older than the app's, and a registry copy of any sibling
+ * that is localized too. Vite serves the checkout's source and resolves its
+ * imports from there, so without a dedupe the dev server loads those copies next
+ * to the app's (measured: three `@_linked/core` in one SSR process).
+ *
+ * So the list is:
+ *
+ * - every localized package — 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;
+ * - `react` and `react-dom` when the app has them.
+ *
+ * A dedupe resolves the name from the app root for EVERY importer and checks no
+ * version — measured: a checkout asking `motion@^13` got the app's 12.43.0. Two
+ * cases are therefore left out:
+ *
+ * - a range the app's version does not satisfy: the checkout keeps its own copy
+ *   (reported, see `describeSkipped`);
+ * - a name some registry install in the app nests its own copy of. npm only
+ *   nests when the hoisted copy does not satisfy that package, so deduping the
+ *   name would hand it the wrong version.
+ *
+ * Plain Node, `tsx` and test runners never read this list; for them
+ * `linked localize` removes the checkout's copies from disk instead.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import semver from 'semver';
+import { readInstalledPkg } from './installed-packages.js';
+import { localizedPackageNames } from './lifecycle.js';
+const RUNTIME_FIELDS = [
+    'dependencies',
+    'peerDependencies',
+    'optionalDependencies',
+];
+export function localizedDedupe() {
+    return __awaiter(this, arguments, void 0, function* (appRoot = process.cwd()) {
+        var _a, _b, _c, _d;
+        const localized = localizedPackageNames(appRoot).filter((name) => fs.existsSync(path.join(appRoot, 'node_modules', name, 'package.json')));
+        const names = new Set(localized);
+        const skipped = [];
+        // 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);
+                }
+            }
+        }
+        const nested = asks.size
+            ? nestedCopies(path.join(appRoot, 'node_modules'))
+            : new Map();
+        for (const [name, ranges] of asks) {
+            const app = yield readInstalledPkg(name, appRoot);
+            if (!((_d = app === null || app === void 0 ? void 0 : app.json) === null || _d === void 0 ? void 0 : _d.version))
+                continue; // nothing at the root to dedupe to
+            const appVersion = app.json.version;
+            const unmet = ranges.filter((a) => !satisfies(appVersion, a.range));
+            if (unmet.length) {
+                skipped.push({ name, reason: 'range', asks: unmet, appVersion });
+            }
+            else if (nested.has(name)) {
+                skipped.push({ name, reason: 'nested', nestedAt: nested.get(name) });
+            }
+            else {
+                names.add(name);
+            }
+        }
+        for (const name of ['react', 'react-dom']) {
+            if (yield readInstalledPkg(name, appRoot))
+                names.add(name);
+        }
+        return { names: [...names].sort(), skipped };
+    });
+}
+/** One line for the dev log about the ranges the app does not satisfy; null when there are none. */
+export function describeSkipped(skipped) {
+    const range = skipped.filter((s) => s.reason === 'range');
+    if (!range.length)
+        return null;
+    return (`[linked] dedupe: ${range.length} package${range.length === 1 ? '' : 's'} a localized checkout ` +
+        `keeps its own copy of, because the app's version is outside its range: ` +
+        range
+            .map((s) => `${s.name} (${s.asks.map((a) => `${a.from} asks ${a.range}`).join(', ')}; app ${s.appVersion})`)
+            .join(', '));
+}
+function satisfies(version, range) {
+    try {
+        return (semver.validRange(range) !== null && semver.satisfies(version, range));
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Every package name nested below the top level of `nm` — a registry install's
+ * private copy — mapped to one place it sits. Symlinks (localized checkouts,
+ * workspaces) are not followed: their trees are not the app's install.
+ */
+function nestedCopies(nm) {
+    const out = new Map();
+    const walk = (dir, depth) => {
+        for (const name of packageNames(dir)) {
+            const pkgDir = path.join(dir, name);
+            let stat;
+            try {
+                stat = fs.lstatSync(pkgDir);
+            }
+            catch (_a) {
+                continue;
+            }
+            if (stat.isSymbolicLink())
+                continue;
+            if (depth > 0 && !out.has(name))
+                out.set(name, path.relative(path.dirname(nm), pkgDir));
+            walk(path.join(pkgDir, 'node_modules'), depth + 1);
+        }
+    };
+    walk(nm, 0);
+    return out;
+}
+function packageNames(nm) {
+    let entries;
+    try {
+        entries = fs.readdirSync(nm);
+    }
+    catch (_a) {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (entry.startsWith('.'))
+            continue;
+        if (entry.startsWith('@')) {
+            try {
+                for (const sub of fs.readdirSync(path.join(nm, entry)))
+                    out.push(`${entry}/${sub}`);
+            }
+            catch (_b) {
+                /* not a directory */
+            }
+        }
+        else {
+            out.push(entry);
+        }
+    }
+    return out;
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (_a) {
+        return null;
+    }
+}
+//# sourceMappingURL=localized-dedupe.js.map

package/lib/esm/localized-dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-dedupe.js","sourceRoot":"","sources":["../../src/localized-dedupe.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What Vite's `resolve.dedupe` lists: the packages a LOCALIZED checkout could\n * otherwise load a second copy of.\n *\n * The duplicates come from localization, not from being a linked package. A\n * localized checkout (`linked localize`) is a git clone under the app root with\n * its own `npm install`, so its `node_modules` holds its own copy of what it\n * depends on — often older than the app's, and a registry copy of any sibling\n * that is localized too. Vite serves the checkout's source and resolves its\n * imports from there, so without a dedupe the dev server loads those copies next\n * to the app's (measured: three `@_linked/core` in one SSR process).\n *\n * So the list is:\n *\n * - every localized package — always, whatever a range says: the live checkout\n *   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 it;\n * - `react` and `react-dom` when the app has them.\n *\n * A dedupe resolves the name from the app root for EVERY importer and checks no\n * version — measured: a checkout asking `motion@^13` got the app's 12.43.0. Two\n * cases are therefore left out:\n *\n * - a range the app's version does not satisfy: the checkout keeps its own copy\n *   (reported, see `describeSkipped`);\n * - a name some registry install in the app nests its own copy of. npm only\n *   nests when the hoisted copy does not satisfy that package, so deduping the\n *   name would hand it the wrong version.\n *\n * Plain Node, `tsx` and test runners never read this list; for them\n * `linked localize` removes the checkout's copies from disk instead.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport semver from 'semver';\nimport {readInstalledPkg} from './installed-packages.js';\nimport {localizedPackageNames} from './lifecycle.js';\n\nconst RUNTIME_FIELDS = [\n  'dependencies',\n  'peerDependencies',\n  'optionalDependencies',\n];\n\nexport interface SkippedDedupe {\n  name: string;\n  reason: 'range' | 'nested';\n  /** For `range`: who asks what, and what the app has. */\n  asks?: {from: string; range: string}[];\n  appVersion?: string;\n  /** For `nested`: one registry install that carries its own copy. */\n  nestedAt?: string;\n}\n\nexport interface LocalizedDedupe {\n  names: string[];\n  skipped: SkippedDedupe[];\n}\n\nexport async function localizedDedupe(\n  appRoot: string = process.cwd(),\n): Promise<LocalizedDedupe> {\n  const localized = localizedPackageNames(appRoot).filter((name) =>\n    fs.existsSync(path.join(appRoot, 'node_modules', name, 'package.json')),\n  );\n  const names = new Set<string>(localized);\n  const skipped: SkippedDedupe[] = [];\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  const nested = asks.size\n    ? nestedCopies(path.join(appRoot, 'node_modules'))\n    : new Map();\n  for (const [name, ranges] of asks) {\n    const app = await readInstalledPkg(name, appRoot);\n    if (!app?.json?.version) continue; // nothing at the root to dedupe to\n    const appVersion = app.json.version;\n    const unmet = ranges.filter((a) => !satisfies(appVersion, a.range));\n    if (unmet.length) {\n      skipped.push({name, reason: 'range', asks: unmet, appVersion});\n    } else if (nested.has(name)) {\n      skipped.push({name, reason: 'nested', nestedAt: nested.get(name)});\n    } else {\n      names.add(name);\n    }\n  }\n\n  for (const name of ['react', 'react-dom']) {\n    if (await readInstalledPkg(name, appRoot)) names.add(name);\n  }\n  return {names: [...names].sort(), skipped};\n}\n\n/** One line for the dev log about the ranges the app does not satisfy; null when there are none. */\nexport function describeSkipped(skipped: SkippedDedupe[]): string | null {\n  const range = skipped.filter((s) => s.reason === 'range');\n  if (!range.length) return null;\n  return (\n    `[linked] dedupe: ${range.length} package${range.length === 1 ? '' : 's'} a localized checkout ` +\n    `keeps its own copy of, because the app's version is outside its range: ` +\n    range\n      .map(\n        (s) =>\n          `${s.name} (${s.asks!.map((a) => `${a.from} asks ${a.range}`).join(', ')}; app ${s.appVersion})`,\n      )\n      .join(', ')\n  );\n}\n\nfunction satisfies(version: string, range: string): boolean {\n  try {\n    return (\n      semver.validRange(range) !== null && semver.satisfies(version, range)\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Every package name nested below the top level of `nm` — a registry install's\n * private copy — mapped to one place it sits. Symlinks (localized checkouts,\n * workspaces) are not followed: their trees are not the app's install.\n */\nfunction nestedCopies(nm: string): Map<string, string> {\n  const out = new Map<string, string>();\n  const walk = (dir: string, depth: number) => {\n    for (const name of packageNames(dir)) {\n      const pkgDir = path.join(dir, name);\n      let stat: fs.Stats;\n      try {\n        stat = fs.lstatSync(pkgDir);\n      } catch {\n        continue;\n      }\n      if (stat.isSymbolicLink()) continue;\n      if (depth > 0 && !out.has(name))\n        out.set(name, path.relative(path.dirname(nm), pkgDir));\n      walk(path.join(pkgDir, 'node_modules'), depth + 1);\n    }\n  };\n  walk(nm, 0);\n  return out;\n}\n\nfunction packageNames(nm: string): string[] {\n  let entries: string[];\n  try {\n    entries = fs.readdirSync(nm);\n  } catch {\n    return [];\n  }\n  const out: string[] = [];\n  for (const entry of entries) {\n    if (entry.startsWith('.')) continue;\n    if (entry.startsWith('@')) {\n      try {\n        for (const sub of fs.readdirSync(path.join(nm, entry)))\n          out.push(`${entry}/${sub}`);\n      } catch {\n        /* not a directory */\n      }\n    } else {\n      out.push(entry);\n    }\n  }\n  return out;\n}\n\nfunction readJson(file: string): any {\n  try {\n    return JSON.parse(fs.readFileSync(file, 'utf8'));\n  } catch {\n    return null;\n  }\n}\n"]}

package/lib/esm/utils/createPackageLocation.d.ts

@@ -0,0 +1,76 @@
+export declare const PACKAGE_LOCATIONS: readonly ["packages", "packages-local"];
+export type PackageLocation = (typeof PACKAGE_LOCATIONS)[number];
+export interface CreatePackageOptions {
+    /** Validated at runtime too, since the command line passes any string. */
+    location?: PackageLocation;
+    /** A git URL. Implies `packages-local`. */
+    remote?: string;
+    /** Push the initial commit. Needs `remote`. */
+    push?: boolean;
+}
+/**
+ * - `outside`: no app above us — the old behaviour, unchanged.
+ * - `resolved`: the flags (or the prompt's answers) settle it.
+ * - `ask`: inside an app, no flags, on a terminal.
+ * - `refuse`: a contradiction, or no answer and no terminal to ask.
+ */
+export type TargetDecision = {
+    kind: 'outside';
+} | {
+    kind: 'resolved';
+    location: PackageLocation;
+    remote?: string;
+    push: boolean;
+} | {
+    kind: 'ask';
+} | {
+    kind: 'refuse';
+    message: string;
+};
+/** A refusal of create-package's own, as opposed to a crash. */
+export declare class CreatePackageError extends Error {
+    constructor(message: string);
+}
+/**
+ * The nearest directory, from `start` upwards, whose package.json says
+ * `linkedApp: true`. That is the app — whether or not it has `workspaces`,
+ * which the app template does not.
+ */
+export declare function findLinkedAppRoot(start: string): string | null;
+/**
+ * Flags decide everything they can. Any of `--location`, `--remote` or
+ * `--push` is taken as the complete answer, so a scripted call never meets a
+ * prompt; with none of them, a terminal is asked and anything else is refused.
+ */
+export declare function decideCreatePackageTarget({ appRoot, options, isTTY, }: {
+    appRoot: string | null;
+    options: CreatePackageOptions;
+    isTTY: boolean;
+}): TargetDecision;
+export declare function isPackageLocation(value: string): value is PackageLocation;
+/** `@scope/foo-bar` → `foo-bar`: the folder name under `packages/`. */
+export declare function bareName(name: string): string;
+/**
+ * Make sure the app's `workspaces` covers `packages/*`, so a package created
+ * there is a workspace member. Mutates `pkg`.
+ *
+ * @returns whether it changed, and a warning when it cannot tell.
+ */
+export declare function ensureWorkspaceGlob(pkg: Record<string, any>): {
+    changed: boolean;
+    warning?: string;
+};
+export declare const RELINK_COMMAND = "linked localize --relink";
+/**
+ * Make sure the app's `postinstall` recreates localize's links. Without it the
+ * next `npm install` prunes a packages-local link as extraneous. With no
+ * `local-packages.json` the hook prints nothing and exits 0, so it is safe to
+ * commit for everyone. Mutates `pkg`.
+ */
+export declare function ensureRelinkPostinstall(pkg: Record<string, any>): boolean;
+/**
+ * A git remote as npm wants it in `repository.url`: `git+https://…`, or
+ * `git+ssh://git@host/path` for the scp-like `git@host:path` form.
+ */
+export declare function repositoryUrlFor(remote: string): string;
+//# sourceMappingURL=createPackageLocation.d.ts.map

package/lib/esm/utils/createPackageLocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPackageLocation.d.ts","sourceRoot":"","sources":["../../../src/utils/createPackageLocation.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,iBAAiB,yCAA0C,CAAC;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAC,IAAI,EAAE,SAAS,CAAA;CAAC,GACjB;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,GAC7E;IAAC,IAAI,EAAE,KAAK,CAAA;CAAC,GACb;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC;AAEtC,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB9D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,OAAO,EACP,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,cAAc,CAwCjB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAMD,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAsBA;AAED,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAQzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/lib/esm/utils/createPackageLocation.js

@@ -0,0 +1,157 @@
+/**
+ * Where `linked create-package` puts a new package, decided without touching
+ * anything — the IO lives in `createPackage`.
+ *
+ * Inside an app there are two homes, and they mean different things:
+ *
+ * - `packages/` — the package is part of the app's own repository: a tracked
+ *   npm workspace member, declared as a dependency like any other.
+ * - `packages-local/` — the package has a repository of its own. It goes where
+ *   `linked localize` keeps checkouts, under the same name localize would give
+ *   it (`@_linked/foo` → `packages-local/_linked-foo`), and is handed to
+ *   localize's `adopt`, so the two can never disagree about it.
+ */
+import fs from 'fs';
+import path from 'path';
+export const PACKAGE_LOCATIONS = ['packages', 'packages-local'];
+/** A refusal of create-package's own, as opposed to a crash. */
+export class CreatePackageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CreatePackageError';
+    }
+}
+/**
+ * The nearest directory, from `start` upwards, whose package.json says
+ * `linkedApp: true`. That is the app — whether or not it has `workspaces`,
+ * which the app template does not.
+ */
+export function findLinkedAppRoot(start) {
+    let dir = path.resolve(start);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+            if ((pkg === null || pkg === void 0 ? void 0 : pkg.linkedApp) === true)
+                return dir;
+        }
+        catch (_a) {
+            // no package.json here, or not one we can read: keep walking
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Flags decide everything they can. Any of `--location`, `--remote` or
+ * `--push` is taken as the complete answer, so a scripted call never meets a
+ * prompt; with none of them, a terminal is asked and anything else is refused.
+ */
+export function decideCreatePackageTarget({ appRoot, options, isTTY, }) {
+    var _a;
+    const { remote, push = false } = options;
+    const location = options.location;
+    const given = location !== undefined || remote !== undefined || push;
+    if (location !== undefined && !isPackageLocation(location)) {
+        return refuse(`--location must be one of ${PACKAGE_LOCATIONS.join(', ')}, not "${location}".`);
+    }
+    if (!appRoot) {
+        return given
+            ? refuse(`--location, --remote and --push only apply inside a linked app, and no package.json ` +
+                `with "linkedApp": true was found above this directory.`)
+            : { kind: 'outside' };
+    }
+    if (push && !remote) {
+        return refuse('--push needs --remote: there is nowhere to push to.');
+    }
+    if (remote && location === 'packages') {
+        return refuse(`--remote gives the package a repository of its own, but packages/ is for packages that ` +
+            `live in the app's repository. Use --location packages-local, or drop --remote.`);
+    }
+    if (given) {
+        return Object.assign(Object.assign({ kind: 'resolved', location: (_a = location) !== null && _a !== void 0 ? _a : 'packages-local' }, (remote ? { remote } : {})), { push });
+    }
+    if (isTTY)
+        return { kind: 'ask' };
+    return refuse(`Where should the package go? Pass --location packages (part of this app's repository) or ` +
+        `--location packages-local (its own repository, optionally with --remote <git-url>).`);
+}
+export function isPackageLocation(value) {
+    return PACKAGE_LOCATIONS.includes(value);
+}
+function refuse(message) {
+    return { kind: 'refuse', message };
+}
+/** `@scope/foo-bar` → `foo-bar`: the folder name under `packages/`. */
+export function bareName(name) {
+    const match = name.match(/(@[\w\-]+\/)?([\w\-]+)/);
+    if (!match) {
+        throw new CreatePackageError(`"${name}" is not a usable package name.`);
+    }
+    return match[2];
+}
+/**
+ * Make sure the app's `workspaces` covers `packages/*`, so a package created
+ * there is a workspace member. Mutates `pkg`.
+ *
+ * @returns whether it changed, and a warning when it cannot tell.
+ */
+export function ensureWorkspaceGlob(pkg) {
+    var _a;
+    const covers = (globs) => globs.some((g) => g === 'packages/*' || g === 'packages/**');
+    if (pkg.workspaces === undefined) {
+        pkg.workspaces = ['packages/*'];
+        return { changed: true };
+    }
+    const globs = Array.isArray(pkg.workspaces)
+        ? pkg.workspaces
+        : Array.isArray((_a = pkg.workspaces) === null || _a === void 0 ? void 0 : _a.packages)
+            ? pkg.workspaces.packages
+            : null;
+    if (!globs) {
+        return {
+            changed: false,
+            warning: `the app's "workspaces" field has a shape this command does not edit; make sure it covers packages/*.`,
+        };
+    }
+    if (covers(globs))
+        return { changed: false };
+    globs.push('packages/*');
+    return { changed: true };
+}
+export const RELINK_COMMAND = 'linked localize --relink';
+/**
+ * Make sure the app's `postinstall` recreates localize's links. Without it the
+ * next `npm install` prunes a packages-local link as extraneous. With no
+ * `local-packages.json` the hook prints nothing and exits 0, so it is safe to
+ * commit for everyone. Mutates `pkg`.
+ */
+export function ensureRelinkPostinstall(pkg) {
+    var _a;
+    pkg.scripts = (_a = pkg.scripts) !== null && _a !== void 0 ? _a : {};
+    const current = pkg.scripts.postinstall;
+    if (current && /localize\s+--relink/.test(current))
+        return false;
+    pkg.scripts.postinstall = current
+        ? `${current} && ${RELINK_COMMAND}`
+        : RELINK_COMMAND;
+    return true;
+}
+/**
+ * A git remote as npm wants it in `repository.url`: `git+https://…`, or
+ * `git+ssh://git@host/path` for the scp-like `git@host:path` form.
+ */
+export function repositoryUrlFor(remote) {
+    const url = remote.trim();
+    if (url.startsWith('git+'))
+        return url;
+    const scp = /^([\w.-]+@[\w.-]+):(?!\/)(.+)$/.exec(url);
+    if (scp)
+        return `git+ssh://${scp[1]}/${scp[2]}`;
+    if (/^(https?|ssh):\/\//.test(url))
+        return `git+${url}`;
+    return url;
+}
+//# sourceMappingURL=createPackageLocation.js.map

package/lib/esm/utils/createPackageLocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPackageLocation.js","sourceRoot":"","sources":["../../../src/utils/createPackageLocation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Where `linked create-package` puts a new package, decided without touching\n * anything — the IO lives in `createPackage`.\n *\n * Inside an app there are two homes, and they mean different things:\n *\n * - `packages/` — the package is part of the app's own repository: a tracked\n *   npm workspace member, declared as a dependency like any other.\n * - `packages-local/` — the package has a repository of its own. It goes where\n *   `linked localize` keeps checkouts, under the same name localize would give\n *   it (`@_linked/foo` → `packages-local/_linked-foo`), and is handed to\n *   localize's `adopt`, so the two can never disagree about it.\n */\nimport fs from 'fs';\nimport path from 'path';\n\nexport const PACKAGE_LOCATIONS = ['packages', 'packages-local'] as const;\nexport type PackageLocation = (typeof PACKAGE_LOCATIONS)[number];\n\nexport interface CreatePackageOptions {\n  /** Validated at runtime too, since the command line passes any string. */\n  location?: PackageLocation;\n  /** A git URL. Implies `packages-local`. */\n  remote?: string;\n  /** Push the initial commit. Needs `remote`. */\n  push?: boolean;\n}\n\n/**\n * - `outside`: no app above us — the old behaviour, unchanged.\n * - `resolved`: the flags (or the prompt's answers) settle it.\n * - `ask`: inside an app, no flags, on a terminal.\n * - `refuse`: a contradiction, or no answer and no terminal to ask.\n */\nexport type TargetDecision =\n  | {kind: 'outside'}\n  | {kind: 'resolved'; location: PackageLocation; remote?: string; push: boolean}\n  | {kind: 'ask'}\n  | {kind: 'refuse'; message: string};\n\n/** A refusal of create-package's own, as opposed to a crash. */\nexport class CreatePackageError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CreatePackageError';\n  }\n}\n\n/**\n * The nearest directory, from `start` upwards, whose package.json says\n * `linkedApp: true`. That is the app — whether or not it has `workspaces`,\n * which the app template does not.\n */\nexport function findLinkedAppRoot(start: string): string | null {\n  let dir = path.resolve(start);\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    try {\n      const pkg = JSON.parse(\n        fs.readFileSync(path.join(dir, 'package.json'), 'utf8'),\n      );\n      if (pkg?.linkedApp === true) return dir;\n    } catch {\n      // no package.json here, or not one we can read: keep walking\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\n/**\n * Flags decide everything they can. Any of `--location`, `--remote` or\n * `--push` is taken as the complete answer, so a scripted call never meets a\n * prompt; with none of them, a terminal is asked and anything else is refused.\n */\nexport function decideCreatePackageTarget({\n  appRoot,\n  options,\n  isTTY,\n}: {\n  appRoot: string | null;\n  options: CreatePackageOptions;\n  isTTY: boolean;\n}): TargetDecision {\n  const {remote, push = false} = options;\n  const location: string | undefined = options.location;\n  const given = location !== undefined || remote !== undefined || push;\n\n  if (location !== undefined && !isPackageLocation(location)) {\n    return refuse(\n      `--location must be one of ${PACKAGE_LOCATIONS.join(', ')}, not \"${location}\".`,\n    );\n  }\n  if (!appRoot) {\n    return given\n      ? refuse(\n          `--location, --remote and --push only apply inside a linked app, and no package.json ` +\n            `with \"linkedApp\": true was found above this directory.`,\n        )\n      : {kind: 'outside'};\n  }\n  if (push && !remote) {\n    return refuse('--push needs --remote: there is nowhere to push to.');\n  }\n  if (remote && location === 'packages') {\n    return refuse(\n      `--remote gives the package a repository of its own, but packages/ is for packages that ` +\n        `live in the app's repository. Use --location packages-local, or drop --remote.`,\n    );\n  }\n  if (given) {\n    return {\n      kind: 'resolved',\n      location: (location as PackageLocation) ?? 'packages-local',\n      ...(remote ? {remote} : {}),\n      push,\n    };\n  }\n  if (isTTY) return {kind: 'ask'};\n  return refuse(\n    `Where should the package go? Pass --location packages (part of this app's repository) or ` +\n      `--location packages-local (its own repository, optionally with --remote <git-url>).`,\n  );\n}\n\nexport function isPackageLocation(value: string): value is PackageLocation {\n  return (PACKAGE_LOCATIONS as readonly string[]).includes(value);\n}\n\nfunction refuse(message: string): TargetDecision {\n  return {kind: 'refuse', message};\n}\n\n/** `@scope/foo-bar` → `foo-bar`: the folder name under `packages/`. */\nexport function bareName(name: string): string {\n  const match = name.match(/(@[\\w\\-]+\\/)?([\\w\\-]+)/);\n  if (!match) {\n    throw new CreatePackageError(`\"${name}\" is not a usable package name.`);\n  }\n  return match[2];\n}\n\n/**\n * Make sure the app's `workspaces` covers `packages/*`, so a package created\n * there is a workspace member. Mutates `pkg`.\n *\n * @returns whether it changed, and a warning when it cannot tell.\n */\nexport function ensureWorkspaceGlob(pkg: Record<string, any>): {\n  changed: boolean;\n  warning?: string;\n} {\n  const covers = (globs: unknown[]) =>\n    globs.some((g) => g === 'packages/*' || g === 'packages/**');\n\n  if (pkg.workspaces === undefined) {\n    pkg.workspaces = ['packages/*'];\n    return {changed: true};\n  }\n  const globs = Array.isArray(pkg.workspaces)\n    ? pkg.workspaces\n    : Array.isArray(pkg.workspaces?.packages)\n      ? pkg.workspaces.packages\n      : null;\n  if (!globs) {\n    return {\n      changed: false,\n      warning: `the app's \"workspaces\" field has a shape this command does not edit; make sure it covers packages/*.`,\n    };\n  }\n  if (covers(globs)) return {changed: false};\n  globs.push('packages/*');\n  return {changed: true};\n}\n\nexport const RELINK_COMMAND = 'linked localize --relink';\n\n/**\n * Make sure the app's `postinstall` recreates localize's links. Without it the\n * next `npm install` prunes a packages-local link as extraneous. With no\n * `local-packages.json` the hook prints nothing and exits 0, so it is safe to\n * commit for everyone. Mutates `pkg`.\n */\nexport function ensureRelinkPostinstall(pkg: Record<string, any>): boolean {\n  pkg.scripts = pkg.scripts ?? {};\n  const current: string | undefined = pkg.scripts.postinstall;\n  if (current && /localize\\s+--relink/.test(current)) return false;\n  pkg.scripts.postinstall = current\n    ? `${current} && ${RELINK_COMMAND}`\n    : RELINK_COMMAND;\n  return true;\n}\n\n/**\n * A git remote as npm wants it in `repository.url`: `git+https://…`, or\n * `git+ssh://git@host/path` for the scp-like `git@host:path` form.\n */\nexport function repositoryUrlFor(remote: string): string {\n  const url = remote.trim();\n  if (url.startsWith('git+')) return url;\n  const scp = /^([\\w.-]+@[\\w.-]+):(?!\\/)(.+)$/.exec(url);\n  if (scp) return `git+ssh://${scp[1]}/${scp[2]}`;\n  if (/^(https?|ssh):\\/\\//.test(url)) return `git+${url}`;\n  return url;\n}\n"]}

package/lib/esm/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,WAAW,EAAC,MAAM,eAAe,CAAC;AAKhD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAsBpD,eAAO,IAAI,cAAc,GAAmB,aAAQ,sBAwEnD,CAAC;AA4BF;;;;;;;;;;;;;GAaG;AACH,eAAO,IAAI,sBAAsB,GAAa,YAAY,MAAM,YAQ/D,CAAC;AACF;;;;;;;;GAQG;AACH,eAAO,IAAI,wBAAwB,GACjC,YAAY,MAAM,EAClB,cAAc,MAAM,YAerB,CAAC;AAEF,eAAO,IAAI,cAAc,GAAa,aAAoB,EAAE,eAAY,QAcvE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,IAAI,oBAAoB,GAC7B,iBAAY,EACZ,kBAAiB,GAAG,CAAC,MAAM,CAAa,KACvC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EA2I5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,gBAAW;;;;CAE3C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,gBAAW;;;;CAUpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,gBAAW,KACV,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,CAoBzD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,aAAQ,EAAE,WAAW;;;;CAsBxD,CAAC;AAGF,eAAO,IAAI,oBAAoB,GAAa,gBAAW,EAAE,cAAS,QA2BjE,CAAC;AACF,wBAAgB,KAAK,CACnB,GAAG,KAAA,EACH,GAAG,GAAE,OAAe,EACpB,UAAU,GAAE,OAAe,EAC3B,OAAO,GAAE,GAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED,wBAAgB,WAAW,CACzB,OAAO,KAAA,EACP,GAAG,UAAQ,EACX,UAAU,GAAE,OAAe,EAC3B,OAAO,CAAC,EAAE,WAAW,EACrB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,OAAO,EAAC,4BAA4B,EAAC,MAAM,uBAAuB,CAAC;AACnE,wBAAgB,kBAAkB,CAAC,YAAY,KAAA,EAAE,QAAQ,KAAA,EAAE,GAAG,CAAC,KAAA,UAwB9D;AAED,eAAO,MAAM,eAAe,GAC1B,KAAK,cAAc,EACnB,uBAAuB,OAAO,EAC9B,MAAK,OAAe,qBAyCrB,CAAC;AAEF,wBAAgB,GAAG,CAAC,GAAG,QAAQ,OAAA,QAI9B;AAED,wBAAgB,KAAK,CAAC,MAAM,KAAA,EAAE,GAAG,QAAQ,OAAA,QAIxC;AAED,wBAAgB,SAAS,CAAC,GAAG,QAAQ,OAAA,QAiBpC;AAED,wBAAgB,IAAI,CAAC,GAAG,QAAQ,OAAA,QAI/B;AAED,wBAAgB,OAAO,CAAC,GAAG,KAAA,OAI1B;AAED,wBAAgB,uBAAuB;;;EAKtC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,WAAW,EAAC,MAAM,eAAe,CAAC;AAKhD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAuBpD,eAAO,IAAI,cAAc,GAAmB,aAAQ,sBAwEnD,CAAC;AA4BF;;;;;;;;;;;;;GAaG;AACH,eAAO,IAAI,sBAAsB,GAAa,YAAY,MAAM,YAQ/D,CAAC;AACF;;;;;;;;GAQG;AACH,eAAO,IAAI,wBAAwB,GACjC,YAAY,MAAM,EAClB,cAAc,MAAM,YAerB,CAAC;AAEF,eAAO,IAAI,cAAc,GAAa,aAAoB,EAAE,eAAY,QAcvE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,IAAI,oBAAoB,GAC7B,iBAAY,EACZ,kBAAiB,GAAG,CAAC,MAAM,CAAa,KACvC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EA2I5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,gBAAW;;;;CAE3C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,gBAAW;;;;CAUpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,gBAAW,KACV,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,CAoBzD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,aAAQ,EAAE,WAAW;;;;CAsBxD,CAAC;AAGF,eAAO,IAAI,oBAAoB,GAAa,gBAAW,EAAE,cAAS,QA2BjE,CAAC;AACF,wBAAgB,KAAK,CACnB,GAAG,KAAA,EACH,GAAG,GAAE,OAAe,EACpB,UAAU,GAAE,OAAe,EAC3B,OAAO,GAAE,GAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED,wBAAgB,WAAW,CACzB,OAAO,KAAA,EACP,GAAG,UAAQ,EACX,UAAU,GAAE,OAAe,EAC3B,OAAO,CAAC,EAAE,WAAW,EACrB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,OAAO,EAAC,4BAA4B,EAAC,MAAM,uBAAuB,CAAC;AACnE,wBAAgB,kBAAkB,CAAC,YAAY,KAAA,EAAE,QAAQ,KAAA,EAAE,GAAG,CAAC,KAAA,UAwB9D;AAED,eAAO,MAAM,eAAe,GAC1B,KAAK,cAAc,EACnB,uBAAuB,OAAO,EAC9B,MAAK,OAAe,qBAyCrB,CAAC;AAEF,wBAAgB,GAAG,CAAC,GAAG,QAAQ,OAAA,QAI9B;AAED,wBAAgB,KAAK,CAAC,MAAM,KAAA,EAAE,GAAG,QAAQ,OAAA,QAIxC;AAED,wBAAgB,SAAS,CAAC,GAAG,QAAQ,OAAA,QAiBpC;AAED,wBAAgB,IAAI,CAAC,GAAG,QAAQ,OAAA,QAI/B;AAED,wBAAgB,OAAO,CAAC,GAAG,KAAA,OAI1B;AAED,wBAAgB,uBAAuB;;;EAKtC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/lib/esm/utils.js

@@ -13,6 +13,7 @@ import * as fs from 'fs';
 import { builtinModules } from 'module';
 import * as path from 'path';
 import ts from 'typescript';
+import { isLinkedPackageJson } from './installed-packages.js';
 import { findNearestPackageJsonSync } from 'find-nearest-package-json';
 import * as glob from 'glob';
 var gruntConfig;
@@ -194,7 +195,7 @@ export var getLINCDDependencies = function (packageJson, checkedPackages = new S
             if (!checkedPackages.has(dependency)) {
                 let [modulePackageJson, modulePath] = getModulePackageJSON(dependency);
                 checkedPackages.add(dependency);
-                if (modulePackageJson === null || modulePackageJson === void 0 ? void 0 : modulePackageJson.lincd) {
+                if (isLinkedPackageJson(modulePackageJson)) {
                     lincdPackagePaths.push([
                         modulePackageJson.name,
                         modulePath,