@ggui-ai/ui-gen 0.28.0 → 0.29.0

package/dist/chunk-Z3CXME3K.js

@@ -0,0 +1,107 @@
+import { consumedTokenManifest } from '@ggui-ai/design/themes';
+
+// src/boilerplate/json-schema-ts.ts
+function jsonSchemaTypeToTs(schema) {
+  const unionMembers = schema.oneOf ?? schema.anyOf;
+  if (unionMembers?.length) {
+    const types = [...new Set(unionMembers.map((s) => jsonSchemaTypeToTs(s)))];
+    return types.length === 1 ? types[0] : types.join(" | ");
+  }
+  if (schema.const !== void 0) {
+    return typeof schema.const === "string" ? `'${schema.const}'` : String(schema.const);
+  }
+  if (schema.enum?.length) {
+    return schema.enum.map((v) => typeof v === "string" ? `'${v}'` : String(v)).join(" | ");
+  }
+  if (Array.isArray(schema.type)) {
+    const { nullable: _nullable, ...rest } = schema;
+    const members = [...new Set(schema.type)].map(
+      (member) => jsonSchemaTypeToTs({ ...rest, type: member })
+    );
+    const unique = [...new Set(members)];
+    if (schema.nullable && !unique.includes("null")) unique.push("null");
+    return unique.join(" | ");
+  }
+  let result;
+  switch (schema.type) {
+    case "string":
+      result = "string";
+      break;
+    case "number":
+    case "integer":
+      result = "number";
+      break;
+    case "boolean":
+      result = "boolean";
+      break;
+    case "null":
+      return "null";
+    case "array": {
+      if (schema.items) {
+        const itemType = jsonSchemaTypeToTs(schema.items);
+        const itemsDeclareObject = Array.isArray(schema.items.type) ? schema.items.type.includes("object") : schema.items.type === "object";
+        result = itemsDeclareObject && schema.items.properties ? `Array<${itemType}>` : itemType.includes("|") ? `(${itemType})[]` : `${itemType}[]`;
+      } else {
+        result = "unknown[]";
+      }
+      break;
+    }
+    case "object": {
+      if (schema.properties) {
+        const required = schema.required ?? [];
+        const fields = Object.entries(schema.properties).map(([key, prop]) => {
+          const opt = !required.includes(key);
+          return `${key}${opt ? "?" : ""}: ${jsonSchemaTypeToTs(prop)}`;
+        }).join("; ");
+        result = `{ ${fields} }`;
+      } else if (schema.additionalProperties && typeof schema.additionalProperties === "object") {
+        result = `Record<string, ${jsonSchemaTypeToTs(schema.additionalProperties)}>`;
+      } else {
+        result = "Record<string, unknown>";
+      }
+      break;
+    }
+    default:
+      result = "unknown";
+  }
+  if (schema.nullable && result !== "unknown") {
+    return `${result} | null`;
+  }
+  return result;
+}
+
+// src/boilerplate/react-hooks.ts
+var BOILERPLATE_REACT_HOOKS = ["useState", "useCallback", "useMemo", "useEffect", "useLayoutEffect", "useRef"];
+var BOILERPLATE_REACT_IMPORT = `import React, { ${BOILERPLATE_REACT_HOOKS.join(", ")} } from 'react';`;
+var REACT_IMPORT_ANY = /^[ \t]*import\b[^;]*?\bfrom\s*['"]react['"]/gm;
+var REACT_IMPORT_LINE = /^[ \t]*import[ \t]+React(?:[ \t]*,[ \t]*\{([^}\n]*)\})?[ \t]*from[ \t]*['"]react['"];?[ \t]*$/m;
+function restoreReactImport(source) {
+  const imports = source.match(REACT_IMPORT_ANY) ?? [];
+  if (imports.length === 0) {
+    const called = BOILERPLATE_REACT_HOOKS.some((h) => new RegExp(`\\b${h}\\s*[(<]`).test(source));
+    if (!called) return { source, added: [] };
+    return { source: `${BOILERPLATE_REACT_IMPORT}
+${source}`, added: [...BOILERPLATE_REACT_HOOKS] };
+  }
+  if (imports.length > 1) return { source, added: [] };
+  const line = REACT_IMPORT_LINE.exec(source);
+  if (line === null) return { source, added: [] };
+  const inner = line[1] ?? "";
+  if (/\btype\b|\/\*|\/\//.test(inner)) return { source, added: [] };
+  const specs = inner.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  const imported = new Set(specs.map((s) => s.split(/\s+as\s+/)[0]));
+  const added = BOILERPLATE_REACT_HOOKS.filter((h) => !imported.has(h));
+  if (added.length === 0) return { source, added: [] };
+  const hooks = BOILERPLATE_REACT_HOOKS;
+  const names = [...hooks, ...specs.filter((s) => !hooks.includes(s))];
+  const restored = `import React, { ${names.join(", ")} } from 'react';`;
+  return { source: source.replace(line[0], restored), added };
+}
+var NOT_YET_TAUGHT_TOKENS = /* @__PURE__ */ new Set([]);
+var taughtTokenManifest = consumedTokenManifest.filter(
+  (token) => !NOT_YET_TAUGHT_TOKENS.has(token)
+);
+
+export { BOILERPLATE_REACT_HOOKS, BOILERPLATE_REACT_IMPORT, jsonSchemaTypeToTs, restoreReactImport, taughtTokenManifest };
+//# sourceMappingURL=chunk-Z3CXME3K.js.map
+//# sourceMappingURL=chunk-Z3CXME3K.js.map

package/dist/chunk-Z3CXME3K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/boilerplate/json-schema-ts.ts","../src/boilerplate/react-hooks.ts","../src/taught-tokens.ts"],"names":[],"mappings":"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","file":"chunk-Z3CXME3K.js","sourcesContent":["// packages/ui-gen/src/boilerplate/json-schema-ts.ts\n//\n// JSON Schema → TypeScript type string converter.\n//\n// Pure, self-contained, no env reads, no framework deps. Exposed\n// publicly on `@ggui-ai/ui-gen/boilerplate` because it's the primitive\n// that turns a contract's JSON Schema into the `interface Props { ... }`\n// block the boilerplate generator writes.\n\nimport type { JsonSchema } from '@ggui-ai/protocol';\n\n/**\n * Convert a JsonSchema to a TypeScript type string — recursive.\n *\n * Handles: string, number, integer, boolean, null, array (+ tuples), object,\n * enum, oneOf/anyOf (unions), nullable, const, additionalProperties.\n */\nexport function jsonSchemaTypeToTs(schema: JsonSchema): string {\n  // ── Union types (oneOf / anyOf) ──\n  const unionMembers = schema.oneOf ?? schema.anyOf;\n  if (unionMembers?.length) {\n    const types = [...new Set(unionMembers.map(s => jsonSchemaTypeToTs(s)))];\n    return types.length === 1 ? types[0] : types.join(' | ');\n  }\n\n  // ── Const (literal type) ──\n  if (schema.const !== undefined) {\n    return typeof schema.const === 'string' ? `'${schema.const}'` : String(schema.const);\n  }\n\n  // ── Enum (union of literals) ──\n  if (schema.enum?.length) {\n    return schema.enum\n      .map(v => typeof v === 'string' ? `'${v}'` : String(v))\n      .join(' | ');\n  }\n\n  // ── Draft-07 type array (`['string','null']` — the canonical\n  // nullable form since draft-2026-08-19): members' TS union. Each\n  // member re-enters with the single type so object/array members\n  // keep their properties/items; `nullable` is folded in here (not in\n  // the recursion) so it can't double-append. ──\n  if (Array.isArray(schema.type)) {\n    const { nullable: _nullable, ...rest } = schema;\n    const members = [...new Set(schema.type)].map((member) =>\n      jsonSchemaTypeToTs({ ...rest, type: member }),\n    );\n    const unique = [...new Set(members)];\n    if (schema.nullable && !unique.includes('null')) unique.push('null');\n    return unique.join(' | ');\n  }\n\n  let result: string;\n\n  switch (schema.type) {\n    case 'string':\n      result = 'string';\n      break;\n    case 'number':\n    case 'integer':\n      result = 'number';\n      break;\n    case 'boolean':\n      result = 'boolean';\n      break;\n    case 'null':\n      return 'null';\n\n    case 'array': {\n      if (schema.items) {\n        const itemType = jsonSchemaTypeToTs(schema.items);\n        // Use Array<T> for complex object types, T[] for simple.\n        // `items.type` may be a type SET — treat any set containing\n        // 'object' like the single-string form.\n        const itemsDeclareObject = Array.isArray(schema.items.type)\n          ? schema.items.type.includes('object')\n          : schema.items.type === 'object';\n        result = (itemsDeclareObject && schema.items.properties)\n          ? `Array<${itemType}>`\n          : (itemType.includes('|') ? `(${itemType})[]` : `${itemType}[]`);\n      } else {\n        result = 'unknown[]';\n      }\n      break;\n    }\n\n    case 'object': {\n      if (schema.properties) {\n        const required = schema.required ?? [];\n        const fields = Object.entries(schema.properties)\n          .map(([key, prop]) => {\n            const opt = !required.includes(key);\n            return `${key}${opt ? '?' : ''}: ${jsonSchemaTypeToTs(prop)}`;\n          })\n          .join('; ');\n        result = `{ ${fields} }`;\n      } else if (schema.additionalProperties && typeof schema.additionalProperties === 'object') {\n        result = `Record<string, ${jsonSchemaTypeToTs(schema.additionalProperties)}>`;\n      } else {\n        result = 'Record<string, unknown>';\n      }\n      break;\n    }\n\n    default:\n      result = 'unknown';\n  }\n\n  // Apply nullable (OpenAPI 3.0 shorthand)\n  if (schema.nullable && result !== 'unknown') {\n    return `${result} | null`;\n  }\n\n  return result;\n}\n","/**\n * The React hooks the boilerplate's DO NOT EDIT React import always lists, so generated code may use\n * any of them without editing that line. One list: the boilerplate emits its import from it, and\n * tier-0's fix text names the import when one of these names goes missing.\n */\nexport const BOILERPLATE_REACT_HOOKS = ['useState', 'useCallback', 'useMemo', 'useEffect', 'useLayoutEffect', 'useRef'] as const;\n\n/** The React import line the boilerplate writes, verbatim. */\nexport const BOILERPLATE_REACT_IMPORT = `import React, { ${BOILERPLATE_REACT_HOOKS.join(', ')} } from 'react';`;\n\n/** What {@link restoreReactImport} did: the source to build, and the boilerplate hooks it put back (empty: untouched). */\nexport interface ReactImportRestore {\n  readonly source: string;\n  readonly added: readonly string[];\n}\n\nconst REACT_IMPORT_ANY = /^[ \\t]*import\\b[^;]*?\\bfrom\\s*['\"]react['\"]/gm;\nconst REACT_IMPORT_LINE = /^[ \\t]*import[ \\t]+React(?:[ \\t]*,[ \\t]*\\{([^}\\n]*)\\})?[ \\t]*from[ \\t]*['\"]react['\"];?[ \\t]*$/m;\n\n/**\n * ggui#1932 — keep the boilerplate's DO NOT EDIT React import, in code, before tier-0 reads the source.\n *\n * - The line exists (`import React …from 'react'`) but lacks a boilerplate hook: it becomes the boilerplate\n *   hooks in order, then every other name the model listed, in its order. The result is a superset of the\n *   model's line, so nothing it uses is dropped; with no extra names it is byte-for-byte\n *   {@link BOILERPLATE_REACT_IMPORT}.\n * - No import from 'react' at all, and the source calls a boilerplate hook: the boilerplate line is inserted\n *   at the top, where the boilerplate has it. A source that calls none is left alone: inserting would shift\n *   every line for nothing, and the model patches by line number.\n * - Any other 'react' import form (named-only, namespace, more than one, spanning lines, or carrying `type`\n *   specifiers or comments): untouched. Rewriting it could declare a name twice or drop what the model meant;\n *   tier-0 and its fix text handle it.\n * Every boilerplate hook already imported (plain or aliased): untouched.\n */\nexport function restoreReactImport(source: string): ReactImportRestore {\n  const imports = source.match(REACT_IMPORT_ANY) ?? [];\n  if (imports.length === 0) {\n    const called = BOILERPLATE_REACT_HOOKS.some((h) => new RegExp(`\\\\b${h}\\\\s*[(<]`).test(source));\n    if (!called) return { source, added: [] };\n    return { source: `${BOILERPLATE_REACT_IMPORT}\\n${source}`, added: [...BOILERPLATE_REACT_HOOKS] };\n  }\n  if (imports.length > 1) return { source, added: [] };\n  const line = REACT_IMPORT_LINE.exec(source);\n  if (line === null) return { source, added: [] };\n  const inner = line[1] ?? '';\n  if (/\\btype\\b|\\/\\*|\\/\\//.test(inner)) return { source, added: [] };\n  const specs = inner.split(',').map((s) => s.trim()).filter((s) => s.length > 0);\n  // The IMPORTED name (left of `as`): `useMemo as memo` is `useMemo` present.\n  const imported = new Set(specs.map((s) => s.split(/\\s+as\\s+/)[0]));\n  const added = BOILERPLATE_REACT_HOOKS.filter((h) => !imported.has(h));\n  if (added.length === 0) return { source, added: [] };\n  const hooks: readonly string[] = BOILERPLATE_REACT_HOOKS;\n  const names = [...hooks, ...specs.filter((s) => !hooks.includes(s))];\n  const restored = `import React, { ${names.join(', ')} } from 'react';`;\n  return { source: source.replace(line[0], restored), added };\n}\n","// The consumed-token names the generator may TEACH — the manifest minus the names a card may not\n// reference yet.\n//\n// A card is minted by one release and rendered by whichever runtime serves it: during a rolling\n// deploy, or after a rollback, that runtime can be the previous release, which neither declares\n// nor completes a key derived for the first time in this one. A bare `var(--new-key)` then\n// resolves to nothing — a `border` shorthand drops whole — and the no-fallback rule leaves the\n// card nothing to fall back on. So a new derived key ships in two steps: the renderers that\n// declare and complete it serve first (the design package's own primitives read it behind a\n// fallback), and the release AFTER takes it out of this set, in the same change as the prompt\n// guidance that teaches it.\n\nimport { consumedTokenManifest } from \"@ggui-ai/design/themes\";\n\n/**\n * Manifest names held back from every surface that teaches the model a name — the free prompt's\n * colour vocabulary and token reference, and the self-check's nearest-name suggestions. The\n * closed-set check still admits them: a card that references one is valid wherever this release\n * renders it.\n *\n * Empty today. The control edges (`controlOutline`, `controlAccentOutline`, ggui#1494) were held here\n * until every serving and rollback runtime declared them; the derivation (`10a0c00f2`) is in every\n * release from tag 17 on, so they are taught from ggui#1697, in the same change as the prompt rule that\n * teaches a control's edge.\n */\nexport const NOT_YET_TAUGHT_TOKENS: ReadonlySet<string> = new Set<string>([]);\n\n/** The manifest as the model is taught it. */\nexport const taughtTokenManifest: readonly string[] = consumedTokenManifest.filter(\n  (token) => !NOT_YET_TAUGHT_TOKENS.has(token),\n);\n"]}

package/dist/classifier/index.js

@@ -1,529 +1,4 @@
-// src/classifier/inspect.ts
-function resolveSchema(node) {
-  if (!node || typeof node !== "object") return void 0;
-  const n = node;
-  return n.schema ?? n;
-}
-function propType(p) {
-  const s = resolveSchema(p);
-  return s?.type;
-}
-function itemShape(p) {
-  const s = resolveSchema(p);
-  return s?.items;
-}
-function propertiesOf(p) {
-  const s = resolveSchema(p);
-  return s?.properties;
-}
-var ID_FIELD_CANDIDATES = ["id", "uuid", "symbol", "key", "slug", "code"];
-function inferIdField(itemProps) {
-  if (!itemProps) return "id";
-  for (const cand of ID_FIELD_CANDIDATES) {
-    if (cand in itemProps) return cand;
-  }
-  return "id";
-}
-function singularize(name) {
-  if (name.endsWith("ies")) return name.slice(0, -3) + "y";
-  if (name.endsWith("ses")) return name.slice(0, -2);
-  if (name.endsWith("s") && !name.endsWith("ss")) return name.slice(0, -1);
-  return name;
-}
-function walkForArrObj(node, depth = 0) {
-  if (depth > 8 || !node || typeof node !== "object") return false;
-  const s = resolveSchema(node);
-  if (!s) return false;
-  const t = s.type;
-  const items = s.items;
-  if (t === "array" && items?.type === "object") return true;
-  const props = s.properties;
-  if (props) {
-    for (const v of Object.values(props)) {
-      if (walkForArrObj(v, depth + 1)) return true;
-    }
-  }
-  if (items && typeof items === "object") {
-    const itemProps = items.properties;
-    if (itemProps) {
-      for (const v of Object.values(itemProps)) {
-        if (walkForArrObj(v, depth + 1)) return true;
-      }
-    }
-  }
-  return false;
-}
-function hasGeoCoordsRecursive(node, depth = 0) {
-  if (depth > 8 || !node || typeof node !== "object") return false;
-  const s = resolveSchema(node);
-  if (!s) return false;
-  const props = s.properties;
-  if (props) {
-    const keys = Object.keys(props);
-    const lowered = keys.map((k) => k.toLowerCase());
-    const hasLat = lowered.includes("lat") || lowered.includes("latitude");
-    const hasLng = lowered.includes("lng") || lowered.includes("lon") || lowered.includes("longitude");
-    if (hasLat && hasLng) return true;
-    for (const v of Object.values(props)) {
-      if (hasGeoCoordsRecursive(v, depth + 1)) return true;
-    }
-  }
-  if (s.items) {
-    if (hasGeoCoordsRecursive(s.items, depth + 1)) return true;
-  }
-  return false;
-}
-function scalarKeyCount(obj) {
-  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return [];
-  const keys = [];
-  for (const [k, v] of Object.entries(obj)) {
-    const t = typeof v;
-    if (t === "string" || t === "number" || t === "boolean") keys.push(k);
-  }
-  return keys;
-}
-function allTopLevelKeys(obj) {
-  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return [];
-  return Object.keys(obj);
-}
-function referencedEntitiesForPayload(keys, entityLists, singletons) {
-  const hits = /* @__PURE__ */ new Set();
-  for (const key of keys) {
-    if (/Id$/.test(key) && key.length > 2) {
-      const stem = key.slice(0, -2).toLowerCase();
-      for (const e of entityLists) {
-        if (e.singular.toLowerCase() === stem) hits.add(e.name);
-      }
-      for (const s of singletons) {
-        if (s.name.toLowerCase() === stem) hits.add(`__singleton:${s.name}`);
-      }
-    }
-  }
-  return [...hits];
-}
-function isFullEntity(eventKeys, entity) {
-  return entity.itemKeys.every((k) => eventKeys.includes(k));
-}
-function inferStreamKindFromSchema(eventSchema, entityLists, singletons) {
-  const eventProps = eventSchema?.properties ?? {};
-  const eventKeys = Object.keys(eventProps);
-  const hasBool = Object.values(eventProps).some(
-    (v) => propType(v) === "boolean"
-  );
-  const hasUserKey = eventKeys.some(
-    (k) => /sender|user|author|actor|from/i.test(k)
-  );
-  if (hasBool && hasUserKey && eventKeys.length <= 3) return "presence";
-  for (const v of Object.values(eventProps)) {
-    const s = resolveSchema(v);
-    if (s?.type === "object" && s.properties && "id" in s.properties) {
-      return "merge";
-    }
-  }
-  for (const entity of entityLists) {
-    if (isFullEntity(eventKeys, entity)) return "append";
-  }
-  for (const entity of entityLists) {
-    const directMatch = eventKeys.includes(entity.idField);
-    const suffixMatch = eventKeys.some((k) => {
-      if (!/Id$/.test(k) || k.length <= 2) return false;
-      return k.slice(0, -2).toLowerCase() === entity.singular.toLowerCase();
-    });
-    if (directMatch || suffixMatch) return "merge";
-  }
-  for (const singleton of singletons) {
-    const suffixMatch = eventKeys.some((k) => {
-      if (!/Id$/.test(k) || k.length <= 2) return false;
-      return k.slice(0, -2).toLowerCase() === singleton.name.toLowerCase();
-    });
-    if (suffixMatch) return "merge";
-    const overlapCount = eventKeys.filter((k) => singleton.keys.includes(k)).length;
-    if (overlapCount >= 2) return "merge";
-  }
-  for (const v of Object.values(eventProps)) {
-    const s = resolveSchema(v);
-    if (Array.isArray(s?.enum) && s.enum.length > 0) return "status";
-  }
-  return "other";
-}
-function inspect(contract) {
-  const empty = {
-    actions: [],
-    streams: [],
-    agentTools: [],
-    clientCapabilities: [],
-    entityLists: [],
-    singletons: [],
-    hasArrObjAnywhere: false,
-    hasGeoCoords: false,
-    entityListIdInPayload: false,
-    singletonIdInPayload: false,
-    crossEntityAction: false,
-    multiFieldSubmit: false,
-    topLevelScalarCount: 0,
-    entitiesHaveGridPositions: false
-  };
-  if (!contract) return empty;
-  const propsField = contract.propsSpec;
-  const propsProps = propsField?.properties ?? {};
-  const entityLists = [];
-  for (const [name, p] of Object.entries(propsProps)) {
-    const t = propType(p);
-    const items = itemShape(p);
-    if (t === "array" && items?.type === "object") {
-      const itemProps = items.properties ?? {};
-      entityLists.push({
-        name,
-        singular: singularize(name),
-        idField: inferIdField(itemProps),
-        itemKeys: Object.keys(itemProps)
-      });
-    }
-  }
-  const singletons = [];
-  for (const [name, p] of Object.entries(propsProps)) {
-    const t = propType(p);
-    if (t === "object") {
-      const childProps = propertiesOf(p) ?? {};
-      const keys = Object.keys(childProps);
-      if (keys.length > 0) {
-        singletons.push({ name, keys });
-      }
-    }
-  }
-  const actionsMap = contract.actionSpec ?? {};
-  const actions = [];
-  for (const [name, action] of Object.entries(actionsMap)) {
-    const a = action;
-    const scalarKeys = scalarKeyCount(a?.example);
-    const allKeys = allTopLevelKeys(a?.example);
-    const referencedEntities = referencedEntitiesForPayload(
-      allKeys,
-      entityLists,
-      singletons
-    );
-    actions.push({
-      name,
-      nextStep: a?.nextStep,
-      example: a?.example,
-      scalarKeys,
-      allKeys,
-      referencedEntities
-    });
-  }
-  const channelsMap = contract.streamSpec ?? {};
-  const streams = [];
-  for (const [name, channel] of Object.entries(channelsMap)) {
-    streams.push({ name, schema: channel.schema });
-  }
-  const agentToolsMap = contract.agentCapabilities?.tools ?? {};
-  const agentTools = [];
-  for (const [name, tool] of Object.entries(agentToolsMap)) {
-    const t = tool;
-    const req = t?.toolInfo?.inputSchema?.properties ?? {};
-    agentTools.push({ name, requestKeys: Object.keys(req) });
-  }
-  const gadgetsMap = contract.clientCapabilities?.gadgets ?? {};
-  const clientCapabilities = [];
-  for (const name of Object.keys(gadgetsMap)) {
-    clientCapabilities.push({ name, requestKeys: [] });
-  }
-  const hasArrObjAnywhere = walkForArrObj({ properties: propsProps });
-  const hasGeoCoords = hasGeoCoordsRecursive({ properties: propsProps });
-  const entityListNames = new Set(entityLists.map((e) => e.name));
-  const entityListIdInPayload = actions.some(
-    (a) => a.referencedEntities.some((r) => entityListNames.has(r))
-  );
-  const singletonIdInPayload = actions.some(
-    (a) => a.referencedEntities.some((r) => r.startsWith("__singleton:"))
-  );
-  const crossEntityAction = actions.some((a) => {
-    const entityRefs = a.referencedEntities.filter(
-      (r) => entityListNames.has(r)
-    );
-    return new Set(entityRefs).size >= 2;
-  });
-  const multiFieldSubmit = actions.some((a) => a.scalarKeys.length >= 3);
-  let topLevelScalarCount = 0;
-  for (const v of Object.values(propsProps)) {
-    const t = propType(v);
-    if (t === "string" || t === "number" || t === "boolean") topLevelScalarCount++;
-  }
-  const entitiesHaveGridPositions = entityLists.some((e) => {
-    const keys = e.itemKeys;
-    return keys.includes("row") && keys.includes("col") || keys.includes("x") && keys.includes("y") && keys.length > 2 || keys.includes("gridRow") && keys.includes("gridColumn");
-  });
-  return {
-    actions,
-    streams,
-    agentTools,
-    clientCapabilities,
-    entityLists,
-    singletons,
-    hasArrObjAnywhere,
-    hasGeoCoords,
-    entityListIdInPayload,
-    singletonIdInPayload,
-    crossEntityAction,
-    multiFieldSubmit,
-    topLevelScalarCount,
-    entitiesHaveGridPositions
-  };
-}
-
-// src/classifier/infer-state.ts
-var AFFORDANCE_KEYWORDS = /\b(search\b|filter\b|sort\b|select\b|tabs?\b|quantity\b|paginat|expand(ed|able)?|collaps|click(?:s|ing|ed)?\s+(an|a|the)\s+\w+\s*→?\s*detail|click\s+to\s+(select|open|view))/i;
-function inferState(s, prompt) {
-  if (s.actions.length === 1 && s.multiFieldSubmit && !s.entityListIdInPayload && !s.singletonIdInPayload) {
-    return { value: "payload", source: "contract" };
-  }
-  if (s.streams.length > 0) {
-    return { value: "merge", source: "contract" };
-  }
-  if (s.entityLists.length > 0 && s.entityListIdInPayload) {
-    return { value: "merge", source: "contract" };
-  }
-  if (AFFORDANCE_KEYWORDS.test(prompt)) {
-    return { value: "ui-affordance", source: "prompt" };
-  }
-  if (s.actions.length >= 1) {
-    return { value: "ui-affordance", source: "heuristic" };
-  }
-  return { value: "none", source: "contract" };
-}
-
-// src/classifier/infer-writes.ts
-function inferWrites(s) {
-  if (s.actions.length === 0) {
-    return { value: "none", source: "contract" };
-  }
-  if (s.crossEntityAction) {
-    return { value: "compose", source: "contract" };
-  }
-  if (s.entityListIdInPayload) {
-    return { value: "per-item", source: "contract" };
-  }
-  if (s.actions.length === 1 && s.multiFieldSubmit) {
-    return { value: "submit", source: "contract" };
-  }
-  if (s.actions.length >= 2) {
-    return { value: "multi-commit", source: "contract" };
-  }
-  return { value: "commit", source: "contract" };
-}
-
-// src/classifier/infer-realtime.ts
-function inferRealtime(s) {
-  if (s.streams.length === 0) {
-    return { value: "none", source: "contract" };
-  }
-  const kinds = {};
-  for (const stream of s.streams) {
-    kinds[stream.name] = inferStreamKindFromSchema(
-      stream.schema,
-      s.entityLists,
-      s.singletons
-    );
-  }
-  const distinct = new Set(Object.values(kinds));
-  if (distinct.size === 1) {
-    const only = [...distinct][0];
-    if (only === "other") {
-      return { value: "mixed", streamKinds: kinds, source: "contract" };
-    }
-    return { value: only, source: "contract" };
-  }
-  return { value: "mixed", streamKinds: kinds, source: "contract" };
-}
-
-// src/classifier/infer-fetch.ts
-var PAGINATION_KEYS = /* @__PURE__ */ new Set([
-  "cursor",
-  "offset",
-  "page",
-  "before",
-  "after",
-  "limit",
-  "pageSize"
-]);
-var SEARCH_KEYS = /* @__PURE__ */ new Set(["query", "q", "search", "keyword"]);
-function inferFetch(s) {
-  if (s.agentTools.length === 0) {
-    return { value: "none", source: "contract" };
-  }
-  const tools = s.agentTools;
-  for (const tool of tools) {
-    for (const key of tool.requestKeys) {
-      if (PAGINATION_KEYS.has(key)) return { value: "pagination", source: "contract" };
-    }
-  }
-  for (const tool of tools) {
-    for (const key of tool.requestKeys) {
-      if (SEARCH_KEYS.has(key)) return { value: "search", source: "contract" };
-    }
-  }
-  const entityIdFields = new Set(s.entityLists.map((e) => e.idField));
-  for (const tool of tools) {
-    for (const key of tool.requestKeys) {
-      if (key === "id") return { value: "drill-down", source: "contract" };
-      if (/Id$/.test(key) && key.length > 2) {
-        return { value: "drill-down", source: "contract" };
-      }
-      if (entityIdFields.has(key)) {
-        return { value: "drill-down", source: "contract" };
-      }
-    }
-  }
-  return { value: "refresh", source: "contract" };
-}
-
-// src/classifier/infer-render.ts
-var CHART_RX = /\b(chart|graph|trend|bar\s*graph|line\s*graph|pie)\b/i;
-var TIMELINE_RX = /\b(timeline|chronolog|activity\s*feed|event\s*feed)\b/i;
-var GRID_RX = /\bgrid\b|\btile\s*layout\b|\b\d+\s*columns\b|\bkanban\b|\bcolumns?\s*:/i;
-var MAP_RX = /\b(on\s*a\s*map|on\s*the\s*map|geo|gps|lat\/lng)\b/i;
-var MASTER_DETAIL_RX = /\b(left\s*pane|right\s*pane|sidebar|master[- ]detail|split\s*view|two[- ]pane)\b/i;
-var STATIC_RX = /\b(card\s*stack|card\s*deck|one\s*(card|email|message|item)\s*at\s*a\s*time|full[- ]screen\s*card)\b/i;
-function inferRender(s, prompt, blueprint) {
-  if (blueprint?.layoutHint) {
-    const hint = blueprint.layoutHint.toLowerCase();
-    if (hint.includes("master-detail") || hint.includes("split"))
-      return { value: "master-detail", source: "blueprint" };
-    if (hint.includes("card-stack") || hint.includes("deck") || hint.includes("modal"))
-      return { value: "static", source: "blueprint" };
-    if (hint.includes("spatial") || hint.includes("map"))
-      return { value: "spatial", source: "blueprint" };
-    if (hint.includes("timeline")) return { value: "timeline", source: "blueprint" };
-    if (hint.includes("chart")) return { value: "chart", source: "blueprint" };
-    if (hint.includes("grid")) return { value: "grid", source: "blueprint" };
-  }
-  if (s.hasGeoCoords) {
-    return { value: "spatial", source: "contract" };
-  }
-  if (s.entitiesHaveGridPositions) {
-    return { value: "grid", source: "contract" };
-  }
-  if (CHART_RX.test(prompt)) return { value: "chart", source: "prompt" };
-  if (TIMELINE_RX.test(prompt)) return { value: "timeline", source: "prompt" };
-  if (MASTER_DETAIL_RX.test(prompt))
-    return { value: "master-detail", source: "prompt" };
-  if (GRID_RX.test(prompt)) return { value: "grid", source: "prompt" };
-  if (MAP_RX.test(prompt) && !s.hasGeoCoords)
-    return { value: "spatial", source: "prompt" };
-  if (STATIC_RX.test(prompt)) return { value: "static", source: "prompt" };
-  if (s.entityLists.length === 0) {
-    return { value: "static", source: "contract" };
-  }
-  if (s.entityLists.length === 1 && s.topLevelScalarCount >= 4) {
-    return { value: "static", source: "contract" };
-  }
-  if (s.entityLists.length >= 2) {
-    return { value: "master-detail", source: "contract" };
-  }
-  return { value: "list", source: "contract" };
-}
-
-// src/classifier/infer-layout.ts
-var OVERLAY_RX = /\b(overlay|overlaid|on\s*top|positioned\s*over|floating\s*action)\b/i;
-var MODAL_RX = /\b(modal|dialog|sheet|drawer|card\s*stack)\b/i;
-var MULTI_STEP_RX = /\b(multi[- ]step|wizard|step\s*\d+|step\s*\d+\s*:)/i;
-var MASTER_DETAIL_RX2 = /\b(left\s*pane|right\s*pane|left\s*sidebar|right\s*main|split\s*view|two[- ]pane|master[- ]detail)\b/i;
-function inferLayout(s, prompt, blueprint) {
-  if (blueprint?.layoutHint) {
-    const hint = blueprint.layoutHint.toLowerCase();
-    if (hint.includes("master-detail") || hint.includes("split"))
-      return { value: "master-detail", source: "blueprint" };
-    if (hint.includes("modal") || hint.includes("card-stack") || hint.includes("deck"))
-      return { value: "modal", source: "blueprint" };
-    if (hint.includes("overlay")) return { value: "overlay", source: "blueprint" };
-    if (hint.includes("multi-step") || hint.includes("wizard"))
-      return { value: "multi-step", source: "blueprint" };
-  }
-  if (MULTI_STEP_RX.test(prompt)) return { value: "multi-step", source: "prompt" };
-  if (OVERLAY_RX.test(prompt)) return { value: "overlay", source: "prompt" };
-  if (MODAL_RX.test(prompt)) return { value: "modal", source: "prompt" };
-  if (MASTER_DETAIL_RX2.test(prompt))
-    return { value: "master-detail", source: "prompt" };
-  return { value: "single", source: "default" };
-}
-
-// src/classifier/infer-trigger.ts
-var DRAG_RX = /\b(drag|drop|dragging|draggable)\b/i;
-var SWIPE_RX = /\b(swipe|swipes|gesture\s*stack)\b/i;
-var KEYBOARD_RX = /\b(keyboard\s*shortcut|hotkey|keystroke|kbd)\b/i;
-function inferWriteTrigger(s, prompt) {
-  if (s.actions.length === 0) {
-    return { value: "click", source: "default" };
-  }
-  if (DRAG_RX.test(prompt)) return { value: "drag", source: "prompt" };
-  if (SWIPE_RX.test(prompt)) return { value: "swipe", source: "prompt" };
-  if (KEYBOARD_RX.test(prompt)) return { value: "keystroke", source: "prompt" };
-  return { value: "click", source: "default" };
-}
-
-// src/classifier/infer-tooling.ts
-function inferTooling(s) {
-  const hasAgent = s.agentTools.length > 0;
-  const hasClient = s.clientCapabilities.length > 0;
-  if (hasAgent && hasClient) return { value: "both", source: "contract" };
-  if (hasAgent) return { value: "wired", source: "contract" };
-  if (hasClient) return { value: "client", source: "contract" };
-  return { value: "none", source: "default" };
-}
-
-// src/classifier/risk-tier.ts
-function deriveRiskTier(v) {
-  if (v.writes === "compose") return "high";
-  if (v.writeTrigger === "drag" || v.writeTrigger === "swipe") return "high";
-  if (v.realtime === "mixed") return "high";
-  if (v.render === "spatial" && v.realtime !== "none") return "high";
-  if (v.state === "merge" && v.writes === "per-item") return "high";
-  if ((v.state === "none" || v.state === "ui-affordance") && v.writes === "none" && v.realtime === "none" && v.fetch === "none") {
-    return "low";
-  }
-  return "medium";
-}
-
-// src/classifier/classifier.ts
-function classifyAxes(input) {
-  const s = inspect(input.contract);
-  const prompt = input.prompt ?? "";
-  const blueprint = input.blueprint;
-  const state = inferState(s, prompt);
-  const writes = inferWrites(s);
-  const realtime = inferRealtime(s);
-  const fetch = inferFetch(s);
-  const render = inferRender(s, prompt, blueprint);
-  const layout = inferLayout(s, prompt, blueprint);
-  const writeTrigger = inferWriteTrigger(s, prompt);
-  const tooling = inferTooling(s);
-  const vector = {
-    render: render.value,
-    state: state.value,
-    writes: writes.value,
-    writeTrigger: writeTrigger.value,
-    realtime: realtime.value,
-    fetch: fetch.value,
-    layout: layout.value,
-    tooling: tooling.value
-  };
-  if (realtime.streamKinds) {
-    vector.streamKinds = realtime.streamKinds;
-  }
-  const provenance = {
-    render: render.source,
-    state: state.source,
-    writes: writes.source,
-    writeTrigger: writeTrigger.source,
-    realtime: realtime.source,
-    fetch: fetch.source,
-    layout: layout.source,
-    tooling: tooling.source
-  };
-  const riskTier = deriveRiskTier(vector);
-  return { vector, provenance, riskTier };
-}
-
-export { classifyAxes, deriveRiskTier, inferFetch, inferLayout, inferRealtime, inferRender, inferState, inferStreamKindFromSchema, inferTooling, inferWriteTrigger, inferWrites, inspect };
+export { classifyAxes, deriveRiskTier, inferFetch, inferLayout, inferRealtime, inferRender, inferState, inferStreamKindFromSchema, inferTooling, inferWriteTrigger, inferWrites, inspect } from '../chunk-5KXCQLLR.js';
+import '../chunk-G3PMV62Z.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map