@aparte/core 0.2.0-alpha.0

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

@@ -0,0 +1,47 @@
+/**
+ * Per-instance config resolution (Phase 2, step 1 — the seam only).
+ *
+ * `AparteConfig` is a global singleton: one config for the whole page. That makes
+ * two independent chats on one page impossible (changing the model of one
+ * changes the other) and couples every component to global state.
+ *
+ * This module adds an OPTIONAL instance boundary without touching behaviour:
+ * a host element can carry its own {@link AparteConfigClass} instance, and any
+ * component resolves "its" config by walking up to the nearest such host —
+ * falling back to the global singleton when there is none. Until a caller
+ * attaches an instance config, `resolveConfig` always returns the global, so
+ * single-chat apps are unaffected.
+ *
+ * Step 2 migrates the ~23 component read-sites from `AparteConfig.x()` to
+ * `resolveConfig(this).x()`. This step just ships the mechanism + tests.
+ */
+import { AparteConfigClass } from './aparte-config.js';
+/** Marks an element as an instance-config boundary (used by `closest()`). */
+export declare const APARTE_HOST_ATTR = "data-aparte-host";
+/**
+ * Attach an instance config to `el`, making it a resolution boundary: every
+ * component inside `el` resolves to `config` instead of the global singleton.
+ * Idempotent; pass the same element to replace its config.
+ */
+export declare function attachConfig(el: HTMLElement, config: AparteConfigClass): void;
+/**
+ * Remove the instance-config boundary from `el` (e.g. in `disconnectedCallback`).
+ * Components under `el` fall back to the next boundary up, or the global.
+ */
+export declare function detachConfig(el: HTMLElement): void;
+/**
+ * Resolve the config governing `el`: the nearest ancestor boundary's instance
+ * config (including `el` itself), or the global {@link AparteConfig} when none is
+ * present. Cheap — a single `closest()` — but callers should cache the result at
+ * `connectedCallback` rather than call it per render.
+ */
+export declare function resolveConfig(el: Element | null | undefined): AparteConfigClass;
+/** Run `fn` with `config` as the ambient render config (restored after). */
+export declare function runWithConfig<T>(config: AparteConfigClass, fn: () => T): T;
+/**
+ * The ambient render config set by {@link runWithConfig}, else the config
+ * resolved from `el` (when provided), else the global singleton. Capture it
+ * synchronously at the top of a renderer — never after an `await`.
+ */
+export declare function contextConfig(el?: Element | null): AparteConfigClass;
+//# sourceMappingURL=config-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-context.d.ts","sourceRoot":"","sources":["../../src/config/config-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAgB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErE,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AASnD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAG7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAGlD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAG/E;AAWD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,iBAAiB,CAEpE"}

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

