@aparte/core 0.7.1 → 0.8.0

package/dist/renderers/segments/artifact/preview-document.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What a previewed artifact is allowed to FETCH. Inline script and style are
+ * permitted (that IS the preview); no fetch, no XHR, no websocket, no remote image,
+ * no font. Without this the sandbox still lets injected code beacon out to any
+ * origin, so the policy does real work — measured blocked in Chromium, Firefox and
+ * WebKit.
+ *
+ * WHAT IT DOES NOT STOP, stated because the sentence here used to claim otherwise:
+ * the frame NAVIGATING ITSELF. Assigning `location.href` is a navigation, not a
+ * fetch, and no directive in this policy governs it — CSP's `navigate-to` was
+ * removed from the spec and never shipped, and the parent page's `frame-src` does
+ * not apply to a navigation the frame initiates. Reproduced in all three engines;
+ * in Firefox and WebKit the frame then RENDERS the attacker's page inside the card,
+ * which is a phishing surface as well as an exfiltration channel.
+ *
+ * What still holds, and is why this is serious rather than fatal: the sandbox has
+ * no `allow-same-origin`, so the frame's origin is opaque — it cannot read the host
+ * page, its storage, or the API key — and no `allow-forms` or
+ * `allow-top-navigation`, so it can neither POST nor move the tab.
+ *
+ * The honest summary for a consumer: a previewed artifact cannot reach your page or
+ * your data, and can phone home once. Previewing model-authored HTML is running
+ * untrusted content in a box, not running nothing.
+ */
+export declare const PREVIEW_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:";
+export declare function buildSafePreviewDocument(kind: string, body: string, title: string): string;
+//# sourceMappingURL=preview-document.d.ts.map

package/dist/renderers/segments/artifact/preview-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-document.d.ts","sourceRoot":"","sources":["../../../../src/renderers/segments/artifact/preview-document.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,WAAW,6GAA6G,CAAC;AAkDtI,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1F"}

package/dist/renderers/segments/artifact/shared.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Strip leading/trailing markdown code fences (``` or ~~~, optional lang tag).
+ * Also strips any content that appears after the closing fence (small models
+ * frequently duplicate lines after the closing ``` block).
+ *
+ * Char-based scanner — no regex.
+ */
+export declare function stripCodeFences(content: string): string;
+export declare function markThrottle(map: Map<string, number>, id: string, at: number): void;
+export declare function debounceHighlight(element: HTMLElement, paneSelector: string, content: string, lang: string, segId: string): void;
+export declare function labelForKind(kind: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/renderers/segments/artifact/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/renderers/segments/artifact/shared.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBvD;AA8CD,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAOnF;AAED,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACd,IAAI,CAUN;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBjD"}

package/dist/renderers/segments/code.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteCodeSegment } from '../../types/index.js';
+export declare const codeRenderer: AparteSegmentRenderer<AparteCodeSegment>;
+//# sourceMappingURL=code.d.ts.map

package/dist/renderers/segments/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/code.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACR,qBAAqB,EACrB,iBAAiB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,YAAY,EAAE,qBAAqB,CAAC,iBAAiB,CAkEjE,CAAC"}

package/dist/renderers/segments/error.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteErrorSegment } from '../../types/index.js';
+export declare const errorRenderer: AparteSegmentRenderer<AparteErrorSegment>;
+//# sourceMappingURL=error.d.ts.map

package/dist/renderers/segments/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/error.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACR,qBAAqB,EACrB,kBAAkB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,kBAAkB,CA6BnE,CAAC"}

package/dist/renderers/segments/file-tree.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteFileTreeSegment } from '../../types/index.js';
+export declare const fileTreeRenderer: AparteSegmentRenderer<AparteFileTreeSegment>;
+//# sourceMappingURL=file-tree.d.ts.map

package/dist/renderers/segments/file-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tree.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/file-tree.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACR,qBAAqB,EAErB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAkB9B,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,qBAAqB,CAazE,CAAC"}

package/dist/renderers/segments/pipeline-waiting.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer } from '../../types/index.js';
+export declare const pipelineWaitingRenderer: AparteSegmentRenderer;
+//# sourceMappingURL=pipeline-waiting.d.ts.map

package/dist/renderers/segments/pipeline-waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-waiting.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/pipeline-waiting.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACR,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,uBAAuB,EAAE,qBAgDrC,CAAC"}

