@k2b/ui 0.17.0 → 0.19.0

package/dist/ssr/chat/chat-behavior.js

@@ -45,4 +45,13 @@ export const executeChatAction = async action => {
   }
   await action.onSelect();
 };
+/**
+ * What Enter does in a conversation composer: Ctrl/⌘+Enter always sends; Shift+Enter, Enter inside an open code
+ * block, and Enter on a touch-only device break the line; otherwise `sendKey` decides. IME input is the caller's check.
+ */
+export const conversationEnterAction = (key, context) => {
+  if (key.ctrlKey || key.metaKey) return "send";
+  if (key.shiftKey || key.altKey || context.touchOnly || context.inCodeBlock || context.sendKey === "mod-enter") return "newline";
+  return "send";
+};
 //# sourceMappingURL=chat-behavior.js.map

package/dist/ssr/chat/chat-behavior.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["chat/chat-behavior.ts"],"sourcesContent":["import type { ChatAction } from \"./types\";\n\nexport const nextChatCommandIndex = (index: number, length: number, direction: 1 | -1): number =>\n  length <= 0 ? 0 : (index + direction + length) % length;\n\nexport const isChatNearBottom = (scrollHeight: number, scrollTop: number, clientHeight: number, threshold = 96): boolean =>\n  scrollHeight - scrollTop - clientHeight <= threshold;\n\nexport const restoredChatScrollTop = (previousScrollTop: number, previousScrollHeight: number, nextScrollHeight: number): number =>\n  Math.max(0, previousScrollTop + nextScrollHeight - previousScrollHeight);\n\nexport type ChatSubmissionRun = {\n  /** Clears the controlled draft (and attachments) before the handler runs. */\n  clear: () => void;\n  /**\n   * The application handler. A synchronous throw, a rejected promise, and a\n   * `false` result all count as a rejected submission.\n   */\n  perform: () => boolean | void | Promise<boolean | void>;\n  /** Restores the cleared draft (and attachments) after a rejected submission. */\n  restore: () => void;\n  onError?: (error: unknown) => void;\n};\n\n/**\n * Runs one composer submission with optimistic clearing. Resolves to `true`\n * when the handler accepted the submission. A synchronous throw is handled\n * exactly like a rejected promise so a controlled draft is never lost.\n */\nexport const runChatSubmission = async (run: ChatSubmissionRun): Promise<boolean> => {\n  run.clear();\n  try {\n    if ((await run.perform()) === false) {\n      run.restore();\n      return false;\n    }\n    return true;\n  } catch (error) {\n    run.onError?.(error);\n    run.restore();\n    return false;\n  }\n};\n\n/** Reports a handler failure without letting a synchronous throw escape. */\nexport const reportChatFailure = (perform: () => unknown, onError?: (error: unknown) => void): void => {\n  try {\n    const result = perform();\n    if (result instanceof Promise) void result.catch((error) => onError?.(error));\n  } catch (error) {\n    onError?.(error);\n  }\n};\n\nconst writeChatClipboard = async (value: string): Promise<void> => {\n  if (typeof navigator === \"undefined\" || !navigator.clipboard?.writeText) {\n    throw new Error(\"Clipboard access is unavailable.\");\n  }\n  await navigator.clipboard.writeText(value);\n};\n\n/** Executes the one behavior guaranteed by the ChatAction contract. */\nexport const executeChatAction = async (action: ChatAction): Promise<void> => {\n  if (typeof action.copyText === \"string\") {\n    await writeChatClipboard(action.copyText);\n    return;\n  }\n  await action.onSelect();\n};\n"],"mappings":"AAEA,OAAO,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,MAAc,EAAE,SAAiB,KACnF,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,IAAI,MAAM;AAEzD,OAAO,MAAM,gBAAgB,GAAG,CAAC,YAAoB,EAAE,SAAiB,EAAE,YAAoB,EAAE,SAAS,GAAG,EAAE,KAC5G,YAAY,GAAG,SAAS,GAAG,YAAY,IAAI,SAAS;AAEtD,OAAO,MAAM,qBAAqB,GAAG,CAAC,iBAAyB,EAAE,oBAA4B,EAAE,gBAAwB,KACrH,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAe1E;AACA;AACA;AACA;AACA;AACA,OAAO,MAAM,iBAAiB,GAAG,MAAO,GAAsB,IAAuB;EACnF,GAAG,CAAC,KAAK,CAAC,CAAC;EACX,IAAI;IACF,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,EAAE;MACnC,GAAG,CAAC,OAAO,CAAC,CAAC;MACb,OAAO,KAAK;IACd;IACA,OAAO,IAAI;EACb,CAAC,CAAC,OAAO,KAAK,EAAE;IACd,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACpB,GAAG,CAAC,OAAO,CAAC,CAAC;IACb,OAAO,KAAK;EACd;AACF,CAAC;;AAED;AACA,OAAO,MAAM,iBAAiB,GAAG,CAAC,OAAsB,EAAE,OAAkC,KAAW;EACrG,IAAI;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC;IACxB,IAAI,MAAM,YAAY,OAAO,EAAE,KAAK,MAAM,CAAC,KAAK,CAAE,KAAK,IAAK,OAAO,GAAG,KAAK,CAAC,CAAC;EAC/E,CAAC,CAAC,OAAO,KAAK,EAAE;IACd,OAAO,GAAG,KAAK,CAAC;EAClB;AACF,CAAC;AAED,MAAM,kBAAkB,GAAG,MAAO,KAAa,IAAoB;EACjE,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE;IACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC;EACrD;EACA,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;AAC5C,CAAC;;AAED;AACA,OAAO,MAAM,iBAAiB,GAAG,MAAO,MAAkB,IAAoB;EAC5E,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE;IACvC,MAAM,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;IACzC;EACF;EACA,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC","ignoreList":[]}
+{"version":3,"names":[],"sources":["chat/chat-behavior.ts"],"sourcesContent":["import type { ChatAction } from \"./types\";\n\nexport const nextChatCommandIndex = (index: number, length: number, direction: 1 | -1): number =>\n  length <= 0 ? 0 : (index + direction + length) % length;\n\nexport const isChatNearBottom = (scrollHeight: number, scrollTop: number, clientHeight: number, threshold = 96): boolean =>\n  scrollHeight - scrollTop - clientHeight <= threshold;\n\nexport const restoredChatScrollTop = (previousScrollTop: number, previousScrollHeight: number, nextScrollHeight: number): number =>\n  Math.max(0, previousScrollTop + nextScrollHeight - previousScrollHeight);\n\nexport type ChatSubmissionRun = {\n  /** Clears the controlled draft (and attachments) before the handler runs. */\n  clear: () => void;\n  /**\n   * The application handler. A synchronous throw, a rejected promise, and a\n   * `false` result all count as a rejected submission.\n   */\n  perform: () => boolean | void | Promise<boolean | void>;\n  /** Restores the cleared draft (and attachments) after a rejected submission. */\n  restore: () => void;\n  onError?: (error: unknown) => void;\n};\n\n/**\n * Runs one composer submission with optimistic clearing. Resolves to `true`\n * when the handler accepted the submission. A synchronous throw is handled\n * exactly like a rejected promise so a controlled draft is never lost.\n */\nexport const runChatSubmission = async (run: ChatSubmissionRun): Promise<boolean> => {\n  run.clear();\n  try {\n    if ((await run.perform()) === false) {\n      run.restore();\n      return false;\n    }\n    return true;\n  } catch (error) {\n    run.onError?.(error);\n    run.restore();\n    return false;\n  }\n};\n\n/** Reports a handler failure without letting a synchronous throw escape. */\nexport const reportChatFailure = (perform: () => unknown, onError?: (error: unknown) => void): void => {\n  try {\n    const result = perform();\n    if (result instanceof Promise) void result.catch((error) => onError?.(error));\n  } catch (error) {\n    onError?.(error);\n  }\n};\n\nconst writeChatClipboard = async (value: string): Promise<void> => {\n  if (typeof navigator === \"undefined\" || !navigator.clipboard?.writeText) {\n    throw new Error(\"Clipboard access is unavailable.\");\n  }\n  await navigator.clipboard.writeText(value);\n};\n\n/** Executes the one behavior guaranteed by the ChatAction contract. */\nexport const executeChatAction = async (action: ChatAction): Promise<void> => {\n  if (typeof action.copyText === \"string\") {\n    await writeChatClipboard(action.copyText);\n    return;\n  }\n  await action.onSelect();\n};\n\nexport type ChatEnterKey = { shiftKey: boolean; ctrlKey: boolean; metaKey: boolean; altKey: boolean };\n\n/**\n * What Enter does in a conversation composer: Ctrl/⌘+Enter always sends; Shift+Enter, Enter inside an open code\n * block, and Enter on a touch-only device break the line; otherwise `sendKey` decides. IME input is the caller's check.\n */\nexport const conversationEnterAction = (\n  key: ChatEnterKey,\n  context: { sendKey: \"enter\" | \"mod-enter\"; touchOnly: boolean; inCodeBlock: boolean },\n): \"send\" | \"newline\" => {\n  if (key.ctrlKey || key.metaKey) return \"send\";\n  if (key.shiftKey || key.altKey || context.touchOnly || context.inCodeBlock || context.sendKey === \"mod-enter\") return \"newline\";\n  return \"send\";\n};\n"],"mappings":"AAEA,OAAO,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,MAAc,EAAE,SAAiB,KACnF,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,IAAI,MAAM;AAEzD,OAAO,MAAM,gBAAgB,GAAG,CAAC,YAAoB,EAAE,SAAiB,EAAE,YAAoB,EAAE,SAAS,GAAG,EAAE,KAC5G,YAAY,GAAG,SAAS,GAAG,YAAY,IAAI,SAAS;AAEtD,OAAO,MAAM,qBAAqB,GAAG,CAAC,iBAAyB,EAAE,oBAA4B,EAAE,gBAAwB,KACrH,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAe1E;AACA;AACA;AACA;AACA;AACA,OAAO,MAAM,iBAAiB,GAAG,MAAO,GAAsB,IAAuB;EACnF,GAAG,CAAC,KAAK,CAAC,CAAC;EACX,IAAI;IACF,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,EAAE;MACnC,GAAG,CAAC,OAAO,CAAC,CAAC;MACb,OAAO,KAAK;IACd;IACA,OAAO,IAAI;EACb,CAAC,CAAC,OAAO,KAAK,EAAE;IACd,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACpB,GAAG,CAAC,OAAO,CAAC,CAAC;IACb,OAAO,KAAK;EACd;AACF,CAAC;;AAED;AACA,OAAO,MAAM,iBAAiB,GAAG,CAAC,OAAsB,EAAE,OAAkC,KAAW;EACrG,IAAI;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC;IACxB,IAAI,MAAM,YAAY,OAAO,EAAE,KAAK,MAAM,CAAC,KAAK,CAAE,KAAK,IAAK,OAAO,GAAG,KAAK,CAAC,CAAC;EAC/E,CAAC,CAAC,OAAO,KAAK,EAAE;IACd,OAAO,GAAG,KAAK,CAAC;EAClB;AACF,CAAC;AAED,MAAM,kBAAkB,GAAG,MAAO,KAAa,IAAoB;EACjE,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE;IACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC;EACrD;EACA,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;AAC5C,CAAC;;AAED;AACA,OAAO,MAAM,iBAAiB,GAAG,MAAO,MAAkB,IAAoB;EAC5E,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE;IACvC,MAAM,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;IACzC;EACF;EACA,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAID;AACA;AACA;AACA;AACA,OAAO,MAAM,uBAAuB,GAAG,CACrC,GAAiB,EACjB,OAAqF,KAC9D;EACvB,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,MAAM;EAC7C,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,OAAO,SAAS;EAC/H,OAAO,MAAM;AACf,CAAC","ignoreList":[]}

