@aparte/core 0.2.0-alpha.0

package/dist/types/models.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Aparte Models
+ * Core data structures for message handling and attachments
+ */
+import type { AparteSegment } from './segments.js';
+/**
+ * Generic status type for flow management
+ * Used to drive loading indicators, error states, and transitions
+ * without coupling to any specific data source
+ */
+export type AparteStatus = 'idle' | 'pending' | 'streaming' | 'completed' | 'error' | 'success';
+/** Role of a message sender in the conversation */
+export type AparteBubbleRole = 'user' | 'assistant';
+/**
+ * Attachment interface for media and file support
+ * Future-proof structure for images, audio, documents, etc.
+ */
+export interface AparteAttachment {
+    /** Unique identifier for the attachment */
+    id: string;
+    /** Display name of the attachment */
+    name: string;
+    /** MIME type (e.g., 'image/png', 'application/pdf') */
+    type: string;
+    /** URL or data URI to access the attachment */
+    url: string;
+    /** Optional file size in bytes */
+    size?: number;
+    /** Optional thumbnail URL for previews */
+    thumbnailUrl?: string;
+    /** Optional metadata for custom properties */
+    metadata?: Record<string, unknown>;
+    /**
+     * Binary payload. Set at message-creation time (File from upload) so the
+     * persistence adapter can save it to its attachments table. Stripped from
+     * the serialised message row — the adapter reconstructs `url` via
+     * `URL.createObjectURL(blob)` on hydration. Not serialised to JSON.
+     */
+    blob?: Blob;
+}
+/**
+ * A single branch (alternative response) within an assistant message.
+ *
+ * @deprecated The active branching system is tree-based via `MessageRepository`
+ *   (siblings under the same parent node). This in-message versioning struct is
+ *   kept only for backwards compatibility with existing serialised payloads.
+ *   New code should rely on viewport methods `addSiblingOf` / `navigateBranch`
+ *   and on the `aparte-path-changed` event payload to drive the branch picker UI.
+ */
+export interface AparteMessageBranch {
+    /** Unique identifier for this branch */
+    id: string;
+    /** Text content of this branch */
+    content?: string;
+    /** Rich segments of this branch */
+    segments?: AparteSegment[];
+    /** Branch status */
+    status?: AparteStatus;
+    /** Creation timestamp */
+    timestamp: number;
+}
+/**
+ * Names of the individual action-bar buttons, used for explicit per-role
+ * ordered configuration (see `AparteBubbleActionsConfig.user` / `.assistant`).
+ */
+export type AparteBubbleActionName = 'copy' | 'edit' | 'retry' | 'thumbUp' | 'thumbDown';
+/**
+ * Controls which action buttons are rendered in message bubbles.
+ * Pass to `AparteConfig.setBubbleActions()` to customise or disable actions.
+ *
+ * Two ways to configure:
+ * - Global flags (`copy`/`retry`/`edit`/`feedback`) — role-aware defaults, the
+ *   original behaviour.
+ * - Explicit per-role ordered sets (`user`/`assistant`) — when provided for a
+ *   role, they fully replace the flag-derived set for that role: buttons render
+ *   in exactly the given order and nothing is auto-appended (not even the usage
+ *   "info" button). Lets a theme match a specific product 1:1.
+ */
+export interface AparteBubbleActionsConfig {
+    /** Copy message text to clipboard. Default: true */
+    copy?: boolean;
+    /** Retry / regenerate the response (assistant bubbles). Default: true */
+    retry?: boolean;
+    /** Edit the sent message inline (user bubbles). Default: true */
+    edit?: boolean;
+    /** Thumbs-up / thumbs-down feedback (assistant bubbles). Default: false */
+    feedback?: boolean;
+    /** Explicit, ordered action set for USER bubbles. Example: `['edit', 'copy']`. */
+    user?: AparteBubbleActionName[];
+    /** Explicit, ordered action set for ASSISTANT bubbles. Example: `['copy', 'thumbUp', 'thumbDown', 'retry']`. */
+    assistant?: AparteBubbleActionName[];
+}
+/**
+ * Core message structure for the chat
+ * Supports both simple content and rich multi-segment content
+ */
+export interface AparteMessage {
+    /** Unique identifier for the message */
+    id: string;
+    /** Role of the message sender */
+    role: AparteBubbleRole;
+    /**
+     * Simple text content (for basic messages)
+     * Use `segments` for rich content with multiple parts
+     */
+    content?: string;
+    /**
+     * Rich content segments (thinking, code, terminal, etc.)
+     * Takes precedence over `content` if provided
+     */
+    segments?: AparteSegment[];
+    /** Unix timestamp of message creation */
+    timestamp: number;
+    /** Whether the message is still being streamed */
+    isStreaming?: boolean;
+    /** Current status of the message */
+    status?: AparteStatus;
+    /** Optional attachments (images, files, etc.) */
+    attachments?: AparteAttachment[];
+    /** Token usage + timing reported by the provider for assistant messages. */
+    usage?: import('./chat.js').AparteUsage;
+    /**
+     * Alternative responses generated by retrying.
+     *
+     * @deprecated Use the tree-based branching exposed by `MessageRepository`
+     *   (siblings under the same parent). The bubble no longer reads this field
+     *   — sibling counts come from `aparte-path-changed` event metadata.
+     */
+    branches?: AparteMessageBranch[];
+    /**
+     * Index of the currently displayed branch (default 0).
+     * @deprecated See {@link AparteMessage.branches}.
+     */
+    activeBranchIndex?: number;
+    /** Optional metadata for custom properties */
+    metadata?: Record<string, unknown>;
+}
+/** Configuration options for AparteChatViewport */
+export interface AparteViewportConfig {
+    /** Threshold in pixels for smart scroll detection */
+    scrollThreshold?: number;
+    /**
+     * DOM render cap: the max number of bubbles kept in the DOM at once (a perf
+     * ceiling for very long conversations). This does NOT evict messages from the
+     * conversation model — the full tree and its persistence snapshot stay intact.
+     * Defaults to 1000.
+     */
+    maxRenderedBubbles?: number;
+    /**
+     * @deprecated Renamed to {@link maxRenderedBubbles}. This used to silently
+     * evict messages from the conversation model (data loss); it now only caps
+     * rendered bubbles. For real history retention, configure it on your
+     * ConversationManager instead.
+     */
+    maxMessages?: number;
+    /**
+     * Duration in milliseconds to freeze spacer recalculation after resetSpacer().
+     * Set this to the duration of any CSS layout transition in the host app
+     * (e.g. the flex animation that moves the composer from center to bottom).
+     * Defaults to 0 (no freeze). Example: 350 when `transition: flex 0.3s ease` is used.
+     */
+    layoutTransitionMs?: number;
+}
+/** Configuration options for the composer input. */
+export interface AparteInputConfig {
+    /** Placeholder text for the input */
+    placeholder?: string;
+    /** Maximum height in pixels for auto-expand */
+    maxHeight?: number;
+    /** Minimum height in pixels */
+    minHeight?: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/types/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"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"}

