@_linked/cli 1.46.2 → 1.47.1

package/lib/esm/lifecycle.js

@@ -19,10 +19,11 @@ import path from 'path';
 import chalk from 'chalk';
 import { getPackageJSON } from './utils.js';
 import { isLinkedPackageJson } from './installed-packages.js';
-import { readManifest } from './localize/manifest.js';
+import { LOCAL_DIR, localMembers } from './localize/members.js';
 import { parseWorkspacePatterns, isWorkspacePathNegated } from './workspace-globs.js';
 // Shared with the CSS loader's mode resolution, which must pick the same profiles.
 import { readEnvNamesFromArgv } from './loader-mode.js';
+import { importFile } from './utils/platform.js';
 /**
  * Load the app's environment into `process.env`, then re-apply the original
  * shell env so it always wins on conflict. Idempotent — runs at most once.
@@ -157,7 +158,7 @@ export function loadBackendStorageConfig() {
                 // Variable specifier is intentional — we discover the path at
                 // runtime by probing the candidate list, so static analysis is
                 // impossible.
-                return import(/* @vite-ignore */ candidate);
+                return importFile(candidate);
             }
         }
         console.warn(chalk.yellow('[linked.backend.storage] no linked.backend.storage.{ts,js} found at app root.'));
@@ -165,13 +166,12 @@ export function loadBackendStorageConfig() {
     });
 }
 /**
- * Directory holding localized checkouts (`linked localize`). It is
- * deliberately in NO workspace glob — that is the whole point of the design,
- * since npm learning about these checkouts is what made their predecessor
- * under `packages/` a trap — so any walk of `workspaces` alone cannot see it
- * and has to be told about it separately.
+ * Directory holding localized checkouts (`linked localize`). An app set up by
+ * `linked localize` lists `packages-local/*` in its `workspaces`, so a walk of
+ * the globs finds them as workspace members; it is still walked on its own for
+ * an app that has not been set up yet (no glob, or no `workspaces` at all).
  */
-export const LOCAL_PACKAGES_DIR = 'packages-local';
+export const LOCAL_PACKAGES_DIR = LOCAL_DIR;
 /**
  * Walk the app's `package.json` `workspaces` field and return every
  * workspace package that declares `"linkedPackage": true`.
@@ -196,8 +196,10 @@ export function getLincdPackages(rootPath = process.cwd()) {
  *
  * Two sources, because the workspace globs are not the whole picture any more:
  *
- *   1. the `workspaces` field (negations honoured — see ./workspace-globs.js);
- *   2. `packages-local/`, the localized checkouts, which is in no glob.
+ *   1. the `workspaces` field (negations honoured — see ./workspace-globs.js),
+ *      which includes `packages-local/*` in an app set up for localizing;
+ *   2. `packages-local/`, the localized checkouts, for an app whose globs do
+ *      not reach it. A checkout a glob already found is not added twice.
  *
  * Nothing is filtered out here. Callers decide what they can act on and are
  * expected to SAY what they skipped and why.
@@ -246,8 +248,8 @@ function checkLocalPackagesDir(rootPath, localPackagesDir, res) {
         const packagePath = path.join(dir, entry);
         if (!fs.statSync(packagePath).isDirectory())
             continue;
-        // A checkout that some glob already picked up must not appear twice —
-        // duplicates would be built twice and counted twice.
+        // A checkout a glob already picked up (`packages-local/*`) must not
+        // appear twice — duplicates would be built twice and counted twice.
         if (already.has(path.resolve(packagePath)))
             continue;
         addPackage(packagePath, 'local-packages-dir', res);
@@ -356,47 +358,71 @@ function filterPackagesByDependencyTree(allPackages, appRootPath) {
     return relevantPackages;
 }
 /**
- * The package names recorded in the app's `local-packages.json` — what
- * `linked localize` has linked — read with localize's own reader. Read
- * tolerantly: `linked localize` refuses a malformed file (and warns about a
- * malformed entry) loudly, so here a missing or unusable file is simply
- * "nothing localized", and a malformed entry is skipped without a word.
+ * The names of the app's localized checkouts — every directory in
+ * `packages-local/` with a named `package.json` (localize/members.ts). Nothing
+ * there is simply "nothing localized".
  */
 export function localizedPackageNames(appRootPath) {
-    try {
-        return Object.keys(readManifest(appRootPath, { warn: () => { } }).entries);
-    }
-    catch (_a) {
-        return [];
-    }
+    return localMembers(appRootPath).map((member) => member.name);
 }
 /** The package whose `linked` bin the other packages' build scripts run. */
 export const BUILD_TOOL_PACKAGE = '@_linked/cli';
+/** The package names a package's `dependencies` field lists. */
+function declaredDependencies(pkg) {
+    var _a;
+    return Object.keys(((_a = getPackageJSON(pkg.path, false)) === null || _a === void 0 ? void 0 : _a.dependencies) || {});
+}
 /**
- * Take the build tool (`@_linked/cli`) out of the dependency-ordered build.
+ * Split the build around the build tool (`@_linked/cli`).
  *
  * Every other package's `build` script runs `linked build`, which is THIS
  * package's `lib/`. Built in parallel with them, its `rimraf ./lib` pulled that
  * `lib/` out from under their builds (`ENOENT …/lib/esm/installed-packages.js`),
  * and whatever was built before it ran a stale cli. So when it is in the set it
- * is built first and alone, and the rest only once it has succeeded.
+ * is built alone, and the rest only once it has succeeded.
  *
- * `--from` reads the tool as the first package in the order: `--from` the tool
- * builds it and then everything; `--from` anything else resumes past it, so it
- * is not rebuilt.
+ * It cannot be built FIRST, though: a localized `@_linked/core` it depends on
+ * must have its `lib/` before the tool's `tsc` runs. So the tool's own
+ * dependencies among the packages to build (`pre`, the transitive closure of
+ * `dependencies`) go before it, in dependency order. They build with the tool
+ * as it was before this run, which is what a fresh checkout's `npm run build`
+ * does too.
+ *
+ * `--from` reads the order as `pre`, then the tool, then `rest`: it resumes
+ * inside whichever group holds the package and passes over the groups before
+ * it. A name in none of them goes to `rest`, which reports it.
  */
