stera-ui 0.3.2 → 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,7 +371,15 @@ 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
@@ -469,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)));
 }
@@ -522,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";
@@ -954,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;
@@ -968,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
@@ -1149,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);
@@ -1162,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,

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/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.2",
+  "version": "0.3.3",
   "type": "module",
   "description": "Add Stera UI components to your project.",
   "license": "MIT",