stera-ui 0.6.0 → 0.7.0

package/dist/utils/index.d.ts

@@ -78,27 +78,69 @@ declare function detectProject(cwd: string): ProjectInfo;
  */
 declare function detectAliasPrefix(cwd: string): string | null;
 
-interface WriteSteraCssResult {
-    /** Absolute path to the written `stera-ui.css`. */
-    steraUiPath: string;
+interface WriteOptions {
+    overwrite?: boolean;
+}
+interface SkippedFile {
+    path: string;
+    /** "unchanged" — identical content on disk; "declined" — user kept their version. */
+    reason: "unchanged" | "declined";
+}
+interface WriteResult {
+    written: string[];
+    skipped: SkippedFile[];
+}
+/**
+ * Write component files to the consumer's project.
+ * Checks for existing files and prompts before overwriting.
+ */
+declare function writeComponentFiles(items: RegistryItem[], config: SteraConfig, projectRoot: string, options?: WriteOptions): Promise<WriteResult>;
+
+/** Entry point the user's globals.css imports; owns the partial wiring. */
+declare const INDEX_TARGET = "ui/index.css";
+/** Partial that owns the font variables patched during init. */
+declare const TYPOGRAPHY_TARGET = "ui/typography.css";
+interface WriteStylesResult {
+    /** Absolute path to the written `ui/index.css`. */
+    indexPath: string;
+    /** Absolute path to `ui/typography.css`, where font variables are patched. */
+    typographyPath: string;
     /**
-     * Non-tailwindcss `@import` statements stripped from the registry content
-     * (e.g. `@import "tw-animate-css";`). Callers are expected to ensure these
-     * are present in the user's main globals.css.
+     * Non-relative `@import` statements lifted out of the index (e.g.
+     * `@import "tw-animate-css";`). Callers ensure these are present in the
+     * user's globals.css.
      */
     extraImports: string[];
     /** npm packages declared by the globals registry item. */
     dependencies: string[];
+    /** Consumer-relative paths written this run. */
+    written: string[];
+    /** Protected partials left untouched. */
+    skipped: SkippedFile[];
 }
 /**
- * Fetch the `globals` registry item and write `stera-ui.css` into the
- * directory that holds the user's configured globals.css. Overwrites
- * unconditionally — the caller decides when this is appropriate (init or
- * an explicit `add globals` refresh).
+ * Remove the pre-split `stera-ui.css` and its import.
+ *
+ * Projects initialized before the styles were split carry a single flat file
+ * plus an `@import "./stera-ui.css"` line. Left in place the file goes stale
+ * and its import points at content the `ui/` folder now owns.
+ *
+ * @returns The removed file's absolute path, or null if there was nothing to do.
+ */
+declare function migrateLegacyStyles(config: SteraConfig, cwd: string): Promise<string | null>;
+/**
+ * Fetch the `globals` registry item and write its partials into a `ui/`
+ * folder beside the user's configured globals.css.
+ *
+ * Stable partials are overwritten unconditionally — the caller decides when
+ * that is appropriate (init, or an explicit `add globals` refresh). Protected
+ * partials prompt first unless `overwrite` is set.
  *
  * Does NOT touch the user's globals.css.
  */
-declare function writeSteraUiCss(config: SteraConfig, cwd: string): Promise<WriteSteraCssResult>;
+declare function writeStyles(config: SteraConfig, cwd: string, options?: {
+    overwrite?: boolean;
+}): Promise<WriteStylesResult>;
 
 /**
  * Insert an `@import` statement into an existing CSS file, placed after the
@@ -116,24 +158,6 @@ declare function detectPackageManager(cwd: string): Promise<PackageManager>;
  */
 declare function installDependencies(deps: string[], cwd: string): Promise<void>;
 
-interface WriteOptions {
-    overwrite?: boolean;
-}
-interface SkippedFile {
-    path: string;
-    /** "unchanged" — identical content on disk; "declined" — user kept their version. */
-    reason: "unchanged" | "declined";
-}
-interface WriteResult {
-    written: string[];
-    skipped: SkippedFile[];
-}
-/**
- * Write component files to the consumer's project.
- * Checks for existing files and prompts before overwriting.
- */
-declare function writeComponentFiles(items: RegistryItem[], config: SteraConfig, projectRoot: string, options?: WriteOptions): Promise<WriteResult>;
-
 declare const brand: (text: string) => string;
 declare const dim: (text: string) => string;
 declare const LOGO: string;
@@ -172,4 +196,4 @@ declare function updateFonts(fonts: RegistryFontItem[], project: ProjectInfo, cw
     silent?: boolean;
 }): Promise<void>;
 
