@mindfiredigital/ignix-lite-cli 1.1.0

package/dist/index.js

@@ -0,0 +1,828 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/init.ts
+import fs from "fs";
+import path from "path";
+import prompts from "prompts";
+import pc from "picocolors";
+import ora from "ora";
+async function initCommand() {
+  console.log(
+    pc.cyan("Welcome to Ignix-Lite! Let's get your project set up.\n")
+  );
+  const response = await prompts([
+    {
+      type: "select",
+      name: "framework",
+      message: "Which framework are you using?",
+      choices: [
+        { title: "React", value: "react" },
+        { title: "Vue", value: "vue" },
+        { title: "Svelte", value: "svelte" },
+        { title: "Vanilla HTML", value: "vanilla" }
+      ]
+    },
+    {
+      type: "text",
+      name: "stylePath",
+      message: "Path to your main CSS file (where Ignix-Lite variables will be added):",
+      initial: "src/index.css"
+    },
+    {
+      type: "text",
+      name: "primaryColor",
+      message: "Default primary theme color (hex):",
+      initial: "#6366f1",
+      validate: (value) => {
+        const hexRegex = /^#([A-Fa-f0-9]{3}|[A-Fa-f0-9]{6})$/;
+        return hexRegex.test(value) ? true : "Please enter a valid hex color code (e.g. #6366f1 or #fff)";
+      }
+    }
+  ]);
+  if (!response.framework || !response.stylePath) {
+    console.log(pc.red("\nSetup cancelled."));
+    return;
+  }
+  const spinner = ora("Initializing project...").start();
+  const config = {
+    framework: response.framework,
+    style: response.stylePath,
+    theme: {
+      primary: response.primaryColor
+    }
+  };
+  fs.writeFileSync("ignix.config.json", JSON.stringify(config, null, 2));
+  const cssDir = path.dirname(response.stylePath);
+  if (!fs.existsSync(cssDir)) {
+    fs.mkdirSync(cssDir, { recursive: true });
+  }
+  const defaultThemeVars = `/* Ignix-Lite Custom Theme Variables */
+:root {
+  --ix-primary: ${response.primaryColor};
+  --ix-primary-hover: ${response.primaryColor}d0;
+  --ix-primary-contrast: #ffffff;
+  --ix-primary-bg: ${response.primaryColor}1a;
+}
+`;
+  if (fs.existsSync(response.stylePath)) {
+    let content = fs.readFileSync(response.stylePath, "utf-8");
+    if (!content.includes("--ix-primary")) {
+      content = defaultThemeVars + "\n" + content;
+      fs.writeFileSync(response.stylePath, content);
+    }
+  } else {
+    fs.writeFileSync(response.stylePath, defaultThemeVars);
+  }
+  spinner.succeed(pc.green("Ignix-Lite initialized successfully!"));
+  console.log(`
+Created ${pc.blue("ignix.config.json")}`);
+  console.log(`Updated theme variables in ${pc.blue(response.stylePath)}`);
+}
+
+// src/commands/theme.ts
+import fs2 from "fs";
+import path2 from "path";
+import pc2 from "picocolors";
+import ora2 from "ora";
+import { resolveTokens, buildCss } from "@mindfiredigital/ignix-lite-engine";
+async function themeCommand(prompt, options = {}) {
+  const spinner = ora2("Generating theme tokens...").start();
+  let stylePath = options.styleFile;
+  if (!stylePath) {
+    const configPath = "ignix.config.json";
+    if (!fs2.existsSync(configPath)) {
+      spinner.fail(
+        pc2.red(
+          'ignix.config.json not found. Run "ignix-lite init" first or specify --style-file.'
+        )
+      );
+      return;
+    }
+    try {
+      const config = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
+      stylePath = config.style;
+    } catch {
+      spinner.fail(pc2.red("Failed to read ignix.config.json."));
+      return;
+    }
+  }
+  if (!stylePath) {
+    spinner.fail(
+      pc2.red("Style path not configured. Specify -s or --style-file option.")
+    );
+    return;
+  }
+  const queryParts = [prompt || "", options.primary || ""].filter(Boolean);
+  const query = queryParts.join(" ").trim();
+  if (!query) {
+    spinner.fail(
+      pc2.yellow(
+        'Please provide a prompt or primary color, e.g.: ignix-lite theme "dark round blue"'
+      )
+    );
+    return;
+  }
+  try {
+    const tokens = resolveTokens(query);
+    const cssBlock = buildCss(tokens);
+    const absoluteStylePath = path2.resolve(process.cwd(), stylePath);
+    if (!absoluteStylePath.startsWith(process.cwd())) {
+      spinner.fail(
+        pc2.red("Error: Style file path must be within the project workspace.")
+      );
+      return;
+    }
+    const cssDir = path2.dirname(absoluteStylePath);
+    if (!fs2.existsSync(cssDir)) {
+      fs2.mkdirSync(cssDir, { recursive: true });
+    }
+    const themeRegex = /\/\* Ignix-Lite Custom Theme Variables \*\/[\s\S]*?\}\n?/g;
+    if (fs2.existsSync(absoluteStylePath)) {
+      let content = fs2.readFileSync(absoluteStylePath, "utf-8");
+      if (themeRegex.test(content)) {
+        content = content.replace(themeRegex, cssBlock + "\n");
+      } else {
+        content = cssBlock + "\n\n" + content;
+      }
+      fs2.writeFileSync(absoluteStylePath, content);
+    } else {
+      fs2.writeFileSync(absoluteStylePath, cssBlock);
+    }
+    spinner.succeed(
+      pc2.green(`Theme successfully updated in ${pc2.blue(stylePath)}`)
+    );
+    console.log(pc2.gray(`Resolved primary color: ${tokens.resolvedPrimary}`));
+    console.log(pc2.gray(`Mode: ${tokens.isDark ? "Dark" : "Light"}
+`));
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    spinner.fail(pc2.red(`Failed to generate theme: ${msg}`));
+  }
+}
+
+// src/commands/add.ts
+import pc3 from "picocolors";
+var COMPONENT_TEMPLATES = {
+  accordion: `<details>
+                    <summary>Accordion Title</summary>
+                    <p>Accordion contents goes here...</p>
+                </details>`,
+  alert: `<aside data-intent="info">
+                <strong>Head's up!</strong>
+                <span>This is a semantic alert component</span>
+            </aside>`,
+  avatar: `<span data-size="md">JD</span>`,
+  badge: `<mark data-intent="success">Saved</mark>`,
+  breadcrumb: `<nav aria-label="Breadcrumb">
+                    <ol>
+                        <li><a href="/">Home</a></li>
+                        <li><a href="/docs" aria-current="page">Docs</a></li>
+                    </ol>
+                </nav>`,
+  button: `<button data-intent="primary">Save</button>`,
+  card: `<article>
+            <h2 slot="title">Card Title</h2>
+            <p slot="body">
+                This is the main card body content.
+            </p>
+        </article>`,
+  checkbox: `<label>
+                <input type="checkbox" />
+                Remember me
+            </label>`,
+  codeblock: `<pre><code data-lang="typescript">const greet = () => "Hello World";</code></pre>`,
+  combobox: `<ix-combobox>
+                    <label slot="control">
+                        Search
+                        <input type="text" placeholder="Search options..." />
+                    </label>
+                    <ul hidden>
+                        <li data-value="1">Option A</li>
+                        <li data-value="2">Option B</li>
+                    </ul>
+                </ix-combobox>`,
+  dialog: `<dialog id="confirm-modal" data-intent="danger">
+                <h2>Confirm Action</h2>
+                <p>Are you sure you want to proceed?</p>
+                <button>Cancel</button>
+                <button>Delete</button>
+            </dialog>`,
+  divider: `<hr />`,
+  dropdown: `<ix-dropdown>
+                <button slot="trigger">Options \u25BE</button>
+                <ul slot="menu" hidden>
+                    <li><button>Profile</button></li>
+                    <li><button>Settings</button></li>
+                </ul>
+            </ix-dropdown>`,
+  form: `<form>
+            <label>
+                Name
+                <input type="text" required />
+            </label>
+            <button type="submit" data-intent="primary">Submit</button>
+            </form>`,
+  grid: `<section data-grid="3">
+            <section>Column 1</section>
+            <section>Column 2</section>
+            <section>Column 3</section>
+            </section>`,
+  input: `<label>
+                Username
+            <input type="text" required placeholder="Enter Username..." />
+            </label>`,
+  meter: `<meter value="70" min="0" max="100" low="30" high="70" optimum="100"></meter>`,
+  navigation: `<nav aria-label="Main Navigation">
+                    <ul>
+                        <li><a href="/" aria-current="page">Home</a></li>
+                        <li><a href="/docs">Docs</a></li>
+                        <li><a href="/blog">Blog</a></li>
+                    </ul>
+                </nav>`,
+  progress: `<progress value="50" max="100"></progress>`,
+  radio: `<label>
+                <input type="radio" name="options" value="a" />
+                Option A
+            </label>`,
+  select: `<label>
+                Options
+                <select data-intent="primary">
+                    <option value="1">Option 1</option>
+                    <option value="2">Option 2</option>
+                </select>
+            </label>`,
+  skeleton: `<span aria-busy="true" data-shape="text"></span>`,
+  tabs: `<ix-tabs>
+                <button slot="tab" aria-selected="true">Tab 1</button>
+                <button slot="tab">Tab 2</button>
+                <section slot="panel">Content for Tab 1</section>
+                <section slot="panel" hidden>Content for Tab 2</section>
+            </ix-tabs>`,
+  table: `<table>
+            <thead>
+                <tr>
+                    <th>Name</th>
+                    <th>Role</th>
+                </tr>
+            </thead>
+            <tbody>
+                <tr>
+                    <td>Alice</td>
+                    <td>Developer</td>
+                </tr>
+            </tbody>
+            </table>`,
+  textarea: `<label>
+                Message
+                <textarea data-intent="primary" placeholder="Enter your message..."></textarea>
+              </label>`,
+  toast: `<ix-toast>
+                <aside data-intent="success" data-open="true">
+                    <strong>Success!</strong>
+                    <span>Action completed.</span>
+                </aside>
+            </ix-toast>`,
+  tooltip: `<ix-tooltip content="Helpful information">
+                <span>Hover me</span>
+            </ix-tooltip>`
+};
+async function addCommand(component) {
+  const normalized = component.toLowerCase().trim();
+  const template = COMPONENT_TEMPLATES[normalized];
+  if (!template) {
+    console.log(pc3.red(`Component "${component}" not found.`));
+    console.log(
+      pc3.yellow(
+        `Available components : ${Object.keys(COMPONENT_TEMPLATES).join(", ")}`
+      )
+    );
+    return;
+  }
+  console.log(pc3.cyan(`
+Template for <${component}>:
+`));
+  console.log(template);
+  console.log("\n");
+}
+
+// src/commands/validate.ts
+import { readFileSync, existsSync } from "fs";
+import path3 from "path";
+import pc4 from "picocolors";
+import { validateHtml } from "@mindfiredigital/ignix-lite-engine";
+async function validateCommand(filePath) {
+  const absolutePath = path3.resolve(process.cwd(), filePath);
+  if (!existsSync(absolutePath)) {
+    console.log(pc4.red(`Error: File not found at ${filePath}`));
+    process.exit(1);
+  }
+  const html = readFileSync(absolutePath, "utf8");
+  const result = validateHtml(html);
+  console.log(pc4.bold(pc4.cyan(`
+\u{1F50D} Validation Report`)));
+  console.log(pc4.gray("\u2550".repeat(60)));
+  console.log(`${pc4.bold("File:")} ${pc4.blue(filePath)}`);
+  if (result.valid) {
+    console.log(
+      pc4.bold(
+        pc4.green(`
+\u2714 PASS: All checks passed! Score: ${result.score ?? 100}/100`)
+      )
+    );
+  } else {
+    console.log(
+      pc4.bold(
+        pc4.red(
+          `
+\u2718 FAIL: Validation failed with ${result.errors.length} violation(s)`
+        )
+      )
+    );
+    console.log(`${pc4.bold("Score:")} ${pc4.yellow(`${result.score}/100
+`)}`);
+    result.errors.forEach((err, idx) => {
+      console.log(pc4.bold(pc4.red(`[Violation ${idx + 1}]`)));
+      console.log(`  ${pc4.bold("Line:")}    ${err.line}`);
+      console.log(`  ${pc4.bold("Element:")} <${err.element}>`);
+      console.log(`  ${pc4.bold("Problem:")} ${pc4.yellow(err.message)}`);
+      if (err.fix) {
+        console.log(`  ${pc4.bold("Fix:")}     ${pc4.green(err.fix)}`);
+      }
+      console.log();
+    });
+  }
+  console.log();
+}
+
+// src/commands/check-a11y.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import path4 from "path";
+import pc5 from "picocolors";
+import { auditA11y } from "@mindfiredigital/ignix-lite-engine";
+async function checkA11yCommand(filePath) {
+  const absolutePath = path4.resolve(process.cwd(), filePath);
+  if (!existsSync2(absolutePath)) {
+    console.log(pc5.red(`Error: File not found at ${filePath}`));
+    process.exit(1);
+  }
+  const html = readFileSync2(absolutePath, "utf8");
+  const result = auditA11y(html);
+  console.log(pc5.bold(pc5.cyan(`
+\u267F Accessibility Audit Report`)));
+  console.log(pc5.gray("\u2550".repeat(60)));
+  console.log(`${pc5.bold("File:")}       ${pc5.blue(filePath)}`);
+  console.log(`${pc5.bold("Standards:")}  WCAG 2.2 ${pc5.bold(result.wcag)}`);
+  console.log(
+    `${pc5.bold("Summary:")}    Passed ${result.passes.length} rules, Found ${result.issues.length} issue(s)`
+  );
+  if (result.issues.length === 0) {
+    console.log(
+      pc5.bold(
+        pc5.green(`
+\u2714 PASS: No accessibility issues found! Score: 100/100`)
+      )
+    );
+  } else {
+    console.log(
+      pc5.bold(
+        pc5.red(
+          `
+\u2718 FAIL: Accessibility check failed. Score: ${result.score}/100
+`
+        )
+      )
+    );
+    result.issues.forEach((issue, idx) => {
+      const isError = issue.type === "error";
+      const labelColor = isError ? pc5.red : pc5.yellow;
+      const borderChar = isError ? "\u2718" : "\u26A0";
+      console.log(
+        pc5.bold(
+          labelColor(
+            `[Issue ${idx + 1}] ${borderChar} ${issue.rule} (${issue.type.toUpperCase()})`
+          )
+        )
+      );
+      console.log(`  ${pc5.bold("Element:")} ${issue.element}`);
+      console.log(`  ${pc5.bold("Message:")} ${issue.message}`);
+      if (issue.fix) {
+        console.log(`  ${pc5.bold("Fix:")}     ${pc5.green(issue.fix)}`);
+      }
+      console.log();
+    });
+  }
+  console.log();
+}
+
+// src/commands/list.ts
+import pc6 from "picocolors";
+import { manifests } from "@mindfiredigital/ignix-lite-engine";
+function listCommand() {
+  const components = Object.keys(manifests).sort();
+  console.log(pc6.bold(pc6.cyan("\n\u{1F525} Ignix-Lite Components Catalog")));
+  console.log(pc6.gray("\u2550".repeat(70)));
+  components.forEach((name) => {
+    const desc = manifests[name].description || pc6.gray("No description available");
+    console.log(
+      `  ${pc6.bold(pc6.green("\u25CF"))} ${pc6.bold(name.padEnd(15))} ${pc6.dim("\u2192")} ${desc}`
+    );
+  });
+  console.log(pc6.gray("\u2550".repeat(70)));
+  console.log(
+    pc6.cyan(`Total: ${pc6.bold(components.length)} components ready to use!
+`)
+  );
+}
+
+// src/commands/info.ts
+import pc7 from "picocolors";
+import { manifests as manifests2 } from "@mindfiredigital/ignix-lite-engine";
+function infoCommand(component) {
+  const name = component.toLowerCase().trim();
+  const manifest = manifests2[name];
+  if (!manifest) {
+    console.log(pc7.red(`
+Error: Component "${component}" does not exist.`));
+    console.log(
+      `Run ${pc7.yellow("ignix-lite list")} to see all available components.
+`
+    );
+    process.exit(1);
+  }
+  console.log(pc7.bold(pc7.cyan(`
+\u{1F4E6} Component: <${name.toUpperCase()}>`)));
+  console.log(pc7.gray("\u2550".repeat(60)));
+  console.log(`${pc7.bold("Description:")}    ${manifest.description}`);
+  console.log(
+    `${pc7.bold("HTML Wrapper:")}   ${pc7.yellow(`<${manifest.element}>`)}`
+  );
+  console.log(`${pc7.bold("Default Emmet:")}  ${pc7.green(manifest.emmet)}`);
+  if (manifest.props && Object.keys(manifest.props).length > 0) {
+    console.log(pc7.bold(pc7.blue("\n\u2699  Attributes & Options:")));
+    console.log(pc7.gray("  " + "\u2500".repeat(56)));
+    Object.entries(manifest.props).forEach(([propName, propDef]) => {
+      const typeStr = pc7.magenta(propDef.type);
+      const valuesStr = propDef.values ? pc7.dim(` [${propDef.values.join(", ")}]`) : "";
+      const defaultStr = propDef.default !== void 0 ? ` (default: ${pc7.bold(String(propDef.default))})` : "";
+      console.log(
+        `  ${pc7.cyan("\u2022")} ${pc7.bold(propName.padEnd(15))} ${typeStr}${valuesStr}${defaultStr}`
+      );
+    });
+  }
+  if (manifest.slots && Object.keys(manifest.slots).length > 0) {
+    console.log(pc7.bold(pc7.blue("\n\u{1F4E5} Slots:")));
+    console.log(pc7.gray("  " + "\u2500".repeat(56)));
+    Object.entries(manifest.slots).forEach(([slotName, slotDef]) => {
+      const elementsStr = slotDef.element ? pc7.dim(` (tags: ${slotDef.element.join(", ")})`) : "";
+      const requiredStr = slotDef.required ? pc7.bold(pc7.red(" (required)")) : "";
+      console.log(
+        `  ${pc7.cyan("\u2022")} ${pc7.bold(slotName.padEnd(15))} ${requiredStr}${elementsStr}`
+      );
+    });
+  }
+  if (manifest.do && manifest.do.length > 0) {
+    console.log(pc7.bold(pc7.green("\n\u2714 Best Practices (Do):")));
+    manifest.do.forEach((rule) => console.log(`  ${pc7.green("+")} ${rule}`));
+  }
+  if (manifest.dont && manifest.dont.length > 0) {
+    console.log(pc7.bold(pc7.red("\n\u2718 Avoid (Don't):")));
+    manifest.dont.forEach((rule) => console.log(`  ${pc7.red("-")} ${rule}`));
+  }
+  console.log();
+}
+
+// src/commands/build.ts
+import { writeFileSync } from "fs";
+import path5 from "path";
+import pc8 from "picocolors";
+import { howToBuild } from "@mindfiredigital/ignix-lite-engine";
+async function buildCommand(prompt, options) {
+  const response = await howToBuild(prompt);
+  if (!response.content || response.content.length === 0) {
+    console.log(
+      pc8.red("Error: Intent synthesis engine returned an empty response.")
+    );
+    return;
+  }
+  let data;
+  try {
+    data = JSON.parse(response.content[0].text);
+  } catch {
+    console.log(
+      pc8.red("Error: Failed to parse response from intent synthesis engine.")
+    );
+    return;
+  }
+  if (!data || data.source === "no-match") {
+    console.log(pc8.red(`
+Could not synthesize UI for: "${prompt}"`));
+    console.log(pc8.yellow(`Suggestion: ${data?.suggestion || "Try clarifying your request."}
+`));
+    return;
+  }
+  const outputContent = options.emmetOnly ? data.emmet : data.html;
+  if (!outputContent) {
+    console.log(pc8.red("Error: Response does not contain any synthesized code."));
+    return;
+  }
+  if (options.output) {
+    try {
+      const absolutePath = path5.resolve(process.cwd(), options.output);
+      writeFileSync(absolutePath, outputContent, "utf8");
+      console.log(
+        pc8.green(`
+Successfully wrote output to ${pc8.blue(options.output)}
+`)
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.log(
+        pc8.red(`Error: Failed to write output to file. ${msg}`)
+      );
+    }
+  } else {
+    console.log(pc8.cyan("\nSynthesized Output:"));
+    console.log(outputContent);
+    console.log();
+  }
+}
+
+// src/commands/preview.ts
+import { readFileSync as readFileSync3, existsSync as existsSync3, writeFileSync as writeFileSync2 } from "fs";
+import path6 from "path";
+import pc9 from "picocolors";
+import ora3 from "ora";
+import { preview } from "@mindfiredigital/ignix-lite-engine";
+async function previewCommand(filePath, options) {
+  const absolutePath = path6.resolve(process.cwd(), filePath);
+  if (!existsSync3(absolutePath)) {
+    console.log(pc9.red(`Error: File not found at ${filePath}`));
+    process.exit(1);
+  }
+  const spinner = ora3(
+    "Launching headless browser and rendering preview..."
+  ).start();
+  try {
+    const inputContent = readFileSync3(absolutePath, "utf8");
+    const widthNum = parseInt(options.width, 10) || 400;
+    const response = await preview({
+      input: inputContent,
+      options: {
+        width: widthNum,
+        theme: options.theme
+      }
+    });
+    if (!response.content || response.content.length === 0) {
+      spinner.fail(
+        pc9.red("Render failed: Received empty response from preview engine.")
+      );
+      return;
+    }
+    let result;
+    try {
+      result = JSON.parse(response.content[0].text);
+    } catch {
+      spinner.fail(pc9.red("Render failed: Invalid JSON response from preview engine."));
+      return;
+    }
+    if (result.error) {
+      spinner.fail(pc9.red(`Render failed: ${result.error}`));
+      return;
+    }
+    if (!result.png || typeof result.png !== "string") {
+      spinner.fail(
+        pc9.red("Render failed: Preview engine did not return base64 PNG data.")
+      );
+      return;
+    }
+    const base64Data = result.png.replace(/^data:image\/png;base64,/, "");
+    const buffer = Buffer.from(base64Data, "base64");
+    const outputPath = path6.resolve(process.cwd(), options.output);
+    writeFileSync2(outputPath, buffer);
+    spinner.succeed(
+      pc9.green(
+        `Visual preview generated successfully! Saved to ${pc9.blue(options.output)}`
+      )
+    );
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    spinner.fail(pc9.red(`Preview failed: ${msg}`));
+  }
+}
+
+// src/commands/mcp.ts
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync } from "fs";
+import path7 from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+import pc10 from "picocolors";
+import ora4 from "ora";
+function resolveMcpServerPath() {
+  try {
+    const resolvedUrl = import.meta.resolve("@mindfiredigital/ignix-lite-mcp");
+    return fileURLToPath(resolvedUrl);
+  } catch {
+    const thisDir = path7.dirname(fileURLToPath(import.meta.url));
+    return path7.resolve(thisDir, "../../mcp/dist/server.js");
+  }
+}
+function readJson(filePath) {
+  try {
+    return JSON.parse(readFileSync4(filePath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeJson(filePath, data) {
+  mkdirSync(path7.dirname(filePath), { recursive: true });
+  writeFileSync3(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+function mcpEntry(serverPath) {
+  return {
+    command: "node",
+    args: [serverPath]
+  };
+}
+function setupClaudeDesktop(serverPath) {
+  const spinner = ora4("Configuring Claude Desktop...").start();
+  try {
+    const configDir = process.platform === "win32" ? path7.join(process.env.APPDATA || "", "Claude") : path7.join(
+      process.env.HOME || "",
+      "Library",
+      "Application Support",
+      "Claude"
+    );
+    const configPath = path7.join(configDir, "claude_desktop_config.json");
+    const config = readJson(configPath);
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers["ignix-lite"] = mcpEntry(serverPath);
+    writeJson(configPath, config);
+    spinner.succeed(pc10.green("Claude Desktop configured successfully!"));
+    console.log(pc10.gray(`  Config: ${configPath}`));
+    console.log(pc10.yellow("\n  \u26A1 Restart Claude Desktop to apply changes.\n"));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    spinner.fail(pc10.red(`Failed to configure Claude Desktop: ${msg}`));
+  }
+}
+function setupClaudeCode(serverPath) {
+  const spinner = ora4("Configuring Claude Code (claude CLI)...").start();
+  try {
+    const configPath = process.platform === "win32" ? path7.join(process.env.USERPROFILE || "", ".claude.json") : path7.join(process.env.HOME || "", ".claude.json");
+    const config = readJson(configPath);
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers["ignix-lite"] = mcpEntry(serverPath);
+    writeJson(configPath, config);
+    spinner.succeed(pc10.green("Claude Code configured successfully!"));
+    console.log(pc10.gray(`  Config: ${configPath}`));
+    console.log(
+      pc10.yellow(
+        '\n  \u26A1 Run "claude" in any project to start using Ignix-Lite tools.\n'
+      )
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    spinner.fail(pc10.red(`Failed to configure Claude Code: ${msg}`));
+  }
+}
+function setupGemini(serverPath) {
+  const spinner = ora4("Configuring Gemini CLI...").start();
+  try {
+    const configDir = process.platform === "win32" ? path7.join(process.env.USERPROFILE || "", ".gemini") : path7.join(process.env.HOME || "", ".gemini");
+    const configPath = path7.join(configDir, "settings.json");
+    const config = readJson(configPath);
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers["ignix-lite"] = mcpEntry(serverPath);
+    writeJson(configPath, config);
+    spinner.succeed(pc10.green("Gemini CLI configured successfully!"));
+    console.log(pc10.gray(`  Config: ${configPath}`));
+    console.log(
+      pc10.yellow(
+        "\n  \u26A1 Start a new Gemini CLI session to activate Ignix-Lite tools.\n"
+      )
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    spinner.fail(pc10.red(`Failed to configure Gemini CLI: ${msg}`));
+  }
+}
+function setupCursor(serverPath) {
+  const spinner = ora4("Configuring Cursor...").start();
+  try {
+    const configDir = process.platform === "win32" ? path7.join(process.env.USERPROFILE || "", ".cursor") : path7.join(process.env.HOME || "", ".cursor");
+    const configPath = path7.join(configDir, "mcp.json");
+    const config = readJson(configPath);
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers["ignix-lite"] = mcpEntry(serverPath);
+    writeJson(configPath, config);
+    spinner.succeed(pc10.green("Cursor configured successfully!"));
+    console.log(pc10.gray(`  Config: ${configPath}`));
+    console.log(
+      pc10.yellow(
+        '\n  \u26A1 Reload Cursor (Ctrl+Shift+P \u2192 "Reload Window") to activate Ignix-Lite tools.\n'
+      )
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    spinner.fail(pc10.red(`Failed to configure Cursor: ${msg}`));
+  }
+}
+var SUPPORTED_CLIENTS = [
+  "claude",
+  "claude-desktop",
+  "claude-code",
+  "gemini",
+  "cursor"
+];
+async function mcpSetupCommand(client) {
+  const serverPath = resolveMcpServerPath();
+  const target = (client || "").toLowerCase().trim();
+  if (!target) {
+    console.log(pc10.cyan("\nWhich client do you want to configure?\n"));
+    console.log(
+      `  ${pc10.bold("claude")}          Claude Desktop       (auto-configure)`
+    );
+    console.log(
+      `  ${pc10.bold("claude-code")}     Claude Code CLI      (auto-configure)`
+    );
+    console.log(
+      `  ${pc10.bold("gemini")}          Gemini CLI           (auto-configure)`
+    );
+    console.log(
+      `  ${pc10.bold("cursor")}          Cursor editor        (auto-configure)`
+    );
+    console.log();
+    console.log(
+      pc10.gray(
+        "Usage: ignix-lite mcp setup <client>  (e.g. ignix-lite mcp setup cursor)"
+      )
+    );
+    console.log();
+    return;
+  }
+  switch (target) {
+    case "claude":
+    case "claude-desktop":
+      setupClaudeDesktop(serverPath);
+      break;
+    case "claude-code":
+      setupClaudeCode(serverPath);
+      break;
+    case "gemini":
+      setupGemini(serverPath);
+      break;
+    case "cursor":
+      setupCursor(serverPath);
+      break;
+    default:
+      console.log(pc10.red(`
+Unknown client: "${client}"
+`));
+      console.log(`Supported clients: ${pc10.bold(SUPPORTED_CLIENTS.join(", "))}`);
+      console.log();
+  }
+}
+function mcpStartCommand() {
+  const serverPath = resolveMcpServerPath();
+  console.log(pc10.cyan(`
+Starting Ignix-Lite MCP Server...`));
+  console.log(`Running: ${pc10.green("node " + serverPath)}
+`);
+  const child = spawn("node", [serverPath], { stdio: "inherit" });
+  child.on("error", (err) => {
+    console.log(pc10.red(`
+Failed to start MCP Server: ${err.message}`));
+  });
+  child.on("close", (code) => {
+    if (code !== 0) {
+      console.log(pc10.red(`
+MCP Server exited with code ${code}`));
+    }
+  });
+}
+
+// src/index.ts
+var program = new Command();
+program.name("ignix-lite").description(
+  "CLI tool for project initialization, component scaffolding, and local validation in Ignix-Lite"
+).version("1.0.0");
+program.command("init").description("Initialize Ignix-Lite in your project").action(initCommand);
+program.command("theme [prompt]").description(
+  "Generate theme variables based on design prompts or primary color"
+).option("-p, --primary <color>", "Primary color (hex/hsl) explicitly").option("-s, --style-file <path>", "Stylesheet target path").action(themeCommand);
+program.command("add <component>").description("Add or print an Ignix-Lite component template").action(addCommand);
+program.command("validate <file>").description("Validate a markup file against Ignix-Lite design rules").action(validateCommand);
+program.command("check-a11y <file>").description("Audit a local markup file for WCAG accessibility issues").action(checkA11yCommand);
+program.command("list").description("List all available Ignix-Lite components").action(listCommand);
+program.command("info <component>").description("Show detailed manifest and guidelines for a component").action(infoCommand);
+program.command("build <prompt>").description("Generate Ignix-Lite HTML/Emmet from a natural language prompt").option("-o, --output <file>", "Path to write the synthesized HTML output").option("-e, --emmet-only", "Output the compiled Emmet shorthand only").action(buildCommand);
+program.command("preview <file>").description("Generate a visual PNG preview of an HTML or Emmet file").option("-o, --output <file>", "Output image destination", "preview.png").option("-w, --width <pixels>", "Viewport width", "400").option("-t, --theme <light|dark>", "Emulated color scheme theme").action(previewCommand);
+var mcp = program.command("mcp").description("Manage the Ignix-Lite MCP server");
+mcp.command("setup [client]").description(
+  "Configure the MCP server for an editor/client (claude, cursor, gemini)"
+).action(mcpSetupCommand);
+mcp.command("start").description("Start the Ignix-Lite MCP server").action(mcpStartCommand);
+program.parse(process.argv);