@aparte/core 0.2.0-alpha.0

package/dist/config/aparte-config.d.ts

@@ -0,0 +1,490 @@
+/**
+ * AparteConfig
+ *
+ * Central configuration singleton for Aparte.
+ * Manages providers for Markdown rendering, Syntax Highlighting, Icons, and Skeleton loading.
+ *
+ * "Invisible but Flexible": Works out-of-the-box with sensible defaults,
+ * but allows complete customization via dependency injection.
+ */
+import { AparteIconProvider, AparteIconName } from './icon-provider.js';
+import { AparteAvatarProvider } from './avatar-provider.js';
+import { AparteLocale } from './locale.js';
+import { AparteAction, AparteActionZone } from './action-provider.js';
+import { AparteSkeletonProvider, AparteSkeletonType } from './skeleton-provider.js';
+import type { AparteStatusRenderer } from './status-renderer.js';
+import type { AparteErrorRenderer } from './error-renderer.js';
+import type { AparteAttachmentRenderer } from './attachment-renderer.js';
+import type { AparteSiblingNavRenderer } from './sibling-nav-renderer.js';
+import type { AparteBubbleShellRenderer } from './bubble-shell-renderer.js';
+import type { AparteAIProvider, AparteAIModel, AparteModelConfig } from '../types/model-provider.js';
+import type { AparteTransport } from '../transport/index.js';
+import type { AparteTool, AparteToolHandler, AparteToolRenderer } from '../types/tools.js';
+import type { AparteBubbleActionsConfig, AparteBubbleActionName } from '../types/models.js';
+import type { ConversationManager } from '../conversations/conversation-manager.js';
+import { type AparteSanitizer } from './sanitize.js';
+import type { AparteElicitationPresenter, AparteElicitationRequest, AparteElicitationResult } from '../elicitation/types.js';
+export type AparteMarkdownProvider = (raw: string) => string;
+export type AparteHighlightProvider = ((code: string, lang: string) => string) | ((code: string, lang: string) => Promise<string>);
+export type AparteSystemPromptVarsProvider = () => Record<string, string>;
+export type AparteLocaleProvider = AparteLocale;
+export type AparteKeyProvider = (providerId: string) => string | Promise<string | undefined> | undefined;
+export interface AparteModelPreference {
+    provider: string;
+    model: string;
+}
+export interface AparteModelPreferenceProvider {
+    /** Called whenever the selected provider+model changes */
+    save: (provider: string, model: string) => void;
+    /** Called on init to restore the previously saved selection. Return null if nothing stored. */
+    load: () => AparteModelPreference | null;
+}
+/**
+ * Incremental Markdown renderer bound to a target element. Created once per
+ * streaming message: tokens are fed via `write()` and parsed + appended to the
+ * DOM incrementally (O(n) total — no full re-parse / innerHTML rebuild on every
+ * token). `end()` flushes any pending text when the stream completes.
+ */
+export interface AparteStreamingMarkdownRenderer {
+    /** Append a chunk of Markdown text — parsed incrementally, appended as DOM nodes. */
+    write(chunk: string): void;
+    /** Finalize the stream (flush any pending text). */
+    end(): void;
+}
+/**
+ * Factory for an {@link AparteStreamingMarkdownRenderer}: given a target element,
+ * returns a renderer that appends parsed Markdown into it. Supplied by an
+ * opt-in provider package (e.g. `@aparte/provider-streaming-markdown`); when none
+ * is registered the chat falls back to the one-shot `AparteMarkdownProvider`.
+ */
+export type AparteStreamingMarkdownProvider = (target: HTMLElement) => AparteStreamingMarkdownRenderer;
+/**
+ * Builds the HTML document used as an artifact preview iframe `srcdoc` for a
+ * given artifact kind (react/html/svg/js/css/…). Supplied by the consuming app
+ * — e.g. a React/Babel/Tailwind live preview that loads those libs from a CDN.
+ * Core ships only a CDN-free fallback (svg/css/html/js render offline; other
+ * kinds degrade to a read-only code view), so the engine stays zero-network and
+ * framework-agnostic. The app opts into richer previews via
+ * {@link AparteConfigClass.setArtifactPreviewBuilder}.
+ */
+export type AparteArtifactPreviewBuilder = (kind: string, body: string, title: string) => string;
+export declare class AparteConfigClass {
+    private _markdownProvider?;
+    private _streamingMarkdownProvider?;
+    private _highlightProvider?;
+    private _sanitizer;
+    private _systemPromptTemplate?;
+    private _systemPromptVarsProvider?;
+    private _skeletonProvider?;
+    private _statusRenderer?;
+    private _errorRenderer?;
+    private _attachmentRenderer?;
+    private _siblingNavRenderer?;
+    private _bubbleShellRenderer?;
+    private _iconProvider?;
+    private _avatarProvider?;
+    private _keyProvider?;
+    private _artifactPreviewBuilder?;
+    private _locale;
+    private _actions;
+    private _listeners;
+    private _aiProviders;
+    private _modelConfig;
+    /** Opt-in: gate the composer (block send + grey out) until a model is selected. */
+    private _requireModelSelection;
+    private _transport;
+    private _modelPreferenceProvider?;
+    private _conversationManager?;
+    private _elicitationPresenter?;
+    private _tools;
+    private _toolRenderers;
+    private _bubbleActionsConfig;
+    /**
+     * Register a custom action button. `zones` places it in the composer toolbar
+     * and/or the message (bubble) toolbar. Re-registering the same id overwrites
+     * it. Notifies mounted elements so they re-render.
+     */
+    registerAction(action: AparteAction): void;
+    /** All registered actions for a zone, sorted by `order` (lower first). */
+    getActions(zone: AparteActionZone): AparteAction[];
+    /** Remove a custom action by id (from every zone); notifies mounted elements if it existed. */
+    unregisterAction(id: string): void;
+    /**
+     * Show or hide a composer action button by id.
+     * Triggers a config update so all mounted composer elements react immediately.
+     */
+    setActionHidden(id: string, hidden: boolean): void;
+    /**
+     * Configure which action buttons appear in message bubbles.
+     * Unset keys keep their defaults (copy=true, retry=true, edit=true, feedback=false).
+     *
+     * @example
+     * AparteConfig.setBubbleActions({ feedback: true })        // enable feedback, keep rest
+     * AparteConfig.setBubbleActions({ retry: false })          // disable retry only
+     * AparteConfig.setBubbleActions({ copy: false, retry: false, edit: false }) // hide all
+     * // Explicit per-role ordered sets (replace the flag defaults for that role):
+     * AparteConfig.setBubbleActions({ user: ['edit', 'copy'], assistant: ['copy', 'thumbUp', 'thumbDown', 'retry'] })
+     */
+    setBubbleActions(config: AparteBubbleActionsConfig): void;
+    /** Returns the resolved bubble actions config (flag defaults applied; per-role sets passed through). */
+    getBubbleActions(): {
+        copy: boolean;
+        retry: boolean;
+        edit: boolean;
+        feedback: boolean;
+        user?: AparteBubbleActionName[];
+        assistant?: AparteBubbleActionName[];
+    };
+    /**
+     * Set a custom Markdown renderer (e.g., marked, maritime-it)
+     */
+    setMarkdownProvider(fn: AparteMarkdownProvider): void;
+    /**
+     * Set an incremental (streaming) Markdown renderer provider. Optional —
+     * when set, the chat bubble uses it to render the assistant message
+     * token-by-token DURING streaming (incremental parse + DOM append, O(n)),
+     * instead of re-parsing the whole string on every token. The one-shot
+     * `setMarkdownProvider` is still used for finished / re-rendered messages.
+     */
+    setStreamingMarkdownProvider(fn: AparteStreamingMarkdownProvider): void;
+    /**
+     * Create an incremental Markdown renderer bound to `target`, or `null` when
+     * no streaming-markdown provider is registered (the caller then falls back
+     * to the one-shot `renderMarkdown`).
+     */
+    createStreamingMarkdownRenderer(target: HTMLElement): AparteStreamingMarkdownRenderer | null;
+    /**
+     * Set a custom Syntax Highlighter (e.g., prism, highlight.js, shiki)
+     * Supports both synchronous and asynchronous renderers.
+     */
+    setHighlightProvider(fn: AparteHighlightProvider): void;
+    /**
+     * Whether a syntax-highlight provider is registered. Lets consumers (e.g.
+     * the bubble) skip the highlight pass — and avoid replacing already-rendered
+     * code blocks with the plain fallback — when no highlighter is installed.
+     */
+    hasHighlightProvider(): boolean;
+    /**
+     * Replace or disable the HTML sanitizer applied to markdown/highlight
+     * provider output before it is injected into the DOM. Defaults to a built-in
+     * zero-dependency allowlist sanitizer.
+     *
+     * @param sanitizer A sanitizer function (e.g. a DOMPurify wrapper) for
+     *   hardened coverage, or `null` to DISABLE sanitization. Disabling exposes
+     *   you to XSS from LLM-authored content — only do so for content you fully
+     *   trust and have already sanitized upstream.
+     * @example AparteConfig.setHtmlSanitizer((html) => DOMPurify.sanitize(html));
+     */
+    setHtmlSanitizer(sanitizer: AparteSanitizer | null): void;
+    /**
+     * Run the active sanitizer over provider-produced HTML. Public so a
+     * streaming-markdown provider (which appends DOM directly, bypassing
+     * `renderMarkdown`) can apply the same policy. Returns the input unchanged
+     * only when sanitization was disabled via `setHtmlSanitizer(null)`.
+     */
+    sanitizeHtml(html: string): string;
+    /**
+     * Set the system prompt template. Supports `{{key}}` placeholders resolved via setSystemPromptVarsProvider.
+     * Pass undefined to clear.
+     */
+    setSystemPrompt(template: string | undefined): void;
+    /** Get the raw system prompt template (with unresolved placeholders). */
+    getSystemPromptTemplate(): string | undefined;
+    /**
+     * Register a function that returns a map of variable name → value.
+     * Called at request time to resolve `{{key}}` placeholders in the system prompt.
+     * Example: () => ({ 'settings.lang': 'French' })
+     */
+    setSystemPromptVarsProvider(fn: AparteSystemPromptVarsProvider): void;
+    /**
+     * Resolve the system prompt template by substituting all `{{key}}` placeholders.
+     * Returns null if no template is set or the template is empty after trimming.
+     */
+    resolveSystemPrompt(): string | null;
+    /**
+     * Set a custom Skeleton generator for loading states
+     * @param provider Object implementing AparteSkeletonProvider interface
+     */
+    setSkeletonProvider(provider: AparteSkeletonProvider): void;
+    /**
+     * Set a custom Icon provider (e.g., Lucide, FontAwesome, Material)
+     * @param provider Object implementing AparteIconProvider interface
+     */
+    setIconProvider(provider: AparteIconProvider): void;
+    /**
+     * Register an artifact preview builder (app-level). When set, the artifact
+     * renderer uses it to build the preview iframe `srcdoc`; when unset, core's
+     * CDN-free fallback is used. This is how the product opts into a
+     * React/Babel/Tailwind live preview without leaking those into core.
+     */
+    setArtifactPreviewBuilder(builder: AparteArtifactPreviewBuilder): void;
+    /** The registered artifact preview builder, or undefined for the core fallback. */
+    getArtifactPreviewBuilder(): AparteArtifactPreviewBuilder | undefined;
+    /**
+     * Get the current icon provider, or a proxy that falls back to DEFAULT_ICON_FALLBACKS
+     */
+    getIconProvider(): AparteIconProvider;
+    /**
+     * Set a custom avatar renderer. Lets framework consumers (Angular,
+     * React, Vue, …) mount live components in place of the default
+     * avatar text/image. Cleared by passing `null`.
+     */
+    setAvatarProvider(provider: AparteAvatarProvider | null): void;
+    /** Returns the registered avatar provider, or null if none. */
+    getAvatarProvider(): AparteAvatarProvider | null;
+    /**
+     * Set a custom typing-indicator renderer. Replaces the inner markup of
+     * `<aparte-chat-status>` (avatar + animated dots + text) while the element keeps
+     * owning show/hide. Return a string or an HTMLElement. Cleared by passing
+     * `null`. Notifies mounted components so a live skin switch re-renders.
+     */
+    setStatusRenderer(renderer: AparteStatusRenderer | null): void;
+    /** Returns the registered status renderer, or null if none. */
+    getStatusRenderer(): AparteStatusRenderer | null;
+    /**
+     * Set a custom error renderer. Drives the content of error bubbles (the
+     * built-in `error` segment) — return a string or an HTMLElement, e.g. a
+     * friendly message with a retry button. The bubble also carries `data-error`
+     * on its `.aparte-message` while errored, for CSS theming. Cleared with `null`.
+     * Notifies mounted components so a live change re-renders.
+     */
+    setErrorRenderer(renderer: AparteErrorRenderer | null): void;
+    /** Returns the registered error renderer, or null if none. */
+    getErrorRenderer(): AparteErrorRenderer | null;
+    /**
+     * Set a custom attachment renderer. Replaces the chip rendered for each
+     * attachment on a user message (default: image thumbnail / file chip) — return
+     * a string or an HTMLElement, e.g. a PDF preview. You own the interactions for
+     * custom output (see {@link AparteAttachmentRenderer}). Cleared with `null`.
+     * Notifies mounted components so a live change re-renders.
+     */
+    setAttachmentRenderer(renderer: AparteAttachmentRenderer | null): void;
+    /** Returns the registered attachment renderer, or null if none. */
+    getAttachmentRenderer(): AparteAttachmentRenderer | null;
+    /**
+     * Set a custom sibling (branch) position indicator. Replaces the `‹ N / M ›`
+     * counter between the prev/next arrows — e.g. dots. Return a string or an
+     * HTMLElement (see {@link AparteSiblingNavRenderer}); the arrows keep their
+     * behavior. Cleared with `null`. Notifies mounted components.
+     */
+    setSiblingNavRenderer(renderer: AparteSiblingNavRenderer | null): void;
+    /** Returns the registered sibling-nav renderer, or null if none. */
+    getSiblingNavRenderer(): AparteSiblingNavRenderer | null;
+    /**
+     * Set a custom bubble shell renderer (advanced) — replaces the structural
+     * skeleton of `<aparte-chat-bubble>` while keeping its behavior. The shell must
+     * honor the class-hook contract (root `.aparte-message`, region hooks) — see
+     * {@link AparteBubbleShellRenderer}. For a fully custom element use `renderBubble`
+     * (wrapper) instead. Cleared with `null`. Notifies mounted components.
+     */
+    setBubbleShellRenderer(renderer: AparteBubbleShellRenderer | null): void;
+    /** Returns the registered bubble-shell renderer, or null if none. */
+    getBubbleShellRenderer(): AparteBubbleShellRenderer | null;
+    /**
+     * Set the current locale
+     * @param locale AparteLocale object defining all strings
+     */
+    setLocale(locale: AparteLocale): void;
+    /**
+     * Get the current locale
+     */
+    getLocale(): AparteLocale;
+    /**
+     * Extend the current locale with partial translations.
+     * Useful for plugins to register their own strings.
+     * @param translations Partial locale object to merge
+     */
+    extendLocale(translations: Partial<AparteLocale>): void;
+    /**
+     * Get icon HTML string by name
+     * Falls back to textual representation if no provider is set
+     */
+    getIcon(name: AparteIconName): string;
+    /**
+     * Set a custom Key provider (e.g., AparteVault override)
+     */
+    setKeyProvider(provider: AparteKeyProvider): void;
+    /**
+     * Get API key for a provider
+     */
+    getKey(providerId: string): Promise<string | undefined>;
+    /**
+     * Refresh models for a specific provider
+     * Orchestrates: Key Retrieval -> Fetch -> Return
+     * This keeps UI components unaware of keys.
+     */
+    refreshProviderModels(providerId: string): Promise<AparteAIModel[]>;
+    /**
+     * Register one or more AI providers (e.g., OpenRouter, Gemini, Anthropic)
+     * @param providers AparteAIProvider implementations
+     * @example
+     * AparteConfig.registerAIProvider(OpenRouterProvider);
+     * AparteConfig.registerAIProvider(GeminiProvider, AnthropicProvider);
+     */
+    registerAIProvider(...providers: AparteAIProvider[]): void;
+    /**
+     * Unregister an AI provider
+     */
+    unregisterAIProvider(id: string): void;
+    /**
+     * Get all registered AI providers
+     * Optionally filtered by enabled providers in config
+     */
+    getAIProviders(): AparteAIProvider[];
+    /**
+     * Get a specific AI provider by ID
+     */
+    getAIProvider(id: string): AparteAIProvider | undefined;
+    /**
+     * Set the transport that decides where chat requests go and how auth is
+     * handled. Defaults to {@link DirectTransport} (browser-direct — BYOK/local).
+     * Use a `BackendTransport` to keep API keys server-side (recommended for
+     * production).
+     */
+    setTransport(transport: AparteTransport): void;
+    /** Get the active transport (DirectTransport by default). */
+    getTransport(): AparteTransport;
+    /**
+     * Register a model preference provider for agnostic persistence.
+     * The host app decides how/where to store the selected provider & model.
+     * @example
+     * AparteConfig.setModelPreferenceProvider({
+     *   save: (p, m) => localStorage.setItem('model', JSON.stringify({p, m})),
+     *   load: () => JSON.parse(localStorage.getItem('model') ?? 'null')
+     * });
+     */
+    setModelPreferenceProvider(provider: AparteModelPreferenceProvider): void;
+    /**
+     * Restore previously saved model preference via the registered provider.
+     * Should be called once at app startup, before any component mounts.
+     * No-op if no provider is registered or nothing was saved.
+     */
+    restoreModelPreference(): AparteModelPreference | null;
+    /**
+     * Set model selection configuration
+     */
+    setModelConfig(config: AparteModelConfig): void;
+    /**
+     * Subscribe to configuration changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: () => void): () => void;
+    private _notify;
+    /**
+     * Get current model configuration
+     */
+    getModelConfig(): AparteModelConfig;
+    /**
+     * True when the model config has BOTH a provider and a model selected — i.e.
+     * the chat can actually send. Used by the composer's `require-model` gate.
+     */
+    hasSelectedModel(): boolean;
+    /**
+     * Opt-in UX: when enabled, `<aparte-composer>` blocks sending and greys out
+     * until {@link hasSelectedModel} is true (e.g. while the model selector is
+     * still fetching its list). Off by default so single-model / backend setups
+     * that never select a model are unaffected.
+     */
+    setRequireModelSelection(required: boolean): void;
+    /** Whether the composer should gate on model selection (see {@link setRequireModelSelection}). */
+    getRequireModelSelection(): boolean;
+    /**
+     * Get the currently selected model object, if available synchronously.
+     * Returns undefined if no provider/model is selected, or if the provider's
+     * models are only available asynchronously (fetchModels).
+     */
+    getCurrentModel(): AparteAIModel | undefined;
+    /**
+     * Get translated string by key
+     */
+    t(key: keyof AparteLocale): string;
+    /**
+     * Render Markdown to HTML
+     * Fallback: Escapes HTML and converts newlines to <br>
+     */
+    renderMarkdown(raw: string): string;
+    /**
+     * Highlight code block
+     * Fallback: Returns raw code wrapped in <pre><code>
+     * Supports Promise if provider is async/streaming
+     */
+    highlightCode(code: string, lang: string): Promise<string>;
+    /**
+     * Get HTML for a skeleton loader
+     * Fallback: Simple CSS-animated box
+     */
+    getSkeleton(type: AparteSkeletonType): string;
+    /**
+     * Register a tool and its handler together.
+     * The handler is called when the AI invokes the tool during streaming.
+     * @example
+     * AparteConfig.registerTool(askQuestionTool, askQuestionHandler);
+     */
+    registerTool(tool: AparteTool, handler: AparteToolHandler): void;
+    /** Unregister a tool by name */
+    unregisterTool(name: string): void;
+    /** Get all registered tool definitions (to pass in AparteChatRequest) */
+    getTools(): AparteTool[];
+    /** Get the handler for a tool by name */
+    getToolHandler(name: string): AparteToolHandler | undefined;
+    /**
+     * Register a per-tool segment renderer.
+     * Controls what appears in the chat bubble when the AI calls this tool.
+     * Use this instead of the generic `tool_call` segment renderer for tool-specific UI.
+     *
+     * @example
+     * // Hide the segment entirely (UI-only tool like ask_question)
+     * AparteConfig.registerToolRenderer('ask_question', { render: () => '' });
+     *
+     * @example
+     * // Custom pill for a web-search tool
+     * AparteConfig.registerToolRenderer('web_search', { render: (seg) => `<div class="tool-pill">Searching...</div>` });
+     */
+    registerToolRenderer(toolName: string, renderer: AparteToolRenderer): void;
+    /** Unregister a per-tool renderer */
+    unregisterToolRenderer(toolName: string): void;
+    /** Get the renderer for a specific tool name. Returns undefined if none registered. */
+    getToolRenderer(toolName: string): AparteToolRenderer | undefined;
+    /**
+     * Register a ConversationManager so any UI controller can persist & load
+     * conversations without coupling to a framework wrapper.
+     */
+    setConversationManager(manager: ConversationManager): void;
+    /** Returns the registered ConversationManager, or undefined if none. */
+    getConversationManager(): ConversationManager | undefined;
+    /**
+     * Register the presenter that renders typed input requests (a choice, a
+     * confirmation, a text field, a form) and resolves with the user's answer.
+     * The `<aparte-elicitation>` Web Component registers itself here; an app can
+     * override with its own framework-native presenter. Pass `null` to clear.
+     */
+    setElicitationPresenter(presenter: AparteElicitationPresenter | null): void;
+    /** The registered elicitation presenter, or undefined if none. */
+    getElicitationPresenter(): AparteElicitationPresenter | undefined;
+    /**
+     * Ask the user for typed input mid-run and await their response. This is the
+     * generic primitive behind `ask_question` and tool approval — the KIND of
+     * question is the schema, not a bespoke tool. Resolves `accept` with the
+     * value, `decline` when the user declines, or `cancel` when the turn is
+     * cancelled. With no presenter registered it resolves `cancel` (nothing can
+     * present it) rather than hanging.
+     */
+    requestUserInput(request: AparteElicitationRequest): Promise<AparteElicitationResult>;
+    /**
+     * Reset ALL configuration back to defaults — providers, registries, model
+     * selection and bubble actions. Previously left `_aiProviders` / `_tools` /
+     * `_toolRenderers` / `_modelConfig` behind, which leaked across SPA
+     * navigations (registries only ever grew). Now a full reset.
+     */
+    reset(): void;
+    private _defaultMarkdownRenderer;
+    private _defaultHighlightRenderer;
+    private _defaultSkeletonRenderer;
+    private _escapeHtml;
+}
+/**
+ * Global configuration singleton for Aparte.
+ * Use this to register providers and configure behavior.
+ */
+export declare const AparteConfig: AparteConfigClass;
+//# sourceMappingURL=aparte-config.d.ts.map

