@lostgradient/cinder 0.8.0 → 0.11.0

package/dist/components/card/card.css

@@ -95,6 +95,11 @@
     padding: 0;
   }
 
+  .cinder-card[data-cinder-padding='none'] > .cinder-card__header,
+  .cinder-card[data-cinder-padding='none'] > .cinder-card__footer {
+    padding: 0;
+  }
+
   .cinder-card[data-cinder-variant='well'] > .cinder-card__body {
     background: var(--cinder-surface-inset);
   }

package/dist/components/card/card.schema.js

@@ -82,7 +82,7 @@ var schema = {
     },
     padding: {
       enum: ["none", "default"],
-      description: "Body padding. `none` removes all padding for flush or full-bleed content (e.g. an image)."
+      description: "Region padding. `none` removes body, header, and footer padding for flush or full-bleed content (e.g. an image)."
     },
     headingLevel: {
       enum: [2, 3, 4, 5, 6],
@@ -121,4 +121,4 @@ export {
   card_schema_default as default
 };
 
-//# debugId=F6D9BA0707365EC764756E2164756E21
+//# debugId=F547FD1405B4E7BD64756E2164756E21

package/dist/components/card/card.types.d.ts

@@ -3,7 +3,7 @@ import type { HTMLAttributes } from 'svelte/elements';
 export type CardVariant = 'card' | 'well';
 export type CardTone = 'default' | 'muted';
 export type CardSurfaceTone = 'default' | 'danger';
-/** Controls body padding. `none` removes all padding for flush/full-bleed content. Future values like `compact` may be added. */
+/** Controls region padding. `none` removes body, header, and footer padding for flush/full-bleed content. Future values like `compact` may be added. */
 export type CardPadding = 'default' | 'none';
 /** Heading level for the generated card title, so the document outline stays correct. */
 export type CardHeadingLevel = 2 | 3 | 4 | 5 | 6;
@@ -19,7 +19,7 @@ type CardBase = HTMLAttributes<HTMLDivElement> & {
     footerTone?: CardTone;
     /** Remove side borders/radius and bleed to the viewport edge on narrow screens. */
     edgeToEdgeOnMobile?: boolean;
-    /** Body padding. `none` removes all padding for flush or full-bleed content (e.g. an image). */
+    /** Region padding. `none` removes body, header, and footer padding for flush or full-bleed content (e.g. an image). */
     padding?: CardPadding;
 };
 /** Basic card with no generated header. */

package/dist/components/card/index.js

@@ -253,6 +253,7 @@ function Card($$anchor, $$props) {
     "data-cinder-variant": variant(),
     "data-cinder-tone": tone(),
     "data-cinder-edge-to-edge-mobile": edgeToEdgeOnMobile() ? "" : undefined,
+    "data-cinder-padding": padding(),
     ...$3.get(labelAttributes)
   }), [() => classNames("cinder-card", $$props.class)]);
   var node = $3.child(div);
@@ -351,4 +352,4 @@ export {
   Card
 };
 
-//# debugId=9672E10E3D232CA964756E2164756E21
+//# debugId=AD4C1F4D4FAE6B8B64756E2164756E21

package/dist/components/chat/builders.d.ts

@@ -1,16 +1,25 @@
 /**
  * Conversation builders for the Chat component.
  *
- * Chat renders a {@link ConversationHistory} snapshot. These are thin aliases
- * over the published `conversationalist` builders so examples, demos, tests, and
- * simple apps construct the same transcript shape Chat consumes.
+ * Chat renders a {@link ConversationHistory} snapshot. These helpers construct
+ * the published Conversationalist shape without importing the package runtime
+ * into Cinder's browser graph.
  */
-import { appendAssistantMessage as appendConversationalistAssistantMessage, appendUserMessage as appendConversationalistUserMessage, createConversationHistory } from 'conversationalist';
-import type { ConversationHistory, MessageInput } from './conversation-model.ts';
+import type { ConversationEnvironment, ConversationHistory, ConversationStatus, JSONValue, MessageInput } from './conversation-model.ts';
+type CreateConversationOptions = {
+    id?: string;
+    title?: string;
+    status?: ConversationStatus;
+    metadata?: Record<string, JSONValue>;
+};
+type ConversationEnvironmentInput = Partial<ConversationEnvironment>;
 /** Creates a new empty conversation snapshot. */
-declare const createConversation: typeof createConversationHistory;
+declare function createConversation(options?: CreateConversationOptions, environment?: ConversationEnvironmentInput): ConversationHistory;
 /** Appends one or more messages, preserving the previous no-op identity contract. */
 declare function appendMessages(conversation: ConversationHistory, ...inputs: MessageInput[]): ConversationHistory;
