@saasicat/cli 0.27.0 → 1.0.0-rc.1

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   MfaSetupFlow: () => MfaSetupFlow,
   PLATFORM_DOCTOR_CHECK_PROVIDERS: () => PLATFORM_DOCTOR_CHECK_PROVIDERS,
   PlanCatalogDoctorCheck: () => PlanCatalogDoctorCheck,
+  UI_VUE_SPECIFIER: () => UI_VUE_SPECIFIER,
   USER_MANAGEMENT_PORT_TOKEN: () => USER_MANAGEMENT_PORT_TOKEN,
   USER_PORT_TOKEN: () => USER_PORT_TOKEN,
   UserCommands: () => UserCommands,
@@ -78,6 +79,7 @@ __export(index_exports, {
   blankStringLiterals: () => blankStringLiterals,
   blockBodyLines: () => blockBodyLines,
   breaksContract: () => breaksContract,
+  buildImportMap: () => buildImportMap,
   checkSchema: () => checkSchema,
   constraintsFor: () => constraintsFor,
   enableFkPointers: () => enableFkPointers,
@@ -89,10 +91,12 @@ __export(index_exports, {
   foreignKeyOf: () => foreignKeyOf,
   hasBackRelation: () => hasBackRelation,
   hasConstraints: () => hasConstraints,
+  isNoLongerPublic: () => isNoLongerPublic,
   isOneToOne: () => isOneToOne,
   kebabCase: () => kebabCase,
   migrationCreatedBy: () => migrationCreatedBy,
   minimumQuotasPerPlan: () => minimumQuotasPerPlan,
+  namedImports: () => namedImports,
   parseBlockAttributes: () => parseBlockAttributes,
   parseEnumValues: () => parseEnumValues,
   parseFields: () => parseFields,
@@ -106,20 +110,24 @@ __export(index_exports, {
   quotaKeyPattern: () => quotaKeyPattern,
   relationNameOf: () => relationNameOf,
   reportConstraints: () => reportConstraints,
+  rewriteImports: () => rewriteImports,
+  rewriteManifest: () => rewriteManifest,
+  rewriteNames: () => rewriteNames,
+  rewriteSubpath: () => rewriteSubpath,
   stripLineComment: () => stripLineComment,
   structuralOnly: () => structuralOnly,
   tablesAddressedBy: () => tablesAddressedBy
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/tokens.ts
-var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/Config");
-var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserPort");
-var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/UserManagementPort");
-var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/AuditQueryPort");
-var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/DoctorChecks");
-var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestAccessPort");
-var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform-cli/ManifestChecks");
+// src/cli.tokens.ts
+var CLI_CONTEXT_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/Config");
+var USER_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserPort");
+var USER_MANAGEMENT_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/UserManagementPort");
+var AUDIT_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/AuditQueryPort");
+var DOCTOR_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/DoctorChecks");
+var MANIFEST_ACCESS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestAccessPort");
+var MANIFEST_CHECKS_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/cli/ManifestChecks");
 
 // src/cli-context.service.ts
 var os = __toESM(require("os"), 1);
@@ -1827,6 +1835,269 @@ function patchOptionsFor(plan) {
 }
 __name(patchOptionsFor, "patchOptionsFor");
 
+// src/codemods/v1-imports.ts
+var PUBLIC_PREFIXES = [
+  "ui/",
+  "layouts/",
+  "auth/",
+  "pages/"
+];
+function buildImportMap(table) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [from, to] of Object.entries(table.moves)) {
+    const onSurface = PUBLIC_PREFIXES.some((prefix) => to.startsWith(prefix));
+    if (!onSurface && !to.startsWith("@")) continue;
+    if (from.startsWith("components/")) {
+      map.set(from, to);
+      continue;
+    }
+    if (!from.startsWith("pages-standard/")) continue;
+    const file = from.slice("pages-standard/".length);
+    if (file.includes("/")) continue;
+    map.set(from, to);
+    map.set(`pages/${file}`, to);
+  }
+  for (const [from, to] of Object.entries(table.packages ?? {})) {
+    if (from === "_") continue;
+    map.set(from, to);
+  }
+  for (const [from, to] of Object.entries(table.moveDirectories ?? {})) {
+    map.set(`${from}/`, `${to}/`);
+  }
+  return map;
+}
+__name(buildImportMap, "buildImportMap");
+function wentPrivate(map, subpath) {
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("internal/") && subpath.startsWith(prefix)) {
+      return true;
+    }
+  }
+  return false;
+}
+__name(wentPrivate, "wentPrivate");
+function rewriteSubpath(map, subpath) {
+  const direct = map.get(subpath);
+  if (direct !== void 0 && direct !== subpath) return direct;
+  for (const [prefix, target] of map) {
+    if (prefix.endsWith("/") && target.startsWith("@") && subpath.startsWith(prefix)) {
+      return `${target}${subpath.slice(prefix.length)}`;
+    }
+  }
+  if (subpath.startsWith("pages-standard/") && !wentPrivate(map, subpath)) {
+    const file = subpath.slice("pages-standard/".length);
+    if (!file.includes("/")) return `pages/${file}`;
+  }
+  return null;
+}
+__name(rewriteSubpath, "rewriteSubpath");
+function isNoLongerPublic(map, subpath) {
+  if (subpath.startsWith("components/")) return !map.has(subpath);
+  return subpath.startsWith("pages-standard/") && wentPrivate(map, subpath);
+}
+__name(isNoLongerPublic, "isNoLongerPublic");
+var UI_VUE_SPECIFIER = /@saasicat\/ui-vue\/([A-Za-z0-9/_.-]+)/g;
+function rewriteImports(text, map) {
+  const unmapped = /* @__PURE__ */ new Map();
+  let rewritten = 0;
+  const next = text.replace(UI_VUE_SPECIFIER, (whole, subpath) => {
+    const to = rewriteSubpath(map, subpath);
+    if (to === null) {
+      if (isNoLongerPublic(map, subpath)) {
+        unmapped.set(subpath, (unmapped.get(subpath) ?? 0) + 1);
+      }
+      return whole;
+    }
+    rewritten += 1;
+    return to.startsWith("@") ? to : `@saasicat/ui-vue/${to}`;
+  });
+  return {
+    text: next,
+    rewritten,
+    unmapped
+  };
+}
+__name(rewriteImports, "rewriteImports");
+
+// src/codemods/v1-rename.ts
+var escape = /* @__PURE__ */ __name((s) => s.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&"), "escape");
+var FROM_SPECIFIER = /from\s*(['"])([^'"]+)\1/g;
+var isSpace = /* @__PURE__ */ __name((ch) => ch === " " || ch === "	" || ch === "\n" || ch === "\r", "isSpace");
+function namedImports(text) {
+  const found = [];
+  for (const match of text.matchAll(FROM_SPECIFIER)) {
+    let i = (match.index ?? 0) - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    if (text[i] !== "}") continue;
+    const close = i;
+    const open = text.lastIndexOf("{", close);
+    if (open < 0) continue;
+    i = open - 1;
+    while (i >= 0 && isSpace(text[i])) i -= 1;
+    let head = text.slice(Math.max(0, i - 3), i + 1);
+    if (head === "type") {
+      i -= 4;
+      while (i >= 0 && isSpace(text[i])) i -= 1;
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    } else {
+      head = text.slice(Math.max(0, i - 5), i + 1);
+    }
+    if (head !== "import") continue;
+    const names = text.slice(open + 1, close).split(",").map((raw) => {
+      const words = raw.trim().split(/\s+/);
+      if (words[0] === "type") words.shift();
+      return words[0] ?? "";
+    }).filter((name) => name.length > 0);
+    found.push({
+      names,
+      specifier: match[2]
+    });
+  }
+  return found;
+}
+__name(namedImports, "namedImports");
+function rewriteNames(text, table) {
+  let next = text;
+  let rewritten = 0;
+  const ambiguous = /* @__PURE__ */ new Set();
+  const perEntry = /* @__PURE__ */ new Map();
+  for (const { names, specifier } of namedImports(text)) {
+    const mapping = table.entryTokens[specifier];
+    for (const name of names) {
+      const knownSomewhere = Object.values(table.entryTokens).some((m) => name in m);
+      if (!knownSomewhere) continue;
+      const already = perEntry.get(name);
+      if (mapping && name in mapping && (already === void 0 || already === mapping[name])) {
+        perEntry.set(name, mapping[name]);
+      } else {
+        if (already !== void 0) perEntry.delete(name);
+        ambiguous.add(`${name} from '${specifier}'`);
+      }
+    }
+  }
+  for (const [from, to] of perEntry) {
+    next = next.replace(new RegExp(`\\b${escape(from)}\\b`, "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.identifierStems)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.registryKeys)) {
+    const symbolFor = new RegExp(`(Symbol\\.for\\(\\s*['"\`])${escape(from)}`, "g");
+    next = next.replace(symbolFor, (_, head) => {
+      rewritten += 1;
+      return `${head}${to}`;
+    });
+    if (from.startsWith("@")) continue;
+    const literal = new RegExp(`(['"\`])${escape(from)}`, "g");
+    next = next.replace(literal, (_, quote) => {
+      rewritten += 1;
+      return `${quote}${to}`;
+    });
+  }
+  for (const [from, to] of Object.entries(table.packages ?? {})) {
+    if (from === "_") continue;
+    next = next.replace(new RegExp(`${escape(from)}(?=['"\`/])`, "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  for (const [from, to] of Object.entries(table.subpaths)) {
+    next = next.replace(new RegExp(escape(from), "g"), () => {
+      rewritten += 1;
+      return to;
+    });
+  }
+  return {
+    text: next,
+    rewritten,
+    ambiguous: [
+      ...ambiguous
+    ].sort()
+  };
+}
+__name(rewriteNames, "rewriteNames");
+var DEPENDENCY_FIELDS = [
+  "dependencies",
+  "devDependencies",
+  "peerDependencies",
+  "optionalDependencies"
+];
+var UNTRANSLATABLE_RANGE = /^(workspace:|file:|link:|npm:|git\+|https?:)/;
+function rewriteManifest(text, table, options) {
+  const renames = Object.entries(table.packages ?? {}).filter(([from]) => from !== "_");
+  const ambiguous = [];
+  let manifest;
+  try {
+    manifest = JSON.parse(text);
+  } catch {
+    return {
+      text,
+      rewritten: 0,
+      ambiguous
+    };
+  }
+  let rewritten = 0;
+  for (const field of DEPENDENCY_FIELDS) {
+    const deps = manifest[field];
+    if (!deps || typeof deps !== "object") continue;
+    const entries = Object.entries(deps);
+    const renamed = entries.map(([name, range]) => {
+      const to = renames.find(([from]) => from === name)?.[1];
+      if (!to) return [
+        name,
+        range
+      ];
+      if (UNTRANSLATABLE_RANGE.test(range)) {
+        ambiguous.push(`${name} in ${field} (${range})`);
+        return [
+          name,
+          range
+        ];
+      }
+      rewritten += 1;
+      return [
+        to,
+        options.targetRange
+      ];
+    });
+    manifest[field] = Object.fromEntries(renamed);
+  }
+  const meta = manifest.peerDependenciesMeta;
+  if (meta && typeof meta === "object") {
+    manifest.peerDependenciesMeta = Object.fromEntries(Object.entries(meta).map(([name, flags]) => {
+      const to = renames.find(([from]) => from === name)?.[1];
+      if (!to) return [
+        name,
+        flags
+      ];
+      rewritten += 1;
+      return [
+        to,
+        flags
+      ];
+    }));
+  }
+  if (rewritten === 0) return {
+    text,
+    rewritten: 0,
+    ambiguous
+  };
+  const indent = /^[ \t]+/m.exec(text)?.[0] ?? "    ";
+  const trailing = text.endsWith("\n") ? "\n" : "";
+  return {
+    text: JSON.stringify(manifest, null, indent) + trailing,
+    rewritten,
+    ambiguous
+  };
+}
+__name(rewriteManifest, "rewriteManifest");
+
 // src/init/patch-app-module.ts
 var MARKER = "SaaSiCatModule.forRoot";
 function patchAppModule(source, options) {
@@ -1951,7 +2222,7 @@ var LIMIT_FILTER_IMPORTS = [
   "import { LimitExceededFilter } from '@saasicat/nest/billing';"
 ].join("\n");
 
-// src/module.ts
+// src/cli-context.module.ts
 var import_common8 = require("@nestjs/common");
 var import_nest5 = require("@saasicat/nest");
 function _ts_decorate8(decorators, target, key, desc) {
@@ -3037,6 +3308,7 @@ UserCommands = _ts_decorate14([
   MfaSetupFlow,
   PLATFORM_DOCTOR_CHECK_PROVIDERS,
   PlanCatalogDoctorCheck,
+  UI_VUE_SPECIFIER,
   USER_MANAGEMENT_PORT_TOKEN,
   USER_PORT_TOKEN,
   UserCommands,
@@ -3051,6 +3323,7 @@ UserCommands = _ts_decorate14([
   blankStringLiterals,
   blockBodyLines,
   breaksContract,
+  buildImportMap,
   checkSchema,
   constraintsFor,
   enableFkPointers,
@@ -3062,10 +3335,12 @@ UserCommands = _ts_decorate14([
   foreignKeyOf,
   hasBackRelation,
   hasConstraints,
+  isNoLongerPublic,
   isOneToOne,
   kebabCase,
   migrationCreatedBy,
   minimumQuotasPerPlan,
+  namedImports,
   parseBlockAttributes,
   parseEnumValues,
   parseFields,
@@ -3079,6 +3354,10 @@ UserCommands = _ts_decorate14([
   quotaKeyPattern,
   relationNameOf,
   reportConstraints,
+  rewriteImports,
+  rewriteManifest,
+  rewriteNames,
+  rewriteSubpath,
   stripLineComment,
   structuralOnly,
   tablesAddressedBy

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { MfaService, AdminAuditService, AdminManifestService, DiscoverySnapshot, ProviderSpec, DiscoveryScanner } from '@saasicat/nest';
-import { UserPort, PlatformUserDto, AuditQueryPort, AuditEntry, AdminManifest, ManifestAccessPort, PlanCatalog, UserManagementPort } from '@saasicat/types';
+import { UserPort, PlatformUserDto, AuditQueryPort, AuditEntry, AdminManifest, ManifestAccessPort, PlanCatalog, UserManagementPort } from '@saasicat/core';
 import { Type, DynamicModule } from '@nestjs/common';
 import { CommandRunner } from 'nest-commander';
 
@@ -820,6 +820,117 @@ declare function assertValidProjectKey(projectKey: string): void;
 /** The same, for a quota key. `additionalProperties: false` makes it a hard rule. */
 declare function assertValidQuotaKey(quotaKey: string): void;
 
+/** One entry of the move table: where a file was, and where it went. */
+interface MoveTable {
+    readonly moves: Readonly<Record<string, string>>;
+    /**
+     * Prefixes that left the package entirely. The value is a full specifier
+     * — `@saasicat/ui-vue-tenant/` — and is emitted verbatim.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+    /**
+     * Directories whose files left the surface as a whole — the page-private
+     * parts under `pages-standard/<page>/` that became `internal/<page>/`.
+     */
+    readonly moveDirectories?: Readonly<Record<string, string>>;
+}
+/**
+ * Old subpath → new subpath, derived from the move table.
+ *
+ * Both spellings of a page that moved are mapped, because both were reachable:
+ * `pages/AdminLayout.vue` and `pages-standard/AdminLayout.vue` named one file.
+ */
+declare function buildImportMap(table: MoveTable): Map<string, string>;
+/**
+ * What a subpath becomes, or null when it is already right.
+ *
+ * A `pages-standard/` path with no entry in the table is a page that did not
+ * move: it keeps its name under the surviving alias.
+ */
+declare function rewriteSubpath(map: ReadonlyMap<string, string>, subpath: string): string | null;
+/**
+ * Whether a subpath was public before and is not any more.
+ *
+ * Reported rather than rewritten: it moved into `features/` or `internal/`,
+ * which the 1.0 surface does not publish, so there is no destination to point
+ * at. Leaving it silently would hand the consumer a build error with no
+ * explanation of what happened.
+ */
+declare function isNoLongerPublic(map: ReadonlyMap<string, string>, subpath: string): boolean;
+/** Every `@saasicat/ui-vue/<subpath>` occurrence in a source text. */
+declare const UI_VUE_SPECIFIER: RegExp;
+interface RewriteResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /** Subpaths that lost their export, with how often each appeared. */
+    readonly unmapped: ReadonlyMap<string, number>;
+}
+/** Applies the map to one file's text. */
+declare function rewriteImports(text: string, map: ReadonlyMap<string, string>): RewriteResult;
+
+/** One entry of the rename table. */
+interface RenameTable {
+    /** An identifier stem, matched anywhere in an identifier, and its replacement. */
+    readonly identifierStems: Readonly<Record<string, string>>;
+    /** A registry-key prefix (or a whole key) inside a string literal, and its replacement. */
+    readonly registryKeys: Readonly<Record<string, string>>;
+    /** Per import specifier: a name that means something different per entry. */
+    readonly entryTokens: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** A module specifier prefix and its replacement. */
+    readonly subpaths: Readonly<Record<string, string>>;
+    /**
+     * A package that was renamed. Rewritten in specifiers by `rewriteNames`
+     * and in `package.json` dependency fields by `rewriteManifest` — both,
+     * because an import a manifest does not declare fails to resolve under
+     * pnpm's isolated `node_modules`.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+}
+interface RenameResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /**
+     * Names the table knows only per entry, imported from somewhere the table
+     * does not cover. Reported rather than guessed: which registry the
+     * consumer meant is not in the text.
+     */
+    readonly ambiguous: readonly string[];
+}
+/**
+ * The specifier and the bound names of every `import { … } from '…'`.
+ *
+ * Read backwards from each `from`, one character at a time, instead of with
+ * one regular expression over the statement: `\{([^}]*)\}\s+from` and its
+ * siblings backtrack quadratically on a file full of `import {{`, and the
+ * file is a consumer's — whatever they wrote, this must finish.
+ */
+declare function namedImports(text: string): Array<{
+    names: string[];
+    specifier: string;
+}>;
+/** Applies the table to one file's text. Idempotent: a second run changes nothing. */
+declare function rewriteNames(text: string, table: RenameTable): RenameResult;
+/**
+ * Applies the package renames to a `package.json` text.
+ *
+ * Parsed and re-serialised rather than string-replaced, so a rename lands in a
+ * dependency field and nowhere else — not in `name`, not in a description.
+ * The file's indentation is kept; a consumer's formatter must not see a diff
+ * it did not cause. Returns the text unchanged when nothing applied.
+ */
+interface ManifestRewriteOptions {
+    /**
+     * The range the renamed dependency gets — `^<the version this CLI was
+     * released as>`. The old range cannot be carried over: a 0.x consumer
+     * declares `"@saasicat/types": "^0.27.0"`, and `@saasicat/core` has no
+     * 0.27 — the rename starts on the 1.0 line. The caller passes the CLI's
+     * own version because that IS the line the consumer is migrating to;
+     * the codemod ships with it.
+     */
+    readonly targetRange: string;
+}
+declare function rewriteManifest(text: string, table: RenameTable, options: ManifestRewriteOptions): RenameResult;
+
 interface PatchAppModuleOptions {
     /** Import specifier for the persistence bundle, or null when not generated. */
     persistenceImport: string | null;
@@ -1063,4 +1174,4 @@ declare class UserCommands extends CommandRunner {
     parsePassword(val: string): string;
 }
 
-export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type SchemaCheckReport, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, stripLineComment, structuralOnly, tablesAddressedBy };
+export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, type ManifestRewriteOptions, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, type MoveTable, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type RenameResult, type RenameTable, type RewriteResult, type SchemaCheckReport, UI_VUE_SPECIFIER, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, buildImportMap, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isNoLongerPublic, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, namedImports, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, rewriteImports, rewriteManifest, rewriteNames, rewriteSubpath, stripLineComment, structuralOnly, tablesAddressedBy };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { MfaService, AdminAuditService, AdminManifestService, DiscoverySnapshot, ProviderSpec, DiscoveryScanner } from '@saasicat/nest';
-import { UserPort, PlatformUserDto, AuditQueryPort, AuditEntry, AdminManifest, ManifestAccessPort, PlanCatalog, UserManagementPort } from '@saasicat/types';
+import { UserPort, PlatformUserDto, AuditQueryPort, AuditEntry, AdminManifest, ManifestAccessPort, PlanCatalog, UserManagementPort } from '@saasicat/core';
 import { Type, DynamicModule } from '@nestjs/common';
 import { CommandRunner } from 'nest-commander';
 
@@ -820,6 +820,117 @@ declare function assertValidProjectKey(projectKey: string): void;
 /** The same, for a quota key. `additionalProperties: false` makes it a hard rule. */
 declare function assertValidQuotaKey(quotaKey: string): void;
 
+/** One entry of the move table: where a file was, and where it went. */
+interface MoveTable {
+    readonly moves: Readonly<Record<string, string>>;
+    /**
+     * Prefixes that left the package entirely. The value is a full specifier
+     * — `@saasicat/ui-vue-tenant/` — and is emitted verbatim.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+    /**
+     * Directories whose files left the surface as a whole — the page-private
+     * parts under `pages-standard/<page>/` that became `internal/<page>/`.
+     */
+    readonly moveDirectories?: Readonly<Record<string, string>>;
+}
+/**
+ * Old subpath → new subpath, derived from the move table.
+ *
+ * Both spellings of a page that moved are mapped, because both were reachable:
+ * `pages/AdminLayout.vue` and `pages-standard/AdminLayout.vue` named one file.
+ */
+declare function buildImportMap(table: MoveTable): Map<string, string>;
+/**
+ * What a subpath becomes, or null when it is already right.
+ *
+ * A `pages-standard/` path with no entry in the table is a page that did not
+ * move: it keeps its name under the surviving alias.
+ */
+declare function rewriteSubpath(map: ReadonlyMap<string, string>, subpath: string): string | null;
+/**
+ * Whether a subpath was public before and is not any more.
+ *
+ * Reported rather than rewritten: it moved into `features/` or `internal/`,
+ * which the 1.0 surface does not publish, so there is no destination to point
+ * at. Leaving it silently would hand the consumer a build error with no
+ * explanation of what happened.
+ */
+declare function isNoLongerPublic(map: ReadonlyMap<string, string>, subpath: string): boolean;
+/** Every `@saasicat/ui-vue/<subpath>` occurrence in a source text. */
+declare const UI_VUE_SPECIFIER: RegExp;
+interface RewriteResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /** Subpaths that lost their export, with how often each appeared. */
+    readonly unmapped: ReadonlyMap<string, number>;
+}
+/** Applies the map to one file's text. */
+declare function rewriteImports(text: string, map: ReadonlyMap<string, string>): RewriteResult;
+
+/** One entry of the rename table. */
+interface RenameTable {
+    /** An identifier stem, matched anywhere in an identifier, and its replacement. */
+    readonly identifierStems: Readonly<Record<string, string>>;
+    /** A registry-key prefix (or a whole key) inside a string literal, and its replacement. */
+    readonly registryKeys: Readonly<Record<string, string>>;
+    /** Per import specifier: a name that means something different per entry. */
+    readonly entryTokens: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** A module specifier prefix and its replacement. */
+    readonly subpaths: Readonly<Record<string, string>>;
+    /**
+     * A package that was renamed. Rewritten in specifiers by `rewriteNames`
+     * and in `package.json` dependency fields by `rewriteManifest` — both,
+     * because an import a manifest does not declare fails to resolve under
+     * pnpm's isolated `node_modules`.
+     */
+    readonly packages?: Readonly<Record<string, string>>;
+}
+interface RenameResult {
+    readonly text: string;
+    readonly rewritten: number;
+    /**
+     * Names the table knows only per entry, imported from somewhere the table
+     * does not cover. Reported rather than guessed: which registry the
+     * consumer meant is not in the text.
+     */
+    readonly ambiguous: readonly string[];
+}
+/**
+ * The specifier and the bound names of every `import { … } from '…'`.
+ *
+ * Read backwards from each `from`, one character at a time, instead of with
+ * one regular expression over the statement: `\{([^}]*)\}\s+from` and its
+ * siblings backtrack quadratically on a file full of `import {{`, and the
+ * file is a consumer's — whatever they wrote, this must finish.
+ */
+declare function namedImports(text: string): Array<{
+    names: string[];
+    specifier: string;
+}>;
+/** Applies the table to one file's text. Idempotent: a second run changes nothing. */
+declare function rewriteNames(text: string, table: RenameTable): RenameResult;
+/**
+ * Applies the package renames to a `package.json` text.
+ *
+ * Parsed and re-serialised rather than string-replaced, so a rename lands in a
+ * dependency field and nowhere else — not in `name`, not in a description.
+ * The file's indentation is kept; a consumer's formatter must not see a diff
+ * it did not cause. Returns the text unchanged when nothing applied.
+ */
+interface ManifestRewriteOptions {
+    /**
+     * The range the renamed dependency gets — `^<the version this CLI was
+     * released as>`. The old range cannot be carried over: a 0.x consumer
+     * declares `"@saasicat/types": "^0.27.0"`, and `@saasicat/core` has no
+     * 0.27 — the rename starts on the 1.0 line. The caller passes the CLI's
+     * own version because that IS the line the consumer is migrating to;
+     * the codemod ships with it.
+     */
+    readonly targetRange: string;
+}
+declare function rewriteManifest(text: string, table: RenameTable, options: ManifestRewriteOptions): RenameResult;
+
 interface PatchAppModuleOptions {
     /** Import specifier for the persistence bundle, or null when not generated. */
     persistenceImport: string | null;
@@ -1063,4 +1174,4 @@ declare class UserCommands extends CommandRunner {
     parsePassword(val: string): string;
 }
 
-export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type SchemaCheckReport, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, stripLineComment, structuralOnly, tablesAddressedBy };
+export { AUDIT_QUERY_PORT_TOKEN, AdminCommands, AdminManifestDoctorCheck, AdminMfaSetupCommand, AdminWhoamiCommand, type ApplyResult, AuditCommands, AuditTailCommand, AuditTailFlow, type AuditTailOptions, type BlockAttributeKind, type BlockAttributes, CLI_CONTEXT_CONFIG_TOKEN, CONSTRAINTS_MARKER, type CheckSeverity, type CliContextConfig, CliContextModule, type CliContextModuleOptions, CliContextService, CliError, type CliIdentity, type ConstraintsOutcome, type ConstraintsReport, DEFAULT_MANIFEST_CHECKS, DOCTOR_CHECKS_TOKEN, DiscoveryCommands, DiscoveryScanCommand, DiscoverySnapshotDoctorCheck, type DoctorCheck, type DoctorCheckResult, DoctorCommands, DoctorFlow, type DoctorReport, type EnableFkResult, type FieldMismatch, type FieldMismatchReason, type FieldSignature, type FkModelNames, type FkPointer, type InitOptions, type InitPlan, LIMIT_FILTER_IMPORTS, LIMIT_FILTER_PROVIDER, MANIFEST_ACCESS_PORT_TOKEN, MANIFEST_CHECKS_TOKEN, type ManifestCheck, ManifestCheckCommand, type ManifestCheckReport, type ManifestCheckResult, ManifestCliFlow, ManifestCommands, type ManifestDiff, ManifestDumpCommand, ManifestHashCommand, type ManifestRewriteOptions, ManifestValidateCommand, MfaSetupFlow, type MfaSetupOptions, type MfaSetupResult, type MissingBlockAttribute, type MissingEnumValue, type MissingField, type MoveTable, PLATFORM_DOCTOR_CHECK_PROVIDERS, type ParsedSchema, type PatchAppModuleOptions, type PatchOptionsFromPlan, type PatchResult, PlanCatalogDoctorCheck, type PlannedFile, type QuotaProviderFile, type QuotaSpec, type RenameResult, type RenameTable, type RewriteResult, type SchemaCheckReport, UI_VUE_SPECIFIER, USER_MANAGEMENT_PORT_TOKEN, USER_PORT_TOKEN, UserCommands, UserPortDoctorCheck, WhoAmIFlow, type WhoAmIResult, appendConstraints, applyFragmentBlocks, applyTokens, assertModelsExist, assertValidProjectKey, assertValidQuotaKey, blankStringLiterals, blockBodyLines, breaksContract, buildImportMap, checkSchema, constraintsFor, enableFkPointers, extractBlockNames, extractBlocks, extractModelBlocks, extractModelNames, findFkPointers, foreignKeyOf, hasBackRelation, hasConstraints, isNoLongerPublic, isOneToOne, kebabCase, migrationCreatedBy, minimumQuotasPerPlan, namedImports, parseBlockAttributes, parseEnumValues, parseFields, parseQuota, parseSchema, pascalCase, patchAppModule, patchOptionsFor, planInit, projectKeyPattern, quotaKeyPattern, relationNameOf, reportConstraints, rewriteImports, rewriteManifest, rewriteNames, rewriteSubpath, stripLineComment, structuralOnly, tablesAddressedBy };