package/dist/config/aparte-config.d.ts.map

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

package/dist/config/attachment-renderer.d.ts

@@ -0,0 +1,28 @@
+import type { AparteAttachment } from '../types/models.js';
+/**
+ * Attachment Renderer
+ *
+ * Replace the chip rendered for each attachment on a user message — the default
+ * is an image thumbnail or a file chip (extension + name). Return an HTML
+ * **string** or a ready **HTMLElement** (charter §6 render hooks:
+ * `string | HTMLElement`), e.g. a PDF page preview, an audio player, or a richer
+ * card. Called once per attachment.
+ *
+ * When you provide a renderer you own the markup AND the interactions: the
+ * built-in image-tile click that dispatches `aparte-attachment-preview` is NOT
+ * wired for custom output — dispatch it yourself (bubbles, composed) or handle
+ * clicks your own way.
+ *
+ * @example
+ * AparteConfig.setAttachmentRenderer((att) => {
+ *   if (att.type === 'application/pdf') {
+ *     const el = document.createElement('div');
+ *     el.className = 'my-pdf-chip';
+ *     el.textContent = att.name;
+ *     return el;
+ *   }
+ *   return `<div class="my-file">${att.name}</div>`;
+ * });
+ */
+export type AparteAttachmentRenderer = (attachment: AparteAttachment) => string | HTMLElement;
+//# sourceMappingURL=attachment-renderer.d.ts.map

