@_linked/cli 1.44.1 → 1.45.0

package/lib/esm/utils/createPackageLocation.js

@@ -13,6 +13,7 @@
  */
 import fs from 'fs';
 import path from 'path';
+import { ensureRelinkHooks } from './relinkHooks.js';
 export const PACKAGE_LOCATIONS = ['packages', 'packages-local'];
 /** A refusal of create-package's own, as opposed to a crash. */
 export class CreatePackageError extends Error {
@@ -121,23 +122,17 @@ export function ensureWorkspaceGlob(pkg) {
     globs.push('packages/*');
     return { changed: true };
 }
-export const RELINK_COMMAND = 'linked localize --relink';
+export { RELINK_COMMAND, ensureRelinkHooks } from './relinkHooks.js';
 /**
- * Make sure the app's `postinstall` recreates localize's links. Without it the
- * next `npm install` prunes a packages-local link as extraneous. With no
- * `local-packages.json` the hook prints nothing and exits 0, so it is safe to
- * commit for everyone. Mutates `pkg`.
+ * Make sure the app's `postinstall` AND `dependencies` scripts recreate
+ * localize's links -- see `./relinkHooks.js` for why npm needs both. Kept
+ * under its old name for existing callers; prefer `ensureRelinkHooks`.
+ * Mutates `pkg`.
+ *
+ * @returns true when it changed `pkg`.
  */
 export function ensureRelinkPostinstall(pkg) {
-    var _a;
-    pkg.scripts = (_a = pkg.scripts) !== null && _a !== void 0 ? _a : {};
-    const current = pkg.scripts.postinstall;
-    if (current && /localize\s+--relink/.test(current))
-        return false;
-    pkg.scripts.postinstall = current
-        ? `${current} && ${RELINK_COMMAND}`
-        : RELINK_COMMAND;
-    return true;
+    return ensureRelinkHooks(pkg).length > 0;
 }
 /**
  * A git remote as npm wants it in `repository.url`: `git+https://…`, or

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

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

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

@@ -0,0 +1,27 @@
+export declare const BASE_URI_ENV = "LINKED_BASE_URI";
+export type BaseUriSource = '--base-uri' | 'environment' | '.env.local' | '.env';
+export interface ResolvedBaseUri {
+    baseUri: string;
+    source: BaseUriSource;
+}
+/**
+ * A root as IRIs are appended to it: absolute http(s), no query or fragment,
+ * ending in `/`. Mirrors the app template's `resolveBaseUri`. Empty → undefined.
+ */
+export declare function normalizeBaseUri(value: string | undefined, from: string): string | undefined;
+/**
+ * The base URI for a package created in `appRoot` (null outside an app, where
+ * only the flag counts). Undefined when no source sets one.
+ */
+export declare function resolvePackageBaseUri({ flag, appRoot, env, }: {
+    flag?: string;
+    appRoot: string | null;
+    env?: NodeJS.ProcessEnv;
+}): ResolvedBaseUri | undefined;
+/**
+ * Give a scaffolded `src/package.ts` its root: `linkedPackage('x')` →
+ * `linkedPackage('x', {baseUri: '…'})`. Throws when the call is not found, so a
+ * template change cannot silently drop the root.
+ */
+export declare function withBaseUri(packageTs: string, baseUri: string): string;
+//# sourceMappingURL=packageBaseUri.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageBaseUri.d.ts","sourceRoot":"","sources":["../../../src/utils/packageBaseUri.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwB5F;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,OAAO,EACP,GAAiB,GAClB,EAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,eAAe,GAAG,SAAS,CAc9B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/lib/esm/utils/packageBaseUri.js

@@ -0,0 +1,91 @@
+/**
+ * The root a new package's IRIs are minted under: `linkedPackage(name, {baseUri})`
+ * gives shapes `{baseUri}shape/{slug}/{Name}`, and an ontology package's terms are
+ * `{baseUri}ont/{ontologySlug}/{Term}`. Without one, core's default
+ * (`https://linked.cm/`) applies.
+ *
+ * Where it comes from, first match wins:
+ *
+ *   1. `--base-uri <uri>`: explicit, and what a script or a host passes.
+ *   2. `LINKED_BASE_URI` in the shell environment.
+ *   3. `LINKED_BASE_URI` in the app's `.env.local`, then its `.env`.
+ *
+ * 2 and 3 are the variable the app template documents as "the root of this
+ * app's package and shape IRIs", read with the same precedence `linked start`
+ * gives the app's `.env` (the shell wins over the file). The file is parsed, not
+ * loaded, so creating a package never changes this process's environment.
+ * `linked.config.js` is not a source: it is a module that would have to be
+ * imported (running the app's code) just to scaffold a package, and it has no
+ * IRI setting today.
+ */
+import fs from 'fs';
+import path from 'path';
+import { parseEnv } from 'util';
+export const BASE_URI_ENV = 'LINKED_BASE_URI';
+/**
+ * A root as IRIs are appended to it: absolute http(s), no query or fragment,
+ * ending in `/`. Mirrors the app template's `resolveBaseUri`. Empty → undefined.
+ */
+export function normalizeBaseUri(value, from) {
+    const trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    if (!trimmed)
+        return undefined;
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch (_a) {
+        url = undefined;
+    }
+    if (!url ||
+        !/^https?:$/.test(url.protocol) ||
+        !url.hostname ||
+        url.search ||
+        url.hash ||
+        /\s/.test(trimmed) ||
+        trimmed.includes('?') ||
+        trimmed.includes('#')) {
+        throw new Error(`${from} must be an absolute http(s) URI without a query or fragment, got ${JSON.stringify(value)}`);
+    }
+    return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;
+}
+/** `LINKED_BASE_URI` from an env file, or undefined when the file or the key is absent. */
+function fromEnvFile(file) {
+    if (!fs.existsSync(file))
+        return undefined;
+    return parseEnv(fs.readFileSync(file, 'utf8'))[BASE_URI_ENV];
+}
+/**
+ * The base URI for a package created in `appRoot` (null outside an app, where
+ * only the flag counts). Undefined when no source sets one.
+ */
+export function resolvePackageBaseUri({ flag, appRoot, env = process.env, }) {
+    const fromFlag = normalizeBaseUri(flag, '--base-uri');
+    if (fromFlag)
+        return { baseUri: fromFlag, source: '--base-uri' };
+    if (!appRoot)
+        return undefined;
+    const fromShell = normalizeBaseUri(env[BASE_URI_ENV], BASE_URI_ENV);
+    if (fromShell)
+        return { baseUri: fromShell, source: 'environment' };
+    for (const name of ['.env.local', '.env']) {
+        const file = path.join(appRoot, name);
+        const value = normalizeBaseUri(fromEnvFile(file), `${BASE_URI_ENV} in ${file}`);
+        if (value)
+            return { baseUri: value, source: name };
+    }
+    return undefined;
+}
+/**
+ * Give a scaffolded `src/package.ts` its root: `linkedPackage('x')` →
+ * `linkedPackage('x', {baseUri: '…'})`. Throws when the call is not found, so a
+ * template change cannot silently drop the root.
+ */
+export function withBaseUri(packageTs, baseUri) {
+    const call = /linkedPackage\(\s*(['"][^'"]+['"])\s*\)/;
+    if (!call.test(packageTs)) {
+        throw new Error('src/package.ts has no linkedPackage(<name>) call to give a baseUri to.');
+    }
+    return packageTs.replace(call, `linkedPackage($1, {baseUri: ${JSON.stringify(baseUri)}})`);
+}
+//# sourceMappingURL=packageBaseUri.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageBaseUri.js","sourceRoot":"","sources":["../../../src/utils/packageBaseUri.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The root a new package's IRIs are minted under: `linkedPackage(name, {baseUri})`\n * gives shapes `{baseUri}shape/{slug}/{Name}`, and an ontology package's terms are\n * `{baseUri}ont/{ontologySlug}/{Term}`. Without one, core's default\n * (`https://linked.cm/`) applies.\n *\n * Where it comes from, first match wins:\n *\n *   1. `--base-uri <uri>`: explicit, and what a script or a host passes.\n *   2. `LINKED_BASE_URI` in the shell environment.\n *   3. `LINKED_BASE_URI` in the app's `.env.local`, then its `.env`.\n *\n * 2 and 3 are the variable the app template documents as \"the root of this\n * app's package and shape IRIs\", read with the same precedence `linked start`\n * gives the app's `.env` (the shell wins over the file). The file is parsed, not\n * loaded, so creating a package never changes this process's environment.\n * `linked.config.js` is not a source: it is a module that would have to be\n * imported (running the app's code) just to scaffold a package, and it has no\n * IRI setting today.\n */\nimport fs from 'fs';\nimport path from 'path';\nimport {parseEnv} from 'util';\n\nexport const BASE_URI_ENV = 'LINKED_BASE_URI';\n\nexport type BaseUriSource = '--base-uri' | 'environment' | '.env.local' | '.env';\n\nexport interface ResolvedBaseUri {\n  baseUri: string;\n  source: BaseUriSource;\n}\n\n/**\n * A root as IRIs are appended to it: absolute http(s), no query or fragment,\n * ending in `/`. Mirrors the app template's `resolveBaseUri`. Empty → undefined.\n */\nexport function normalizeBaseUri(value: string | undefined, from: string): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed) return undefined;\n  let url: URL;\n  try {\n    url = new URL(trimmed);\n  } catch {\n    url = undefined;\n  }\n  if (\n    !url ||\n    !/^https?:$/.test(url.protocol) ||\n    !url.hostname ||\n    url.search ||\n    url.hash ||\n    /\\s/.test(trimmed) ||\n    trimmed.includes('?') ||\n    trimmed.includes('#')\n  ) {\n    throw new Error(\n      `${from} must be an absolute http(s) URI without a query or fragment, got ${JSON.stringify(value)}`,\n    );\n  }\n  return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;\n}\n\n/** `LINKED_BASE_URI` from an env file, or undefined when the file or the key is absent. */\nfunction fromEnvFile(file: string): string | undefined {\n  if (!fs.existsSync(file)) return undefined;\n  return parseEnv(fs.readFileSync(file, 'utf8'))[BASE_URI_ENV];\n}\n\n/**\n * The base URI for a package created in `appRoot` (null outside an app, where\n * only the flag counts). Undefined when no source sets one.\n */\nexport function resolvePackageBaseUri({\n  flag,\n  appRoot,\n  env = process.env,\n}: {\n  flag?: string;\n  appRoot: string | null;\n  env?: NodeJS.ProcessEnv;\n}): ResolvedBaseUri | undefined {\n  const fromFlag = normalizeBaseUri(flag, '--base-uri');\n  if (fromFlag) return {baseUri: fromFlag, source: '--base-uri'};\n  if (!appRoot) return undefined;\n\n  const fromShell = normalizeBaseUri(env[BASE_URI_ENV], BASE_URI_ENV);\n  if (fromShell) return {baseUri: fromShell, source: 'environment'};\n\n  for (const name of ['.env.local', '.env'] as const) {\n    const file = path.join(appRoot, name);\n    const value = normalizeBaseUri(fromEnvFile(file), `${BASE_URI_ENV} in ${file}`);\n    if (value) return {baseUri: value, source: name};\n  }\n  return undefined;\n}\n\n/**\n * Give a scaffolded `src/package.ts` its root: `linkedPackage('x')` →\n * `linkedPackage('x', {baseUri: '…'})`. Throws when the call is not found, so a\n * template change cannot silently drop the root.\n */\nexport function withBaseUri(packageTs: string, baseUri: string): string {\n  const call = /linkedPackage\\(\\s*(['\"][^'\"]+['\"])\\s*\\)/;\n  if (!call.test(packageTs)) {\n    throw new Error('src/package.ts has no linkedPackage(<name>) call to give a baseUri to.');\n  }\n  return packageTs.replace(call, `linkedPackage($1, {baseUri: ${JSON.stringify(baseUri)}})`);\n}\n"]}

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

@@ -0,0 +1,49 @@
+export declare const PACKAGE_KINDS: readonly ["ontology", "assets", "both"];
+export type PackageKind = (typeof PACKAGE_KINDS)[number];
+/** The kinds a single package can be: `both` expands to these two. */
+export type ScaffoldKind = Exclude<PackageKind, 'both'>;
+export declare const KIND_SUFFIX: Record<ScaffoldKind, string>;
+export type KindDecision = {
+    kind: 'resolved';
+    packageKind: PackageKind;
+} | {
+    kind: 'ask';
+} | {
+    kind: 'refuse';
+    message: string;
+};
+export declare function isPackageKind(value: string): value is PackageKind;
+/**
+ * `--kind` decides it. Without it a terminal is asked; anything else is
+ * refused, so a scripted call never meets a prompt. `--remote` names one
+ * repository, which cannot hold both packages.
+ */
+export declare function decidePackageKind({ kind, remote, isTTY, }: {
+    kind?: string;
+    remote?: string;
+    isTTY: boolean;
+}): KindDecision;
+/** `both` → `['ontology', 'assets']`, in the order they are created. */
+export declare function scaffoldKinds(kind: PackageKind): ScaffoldKind[];
+/**
+ * The package name a kind gives: `foo` → `foo-ont` / `foo-assets`, keeping an
+ * npm scope (`@acme/foo` → `@acme/foo-ont`). A name that already ends in the
+ * suffix is kept as it is, so `foo-ont` never becomes `foo-ont-ont`.
+ */
+export declare function packageNameFor(name: string, kind: ScaffoldKind): string;
+/**
+ * The ontology slug of an ontology package: the bare name without `-ont`.
+ * `@acme/foo-ont` → `foo`. It is the `{ontologySlug}` in
+ * `{root}ont/{ontologySlug}/{Term}` and the ontology's file name and prefix.
+ */
+export declare function ontologySlugFor(packageName: string): string;
+/**
+ * The template files of a kind, relative to the package root. The files every
+ * package has come from `defaults/package`; an asset package is that whole
+ * folder, an ontology package adds `defaults/package-ontology` on top of the
+ * shared files only.
+ */
+export declare const PACKAGE_TEMPLATE_DIRS: Record<ScaffoldKind, string[]>;
+/** The files of `defaults/package` every kind gets. The rest is asset-only. */
+export declare const SHARED_TEMPLATE_FILES: readonly ["gitignore.template", "npmignore.template", "package.json", "tsconfig.json", "tsconfig-esm.json", "src/package.ts"];
+//# sourceMappingURL=packageKind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageKind.d.ts","sourceRoot":"","sources":["../../../src/utils/packageKind.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,aAAa,yCAA0C,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAGpD,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAC,GAC5C;IAAC,IAAI,EAAE,KAAK,CAAA;CAAC,GACb;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC;AAEtC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,KAAK,GACN,EAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CAkBf;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAGhE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,+HAOxB,CAAC"}

package/lib/esm/utils/packageKind.js

@@ -0,0 +1,94 @@
+/**
+ * What `linked create-package` scaffolds, decided without touching anything.
+ *
+ * A linked package is one of two kinds (create-now arch-03 §Package types):
+ *
+ * - an **ontology package**, `<name>-ont`: exactly one ontology and nothing
+ *   else. Its ontology slug is `<name>` (no `-ont`), so its terms mint
+ *   `{root}ont/<name>/{Term}` while the package itself is `<name>-ont`.
+ * - an **asset package**, `<name>-assets`: shapes, components and a backend,
+ *   and no ontology.
+ *
+ * `both` scaffolds the pair. The suffix is applied to the name given, unless
+ * the name already carries it.
+ */
+import { bareName } from './createPackageLocation.js';
+export const PACKAGE_KINDS = ['ontology', 'assets', 'both'];
+export const KIND_SUFFIX = {
+    ontology: '-ont',
+    assets: '-assets',
+};
+export function isPackageKind(value) {
+    return PACKAGE_KINDS.includes(value);
+}
+/**
+ * `--kind` decides it. Without it a terminal is asked; anything else is
+ * refused, so a scripted call never meets a prompt. `--remote` names one
+ * repository, which cannot hold both packages.
+ */
+export function decidePackageKind({ kind, remote, isTTY, }) {
+    if (kind !== undefined) {
+        if (!isPackageKind(kind)) {
+            return refuse(`--kind must be one of ${PACKAGE_KINDS.join(', ')}, not "${kind}".`);
+        }
+        if (kind === 'both' && remote) {
+            return refuse(`--kind both creates two packages, and --remote names one repository. Create them ` +
+                `separately: linked create-ont-package and linked create-asset-package.`);
+        }
+        return { kind: 'resolved', packageKind: kind };
+    }
+    if (isTTY)
+        return { kind: 'ask' };
+    return refuse(`What kind of package? Pass --kind ontology (one ontology, no shapes: <name>-ont), ` +
+        `--kind assets (shapes, components and a backend: <name>-assets) or --kind both.`);
+}
+/** `both` → `['ontology', 'assets']`, in the order they are created. */
+export function scaffoldKinds(kind) {
+    return kind === 'both' ? ['ontology', 'assets'] : [kind];
+}
+/**
+ * The package name a kind gives: `foo` → `foo-ont` / `foo-assets`, keeping an
+ * npm scope (`@acme/foo` → `@acme/foo-ont`). A name that already ends in the
+ * suffix is kept as it is, so `foo-ont` never becomes `foo-ont-ont`.
+ */
+export function packageNameFor(name, kind) {
+    const suffix = KIND_SUFFIX[kind];
+    return name.endsWith(suffix) ? name : `${name}${suffix}`;
+}
+/**
+ * The ontology slug of an ontology package: the bare name without `-ont`.
+ * `@acme/foo-ont` → `foo`. It is the `{ontologySlug}` in
+ * `{root}ont/{ontologySlug}/{Term}` and the ontology's file name and prefix.
+ */
+export function ontologySlugFor(packageName) {
+    const bare = bareName(packageName);
+    const suffix = KIND_SUFFIX.ontology;
+    const slug = bare.endsWith(suffix) ? bare.slice(0, -suffix.length) : bare;
+    if (!slug) {
+        throw new Error(`Cannot derive an ontology slug from '${packageName}'`);
+    }
+    return slug;
+}
+/**
+ * The template files of a kind, relative to the package root. The files every
+ * package has come from `defaults/package`; an asset package is that whole
+ * folder, an ontology package adds `defaults/package-ontology` on top of the
+ * shared files only.
+ */
+export const PACKAGE_TEMPLATE_DIRS = {
+    assets: ['package'],
+    ontology: ['package', 'package-ontology'],
+};
+/** The files of `defaults/package` every kind gets. The rest is asset-only. */
+export const SHARED_TEMPLATE_FILES = [
+    'gitignore.template',
+    'npmignore.template',
+    'package.json',
+    'tsconfig.json',
+    'tsconfig-esm.json',
+    'src/package.ts',
+];
+function refuse(message) {
+    return { kind: 'refuse', message };
+}
+//# sourceMappingURL=packageKind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageKind.js","sourceRoot":"","sources":["../../../src/utils/packageKind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAMrE,MAAM,CAAC,MAAM,WAAW,GAAiC;IACvD,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,SAAS;CAClB,CAAC;AAOF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,KAAK,GAKN;IACC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,yBAAyB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;YAC9B,OAAO,MAAM,CACX,mFAAmF;gBACjF,wEAAwE,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,EAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK;QAAE,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC;IAChC,OAAO,MAAM,CACX,oFAAoF;QAClF,iFAAiF,CACpF,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAkB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,wCAAwC,WAAW,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmC;IACnE,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,CAAC;CAC1C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAEX,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,EAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAC,CAAC;AACnC,CAAC","sourcesContent":["/**\n * What `linked create-package` scaffolds, decided without touching anything.\n *\n * A linked package is one of two kinds (create-now arch-03 §Package types):\n *\n * - an **ontology package**, `<name>-ont`: exactly one ontology and nothing\n *   else. Its ontology slug is `<name>` (no `-ont`), so its terms mint\n *   `{root}ont/<name>/{Term}` while the package itself is `<name>-ont`.\n * - an **asset package**, `<name>-assets`: shapes, components and a backend,\n *   and no ontology.\n *\n * `both` scaffolds the pair. The suffix is applied to the name given, unless\n * the name already carries it.\n */\nimport {bareName} from './createPackageLocation.js';\n\nexport const PACKAGE_KINDS = ['ontology', 'assets', 'both'] as const;\nexport type PackageKind = (typeof PACKAGE_KINDS)[number];\n\n/** The kinds a single package can be: `both` expands to these two. */\nexport type ScaffoldKind = Exclude<PackageKind, 'both'>;\n\nexport const KIND_SUFFIX: Record<ScaffoldKind, string> = {\n  ontology: '-ont',\n  assets: '-assets',\n};\n\nexport type KindDecision =\n  | {kind: 'resolved'; packageKind: PackageKind}\n  | {kind: 'ask'}\n  | {kind: 'refuse'; message: string};\n\nexport function isPackageKind(value: string): value is PackageKind {\n  return (PACKAGE_KINDS as readonly string[]).includes(value);\n}\n\n/**\n * `--kind` decides it. Without it a terminal is asked; anything else is\n * refused, so a scripted call never meets a prompt. `--remote` names one\n * repository, which cannot hold both packages.\n */\nexport function decidePackageKind({\n  kind,\n  remote,\n  isTTY,\n}: {\n  kind?: string;\n  remote?: string;\n  isTTY: boolean;\n}): KindDecision {\n  if (kind !== undefined) {\n    if (!isPackageKind(kind)) {\n      return refuse(`--kind must be one of ${PACKAGE_KINDS.join(', ')}, not \"${kind}\".`);\n    }\n    if (kind === 'both' && remote) {\n      return refuse(\n        `--kind both creates two packages, and --remote names one repository. Create them ` +\n          `separately: linked create-ont-package and linked create-asset-package.`,\n      );\n    }\n    return {kind: 'resolved', packageKind: kind};\n  }\n  if (isTTY) return {kind: 'ask'};\n  return refuse(\n    `What kind of package? Pass --kind ontology (one ontology, no shapes: <name>-ont), ` +\n      `--kind assets (shapes, components and a backend: <name>-assets) or --kind both.`,\n  );\n}\n\n/** `both` → `['ontology', 'assets']`, in the order they are created. */\nexport function scaffoldKinds(kind: PackageKind): ScaffoldKind[] {\n  return kind === 'both' ? ['ontology', 'assets'] : [kind];\n}\n\n/**\n * The package name a kind gives: `foo` → `foo-ont` / `foo-assets`, keeping an\n * npm scope (`@acme/foo` → `@acme/foo-ont`). A name that already ends in the\n * suffix is kept as it is, so `foo-ont` never becomes `foo-ont-ont`.\n */\nexport function packageNameFor(name: string, kind: ScaffoldKind): string {\n  const suffix = KIND_SUFFIX[kind];\n  return name.endsWith(suffix) ? name : `${name}${suffix}`;\n}\n\n/**\n * The ontology slug of an ontology package: the bare name without `-ont`.\n * `@acme/foo-ont` → `foo`. It is the `{ontologySlug}` in\n * `{root}ont/{ontologySlug}/{Term}` and the ontology's file name and prefix.\n */\nexport function ontologySlugFor(packageName: string): string {\n  const bare = bareName(packageName);\n  const suffix = KIND_SUFFIX.ontology;\n  const slug = bare.endsWith(suffix) ? bare.slice(0, -suffix.length) : bare;\n  if (!slug) {\n    throw new Error(`Cannot derive an ontology slug from '${packageName}'`);\n  }\n  return slug;\n}\n\n/**\n * The template files of a kind, relative to the package root. The files every\n * package has come from `defaults/package`; an asset package is that whole\n * folder, an ontology package adds `defaults/package-ontology` on top of the\n * shared files only.\n */\nexport const PACKAGE_TEMPLATE_DIRS: Record<ScaffoldKind, string[]> = {\n  assets: ['package'],\n  ontology: ['package', 'package-ontology'],\n};\n\n/** The files of `defaults/package` every kind gets. The rest is asset-only. */\nexport const SHARED_TEMPLATE_FILES = [\n  'gitignore.template',\n  'npmignore.template',\n  'package.json',\n  'tsconfig.json',\n  'tsconfig-esm.json',\n  'src/package.ts',\n] as const;\n\nfunction refuse(message: string): KindDecision {\n  return {kind: 'refuse', message};\n}\n"]}

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

@@ -0,0 +1,19 @@
+export declare const RELINK_COMMAND = "linked localize --relink";
+/** The npm lifecycle scripts that run {@link RELINK_COMMAND}. See the module header. */
+export declare const RELINK_HOOKS: readonly ["postinstall", "dependencies"];
+/**
+ * Make sure each of the app's {@link RELINK_HOOKS} runs {@link RELINK_COMMAND}:
+ * set it when absent, append it with `&&` to a script that does something
+ * else, and leave a script that already relinks alone. Mutates `pkg`.
+ *
+ * @returns the hooks it added the command to (empty when nothing changed).
+ */
+export declare function ensureRelinkHooks(pkg: Record<string, any>): string[];
+/**
+ * {@link ensureRelinkHooks} on a `package.json` file, keeping its indentation
+ * and trailing newline. A missing or unparseable file is left alone.
+ *
+ * @returns the hooks it added (empty when nothing changed or nothing could be).
+ */
+export declare function ensureRelinkHooksInFile(pkgPath: string): string[];
+//# sourceMappingURL=relinkHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relinkHooks.d.ts","sourceRoot":"","sources":["../../../src/utils/relinkHooks.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,wFAAwF;AACxF,eAAO,MAAM,YAAY,0CAA2C,CAAC;AAKrE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAYpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBjE"}

package/lib/esm/utils/relinkHooks.js

@@ -0,0 +1,74 @@
+/**
+ * The app scripts that put `linked localize`'s links back after npm removed
+ * them. Shared by `create-package` (which sets them up before it adopts a new
+ * package) and by `localize` / `adopt` (which add them when they record a
+ * package into an app that does not have them yet).
+ *
+ * Why TWO hooks, both running the same command: npm runs an app's root
+ * `postinstall` only on a bare `npm install` / `npm ci`. It runs a root
+ * `dependencies` script after ANY command that changes `node_modules` --
+ * `npm install <name>`, `npm update`, `npm uninstall`, `npm dedupe` (npm's
+ * arborist, `reify.js`). Each of those replaces a localized link with the
+ * registry copy, silently, so `postinstall` alone leaves most of them
+ * unguarded. A bare `npm install` runs both scripts; `--relink` is idempotent
+ * and silent when there is nothing to do, so running twice costs nothing.
+ *
+ * With no `local-packages.json` the command prints nothing and exits 0, so the
+ * hooks are safe to commit for everyone.
+ */
+import fs from 'fs';
+export const RELINK_COMMAND = 'linked localize --relink';
+/** The npm lifecycle scripts that run {@link RELINK_COMMAND}. See the module header. */
+export const RELINK_HOOKS = ['postinstall', 'dependencies'];
+/** Also matches the retired `linked-localize --relink` spelling. */
+const RELINKS = /localize\s+--relink/;
+/**
+ * Make sure each of the app's {@link RELINK_HOOKS} runs {@link RELINK_COMMAND}:
+ * set it when absent, append it with `&&` to a script that does something
+ * else, and leave a script that already relinks alone. Mutates `pkg`.
+ *
+ * @returns the hooks it added the command to (empty when nothing changed).
+ */
+export function ensureRelinkHooks(pkg) {
+    var _a;
+    pkg.scripts = (_a = pkg.scripts) !== null && _a !== void 0 ? _a : {};
+    const added = [];
+    for (const hook of RELINK_HOOKS) {
+        const current = pkg.scripts[hook];
+        if (current && RELINKS.test(current))
+            continue;
+        pkg.scripts[hook] = current
+            ? `${current} && ${RELINK_COMMAND}`
+            : RELINK_COMMAND;
+        added.push(hook);
+    }
+    return added;
+}
+/**
+ * {@link ensureRelinkHooks} on a `package.json` file, keeping its indentation
+ * and trailing newline. A missing or unparseable file is left alone.
+ *
+ * @returns the hooks it added (empty when nothing changed or nothing could be).
+ */
+export function ensureRelinkHooksInFile(pkgPath) {
+    var _a, _b;
+    let text;
+    let pkg;
+    try {
+        text = fs.readFileSync(pkgPath, 'utf8');
+        pkg = JSON.parse(text);
+    }
+    catch (_c) {
+        return [];
+    }
+    if (!pkg || typeof pkg !== 'object' || Array.isArray(pkg))
+        return [];
+    const added = ensureRelinkHooks(pkg);
+    if (!added.length)
+        return added;
+    const indent = (_b = (_a = /^[ \t]+(?=")/m.exec(text)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : 2;
+    const eol = text.endsWith('\n') ? '\n' : '';
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + eol);
+    return added;
+}
+//# sourceMappingURL=relinkHooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relinkHooks.js","sourceRoot":"","sources":["../../../src/utils/relinkHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,cAAc,CAAU,CAAC;AAErE,oEAAoE;AACpE,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAwB;;IACxD,GAAG,CAAC,OAAO,GAAG,MAAA,GAAG,CAAC,OAAO,mCAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,OAAO,GAAuB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QAC/C,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO;YACzB,CAAC,CAAC,GAAG,OAAO,OAAO,cAAc,EAAE;YACnC,CAAC,CAAC,cAAc,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;;IACrD,IAAI,IAAY,CAAC;IACjB,IAAI,GAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,MAAA,MAAA,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * The app scripts that put `linked localize`'s links back after npm removed\n * them. Shared by `create-package` (which sets them up before it adopts a new\n * package) and by `localize` / `adopt` (which add them when they record a\n * package into an app that does not have them yet).\n *\n * Why TWO hooks, both running the same command: npm runs an app's root\n * `postinstall` only on a bare `npm install` / `npm ci`. It runs a root\n * `dependencies` script after ANY command that changes `node_modules` --\n * `npm install <name>`, `npm update`, `npm uninstall`, `npm dedupe` (npm's\n * arborist, `reify.js`). Each of those replaces a localized link with the\n * registry copy, silently, so `postinstall` alone leaves most of them\n * unguarded. A bare `npm install` runs both scripts; `--relink` is idempotent\n * and silent when there is nothing to do, so running twice costs nothing.\n *\n * With no `local-packages.json` the command prints nothing and exits 0, so the\n * hooks are safe to commit for everyone.\n */\nimport fs from 'fs';\n\nexport const RELINK_COMMAND = 'linked localize --relink';\n\n/** The npm lifecycle scripts that run {@link RELINK_COMMAND}. See the module header. */\nexport const RELINK_HOOKS = ['postinstall', 'dependencies'] as const;\n\n/** Also matches the retired `linked-localize --relink` spelling. */\nconst RELINKS = /localize\\s+--relink/;\n\n/**\n * Make sure each of the app's {@link RELINK_HOOKS} runs {@link RELINK_COMMAND}:\n * set it when absent, append it with `&&` to a script that does something\n * else, and leave a script that already relinks alone. Mutates `pkg`.\n *\n * @returns the hooks it added the command to (empty when nothing changed).\n */\nexport function ensureRelinkHooks(pkg: Record<string, any>): string[] {\n  pkg.scripts = pkg.scripts ?? {};\n  const added: string[] = [];\n  for (const hook of RELINK_HOOKS) {\n    const current: string | undefined = pkg.scripts[hook];\n    if (current && RELINKS.test(current)) continue;\n    pkg.scripts[hook] = current\n      ? `${current} && ${RELINK_COMMAND}`\n      : RELINK_COMMAND;\n    added.push(hook);\n  }\n  return added;\n}\n\n/**\n * {@link ensureRelinkHooks} on a `package.json` file, keeping its indentation\n * and trailing newline. A missing or unparseable file is left alone.\n *\n * @returns the hooks it added (empty when nothing changed or nothing could be).\n */\nexport function ensureRelinkHooksInFile(pkgPath: string): string[] {\n  let text: string;\n  let pkg: Record<string, any>;\n  try {\n    text = fs.readFileSync(pkgPath, 'utf8');\n    pkg = JSON.parse(text);\n  } catch {\n    return [];\n  }\n  if (!pkg || typeof pkg !== 'object' || Array.isArray(pkg)) return [];\n  const added = ensureRelinkHooks(pkg);\n  if (!added.length) return added;\n  const indent = /^[ \\t]+(?=\")/m.exec(text)?.[0] ?? 2;\n  const eol = text.endsWith('\\n') ? '\\n' : '';\n  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + eol);\n  return added;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_linked/cli",
-  "version": "1.44.1",
+  "version": "1.45.0",
   "packageManager": "npm@11.21.0",
   "description": "Command line tools for the @_linked/* packages and apps",
   "main": "lib/esm/index.js",