@@ -0,0 +1,26 @@
+/**
+ * Error Renderer
+ *
+ * Replace the content of an error bubble — the default is an icon + "Error" title
+ * + message (+ details). Return an HTML **string** or a ready **HTMLElement**
+ * (charter §6 render hooks: `string | HTMLElement`), e.g. a friendly message with
+ * your own "Try again" button. This drives the built-in `error` segment renderer,
+ * so it's the one place to customize error UI (rather than registering a segment
+ * renderer for the `error` type yourself). The bubble also reflects `data-error`
+ * on its `.aparte-message` while an error segment is present, for CSS theming.
+ *
+ * @example
+ * AparteConfig.setErrorRenderer(({ message }) => {
+ *   const el = document.createElement('div');
+ *   el.className = 'my-error';
+ *   el.textContent = `Something went wrong: ${message}`;
+ *   return el;
+ * });
+ */
+export type AparteErrorRenderer = (ctx: {
+    /** Human-readable error message (the error segment's content). */
+    message: string;
+    /** Optional error code/details (the error segment's `details`). */
+    details?: string;
+}) => string | HTMLElement;
+//# sourceMappingURL=error-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.d.ts","sourceRoot":"","sources":["../../src/config/error-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE;IACpC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,KAAK,MAAM,GAAG,WAAW,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Icon Provider Interface
+ *
+ * Defines the contract for icon plugins.
+ * Returns HTML strings: SVG, <i> tags, emojis, or any valid HTML.
+ *
+ * @example
+ * // Register an icon provider (e.g. a FontAwesome bridge)
+ * AparteConfig.setIconProvider({
+ *   copy: () => '<i class="fas fa-copy"></i>',
+ *   check: () => '<i class="fas fa-check"></i>',
+ *   // ...
+ * });
+ */
+export interface AparteIconProvider {
+    /** Copy button icon */
+    copy: () => string;
+    /** Success/check icon */
+    check: () => string;
+    /** Send message icon */
+    send: () => string;
+    /** Loading/spinner indicator */
+    loading: () => string;
+    /** Error indicator */
+    error: () => string;
+    /** Expand/show more icon */
+    expand: () => string;
+    /** Collapse/show less icon */
+    collapse: () => string;
+    /** Terminal/command prompt icon */
+    terminal: () => string;
+    /** File attachment / paperclip icon (used by upload plugin) */
+    paperclip: () => string;
+    /** Image file icon (used by upload plugin) */
+    image: () => string;
+    /** Generic file icon (used by upload plugin) */
+    file: () => string;
+    /** Scroll to bottom button icon */
+    scrollDown: () => string;
+    /** Retry / regenerate icon */
+    retry: () => string;
+    /** Edit / pencil icon */
+    edit: () => string;
+    /** Thumbs up / positive feedback icon */
+    thumbUp: () => string;
+    /** Thumbs down / negative feedback icon */
+    thumbDown: () => string;
+    /** Previous branch arrow */
+    prevBranch: () => string;
+    /** Next branch arrow */
+    nextBranch: () => string;
+    /** Tool call indicator (wrench) — optional so existing providers stay valid */
+    tool?: () => string;
+    /** Close / failed / rejected (✕) — optional so existing providers stay valid */
+    close?: () => string;
+    /** Stop / halt streaming (■) — optional so existing providers stay valid */
+    stop?: () => string;
+}
+/** Icon names available in the provider */
+export type AparteIconName = keyof AparteIconProvider;
+/** Default textual fallbacks - zero dependency */
+export declare const DEFAULT_ICON_FALLBACKS: Record<AparteIconName, string>;
+//# sourceMappingURL=icon-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icon-provider.d.ts","sourceRoot":"","sources":["../../src/config/icon-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,wBAAwB;IACxB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,gDAAgD;IAChD,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,yBAAyB;IACzB,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,wBAAwB;IACxB,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC;AAEtD,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAsBjE,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,19 @@
+export { AparteConfig, AparteConfigClass } from './aparte-config.js';
+export { resolveConfig, attachConfig, detachConfig, runWithConfig, contextConfig, APARTE_HOST_ATTR } from './config-context.js';
+export type { AparteMarkdownProvider, AparteStreamingMarkdownProvider, AparteStreamingMarkdownRenderer, AparteHighlightProvider, AparteSystemPromptVarsProvider, AparteModelPreference, AparteModelPreferenceProvider, AparteArtifactPreviewBuilder } from './aparte-config.js';
+export type { AparteSanitizer } from './sanitize.js';
+export { defaultSanitizer, isSafeUrl } from './sanitize.js';
+export type { AparteIconProvider, AparteIconName } from './icon-provider.js';
+export { DEFAULT_ICON_FALLBACKS } from './icon-provider.js';
+export type { AparteSkeletonType, AparteSkeletonProvider } from './skeleton-provider.js';
+export { DEFAULT_SKELETON_FALLBACKS } from './skeleton-provider.js';
+export type { AparteAvatarProvider } from './avatar-provider.js';
+export type { AparteStatusRenderer } from './status-renderer.js';
+export type { AparteErrorRenderer } from './error-renderer.js';
+export type { AparteAttachmentRenderer } from './attachment-renderer.js';
+export type { AparteSiblingNavRenderer } from './sibling-nav-renderer.js';
+export type { AparteBubbleShellRenderer } from './bubble-shell-renderer.js';
+export type { AparteLocale } from './locale.js';
+export { DEFAULT_LOCALE } from './locale.js';
+export type { AparteAction, AparteActionZone } from './action-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAChI,YAAY,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAChR,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/config/locale.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Aparte Locale Interface
+ *
+ * Defines all translatable strings for the chat interface.
+ * The core keeps only the English default in memory.
+ * Other languages are injected via AparteConfig.setLocale().
+ */
+export interface AparteLocale {
+    inputPlaceholder: string;
+    sendButton: string;
+    copy: string;
+    copied: string;
+    retry: string;
+    thinking: string;
+    typing: string;
+    error: string;
+    running: string;
+    run: string;
+    file: string;
+    /** Display name shown above the user's messages (default: "You") */
+    roleNameUser: string;
+    /** Display name shown above the assistant's messages (default: "Assistant") */
+    roleNameAssistant: string;
+    yourMessage: string;
+    assistantResponse: string;
+    messageActions: string;
+    edit: string;
+    editConfirm: string;
+    editCancel: string;
+    feedbackPositive: string;
+    feedbackNegative: string;
+    previousResponse: string;
+    nextResponse: string;
+    /** Approve button on a tool awaiting human approval (default: "Approve") */
+    approveTool?: string;
+    /** Reject button on a tool awaiting human approval (default: "Reject") */
+    rejectTool?: string;
+    /** Short suffix for tokens-per-second perf chip (default: "tok/s") */
+    tokensPerSecondLabel?: string;
+    /** Aria-label / tooltip for the message info ("i") action button (default: "Details") */
+    messageInfo?: string;
+    /** Default title for a new conversation (default: "New Chat") */
+    newChat: string;
+    /** Aria-label for the delete conversation button (default: "Delete conversation") */
+    deleteConversation: string;
+    /** Aria-label for the archive conversation button (default: "Archive conversation") */
+    archiveConversation?: string;
+    /** Aria-label for the unarchive conversation button (default: "Unarchive conversation") */
+    unarchiveConversation?: string;
+    /** Direction of the text (ltr or rtl) - defaults to ltr */
+    direction?: 'ltr' | 'rtl';
+    /** Allow extensions for plugins */
+    [key: string]: string | undefined;
+}
+/**
+ * Default English Locale (Zero-dependency)
+ * Hardcoded to ensure the core works out-of-the-box.
+ */
+export declare const DEFAULT_LOCALE: AparteLocale;
+//# sourceMappingURL=locale.d.ts.map