package/dist/config/attachment-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-renderer.d.ts","sourceRoot":"","sources":["../../src/config/attachment-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,MAAM,GAAG,WAAW,CAAC"}

package/dist/config/avatar-provider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Avatar Provider Interface
+ *
+ * Defines the contract for plugging custom avatar rendering into chat
+ * messages. Unlike the icon provider (which returns HTML strings), the
+ * avatar provider receives the live host element and fills it with
+ * whatever DOM the consumer wants — including framework components
+ * mounted via createComponent (Angular), createRoot (React), etc.
+ *
+ * @example
+ * AparteConfig.setAvatarProvider({
+ *   render: (role, host) => {
+ *     if (role === 'assistant') {
+ *       const ref = createComponent(MascotComponent, { hostElement: host });
+ *       ref.setInput('variant', 'classic');
+ *       return () => ref.destroy();
+ *     }
+ *     host.textContent = 'You';
+ *   },
+ * });
+ */
+export interface AparteAvatarProvider {
+    /**
+     * Fill the avatar host element with custom DOM.
+     *
+     * @param role  - The message role this avatar represents.
+     * @param host  - The `.aparte-avatar` element. Already styled (size, radius)
+     *                via CSS variables. The provider owns its inner content.
+     * @returns     - Optional cleanup function. Called when the message is
+     *                detached or re-rendered, so live components can be
+     *                disposed cleanly.
+     */
+    render(role: 'user' | 'assistant', host: HTMLElement): void | (() => void);
+}
+//# sourceMappingURL=avatar-provider.d.ts.map