package/dist/types/parsers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Aparte Parsers
+ * Interfaces for content parsing plugins
+ */
+/**
+ * Content parser plugin interface for external parsers
+ * Allows integration of Markdown, code highlighting, LaTeX, etc.
+ * without adding dependencies to the core
+ */
+export interface AparteContentParser {
+    /** Unique identifier for the parser */
+    id: string;
+    /** Priority for parser execution (higher = first) */
+    priority: number;
+    /**
+     * Check if this parser can handle the content
+     * @param content - Raw content to check
+     * @returns true if parser should process this content
+     */
+    canParse(content: string): boolean;
+    /**
+     * Parse content and return transformed output
+     * @param content - Raw content to parse
+     * @returns Parsed HTML string or transformed content
+     */
+    parse(content: string): string;
+}
+/**
+ * Parser registry interface for managing multiple parsers
+ * Optional interface for advanced parser management
+ */
+export interface AparteParserRegistry {
+    /** Register a new parser */
+    register(parser: AparteContentParser): void;
+    /** Unregister a parser by ID */
+    unregister(parserId: string): void;
+    /** Get all registered parsers */
+    getAll(): readonly AparteContentParser[];
+    /** Parse content through all applicable parsers */
+    parse(content: string): string;
+}
+//# sourceMappingURL=parsers.d.ts.map

package/dist/types/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/types/parsers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IAEX,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE5C,gCAAgC;IAChC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,iCAAiC;IACjC,MAAM,IAAI,SAAS,mBAAmB,EAAE,CAAC;IAEzC,mDAAmD;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC"}