-declare const appendUserMessage: typeof appendConversationalistUserMessage;
-declare const appendAssistantMessage: typeof appendConversationalistAssistantMessage;
+declare function appendMessages(conversation: ConversationHistory, ...inputsAndEnvironment: [...MessageInput[], ConversationEnvironmentInput | undefined]): ConversationHistory;
+declare function appendUserMessage(conversation: ConversationHistory, content: MessageInput['content'], metadata?: Record<string, JSONValue>, environment?: ConversationEnvironmentInput): ConversationHistory;
+declare function appendUserMessage(conversation: ConversationHistory, content: MessageInput['content'], environment?: ConversationEnvironmentInput): ConversationHistory;
+declare function appendAssistantMessage(conversation: ConversationHistory, content: MessageInput['content'], metadata?: Record<string, JSONValue>, environment?: ConversationEnvironmentInput): ConversationHistory;
+declare function appendAssistantMessage(conversation: ConversationHistory, content: MessageInput['content'], environment?: ConversationEnvironmentInput): ConversationHistory;
 export { appendAssistantMessage, appendMessages, appendUserMessage, createConversation };

package/dist/components/chat/chat.schema.js

@@ -104,6 +104,26 @@ var schema = {
       type: "string",
       description: 'Optional status label displayed in the typing indicator while `streaming` is `true` and no streaming content has arrived yet (e.g. `"Thinking…"` or `"Analyzing file…"`). When omitted, three animated dots are shown.'
     },
+    composerRole: {
+      type: "string",
+      description: "Explicit role for the composer textarea, for overlay patterns such as ARIA comboboxes."
+    },
+    composerAriaExpanded: {
+      enum: [false, true, "true", "false"],
+      description: "`aria-expanded` passed to the composer textarea for overlays such as slash-command menus."
+    },
+    composerAriaControls: {
+      type: "string",
+      description: "`aria-controls` passed to the composer textarea for overlays such as slash-command menus."
+    },
+    composerAriaActiveDescendant: {
+      type: "string",
+      description: "`aria-activedescendant` passed to the composer textarea for overlays such as slash-command menus."
+    },
+    composerAriaAutocomplete: {
+      enum: ["none", "inline", "list", "both"],
+      description: "`aria-autocomplete` passed to the composer textarea for overlays such as slash-command menus."
+    },
     virtualized: {
       type: "boolean",
       description: "Use the virtualized message render path for long transcripts. The complete `ConversationHistory` remains unchanged; only the DOM window is reduced. Default `false`."
@@ -225,10 +245,32 @@ generation. When an adapter is also wired, Chat calls
         name: "onattachmentremove",
         reason: "function-or-snippet"
       },
