@exponential-at/ui 0.0.0-stage → 0.1.0

package/dist/entries/prompt.js

@@ -0,0 +1,251 @@
+import {
+  coreCatalog2,
+  CORE_CATALOG_ID2,
+  CORE_LITE_CATALOG_ID2,
+  catalogView2,
+  isOffered2
+} from "../chunks/index-gwkt14w3.js";
+import {
+  describeCatalog2
+} from "../chunks/index-xrm6f7wc.js";
+
+// packages/exponential-ui/src/prompt.ts
+var PROMPT_SECTIONS = [`rules`, `components`, `index`, `shapes`, `functions`, `style`, `extensions`];
+var DEFAULT_SECTIONS = [`rules`, `components`, `shapes`, `functions`, `style`, `extensions`];
+var PROMPT_RULES = [
+  `Reply with A2UI v0.9 messages: createSurface{surfaceId, catalogId}, then updateComponents{surfaceId, components:[…]} (one has id "root"; resend an id to change it) and updateDataModel{surfaceId, path, value} (writes the JSON pointer; no value removes it). Keep data in the model and bind to it.`,
+  `A component = {id, component, …props, children?: [ids] | {componentId, path, key?}, slots?: {name: id}, on?: {event: action}, style?, visible?}. Children are ids, never inline; {componentId, path} repeats per item, key = the item field naming it.`,
+  `Include every required prop. A ~ prop may be a binding {path: "/json/pointer"} or a call {call, args} (live). visible: false (or a binding) hides any component.`,
+  `An action (on: {event: action}) = {event: {name, context?}} (sent to you; context values may be bindings, read AFTER the component's own write) and/or {functionCall: {call, args}} (runs on the client: a function below, or a namespaced host function like app.toast).`,
+  `Lay out with Page, Stack, Grid, Card, SplitView, Sidebar and List (anything longer than a screen); a row of controls is a Toolbar, fields side by side a FieldGroup, the Cancel/submit row FormActions; Box + style only for the rest. Wrap fields in Form; a valid submit closes the Dialog or Drawer around it.`,
+  `Responsive: a ^ prop also takes {base, sm?, md?, lg?, xl?} (from that breakpoint up). Style conditions, one level, narrow first: "@media (min-width: $breakpoint.md)": {…} (also max-width, min-height, max-height in px or $breakpoint.sm|md|lg|xl; orientation: portrait|landscape; hover: hover|none; prefers-reduced-motion: reduce), then ":hover", ":focus-visible", ":pressed". display: "none" hides.`,
+  `Prefer catalog components over Markdown (feature lists = List + Row, not bullets), labels and tones over colours; a colour is a $color.* token, never #hex (light and dark both apply). Built-in copy (Cancel, Search…) is localized: leave it unset.`,
+  `One default Button per screen (the FormActions submit or the main action); the rest outline, secondary or ghost.`
+];
+var COMMON_PROPS = {
+  name: `form key`,
+  label: ``,
+  placeholder: ``,
+  disabled: ``,
+  checks: `validation; every failure shows`,
+  validateOn: ``,
+  style: `extra Box style`,
+  icon: ``,
+  size: ``,
+  tone: ``,
+  open: `bind it`,
+  side: ``,
+  emptyText: ``,
+  dismissible: ``,
+  busy: ``,
+  loading: ``,
+  lines: `truncate`,
+  width: `px`,
+  height: `px`,
+  value: `bind it for two-way state`,
+  title: ``,
+  subtitle: ``,
+  description: ``,
+  meta: ``,
+  count: ``,
+  min: ``,
+  max: ``,
+  step: ``,
+  src: ``,
+  alt: ``,
+  multiple: ``,
+  pressable: `fires press`,
+  durationMs: `known length`,
+  firstDayOfWeek: `0 = Sunday; else the locale's`,
+  direction: ``,
+  orientation: ``,
+  gap: ``,
+  aspectRatio: `width/height`,
+  text: ``
+};
+function typeOf(schema, enums) {
+  switch (schema.type) {
+    case `enum`:
+      return (schema.values ?? enums[schema.enum ?? ``] ?? []).join(`|`);
+    case `array`:
+      return schema.items ? `[${schema.items.type === `object` ? schema.items.shape ?? `object` : typeOf(schema.items, enums)}]` : `[]`;
+    case `object`:
+      return schema.shape ?? `object`;
+    default:
+      return schema.type;
+  }
+}
+function marksOf(schema) {
+  return `${schema.required ? `*` : ``}${schema.bindable ? `~` : ``}${schema.responsive ? `^` : ``}`;
+}
+function defaultOf(schema, enums) {
+  if (schema.default === undefined)
+    return ``;
+  if (schema.type === `boolean` && schema.default === false)
+    return ``;
+  if (schema.type === `enum` && (schema.values ?? enums[schema.enum ?? ``] ?? [])[0] === schema.default)
+    return ``;
+  return `=${JSON.stringify(schema.default)}`;
+}
+function propLine(name, schema, enums) {
+  const def = defaultOf(schema, enums);
+  const head = `${name}${marksOf(schema)}: ${typeOf(schema, enums)}${def}`;
+  return name in COMMON_PROPS ? head : `${head} — ${schema.description}`;
+}
+function componentBlock(name, def, enums, terse) {
+  const head = `${name}${def.kind === `macro` ? `` : ``}: ${def.description}`;
+  const meta = [];
+  if (def.children !== `none`)
+    meta.push(def.children === `one` ? `one child` : `children`);
+  if (def.slots?.length)
+    meta.push(`slots: ${def.slots.join(`, `)}`);
+  if (def.events?.length)
+    meta.push(`on: ${def.events.join(`, `)}`);
+  const props = Object.entries(def.props);
+  const body = terse ? [`  props: ${props.map(([p, s]) => `${p}${marksOf(s)}:${typeOf(s, enums)}`).join(`, `)}`] : props.map(([p, s]) => `  ${propLine(p, s, enums)}`);
+  return [head, ...meta.length ? [`  ${meta.join(`; `)}`] : [], ...body].join(`
+`);
+}
+function usedShapes(components, defs) {
+  const used = new Set;
+  const visit = (schema) => {
+    if (!schema)
+      return;
+    if (schema.type === `array`)
+      return visit(schema.items);
+    if (schema.type === `object` && schema.shape && !used.has(schema.shape) && defs[schema.shape]) {
+      used.add(schema.shape);
+      for (const p of Object.values(defs[schema.shape].properties))
+        visit(p);
+    }
+  };
+  for (const def of components)
+    for (const p of Object.values(def.props))
+      visit(p);
+  return used;
+}
+function defsBlock(defs, enums, only) {
+  return Object.entries(defs).filter(([name]) => !only || only.has(name)).map(([name, def]) => `${name} = {${Object.entries(def.properties).map(([p, s]) => `${p}${s.required ? `*` : ``}: ${typeOf(s, enums)}`).join(`, `)}}`);
+}
+var SHORT_TYPES = { string: `str`, number: `num`, boolean: `bool`, object: `obj` };
+function functionSignatures() {
+  const { names, core, basic } = coreCatalog2.functions;
+  return names.map((name) => {
+    const sig = core[name] ?? basic[name];
+    if (!sig)
+      return name;
+    return `${name}(${Object.entries(sig.args).map(([a, t]) => `${a}:${SHORT_TYPES[t] ?? t}`).join(`,`)})→${SHORT_TYPES[sig.returns] ?? sig.returns}`;
+  });
+}
+function componentPrompt(name, options = {}) {
+  const extensions = options.extensions ?? [];
+  const view = catalogView2(extensions);
+  const def = view.components[name];
+  if (!def || def.hidden)
+    return ``;
+  const defs = { ...coreCatalog2.defs, ...Object.fromEntries(extensions.flatMap((e) => Object.entries(e.defs ?? {}))) };
+  const lines = [componentBlock(name, def, view.enums, options.terse ?? false)];
+  const shapes = defsBlock(defs, view.enums, usedShapes([def], defs));
+  if (shapes.length)
+    lines.push(`Shapes: ${shapes.join(`; `)}`);
+  return lines.join(`
+`);
+}
+function catalogIndex(options = {}) {
+  const groups = new Map;
+  const add = (name, def) => {
+    const list = groups.get(def.group) ?? [];
+    list.push(`${name}${def.children === `none` ? `` : def.children === `one` ? ` (one child)` : ` (children)`}: ${def.description}`);
+    groups.set(def.group, list);
+  };
+  for (const [name, def] of Object.entries(coreCatalog2.components)) {
+    if (!isOffered2(def))
+      continue;
+    if (options.lite && !def.lite)
+      continue;
+    add(name, def);
+  }
+  for (const ext of options.extensions ?? [])
+    for (const [name, def] of Object.entries(ext.components))
+      add(name, def);
+  return [...groups.entries()].map(([group, items]) => `${group}: ${items.join(` · `)}`);
+}
+function catalogPrompt(options = {}) {
+  const extensions = options.extensions ?? [];
+  const view = catalogView2(extensions);
+  const wanted = new Set(options.sections ?? DEFAULT_SECTIONS);
+  const has = (s) => wanted.has(s);
+  const only = options.only ? new Set(options.only) : undefined;
+  const lines = [];
+  const id = options.lite ? CORE_LITE_CATALOG_ID2 : CORE_CATALOG_ID2;
+  lines.push(`Catalog ${id}${extensions.length ? ` with extensions ${extensions.map((e) => e.id).join(`, `)}` : ``}.`);
+  if (has(`rules`)) {
+    lines.push(`Rules:`);
+    for (const rule of PROMPT_RULES)
+      lines.push(`- ${rule}`);
+  }
+  const offered = Object.entries(coreCatalog2.components).filter(([, def]) => isOffered2(def) && (!options.lite || def.lite));
+  const listed = offered.filter(([name]) => !only || only.has(name));
+  if (has(`components`)) {
+    lines.push(`Components (props marked * are required, ~ accept a binding, ^ are responsive; =x is the default, else an enum defaults to its first value and a boolean to false${only ? `; ask for any other component by name` : ``}):`);
+    if (!options.terse)
+      lines.push(`Common props (no description below): ${Object.entries(COMMON_PROPS).map(([k, v]) => v ? `${k} (${v})` : k).join(`, `)}.`);
+    for (const [name, def] of listed)
+      lines.push(componentBlock(name, def, view.enums, options.terse ?? false));
+  }
+  if (has(`index`)) {
+    lines.push(`Index (every component; ask for one by name to get its props):`);
+    for (const line of catalogIndex({ extensions, lite: options.lite }))
+      lines.push(`- ${line}`);
+  }
+  if (has(`shapes`) && has(`components`))
+    lines.push(`Shapes: ${defsBlock(coreCatalog2.defs, view.enums, usedShapes(listed.map(([, def]) => def), coreCatalog2.defs)).join(`; `)}`);
+  if (has(`functions`))
+    lines.push(`Functions ({call, args}; name(arg:type)→result): ${functionSignatures().join(`, `)}. filter: where = {field: value} (an empty value matches all), query = a case-insensitive substring of fields; bind a List or Table to it.`);
+  if (has(`style`))
+    lines.push(`Style keys (Box): display, flex*, justifyContent, align*, gap, width, height, min/max sizes, aspectRatio, position (relative|absolute|sticky), top/right/bottom/left, inset*, padding*/margin* (+Horizontal/Vertical/InlineStart/End), grid*, overflow(X/Y), direction, backgroundColor, backgroundGradient {angle, stops}, backdropBlur $blur.*, color, border*, opacity, boxShadow, font*, letterSpacing, text*, transition $motion.*, transform (translate/scale/rotate, paint only), animation (pulse|spin|fade-in|slide-in-up/down/left/right|shimmer), visibility, pointerEvents, userSelect, cursor. Values: px, "N%", "auto", or tokens $spacing.md, $color.primary, $radius.lg, $control.row.`);
+  if (has(`extensions`) && has(`components`)) {
+    for (const ext of extensions) {
+      lines.push(`Extension ${ext.id} (${ext.name}):`);
+      for (const [name, def] of Object.entries(ext.components))
+        lines.push(componentBlock(name, def, view.enums, options.terse ?? false));
+      if (ext.defs && Object.keys(ext.defs).length)
+        lines.push(`Shapes: ${defsBlock(ext.defs, view.enums).join(`; `)}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+var CHARS_PER_TOKEN = 4;
+function estimateTokens(text) {
+  return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+
+// packages/exponential-ui/src/entries/prompt.ts
+function catalogPrompt2(options = {}) {
+  describeCatalog2();
+  return catalogPrompt(options);
+}
+function componentPrompt2(name, options = {}) {
+  describeCatalog2();
+  return componentPrompt(name, options);
+}
+function catalogIndex2(options = {}) {
+  describeCatalog2();
+  return catalogIndex(options);
+}
+export {
+  CHARS_PER_TOKEN,
+  COMMON_PROPS,
+  DEFAULT_SECTIONS,
+  PROMPT_RULES,
+  PROMPT_SECTIONS,
+  catalogIndex2 as catalogIndex,
+  catalogPrompt2 as catalogPrompt,
+  componentPrompt2 as componentPrompt,
+  describeCatalog2 as describeCatalog,
+  estimateTokens
+};
+
+//# debugId=077C2E498EB260FA64756E2164756E21
+//# sourceMappingURL=prompt.js.map

package/dist/entries/prompt.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/prompt.ts", "../src/entries/prompt.ts"],
+  "sourcesContent": [
+    "// VAPP-85: the model-facing catalog prompt. One compact block: the catalog\n// id, the authoring rules, one line per component (description, then props\n// with type and one-sentence meaning), the functions, then any registered\n// extensions in the same shape. fixtures/prompt-budget.json records the size\n// of the full core prompt; prompt.test.ts fails when it grows past the\n// budget — cut descriptions before cutting components.\n// VAPP-108: the prompt is SECTIONED (`sections`): a host serves the rules +\n// the index first and `componentPrompt(name)` on demand, or `only` the\n// components a task needs; eval/ measures what each variant costs.\n\nimport { CORE_CATALOG_ID, CORE_LITE_CATALOG_ID, catalogView, coreCatalog, isOffered } from \"./catalog\"\nimport type { ComponentDef, ExtensionDef, PropSchema } from \"./types\"\n\n/** The sections of the prompt, in print order (VAPP-108): an agent (or the\n *  host serving it) asks for the ones it needs. `index` = one line per\n *  component (name, group, description) instead of the full `components`\n *  blocks: the agent reads the index, then asks for `componentPrompt(name)`\n *  of the ones it will use. */\nexport type PromptSection = `rules` | `components` | `index` | `shapes` | `functions` | `style` | `extensions`\nexport const PROMPT_SECTIONS: readonly PromptSection[] = [`rules`, `components`, `index`, `shapes`, `functions`, `style`, `extensions`]\n/** What `catalogPrompt()` prints without `sections`. */\nexport const DEFAULT_SECTIONS: readonly PromptSection[] = [`rules`, `components`, `shapes`, `functions`, `style`, `extensions`]\n\nexport interface PromptOptions {\n  extensions?: readonly ExtensionDef[]\n  /** The core-lite subset (the app-shaped vocabulary: no overlays, media, Chart, data tables or the rarer controls). */\n  lite?: boolean\n  /** Omit the per-prop lines (names + types only). */\n  terse?: boolean\n  /** VAPP-108: which sections to print (default `DEFAULT_SECTIONS`, in that order whatever the order given). */\n  sections?: readonly PromptSection[]\n  /** VAPP-108: print only these components (full blocks) and the shapes they reach; `index` still lists every one. */\n  only?: readonly string[]\n}\n\n/** The rules every surface author (a model) must follow, shared by the core\n *  and the basic catalog. Kept to a few lines on purpose. */\nexport const PROMPT_RULES: readonly string[] = [\n  `Reply with A2UI v0.9 messages: createSurface{surfaceId, catalogId}, then updateComponents{surfaceId, components:[…]} (one has id \"root\"; resend an id to change it) and updateDataModel{surfaceId, path, value} (writes the JSON pointer; no value removes it). Keep data in the model and bind to it.`,\n  `A component = {id, component, …props, children?: [ids] | {componentId, path, key?}, slots?: {name: id}, on?: {event: action}, style?, visible?}. Children are ids, never inline; {componentId, path} repeats per item, key = the item field naming it.`,\n  `Include every required prop. A ~ prop may be a binding {path: \"/json/pointer\"} or a call {call, args} (live). visible: false (or a binding) hides any component.`,\n  `An action (on: {event: action}) = {event: {name, context?}} (sent to you; context values may be bindings, read AFTER the component's own write) and/or {functionCall: {call, args}} (runs on the client: a function below, or a namespaced host function like app.toast).`,\n  `Lay out with Page, Stack, Grid, Card, SplitView, Sidebar and List (anything longer than a screen); a row of controls is a Toolbar, fields side by side a FieldGroup, the Cancel/submit row FormActions; Box + style only for the rest. Wrap fields in Form; a valid submit closes the Dialog or Drawer around it.`,\n  `Responsive: a ^ prop also takes {base, sm?, md?, lg?, xl?} (from that breakpoint up). Style conditions, one level, narrow first: \"@media (min-width: $breakpoint.md)\": {…} (also max-width, min-height, max-height in px or $breakpoint.sm|md|lg|xl; orientation: portrait|landscape; hover: hover|none; prefers-reduced-motion: reduce), then \":hover\", \":focus-visible\", \":pressed\". display: \"none\" hides.`,\n  `Prefer catalog components over Markdown (feature lists = List + Row, not bullets), labels and tones over colours; a colour is a $color.* token, never #hex (light and dark both apply). Built-in copy (Cancel, Search…) is localized: leave it unset.`,\n  `One default Button per screen (the FormActions submit or the main action); the rest outline, secondary or ghost.`,\n]\n\n/** Props whose meaning is the same everywhere: described ONCE in the full\n *  prompt (the per-prop line then carries only name, marks and type). The\n *  catalog keeps every per-component description for the docs. */\nexport const COMMON_PROPS: Readonly<Record<string, string>> = {\n  name: `form key`,\n  label: ``,\n  placeholder: ``,\n  disabled: ``,\n  checks: `validation; every failure shows`,\n  validateOn: ``,\n  style: `extra Box style`,\n  icon: ``,\n  size: ``,\n  tone: ``,\n  open: `bind it`,\n  side: ``,\n  emptyText: ``,\n  dismissible: ``,\n  busy: ``,\n  loading: ``,\n  lines: `truncate`,\n  width: `px`,\n  height: `px`,\n  value: `bind it for two-way state`,\n  title: ``,\n  subtitle: ``,\n  description: ``,\n  meta: ``,\n  count: ``,\n  min: ``,\n  max: ``,\n  step: ``,\n  src: ``,\n  alt: ``,\n  multiple: ``,\n  pressable: `fires press`,\n  durationMs: `known length`,\n  firstDayOfWeek: `0 = Sunday; else the locale's`,\n  direction: ``,\n  orientation: ``,\n  gap: ``,\n  aspectRatio: `width/height`,\n  text: ``,\n}\n\nfunction typeOf(schema: PropSchema, enums: Record<string, readonly string[]>): string {\n  switch (schema.type) {\n    case `enum`:\n      return (schema.values ?? enums[schema.enum ?? ``] ?? []).join(`|`)\n    case `array`:\n      return schema.items ? `[${schema.items.type === `object` ? (schema.items.shape ?? `object`) : typeOf(schema.items, enums)}]` : `[]`\n    case `object`:\n      return schema.shape ?? `object`\n    default:\n      return schema.type\n  }\n}\n\nfunction marksOf(schema: PropSchema): string {\n  return `${schema.required ? `*` : ``}${schema.bindable ? `~` : ``}${schema.responsive ? `^` : ``}`\n}\n\n/** The default worth printing: an enum's FIRST value and a boolean's\n *  `false` are implied (the components line says so once). */\nfunction defaultOf(schema: PropSchema, enums: Record<string, readonly string[]>): string {\n  if (schema.default === undefined) return ``\n  if (schema.type === `boolean` && schema.default === false) return ``\n  if (schema.type === `enum` && (schema.values ?? enums[schema.enum ?? ``] ?? [])[0] === schema.default) return ``\n  return `=${JSON.stringify(schema.default)}`\n}\n\nfunction propLine(name: string, schema: PropSchema, enums: Record<string, readonly string[]>): string {\n  const def = defaultOf(schema, enums)\n  const head = `${name}${marksOf(schema)}: ${typeOf(schema, enums)}${def}`\n  return name in COMMON_PROPS ? head : `${head} — ${schema.description}`\n}\n\nexport function componentBlock(name: string, def: ComponentDef, enums: Record<string, readonly string[]>, terse: boolean): string {\n  const head = `${name}${def.kind === `macro` ? `` : ``}: ${def.description}`\n  const meta: string[] = []\n  if (def.children !== `none`) meta.push(def.children === `one` ? `one child` : `children`)\n  if (def.slots?.length) meta.push(`slots: ${def.slots.join(`, `)}`)\n  if (def.events?.length) meta.push(`on: ${def.events.join(`, `)}`)\n  const props = Object.entries(def.props)\n  const body = terse\n    ? [`  props: ${props.map(([p, s]) => `${p}${marksOf(s)}:${typeOf(s, enums)}`).join(`, `)}`]\n    : props.map(([p, s]) => `  ${propLine(p, s, enums)}`)\n  return [head, ...(meta.length ? [`  ${meta.join(`; `)}`] : []), ...body].join(`\\n`)\n}\n\n/** The shapes a prompt needs: every def a listed component's props reach\n *  (directly, through arrays or through another def). */\nfunction usedShapes(components: Iterable<ComponentDef>, defs: Record<string, { properties: Record<string, PropSchema> }>): Set<string> {\n  const used = new Set<string>()\n  const visit = (schema: PropSchema | undefined) => {\n    if (!schema) return\n    if (schema.type === `array`) return visit(schema.items)\n    if (schema.type === `object` && schema.shape && !used.has(schema.shape) && defs[schema.shape]) {\n      used.add(schema.shape)\n      for (const p of Object.values(defs[schema.shape].properties)) visit(p)\n    }\n  }\n  for (const def of components) for (const p of Object.values(def.props)) visit(p)\n  return used\n}\n\nfunction defsBlock(defs: Record<string, { description: string; properties: Record<string, PropSchema> }>, enums: Record<string, readonly string[]>, only?: Set<string>): string[] {\n  return Object.entries(defs).filter(([name]) => !only || only.has(name)).map(\n    ([name, def]) => `${name} = {${Object.entries(def.properties).map(([p, s]) => `${p}${s.required ? `*` : ``}: ${typeOf(s, enums)}`).join(`, `)}}`\n  )\n}\n\nconst SHORT_TYPES: Readonly<Record<string, string>> = { string: `str`, number: `num`, boolean: `bool`, object: `obj` }\n\n/** Every catalog function as `name(arg:type,…)→returns` (round 4: the\n *  model sees the argument names, not just the function names). */\nexport function functionSignatures(): string[] {\n  const { names, core, basic } = coreCatalog.functions\n  return names.map((name) => {\n    const sig = core[name] ?? basic[name]\n    if (!sig) return name\n    return `${name}(${Object.entries(sig.args).map(([a, t]) => `${a}:${SHORT_TYPES[t] ?? t}`).join(`,`)})→${SHORT_TYPES[sig.returns] ?? sig.returns}`\n  })\n}\n\n/** VAPP-108: one component's full block on demand (the per-component\n *  section an agent requests after reading the index), with the shapes its\n *  props reach. Unknown or hidden names give an empty string. */\nexport function componentPrompt(name: string, options: Pick<PromptOptions, `extensions` | `terse`> = {}): string {\n  const extensions = options.extensions ?? []\n  const view = catalogView(extensions)\n  const def = view.components[name]\n  if (!def || def.hidden) return ``\n  const defs = { ...coreCatalog.defs, ...Object.fromEntries(extensions.flatMap((e) => Object.entries(e.defs ?? {}))) }\n  const lines = [componentBlock(name, def, view.enums, options.terse ?? false)]\n  const shapes = defsBlock(defs, view.enums, usedShapes([def], defs))\n  if (shapes.length) lines.push(`Shapes: ${shapes.join(`; `)}`)\n  return lines.join(`\\n`)\n}\n\n/** VAPP-108: the index — every offered component on one line (name, group, kind, its sentence), grouped. */\nexport function catalogIndex(options: Pick<PromptOptions, `extensions` | `lite`> = {}): string[] {\n  const groups = new Map<string, string[]>()\n  const add = (name: string, def: ComponentDef) => {\n    const list = groups.get(def.group) ?? []\n    list.push(`${name}${def.children === `none` ? `` : def.children === `one` ? ` (one child)` : ` (children)`}: ${def.description}`)\n    groups.set(def.group, list)\n  }\n  for (const [name, def] of Object.entries(coreCatalog.components)) {\n    if (!isOffered(def)) continue\n    if (options.lite && !def.lite) continue\n    add(name, def)\n  }\n  for (const ext of options.extensions ?? []) for (const [name, def] of Object.entries(ext.components)) add(name, def)\n  return [...groups.entries()].map(([group, items]) => `${group}: ${items.join(` · `)}`)\n}\n\n/** The system prompt for a surface author. */\nexport function catalogPrompt(options: PromptOptions = {}): string {\n  const extensions = options.extensions ?? []\n  const view = catalogView(extensions)\n  const wanted = new Set(options.sections ?? DEFAULT_SECTIONS)\n  const has = (s: PromptSection) => wanted.has(s)\n  const only = options.only ? new Set(options.only) : undefined\n  const lines: string[] = []\n  const id = options.lite ? CORE_LITE_CATALOG_ID : CORE_CATALOG_ID\n  lines.push(`Catalog ${id}${extensions.length ? ` with extensions ${extensions.map((e) => e.id).join(`, `)}` : ``}.`)\n  if (has(`rules`)) {\n    lines.push(`Rules:`)\n    for (const rule of PROMPT_RULES) lines.push(`- ${rule}`)\n  }\n  const offered = Object.entries(coreCatalog.components).filter(([, def]) => isOffered(def) && (!options.lite || def.lite))\n  const listed = offered.filter(([name]) => !only || only.has(name))\n  if (has(`components`)) {\n    lines.push(`Components (props marked * are required, ~ accept a binding, ^ are responsive; =x is the default, else an enum defaults to its first value and a boolean to false${only ? `; ask for any other component by name` : ``}):`)\n    if (!options.terse) lines.push(`Common props (no description below): ${Object.entries(COMMON_PROPS).map(([k, v]) => (v ? `${k} (${v})` : k)).join(`, `)}.`)\n    for (const [name, def] of listed) lines.push(componentBlock(name, def, view.enums, options.terse ?? false))\n  }\n  if (has(`index`)) {\n    lines.push(`Index (every component; ask for one by name to get its props):`)\n    for (const line of catalogIndex({ extensions, lite: options.lite })) lines.push(`- ${line}`)\n  }\n  if (has(`shapes`) && has(`components`)) lines.push(`Shapes: ${defsBlock(coreCatalog.defs, view.enums, usedShapes(listed.map(([, def]) => def), coreCatalog.defs)).join(`; `)}`)\n  if (has(`functions`)) lines.push(`Functions ({call, args}; name(arg:type)→result): ${functionSignatures().join(`, `)}. filter: where = {field: value} (an empty value matches all), query = a case-insensitive substring of fields; bind a List or Table to it.`)\n  if (has(`style`)) lines.push(`Style keys (Box): display, flex*, justifyContent, align*, gap, width, height, min/max sizes, aspectRatio, position (relative|absolute|sticky), top/right/bottom/left, inset*, padding*/margin* (+Horizontal/Vertical/InlineStart/End), grid*, overflow(X/Y), direction, backgroundColor, backgroundGradient {angle, stops}, backdropBlur $blur.*, color, border*, opacity, boxShadow, font*, letterSpacing, text*, transition $motion.*, transform (translate/scale/rotate, paint only), animation (pulse|spin|fade-in|slide-in-up/down/left/right|shimmer), visibility, pointerEvents, userSelect, cursor. Values: px, \"N%\", \"auto\", or tokens $spacing.md, $color.primary, $radius.lg, $control.row.`)\n  if (has(`extensions`) && has(`components`)) {\n    for (const ext of extensions) {\n      lines.push(`Extension ${ext.id} (${ext.name}):`)\n      for (const [name, def] of Object.entries(ext.components)) lines.push(componentBlock(name, def, view.enums, options.terse ?? false))\n      if (ext.defs && Object.keys(ext.defs).length) lines.push(`Shapes: ${defsBlock(ext.defs, view.enums).join(`; `)}`)\n    }\n  }\n  return lines.join(`\\n`)\n}\n\n/** Characters per token the budget assumes (the same rule as the context\n *  layout's `charsPerToken`): an estimate, not a tokenizer. */\nexport const CHARS_PER_TOKEN = 4\n\nexport function estimateTokens(text: string): number {\n  return Math.ceil(text.length / CHARS_PER_TOKEN)\n}\n",
+    "// VAPP-106: `@exponential-at/ui/prompt`, the model-facing prompt as its own\n// entry. The root entry ships the catalog WITHOUT its descriptions (a browser\n// that renders never needs them); this entry attaches them\n// (`describeCatalog`) before the prompt reads them. The prompt itself is\n// src/prompt.ts, which this file leaves alone.\n\nimport { describeCatalog } from \"../catalog.described\"\nimport { CHARS_PER_TOKEN, COMMON_PROPS, DEFAULT_SECTIONS, PROMPT_RULES, PROMPT_SECTIONS, catalogIndex as bareCatalogIndex, catalogPrompt as bareCatalogPrompt, componentPrompt as bareComponentPrompt, estimateTokens } from \"../prompt\"\nimport type { PromptOptions, PromptSection } from \"../prompt\"\n\nexport { CHARS_PER_TOKEN, COMMON_PROPS, DEFAULT_SECTIONS, PROMPT_RULES, PROMPT_SECTIONS, describeCatalog, estimateTokens }\nexport type { PromptOptions, PromptSection }\n\n/** The catalog prompt (src/prompt.ts `catalogPrompt`) over the described catalog. */\nexport function catalogPrompt(options: PromptOptions = {}): string {\n  describeCatalog()\n  return bareCatalogPrompt(options)\n}\n\n/** One component's prompt section (VAPP-108, the on-demand per-component prompt) over the described catalog. */\nexport function componentPrompt(name: string, options: Parameters<typeof bareComponentPrompt>[1] = {}): string {\n  describeCatalog()\n  return bareComponentPrompt(name, options)\n}\n\n/** The one-line-per-component index (VAPP-108) over the described catalog. */\nexport function catalogIndex(options: Parameters<typeof bareCatalogIndex>[0] = {}): string[] {\n  describeCatalog()\n  return bareCatalogIndex(options)\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "077C2E498EB260FA64756E2164756E21",
+  "names": []
+}