@fragments-sdk/cli 0.14.3 → 0.15.1

package/dist/push-contracts-WY32TFP6.js

@@ -0,0 +1,84 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import "./chunk-D2CDBRNU.js";
+import {
+  BRAND
+} from "./chunk-32LIWN2P.js";
+
+// src/commands/push-contracts.ts
+import { readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+import pc from "picocolors";
+async function pushContracts(options = {}) {
+  const quiet = options.quiet ?? false;
+  const apiKey = options.apiKey ?? process.env.FRAGMENTS_API_KEY;
+  if (!apiKey) {
+    console.error(
+      pc.red("No API key found. Set FRAGMENTS_API_KEY or pass --api-key.")
+    );
+    return { exitCode: 1 };
+  }
+  if (!quiet) {
+    console.log(pc.cyan(`
+${BRAND.name} Push Contracts
+`));
+  }
+  const inputPath = options.input ? resolve(options.input) : resolve("fragments.json");
+  if (!existsSync(inputPath)) {
+    console.error(
+      pc.red(`Contract registry not found at ${inputPath}`)
+    );
+    console.error(
+      pc.dim("Run `fragments build` or `fragments scan` to generate fragments.json first.")
+    );
+    return { exitCode: 1 };
+  }
+  let contractRegistry;
+  let componentCount = 0;
+  try {
+    const raw = readFileSync(inputPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const fragments = parsed.fragments ?? parsed;
+    if (!Array.isArray(fragments)) {
+      console.error(pc.red("Invalid contract registry: expected fragments array"));
+      return { exitCode: 1 };
+    }
+    componentCount = fragments.length;
+    contractRegistry = JSON.stringify({ fragments });
+  } catch (error) {
+    console.error(
+      pc.red("Failed to parse contract registry:"),
+      error instanceof Error ? error.message : "unknown error"
+    );
+    return { exitCode: 1 };
+  }
+  if (componentCount === 0) {
+    console.warn(pc.yellow("No components found in contract registry. Nothing to push."));
+    return { exitCode: 0 };
+  }
+  if (!quiet) {
+    console.log(pc.dim(`  Found ${componentCount} component contracts
+`));
+    console.log(pc.dim("  Pushing to Fragments Cloud...\n"));
+  }
+  const { pushContracts: push } = await import("@fragments-sdk/govern");
+  const result = await push({
+    contractRegistry,
+    url: options.url,
+    apiKey
+  });
+  if (!result.ok) {
+    console.error(pc.red(`Failed to push contracts: ${result.error}`));
+    return { exitCode: 1 };
+  }
+  if (!quiet) {
+    console.log(
+      pc.green(`  \u2713 Pushed ${componentCount} component contracts to Fragments Cloud
+`)
+    );
+  }
+  return { exitCode: 0 };
+}
+export {
+  pushContracts
+};
+//# sourceMappingURL=push-contracts-WY32TFP6.js.map

package/dist/push-contracts-WY32TFP6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/push-contracts.ts"],"sourcesContent":["/**\n * fragments push-contracts\n *\n * Push compiled component contracts to Fragments Cloud.\n * Reads fragments.json from the project root (or builds it from .contract.json files)\n * and posts the contract registry to the Cloud ingest endpoint.\n */\n\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport pc from 'picocolors';\nimport { BRAND } from '../core/index.js';\n\nexport interface PushContractsOptions {\n  /** Path to fragments.json or directory containing .contract.json files */\n  input?: string;\n  /** Fragments Cloud URL */\n  url?: string;\n  /** API key (defaults to FRAGMENTS_API_KEY env var) */\n  apiKey?: string;\n  /** Suppress output */\n  quiet?: boolean;\n}\n\nexport async function pushContracts(\n  options: PushContractsOptions = {},\n): Promise<{ exitCode: number }> {\n  const quiet = options.quiet ?? false;\n  const apiKey = options.apiKey ?? process.env.FRAGMENTS_API_KEY;\n\n  if (!apiKey) {\n    console.error(\n      pc.red('No API key found. Set FRAGMENTS_API_KEY or pass --api-key.'),\n    );\n    return { exitCode: 1 };\n  }\n\n  if (!quiet) {\n    console.log(pc.cyan(`\\n${BRAND.name} Push Contracts\\n`));\n  }\n\n  // 1. Find contract registry\n  const inputPath = options.input\n    ? resolve(options.input)\n    : resolve('fragments.json');\n\n  if (!existsSync(inputPath)) {\n    console.error(\n      pc.red(`Contract registry not found at ${inputPath}`),\n    );\n    console.error(\n      pc.dim('Run `fragments build` or `fragments scan` to generate fragments.json first.'),\n    );\n    return { exitCode: 1 };\n  }\n\n  // 2. Parse and validate\n  let contractRegistry: string;\n  let componentCount = 0;\n\n  try {\n    const raw = readFileSync(inputPath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    const fragments = parsed.fragments ?? parsed;\n\n    if (!Array.isArray(fragments)) {\n      console.error(pc.red('Invalid contract registry: expected fragments array'));\n      return { exitCode: 1 };\n    }\n\n    componentCount = fragments.length;\n    contractRegistry = JSON.stringify({ fragments });\n  } catch (error) {\n    console.error(\n      pc.red('Failed to parse contract registry:'),\n      error instanceof Error ? error.message : 'unknown error',\n    );\n    return { exitCode: 1 };\n  }\n\n  if (componentCount === 0) {\n    console.warn(pc.yellow('No components found in contract registry. Nothing to push.'));\n    return { exitCode: 0 };\n  }\n\n  if (!quiet) {\n    console.log(pc.dim(`  Found ${componentCount} component contracts\\n`));\n    console.log(pc.dim('  Pushing to Fragments Cloud...\\n'));\n  }\n\n  // 3. Push to Cloud\n  const { pushContracts: push } = await import('@fragments-sdk/govern');\n\n  const result = await push({\n    contractRegistry,\n    url: options.url,\n    apiKey,\n  });\n\n  if (!result.ok) {\n    console.error(pc.red(`Failed to push contracts: ${result.error}`));\n    return { exitCode: 1 };\n  }\n\n  if (!quiet) {\n    console.log(\n      pc.green(`  ✓ Pushed ${componentCount} component contracts to Fragments Cloud\\n`),\n    );\n  }\n\n  return { exitCode: 0 };\n}\n"],"mappings":";;;;;;;AAQA,SAAS,cAAc,kBAAkB;AACzC,SAAS,eAAe;AACxB,OAAO,QAAQ;AAcf,eAAsB,cACpB,UAAgC,CAAC,GACF;AAC/B,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAE7C,MAAI,CAAC,QAAQ;AACX,YAAQ;AAAA,MACN,GAAG,IAAI,4DAA4D;AAAA,IACrE;AACA,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAEA,MAAI,CAAC,OAAO;AACV,YAAQ,IAAI,GAAG,KAAK;AAAA,EAAK,MAAM,IAAI;AAAA,CAAmB,CAAC;AAAA,EACzD;AAGA,QAAM,YAAY,QAAQ,QACtB,QAAQ,QAAQ,KAAK,IACrB,QAAQ,gBAAgB;AAE5B,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAQ;AAAA,MACN,GAAG,IAAI,kCAAkC,SAAS,EAAE;AAAA,IACtD;AACA,YAAQ;AAAA,MACN,GAAG,IAAI,6EAA6E;AAAA,IACtF;AACA,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAGA,MAAI;AACJ,MAAI,iBAAiB;AAErB,MAAI;AACF,UAAM,MAAM,aAAa,WAAW,OAAO;AAC3C,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,UAAM,YAAY,OAAO,aAAa;AAEtC,QAAI,CAAC,MAAM,QAAQ,SAAS,GAAG;AAC7B,cAAQ,MAAM,GAAG,IAAI,qDAAqD,CAAC;AAC3E,aAAO,EAAE,UAAU,EAAE;AAAA,IACvB;AAEA,qBAAiB,UAAU;AAC3B,uBAAmB,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,EACjD,SAAS,OAAO;AACd,YAAQ;AAAA,MACN,GAAG,IAAI,oCAAoC;AAAA,MAC3C,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AACA,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAEA,MAAI,mBAAmB,GAAG;AACxB,YAAQ,KAAK,GAAG,OAAO,4DAA4D,CAAC;AACpF,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAEA,MAAI,CAAC,OAAO;AACV,YAAQ,IAAI,GAAG,IAAI,WAAW,cAAc;AAAA,CAAwB,CAAC;AACrE,YAAQ,IAAI,GAAG,IAAI,mCAAmC,CAAC;AAAA,EACzD;AAGA,QAAM,EAAE,eAAe,KAAK,IAAI,MAAM,OAAO,uBAAuB;AAEpE,QAAM,SAAS,MAAM,KAAK;AAAA,IACxB;AAAA,IACA,KAAK,QAAQ;AAAA,IACb;AAAA,EACF,CAAC;AAED,MAAI,CAAC,OAAO,IAAI;AACd,YAAQ,MAAM,GAAG,IAAI,6BAA6B,OAAO,KAAK,EAAE,CAAC;AACjE,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAEA,MAAI,CAAC,OAAO;AACV,YAAQ;AAAA,MACN,GAAG,MAAM,mBAAc,cAAc;AAAA,CAA2C;AAAA,IAClF;AAAA,EACF;AAEA,SAAO,EAAE,UAAU,EAAE;AACvB;","names":[]}

package/dist/scan-PKSYSTRR.js

@@ -0,0 +1,15 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import {
+  scan
+} from "./chunk-ONUP6Z4W.js";
+import "./chunk-6SQPP47U.js";
+import "./chunk-D2CDBRNU.js";
+import "./chunk-HQ6A6DTV.js";
+import "./chunk-32LIWN2P.js";
+import "./chunk-MHIBEEW4.js";
+import "./chunk-QCN35LJU.js";
+import "./chunk-7DZC4YEV.js";
+export {
+  scan
+};
+//# sourceMappingURL=scan-PKSYSTRR.js.map

package/dist/{scan-generate-TFZVL3BT.js → scan-generate-VY27PIOX.js}

@@ -1,22 +1,144 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
-import {
-  createComponentExtractor
-} from "./chunk-EYXVAMEX.js";
-import "./chunk-55KERLWL.js";
+import "./chunk-D2CDBRNU.js";
 import {
   discoverAllComponents
-} from "./chunk-ZKTFKHWN.js";
-import "./chunk-D2CDBRNU.js";
+} from "./chunk-HQ6A6DTV.js";
 import {
   BRAND
-} from "./chunk-I34BC3CU.js";
-import "./chunk-Z7EY4VHE.js";
+} from "./chunk-32LIWN2P.js";
 
 // src/commands/scan-generate.ts
 import { readFile, writeFile, access, mkdir } from "fs/promises";
 import { resolve, basename, dirname, relative, join } from "path";
+import { execSync } from "child_process";
 import * as ts from "typescript";
 import pc from "picocolors";
+import {
+  createComponentExtractor
+} from "@fragments-sdk/extract";
+async function findNearestAncestor(scanPath, targetFile) {
+  let dir = resolve(scanPath);
+  for (let i = 0; i < 20; i++) {
+    try {
+      await access(join(dir, targetFile));
+      return dir;
+    } catch {
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  }
+  return null;
+}
+async function findNearestPackageJsonDir(scanPath) {
+  return findNearestAncestor(scanPath, "package.json");
+}
+async function detectPackageManagerForProject(projectDir) {
+  let dir = resolve(projectDir);
+  for (let i = 0; i < 20; i++) {
+    for (const [fileName, manager] of [
+      ["pnpm-lock.yaml", "pnpm"],
+      ["pnpm-workspace.yaml", "pnpm"],
+      ["yarn.lock", "yarn"],
+      ["package-lock.json", "npm"]
+    ]) {
+      try {
+        await access(join(dir, fileName));
+        return { manager, lockfileDir: dir };
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return { manager: "npm", lockfileDir: null };
+}
+function resolveCoreInstallCommand(manager) {
+  switch (manager) {
+    case "pnpm":
+      return "pnpm add -D @fragments-sdk/core";
+    case "yarn":
+      return "yarn add -D @fragments-sdk/core";
+    default:
+      return "npm install -D @fragments-sdk/core";
+  }
+}
+async function ensureCoreDependency(scanPath) {
+  const projectDir = await findNearestPackageJsonDir(scanPath);
+  if (!projectDir) return;
+  const pkgJsonPath = join(projectDir, "package.json");
+  try {
+    const pkgRaw = await readFile(pkgJsonPath, "utf-8");
+    const pkg = JSON.parse(pkgRaw);
+    const deps = pkg.dependencies || {};
+    const devDeps = pkg.devDependencies || {};
+    if (deps["@fragments-sdk/core"] || devDeps["@fragments-sdk/core"]) {
+      console.log(pc.dim("  \xB7 @fragments-sdk/core already installed"));
+      return;
+    }
+    const { manager } = await detectPackageManagerForProject(projectDir);
+    const cmd = resolveCoreInstallCommand(manager);
+    execSync(cmd, { cwd: projectDir, stdio: "ignore" });
+    console.log(pc.green("  \u2713 Installed @fragments-sdk/core"));
+  } catch (e) {
+    console.log(
+      pc.yellow(
+        `  \u26A0 Could not auto-install @fragments-sdk/core: ${e instanceof Error ? e.message : String(e)}`
+      )
+    );
+  }
+}
+async function excludeFragmentsFromTsconfig(scanPath) {
+  const projectDir = await findNearestPackageJsonDir(scanPath);
+  if (!projectDir) return;
+  let tsconfigPath = null;
+  let tsconfigName = "";
+  for (const name of ["tsconfig.app.json", "tsconfig.json"]) {
+    const candidate = join(projectDir, name);
+    try {
+      await access(candidate);
+      tsconfigPath = candidate;
+      tsconfigName = name;
+      break;
+    } catch {
+    }
+  }
+  if (!tsconfigPath) return;
+  try {
+    const raw = await readFile(tsconfigPath, "utf-8");
+    const parsed = ts.parseConfigFileTextToJson(tsconfigPath, raw);
+    if (parsed.error || !parsed.config) {
+      throw new Error(parsed.error?.messageText?.toString() ?? "Unable to parse tsconfig");
+    }
+    const config = parsed.config;
+    const exclude = Array.isArray(config.exclude) ? [...config.exclude] : [];
+    const ext = BRAND.fileExtension;
+    const alreadyExcluded = exclude.some(
+      (pattern) => pattern.includes(`*${ext}`) || pattern.includes("*.fragment.*") || pattern.includes("*.contract.*")
+    );
+    if (alreadyExcluded) {
+      console.log(
+        pc.dim(`  \xB7 ${ext} already excluded in ${tsconfigName}`)
+      );
+      return;
+    }
+    exclude.push(`**/*${ext}`);
+    config.exclude = exclude;
+    const updated = `${JSON.stringify(config, null, 2)}
+`;
+    await writeFile(tsconfigPath, updated, "utf-8");
+    console.log(
+      pc.green(`  \u2713 Added ${ext} exclusion to ${tsconfigName}`)
+    );
+  } catch (e) {
+    console.log(
+      pc.yellow(
+        `  \u26A0 Could not update ${tsconfigName}: ${e instanceof Error ? e.message : String(e)}`
+      )
+    );
+  }
+}
 async function scanGenerate(options) {
   const scanPath = resolve(options.scanPath);
   const generated = [];
@@ -122,7 +244,7 @@ ${BRAND.name} Scan \u2192 Generate
     });
     enrichments = enrichResult.enrichments;
     if (enrichResult.model && enrichResult.totalInputTokens > 0) {
-      const { calculateCost } = await import("./ai-client-I6MDWNYA.js");
+      const { calculateCost } = await import("./ai-client-LSLQGOMM.js");
       enrichmentCost = calculateCost(
         enrichResult.model,
         enrichResult.totalInputTokens,
@@ -168,13 +290,26 @@ Phase ${options.enrich ? "4" : "3"}: Generating fragment files...`));
         comp.sourcePath,
         componentBaseName
       );
-      const content = generateFragmentWithTodos(
-        comp.name,
-        importPath,
-        data,
-        confidence,
-        enrichment
-      );
+      let content;
+      if (fragmentPath.endsWith(".contract.json")) {
+        content = generateContractJsonFromScan(
+          comp.name,
+          componentBaseName,
+          data,
+          confidence,
+          comp.sourcePath,
+          scanPath,
+          enrichment
+        );
+      } else {
+        content = generateFragmentWithTodos(
+          comp.name,
+          importPath,
+          data,
+          confidence,
+          enrichment
+        );
+      }
       await writeFile(fragmentPath, content, "utf-8");
       const relPath = relative(process.cwd(), fragmentPath);
       generated.push({
@@ -196,6 +331,10 @@ Phase ${options.enrich ? "4" : "3"}: Generating fragment files...`));
       console.log(pc.red(`  \u2717 ${comp.name}: ${e instanceof Error ? e.message : String(e)}`));
     }
   }
+  if (generated.length > 0) {
+    await ensureCoreDependency(scanPath);
+    await excludeFragmentsFromTsconfig(scanPath);
+  }
   const avgConfidence = generated.length > 0 ? Math.round(
     generated.reduce((sum, g) => sum + g.confidence, 0) / generated.length
   ) : 0;
@@ -450,12 +589,12 @@ Rules:
 }
 function buildEnrichmentUserPrompt(name, data) {
   const props = data.meta?.props ?? {};
-  const localProps = Object.entries(props).filter(([_, p]) => p.source === "local");
+  const fragmentProps = getFragmentPropEntries(props);
   const composition = data.meta?.composition ?? null;
   const description = data.meta?.description || "";
   const category = inferCategoryFromMeta(
     name,
-    Object.fromEntries(localProps)
+    Object.fromEntries(fragmentProps)
   );
   const lines = [
     `Component: ${name}`,
@@ -464,10 +603,10 @@ function buildEnrichmentUserPrompt(name, data) {
   if (description) {
     lines.push(`Description: ${description}`);
   }
-  if (localProps.length > 0) {
+  if (fragmentProps.length > 0) {
     lines.push("");
     lines.push("Props:");
-    for (const [propName, prop] of localProps) {
+    for (const [propName, prop] of fragmentProps) {
       let propLine = `  - ${propName}: ${prop.typeKind}`;
       if (prop.values && prop.values.length > 0) {
         propLine += ` (${prop.values.join(" | ")})`;
@@ -528,7 +667,7 @@ async function enrichComponents(componentDataList, options) {
     createAIClient,
     generateCompletion,
     ENRICHMENT_MODELS
-  } = await import("./ai-client-I6MDWNYA.js");
+  } = await import("./ai-client-LSLQGOMM.js");
   const provider = detectProvider({ provider: options.provider, apiKey: options.apiKey });
   if (provider === "none") {
     console.log(pc.yellow("  No API key found. Set ANTHROPIC_API_KEY or OPENAI_API_KEY, or use --api-key"));
@@ -606,8 +745,8 @@ function calculateFieldConfidence(data, enrichment) {
   let score = 0;
   const todoFields = [];
   const props = data.meta?.props ?? {};
-  const localEntries = Object.values(props).filter((p) => p.source === "local");
-  const hasProps = localEntries.length > 0;
+  const fragmentPropEntries = getFragmentPropEntries(props);
+  const hasProps = fragmentPropEntries.length > 0;
   if (hasProps) {
     score += 30;
   }
@@ -616,10 +755,8 @@ function calculateFieldConfidence(data, enrichment) {
   } else {
     todoFields.push("meta.description");
   }
-  const localProps = Object.fromEntries(
-    Object.entries(props).filter(([_, p]) => p.source === "local")
-  );
-  const category = inferCategoryFromMeta(data.component.name, localProps);
+  const fragmentProps = Object.fromEntries(fragmentPropEntries);
+  const category = inferCategoryFromMeta(data.component.name, fragmentProps);
   if (category !== "Components") {
     score += 10;
   } else {
@@ -629,7 +766,7 @@ function calculateFieldConfidence(data, enrichment) {
     score += 25;
   }
   if (hasProps) {
-    const allResolved = localEntries.every((p) => p.typeKind !== "custom");
+    const allResolved = fragmentPropEntries.every(([_, p]) => p.typeKind !== "custom");
     if (allResolved) {
       score += 10;
     }
@@ -638,7 +775,7 @@ function calculateFieldConfidence(data, enrichment) {
     score += 10;
   }
   if (hasProps) {
-    const hasDefaults = localEntries.some((p) => p.default !== void 0);
+    const hasDefaults = fragmentPropEntries.some(([_, p]) => p.default !== void 0);
     if (hasDefaults) {
       score += 5;
     }
@@ -792,13 +929,55 @@ function inferAccessibilityFromMeta(props) {
   if (requirements.length > 0) accessibility.requirements = requirements;
   return accessibility;
 }
-function buildContractBlock(componentName, props, composition, accessibility) {
-  const localEntries = Object.entries(props).filter(([_, p]) => p.source === "local");
-  if (localEntries.length === 0 && !composition && !accessibility.requirements?.length) {
+var INHERITED_PROP_PRIORITY = [
+  "htmlFor",
+  "type",
+  "value",
+  "defaultValue",
+  "checked",
+  "defaultChecked",
+  "disabled",
+  "required",
+  "placeholder",
+  "name",
+  "id",
+  "form",
+  "accept",
+  "multiple",
+  "min",
+  "max",
+  "step",
+  "pattern",
+  "role",
+  "children"
+];
+function getFragmentPropEntries(props) {
+  const entries = Object.entries(props);
+  const localEntries = entries.filter(([_, prop]) => prop.source === "local");
+  if (localEntries.length > 0) {
+    return localEntries;
+  }
+  const prioritized = new Set(INHERITED_PROP_PRIORITY);
+  const inheritedEntries = entries.filter(([name, prop]) => {
+    if (prop.source !== "inherited") return false;
+    if (name === "key" || name === "ref" || name === "className" || name === "style") return false;
+    if (name.startsWith("on")) return false;
+    if (name.startsWith("aria-") || name.startsWith("data-")) return false;
+    return prioritized.has(name);
+  }).sort(([nameA], [nameB]) => {
+    const rankA = INHERITED_PROP_PRIORITY.indexOf(nameA);
+    const rankB = INHERITED_PROP_PRIORITY.indexOf(nameB);
+    return rankA - rankB;
+  });
+  return inheritedEntries.slice(0, 8);
+}
+function buildContractBlock(componentName, props, composition, accessibility, compoundPartRefs = []) {
+  const relevantEntries = getFragmentPropEntries(props);
+  if (relevantEntries.length === 0 && !composition && !accessibility.requirements?.length) {
     return null;
   }
   const contract = { propsSummary: [] };
-  for (const [name, prop] of localEntries) {
+  for (const [name, prop] of relevantEntries) {
     let summary = name + ": ";
     if (prop.typeKind === "enum" && prop.values && prop.values.length > 0) {
       summary += prop.values.join(" | ");
@@ -825,7 +1004,8 @@ function buildContractBlock(componentName, props, composition, accessibility) {
     contract.compoundChildren = children;
   }
   if (composition && composition.parts.length > 0) {
-    const innerLines = composition.parts.map((part) => `  <${componentName}.${part.name}>...</${componentName}.${part.name}>`).join("\n");
+    const resolvedParts = compoundPartRefs.length > 0 ? compoundPartRefs : composition.parts.map((part) => ({ partName: part.name, tagName: `${componentName}.${part.name}` }));
+    const innerLines = resolvedParts.map((part) => `  <${part.tagName}>...</${part.tagName}>`).join("\n");
     contract.canonicalUsage = [
       `<${componentName}>
 ${innerLines}
@@ -909,20 +1089,53 @@ function computeImportPath(fragmentDir, sourcePath, componentBaseName) {
 function escapeQuotes(str) {
   return str.replace(/'/g, "\\'");
 }
+function resolveCompoundPartReferences(componentName, composition, exportNames) {
+  if (!composition || composition.parts.length === 0) return [];
+  return composition.parts.map((part) => {
+    const directExportName = `${componentName}${part.name}`;
+    if (exportNames.includes(directExportName)) {
+      return {
+        partName: part.name,
+        tagName: directExportName,
+        importName: directExportName
+      };
+    }
+    return {
+      partName: part.name,
+      tagName: `${componentName}.${part.name}`
+    };
+  });
+}
 function generateFragmentWithTodos(componentName, importPath, data, confidence, enrichment) {
   const props = data.meta?.props ?? {};
   const localProps = Object.fromEntries(
     Object.entries(props).filter(([_, p]) => p.source === "local")
   );
+  const fragmentProps = Object.fromEntries(getFragmentPropEntries(props));
+  const inferenceProps = Object.keys(localProps).length > 0 ? localProps : fragmentProps;
   const composition = data.meta?.composition ?? null;
-  const description = data.meta?.description || inferDescriptionFromMeta(componentName, localProps);
+  const description = data.meta?.description || inferDescriptionFromMeta(componentName, inferenceProps);
   const descriptionTodo = data.meta?.description ? "" : " // TODO: Review description";
-  const category = inferCategoryFromMeta(componentName, localProps);
+  const category = inferCategoryFromMeta(componentName, inferenceProps);
   const categoryTodo = category === "Components" ? " // TODO: Set correct category" : "";
   const status = inferStatus(data.component.sourcePath);
-  const accessibility = inferAccessibilityFromMeta(localProps);
+  const accessibility = inferAccessibilityFromMeta(inferenceProps);
+  const exportNames = data.meta?.exports ?? [];
+  const compoundPartRefs = resolveCompoundPartReferences(componentName, composition, exportNames);
+  const importNames = Array.from(
+    /* @__PURE__ */ new Set([
+      componentName,
+      ...compoundPartRefs.flatMap((part) => part.importName ? [part.importName] : [])
+    ])
+  );
   const propsBlock = buildPropsBlockFromMeta(props);
-  const contract = buildContractBlock(componentName, props, composition, accessibility);
+  const contract = buildContractBlock(
+    componentName,
+    props,
+    composition,
+    accessibility,
+    compoundPartRefs
+  );
   if (contract && enrichment) {
     if (enrichment.a11yRules.length > 0) {
       contract.a11yRules = enrichment.a11yRules;
@@ -950,17 +1163,17 @@ function generateFragmentWithTodos(componentName, importPath, data, confidence,
   const variantsBlock = buildVariantsBlock(
     componentName,
     data.storyVariants,
-    composition
+    composition,
+    compoundPartRefs
   );
-  const aiBlock = buildAIBlock(composition);
+  const aiBlock = buildAIBlock(composition, compoundPartRefs);
   const provenanceBlock = buildProvenanceBlock(confidence, props);
   const compoundComment = composition && composition.parts.length > 0 ? `
 // Compound sub-components detected: ${composition.parts.map((p) => p.name).join(", ")}` : "";
   return `// Auto-generated by fragments init --scan | Confidence: ${confidence.score}/100
 // ${confidence.todoFields.length} TODO(s) \u2014 search for "TODO:" and fill in human knowledge${compoundComment}
-import React from 'react';
 import { defineFragment } from '@fragments-sdk/core';
-import { ${componentName} } from '${importPath}';
+import { ${importNames.join(", ")} } from '${importPath}';
 
 export default defineFragment({
   component: ${componentName},
@@ -983,7 +1196,7 @@ ${provenanceBlock}});
 `;
 }
 function buildPropsBlockFromMeta(props) {
-  const entries = Object.entries(props).filter(([_, p]) => p.source === "local");
+  const entries = getFragmentPropEntries(props);
   if (entries.length === 0) return "{}";
   const lines = entries.map(([name, prop]) => {
     const type = prop.typeKind;
@@ -1009,12 +1222,12 @@ ${parts.join(",\n")},
 ${lines.join("\n")}
   }`;
 }
-function buildVariantsBlock(componentName, storyVariants, composition) {
+function buildVariantsBlock(componentName, storyVariants, composition, compoundPartRefs = []) {
   const entries = [];
   const hasDefault = storyVariants.some((v) => v.name === "Default");
   if (!hasDefault) {
     if (composition && composition.pattern === "compound" && composition.parts.length > 0) {
-      entries.push(formatCompoundVariantEntry(componentName, composition));
+      entries.push(formatCompoundVariantEntry(componentName, composition, compoundPartRefs));
     } else {
       entries.push(formatVariantEntry(componentName, "Default", `Default ${componentName}`, {}));
     }
@@ -1041,9 +1254,9 @@ function formatVariantEntry(componentName, name, description, args) {
       render: () => ${jsxCode},
     },`;
 }
-function formatCompoundVariantEntry(componentName, composition) {
-  const parts = composition.parts;
-  const innerJsx = parts.map((part) => `    <${componentName}.${part.name}>...</${componentName}.${part.name}>`).join("\n");
+function formatCompoundVariantEntry(componentName, composition, compoundPartRefs = []) {
+  const resolvedParts = compoundPartRefs.length > 0 ? compoundPartRefs : composition.parts.map((part) => ({ partName: part.name, tagName: `${componentName}.${part.name}` }));
+  const innerJsx = resolvedParts.map((part) => `    <${part.tagName}>...</${part.tagName}>`).join("\n");
   const jsxCode = `<${componentName}>
 ${innerJsx}
   </${componentName}>`;
@@ -1056,12 +1269,16 @@ ${innerJsx}
       ),
     },`;
 }
-function buildAIBlock(composition) {
+function buildAIBlock(composition, compoundPartRefs = []) {
   if (!composition || composition.parts.length === 0) return "";
-  const subComponents = composition.parts.map((p) => `'${p.name}'`).join(", ");
+  const resolvedParts = compoundPartRefs.length > 0 ? compoundPartRefs : composition.parts.map((part) => ({
+    partName: part.name,
+    tagName: `Component.${part.name}`
+  }));
+  const subComponents = resolvedParts.map((part) => `'${part.importName ?? part.partName}'`).join(", ");
   const pattern = `
       <Component>
-${composition.parts.map((p) => `        <Component.${p.name}>...</Component.${p.name}>`).join("\n")}
+${resolvedParts.map((part) => `        <${part.tagName}>...</${part.tagName}>`).join("\n")}
       </Component>`;
   return `
 
@@ -1100,6 +1317,73 @@ function buildJsxString(componentName, args) {
   }
   return `<${componentName}${propsStr} />`;
 }
+function generateContractJsonFromScan(componentName, _baseName, data, confidence, sourcePath, scanPath, enrichment) {
+  const props = data.meta?.props ?? {};
+  const localProps = Object.fromEntries(
+    Object.entries(props).filter(([, p]) => p.source === "local")
+  );
+  const effectiveProps = Object.keys(localProps).length > 0 ? localProps : props;
+  const composition = data.meta?.composition ?? null;
+  const description = data.meta?.description || `${componentName} component`;
+  const category = inferCategoryFromMeta(componentName, effectiveProps);
+  const propsSchema = {};
+  for (const [name, prop] of Object.entries(effectiveProps)) {
+    propsSchema[name] = {
+      type: prop.typeKind,
+      description: prop.description ?? "",
+      ...prop.values?.length && { values: prop.values },
+      ...prop.default !== void 0 && { default: prop.default },
+      ...prop.required && { required: true }
+    };
+  }
+  const propsSummary = Object.entries(effectiveProps).map(([name, prop]) => {
+    let summary = `${name}: `;
+    if (prop.values?.length) {
+      summary += prop.values.join("|");
+    } else {
+      summary += prop.typeKind;
+    }
+    if (prop.default !== void 0) summary += ` (default: ${prop.default})`;
+    if (prop.required) summary += " (required)";
+    return summary;
+  });
+  let ai;
+  if (composition) {
+    ai = {
+      compositionPattern: composition.pattern,
+      subComponents: composition.parts.map((p) => p.name),
+      ...composition.required.length > 0 && { requiredChildren: composition.required }
+    };
+  }
+  const relativeSourcePath = relative(scanPath, sourcePath);
+  const usage = enrichment ? {
+    when: enrichment.when ?? [],
+    whenNot: enrichment.whenNot ?? [],
+    ...enrichment.guidelines?.length && { guidelines: enrichment.guidelines }
+  } : {
+    when: [],
+    whenNot: []
+  };
+  const contract = {
+    $schema: "https://usefragments.com/schemas/contract.v1.json",
+    name: componentName,
+    description,
+    category,
+    sourcePath: relativeSourcePath,
+    exportName: componentName,
+    propsSummary,
+    props: propsSchema,
+    usage,
+    ...ai && { ai },
+    provenance: {
+      source: "extracted",
+      verified: confidence.score >= 70,
+      frameworkSupport: "native",
+      extractedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+  return JSON.stringify(contract, null, 2) + "\n";
+}
 export {
   buildEnrichedUsageBlock,
   buildEnrichmentSystemPrompt,
@@ -1107,9 +1391,13 @@ export {
   calculateFieldConfidence,
   detectCompoundComponents,
   detectCompoundComponentsFromSource,
+  detectPackageManagerForProject,
+  ensureCoreDependency,
+  excludeFragmentsFromTsconfig,
   extractComponentJSDoc,
   extractComponentJSDocFromSource,
   parseEnrichmentResponse,
+  resolveCoreInstallCommand,
   scanGenerate
 };
-//# sourceMappingURL=scan-generate-TFZVL3BT.js.map
+//# sourceMappingURL=scan-generate-VY27PIOX.js.map