package/dist/ssr/chat/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["chat/index.ts"],"sourcesContent":["export type { ChatContextPanelProps, ChatContextPopupProps } from \"./ChatContextPopup\";\n\nimport { ChatContextPanel, ChatContextPopup } from \"./ChatContextPopup\";\nimport { ChatTasks } from \"./ChatTasks\";\n\nexport type { ChatTask, ChatTasksProps } from \"./ChatTasks\";\n\nimport { ChatComposer } from \"./ChatComposer\";\nimport { ChatActivity, ChatContextUsage, ChatMessage } from \"./ChatPrimitives\";\nimport { ChatRoot } from \"./ChatRoot\";\nimport { ChatTimeline } from \"./ChatTimeline\";\n\nexport type { ChatCommand, ChatCommandContext, ChatComposerProps, ChatFileSelection, ChatPasteHandler } from \"./ChatComposer\";\nexport type { ChatActivityProps, ChatContextUsageProps, ChatMessageProps } from \"./ChatPrimitives\";\nexport { formatChatTokens } from \"./ChatPrimitives\";\nexport type { ChatRootProps } from \"./ChatRoot\";\nexport type { ChatActivityItem, ChatMessageItem, ChatTimelineItem, ChatTimelineProps } from \"./ChatTimeline\";\nexport type {\n  ChatAction,\n  ChatActivityTone,\n  ChatAttachment,\n  ChatComposerState,\n  ChatContextUsageData,\n  ChatMention,\n  ChatMessageStatus,\n  ChatModelOption,\n  ChatRole,\n  ChatSubmitInput,\n  ChatSubmitIntent,\n  ChatUsage,\n} from \"./types\";\n\n/**\n * Portable, controlled chat surface. Applications own storage, streaming,\n * authorization, rich message rendering, and domain actions.\n */\nexport const Chat = Object.assign(ChatRoot, {\n  Tasks: ChatTasks,\n  Timeline: ChatTimeline,\n  Message: ChatMessage,\n  Activity: ChatActivity,\n  Composer: ChatComposer,\n  ContextUsage: ChatContextUsage,\n  ContextPopup: ChatContextPopup,\n  ContextPanel: ChatContextPanel,\n});\n\nexport { reconcileChatMentions } from \"./composer-document\";\n"],"mappings":"AAEA,SAAS,gBAAgB,EAAE,gBAAgB,QAAQ,oBAAoB;AACvE,SAAS,SAAS,QAAQ,aAAa;AAIvC,SAAS,YAAY,QAAQ,gBAAgB;AAC7C,SAAS,YAAY,EAAE,gBAAgB,EAAE,WAAW,QAAQ,kBAAkB;AAC9E,SAAS,QAAQ,QAAQ,YAAY;AACrC,SAAS,YAAY,QAAQ,gBAAgB;AAI7C,SAAS,gBAAgB,QAAQ,kBAAkB;AAkBnD;AACA;AACA;AACA;AACA,OAAO,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;EAC1C,KAAK,EAAE,SAAS;EAChB,QAAQ,EAAE,YAAY;EACtB,OAAO,EAAE,WAAW;EACpB,QAAQ,EAAE,YAAY;EACtB,QAAQ,EAAE,YAAY;EACtB,YAAY,EAAE,gBAAgB;EAC9B,YAAY,EAAE,gBAAgB;EAC9B,YAAY,EAAE;AAChB,CAAC,CAAC;AAEF,SAAS,qBAAqB,QAAQ,qBAAqB","ignoreList":[]}
+{"version":3,"names":[],"sources":["chat/index.ts"],"sourcesContent":["export type { ChatContextPanelProps, ChatContextPopupProps } from \"./ChatContextPopup\";\n\nimport { ChatContextPanel, ChatContextPopup } from \"./ChatContextPopup\";\nimport { ChatTasks } from \"./ChatTasks\";\n\nexport type { ChatTask, ChatTasksProps } from \"./ChatTasks\";\n\nimport { ChatComposer } from \"./ChatComposer\";\nimport { ChatActivity, ChatContextUsage, ChatMessage } from \"./ChatPrimitives\";\nimport { ChatRoot } from \"./ChatRoot\";\nimport { ChatTimeline } from \"./ChatTimeline\";\n\nexport type { ChatCommand, ChatCommandContext, ChatComposerProps, ChatFileSelection, ChatPasteHandler } from \"./ChatComposer\";\nexport type { ChatActivityProps, ChatContextUsageProps, ChatMessageProps } from \"./ChatPrimitives\";\nexport { formatChatTokens } from \"./ChatPrimitives\";\nexport type { ChatRootProps } from \"./ChatRoot\";\nexport type { ChatActivityItem, ChatMessageItem, ChatTimelineItem, ChatTimelineProps } from \"./ChatTimeline\";\nexport type {\n  ChatAction,\n  ChatActivityTone,\n  ChatAttachment,\n  ChatComposerEmoji,\n  ChatComposerMicrophone,\n  ChatComposerState,\n  ChatContextUsageData,\n  ChatDictationState,\n  ChatMention,\n  ChatMessageStatus,\n  ChatModelOption,\n  ChatRole,\n  ChatSubmitInput,\n  ChatSubmitIntent,\n  ChatUsage,\n} from \"./types\";\n\n/**\n * Portable, controlled chat surface. Applications own storage, streaming,\n * authorization, rich message rendering, and domain actions.\n */\nexport const Chat = Object.assign(ChatRoot, {\n  Tasks: ChatTasks,\n  Timeline: ChatTimeline,\n  Message: ChatMessage,\n  Activity: ChatActivity,\n  Composer: ChatComposer,\n  ContextUsage: ChatContextUsage,\n  ContextPopup: ChatContextPopup,\n  ContextPanel: ChatContextPanel,\n});\n\nexport { reconcileChatMentions } from \"./composer-document\";\n"],"mappings":"AAEA,SAAS,gBAAgB,EAAE,gBAAgB,QAAQ,oBAAoB;AACvE,SAAS,SAAS,QAAQ,aAAa;AAIvC,SAAS,YAAY,QAAQ,gBAAgB;AAC7C,SAAS,YAAY,EAAE,gBAAgB,EAAE,WAAW,QAAQ,kBAAkB;AAC9E,SAAS,QAAQ,QAAQ,YAAY;AACrC,SAAS,YAAY,QAAQ,gBAAgB;AAI7C,SAAS,gBAAgB,QAAQ,kBAAkB;AAqBnD;AACA;AACA;AACA;AACA,OAAO,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;EAC1C,KAAK,EAAE,SAAS;EAChB,QAAQ,EAAE,YAAY;EACtB,OAAO,EAAE,WAAW;EACpB,QAAQ,EAAE,YAAY;EACtB,QAAQ,EAAE,YAAY;EACtB,YAAY,EAAE,gBAAgB;EAC9B,YAAY,EAAE,gBAAgB;EAC9B,YAAY,EAAE;AAChB,CAAC,CAAC;AAEF,SAAS,qBAAqB,QAAQ,qBAAqB","ignoreList":[]}

