starwind 1.15.5 → 1.16.1

package/README.md

@@ -4,7 +4,7 @@
 
 **Create animated websites in record time.**
 
-Starwind UI is a collection of 42+ beautifully designed, animated, and accessible components built purely with Astro and vanilla JS. Inspired by [shadcn/ui](https://ui.shadcn.com/), components are added directly to your codebase, giving you full ownership and complete control.
+Starwind UI is a collection of 45+ beautifully designed, animated, and accessible components built purely with Astro and vanilla JS. Inspired by [shadcn/ui](https://ui.shadcn.com/), components are added directly to your codebase, giving you full ownership and complete control.
 
 **[Get Started →](https://starwind.dev/docs/getting-started/installation/)**  |  **[Explore Components](https://starwind.dev/docs/components/)**
 

package/dist/index.js

@@ -6,9 +6,10 @@ import { Command, Option } from "commander";
 // package.json
 var package_default = {
   name: "starwind",
-  version: "1.15.5",
+  version: "1.16.1",
   description: "Add beautifully designed components to your Astro applications",
   license: "MIT",
+  homepage: "https://starwind.dev/",
   author: {
     name: "webreaper",
     url: "https://x.com/BowTiedWebReapr"
@@ -20,15 +21,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 +60,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^0.11.0",
-    "@starwind-ui/core": "1.15.5",
+    "@starwind-ui/core": "1.16.1",
     chalk: "^5.6.2",
     commander: "^14.0.2",
     execa: "^9.6.0",
@@ -87,12 +89,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 +146,7 @@ var defaultConfig = {
   // 	components: "@/components",
   // },
   componentDir: "src/components/starwind",
+  utilsDir: PATHS.LOCAL_UTILS_DIR,
   components: []
 };
 async function getConfig() {
@@ -182,6 +189,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 +234,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 +283,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 +358,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 +1158,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 +1199,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);
@@ -1468,6 +1526,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 = {
@@ -1639,6 +1754,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({
@@ -1650,6 +1766,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 () => {
@@ -1734,6 +1858,7 @@ async function init(withinAdd = false, options) {
           // 	components: "@/components",
           // },
           componentDir: configChoices.installLocation,
+          utilsDir,
           components: []
         });
         await sleep(250);