package/dist/renderers/segments/progress.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteProgressSegment } from '../../types/index.js';
+export declare const progressRenderer: AparteSegmentRenderer<AparteProgressSegment>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/renderers/segments/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/progress.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,qBAAqB,CAQzE,CAAC"}

package/dist/renderers/segments/terminal.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteTerminalSegment } from '../../types/index.js';
+export declare const terminalRenderer: AparteSegmentRenderer<AparteTerminalSegment>;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/renderers/segments/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/terminal.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,qBAAqB,CA2DzE,CAAC"}

package/dist/renderers/segments/text.d.ts

@@ -0,0 +1,10 @@
+import type { AparteSegmentRenderer, AparteTextSegment } from '../../types/index.js';
+/**
+ * Text segment renderer.
+ *
+ * The incremental-vs-one-shot Markdown machinery lives in
+ * `../markdown-stream.ts`, shared with the thinking renderer — see that file for
+ * why appending beats rebuilding, and what the settling update flushes.
+ */
+export declare const textRenderer: AparteSegmentRenderer<AparteTextSegment>;
+//# sourceMappingURL=text.d.ts.map

package/dist/renderers/segments/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/text.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACR,qBAAqB,EACrB,iBAAiB,EACpB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,qBAAqB,CAAC,iBAAiB,CAcjE,CAAC"}

package/dist/renderers/segments/thinking.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteThinkingSegment } from '../../types/index.js';
+export declare const thinkingRenderer: AparteSegmentRenderer<AparteThinkingSegment>;
+//# sourceMappingURL=thinking.d.ts.map

package/dist/renderers/segments/thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/thinking.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAa9B,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,qBAAqB,CA0DzE,CAAC"}

package/dist/renderers/segments/tool-call.d.ts

@@ -0,0 +1,3 @@
+import type { AparteSegmentRenderer, AparteToolCallSegment } from '../../types/index.js';
+export declare const toolCallRenderer: AparteSegmentRenderer<AparteToolCallSegment>;
+//# sourceMappingURL=tool-call.d.ts.map

package/dist/renderers/segments/tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../src/renderers/segments/tool-call.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,qBAAqB,CAwHzE,CAAC"}

package/dist/runtime/message-repository.d.ts

@@ -1,9 +1,9 @@
 /**
- * MessageRepository — Conversation Tree Storage
+ * AparteMessageRepository — Conversation Tree Storage
  *
  * Manages the branching conversation tree while keeping AparteMessage pure
  * (no topology fields on the message itself). Inspired by assistant-ui's
- * MessageRepository but adapted for the Aparte vanilla-TS stack.
+ * AparteMessageRepository but adapted for the Aparte vanilla-TS stack.
  *
  * Internal structure: a doubly-linked tree where each node holds a pointer
  * to its parent (prev) and its active child (next). `children` stores all
@@ -20,7 +20,7 @@ export type ExportedMessageRepository = {
         parentId: string | null;
     }>;
 };
-export declare class MessageRepository {
+export declare class AparteMessageRepository {
     private _nodes;
     private _head;
     private _root;

package/dist/runtime/message-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-repository.d.ts","sourceRoot":"","sources":["../../src/runtime/message-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAsBvD,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GAAG;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACxE,CAAC;AAaF,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAA0C;IAIvD,8CAA8C;IAC9C,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;OAGG;IACH,WAAW,IAAI,aAAa,EAAE;IAU9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAUtG;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IASxC;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAkCzE;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAMvE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBrC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAMb;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAUjD;;;OAGG;IACH,MAAM,IAAI,yBAAyB;IAanC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,kBAAkB;CAW7B"}
+{"version":3,"file":"message-repository.d.ts","sourceRoot":"","sources":["../../src/runtime/message-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAsBvD,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GAAG;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACxE,CAAC;AAaF,qBAAa,uBAAuB;IAChC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAA0C;IAIvD,8CAA8C;IAC9C,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;OAGG;IACH,WAAW,IAAI,aAAa,EAAE;IAU9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAUtG;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IASxC;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAkCzE;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQvC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAMvE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBrC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAMb;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAUjD;;;OAGG;IACH,MAAM,IAAI,yBAAyB;IAanC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,kBAAkB;CAW7B"}

package/dist/transport/backend-handler.d.ts

@@ -7,12 +7,22 @@ export interface AparteChatHandlerOptions {
      */
     providers: Record<string, AparteAIProvider>;
     /**
-     * Optional gate run on EVERY request before any work — this endpoint spends
-     * your server-held vendor key, so put your own auth in front of it. Return
-     * `false` to reject with 401, a `Response` to reject with your own status/body
-     * (e.g. 403 + a message), or `true` to proceed. Reads cookies/headers via `req`.
+     * Gate run on EVERY request before any work. **Required.**
+     *
+     * This endpoint spends your server-held vendor key, so leaving it open means
+     * anyone who finds the URL spends your money. It used to be optional, and both
+     * the JSDoc example here and the primary snippet in the docs omitted it — so
+     * the copy-paste path was the unauthenticated one. Making it required moves
+     * that decision from "did you notice?" to a compile error.
+     *
+     * Return `false` to reject with 401, a `Response` to reject with your own
+     * status/body (e.g. 403 + a message), or `true` to proceed. Reads
+     * cookies/headers via `req`.
+     *
+     * A deliberately open endpoint is still possible — `authorize: () => true` —
+     * but now it is a line someone wrote on purpose.
      */