package/dist/ssr/chat/types.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["chat/types.ts"],"sourcesContent":["export type ChatRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\nexport type ChatMessageStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\";\n\nexport type ChatActivityTone = \"neutral\" | \"ai\" | \"success\" | \"danger\";\n\ntype ChatActionBase = {\n  id: string;\n  label: string;\n  icon?: string;\n  variant?: \"danger\";\n  disabled?: boolean;\n  /** Toggle state for persistent message actions such as feedback. */\n  pressed?: boolean;\n  /** Semantic foreground for selected feedback actions, without a persistent background. */\n  pressedTone?: \"success\" | \"danger\";\n};\n\n/** Exactly one executable behavior for every chat action. */\nexport type ChatAction = ChatActionBase &\n  ({ onSelect: () => void | Promise<void>; copyText?: never } | { copyText: string; onSelect?: never });\n\nexport type ChatAttachment = {\n  id: string;\n  name: string;\n  size?: number;\n  kind?: \"file\" | \"image\" | \"resource\";\n  icon?: string;\n  previewUrl?: string;\n  alt?: string;\n  /** Optional destination represented by this attachment. */\n  href?: string;\n  /** Opaque application-owned payload returned unchanged with ChatSubmitInput. */\n  data?: unknown;\n  /** Optional application-owned action presented below the attachment label. */\n  action?: ChatAction;\n};\n\nexport type ChatUsage = {\n  input?: number;\n  output?: number;\n  total?: number;\n};\n\nexport type ChatContextUsageData = {\n  usage?: ChatUsage | null;\n  loopUsage?: ChatUsage | null;\n  contextWindow?: number;\n  modelLabel?: string;\n};\n\nexport type ChatModelOption = {\n  id: string;\n  label: string;\n  description?: string;\n  image?: string;\n  icon?: string;\n  capabilities?: readonly string[];\n};\n\nexport type ChatComposerState = \"idle\" | \"submitting\" | \"running\" | \"stopping\";\n\nexport type ChatSubmitIntent = \"send\" | \"steer\" | \"queue\";\n\nexport type ChatSubmitInput = {\n  intent: ChatSubmitIntent;\n  text: string;\n  attachments: readonly ChatAttachment[];\n  mentions?: readonly ChatMention[];\n};\n\n/** Ranges use UTF-16 offsets into the untrimmed composer text. Payloads stay application-owned. */\nexport type ChatMention = { start: number; end: number; attachment: ChatAttachment };\n"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sources":["chat/types.ts"],"sourcesContent":["import type { EmojiSkinTone } from \"../inputs/emoji/emoji-index\";\n\nexport type ChatRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\nexport type ChatMessageStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\";\n\nexport type ChatActivityTone = \"neutral\" | \"ai\" | \"success\" | \"danger\";\n\ntype ChatActionBase = {\n  id: string;\n  label: string;\n  icon?: string;\n  variant?: \"danger\";\n  disabled?: boolean;\n  /** Toggle state for persistent message actions such as feedback. */\n  pressed?: boolean;\n  /** Semantic foreground for selected feedback actions, without a persistent background. */\n  pressedTone?: \"success\" | \"danger\";\n};\n\n/** Exactly one executable behavior for every chat action. */\nexport type ChatAction = ChatActionBase &\n  ({ onSelect: () => void | Promise<void>; copyText?: never } | { copyText: string; onSelect?: never });\n\nexport type ChatAttachment = {\n  id: string;\n  name: string;\n  size?: number;\n  kind?: \"file\" | \"image\" | \"resource\";\n  icon?: string;\n  previewUrl?: string;\n  alt?: string;\n  /** Optional destination represented by this attachment. */\n  href?: string;\n  /** Opaque application-owned payload returned unchanged with ChatSubmitInput. */\n  data?: unknown;\n  /** Optional application-owned action presented below the attachment label. */\n  action?: ChatAction;\n};\n\nexport type ChatUsage = {\n  input?: number;\n  output?: number;\n  total?: number;\n};\n\nexport type ChatContextUsageData = {\n  usage?: ChatUsage | null;\n  loopUsage?: ChatUsage | null;\n  contextWindow?: number;\n  modelLabel?: string;\n};\n\nexport type ChatModelOption = {\n  id: string;\n  label: string;\n  description?: string;\n  image?: string;\n  icon?: string;\n  capabilities?: readonly string[];\n};\n\nexport type ChatComposerState = \"idle\" | \"submitting\" | \"running\" | \"stopping\";\n\nexport type ChatSubmitIntent = \"send\" | \"steer\" | \"queue\";\n\nexport type ChatSubmitInput = {\n  intent: ChatSubmitIntent;\n  text: string;\n  attachments: readonly ChatAttachment[];\n  mentions?: readonly ChatMention[];\n};\n\n/** Ranges use UTF-16 offsets into the untrimmed composer text. Payloads stay application-owned. */\nexport type ChatMention = { start: number; end: number; attachment: ChatAttachment };\n\n/**\n * Live dictation as the caller runs it: `listening` while speech arrives, `refining` after the stop until the refined\n * text replaced it, `refined` afterwards, `unrefined` when the raw text stays, and `interrupted` when the connection\n * ended early and the text so far stays.\n */\nexport type ChatDictationState = \"listening\" | \"refining\" | \"refined\" | \"unrefined\" | \"interrupted\";\n\n/** The composer's microphone. Dictation comes first; a voice message is the deliberate second action. */\nexport type ChatComposerMicrophone = {\n  /** A tap starts or stops live dictation. Without it, a tap opens the microphone menu. */\n  onDictate?: () => void;\n  /** Holding the microphone, or \"Record voice message\" in its menu. Omit it where recording is not available. */\n  onVoiceMessage?: () => void;\n  /** The dictation state, shown on the microphone and in the hint line. */\n  dictation?: ChatDictationState | null;\n  /** Offered as \"Restore original\" while `dictation` is `refined`. */\n  onRestoreOriginal?: () => void;\n  disabled?: boolean;\n};\n\n/**\n * The composer's emoji button and `:shortcode` completion. Typing a colon and two letters suggests emoji by their\n * English or German name or GitHub shortcode; a complete `:thumbsup:` becomes 👍 when its closing colon is typed.\n */\nexport type ChatComposerEmoji = {\n  /** Opens the emoji choice next to `anchor`, usually `EmojiPicker.Popover`; `insert` puts the chosen text at the caret. */\n  onOpen: (context: { anchor: HTMLElement; insert: (text: string) => void }) => void;\n  /** The skin tone of completed emoji that have one, as in the picker. */\n  skinTone?: EmojiSkinTone;\n  /** Called with each emoji the completion inserted, for example to remember it with `rememberEmoji`. */\n  onPick?: (emoji: string) => void;\n};\n"],"mappings":"","ignoreList":[]}