stera-ui 0.3.1 → 0.3.3

package/dist/{chunk-26HP67ZM.js → chunk-QD7FOI3A.js}

@@ -66,14 +66,22 @@ var TYPE_TO_ALIAS = {
 };
 function resolveAlias(alias, projectRoot) {
   const tsConfig = loadConfig(projectRoot);
-  if (tsConfig.resultType === "success") {
-    const match = createMatchPath(tsConfig.absoluteBaseUrl, tsConfig.paths);
-    const resolved = match(alias, void 0, () => true, [".ts", ".tsx"]);
-    if (resolved) {
-      return path.relative(projectRoot, resolved);
+  if (tsConfig.resultType === "success" && Object.keys(tsConfig.paths).length > 0) {
+    const hasMatchingPrefix = Object.keys(tsConfig.paths).some((key) => {
+      const prefix = key.replace(/\/\*$/, "");
+      return alias === prefix || alias.startsWith(`${prefix}/`);
+    });
+    if (hasMatchingPrefix) {
+      const match = createMatchPath(tsConfig.absoluteBaseUrl, tsConfig.paths);
+      const resolved = match(alias, void 0, () => true, [".ts", ".tsx"]);
+      if (resolved) {
+        return path.relative(projectRoot, resolved);
+      }
     }
   }
-  return alias.replace(/^@\//, "");
+  throw new Error(
+    `Could not resolve alias "${alias}" from tsconfig.json. Ensure compilerOptions.paths defines a mapping for it (e.g. "${alias}/*"), then re-run. See https://ui.stera.sh/docs/installation.`
+  );
 }
 function resolveOutputPath(config, projectRoot, file) {
   const alias = TYPE_TO_ALIAS[file.type];
@@ -129,6 +137,7 @@ function loadConfig2(cwd) {
 // src/utils/detect-project.ts
 import fs2 from "fs";
 import path3 from "path";
+import { loadConfig as loadConfig3 } from "tsconfig-paths";
 function hasFile(cwd, filenames) {
   return filenames.some((f) => fs2.existsSync(path3.join(cwd, f)));
 }
@@ -182,6 +191,24 @@ function detectProject(cwd) {
   }
   return { hasSrc, framework, rsc, existingCssFile, layoutFile };
 }
+function detectAliasPrefix(cwd) {
+  let tsConfig;
+  try {
+    tsConfig = loadConfig3(cwd);
+  } catch {
+    return null;
+  }
+  if (tsConfig.resultType !== "success" || Object.keys(tsConfig.paths).length === 0) {
+    return null;
+  }
+  for (const [alias, targets] of Object.entries(tsConfig.paths)) {
+    if (targets.includes("./*") || targets.includes("./src/*") || targets.includes("./app/*")) {
+      return alias.replace(/\/\*$/, "");
+    }
+  }
+  const first = Object.keys(tsConfig.paths)[0];
+  return first ? first.replace(/\/\*$/, "") : null;
+}
 
 // src/utils/detect-globals.ts
 import fs3 from "fs";
@@ -192,7 +219,15 @@ function hasGlobalsCss(config, projectRoot) {
     return false;
   }
   const steraPath = path4.join(path4.dirname(cssPath), "stera-ui.css");
-  return fs3.existsSync(steraPath);
+  if (fs3.existsSync(steraPath)) {
+    return true;
+  }
+  try {
+    const contents = fs3.readFileSync(cssPath, "utf-8");
+    return contents.includes("--color-bg-surface");
+  } catch {
+    return false;
+  }
 }
 
 // src/utils/install-deps.ts
@@ -679,6 +714,7 @@ export {
   findConfigPath,
   loadConfig2 as loadConfig,
   detectProject,
+  detectAliasPrefix,
   hasGlobalsCss,
   brand,
   dim,

package/dist/cli.js

@@ -111,14 +111,22 @@ var TYPE_TO_ALIAS = {
 };
 function resolveAlias(alias, projectRoot) {
   const tsConfig = loadConfig2(projectRoot);
-  if (tsConfig.resultType === "success") {
-    const match = createMatchPath(tsConfig.absoluteBaseUrl, tsConfig.paths);
-    const resolved = match(alias, void 0, () => true, [".ts", ".tsx"]);
-    if (resolved) {
-      return path2.relative(projectRoot, resolved);
+  if (tsConfig.resultType === "success" && Object.keys(tsConfig.paths).length > 0) {
+    const hasMatchingPrefix = Object.keys(tsConfig.paths).some((key) => {
+      const prefix = key.replace(/\/\*$/, "");
+      return alias === prefix || alias.startsWith(`${prefix}/`);
+    });
+    if (hasMatchingPrefix) {
+      const match = createMatchPath(tsConfig.absoluteBaseUrl, tsConfig.paths);
+      const resolved = match(alias, void 0, () => true, [".ts", ".tsx"]);
+      if (resolved) {
+        return path2.relative(projectRoot, resolved);
+      }
     }
   }
-  return alias.replace(/^@\//, "");
+  throw new Error(
+    `Could not resolve alias "${alias}" from tsconfig.json. Ensure compilerOptions.paths defines a mapping for it (e.g. "${alias}/*"), then re-run. See https://ui.stera.sh/docs/installation.`
+  );
 }
 function resolveOutputPath(config, projectRoot, file) {
   const alias = TYPE_TO_ALIAS[file.type];
@@ -363,34 +371,54 @@ function hasGlobalsCss(config, projectRoot) {
     return false;
   }
   const steraPath = path5.join(path5.dirname(cssPath), "stera-ui.css");
-  return fs4.existsSync(steraPath);
+  if (fs4.existsSync(steraPath)) {
+    return true;
+  }
+  try {
+    const contents = fs4.readFileSync(cssPath, "utf-8");
+    return contents.includes("--color-bg-surface");
+  } catch {
+    return false;
+  }
 }
 
 // src/commands/add.ts
 var transforms = [transformImports];
 async function add(components, options) {
   const cwd = options.cwd ? path6.resolve(options.cwd) : process.cwd();
-  for (const name of components) {
-    const item = await getComponent(name);
-    if (!item) {
-      console.error(`  Error: Component "${name}" not found in registry.`);
-      console.error(`  Run "stera-ui list" to see available components.`);
-      process.exit(1);
+  const spinner = createSpinner("Fetching registry");
+  try {
+    for (const name of components) {
+      const item = await getComponent(name);
+      if (!item) {
+        spinner.fail(`Component "${name}" not found in registry.`);
+        console.error(`  Run "stera-ui list" to see available components.`);
+        process.exit(1);
+      }
     }
+  } catch (err) {
+    spinner.fail("Failed to fetch registry");
+    throw err;
   }
   const configPath = findConfigPath(cwd);
   if (!configPath) {
-    console.error(
-      `  Error: ${CONFIG_FILE} not found. Run "stera-ui init" first.`
-    );
+    spinner.fail(`${CONFIG_FILE} not found. Run "stera-ui init" first.`);
     process.exit(1);
   }
   const config = loadConfig(cwd);
   if (!config) {
-    console.error(`  Error: Failed to parse ${CONFIG_FILE}.`);
+    spinner.fail(`Failed to parse ${CONFIG_FILE}.`);
     process.exit(1);
   }
   const projectRoot = path6.dirname(configPath);
+  let resolved;
+  try {
+    resolved = await resolveDependencies(components);
+  } catch (err) {
+    spinner.fail("Failed to fetch registry");
+    throw err;
+  }
+  spinner.succeed("Registry resolved");
   const isAddingGlobals = components.includes("globals");
   if (!isAddingGlobals && !hasGlobalsCss(config, projectRoot)) {
     console.warn(`
@@ -399,7 +427,6 @@ async function add(components, options) {
     console.warn(`     Run "stera-ui add globals" to install base styles.
 `);
   }
-  const resolved = await resolveDependencies(components);
   for (const item of resolved) {
     for (const file of item.files ?? []) {
       if (file.content) {
@@ -458,6 +485,7 @@ import { select } from "@inquirer/prompts";
 // src/utils/detect-project.ts
 import fs5 from "fs";
 import path7 from "path";
+import { loadConfig as loadConfig3 } from "tsconfig-paths";
 function hasFile(cwd, filenames) {
   return filenames.some((f) => fs5.existsSync(path7.join(cwd, f)));
 }
@@ -511,6 +539,24 @@ function detectProject(cwd) {
   }
   return { hasSrc, framework, rsc, existingCssFile, layoutFile };
 }
+function detectAliasPrefix(cwd) {
+  let tsConfig;
+  try {
+    tsConfig = loadConfig3(cwd);
+  } catch {
+    return null;
+  }
+  if (tsConfig.resultType !== "success" || Object.keys(tsConfig.paths).length === 0) {
+    return null;
+  }
+  for (const [alias, targets] of Object.entries(tsConfig.paths)) {
+    if (targets.includes("./*") || targets.includes("./src/*") || targets.includes("./app/*")) {
+      return alias.replace(/\/\*$/, "");
+    }
+  }
+  const first = Object.keys(tsConfig.paths)[0];
+  return first ? first.replace(/\/\*$/, "") : null;
+}
 
 // src/utils/detect-fonts.ts
 import fs6 from "fs";
@@ -943,7 +989,7 @@ function parseTemplateLiteralToCnArgs(templateLiteral) {
 
 // src/commands/init.ts
 var DEFAULT_FONT_NAMES = ["font-geist", "font-geist-mono"];
-function buildConfig(project, strategy) {
+function buildConfig(project, strategy, aliasPrefix) {
   let cssPath;
   if (project.existingCssFile) {
     cssPath = project.existingCssFile;
@@ -957,11 +1003,11 @@ function buildConfig(project, strategy) {
     version: 1,
     css: cssPath,
     aliases: {
-      components: "@/components",
-      utils: "@/lib/utils",
-      ui: "@/components/ui",
-      lib: "@/lib",
-      hooks: "@/hooks"
+      components: `${aliasPrefix}/components`,
+      utils: `${aliasPrefix}/lib/utils`,
+      ui: `${aliasPrefix}/components/ui`,
+      lib: `${aliasPrefix}/lib`,
+      hooks: `${aliasPrefix}/hooks`
     },
     fonts: {
       strategy
@@ -1045,16 +1091,23 @@ async function promptFontStrategy(detected, skipPrompts) {
   return strategy;
 }
 async function fetchDefaultFonts() {
+  const spinner = createSpinner("Fetching fonts");
   const fonts = [];
-  for (const name of DEFAULT_FONT_NAMES) {
-    try {
-      const item = await fetchRegistryItem(name);
-      if (item.type === "registry:font") {
-        fonts.push(item);
+  try {
+    for (const name of DEFAULT_FONT_NAMES) {
+      try {
+        const item = await fetchRegistryItem(name);
+        if (item.type === "registry:font") {
+          fonts.push(item);
+        }
+      } catch {
       }
-    } catch {
     }
+  } catch (err) {
+    spinner.fail("Failed to fetch fonts");
+    throw err;
   }
+  spinner.succeed("Fonts resolved");
   return fonts;
 }
 async function executeFontStrategy(strategy, project, detected, config, cwd) {
@@ -1131,6 +1184,19 @@ async function init(options) {
     process.exit(1);
   }
   const project = detectProject(cwd);
+  const aliasPrefix = detectAliasPrefix(cwd);
+  if (!aliasPrefix) {
+    console.error("");
+    console.error("  Error: No import alias found in your tsconfig.json file.");
+    console.error(
+      '  Stera UI requires a path alias (e.g. "@/*": ["./src/*"]) in compilerOptions.paths.'
+    );
+    console.error(
+      "  See https://ui.stera.sh/docs/installation for setup instructions per framework."
+    );
+    console.error("");
+    process.exit(1);
+  }
   const frameworkName = project.framework === "next" ? "Next.js" : project.framework === "vite" ? "Vite" : null;
   const parts = [];
   if (frameworkName) parts.push(frameworkName);
@@ -1144,7 +1210,7 @@ async function init(options) {
     detectedFonts,
     options.yes ?? false
   );
-  const config = buildConfig(project, strategy);
+  const config = buildConfig(project, strategy, aliasPrefix);
   const configPath = path10.join(cwd, CONFIG_FILE);
   fs9.writeFileSync(
     configPath,
@@ -1159,8 +1225,16 @@ async function init(options) {
         `  ${CHECK}  Stera already initialised ${dim(`(${path10.join(path10.dirname(project.existingCssFile), "stera-ui.css")} exists)`)}`
       );
     } else {
+      const fetchSpinner = createSpinner("Fetching base styles");
+      let globalsItem;
       try {
-        const globalsItem = await fetchRegistryItem("globals");
+        globalsItem = await fetchRegistryItem("globals");
+      } catch {
+        fetchSpinner.fail("Base styles not found \u2014 skipping");
+        globalsItem = null;
+      }
+      if (globalsItem) {
+        fetchSpinner.succeed("Base styles resolved");
         const globalsContent = globalsItem.files?.[0]?.content ?? "";
         const { content: steraUiContent, imports } = stripImportLines(globalsContent);
         const steraUiPath = path10.join(cssDir, "stera-ui.css");
@@ -1173,11 +1247,18 @@ async function init(options) {
         }
         insertImportLine(existingCssPath, "@import './stera-ui.css';");
         console.log(`  ${CHECK}  Added @import to ${project.existingCssFile}`);
-      } catch {
       }
     }
   } else {
-    const resolved = await resolveDependencies(["globals"]);
+    const fetchSpinner = createSpinner("Fetching base styles");
+    let resolved;
+    try {
+      resolved = await resolveDependencies(["globals"]);
+    } catch (err) {
+      fetchSpinner.fail("Failed to fetch base styles");
+      throw err;
+    }
+    fetchSpinner.succeed("Base styles resolved");
     const filtered = resolved.filter((item) => item.name !== "fonts");
     const { written } = await writeComponentFiles(filtered, config, cwd);
     for (const file of written) {
@@ -1191,14 +1272,21 @@ async function init(options) {
     config,
     cwd
   );
+  const depsSpinner = createSpinner("Fetching package list");
+  let globalsForDeps;
   try {
-    const globalsItem = await fetchRegistryItem("globals");
-    if (globalsItem.dependencies) {
-      const deps = [...new Set(globalsItem.dependencies)].sort();
+    globalsForDeps = await fetchRegistryItem("globals");
+  } catch {
+    depsSpinner.fail("Package list unavailable \u2014 skipping");
+    globalsForDeps = null;
+  }
+  if (globalsForDeps) {
+    depsSpinner.succeed("Package list resolved");
+    if (globalsForDeps.dependencies) {
+      const deps = [...new Set(globalsForDeps.dependencies)].sort();
       console.log("");
       await installDependencies(deps, cwd);
     }
-  } catch {
   }
   console.log("");
   console.log("  Next steps:");
@@ -1212,7 +1300,15 @@ async function init(options) {
 
 // src/commands/list.ts
 async function list() {
-  const items = await getAllComponents();
+  const spinner = createSpinner("Fetching registry");
+  let items;
+  try {
+    items = await getAllComponents();
+  } catch (err) {
+    spinner.fail("Failed to fetch registry");
+    throw err;
+  }
+  spinner.succeed("Registry resolved");
   const groups = /* @__PURE__ */ new Map();
   for (const item of items) {
     const type = item.type.replace("registry:", "");

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { fetchRegistryIndex, fetchRegistryItem, getAllComponents, getComponent, resolveDependencies } from './registry/index.js';
 export { RegistryFontItem, RegistryIndex, RegistryItem, RegistryItemFile, RegistryItemFont, RegistryItemType, SteraConfig, configSchema, registryIndexSchema, registryItemFileSchema, registryItemFontSchema, registryItemSchema, registryItemTypeSchema } from './schema/index.js';
-export { CHECK, CONFIG_FILE, CROSS, LOGO, ProjectInfo, TransformContext, TransformFn, WARN, WriteOptions, WriteResult, applyTransforms, brand, createSpinner, detectPackageManager, detectProject, dim, findConfigPath, hasGlobalsCss, installDependencies, loadConfig, massageTreeForFonts, resolveOutputPath, transformImports, updateFonts, writeComponentFiles } from './utils/index.js';
+export { CHECK, CONFIG_FILE, CROSS, LOGO, ProjectInfo, TransformContext, TransformFn, WARN, WriteOptions, WriteResult, applyTransforms, brand, createSpinner, detectAliasPrefix, detectPackageManager, detectProject, dim, findConfigPath, hasGlobalsCss, installDependencies, loadConfig, massageTreeForFonts, resolveOutputPath, transformImports, updateFonts, writeComponentFiles } from './utils/index.js';
 import 'zod';

package/dist/index.js

@@ -22,6 +22,7 @@ import {
   applyTransforms,
   brand,
   createSpinner,
+  detectAliasPrefix,
   detectPackageManager,
   detectProject,
   dim,
@@ -34,7 +35,7 @@ import {
   transformImports,
   updateFonts,
   writeComponentFiles
-} from "./chunk-26HP67ZM.js";
+} from "./chunk-QD7FOI3A.js";
 export {
   CHECK,
   CONFIG_FILE,
@@ -45,6 +46,7 @@ export {
   brand,
   configSchema,
   createSpinner,
+  detectAliasPrefix,
   detectPackageManager,
   detectProject,
   dim,

package/dist/schema/index.d.ts

@@ -8,13 +8,13 @@ declare const registryItemFileSchema: z.ZodObject<{
     content: z.ZodOptional<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
     path: string;
+    type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
     content?: string | undefined;
     target?: string | undefined;
 }, {
-    type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
     path: string;
+    type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
     content?: string | undefined;
     target?: string | undefined;
 }>;
@@ -88,13 +88,13 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }, {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }>, "many">>;
@@ -114,8 +114,8 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     dependencies?: string[] | undefined;
     registryDependencies?: string[] | undefined;
     files?: {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }[] | undefined;
@@ -135,8 +135,8 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     dependencies?: string[] | undefined;
     registryDependencies?: string[] | undefined;
     files?: {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }[] | undefined;
@@ -152,13 +152,13 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }, {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }>, "many">;
@@ -166,8 +166,8 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
     name: string;
     files: {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }[];
@@ -177,8 +177,8 @@ declare const registryItemSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
     name: string;
     files: {
-        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         path: string;
+        type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
         content?: string | undefined;
         target?: string | undefined;
     }[];
@@ -231,13 +231,13 @@ declare const registryIndexSchema: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             target: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }, {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }>, "many">>;
@@ -257,8 +257,8 @@ declare const registryIndexSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         registryDependencies?: string[] | undefined;
         files?: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[] | undefined;
@@ -278,8 +278,8 @@ declare const registryIndexSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         registryDependencies?: string[] | undefined;
         files?: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[] | undefined;
@@ -295,13 +295,13 @@ declare const registryIndexSchema: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             target: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }, {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }>, "many">;
@@ -309,8 +309,8 @@ declare const registryIndexSchema: z.ZodObject<{
         type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
         name: string;
         files: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[];
@@ -320,8 +320,8 @@ declare const registryIndexSchema: z.ZodObject<{
         type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
         name: string;
         files: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[];
@@ -346,8 +346,8 @@ declare const registryIndexSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         registryDependencies?: string[] | undefined;
         files?: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[] | undefined;
@@ -355,8 +355,8 @@ declare const registryIndexSchema: z.ZodObject<{
         type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
         name: string;
         files: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[];
@@ -381,8 +381,8 @@ declare const registryIndexSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         registryDependencies?: string[] | undefined;
         files?: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[] | undefined;
@@ -390,8 +390,8 @@ declare const registryIndexSchema: z.ZodObject<{
         type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style";
         name: string;
         files: {
-            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             path: string;
+            type: "registry:ui" | "registry:component" | "registry:hook" | "registry:lib" | "registry:style" | "registry:font";
             content?: string | undefined;
             target?: string | undefined;
         }[];

package/dist/utils/index.d.ts

@@ -67,10 +67,21 @@ interface ProjectInfo {
  * - Existing Tailwind CSS entry file
  */
 declare function detectProject(cwd: string): ProjectInfo;
+/**
+ * Detect the alias prefix (e.g. "@" or "~") from the project's tsconfig.json
+ * `compilerOptions.paths`. Mirrors shadcn's approach.
+ *
+ * Returns null when tsconfig can't be loaded or defines no path mappings —
+ * `init` should surface a clear error in that case rather than templating
+ * aliases that won't resolve.
+ */
+declare function detectAliasPrefix(cwd: string): string | null;
 
 /**
  * Check if Stera has already been initialised in the user's project.
- * Looks for the presence of `stera-ui.css` alongside the user's CSS file.
+ * Returns true if either a sibling `stera-ui.css` exists (existing-CSS init
+ * path) or the user's CSS file itself contains Stera tokens inline
+ * (no-existing-CSS init path, or a hand-rolled setup).
  */
 declare function hasGlobalsCss(config: SteraConfig, projectRoot: string): boolean;
 
@@ -132,4 +143,4 @@ declare function updateFonts(fonts: RegistryFontItem[], project: ProjectInfo, cw
     silent?: boolean;
 }): Promise<void>;
 
-export { CHECK, CONFIG_FILE, CROSS, LOGO, type ProjectInfo, type TransformContext, type TransformFn, WARN, type WriteOptions, type WriteResult, applyTransforms, brand, createSpinner, detectPackageManager, detectProject, dim, findConfigPath, hasGlobalsCss, installDependencies, loadConfig, massageTreeForFonts, resolveOutputPath, transformImports, updateFonts, writeComponentFiles };
+export { CHECK, CONFIG_FILE, CROSS, LOGO, type ProjectInfo, type TransformContext, type TransformFn, WARN, type WriteOptions, type WriteResult, applyTransforms, brand, createSpinner, detectAliasPrefix, detectPackageManager, detectProject, dim, findConfigPath, hasGlobalsCss, installDependencies, loadConfig, massageTreeForFonts, resolveOutputPath, transformImports, updateFonts, writeComponentFiles };

package/dist/utils/index.js

@@ -7,6 +7,7 @@ import {
   applyTransforms,
   brand,
   createSpinner,
+  detectAliasPrefix,
   detectPackageManager,
   detectProject,
   dim,
@@ -19,7 +20,7 @@ import {
   transformImports,
   updateFonts,
   writeComponentFiles
-} from "../chunk-26HP67ZM.js";
+} from "../chunk-QD7FOI3A.js";
 export {
   CHECK,
   CONFIG_FILE,
@@ -29,6 +30,7 @@ export {
   applyTransforms,
   brand,
   createSpinner,
+  detectAliasPrefix,
   detectPackageManager,
   detectProject,
   dim,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stera-ui",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "description": "Add Stera UI components to your project.",
   "license": "MIT",