package/dist/config/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/config/locale.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAEzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IAGnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAGd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAGhB,GAAG,EAAE,MAAM,CAAC;IAGZ,IAAI,EAAE,MAAM,CAAC;IAGb,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAC;IAG1B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IAGvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAE1B,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAkC5B,CAAC"}

package/dist/config/sanitize.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Zero-dependency HTML sanitizer for provider output.
+ *
+ * Aparte renders LLM-authored content: a markdown or highlight provider turns the
+ * assistant's text into HTML that is then injected via `innerHTML`. Prompt
+ * injection can make a model emit arbitrary markup (`<img onerror=…>`,
+ * `<script>`, `javascript:` URLs), so that HTML is **untrusted** and must be
+ * scrubbed before it touches the DOM.
+ *
+ * This is an allowlist sanitizer built on the browser's own parser: the HTML is
+ * parsed into an inert document (scripts never execute during
+ * `DOMParser.parseFromString`), the tree is rebuilt keeping only known-safe tags
+ * and attributes, then re-serialized. It is deliberately conservative and covers
+ * the realistic threat model (LLM-emitted markup). For hardened, audited
+ * coverage, register DOMPurify via `AparteConfig.setHtmlSanitizer`.
+ */
+export type AparteSanitizer = (html: string) => string;
+/**
+ * True when a URL is safe to place in a `href`/`src` attribute. Exported so a
+ * streaming renderer (which bypasses the one-shot `sanitizeHtml`) can apply the
+ * same URL policy live. `tag` is the host element ('a', 'img', …) — `data:image`
+ * URLs are only allowed on `img`.
+ */
+export declare function isSafeUrl(value: string, tag: string): boolean;
+/**
+ * The built-in sanitizer. Parses `html` with the platform DOMParser, rebuilds an
+ * allowlisted tree, and re-serializes it. Falls back to a regex scrub only when
+ * no DOMParser exists (non-browser runtime).
+ */
+export declare const defaultSanitizer: AparteSanitizer;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/config/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/config/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AA0DvD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ7D;AAkGD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAY9B,CAAC"}

