@intelligo-dev/cli 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/commands/sync-messages.js

@@ -0,0 +1,88 @@
+/**
+ * Message files under `intelligo sync`: the registry's keys an app's
+ * copy lacks, the merge that keeps the app's values, and the other
+ * locales checked against the app's English copy.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Dotted paths of every leaf in `registry` that `app` lacks. */
+export function missingMessageKeys(registry, app, prefix = "") {
+    return Object.entries(registry).flatMap(([key, value]) => {
+        const at = prefix ? `${prefix}.${key}` : key;
+        if (!(key in app))
+            return [at];
+        const mine = app[key];
+        return isObject(value) && isObject(mine)
+            ? missingMessageKeys(value, mine, at)
+            : [];
+    });
+}
+/**
+ * The registry's messages with the app's copy laid over them: every key
+ * the registry has is present, every value the app set wins, and keys
+ * only the app has (its own nav entries, product copy) are kept.
+ */
+export function mergeMessages(registry, app) {
+    const out = {};
+    for (const [key, value] of Object.entries(registry)) {
+        const mine = app[key];
+        out[key] =
+            key in app
+                ? isObject(value) && isObject(mine)
+                    ? mergeMessages(value, mine)
+                    : mine
+                : value;
+    }
+    for (const [key, value] of Object.entries(app)) {
+        if (!(key in out))
+            out[key] = value;
+    }
+    return out;
+}
+export const isMessages = (target) => target.startsWith("messages/") && target.endsWith(".json");
+/** The locale the registry ships messages in. */
+const SOURCE_LOCALE = "en";
+/**
+ * The app's locales, from `locales: [...]` in i18n/routing.ts — the
+ * source locale alone when there is no such file or list.
+ */
+export function appLocales(appRoot) {
+    const file = path.join(appRoot, "i18n", "routing.ts");
+    if (!existsSync(file))
+        return [SOURCE_LOCALE];
+    const list = /\blocales\s*:\s*\[([^\]]*)\]/.exec(readFileSync(file, "utf8"));
+    const locales = [...(list?.[1] ?? "").matchAll(/["'`]([^"'`]+)["'`]/g)].map((m) => m[1]);
+    return locales.length > 0 ? locales : [SOURCE_LOCALE];
+}
+/**
+ * Every other locale's copy of the namespaces the registry ships,
+ * against the app's English file on disk — the merged copy, product
+ * keys included, which is what the other locales translate. A missing
+ * file lacks every key.
+ */
+export function localeEntries(appRoot, files) {
+    const others = appLocales(appRoot).filter((l) => l !== SOURCE_LOCALE);
+    if (others.length === 0)
+        return [];
+    const prefix = `messages/${SOURCE_LOCALE}/`;
+    const entries = [];
+    for (const { item, target } of files) {
+        if (!target.startsWith(prefix) || !target.endsWith(".json"))
+            continue;
+        const english = path.join(appRoot, target);
+        if (!existsSync(english))
+            continue;
+        const source = JSON.parse(readFileSync(english, "utf8"));
+        for (const locale of others) {
+            const rel = `messages/${locale}/${target.slice(prefix.length)}`;
+            const abs = path.join(appRoot, rel);
+            const missingKeys = missingMessageKeys(source, existsSync(abs) ? JSON.parse(readFileSync(abs, "utf8")) : {});
+            entries.push(missingKeys.length > 0
+                ? { item, path: rel, state: "locale-behind", missingKeys }
+                : { item, path: rel, state: "current" });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=sync-messages.js.map

package/dist/commands/sync-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-messages.js","sourceRoot":"","sources":["../../src/commands/sync-messages.ts"],"names":[],"mappings":"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"}

package/dist/commands/sync-scaffold.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Scaffold files a registry install replaces. `intelligo create`
+ * writes app/globals.css, the theme provider and lib/utils.ts; the
+ * design-system base and the items overwrite them, and the scaffold's
+ * record has to let go of them or `upgrade --check` reports them as
+ * the app's own edits forever.
+ */
+/** The `intelligo create` feature whose files an install may replace. */
+export declare const SCAFFOLD_FEATURE = "app-scaffold";
+/**
+ * The scaffold files an install has made the registry's: a file an
+ * installed item ships, the Tailwind stylesheet once the design-system
+ * base is in (it rewrites the tokens), or any scaffold file the install
+ * changed (shadcn's own `utils`, `sonner`). Seams stay the app's, and
+ * so do the files shadcn only extends. Left in the scaffold's record,
+ * each would read `customized` in `upgrade --check` forever.
+ */
+export declare function scaffoldHandover(input: {
+    scaffold: readonly string[];
+    changed: ReadonlySet<string>;
+    shipped: ReadonlySet<string>;
+    seams: Readonly<Record<string, string>>;
+    css: string | null;
+}): string[];
+/**
+ * The scaffold's recorded files as they are before an install, and
+ * afterwards the ones the install made the registry's.
+ */
+export declare function snapshotScaffold(appRoot: string): {
+    handedOver: (input: {
+        shipped: ReadonlySet<string>;
+        seams: Readonly<Record<string, string>>;
+        css: string | null;
+    }) => string[];
+};
+//# sourceMappingURL=sync-scaffold.d.ts.map

package/dist/commands/sync-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/sync-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAY/C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,GAAG,MAAM,EAAE,CAOX;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,UAAU,EAAE,CAAC,KAAK,EAAE;QAClB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACpB,KAAK,MAAM,EAAE,CAAC;CAChB,CAmBA"}

package/dist/commands/sync-scaffold.js

@@ -0,0 +1,53 @@
+/**
+ * Scaffold files a registry install replaces. `intelligo create`
+ * writes app/globals.css, the theme provider and lib/utils.ts; the
+ * design-system base and the items overwrite them, and the scaffold's
+ * record has to let go of them or `upgrade --check` reports them as
+ * the app's own edits forever.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { readManifest } from "../manifest.js";
+/** The `intelligo create` feature whose files an install may replace. */
+export const SCAFFOLD_FEATURE = "app-scaffold";
+/**
+ * Scaffold files the install extends in place rather than replaces:
+ * shadcn adds dependencies to package.json and style fields to
+ * components.json, and both stay the app's.
+ */
+const EDITED_IN_PLACE = new Set([
+    "package.json",
+    "components.json",
+]);
+/**
+ * The scaffold files an install has made the registry's: a file an
+ * installed item ships, the Tailwind stylesheet once the design-system
+ * base is in (it rewrites the tokens), or any scaffold file the install
+ * changed (shadcn's own `utils`, `sonner`). Seams stay the app's, and
+ * so do the files shadcn only extends. Left in the scaffold's record,
+ * each would read `customized` in `upgrade --check` forever.
+ */
+export function scaffoldHandover(input) {
+    return input.scaffold.filter((file) => !(file in input.seams) &&
+        !EDITED_IN_PLACE.has(file) &&
+        (input.shipped.has(file) || file === input.css || input.changed.has(file)));
+}
+function readIfExists(file) {
+    return existsSync(file) ? readFileSync(file, "utf8") : null;
+}
+/**
+ * The scaffold's recorded files as they are before an install, and
+ * afterwards the ones the install made the registry's.
+ */
+export function snapshotScaffold(appRoot) {
+    const scaffold = (readManifest(appRoot)?.features[SCAFFOLD_FEATURE]?.files ?? []).map((f) => f.path);
+    const before = new Map(scaffold.map((f) => [f, readIfExists(path.join(appRoot, f))]));
+    return {
+        handedOver: (input) => scaffoldHandover({
+            ...input,
+            scaffold,
+            changed: new Set(scaffold.filter((f) => readIfExists(path.join(appRoot, f)) !== before.get(f))),
+        }),
+    };
+}
+//# sourceMappingURL=sync-scaffold.js.map

package/dist/commands/sync-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scaffold.js","sourceRoot":"","sources":["../../src/commands/sync-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IACnD,cAAc;IACd,iBAAiB;CAClB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAMhC;IACC,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAC1B,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAO9C,MAAM,QAAQ,GAAG,CACf,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,IAAI,EAAE,CAC/D,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9D,CAAC;IACF,OAAO;QACL,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CACpB,gBAAgB,CAAC;YACf,GAAG,KAAK;YACR,QAAQ;YACR,OAAO,EAAE,IAAI,GAAG,CACd,QAAQ,CAAC,MAAM,CACb,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAC7D,CACF;SACF,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,109 @@
+/**
+ * `intelligo sync [items…] [--check] [--force]`
+ *
+ * Keeps an app's installed registry pages exactly what the framework
+ * ships. Installing stays the shadcn CLI's job — every item goes in with
+ * `shadcn add <item> --yes --overwrite` — and this command adds what
+ * shadcn cannot know:
+ *
+ * - the version: items come from the registry bundled with this CLI, so
+ *   they match the `@intelligo-dev/*` packages of the same release;
+ * - the order: an item that imports a sibling's files lands after it
+ *   (requires.json `items`);
+ * - the seams: files an item ships once for the deployment to own
+ *   (requires.json `seams`) are put back after the install, and message
+ *   files are merged key by key, the app's copy winning;
+ * - the record: intelligo.manifest.json keeps each installed file's
+ *   hash, so `--check` can tell a file edited by hand from one a newer
+ *   registry replaced. Scaffold files an install replaces (globals.css,
+ *   the theme provider) leave the `app-scaffold` record for this one,
+ *   so `upgrade --check` stops calling them customized.
+ *
+ * `--check` installs nothing and exits 1 when any installed file is
+ * missing, edited or behind the registry — the gate CI runs.
+ */
+import type { RegistryRequires } from "./doctor.js";
+export { appLocales, mergeMessages, missingMessageKeys, } from "./sync-messages.js";
+export { SCAFFOLD_FEATURE, scaffoldHandover } from "./sync-scaffold.js";
+/** The design-system base: no marker file, installed before any page. */
+export declare const BASE_ITEM = "intelligo";
+export type SyncFileState = 
+/** identical to the registry */
+"current"
+/** untouched since the last sync; the registry has a newer version */
+ | "outdated"
+/** changed by hand since it was installed */
+ | "edited"
+/** differs from the registry, and no sync ever recorded it */
+ | "differs"
+/** the registry ships it and the app does not have it */
+ | "missing"
+/** a seam: the app's own from the first install on */
+ | "seam"
+/** a message file that lacks keys the registry's has */
+ | "messages-behind"
+/** another locale's copy of a shipped namespace lacks keys the app's English has */
+ | "locale-behind";
+export type SyncEntry = {
+    item: string;
+    path: string;
+    state: SyncFileState;
+    /** For `messages-behind` / `locale-behind`: the dotted keys the copy lacks. */
+    missingKeys?: string[];
+};
+export type SyncReport = {
+    /** The framework version of the bundled registry. */
+    version: string;
+    /** The items checked, in install order (Intelligo components included). */
+    items: string[];
+    entries: SyncEntry[];
+};
+export type SyncSelection = {
+    ok: true;
+    items: string[];
+} | {
+    ok: false;
+    message: string;
+};
+export type SyncContext = {
+    appRoot: string;
+    registryDir: string;
+    requires: RegistryRequires & {
+        seams?: Record<string, string>;
+    };
+    frameworkVersion: string;
+};
+/**
+ * The items to sync: the ones named, else the ones the manifest
+ * recorded. With neither, nothing is guessed — a page at an item's
+ * marker path may be the product's own (a custom dashboard), and a sync
+ * would replace it — so the message lists what looks installed and asks
+ * for names.
+ */
+export declare function selectItems(names: readonly string[], context: SyncContext): SyncSelection;
+/** Blocks in requires.json order, the design-system base first. */
+export declare function installOrder(items: readonly string[], requires: RegistryRequires): string[];
+/** Compare the app against the bundled registry; writes nothing. */
+export declare function syncCheck(items: readonly string[], context: SyncContext): SyncReport;
+export declare function syncCheckExitCode(report: SyncReport): number;
+export declare function formatSyncReport(report: SyncReport): string;
+/** The package version the app resolves for `@intelligo-dev/core`, if any. */
+export declare function installedFrameworkVersion(appRoot: string): string | null;
+/**
+ * Record `names` as items this app keeps in sync before any is
+ * installed, so a bare `intelligo sync` installs them after an install
+ * that did not run or did not finish.
+ */
+export declare function recordItems(names: readonly string[], context: Pick<SyncContext, "appRoot" | "requires" | "frameworkVersion">): void;
+export type SyncApplyOptions = {
+    force?: boolean;
+    log?: (line: string) => void;
+};
+/**
+ * Install `items` from the bundled registry, keep the seams, merge the
+ * messages and record what was written. Refuses to overwrite a file
+ * edited by hand unless `force` — the edit belongs in a seam, and the
+ * refusal says which files.
+ */
+export declare function syncApply(names: readonly string[], context: SyncContext, options?: SyncApplyOptions): Promise<number>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"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"}