@fragments-sdk/cli 0.14.2 → 0.15.0

package/dist/govern-scan-UCBZR6D6.js

@@ -0,0 +1,280 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import "./chunk-D2CDBRNU.js";
+import {
+  BRAND
+} from "./chunk-32LIWN2P.js";
+import "./chunk-Z7EY4VHE.js";
+
+// src/commands/govern-scan.ts
+import pc from "picocolors";
+import { resolve, relative } from "path";
+import { existsSync } from "fs";
+var SCAN_DEFAULT_RULES = {
+  "safety/no-dangerous-html": true,
+  "safety/sanitize-hrefs": true,
+  "safety/no-inline-scripts": true,
+  "safety/no-exposed-secrets": true,
+  "tokens/require-design-tokens": true
+};
+function detectRootDir(cwd) {
+  const candidates = ["src", "app", "pages", "components"];
+  for (const dir of candidates) {
+    if (existsSync(resolve(cwd, dir))) {
+      return cwd;
+    }
+  }
+  return cwd;
+}
+function groupByFile(usages) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const existing = grouped.get(usage.filePath);
+    if (existing) {
+      existing.push(usage);
+    } else {
+      grouped.set(usage.filePath, [usage]);
+    }
+  }
+  return grouped;
+}
+async function governScan(options = {}) {
+  const {
+    loadPolicy,
+    createEngine,
+    buildAdaptersFromConfig,
+    createCloudAdapter,
+    formatVerdict
+  } = await import("@fragments-sdk/govern");
+  const { scanCodebase } = await import("./codebase-scanner-VOTPXRYW.js");
+  const { usagesToSpec } = await import("./converter-JLINP7CJ.js");
+  const format = options.format ?? "summary";
+  const quiet = options.quiet ?? false;
+  if (!quiet) {
+    console.log(pc.cyan(`
+${BRAND.name} Governance Scan
+`));
+  }
+  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));
+  if (!quiet) {
+    console.log(pc.dim(`  Root: ${rootDir}
+`));
+  }
+  let policy = await loadPolicy(options.config);
+  const hasRules = Object.keys(policy.rules).length > 0;
+  if (!hasRules) {
+    policy = { ...policy, rules: SCAN_DEFAULT_RULES };
+    if (!quiet) {
+      console.log(pc.dim("  No config found \u2014 using scan defaults (safety + tokens)\n"));
+    }
+  }
+  const adapters = buildAdaptersFromConfig(policy.audit);
+  const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;
+  if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {
+    adapters.push(createCloudAdapter());
+    if (!quiet) {
+      console.log(pc.dim("  Cloud audit enabled (FRAGMENTS_API_KEY detected)\n"));
+    }
+  }
+  const engine = createEngine(policy, adapters);
+  if (!quiet) {
+    console.log(pc.dim("  Scanning files...\n"));
+  }
+  const analysis = await scanCodebase({
+    rootDir,
+    useCache: true,
+    onProgress: quiet ? void 0 : (progress) => {
+      if (progress.phase === "scanning") {
+        process.stdout.write(
+          `\r  ${pc.dim(`[${progress.current}/${progress.total}]`)} ${pc.dim(relative(rootDir, progress.currentFile))}`
+        );
+      }
+    }
+  });
+  if (!quiet) {
+    process.stdout.write("\r" + " ".repeat(80) + "\r");
+    console.log(
+      pc.dim(`  Scanned ${analysis.totalFiles} files, found ${analysis.totalComponents} component types
+`)
+    );
+  }
+  const allUsages = [];
+  for (const comp of Object.values(analysis.components)) {
+    allUsages.push(...comp.usages);
+  }
+  if (allUsages.length === 0) {
+    if (!quiet) {
+      console.log(pc.yellow("  No component usages found.\n"));
+    }
+    return { exitCode: 0 };
+  }
+  const grouped = groupByFile(allUsages);
+  let totalFiles = 0;
+  let passedFiles = 0;
+  let totalViolations = 0;
+  const violationCounts = /* @__PURE__ */ new Map();
+  for (const [filePath, usages] of grouped) {
+    const spec = usagesToSpec(usages, filePath, rootDir);
+    const relPath = relative(rootDir, filePath);
+    const verdict = await engine.check(spec, {
+      runner: "cli",
+      input: relPath
+    });
+    totalFiles++;
+    if (verdict.passed) {
+      passedFiles++;
+    } else {
+      if (!quiet) {
+        console.log(pc.red(`  \u2717 ${relPath}`));
+        if (format === "summary") {
+          for (const result of verdict.results) {
+            for (const v of result.violations) {
+              const count = violationCounts.get(v.rule) ?? 0;
+              violationCounts.set(v.rule, count + 1);
+              totalViolations++;
+              console.log(
+                pc.dim(`    ${v.severity} `) + pc.yellow(v.rule) + pc.dim(` \u2014 ${v.message}`)
+              );
+              if (v.nodeId) {
+                console.log(pc.dim(`      at ${v.nodeId}`));
+              }
+            }
+          }
+        }
+      }
+    }
+    if (verdict.passed && !quiet && format === "summary") {
+      console.log(pc.green(`  \u2713 ${relPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`));
+    }
+    if (format === "json" || format === "sarif") {
+      const output = formatVerdict(verdict, format);
+      console.log(output);
+    }
+  }
+  if (!quiet && format === "summary") {
+    console.log(pc.dim("\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+    console.log(`  Files checked:  ${totalFiles}`);
+    console.log(`  Passed:         ${passedFiles}/${totalFiles}`);
+    console.log(`  Violations:     ${totalViolations}`);
+    if (violationCounts.size > 0) {
+      console.log(pc.dim("\n  Top violations:"));
+      const sorted = [...violationCounts.entries()].sort((a, b) => b[1] - a[1]);
+      for (const [rule, count] of sorted.slice(0, 5)) {
+        console.log(pc.dim(`    ${count}\xD7 `) + pc.yellow(rule));
+      }
+    }
+    console.log();
+    if (passedFiles === totalFiles) {
+      console.log(pc.green(`  \u2713 All files passed governance checks
+`));
+    } else {
+      console.log(
+        pc.red(`  \u2717 ${totalFiles - passedFiles} file(s) failed governance checks
+`)
+      );
+    }
+  }
+  return { exitCode: passedFiles === totalFiles ? 0 : 1 };
+}
+async function governWatch(options = {}) {
+  const {
+    loadPolicy,
+    createEngine,
+    buildAdaptersFromConfig,
+    createCloudAdapter,
+    formatVerdict
+  } = await import("@fragments-sdk/govern");
+  const { scanFile } = await import("./scanner-7LAZYPWZ.js");
+  const { usagesToSpec } = await import("./converter-JLINP7CJ.js");
+  const quiet = options.quiet ?? false;
+  const debounceMs = options.debounce ?? 300;
+  const format = options.format ?? "summary";
+  console.log(pc.cyan(`
+${BRAND.name} Governance Watch
+`));
+  const { exitCode } = await governScan(options);
+  if (!quiet) {
+    console.log(
+      pc.dim(`  Initial scan ${exitCode === 0 ? "passed" : "completed with violations"}
+`)
+    );
+  }
+  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));
+  let policy = await loadPolicy(options.config);
+  if (Object.keys(policy.rules).length === 0) {
+    policy = { ...policy, rules: SCAN_DEFAULT_RULES };
+  }
+  const adapters = buildAdaptersFromConfig(policy.audit);
+  if (!adapters.some(() => policy.audit?.cloud) && process.env.FRAGMENTS_API_KEY) {
+    adapters.push(createCloudAdapter());
+  }
+  const engine = createEngine(policy, adapters);
+  console.log(pc.dim("  Watching for changes... (Ctrl+C to stop)\n"));
+  const chokidar = await import("chokidar");
+  const watcher = chokidar.watch(
+    ["**/*.tsx", "**/*.ts", "**/*.jsx", "**/*.js"],
+    {
+      cwd: rootDir,
+      ignoreInitial: true,
+      ignored: [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/.next/**",
+        "**/*.test.*",
+        "**/*.spec.*",
+        "**/*.stories.*"
+      ],
+      awaitWriteFinish: { stabilityThreshold: debounceMs }
+    }
+  );
+  const handleChange = async (changedRelPath) => {
+    const absolutePath = resolve(rootDir, changedRelPath);
+    try {
+      const { usages } = await scanFile(absolutePath);
+      if (usages.length === 0) {
+        if (!quiet) {
+          console.log(pc.dim(`  \u25CB ${changedRelPath} \u2014 no component usages`));
+        }
+        return;
+      }
+      const spec = usagesToSpec(usages, absolutePath, rootDir);
+      const verdict = await engine.check(spec, {
+        runner: "cli",
+        input: changedRelPath
+      });
+      if (verdict.passed) {
+        console.log(
+          pc.green(`  \u2713 ${changedRelPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`)
+        );
+      } else {
+        console.log(pc.red(`  \u2717 ${changedRelPath}`));
+        if (format === "summary") {
+          for (const result of verdict.results) {
+            for (const v of result.violations) {
+              console.log(
+                pc.dim(`    ${v.severity} `) + pc.yellow(v.rule) + pc.dim(` \u2014 ${v.message}`)
+              );
+            }
+          }
+        } else {
+          console.log(formatVerdict(verdict, format));
+        }
+      }
+    } catch (error) {
+      if (!quiet) {
+        console.log(
+          pc.dim(`  \u26A0 ${changedRelPath} \u2014 `) + pc.yellow(error instanceof Error ? error.message : "parse error")
+        );
+      }
+    }
+  };
+  watcher.on("change", handleChange);
+  watcher.on("add", handleChange);
+  await new Promise(() => {
+  });
+}
+export {
+  governScan,
+  governWatch
+};
+//# sourceMappingURL=govern-scan-UCBZR6D6.js.map

