@ggui-ai/ui-gen 0.23.0 → 0.25.0

package/dist/check/index.d.ts

@@ -1,9 +1,10 @@
 import { DataContract, JsonObject, PropsSpec, ActionSpec, StreamSpec } from '@ggui-ai/protocol';
 import { D as DesignMode } from '../design-mode-DLufhrNp.js';
-import { b as EvalResult, E as EvalIssue } from '../types-public-Ow-tNtFE.js';
+import { b as EvalResult, E as EvalIssue } from '../types-public-BJTLpzWn.js';
 export { j as jsonSchemaTypeToTs } from '../json-schema-ts-CbB78b3n.js';
-import '../axes-CzLEMDeB.js';
-import '../types-BOvHNG7K.js';
+import '@ggui-ai/mcp-server-core';
+import '../axes-CKVCzR_x.js';
+import '../types-Dh1s4K9j.js';
 
 /**
  * The four contract-declared wire kinds, matching `@ggui-ai/wire` hooks.
@@ -243,4 +244,11 @@ designMode?: DesignMode): Promise<EvalIssue[]>;
  */
 declare function runTier0(sourceCode: string, contract?: DataContract, designMode?: DesignMode): Promise<EvalResult>;
 
-export { type ContractIssue, type ReactLintDiagnostic, type TypeCheckDiagnostic, type TypeCheckResult, type WireCallSite, type WireImportReport, type WireImportSite, type WireKind, type WirePreservationReport, checkWireImports, checkWirePreservation, collectExpectedWires, extractPropsInterface, extractWireCallSites, extractWireImports, inferPropsSpecFromSampleData, lintReactHooks, propsSpecToTypeScript, runTier0, runTier0Checks, typecheck, validateActionSpecConformance, validateAllContracts, validatePropsAgainstSchema, validateStreamSpecConformance };
+/**
+ * Generate sample props from a PropsSpec contract.
+ * Uses `example` values from each PropEntry when available,
+ * otherwise synthesizes plausible defaults from the JSON Schema.
+ */
+declare function generateSampleProps(spec: PropsSpec): JsonObject;
+
+export { type ContractIssue, type ReactLintDiagnostic, type TypeCheckDiagnostic, type TypeCheckResult, type WireCallSite, type WireImportReport, type WireImportSite, type WireKind, type WirePreservationReport, checkWireImports, checkWirePreservation, collectExpectedWires, extractPropsInterface, extractWireCallSites, extractWireImports, generateSampleProps, inferPropsSpecFromSampleData, lintReactHooks, propsSpecToTypeScript, runTier0, runTier0Checks, typecheck, validateActionSpecConformance, validateAllContracts, validatePropsAgainstSchema, validateStreamSpecConformance };

package/dist/check/index.js

@@ -1024,6 +1024,52 @@ function detectCertainDoubleWiredActions(sourceCode, actionBindings, designMode
   return issues;
 }
 var MANIFEST_TOKENS = new Set(consumedTokenManifest);