-export function orderBuildToolFirst(packages, from) {
+export function orderBuildToolFirst(packages, from, dependenciesOf = declaredDependencies) {
     const tool = packages.get(BUILD_TOOL_PACKAGE);
-    if (!tool)
-        return { buildToolFirst: false, rest: packages, from };
+    if (!tool) {
+        return { pre: new Map(), rest: packages, start: from ? 'rest' : 'pre', from };
+    }
+    // Depth-first, dependencies before dependents, so `pre` is in build order.
+    // A cycle back to the tool (or within `pre`) is cut where it closes.
+    const pre = new Map();
+    const visiting = new Set([BUILD_TOOL_PACKAGE]);
+    const visit = (pkg) => {
+        for (const dep of dependenciesOf(pkg)) {
+            const depPkg = packages.get(dep);
+            if (!depPkg || visiting.has(dep) || pre.has(dep))
+                continue;
+            visiting.add(dep);
+            visit(depPkg);
+            pre.set(dep, depPkg);
+        }
+    };
+    visit(tool);
     const rest = new Map(packages);
     rest.delete(BUILD_TOOL_PACKAGE);
+    for (const name of pre.keys())
+        rest.delete(name);
     if (!from)
-        return { tool, buildToolFirst: true, rest };
-    if (from === BUILD_TOOL_PACKAGE) {
-        return { tool, buildToolFirst: true, rest, from: undefined };
-    }
-    return { tool, buildToolFirst: false, rest, from };
+        return { pre, tool, rest, start: 'pre' };
+    if (pre.has(from))
+        return { pre, tool, rest, start: 'pre', from };
+    if (from === BUILD_TOOL_PACKAGE)
+        return { pre, tool, rest, start: 'tool' };
+    return { pre, tool, rest, start: 'rest', from };
 }
 /**
  * Decide what `build-all` builds.

package/lib/esm/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["// Lifecycle helpers shared by the Vite-based dev orchestrator.\n//\n// Extracted from cli-methods.ts so the SSR module graph (started from\n// `commands/start.ts`) doesn't have to walk the rest of that file. The\n// the older helpers in cli-methods.ts contain many dynamic\n// `import(<variable>)` calls Vite can't analyze statically and would\n// emit warnings about — even though startWithVite never calls them.\n\nimport fs from 'fs-extra';\nimport path from 'path';\nimport chalk from 'chalk';\nimport {getPackageJSON} from './utils.js';\nimport {isLinkedPackageJson} from './installed-packages.js';\nimport {readManifest} from './localize/manifest.js';\nimport {parseWorkspacePatterns, isWorkspacePathNegated} from './workspace-globs.js';\n// Shared with the CSS loader's mode resolution, which must pick the same profiles.\nimport {readEnvNamesFromArgv} from './loader-mode.js';\nimport type {PackageDetails} from './interfaces.js';\n\n/**\n * Load the app's environment into `process.env`, then re-apply the original\n * shell env so it always wins on conflict. Idempotent — runs at most once.\n *\n * Two sources, tried in this order:\n *   1. `.env` (Node-native `process.loadEnvFile`, no dependency) — a flat file.\n *      This is what the app template ships and the only form that will survive.\n *      `--env` is not consulted here: a flat `.env` has no profiles, so\n *      NODE_ENV comes from the file or the shell.\n *   2. `.env-cmdrc.json` (DEPRECATED, via `env-cmd`) — profile-based; honours\n *      `--env a,b` and merges `_main` + the named profiles. Still read when it\n *      is the only file present, so no existing app breaks, but it warns.\n *\n * `.env` going first is what makes migrating a one-step job: add the flat file\n * and it takes over. The profile file can then be deleted whenever convenient.\n *\n * If neither file exists we skip silently — CN-hosted apps have their env\n * injected into the child process at spawn time, so there's nothing to read\n * from disk.\n */\nexport const ensureEnvironmentLoaded = async (\n  environmentNames?: string[],\n): Promise<void> => {\n  if (process.env.ENV_VARS_LOADED) return;\n  const cwd = process.cwd();\n  const envCmdrcPath = path.join(cwd, '.env-cmdrc.json');\n  const dotEnvPath = path.join(cwd, '.env');\n\n  // Snapshot the original shell env — it should always take priority over\n  // whatever a file sets (so injected/production env wins over dev defaults).\n  const shellEnv = {...process.env};\n\n  const hasDotEnv = fs.existsSync(dotEnvPath);\n  const hasEnvCmdrc = fs.existsSync(envCmdrcPath);\n\n  for (const notice of envDeprecationNotices({hasEnvCmdrc, hasDotEnv})) {\n    console.warn(chalk.yellow(notice));\n  }\n\n  if (hasDotEnv) {\n    // Native flat-file loader (Node 20.12+). Populates process.env from `.env`.\n    process.loadEnvFile(dotEnvPath);\n  } else if (hasEnvCmdrc) {\n    await loadEnvCmdrc(envCmdrcPath, environmentNames);\n  } else {\n    console.warn(\n      'No .env or .env-cmdrc.json found in this folder — relying on the ambient environment.',\n    );\n  }\n\n  // Re-apply shell env so it always wins over file values.\n  process.env = {...process.env, ...shellEnv};\n  process.env.ENV_VARS_LOADED = 'true';\n};\n\n/**\n * What to tell an app about where its environment came from.\n *\n * `.env-cmdrc.json` is still read when it is the only file present, so no app\n * breaks today. But it is the only reason `--env` exists, and both are going\n * away.\n *\n * The case worth shouting about is an app holding both files: `.env` wins, so\n * the profile file and every `--env` name passed with it do nothing. That is\n * the intended migration path, but it is invisible from the outside — values\n * an app still believes it is getting from a profile are simply absent.\n *\n * Pure and exported so the messages can be asserted without a chdir.\n */\nexport const envDeprecationNotices = (sources: {\n  hasEnvCmdrc: boolean;\n  hasDotEnv: boolean;\n}): string[] => {\n  if (!sources.hasEnvCmdrc) return [];\n  const notices = [\n    '.env-cmdrc.json is deprecated and will be removed in a future major release.',\n    '  Move its values into a flat `.env`, and supply anything that differs per ' +\n      'deployment from the environment itself. `--env` goes away with it.',\n  ];\n  if (sources.hasDotEnv) {\n    notices.push(\n      '  This app has BOTH files. `.env` wins, so `.env-cmdrc.json` — and any ' +\n        '`--env` profile named with it — is being ignored entirely. Delete it once ' +\n        'the flat file is complete.',\n    );\n  }\n  return notices;\n};\n\n/**\n * Legacy loader: reads `.env-cmdrc.json`, merges `_main` plus the profile(s)\n * named by `--env a,b` (default `development`). Kept for CN and existing apps\n * until they migrate to a flat `.env`.\n */\nconst loadEnvCmdrc = async (\n  envCmdrcPath: string,\n  environmentNames?: string[],\n): Promise<void> => {\n  // env-cmd ships ESM; literal specifier is fine for Vite's analyzer.\n  const {GetEnvVars} = await import('env-cmd');\n  const vars = await GetEnvVars({envFile: {filePath: envCmdrcPath}});\n  const environments = Object.keys(vars);\n\n  if (environments.includes('_main')) {\n    process.env = {...process.env, ...vars._main};\n  }\n  // Callers that parsed `--env` themselves pass the names in. Commands that\n  // have not been converted yet still have their names scraped off argv.\n  const requested = environmentNames?.length\n    ? environmentNames\n    : readEnvNamesFromArgv();\n  if (requested.length) {\n    requested.forEach((name) => {\n      if (environments.includes(name)) {\n        console.log('Environment: ' + name);\n        process.env = {...process.env, ...vars[name]};\n      } else {\n        console.warn(\n          `Environment ${name} not found in .env-cmdrc.json. Available: ${environments.join(', ')}`,\n        );\n      }\n    });\n  } else {\n    process.env = {...process.env, ...vars.development};\n    console.log('No environment specified, using development');\n  }\n};\n\n/**\n * Discover and load the app's storage-config bootstrap file. Tries the\n * canonical `linked.backend.storage.{ts,js}` first, then legacy paths.\n * Returns whatever the file's default export evaluates to, or undefined\n * if no candidate exists.\n */\nexport async function loadBackendStorageConfig(): Promise<any> {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'linked.backend.storage.ts'),\n    path.join(cwd, 'linked.backend.storage.js'),\n    path.join(cwd, 'backend-storage-config.ts'),\n    path.join(cwd, 'backend-storage-config.js'),\n    path.join(cwd, 'scripts', 'backend-storage-config.js'),\n    path.join(cwd, 'scripts', 'backend-storage-config.ts'),\n    path.join(cwd, 'scripts', 'storage-config.js'),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) {\n      // Variable specifier is intentional — we discover the path at\n      // runtime by probing the candidate list, so static analysis is\n      // impossible.\n      return import(/* @vite-ignore */ candidate);\n    }\n  }\n  console.warn(\n    chalk.yellow(\n      '[linked.backend.storage] no linked.backend.storage.{ts,js} found at app root.',\n    ),\n  );\n  return undefined;\n}\n\n/**\n * A local package directory found by {@link discoverLocalPackages}, together\n * with the facts that decide what can be done with it.\n *\n * The facts are recorded rather than filtered on, because the bug this type\n * exists to fix was a SILENT filter: `build-all` discovered only packages\n * carrying `linkedPackage: true` and printed nothing about the rest, so\n * `@_linked/maps` — a shipped dependency that simply never got the flag — was\n * dropped from a green build for as long as nobody counted the names.\n */\nexport interface LocalPackage extends PackageDetails {\n  /** Where the walk found it. */\n  source: 'workspace' | 'local-packages-dir';\n  /** `linkedPackage: true` — see `isLinkedPackageJson`. */\n  isLinkedPackage: boolean;\n  /** `linkedApp: true` — built by `linked build-app`, not `linked build`. */\n  isApp: boolean;\n  /** Has a `build` script of its own, which is what `build-all` invokes. */\n  hasBuildScript: boolean;\n}\n\n/**\n * Directory holding localized checkouts (`linked localize`). It is\n * deliberately in NO workspace glob — that is the whole point of the design,\n * since npm learning about these checkouts is what made their predecessor\n * under `packages/` a trap — so any walk of `workspaces` alone cannot see it\n * and has to be told about it separately.\n */\nexport const LOCAL_PACKAGES_DIR = 'packages-local';\n\n/**\n * Walk the app's `package.json` `workspaces` field and return every\n * workspace package that declares `\"linkedPackage\": true`.\n *\n * Lives here (not in cli-methods.ts) so consumers like LinkedServer can\n * import it without dragging the rest of the legacy cli-methods flow into\n * Vite's SSR module graph.\n *\n * Kept deliberately narrow: this is the set the dev resolver and the runtime\n * treat as linked packages. Commands that want every *buildable* local\n * package — flag or no flag, workspace or localized checkout — want\n * {@link discoverLocalPackages} instead.\n */\nexport function getLincdPackages(\n  rootPath = process.cwd(),\n): PackageDetails[] {\n  return discoverLocalPackages(rootPath, {includeLocalPackagesDir: false})\n    .filter((pkg) => pkg.isLinkedPackage)\n    .map(({path: packagePath, packageName}) => ({path: packagePath, packageName}));\n}\n\n/**\n * Every local package directory this app can see, whether or not it declares\n * `linkedPackage: true`.\n *\n * Two sources, because the workspace globs are not the whole picture any more:\n *\n *   1. the `workspaces` field (negations honoured — see ./workspace-globs.js);\n *   2. `packages-local/`, the localized checkouts, which is in no glob.\n *\n * Nothing is filtered out here. Callers decide what they can act on and are\n * expected to SAY what they skipped and why.\n */\nexport function discoverLocalPackages(\n  rootPath = process.cwd(),\n  options: {includeLocalPackagesDir?: boolean; localPackagesDir?: string} = {},\n): LocalPackage[] {\n  const {includeLocalPackagesDir = true, localPackagesDir = LOCAL_PACKAGES_DIR} =\n    options;\n\n  let pack = getPackageJSON(rootPath);\n  if (!pack || !pack.workspaces) {\n    const originalRoot = rootPath;\n    for (let i = 0; i <= 3; i++) {\n      rootPath = path.join(originalRoot, ...Array(i).fill('..'));\n      pack = getPackageJSON(rootPath);\n      if (pack && pack.workspaces) break;\n    }\n    if (!pack || !pack.workspaces) {\n      // Standalone apps (scaffolded with `linked create-app`) don't have\n      // workspaces — expected. Fall back to the original root so a\n      // `packages-local/` beside it is still found.\n      rootPath = originalRoot;\n    }\n  }\n\n  const res: LocalPackage[] = [];\n  if (pack && pack.workspaces) {\n    checkWorkspaces(rootPath, pack.workspaces, res);\n  }\n  if (includeLocalPackagesDir) {\n    checkLocalPackagesDir(rootPath, localPackagesDir, res);\n  }\n  return res;\n}\n\n/**\n * Add every immediate subdirectory of `packages-local/` that holds a\n * `package.json`. No glob, no negations: the directory has no `workspaces`\n * entry to interpret, its contents are there because a developer localized\n * them on purpose, and each one is a plain checkout.\n */\nfunction checkLocalPackagesDir(\n  rootPath: string,\n  localPackagesDir: string,\n  res: LocalPackage[],\n) {\n  const dir = path.join(rootPath, localPackagesDir);\n  if (!fs.existsSync(dir)) return;\n  const already = new Set(res.map((pkg) => path.resolve(pkg.path)));\n  for (const entry of fs.readdirSync(dir)) {\n    if (entry.startsWith('.')) continue;\n    const packagePath = path.join(dir, entry);\n    if (!fs.statSync(packagePath).isDirectory()) continue;\n    // A checkout that some glob already picked up must not appear twice —\n    // duplicates would be built twice and counted twice.\n    if (already.has(path.resolve(packagePath))) continue;\n    addPackage(packagePath, 'local-packages-dir', res);\n  }\n}\n\nfunction checkWorkspaces(rootPath: string, workspaces: any, res: LocalPackage[]) {\n  // Negated entries (\"!packages/core\") are excluded the way npm excludes them\n  // — including from the exact-path branch below, which npm also subjects to\n  // them. See ./workspace-globs.js.\n  const {patterns, negatedPatterns} = parseWorkspacePatterns(workspaces);\n  const checkUnlessNegated = (packagePath: string) => {\n    const rel = path.relative(rootPath, packagePath).split(path.sep).join('/');\n    if (isWorkspacePathNegated(rel, negatedPatterns)) return;\n    checkPackagePath(rootPath, packagePath, res);\n  };\n  patterns.forEach((workspace: string) => {\n    const workspacePath = path.join(rootPath, workspace.replace('/*', ''));\n    if (workspace.indexOf('/*') !== -1) {\n      if (fs.existsSync(workspacePath)) {\n        const folders = fs.readdirSync(workspacePath);\n        folders.forEach((folder: string) => {\n          if (folder !== './' && folder !== '../') {\n            checkUnlessNegated(path.join(workspacePath, folder));\n          }\n        });\n      }\n    } else {\n      checkUnlessNegated(workspacePath);\n    }\n  });\n}\n\nfunction checkPackagePath(rootPath: string, packagePath: string, res: LocalPackage[]) {\n  const packageJsonPath = path.join(packagePath, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) return;\n  const pack = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));\n  if (pack && pack.workspaces) {\n    checkWorkspaces(packagePath, pack.workspaces, res);\n  } else if (pack) {\n    addPackage(packagePath, 'workspace', res, pack);\n  }\n}\n\nfunction addPackage(\n  packagePath: string,\n  source: LocalPackage['source'],\n  res: LocalPackage[],\n  packageJson?: any,\n) {\n  const pack = packageJson ?? getPackageJSON(packagePath);\n  if (!pack || !pack.name) return;\n  res.push({\n    path: packagePath,\n    packageName: pack.name,\n    source,\n    // The one definition, shared with `linked build-package`.\n    isLinkedPackage: isLinkedPackageJson(pack),\n    isApp: pack.linkedApp === true,\n    hasBuildScript: !!pack.scripts?.build,\n  });\n}\n\n/**\n * Filters packages to only include those in the dependency tree of the app root\n */\nfunction filterPackagesByDependencyTree(\n  allPackages: Map<string, PackageDetails>,\n  appRootPath: string,\n): Map<string, PackageDetails> {\n  const appPackageJson = getPackageJSON(appRootPath);\n  if (!appPackageJson) {\n    return allPackages;\n  }\n\n  const relevantPackages = new Map<string, PackageDetails>();\n  const packagesToCheck = new Set<string>();\n\n  // Start with direct dependencies from app root, plus everything localized:\n  // a package created locally is linked but cannot be declared until it is\n  // published (an unpublished range fails `npm install`), and being localized\n  // already says this app is developed against it.\n  [\n    ...Object.keys(appPackageJson.dependencies || {}),\n    ...localizedPackageNames(appRootPath),\n  ].forEach((dep) => {\n    if (allPackages.has(dep)) {\n      packagesToCheck.add(dep);\n    }\n  });\n\n  // Recursively add dependencies\n  const processedPackages = new Set<string>();\n\n  while (packagesToCheck.size > 0) {\n    const packageName = Array.from(packagesToCheck)[0];\n    packagesToCheck.delete(packageName);\n\n    if (processedPackages.has(packageName)) {\n      continue;\n    }\n\n    processedPackages.add(packageName);\n    const packageDetails = allPackages.get(packageName);\n\n    if (packageDetails) {\n      relevantPackages.set(packageName, packageDetails);\n\n      // Get this package's dependencies\n      const packageJson = getPackageJSON(packageDetails.path);\n      if (packageJson && packageJson.dependencies) {\n        Object.keys(packageJson.dependencies).forEach((dep) => {\n          if (allPackages.has(dep) && !processedPackages.has(dep)) {\n            packagesToCheck.add(dep);\n          }\n        });\n      }\n    }\n  }\n\n  return relevantPackages;\n}\n\n/**\n * The package names recorded in the app's `local-packages.json` — what\n * `linked localize` has linked — read with localize's own reader. Read\n * tolerantly: `linked localize` refuses a malformed file (and warns about a\n * malformed entry) loudly, so here a missing or unusable file is simply\n * \"nothing localized\", and a malformed entry is skipped without a word.\n */\nexport function localizedPackageNames(appRootPath: string): string[] {\n  try {\n    return Object.keys(readManifest(appRootPath, {warn: () => {}}).entries);\n  } catch {\n    return [];\n  }\n}\n\n/** A package `build-all` found but will not build, and why not. */\nexport interface SkippedPackage {\n  packageName: string;\n  path: string;\n  reason: string;\n}\n\n/** What `build-all` found, and what it decided to do with each package. */\nexport interface BuildAllPlan {\n  build: Map<string, PackageDetails>;\n  skipped: SkippedPackage[];\n}\n\n/** The package whose `linked` bin the other packages' build scripts run. */\nexport const BUILD_TOOL_PACKAGE = '@_linked/cli';\n\n/** How `build-all` orders the build tool against everything else. */\nexport interface BuildToolOrder {\n  /** The build tool, when it is among the packages to build. */\n  tool?: PackageDetails;\n  /** Whether to build `tool` now, alone, before anything else starts. */\n  buildToolFirst: boolean;\n  /** Everything else, built afterwards in dependency order. */\n  rest: Map<string, PackageDetails>;\n  /** The `--from` to apply to `rest`: cleared once it has been reached at the tool. */\n  from?: string;\n}\n\n/**\n * Take the build tool (`@_linked/cli`) out of the dependency-ordered build.\n *\n * Every other package's `build` script runs `linked build`, which is THIS\n * package's `lib/`. Built in parallel with them, its `rimraf ./lib` pulled that\n * `lib/` out from under their builds (`ENOENT …/lib/esm/installed-packages.js`),\n * and whatever was built before it ran a stale cli. So when it is in the set it\n * is built first and alone, and the rest only once it has succeeded.\n *\n * `--from` reads the tool as the first package in the order: `--from` the tool\n * builds it and then everything; `--from` anything else resumes past it, so it\n * is not rebuilt.\n */\nexport function orderBuildToolFirst(\n  packages: Map<string, PackageDetails>,\n  from?: string,\n): BuildToolOrder {\n  const tool = packages.get(BUILD_TOOL_PACKAGE);\n  if (!tool) return {buildToolFirst: false, rest: packages, from};\n  const rest = new Map(packages);\n  rest.delete(BUILD_TOOL_PACKAGE);\n  if (!from) return {tool, buildToolFirst: true, rest};\n  if (from === BUILD_TOOL_PACKAGE) {\n    return {tool, buildToolFirst: true, rest, from: undefined};\n  }\n  return {tool, buildToolFirst: false, rest, from};\n}\n\n/**\n * Decide what `build-all` builds.\n *\n * Every discovered package lands in exactly one of `build` or `skipped`, and\n * `skipped` carries a reason — because the failure mode this replaces was not\n * a narrow scan, it was a SILENT one. `@_linked/maps` is a shipped Create Now\n * dependency that never got `linkedPackage: true`; `build-all` dropped it and\n * printed nothing, so a build covering half the workspace exited 0 and people\n * acted on it. A skip nobody can see is worse than a failure.\n *\n * What counts as buildable is a CAPABILITY, not a declaration: `build-all`\n * invokes each package's own `build` script, so anything with one can be\n * built whether or not it carries the flag. The flag is still reported when\n * it is missing, since the dev resolver and `linked build` do require it.\n */\nexport function planBuildAll(rootPath = './', appRoot?: string): BuildAllPlan {\n  const build = new Map<string, PackageDetails>();\n  const skipped: SkippedPackage[] = [];\n  const buildable: LocalPackage[] = [];\n\n  for (const pkg of discoverLocalPackages(rootPath)) {\n    const detail = {path: pkg.path, packageName: pkg.packageName};\n    // Packages reached through a `../` workspace glob live outside this\n    // repository; building them was never in scope for `build-all`.\n    if (pkg.path.indexOf('../') !== -1 || pkg.path.indexOf('..\\\\') !== -1) {\n      skipped.push({...detail, reason: 'outside this repository'});\n    } else if (pkg.isApp) {\n      skipped.push({\n        ...detail,\n        reason: 'is a linked app — build it with `linked build-app`',\n      });\n    } else if (!pkg.hasBuildScript) {\n      skipped.push({...detail, reason: 'has no `build` script'});\n    } else {\n      buildable.push(pkg);\n      build.set(pkg.packageName, detail);\n    }\n  }\n\n  // Narrow to what this app actually depends on, if we are inside one.\n  if (appRoot) {\n    const appPackageJson = getPackageJSON(appRoot);\n    const isAppWithLinkedDeps =\n      appPackageJson &&\n      !isLinkedPackageJson(appPackageJson) &&\n      [\n        ...Object.keys(appPackageJson.dependencies || {}),\n        ...localizedPackageNames(appRoot),\n      ].some((dep) => build.has(dep));\n\n    if (isAppWithLinkedDeps) {\n      const inTree = filterPackagesByDependencyTree(build, appRoot);\n      for (const pkg of buildable) {\n        if (inTree.has(pkg.packageName)) continue;\n        build.delete(pkg.packageName);\n        skipped.push({\n          path: pkg.path,\n          packageName: pkg.packageName,\n          reason: `not in ${appPackageJson.name || 'this app'}'s dependency tree`,\n        });\n      }\n    }\n  }\n\n  return {build, skipped};\n}\n\n"]}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["// Lifecycle helpers shared by the Vite-based dev orchestrator.\n//\n// Extracted from cli-methods.ts so the SSR module graph (started from\n// `commands/start.ts`) doesn't have to walk the rest of that file. The\n// the older helpers in cli-methods.ts contain many dynamic\n// `import(<variable>)` calls Vite can't analyze statically and would\n// emit warnings about — even though startWithVite never calls them.\n\nimport fs from 'fs-extra';\nimport path from 'path';\nimport chalk from 'chalk';\nimport {getPackageJSON} from './utils.js';\nimport {isLinkedPackageJson} from './installed-packages.js';\nimport {LOCAL_DIR, localMembers} from './localize/members.js';\nimport {parseWorkspacePatterns, isWorkspacePathNegated} from './workspace-globs.js';\n// Shared with the CSS loader's mode resolution, which must pick the same profiles.\nimport {readEnvNamesFromArgv} from './loader-mode.js';\nimport type {PackageDetails} from './interfaces.js';\nimport {importFile} from './utils/platform.js';\n\n/**\n * Load the app's environment into `process.env`, then re-apply the original\n * shell env so it always wins on conflict. Idempotent — runs at most once.\n *\n * Two sources, tried in this order:\n *   1. `.env` (Node-native `process.loadEnvFile`, no dependency) — a flat file.\n *      This is what the app template ships and the only form that will survive.\n *      `--env` is not consulted here: a flat `.env` has no profiles, so\n *      NODE_ENV comes from the file or the shell.\n *   2. `.env-cmdrc.json` (DEPRECATED, via `env-cmd`) — profile-based; honours\n *      `--env a,b` and merges `_main` + the named profiles. Still read when it\n *      is the only file present, so no existing app breaks, but it warns.\n *\n * `.env` going first is what makes migrating a one-step job: add the flat file\n * and it takes over. The profile file can then be deleted whenever convenient.\n *\n * If neither file exists we skip silently — CN-hosted apps have their env\n * injected into the child process at spawn time, so there's nothing to read\n * from disk.\n */\nexport const ensureEnvironmentLoaded = async (\n  environmentNames?: string[],\n): Promise<void> => {\n  if (process.env.ENV_VARS_LOADED) return;\n  const cwd = process.cwd();\n  const envCmdrcPath = path.join(cwd, '.env-cmdrc.json');\n  const dotEnvPath = path.join(cwd, '.env');\n\n  // Snapshot the original shell env — it should always take priority over\n  // whatever a file sets (so injected/production env wins over dev defaults).\n  const shellEnv = {...process.env};\n\n  const hasDotEnv = fs.existsSync(dotEnvPath);\n  const hasEnvCmdrc = fs.existsSync(envCmdrcPath);\n\n  for (const notice of envDeprecationNotices({hasEnvCmdrc, hasDotEnv})) {\n    console.warn(chalk.yellow(notice));\n  }\n\n  if (hasDotEnv) {\n    // Native flat-file loader (Node 20.12+). Populates process.env from `.env`.\n    process.loadEnvFile(dotEnvPath);\n  } else if (hasEnvCmdrc) {\n    await loadEnvCmdrc(envCmdrcPath, environmentNames);\n  } else {\n    console.warn(\n      'No .env or .env-cmdrc.json found in this folder — relying on the ambient environment.',\n    );\n  }\n\n  // Re-apply shell env so it always wins over file values.\n  process.env = {...process.env, ...shellEnv};\n  process.env.ENV_VARS_LOADED = 'true';\n};\n\n/**\n * What to tell an app about where its environment came from.\n *\n * `.env-cmdrc.json` is still read when it is the only file present, so no app\n * breaks today. But it is the only reason `--env` exists, and both are going\n * away.\n *\n * The case worth shouting about is an app holding both files: `.env` wins, so\n * the profile file and every `--env` name passed with it do nothing. That is\n * the intended migration path, but it is invisible from the outside — values\n * an app still believes it is getting from a profile are simply absent.\n *\n * Pure and exported so the messages can be asserted without a chdir.\n */\nexport const envDeprecationNotices = (sources: {\n  hasEnvCmdrc: boolean;\n  hasDotEnv: boolean;\n}): string[] => {\n  if (!sources.hasEnvCmdrc) return [];\n  const notices = [\n    '.env-cmdrc.json is deprecated and will be removed in a future major release.',\n    '  Move its values into a flat `.env`, and supply anything that differs per ' +\n      'deployment from the environment itself. `--env` goes away with it.',\n  ];\n  if (sources.hasDotEnv) {\n    notices.push(\n      '  This app has BOTH files. `.env` wins, so `.env-cmdrc.json` — and any ' +\n        '`--env` profile named with it — is being ignored entirely. Delete it once ' +\n        'the flat file is complete.',\n    );\n  }\n  return notices;\n};\n\n/**\n * Legacy loader: reads `.env-cmdrc.json`, merges `_main` plus the profile(s)\n * named by `--env a,b` (default `development`). Kept for CN and existing apps\n * until they migrate to a flat `.env`.\n */\nconst loadEnvCmdrc = async (\n  envCmdrcPath: string,\n  environmentNames?: string[],\n): Promise<void> => {\n  // env-cmd ships ESM; literal specifier is fine for Vite's analyzer.\n  const {GetEnvVars} = await import('env-cmd');\n  const vars = await GetEnvVars({envFile: {filePath: envCmdrcPath}});\n  const environments = Object.keys(vars);\n\n  if (environments.includes('_main')) {\n    process.env = {...process.env, ...vars._main};\n  }\n  // Callers that parsed `--env` themselves pass the names in. Commands that\n  // have not been converted yet still have their names scraped off argv.\n  const requested = environmentNames?.length\n    ? environmentNames\n    : readEnvNamesFromArgv();\n  if (requested.length) {\n    requested.forEach((name) => {\n      if (environments.includes(name)) {\n        console.log('Environment: ' + name);\n        process.env = {...process.env, ...vars[name]};\n      } else {\n        console.warn(\n          `Environment ${name} not found in .env-cmdrc.json. Available: ${environments.join(', ')}`,\n        );\n      }\n    });\n  } else {\n    process.env = {...process.env, ...vars.development};\n    console.log('No environment specified, using development');\n  }\n};\n\n/**\n * Discover and load the app's storage-config bootstrap file. Tries the\n * canonical `linked.backend.storage.{ts,js}` first, then legacy paths.\n * Returns whatever the file's default export evaluates to, or undefined\n * if no candidate exists.\n */\nexport async function loadBackendStorageConfig(): Promise<any> {\n  const cwd = process.cwd();\n  const candidates = [\n    path.join(cwd, 'linked.backend.storage.ts'),\n    path.join(cwd, 'linked.backend.storage.js'),\n    path.join(cwd, 'backend-storage-config.ts'),\n    path.join(cwd, 'backend-storage-config.js'),\n    path.join(cwd, 'scripts', 'backend-storage-config.js'),\n    path.join(cwd, 'scripts', 'backend-storage-config.ts'),\n    path.join(cwd, 'scripts', 'storage-config.js'),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) {\n      // Variable specifier is intentional — we discover the path at\n      // runtime by probing the candidate list, so static analysis is\n      // impossible.\n      return importFile(candidate);\n    }\n  }\n  console.warn(\n    chalk.yellow(\n      '[linked.backend.storage] no linked.backend.storage.{ts,js} found at app root.',\n    ),\n  );\n  return undefined;\n}\n\n/**\n * A local package directory found by {@link discoverLocalPackages}, together\n * with the facts that decide what can be done with it.\n *\n * The facts are recorded rather than filtered on, because the bug this type\n * exists to fix was a SILENT filter: `build-all` discovered only packages\n * carrying `linkedPackage: true` and printed nothing about the rest, so\n * `@_linked/maps` — a shipped dependency that simply never got the flag — was\n * dropped from a green build for as long as nobody counted the names.\n */\nexport interface LocalPackage extends PackageDetails {\n  /** Where the walk found it. */\n  source: 'workspace' | 'local-packages-dir';\n  /** `linkedPackage: true` — see `isLinkedPackageJson`. */\n  isLinkedPackage: boolean;\n  /** `linkedApp: true` — built by `linked build-app`, not `linked build`. */\n  isApp: boolean;\n  /** Has a `build` script of its own, which is what `build-all` invokes. */\n  hasBuildScript: boolean;\n}\n\n/**\n * Directory holding localized checkouts (`linked localize`). An app set up by\n * `linked localize` lists `packages-local/*` in its `workspaces`, so a walk of\n * the globs finds them as workspace members; it is still walked on its own for\n * an app that has not been set up yet (no glob, or no `workspaces` at all).\n */\nexport const LOCAL_PACKAGES_DIR = LOCAL_DIR;\n\n/**\n * Walk the app's `package.json` `workspaces` field and return every\n * workspace package that declares `\"linkedPackage\": true`.\n *\n * Lives here (not in cli-methods.ts) so consumers like LinkedServer can\n * import it without dragging the rest of the legacy cli-methods flow into\n * Vite's SSR module graph.\n *\n * Kept deliberately narrow: this is the set the dev resolver and the runtime\n * treat as linked packages. Commands that want every *buildable* local\n * package — flag or no flag, workspace or localized checkout — want\n * {@link discoverLocalPackages} instead.\n */\nexport function getLincdPackages(\n  rootPath = process.cwd(),\n): PackageDetails[] {\n  return discoverLocalPackages(rootPath, {includeLocalPackagesDir: false})\n    .filter((pkg) => pkg.isLinkedPackage)\n    .map(({path: packagePath, packageName}) => ({path: packagePath, packageName}));\n}\n\n/**\n * Every local package directory this app can see, whether or not it declares\n * `linkedPackage: true`.\n *\n * Two sources, because the workspace globs are not the whole picture any more:\n *\n *   1. the `workspaces` field (negations honoured — see ./workspace-globs.js),\n *      which includes `packages-local/*` in an app set up for localizing;\n *   2. `packages-local/`, the localized checkouts, for an app whose globs do\n *      not reach it. A checkout a glob already found is not added twice.\n *\n * Nothing is filtered out here. Callers decide what they can act on and are\n * expected to SAY what they skipped and why.\n */\nexport function discoverLocalPackages(\n  rootPath = process.cwd(),\n  options: {includeLocalPackagesDir?: boolean; localPackagesDir?: string} = {},\n): LocalPackage[] {\n  const {includeLocalPackagesDir = true, localPackagesDir = LOCAL_PACKAGES_DIR} =\n    options;\n\n  let pack = getPackageJSON(rootPath);\n  if (!pack || !pack.workspaces) {\n    const originalRoot = rootPath;\n    for (let i = 0; i <= 3; i++) {\n      rootPath = path.join(originalRoot, ...Array(i).fill('..'));\n      pack = getPackageJSON(rootPath);\n      if (pack && pack.workspaces) break;\n    }\n    if (!pack || !pack.workspaces) {\n      // Standalone apps (scaffolded with `linked create-app`) don't have\n      // workspaces — expected. Fall back to the original root so a\n      // `packages-local/` beside it is still found.\n      rootPath = originalRoot;\n    }\n  }\n\n  const res: LocalPackage[] = [];\n  if (pack && pack.workspaces) {\n    checkWorkspaces(rootPath, pack.workspaces, res);\n  }\n  if (includeLocalPackagesDir) {\n    checkLocalPackagesDir(rootPath, localPackagesDir, res);\n  }\n  return res;\n}\n\n/**\n * Add every immediate subdirectory of `packages-local/` that holds a\n * `package.json`. No glob, no negations: the directory has no `workspaces`\n * entry to interpret, its contents are there because a developer localized\n * them on purpose, and each one is a plain checkout.\n */\nfunction checkLocalPackagesDir(\n  rootPath: string,\n  localPackagesDir: string,\n  res: LocalPackage[],\n) {\n  const dir = path.join(rootPath, localPackagesDir);\n  if (!fs.existsSync(dir)) return;\n  const already = new Set(res.map((pkg) => path.resolve(pkg.path)));\n  for (const entry of fs.readdirSync(dir)) {\n    if (entry.startsWith('.')) continue;\n    const packagePath = path.join(dir, entry);\n    if (!fs.statSync(packagePath).isDirectory()) continue;\n    // A checkout a glob already picked up (`packages-local/*`) must not\n    // appear twice — duplicates would be built twice and counted twice.\n    if (already.has(path.resolve(packagePath))) continue;\n    addPackage(packagePath, 'local-packages-dir', res);\n  }\n}\n\nfunction checkWorkspaces(rootPath: string, workspaces: any, res: LocalPackage[]) {\n  // Negated entries (\"!packages/core\") are excluded the way npm excludes them\n  // — including from the exact-path branch below, which npm also subjects to\n  // them. See ./workspace-globs.js.\n  const {patterns, negatedPatterns} = parseWorkspacePatterns(workspaces);\n  const checkUnlessNegated = (packagePath: string) => {\n    const rel = path.relative(rootPath, packagePath).split(path.sep).join('/');\n    if (isWorkspacePathNegated(rel, negatedPatterns)) return;\n    checkPackagePath(rootPath, packagePath, res);\n  };\n  patterns.forEach((workspace: string) => {\n    const workspacePath = path.join(rootPath, workspace.replace('/*', ''));\n    if (workspace.indexOf('/*') !== -1) {\n      if (fs.existsSync(workspacePath)) {\n        const folders = fs.readdirSync(workspacePath);\n        folders.forEach((folder: string) => {\n          if (folder !== './' && folder !== '../') {\n            checkUnlessNegated(path.join(workspacePath, folder));\n          }\n        });\n      }\n    } else {\n      checkUnlessNegated(workspacePath);\n    }\n  });\n}\n\nfunction checkPackagePath(rootPath: string, packagePath: string, res: LocalPackage[]) {\n  const packageJsonPath = path.join(packagePath, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) return;\n  const pack = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));\n  if (pack && pack.workspaces) {\n    checkWorkspaces(packagePath, pack.workspaces, res);\n  } else if (pack) {\n    addPackage(packagePath, 'workspace', res, pack);\n  }\n}\n\nfunction addPackage(\n  packagePath: string,\n  source: LocalPackage['source'],\n  res: LocalPackage[],\n  packageJson?: any,\n) {\n  const pack = packageJson ?? getPackageJSON(packagePath);\n  if (!pack || !pack.name) return;\n  res.push({\n    path: packagePath,\n    packageName: pack.name,\n    source,\n    // The one definition, shared with `linked build-package`.\n    isLinkedPackage: isLinkedPackageJson(pack),\n    isApp: pack.linkedApp === true,\n    hasBuildScript: !!pack.scripts?.build,\n  });\n}\n\n/**\n * Filters packages to only include those in the dependency tree of the app root\n */\nfunction filterPackagesByDependencyTree(\n  allPackages: Map<string, PackageDetails>,\n  appRootPath: string,\n): Map<string, PackageDetails> {\n  const appPackageJson = getPackageJSON(appRootPath);\n  if (!appPackageJson) {\n    return allPackages;\n  }\n\n  const relevantPackages = new Map<string, PackageDetails>();\n  const packagesToCheck = new Set<string>();\n\n  // Start with direct dependencies from app root, plus everything localized:\n  // a package created locally is linked but cannot be declared until it is\n  // published (an unpublished range fails `npm install`), and being localized\n  // already says this app is developed against it.\n  [\n    ...Object.keys(appPackageJson.dependencies || {}),\n    ...localizedPackageNames(appRootPath),\n  ].forEach((dep) => {\n    if (allPackages.has(dep)) {\n      packagesToCheck.add(dep);\n    }\n  });\n\n  // Recursively add dependencies\n  const processedPackages = new Set<string>();\n\n  while (packagesToCheck.size > 0) {\n    const packageName = Array.from(packagesToCheck)[0];\n    packagesToCheck.delete(packageName);\n\n    if (processedPackages.has(packageName)) {\n      continue;\n    }\n\n    processedPackages.add(packageName);\n    const packageDetails = allPackages.get(packageName);\n\n    if (packageDetails) {\n      relevantPackages.set(packageName, packageDetails);\n\n      // Get this package's dependencies\n      const packageJson = getPackageJSON(packageDetails.path);\n      if (packageJson && packageJson.dependencies) {\n        Object.keys(packageJson.dependencies).forEach((dep) => {\n          if (allPackages.has(dep) && !processedPackages.has(dep)) {\n            packagesToCheck.add(dep);\n          }\n        });\n      }\n    }\n  }\n\n  return relevantPackages;\n}\n\n/**\n * The names of the app's localized checkouts — every directory in\n * `packages-local/` with a named `package.json` (localize/members.ts). Nothing\n * there is simply \"nothing localized\".\n */\nexport function localizedPackageNames(appRootPath: string): string[] {\n  return localMembers(appRootPath).map((member) => member.name);\n}\n\n/** A package `build-all` found but will not build, and why not. */\nexport interface SkippedPackage {\n  packageName: string;\n  path: string;\n  reason: string;\n}\n\n/** What `build-all` found, and what it decided to do with each package. */\nexport interface BuildAllPlan {\n  build: Map<string, PackageDetails>;\n  skipped: SkippedPackage[];\n}\n\n/** The package whose `linked` bin the other packages' build scripts run. */\nexport const BUILD_TOOL_PACKAGE = '@_linked/cli';\n\n/** Where `build-all` starts: everything in the groups before it is passed over. */\nexport type BuildToolStart = 'pre' | 'tool' | 'rest';\n\n/** How `build-all` orders the build tool against everything else. */\nexport interface BuildToolOrder {\n  /**\n   * What the build tool depends on, transitively, among the packages to build\n   * (a localized `@_linked/core`), in dependency order. Built before it.\n   */\n  pre: Map<string, PackageDetails>;\n  /** The build tool, when it is among the packages to build. */\n  tool?: PackageDetails;\n  /** Everything else, built afterwards in dependency order. */\n  rest: Map<string, PackageDetails>;\n  /** The first group to build; the groups before it are passed over (`--from`). */\n  start: BuildToolStart;\n  /** The `--from` to apply inside `start` (`pre` or `rest`); unset when the build starts at its top. */\n  from?: string;\n}\n\n/** The package names a package's `dependencies` field lists. */\nfunction declaredDependencies(pkg: PackageDetails): string[] {\n  return Object.keys(getPackageJSON(pkg.path, false)?.dependencies || {});\n}\n\n/**\n * Split the build around the build tool (`@_linked/cli`).\n *\n * Every other package's `build` script runs `linked build`, which is THIS\n * package's `lib/`. Built in parallel with them, its `rimraf ./lib` pulled that\n * `lib/` out from under their builds (`ENOENT …/lib/esm/installed-packages.js`),\n * and whatever was built before it ran a stale cli. So when it is in the set it\n * is built alone, and the rest only once it has succeeded.\n *\n * It cannot be built FIRST, though: a localized `@_linked/core` it depends on\n * must have its `lib/` before the tool's `tsc` runs. So the tool's own\n * dependencies among the packages to build (`pre`, the transitive closure of\n * `dependencies`) go before it, in dependency order. They build with the tool\n * as it was before this run, which is what a fresh checkout's `npm run build`\n * does too.\n *\n * `--from` reads the order as `pre`, then the tool, then `rest`: it resumes\n * inside whichever group holds the package and passes over the groups before\n * it. A name in none of them goes to `rest`, which reports it.\n */\nexport function orderBuildToolFirst(\n  packages: Map<string, PackageDetails>,\n  from?: string,\n  dependenciesOf: (pkg: PackageDetails) => string[] = declaredDependencies,\n): BuildToolOrder {\n  const tool = packages.get(BUILD_TOOL_PACKAGE);\n  if (!tool) {\n    return {pre: new Map(), rest: packages, start: from ? 'rest' : 'pre', from};\n  }\n\n  // Depth-first, dependencies before dependents, so `pre` is in build order.\n  // A cycle back to the tool (or within `pre`) is cut where it closes.\n  const pre = new Map<string, PackageDetails>();\n  const visiting = new Set<string>([BUILD_TOOL_PACKAGE]);\n  const visit = (pkg: PackageDetails) => {\n    for (const dep of dependenciesOf(pkg)) {\n      const depPkg = packages.get(dep);\n      if (!depPkg || visiting.has(dep) || pre.has(dep)) continue;\n      visiting.add(dep);\n      visit(depPkg);\n      pre.set(dep, depPkg);\n    }\n  };\n  visit(tool);\n\n  const rest = new Map(packages);\n  rest.delete(BUILD_TOOL_PACKAGE);\n  for (const name of pre.keys()) rest.delete(name);\n\n  if (!from) return {pre, tool, rest, start: 'pre'};\n  if (pre.has(from)) return {pre, tool, rest, start: 'pre', from};\n  if (from === BUILD_TOOL_PACKAGE) return {pre, tool, rest, start: 'tool'};\n  return {pre, tool, rest, start: 'rest', from};\n}\n\n/**\n * Decide what `build-all` builds.\n *\n * Every discovered package lands in exactly one of `build` or `skipped`, and\n * `skipped` carries a reason — because the failure mode this replaces was not\n * a narrow scan, it was a SILENT one. `@_linked/maps` is a shipped Create Now\n * dependency that never got `linkedPackage: true`; `build-all` dropped it and\n * printed nothing, so a build covering half the workspace exited 0 and people\n * acted on it. A skip nobody can see is worse than a failure.\n *\n * What counts as buildable is a CAPABILITY, not a declaration: `build-all`\n * invokes each package's own `build` script, so anything with one can be\n * built whether or not it carries the flag. The flag is still reported when\n * it is missing, since the dev resolver and `linked build` do require it.\n */\nexport function planBuildAll(rootPath = './', appRoot?: string): BuildAllPlan {\n  const build = new Map<string, PackageDetails>();\n  const skipped: SkippedPackage[] = [];\n  const buildable: LocalPackage[] = [];\n\n  for (const pkg of discoverLocalPackages(rootPath)) {\n    const detail = {path: pkg.path, packageName: pkg.packageName};\n    // Packages reached through a `../` workspace glob live outside this\n    // repository; building them was never in scope for `build-all`.\n    if (pkg.path.indexOf('../') !== -1 || pkg.path.indexOf('..\\\\') !== -1) {\n      skipped.push({...detail, reason: 'outside this repository'});\n    } else if (pkg.isApp) {\n      skipped.push({\n        ...detail,\n        reason: 'is a linked app — build it with `linked build-app`',\n      });\n    } else if (!pkg.hasBuildScript) {\n      skipped.push({...detail, reason: 'has no `build` script'});\n    } else {\n      buildable.push(pkg);\n      build.set(pkg.packageName, detail);\n    }\n  }\n\n  // Narrow to what this app actually depends on, if we are inside one.\n  if (appRoot) {\n    const appPackageJson = getPackageJSON(appRoot);\n    const isAppWithLinkedDeps =\n      appPackageJson &&\n      !isLinkedPackageJson(appPackageJson) &&\n      [\n        ...Object.keys(appPackageJson.dependencies || {}),\n        ...localizedPackageNames(appRoot),\n      ].some((dep) => build.has(dep));\n\n    if (isAppWithLinkedDeps) {\n      const inTree = filterPackagesByDependencyTree(build, appRoot);\n      for (const pkg of buildable) {\n        if (inTree.has(pkg.packageName)) continue;\n        build.delete(pkg.packageName);\n        skipped.push({\n          path: pkg.path,\n          packageName: pkg.packageName,\n          reason: `not in ${appPackageJson.name || 'this app'}'s dependency tree`,\n        });\n      }\n    }\n  }\n\n  return {build, skipped};\n}\n\n"]}

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

@@ -1,10 +1,10 @@
 import type { LocalizeOptions } from './localize.js';
 import type { Deps } from './run.js';
 /**
- * @param {string[]} names  full npm package names
- * @param {object} opts  `{dir, repo, build, force}`
- * @param {object} deps  `{appRoot, run, log, warn, error}`
- * @returns {number} the process exit code, as `localize` returns it.
+ * @param names  full npm package names
+ * @returns the process exit code, as `localize` returns it.
  */
-export declare function adopt(names: string[], opts: Omit<LocalizeOptions, 'subdir'>, deps: Deps): number;
+export declare function adopt(names: string[], opts: Pick<LocalizeOptions, 'dir' | 'build'>, deps: Deps): number;
+/** Move every parked checkout back, then one install. No builds: each is as it was. */
+export declare function localizeParked(opts: Pick<LocalizeOptions, 'dir'>, deps: Deps): number;
 //# sourceMappingURL=adopt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../../src/localize/adopt.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAC,eAAe,EAAY,MAAM,eAAe,CAAC;AAG9D,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,UAAU,CAAC;AAGnC;;;;;GAKG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,EACrC,IAAI,EAAE,IAAI,GACT,MAAM,CAWR"}
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../../src/localize/adopt.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAC,eAAe,EAAW,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,UAAU,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,OAAO,CAAC,EAC5C,IAAI,EAAE,IAAI,GACT,MAAM,CAER;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EAClC,IAAI,EAAE,IAAI,GACT,MAAM,CAUR"}

package/lib/esm/localize/adopt.js

@@ -1,76 +1,67 @@
 /**
- * `adopt` -- localize a checkout that is ALREADY in the checkout directory,
- * without asking the registry or a remote anything.
+ * `--adopt` and `--parked` -- the localize run for checkouts that need no
+ * clone.
  *
- * `localize` gets its checkout by resolving the published `repository` and
- * cloning it. That cannot work for two kinds of checkout that nonetheless
- * belong in `<dir>`:
+ * `adopt` takes a checkout that is ALREADY in `packages-local/` -- a package
+ * created locally and never published (`create-package --location
+ * packages-local`), or a clone put there by hand -- and runs the rest of
+ * localize on it: app setup, git hooks, the root `npm install`, its build. No
+ * registry lookup, no clone, no pull. It is found by its name among the
+ * members, else at `packages-local/<checkoutName>`, so `localize` and `adopt`
+ * agree about where a package lives.
  *
- * - a package created locally and never published, which may not even have a
- *   remote yet;
- * - a clone that was put there by hand.
- *
- * `adopt` takes the checkout as it finds it -- no clone, no pull, no fetch --
- * and runs the same tail as `localize`: install inside it, build, symlink,
- * record. The checkout has to be a git checkout at `<dir>/<checkoutName>`, so
- * that `localize` and `adopt` can never disagree about where a package lives.
- *
- * The recorded `repo` is `--repo` when given, else the checkout's `origin`,
- * else what an earlier run recorded, else absent. Absent is fine: `relink`,
- * `--list` and `remove` never need it.
+ * `localizeParked` takes back every checkout `linked delocalize` parked.
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import { EXIT_REFUSED, LocalizeError } from './errors.js';
-import { forEachName, guardForeignLink, installLinkAndRecord, reportError, } from './localize.js';
-import { checkoutNameFor, normalizeGitUrl } from './resolve.js';
-import { isGitCheckout, readJson } from './fsops.js';
+import { checkoutRepoRoot, readJson } from './fsops.js';
+import { runLocalize, unpark } from './localize.js';
+import { LOCAL_DIR, localMembers, parkedMembers } from './members.js';
+import { checkoutNameFor } from './resolve.js';
 /**
- * @param {string[]} names  full npm package names
- * @param {object} opts  `{dir, repo, build, force}`
- * @param {object} deps  `{appRoot, run, log, warn, error}`
- * @returns {number} the process exit code, as `localize` returns it.
+ * @param names  full npm package names
+ * @returns the process exit code, as `localize` returns it.
  */
 export function adopt(names, opts, deps) {
-    if (opts.repo && names.length > 1) {
-        return reportError(new LocalizeError(`--repo names one repository, so it can only be used when adopting one package.`, EXIT_REFUSED), deps);
+    return runLocalize(names, opts, deps, prepareAdopt);
+}
+/** Move every parked checkout back, then one install. No builds: each is as it was. */
+export function localizeParked(opts, deps) {
+    const names = parkedMembers(deps.appRoot).map((m) => m.name);
+    if (!names.length) {
+        deps.log('[localize] nothing is parked.');
+        return 0;
     }
-    return forEachName(names, opts, deps, adoptOne);
+    return runLocalize(names, opts, deps, (name) => {
+        const parked = parkedMembers(deps.appRoot).find((m) => m.name === name);
+        return parked ? unpark(parked, deps) : null;
+    });
 }
-function adoptOne(name, dir, recorded, opts, deps) {
+function prepareAdopt(name, _opts, deps) {
     var _a, _b;
-    const relPkg = path.join(dir, checkoutNameFor(name));
-    const pkgDir = path.join(deps.appRoot, relPkg);
+    const member = localMembers(deps.appRoot).find((m) => m.name === name);
+    const relDir = (_a = member === null || member === void 0 ? void 0 : member.dir) !== null && _a !== void 0 ? _a : `${LOCAL_DIR}/${checkoutNameFor(name)}`;
+    const pkgDir = path.join(deps.appRoot, relDir);
     if (!fs.existsSync(pkgDir)) {
-        throw new LocalizeError(`there is nothing to adopt at ${relPkg}.\n` +
-            `adopt links a checkout that is already there. To clone a published package instead:\n` +
-            `  linked localize ${name}`, EXIT_REFUSED);
+        const parked = parkedMembers(deps.appRoot).some((m) => m.name === name);
+        throw new LocalizeError(`there is nothing to adopt at ${relDir}.\n` +
+            (parked
+                ? `${name} is parked. To take it back:\n  linked localize ${name}`
+                : `adopt installs a checkout that is already there. To clone a published package instead:\n` +
+                    `  linked localize ${name}`), EXIT_REFUSED);
     }
-    if (!isGitCheckout(pkgDir)) {
-        throw new LocalizeError(`${relPkg} is not a git checkout. Run \`git init\` in it first -- localize tracks a ` +
-            `checkout's branch, and a checkout without history has none.`, EXIT_REFUSED);
+    if (!checkoutRepoRoot(pkgDir, deps.appRoot)) {
+        throw new LocalizeError(`${relDir} is not a git checkout. Run \`git init\` in it first -- a checkout in ` +
+            `${LOCAL_DIR}/ is its own repository, never part of the app's.`, EXIT_REFUSED);
     }
-    const declared = (_a = readJson(path.join(pkgDir, 'package.json'))) === null || _a === void 0 ? void 0 : _a.name;
+    const declared = (_b = readJson(path.join(pkgDir, 'package.json'))) === null || _b === void 0 ? void 0 : _b.name;
     if (declared !== name) {
         throw new LocalizeError(declared
-            ? `${relPkg} declares itself as "${declared}", not "${name}".`
-            : `${relPkg} has no package.json naming it, so it is not the package "${name}".`, EXIT_REFUSED);
+            ? `${relDir} declares itself as "${declared}", not "${name}".`
+            : `${relDir} has no package.json naming it, so it is not the package "${name}".`, EXIT_REFUSED);
     }
-    if (recorded === null || recorded === void 0 ? void 0 : recorded.subdir) {
-        deps.warn(`[localize] ${name} was recorded inside a monorepo (${recorded.path}); adopt replaces that ` +
-            `with ${relPkg}.`);
-    }
-    guardForeignLink(name, dir, opts, deps);
-    const repo = opts.repo
-        ? normalizeGitUrl(opts.repo)
-        : ((_b = originOf(pkgDir, deps)) !== null && _b !== void 0 ? _b : recorded === null || recorded === void 0 ? void 0 : recorded.repo);
-    deps.log(`[localize] adopting ${relPkg}${repo ? ` (${repo})` : ' (no remote)'}`);
-    return installLinkAndRecord({ npmName: name, clone: pkgDir, relPkg, pkgDir, repo }, opts, deps);
-}
-/** The checkout's `origin` URL, or undefined when it has none. Read, never fetched. */
-function originOf(pkgDir, deps) {
-    const r = deps.run('git', ['remote', 'get-url', 'origin'], { cwd: pkgDir });
-    const url = r.stdout.trim();
-    return r.status === 0 && url ? normalizeGitUrl(url) : undefined;
+    deps.log(`[localize] adopting ${relDir}`);
+    return { name, dir: relDir, build: true };
 }
 //# sourceMappingURL=adopt.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../../src/localize/adopt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `adopt` -- localize a checkout that is ALREADY in the checkout directory,\n * without asking the registry or a remote anything.\n *\n * `localize` gets its checkout by resolving the published `repository` and\n * cloning it. That cannot work for two kinds of checkout that nonetheless\n * belong in `<dir>`:\n *\n * - a package created locally and never published, which may not even have a\n *   remote yet;\n * - a clone that was put there by hand.\n *\n * `adopt` takes the checkout as it finds it -- no clone, no pull, no fetch --\n * and runs the same tail as `localize`: install inside it, build, symlink,\n * record. The checkout has to be a git checkout at `<dir>/<checkoutName>`, so\n * that `localize` and `adopt` can never disagree about where a package lives.\n *\n * The recorded `repo` is `--repo` when given, else the checkout's `origin`,\n * else what an earlier run recorded, else absent. Absent is fine: `relink`,\n * `--list` and `remove` never need it.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {EXIT_REFUSED, LocalizeError} from './errors.js';\nimport {\n  forEachName,\n  guardForeignLink,\n  installLinkAndRecord,\n  reportError,\n} from './localize.js';\nimport type {LocalizeOptions, OneResult} from './localize.js';\nimport type {ManifestEntry} from './manifest.js';\nimport {checkoutNameFor, normalizeGitUrl} from './resolve.js';\nimport type {Deps} from './run.js';\nimport {isGitCheckout, readJson} from './fsops.js';\n\n/**\n * @param {string[]} names  full npm package names\n * @param {object} opts  `{dir, repo, build, force}`\n * @param {object} deps  `{appRoot, run, log, warn, error}`\n * @returns {number} the process exit code, as `localize` returns it.\n */\nexport function adopt(\n  names: string[],\n  opts: Omit<LocalizeOptions, 'subdir'>,\n  deps: Deps,\n): number {\n  if (opts.repo && names.length > 1) {\n    return reportError(\n      new LocalizeError(\n        `--repo names one repository, so it can only be used when adopting one package.`,\n        EXIT_REFUSED,\n      ),\n      deps,\n    );\n  }\n  return forEachName(names, opts, deps, adoptOne);\n}\n\nfunction adoptOne(\n  name: string,\n  dir: string,\n  recorded: ManifestEntry | undefined,\n  opts: LocalizeOptions,\n  deps: Deps,\n): OneResult {\n  const relPkg = path.join(dir, checkoutNameFor(name));\n  const pkgDir = path.join(deps.appRoot, relPkg);\n\n  if (!fs.existsSync(pkgDir)) {\n    throw new LocalizeError(\n      `there is nothing to adopt at ${relPkg}.\\n` +\n        `adopt links a checkout that is already there. To clone a published package instead:\\n` +\n        `  linked localize ${name}`,\n      EXIT_REFUSED,\n    );\n  }\n  if (!isGitCheckout(pkgDir)) {\n    throw new LocalizeError(\n      `${relPkg} is not a git checkout. Run \\`git init\\` in it first -- localize tracks a ` +\n        `checkout's branch, and a checkout without history has none.`,\n      EXIT_REFUSED,\n    );\n  }\n\n  const declared = readJson(path.join(pkgDir, 'package.json'))?.name;\n  if (declared !== name) {\n    throw new LocalizeError(\n      declared\n        ? `${relPkg} declares itself as \"${declared}\", not \"${name}\".`\n        : `${relPkg} has no package.json naming it, so it is not the package \"${name}\".`,\n      EXIT_REFUSED,\n    );\n  }\n\n  if (recorded?.subdir) {\n    deps.warn(\n      `[localize] ${name} was recorded inside a monorepo (${recorded.path}); adopt replaces that ` +\n        `with ${relPkg}.`,\n    );\n  }\n\n  guardForeignLink(name, dir, opts, deps);\n\n  const repo = opts.repo\n    ? normalizeGitUrl(opts.repo)\n    : (originOf(pkgDir, deps) ?? recorded?.repo);\n  deps.log(\n    `[localize] adopting ${relPkg}${repo ? ` (${repo})` : ' (no remote)'}`,\n  );\n\n  return installLinkAndRecord(\n    {npmName: name, clone: pkgDir, relPkg, pkgDir, repo},\n    opts,\n    deps,\n  );\n}\n\n/** The checkout's `origin` URL, or undefined when it has none. Read, never fetched. */\nfunction originOf(pkgDir, deps) {\n  const r = deps.run('git', ['remote', 'get-url', 'origin'], {cwd: pkgDir});\n  const url = r.stdout.trim();\n  return r.status === 0 && url ? normalizeGitUrl(url) : undefined;\n}\n"]}
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../../src/localize/adopt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `--adopt` and `--parked` -- the localize run for checkouts that need no\n * clone.\n *\n * `adopt` takes a checkout that is ALREADY in `packages-local/` -- a package\n * created locally and never published (`create-package --location\n * packages-local`), or a clone put there by hand -- and runs the rest of\n * localize on it: app setup, git hooks, the root `npm install`, its build. No\n * registry lookup, no clone, no pull. It is found by its name among the\n * members, else at `packages-local/<checkoutName>`, so `localize` and `adopt`\n * agree about where a package lives.\n *\n * `localizeParked` takes back every checkout `linked delocalize` parked.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {EXIT_REFUSED, LocalizeError} from './errors.js';\nimport {checkoutRepoRoot, readJson} from './fsops.js';\nimport {runLocalize, unpark} from './localize.js';\nimport type {LocalizeOptions, Prepared} from './localize.js';\nimport {LOCAL_DIR, localMembers, parkedMembers} from './members.js';\nimport {checkoutNameFor} from './resolve.js';\nimport type {Deps} from './run.js';\n\n/**\n * @param names  full npm package names\n * @returns the process exit code, as `localize` returns it.\n */\nexport function adopt(\n  names: string[],\n  opts: Pick<LocalizeOptions, 'dir' | 'build'>,\n  deps: Deps,\n): number {\n  return runLocalize(names, opts, deps, prepareAdopt);\n}\n\n/** Move every parked checkout back, then one install. No builds: each is as it was. */\nexport function localizeParked(\n  opts: Pick<LocalizeOptions, 'dir'>,\n  deps: Deps,\n): number {\n  const names = parkedMembers(deps.appRoot).map((m) => m.name);\n  if (!names.length) {\n    deps.log('[localize] nothing is parked.');\n    return 0;\n  }\n  return runLocalize(names, opts, deps, (name) => {\n    const parked = parkedMembers(deps.appRoot).find((m) => m.name === name);\n    return parked ? unpark(parked, deps) : null;\n  });\n}\n\nfunction prepareAdopt(\n  name: string,\n  _opts: LocalizeOptions,\n  deps: Deps,\n): Prepared {\n  const member = localMembers(deps.appRoot).find((m) => m.name === name);\n  const relDir = member?.dir ?? `${LOCAL_DIR}/${checkoutNameFor(name)}`;\n  const pkgDir = path.join(deps.appRoot, relDir);\n\n  if (!fs.existsSync(pkgDir)) {\n    const parked = parkedMembers(deps.appRoot).some((m) => m.name === name);\n    throw new LocalizeError(\n      `there is nothing to adopt at ${relDir}.\\n` +\n        (parked\n          ? `${name} is parked. To take it back:\\n  linked localize ${name}`\n          : `adopt installs a checkout that is already there. To clone a published package instead:\\n` +\n            `  linked localize ${name}`),\n      EXIT_REFUSED,\n    );\n  }\n  if (!checkoutRepoRoot(pkgDir, deps.appRoot)) {\n    throw new LocalizeError(\n      `${relDir} is not a git checkout. Run \\`git init\\` in it first -- a checkout in ` +\n        `${LOCAL_DIR}/ is its own repository, never part of the app's.`,\n      EXIT_REFUSED,\n    );\n  }\n\n  const declared = readJson(path.join(pkgDir, 'package.json'))?.name;\n  if (declared !== name) {\n    throw new LocalizeError(\n      declared\n        ? `${relDir} declares itself as \"${declared}\", not \"${name}\".`\n        : `${relDir} has no package.json naming it, so it is not the package \"${name}\".`,\n      EXIT_REFUSED,\n    );\n  }\n\n  deps.log(`[localize] adopting ${relDir}`);\n  return {name, dir: relDir, build: true};\n}\n"]}

package/lib/esm/localize/app-root.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The workspace root for `start`: the nearest ancestor (or `start` itself)
+ * whose `package.json` has `workspaces`, then each higher ancestor with
+ * `workspaces` whose globs match the root found so far -- the first one that
+ * does not ends the climb. Of that chain, the topmost that is not itself a
+ * linked package (`"linkedPackage": true`), else the topmost. Null when there
+ * is none.
+ */
+export declare function findWorkspaceRoot(start: string): string | null;
+/**
+ * The app root for a command run in `start`: the workspace root above it, or
+ * `start` itself for an app that has no `workspaces` yet (localize's set-up
+ * adds them).
+ */
+export declare function findAppRoot(start: string): string;
+//# sourceMappingURL=app-root.d.ts.map

package/lib/esm/localize/app-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-root.d.ts","sourceRoot":"","sources":["../../../src/localize/app-root.ts"],"names":[],"mappings":"AAkDA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB9D;AA0BD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}