starwind 1.16.1 → 2.0.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command, Option } from "commander";
 // package.json
 var package_default = {
   name: "starwind",
-  version: "1.16.1",
+  version: "2.0.0",
   description: "Add beautifully designed components to your Astro applications",
   license: "MIT",
   homepage: "https://starwind.dev/",
@@ -44,7 +44,7 @@ var package_default = {
   scripts: {
     build: "tsup",
     dev: "tsup --watch",
-    "cli:link": "pnpm link --global",
+    "cli:link": "pnpm add --global . --ignore-scripts",
     "cli:unlink": "pnpm rm --global starwind",
     "cli:yalc:link": "yalc publish && yalc link @starwind-ui/core",
     "cli:yalc:unlink": "yalc remove @starwind-ui/core && yalc remove starwind",
@@ -60,7 +60,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^0.11.0",
-    "@starwind-ui/core": "1.16.1",
+    "@starwind-ui/core": "2.0.0",
     chalk: "^5.6.2",
     commander: "^14.0.2",
     execa: "^9.6.0",
@@ -76,7 +76,7 @@ var package_default = {
     tsup: "^8.5.1"
   },
   engines: {
-    node: "^20.6.0 || >=22.0.0"
+    node: ">=22.12.0"
   }
 };
 
@@ -90,6 +90,7 @@ var PATHS = {
   STARWIND_CORE: "@starwind-ui/core",
   STARWIND_CORE_COMPONENTS: "src/components",
   STARWIND_CORE_UTILS: "src/lib/utils",
+  STARWIND_DOCS_BASE_URL: "https://starwind.dev/docs/components",
   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",
@@ -724,7 +725,7 @@ async function getShadcnCommand() {
       return ["bunx", ["shadcn@3"]];
     case "npm":
     default:
-      return ["npx", ["shadcn@3"]];
+      return ["npx", ["-y", "shadcn@3"]];
   }
 }
 async function installDependencies(packages, pm, dev = false, force = false) {
@@ -909,7 +910,7 @@ async function installComponent(name, options) {
       }
     }
   }
-  const result = await copyComponent(name);
+  const result = await copyComponent(name, options?.overwrite);
   if (dependencyResults.length > 0) {
     return {
       ...result,
@@ -2069,11 +2070,21 @@ async function add(components, options) {
         };
         for (const registryComponent of registryComponents) {
           try {
-            p9.log.info(`Installing ${highlighter.info(registryComponent)} via shadcn...`);
-            await execa2(command, [...baseArgs, "add", registryComponent], {
-              stdio: "inherit",
-              cwd: process.cwd()
-            });
+            p9.log.info(`Installing ${highlighter.info(registryComponent)}`);
+            await execa2(
+              command,
+              [
+                ...baseArgs,
+                "add",
+                "--yes",
+                ...options?.overwrite ? ["--overwrite"] : [],
+                registryComponent
+              ],
+              {
+                stdio: "inherit",
+                cwd: process.cwd()
+              }
+            );
             registryResults.success.push(registryComponent);
           } catch (error) {
             registryResults.failed.push(registryComponent);
@@ -2150,6 +2161,7 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
       }
       const result = await installComponent(comp, {
         skipPrompts: options?.yes,
+        overwrite: options?.overwrite,
         packageManager: options?.packageManager
       });
       if (result.dependencyResults) {
@@ -2216,32 +2228,67 @@ ${registryResults.success.map((name) => `  ${name}`).join("\n")}`
   }
 }
 
-// src/commands/remove.ts
+// src/commands/docs.ts
 import * as p10 from "@clack/prompts";
+var DOCS_BASE_URL = "https://starwind.dev/docs/components";
+async function docs(components, options) {
+  if (!options?.json) {
+    p10.intro(highlighter.title(" Starwind Docs "));
+  }
+  try {
+    const registry = await getAllComponents();
+    const results = [];
+    for (const name of components) {
+      const exists = registry.find((c) => c.name === name);
+      if (!exists) {
+        p10.log.error(`Component ${highlighter.info(name)} not found in the Starwind registry.`);
+        process.exit(1);
+      }
+      results.push({ component: name, url: `${DOCS_BASE_URL}/${name}/` });
+    }
+    if (options?.json) {
+      console.log(JSON.stringify(results, null, 2));
+      return;
+    }
+    const maxNameLength = Math.max(...results.map((r) => r.component.length));
+    p10.log.message(highlighter.underline("Documentation links"));
+    for (const { component, url } of results) {
+      p10.log.info(`  ${highlighter.info(component.padEnd(maxNameLength + 2))}${url}`);
+    }
+    p10.outro(`Found docs for ${results.length} component${results.length === 1 ? "" : "s"}`);
+  } catch (error) {
+    p10.log.error(error instanceof Error ? error.message : "Failed to fetch documentation");
+    p10.cancel("Operation cancelled");
+    process.exit(1);
+  }
+}
+
+// src/commands/remove.ts
+import * as p11 from "@clack/prompts";
 async function remove(components, options) {
   try {
-    p10.intro(highlighter.title(" Welcome to the Starwind CLI "));
+    p11.intro(highlighter.title(" Welcome to the Starwind CLI "));
     const configExists = await fileExists(PATHS.LOCAL_CONFIG_FILE);
     if (!configExists) {
-      p10.log.error("No Starwind configuration found. Please run starwind init first.");
+      p11.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) {
-      p10.log.warn("No components are currently installed.");
+      p11.log.warn("No components are currently installed.");
       process.exit(0);
     }
     let componentsToRemove = [];
     if (options?.all) {
       componentsToRemove = installedComponents.map((comp) => comp.name);
-      p10.log.info(`Removing all ${componentsToRemove.length} installed components...`);
+      p11.log.info(`Removing all ${componentsToRemove.length} installed components...`);
     } else if (components && components.length > 0) {
       const invalid = components.filter(
         (comp) => !installedComponents.some((ic) => ic.name === comp)
       );
       if (invalid.length > 0) {
-        p10.log.warn(
+        p11.log.warn(
           `${highlighter.warn("Components not found:")}
 ${invalid.map((name) => `  ${name}`).join("\n")}`
         );
@@ -2250,7 +2297,7 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         (comp) => installedComponents.some((ic) => ic.name === comp)
       );
       if (componentsToRemove.length === 0) {
-        p10.log.warn("No valid components to remove");
+        p11.log.warn("No valid components to remove");
         process.exit(0);
       }
     } else {
@@ -2258,25 +2305,25 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         value: comp.name,
         label: comp.name
       }));
-      const selected = await p10.multiselect({
+      const selected = await p11.multiselect({
         message: "Select components to remove",
         options: choices
       });
-      if (p10.isCancel(selected)) {
-        p10.cancel("Operation cancelled");
+      if (p11.isCancel(selected)) {
+        p11.cancel("Operation cancelled");
         process.exit(0);
       }
       componentsToRemove = selected;
     }
     if (componentsToRemove.length === 0) {
-      p10.log.warn("No components selected for removal");
+      p11.log.warn("No components selected for removal");
       process.exit(0);
     }
-    const confirmed = await p10.confirm({
+    const confirmed = await p11.confirm({
       message: `Remove ${componentsToRemove.map((comp) => highlighter.info(comp)).join(", ")} ${componentsToRemove.length > 1 ? "components" : "component"}?`
     });
-    if (!confirmed || p10.isCancel(confirmed)) {
-      p10.cancel("Operation cancelled");
+    if (!confirmed || p11.isCancel(confirmed)) {
+      p11.cancel("Operation cancelled");
       process.exit(0);
     }
     const results = {
@@ -2301,60 +2348,295 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
       },
       { appendComponents: false }
     );
-    p10.log.message(`
+    p11.log.message(`
 
 ${highlighter.underline("Removal Summary")}`);
     if (results.failed.length > 0) {
-      p10.log.error(
+      p11.log.error(
         `${highlighter.error("Failed to remove components:")}
 ${results.failed.map((r) => `  ${r.name} - ${r.error}`).join("\n")}`
       );
     }
     if (results.removed.length > 0) {
-      p10.log.success(
+      p11.log.success(
         `${highlighter.success("Successfully removed components:")}
 ${results.removed.map((r) => `  ${r.name}`).join("\n")}`
       );
     }
     await sleep(1e3);
     if (results.removed.length > 0) {
-      p10.outro("Components removed successfully \u{1F5D1}\uFE0F");
+      p11.outro("Components removed successfully \u{1F5D1}\uFE0F");
     } else {
-      p10.cancel("Errors occurred while removing components");
+      p11.cancel("Errors occurred while removing components");
       process.exit(1);
     }
   } catch (error) {
-    p10.log.error(error instanceof Error ? error.message : "Failed to remove components");
-    p10.cancel("Operation cancelled");
+    p11.log.error(error instanceof Error ? error.message : "Failed to remove components");
+    p11.cancel("Operation cancelled");
+    process.exit(1);
+  }
+}
+
+// src/commands/search.ts
+import * as p12 from "@clack/prompts";
+
+// src/utils/pro-manifest.ts
+import { z as z2 } from "zod";
+var manifestBlockSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  description: z2.string(),
+  categories: z2.array(z2.string()),
+  keywords: z2.array(z2.string()),
+  plan: z2.enum(["free", "pro"]),
+  installCommand: z2.string(),
+  previewUrl: z2.string()
+});
+var manifestSchema = z2.object({
+  $schema: z2.string().optional(),
+  name: z2.string(),
+  version: z2.string(),
+  generatedAt: z2.string(),
+  baseUrl: z2.string(),
+  totalBlocks: z2.number(),
+  categories: z2.array(z2.string()),
+  blocks: z2.array(manifestBlockSchema)
+});
+var MANIFEST_URL = "https://pro.starwind.dev/r/manifest.json";
+var CACHE_TTL_MS = 60 * 60 * 1e3;
+var manifestCache = null;
+async function getProManifest() {
+  if (manifestCache && Date.now() < manifestCache.expiresAt) {
+    return { manifest: manifestCache.data, source: "cache" };
+  }
+  try {
+    const response = await fetch(MANIFEST_URL);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch manifest: ${response.status} ${response.statusText}`);
+    }
+    const raw = await response.json();
+    const manifest = manifestSchema.parse(raw);
+    manifestCache = {
+      data: manifest,
+      timestamp: Date.now(),
+      expiresAt: Date.now() + CACHE_TTL_MS
+    };
+    return { manifest, source: "network" };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new Error(`Error fetching Starwind Pro manifest: ${message}`);
+  }
+}
+function scoreBlockMatch(block, query) {
+  const q = query.toLowerCase();
+  let score = 0;
+  if (block.name.toLowerCase() === q) score += 100;
+  else if (block.name.toLowerCase().includes(q)) score += 50;
+  if (block.id.toLowerCase().includes(q)) score += 40;
+  if (block.keywords.some((k) => k.toLowerCase() === q)) score += 30;
+  if (block.keywords.some((k) => k.toLowerCase().includes(q))) score += 20;
+  if (block.description.toLowerCase().includes(q)) score += 10;
+  if (block.categories.some((c) => c.toLowerCase().includes(q))) score += 15;
+  return score;
+}
+async function searchProBlocks(options = {}) {
+  const { query, category, plan, limit = 50, offset = 0 } = options;
+  const { manifest } = await getProManifest();
+  let results = [...manifest.blocks];
+  if (category) {
+    const catLower = category.toLowerCase();
+    results = results.filter((b) => b.categories.some((c) => c.toLowerCase() === catLower));
+  }
+  if (plan) {
+    results = results.filter((b) => b.plan === plan);
+  }
+  if (query) {
+    const scored = results.map((block) => ({ block, score: scoreBlockMatch(block, query) })).filter(({ score }) => score > 0).sort((a, b) => b.score - a.score);
+    results = scored.map(({ block }) => block);
+  }
+  const effectiveLimit = Math.min(Math.max(1, limit), 50);
+  const effectiveOffset = Math.max(0, offset);
+  return results.slice(effectiveOffset, effectiveOffset + effectiveLimit);
+}
+
+// src/commands/search.ts
+async function search(query, options) {
+  if (!options?.json) {
+    p12.intro(highlighter.title(" Starwind Search "));
+  }
+  try {
+    const proOnly = !!(options?.category || options?.plan);
+    let proBlocks = [];
+    let matchedComponents = [];
+    if (options?.json) {
+      proBlocks = await searchProBlocks({
+        query,
+        category: options?.category,
+        plan: options?.plan,
+        limit: options?.limit ?? 20,
+        offset: options?.offset ?? 0
+      });
+      if (!proOnly) {
+        const coreComponents = await getAllComponents();
+        if (query) {
+          const q = query.toLowerCase();
+          matchedComponents = coreComponents.filter(
+            (c) => c.name.toLowerCase().includes(q) || (c.dependencies ?? []).some((dep) => dep.toLowerCase().includes(q))
+          );
+        } else {
+          matchedComponents = coreComponents;
+        }
+      }
+    } else {
+      const searchTasks = [
+        {
+          title: "Searching Starwind Pro blocks",
+          task: async () => {
+            proBlocks = await searchProBlocks({
+              query,
+              category: options?.category,
+              plan: options?.plan,
+              limit: options?.limit ?? 20,
+              offset: options?.offset ?? 0
+            });
+            return `Found ${proBlocks.length} Pro block${proBlocks.length === 1 ? "" : "s"}`;
+          }
+        }
+      ];
+      if (!proOnly) {
+        searchTasks.push({
+          title: "Searching core components",
+          task: async () => {
+            const coreComponents = await getAllComponents();
+            if (query) {
+              const q = query.toLowerCase();
+              matchedComponents = coreComponents.filter(
+                (c) => c.name.toLowerCase().includes(q) || (c.dependencies ?? []).some((dep) => dep.toLowerCase().includes(q))
+              );
+            } else {
+              matchedComponents = coreComponents;
+            }
+            return `Found ${matchedComponents.length} core component${matchedComponents.length === 1 ? "" : "s"}`;
+          }
+        });
+      }
+      await p12.tasks(searchTasks);
+    }
+    if (options?.json) {
+      console.log(
+        JSON.stringify(
+          {
+            query: query || null,
+            filters: {
+              category: options?.category || null,
+              plan: options?.plan || null,
+              limit: options?.limit ?? 20
+            },
+            proBlocks: {
+              total: proBlocks.length,
+              results: proBlocks.map((b) => ({
+                id: b.id,
+                name: b.name,
+                description: b.description,
+                categories: b.categories,
+                plan: b.plan,
+                installCommand: b.installCommand + " --yes"
+              }))
+            },
+            coreComponents: {
+              total: matchedComponents.length,
+              results: matchedComponents.map((c) => ({
+                name: c.name,
+                version: c.version,
+                dependencies: c.dependencies,
+                docsUrl: `${PATHS.STARWIND_DOCS_BASE_URL}/${c.name}/`
+              }))
+            },
+            proSetupTip: "Run `starwind setup` to enable Starwind Pro blocks"
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    const hasPro = proBlocks.length > 0;
+    const hasCore = matchedComponents.length > 0;
+    if (!hasPro && !hasCore) {
+      p12.log.warn("No results found for your search.");
+      p12.outro("Try a different query or browse all categories.");
+      return;
+    }
+    if (hasPro) {
+      p12.log.message(highlighter.underline("Pro Blocks"));
+      const maxNameLen = Math.max(...proBlocks.map((b) => b.name.length));
+      for (const block of proBlocks) {
+        const planBadge = block.plan === "pro" ? highlighter.info("[pro] ") : highlighter.success("[free]");
+        const paddedName = block.name.padEnd(maxNameLen + 2);
+        p12.log.info(`  ${highlighter.info(paddedName)}${planBadge} ${block.installCommand}`);
+      }
+      console.log();
+    }
+    if (hasCore) {
+      p12.log.message(highlighter.underline("Core Components"));
+      const maxNameLen = Math.max(...matchedComponents.map((c) => c.name.length));
+      for (const comp of matchedComponents) {
+        const paddedName = comp.name.padEnd(maxNameLen + 2);
+        p12.log.info(`  ${highlighter.info(paddedName)}starwind add ${comp.name}`);
+      }
+      console.log();
+    }
+    if (proBlocks.length > 0) {
+      const proConfigured = await hasStarwindProRegistry();
+      const hasPaidBlocks = proBlocks.some((b) => b.plan === "pro");
+      if (!proConfigured) {
+        p12.note(
+          `Pro blocks require Starwind Pro setup.
+Run ${highlighter.info("starwind setup")} to configure.`,
+          "Pro Tip"
+        );
+      } else if (hasPaidBlocks) {
+        p12.note(
+          `Unlock premium blocks at ${highlighter.info("https://pro.starwind.dev/")}`,
+          "Pro Tip"
+        );
+      }
+    }
+    p12.outro(
+      `Found ${proBlocks.length + matchedComponents.length} result${proBlocks.length + matchedComponents.length === 1 ? "" : "s"} \u{1F50E}`
+    );
+  } catch (error) {
+    p12.log.error(error instanceof Error ? error.message : "Failed to search");
+    p12.cancel("Operation cancelled");
     process.exit(1);
   }
 }
 
 // src/commands/setup.ts
-import * as p11 from "@clack/prompts";
+import * as p13 from "@clack/prompts";
 async function setup(options) {
-  p11.intro(highlighter.title(" Using Starwind Setup "));
+  p13.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({
+      const shouldInit = options?.yes ? true : await p13.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");
+      if (p13.isCancel(shouldInit)) {
+        p13.cancel("Operation cancelled");
         process.exit(0);
       }
       if (shouldInit) {
         await init(true, { defaults: options?.yes, packageManager: options?.packageManager });
       } else {
-        p11.log.error(
+        p13.log.error(
           `Please initialize starwind with ${highlighter.info("starwind init")} before running setup`
         );
         process.exit(1);
       }
     }
-    const tasks4 = [
+    const tasks5 = [
       {
         name: "Starwind Pro",
         value: "pro",
@@ -2366,32 +2648,32 @@ async function setup(options) {
     ];
     const selectedTasks = [];
     if (options?.pro) {
-      const proTask = tasks4.find((t) => t.value === "pro");
+      const proTask = tasks5.find((t) => t.value === "pro");
       if (proTask) selectedTasks.push(proTask);
     } else {
-      const proTask = tasks4.find((t) => t.value === "pro");
+      const proTask = tasks5.find((t) => t.value === "pro");
       if (proTask) selectedTasks.push(proTask);
     }
     if (selectedTasks.length === 0) {
-      p11.log.warn("No setup tasks selected.");
+      p13.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");
+    p13.log.error(error instanceof Error ? error.message : "Failed to run setup");
+    p13.cancel("Operation cancelled");
     process.exit(1);
   }
 }
 async function runProSetup() {
-  p11.log.info(highlighter.info("Setting up Starwind Pro..."));
+  p13.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"));
+    p13.log.info(highlighter.info("Starwind Pro registry and environment already configured"));
   } else {
     let cssFile = PATHS.LOCAL_CSS_FILE;
     let baseColor = "neutral";
@@ -2425,7 +2707,7 @@ async function runProSetup() {
       });
     }
     if (configTasks.length > 0) {
-      await p11.tasks(configTasks);
+      await p13.tasks(configTasks);
     }
   }
   await sleep(250);
@@ -2433,37 +2715,37 @@ async function runProSetup() {
 ${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");
+  p13.note(nextStepsMessage, "Next steps");
   await sleep(1e3);
-  p11.outro("Enjoy using Starwind UI with Pro components! \u{1F680}");
+  p13.outro("Enjoy using Starwind UI with Pro components! \u{1F680}");
 }
 
 // src/commands/update.ts
-import * as p12 from "@clack/prompts";
+import * as p14 from "@clack/prompts";
 async function update(components, options) {
   try {
-    p12.intro(highlighter.title(" Welcome to the Starwind CLI "));
+    p14.intro(highlighter.title(" Welcome to the Starwind CLI "));
     const configExists = await fileExists(PATHS.LOCAL_CONFIG_FILE);
     if (!configExists) {
-      p12.log.error("No Starwind configuration found. Please run starwind init first.");
+      p14.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) {
-      p12.log.warn("No components are currently installed.");
+      p14.log.warn("No components are currently installed.");
       process.exit(0);
     }
     let componentsToUpdate = [];
     if (options?.all) {
       componentsToUpdate = installedComponents.map((comp) => comp.name);
-      p12.log.info(`Checking updates for all ${componentsToUpdate.length} installed components...`);
+      p14.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) {
-        p12.log.warn(
+        p14.log.warn(
           `${highlighter.warn("Components not found in project:")}
 ${invalid.map((name) => `  ${name}`).join("\n")}`
         );
@@ -2472,7 +2754,7 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         (comp) => installedComponents.some((ic) => ic.name === comp)
       );
       if (componentsToUpdate.length === 0) {
-        p12.log.warn("No valid components to update");
+        p14.log.warn("No valid components to update");
         process.exit(0);
       }
     } else {
@@ -2480,18 +2762,18 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
         value: comp.name,
         label: comp.name
       }));
-      const selected = await p12.multiselect({
+      const selected = await p14.multiselect({
         message: "Select components to update",
         options: choices
       });
-      if (p12.isCancel(selected)) {
-        p12.cancel("Operation cancelled");
+      if (p14.isCancel(selected)) {
+        p14.cancel("Operation cancelled");
         process.exit(0);
       }
       componentsToUpdate = selected;
     }
     if (componentsToUpdate.length === 0) {
-      p12.log.warn("No components selected for update");
+      p14.log.warn("No components selected for update");
       process.exit(0);
     }
     const results = {
@@ -2542,45 +2824,45 @@ ${invalid.map((name) => `  ${name}`).join("\n")}`
           { appendComponents: false }
         );
       } catch (error) {
-        p12.log.error(
+        p14.log.error(
           `Failed to update config: ${error instanceof Error ? error.message : "Unknown error"}`
         );
         process.exit(1);
       }
     }
-    p12.log.message(`
+    p14.log.message(`
 
 ${highlighter.underline("Update Summary")}`);
     if (results.failed.length > 0) {
-      p12.log.error(
+      p14.log.error(
         `${highlighter.error("Failed to update components:")}
 ${results.failed.map((r) => `  ${r.name} - ${r.error}`).join("\n")}`
       );
     }
     if (results.skipped.length > 0) {
-      p12.log.info(
+      p14.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) {
-      p12.log.success(
+      p14.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) {
-      p12.outro("Components updated successfully \u{1F680}");
+      p14.outro("Components updated successfully \u{1F680}");
     } else if (results.skipped.length > 0 && results.failed.length === 0) {
-      p12.outro("Components already up to date or skipped \u2728");
+      p14.outro("Components already up to date or skipped \u2728");
     } else {
-      p12.cancel("No components were updated");
+      p14.cancel("No components were updated");
       process.exit(1);
     }
   } catch (error) {
-    p12.log.error(error instanceof Error ? error.message : "Failed to update components");
-    p12.cancel("Operation cancelled");
+    p14.log.error(error instanceof Error ? error.message : "Failed to update components");
+    p14.cancel("Operation cancelled");
     process.exit(1);
   }
 }
@@ -2588,13 +2870,30 @@ ${results.updated.map((r) => `  ${r.name} (${r.oldVersion} \u2192 ${r.newVersion
 // src/index.ts
 var program = new Command().name("starwind").description("Add beautifully designed components to your Astro applications").version(package_default.version);
 program.command("init").description("Initialize your project with Starwind").option("-d, --defaults", "Use default values for all prompts").option("-p, --pro", "Initialize with Starwind Pro setup").action((options) => init(false, { defaults: options.defaults, pro: options.pro }));
-program.command("add").description("Add Starwind components to your project").argument("[components...]", "The components to add (space separated)").allowExcessArguments().option("-a, --all", "Add all available components").option("-y, --yes", "Skip confirmation prompts").addOption(
+program.command("add").description("Add Starwind components to your project").argument("[components...]", "The components to add (space separated)").allowExcessArguments().option("-a, --all", "Add all available components").option("-y, --yes", "Skip confirmation prompts").option("-o, --overwrite", "Overwrite existing files").addOption(
   new Option("-m, --package-manager <pm>", "Package manager to use").choices([
     "npm",
     "pnpm",
     "yarn"
   ])
 ).action(add);
+program.command("docs").description("Open documentation for Starwind components").argument("[components...]", "The components to look up (space separated)").allowExcessArguments().option("--json", "Output as JSON").action(docs);
+program.command("search").description("Search Starwind components and Pro blocks").argument("[query]", "Search query string").allowExcessArguments().option("-p, --plan <plan>", "Filter Pro blocks by plan type (free or pro)").option("-c, --category <category>", "Filter Pro blocks by category").option("-l, --limit <number>", "Maximum number of Pro blocks to display", "20").option("-o, --offset <number>", "Offset for paginating Pro block results", "0").option("--json", "Output as JSON").action(
+  async (query, opts) => {
+    const parsedLimit = Math.min(Math.max(parseInt(opts.limit, 10) || 20, 1), 50);
+    const parsedOffset = Math.max(parseInt(opts.offset, 10) || 0, 0);
+    if (opts.plan && opts.plan !== "free" && opts.plan !== "pro") {
+      program.error(`Invalid plan "${opts.plan}". Must be "free" or "pro".`);
+    }
+    await search(query, {
+      plan: opts.plan,
+      category: opts.category,
+      limit: parsedLimit,
+      offset: parsedOffset,
+      json: opts.json
+    });
+  }
+);
 program.command("update").description("Update Starwind components to their latest versions").argument("[components...]", "The components to update (space separated)").allowExcessArguments().option("-a, --all", "Update all installed components").option("-y, --yes", "Skip confirmation prompts").addOption(
   new Option("-m, --package-manager <pm>", "Package manager to use").choices([
     "npm",