@assistant-ui/react-generative-ui 0.0.7 → 0.0.9

package/dist/ir.js.map

@@ -1 +1 @@
-{"version":3,"file":"ir.js","names":[],"sources":["../src/ir.ts"],"sourcesContent":["/**\n * The generative-ui intermediate representation: a model-emitted, cross-platform\n * UI tree. React-free, so converters and non-web runtimes consume it without\n * pulling React. The flat `$type` shape is the canonical form; the legacy\n * `component` shape is accepted as a backward-compatible alias.\n *\n * Reserved keys are partitioned off from component props so the component prop\n * namespace stays fully free:\n *\n * - `$`-prefixed keys are framework-reserved (`$type`, `$key`, `$action`,\n *   `$status`). Components never declare `$`-prefixed props, so a component\n *   can use `type`, `status`, `variant`, etc. as ordinary props without\n *   colliding with the framework.\n * - `children` is additionally reserved (the JSX convention).\n * - every other key is an inline prop passed straight to the component.\n */\n\nimport { TYPE_KEY } from \"./constants\";\n\nexport const TEXT_SIZES = [\"sm\", \"md\", \"lg\", \"xl\", \"2xl\", \"3xl\"] as const;\nexport type TextSize = (typeof TEXT_SIZES)[number];\n\nexport const IMAGE_SIZE_TOKENS = [\"sm\", \"md\", \"lg\"] as const;\nexport type ImageSize = (typeof IMAGE_SIZE_TOKENS)[number] | number;\n\nexport const WEIGHTS = [\"normal\", \"medium\", \"semibold\", \"bold\"] as const;\nexport type Weight = (typeof WEIGHTS)[number];\n\nexport const COLORS = [\n  \"emphasis\",\n  \"secondary\",\n  \"alpha-70\",\n  \"white\",\n  \"white-70\",\n  \"white-50\",\n] as const;\nexport type Color = (typeof COLORS)[number];\n\nexport const ALIGNS = [\"start\", \"center\", \"end\"] as const;\nexport type Align = (typeof ALIGNS)[number];\n\nexport const JUSTIFIES = [\"start\", \"center\", \"end\", \"between\"] as const;\nexport type Justify = (typeof JUSTIFIES)[number];\n\nexport const BUTTON_STYLES = [\n  \"primary\",\n  \"secondary\",\n  \"outline\",\n  \"ghost\",\n  \"danger\",\n] as const;\nexport type ButtonStyle = (typeof BUTTON_STYLES)[number];\n\nexport const ALERT_TONES = [\"info\", \"success\", \"warning\", \"danger\"] as const;\n/** Maps to ChatKit `alert` severity levels. */\nexport type AlertTone = (typeof ALERT_TONES)[number];\n\n/**\n * Behavior payload carried by an interactive node. `type` is resolved by the\n * host's action registry, not the renderer; keeping behavior as data keeps the\n * tree serializable so the same node renders on web and converts to a native\n * action id on Slack.\n */\nexport interface Action {\n  readonly type: string;\n  readonly [payload: string]: unknown;\n}\n\n/**\n * Anything renderable as generative UI, as the model emits it. The renderer\n * also accepts `number`, `boolean`, `null`, `undefined`, and arrays at the\n * input boundary (numbers render as text, falsy/boolean as nothing, arrays as\n * lists); {@link normalizeUINode} accepts that full range.\n */\nexport type UINode = string | number | UIElement | LegacyComponentNode;\n\nexport type UIChildren = UINode | readonly UINode[];\n\n/** The flat node shape: inline props keep the tree compact and natural for a\n * model to emit, instead of a nested `{ type, props }` bag. Reserved keys are\n * stripped before props reach the component (see the module header). */\nexport interface UIElement {\n  readonly $type: string;\n  readonly $key?: string | number;\n  readonly children?: UIChildren;\n  readonly $action?: Action;\n  readonly [prop: string]: unknown;\n}\n\n/**\n * The legacy node shape: a `component` name plus a nested `props` bag. Kept\n * for backward compatibility. New code authors the flat {@link UIElement}\n * shape instead.\n */\nexport interface LegacyComponentNode {\n  readonly component: string;\n  readonly props?: Record<string, unknown>;\n  readonly children?: UIChildren;\n  readonly key?: string;\n}\n\nexport type UISpec = UINode | readonly UINode[];\n\n/**\n * A node normalized to a single canonical shape: a `type` string, an inline\n * `props` bag, recursive `children`, an optional `key`, and an optional\n * `action`. Renderers and platform converters consume this form, so they never\n * branch on whether the model emitted the flat `$type` shape or the legacy\n * `component` shape, and they never see the reserved `$`-prefixed keys leak\n * into component props.\n */\nexport interface NormalizedUIElement {\n  readonly type: string;\n  readonly props: Readonly<Record<string, unknown>>;\n  readonly children?: NormalizedUINode | undefined;\n  readonly key?: string | number | undefined;\n  readonly action?: Action | undefined;\n}\n\nexport type NormalizedUINode =\n  | string\n  | number\n  | readonly NormalizedUINode[]\n  | NormalizedUIElement\n  | null;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\ntype LegacyNodeRecord = { component: string } & Record<string, unknown>;\n\nconst isLegacyNode = (\n  node: Record<string, unknown>,\n): node is LegacyNodeRecord => typeof node[\"component\"] === \"string\";\n\nconst isTypeNode = (node: Record<string, unknown>): node is UIElement =>\n  typeof node[TYPE_KEY] === \"string\";\n\n/** Bounds recursion so a runaway or adversarial model response cannot overflow\n * the stack; past this depth (far beyond any real UI) we stop. */\nconst MAX_DEPTH = 64;\n\n/**\n * Steps a streaming partial path down into `key`. `partialPath` is the remaining\n * segment of the parse meta's partial path relative to `node` (`undefined` once\n * the walk leaves the partial frontier, i.e. everything below is complete).\n */\nfunction descend(\n  partialPath: readonly string[] | undefined,\n  key: string,\n): readonly string[] | undefined {\n  return partialPath?.[0] === key ? partialPath.slice(1) : undefined;\n}\n\n/**\n * Normalizes a generative-ui input to {@link NormalizedUINode}. The flat\n * `$type` shape and the legacy `component` shape both map to the same canonical\n * element, with reserved keys (`$type`, `$key`, `$action`, `children`) stripped\n * from the prop bag. A node that carries neither a `$type` nor a `component`\n * string is not renderable and resolves to `null` rather than throwing, so a\n * partially-streamed or malformed node degrades to \"render nothing\".\n *\n * `partialPath` carries streaming state from the tool-args parse meta: a node\n * whose `$type` is still mid-arrival is held back (resolves to `null`) until it\n * completes, and the path is threaded into `children` so a nested streaming\n * node is held back while completed siblings render. Omit it for a\n * non-streaming (converter) normalize.\n */\nexport function normalizeUINode(\n  node: unknown,\n  partialPath?: readonly string[] | undefined,\n  depth = 0,\n): NormalizedUINode {\n  if (depth > MAX_DEPTH) return null;\n  if (node == null || typeof node === \"boolean\") return null;\n  if (typeof node === \"string\" || typeof node === \"number\") return node;\n  if (Array.isArray(node))\n    return node.map((child, index) =>\n      normalizeUINode(child, descend(partialPath, String(index)), depth + 1),\n    );\n  if (!isRecord(node)) return null;\n\n  // The flat `$type` shape is the canonical form; detect it first so a flat\n  // node that happens to use `component` as an ordinary prop is not swallowed\n  // by the legacy `component`-shape branch.\n  if (isTypeNode(node)) {\n    if (partialPath?.length === 1 && partialPath[0] === TYPE_KEY) return null;\n    const { [TYPE_KEY]: type, $key, $action, children, ...rest } = node;\n    // The `$`-prefixed namespace is framework-reserved (see the module header),\n    // so any model-supplied `$`-prefixed key is stripped from the prop bag the\n    // component sees. `$type`/`$key`/`$action` are pulled above; sweep the rest\n    // (e.g. a stray `$status`) so it never leaks to converters or components.\n    const props = stripReservedProps(rest);\n    return {\n      type,\n      props,\n      children: normalizeChildren(children, partialPath, depth),\n      key: $key,\n      action: $action,\n    };\n  }\n\n  if (isLegacyNode(node)) {\n    const props = stripReservedProps(\n      (node.props ?? {}) as Record<string, unknown>,\n    );\n    return {\n      type: node.component,\n      props,\n      children: normalizeChildren(node.children, partialPath, depth),\n      key: node.key as string | undefined,\n    };\n  }\n\n  return null;\n}\n\nfunction stripReservedProps(\n  props: Record<string, unknown>,\n): Record<string, unknown> {\n  let out: Record<string, unknown> | undefined;\n  for (const key of Object.keys(props)) {\n    if (key.startsWith(\"$\")) {\n      out ??= { ...props };\n      delete out[key];\n    }\n  }\n  return out ?? props;\n}\n\nfunction normalizeChildren(\n  children: unknown,\n  partialPath: readonly string[] | undefined,\n  depth: number,\n): NormalizedUINode | undefined {\n  if (children === undefined) return undefined;\n  return normalizeUINode(children, descend(partialPath, \"children\"), depth + 1);\n}\n\n/**\n * Normalizes the root of a {@link UISpec}, preserving whether the root was a\n * single node or a list.\n */\nexport function normalizeSpec(spec: UISpec): {\n  readonly root: NormalizedUINode | readonly NormalizedUINode[];\n} {\n  if (Array.isArray(spec)) {\n    return {\n      root: (spec as readonly UINode[]).map((node) => normalizeUINode(node)),\n    };\n  }\n  return { root: normalizeUINode(spec) };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,MAAa,aAAa;CAAC;CAAM;CAAM;CAAM;CAAM;CAAO;AAAK;AAG/D,MAAa,oBAAoB;CAAC;CAAM;CAAM;AAAI;AAGlD,MAAa,UAAU;CAAC;CAAU;CAAU;CAAY;AAAM;AAG9D,MAAa,SAAS;CACpB;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,SAAS;CAAC;CAAS;CAAU;AAAK;AAG/C,MAAa,YAAY;CAAC;CAAS;CAAU;CAAO;AAAS;AAG7D,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,cAAc;CAAC;CAAQ;CAAW;CAAW;AAAQ;AAyElE,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAIrE,MAAM,gBACJ,SAC6B,OAAO,KAAK,iBAAiB;AAE5D,MAAM,cAAc,SAClB,OAAO,KAAK,cAAc;;;AAI5B,MAAM,YAAY;;;;;;AAOlB,SAAS,QACP,aACA,KAC+B;CAC/B,OAAO,cAAc,OAAO,MAAM,YAAY,MAAM,CAAC,IAAI,KAAA;AAC3D;;;;;;;;;;;;;;;AAgBA,SAAgB,gBACd,MACA,aACA,QAAQ,GACU;CAClB,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAAW,OAAO;CACtD,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAAU,OAAO;CACjE,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,KAAK,OAAO,UACtB,gBAAgB,OAAO,QAAQ,aAAa,OAAO,KAAK,CAAC,GAAG,QAAQ,CAAC,CACvE;CACF,IAAI,CAAC,SAAS,IAAI,GAAG,OAAO;CAK5B,IAAI,WAAW,IAAI,GAAG;EACpB,IAAI,aAAa,WAAW,KAAK,YAAY,OAAA,SAAiB,OAAO;EACrE,MAAM,GAAG,WAAW,MAAM,MAAM,SAAS,UAAU,GAAG,SAAS;EAM/D,OAAO;GACL;GACA,OAHY,mBAAmB,IAG3B;GACJ,UAAU,kBAAkB,UAAU,aAAa,KAAK;GACxD,KAAK;GACL,QAAQ;EACV;CACF;CAEA,IAAI,aAAa,IAAI,GAAG;EACtB,MAAM,QAAQ,mBACX,KAAK,SAAS,CAAC,CAClB;EACA,OAAO;GACL,MAAM,KAAK;GACX;GACA,UAAU,kBAAkB,KAAK,UAAU,aAAa,KAAK;GAC7D,KAAK,KAAK;EACZ;CACF;CAEA,OAAO;AACT;AAEA,SAAS,mBACP,OACyB;CACzB,IAAI;CACJ,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GACjC,IAAI,IAAI,WAAW,GAAG,GAAG;EACvB,QAAQ,EAAE,GAAG,MAAM;EACnB,OAAO,IAAI;CACb;CAEF,OAAO,OAAO;AAChB;AAEA,SAAS,kBACP,UACA,aACA,OAC8B;CAC9B,IAAI,aAAa,KAAA,GAAW,OAAO,KAAA;CACnC,OAAO,gBAAgB,UAAU,QAAQ,aAAa,UAAU,GAAG,QAAQ,CAAC;AAC9E;;;;;AAMA,SAAgB,cAAc,MAE5B;CACA,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,EACL,MAAO,KAA2B,KAAK,SAAS,gBAAgB,IAAI,CAAC,EACvE;CAEF,OAAO,EAAE,MAAM,gBAAgB,IAAI,EAAE;AACvC"}
+{"version":3,"file":"ir.js","names":[],"sources":["../src/ir.ts"],"sourcesContent":["/**\n * The generative-ui intermediate representation: a model-emitted, cross-platform\n * UI tree. React-free, so converters and non-web runtimes consume it without\n * pulling React. The flat `$type` shape is the canonical form; the legacy\n * `component` shape is accepted as a backward-compatible alias.\n *\n * Reserved keys are partitioned off from component props so the component prop\n * namespace stays fully free:\n *\n * - `$`-prefixed keys are framework-reserved (`$type`, `$key`, `$action`,\n *   `$status`). Components never declare `$`-prefixed props, so a component\n *   can use `type`, `status`, `variant`, etc. as ordinary props without\n *   colliding with the framework.\n * - `children` is additionally reserved (the JSX convention).\n * - every other key is an inline prop passed straight to the component.\n */\n\nimport { TYPE_KEY } from \"./constants\";\n\nexport const TEXT_SIZES = [\"sm\", \"md\", \"lg\", \"xl\", \"2xl\", \"3xl\"] as const;\nexport type TextSize = (typeof TEXT_SIZES)[number];\n\nexport const IMAGE_SIZE_TOKENS = [\"sm\", \"md\", \"lg\"] as const;\nexport type ImageSize = (typeof IMAGE_SIZE_TOKENS)[number] | number;\n\nexport const WEIGHTS = [\"normal\", \"medium\", \"semibold\", \"bold\"] as const;\nexport type Weight = (typeof WEIGHTS)[number];\n\nexport const COLORS = [\n  \"emphasis\",\n  \"secondary\",\n  \"alpha-70\",\n  \"white\",\n  \"white-70\",\n  \"white-50\",\n] as const;\nexport type Color = (typeof COLORS)[number];\n\nexport const ALIGNS = [\"start\", \"center\", \"end\"] as const;\nexport type Align = (typeof ALIGNS)[number];\n\nexport const JUSTIFIES = [\"start\", \"center\", \"end\", \"between\"] as const;\nexport type Justify = (typeof JUSTIFIES)[number];\n\nexport const BUTTON_STYLES = [\n  \"primary\",\n  \"secondary\",\n  \"outline\",\n  \"ghost\",\n  \"danger\",\n] as const;\nexport type ButtonStyle = (typeof BUTTON_STYLES)[number];\n\nexport const ALERT_TONES = [\"info\", \"success\", \"warning\", \"danger\"] as const;\n/** A severity level, from informational to destructive. */\nexport type AlertTone = (typeof ALERT_TONES)[number];\n\nexport const ICON_NAMES = [\n  \"sun\",\n  \"moon\",\n  \"cloud\",\n  \"rain\",\n  \"snow\",\n  \"wind\",\n  \"play\",\n  \"pause\",\n  \"check\",\n  \"x\",\n  \"star\",\n  \"heart\",\n  \"arrow-right\",\n  \"arrow-up-right\",\n  \"chevron-right\",\n  \"calendar\",\n  \"clock\",\n  \"map-pin\",\n  \"plane\",\n  \"truck\",\n  \"credit-card\",\n  \"user\",\n  \"search\",\n  \"bell\",\n] as const;\n/** A name from the built-in icon set; the closed enum lets the model see exactly which icons exist. */\nexport type IconName = (typeof ICON_NAMES)[number];\n\n/**\n * Behavior payload carried by an interactive node. `type` is resolved by the host's action registry, not the renderer; keeping behavior as data keeps the tree serializable, so the same node renders on web while converters may bind the type to a native action id on other platforms.\n */\nexport interface Action {\n  readonly type: string;\n  readonly [payload: string]: unknown;\n}\n\n/**\n * Anything renderable as generative UI, as the model emits it. The renderer\n * also accepts `number`, `boolean`, `null`, `undefined`, and arrays at the\n * input boundary (numbers render as text, falsy/boolean as nothing, arrays as\n * lists); {@link normalizeUINode} accepts that full range.\n */\nexport type UINode = string | number | UIElement | LegacyComponentNode;\n\nexport type UIChildren = UINode | readonly UINode[];\n\n/** The flat node shape: inline props keep the tree compact and natural for a\n * model to emit, instead of a nested `{ type, props }` bag. Reserved keys are\n * stripped before props reach the component (see the module header). */\nexport interface UIElement {\n  readonly $type: string;\n  readonly $key?: string | number;\n  readonly children?: UIChildren;\n  readonly $action?: Action;\n  readonly [prop: string]: unknown;\n}\n\n/**\n * The legacy node shape: a `component` name plus a nested `props` bag. Kept\n * for backward compatibility. New code authors the flat {@link UIElement}\n * shape instead.\n */\nexport interface LegacyComponentNode {\n  readonly component: string;\n  readonly props?: Record<string, unknown>;\n  readonly children?: UIChildren;\n  readonly key?: string;\n}\n\nexport type UISpec = UINode | readonly UINode[];\n\n/**\n * A node normalized to a single canonical shape: a `type` string, an inline\n * `props` bag, recursive `children`, an optional `key`, and an optional\n * `action`. Renderers and platform converters consume this form, so they never\n * branch on whether the model emitted the flat `$type` shape or the legacy\n * `component` shape, and they never see the reserved `$`-prefixed keys leak\n * into component props.\n */\nexport interface NormalizedUIElement {\n  readonly type: string;\n  readonly props: Readonly<Record<string, unknown>>;\n  readonly children?: NormalizedUINode | undefined;\n  readonly key?: string | number | undefined;\n  readonly action?: Action | undefined;\n}\n\nexport type NormalizedUINode =\n  | string\n  | number\n  | readonly NormalizedUINode[]\n  | NormalizedUIElement\n  | null;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\ntype LegacyNodeRecord = { component: string } & Record<string, unknown>;\n\nconst isLegacyNode = (\n  node: Record<string, unknown>,\n): node is LegacyNodeRecord => typeof node[\"component\"] === \"string\";\n\nconst isTypeNode = (node: Record<string, unknown>): node is UIElement =>\n  typeof node[TYPE_KEY] === \"string\";\n\n/** Bounds recursion so a runaway or adversarial model response cannot overflow\n * the stack; past this depth (far beyond any real UI) we stop. */\nconst MAX_DEPTH = 64;\n\n/**\n * Steps a streaming partial path down into `key`. `partialPath` is the remaining\n * segment of the parse meta's partial path relative to `node` (`undefined` once\n * the walk leaves the partial frontier, i.e. everything below is complete).\n */\nfunction descend(\n  partialPath: readonly string[] | undefined,\n  key: string,\n): readonly string[] | undefined {\n  return partialPath?.[0] === key ? partialPath.slice(1) : undefined;\n}\n\n/**\n * Normalizes a generative-ui input to {@link NormalizedUINode}. The flat\n * `$type` shape and the legacy `component` shape both map to the same canonical\n * element, with reserved keys (`$type`, `$key`, `$action`, `children`) stripped\n * from the prop bag. A node that carries neither a `$type` nor a `component`\n * string is not renderable and resolves to `null` rather than throwing, so a\n * partially-streamed or malformed node degrades to \"render nothing\".\n *\n * `partialPath` carries streaming state from the tool-args parse meta: a node\n * whose `$type` is still mid-arrival is held back (resolves to `null`) until it\n * completes, and the path is threaded into `children` so a nested streaming\n * node is held back while completed siblings render. Omit it for a\n * non-streaming (converter) normalize.\n */\nexport function normalizeUINode(\n  node: unknown,\n  partialPath?: readonly string[] | undefined,\n  depth = 0,\n): NormalizedUINode {\n  if (depth > MAX_DEPTH) return null;\n  if (node == null || typeof node === \"boolean\") return null;\n  if (typeof node === \"string\" || typeof node === \"number\") return node;\n  if (Array.isArray(node))\n    return node.map((child, index) =>\n      normalizeUINode(child, descend(partialPath, String(index)), depth + 1),\n    );\n  if (!isRecord(node)) return null;\n\n  // The flat `$type` shape is the canonical form; detect it first so a flat\n  // node that happens to use `component` as an ordinary prop is not swallowed\n  // by the legacy `component`-shape branch.\n  if (isTypeNode(node)) {\n    if (partialPath?.length === 1 && partialPath[0] === TYPE_KEY) return null;\n    const { [TYPE_KEY]: type, $key, $action, children, ...rest } = node;\n    // The `$`-prefixed namespace is framework-reserved (see the module header),\n    // so any model-supplied `$`-prefixed key is stripped from the prop bag the\n    // component sees. `$type`/`$key`/`$action` are pulled above; sweep the rest\n    // (e.g. a stray `$status`) so it never leaks to converters or components.\n    const props = stripReservedProps(rest);\n    return {\n      type,\n      props,\n      children: normalizeChildren(children, partialPath, depth),\n      key: $key,\n      action: $action,\n    };\n  }\n\n  if (isLegacyNode(node)) {\n    const props = stripReservedProps(\n      (node.props ?? {}) as Record<string, unknown>,\n    );\n    return {\n      type: node.component,\n      props,\n      children: normalizeChildren(node.children, partialPath, depth),\n      key: node.key as string | undefined,\n    };\n  }\n\n  return null;\n}\n\nfunction stripReservedProps(\n  props: Record<string, unknown>,\n): Record<string, unknown> {\n  let out: Record<string, unknown> | undefined;\n  for (const key of Object.keys(props)) {\n    if (key.startsWith(\"$\")) {\n      out ??= { ...props };\n      delete out[key];\n    }\n  }\n  return out ?? props;\n}\n\nfunction normalizeChildren(\n  children: unknown,\n  partialPath: readonly string[] | undefined,\n  depth: number,\n): NormalizedUINode | undefined {\n  if (children === undefined) return undefined;\n  return normalizeUINode(children, descend(partialPath, \"children\"), depth + 1);\n}\n\n/**\n * Normalizes the root of a {@link UISpec}, preserving whether the root was a\n * single node or a list.\n */\nexport function normalizeSpec(spec: UISpec): {\n  readonly root: NormalizedUINode | readonly NormalizedUINode[];\n} {\n  if (Array.isArray(spec)) {\n    return {\n      root: (spec as readonly UINode[]).map((node) => normalizeUINode(node)),\n    };\n  }\n  return { root: normalizeUINode(spec) };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,MAAa,aAAa;CAAC;CAAM;CAAM;CAAM;CAAM;CAAO;AAAK;AAG/D,MAAa,oBAAoB;CAAC;CAAM;CAAM;AAAI;AAGlD,MAAa,UAAU;CAAC;CAAU;CAAU;CAAY;AAAM;AAG9D,MAAa,SAAS;CACpB;CACA;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,SAAS;CAAC;CAAS;CAAU;AAAK;AAG/C,MAAa,YAAY;CAAC;CAAS;CAAU;CAAO;AAAS;AAG7D,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CACA;AACF;AAGA,MAAa,cAAc;CAAC;CAAQ;CAAW;CAAW;AAAQ;AAIlE,MAAa,aAAa;CACxB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAsEA,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAIrE,MAAM,gBACJ,SAC6B,OAAO,KAAK,iBAAiB;AAE5D,MAAM,cAAc,SAClB,OAAO,KAAK,cAAc;;;AAI5B,MAAM,YAAY;;;;;;AAOlB,SAAS,QACP,aACA,KAC+B;CAC/B,OAAO,cAAc,OAAO,MAAM,YAAY,MAAM,CAAC,IAAI,KAAA;AAC3D;;;;;;;;;;;;;;;AAgBA,SAAgB,gBACd,MACA,aACA,QAAQ,GACU;CAClB,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAAW,OAAO;CACtD,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAAU,OAAO;CACjE,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,KAAK,OAAO,UACtB,gBAAgB,OAAO,QAAQ,aAAa,OAAO,KAAK,CAAC,GAAG,QAAQ,CAAC,CACvE;CACF,IAAI,CAAC,SAAS,IAAI,GAAG,OAAO;CAK5B,IAAI,WAAW,IAAI,GAAG;EACpB,IAAI,aAAa,WAAW,KAAK,YAAY,OAAA,SAAiB,OAAO;EACrE,MAAM,GAAG,WAAW,MAAM,MAAM,SAAS,UAAU,GAAG,SAAS;EAM/D,OAAO;GACL;GACA,OAHY,mBAAmB,IAG3B;GACJ,UAAU,kBAAkB,UAAU,aAAa,KAAK;GACxD,KAAK;GACL,QAAQ;EACV;CACF;CAEA,IAAI,aAAa,IAAI,GAAG;EACtB,MAAM,QAAQ,mBACX,KAAK,SAAS,CAAC,CAClB;EACA,OAAO;GACL,MAAM,KAAK;GACX;GACA,UAAU,kBAAkB,KAAK,UAAU,aAAa,KAAK;GAC7D,KAAK,KAAK;EACZ;CACF;CAEA,OAAO;AACT;AAEA,SAAS,mBACP,OACyB;CACzB,IAAI;CACJ,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GACjC,IAAI,IAAI,WAAW,GAAG,GAAG;EACvB,QAAQ,EAAE,GAAG,MAAM;EACnB,OAAO,IAAI;CACb;CAEF,OAAO,OAAO;AAChB;AAEA,SAAS,kBACP,UACA,aACA,OAC8B;CAC9B,IAAI,aAAa,KAAA,GAAW,OAAO,KAAA;CACnC,OAAO,gBAAgB,UAAU,QAAQ,aAAa,UAAU,GAAG,QAAQ,CAAC;AAC9E;;;;;AAMA,SAAgB,cAAc,MAE5B;CACA,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,EACL,MAAO,KAA2B,KAAK,SAAS,gBAAgB,IAAI,CAAC,EACvE;CAEF,OAAO,EAAE,MAAM,gBAAgB,IAAI,EAAE;AACvC"}

package/dist/node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts

@@ -9,13 +9,13 @@
  * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
  */
 type JSONSchema7TypeName = "string" //
-| "number" | "integer" | "boolean" | "object" | "array" | "null";
+ | "number" | "integer" | "boolean" | "object" | "array" | "null";
 /**
  * Primitive type
  * @see https://tools.ietf.org/html/draft-handrews-json-schema-validation-01#section-6.1.1
  */
 type JSONSchema7Type = string //
-| number | boolean | JSONSchema7Object | JSONSchema7Array | null;
+ | number | boolean | JSONSchema7Object | JSONSchema7Array | null;
 // Workaround for infinite type recursion
 interface JSONSchema7Object {
   [key: string]: JSONSchema7Type;
@@ -137,5 +137,5 @@ interface JSONSchema7 {
   examples?: JSONSchema7Type | undefined;
 }
 //#endregion
-export { JSONSchema7 };
+export { JSONSchema7, JSONSchema7Array, JSONSchema7Definition, JSONSchema7Object, JSONSchema7Type, JSONSchema7TypeName, JSONSchema7Version };
 //# sourceMappingURL=index.d.ts.map

package/dist/node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["JSONSchema4Object","JSONSchema4Array","key","JSONSchema4Type","Array","id","$ref","$schema","JSONSchema4Version","title","description","default","multipleOf","maximum","exclusiveMaximum","minimum","exclusiveMinimum","maxLength","minLength","pattern","additionalItems","JSONSchema4","items","maxItems","minItems","uniqueItems","maxProperties","minProperties","required","additionalProperties","definitions","k","properties","patternProperties","dependencies","enum","type","JSONSchema4TypeName","allOf","anyOf","oneOf","not","extends","format","JSONSchema6Object","JSONSchema6Array","JSONSchema6Type","JSONSchema6","$id","JSONSchema6Version","JSONSchema6Definition","contains","propertyNames","const","JSONSchema6TypeName","examples","JSONSchema7Object","JSONSchema7Array","JSONSchema7Type","JSONSchema7","JSONSchema7Version","$comment","$defs","JSONSchema7Definition","JSONSchema7TypeName","if","then","else","contentMediaType","contentEncoding","readOnly","writeOnly","valid","errors","ValidationError","property","message","instance","schema","ValidationResult","value","result"],"sources":["../../../../../../../../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;KA+iBY,mBAAA;AAAA;;;;;KAaA,eAAA;AAAA,qBAIN,iBAAA,GACA,gBAAgB;AAAA;AAAA,UAIL,iBAAA;EAAA,CACZE,GAAAA,WAAc,eAAe;AAAA;AAAA;AAAA;AAAA,UAKjB,gBAAA,SAAyB,KAAK,CAAC,eAAA;;;;;;;;;;;;KAapC,kBAAA;;;;;KAMA,qBAAA,GAAwB,WAAW;AAAA,UAC9B,WAAA;EACb8C,GAAAA;EACA1C,IAAAA;EACAC,OAAAA,GAAU,kBAAA;EACVsD,QAAAA;;;;;EAMAC,KAAAA;IAAAA,CACK5D,GAAAA,WAAc,qBAAA;EAAA;;;;EAMnBkC,IAAAA,GAAO,mBAAA,GAAsB,mBAAA;EAC7BD,IAAAA,GAAO,eAAA;EACPkB,KAAAA,GAAQ,eAAA;;;;EAKRzC,UAAAA;EACAC,OAAAA;EACAC,gBAAAA;EACAC,OAAAA;EACAC,gBAAAA;;;;EAKAC,SAAAA;EACAC,SAAAA;EACAC,OAAAA;;;;EAKAG,KAAAA,GAAQ,qBAAA,GAAwB,qBAAA;EAChCF,eAAAA,GAAkB,qBAAA;EAClBG,QAAAA;EACAC,QAAAA;EACAC,WAAAA;EACA0B,QAAAA,GAAW,qBAAA;;;;EAKXzB,aAAAA;EACAC,aAAAA;EACAC,QAAAA;EACAI,UAAAA;IAAAA,CACK9B,GAAAA,WAAc,qBAAA;EAAA;EAEnB+B,iBAAAA;IAAAA,CACK/B,GAAAA,WAAc,qBAAA;EAAA;EAEnB2B,oBAAAA,GAAuB,qBAAA;EACvBK,YAAAA;IAAAA,CACKhC,GAAAA,WAAc,qBAAA;EAAA;EAEnBkD,aAAAA,GAAgB,qBAAA;;;;EAKhBa,EAAAA,GAAK,qBAAA;EACLC,IAAAA,GAAO,qBAAA;EACPC,IAAAA,GAAO,qBAAA;;;;EAKP7B,KAAAA,GAAQ,qBAAA;EACRC,KAAAA,GAAQ,qBAAA;EACRC,KAAAA,GAAQ,qBAAA;EACRC,GAAAA,GAAM,qBAAA;;;;EAKNE,MAAAA;;;;EAKAyB,gBAAAA;EACAC,eAAAA;;;;EAKAvC,WAAAA;IAAAA,CACK5B,GAAAA,WAAc,qBAAA;EAAA;;;;EAMnBO,KAAAA;EACAC,WAAAA;EACAC,OAAAA,GAAU,eAAA;EACV2D,QAAAA;EACAC,SAAAA;EACAhB,QAAAA,GAAW,eAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;KA+iBY;;;;;;KAaA;sBAIN,oBACA;;UAIW;GACZ,cAAc;;;;UAKF,yBAAyB,MAAM;;;;;;;;;;;;KAapC;;;;;KAMA,wBAAwB;UACnB;EACb;EACA;EACA,UAAU;EACV;;;;;EAMA;KACK,cAAc;;;;;EAMnB,OAAO,sBAAsB;EAC7B,OAAO;EACP,QAAQ;;;;EAKR;EACA;EACA;EACA;EACA;;;;EAKA;EACA;EACA;;;;EAKA,QAAQ,wBAAwB;EAChC,kBAAkB;EAClB;EACA;EACA;EACA,WAAW;;;;EAKX;EACA;EACA;EACA;KACK,cAAc;;EAEnB;KACK,cAAc;;EAEnB,uBAAuB;EACvB;KACK,cAAc;;EAEnB,gBAAgB;;;;EAKhB,KAAK;EACL,OAAO;EACP,OAAO;;;;EAKP,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,MAAM;;;;EAKN;;;;EAKA;EACA;;;;EAKA;KACK,cAAc;;;;;EAMnB;EACA;EACA,UAAU;EACV;EACA;EACA,WAAW"}

package/dist/renderGenerativeUI.d.ts

@@ -1,6 +1,5 @@
 import { GenerativeUILibrary, GenerativeUIRenderContext } from "./types.js";
 import { ReactNode } from "react";
-
 //#region src/renderGenerativeUI.d.ts
 /**
  * Renders a generative-ui tree against a {@link GenerativeUILibrary}.

package/dist/renderGenerativeUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderGenerativeUI.d.ts","names":[],"sources":["../src/renderGenerativeUI.tsx"],"mappings":";;;;;;AAwBA;;;;;;;;iBAAgB,kBAAA,CACd,IAAA,WACA,OAAA,EAAS,mBAAA,EACT,OAAA,GAAS,yBAAA,GACR,SAAA"}
+{"version":3,"file":"renderGenerativeUI.d.ts","names":[],"sources":["../src/renderGenerativeUI.tsx"],"mappings":";;;;;;;;;;;;;iBAwBgB,mBACd,eACA,SAAS,qBACT,UAAS,4BACR"}

package/dist/slack/constants.d.ts

@@ -0,0 +1,111 @@
+import { SlackAlertBlock, SlackButtonElement, SlackCardBlock, SlackCarouselBlock, SlackContextBlock, SlackDataTableBlock, SlackDataTableCell, SlackImageBlock, SlackSectionBlock, SlackTextObject } from "./types.js";
+//#region src/slack/constants.d.ts
+/** The maximum normalized traversal depth. */
+declare const MAX_TRAVERSAL_DEPTH = 64;
+/**
+ * The maximum number of entries kept at any single level (root, or a
+ * `children` array at any depth) of the raw spec, before it ever reaches
+ * `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass
+ * can never be made to walk further than this regardless of what the array
+ * claims about itself.
+ */
+declare const CHILDREN_CAP = 200;
+/**
+ * The total number of nodes the pre-normalization bounding walk will visit
+ * across one call, regardless of how many times a shared reference recurs.
+ * Bounds the combinatorial work a DAG of shared or self-referential nodes
+ * would otherwise force even though each individual array stays within
+ * {@link CHILDREN_CAP}.
+ */
+declare const NODE_BUDGET = 5000;
+/** The block limit for a Slack message. */
+declare const MESSAGE_BLOCK_CAP = 50;
+/** The block limit for a Slack modal. */
+declare const MODAL_BLOCK_CAP = 100;
+/**
+ * The maximum number of top-level blocks accepted when parsing Slack Block
+ * Kit JSON back into generative UI, guarding against a hostile or malformed
+ * payload.
+ */
+declare const INBOUND_BLOCK_CAP = 200;
+/** The character limit for header text. */
+declare const HEADER_TEXT_CAP = 150;
+/** The character limit for section text. */
+declare const SECTION_TEXT_CAP = 3000;
+/** The maximum number of fields in one section. */
+declare const FACT_FIELD_CAP = 10;
+/** The character limit for one section field. */
+declare const FACT_FIELD_TEXT_CAP = 2000;
+/** The character limit for button labels and option labels. */
+declare const INTERACTIVE_TEXT_CAP = 75;
+/** The character limit for an action_id. */
+declare const ACTION_ID_CAP = 255;
+/** The character limit for a button's serialized value payload. */
+declare const BUTTON_VALUE_CAP = 2000;
+/** The maximum number of elements in one actions block. */
+declare const ACTIONS_ELEMENT_CAP = 25;
+/** The maximum number of options in a static select. */
+declare const SELECT_OPTION_CAP = 100;
+/** The maximum number of options in a radio-button group. */
+declare const RADIO_OPTION_CAP = 10;
+/** The character limit for a select or input placeholder. */
+declare const PLACEHOLDER_TEXT_CAP = 150;
+/** The character limit for an input's label. */
+declare const INPUT_LABEL_CAP = 2000;
+/** The maximum number of elements in one context block. */
+declare const CONTEXT_ELEMENT_CAP = 10;
+/** The character limit for one context element's text. */
+declare const CONTEXT_TEXT_CAP = 3000;
+/** The character limit for card titles and subtitles. */
+declare const CARD_TITLE_CAP = 150;
+/** The character limit for a card's body text. */
+declare const CARD_BODY_CAP = 200;
+/** The character limit for a card's subtext. */
+declare const CARD_SUBTEXT_CAP = 200;
+/** The maximum number of buttons in a card's actions. */
+declare const CARD_ACTIONS_CAP = 3;
+/** The minimum number of elements in a renderable carousel. */
+declare const CAROUSEL_CARD_MIN = 1;
+/** The maximum number of elements in a carousel. */
+declare const CAROUSEL_CARD_CAP = 10;
+/** The character limit for an alert's text. */
+declare const ALERT_TEXT_CAP = 200;
+/**
+ * The maximum number of data rows in a data-table block; the emitted `rows`
+ * array additionally carries one header row.
+ */
+declare const DATA_TABLE_ROW_CAP = 100;
+/** The maximum number of columns in a data-table block. */
+declare const DATA_TABLE_COLUMN_CAP = 20;
+/**
+ * The cumulative character limit (summed across every cell's text) shared by
+ * every data-table block in one payload.
+ */
+declare const DATA_TABLE_CHAR_BUDGET = 10000;
+/** The caption emitted on every native data-table block. */
+declare const TABLE_CAPTION = "Table";
+/** The cumulative character limit for native markdown blocks. */
+declare const MARKDOWN_TEXT_BUDGET = 12000;
+/** Builds the message-surface fallback for an alert. */
+declare function buildAlertFallback(title: string, description: string, tone: "info" | "success" | "warning" | "danger"): readonly [SlackContextBlock, SlackSectionBlock];
+/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */
+declare function buildAlertBlock(text: string, tone: "info" | "success" | "warning" | "danger"): SlackAlertBlock;
+type CardBlockFields = {
+  readonly heroImage?: SlackImageBlock;
+  readonly title?: SlackTextObject;
+  readonly subtitle?: SlackTextObject;
+  readonly body?: SlackTextObject;
+  readonly subtext?: SlackTextObject;
+  readonly actions?: readonly SlackButtonElement[];
+};
+/** Builds a 2026 Slack card block from its already-clamped fields. */
+declare function buildCardBlock(fields: CardBlockFields): SlackCardBlock;
+/** Builds a 2026 Slack carousel block. */
+declare function buildCarouselBlock(elements: readonly SlackCardBlock[]): SlackCarouselBlock;
+/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */
+declare function buildDataTableBlock(rows: readonly (readonly SlackDataTableCell[])[]): SlackDataTableBlock;
+/** Builds the final note used when a surface block budget is exceeded. */
+declare function buildBlockBudgetNote(omitted: number): SlackContextBlock;
+//#endregion
+export { ACTIONS_ELEMENT_CAP, ACTION_ID_CAP, ALERT_TEXT_CAP, BUTTON_VALUE_CAP, CARD_ACTIONS_CAP, CARD_BODY_CAP, CARD_SUBTEXT_CAP, CARD_TITLE_CAP, CAROUSEL_CARD_CAP, CAROUSEL_CARD_MIN, CHILDREN_CAP, CONTEXT_ELEMENT_CAP, CONTEXT_TEXT_CAP, DATA_TABLE_CHAR_BUDGET, DATA_TABLE_COLUMN_CAP, DATA_TABLE_ROW_CAP, FACT_FIELD_CAP, FACT_FIELD_TEXT_CAP, HEADER_TEXT_CAP, INBOUND_BLOCK_CAP, INPUT_LABEL_CAP, INTERACTIVE_TEXT_CAP, MARKDOWN_TEXT_BUDGET, MAX_TRAVERSAL_DEPTH, MESSAGE_BLOCK_CAP, MODAL_BLOCK_CAP, NODE_BUDGET, PLACEHOLDER_TEXT_CAP, RADIO_OPTION_CAP, SECTION_TEXT_CAP, SELECT_OPTION_CAP, TABLE_CAPTION, buildAlertBlock, buildAlertFallback, buildBlockBudgetNote, buildCardBlock, buildCarouselBlock, buildDataTableBlock };
+//# sourceMappingURL=constants.d.ts.map

package/dist/slack/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/slack/constants.ts"],"mappings":";;;cAca;;;;;;;;cASA;;;;;;;;cASA;;cAGA;;cAGA;;;;;;cAOA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;;;;cAMA;;cAGA;;;;;cAMA;;cAGA;;cAGA;;iBAGG,mBACd,eACA,qBACA,4DACW,mBAAmB;;iBAmBhB,gBACd,cACA,kDACC;KAKE;WACM,YAAY;WACZ,QAAQ;WACR,WAAW;WACX,OAAO;WACP,UAAU;WACV,mBAAmB;;;iBAId,eAAe,QAAQ,kBAAkB;;iBAczC,mBACd,mBAAmB,mBAClB;;iBAKa,oBACd,yBAAyB,0BACxB;;iBAKa,qBAAqB,kBAAkB"}

package/dist/slack/constants.js

@@ -0,0 +1,162 @@
+//#region src/slack/constants.ts
+/** The maximum normalized traversal depth. */
+const MAX_TRAVERSAL_DEPTH = 64;
+/**
+* The maximum number of entries kept at any single level (root, or a
+* `children` array at any depth) of the raw spec, before it ever reaches
+* `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass
+* can never be made to walk further than this regardless of what the array
+* claims about itself.
+*/
+const CHILDREN_CAP = 200;
+/**
+* The total number of nodes the pre-normalization bounding walk will visit
+* across one call, regardless of how many times a shared reference recurs.
+* Bounds the combinatorial work a DAG of shared or self-referential nodes
+* would otherwise force even though each individual array stays within
+* {@link CHILDREN_CAP}.
+*/
+const NODE_BUDGET = 5e3;
+/** The block limit for a Slack message. */
+const MESSAGE_BLOCK_CAP = 50;
+/** The block limit for a Slack modal. */
+const MODAL_BLOCK_CAP = 100;
+/**
+* The maximum number of top-level blocks accepted when parsing Slack Block
+* Kit JSON back into generative UI, guarding against a hostile or malformed
+* payload.
+*/
+const INBOUND_BLOCK_CAP = 200;
+/** The character limit for header text. */
+const HEADER_TEXT_CAP = 150;
+/** The character limit for section text. */
+const SECTION_TEXT_CAP = 3e3;
+/** The maximum number of fields in one section. */
+const FACT_FIELD_CAP = 10;
+/** The character limit for one section field. */
+const FACT_FIELD_TEXT_CAP = 2e3;
+/** The character limit for button labels and option labels. */
+const INTERACTIVE_TEXT_CAP = 75;
+/** The character limit for an action_id. */
+const ACTION_ID_CAP = 255;
+/** The character limit for a button's serialized value payload. */
+const BUTTON_VALUE_CAP = 2e3;
+/** The maximum number of elements in one actions block. */
+const ACTIONS_ELEMENT_CAP = 25;
+/** The maximum number of options in a static select. */
+const SELECT_OPTION_CAP = 100;
+/** The maximum number of options in a radio-button group. */
+const RADIO_OPTION_CAP = 10;
+/** The character limit for a select or input placeholder. */
+const PLACEHOLDER_TEXT_CAP = 150;
+/** The character limit for an input's label. */
+const INPUT_LABEL_CAP = 2e3;
+/** The maximum number of elements in one context block. */
+const CONTEXT_ELEMENT_CAP = 10;
+/** The character limit for one context element's text. */
+const CONTEXT_TEXT_CAP = 3e3;
+/** The character limit for card titles and subtitles. */
+const CARD_TITLE_CAP = 150;
+/** The character limit for a card's body text. */
+const CARD_BODY_CAP = 200;
+/** The character limit for a card's subtext. */
+const CARD_SUBTEXT_CAP = 200;
+/** The maximum number of buttons in a card's actions. */
+const CARD_ACTIONS_CAP = 3;
+/** The minimum number of elements in a renderable carousel. */
+const CAROUSEL_CARD_MIN = 1;
+/** The maximum number of elements in a carousel. */
+const CAROUSEL_CARD_CAP = 10;
+/** The character limit for an alert's text. */
+const ALERT_TEXT_CAP = 200;
+/**
+* The maximum number of data rows in a data-table block; the emitted `rows`
+* array additionally carries one header row.
+*/
+const DATA_TABLE_ROW_CAP = 100;
+/** The maximum number of columns in a data-table block. */
+const DATA_TABLE_COLUMN_CAP = 20;
+/**
+* The cumulative character limit (summed across every cell's text) shared by
+* every data-table block in one payload.
+*/
+const DATA_TABLE_CHAR_BUDGET = 1e4;
+/** The caption emitted on every native data-table block. */
+const TABLE_CAPTION = "Table";
+/** The cumulative character limit for native markdown blocks. */
+const MARKDOWN_TEXT_BUDGET = 12e3;
+/** Builds the message-surface fallback for an alert. */
+function buildAlertFallback(title, description, tone) {
+	const emoji = {
+		info: "ℹ️",
+		success: "✅",
+		warning: "⚠️",
+		danger: "🛑"
+	}[tone];
+	return [{
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: title ? `${emoji} *${title}*` : emoji
+		}]
+	}, {
+		type: "section",
+		text: {
+			type: "mrkdwn",
+			text: description
+		}
+	}];
+}
+/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */
+function buildAlertBlock(text, tone) {
+	return {
+		type: "alert",
+		text: {
+			type: "mrkdwn",
+			text
+		},
+		level: tone === "danger" ? "error" : tone
+	};
+}
+/** Builds a 2026 Slack card block from its already-clamped fields. */
+function buildCardBlock(fields) {
+	const { heroImage, title, subtitle, body, subtext, actions } = fields;
+	return {
+		type: "card",
+		...heroImage !== void 0 ? { hero_image: heroImage } : {},
+		...title !== void 0 ? { title } : {},
+		...subtitle !== void 0 ? { subtitle } : {},
+		...body !== void 0 ? { body } : {},
+		...subtext !== void 0 ? { subtext } : {},
+		...actions !== void 0 ? { actions } : {}
+	};
+}
+/** Builds a 2026 Slack carousel block. */
+function buildCarouselBlock(elements) {
+	return {
+		type: "carousel",
+		elements
+	};
+}
+/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */
+function buildDataTableBlock(rows) {
+	return {
+		type: "data_table",
+		caption: TABLE_CAPTION,
+		rows
+	};
+}
+/** Builds the final note used when a surface block budget is exceeded. */
+function buildBlockBudgetNote(omitted) {
+	return {
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: `${omitted} ${omitted === 1 ? "block was" : "blocks were"} omitted.`
+		}]
+	};
+}
+//#endregion
+export { ACTIONS_ELEMENT_CAP, ACTION_ID_CAP, ALERT_TEXT_CAP, BUTTON_VALUE_CAP, CARD_ACTIONS_CAP, CARD_BODY_CAP, CARD_SUBTEXT_CAP, CARD_TITLE_CAP, CAROUSEL_CARD_CAP, CAROUSEL_CARD_MIN, CHILDREN_CAP, CONTEXT_ELEMENT_CAP, CONTEXT_TEXT_CAP, DATA_TABLE_CHAR_BUDGET, DATA_TABLE_COLUMN_CAP, DATA_TABLE_ROW_CAP, FACT_FIELD_CAP, FACT_FIELD_TEXT_CAP, HEADER_TEXT_CAP, INBOUND_BLOCK_CAP, INPUT_LABEL_CAP, INTERACTIVE_TEXT_CAP, MARKDOWN_TEXT_BUDGET, MAX_TRAVERSAL_DEPTH, MESSAGE_BLOCK_CAP, MODAL_BLOCK_CAP, NODE_BUDGET, PLACEHOLDER_TEXT_CAP, RADIO_OPTION_CAP, SECTION_TEXT_CAP, SELECT_OPTION_CAP, TABLE_CAPTION, buildAlertBlock, buildAlertFallback, buildBlockBudgetNote, buildCardBlock, buildCarouselBlock, buildDataTableBlock };
+
+//# sourceMappingURL=constants.js.map

