@_linked/cli 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # Changelog
 
+## 1.16.0
+
+### Minor Changes
+
+- [#93](https://github.com/linked-fw/cli/pull/93) [`4b944dc`](https://github.com/linked-fw/cli/commit/4b944dc5a0a37b7858cb8f34d078879965f8b648) Thanks [@flyon](https://github.com/flyon)! - `create-app` now scaffolds web apps with npm.
+
+  The web template used to install with yarn (and prompted for a package manager
+  when both were on PATH); it now always runs `npm install`, matching the
+  react-native template, and the next-steps message prints `npm start`. The empty
+  `yarn.lock` that create-app wrote to pin down Yarn's project-root search is no
+  longer created, so a new app has a single npm lockfile.
+
+  create-app also strips every yarn project file from the clone (the legacy
+  `yarnrc.yml.template` it used to rename into `.yarnrc.yml`, plus `.yarnrc.yml`,
+  `.yarn/` and any `yarn.lock` the template still carries), so a scaffolded app is
+  an npm project end to end.
+
+## 1.15.3
+
+### Patch Changes
+
+- [#73](https://github.com/linked-cm/cli/pull/73) [`92e8f6b`](https://github.com/linked-cm/cli/commit/92e8f6ba07b80f3a72adae9238bd855fc94869b6) Thanks [@abdipramana](https://github.com/abdipramana)! - `linked start --vite`: widen development config discovery so apps that predate
+  the current filenames still start.
+
+  - The app's linked config is now looked up as `linked.config.js` **or** the
+    legacy `lincd.config.js` (current name wins when both exist). Apps that never
+    renamed the file silently lost their whole `server` block — `cachePaths`,
+    `apiOnly` and the rest of LinkedServer's options — because only the new name
+    was read. The lookup is exposed as `resolveLinkedConfigPath()`.
+  - SSR page discovery also skips `*.d.ts` files in `src/pages/` (alongside the
+    existing `.test` / `.spec` skip). Type declarations have no runtime module,
+    so preloading them into the SSR graph only produced errors.
+  - The backend storage config is discovered under several legacy filenames
+    (`backend-storage-config.*`, `scripts/backend-storage-config.*`,
+    `scripts/storage-config.js`) in addition to `linked.backend.storage.*`.
+
+## 1.15.2
+
+### Patch Changes
+
+- [#71](https://github.com/linked-cm/cli/pull/71) [`b3e482b`](https://github.com/linked-cm/cli/commit/b3e482bdd55a43fb5fe9a11ab58d06e6bea66f5d) Thanks [@carlenmy](https://github.com/carlenmy)! - `createViteConfig`: give each app a unique HMR websocket port, derived from its
+  dev port (`PORT` env override, else `opts.port`), instead of Vite's shared
+  default `24678`.
+
+  Every app built on `createViteConfig` defaulted to `24678` for HMR, so running
+  two of them at once (parallel worktrees / multiple `@_linked` apps on one
+  machine) collided — `WebSocket server error: Port 24678 is already in use`, and
+  HMR silently broke for the loser. The port is now `24678 + (devPort - 4040)`, so
+  apps that already use distinct dev ports get distinct HMR ports for free.
+
+  The derivation lives in the new exported `hmrPortFor()` helper and is defensive
+  about its input: a `PORT` that is not a whole port number (`PORT=abc`, a
+  negative or out-of-range value) falls back to the `4040` default rather than
+  producing `NaN`, and the derived port is clamped into `1024`–`65535`. Apps can
+  still override via `server.hmr` in their own merged config.
+
+## 1.15.1
+
+### Patch Changes
+
+- [#72](https://github.com/linked-cm/cli/pull/72) [`3bab3ab`](https://github.com/linked-cm/cli/commit/3bab3ab287ad72dff74c21f15d93a6229702b0e6) Thanks [@flyon](https://github.com/flyon)! - Backend provider HMR reloads are now debounced and serialised.
+
+  `vite.watcher.on('change')` called `server.onSourceChange(pkg)` once per changed
+  file with no debounce and no queue. Since `onSourceChange` disposes a package's
+  providers and re-registers their Express routes, it mutates the shared router
+  stack — and a multi-file save, a format-on-save, or a branch switch ran several
+  of those dispose/re-register cycles concurrently against that same stack with
+  nothing ordering them.
+
+  Changed packages are now collected over a 150 ms window and their reload cycles
+  run one at a time on a promise chain. Reload failures are still logged per
+  package and no longer abort the cycles queued behind them.
+
+  No API change; dev-server behaviour only.
+
 ## 1.15.0
 
 ### Minor Changes

package/README.md

@@ -145,7 +145,7 @@ Templates live in `defaults/`:
 
 ### `linked create-app` template structure
 
-`linked create-app <name>` copies `defaults/app-with-backend/` to the new app's folder, substitutes `${name}` / `${hyphen_name}` / `${app_prefix}` / `${app_domain}` placeholders in selected files, and copies `linked.backend.datasets.example.json` → `linked.backend.datasets.json` so first boot works zero-config.
+`linked create-app <name>` copies `defaults/app-with-backend/` to the new app's folder, substitutes `${name}` / `${hyphen_name}` / `${app_prefix}` / `${app_domain}` placeholders in selected files, and copies `linked.backend.datasets.example.json` → `linked.backend.datasets.json` so first boot works zero-config. Dependencies are installed with `npm install`, and the next-steps message tells you to run `npm start`.
 
 Storage configuration follows the two-layer pattern from [backlog 016](https://github.com/c### `linked create-app --template react-native`
 

package/defaults/app-react-native/README.md

@@ -1,6 +1,6 @@
 # Linked React Native monorepo
 
-An npm-workspaces monorepo for a [Linked](https://github.com/linked-cm) app on Expo SDK 57 / React Native 0.86 /
+An npm-workspaces monorepo for a [Linked](https://github.com/linked-fw) app on Expo SDK 57 / React Native 0.86 /
 React 19.2, with an API-only Linked backend on Fuseki.
 
 ```

package/defaults/app-react-native/apps/mobile/src/components/PersonOverview.tsx

@@ -2,7 +2,7 @@
 // linkedSetComponent for the list (auto-runs the query, injects results and
 // an injected _refresh); linkedComponent for each row (see PersonPreview).
 // After Person.create the form calls _refresh() to re-run the list query.
-// A React Native port of the web app-template's example (linked-cm/app-template).
+// A React Native port of the web app-template's example (linked-fw/app-template).
 //
 // `linkedSetComponent` checks LinkedStorage when this module loads, so storage is imported first.
 // Replace or extend this with your own shapes (see https://linked.cm).

package/defaults/app-react-native/apps/mobile/src/components/PersonPreview.tsx

@@ -3,7 +3,7 @@
 // result keys + `source` + `_refresh` into the render function. _refresh
 // patches local query state for optimistic UI; on delete, the parent
 // list re-runs via the PersonListRefresh context.
-// A React Native port of the web app-template's example (linked-cm/app-template).
+// A React Native port of the web app-template's example (linked-fw/app-template).
 // Storage is imported first, so the row's queries go to the API store however this module is reached.
 import '../shell/storage';
 

package/lib/esm/cli-methods.d.ts

@@ -52,6 +52,24 @@ export declare function scaffoldReactNativeApp(targetFolder: string, id: AppIden
 export declare const reactNativeInternals: {
     scaffoldReactNativeApp: typeof scaffoldReactNativeApp;
 };
+/**
+ * Stamp the new app's identity into the freshly-cloned template. The template
+ * ships without `${var}` placeholders (so a raw CN clone boots on defaults), so
+ * create-app writes the real per-app values here:
+ *  - `.env.example` (committed defaults for this app) + `.env` (local): APP_NAME
+ *    drives the display name; APP_PREFIX names data files.
+ *  - `package.json`: `name` (hyphenated id) + `displayName` (human name).
+ *  - `src/package.ts`: the runtime `linkedPackage` id — shape URIs derive from it.
+ *  - pm2 process names + the VS Code launch name (cosmetic, but should match).
+ */
+/**
+ * Scaffolded apps are npm apps, so the new app must not also look like a yarn
+ * project. Removes every yarn project file a template clone may still carry —
+ * including the legacy `yarnrc.yml.template` that create-app used to rename
+ * into `.yarnrc.yml`. (No empty `yarn.lock` is written any more either; that
+ * file only existed to pin down Yarn's project-root search.)
+ */
+export declare function stripYarnProjectFiles(targetFolder: string): void;
 export declare function warn(...messages: any[]): void;
 export declare function logError(...errors: any[]): void;
 export declare function developPackage(target: any, mode: any): void;
@@ -60,6 +78,16 @@ export declare function buildAll(options: any): void;
 export declare const createOntology: (prefix: any, uriBase?: any, basePath?: string) => Promise<void>;
 export declare const addShapeToBarrel: (shapeHyphenName: string, root?: string) => string;
 export declare const addLineToIndex: (line: any, insertMatchString: string, root?: string, insertAtStart?: boolean) => string;
+export type PackageManager = 'npm' | 'yarn';
+/**
+ * The package manager `create-app` scaffolds with. Both templates (web and
+ * react-native) install with npm, so a scaffolded app has exactly one lockfile.
+ */
+export declare const CREATE_APP_PACKAGE_MANAGER: PackageManager;
+/** The shell command that installs a scaffolded app's dependencies. */
+export declare function installCommandFor(pm: PackageManager): string;
+/** The command printed to the user for starting their new app. */
+export declare function startCommandFor(pm: PackageManager): string;
 export declare const setNameVariables: (name: any) => {
     hyphenName: any;
     camelCaseName: any;

package/lib/esm/cli-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAgBpD;;;;;;GAMG;AAKH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAC,uBAAuB,EAAE,wBAAwB,EAAE,gBAAgB,EAAC,CAAC;AAoB7E,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,cAAc,CAAC;AAEjD,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,SAAI,EAAE,iBAAwB,EAAE,UAAS;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;CAAM,kBAgNtL,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAcR;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AAkBrD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3E;AA8BD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,WAAW,EACf,OAAO,GAAE;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAM,GAC1D,OAAO,CAAC,IAAI,CAAC,CAkGf;AAGD,eAAO,MAAM,oBAAoB;;CAA2B,CAAC;AA0F7D,wBAAgB,IAAI,CAAC,GAAG,QAAQ,OAAA,QAK/B;AACD,wBAAgB,QAAQ,CAAC,GAAG,MAAM,OAAA,QAIjC;AACD,wBAAgB,cAAc,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA,QAyB1C;AA2CD,wBAAgB,kCAAkC,CAChD,aAAa,KAAA,EACb,YAAY,EAAE,CACZ,YAAY,KAAA,EACZ,YAAY,KAAA,KACT,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1C,UAAU,KAAA,EACV,IAAI,UAAQ,GACX,OAAO,CAAC,IAAI,CAAC,CAqNf;AA+ID,wBAAgB,QAAQ,CAAC,OAAO,KAAA,QAkU/B;AA2ED,eAAO,MAAM,cAAc,GACzB,WAAM,EACN,aAAQ,EACR,iBAAwB,kBA6FzB,CAAC;AAmBF,eAAO,MAAM,gBAAgB,GAAa,iBAAiB,MAAM,EAAE,OAAM,MAAsB,WAkB9F,CAAC;AAIF,eAAO,MAAM,cAAc,GACzB,SAAI,EACJ,mBAAmB,MAAM,EACzB,OAAM,MAAsB,EAC5B,gBAAe,OAAe,WAsC/B,CAAC;AAiGF,eAAO,MAAM,gBAAgB,GAAa,SAAI;;;;;CAc7C,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,YAAY,cAaxB,CAAC;AACF,eAAO,MAAM,WAAW,GAAU,SAAI,EAAE,iBAAwB,kBA0B/D,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,SAAI,EAAE,iBAAwB,kBAmCtE,CAAC;AACF,eAAO,MAAM,eAAe,GAAU,SAAI,EAAE,iBAAwB,kBAuCnE,CAAC;AAMF,eAAO,MAAM,YAAY,GACvB,eAAc,MAA0B,EACxC,QAAO,MAAU,EAAE,wDAAwD;AAC3E,iBAAgB,GAAG,CAAC,MAAM,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAC,EAAE,CAAa,qBA2F9E,CAAC;AAEF,eAAO,MAAM,cAAc,qBAuB1B,CAAC;AACF,eAAO,MAAM,QAAQ,GAAU,cAAa,MAAsB,qBAwDjE,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,YAAY,MAAM,EAClB,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,mBAoB1B,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,QAAQ,MAAM,EACd,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,kBAiH1B,CAAC;AACF,eAAO,MAAM,WAAW,GACtB,WAAU,OAAe,EACzB,iBAAkB,iBA8DnB,CAAC;AACF,eAAO,MAAM,QAAQ,sBAKpB,CAAC;AACF,eAAO,MAAM,aAAa,qBAqHzB,CAAC;AACF,eAAO,MAAM,YAAY,wBAiExB,CAAC;AAEF,eAAO,MAAM,eAAe,qBAoK3B,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAI,EACJ,aAAQ,EACR,iBAAwB,kBA4HzB,CAAC;AAqBF,eAAO,MAAM,QAAQ,GAAa,gBAAW,kBAuD5C,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,WAAM,EACN,YAAO,EACP,oBAA2B,EAC3B,aAAY,OAAc,qBAyK3B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B,CAAC;AAMF,eAAO,MAAM,cAAc,GAAI,YAAO,EAAE,aAAa,MAAM,KAAG,SAAS,EA8GtE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,oBAA2B,kBAyB/D,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B,qBAWlE,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B;;EAelE,CAAC;AAEF,eAAO,IAAI,cAAc,GAAa,OAAM,OAAe,kBA0K1D,CAAC;AAsBF,eAAO,IAAI,cAAc,GACvB,SAAI,EACJ,UAAK,EACL,UAAK,EACL,oBAAe,oBA6DhB,CAAC;AAEF,eAAO,IAAI,YAAY,GACrB,SAAI,EACJ,WAAM,EACN,YAAO,EACP,wBAAuB,OAAe,EACtC,OAAM,OAAe,kBAiHtB,CAAC;AAeF,eAAO,IAAI,4BAA4B,GACrC,aAAQ,EACR,YAAO,EACP,iBAAY,EACZ,gBAAW,qBA4CZ,CAAC;AAOF,eAAO,IAAI,cAAc,GAAa,aAAQ,EAAE,YAAO,SAMtD,CAAC;AACF,eAAO,IAAI,YAAY,GAAmB,iBAAwB,kBA8FjE,CAAC;AAEF,eAAO,IAAI,wBAAwB,GAAa,gBAAW,EAAE,YAAO,SA6BnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,gBAAW,qBA8B/C,CAAC"}
+{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}

package/lib/esm/cli-methods.js

@@ -124,7 +124,7 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     // Scaffold from the canonical template repo (single source of truth; CN's
     // server-side createProject clones the same repo). Shallow clone, then drop
     // .git so the new app starts with clean history.
-    yield execPromise(`git clone --depth 1 https://github.com/linked-cm/app-template.git "${targetFolder}"`, false, false);
+    yield execPromise(`git clone --depth 1 https://github.com/linked-fw/app-template.git "${targetFolder}"`, false, false);
     fs.removeSync(path.join(targetFolder, '.git'));
     //make sure the data folder exists (even though its empty).. copying empty folders does not work with fs.copySync
     fs.mkdirSync(path.join(targetFolder, 'data'), { recursive: true });
@@ -137,19 +137,7 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     if (fs.existsSync(gitignoreTemplate)) {
         fs.renameSync(gitignoreTemplate, path.join(targetFolder, '.gitignore'));
     }
-    const yarnrcTemplate = path.join(targetFolder, 'yarnrc.yml.template');
-    if (fs.existsSync(yarnrcTemplate)) {
-        fs.renameSync(yarnrcTemplate, path.join(targetFolder, '.yarnrc.yml'));
-    }
-    // Mark the new app as a self-contained Yarn project root. Without this,
-    // Yarn climbs ancestor dirs looking for the project root and may decide
-    // a stray yarn.lock further up the tree is "the project" — aborting
-    // install with "the nearest package directory doesn't seem to be part
-    // of the project declared in <ancestor>".
-    const yarnLockPath = path.join(targetFolder, 'yarn.lock');
-    if (!fs.existsSync(yarnLockPath)) {
-        fs.writeFileSync(yarnLockPath, '');
-    }
+    stripYarnProjectFiles(targetFolder);
     // Seed the real (gitignored) Layer 2 config from the committed example so
     // the scaffolded app boots first try. Users can edit either file later.
     const datasetsExample = path.join(targetFolder, 'linked.backend.datasets.example.json');
@@ -165,17 +153,13 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     // create-app stamps this app's identity into the clone directly rather than
     // relying on ${var} substitution.
     applyAppIdentity(targetFolder, { appName, appPrefix, hyphenName });
-    // Pick a package manager. When both are available and the user is running
-    // create-app interactively, ask. Carry the choice through both the install
-    // step AND the final "next command" message so the user can copy-paste.
-    const interactive = !(options.appName ||
-        options.appPrefix ||
-        options.appDomain);
-    const pm = yield choosePackageManager(interactive);
+    // New apps are npm apps: npm is the package manager the templates, the CI
+    // workflows and the published @_linked/* packages are all tested against, and
+    // the react-native template already installs with npm. Keeping a single
+    // package manager also keeps the scaffolded app to a single lockfile.
+    const pm = CREATE_APP_PACKAGE_MANAGER;
     if (!options.skipInstall) {
-        const installCommand = pm === 'yarn'
-            ? 'export NODE_OPTIONS="--no-network-family-autoselection" && yarn install'
-            : 'npm install';
+        const installCommand = installCommandFor(pm);
         const spinner = ora({
             text: `Installing dependencies (${pm})...`,
             spinner: 'dots',
@@ -207,7 +191,7 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
             }
         }
     }
-    const startCommand = pm === 'yarn' ? 'yarn start' : 'npm start';
+    const startCommand = startCommandFor(pm);
     log(`Your Linked app is ready at ${chalk.blueBright(targetFolder)}`, `\nStorage: linked.backend.storage.ts wires aliases to stores; linked.backend.datasets.json holds endpoints.`, `Defaults to Fuseki at ${chalk.cyan('http://localhost:3030')} (auto-creates the dataset on first boot).`, `Make sure Fuseki is running, e.g.:`, `  ${chalk.blueBright('docker run -d --rm -p 3030:3030 --name fuseki stain/jena-fuseki')}`, `Edit ${chalk.cyan('linked.backend.datasets.json')} to change endpoints or credentials.`, `Mirror file for the frontend: ${chalk.cyan('src/linked.frontend.storage.ts')} + ${chalk.cyan('src/linked.frontend.datasets.json')}.`, `\nTo start:`, `  ${chalk.blueBright(`cd ${hyphenName} && ${startCommand}`)}`);
 });
 /**
@@ -391,9 +375,26 @@ function setEnvVar(envText, key, value) {
  *  - `src/package.ts`: the runtime `linkedPackage` id — shape URIs derive from it.
  *  - pm2 process names + the VS Code launch name (cosmetic, but should match).
  */
+/**
+ * Scaffolded apps are npm apps, so the new app must not also look like a yarn
+ * project. Removes every yarn project file a template clone may still carry —
+ * including the legacy `yarnrc.yml.template` that create-app used to rename
+ * into `.yarnrc.yml`. (No empty `yarn.lock` is written any more either; that
+ * file only existed to pin down Yarn's project-root search.)
+ */
+export function stripYarnProjectFiles(targetFolder) {
+    for (const yarnLeftover of [
+        'yarnrc.yml.template',
+        '.yarnrc.yml',
+        '.yarn',
+        'yarn.lock',
+    ]) {
+        fs.removeSync(path.join(targetFolder, yarnLeftover));
+    }
+}
 function applyAppIdentity(targetFolder, ids) {
     const { appName, appPrefix, hyphenName } = ids;
-    // 1. .env.example (+ seed .env from it so the first `yarn start` is correct).
+    // 1. .env.example (+ seed .env from it so the first `npm start` is correct).
     const envExample = path.join(targetFolder, '.env.example');
     if (fs.existsSync(envExample)) {
         let env = fs.readFileSync(envExample, 'utf8');
@@ -1240,48 +1241,20 @@ const replaceVariablesInFolder = function (folder) {
 const replaceVariablesInFilesWithRoot = function (root, ...files) {
     return replaceVariablesInFiles(...files.map((f) => path.join(root, f)));
 };
-function isAvailable(cmd) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            const out = (yield execPromise(`${cmd} --version`, false, false));
-            return /\d+/.test(String(out));
-        }
-        catch (_a) {
-            return false;
-        }
-    });
-}
-function detectPackageManagers() {
-    return __awaiter(this, void 0, void 0, function* () {
-        const found = [];
-        if (yield isAvailable('npm'))
-            found.push('npm');
-        if (yield isAvailable('yarn'))
-            found.push('yarn');
-        return found;
-    });
+/**
+ * The package manager `create-app` scaffolds with. Both templates (web and
+ * react-native) install with npm, so a scaffolded app has exactly one lockfile.
+ */
+export const CREATE_APP_PACKAGE_MANAGER = 'npm';
+/** The shell command that installs a scaffolded app's dependencies. */
+export function installCommandFor(pm) {
+    return pm === 'yarn'
+        ? 'export NODE_OPTIONS="--no-network-family-autoselection" && yarn install'
+        : 'npm install';
 }
-function choosePackageManager(interactive) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const available = yield detectPackageManagers();
-        if (available.length === 0) {
-            throw new Error('Neither npm nor yarn is available on PATH. Install one and retry.');
-        }
-        if (available.length === 1)
-            return available[0];
-        if (!interactive) {
-            // Match the historical default: prefer yarn when both are installed.
-            return available.includes('yarn') ? 'yarn' : 'npm';
-        }
-        const fallback = available.includes('yarn') ? 'yarn' : 'npm';
-        const answer = yield promptUser(`Package manager [${available.join('/')}] (default: ${chalk.gray(fallback)}): `);
-        const choice = answer.trim().toLowerCase();
-        if (choice === 'npm' || choice === 'yarn') {
-            if (available.includes(choice))
-                return choice;
-        }
-        return fallback;
-    });
+/** The command printed to the user for starting their new app. */
+export function startCommandFor(pm) {
+    return pm === 'yarn' ? 'yarn start' : 'npm start';
 }
 const ensureFolderExists = function (...folders) {
     let target;