@k2b/ui 0.1.0-rc.0

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

@@ -0,0 +1,53 @@
+export const filterChatCommands = (value, commands) => {
+  if (!value.startsWith("/") || /\s/.test(value)) return [];
+  const query = value.slice(1).toLowerCase();
+  return commands.filter(command => command.name.toLowerCase().startsWith(query));
+};
+export const nextChatCommandIndex = (index, length, direction) => length <= 0 ? 0 : (index + direction + length) % length;
+export const isChatNearBottom = (scrollHeight, scrollTop, clientHeight, threshold = 96) => scrollHeight - scrollTop - clientHeight <= threshold;
+export const restoredChatScrollTop = (previousScrollTop, previousScrollHeight, nextScrollHeight) => Math.max(0, previousScrollTop + nextScrollHeight - previousScrollHeight);
+/**
+ * Runs one composer submission with optimistic clearing. Resolves to `true`
+ * when the handler accepted the submission. A synchronous throw is handled
+ * exactly like a rejected promise so a controlled draft is never lost.
+ */
+export const runChatSubmission = async run => {
+  run.clear();
+  try {
+    if ((await run.perform()) === false) {
+      run.restore();
+      return false;
+    }
+    return true;
+  } catch (error) {
+    run.onError?.(error);
+    run.restore();
+    return false;
+  }
+};
+
+/** Reports a handler failure without letting a synchronous throw escape. */
+export const reportChatFailure = (perform, onError) => {
+  try {
+    const result = perform();
+    if (result instanceof Promise) void result.catch(error => onError?.(error));
+  } catch (error) {
+    onError?.(error);
+  }
+};
+const writeChatClipboard = async value => {
+  if (typeof navigator === "undefined" || !navigator.clipboard?.writeText) {
+    throw new Error("Clipboard access is unavailable.");
+  }
+  await navigator.clipboard.writeText(value);
+};
+
+/** Executes the one behavior guaranteed by the ChatAction contract. */
+export const executeChatAction = async action => {
+  if (typeof action.copyText === "string") {
+    await writeChatClipboard(action.copyText);
+    return;
+  }
+  await action.onSelect();
+};
+//# sourceMappingURL=chat-behavior.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["filterChatCommands","value","commands","startsWith","test","query","slice","toLowerCase","filter","command","name","nextChatCommandIndex","index","length","direction","isChatNearBottom","scrollHeight","scrollTop","clientHeight","threshold","restoredChatScrollTop","previousScrollTop","previousScrollHeight","nextScrollHeight","Math","max","runChatSubmission","run","clear","perform","restore","error","onError","reportChatFailure","result","Promise","catch","writeChatClipboard","navigator","clipboard","writeText","Error","executeChatAction","action","copyText","onSelect"],"sources":["chat/chat-behavior.ts"],"sourcesContent":["import type { ChatAction } from \"./types\";\n\nexport const filterChatCommands = <T extends { name: string }>(value: string, commands: readonly T[]): T[] => {\n  if (!value.startsWith(\"/\") || /\\s/.test(value)) return [];\n  const query = value.slice(1).toLowerCase();\n  return commands.filter((command) => command.name.toLowerCase().startsWith(query));\n};\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,MAAMA,kBAAkB,GAAGA,CAA6BC,KAAa,EAAEC,QAAsB,KAAU;EAC5G,IAAI,CAACD,KAAK,CAACE,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAACC,IAAI,CAACH,KAAK,CAAC,EAAE,OAAO,EAAE;EACzD,MAAMI,KAAK,GAAGJ,KAAK,CAACK,KAAK,CAAC,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;EAC1C,OAAOL,QAAQ,CAACM,MAAM,CAAEC,OAAO,IAAKA,OAAO,CAACC,IAAI,CAACH,WAAW,CAAC,CAAC,CAACJ,UAAU,CAACE,KAAK,CAAC,CAAC;AACnF,CAAC;AAED,OAAO,MAAMM,oBAAoB,GAAGA,CAACC,KAAa,EAAEC,MAAc,EAAEC,SAAiB,KACnFD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAACD,KAAK,GAAGE,SAAS,GAAGD,MAAM,IAAIA,MAAM;AAEzD,OAAO,MAAME,gBAAgB,GAAGA,CAACC,YAAoB,EAAEC,SAAiB,EAAEC,YAAoB,EAAEC,SAAS,GAAG,EAAE,KAC5GH,YAAY,GAAGC,SAAS,GAAGC,YAAY,IAAIC,SAAS;AAEtD,OAAO,MAAMC,qBAAqB,GAAGA,CAACC,iBAAyB,EAAEC,oBAA4B,EAAEC,gBAAwB,KACrHC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEJ,iBAAiB,GAAGE,gBAAgB,GAAGD,oBAAoB,CAAC;AAe1E;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,iBAAiB,GAAG,MAAOC,GAAsB,IAAuB;EACnFA,GAAG,CAACC,KAAK,CAAC,CAAC;EACX,IAAI;IACF,IAAI,CAAC,MAAMD,GAAG,CAACE,OAAO,CAAC,CAAC,MAAM,KAAK,EAAE;MACnCF,GAAG,CAACG,OAAO,CAAC,CAAC;MACb,OAAO,KAAK;IACd;IACA,OAAO,IAAI;EACb,CAAC,CAAC,OAAOC,KAAK,EAAE;IACdJ,GAAG,CAACK,OAAO,GAAGD,KAAK,CAAC;IACpBJ,GAAG,CAACG,OAAO,CAAC,CAAC;IACb,OAAO,KAAK;EACd;AACF,CAAC;;AAED;AACA,OAAO,MAAMG,iBAAiB,GAAGA,CAACJ,OAAsB,EAAEG,OAAkC,KAAW;EACrG,IAAI;IACF,MAAME,MAAM,GAAGL,OAAO,CAAC,CAAC;IACxB,IAAIK,MAAM,YAAYC,OAAO,EAAE,KAAKD,MAAM,CAACE,KAAK,CAAEL,KAAK,IAAKC,OAAO,GAAGD,KAAK,CAAC,CAAC;EAC/E,CAAC,CAAC,OAAOA,KAAK,EAAE;IACdC,OAAO,GAAGD,KAAK,CAAC;EAClB;AACF,CAAC;AAED,MAAMM,kBAAkB,GAAG,MAAOpC,KAAa,IAAoB;EACjE,IAAI,OAAOqC,SAAS,KAAK,WAAW,IAAI,CAACA,SAAS,CAACC,SAAS,EAAEC,SAAS,EAAE;IACvE,MAAM,IAAIC,KAAK,CAAC,kCAAkC,CAAC;EACrD;EACA,MAAMH,SAAS,CAACC,SAAS,CAACC,SAAS,CAACvC,KAAK,CAAC;AAC5C,CAAC;;AAED;AACA,OAAO,MAAMyC,iBAAiB,GAAG,MAAOC,MAAkB,IAAoB;EAC5E,IAAI,OAAOA,MAAM,CAACC,QAAQ,KAAK,QAAQ,EAAE;IACvC,MAAMP,kBAAkB,CAACM,MAAM,CAACC,QAAQ,CAAC;IACzC;EACF;EACA,MAAMD,MAAM,CAACE,QAAQ,CAAC,CAAC;AACzB,CAAC","ignoreList":[]}