package/dist/config/sibling-nav-renderer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Sibling-Nav Renderer
+ *
+ * Replace the branch position indicator — the default `‹ N / M ›` counter between
+ * the prev/next arrows — e.g. with a row of dots. Return an HTML **string**
+ * (multiple roots allowed, set via innerHTML) or a single **HTMLElement**
+ * (charter §6 render hooks: `string | HTMLElement`). Called whenever the active
+ * sibling / count changes.
+ *
+ * The prev/next arrows and their behavior (dispatching `aparte-branch-navigate`) are
+ * kept — this hook customizes only the indicator. For click-to-jump navigation,
+ * dispatch your own events / use the imperative API from your rendered output.
+ *
+ * @example
+ * AparteConfig.setSiblingNavRenderer(({ count, index }) =>
+ *   Array.from({ length: count }, (_, i) =>
+ *     `<span class="dot${i === index ? ' active' : ''}"></span>`).join(''));
+ *
+ * @param ctx.count - Total number of siblings (> 1 when a picker shows).
+ * @param ctx.index - 0-based index of the active sibling.
+ * @returns HTML string or a DOM element for the indicator.
+ */
+export type AparteSiblingNavRenderer = (ctx: {
+    count: number;
+    index: number;
+}) => string | HTMLElement;
+//# sourceMappingURL=sibling-nav-renderer.d.ts.map

package/dist/config/sibling-nav-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sibling-nav-renderer.d.ts","sourceRoot":"","sources":["../../src/config/sibling-nav-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,GAAG,WAAW,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Skeleton Provider Interface
+ *
+ * Defines the contract for skeleton/loading state plugins.
+ * Returns HTML strings for various loading states.
+ *
+ * @example
+ * // Register a skeleton provider (e.g. an Angular ngx-skeleton-loader bridge)
+ * AparteConfig.setSkeletonProvider({
+ *   message: () => '<ngx-skeleton-loader count="3"></ngx-skeleton-loader>',
+ *   code: () => '<ngx-skeleton-loader appearance="line" count="5"></ngx-skeleton-loader>',
+ *   // ...
+ * });
+ */
+/** Skeleton types available in the provider */
+export type AparteSkeletonType = 'message' | 'code' | 'thinking' | 'input' | 'list' | 'text';
+export interface AparteSkeletonProvider {
+    /** Get skeleton HTML for a specific type */
+    getSkeleton: (type: AparteSkeletonType) => string;
+}
+/**
+ * Minimal fallback skeletons - zero CSS animations, just structure
+ * Used when no skeleton plugin is installed
+ */
+export declare const DEFAULT_SKELETON_FALLBACKS: Record<AparteSkeletonType, string>;
+//# sourceMappingURL=skeleton-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-provider.d.ts","sourceRoot":"","sources":["../../src/config/skeleton-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GACxB,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,MAAM,GACN,MAAM,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACnC,4CAA4C;IAC5C,WAAW,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,MAAM,CAAC;CACrD;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAOzE,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Status Renderer
+ *
+ * Replace the typing indicator's inner markup — the default is an assistant
+ * avatar slot + animated dots + optional text. Return an HTML **string** or a
+ * ready **HTMLElement** (charter §6 render hooks: `string | HTMLElement`). The
+ * `<aparte-chat-status>` container keeps owning show/hide (via the `visible`
+ * attribute) and the accessible name, so you supply only the visual.
+ *
+ * @example
+ * // A custom spinner, driven by the typing text.
+ * AparteConfig.setStatusRenderer((text) => {
+ *   const el = document.createElement('div');
+ *   el.className = 'my-typing';
+ *   el.textContent = text;
+ *   return el;
+ * });
+ *
+ * @param text - The typing text (from the `text` attribute, default "Typing").
+ * @returns HTML string or a DOM element to place inside the status container.
+ */
+export type AparteStatusRenderer = (text: string) => string | HTMLElement;
+//# sourceMappingURL=status-renderer.d.ts.map

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

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

package/dist/conversations/conversation-controller.d.ts

