@ggui-ai/ui-gen 0.27.0 → 0.29.0

package/dist/chunk-33B3BAWS.js

@@ -0,0 +1,24 @@
+import { FORBIDDEN_IMPORT_SPECIFIERS } from '@ggui-ai/design/rendering';
+
+// src/validation/allowed-imports.ts
+var ALLOWED_IMPORT_BASES = [
+  "react",
+  "react-dom",
+  "@ggui-ai/design",
+  "@ggui-ai/wire",
+  "@ggui-ai/gadgets"
+];
+function isAllowedImport(specifier, gadgetPackages) {
+  if (FORBIDDEN_IMPORT_SPECIFIERS.includes(specifier)) return false;
+  for (const base of ALLOWED_IMPORT_BASES) {
+    if (specifier === base || specifier.startsWith(`${base}/`)) return true;
+  }
+  return gadgetPackages?.has(specifier) ?? false;
+}
+function describeAllowedImports() {
+  return "react, @ggui-ai/design, @ggui-ai/wire, @ggui-ai/gadgets, or a gadget package declared on the contract \u2014 never @ggui-ai/wire/internal (the writer side of the wire; components read useRender().isConnected)";
+}
+
+export { describeAllowedImports, isAllowedImport };
+//# sourceMappingURL=chunk-33B3BAWS.js.map
+//# sourceMappingURL=chunk-33B3BAWS.js.map

package/dist/chunk-33B3BAWS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation/allowed-imports.ts"],"names":[],"mappings":";;;AA0BO,IAAM,oBAAA,GAAuB;AAAA,EAClC,OAAA;AAAA,EACA,WAAA;AAAA,EACA,iBAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF,CAAA;AAUO,SAAS,eAAA,CACd,WACA,cAAA,EACS;AACT,EAAA,IAAI,2BAAA,CAA4B,QAAA,CAAS,SAAS,CAAA,EAAG,OAAO,KAAA;AAC5D,EAAA,KAAA,MAAW,QAAQ,oBAAA,EAAsB;AACvC,IAAA,IAAI,SAAA,KAAc,QAAQ,SAAA,CAAU,UAAA,CAAW,GAAG,IAAI,CAAA,CAAA,CAAG,GAAG,OAAO,IAAA;AAAA,EACrE;AACA,EAAA,OAAO,cAAA,EAAgB,GAAA,CAAI,SAAS,CAAA,IAAK,KAAA;AAC3C;AAMO,SAAS,sBAAA,GAAiC;AAC/C,EAAA,OAAO,kNAAA;AACT","file":"chunk-33B3BAWS.js","sourcesContent":["/**\n * The single source of truth for which packages LLM-generated\n * component code may import.\n *\n * Before this module the allowlist was duplicated — as `startsWith`\n * chains, as literal arrays, as hand-written error strings — across\n * `adapters/tools.ts`, `check/run-tier0.ts`, `check/type-checker.ts`\n * and `validation/component-detailed.ts`. The copies had already\n * drifted (one rejected `react-dom`, others allowed it). Every\n * import-validation site now derives from {@link isAllowedImport}.\n *\n * The design system is imported through ONE specifier — `@ggui-ai/design`\n * — never the `/primitives`, `/components`, `/compositions`, `/interact`\n * subpaths. The barrel re-exports every layer, so the generation LLM\n * never has to predict which subpath a component lives in. Subpaths\n * still resolve (the predicate allows any `@ggui-ai/design/...`), but\n * the prompt and catalog teach the barrel exclusively.\n */\n\n/**\n * Static package specifiers generated code may import. A subpath of\n * any base (`<base>/...`) is allowed too. Per-contract gadget packages\n * are dynamic — pass them to {@link isAllowedImport}.\n */\nimport { FORBIDDEN_IMPORT_SPECIFIERS } from '@ggui-ai/design/rendering';\n\nexport const ALLOWED_IMPORT_BASES = [\n  'react',\n  'react-dom',\n  '@ggui-ai/design',\n  '@ggui-ai/wire',\n  '@ggui-ai/gadgets',\n] as const;\n\n/**\n * True if `specifier` is a package generated component code may import:\n * one of {@link ALLOWED_IMPORT_BASES} (or a subpath of one), or a\n * contract-declared gadget package — and never one of the design package's\n * `FORBIDDEN_IMPORT_SPECIFIERS` (ggui#843: `@ggui-ai/wire/internal` is the\n * writer side of the wire; the load-time rewriter refuses it from the same\n * list, so the two gates cannot drift apart).\n */\nexport function isAllowedImport(\n  specifier: string,\n  gadgetPackages?: ReadonlySet<string>,\n): boolean {\n  if (FORBIDDEN_IMPORT_SPECIFIERS.includes(specifier)) return false;\n  for (const base of ALLOWED_IMPORT_BASES) {\n    if (specifier === base || specifier.startsWith(`${base}/`)) return true;\n  }\n  return gadgetPackages?.has(specifier) ?? false;\n}\n\n/**\n * Human-readable allowed-import list for error messages shown to the\n * generation LLM.\n */\nexport function describeAllowedImports(): string {\n  return 'react, @ggui-ai/design, @ggui-ai/wire, @ggui-ai/gadgets, or a gadget package declared on the contract — never @ggui-ai/wire/internal (the writer side of the wire; components read useRender().isConnected)';\n}\n"]}