+var RETIRED_TOKEN_SUCCESSORS = /* @__PURE__ */ new Map([
+  ["--ggui-color-surface", "--ggui-color-container"],
+  ["--ggui-color-onSurface", "--ggui-color-onContainer"],
+  ["--ggui-color-surfaceVariant", "--ggui-color-sunken"],
+  ["--ggui-color-onSurfaceVariant", "--ggui-color-onSunken"]
+]);
+function suggestManifestTokens(name) {
+  const successor = RETIRED_TOKEN_SUCCESSORS.get(name);
+  if (successor !== void 0) return [successor];
+  const segments = name.split("-").filter((segment) => segment.length > 0);
+  const own = name.endsWith("-") ? segments.length : segments.length - 1;
+  for (let n = own; n >= 2; n--) {
+    const prefix = `--${segments.slice(0, n).join("-")}-`;
+    const family = consumedTokenManifest.filter((token) => token.startsWith(prefix));
+    if (family.length > 0) return wordHitsFirst(name, rolesFirst(family));
+  }
+  const words = new Set(
+    segments.slice(1).filter((segment) => segment.length >= 4).map((segment) => segment.toLowerCase())
+  );
+  return rolesFirst(
+    consumedTokenManifest.filter(
+      (token) => token.split("-").some((segment) => words.has(segment.toLowerCase()))
+    )
+  );
+}
+function wordHitsFirst(name, family) {
+  const word = name.slice(name.lastIndexOf("-") + 1).toLowerCase();
+  if (word.length < 4) return family;
+  const hit = (token) => token.slice(token.lastIndexOf("-") + 1).toLowerCase().includes(word);
+  return [...family.filter(hit), ...family.filter((token) => !hit(token))];
+}
+function rolesFirst(tokens) {
+  const isRole = (token) => !/^\d+$/.test(token.slice(token.lastIndexOf("-") + 1));
+  return [...tokens.filter(isRole), ...tokens.filter((token) => !isRole(token))];
+}
+function offManifestHint(name) {
+  const successor = RETIRED_TOKEN_SUCCESSORS.get(name);
+  if (successor !== void 0) {
+    return `"${name}" was retired (ggui#987); the current name is var(${successor}). `;
+  }
+  const near = suggestManifestTokens(name);
+  if (near.length === 0) return "";
+  const shown = near.slice(0, 8).map((token) => `var(${token})`).join(", ");
+  const more = near.length > 8 ? ` (and ${near.length - 8} more in that family)` : "";
+  return `Nearest names in the manifest: ${shown}${more}. `;
+}
 var TOKEN_REF_RE = /var\(\s*(--ggui-[a-zA-Z0-9-]+)/g;
 var HOOK_NAME_FOR = {
   action: "useAction",
@@ -1257,7 +1303,7 @@ ${errorDetail}`,
         subcategory: "off-manifest-token",
         severity: "critical",
         description: `Token "${name}" is not in the design system's token manifest \u2014 no theme defines it, so it renders unset.`,
-        fix: `Choose a token that exists: the closed vocabulary is the manifest the design-system docs list (colors: var(--ggui-color-primary-500), var(--ggui-color-onContainer), \u2026; spacing: var(--ggui-spacing-4); type: var(--ggui-font-size-sm)). Never invent a name and never add a literal fallback.`,
+        fix: `${offManifestHint(name)}Choose a token that exists: the closed vocabulary is the manifest the design-system docs list (colors: var(--ggui-color-primary-500), var(--ggui-color-onContainer), \u2026; spacing: var(--ggui-spacing-4); type: var(--ggui-font-size-sm)). Never invent a name and never add a literal fallback.`,
         line: lineNum
       });
     }
@@ -1775,6 +1821,52 @@ async function runTier0(sourceCode, contract, designMode = DEFAULT_DESIGN_MODE)
   return { issues, pass };
 }
 
-export { checkWireImports, checkWirePreservation, collectExpectedWires, extractPropsInterface, extractWireCallSites, extractWireImports, inferPropsSpecFromSampleData, jsonSchemaTypeToTs, lintReactHooks, propsSpecToTypeScript, runTier0, runTier0Checks, typecheck, validateActionSpecConformance, validateAllContracts, validatePropsAgainstSchema, validateStreamSpecConformance };
+// src/check/sample-props.ts
+function generateSampleProps(spec) {
+  const props = {};
+  for (const [name, entry] of Object.entries(spec.properties)) {
+    if (entry.example !== void 0) {
+      props[name] = entry.example;
+      continue;
+    }
+    if (entry.default !== void 0) {
+      props[name] = entry.default;
+      continue;
+    }
+    props[name] = synthesizeFromSchema(entry.schema);
+  }
+  return props;
+}
+function synthesizeFromSchema(schema) {
+  const declared = Array.isArray(schema.type) ? schema.type.find((t) => t !== "null") : schema.type;
+  switch (declared) {
+    case "string":
+      return "sample";
+    case "number":
+    case "integer":
+      return 0;
+    case "boolean":
+      return false;
+    case "null":
+      return null;
+    case "array": {
+      if (schema.items) return [synthesizeFromSchema(schema.items) ?? null];
+      return [];
+    }
+    case "object": {
+      const obj = {};
+      if (schema.properties) {
+        for (const [k, v] of Object.entries(schema.properties)) {
+          obj[k] = synthesizeFromSchema(v);
+        }
+      }
+      return obj;
+    }
+    default:
+      return void 0;
+  }
+}
+
+export { checkWireImports, checkWirePreservation, collectExpectedWires, extractPropsInterface, extractWireCallSites, extractWireImports, generateSampleProps, inferPropsSpecFromSampleData, jsonSchemaTypeToTs, lintReactHooks, propsSpecToTypeScript, runTier0, runTier0Checks, typecheck, validateActionSpecConformance, validateAllContracts, validatePropsAgainstSchema, validateStreamSpecConformance };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map