@@ -0,0 +1,126 @@
+import type { AparteMessage } from '../types/index.js';
+import type { ConversationManager } from './conversation-manager.js';
+import type { ExportedMessageRepository } from '../runtime/message-repository.js';
+/**
+ * Abstract binding between a chat UI and the conversation lifecycle.
+ *
+ * Each framework wrapper (Angular, React, Vue, Svelte) provides an
+ * implementation that knows how to mutate its own message list. The
+ * controller orchestrates loading, persistence and abort using only this
+ * interface, keeping the conversation engine fully framework-agnostic.
+ */
+export interface AparteChatBinding {
+    /** Stable id of the host element (used as `targetId` for scoped events). */
+    readonly hostId: string;
+    /** The element that emits/receives `aparte-send` and `aparte-path-changed`. */
+    readonly host: HTMLElement;
+    /** Replace the entire message list (used when switching conversations). */
+    setMessages(messages: AparteMessage[]): void;
+    /** Append a single message (used for the optimistic user-msg on send). */
+    appendMessage(message: AparteMessage): void;
+    /** Read the current message list. */
+    getMessages(): AparteMessage[];
+    /** Clear all messages (e.g. when starting a new conversation). */
+    clearMessages(): void;
+    /**
+     * Export the full conversation tree for persistence.
+     * Optional: only available when the binding wraps a `MessageRepository`
+     * (e.g. the vanilla viewport). Returns `undefined` when not supported.
+     */
+    exportTree?(): ExportedMessageRepository | undefined;
+    /**
+     * Import a previously-persisted tree snapshot, restoring full branch
+     * topology. Called by the controller after `setMessages` (which handles
+     * cleanup) when the loaded conversation carries a `tree` field.
+     * Optional: falls back to the flat `setMessages` load when absent.
+     */
+    importTree?(tree: ExportedMessageRepository): void;
+}
+export interface AparteConversationControllerOptions {
+    /**
+     * Conversation manager. If omitted, the controller resolves it from
+     * `AparteConfig.getConversationManager()` when first needed.
+     */
+    manager?: ConversationManager;
+    /**
+     * Called whenever a new conversation is created lazily (on first user
+     * message in an empty thread). Useful for the parent app to sync the URL.
+     */
+    onConversationCreated?: (id: string) => void;
+}
+/**
+ * Connects an `AparteChatBinding` to a `ConversationManager`.
+ *
+ * Responsibilities:
+ *   - Load messages when `setConversationId(id)` is called.
+ *   - Lazily create a conversation on the first user `aparte-send` if none active.
+ *   - Persist updates triggered by `aparte-path-changed` (branch nav, retry, edit).
+ *   - Dispatch `aparte-abort` when the active conversation changes mid-stream.
+ *
+ * Usage:
+ * ```ts
+ * const controller = new AparteConversationController(binding);
+ * const stop = controller.bind();
+ * controller.setConversationId('abc-123');
+ * // …
+ * stop();
+ * ```
+ */
+export declare class AparteConversationController {
+    private _binding;
+    private _options;
+    private _activeId;
+    private _isStreaming;
+    private _isLoadingConversation;
+    private _ensureInFlight;
+    private _onSendCapture;
+    private _onPathChanged;
+    private _onMessageStart;
+    private _onMessageDone;
+    private _onMessageError;
+    private _onMessageAborted;
+    private _onSelectConversation;
+    private _unsubscribeManager;
+    constructor(binding: AparteChatBinding, options?: AparteConversationControllerOptions);
+    /** The current active conversation id (null when none selected). */
+    get activeId(): string | null;
+    /**
+     * Lazily resolve the conversation manager. Returns `undefined` if none is
+     * registered — the controller then runs in degraded mode: optimistic UI
+     * still works (user message is appended) but no persistence happens. This
+     * keeps backward compatibility with hosts that haven't opted into the
+     * conversation lifecycle yet.
+     */
+    private _manager;
+    /**
+     * Attach event listeners to the binding host. Returns an unbind function.
+     */
+    bind(): () => void;
+    /** Detach event listeners. */
+    unbind(): void;
+    /**
+     * Switch to (or clear) the active conversation.
+     *  - `null`: clears the binding and deselects in the manager.
+     *  - any id: loads the conversation's messages into the binding.
+     *
+     * Idempotent: calling with the current id forces a re-snapshot from the
+     * manager (handy when external mutations could have desynchronised the
+     * binding, or when a user re-selects the already-active conv from a
+     * sidebar). Streams are only aborted on an actual id change so a same-id
+     * reload never kills an in-flight response.
+     */
+    setConversationId(id: string | null): Promise<void>;
+    /**
+     * Snapshot the binding's current messages and push them to the manager.
+     * No-op when there is no active conversation or no manager registered.
+     * Idempotent: safe to call multiple times in a row.
+     *
+     * Any message whose status is 'streaming' or 'pending' at persist-time is
+     * normalised to 'completed' so that reloading the conversation does not
+     * re-enter streaming UI (caret, spinner, no action buttons) for content
+     * that was partially written before a switch or component destruction.
+     */
+    private _persistActive;
+    private _ensureConversationAndPersist;
+}
+//# sourceMappingURL=conversation-controller.d.ts.map