+      {
+        name: "oncomposerblur",
+        reason: "function-or-snippet",
+        description: `Called when focus leaves the composer textarea. Overlay primitives can use
+this to dismiss without preventing native focus movement.`
+      },
       {
         name: "oncomposerinput",
         reason: "function-or-snippet",
-        description: "Called with the composer's current plain-text value on every composer\ninput event. Lets a consumer build slash-command, mention, or autocomplete\nUX without reaching into `.chat-input-editor` DOM directly."
+        description: "Called with the composer's current plain-text value on every composer\ninput event. The optional event exposes the textarea for composer-bound\noverlays without reaching into `.chat-input-editor` DOM directly."
+      },
+      {
+        name: "oncomposerkeydown",
+        reason: "function-or-snippet",
+        description: `Called before Chat's internal composer key handling when a keydown
+originates from the composer textarea. Call \`event.preventDefault()\` to
+let an overlay consume Arrow keys, Enter, or Escape before Enter-to-send.
+Chat does not call this hook during IME composition, so Enter can still
+confirm the active candidate instead of sending.`
+      },
+      {
+        name: "oncomposerselectionchange",
+        reason: "function-or-snippet",
+        description: `Called after pointer or selection activity may have moved the composer
+caret without changing text. Overlay primitives can resync their active
+token from the textarea selection.`
       },
       {
         name: "ondeny",
@@ -321,4 +363,4 @@ export {
   chat_schema_default as default
 };
 
-//# debugId=9906999F3FA9B93664756E2164756E21
+//# debugId=F47E899530612A1264756E2164756E21

package/dist/components/chat/chat.svelte.d.ts

@@ -12,17 +12,19 @@
  * @avoidWhen The transcript is read-only and needs no composer — a simple list of message bubbles is a better fit.
  * @related markdown-editor
  */
-export type { ChatProps } from './chat.types.ts';
-import type { ChatProps } from './chat.types.ts';
+export type { ChatAnnounceLevel, ChatProps } from './chat.types.ts';
+import type { ChatAnnounceLevel, ChatProps } from './chat.types.ts';
 declare const Chat: import("svelte").Component<ChatProps, {
     beginStreaming: (messageId: string) => void;
     pushToken: (token: string) => void;
     endStreaming: () => void;
+    announce: (message: string, level?: ChatAnnounceLevel) => void;
     scrollToBottom: () => void;
     scrollToTop: () => void;
     focusInput: () => void;
     clearInput: () => void;
     getComposerValue: () => string;
+    getEditorElement: () => HTMLTextAreaElement | null;
 }, "">;
 type Chat = ReturnType<typeof Chat>;
 export default Chat;

package/dist/components/chat/chat.types.d.ts

@@ -36,6 +36,8 @@ export type ReadReceipt = {
      */
     readBy?: string[];
 };
+/** Live-region channel for imperative Chat announcements. */
+export type ChatAnnounceLevel = 'polite' | 'assertive';
 /**
  * Full-row override snippet. Inversion of control: receives the message AND a
  * `renderDefault` snippet that renders the built-in row, so a consumer can wrap
@@ -109,6 +111,16 @@ export type ChatProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'onsubmit'>
      * rather than as five separate boolean props.
      */
     capabilities?: ChatCapabilities;
+    /** Explicit role for the composer textarea, for overlay patterns such as ARIA comboboxes. */
+    composerRole?: string | undefined;
+    /** `aria-expanded` passed to the composer textarea for overlays such as slash-command menus. */
+    composerAriaExpanded?: boolean | 'true' | 'false' | undefined;
+    /** `aria-controls` passed to the composer textarea for overlays such as slash-command menus. */
+    composerAriaControls?: string | undefined;
+    /** `aria-activedescendant` passed to the composer textarea for overlays such as slash-command menus. */
+    composerAriaActiveDescendant?: string | undefined;
+    /** `aria-autocomplete` passed to the composer textarea for overlays such as slash-command menus. */
+    composerAriaAutocomplete?: 'none' | 'inline' | 'list' | 'both' | undefined;
     /** Use the virtualized message render path for long transcripts. The complete `ConversationHistory` remains unchanged; only the DOM window is reduced. Default `false`. */
     virtualized?: boolean;
     /** Estimated row height in pixels for virtualized message rows. Default `88`. */
@@ -230,8 +242,27 @@ export type ChatProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'onsubmit'>
     onattachmentfailure?: (file: File, error: string) => void;
     /**
      * Called with the composer's current plain-text value on every composer
-     * input event. Lets a consumer build slash-command, mention, or autocomplete
-     * UX without reaching into `.chat-input-editor` DOM directly.
+     * input event. The optional event exposes the textarea for composer-bound
+     * overlays without reaching into `.chat-input-editor` DOM directly.
      */
-    oncomposerinput?: (value: string) => void;
+    oncomposerinput?: (value: string, event?: Event) => void;
+    /**
+     * Called before Chat's internal composer key handling when a keydown
+     * originates from the composer textarea. Call `event.preventDefault()` to
+     * let an overlay consume Arrow keys, Enter, or Escape before Enter-to-send.
+     * Chat does not call this hook during IME composition, so Enter can still
+     * confirm the active candidate instead of sending.
+     */
+    oncomposerkeydown?: (event: KeyboardEvent) => void;
+    /**
+     * Called after pointer or selection activity may have moved the composer
+     * caret without changing text. Overlay primitives can resync their active
+     * token from the textarea selection.
+     */
+    oncomposerselectionchange?: (event: Event) => void;
+    /**
+     * Called when focus leaves the composer textarea. Overlay primitives can use
+     * this to dismiss without preventing native focus movement.
+     */
+    oncomposerblur?: (event: FocusEvent) => void;
 };

package/dist/components/chat/container/chat.svelte.d.ts

