@exponential-at/ui 0.0.0-stage → 0.1.0

package/dist/chunks/index-xrm6f7wc.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/catalog.described.ts"],
+  "sourcesContent": [
+    "// VAPP-106: the model-facing text of the catalog (every component and prop\n// description, every example, the functions' descriptions) lives OUTSIDE the\n// runtime catalog. `generated/core.runtime.json` is what the reducer, the\n// validator and every renderer read (and what the Rust core embeds);\n// `generated/core.descriptions.json` is the rest, keyed like the catalog.\n// `describeCatalog()` puts the two back together IN PLACE on `coreCatalog`\n// (once; later calls return at the first check): the `./prompt` and\n// `./schema` entries call it before they read a description, so a browser\n// that only renders never downloads a word of it. The generator\n// (scripts/generate.ts) makes the split from catalog/core.catalog.json, the\n// source, with `splitDescriptions`; `catalog.described.test.ts` proves the\n// round trip.\n\nimport descriptionsJson from \"../generated/core.descriptions.json\" with { type: \"json\" }\nimport { coreCatalog } from \"./catalog\"\nimport type { CatalogSource, ComponentDef, DefSchema, PropSchema } from \"./types\"\n\n/** The text a prop schema carries (recursing into `items`). */\nexport interface PropDescription {\n  description?: string\n  items?: PropDescription\n}\n\n/** The text of the catalog, keyed like the catalog itself. */\nexport interface CatalogDescriptions {\n  components: Record<string, { description?: string; example?: Record<string, unknown>; props: Record<string, PropDescription> }>\n  defs: Record<string, { description?: string; properties: Record<string, PropDescription> }>\n  functions: { core: Record<string, string>; basic: Record<string, string> }\n}\n\n/** The runtime view of a schema object: its text may be absent (src/types.ts keeps it typed present). */\ntype Mutable<T> = { -readonly [K in keyof T as K extends `description` | `example` ? never : K]: T[K] } & { description?: string; example?: Record<string, unknown> }\n\nfunction takeProp(schema: Mutable<PropSchema>): PropDescription {\n  const out: PropDescription = {}\n  if (schema.description !== undefined) {\n    out.description = schema.description\n    delete schema.description\n  }\n  if (schema.items) {\n    const items = takeProp(schema.items as Mutable<PropSchema>)\n    if (Object.keys(items).length) out.items = items\n  }\n  return out\n}\n\nfunction giveProp(schema: Mutable<PropSchema>, text: PropDescription | undefined): void {\n  if (!text) return\n  if (text.description !== undefined) schema.description = text.description\n  if (text.items && schema.items) giveProp(schema.items as Mutable<PropSchema>, text.items)\n}\n\n/** Every `$comment` dropped, recursively (the source carries them for people). */\nfunction withoutComments<T>(value: T): T {\n  if (Array.isArray(value)) return value.map(withoutComments) as T\n  if (typeof value === `object` && value !== null)\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .filter(([k]) => k !== `$comment`)\n        .map(([k, v]) => [k, withoutComments(v)])\n    ) as T\n  return value\n}\n\n/** The source catalog split into what the runtime needs and the text only\n *  the prompt, the schema and the docs read. Pure: the source stays as it is. */\nexport function splitDescriptions(source: CatalogSource): { runtime: CatalogSource; descriptions: CatalogDescriptions } {\n  const runtime = withoutComments(structuredClone(source)) as Mutable<CatalogSource>\n  const descriptions: CatalogDescriptions = { components: {}, defs: {}, functions: { core: {}, basic: {} } }\n  for (const [name, def] of Object.entries(runtime.components) as [string, Mutable<ComponentDef>][]) {\n    const entry: CatalogDescriptions[`components`][string] = { props: {} }\n    if (def.description !== undefined) {\n      entry.description = def.description\n      delete def.description\n    }\n    if (def.example !== undefined) {\n      entry.example = def.example\n      delete def.example\n    }\n    for (const [prop, schema] of Object.entries(def.props)) {\n      const text = takeProp(schema as Mutable<PropSchema>)\n      if (Object.keys(text).length) entry.props[prop] = text\n    }\n    descriptions.components[name] = entry\n  }\n  for (const [name, def] of Object.entries(runtime.defs) as [string, Mutable<DefSchema>][]) {\n    const entry: CatalogDescriptions[`defs`][string] = { properties: {} }\n    if (def.description !== undefined) {\n      entry.description = def.description\n      delete def.description\n    }\n    for (const [prop, schema] of Object.entries(def.properties)) {\n      const text = takeProp(schema as Mutable<PropSchema>)\n      if (Object.keys(text).length) entry.properties[prop] = text\n    }\n    descriptions.defs[name] = entry\n  }\n  for (const group of [`core`, `basic`] as const)\n    for (const [name, fn] of Object.entries(runtime.functions[group]) as [string, { description?: string }][]) {\n      if (fn.description === undefined) continue\n      descriptions.functions[group][name] = fn.description\n      delete fn.description\n    }\n  return { runtime, descriptions }\n}\n\n/** Puts the text back onto a runtime catalog, in place. */\nexport function applyDescriptions(target: CatalogSource, descriptions: CatalogDescriptions): void {\n  for (const [name, text] of Object.entries(descriptions.components)) {\n    const def = target.components[name] as Mutable<ComponentDef> | undefined\n    if (!def) continue\n    if (text.description !== undefined) def.description = text.description\n    if (text.example !== undefined) def.example = text.example\n    for (const [prop, propText] of Object.entries(text.props)) giveProp(def.props[prop] as Mutable<PropSchema>, propText)\n  }\n  for (const [name, text] of Object.entries(descriptions.defs)) {\n    const def = target.defs[name] as Mutable<DefSchema> | undefined\n    if (!def) continue\n    if (text.description !== undefined) def.description = text.description\n    for (const [prop, propText] of Object.entries(text.properties)) giveProp(def.properties[prop] as Mutable<PropSchema>, propText)\n  }\n  for (const group of [`core`, `basic`] as const)\n    for (const [name, description] of Object.entries(descriptions.functions[group])) {\n      const fn = target.functions[group][name] as { description?: string } | undefined\n      if (fn) fn.description = description\n    }\n}\n\nlet described = false\n\n/** `coreCatalog` with its descriptions and examples attached (once per\n *  process); what the prompt, the schema emitter and the docs read. */\nexport function describeCatalog(): CatalogSource {\n  if (!described) {\n    applyDescriptions(coreCatalog, descriptionsJson as unknown as CatalogDescriptions)\n    described = true\n  }\n  return coreCatalog\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAS,QAAQ,CAAC,QAA6B,MAAyC;AAAA,EACtF,IAAI,CAAC;AAAA,IAAM;AAAA,EACX,IAAI,KAAK,gBAAgB;AAAA,IAAW,OAAO,cAAc,KAAK;AAAA,EAC9D,IAAI,KAAK,SAAS,OAAO;AAAA,IAAO,SAAS,OAAO,OAA8B,KAAK,KAAK;AAAA;AA0DnF,SAAS,iBAAiB,CAAC,QAAuB,cAAyC;AAAA,EAChG,YAAY,MAAM,SAAS,OAAO,QAAQ,aAAa,UAAU,GAAG;AAAA,IAClE,MAAM,MAAM,OAAO,WAAW;AAAA,IAC9B,IAAI,CAAC;AAAA,MAAK;AAAA,IACV,IAAI,KAAK,gBAAgB;AAAA,MAAW,IAAI,cAAc,KAAK;AAAA,IAC3D,IAAI,KAAK,YAAY;AAAA,MAAW,IAAI,UAAU,KAAK;AAAA,IACnD,YAAY,MAAM,aAAa,OAAO,QAAQ,KAAK,KAAK;AAAA,MAAG,SAAS,IAAI,MAAM,OAA8B,QAAQ;AAAA,EACtH;AAAA,EACA,YAAY,MAAM,SAAS,OAAO,QAAQ,aAAa,IAAI,GAAG;AAAA,IAC5D,MAAM,MAAM,OAAO,KAAK;AAAA,IACxB,IAAI,CAAC;AAAA,MAAK;AAAA,IACV,IAAI,KAAK,gBAAgB;AAAA,MAAW,IAAI,cAAc,KAAK;AAAA,IAC3D,YAAY,MAAM,aAAa,OAAO,QAAQ,KAAK,UAAU;AAAA,MAAG,SAAS,IAAI,WAAW,OAA8B,QAAQ;AAAA,EAChI;AAAA,EACA,WAAW,SAAS,CAAC,QAAQ,OAAO;AAAA,IAClC,YAAY,MAAM,gBAAgB,OAAO,QAAQ,aAAa,UAAU,MAAM,GAAG;AAAA,MAC/E,MAAM,KAAK,OAAO,UAAU,OAAO;AAAA,MACnC,IAAI;AAAA,QAAI,GAAG,cAAc;AAAA,IAC3B;AAAA;AAGJ,IAAI,YAAY;AAIT,SAAS,gBAAe,GAAkB;AAAA,EAC/C,IAAI,CAAC,WAAW;AAAA,IACd,kBAAkB,cAAa,yBAAkD;AAAA,IACjF,YAAY;AAAA,EACd;AAAA,EACA,OAAO;AAAA;",
+  "debugId": "55EDB4D4EA3B41EC64756E2164756E21",
+  "names": []
+}