package/dist/conversations/conversation-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-controller.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAGlF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,2EAA2E;IAC3E,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC7C,0EAA0E;IAC1E,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C,qCAAqC;IACrC,WAAW,IAAI,aAAa,EAAE,CAAC;IAC/B,kEAAkE;IAClE,aAAa,IAAI,IAAI,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,IAAI,yBAAyB,GAAG,SAAS,CAAC;IACrD;;;;;OAKG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,mCAAmC;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,4BAA4B;IACrC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,qBAAqB,CAAqC;IAClE,OAAO,CAAC,mBAAmB,CAA6B;gBAE5C,OAAO,EAAE,iBAAiB,EAAE,OAAO,GAAE,mCAAwC;IAKzF,oEAAoE;IACpE,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACH,IAAI,IAAI,MAAM,IAAI;IAoIlB,8BAA8B;IAC9B,MAAM,IAAI,IAAI;IA2Cd;;;;;;;;;;OAUG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoHzD;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;YA2BR,6BAA6B;CAiD9C"}

package/dist/conversations/conversation-manager.d.ts

@@ -0,0 +1,98 @@
+import type { AparteMessage } from '../types/index.js';
+import type { AparteConversation, AparteStorageAdapter } from './types.js';
+import type { ExportedMessageRepository } from '../runtime/message-repository.js';
+type Listener = (conversations: AparteConversation[]) => void;
+export interface ConversationManagerOptions {
+    /**
+     * Opt-in history retention. When set, `updateMessages()` trims a persisted
+     * conversation to at most `maxMessages` on the active path (dropping the
+     * oldest history and the branches hanging off it) before writing to storage.
+     * Omit for unbounded history (the default) — retention is a deliberate
+     * consumer choice, never silent.
+     */
+    retention?: {
+        maxMessages: number;
+    };
+}
+/**
+ * Pure retention transform: keep at most `maxMessages` on the active path.
+ *
+ * Keeps the subtree rooted at the new-oldest kept message (so recent history AND
+ * recent branches survive) and drops everything before it. Exported for testing.
+ */
+export declare function applyRetention(messages: AparteMessage[], tree: ExportedMessageRepository | undefined, maxMessages: number): {
+    messages: AparteMessage[];
+    tree: ExportedMessageRepository | undefined;
+};
+/**
+ * Framework-agnostic conversation manager.
+ *
+ * Usage:
+ * ```ts
+ * const manager = new ConversationManager(myAdapter);
+ * await manager.init();                    // load from storage
+ * const conv = await manager.createNew(); // returns new AparteConversation
+ * ```
+ *
+ * The manager emits synchronous notifications to registered listeners on every
+ * mutation so framework wrappers (Angular signals, Vue reactive, etc.) can
+ * react without polling.
+ */
+export declare class ConversationManager {
+    private _adapter;
+    private _conversations;
+    private _activeId;
+    private _listeners;
+    private _initialized;
+    private _retention;
+    constructor(adapter: AparteStorageAdapter, options?: ConversationManagerOptions);
+    /** Load all conversations from the adapter. Call once at app startup. */
+    init(): Promise<void>;
+    /**
+     * Whether `init()` has completed at least once. Consumers use this to
+     * distinguish "manager still hydrating from storage" from "manager
+     * hydrated, conversations is genuinely empty". The conversation-controller
+     * relies on this to defer clearing the binding during the IndexedDB
+     * hydration window (Angular APP_INITIALIZER race).
+     */
+    get initialized(): boolean;
+    get conversations(): AparteConversation[];
+    get activeId(): string | null;
+    get active(): AparteConversation | null;
+    /** Active conversations (not archived), newest first. */
+    get activeConversations(): AparteConversation[];
+    /** Archived conversations, newest first. */
+    get archivedConversations(): AparteConversation[];
+    /** Create a new empty conversation, persist it, and make it active. */
+    createNew(title?: string): Promise<AparteConversation>;
+    /** Switch active conversation without touching storage. */
+    select(id: string): void;
+    /** Deselect the active conversation (no conv selected). */
+    clearActive(): void;
+    /** Append a message to a conversation. Auto-generates title from first user message. */
+    addMessage(convId: string, msg: AparteMessage): Promise<void>;
+    /**
+     * Replace the flat active-path messages and optionally the full branch tree.
+     * `messages` is always written (active path, for sidebar/title/compat).
+     * `tree` is written when provided — it carries the full branching topology.
+     */
+    updateMessages(convId: string, messages: AparteMessage[], tree?: ExportedMessageRepository): Promise<void>;
+    /** Permanently delete a conversation. */
+    delete(id: string): Promise<void>;
+    /** Archive a conversation (soft-delete). */
+    archive(id: string): Promise<void>;
+    /** Restore an archived conversation. */
+    unarchive(id: string): Promise<void>;
+    /** Update the title manually. The full input is preserved — UI surfaces
+     *  (sidebar list, topbar) are responsible for visual truncation via CSS
+     *  (`min-w-0` + `truncate`). Auto-titles produced internally by
+     *  `_autoTitle()` remain capped at a sensible length on input. */
+    updateTitle(id: string, title: string): Promise<void>;
+    subscribe(listener: Listener): () => void;
+    private _find;
+    private _replace;
+    private _notify;
+    private _autoTitle;
+}
+export {};
+//# sourceMappingURL=conversation-manager.d.ts.map

