@_linked/cli 1.15.0 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,124 @@
 # Changelog
 
+## 1.17.0
+
+### Minor Changes
+
+- [#94](https://github.com/linked-fw/cli/pull/94) [`b4140fd`](https://github.com/linked-fw/cli/commit/b4140fdb7ed0face4978d5436e0cee2876eb1d09) Thanks [@flyon](https://github.com/flyon)! - npm is now the CLI's default package manager; yarn is detected, not assumed.
+
+  A new `detectPackageManager()` walks up from the directory being acted on and
+  only reports `yarn` when the tree actually is a yarn project (`yarn.lock`,
+  `.yarnrc.yml`, a vendored `.yarn/releases/`). The nearest marker wins, so an npm
+  package checked out inside a yarn workspace is treated as npm. Everything else
+  is npm. Existing yarn monorepos keep working; `linked yarn` (safe-yarn) is
+  unchanged.
+
+  What changed per command:
+
+  - `linked build-workspace` runs each package's build with `npm run build`
+    instead of always `yarn build` (still `yarn build` inside a yarn workspace).
+  - `linked build <path>` (the editor hook) invokes the `linked` binary via
+    `npx --no-install` instead of always `yarn exec` (yarn, including a vendored
+    release, is still used inside a yarn workspace).
+  - `linked create-package` installs with npm unless the new package lands inside
+    an existing yarn project. `planPackageSetup()` gained an
+    `insideYarnProject` argument; having yarn on `PATH` no longer selects it. The
+    closing hint now names the package manager that was actually used.
+  - `linked publish` uses `npm version … --no-git-tag-version && npm publish`
+    outside a yarn project (Berry's `yarn version` / `yarn npm publish` is kept
+    inside one).
+  - The backend TS compile step uses `npx --no-install tsc` outside a yarn
+    project.
+  - Capacitor setup installs with npm and writes `npx cap …` / `npm run …`
+    scripts instead of `yarn cap …`.
+  - The `create-package` template (`defaults/package/package.json`) builds with
+    `npm run …` and bare local bins, so a scaffolded package no longer needs yarn.
+
+  Also: the CLI's own `build`, `dev`, `test` and `format` scripts no longer shell
+  out to `yarn`, so `npm run build` works without yarn installed (previously it
+  failed under Yarn Berry with "the nearest package directory doesn't seem to be
+  part of the project", and needed a Yarn 1 shim). Stale yarn mentions in the
+  README, help text and comments now say npm.
+
+### Patch Changes
+
+- [#94](https://github.com/linked-fw/cli/pull/94) [`2ec3601`](https://github.com/linked-fw/cli/commit/2ec3601cd473ffbcbd6bfd5fdf4031c28efb48ab) Thanks [@flyon](https://github.com/flyon)! - Declare npm as the package manager for this repo and mark `package-lock.json` as a generated file.
+
+## 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

@@ -6,8 +6,6 @@ Command-line tools for the `@_linked/*` packages and apps.
 
 ```bash
 npm install --save-dev @_linked/cli
-# or
-yarn add -D @_linked/cli
 ```
 
 ## Binaries
@@ -129,7 +127,8 @@ API-only mode is never inferred: a web app without a `vite.config.*` and without
 
 ```bash
 cd packages/cli
-yarn build
+npm install
+npm run build
 ```
 
 Dual ESM + CJS build via `tsconfig-to-dual-package`. Sources in `src/`, output in `lib/esm/` and `lib/cjs/`.
@@ -145,7 +144,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`
 
@@ -208,7 +207,7 @@ cd apps/mobile && npx expo export --platform ios --output-dir /tmp/export
 
 To run it: `npm run fuseki:up`, `npm run api`, then `cd apps/mobile && npx expo run:ios`.
 
-Tests for this template in this repo: `yarn test:unit` covers the scaffold offline, using the fixture in
+Tests for this template in this repo: `npm run test:unit` covers the scaffold offline, using the fixture in
 `tests/fixtures/app-react-native-min` and the real template. `npm run test:template` runs the built CLI with
 install, then checks the generated files, `check:react`, lint, typecheck, `npm test`, the shapes build and a
 Metro iOS bundle. It builds nothing itself, needs network and takes several minutes.

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/defaults/package/package.json

@@ -17,12 +17,12 @@
   "types": "lib/esm/index.d.ts",
   "license": "ISC",
   "scripts": {
-    "start": "yarn linked dev",
-    "build": "rimraf ./lib && yarn build-esm && yarn build-cjs && yarn copy-to-lib && yarn dual-package",
-    "build-esm": "echo \"compiling ESM\" && rimraf ./lib/esm && yarn tsc -p tsconfig-esm.json",
-    "build-cjs": "echo \"compiling CJS\" && rimraf ./lib/cjs && yarn tsc -p tsconfig-cjs.json",
-    "copy-to-lib": "echo 'copying CSS + JSON assets to lib folder' && yarn copyfiles -u 1 'src/**/*.css' 'src/**/*.json' lib/esm && yarn copyfiles -u 1 'src/**/*.css' 'src/**/*.json' lib/cjs",
-    "dual-package": "echo 'adding package.json to each lib folder for dual output support' && yarn tsconfig-to-dual-package ./tsconfig-cjs.json ./tsconfig-esm.json"
+    "start": "linked dev",
+    "build": "rimraf ./lib && npm run build-esm && npm run build-cjs && npm run copy-to-lib && npm run dual-package",
+    "build-esm": "echo \"compiling ESM\" && rimraf ./lib/esm && tsc -p tsconfig-esm.json",
+    "build-cjs": "echo \"compiling CJS\" && rimraf ./lib/cjs && tsc -p tsconfig-cjs.json",
+    "copy-to-lib": "echo 'copying CSS + JSON assets to lib folder' && copyfiles -u 1 'src/**/*.css' 'src/**/*.json' lib/esm && copyfiles -u 1 'src/**/*.css' 'src/**/*.json' lib/cjs",
+    "dual-package": "echo 'adding package.json to each lib folder for dual output support' && tsconfig-to-dual-package ./tsconfig-cjs.json ./tsconfig-esm.json"
   },
   "keywords": [
     "linked",

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":"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"}
+{"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

@@ -17,6 +17,7 @@ import { createInterface } from 'readline';
 import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isInternalLinkedImport, needsRebuilding, } from './utils.js';
 import { renameShippedDotfiles } from './utils/shippedDotfiles.js';
 import { planPackageSetup } from './utils/packageSetup.js';
+import { detectPackageManager, execBinCommand, runScriptCommand, } from './utils/packageManager.js';
 import { rewriteExtensionlessImports } from './utils/esmSpecifiers.js';
 import { spawn as spawnChild } from 'child_process';
 import { findNearestPackageJson } from 'find-nearest-package-json';
@@ -124,7 +125,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 +138,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 +154,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 +192,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 +376,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');
@@ -432,7 +434,7 @@ function applyAppIdentity(targetFolder, ids) {
     }
 }
 function logHelp() {
-    execp('yarn exec lincd help');
+    execp(execBinCommand(detectPackageManager(), 'linked help'));
 }
 function log(...messages) {
     messages.forEach((message) => {
@@ -883,10 +885,13 @@ export function buildAll(options) {
             }
             //unless told otherwise, build the package
             if (!command) {
-                // Invoke the package's own `yarn build` script. This lets each package
+                // Invoke the package's own `build` script. This lets each package
                 // own its build pipeline — e.g. @_linked/core uses direct tsc, pure-CSS
                 // packages may have no-op builds, and linkedPackage: true packages
-                // typically call `yarn linked build` internally.
+                // typically call `linked build` internally.
+                //
+                // npm is the default; the package manager is detected per package so
+                // packages inside an existing yarn workspace still build with yarn.
                 const pkgDir = path.join(process.cwd(), pkg.path);
                 const pkgJson = getPackageJSON(pkgDir);
                 const hasBuildScript = !!((_a = pkgJson === null || pkgJson === void 0 ? void 0 : pkgJson.scripts) === null || _a === void 0 ? void 0 : _a.build);
@@ -895,7 +900,8 @@ export function buildAll(options) {
                     command = Promise.resolve(true);
                 }
                 else {
-                    command = execPromise('yarn build', false, false, {
+                    const buildCmd = runScriptCommand(detectPackageManager(pkgDir), 'build');
+                    command = execPromise(buildCmd, false, false, {
                         cwd: pkgDir,
                     })
                         .then((res) => res === '' || typeof res === 'string')
@@ -1240,48 +1246,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;
@@ -1665,7 +1643,7 @@ export const runMethod = (packageName, method, options) => __awaiter(void 0, voi
             if (error.code === 'ECONNREFUSED' ||
                 ((_a = error.cause) === null || _a === void 0 ? void 0 : _a.code) === 'ECONNREFUSED') {
                 console.error(chalk.red('Could not connect to the backend server. Is it running?'));
-                console.error(`Make sure you ${chalk.magenta('run "yarn start" in a separate process')} before calling this method.`);
+                console.error(`Make sure you ${chalk.magenta('run "npm start" in a separate process')} before calling this method.`);
             }
             else {
                 console.error('Error during backend call:', error);
@@ -1860,7 +1838,7 @@ export const buildBackend = () => __awaiter(void 0, void 0, void 0, function* ()
         text: 'Compiling backend TS files',
     }).start();
     try {
-        yield execPromise(`yarn exec tsc`);
+        yield execPromise(execBinCommand(detectPackageManager(), 'tsc'));
         compileSpinner.succeed('Backend TS files compiled');
     }
     catch (e) {
@@ -2098,11 +2076,17 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
         console.log('rename ', path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
         fs.renameSync(path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
     });
-    let version = (yield execPromise('yarn --version').catch((err) => {
-        console.log('yarn probably not working');
-        return '';
-    }));
-    const setup = planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'));
+    // npm is the default for a new package. yarn is only consulted when the new
+    // package lands inside an existing yarn project (an mrgit/yarn-3 monorepo),
+    // where adding an npm lockfile would break the workspace.
+    const insideYarnProject = detectPackageManager(path.dirname(path.resolve(targetFolder))) === 'yarn';
+    let version = insideYarnProject
+        ? (yield execPromise('yarn --version').catch(() => {
+            console.log('yarn probably not working');
+            return '';
+        }))
+        : '';
+    const setup = planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'), process.execPath, insideYarnProject);
     if (setup.yarnrc) {
         fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
     }
@@ -2121,7 +2105,7 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
             process.exitCode = 1;
         });
     }
-    log(`Prepared a new LINCD package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright('yarn build')} from this directory to build once`, `Or ${chalk.blueBright('yarn dev')} to continuously rebuild on file changes`);
+    log(`Prepared a new LINCD package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'build'))} from this directory to build once`, `Or ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} to continuously rebuild on file changes`);
 });
 var getNextVersion = function (version) {
     let parts = version.split('.');
@@ -2676,7 +2660,13 @@ export var publishPackage = function (pkg, test, info, publishVersion) {
         console.log(chalk.blue('publishing ' + pkg.packageName + ' ' + publishVersion));
         //looking for an .env.json file in our workspace, which may store our NPM AUTH key
         let envJsonPath = yield getEnvJsonPath(pkg.path);
-        return execPromise(`cd ${pkg.path} && ${envJsonPath ? `env-cmd -f ${envJsonPath} --use-shell "` : ''}yarn version ${publishVersion} && yarn npm publish${envJsonPath ? `"` : ''}`, true, false, {}, true)
+        // `yarn version` / `yarn npm publish` is Yarn Berry syntax. Only use it when
+        // the package really lives in a yarn project; otherwise publish with npm.
+        const publishPm = detectPackageManager(pkg.path);
+        const versionAndPublish = publishPm === 'yarn'
+            ? `yarn version ${publishVersion} && yarn npm publish`
+            : `npm version ${publishVersion} --no-git-tag-version && npm publish`;
+        return execPromise(`cd ${pkg.path} && ${envJsonPath ? `env-cmd -f ${envJsonPath} --use-shell "` : ''}${versionAndPublish}${envJsonPath ? `"` : ''}`, true, false, {}, true)
             .then((res) => {
             if (res.indexOf('Aborted due to warnings') !== -1 ||
                 res.indexOf('Could not publish') !== -1 ||
@@ -2885,18 +2875,18 @@ export var addCapacitor = function () {
             'env-cmd -e _main, staging node scripts/build.js';
         pack.scripts['fix-app'] = 'node scripts/fix-namespace.js';
         pack.scripts['app'] =
-            'env-cmd -e _main,production,app-main node scripts/build.js && npx cap sync && yarn run fix-app';
+            'env-cmd -e _main,production,app-main node scripts/build.js && npx cap sync && npm run fix-app';
         pack.scripts['app-local-ios'] =
-            'env-cmd -e _main,development,app-main,app-local-ios node scripts/build.js && npx cap sync && yarn run fix-app';
+            'env-cmd -e _main,development,app-main,app-local-ios node scripts/build.js && npx cap sync && npm run fix-app';
         pack.scripts['app-local-android'] =
-            'env-cmd -e _main,development,app-main,app-local-android node scripts/build.js && npx cap sync && yarn run fix-app';
-        pack.scripts['cap:android'] = 'yarn cap open android';
-        pack.scripts['cap:ios'] = 'yarn cap open ios';
-        pack.scripts['cap:sync'] = 'yarn cap sync';
+            'env-cmd -e _main,development,app-main,app-local-android node scripts/build.js && npx cap sync && npm run fix-app';
+        pack.scripts['cap:android'] = 'npx cap open android';
+        pack.scripts['cap:ios'] = 'npx cap open ios';
+        pack.scripts['cap:sync'] = 'npx cap sync';
         fs.writeFile(path.resolve(basePath, 'package.json'), JSON.stringify(pack, null, 2));
         log('Added new run script to package.json');
-        yield execPromise(`yarn add -D @capacitor/cli`, true, false, null, true);
-        yield execPromise(`yarn add @capacitor/android @capacitor/core @capacitor/app @capacitor/ios`, false, false, null, true);
+        yield execPromise(`npm install --save-dev @capacitor/cli`, true, false, null, true);
+        yield execPromise(`npm install @capacitor/android @capacitor/core @capacitor/app @capacitor/ios`, false, false, null, true);
         // TODO: Do we need to add `npx cap init`? If yes, we should not copy capacitor config.ts yet
         // await execPromise(`npx cap init`, true, false, null, true);
         // got error:
@@ -2905,21 +2895,27 @@ export var addCapacitor = function () {
         // [error] Non-interactive shell detected.
         // Run the command with --help to see a list of arguments that must be provided.
         log(`Done! Now update your Capacitor configuration by providing an app name, app ID, and web directory at ${chalk.blue('capacitor.config.ts')}`);
-        log(`And then run ${chalk.magenta('yarn cap add android')} and/or ${chalk.magenta('yarn cap add ios')}')`);
-        log(`Last, run ${chalk.magenta('yarn app')} or ${chalk.magenta('yarn app-local-ios')} or ${chalk.magenta('yarn app-local-android')}`);
+        log(`And then run ${chalk.magenta('npx cap add android')} and/or ${chalk.magenta('npx cap add ios')}')`);
+        log(`Last, run ${chalk.magenta('npm run app')} or ${chalk.magenta('npm run app-local-ios')} or ${chalk.magenta('npm run app-local-android')}`);
     });
 };
 export var executeCommandForPackage = function (packageName, command) {
     let packageDetails = getLincdPackages().find((modDetails) => modDetails.packageName.indexOf(packageName) !== -1 ||
         modDetails.packageName.indexOf(packageName) !== -1);
     if (packageDetails) {
+        // npm is the default; only a package inside a yarn project is driven with
+        // yarn (`yarn linked <cmd>` resolves the bin from the yarn workspace).
+        const pm = detectPackageManager(packageDetails.path);
+        // Windows quirk: the shim is `yarn.cmd` / `npx.cmd`.
+        const isWin = process.platform === 'win32';
+        const runner = pm === 'yarn' ? (isWin ? 'yarn.cmd' : 'yarn') : isWin ? 'npx.cmd' : 'npx';
+        const runnerArgs = pm === 'yarn' ? ['linked'] : ['--no-install', 'linked'];
         log("Executing 'cd " +
             packageDetails.path +
-            ' && yarn lincd' +
+            ` && ${runner} linked` +
             (command ? ' ' + command : '') +
             "'");
-        spawnChild(process.platform === 'win32' ? 'yarn.cmd' : 'yarn', // Windows quirk
-        ['lincd', command || null], {
+        spawnChild(runner, [...runnerArgs, command || null], {
             cwd: packageDetails.path,
             stdio: 'inherit',
         });