inai-react-components 1.2.1 → 1.4.1

package/dist/commands/add.d.ts

@@ -1,4 +1,4 @@
-import { type RegistryComponent } from "./status.js";
+import { type RegistryComponent, type ComponentsJsonFile } from "./status.js";
 export interface AddOptions {
     /** Overwrite existing files without prompting. */
     force?: boolean;
@@ -54,13 +54,10 @@ export declare function findInRegistry(registry: {
     templates: RegistryComponent[];
 }, name: string, prefix: string | null): RegistryComponent | null;
 /**
- * Determine the target directory for a component based on its type and aliases.
+ * Determine the target directory for a component based on its type and the
+ * project's aliases + layout from `components.json`.
  */
-export declare function getTargetDir(component: RegistryComponent, aliases: {
-    components: string;
-    blocks: string;
-    templates?: string;
-}): string;
+export declare function getTargetDir(component: RegistryComponent, componentsJson: ComponentsJsonFile): string;
 export declare function runAdd(componentSpec: string, rootDir: string, options?: AddOptions): Promise<AddResult>;
 export interface AddCommandOptions extends AddOptions {
     all?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAIvB,MAAM,aAAa,CAAC;AAmBrB,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAsCA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC1G,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,iBAAiB,GAAG,IAAI,CAc1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,CAgBR;AA0JD,wBAAsB,MAAM,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAmMpB;AAqCD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,UAAU,CAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqIf"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,kBAAkB,EAExB,MAAM,aAAa,CAAC;AAoBrB,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAsCA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC1G,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,iBAAiB,GAAG,IAAI,CAc1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAC5B,cAAc,EAAE,kBAAkB,GACjC,MAAM,CAiBR;AA4JD,wBAAsB,MAAM,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAmMpB;AAqCD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,UAAU,CAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqIf"}

package/dist/commands/add.js

@@ -10,6 +10,7 @@ import { saveSnapshot, sha256, } from "../utils/snapshot.js";
 import { fuzzySearchNames } from "../utils/fuzzy-search.js";
 import { normalizeThemeCss, getLocalTailwindCssTemplate, getLegacyTailwindCssTemplate, } from "./init.js";
 import { autoInstallDeps } from "../utils/auto-install.js";
+import { resolveLocalDir, getSourceRoot } from "../utils/paths.js";
 /**
  * Parse a component spec into its registry namespace, type prefix and name.
  *
@@ -75,24 +76,26 @@ export function findInRegistry(registry, name, prefix) {
     return allItems.find((c) => c.name === name) ?? null;
 }
 /**
- * Determine the target directory for a component based on its type and aliases.
+ * Determine the target directory for a component based on its type and the
+ * project's aliases + layout from `components.json`.
  */
-export function getTargetDir(component, aliases) {
+export function getTargetDir(component, componentsJson) {
+    const { aliases } = componentsJson;
     const type = component.type.toLowerCase();
     if (type === "block") {
-        return aliases.blocks.replace(/^@\//, "src/");
+        return resolveLocalDir(aliases.blocks, componentsJson);
     }
     if (type === "template") {
         if (aliases.templates) {
-            return aliases.templates.replace(/^@\//, "src/");
+            return resolveLocalDir(aliases.templates, componentsJson);
         }
         // Fallback: derive templates dir from blocks dir
-        const blocksDir = aliases.blocks.replace(/^@\//, "src/");
+        const blocksDir = resolveLocalDir(aliases.blocks, componentsJson);
         const parent = path.dirname(blocksDir);
         return path.join(parent, "templates");
     }
     // Components, forms, and other types go to the components directory
-    return aliases.components.replace(/^@\//, "src/");
+    return resolveLocalDir(aliases.components, componentsJson);
 }
 /**
  * Install a single component (no dep resolution). Internal helper used by
@@ -101,7 +104,7 @@ export function getTargetDir(component, aliases) {
  */
 async function installOne(component, registry, componentsJson, registryDir, rootDir, options) {
     const name = component.name;
-    const baseTargetDir = getTargetDir(component, componentsJson.aliases);
+    const baseTargetDir = getTargetDir(component, componentsJson);
     const isMultiFile = component.type === "block" || component.type === "template";
     const targetDir = isMultiFile ? path.join(baseTargetDir, name) : baseTargetDir;
     const copiedFiles = [];
@@ -157,12 +160,14 @@ async function installOne(component, registry, componentsJson, registryDir, root
         }
         copiedFiles.push(isMultiFile ? `${name}/${fileName}` : fileName);
     }
-    // Internal deps (lib/cn, lib/animations, ...)
+    // Internal deps (lib/cn, lib/animations, ...) — installed under the
+    // project's detected sourceRoot so they match where `init` placed cn.ts.
+    const sourceRoot = getSourceRoot(componentsJson);
     const copiedInternalDeps = [];
     for (const dep of component.internalDeps) {
         const depFileName = dep.split("/").pop() + ".ts";
         const depSourcePath = path.join(registryDir, "packages", "ui", "src", dep + ".ts");
-        const depTargetPath = path.join(rootDir, "src", "lib", depFileName);
+        const depTargetPath = path.join(rootDir, sourceRoot, "lib", depFileName);
         if (!fs.existsSync(depSourcePath)) {
             continue;
         }
@@ -572,10 +577,14 @@ async function changeTheme(rootDir, registryDir) {
     try {
         const tokensSrc = path.join(registryDir, "packages", "tokens", "src");
         const isRemote = !!componentsJson.registrySource;
+        const sourceRoot = getSourceRoot(componentsJson);
+        const cssRelPath = componentsJson.tailwind?.css ?? `${sourceRoot}/index.css`;
+        const cssPath = path.join(rootDir, cssRelPath);
+        const themesRelPath = `${sourceRoot}/styles/tokens/themes`;
         if (isRemote) {
             // Remote mode: copy and normalize theme file
             const themesSrc = path.join(tokensSrc, "themes");
-            const themesDest = path.join(rootDir, "src", "styles", "tokens", "themes");
+            const themesDest = path.join(rootDir, sourceRoot, "styles", "tokens", "themes");
             // Remove old theme file
             const oldThemeFile = path.join(themesDest, `${currentTheme}.css`);
             if (fs.existsSync(oldThemeFile)) {
@@ -589,17 +598,17 @@ async function changeTheme(rootDir, registryDir) {
                 const normalizedCss = normalizeThemeCss(rawCss, newTheme);
                 fs.writeFileSync(path.join(themesDest, `${newTheme}.css`), normalizedCss);
             }
-            // Regenerate index.css
+            // Regenerate CSS entry
             const font = componentsJson.font ?? { body: "outfit", heading: "outfit" };
             const radius = componentsJson.radius ?? 0.5;
-            const cssPath = path.join(rootDir, "src", "index.css");
+            fs.mkdirSync(path.dirname(cssPath), { recursive: true });
             fs.writeFileSync(cssPath, getLocalTailwindCssTemplate(newTheme, font.body, font.heading, radius));
         }
         else {
-            // Local mode: just regenerate index.css with new import
+            // Local mode: just regenerate CSS entry with new import
             const font = componentsJson.font ?? { body: "outfit", heading: "outfit" };
             const radius = componentsJson.radius ?? 0.5;
-            const cssPath = path.join(rootDir, "src", "index.css");
+            fs.mkdirSync(path.dirname(cssPath), { recursive: true });
             fs.writeFileSync(cssPath, getLegacyTailwindCssTemplate(newTheme, font.body, font.heading, radius));
         }
         // Update components.json
@@ -610,9 +619,9 @@ async function changeTheme(rootDir, registryDir) {
         spinner.succeed(`Theme switched to "${newTheme}"`);
         console.log(chalk.green("\nUpdated files:"));
         console.log(chalk.dim("  - components.json"));
-        console.log(chalk.dim("  - src/index.css"));
+        console.log(chalk.dim(`  - ${cssRelPath}`));
         if (componentsJson.registrySource) {
-            console.log(chalk.dim(`  - src/styles/tokens/themes/${newTheme}.css`));
+            console.log(chalk.dim(`  - ${themesRelPath}/${newTheme}.css`));
         }
     }
     catch (error) {
@@ -641,34 +650,53 @@ async function installAll(options) {
         ...registry.templates,
     ];
     console.log(chalk.bold(`\nInstalling all ${allItems.length} components, blocks, and templates...\n`));
-    const installed = componentsJson.installedComponents ?? [];
-    const installedNames = new Set(installed.map((c) => c.name));
+    // Track what's been installed across the loop. Because `runAdd` resolves
+    // transitive dependencies (e.g. `alert` pulls in `button`), a component
+    // scheduled later in the iteration may already be on disk by the time we
+    // reach it. We refresh this set from `components.json` after every
+    // `runAdd` call so `isInstalled` stays accurate across the bulk install.
+    const installedNames = new Set((componentsJson.installedComponents ?? []).map((c) => c.name));
     const allNpmDeps = new Set();
     let addedCount = 0;
-    let updatedCount = 0;
+    let skippedCount = 0;
     for (const item of allItems) {
-        const isInstalled = installedNames.has(item.name);
-        const action = isInstalled ? "Updating" : "Adding";
+        // Skip components that were already installed by a previous iteration
+        // as a transitive dep — avoids redundant file writes and prevents the
+        // overwrite prompt from hanging the bulk install.
+        if (installedNames.has(item.name)) {
+            skippedCount++;
+            continue;
+        }
         const prefix = item.type === "block" ? "block/" : item.type === "template" ? "template/" : "";
-        const spinner = ora(`${action} "${prefix}${item.name}"...`).start();
+        const spinner = ora(`Adding "${prefix}${item.name}"...`).start();
         try {
             const spec = prefix ? `${prefix}${item.name}` : item.name;
+            // Pause the spinner defensively — any stray `prompts()` call inside
+            // `runAdd` would otherwise deadlock because ora holds stdout while
+            // the prompt reads stdin.
+            spinner.stop();
             const result = await runAdd(spec, rootDir, {
+                // During a bulk install, default to skipping files that already
+                // exist (from transitive deps or user edits) instead of prompting
+                // for overwrite. `--force` still overrides this if the user wants
+                // to refresh everything.
                 force: options?.force,
                 dryRun: options?.dryRun,
-                skipExisting: options?.skipExisting,
+                skipExisting: options?.skipExisting ?? !options?.force,
             });
             if (!result.added) {
                 spinner.fail(result.message);
                 continue;
             }
-            if (isInstalled) {
-                spinner.succeed(`Updated "${prefix}${item.name}"`);
-                updatedCount++;
-            }
-            else {
-                spinner.succeed(`Added "${prefix}${item.name}"`);
-                addedCount++;
+            spinner.succeed(`Added "${prefix}${item.name}"`);
+            addedCount++;
+            // Refresh the installed-names cache so the next iteration sees any
+            // transitive deps just installed by `runAdd`.
+            const freshJson = readComponentsJson(rootDir);
+            if (freshJson?.installedComponents) {
+                for (const entry of freshJson.installedComponents) {
+                    installedNames.add(entry.name);
+                }
             }
             for (const dep of result.npmDeps) {
                 allNpmDeps.add(dep);
@@ -685,8 +713,8 @@ async function installAll(options) {
     if (addedCount > 0) {
         console.log(chalk.green(`  ${addedCount} component${addedCount > 1 ? "s" : ""} added`));
     }
-    if (updatedCount > 0) {
-        console.log(chalk.blue(`  ${updatedCount} component${updatedCount > 1 ? "s" : ""} updated`));
+    if (skippedCount > 0) {
+        console.log(chalk.dim(`  ${skippedCount} component${skippedCount > 1 ? "s" : ""} skipped (already installed as dependency)`));
     }
     if (allNpmDeps.size > 0) {
         console.log(chalk.yellow("\nInstall required npm dependencies:"));

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

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAC;AAKrB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAqEjF;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,iBAAiB,GAAG,IAAI,CAW1B;AA+BD,wBAAsB,OAAO,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAgEjB;AAED,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAC;AAMrB;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAqEjF;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,iBAAiB,GAAG,IAAI,CAW1B;AA6BD,wBAAsB,OAAO,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAgEjB;AAED,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE"}

package/dist/commands/diff.js

@@ -5,6 +5,7 @@ import ora from "ora";
 import { diffLines } from "diff";
 import { readComponentsJson, readRegistryJson, } from "./status.js";
 import { resolveRegistryDir } from "../utils/registry-resolver.js";
+import { resolveLocalDir } from "../utils/paths.js";
 const CONTEXT_LINES = 2;
 /**
  * Render a unified-style colored diff between two strings using a real
@@ -96,21 +97,18 @@ export function findComponentInRegistry(registryPath, componentName) {
 function getLocalAliasDir(component, componentsJson) {
     const type = component.type.toLowerCase();
     if (type === "block") {
-        return componentsJson.aliases.blocks.replace(/^@\//, "src/");
+        return resolveLocalDir(componentsJson.aliases.blocks, componentsJson);
     }
     if (type === "template") {
-        // ComponentsJsonFile doesn't officially type `aliases.templates`, but
-        // it may be present in user config — fall back to blocks/templates.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const templatesAlias = componentsJson.aliases.templates;
         if (templatesAlias) {
-            return templatesAlias.replace(/^@\//, "src/");
+            return resolveLocalDir(templatesAlias, componentsJson);
         }
-        const blocksDir = componentsJson.aliases.blocks.replace(/^@\//, "src/");
+        const blocksDir = resolveLocalDir(componentsJson.aliases.blocks, componentsJson);
         const parent = path.dirname(blocksDir);
         return path.join(parent, "templates");
     }
-    return componentsJson.aliases.components.replace(/^@\//, "src/");
+    return resolveLocalDir(componentsJson.aliases.components, componentsJson);
 }
 export async function runDiff(componentName, rootDir) {
     const componentsJson = readComponentsJson(rootDir);

package/dist/commands/init.d.ts

@@ -1,4 +1,5 @@
 import { type Framework } from "../utils/framework-detect.js";
+import { type ProjectLayout } from "../utils/tsconfig-detect.js";
 type Theme = string;
 declare const FONT_PRESETS: readonly [{
     readonly name: "outfit";
@@ -221,20 +222,21 @@ export interface InitConfig {
     fontBody: FontPreset;
     fontHeading: FontPreset;
     radius: number;
-    importAlias: string;
-    utilsAlias: string;
     tanstackRouter: boolean;
     tanstackQuery: boolean;
     tanstackForm: boolean;
     tanstackTable: boolean;
     framework?: Framework;
     cssEntryPoint?: string;
+    /** Detected project layout — drives file destinations in `runInit`. */
+    layout?: ProjectLayout;
 }
 export interface ComponentsJson {
     $schema: string;
     registrySource?: string;
     style: string;
     framework?: Framework;
+    layout?: ProjectLayout;
     tailwind: {
         config: string;
         css: string;
@@ -257,7 +259,7 @@ export interface ComponentsJson {
         table: boolean;
     };
 }
-export declare function promptInitConfig(registryDir?: string, framework?: Framework): Promise<InitConfig | null>;
+export declare function promptInitConfig(registryDir?: string, framework?: Framework, layout?: ProjectLayout): Promise<InitConfig | null>;
 export declare function buildComponentsJson(config: InitConfig, repoUrl?: string): ComponentsJson;
 export declare function getCnTemplate(): string;
 export declare function getLocalTailwindCssTemplate(theme: Theme, fontBody: FontPreset, fontHeading: FontPreset, radius: number): string;
@@ -269,6 +271,13 @@ export declare function getLegacyTailwindCssTemplate(theme: Theme, fontBody: Fon
  * `data-theme` attribute on the HTML element.
  */
 export declare function normalizeThemeCss(css: string, theme: string): string;
+/**
+ * Copies the i18n base files (context, types, defaults) from the registry
+ * to the project's <sourceRoot>/lib/. Required because ~75 components import
+ * `useUIMessages` from `./lib/i18n-context.js` — without these files, every
+ * subsequent `add` of an i18n-aware component would produce a broken import.
+ */
+export declare function copyI18nFiles(registryDir: string | undefined, targetDir: string, sourceRoot: string): string[];
 export declare function runInit(config: InitConfig, targetDir: string, repoUrl?: string): Promise<{
     success: boolean;
     filesCreated: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAGrC,KAAK,KAAK,GAAG,MAAM,CAAC;AAEpB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DR,CAAC;AACX,KAAK,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAUxD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU,CAAC;QACjB,OAAO,EAAE,UAAU,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAgBD,wBAAsB,gBAAgB,CACpC,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,SAAS,EACrB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA0F5B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAwChB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAQtC;AAOD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAc/H;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAahI;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBpE;AA0FD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAeV;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqEvD;AAED,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EjE"}

package/dist/commands/init.js

@@ -6,6 +6,7 @@ import prompts from "prompts";
 import { cloneRegistry, getCacheDir } from "../utils/registry-resolver.js";
 import { THEME_NAMES } from "../utils/themes.js";
 import { detectFramework, frameworkLabel, getCssEntryPoint, } from "../utils/framework-detect.js";
+import { detectProjectLayout, } from "../utils/tsconfig-detect.js";
 const AVAILABLE_THEMES = THEME_NAMES;
 const FONT_PRESETS = [
     // Sans-serif — geometric & modern
@@ -88,23 +89,24 @@ function discoverThemes(registryDir) {
     }
     return [...AVAILABLE_THEMES];
 }
-export async function promptInitConfig(registryDir, framework) {
+export async function promptInitConfig(registryDir, framework, layout) {
     const themes = discoverThemes(registryDir);
+    const sourceRoot = layout?.sourceRoot ?? "src";
     const defaultCssEntry = framework
-        ? getCssEntryPoint(framework)
-        : "src/index.css";
+        ? getCssEntryPoint(framework, sourceRoot)
+        : `${sourceRoot}/index.css`;
     const response = await prompts([
         {
             type: "text",
             name: "componentPath",
             message: "Where would you like to install components?",
-            initial: "src/components/ui",
+            initial: `${sourceRoot}/components/ui`,
         },
         {
             type: "text",
             name: "blockPath",
             message: "Where would you like to install blocks?",
-            initial: "src/components/blocks",
+            initial: `${sourceRoot}/components/blocks`,
         },
         {
             type: "select",
@@ -134,18 +136,6 @@ export async function promptInitConfig(registryDir, framework) {
             choices: RADIUS_OPTIONS.map((r) => ({ title: r.label, value: r.value })),
             initial: 2,
         },
-        {
-            type: "text",
-            name: "importAlias",
-            message: "Configure the import alias for components:",
-            initial: "@/components/ui",
-        },
-        {
-            type: "text",
-            name: "utilsAlias",
-            message: "Configure the import alias for utils:",
-            initial: "@/lib/utils",
-        },
         {
             type: "confirm",
             name: "tanstackRouter",
@@ -181,23 +171,28 @@ export async function promptInitConfig(registryDir, framework) {
     const config = response;
     config.framework = framework;
     config.cssEntryPoint = defaultCssEntry;
+    config.layout = layout;
     return config;
 }
 export function buildComponentsJson(config, repoUrl) {
+    const layout = config.layout ?? {
+        sourceRoot: "src",
+        aliasPrefix: "@/",
+    };
+    const utilsAlias = `${layout.aliasPrefix}lib/utils`;
     const json = {
         $schema: "https://inai-ui.dev/schema.json",
         style: "default",
         framework: config.framework,
+        layout,
         tailwind: {
             config: "tailwind.config.ts",
-            css: config.cssEntryPoint ?? "src/index.css",
+            css: config.cssEntryPoint ?? `${layout.sourceRoot}/index.css`,
         },
         aliases: {
-            components: config.importAlias,
-            blocks: config.blockPath.startsWith("src/")
-                ? `@/${config.blockPath.slice(4)}`
-                : config.blockPath,
-            utils: config.utilsAlias,
+            components: config.componentPath,
+            blocks: config.blockPath,
+            utils: utilsAlias,
         },
         theme: config.theme,
         font: {
@@ -295,9 +290,10 @@ function copyDirRecursive(src, dest) {
     }
     return copied;
 }
-function copyTokensToProject(registryDir, targetDir, theme) {
+function copyTokensToProject(registryDir, targetDir, theme, sourceRoot) {
     const tokensSrc = path.join(registryDir, "packages", "tokens", "src");
-    const tokensDest = path.join(targetDir, "src", "styles", "tokens");
+    const tokensDest = path.join(targetDir, sourceRoot, "styles", "tokens");
+    const tokensRelBase = `${sourceRoot}/styles/tokens`;
     const copied = [];
     if (!fs.existsSync(tokensSrc))
         return copied;
@@ -307,7 +303,7 @@ function copyTokensToProject(registryDir, targetDir, theme) {
         const src = path.join(tokensSrc, file);
         if (fs.existsSync(src)) {
             fs.copyFileSync(src, path.join(tokensDest, file));
-            copied.push(`src/styles/tokens/${file}`);
+            copied.push(`${tokensRelBase}/${file}`);
         }
     }
     // Copy primitives (color scales referenced by all themes)
@@ -331,7 +327,7 @@ function copyTokensToProject(registryDir, targetDir, theme) {
             const rawCss = fs.readFileSync(themeSrc, "utf-8");
             const normalizedCss = normalizeThemeCss(rawCss, theme);
             fs.writeFileSync(path.join(themesDest, themeFile), normalizedCss);
-            copied.push(`src/styles/tokens/themes/${themeFile}`);
+            copied.push(`${tokensRelBase}/themes/${themeFile}`);
         }
     }
     // Copy presets
@@ -343,14 +339,38 @@ function copyTokensToProject(registryDir, targetDir, theme) {
             const src = path.join(presetsSrc, file);
             if (fs.existsSync(src)) {
                 fs.copyFileSync(src, path.join(presetsDest, file));
-                copied.push(`src/styles/tokens/presets/${file}`);
+                copied.push(`${tokensRelBase}/presets/${file}`);
             }
         }
     }
     return copied;
 }
+/**
+ * Copies the i18n base files (context, types, defaults) from the registry
+ * to the project's <sourceRoot>/lib/. Required because ~75 components import
+ * `useUIMessages` from `./lib/i18n-context.js` — without these files, every
+ * subsequent `add` of an i18n-aware component would produce a broken import.
+ */
+export function copyI18nFiles(registryDir, targetDir, sourceRoot) {
+    if (!registryDir)
+        return [];
+    const files = ["i18n-context.tsx", "i18n-types.ts", "i18n-defaults.ts"];
+    const srcBase = path.join(registryDir, "packages", "ui", "src", "lib");
+    const destBase = path.join(targetDir, sourceRoot, "lib");
+    fs.mkdirSync(destBase, { recursive: true });
+    const copied = [];
+    for (const file of files) {
+        const src = path.join(srcBase, file);
+        if (!fs.existsSync(src))
+            continue;
+        fs.copyFileSync(src, path.join(destBase, file));
+        copied.push(`${sourceRoot}/lib/${file}`);
+    }
+    return copied;
+}
 export async function runInit(config, targetDir, repoUrl) {
     const filesCreated = [];
+    const sourceRoot = config.layout?.sourceRoot ?? "src";
     // 1. Create components.json
     const componentsJsonPath = path.join(targetDir, "components.json");
     const componentsJson = buildComponentsJson(config, repoUrl);
@@ -361,21 +381,24 @@ export async function runInit(config, targetDir, repoUrl) {
     fs.mkdirSync(componentDir, { recursive: true });
     const blockDir = path.join(targetDir, config.blockPath);
     fs.mkdirSync(blockDir, { recursive: true });
-    // 3. Create cn.ts utility
-    const utilsDir = path.join(targetDir, "src", "lib");
+    // 3. Create cn.ts utility under the detected source root
+    const utilsDir = path.join(targetDir, sourceRoot, "lib");
     fs.mkdirSync(utilsDir, { recursive: true });
     const cnPath = path.join(utilsDir, "cn.ts");
     fs.writeFileSync(cnPath, getCnTemplate());
-    filesCreated.push("src/lib/cn.ts");
+    filesCreated.push(`${sourceRoot}/lib/cn.ts`);
     // 4. Copy tokens and create CSS
-    const cssRelPath = config.cssEntryPoint ?? "src/index.css";
+    const cssRelPath = config.cssEntryPoint ?? `${sourceRoot}/index.css`;
     const cssPath = path.join(targetDir, cssRelPath);
     fs.mkdirSync(path.dirname(cssPath), { recursive: true });
     if (repoUrl) {
         // Remote mode: copy tokens from cached registry
         const registryDir = getCacheDir();
-        const tokenFiles = copyTokensToProject(registryDir, targetDir, config.theme);
+        const tokenFiles = copyTokensToProject(registryDir, targetDir, config.theme, sourceRoot);
         filesCreated.push(...tokenFiles);
+        // Copy i18n base files so components importing useUIMessages resolve
+        const i18nFiles = copyI18nFiles(registryDir, targetDir, sourceRoot);
+        filesCreated.push(...i18nFiles);
         fs.writeFileSync(cssPath, getLocalTailwindCssTemplate(config.theme, config.fontBody, config.fontHeading, config.radius));
     }
     else {
@@ -387,8 +410,11 @@ export async function runInit(config, targetDir, repoUrl) {
 }
 export async function initCommand(repoUrl) {
     console.log(chalk.bold("\nInAI UI - Project Initialization\n"));
-    const detectedFramework = detectFramework(process.cwd());
+    const cwd = process.cwd();
+    const detectedFramework = detectFramework(cwd);
+    const detectedLayout = detectProjectLayout(cwd);
     console.log(chalk.dim(`Detected framework: ${frameworkLabel(detectedFramework)}`));
+    console.log(chalk.dim(`Detected layout:    ${detectedLayout.sourceRoot}/ with alias ${detectedLayout.aliasPrefix}`));
     if (repoUrl) {
         const spinner = ora("Cloning component registry...").start();
         try {
@@ -404,7 +430,7 @@ export async function initCommand(repoUrl) {
         }
     }
     const registryDir = repoUrl ? getCacheDir() : undefined;
-    const config = await promptInitConfig(registryDir, detectedFramework);
+    const config = await promptInitConfig(registryDir, detectedFramework, detectedLayout);
     if (!config) {
         console.log(chalk.yellow("\nInitialization cancelled."));
         process.exit(0);

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

@@ -1 +1 @@
-{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAgCD,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAgIvB;AAED,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAgCD,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAgIvB;AAED,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/commands/remove.js

@@ -6,6 +6,7 @@ import prompts from "prompts";
 import { readComponentsJson, readRegistryJson, } from "./status.js";
 import { resolveRegistryDir } from "../utils/registry-resolver.js";
 import { deleteSnapshot } from "../utils/snapshot.js";
+import { resolveLocalDir } from "../utils/paths.js";
 /**
  * Find components that depend on the given component name via
  * `registryDependencies`.
@@ -94,19 +95,19 @@ export async function runRemove(componentName, rootDir, options = {}) {
         const aliases = componentsJson.aliases;
         let baseTargetDir;
         if (type === "block") {
-            baseTargetDir = aliases.blocks.replace(/^@\//, "src/");
+            baseTargetDir = resolveLocalDir(aliases.blocks, componentsJson);
         }
         else if (type === "template") {
             if (aliases.templates) {
-                baseTargetDir = aliases.templates.replace(/^@\//, "src/");
+                baseTargetDir = resolveLocalDir(aliases.templates, componentsJson);
             }
             else {
-                const blocksDir = aliases.blocks.replace(/^@\//, "src/");
+                const blocksDir = resolveLocalDir(aliases.blocks, componentsJson);
                 baseTargetDir = path.join(path.dirname(blocksDir), "templates");
             }
         }
         else {
-            baseTargetDir = aliases.components.replace(/^@\//, "src/");
+            baseTargetDir = resolveLocalDir(aliases.components, componentsJson);
         }
         if (isMultiFile) {
             // Delete the entire component directory

package/dist/commands/status.d.ts

@@ -1,6 +1,13 @@
+import type { Framework } from "../utils/framework-detect.js";
 export interface ComponentsJsonFile {
     $schema: string;
     style: string;
+    framework?: Framework;
+    registrySource?: string;
+    layout?: {
+        sourceRoot: string;
+        aliasPrefix: string;
+    };
     tailwind: {
         config: string;
         css: string;
@@ -8,9 +15,9 @@ export interface ComponentsJsonFile {
     aliases: {
         components: string;
         blocks: string;
+        templates?: string;
         utils: string;
     };
-    registrySource?: string;
     theme: string;
     font?: {
         body: string;

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

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

package/dist/commands/status.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import chalk from "chalk";
 import ora from "ora";
 import { loadSnapshot, sha256 } from "../utils/snapshot.js";
+import { resolveLocalDir } from "../utils/paths.js";
 export function readComponentsJson(rootDir) {
     const filePath = path.join(rootDir, "components.json");
     if (!fs.existsSync(filePath)) {
@@ -41,8 +42,8 @@ function padRight(str, len) {
 export function inspectStatus(rootDir, componentsJson, registry) {
     const installed = componentsJson.installedComponents ?? [];
     const registryVersion = registry?.version ?? "unknown";
-    const localComponentDir = componentsJson.aliases.components.replace(/^@\//, "src/");
-    const localBlocksDir = componentsJson.aliases.blocks.replace(/^@\//, "src/");
+    const localComponentDir = resolveLocalDir(componentsJson.aliases.components, componentsJson);
+    const localBlocksDir = resolveLocalDir(componentsJson.aliases.blocks, componentsJson);
     const allRegistryItems = registry
         ? [...registry.components, ...registry.blocks, ...registry.templates]
         : [];

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,YAAY,CA4Cd;AAED,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,UAAQ,GAClB,OAAO,CAAC,YAAY,CAAC,CA+MvB;AAED,wBAAsB,aAAa,CACjC,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiDf"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,YAAY,CA4Cd;AAED,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,UAAQ,GAClB,OAAO,CAAC,YAAY,CAAC,CA+MvB;AAED,wBAAsB,aAAa,CACjC,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/commands/update.js

@@ -7,6 +7,7 @@ import diff3Merge from "diff3";
 import { readComponentsJson, readRegistryJson, } from "./status.js";
 import { findComponentInRegistry, computeDiff } from "./diff.js";
 import { resolveRegistryDir } from "../utils/registry-resolver.js";
+import { resolveLocalDir } from "../utils/paths.js";
 import { loadSnapshot, saveSnapshot, sha256, } from "../utils/snapshot.js";
 /**
  * Run a 3-way line merge between base (snapshot), mine (local) and theirs
@@ -73,7 +74,7 @@ export async function runUpdate(componentName, rootDir, skipPrompts = false) {
     }
     const registry = readRegistryJson(registryPath);
     const registryVersion = registry?.version ?? "unknown";
-    const localComponentDir = componentsJson.aliases.components.replace(/^@\//, "src/");
+    const localComponentDir = resolveLocalDir(componentsJson.aliases.components, componentsJson);
     const updatedFiles = [];
     const cleanMerges = [];
     const conflictedFiles = [];

package/dist/index.js

@@ -17,7 +17,7 @@ const program = new Command();
 program
     .name("inai-ui")
     .description("CLI for InAI UI component library")
-    .version("1.2.1");
+    .version("1.4.1");
 program
     .command("init [repo-url]")
     .description("Initialize InAI UI in your project. Optionally pass a Git repo URL to fetch components remotely.")

package/dist/utils/framework-detect.d.ts

@@ -6,10 +6,15 @@ export type Framework = "next-app" | "next-pages" | "vite" | "remix" | "astro" |
  */
 export declare function detectFramework(cwd: string): Framework;
 /**
- * Default CSS entry point for a given framework. Used by `inai-ui init`
- * to pre-populate the prompt that asks where tailwind/tokens should be
- * imported.
+ * Default CSS entry point for a given framework, relative to the project
+ * root. `sourceRoot` is the project's source directory (usually "src" or
+ * "app") as detected from `tsconfig.json`. Paths are derived from it so
+ * projects that use `app/` instead of `src/` get correct defaults without
+ * manual overrides.
+ *
+ * Next.js Pages Router and Next.js App Router are special: their CSS
+ * entry point is dictated by the framework, not the user's source root.
  */
-export declare function getCssEntryPoint(framework: Framework): string;
+export declare function getCssEntryPoint(framework: Framework, sourceRoot: string): string;
 export declare function frameworkLabel(framework: Framework): string;
 //# sourceMappingURL=framework-detect.d.ts.map

package/dist/utils/framework-detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-detect.d.ts","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,YAAY,GACZ,MAAM,GACN,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,SAAS,CAAC;AAEd;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAkDtD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAiB7D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAiB3D"}
+{"version":3,"file":"framework-detect.d.ts","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,YAAY,GACZ,MAAM,GACN,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,SAAS,CAAC;AAEd;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAkDtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAmBjF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAiB3D"}

package/dist/utils/framework-detect.js

@@ -48,26 +48,33 @@ export function detectFramework(cwd) {
     return "unknown";
 }
 /**
- * Default CSS entry point for a given framework. Used by `inai-ui init`
- * to pre-populate the prompt that asks where tailwind/tokens should be
- * imported.
+ * Default CSS entry point for a given framework, relative to the project
+ * root. `sourceRoot` is the project's source directory (usually "src" or
+ * "app") as detected from `tsconfig.json`. Paths are derived from it so
+ * projects that use `app/` instead of `src/` get correct defaults without
+ * manual overrides.
+ *
+ * Next.js Pages Router and Next.js App Router are special: their CSS
+ * entry point is dictated by the framework, not the user's source root.
  */
-export function getCssEntryPoint(framework) {
+export function getCssEntryPoint(framework, sourceRoot) {
     switch (framework) {
         case "next-app":
+            // Next App Router always uses `app/globals.css` regardless of sourceRoot.
             return "app/globals.css";
         case "next-pages":
+            // Next Pages Router uses top-level `styles/globals.css`.
             return "styles/globals.css";
         case "vite":
-            return "src/index.css";
+            return `${sourceRoot}/index.css`;
         case "remix":
-            return "app/styles/globals.css";
+            return `${sourceRoot}/styles/globals.css`;
         case "astro":
-            return "src/styles/globals.css";
+            return `${sourceRoot}/styles/globals.css`;
         case "tanstack-start":
-            return "src/styles/app.css";
+            return `${sourceRoot}/styles/app.css`;
         default:
-            return "src/index.css";
+            return `${sourceRoot}/index.css`;
     }
 }
 export function frameworkLabel(framework) {

package/dist/utils/paths.d.ts

@@ -0,0 +1,26 @@
+import type { ComponentsJsonFile } from "../commands/status.js";
+/**
+ * Resolve an alias stored in `components.json` (e.g. "@/components/ui" or
+ * "app/components/ui") to an actual directory relative to the project root.
+ *
+ * Rules:
+ * 1. If the value starts with a known alias prefix (`@/`, `~/`, `$/`),
+ *    substitute it with `layout.sourceRoot` from `components.json`.
+ *    This preserves backwards compatibility with legacy configs that
+ *    stored `@/...` aliases and assumed `src/` as the source root.
+ * 2. If the value does not start with a known prefix, it's already a
+ *    filesystem-relative path and is returned unchanged. This is the
+ *    preferred format going forward — `init` now writes raw paths.
+ *
+ * When `layout` is missing (pre-1.3.0 `components.json` files), the
+ * fallback is `sourceRoot = "src"`, which matches the hardcoded behaviour
+ * the CLI shipped with before this refactor.
+ */
+export declare function resolveLocalDir(alias: string, componentsJson: Pick<ComponentsJsonFile, "layout">): string;
+/**
+ * Get the source root directory to use for project-level files like
+ * `lib/cn.ts` and `styles/tokens/`. Falls back to `"src"` for legacy
+ * `components.json` files without a `layout` field.
+ */
+export declare function getSourceRoot(componentsJson: Pick<ComponentsJsonFile, "layout">): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GACjD,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GACjD,MAAM,CAER"}

package/dist/utils/paths.js

@@ -0,0 +1,35 @@
+const KNOWN_PREFIXES = ["@/", "~/", "$/"];
+/**
+ * Resolve an alias stored in `components.json` (e.g. "@/components/ui" or
+ * "app/components/ui") to an actual directory relative to the project root.
+ *
+ * Rules:
+ * 1. If the value starts with a known alias prefix (`@/`, `~/`, `$/`),
+ *    substitute it with `layout.sourceRoot` from `components.json`.
+ *    This preserves backwards compatibility with legacy configs that
+ *    stored `@/...` aliases and assumed `src/` as the source root.
+ * 2. If the value does not start with a known prefix, it's already a
+ *    filesystem-relative path and is returned unchanged. This is the
+ *    preferred format going forward — `init` now writes raw paths.
+ *
+ * When `layout` is missing (pre-1.3.0 `components.json` files), the
+ * fallback is `sourceRoot = "src"`, which matches the hardcoded behaviour
+ * the CLI shipped with before this refactor.
+ */
+export function resolveLocalDir(alias, componentsJson) {
+    for (const prefix of KNOWN_PREFIXES) {
+        if (alias.startsWith(prefix)) {
+            const sourceRoot = componentsJson.layout?.sourceRoot ?? "src";
+            return `${sourceRoot}/${alias.slice(prefix.length)}`;
+        }
+    }
+    return alias;
+}
+/**
+ * Get the source root directory to use for project-level files like
+ * `lib/cn.ts` and `styles/tokens/`. Falls back to `"src"` for legacy
+ * `components.json` files without a `layout` field.
+ */
+export function getSourceRoot(componentsJson) {
+    return componentsJson.layout?.sourceRoot ?? "src";
+}

package/dist/utils/tsconfig-detect.d.ts

@@ -0,0 +1,18 @@
+export interface ProjectLayout {
+    /** Directory where source code lives, relative to project root. e.g. "app" | "src". */
+    sourceRoot: string;
+    /** Import alias prefix including trailing slash. e.g. "~/" | "@/" | "$/". */
+    aliasPrefix: string;
+}
+/**
+ * Detect the project layout (source root directory and alias prefix) by
+ * reading `tsconfig.json` in `cwd`. Falls back to filesystem heuristics
+ * (looking for `app/` or `src/`) if tsconfig is missing or doesn't declare
+ * path aliases.
+ *
+ * The returned layout drives where the CLI writes component files, cn.ts,
+ * tokens, and the CSS entry point so projects using `app/` (Remix,
+ * TanStack Start, Next App Router, custom) work without manual config.
+ */
+export declare function detectProjectLayout(cwd: string): ProjectLayout;
+//# sourceMappingURL=tsconfig-detect.d.ts.map

package/dist/utils/tsconfig-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-detect.d.ts","sourceRoot":"","sources":["../../src/utils/tsconfig-detect.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;CACrB;AA0FD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CA0B9D"}

package/dist/utils/tsconfig-detect.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Strip JSONC comments and trailing commas so `JSON.parse` can handle
+ * typical `tsconfig.json` files without an extra dependency.
+ */
+function parseJsonc(raw) {
+    // Remove block comments /* ... */
+    let stripped = raw.replace(/\/\*[\s\S]*?\*\//g, "");
+    // Remove line comments //
+    stripped = stripped.replace(/(^|[^:])\/\/.*$/gm, "$1");
+    // Remove trailing commas in objects/arrays
+    stripped = stripped.replace(/,(\s*[}\]])/g, "$1");
+    return JSON.parse(stripped);
+}
+/**
+ * Load a tsconfig file and merge its `extends` chain (up to 3 levels).
+ * Only `compilerOptions.paths` and `compilerOptions.baseUrl` are merged —
+ * that is the minimum we need to resolve the source root.
+ */
+function loadTsconfigChain(tsconfigPath, depth = 0) {
+    if (depth > 3)
+        return null;
+    if (!fs.existsSync(tsconfigPath))
+        return null;
+    let parsed;
+    try {
+        const raw = fs.readFileSync(tsconfigPath, "utf-8");
+        parsed = parseJsonc(raw);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.extends) {
+        let parentPath = parsed.extends;
+        if (!parentPath.endsWith(".json"))
+            parentPath += ".json";
+        const resolved = path.isAbsolute(parentPath)
+            ? parentPath
+            : path.resolve(path.dirname(tsconfigPath), parentPath);
+        const parent = loadTsconfigChain(resolved, depth + 1);
+        if (parent) {
+            return {
+                compilerOptions: {
+                    baseUrl: parsed.compilerOptions?.baseUrl ?? parent.compilerOptions?.baseUrl,
+                    paths: {
+                        ...(parent.compilerOptions?.paths ?? {}),
+                        ...(parsed.compilerOptions?.paths ?? {}),
+                    },
+                },
+            };
+        }
+    }
+    return parsed;
+}
+/**
+ * Parse a tsconfig `paths` entry to extract the alias prefix and target
+ * directory. Returns null if the entry is not a simple wildcard-to-directory
+ * mapping.
+ *
+ * Examples:
+ * - `"~/*": ["./app/*"]`  → { prefix: "~/", sourceRoot: "app" }
+ * - `"@/*": ["./src/*"]`  → { prefix: "@/", sourceRoot: "src" }
+ * - `"@foo/*": ["./libs/foo/*"]` → { prefix: "@foo/", sourceRoot: "libs/foo" }
+ */
+function parsePathEntry(key, value) {
+    if (!key.endsWith("/*"))
+        return null;
+    const target = value[0];
+    if (!target || !target.endsWith("/*"))
+        return null;
+    const aliasPrefix = key.slice(0, -1); // "~/*" → "~/"
+    let sourceRoot = target.slice(0, -2); // "./app/*" → "./app"
+    // Strip leading "./"
+    if (sourceRoot.startsWith("./"))
+        sourceRoot = sourceRoot.slice(2);
+    // Reject absolute paths and paths that escape the project
+    if (path.isAbsolute(sourceRoot) || sourceRoot.startsWith(".."))
+        return null;
+    if (!sourceRoot)
+        return null;
+    return { sourceRoot, aliasPrefix };
+}
+/**
+ * Detect the project layout (source root directory and alias prefix) by
+ * reading `tsconfig.json` in `cwd`. Falls back to filesystem heuristics
+ * (looking for `app/` or `src/`) if tsconfig is missing or doesn't declare
+ * path aliases.
+ *
+ * The returned layout drives where the CLI writes component files, cn.ts,
+ * tokens, and the CSS entry point so projects using `app/` (Remix,
+ * TanStack Start, Next App Router, custom) work without manual config.
+ */
+export function detectProjectLayout(cwd) {
+    const tsconfigPath = path.join(cwd, "tsconfig.json");
+    const tsconfig = loadTsconfigChain(tsconfigPath);
+    const paths = tsconfig?.compilerOptions?.paths ?? {};
+    // Prefer an entry whose source root directory actually exists on disk.
+    // This handles tsconfigs that declare multiple aliases.
+    let firstParsed = null;
+    for (const [key, value] of Object.entries(paths)) {
+        const parsed = parsePathEntry(key, value);
+        if (!parsed)
+            continue;
+        if (!firstParsed)
+            firstParsed = parsed;
+        if (fs.existsSync(path.join(cwd, parsed.sourceRoot))) {
+            return parsed;
+        }
+    }
+    if (firstParsed)
+        return firstParsed;
+    // No usable alias in tsconfig — fall back to directory heuristics.
+    if (fs.existsSync(path.join(cwd, "app"))) {
+        return { sourceRoot: "app", aliasPrefix: "~/" };
+    }
+    if (fs.existsSync(path.join(cwd, "src"))) {
+        return { sourceRoot: "src", aliasPrefix: "@/" };
+    }
+    return { sourceRoot: "src", aliasPrefix: "@/" };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inai-react-components",
-  "version": "1.2.1",
+  "version": "1.4.1",
   "description": "CLI for InAI UI component library — install components from a private registry into your React project",
   "private": false,
   "type": "module",