-    authorize?: (req: Request) => boolean | Response | Promise<boolean | Response>;
+    authorize: (req: Request) => boolean | Response | Promise<boolean | Response>;
     /**
      * Resolve the vendor API key for a providerId — from env / a secret store.
      * Runs server-side only. Return `undefined` for keyless/local providers.
@@ -25,7 +35,7 @@ export interface AparteChatHandlerOptions {
     fetchImpl?: typeof fetch;
 }
 /**
- * Build a framework-free `/api/chat` handler for {@link BackendTransport} — the
+ * Build a framework-free `/api/chat` handler for {@link AparteBackendTransport} — the
  * server counterpart that keeps the key off the client.
  *
  * The returned handler speaks the Web `fetch` API (`Request` → `Response`), so
@@ -33,7 +43,7 @@ export interface AparteChatHandlerOptions {
  * unchanged. It reads `{ providerId, request }`, runs the matching format
  * adapter **server-side** (buildRequest → auth → vendor fetch → parseStream),
  * and streams back normalized `AparteStreamEvent`s as NDJSON — the exact wire
- * format `BackendTransport` expects. The vendor key is injected here and never
+ * format `AparteBackendTransport` expects. The vendor key is injected here and never
  * travels to the browser.
  *
  * ```ts
@@ -43,6 +53,8 @@ export interface AparteChatHandlerOptions {
  * export const POST = createAparteChatHandler({
  *   providers: { openai: createOpenAICompatProvider(presets.OPENAI) },
  *   resolveKey: (id) => process.env[`${id.toUpperCase()}_KEY`],
+ *   // Required: this route spends your key. Your own session check goes here.
+ *   authorize: async (req) => Boolean(await getSession(req)),
  * });
  * ```
  */