-export { CHECK, CONFIG_FILE, CROSS, LEGACY_CONFIG_FILE, LOGO, type ProjectInfo, type SkippedFile, type TransformContext, type TransformFn, WARN, type WriteOptions, type WriteResult, type WriteSteraCssResult, applyTransforms, brand, createSpinner, detectAliasPrefix, detectPackageManager, detectProject, dim, findConfigPath, insertImportLine, installDependencies, loadConfig, massageTreeForFonts, resolveOutputPath, transformImports, updateFonts, writeComponentFiles, writeSteraUiCss };
+export { CHECK, CONFIG_FILE, CROSS, INDEX_TARGET, LEGACY_CONFIG_FILE, LOGO, type ProjectInfo, type SkippedFile, TYPOGRAPHY_TARGET, type TransformContext, type TransformFn, WARN, type WriteOptions, type WriteResult, type WriteStylesResult, applyTransforms, brand, createSpinner, detectAliasPrefix, detectPackageManager, detectProject, dim, findConfigPath, insertImportLine, installDependencies, loadConfig, massageTreeForFonts, migrateLegacyStyles, resolveOutputPath, transformImports, updateFonts, writeComponentFiles, writeStyles };

package/dist/utils/index.js

@@ -2,8 +2,10 @@ import {
   CHECK,
   CONFIG_FILE,
   CROSS,
+  INDEX_TARGET,
   LEGACY_CONFIG_FILE,
   LOGO,
+  TYPOGRAPHY_TARGET,
   WARN,
   applyTransforms,
   brand,
@@ -17,20 +19,23 @@ import {
   installDependencies,
   loadConfig,
   massageTreeForFonts,
+  migrateLegacyStyles,
   resolveOutputPath,
   transformImports,
   updateFonts,
   writeComponentFiles,
-  writeSteraUiCss
-} from "../chunk-SIXUH4HI.js";
+  writeStyles
+} from "../chunk-V4TMOT6I.js";
 import "../chunk-BJNLGEZJ.js";
 import "../chunk-4E46BULJ.js";
 export {
   CHECK,
   CONFIG_FILE,
   CROSS,
+  INDEX_TARGET,
   LEGACY_CONFIG_FILE,
   LOGO,
+  TYPOGRAPHY_TARGET,
   WARN,
   applyTransforms,
   brand,
@@ -44,9 +49,10 @@ export {
   installDependencies,
   loadConfig,
   massageTreeForFonts,
+  migrateLegacyStyles,
   resolveOutputPath,
   transformImports,
   updateFonts,
   writeComponentFiles,
-  writeSteraUiCss
+  writeStyles
 };

package/package.json

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

package/dist/chunk-2Y64FOD3.js

@@ -1,161 +0,0 @@
-#!/usr/bin/env node
-import {
-  createSpinner,
-  fetchRegistryItem
-} from "./chunk-KKUJRJ2N.js";
-
-// src/utils/resolve-config.ts
-import fs from "fs";
-import path from "path";
-var CONFIG_FILE = "stera.config.json";
-var LEGACY_CONFIG_FILE = "components.json";
-function migrateConfig(raw) {
-  if (!("version" in raw) && "tailwind" in raw) {
-    const legacy = raw;
-    return {
-      version: 1,
-      css: legacy.tailwind.css || "src/styles/globals.css",
-      aliases: legacy.aliases
-    };
-  }
-  return raw;
-}
-var warnedLegacyFilename = false;
-function warnLegacyFilenameOnce(legacyPath) {
-  if (warnedLegacyFilename) return;
-  warnedLegacyFilename = true;
-  console.warn(
-    `  \u26A0 Found ${LEGACY_CONFIG_FILE}. Rename to ${CONFIG_FILE} \u2014 legacy filename support will be removed in a future release.
-    (${legacyPath})`
-  );
-}
-function findConfigPath(cwd) {
-  let dir = path.resolve(cwd);
-  while (true) {
-    const configPath = path.join(dir, CONFIG_FILE);
-    if (fs.existsSync(configPath)) return configPath;
-    const legacyPath = path.join(dir, LEGACY_CONFIG_FILE);
-    if (fs.existsSync(legacyPath)) return legacyPath;
-    const parent = path.dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-function loadConfig(cwd) {
-  const configPath = findConfigPath(cwd);
-  if (!configPath) return null;
-  if (path.basename(configPath) === LEGACY_CONFIG_FILE) {
-    warnLegacyFilenameOnce(configPath);
-  }
-  try {
-    const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-    return migrateConfig(raw);
-  } catch {
-    return null;
-  }
-}
-
-// src/utils/install-deps.ts
-import fs2 from "fs";
-import path2 from "path";
-import { detect } from "@antfu/ni";
-import { execa } from "execa";
-async function detectPackageManager(cwd) {
-  const detected = await detect({ programmatic: true, cwd });
-  if (detected === "pnpm@6" || detected === "pnpm") return "pnpm";
-  if (detected === "yarn@berry" || detected === "yarn") return "yarn";
-  if (detected === "bun") return "bun";
-  if (detected === "npm") return "npm";
-  const userAgent = process.env.npm_config_user_agent || "";
-  if (userAgent.startsWith("pnpm")) return "pnpm";
-  if (userAgent.startsWith("yarn")) return "yarn";
-  if (userAgent.startsWith("bun")) return "bun";
-  return "npm";
-}
-function getInstallArgs(pm, deps) {
-  switch (pm) {
-    case "pnpm":
-      return ["pnpm", ["add", ...deps]];
-    case "yarn":
-      return ["yarn", ["add", ...deps]];
-    case "bun":
-      return ["bun", ["add", ...deps]];
-    default:
-      return ["npm", ["install", ...deps]];
-  }
-}
-async function installDependencies(deps, cwd) {
-  if (deps.length === 0) return;
-  const pkgPath = path2.join(cwd, "package.json");
-  let existing = /* @__PURE__ */ new Set();
-  if (fs2.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
-      existing = new Set(
-        Object.keys({ ...pkg.dependencies, ...pkg.devDependencies })
-      );
-    } catch {
-    }
-  }
-  const toInstall = deps.filter((dep) => !existing.has(dep));
-  if (toInstall.length === 0) return;
-  const pm = await detectPackageManager(cwd);
-  const [cmd, args] = getInstallArgs(pm, toInstall);
-  const spinner = createSpinner(`Installing with ${pm}`);
-  try {
-    await execa(cmd, args, { cwd });
-    spinner.succeed(`Installed with ${pm}`);
-  } catch (error) {
-    spinner.fail(`Install failed`);
-    if (error instanceof Error && "stdout" in error && typeof error.stdout === "string" && error.stdout.includes("ERR_PNPM_ADDING_TO_ROOT")) {
-      throw new Error(
-        `Cannot install dependencies at a pnpm workspace root.
-Run stera-ui init from within a specific workspace package instead,
-or use "pnpm add -w <package>" manually to install at the root.`
-      );
-    }
-    throw error;
-  }
-}
-
-// src/utils/write-stera-css.ts
-import fs3 from "fs/promises";
-import path3 from "path";
-function stripImportLines(content) {
-  const lines = content.split("\n");
-  const imports = [];
-  const kept = [];
-  for (const line of lines) {
-    if (line.trim().match(/^@import\s+["'].+["']/)) {
-      if (!line.trim().match(/^@import\s+["']tailwindcss["']/)) {
-        imports.push(line.trim());
-      }
-    } else {
-      kept.push(line);
-    }
-  }
-  return { content: kept.join("\n"), imports };
-}
-async function writeSteraUiCss(config, cwd) {
-  const item = await fetchRegistryItem("globals");
-  const rawContent = item.files?.[0]?.content ?? "";
-  const { content, imports } = stripImportLines(rawContent);
-  const cssDir = path3.dirname(path3.resolve(cwd, config.css));
-  const steraUiPath = path3.join(cssDir, "stera-ui.css");
-  await fs3.mkdir(cssDir, { recursive: true });
-  await fs3.writeFile(steraUiPath, content, "utf-8");
-  return {
-    steraUiPath,
-    extraImports: imports,
-    dependencies: item.dependencies ?? []
-  };
-}
-
-export {
-  CONFIG_FILE,
-  LEGACY_CONFIG_FILE,
-  findConfigPath,
-  loadConfig,
-  installDependencies,
-  writeSteraUiCss
-};