package/dist/types/providers.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Aparte Providers
+ * Abstract interfaces for data providers and adapters
+ */
+import type { AparteMessage, AparteStatus } from './models.js';
+import type { AparteControlEvent } from './events.js';
+/**
+ * Abstract data provider interface
+ * Allows the viewport to receive data from any source
+ * (Fetch, WebSocket, Mock, or custom implementations)
+ *
+ * @example
+ * ```typescript
+ * class WebSocketProvider implements AparteDataProvider {
+ *   request(payload: unknown): void {
+ *     this.socket.send(JSON.stringify(payload));
+ *   }
+ * }
+ * ```
+ */
+export interface AparteDataProvider {
+    /**
+     * Send a request to the data source
+     * Implementation-agnostic method signature
+     *
+     * @param payload - Request payload (message, config, etc.)
+     */
+    request(payload: unknown): void;
+}
+/**
+ * Extended provider interface for streaming responses
+ * Adds lifecycle hooks for stream management
+ */
+export interface AparteStreamProvider extends AparteDataProvider {
+    /**
+     * Optional: Called when streaming starts
+     * @param messageId - ID of the message being streamed
+     */
+    onStreamStart?(messageId: string): void;
+    /**
+     * Optional: Called for each token received
+     * @param messageId - ID of the message
+     * @param chunk - Token chunk content
+     */
+    onToken?(messageId: string, chunk: string): void;
+    /**
+     * Optional: Called when streaming completes
+     * @param messageId - ID of the completed message
+     */
+    onStreamEnd?(messageId: string): void;
+    /**
+     * Optional: Called on error
+     * @param messageId - ID of the affected message
+     * @param error - Error details
+     */
+    onError?(messageId: string, error: unknown): void;
+}
+/**
+ * Abstract message store interface
+ * Allows custom storage implementations (memory, IndexedDB, etc.)
+ */
+export interface AparteMessageStore {
+    /** Get a message by ID */
+    get(messageId: string): AparteMessage | undefined;
+    /** Get all messages */
+    getAll(): AparteMessage[];
+    /** Add or update a message */
+    set(message: AparteMessage): void;
+    /** Remove a message by ID */
+    delete(messageId: string): boolean;
+    /** Clear all messages */
+    clear(): void;
+    /** Get message count */
+    size(): number;
+}
+/**
+ * Interface for handling control events from external packages
+ * Allows decoupled communication between packages
+ */
+export interface AparteControlHandler {
+    /**
+     * Handle a control event
+     * @param event - Control event to process
+     */
+    handleControl(event: AparteControlEvent): void;
+    /**
+     * Update message status
+     * @param messageId - Target message ID
+     * @param status - New status
+     */
+    updateStatus(messageId: string, status: AparteStatus): void;
+}
+//# sourceMappingURL=providers.d.ts.map

package/dist/types/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/types/providers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D;;;OAGG;IACH,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0BAA0B;IAC1B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAElD,uBAAuB;IACvB,MAAM,IAAI,aAAa,EAAE,CAAC;IAE1B,8BAA8B;IAC9B,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAElC,6BAA6B;IAC7B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAAC;IAEd,wBAAwB;IACxB,IAAI,IAAI,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/D"}