package/dist/browser/chat/index.js

@@ -0,0 +1,17 @@
+import { ChatComposer } from "./ChatComposer";
+import { ChatActivity, ChatContextUsage, ChatMessage } from "./ChatPrimitives";
+import { ChatRoot } from "./ChatRoot";
+import { ChatTimeline } from "./ChatTimeline";
+export { formatChatTokens } from "./ChatPrimitives";
+/**
+ * Portable, controlled chat surface. Applications own storage, streaming,
+ * authorization, rich message rendering, and domain actions.
+ */
+export const Chat = Object.assign(ChatRoot, {
+  Timeline: ChatTimeline,
+  Message: ChatMessage,
+  Activity: ChatActivity,
+  Composer: ChatComposer,
+  ContextUsage: ChatContextUsage
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ChatComposer","ChatActivity","ChatContextUsage","ChatMessage","ChatRoot","ChatTimeline","formatChatTokens","Chat","Object","assign","Timeline","Message","Activity","Composer","ContextUsage"],"sources":["chat/index.ts"],"sourcesContent":["import { 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  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  Timeline: ChatTimeline,\n  Message: ChatMessage,\n  Activity: ChatActivity,\n  Composer: ChatComposer,\n  ContextUsage: ChatContextUsage,\n});\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,gBAAgB;AAC7C,SAASC,YAAY,EAAEC,gBAAgB,EAAEC,WAAW,QAAQ,kBAAkB;AAC9E,SAASC,QAAQ,QAAQ,YAAY;AACrC,SAASC,YAAY,QAAQ,gBAAgB;AAI7C,SAASC,gBAAgB,QAAQ,kBAAkB;AAiBnD;AACA;AACA;AACA;AACA,OAAO,MAAMC,IAAI,GAAGC,MAAM,CAACC,MAAM,CAACL,QAAQ,EAAE;EAC1CM,QAAQ,EAAEL,YAAY;EACtBM,OAAO,EAAER,WAAW;EACpBS,QAAQ,EAAEX,YAAY;EACtBY,QAAQ,EAAEb,YAAY;EACtBc,YAAY,EAAEZ;AAChB,CAAC,CAAC","ignoreList":[]}

package/dist/browser/chat/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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};\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};\n"],"mappings":"","ignoreList":[]}