starwind 1.15.4 → 1.16.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command, Option } from "commander";
 // package.json
 var package_default = {
   name: "starwind",
-  version: "1.15.4",
+  version: "1.16.0",
   description: "Add beautifully designed components to your Astro applications",
   license: "MIT",
   author: {
@@ -20,15 +20,16 @@ var package_default = {
   },
   keywords: [
     "starwind",
-    "starwind ui",
-    "starwind cli",
+    "starwind-ui",
+    "starwind-cli",
     "astro",
-    "astro component",
-    "astro ui",
-    "astro ui library",
+    "astro-component",
+    "astro-ui",
+    "withastro",
+    "ui",
+    "accessibility",
     "tailwind",
-    "components",
-    "add component"
+    "components"
   ],
   type: "module",
   bin: {
@@ -58,7 +59,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^0.11.0",
-    "@starwind-ui/core": "1.15.4",
+    "@starwind-ui/core": "1.16.0",
     chalk: "^5.6.2",
     commander: "^14.0.2",
     execa: "^9.6.0",
@@ -87,12 +88,16 @@ var MIN_ASTRO_VERSION = "5.0.0";
 var PATHS = {
   STARWIND_CORE: "@starwind-ui/core",
   STARWIND_CORE_COMPONENTS: "src/components",
+  STARWIND_CORE_UTILS: "src/lib/utils",
   STARWIND_REMOTE_COMPONENT_REGISTRY: "https://starwind.dev/registry.json",
   STARWIND_PRO_REGISTRY: "https://pro.starwind.dev/r/{name}",
   LOCAL_CSS_FILE: "src/styles/starwind.css",
   LOCAL_CONFIG_FILE: "starwind.config.json",
   LOCAL_STYLES_DIR: "src/styles",
-  LOCAL_COMPONENTS_DIR: "src/components"
+  LOCAL_COMPONENTS_DIR: "src/components",
+  LOCAL_UTILS_DIR: "src/lib/utils",
+  VSCODE_DIR: ".vscode",
+  VSCODE_SNIPPETS_FILE: ".vscode/starwind.code-snippets"
 };
 var ASTRO_PACKAGES = {
   core: "astro@latest"
@@ -140,6 +145,7 @@ var defaultConfig = {
   // 	components: "@/components",
   // },
   componentDir: "src/components/starwind",
+  utilsDir: PATHS.LOCAL_UTILS_DIR,
   components: []
 };
 async function getConfig() {
@@ -182,6 +188,7 @@ async function updateConfig(updates, options = { appendComponents: true }) {
       ...updates.tailwind || {}
     },
     componentDir: updates.componentDir ? updates.componentDir : currentConfig.componentDir,
+    utilsDir: updates.utilsDir ? updates.utilsDir : currentConfig.utilsDir ?? defaultConfig.utilsDir,
     components: finalComponents
   };
   try {
@@ -226,6 +233,7 @@ var componentSchema = z.object({
   name: z.string(),
   version: z.string(),
   dependencies: z.array(z.string()).default([]),
+  fileDependencies: z.array(z.string()).optional(),
   type: z.enum(["component"])
 });
 var registryRootSchema = z.object({
@@ -274,25 +282,74 @@ async function getAllComponents(forceRefresh = false) {
 }
 
 // src/utils/component.ts
-async function copyComponent(name, overwrite = false) {
+function resolveConfigPath(directory) {
+  if (directory.startsWith("@/")) {
+    return path.join("src", directory.slice(2));
+  }
+  return directory;
+}
+function normalizeFileDependencyPath(fileDependency) {
+  const normalized = fileDependency.replace(/\\/g, "/");
+  if (path.posix.isAbsolute(normalized)) {
+    throw new Error(`File dependency "${fileDependency}" must be a relative path`);
+  }
+  const trimmed = normalized.startsWith("starwind/") ? normalized.slice("starwind/".length) : normalized;
+  const safePath = path.posix.normalize(trimmed);
+  if (safePath.startsWith("..") || safePath === "." || safePath.length === 0) {
+    throw new Error(`File dependency "${fileDependency}" contains an invalid path`);
+  }
+  return safePath;
+}
+async function copyFileDependencies(options) {
+  const { coreDir, fileDependencies, utilsDir } = options;
+  if (fileDependencies.length === 0) return;
+  const targetUtilsRoot = path.join(resolveConfigPath(utilsDir), "starwind");
+  const sourceUtilsRoot = path.join(coreDir, PATHS.STARWIND_CORE_UTILS, "starwind");
+  await fs2.ensureDir(targetUtilsRoot);
+  for (const fileDependency of fileDependencies) {
+    const relativePath = normalizeFileDependencyPath(fileDependency);
+    const sourcePath = path.join(sourceUtilsRoot, relativePath);
+    const destinationPath = path.join(targetUtilsRoot, relativePath);
+    if (!await fs2.pathExists(sourcePath)) {
+      throw new Error(
+        `File dependency "${fileDependency}" for component is missing from ${PATHS.STARWIND_CORE_UTILS}/starwind`
+      );
+    }
+    await fs2.ensureDir(path.dirname(destinationPath));
+    await fs2.copy(sourcePath, destinationPath, { overwrite: true });
+  }
+}
+async function copyComponent(name, overwrite = false, options) {
   const config = await getConfig();
   const currentComponents = Array.isArray(config.components) ? config.components : [];
-  if (!overwrite && currentComponents.some((component) => component.name === name)) {
-    const existingComponent = currentComponents.find((c) => c.name === name);
-    return {
-      status: "skipped",
-      name,
-      version: existingComponent?.version ?? "unknown"
-    };
-  }
-  const componentDir = path.join(config.componentDir, "starwind", name);
   try {
-    await fs2.ensureDir(componentDir);
-    const pkgUrl = import.meta.resolve?.(PATHS.STARWIND_CORE);
+    const registry = await getRegistry();
+    const componentInfo = registry.find((component) => component.name === name);
+    if (!componentInfo) {
+      throw new Error(`Component ${name} not found in registry`);
+    }
+    const fileDependencies = componentInfo.fileDependencies ?? [];
+    const resolvePackageUrl = options?.resolvePackageUrl ?? ((specifier) => import.meta.resolve?.(specifier));
+    const pkgUrl = resolvePackageUrl(PATHS.STARWIND_CORE);
     if (!pkgUrl) {
       throw new Error(`Could not resolve ${PATHS.STARWIND_CORE} package, is it installed?`);
     }
     const coreDir = path.dirname(fileURLToPath(pkgUrl));
+    if (!overwrite && currentComponents.some((component) => component.name === name)) {
+      await copyFileDependencies({
+        coreDir,
+        fileDependencies,
+        utilsDir: config.utilsDir || PATHS.LOCAL_UTILS_DIR
+      });
+      const existingComponent = currentComponents.find((c) => c.name === name);
+      return {
+        status: "skipped",
+        name,
+        version: existingComponent?.version ?? "unknown"
+      };
+    }
+    const componentDir = path.join(config.componentDir, "starwind", name);
+    await fs2.ensureDir(componentDir);
     const sourceDir = path.join(coreDir, PATHS.STARWIND_CORE_COMPONENTS, name);
     const files = await fs2.readdir(sourceDir);
     for (const file of files) {
@@ -300,11 +357,11 @@ async function copyComponent(name, overwrite = false) {
       const destPath = path.join(componentDir, file);
       await fs2.copy(sourcePath, destPath, { overwrite: true });
     }
-    const registry = await getRegistry();
-    const componentInfo = registry.find((c) => c.name === name);
-    if (!componentInfo) {
-      throw new Error(`Component ${name} not found in registry`);
-    }
+    await copyFileDependencies({
+      coreDir,
+      fileDependencies,
+      utilsDir: config.utilsDir || PATHS.LOCAL_UTILS_DIR
+    });
     return {
       status: "installed",
       name,
@@ -1100,9 +1157,9 @@ var tailwindConfig = `@import "tailwindcss";
   --primary: var(--color-blue-700);
   --primary-foreground: var(--color-neutral-50);
   --primary-accent: var(--color-blue-700);
-  --secondary: var(--color-fuchsia-700);
-  --secondary-foreground: var(--color-neutral-50);
-  --secondary-accent: var(--color-fuchsia-700);
+  --secondary: var(--color-neutral-200);
+  --secondary-foreground: var(--color-neutral-950);
+  --secondary-accent: var(--color-neutral-950);
   --muted: var(--color-neutral-100);
   --muted-foreground: var(--color-neutral-600);
   --accent: var(--color-neutral-100);
@@ -1141,9 +1198,9 @@ var tailwindConfig = `@import "tailwindcss";
   --primary: var(--color-blue-700);
   --primary-foreground: var(--color-neutral-50);
   --primary-accent: var(--color-blue-400);
-  --secondary: var(--color-fuchsia-700);
+  --secondary: var(--color-neutral-800);
   --secondary-foreground: var(--color-neutral-50);
-  --secondary-accent: var(--color-fuchsia-400);
+  --secondary-accent: var(--color-neutral-50);
   --muted: var(--color-neutral-800);
   --muted-foreground: var(--color-neutral-400);
   --accent: var(--color-neutral-700);
@@ -1371,6 +1428,28 @@ async function setupStarwindProEnv() {
   const gitignoreResult = await setupGitignore();
   return envResult && gitignoreResult;
 }
+async function checkStarwindProEnv() {
+  const envExists = await fileExists(ENV_LOCAL_PATH);
+  if (!envExists) return false;
+  try {
+    const envContent = await fs4.readFile(ENV_LOCAL_PATH, "utf-8");
+    if (!hasStarwindLicenseKey(envContent)) return false;
+  } catch {
+    return false;
+  }
+  const gitignoreExists = await fileExists(GITIGNORE_PATH);
+  if (gitignoreExists) {
+    try {
+      const gitignoreContent = await fs4.readFile(GITIGNORE_PATH, "utf-8");
+      if (!hasEnvLocalInGitignore(gitignoreContent)) return false;
+    } catch {
+      return false;
+    }
+  } else {
+    return false;
+  }
+  return true;
+}
 
 // src/utils/layout.ts
 import * as p6 from "@clack/prompts";
@@ -1446,6 +1525,63 @@ async function setupLayoutCssImport(cssPath) {
   }
 }
 
+// src/utils/snippets.ts
+var THEME_TOGGLE_SNIPPET = {
+  "Starwind UI Theme Toggle": {
+    prefix: "starwind-theme-toggle",
+    description: "Starwind UI theme initialization script for the document head",
+    scope: "astro,typescript",
+    body: [
+      "<script is:inline>",
+      "  function initTheme() {",
+      '    const colorTheme = localStorage.getItem("colorTheme");',
+      "    if (!colorTheme) {",
+      '      if (window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches) {',
+      '        document.documentElement.classList.add("dark");',
+      '        localStorage.setItem("colorTheme", "dark");',
+      "      } else {",
+      '        document.documentElement.classList.remove("dark");',
+      '        localStorage.setItem("colorTheme", "light");',
+      "      }",
+      "    } else {",
+      '      if (colorTheme === "dark") {',
+      '        document.documentElement.classList.add("dark");',
+      '      } else if (colorTheme === "light") {',
+      '        document.documentElement.classList.remove("dark");',
+      '      } else if (colorTheme === "system") {',
+      '        const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;',
+      '        document.documentElement.classList.toggle("dark", prefersDark);',
+      "      }",
+      "    }",
+      "  }",
+      "",
+      "  initTheme();",
+      '  document.addEventListener("astro:after-swap", initTheme);',
+      "</script>"
+    ]
+  }
+};
+async function setupSnippets() {
+  await ensureDirectory(PATHS.VSCODE_DIR);
+  const targetPath = PATHS.VSCODE_SNIPPETS_FILE;
+  let existingSnippets = {};
+  if (await fileExists(targetPath)) {
+    try {
+      existingSnippets = await readJsonFile(targetPath);
+    } catch (error) {
+      existingSnippets = {};
+    }
+  }
+  const updatedSnippets = {
+    ...existingSnippets,
+    "Starwind UI Theme Toggle": {
+      ...THEME_TOGGLE_SNIPPET["Starwind UI Theme Toggle"]
+    }
+  };
+  await writeJsonFile(targetPath, updatedSnippets);
+  return true;
+}
+
 // src/utils/tsconfig.ts
 import * as p7 from "@clack/prompts";
 var REQUIRED_TSCONFIG = {
@@ -1617,6 +1753,7 @@ async function init(withinAdd = false, options) {
         }
       );
     }
+    const utilsDir = PATHS.LOCAL_UTILS_DIR;
     const cssFileDir = path2.dirname(configChoices.cssFile);
     const componentInstallDir = path2.join(configChoices.installLocation, "starwind");
     configTasks.push({
@@ -1628,6 +1765,14 @@ async function init(withinAdd = false, options) {
         return "Created project structure";
       }
     });
+    configTasks.push({
+      title: "Setting up VS Code snippets",
+      task: async () => {
+        await setupSnippets();
+        await sleep(250);
+        return "VS Code snippets configured";
+      }
+    });
     configTasks.push({
       title: "Setup Astro config file",
       task: async () => {
@@ -1712,6 +1857,7 @@ async function init(withinAdd = false, options) {
           // 	components: "@/components",
           // },
           componentDir: configChoices.installLocation,
+          utilsDir,
           components: []
         });
         await sleep(250);
@@ -1745,7 +1891,9 @@ async function init(withinAdd = false, options) {
         });
       } else {
         if (!withinAdd) {
-          p8.log.info(highlighter.info("Starwind Pro registry already configured"));
+          p8.log.warn(
+            `${highlighter.warn("Starwind Pro registry already configured.")} Use the ${highlighter.info("setup")} command to update your Pro configuration.`
+          );
         }
       }
     }
@@ -1829,7 +1977,7 @@ async function init(withinAdd = false, options) {
 Starwind Pro is now configured! You can install pro components using:
 ${highlighter.info("npx starwind@latest add @starwind-pro/component-name")}
 
-Make sure to set your ${highlighter.infoBright("STARWIND_LICENSE_KEY")} environment variable in ${highlighter.infoBright(".env.local")}.`;
+Make sure to set your ${highlighter.infoBright("STARWIND_LICENSE_KEY")} environment variable in ${highlighter.infoBright(".env.local")}`;
     }
     p8.note(nextStepsMessage, "Next steps");
     if (!withinAdd) {
@@ -2181,32 +2329,140 @@ ${results.removed.map((r) => `  ${r.name}`).join("\n")}`
   }
 }
 
-// src/commands/update.ts
+// src/commands/setup.ts
 import * as p11 from "@clack/prompts";
+async function setup(options) {
+  p11.intro(highlighter.title(" Using Starwind Setup "));
+  try {
+    const configExists = await fileExists(PATHS.LOCAL_CONFIG_FILE);
+    if (!configExists) {
+      const shouldInit = options?.yes ? true : await p11.confirm({
+        message: `Starwind configuration not found. Would you like to run ${highlighter.info("starwind init")} now?`,
+        initialValue: true
+      });
+      if (p11.isCancel(shouldInit)) {
+        p11.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      if (shouldInit) {
+        await init(true, { defaults: options?.yes, packageManager: options?.packageManager });
+      } else {
+        p11.log.error(
+          `Please initialize starwind with ${highlighter.info("starwind init")} before running setup`
+        );
+        process.exit(1);
+      }
+    }
+    const tasks4 = [
+      {
+        name: "Starwind Pro",
+        value: "pro",
+        flag: "pro",
+        description: "Setup Starwind Pro registry and environment",
+        run: runProSetup
+      }
+      // Future tasks (e.g., Prettier, ESLint) can be added here
+    ];
+    const selectedTasks = [];
+    if (options?.pro) {
+      const proTask = tasks4.find((t) => t.value === "pro");
+      if (proTask) selectedTasks.push(proTask);
+    } else {
+      const proTask = tasks4.find((t) => t.value === "pro");
+      if (proTask) selectedTasks.push(proTask);
+    }
+    if (selectedTasks.length === 0) {
+      p11.log.warn("No setup tasks selected.");
+      process.exit(0);
+    }
+    for (const task of selectedTasks) {
+      await task.run();
+    }
+  } catch (error) {
+    p11.log.error(error instanceof Error ? error.message : "Failed to run setup");
+    p11.cancel("Operation cancelled");
+    process.exit(1);
+  }
+}
+async function runProSetup() {
+  p11.log.info(highlighter.info("Setting up Starwind Pro..."));
+  const configTasks = [];
+  const hasRegistry = await hasStarwindProRegistry();
+  const hasEnv = await checkStarwindProEnv();
+  if (hasRegistry && hasEnv) {
+    p11.log.info(highlighter.info("Starwind Pro registry and environment already configured"));
+  } else {
+    let cssFile = PATHS.LOCAL_CSS_FILE;
+    let baseColor = "neutral";
+    try {
+      const config = await getConfig();
+      if (config.tailwind?.css) cssFile = config.tailwind.css;
+      if (config.tailwind?.baseColor) baseColor = config.tailwind.baseColor;
+    } catch {
+    }
+    if (!hasRegistry) {
+      configTasks.push({
+        title: "Setting up Starwind Pro registry",
+        task: async () => {
+          await setupShadcnProConfig(cssFile, baseColor);
+          await sleep(250);
+          return "Configured Starwind Pro registry in components.json";
+        }
+      });
+    }
+    if (!hasEnv) {
+      configTasks.push({
+        title: "Setting up Starwind Pro environment",
+        task: async () => {
+          const success = await setupStarwindProEnv();
+          if (!success) {
+            throw new Error("Failed to setup Starwind Pro environment");
+          }
+          await sleep(250);
+          return "Created .env.local and updated .gitignore";
+        }
+      });
+    }
+    if (configTasks.length > 0) {
+      await p11.tasks(configTasks);
+    }
+  }
+  await sleep(250);
+  const nextStepsMessage = `Starwind Pro is now configured! You can install pro components using:
+${highlighter.info("npx starwind@latest add @starwind-pro/component-name")}
+
+Make sure to set your ${highlighter.infoBright("STARWIND_LICENSE_KEY")} environment variable in ${highlighter.infoBright(".env.local")}`;
+  p11.note(nextStepsMessage, "Next steps");
+  await sleep(1e3);
+  p11.outro("Enjoy using Starwind UI with Pro components! \u{1F680}");
+}
+
+// src/commands/update.ts
+import * as p12 from "@clack/prompts";
 async function update(components, options) {
   try {
-    p11.intro(highlighter.title(" Welcome to the Starwind CLI "));
+    p12.intro(highlighter.title(" Welcome to the Starwind CLI "));
     const configExists = await fileExists(PATHS.LOCAL_CONFIG_FILE);
     if (!configExists) {
-      p11.log.error("No Starwind configuration found. Please run starwind init first.");
+      p12.log.error("No Starwind configuration found. Please run starwind init first.");
       process.exit(1);
     }
     const config = await getConfig();
     const installedComponents = config.components;
     if (installedComponents.length === 0) {
-      p11.log.warn("No components are currently installed.");
+      p12.log.warn("No components are currently installed.");
       process.exit(0);
     }
     let componentsToUpdate = [];
     if (options?.all) {
       componentsToUpdate = installedComponents.map((comp) => comp.name);
-      p11.log.info(`Checking updates for all ${componentsToUpdate.length} installed components...`);
+      p12.log.info(`Checking updates for all ${componentsToUpdate.length} installed components...`);
     } else if (components && components.length > 0) {
       const invalid = components.filter(
         (comp) => !installedComponents.some((ic) => ic.name === comp)
       );
       if (invalid.length > 0) {
-        p11.log.warn(
+        p12.log.warn(
           `${highlighter.warn("Components not found in project:")}
 ${invalid.map((name) => `  ${name}`).join("\n")}`
         );
@@ -2215,7 +2471,7 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         (comp) => installedComponents.some((ic) => ic.name === comp)
       );
       if (componentsToUpdate.length === 0) {
-        p11.log.warn("No valid components to update");
+        p12.log.warn("No valid components to update");
         process.exit(0);
       }
     } else {
@@ -2223,18 +2479,18 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         value: comp.name,
         label: comp.name
       }));
-      const selected = await p11.multiselect({
+      const selected = await p12.multiselect({
         message: "Select components to update",
         options: choices
       });
-      if (p11.isCancel(selected)) {
-        p11.cancel("Operation cancelled");
+      if (p12.isCancel(selected)) {
+        p12.cancel("Operation cancelled");
         process.exit(0);
       }
       componentsToUpdate = selected;
     }
     if (componentsToUpdate.length === 0) {
-      p11.log.warn("No components selected for update");
+      p12.log.warn("No components selected for update");
       process.exit(0);
     }
     const results = {
@@ -2285,45 +2541,45 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
           { appendComponents: false }
         );
       } catch (error) {
-        p11.log.error(
+        p12.log.error(
           `Failed to update config: ${error instanceof Error ? error.message : "Unknown error"}`
         );
         process.exit(1);
       }
     }
-    p11.log.message(`
+    p12.log.message(`
 
 ${highlighter.underline("Update Summary")}`);
     if (results.failed.length > 0) {
-      p11.log.error(
+      p12.log.error(
         `${highlighter.error("Failed to update components:")}
 ${results.failed.map((r) => `  ${r.name} - ${r.error}`).join("\n")}`
       );
     }
     if (results.skipped.length > 0) {
-      p11.log.info(
+      p12.log.info(
         `${highlighter.info("Components already up to date or skipped:")}
 ${results.skipped.map((r) => `  ${r.name} (${r.oldVersion})`).join("\n")}`
       );
     }
     if (results.updated.length > 0) {
-      p11.log.success(
+      p12.log.success(
         `${highlighter.success("Successfully updated components:")}
 ${results.updated.map((r) => `  ${r.name} (${r.oldVersion} \u2192 ${r.newVersion})`).join("\n")}`
       );
     }
     await sleep(1e3);
     if (results.updated.length > 0) {
-      p11.outro("Components updated successfully \u{1F680}");
+      p12.outro("Components updated successfully \u{1F680}");
     } else if (results.skipped.length > 0 && results.failed.length === 0) {
-      p11.outro("Components already up to date or skipped \u2728");
+      p12.outro("Components already up to date or skipped \u2728");
     } else {
-      p11.cancel("No components were updated");
+      p12.cancel("No components were updated");
       process.exit(1);
     }
   } catch (error) {
-    p11.log.error(error instanceof Error ? error.message : "Failed to update components");
-    p11.cancel("Operation cancelled");
+    p12.log.error(error instanceof Error ? error.message : "Failed to update components");
+    p12.cancel("Operation cancelled");
     process.exit(1);
   }
 }
@@ -2346,5 +2602,12 @@ program.command("update").description("Update Starwind components to their lates
   ])
 ).action(update);
 program.command("remove").description("Remove Starwind components from your project").argument("[components...]", "The components to remove (space separated)").allowExcessArguments().option("-a, --all", "Remove all installed components").action(remove);
+program.command("setup").description("Setup Starwind Pro in your project").option("-y, --yes", "Skip confirmation prompts").addOption(
+  new Option("-m, --package-manager <pm>", "Package manager to use").choices([
+    "npm",
+    "pnpm",
+    "yarn"
+  ])
+).option("-p, --pro", "Setup Starwind Pro (default)").action(setup);
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map