package/dist/transport/backend-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-handler.d.ts","sourceRoot":"","sources":["../../src/transport/backend-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC/E;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtF;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,wBAAwB,GAClC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA4GrC"}
+{"version":3,"file":"backend-handler.d.ts","sourceRoot":"","sources":["../../src/transport/backend-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C;;;;;;;;;;;;;;;OAeG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC9E;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtF;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,wBAAwB,GAClC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8HrC"}

package/dist/transport/backend-transport.d.ts

@@ -31,7 +31,7 @@ export interface BackendTransportOptions {
  * server-side, key held server-side). Drop it into a Next.js route handler,
  * Deno, Bun, or a Worker rather than hand-rolling one.
  */
-export declare class BackendTransport implements AparteTransport {
+export declare class AparteBackendTransport implements AparteTransport {
     private readonly options;
     constructor(options: BackendTransportOptions);
     chat(_provider: AparteAIProvider, request: AparteChatRequest, _auth: string | Record<string, string> | undefined, ctx: AparteTransportContext): Promise<AparteChatResponse>;

package/dist/transport/backend-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-transport.d.ts","sourceRoot":"","sources":["../../src/transport/backend-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI1E,MAAM,WAAW,uBAAuB;IACpC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,IAAI,CACN,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,GAAG,EAAE,sBAAsB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;CA4BjC"}
+{"version":3,"file":"backend-transport.d.ts","sourceRoot":"","sources":["../../src/transport/backend-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI1E,MAAM,WAAW,uBAAuB;IACpC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,IAAI,CACN,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,GAAG,EAAE,sBAAsB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;CA4BjC"}

package/dist/transport/direct-transport.d.ts

@@ -1,13 +1,13 @@
 import type { AparteChatRequest, AparteChatResponse } from '../types/chat.js';
 import type { AparteAIProvider } from '../types/model-provider.js';
 import type { AparteTransport, AparteTransportContext } from './types.js';
-/** Options for {@link DirectTransport}. */
+/** Options for {@link AparteDirectTransport}. */
 export interface DirectTransportOptions {
     /**
      * Set when the key is the end-user's own (BYOK) or the model runs locally —
      * i.e. you *intend* the credential to live in the browser. This silences the
      * one-time insecure-key warning. Leave it unset for keys that must stay
-     * server-side, and use `BackendTransport` for those instead.
+     * server-side, and use `AparteBackendTransport` for those instead.
      */
     byok?: boolean;
 }
@@ -17,7 +17,7 @@ export interface DirectTransportOptions {
  * Calls the vendor endpoint straight from the browser, injecting the resolved
  * key via the adapter's `authHeaders`. This is the pre-refactor behaviour and
  * is only safe when the user brings their own key or the model runs locally.
- * Production apps that must keep a key server-side should use `BackendTransport`.
+ * Production apps that must keep a key server-side should use `AparteBackendTransport`.
  *
  * When a real key is sent straight from the browser and the transport was not
  * flagged `{ byok: true }`, a one-time `console.warn` names the exposure — the
@@ -26,7 +26,7 @@ export interface DirectTransportOptions {
  * Legacy providers (still exposing `chat()` rather than the adapter surface) are
  * delegated to untouched, so the migration can proceed provider-by-provider.
  */
-export declare class DirectTransport implements AparteTransport {
+export declare class AparteDirectTransport implements AparteTransport {
     private readonly byok;
     private warnedBrowserKey;
     constructor(options?: DirectTransportOptions);

package/dist/transport/direct-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct-transport.d.ts","sourceRoot":"","sources":["../../src/transport/direct-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG1E,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,sBAA2B;IAI1C,IAAI,CACN,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACjD,GAAG,EAAE,sBAAsB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAoD9B,OAAO,CAAC,kBAAkB;CAU7B"}
+{"version":3,"file":"direct-transport.d.ts","sourceRoot":"","sources":["../../src/transport/direct-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG1E,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,sBAA2B;IAI1C,IAAI,CACN,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACjD,GAAG,EAAE,sBAAsB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAoD9B,OAAO,CAAC,kBAAkB;CAU7B"}

package/dist/transport/index.d.ts

@@ -1,6 +1,6 @@
 export type { AparteTransport, AparteTransportContext, AparteFormatAdapter, AparteVendorRequest, } from './types.js';
 export { isFormatAdapter, readAuth } from './types.js';
-export { DirectTransport, type DirectTransportOptions } from './direct-transport.js';
-export { BackendTransport, type BackendTransportOptions } from './backend-transport.js';
+export { AparteDirectTransport, type DirectTransportOptions } from './direct-transport.js';
+export { AparteBackendTransport, type BackendTransportOptions } from './backend-transport.js';
 export { createAparteChatHandler, type AparteChatHandlerOptions } from './backend-handler.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/transport/types.d.ts

@@ -5,9 +5,9 @@
  *     how to shape the HTTP request and how to parse the response stream into
  *     unified `AparteStreamEvent`s. No network, no auth, no key.
  *   • **Transport** (`AparteTransport`): WHERE the call goes and how auth is
- *     handled — straight to the vendor from the browser (`DirectTransport`,
+ *     handled — straight to the vendor from the browser (`AparteDirectTransport`,
  *     BYOK/local) or via your own backend that holds the key
- *     (`BackendTransport`, recommended for production).
+ *     (`AparteBackendTransport`, recommended for production).
  *
  * A "provider" is migrating from a monolithic `chat()` (fetch + key + parse) to
  * a pure format adapter. During the migration a provider may expose EITHER the
@@ -64,7 +64,7 @@ export declare function vendorErrorMessage(response: Response, label?: string):
 /**
  * Resolve a non-streaming response to text via the adapter's `parseText`.
  * Both transports use this so `stream: false` behaves identically (previously
- * DirectTransport returned '' and BackendTransport returned raw JSON when
+ * AparteDirectTransport returned '' and AparteBackendTransport returned raw JSON when
  * `parseText` was missing — now both fail loud).
  */
 export declare function parseNonStreamText(provider: {

package/dist/types/element-map.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Global typing for the aparté custom elements. Once `@aparte/core` is in a
+ * consumer's TypeScript program, `document.querySelector('aparte-composer-input')`
+ * returns `AparteComposerInput | null` instead of `Element | null` — no cast, and
+ * the element's own properties and methods are reachable.
+ *
+ * This used to live inline: each component appended its own
+ * `declare global { interface HTMLElementTagNameMap { … } }` at the bottom of its
+ * file. Seven of the eighteen elements did; the other eleven did not, and nothing
+ * could notice. The consequence was not abstract — the canonical example in the
+ * generated API reference, `list.conversations = [...]` after a
+ * `querySelector('aparte-conversation-list')`, could not compile, and the same held
+ * for every `aparte-composer-*` primitive on the "compose your own composer" path
+ * that `getting-started` recommends.
+ *
+ * One file instead of eighteen for one reason: a per-component convention cannot be
+ * enforced, and it was not. Here the whole element surface is in one place, next to
+ * the `customElements.define` calls it has to agree with, which is what makes
+ * `pnpm check:element-map` a five-line diff rather than a parser.
+ *
+ * Every import is `import type`, so nothing is emitted and this cannot introduce a
+ * runtime cycle — the same reason `event-map.ts` can name a component-coupled detail
+ * type from the types layer.
+ *
+ * DOM-only, therefore imported by `index.ts` and NOT by `index.node.ts`:
+ * `HTMLElementTagNameMap` does not exist without the DOM lib.
+ */
+import type { AparteChat } from '../components/chat/aparte-chat.js';
+import type { AparteChatBubble } from '../components/bubble/aparte-chat-bubble.js';
+import type { AparteChatStatus } from '../components/status/aparte-chat-status.js';
+import type { AparteChatViewport } from '../components/viewport/aparte-chat-viewport.js';
+import type { AparteComposer } from '../components/composer/aparte-composer.js';
+import type { AparteComposerInput } from '../components/composer/aparte-composer-input.js';
+import type { AparteComposerSend } from '../components/composer/aparte-composer-send.js';
+import type { AparteComposerCancel } from '../components/composer/aparte-composer-cancel.js';
+import type { AparteComposerAttachments } from '../components/composer/aparte-composer-attachments.js';
+import type { AparteComposerAddAttachment } from '../components/composer/aparte-composer-add-attachment.js';
+import type { AparteComposerAction } from '../components/composer/aparte-composer-action.js';
+import type { AparteComposerToolbar } from '../components/composer/aparte-composer-toolbar.js';
+import type { AparteConversationList } from '../components/conversation-list/aparte-conversation-list.js';
+import type { AparteElicitation } from '../components/elicitation/aparte-elicitation.js';
+import type { AparteSelect } from '../primitives/select/aparte-select.js';
+import type { AparteOption } from '../primitives/select/aparte-option.js';
+import type { AparteOptgroup } from '../primitives/select/aparte-optgroup.js';
+import type { AparteProgressSpinner } from '../primitives/progress-spinner/aparte-progress-spinner.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'aparte-chat': AparteChat;
+        'aparte-chat-viewport': AparteChatViewport;
+        'aparte-chat-bubble': AparteChatBubble;
+        'aparte-chat-status': AparteChatStatus;
+        'aparte-composer': AparteComposer;
+        'aparte-composer-input': AparteComposerInput;
+        'aparte-composer-send': AparteComposerSend;
+        'aparte-composer-cancel': AparteComposerCancel;
+        'aparte-composer-attachments': AparteComposerAttachments;
+        'aparte-composer-add-attachment': AparteComposerAddAttachment;
+        'aparte-composer-action': AparteComposerAction;
+        'aparte-composer-toolbar': AparteComposerToolbar;
+        'aparte-conversation-list': AparteConversationList;
+        'aparte-elicitation': AparteElicitation;
+        'aparte-select': AparteSelect;
+        'aparte-option': AparteOption;
+        'aparte-optgroup': AparteOptgroup;
+        'aparte-progress-spinner': AparteProgressSpinner;
+    }
+}
+export {};
+//# sourceMappingURL=element-map.d.ts.map

package/dist/types/element-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-map.d.ts","sourceRoot":"","sources":["../../src/types/element-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0DAA0D,CAAC;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6DAA6D,CAAC;AAC1G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2DAA2D,CAAC;AAEvG,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAE3B,aAAa,EAAE,UAAU,CAAC;QAC1B,sBAAsB,EAAE,kBAAkB,CAAC;QAC3C,oBAAoB,EAAE,gBAAgB,CAAC;QACvC,oBAAoB,EAAE,gBAAgB,CAAC;QAGvC,iBAAiB,EAAE,cAAc,CAAC;QAClC,uBAAuB,EAAE,mBAAmB,CAAC;QAC7C,sBAAsB,EAAE,kBAAkB,CAAC;QAC3C,wBAAwB,EAAE,oBAAoB,CAAC;QAC/C,6BAA6B,EAAE,yBAAyB,CAAC;QACzD,gCAAgC,EAAE,2BAA2B,CAAC;QAC9D,wBAAwB,EAAE,oBAAoB,CAAC;QAC/C,yBAAyB,EAAE,qBAAqB,CAAC;QAGjD,0BAA0B,EAAE,sBAAsB,CAAC;QACnD,oBAAoB,EAAE,iBAAiB,CAAC;QAGxC,eAAe,EAAE,YAAY,CAAC;QAC9B,eAAe,EAAE,YAAY,CAAC;QAC9B,iBAAiB,EAAE,cAAc,CAAC;QAClC,yBAAyB,EAAE,qBAAqB,CAAC;KACpD;CACJ;AAED,OAAO,EAAE,CAAC"}

package/dist/types/event-map.d.ts

@@ -4,37 +4,98 @@
  * types `e` as `CustomEvent<AparteRetryEventDetail>` with a typed `e.detail` — no
  * manual `(e as CustomEvent<…>).detail` cast.
  *
- * Covers the public bubble / lifecycle / artifact / tool events whose detail type
- * lives in the types layer. Internal component/primitive events (composer-submit,
- * select-change, optgroup-toggle, …) intentionally fall back to the DOM's default
- * `Event` — they carry no cross-package detail contract.
+ * ## What belongs here
+ *
+ * One rule: **an event with a detail belongs in the map.** If a consumer can read
+ * `e.detail`, the map is the only thing that types it, and its absence forces the
+ * exact cast the paragraph above promises you never need.
+ *
+ * The rule this file used to state was different and wrong. It said the map covers
+ * "events whose detail type lives in the types layer", and named composer-submit,
+ * select-change and optgroup-toggle as internal ones that "carry no cross-package
+ * detail contract". Two of those three do: `@aparte/plugin-model-selector` reads
+ * both across a package boundary, and `AparteSelectChangeDetail` is exported from
+ * both public barrels. Meanwhile `aparte-composer-change` sat in the map with its
+ * detail imported from a component — breaking the stated criterion in the other
+ * direction. A rule contradicted by its own list is not a rule.
+ *
+ * Events that carry NO detail stay out, and that is the whole exclusion:
+ * `aparte-composer-submit`, `aparte-cancel`, `aparte-reset`, `aparte-reset-done`,
+ * `aparte-compact-start`, `aparte-select-open`, `aparte-select-close` are all
+ * dispatched as a bare `new CustomEvent(name)`. A map entry would type `e.detail`
+ * as `null` and gain nothing.
  *
  * All names are kebab-case (`aparte-*`) so every framework can bind them in a
  * template (Angular parses a `:` in an event name as a `target:event` selector,
  * so a colon name could never be `(aparte:x)`-bound there).
  */
-import type { AparteSendEventDetail, AparteRetryEventDetail, AparteEditEventDetail, AparteActionEventDetail, ApartePathChangedEventDetail, AparteBranchNavigateEventDetail, AparteFeedbackEventDetail, AparteMessageInfoEventDetail, AparteMessageDoneEventDetail, AparteModelChangeEventDetail, AparteArtifactStartEventDetail, AparteArtifactDeltaEventDetail, AparteArtifactReadyEventDetail, AparteArtifactOpenEventDetail } from './events.js';
+import type { AparteSendEventDetail, AparteRetryEventDetail, AparteEditEventDetail, AparteActionEventDetail, ApartePathChangedEventDetail, AparteBranchNavigateEventDetail, AparteFeedbackEventDetail, AparteMessageInfoEventDetail, AparteMessageDoneEventDetail, AparteModelChangeEventDetail, AparteArtifactStartEventDetail, AparteArtifactDeltaEventDetail, AparteArtifactReadyEventDetail, AparteArtifactRedownloadEventDetail, AparteMessageStartEventDetail, AparteMessageErrorEventDetail, AparteMessageAbortedEventDetail, AparteAbortEventDetail, AparteCompactEventDetail, AparteCompactDoneEventDetail, AparteCompactErrorEventDetail, AparteAttachmentPreviewEventDetail, AparteTerminalRunEventDetail, AparteFileGenReadyEventDetail, AparteFileGenErrorEventDetail } from './events.js';
+import type { AparteActionClickEventDetail } from '../components/composer/aparte-composer-action.js';
+import type { AparteOptgroupToggleEventDetail } from '../primitives/select/aparte-optgroup.js';
+import type { AparteConfigChangeEventDetail } from '../config/aparte-config.js';
 import type { AparteToolDecisionDetail, AparteToolApprovalRequestDetail } from './tools.js';
+import type { AparteSegmentUpdateEventDetail } from './segments.js';
+import type { AparteSelectChangeDetail } from '../primitives/select/aparte-select.js';
+import type { AparteConversationSelectDetail, AparteConversationDeleteDetail, AparteConversationArchiveDetail } from '../components/conversation-list/aparte-conversation-list.js';
 import type { AparteComposerChangeEventDetail } from '../components/composer/aparte-composer.js';
+/**
+ * Declared once, applied to all three targets below.
+ *
+ * It used to be written straight into `HTMLElementEventMap`, which typed
+ * `chat.addEventListener(...)` and nothing else — while `document.addEventListener`
+ * resolves through `DocumentEventMap` and `window.addEventListener` through
+ * `WindowEventMap`, neither of which inherits from it. Every aparté event bubbles
+ * and composes, so listening on `document` is the natural way to handle a page's
+ * worth of chats in one place; the docs recommend exactly that ("Clicks are
+ * declarative — they emit `aparte-action`, so you handle them in one place"), and
+ * that recommended snippet did not compile. `AparteClient` itself listens on
+ * `window`, so the third map is not hypothetical either.
+ */
+interface AparteEventMap {
+    'aparte-send': CustomEvent<AparteSendEventDetail>;
+    'aparte-retry': CustomEvent<AparteRetryEventDetail>;
+    'aparte-edit': CustomEvent<AparteEditEventDetail>;
+    'aparte-action': CustomEvent<AparteActionEventDetail>;
+    'aparte-path-changed': CustomEvent<ApartePathChangedEventDetail>;
+    'aparte-branch-navigate': CustomEvent<AparteBranchNavigateEventDetail>;
+    'aparte-feedback': CustomEvent<AparteFeedbackEventDetail>;
+    'aparte-message-info': CustomEvent<AparteMessageInfoEventDetail>;
+    'aparte-message-done': CustomEvent<AparteMessageDoneEventDetail>;
+    'aparte-model-change': CustomEvent<AparteModelChangeEventDetail>;
+    'aparte-artifact-start': CustomEvent<AparteArtifactStartEventDetail>;
+    'aparte-artifact-delta': CustomEvent<AparteArtifactDeltaEventDetail>;
+    'aparte-artifact-ready': CustomEvent<AparteArtifactReadyEventDetail>;
+    'aparte-artifact-redownload': CustomEvent<AparteArtifactRedownloadEventDetail>;
+    'aparte-tool-decision': CustomEvent<AparteToolDecisionDetail>;
+    'aparte-tool-approval-request': CustomEvent<AparteToolApprovalRequestDetail>;
+    'aparte-composer-change': CustomEvent<AparteComposerChangeEventDetail>;
+    'aparte-select-change': CustomEvent<AparteSelectChangeDetail>;
+    'aparte-segment-update': CustomEvent<AparteSegmentUpdateEventDetail>;
+    'aparte-select-conversation': CustomEvent<AparteConversationSelectDetail>;
+    'aparte-delete-conversation': CustomEvent<AparteConversationDeleteDetail>;
+    'aparte-archive-conversation': CustomEvent<AparteConversationArchiveDetail>;
+    'aparte-unarchive-conversation': CustomEvent<AparteConversationArchiveDetail>;
+    'aparte-message-start': CustomEvent<AparteMessageStartEventDetail>;
+    'aparte-message-error': CustomEvent<AparteMessageErrorEventDetail>;
+    'aparte-message-aborted': CustomEvent<AparteMessageAbortedEventDetail>;
+    'aparte-abort': CustomEvent<AparteAbortEventDetail>;
+    'aparte-compact': CustomEvent<AparteCompactEventDetail>;
+    'aparte-compact-done': CustomEvent<AparteCompactDoneEventDetail>;
+    'aparte-compact-error': CustomEvent<AparteCompactErrorEventDetail>;
+    'aparte-file-gen-ready': CustomEvent<AparteFileGenReadyEventDetail>;
+    'aparte-file-gen-error': CustomEvent<AparteFileGenErrorEventDetail>;
+    'aparte-attachment-preview': CustomEvent<AparteAttachmentPreviewEventDetail>;
+    'aparte-terminal-run': CustomEvent<AparteTerminalRunEventDetail>;
+    'aparte-action-click': CustomEvent<AparteActionClickEventDetail>;
+    'aparte-optgroup-toggle': CustomEvent<AparteOptgroupToggleEventDetail>;
+    'aparte-config-change': CustomEvent<AparteConfigChangeEventDetail>;
+}
 declare global {
-    interface HTMLElementEventMap {
-        'aparte-send': CustomEvent<AparteSendEventDetail>;
-        'aparte-retry': CustomEvent<AparteRetryEventDetail>;
-        'aparte-edit': CustomEvent<AparteEditEventDetail>;
-        'aparte-action': CustomEvent<AparteActionEventDetail>;
-        'aparte-path-changed': CustomEvent<ApartePathChangedEventDetail>;
-        'aparte-branch-navigate': CustomEvent<AparteBranchNavigateEventDetail>;
-        'aparte-feedback': CustomEvent<AparteFeedbackEventDetail>;
-        'aparte-message-info': CustomEvent<AparteMessageInfoEventDetail>;
-        'aparte-message-done': CustomEvent<AparteMessageDoneEventDetail>;
-        'aparte-model-change': CustomEvent<AparteModelChangeEventDetail>;
-        'aparte-artifact-start': CustomEvent<AparteArtifactStartEventDetail>;
-        'aparte-artifact-delta': CustomEvent<AparteArtifactDeltaEventDetail>;
-        'aparte-artifact-ready': CustomEvent<AparteArtifactReadyEventDetail>;
-        'aparte-artifact-open': CustomEvent<AparteArtifactOpenEventDetail>;
-        'aparte-tool-decision': CustomEvent<AparteToolDecisionDetail>;
-        'aparte-tool-approval-request': CustomEvent<AparteToolApprovalRequestDetail>;
-        'aparte-composer-change': CustomEvent<AparteComposerChangeEventDetail>;
+    interface HTMLElementEventMap extends AparteEventMap {
+    }
+    interface DocumentEventMap extends AparteEventMap {
+    }
+    interface WindowEventMap extends AparteEventMap {
     }
 }
 export {};

package/dist/types/event-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../../src/types/event-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACR,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,EAC9B,8BAA8B,EAC9B,6BAA6B,EAChC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAG5F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAEjG,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,mBAAmB;QACzB,aAAa,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;QAClD,cAAc,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;QACpD,aAAa,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;QAClD,eAAe,EAAE,WAAW,CAAC,uBAAuB,CAAC,CAAC;QACtD,qBAAqB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACjE,wBAAwB,EAAE,WAAW,CAAC,+BAA+B,CAAC,CAAC;QACvE,iBAAiB,EAAE,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAC1D,qBAAqB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACjE,qBAAqB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACjE,qBAAqB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACjE,uBAAuB,EAAE,WAAW,CAAC,8BAA8B,CAAC,CAAC;QACrE,uBAAuB,EAAE,WAAW,CAAC,8BAA8B,CAAC,CAAC;QACrE,uBAAuB,EAAE,WAAW,CAAC,8BAA8B,CAAC,CAAC;QACrE,sBAAsB,EAAE,WAAW,CAAC,6BAA6B,CAAC,CAAC;QACnE,sBAAsB,EAAE,WAAW,CAAC,wBAAwB,CAAC,CAAC;QAC9D,8BAA8B,EAAE,WAAW,CAAC,+BAA+B,CAAC,CAAC;QAG7E,wBAAwB,EAAE,WAAW,CAAC,+BAA+B,CAAC,CAAC;KAC1E;CACJ;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../../src/types/event-map.ts"],"names":[],"mappings":"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"}