package/dist/types/segments.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Aparte Segments
+ * Extensible segment types for rich message content
+ */
+/** Base segment interface - all segments extend this */
+export interface AparteSegmentBase {
+    /** Unique segment identifier */
+    id: string;
+    /** Segment type discriminator */
+    type: string;
+    /** Whether segment is currently being streamed */
+    isStreaming?: boolean;
+}
+/** Text segment - plain text content */
+export interface AparteTextSegment extends AparteSegmentBase {
+    type: 'text';
+    content: string;
+}
+/** Thinking/reasoning segment - collapsible */
+export interface AparteThinkingSegment extends AparteSegmentBase {
+    type: 'thinking';
+    content: string;
+    collapsed?: boolean;
+    label?: string;
+}
+/** Code segment - syntax highlighted code block */
+export interface AparteCodeSegment extends AparteSegmentBase {
+    type: 'code';
+    content: string;
+    language?: string;
+    filename?: string;
+    showLineNumbers?: boolean;
+}
+/** Diff segment - before/after code comparison */
+export interface AparteDiffSegment extends AparteSegmentBase {
+    type: 'diff';
+    filename?: string;
+    hunks: AparteDiffHunk[];
+}
+export interface AparteDiffHunk {
+    oldStart: number;
+    newStart: number;
+    lines: AparteDiffLine[];
+}
+export interface AparteDiffLine {
+    type: 'add' | 'remove' | 'context';
+    content: string;
+}
+/** Terminal/console segment - command execution */
+export interface AparteTerminalSegment extends AparteSegmentBase {
+    type: 'terminal';
+    command?: string;
+    output?: string;
+    exitCode?: number;
+    isRunning?: boolean;
+}
+/** File tree segment - directory structure */
+export interface AparteFileTreeSegment extends AparteSegmentBase {
+    type: 'file-tree';
+    files: AparteFileNode[];
+    title?: string;
+}
+export interface AparteFileNode {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    children?: AparteFileNode[];
+    status?: 'added' | 'modified' | 'deleted';
+}
+/** Image segment */
+export interface AparteImageSegment extends AparteSegmentBase {
+    type: 'image';
+    url: string;
+    alt?: string;
+    caption?: string;
+}
+/** Preview/iframe segment */
+export interface ApartePreviewSegment extends AparteSegmentBase {
+    type: 'preview';
+    url: string;
+    title?: string;
+    height?: number;
+}
+/** Error segment */
+export interface AparteErrorSegment extends AparteSegmentBase {
+    type: 'error';
+    content: string;
+    details?: string;
+    stack?: string;
+}
+/** Progress segment - for long operations */
+export interface AparteProgressSegment extends AparteSegmentBase {
+    type: 'progress';
+    label: string;
+    percent?: number;
+    status?: 'pending' | 'running' | 'complete' | 'error';
+}
+/** Tool call segment - rendered while waiting for a tool handler to resolve */
+export interface AparteToolCallSegment extends AparteSegmentBase {
+    type: 'tool_call';
+    toolCall: import('./tools.js').AparteToolCall;
+    /**
+     * `awaiting-approval` — paused for a human decision (needsApproval tools);
+     * `rejected` — the human declined to run it.
+     */
+    status: 'pending' | 'resolved' | 'aborted' | 'awaiting-approval' | 'rejected';
+    result?: string;
+}
+/** Custom segment - for framework-specific views (Onboarding, Tools, etc.) */
+export interface AparteCustomSegment extends AparteSegmentBase {
+    type: 'custom';
+    /** Unique string structure to identify the view (e.g. 'onboarding', 'webcontainer', 'weather-widget') */
+    subType: string;
+    /** Arbitrary data payload for the component */
+    data?: unknown;
+    /** Optional fallback text representation */
+    fallback?: string;
+}
+/**
+ * Artifact segment — a structured payload (React/HTML/SVG/JS/CSS, etc.) embedded in the
+ * assistant's reply. The payload is delimited in the stream by `<artifact type="...">…</artifact>`.
+ *
+ * The core only models the data and emits lifecycle events (`aparte-artifact-start|delta|ready`).
+ * Apps decide how to render the rich preview (typically a side panel with an iframe/code view).
+ *
+ * `mimeType` follows standard MIME conventions, with the Anthropic vendor namespace for
+ * framework-specific kinds:
+ *   - `application/vnd.ant.react` (or `application/vnd.ant.html`, etc.)
+ *   - `text/html`, `text/css`, `application/javascript`
+ *   - `image/svg+xml`
+ */
+export interface AparteArtifactSegment extends AparteSegmentBase {
+    type: 'artifact';
+    /** Standard MIME type (verbatim from the `type="…"` attribute on the opening tag) */
+    mimeType: string;
+    /**
+     * Short kind identifier derived from `mimeType` (e.g. 'react', 'html', 'svg').
+     * Convenience for UIs that want to switch on a stable enum-like string.
+     */
+    artifactType: string;
+    /** Optional human title (from the `title="…"` attribute on the opening tag) */
+    title?: string;
+    /** Body content between the opening and closing tag — accumulates while streaming. */
+    content: string;
+    /**
+     * When true, the renderer displays the artifact inline as a code block
+     * instead of a clickable pill that opens the side panel.
+     * Set by the client after the stream ends, based on content line count.
+     * Defaults to false (pill) while streaming.
+     */
+    inline?: boolean;
+}
+/** Transient waiting indicator shown between pipeline phases */
+export interface ApartePipelineWaitingSegment extends AparteSegmentBase {
+    type: 'pipeline-waiting';
+}
+/** All built-in segment types */
+export type AparteSegment = AparteTextSegment | AparteThinkingSegment | AparteCodeSegment | AparteDiffSegment | AparteTerminalSegment | AparteFileTreeSegment | AparteImageSegment | ApartePreviewSegment | AparteErrorSegment | AparteProgressSegment | AparteCustomSegment | AparteToolCallSegment | AparteArtifactSegment | ApartePipelineWaitingSegment;
+/** Segment type discriminator values */
+export type AparteSegmentType = AparteSegment['type'];
+/**
+ * Segment renderer interface for custom segment types
+ * Implement this to add new segment renderers
+ */
+export interface AparteSegmentRenderer<T extends AparteSegmentBase = AparteSegmentBase> {
+    /** Segment type this renderer handles */
+    type: string;
+    /**
+     * Render a segment to either an HTML string or a ready DOM element.
+     *
+     * Return a **string** for simple markup (inserted via innerHTML) — the built-in
+     * renderers do this. Return an **HTMLElement** to skip innerHTML entirely: you
+     * can attach event listeners and framework nodes directly, and there is no
+     * innerHTML XSS surface for values you interpolate. Either way, `setup()` (if
+     * provided) runs afterwards with the resulting element. For in-place streaming
+     * updates to find your element, keep a `data-segment-id="<segment.id>"` on its
+     * root (or implement `update()`).
+     *
+     * @param segment - Segment data to render
+     * @returns HTML string or a DOM element
+     */
+    render(segment: T): string | HTMLElement;
+    /**
+     * Optional: Get CSS styles for this segment type
+     * @returns CSS string to inject
+     */
+    getStyles?(): string;
+    /**
+     * Optional: Setup interactivity after render
+     * @param element - The rendered DOM element
+     * @param segment - Segment data
+     */
+    setup?(element: HTMLElement, segment: T): void;
+    /**
+     * Optional: In-place DOM update during streaming.
+     * When provided, called instead of re-rendering the full element.
+     * Must not add/remove child nodes — only mutate attributes or textContent
+     * so the MutationObserver (childList) doesn't fire and scroll stays stable.
+     */
+    update?(element: HTMLElement, segment: T): void;
+    /**
+     * Optional: Cleanup when segment is removed
+     * @param element - The DOM element being removed
+     */
+    cleanup?(element: HTMLElement): void;
+}
+/** Event when a segment action is triggered (e.g., "Run", "Copy") */
+export interface AparteSegmentActionEvent {
+    messageId: string;
+    segmentId: string;
+    action: string;
+    payload?: unknown;
+}
+/** Event when segment content is updated during streaming */
+export interface AparteSegmentUpdateEvent {
+    messageId: string;
+    segmentId: string;
+    content: string;
+    append?: boolean;
+}
+//# sourceMappingURL=segments.d.ts.map