@@ -1,12 +1,14 @@
-import type { ChatProps } from '../chat.types.ts';
-export type { ChatProps };
+import type { ChatAnnounceLevel, ChatProps } from '../chat.types.ts';
+export type { ChatAnnounceLevel, ChatProps };
 export type { ChatScrollStateChangeEvent, ChatStopGeneratingEvent, ChatSubmitEvent, ChatUnreadIndicatorChangeEvent, } from './chat-events.ts';
 declare const Chat: import("svelte").Component<ChatProps, {
+    announce: (message: string, level?: ChatAnnounceLevel) => void;
     scrollToBottom: () => void;
     scrollToTop: () => void;
     focusInput: () => void;
     clearInput: () => void;
     getComposerValue: () => string;
+    getEditorElement: () => HTMLTextAreaElement | null;
     beginStreaming: (messageId: string) => void;
     pushToken: (token: string) => void;
     endStreaming: () => void;

package/dist/components/chat/conversation-model.d.ts

@@ -8,7 +8,7 @@
  * @module
  */
 import type { ToMarkdownOptions as ConversationalistToMarkdownOptions } from 'conversationalist/markdown';
-export type { AssistantMessage, ContainerUploadContent, ConversationHistory, ConversationStatus, ImageContent, JSONValue, Message, MessageInput, MessageRole, MultiModalContent, RedactedThinkingContent, ServerToolResultContent, ServerToolResultType, ServerToolUseContent, TextContent, ThinkingContent, TokenUsage, ToolAction, ToolCall, ToolError, ToolErrorCategory, ToolResult, WebSearchToolResultContent, } from 'conversationalist';
+export type { AssistantMessage, ContainerUploadContent, ConversationEnvironment, ConversationHistory, ConversationStatus, ImageContent, JSONValue, Message, MessageInput, MessageRole, MultiModalContent, RedactedThinkingContent, ServerToolResultContent, ServerToolResultType, ServerToolUseContent, TextContent, ThinkingContent, TokenUsage, ToolAction, ToolCall, ToolError, ToolErrorCategory, ToolResult, WebSearchToolResultContent, } from 'conversationalist';
 export type { ToolCallPair } from 'conversationalist/utilities';
 /** Base options shared by all transcript export operations. */
 export type ExportOptions = Omit<ConversationalistToMarkdownOptions, 'includeMetadata'>;

package/dist/components/chat/index.d.ts

@@ -8,14 +8,14 @@
 import './chat.css';
 import Chat from './chat.svelte';
 export default Chat;
-export type { ChatCapabilities, ChatProps, ReadReceipt, TypingParticipant } from './chat.types.ts';
+export type { ChatAnnounceLevel, ChatCapabilities, ChatProps, ReadReceipt, TypingParticipant, } from './chat.types.ts';
 export { Chat };
 export type { ChatAdapter, ChatAdapterErrorEvent, ChatCommand, ChatPushHandlers, ChatReadReceiptEvent, } from './adapter';
 export { appendAssistantMessage, appendMessages, appendUserMessage, createConversation, } from './builders.ts';
-export type { AssistantMessage, ContainerUploadContent, ConversationHistory, ConversationStatus, ExportOptions, ImageContent, JSONValue, Message, MessageInput, MessageRole, MultiModalContent, RedactedThinkingContent, ServerToolResultContent, ServerToolResultType, ServerToolUseContent, TextContent, ThinkingContent, ToMarkdownOptions, TokenUsage, ToolAction, ToolCall, ToolCallPair, ToolError, ToolErrorCategory, ToolResult, WebSearchToolResultContent, } from './conversation-model.ts';
+export type { AssistantMessage, ContainerUploadContent, ConversationEnvironment, ConversationHistory, ConversationStatus, ExportOptions, ImageContent, JSONValue, Message, MessageInput, MessageRole, MultiModalContent, RedactedThinkingContent, ServerToolResultContent, ServerToolResultType, ServerToolUseContent, TextContent, ThinkingContent, ToMarkdownOptions, TokenUsage, ToolAction, ToolCall, ToolCallPair, ToolError, ToolErrorCategory, ToolResult, WebSearchToolResultContent, } from './conversation-model.ts';
 export { formatMessageAsMarkdown, getMessageRoleLabel, getMessageText, messagesToMarkdown, type ChatExportOptions, type DeliveryStatus, } from './utilities';
-export { ChatAttachmentPreview, ChatInput, deriveAttachmentKind } from './input';
-export type { AttachmentKind, ChatAttachment } from './input';
+export { ChatAttachmentPreview, ChatInput, deriveAttachmentKind, serializeChatAttachment, serializeChatAttachments, } from './input';
+export type { AttachmentKind, ChatAttachment, SerializedChatAttachment } from './input';
 export { ChatDateSeparator, ChatMessage, MessageAttachments, MessageContent, ToolCallGroup, } from './message';
 export { DEFAULT_SCROLL_CONFIGURATION, calculateScrollToBottom, calculateUnreadCount, extractTimestamp, findUnreadBoundaryIndex, isAtBottom, shouldShowJumpToLatest, } from './container';
 export type { ChatScrollStateChangeEvent, ChatStopGeneratingEvent, ChatSubmitEvent, ChatUnreadIndicatorChangeEvent, ScrollConfiguration, ScrollState, } from './container';