package/dist/conversations/conversation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAGlF,KAAK,QAAQ,GAAG,CAAC,aAAa,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACvC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,EAAE,yBAAyB,GAAG,SAAS,EAC3C,WAAW,EAAE,MAAM,GACpB;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,EAAE,yBAAyB,GAAG,SAAS,CAAA;CAAE,CAgC5E;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAwC;gBAE9C,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAO/E,yEAAyE;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,IAAI,aAAa,IAAI,kBAAkB,EAAE,CAExC;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,MAAM,IAAI,kBAAkB,GAAG,IAAI,CAGtC;IAED,yDAAyD;IACzD,IAAI,mBAAmB,IAAI,kBAAkB,EAAE,CAI9C;IAED,4CAA4C;IAC5C,IAAI,qBAAqB,IAAI,kBAAkB,EAAE,CAIhD;IAID,uEAAuE;IACjE,SAAS,CAAC,KAAK,SAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBhE,2DAA2D;IAC3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB,2DAA2D;IAC3D,WAAW,IAAI,IAAI;IAKnB,wFAAwF;IAClF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnE;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhH,yCAAyC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,4CAA4C;IACtC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxC,wCAAwC;IAClC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1C;;;sEAGkE;IAC5D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,UAAU;CAQrB"}

package/dist/conversations/index.d.ts

@@ -0,0 +1,5 @@
+export type { AparteConversation, AparteConversationMeta, AparteStorageAdapter, AparteMemoryFact, AparteArtifactRow, AparteAttachmentRow, } from './types.js';
+export { APARTE_CONVERSATION_SCHEMA_VERSION } from './types.js';
+export { ConversationManager, applyRetention, type ConversationManagerOptions } from './conversation-manager.js';
+export { AparteConversationController, type AparteChatBinding, type AparteConversationControllerOptions, } from './conversation-controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/conversations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACjH,OAAO,EACH,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,mCAAmC,GAC3C,MAAM,8BAA8B,CAAC"}