package/dist/config/avatar-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-provider.d.ts","sourceRoot":"","sources":["../../src/config/avatar-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CAC9E"}

package/dist/config/bubble-shell-renderer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Bubble-Shell Renderer (advanced)
+ *
+ * Replace the *structural skeleton* of `<aparte-chat-bubble>` — the markup the
+ * bubble renders once and then populates — while keeping all of its behavior
+ * (segments, streaming, action bar, avatar, branch picker). This is the
+ * whole-structure override that {@link https://…} `renderBubble` (wrapper-level,
+ * replaces the element entirely) is not: here the native bubble stays in charge.
+ *
+ * Return an HTML **string** or a ready **HTMLElement** (charter §6:
+ * `string | HTMLElement`). Because the bubble queries known class hooks after
+ * rendering the shell, your shell MUST honor this contract:
+ *
+ * - Root element **must** be `.aparte-message` (it carries `data-role` and receives
+ *   `data-streaming` / `data-error`; the styles target it).
+ * - Include the region hooks you want the bubble to populate. Any you omit simply
+ *   stay empty (every lookup is null-guarded — graceful degradation):
+ *   - `.aparte-avatar`         — filled by the avatar provider / initial
+ *   - `.aparte-name`           — the display name (you set it from `ctx.name`)
+ *   - `.aparte-timestamp`      — the formatted time
+ *   - `.aparte-attachments`    — user-message attachment chips
+ *   - `.aparte-segments`       — streamed/structured segments
+ *   - `.aparte-content`        — simple markdown content
+ *   - `.aparte-action-bar`     — copy/retry/edit/… + custom actions
+ *   - `.aparte-branch-picker`  — with `.aparte-branch-prev` / `.aparte-branch-label` /
+ *                              `.aparte-branch-next` for sibling navigation
+ *
+ * Prefer `renderBubble` (wrapper) when you want a fully custom element; use this
+ * when you want to keep the native bubble's machinery but reshape its layout.
+ *
+ * @param ctx.role          - 'user' | 'assistant'.
+ * @param ctx.name          - Display name for the header.
+ * @param ctx.avatarInitial - Default one-letter avatar fallback.
+ * @returns HTML string or a DOM element whose root is `.aparte-message`.
+ */
+export type AparteBubbleShellRenderer = (ctx: {
+    role: 'user' | 'assistant';
+    name: string;
+    avatarInitial: string;
+}) => string | HTMLElement;
+//# sourceMappingURL=bubble-shell-renderer.d.ts.map

package/dist/config/bubble-shell-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble-shell-renderer.d.ts","sourceRoot":"","sources":["../../src/config/bubble-shell-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE;IAC1C,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACzB,KAAK,MAAM,GAAG,WAAW,CAAC"}