package/dist/types/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/types/segments.ts"],"names":[],"mappings":"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"}

package/dist/types/theming.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Aparte Theming
+ * CSS Custom Properties interfaces for theming
+ */
+/**
+ * CSS Custom Properties available for theming
+ * All properties are optional - defaults are applied in components
+ */
+export interface AparteThemeVariables {
+    '--aparte-primary'?: string;
+    '--aparte-primary-hover'?: string;
+    '--aparte-secondary'?: string;
+    '--aparte-neutral'?: string;
+    '--aparte-message-content-bg-user'?: string;
+    '--aparte-message-content-bg-assistant'?: string;
+    '--aparte-message-content-text-user'?: string;
+    '--aparte-message-content-text-assistant'?: string;
+    '--aparte-message-content-radius'?: string;
+    '--aparte-message-content-radius-corner'?: string;
+    '--aparte-message-content-padding'?: string;
+    '--aparte-message-content-max-width'?: string;
+    '--aparte-message-content-font-size'?: string;
+    '--aparte-input-bg'?: string;
+    '--aparte-input-border'?: string;
+    '--aparte-input-text'?: string;
+    '--aparte-input-placeholder'?: string;
+    '--aparte-input-focus-border'?: string;
+    '--aparte-input-focus-ring'?: string;
+    '--aparte-input-radius'?: string;
+    '--aparte-input-font-size'?: string;
+    '--aparte-input-disabled-bg'?: string;
+    '--aparte-viewport-padding'?: string;
+    '--aparte-message-gap'?: string;
+    '--aparte-input-padding'?: string;
+    '--aparte-font-family'?: string;
+    '--aparte-timestamp-font-size'?: string;
+    '--aparte-status-color'?: string;
+    '--aparte-status-font-size'?: string;
+    '--aparte-status-dot-size'?: string;
+    '--aparte-status-padding'?: string;
+    '--aparte-button-radius'?: string;
+    '--aparte-button-text'?: string;
+}
+//# sourceMappingURL=theming.d.ts.map

package/dist/types/theming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theming.d.ts","sourceRoot":"","sources":["../../src/types/theming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IAEjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,uCAAuC,CAAC,EAAE,MAAM,CAAC;IACjD,oCAAoC,CAAC,EAAE,MAAM,CAAC;IAC9C,yCAAyC,CAAC,EAAE,MAAM,CAAC;IACnD,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,wCAAwC,CAAC,EAAE,MAAM,CAAC;IAClD,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,oCAAoC,CAAC,EAAE,MAAM,CAAC;IAC9C,oCAAoC,CAAC,EAAE,MAAM,CAAC;IAG9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAGtC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAGlC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAGxC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC"}