package/dist/govern-scan-UCBZR6D6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/govern-scan.ts"],"sourcesContent":["/**\n * govern scan / govern watch — Zero-config governance scanning\n *\n * Parses real JSX/TSX files via the existing codebase scanner, converts\n * component usages to UISpec, and runs governance checks per file.\n * Optionally submits results to Fragments Cloud.\n */\n\nimport pc from 'picocolors';\nimport { resolve, relative } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport { BRAND } from '../core/index.js';\nimport type { ComponentUsage } from '../service/enhance/types.js';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface GovernScanOptions {\n  /** Root directory to scan (default: auto-detect) */\n  dir?: string;\n  /** Path to govern.config.ts */\n  config?: string;\n  /** Output format */\n  format?: 'summary' | 'json' | 'sarif';\n  /** Suppress non-error output */\n  quiet?: boolean;\n}\n\nexport interface GovernWatchOptions extends GovernScanOptions {\n  /** Debounce interval in ms (default: 300) */\n  debounce?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Scan defaults — applied when no config file exists\n// ---------------------------------------------------------------------------\n\nconst SCAN_DEFAULT_RULES: Record<string, boolean | object> = {\n  'safety/no-dangerous-html': true,\n  'safety/sanitize-hrefs': true,\n  'safety/no-inline-scripts': true,\n  'safety/no-exposed-secrets': true,\n  'tokens/require-design-tokens': true,\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Auto-detect root directory by looking for common React project dirs\n */\nfunction detectRootDir(cwd: string): string {\n  const candidates = ['src', 'app', 'pages', 'components'];\n  for (const dir of candidates) {\n    if (existsSync(resolve(cwd, dir))) {\n      return cwd;\n    }\n  }\n  return cwd;\n}\n\n/**\n * Group component usages by their source file\n */\nfunction groupByFile(usages: ComponentUsage[]): Map<string, ComponentUsage[]> {\n  const grouped = new Map<string, ComponentUsage[]>();\n  for (const usage of usages) {\n    const existing = grouped.get(usage.filePath);\n    if (existing) {\n      existing.push(usage);\n    } else {\n      grouped.set(usage.filePath, [usage]);\n    }\n  }\n  return grouped;\n}\n\n// ---------------------------------------------------------------------------\n// governScan\n// ---------------------------------------------------------------------------\n\nexport async function governScan(\n  options: GovernScanOptions = {},\n): Promise<{ exitCode: number }> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanCodebase } = await import(\n    '../service/enhance/codebase-scanner.js'\n  );\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const format = options.format ?? 'summary';\n  const quiet = options.quiet ?? false;\n\n  if (!quiet) {\n    console.log(pc.cyan(`\\n${BRAND.name} Governance Scan\\n`));\n  }\n\n  // 1. Resolve root directory\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  if (!quiet) {\n    console.log(pc.dim(`  Root: ${rootDir}\\n`));\n  }\n\n  // 2. Load policy — use scan defaults if no config exists\n  let policy = await loadPolicy(options.config);\n  const hasRules = Object.keys(policy.rules).length > 0;\n\n  if (!hasRules) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n    if (!quiet) {\n      console.log(pc.dim('  No config found — using scan defaults (safety + tokens)\\n'));\n    }\n  }\n\n  // 3. Build adapters. Auto-add cloud if FRAGMENTS_API_KEY is set\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;\n  if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter());\n    if (!quiet) {\n      console.log(pc.dim('  Cloud audit enabled (FRAGMENTS_API_KEY detected)\\n'));\n    }\n  }\n\n  // 4. Create engine\n  const engine = createEngine(policy, adapters);\n\n  // 5. Scan codebase\n  if (!quiet) {\n    console.log(pc.dim('  Scanning files...\\n'));\n  }\n\n  const analysis = await scanCodebase({\n    rootDir,\n    useCache: true,\n    onProgress: quiet\n      ? undefined\n      : (progress) => {\n          if (progress.phase === 'scanning') {\n            process.stdout.write(\n              `\\r  ${pc.dim(`[${progress.current}/${progress.total}]`)} ${pc.dim(relative(rootDir, progress.currentFile))}`,\n            );\n          }\n        },\n  });\n\n  if (!quiet) {\n    // Clear progress line\n    process.stdout.write('\\r' + ' '.repeat(80) + '\\r');\n    console.log(\n      pc.dim(`  Scanned ${analysis.totalFiles} files, found ${analysis.totalComponents} component types\\n`),\n    );\n  }\n\n  // 6. Collect all usages across components\n  const allUsages: ComponentUsage[] = [];\n  for (const comp of Object.values(analysis.components)) {\n    allUsages.push(...comp.usages);\n  }\n\n  if (allUsages.length === 0) {\n    if (!quiet) {\n      console.log(pc.yellow('  No component usages found.\\n'));\n    }\n    return { exitCode: 0 };\n  }\n\n  // 7. Group by file and run checks\n  const grouped = groupByFile(allUsages);\n  let totalFiles = 0;\n  let passedFiles = 0;\n  let totalViolations = 0;\n  const violationCounts = new Map<string, number>();\n\n  for (const [filePath, usages] of grouped) {\n    const spec = usagesToSpec(usages, filePath, rootDir);\n    const relPath = relative(rootDir, filePath);\n\n    const verdict = await engine.check(spec, {\n      runner: 'cli',\n      input: relPath,\n    });\n\n    totalFiles++;\n\n    if (verdict.passed) {\n      passedFiles++;\n    } else {\n      if (!quiet) {\n        console.log(pc.red(`  ✗ ${relPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              const count = violationCounts.get(v.rule) ?? 0;\n              violationCounts.set(v.rule, count + 1);\n              totalViolations++;\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n              if (v.nodeId) {\n                console.log(pc.dim(`      at ${v.nodeId}`));\n              }\n            }\n          }\n        }\n      }\n    }\n\n    if (verdict.passed && !quiet && format === 'summary') {\n      console.log(pc.green(`  ✓ ${relPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`));\n    }\n\n    // JSON/SARIF: print per-file\n    if (format === 'json' || format === 'sarif') {\n      const output = formatVerdict(verdict, format);\n      console.log(output);\n    }\n  }\n\n  // 8. Summary\n  if (!quiet && format === 'summary') {\n    console.log(pc.dim('\\n  ─────────────────────────────────────\\n'));\n    console.log(`  Files checked:  ${totalFiles}`);\n    console.log(`  Passed:         ${passedFiles}/${totalFiles}`);\n    console.log(`  Violations:     ${totalViolations}`);\n\n    if (violationCounts.size > 0) {\n      console.log(pc.dim('\\n  Top violations:'));\n      const sorted = [...violationCounts.entries()].sort((a, b) => b[1] - a[1]);\n      for (const [rule, count] of sorted.slice(0, 5)) {\n        console.log(pc.dim(`    ${count}× `) + pc.yellow(rule));\n      }\n    }\n\n    console.log();\n\n    if (passedFiles === totalFiles) {\n      console.log(pc.green(`  ✓ All files passed governance checks\\n`));\n    } else {\n      console.log(\n        pc.red(`  ✗ ${totalFiles - passedFiles} file(s) failed governance checks\\n`),\n      );\n    }\n  }\n\n  return { exitCode: passedFiles === totalFiles ? 0 : 1 };\n}\n\n// ---------------------------------------------------------------------------\n// governWatch\n// ---------------------------------------------------------------------------\n\nexport async function governWatch(\n  options: GovernWatchOptions = {},\n): Promise<void> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanFile } = await import('../service/enhance/scanner.js');\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const quiet = options.quiet ?? false;\n  const debounceMs = options.debounce ?? 300;\n  const format = options.format ?? 'summary';\n\n  // 1. Run initial scan\n  console.log(pc.cyan(`\\n${BRAND.name} Governance Watch\\n`));\n\n  const { exitCode } = await governScan(options);\n  if (!quiet) {\n    console.log(\n      pc.dim(`  Initial scan ${exitCode === 0 ? 'passed' : 'completed with violations'}\\n`),\n    );\n  }\n\n  // 2. Set up engine for incremental checks\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  let policy = await loadPolicy(options.config);\n  if (Object.keys(policy.rules).length === 0) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n  }\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  if (!adapters.some(() => policy.audit?.cloud) && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter());\n  }\n  const engine = createEngine(policy, adapters);\n\n  // 3. Watch for changes\n  console.log(pc.dim('  Watching for changes... (Ctrl+C to stop)\\n'));\n\n  const chokidar = await import('chokidar');\n\n  const watcher = chokidar.watch(\n    ['**/*.tsx', '**/*.ts', '**/*.jsx', '**/*.js'],\n    {\n      cwd: rootDir,\n      ignoreInitial: true,\n      ignored: [\n        '**/node_modules/**',\n        '**/dist/**',\n        '**/build/**',\n        '**/.next/**',\n        '**/*.test.*',\n        '**/*.spec.*',\n        '**/*.stories.*',\n      ],\n      awaitWriteFinish: { stabilityThreshold: debounceMs },\n    },\n  );\n\n  const handleChange = async (changedRelPath: string) => {\n    const absolutePath = resolve(rootDir, changedRelPath);\n\n    try {\n      const { usages } = await scanFile(absolutePath);\n\n      if (usages.length === 0) {\n        if (!quiet) {\n          console.log(pc.dim(`  ○ ${changedRelPath} — no component usages`));\n        }\n        return;\n      }\n\n      const spec = usagesToSpec(usages, absolutePath, rootDir);\n      const verdict = await engine.check(spec, {\n        runner: 'cli',\n        input: changedRelPath,\n      });\n\n      if (verdict.passed) {\n        console.log(\n          pc.green(`  ✓ ${changedRelPath}`) +\n          pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`),\n        );\n      } else {\n        console.log(pc.red(`  ✗ ${changedRelPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n            }\n          }\n        } else {\n          console.log(formatVerdict(verdict, format));\n        }\n      }\n    } catch (error) {\n      if (!quiet) {\n        console.log(\n          pc.dim(`  ⚠ ${changedRelPath} — `) +\n          pc.yellow(error instanceof Error ? error.message : 'parse error'),\n        );\n      }\n    }\n  };\n\n  watcher.on('change', handleChange);\n  watcher.on('add', handleChange);\n\n  // Keep process alive\n  await new Promise(() => {});\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -22,7 +22,8 @@ interface DiscoveredFile {
     relativePath: string;
 }
 /**
- * Discover fragment files matching the config patterns
+ * Discover fragment files matching the config patterns.
+ * Also discovers .contract.json files for framework-agnostic component contracts.
  */
 declare function discoverFragmentFiles(config: FragmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
 /**

package/dist/index.js

@@ -2,7 +2,7 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   generateStaticViewer,
   generateViewerFromJson
-} from "./chunk-TXFCEDOC.js";
+} from "./chunk-2WXKALIG.js";
 import {
   buildFragments,
   runAnalyzeCommand,
@@ -12,23 +12,23 @@ import {
   validateCoverage,
   validateSchema,
   validateSnippets
-} from "./chunk-LOYS64QS.js";
-import "./chunk-EYXVAMEX.js";
-import {
-  findConfigFile,
-  loadConfig
-} from "./chunk-55KERLWL.js";
+} from "./chunk-7WHVW72L.js";
+import "./chunk-MN3TJ3D5.js";
 import {
   discoverComponentFiles,
   discoverFragmentFiles,
-  extractComponentName
-} from "./chunk-ZKTFKHWN.js";
-import "./chunk-APTQIBS5.js";
+  extractComponentName,
+  findConfigFile,
+  loadConfig
+} from "./chunk-65WSVDV5.js";
+import "./chunk-XJQ5BIWI.js";
 import "./chunk-D2CDBRNU.js";
 import {
   defineBlock,
   defineFragment
-} from "./chunk-I34BC3CU.js";
+} from "./chunk-32LIWN2P.js";
+import "./chunk-QCN35LJU.js";
+import "./chunk-7DZC4YEV.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/cli-commands.ts