package/dist/slack/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/slack/constants.ts"],"sourcesContent":["import type {\n  SlackAlertBlock,\n  SlackButtonElement,\n  SlackCardBlock,\n  SlackCarouselBlock,\n  SlackContextBlock,\n  SlackDataTableBlock,\n  SlackDataTableCell,\n  SlackImageBlock,\n  SlackSectionBlock,\n  SlackTextObject,\n} from \"./types\";\n\n/** The maximum normalized traversal depth. */\nexport const MAX_TRAVERSAL_DEPTH = 64;\n\n/**\n * The maximum number of entries kept at any single level (root, or a\n * `children` array at any depth) of the raw spec, before it ever reaches\n * `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass\n * can never be made to walk further than this regardless of what the array\n * claims about itself.\n */\nexport const CHILDREN_CAP = 200;\n\n/**\n * The total number of nodes the pre-normalization bounding walk will visit\n * across one call, regardless of how many times a shared reference recurs.\n * Bounds the combinatorial work a DAG of shared or self-referential nodes\n * would otherwise force even though each individual array stays within\n * {@link CHILDREN_CAP}.\n */\nexport const NODE_BUDGET = 5000;\n\n/** The block limit for a Slack message. */\nexport const MESSAGE_BLOCK_CAP = 50;\n\n/** The block limit for a Slack modal. */\nexport const MODAL_BLOCK_CAP = 100;\n\n/**\n * The maximum number of top-level blocks accepted when parsing Slack Block\n * Kit JSON back into generative UI, guarding against a hostile or malformed\n * payload.\n */\nexport const INBOUND_BLOCK_CAP = 200;\n\n/** The character limit for header text. */\nexport const HEADER_TEXT_CAP = 150;\n\n/** The character limit for section text. */\nexport const SECTION_TEXT_CAP = 3000;\n\n/** The maximum number of fields in one section. */\nexport const FACT_FIELD_CAP = 10;\n\n/** The character limit for one section field. */\nexport const FACT_FIELD_TEXT_CAP = 2000;\n\n/** The character limit for button labels and option labels. */\nexport const INTERACTIVE_TEXT_CAP = 75;\n\n/** The character limit for an action_id. */\nexport const ACTION_ID_CAP = 255;\n\n/** The character limit for a button's serialized value payload. */\nexport const BUTTON_VALUE_CAP = 2000;\n\n/** The maximum number of elements in one actions block. */\nexport const ACTIONS_ELEMENT_CAP = 25;\n\n/** The maximum number of options in a static select. */\nexport const SELECT_OPTION_CAP = 100;\n\n/** The maximum number of options in a radio-button group. */\nexport const RADIO_OPTION_CAP = 10;\n\n/** The character limit for a select or input placeholder. */\nexport const PLACEHOLDER_TEXT_CAP = 150;\n\n/** The character limit for an input's label. */\nexport const INPUT_LABEL_CAP = 2000;\n\n/** The maximum number of elements in one context block. */\nexport const CONTEXT_ELEMENT_CAP = 10;\n\n/** The character limit for one context element's text. */\nexport const CONTEXT_TEXT_CAP = 3000;\n\n/** The character limit for card titles and subtitles. */\nexport const CARD_TITLE_CAP = 150;\n\n/** The character limit for a card's body text. */\nexport const CARD_BODY_CAP = 200;\n\n/** The character limit for a card's subtext. */\nexport const CARD_SUBTEXT_CAP = 200;\n\n/** The maximum number of buttons in a card's actions. */\nexport const CARD_ACTIONS_CAP = 3;\n\n/** The minimum number of elements in a renderable carousel. */\nexport const CAROUSEL_CARD_MIN = 1;\n\n/** The maximum number of elements in a carousel. */\nexport const CAROUSEL_CARD_CAP = 10;\n\n/** The character limit for an alert's text. */\nexport const ALERT_TEXT_CAP = 200;\n\n/**\n * The maximum number of data rows in a data-table block; the emitted `rows`\n * array additionally carries one header row.\n */\nexport const DATA_TABLE_ROW_CAP = 100;\n\n/** The maximum number of columns in a data-table block. */\nexport const DATA_TABLE_COLUMN_CAP = 20;\n\n/**\n * The cumulative character limit (summed across every cell's text) shared by\n * every data-table block in one payload.\n */\nexport const DATA_TABLE_CHAR_BUDGET = 10000;\n\n/** The caption emitted on every native data-table block. */\nexport const TABLE_CAPTION = \"Table\";\n\n/** The cumulative character limit for native markdown blocks. */\nexport const MARKDOWN_TEXT_BUDGET = 12000;\n\n/** Builds the message-surface fallback for an alert. */\nexport function buildAlertFallback(\n  title: string,\n  description: string,\n  tone: \"info\" | \"success\" | \"warning\" | \"danger\",\n): readonly [SlackContextBlock, SlackSectionBlock] {\n  const emoji = {\n    info: \"ℹ️\",\n    success: \"✅\",\n    warning: \"⚠️\",\n    danger: \"🛑\",\n  }[tone];\n  return [\n    {\n      type: \"context\",\n      elements: [\n        { type: \"mrkdwn\", text: title ? `${emoji} *${title}*` : emoji },\n      ],\n    },\n    { type: \"section\", text: { type: \"mrkdwn\", text: description } },\n  ];\n}\n\n/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */\nexport function buildAlertBlock(\n  text: string,\n  tone: \"info\" | \"success\" | \"warning\" | \"danger\",\n): SlackAlertBlock {\n  const level = tone === \"danger\" ? \"error\" : tone;\n  return { type: \"alert\", text: { type: \"mrkdwn\", text }, level };\n}\n\ntype CardBlockFields = {\n  readonly heroImage?: SlackImageBlock;\n  readonly title?: SlackTextObject;\n  readonly subtitle?: SlackTextObject;\n  readonly body?: SlackTextObject;\n  readonly subtext?: SlackTextObject;\n  readonly actions?: readonly SlackButtonElement[];\n};\n\n/** Builds a 2026 Slack card block from its already-clamped fields. */\nexport function buildCardBlock(fields: CardBlockFields): SlackCardBlock {\n  const { heroImage, title, subtitle, body, subtext, actions } = fields;\n  return {\n    type: \"card\",\n    ...(heroImage !== undefined ? { hero_image: heroImage } : {}),\n    ...(title !== undefined ? { title } : {}),\n    ...(subtitle !== undefined ? { subtitle } : {}),\n    ...(body !== undefined ? { body } : {}),\n    ...(subtext !== undefined ? { subtext } : {}),\n    ...(actions !== undefined ? { actions } : {}),\n  };\n}\n\n/** Builds a 2026 Slack carousel block. */\nexport function buildCarouselBlock(\n  elements: readonly SlackCardBlock[],\n): SlackCarouselBlock {\n  return { type: \"carousel\", elements };\n}\n\n/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */\nexport function buildDataTableBlock(\n  rows: readonly (readonly SlackDataTableCell[])[],\n): SlackDataTableBlock {\n  return { type: \"data_table\", caption: TABLE_CAPTION, rows };\n}\n\n/** Builds the final note used when a surface block budget is exceeded. */\nexport function buildBlockBudgetNote(omitted: number): SlackContextBlock {\n  return {\n    type: \"context\",\n    elements: [\n      {\n        type: \"mrkdwn\",\n        text: `${omitted} ${omitted === 1 ? \"block was\" : \"blocks were\"} omitted.`,\n      },\n    ],\n  };\n}\n"],"mappings":";;AAcA,MAAa,sBAAsB;;;;;;;;AASnC,MAAa,eAAe;;;;;;;;AAS5B,MAAa,cAAc;;AAG3B,MAAa,oBAAoB;;AAGjC,MAAa,kBAAkB;;;;;;AAO/B,MAAa,oBAAoB;;AAGjC,MAAa,kBAAkB;;AAG/B,MAAa,mBAAmB;;AAGhC,MAAa,iBAAiB;;AAG9B,MAAa,sBAAsB;;AAGnC,MAAa,uBAAuB;;AAGpC,MAAa,gBAAgB;;AAG7B,MAAa,mBAAmB;;AAGhC,MAAa,sBAAsB;;AAGnC,MAAa,oBAAoB;;AAGjC,MAAa,mBAAmB;;AAGhC,MAAa,uBAAuB;;AAGpC,MAAa,kBAAkB;;AAG/B,MAAa,sBAAsB;;AAGnC,MAAa,mBAAmB;;AAGhC,MAAa,iBAAiB;;AAG9B,MAAa,gBAAgB;;AAG7B,MAAa,mBAAmB;;AAGhC,MAAa,mBAAmB;;AAGhC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB;;AAGjC,MAAa,iBAAiB;;;;;AAM9B,MAAa,qBAAqB;;AAGlC,MAAa,wBAAwB;;;;;AAMrC,MAAa,yBAAyB;;AAGtC,MAAa,gBAAgB;;AAG7B,MAAa,uBAAuB;;AAGpC,SAAgB,mBACd,OACA,aACA,MACiD;CACjD,MAAM,QAAQ;EACZ,MAAM;EACN,SAAS;EACT,SAAS;EACT,QAAQ;CACV,EAAE;CACF,OAAO,CACL;EACE,MAAM;EACN,UAAU,CACR;GAAE,MAAM;GAAU,MAAM,QAAQ,GAAG,MAAM,IAAI,MAAM,KAAK;EAAM,CAChE;CACF,GACA;EAAE,MAAM;EAAW,MAAM;GAAE,MAAM;GAAU,MAAM;EAAY;CAAE,CACjE;AACF;;AAGA,SAAgB,gBACd,MACA,MACiB;CAEjB,OAAO;EAAE,MAAM;EAAS,MAAM;GAAE,MAAM;GAAU;EAAK;EAAG,OAD1C,SAAS,WAAW,UAAU;CACkB;AAChE;;AAYA,SAAgB,eAAe,QAAyC;CACtE,MAAM,EAAE,WAAW,OAAO,UAAU,MAAM,SAAS,YAAY;CAC/D,OAAO;EACL,MAAM;EACN,GAAI,cAAc,KAAA,IAAY,EAAE,YAAY,UAAU,IAAI,CAAC;EAC3D,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;EACvC,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC7C,GAAI,SAAS,KAAA,IAAY,EAAE,KAAK,IAAI,CAAC;EACrC,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;EAC3C,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;CAC7C;AACF;;AAGA,SAAgB,mBACd,UACoB;CACpB,OAAO;EAAE,MAAM;EAAY;CAAS;AACtC;;AAGA,SAAgB,oBACd,MACqB;CACrB,OAAO;EAAE,MAAM;EAAc,SAAS;EAAe;CAAK;AAC5D;;AAGA,SAAgB,qBAAqB,SAAoC;CACvE,OAAO;EACL,MAAM;EACN,UAAU,CACR;GACE,MAAM;GACN,MAAM,GAAG,QAAQ,GAAG,YAAY,IAAI,cAAc,cAAc;EAClE,CACF;CACF;AACF"}