package/dist/chunk-3HSGA6NI.js

@@ -0,0 +1,591 @@
+import { DEFAULT_DESIGN_SYSTEM_DOCS } from './chunk-56NJFD55.js';
+import { PRIMITIVES_DOCUMENTATION, validateComponentDetailed, formatValidationResultForClaude } from './chunk-HD6ABIK7.js';
+import { validateAllContracts, generateSampleProps, typecheck, lintReactHooks } from './chunk-FWJIMKFZ.js';
+import { isAllowedImport, describeAllowedImports } from './chunk-33B3BAWS.js';
+import { parseVerdictLine } from './chunk-FLRNMZV2.js';
+import * as z from 'zod';
+import * as esbuild from 'esbuild';
+import ts from 'typescript';
+import { existsSync } from 'fs';
+import { createRequire } from 'module';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { runSandboxed } from '@ggui-ai/sandbox';
+
+var RENDER_TIMEOUT_MS = 12e3;
+var RENDER_STDOUT_CAP = 512 * 1024;
+var RENDER_NODE_HEAP_MB = 256;
+function resolveWorkerSpawn() {
+  const jsCandidates = [
+    new URL("./render-check-worker.js", import.meta.url),
+    new URL("./tools/render-check-worker.js", import.meta.url),
+    new URL("../tools/render-check-worker.js", import.meta.url)
+  ];
+  const tsCandidates = [
+    new URL("./render-check-worker.ts", import.meta.url),
+    new URL("../tools/render-check-worker.ts", import.meta.url)
+  ];
+  for (const jsUrl of jsCandidates) {
+    const jsPath = fileURLToPath(jsUrl);
+    if (existsSync(jsPath)) {
+      return { command: process.execPath, args: [jsPath] };
+    }
+  }
+  for (const tsUrl of tsCandidates) {
+    const tsPath = fileURLToPath(tsUrl);
+    if (existsSync(tsPath)) {
+      const require_ = createRequire(import.meta.url);
+      const tsxLoader = pathToFileURL(require_.resolve("tsx")).href;
+      return {
+        command: process.execPath,
+        args: ["--import", tsxLoader, tsPath]
+      };
+    }
+  }
+  const tried = [...jsCandidates, ...tsCandidates].map((u) => fileURLToPath(u)).join(", ");
+  throw new Error(
+    `render-check: worker not found at any of: ${tried}. Did \`pnpm build\` run?`
+  );
+}
+async function tryRender(compiledCode, sourceCode, sampleProps) {
+  const payload = JSON.stringify({ sourceCode, sampleProps });
+  const spawn = resolveWorkerSpawn();
+  const result = await runSandboxed({
+    command: spawn.command,
+    args: spawn.args,
+    timeoutMs: RENDER_TIMEOUT_MS,
+    maxStdoutBytes: RENDER_STDOUT_CAP,
+    nodeHeapMb: RENDER_NODE_HEAP_MB,
+    stdin: payload,
+    // Forward only what the worker needs. NODE_ENV lets React pick
+    // production vs development builds; everything else stays at the
+    // sandbox's default allowlist (PATH/HOME/TMPDIR bootstrap).
+    env: {
+      NODE_ENV: process.env.NODE_ENV ?? "production"
+    }
+  });
+  if (result.outcome === "timeout") {
+    return `Render timeout: component did not finish within ${RENDER_TIMEOUT_MS}ms (likely infinite loop or runaway recursion).`;
+  }
+  if (result.outcome === "overflow-stdout" || result.outcome === "overflow-stderr") {
+    return `Render error: worker produced excessive output (${result.outcome}). The component is likely in a pathological state.`;
+  }
+  if (result.outcome === "canceled") {
+    return "Render error: smoke test was canceled before completing.";
+  }
+  if (result.outcome === "spawn-error") {
+    return `Render error: failed to start worker \u2014 ${result.errorMessage}`;
+  }
+  if (result.outcome !== "exit") {
+    return `Render error: unexpected sandbox outcome '${result.outcome}'.`;
+  }
+  if (result.exitCode !== 0) {
+    const tail = result.stderr.trim() || result.stdout.trim();
+    return `Render error: worker exited ${result.exitCode}${tail ? ` \u2014 ${tail}` : ""}`;
+  }
+  let verdict;
+  try {
+    verdict = parseVerdictLine(result.stdout);
+  } catch (err) {
+    return `Render error: malformed worker verdict \u2014 ${err instanceof Error ? err.message : String(err)}`;
+  }
+  if (verdict === void 0) {
+    return "Render error: worker exited without producing a verdict.";
+  }
+  return verdict.ok ? null : verdict.error;
+}
+
+// src/adapters/tools.ts
+function createGeneratorTools(context = {}) {
+  const tools = [
+    // --- get_primitives ---
+    {
+      name: "get_primitives",
+      description: "Get the list of available ggui UI primitives (Container, Card, Stack, Button, Input, etc.) that can be used in components. Call this first to understand what components are available.",
+      inputSchema: z.object({}),
+      handler: async () => ({
+        content: [{ type: "text", text: PRIMITIVES_DOCUMENTATION }]
+      })
+    },
+    // --- get_design_system ---
+    {
+      name: "get_design_system",
+      description: "Get the design system tokens and CSS variables for this app. Use these CSS variables (var(--ggui-*)) for colors, spacing, typography, etc.",
+      inputSchema: z.object({}),
+      handler: async () => ({
+        content: [{
+          type: "text",
+          text: context.designContext ? `# App Theme Configuration
+
+${context.designContext}
+
+**IMPORTANT:** Always use CSS variables (var(--ggui-*)) for colors, spacing, etc.` : DEFAULT_DESIGN_SYSTEM_DOCS
+        }]
+      })
+    },
+    // --- get_app_components ---
+    {
+      name: "get_app_components",
+      description: "Get predefined reusable components specific to this app. These can be imported and used in your generated component.",
+      inputSchema: z.object({}),
+      handler: async () => ({
+        content: [{
+          type: "text",
+          text: context.componentContext || "No predefined components available for this app."
+        }]
+      })
+    },
+    // --- validate_component ---
+    {
+      name: "validate_component",
+      description: "Validate component code before compilation. Checks for security issues, syntax errors, and best practices. Returns detailed feedback.",
+      inputSchema: z.object({
+        code: z.string().describe("The TypeScript/TSX component code to validate")
+      }),
+      handler: async (args) => {
+        const result = validateComponentDetailed(args.code);
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatValidationResultForClaude(result)
+            }
+          ],
+          isError: !result.valid
+        };
+      }
+    },
+    // --- self_check ---
+    {
+      name: "self_check",
+      description: "Run deterministic quality checks on your code BEFORE compiling. Catches common issues instantly (zero cost). Returns pass/fail per check with line numbers and fix instructions. Call this after writing code, fix any failures, then compile.",
+      inputSchema: z.object({
+        code: z.string().describe("The TypeScript/TSX component code to check")
+      }),
+      handler: async (args) => {
+        const code = args.code;
+        const { issues, typeWarnings } = await runSelfChecks(code, context.contract);
+        if (context.contract) {
+          const contractIssues = validateAllContracts(code, context.contract);
+          for (const ci of contractIssues) {
+            issues.push({
+              check: `contract:${ci.field}`,
+              line: 0,
+              message: `[${ci.severity}] ${ci.message}`,
+              fix: ci.fix
+            });
+          }
+        }
+        if (issues.length === 0) {
+          const warningText = typeWarnings.length > 0 ? `
+
+Type warnings (non-blocking):
+${typeWarnings.map((w) => `[${w.check}] ${w.line ? `Line ${w.line}: ` : ""}${w.message}`).join("\n")}` : "";
+          return {
+            content: [{ type: "text", text: `All checks passed. Ready to compile.${warningText}` }]
+          };
+        }
+        const report = issues.map((i) => `[${i.check}] ${i.line ? `Line ${i.line}: ` : ""}${i.message}
+  Fix: ${i.fix}`).join("\n\n");
+        return {
+          content: [{ type: "text", text: `${issues.length} issue(s) found:
+
+${report}` }],
+          isError: true
+        };
+      }
+    },
+    // --- compile_component ---
+    {
+      name: "compile_component",
+      description: "Compile a TypeScript/TSX component to JavaScript using esbuild. Returns the compiled code ready for browser execution. On failure, returns detailed error context with line numbers and fix suggestions.",
+      inputSchema: z.object({
+        code: z.string().describe("The TypeScript/TSX component code to compile"),
+        filename: z.string().default("Component.tsx").describe("Filename for error messages")
+      }),
+      handler: async (args) => {
+        const code = args.code;
+        const filename = args.filename || "Component.tsx";
+        const { issues: selfCheckIssues } = await runSelfChecks(code, context.contract);
+        if (context.contract) {
+          const contractIssues = validateAllContracts(code, context.contract);
+          for (const ci of contractIssues) {
+            selfCheckIssues.push({
+              check: `contract:${ci.field}`,
+              line: 0,
+              message: `[${ci.severity}] ${ci.message}`,
+              fix: ci.fix
+            });
+          }
+        }
+        if (selfCheckIssues.length > 0) {
+          const report = selfCheckIssues.map((i) => `[${i.check}] ${i.line ? `Line ${i.line}: ` : ""}${i.message}
+  Fix: ${i.fix}`).join("\n\n");
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: false,
+                phase: "self_check",
+                error: `${selfCheckIssues.length} issue(s) found \u2014 fix these before recompiling:
+
+${report}`
+              }, null, 2)
+            }],
+            isError: true
+          };
+        }
+        const validation = validateComponentDetailed(code);
+        if (!validation.valid) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(
+                  {
+                    success: false,
+                    phase: "validation",
+                    error: formatValidationResultForClaude(validation)
+                  },
+                  null,
+                  2
+                )
+              }
+            ],
+            isError: true
+          };
+        }
+        try {
+          const result = await esbuild.transform(code, {
+            loader: "tsx",
+            target: "es2020",
+            format: "esm",
+            jsx: "automatic",
+            jsxImportSource: "react",
+            minify: true,
+            sourcefile: filename
+          });
+          const warnings = [
+            ...result.warnings.map((w) => w.text),
+            ...validation.warnings.map(
+              (w) => `[${w.type}] ${w.message}: ${w.suggestion}`
+            )
+          ];
+          if (context.contract) {
+            const contractIssues = validateAllContracts(code, context.contract);
+            const errors = contractIssues.filter((i) => i.severity === "error");
+            const contractWarnings = contractIssues.filter((i) => i.severity === "warning");
+            if (errors.length > 0) {
+              const report = errors.map((i) => `- [${i.field}] ${i.message}
+  Fix: ${i.fix}`).join("\n");
+              return {
+                content: [{
+                  type: "text",
+                  text: JSON.stringify({
+                    success: false,
+                    phase: "contract_validation",
+                    error: `Compilation succeeded but data contract validation failed:
+
+${report}
+
+Fix the Props interface to match the data contract, then recompile.`
+                  }, null, 2)
+                }],
+                isError: true
+              };
+            }
+            warnings.push(...contractWarnings.map((i) => `[contract:${i.field}] ${i.message}`));
+          }
+          const sampleProps = context.sampleProps ?? (context.contract?.propsSpec ? generateSampleProps(context.contract.propsSpec) : void 0);
+          const renderError = await tryRender(result.code, code, sampleProps);
+          if (renderError) {
+            return {
+              content: [{
+                type: "text",
+                text: JSON.stringify({
+                  success: false,
+                  phase: "render_smoke_test",
+                  compiledCode: result.code,
+                  error: `${renderError}
+
+The component compiled but crashes at runtime. Fix the null/undefined access and recompile.`,
+                  warnings
+                }, null, 2)
+              }],
+              isError: true
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(
+                  {
+                    success: true,
+                    compiledCode: result.code,
+                    warnings
+                  },
+                  null,
+                  2
+                )
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(
+                  { success: false, phase: "compilation", error: formatEsbuildError(error, code) },
+                  null,
+                  2
+                )
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    }
+  ];
+  return tools;
+}
+function formatEsbuildError(error, sourceCode) {
+  const parts = [];
+  if (error && typeof error === "object" && "errors" in error && Array.isArray(error.errors)) {
+    const esbuildError = error;
+    for (const err of esbuildError.errors) {
+      const line = err.location?.line;
+      const col = err.location?.column;
+      parts.push(`**Error:** ${err.text}`);
+      if (line) {
+        parts.push(`**Location:** Line ${line}, Column ${col ?? 0}`);
+        const lines = sourceCode.split("\n");
+        const start = Math.max(0, line - 3);
+        const end = Math.min(lines.length, line + 2);
+        const context = lines.slice(start, end).map((l, i) => {
+          const ln = start + i + 1;
+          return `${ln === line ? ">>> " : "    "}${ln} | ${l}`;
+        }).join("\n");
+        parts.push(`**Code:**
+\`\`\`
+${context}
+\`\`\``);
+      }
+    }
+  } else {
+    parts.push(`**Error:** ${error instanceof Error ? error.message : "Compilation failed"}`);
+  }
+  parts.push("\n**How to fix:** Review the error above, fix the code, then call compile_component again.");
+  return parts.join("\n");
+}
+var LABELED_COMPONENTS = /* @__PURE__ */ new Set(["Input", "TextArea", "Select"]);
+function checkReactRules(code) {
+  const sf = ts.createSourceFile("component.tsx", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+  const issues = [];
+  function visit(node) {
+    if (ts.isJsxSelfClosingElement(node) || ts.isJsxOpeningElement(node)) {
+      const tagName = node.tagName.getText(sf);
+      if (LABELED_COMPONENTS.has(tagName)) {
+        const propNames = /* @__PURE__ */ new Set();
+        let hasSpread = false;
+        for (const attr of node.attributes.properties) {
+          if (ts.isJsxAttribute(attr)) {
+            propNames.add(attr.name.getText(sf));
+          } else if (ts.isJsxSpreadAttribute(attr)) {
+            hasSpread = true;
+          }
+        }
+        if (!hasSpread && !propNames.has("label") && !propNames.has("aria-label")) {
+          const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+          issues.push({
+            check: "accessibility",
+            line,
+            message: `${tagName} missing label prop`,
+            fix: `Add label="..." prop directly on the ${tagName} component. The label prop is built into the primitive.`
+          });
+        }
+      }
+    }
+    ts.forEachChild(node, visit);
+  }
+  visit(sf);
+  return issues;
+}
+async function runSelfChecks(code, contract) {
+  const issues = [];
+  const lines = code.split("\n");
+  const allowedGadgetPackages = new Set(
+    Object.keys(contract?.clientCapabilities?.gadgets ?? {})
+  );
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNum = i + 1;
+    const hexMatch = line.match(/#[0-9a-fA-F]{3,8}\b/);
+    if (hexMatch && !line.includes("var(--ggui-") && !line.includes("// fallback")) {
+      issues.push({
+        check: "hex-color",
+        line: lineNum,
+        message: `Hardcoded color "${hexMatch[0]}" \u2014 must use design tokens`,
+        fix: `Replace "${hexMatch[0]}" with a primitive variant OR a bare token reference such as var(--ggui-color-primary-500) \u2014 never a literal fallback inside var()`
+      });
+    }
+    const colorFnMatch = line.match(/\b(rgba?|hsla?)\s*\(/);
+    if (colorFnMatch && !line.includes("var(--ggui-") && !line.includes("// fallback") && !line.includes("$value")) {
+      issues.push({
+        check: "hardcoded-color-fn",
+        line: lineNum,
+        message: `Hardcoded ${colorFnMatch[1]}() \u2014 use design tokens instead`,
+        fix: `Replace with the layering roles: var(--ggui-color-container), var(--ggui-color-onContainer), var(--ggui-color-outline), etc.`
+      });
+    }
+    if (/--ggui-color-neutral-50[^0-9]/.test(line) && /background/i.test(line)) {
+      issues.push({
+        check: "prefer-semantic",
+        line: lineNum,
+        message: `neutral-50 for background \u2014 prefer semantic token for dark-theme compatibility`,
+        fix: `Replace with var(--ggui-color-container) or var(--ggui-color-sunken)`
+      });
+    }
+    if (/--ggui-color-neutral-900[^0-9]/.test(line) && /color/i.test(line) && !/background/i.test(line)) {
+      issues.push({
+        check: "prefer-semantic",
+        line: lineNum,
+        message: `neutral-900 for text color \u2014 prefer semantic token for dark-theme compatibility`,
+        fix: `Replace with var(--ggui-color-onContainer) or var(--ggui-color-onSunken)`
+      });
+    }
+    const pxMatch = line.match(/(?:padding|margin|gap|borderRadius)\s*:\s*['"]?\d+px/);
+    if (pxMatch && !line.includes("var(--ggui-")) {
+      issues.push({
+        check: "raw-pixels",
+        line: lineNum,
+        message: `Raw pixel value in spacing \u2014 must use design tokens`,
+        fix: `Replace with a bare var(--ggui-spacing-*) token \u2014 no literal fallback \u2014 or the scale name on the primitive prop (gap="md", padding="lg")`
+      });
+    }
+    if (/\beval\s*\(/.test(line)) {
+      issues.push({ check: "security", line: lineNum, message: "eval() is forbidden", fix: "Remove eval() call entirely" });
+    }
+    if (/\bfetch\s*\(/.test(line)) {
+      issues.push({ check: "security", line: lineNum, message: "fetch() is forbidden \u2014 use props for data", fix: "Remove fetch() and pass data via props" });
+    }
+    const importMatch = line.match(/import\s+.*from\s+['"]([^'"]+)['"]/);
+    if (importMatch) {
+      const pkg = importMatch[1];
+      if (!isAllowedImport(pkg, allowedGadgetPackages)) {
+        issues.push({
+          check: "import",
+          line: lineNum,
+          message: `Import from "${pkg}" is not allowed`,
+          fix: `Only import from: ${describeAllowedImports()}`
+        });
+      }
+    }
+  }
+  try {
+    const jsxIssues = checkReactRules(code);
+    issues.push(...jsxIssues);
+  } catch {
+  }
+  if (!code.includes("interface Props") && !code.includes("type Props")) {
+    issues.push({
+      check: "props-interface",
+      line: 1,
+      message: "No Props interface found \u2014 data is likely hardcoded",
+      fix: "Add interface Props { ... } with typed fields and default values in the function signature"
+    });
+  }
+  if (!code.includes("export default function")) {
+    issues.push({
+      check: "export",
+      line: 1,
+      message: "Missing default export function",
+      fix: "Add export default function GeneratedComponent(props: Props) { ... }"
+    });
+  }
+  const typeWarnings = [];
+  const [typeResult, reactResult] = await Promise.all([
+    typecheck(code).catch((err) => {
+      console.warn("[runSelfChecks] TypeChecker failed:", err instanceof Error ? err.message : String(err));
+      return null;
+    }),
+    lintReactHooks(code).catch((err) => {
+      console.warn("[runSelfChecks] React linter failed:", err instanceof Error ? err.message : String(err));
+      return [];
+    })
+  ]);
+  if (typeResult) {
+    for (const error of typeResult.errors) {
+      issues.push({
+        check: `ts${error.code}`,
+        line: error.line,
+        message: error.message,
+        fix: error.fix
+      });
+    }
+    for (const warning of typeResult.warnings) {
+      typeWarnings.push({
+        check: `ts${warning.code}`,
+        line: warning.line,
+        message: warning.message,
+        fix: warning.fix
+      });
+    }
+  }
+  const hasStateSetter = /\b(set[A-Z]\w*|dispatch)\s*\(/.test(code);
+  const isSetterLoopRisk = (diag) => {
+    if (diag.rule !== "react-hooks/exhaustive-deps") return false;
+    if (!hasStateSetter) return false;
+    return /missing dependenc|changes on every render|object makes the dependencies|array makes the dependencies/i.test(
+      diag.message
+    );
+  };
+  for (const diag of reactResult) {
+    const blocking = diag.severity === "error" || isSetterLoopRisk(diag);
+    if (blocking) {
+      issues.push({
+        check: diag.rule,
+        line: diag.line,
+        message: isSetterLoopRisk(diag) ? `${diag.message} (promoted to error: effect mutates state \u2014 missing/unstable deps cause infinite render loops)` : diag.message,
+        fix: diag.fix
+      });
+    } else {
+      typeWarnings.push({
+        check: diag.rule,
+        line: diag.line,
+        message: diag.message,
+        fix: diag.fix
+      });
+    }
+  }
+  const lineMap = /* @__PURE__ */ new Map();
+  for (const i of issues) {
+    const list = lineMap.get(i.line) ?? [];
+    list.push(i);
+    lineMap.set(i.line, list);
+  }
+  const deduped = [];
+  for (const [, group] of lineMap) {
+    if (group.length === 1) {
+      deduped.push(group[0]);
+      continue;
+    }
+    const primary = group.find((i) => !i.check.startsWith("ts")) ?? group[0];
+    const others = group.filter((i) => i !== primary);
+    if (others.length > 0) {
+      const alsoTags = others.map((o) => o.check).join(", ");
+      deduped.push({
+        ...primary,
+        message: `${primary.message} [also flagged by: ${alsoTags}]`
+      });
+    } else {
+      deduped.push(primary);
+    }
+  }
+  return { issues: deduped, typeWarnings };
+}
+
+export { createGeneratorTools };
+//# sourceMappingURL=chunk-3HSGA6NI.js.map
+//# sourceMappingURL=chunk-3HSGA6NI.js.map