package/dist/slack/decodeBlockAction.d.ts

@@ -0,0 +1,11 @@
+import { Action } from "../ir.js";
+//#region src/slack/decodeBlockAction.d.ts
+/**
+ * Decodes one structural entry from a Slack `block_actions` payload.
+ * `$input` is reserved for the runtime selection: a `$input` key inside the
+ * button's JSON `value` payload is dropped rather than spread into the result.
+ */
+declare function decodeBlockAction(action: unknown): Action | undefined;
+//#endregion
+export { decodeBlockAction };
+//# sourceMappingURL=decodeBlockAction.d.ts.map

package/dist/slack/decodeBlockAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeBlockAction.d.ts","names":[],"sources":["../../src/slack/decodeBlockAction.ts"],"mappings":";;;;;;;iBAegB,kBAAkB,kBAAkB"}

package/dist/slack/decodeBlockAction.js

@@ -0,0 +1,40 @@
+//#region src/slack/decodeBlockAction.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const optionValue = (value) => isRecord(value) && typeof value["value"] === "string" ? value["value"] : void 0;
+/**
+* Decodes one structural entry from a Slack `block_actions` payload.
+* `$input` is reserved for the runtime selection: a `$input` key inside the
+* button's JSON `value` payload is dropped rather than spread into the result.
+*/
+function decodeBlockAction(action) {
+	try {
+		if (!isRecord(action) || typeof action["action_id"] !== "string") return;
+		const actionId = action["action_id"];
+		if (!actionId) return void 0;
+		const rawValue = action["value"];
+		let payload = {};
+		let plainValue;
+		if (typeof rawValue === "string") try {
+			const parsed = JSON.parse(rawValue);
+			if (isRecord(parsed)) payload = parsed;
+			else plainValue = rawValue;
+		} catch {
+			plainValue = rawValue;
+		}
+		const selectedOption = optionValue(action["selected_option"]);
+		const selectedDate = typeof action["selected_date"] === "string" ? action["selected_date"] : void 0;
+		const selectedOptions = Array.isArray(action["selected_options"]) ? action["selected_options"].map(optionValue).filter((value) => value !== void 0) : void 0;
+		const input = selectedOption ?? selectedDate ?? (selectedOptions !== void 0 ? selectedOptions : plainValue);
+		return {
+			...Object.fromEntries(Object.entries(payload).filter(([key]) => key !== "$input")),
+			type: actionId,
+			...input !== void 0 ? { $input: input } : {}
+		};
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { decodeBlockAction };
+
+//# sourceMappingURL=decodeBlockAction.js.map

package/dist/slack/decodeBlockAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeBlockAction.js","names":[],"sources":["../../src/slack/decodeBlockAction.ts"],"sourcesContent":["import type { Action } from \"../ir\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst optionValue = (value: unknown): string | undefined =>\n  isRecord(value) && typeof value[\"value\"] === \"string\"\n    ? value[\"value\"]\n    : undefined;\n\n/**\n * Decodes one structural entry from a Slack `block_actions` payload.\n * `$input` is reserved for the runtime selection: a `$input` key inside the\n * button's JSON `value` payload is dropped rather than spread into the result.\n */\nexport function decodeBlockAction(action: unknown): Action | undefined {\n  try {\n    if (!isRecord(action) || typeof action[\"action_id\"] !== \"string\") {\n      return undefined;\n    }\n\n    const actionId = action[\"action_id\"];\n    if (!actionId) return undefined;\n\n    const rawValue = action[\"value\"];\n    let payload: Record<string, unknown> = {};\n    let plainValue: string | undefined;\n    if (typeof rawValue === \"string\") {\n      try {\n        const parsed: unknown = JSON.parse(rawValue);\n        if (isRecord(parsed)) {\n          payload = parsed;\n        } else {\n          plainValue = rawValue;\n        }\n      } catch {\n        plainValue = rawValue;\n      }\n    }\n\n    const selectedOption = optionValue(action[\"selected_option\"]);\n    const selectedDate =\n      typeof action[\"selected_date\"] === \"string\"\n        ? action[\"selected_date\"]\n        : undefined;\n    const selectedOptions = Array.isArray(action[\"selected_options\"])\n      ? action[\"selected_options\"]\n          .map(optionValue)\n          .filter((value): value is string => value !== undefined)\n      : undefined;\n    const input =\n      selectedOption ??\n      selectedDate ??\n      (selectedOptions !== undefined ? selectedOptions : plainValue);\n\n    return {\n      ...Object.fromEntries(\n        Object.entries(payload).filter(([key]) => key !== \"$input\"),\n      ),\n      type: actionId,\n      ...(input !== undefined ? { $input: input } : {}),\n    };\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";AAEA,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,MAAM,eAAe,UACnB,SAAS,KAAK,KAAK,OAAO,MAAM,aAAa,WACzC,MAAM,WACN,KAAA;;;;;;AAON,SAAgB,kBAAkB,QAAqC;CACrE,IAAI;EACF,IAAI,CAAC,SAAS,MAAM,KAAK,OAAO,OAAO,iBAAiB,UACtD;EAGF,MAAM,WAAW,OAAO;EACxB,IAAI,CAAC,UAAU,OAAO,KAAA;EAEtB,MAAM,WAAW,OAAO;EACxB,IAAI,UAAmC,CAAC;EACxC,IAAI;EACJ,IAAI,OAAO,aAAa,UACtB,IAAI;GACF,MAAM,SAAkB,KAAK,MAAM,QAAQ;GAC3C,IAAI,SAAS,MAAM,GACjB,UAAU;QAEV,aAAa;EAEjB,QAAQ;GACN,aAAa;EACf;EAGF,MAAM,iBAAiB,YAAY,OAAO,kBAAkB;EAC5D,MAAM,eACJ,OAAO,OAAO,qBAAqB,WAC/B,OAAO,mBACP,KAAA;EACN,MAAM,kBAAkB,MAAM,QAAQ,OAAO,mBAAmB,IAC5D,OAAO,mBAAmB,CACvB,IAAI,WAAW,CAAC,CAChB,QAAQ,UAA2B,UAAU,KAAA,CAAS,IACzD,KAAA;EACJ,MAAM,QACJ,kBACA,iBACC,oBAAoB,KAAA,IAAY,kBAAkB;EAErD,OAAO;GACL,GAAG,OAAO,YACR,OAAO,QAAQ,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,QAAQ,QAAQ,CAC5D;GACA,MAAM;GACN,GAAI,UAAU,KAAA,IAAY,EAAE,QAAQ,MAAM,IAAI,CAAC;EACjD;CACF,QAAQ;EACN;CACF;AACF"}

package/dist/slack/fromSlackBlocks.d.ts

@@ -0,0 +1,30 @@
+import { FromSlackBlocksResult } from "./types.js";
+//#region src/slack/fromSlackBlocks.d.ts
+/**
+ * Converts Slack Block Kit JSON back into a generative-ui IR tree, inverting
+ * {@link toSlackBlocks}. Accepts a blocks array or a `{ blocks }` wrapper;
+ * malformed input resolves to an empty node list plus a warning, and an
+ * unrecognized block or action element is skipped with a "dropped" warning.
+ * Every array read along the way (blocks, fields, options, elements, cards,
+ * rows, cells) is bounded to its site's cap before it is mapped over, so a
+ * hostile array (sparse or proxied with a fabricated `length`) is clamped
+ * with a "clamped" warning instead of stalling the event loop. Never throws.
+ *
+ * The Slack shape is lossier than the IR, so some information cannot be
+ * recovered: a context block's elements always decode as `Caption` (the
+ * original `Badge` vs `Caption` distinction does not survive the round trip),
+ * a button's `buttonStyle` is only recovered for the `primary`/`danger` Slack
+ * styles, a native alert block's `title` and `description` merge into a
+ * single `description` string, and a card's layout collapses to its `title`,
+ * a flat `children` list (image, then text, then caption, in that order),
+ * and `confirm`/`cancel` footer buttons. A section field's label and value
+ * are split on the first `*`+newline delimiter, so a label or value that
+ * itself contains that exact delimiter cannot be split back unambiguously.
+ * A data-table cell that Slack carries as `raw_text` always decodes as a
+ * string, even when its text is the stringified form of a boolean, since the
+ * Slack shape does not distinguish a boolean from ordinary text.
+ */
+declare function fromSlackBlocks(blocks: unknown): FromSlackBlocksResult;
+//#endregion
+export { fromSlackBlocks };
+//# sourceMappingURL=fromSlackBlocks.d.ts.map

package/dist/slack/fromSlackBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromSlackBlocks.d.ts","names":[],"sources":["../../src/slack/fromSlackBlocks.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;iBA+pBgB,gBAAgB,kBAAkB"}