@aparte/angular 0.15.1 → 0.16.0

package/dist/fesm2022/aparte-angular.mjs

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken, inject, Injectable, makeEnvironmentProviders, provideAppInitializer, DestroyRef, effect, ElementRef, signal, output, computed, numberAttribute, booleanAttribute, ViewChildren, ViewChild, Input, ChangeDetectionStrategy, CUSTOM_ELEMENTS_SCHEMA, Component, Renderer2, Directive, EventEmitter, HostListener, Output } from '@angular/core';
 import { AparteClient, aparteGlobalConfig, isAwaitingReply, uuid, AparteChatHost, APARTE_DEFAULT_UI_EVENTS, applyElementProps, AparteConversationManager } from '@aparte/core';
 export { aparteGlobalConfig } from '@aparte/core';
-import { NgTemplateOutlet } from '@angular/common';
+import { DOCUMENT, NgTemplateOutlet } from '@angular/common';
 
 /**
  * Injection token for AparteClient configuration. Provided by `provideAparte()`;
@@ -104,17 +104,28 @@ async function loadPlugins(options) {
         pending.push(loadMarkdownPlugin(plugins.markdown));
     await Promise.all(pending);
 }
-/** Reflect the theme mode on the document root. */
-function applyThemeMode(mode, destroyRef) {
+/**
+ * Reflect the theme mode on the document root.
+ *
+ * Angular's own document, not the global: under Universal the initializer runs on the
+ * server, where `document`/`window` do not exist and the injected DOCUMENT is Domino's.
+ * A media query needs a real window; without one the mode is applied once and left.
+ */
+function applyThemeMode(mode, doc, destroyRef) {
     if (mode !== 'auto') {
-        document.documentElement.setAttribute('data-aparte-theme', mode);
+        doc.documentElement.setAttribute('data-aparte-theme', mode);
         return;
     }
-    const query = window.matchMedia('(prefers-color-scheme: dark)');
+    const win = doc.defaultView;
+    if (!win?.matchMedia) {
+        doc.documentElement.setAttribute('data-aparte-theme', 'light');
+        return;
+    }
+    const query = win.matchMedia('(prefers-color-scheme: dark)');
     const onChange = (e) => {
-        document.documentElement.setAttribute('data-aparte-theme', e.matches ? 'dark' : 'light');
+        doc.documentElement.setAttribute('data-aparte-theme', e.matches ? 'dark' : 'light');
     };
-    document.documentElement.setAttribute('data-aparte-theme', query.matches ? 'dark' : 'light');
+    doc.documentElement.setAttribute('data-aparte-theme', query.matches ? 'dark' : 'light');
     query.addEventListener('change', onChange);
     // Released with the environment injector, so repeated bootstraps (TestBed, a
     // multi-instance embed) don't stack listeners on the media query forever.
@@ -147,6 +158,8 @@ function provideAparte(options = {}) {
         { provide: APARTE_CLIENT_OPTIONS, useValue: options.clientOptions ?? {} },
         provideAppInitializer(async () => {
             const destroyRef = inject(DestroyRef);
+            // Before the first await, like `destroyRef`: inject() needs the context.
+            const doc = inject(DOCUMENT);
             // inject() only works before the first await — grab the service now,
             // connect at the end (after plugins) so the first send already sees
             // markdown/action providers. SSR-safe: no listener without a window.
@@ -164,7 +177,7 @@ function provideAparte(options = {}) {
             }
             await loadPlugins(options);
             if (options.themeMode) {
-                applyThemeMode(options.themeMode, destroyRef);
+                applyThemeMode(options.themeMode, doc, destroyRef);
             }
             ai?.connect();
         }),
@@ -246,6 +259,15 @@ class AparteChatComponent {
      */
     set attachmentsInput(val) { this.attachments.set(val); }
     attachments = signal(false);
+    /**
+     * Render the `<aparte-elicitation>` presenter inside the host — on by default, as
+     * it is in `<aparte-chat>`: the built-in approval gate and `requestUserInput()`
+     * ask through it, and it renders nothing until something asks. Set it to `false`
+     * when you mount a presenter of your own (`setElicitationPresenter`) or place the
+     * element yourself.
+     */
+    set elicitationInput(val) { this.elicitation.set(val); }
+    elicitation = signal(true);
     /** Whether the assistant is currently typing/streaming */
     set isTypingInput(val) { this.isTyping.set(val); }
     isTyping = signal(false);
@@ -539,7 +561,7 @@ class AparteChatComponent {
         this.messageSent.emit(detail);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteChatComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.25", type: AparteChatComponent, isStandalone: true, selector: "aparte-chat", inputs: { messagesInput: ["messages", "messagesInput"], placeholderInput: ["placeholder", "placeholderInput"], disabledInput: ["disabled", "disabledInput", booleanAttribute], submitOnEnterInput: ["submitOnEnter", "submitOnEnterInput", booleanAttribute], centerWhenEmptyInput: ["centerWhenEmpty", "centerWhenEmptyInput", booleanAttribute], attachmentsInput: ["attachments", "attachmentsInput", booleanAttribute], isTypingInput: ["isTyping", "isTypingInput", booleanAttribute], typingTextInput: ["typingText", "typingTextInput"], layoutTransitionMs: ["layoutTransitionMs", "layoutTransitionMs", numberAttribute], conversationIdInput: ["conversationId", "conversationIdInput"], config: "config", bubbleTemplate: "bubbleTemplate" }, outputs: { messageSent: "messageSent", action: "action", messagesChange: "messagesChange", messageAppended: "messageAppended", typingChange: "typingChange", conversationCreated: "conversationCreated" }, host: { attributes: { "framework-managed": "" } }, viewQueries: [{ propertyName: "viewportRef", first: true, predicate: ["viewport"], descendants: true }, { propertyName: "inputRef", first: true, predicate: ["input"], descendants: true }, { propertyName: "bubbleRefs", predicate: ["bubble"], descendants: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.25", type: AparteChatComponent, isStandalone: true, selector: "aparte-chat", inputs: { messagesInput: ["messages", "messagesInput"], placeholderInput: ["placeholder", "placeholderInput"], disabledInput: ["disabled", "disabledInput", booleanAttribute], submitOnEnterInput: ["submitOnEnter", "submitOnEnterInput", booleanAttribute], centerWhenEmptyInput: ["centerWhenEmpty", "centerWhenEmptyInput", booleanAttribute], attachmentsInput: ["attachments", "attachmentsInput", booleanAttribute], elicitationInput: ["elicitation", "elicitationInput", booleanAttribute], isTypingInput: ["isTyping", "isTypingInput", booleanAttribute], typingTextInput: ["typingText", "typingTextInput"], layoutTransitionMs: ["layoutTransitionMs", "layoutTransitionMs", numberAttribute], conversationIdInput: ["conversationId", "conversationIdInput"], config: "config", bubbleTemplate: "bubbleTemplate" }, outputs: { messageSent: "messageSent", action: "action", messagesChange: "messagesChange", messageAppended: "messageAppended", typingChange: "typingChange", conversationCreated: "conversationCreated" }, host: { attributes: { "framework-managed": "" } }, viewQueries: [{ propertyName: "viewportRef", first: true, predicate: ["viewport"], descendants: true }, { propertyName: "inputRef", first: true, predicate: ["input"], descendants: true }, { propertyName: "bubbleRefs", predicate: ["bubble"], descendants: true }], ngImport: i0, template: `
     <div
       class="aparte-chat-container"
       [class.aparte-chat-container--auto-center]="centerWhenEmpty()"
@@ -563,6 +585,7 @@ class AparteChatComponent {
               #bubble
               [attr.message-id]="message.id"
               [attr.data-role]="message.role"
+              [attr.data-kind]="message.compaction ? 'compaction' : null"
               [attr.timestamp]="message.timestamp"
               [attr.content]="message.content"
               [attr.streaming]="awaitingReply(message) ? '' : null"
@@ -575,6 +598,12 @@ class AparteChatComponent {
         ></aparte-chat-status>
       </aparte-chat-viewport>
 
+      <!-- The presenter for a request to the human (approval gate, ask_user…).
+           Renders nothing until something asks; on by default as in <aparte-chat>. -->
+      @if (elicitation()) {
+        <aparte-elicitation></aparte-elicitation>
+      }
+
       <ng-content select="[slot='above-composer']"></ng-content>
 
       <aparte-composer
@@ -643,6 +672,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
               #bubble
               [attr.message-id]="message.id"
               [attr.data-role]="message.role"
+              [attr.data-kind]="message.compaction ? 'compaction' : null"
               [attr.timestamp]="message.timestamp"
               [attr.content]="message.content"
               [attr.streaming]="awaitingReply(message) ? '' : null"
@@ -655,6 +685,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
         ></aparte-chat-status>
       </aparte-chat-viewport>
 
+      <!-- The presenter for a request to the human (approval gate, ask_user…).
+           Renders nothing until something asks; on by default as in <aparte-chat>. -->
+      @if (elicitation()) {
+        <aparte-elicitation></aparte-elicitation>
+      }
+
       <ng-content select="[slot='above-composer']"></ng-content>
 
       <aparte-composer
@@ -714,6 +750,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
             }], attachmentsInput: [{
                 type: Input,
                 args: [{ alias: 'attachments', transform: booleanAttribute }]
+            }], elicitationInput: [{
+                type: Input,
+                args: [{ alias: 'elicitation', transform: booleanAttribute }]
             }], isTypingInput: [{
                 type: Input,
                 args: [{ alias: 'isTyping', transform: booleanAttribute }]
@@ -980,6 +1019,8 @@ class AparteChatBubbleDirective extends AparteElementBase {
     edit = new EventEmitter();
     /** The `‹1/2›` picker moved between sibling versions. */
     branchNavigate = new EventEmitter();
+    /** A link in the message body is about to be followed. Cancelable: `preventDefault()` keeps the browser from navigating, so a host can route the link itself. */
+    linkClick = new EventEmitter();
     onAttachmentPreview(e) { this.attachmentPreview.emit(e.detail); }
     onAction(e) { this.action.emit(e.detail); }
     onRetry(e) { this.retry.emit(e.detail); }
@@ -987,8 +1028,9 @@ class AparteChatBubbleDirective extends AparteElementBase {
     onMessageInfo(e) { this.messageInfo.emit(e.detail); }
     onEdit(e) { this.edit.emit(e.detail); }
     onBranchNavigate(e) { this.branchNavigate.emit(e.detail); }
+    onLinkClick(e) { this.linkClick.emit(e.detail); }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteChatBubbleDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteChatBubbleDirective, isStandalone: true, selector: "aparte-chat-bubble", inputs: { messageRole: "messageRole", content: "content", timestamp: "timestamp", messageId: "messageId", streaming: ["streaming", "streaming", booleanAttribute], name: "name" }, outputs: { attachmentPreview: "attachmentPreview", action: "action", retry: "retry", feedback: "feedback", messageInfo: "messageInfo", edit: "edit", branchNavigate: "branchNavigate" }, host: { listeners: { "aparte-attachment-preview": "onAttachmentPreview($event)", "aparte-action": "onAction($event)", "aparte-retry": "onRetry($event)", "aparte-feedback": "onFeedback($event)", "aparte-message-info": "onMessageInfo($event)", "aparte-edit": "onEdit($event)", "aparte-branch-navigate": "onBranchNavigate($event)" } }, usesInheritance: true, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteChatBubbleDirective, isStandalone: true, selector: "aparte-chat-bubble", inputs: { messageRole: "messageRole", content: "content", timestamp: "timestamp", messageId: "messageId", streaming: ["streaming", "streaming", booleanAttribute], name: "name" }, outputs: { attachmentPreview: "attachmentPreview", action: "action", retry: "retry", feedback: "feedback", messageInfo: "messageInfo", edit: "edit", branchNavigate: "branchNavigate", linkClick: "linkClick" }, host: { listeners: { "aparte-attachment-preview": "onAttachmentPreview($event)", "aparte-action": "onAction($event)", "aparte-retry": "onRetry($event)", "aparte-feedback": "onFeedback($event)", "aparte-message-info": "onMessageInfo($event)", "aparte-edit": "onEdit($event)", "aparte-branch-navigate": "onBranchNavigate($event)", "aparte-link-click": "onLinkClick($event)" } }, usesInheritance: true, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteChatBubbleDirective, decorators: [{
             type: Directive,
@@ -1020,6 +1062,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 type: Output
             }], branchNavigate: [{
                 type: Output
+            }], linkClick: [{
+                type: Output
             }], onAttachmentPreview: [{
                 type: HostListener,
                 args: ['aparte-attachment-preview', ['$event']]
@@ -1041,6 +1085,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
             }], onBranchNavigate: [{
                 type: HostListener,
                 args: ['aparte-branch-navigate', ['$event']]
+            }], onLinkClick: [{
+                type: HostListener,
+                args: ['aparte-link-click', ['$event']]
             }] } });
 /** `<aparte-chat-status>` — A standalone status line — a light-DOM indicator the APP owns. Nothing in core turns it on: the framework host only ever flips it back OFF (on the first streamed token), and the four wrappers render one inside the viewport driven by their own `isTyping` prop. */
 class AparteChatStatusDirective extends AparteElementBase {
@@ -1324,6 +1371,8 @@ class AparteContextDirective extends AparteElementBase {
     set danger(v) { this.write('danger', v); }
     /** The id of the `<aparte-chat>` to watch, when the element is not under it. */
     set target(v) { this.write('target', v); }
+    /** `bar` (default) or `ring`: a progress bar with the reading beside it, or a ring with the percentage. */
+    set variant(v) { this.write('variant', v); }
     /** Dispatch `aparte-compact` on reaching `danger` (once per crossing). */
     set autoCompact(v) { this.write('auto-compact', v); }
     /** Reflected BY the element: `ok`, `warn` or `danger`. Read-only. */
@@ -1332,9 +1381,12 @@ class AparteContextDirective extends AparteElementBase {
     set dataEmpty(v) { this.write('data-empty', v); }
     /** The level changed. Bubbles. */
     contextThreshold = new EventEmitter();
+    /** Dispatched on `window` when `auto-compact` is set and the gauge first reaches `danger`: compact this target's transcript. Once per crossing, and only while the attribute is present. `@aparte/plugin-compaction` answers it; with no listener nothing happens. */
+    compact = new EventEmitter();
     onContextThreshold(e) { this.contextThreshold.emit(e.detail); }
+    onCompact(e) { this.compact.emit(e.detail); }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteContextDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteContextDirective, isStandalone: true, selector: "aparte-context", inputs: { window: ["window", "window", numberAttribute], warn: ["warn", "warn", numberAttribute], danger: ["danger", "danger", numberAttribute], target: "target", autoCompact: ["autoCompact", "autoCompact", booleanAttribute], dataLevel: "dataLevel", dataEmpty: ["dataEmpty", "dataEmpty", booleanAttribute] }, outputs: { contextThreshold: "contextThreshold" }, host: { listeners: { "aparte-context-threshold": "onContextThreshold($event)" } }, usesInheritance: true, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteContextDirective, isStandalone: true, selector: "aparte-context", inputs: { window: ["window", "window", numberAttribute], warn: ["warn", "warn", numberAttribute], danger: ["danger", "danger", numberAttribute], target: "target", variant: "variant", autoCompact: ["autoCompact", "autoCompact", booleanAttribute], dataLevel: "dataLevel", dataEmpty: ["dataEmpty", "dataEmpty", booleanAttribute] }, outputs: { contextThreshold: "contextThreshold", compact: "compact" }, host: { listeners: { "aparte-context-threshold": "onContextThreshold($event)", "aparte-compact": "onCompact($event)" } }, usesInheritance: true, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteContextDirective, decorators: [{
             type: Directive,
@@ -1350,6 +1402,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 args: [{ transform: numberAttribute }]
             }], target: [{
                 type: Input
+            }], variant: [{
+                type: Input
             }], autoCompact: [{
                 type: Input,
                 args: [{ transform: booleanAttribute }]
@@ -1360,54 +1414,88 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 args: [{ transform: booleanAttribute }]
             }], contextThreshold: [{
                 type: Output
+            }], compact: [{
+                type: Output
             }], onContextThreshold: [{
                 type: HostListener,
                 args: ['aparte-context-threshold', ['$event']]
+            }], onCompact: [{
+                type: HostListener,
+                args: ['aparte-compact', ['$event']]
             }] } });
-/** `<aparte-conversation-list>` — Conversation-history sidebar — a framework-agnostic web component. The host sets the `conversations` JS property and the `active-id` attribute; this renders the list and fires the user's intent, never acting on it itself. */
+/** `<aparte-conversation-list>` — Conversation-history sidebar — a framework-agnostic web component. The host sets the `conversations` JS property and the `active-id` attribute; this renders the rows and fires the user's intent, never acting on it itself. */
 class AparteConversationListDirective extends AparteElementBase {
     /** The id of the conversation to render as selected. */
     set activeId(v) { this.write('active-id', v); }
-    /** A row was activated; the host loads that conversation. */
-    selectConversation = new EventEmitter();
-    /** The delete action was pressed. Nothing is removed here. */
-    deleteConversation = new EventEmitter();
-    /** The archive action was pressed on a live conversation. */
-    archiveConversation = new EventEmitter();
-    /** The same action on an already-archived one; same detail shape, opposite intent. */
+    /** Render the rows flat, in host order, with no date headings. */
+    set noGroups(v) { this.write('no-groups', v); }
+    /** The same item on a pinned row; same detail shape, opposite intent. */
+    unpinConversation = new EventEmitter();
+    /** The pin item was chosen on an unpinned row. */
+    pinConversation = new EventEmitter();
+    /** The same item on an already-archived one; same detail shape, opposite intent. */
     unarchiveConversation = new EventEmitter();
-    onSelectConversation(e) { this.selectConversation.emit(e.detail); }
-    onDeleteConversation(e) { this.deleteConversation.emit(e.detail); }
-    onArchiveConversation(e) { this.archiveConversation.emit(e.detail); }
+    /** The archive item was chosen on a live conversation. */
+    archiveConversation = new EventEmitter();
+    /** The delete was confirmed. Nothing is removed here. */
+    deleteConversation = new EventEmitter();
+    /** A rename was committed with a new, non-empty title. Nothing is renamed here. */
+    renameConversation = new EventEmitter();
+    /** A row's title was activated; the host loads that conversation. */
+    selectConversation = new EventEmitter();
+    onUnpinConversation(e) { this.unpinConversation.emit(e.detail); }
+    onPinConversation(e) { this.pinConversation.emit(e.detail); }
     onUnarchiveConversation(e) { this.unarchiveConversation.emit(e.detail); }
+    onArchiveConversation(e) { this.archiveConversation.emit(e.detail); }
+    onDeleteConversation(e) { this.deleteConversation.emit(e.detail); }
+    onRenameConversation(e) { this.renameConversation.emit(e.detail); }
+    onSelectConversation(e) { this.selectConversation.emit(e.detail); }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteConversationListDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.25", type: AparteConversationListDirective, isStandalone: true, selector: "aparte-conversation-list", inputs: { activeId: "activeId" }, outputs: { selectConversation: "selectConversation", deleteConversation: "deleteConversation", archiveConversation: "archiveConversation", unarchiveConversation: "unarchiveConversation" }, host: { listeners: { "aparte-select-conversation": "onSelectConversation($event)", "aparte-delete-conversation": "onDeleteConversation($event)", "aparte-archive-conversation": "onArchiveConversation($event)", "aparte-unarchive-conversation": "onUnarchiveConversation($event)" } }, usesInheritance: true, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteConversationListDirective, isStandalone: true, selector: "aparte-conversation-list", inputs: { activeId: "activeId", noGroups: ["noGroups", "noGroups", booleanAttribute] }, outputs: { unpinConversation: "unpinConversation", pinConversation: "pinConversation", unarchiveConversation: "unarchiveConversation", archiveConversation: "archiveConversation", deleteConversation: "deleteConversation", renameConversation: "renameConversation", selectConversation: "selectConversation" }, host: { listeners: { "aparte-unpin-conversation": "onUnpinConversation($event)", "aparte-pin-conversation": "onPinConversation($event)", "aparte-unarchive-conversation": "onUnarchiveConversation($event)", "aparte-archive-conversation": "onArchiveConversation($event)", "aparte-delete-conversation": "onDeleteConversation($event)", "aparte-rename-conversation": "onRenameConversation($event)", "aparte-select-conversation": "onSelectConversation($event)" } }, usesInheritance: true, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteConversationListDirective, decorators: [{
             type: Directive,
             args: [{ selector: 'aparte-conversation-list', standalone: true }]
         }], propDecorators: { activeId: [{
                 type: Input
-            }], selectConversation: [{
+            }], noGroups: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], unpinConversation: [{
                 type: Output
-            }], deleteConversation: [{
+            }], pinConversation: [{
+                type: Output
+            }], unarchiveConversation: [{
                 type: Output
             }], archiveConversation: [{
                 type: Output
-            }], unarchiveConversation: [{
+            }], deleteConversation: [{
                 type: Output
-            }], onSelectConversation: [{
+            }], renameConversation: [{
+                type: Output
+            }], selectConversation: [{
+                type: Output
+            }], onUnpinConversation: [{
                 type: HostListener,
-                args: ['aparte-select-conversation', ['$event']]
-            }], onDeleteConversation: [{
+                args: ['aparte-unpin-conversation', ['$event']]
+            }], onPinConversation: [{
                 type: HostListener,
-                args: ['aparte-delete-conversation', ['$event']]
+                args: ['aparte-pin-conversation', ['$event']]
+            }], onUnarchiveConversation: [{
+                type: HostListener,
+                args: ['aparte-unarchive-conversation', ['$event']]
             }], onArchiveConversation: [{
                 type: HostListener,
                 args: ['aparte-archive-conversation', ['$event']]
-            }], onUnarchiveConversation: [{
+            }], onDeleteConversation: [{
                 type: HostListener,
-                args: ['aparte-unarchive-conversation', ['$event']]
+                args: ['aparte-delete-conversation', ['$event']]
+            }], onRenameConversation: [{
+                type: HostListener,
+                args: ['aparte-rename-conversation', ['$event']]
+            }], onSelectConversation: [{
+                type: HostListener,
+                args: ['aparte-select-conversation', ['$event']]
             }] } });
 /** `<aparte-elicitation>` — The default presenter for a request to the human. It renders nothing itself: it registers as the presenter for the config governing its subtree, and mounts a panel inside the nearest `<aparte-composer>` when something asks — a tool handler calling `requestUserInput`, or core's own approval gate. */
 /**
@@ -1514,6 +1602,36 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 type: Input,
                 args: [{ transform: numberAttribute }]
             }] } });
+/** `<aparte-scroll-rail>` — A rail of ticks beside the transcript — one per turn — that shows where you are in a long conversation and jumps back to any message on a click. */
+class AparteScrollRailDirective extends AparteElementBase {
+    /** The id of the `<aparte-chat>` to follow, when the element is not inside it. */
+    set target(v) { this.write('target', v); }
+    /** `user` (default): one tick per user turn. `message`: one per message. */
+    set every(v) { this.write('every', v); }
+    /** Reflected BY the element while it has fewer than two ticks. Read-only. */
+    set dataEmpty(v) { this.write('data-empty', v); }
+    /** A tick was activated. Bubbles, cancelable: `preventDefault()` leaves the transcript where it is. */
+    scrollRailJump = new EventEmitter();
+    onScrollRailJump(e) { this.scrollRailJump.emit(e.detail); }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteScrollRailDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteScrollRailDirective, isStandalone: true, selector: "aparte-scroll-rail", inputs: { target: "target", every: "every", dataEmpty: ["dataEmpty", "dataEmpty", booleanAttribute] }, outputs: { scrollRailJump: "scrollRailJump" }, host: { listeners: { "aparte-scroll-rail-jump": "onScrollRailJump($event)" } }, usesInheritance: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteScrollRailDirective, decorators: [{
+            type: Directive,
+            args: [{ selector: 'aparte-scroll-rail', standalone: true }]
+        }], propDecorators: { target: [{
+                type: Input
+            }], every: [{
+                type: Input
+            }], dataEmpty: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], scrollRailJump: [{
+                type: Output
+            }], onScrollRailJump: [{
+                type: HostListener,
+                args: ['aparte-scroll-rail-jump', ['$event']]
+            }] } });
 /** `<aparte-select>` — Dropdown select for aparté — a vanilla web component with optional grouping, a search filter and a keyboard-driven listbox. */
 class AparteSelectDirective extends AparteElementBase {
     /** The selected option's value. */
@@ -1575,6 +1693,94 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 type: HostListener,
                 args: ['aparte-select-change', ['$event']]
             }] } });
+/** `<aparte-sidebar>` — The column beside the chat — conversations, a new-chat button, a search field, an account row — as an element, because it has behaviour: it collapses, it becomes a drawer on a narrow window, and its search field filters the conversation list. */
+class AparteSidebarDirective extends AparteElementBase {
+    /** Hidden (in the flow) or closed (as a drawer). Reflected; set it to start closed. */
+    set collapsed(v) { this.write('collapsed', v); }
+    /** The window width under which the sidebar becomes a drawer: a length (default `48rem`), or `none` for a column that never does. */
+    set breakpoint(v) { this.write('breakpoint', v); }
+    /** Reflected BY the element while the window is under 48rem. Read-only. */
+    set dataDrawer(v) { this.write('data-drawer', v); }
+    /** The sidebar opened or closed, by a toggle, by Escape, by a click on the scrim or by `collapsed` being set. Bubbles. */
+    sidebarToggle = new EventEmitter();
+    onSidebarToggle(e) { this.sidebarToggle.emit(e.detail); }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteSidebarDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteSidebarDirective, isStandalone: true, selector: "aparte-sidebar", inputs: { collapsed: ["collapsed", "collapsed", booleanAttribute], breakpoint: "breakpoint", dataDrawer: ["dataDrawer", "dataDrawer", booleanAttribute] }, outputs: { sidebarToggle: "sidebarToggle" }, host: { listeners: { "aparte-sidebar-toggle": "onSidebarToggle($event)" } }, usesInheritance: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteSidebarDirective, decorators: [{
+            type: Directive,
+            args: [{ selector: 'aparte-sidebar', standalone: true }]
+        }], propDecorators: { collapsed: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], breakpoint: [{
+                type: Input
+            }], dataDrawer: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], sidebarToggle: [{
+                type: Output
+            }], onSidebarToggle: [{
+                type: HostListener,
+                args: ['aparte-sidebar-toggle', ['$event']]
+            }] } });
+/** `<aparte-split>` — Two panes and a draggable seam — a chat beside a preview, an editor, an artifact card. */
+class AparteSplitDirective extends AparteElementBase {
+    /** The primary pane's size, as a percentage of the container. Reflected on commit, never per drag frame. */
+    set position(v) { this.write('position', v); }
+    /** `horizontal` (panes side by side, the default) or `vertical` (stacked). Names the CONTAINER's axis. */
+    set orientation(v) { this.write('orientation', v); }
+    /** `start` (default) or `end`: which pane `position` sizes. */
+    set primary(v) { this.write('primary', v); }
+    /** The primary pane folded to its minimum. Enter on the seam toggles it; a second Enter restores the size it had. */
+    set collapsed(v) { this.write('collapsed', v); }
+    /** Below this width the split shows one pane at a time. A length (default `48rem`), or `none` to never stack. */
+    set breakpoint(v) { this.write('breakpoint', v); }
+    /** `start` (default) or `end`: which pane is shown while stacked. */
+    set pane(v) { this.write('pane', v); }
+    /** No drag, no keys, no tab stop; the seam stays drawn. */
+    set disabled(v) { this.write('disabled', v); }
+    /** The seam's accessible name. Defaults to the locale's `splitHandleLabel`. */
+    set label(v) { this.write('label', v); }
+    /** Written BY the element while one pane is shown. Read-only; style against it. */
+    set dataStacked(v) { this.write('data-stacked', v); }
+    /** The position settled: after a drag, a key, a double-click or a property set. Never during a drag — persist from here. */
+    splitResize = new EventEmitter();
+    onSplitResize(e) { this.splitResize.emit(e.detail); }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteSplitDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.25", type: AparteSplitDirective, isStandalone: true, selector: "aparte-split", inputs: { position: ["position", "position", numberAttribute], orientation: "orientation", primary: "primary", collapsed: ["collapsed", "collapsed", booleanAttribute], breakpoint: "breakpoint", pane: "pane", disabled: ["disabled", "disabled", booleanAttribute], label: "label", dataStacked: ["dataStacked", "dataStacked", booleanAttribute] }, outputs: { splitResize: "splitResize" }, host: { listeners: { "aparte-split-resize": "onSplitResize($event)" } }, usesInheritance: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AparteSplitDirective, decorators: [{
+            type: Directive,
+            args: [{ selector: 'aparte-split', standalone: true }]
+        }], propDecorators: { position: [{
+                type: Input,
+                args: [{ transform: numberAttribute }]
+            }], orientation: [{
+                type: Input
+            }], primary: [{
+                type: Input
+            }], collapsed: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], breakpoint: [{
+                type: Input
+            }], pane: [{
+                type: Input
+            }], disabled: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], label: [{
+                type: Input
+            }], dataStacked: [{
+                type: Input,
+                args: [{ transform: booleanAttribute }]
+            }], splitResize: [{
+                type: Output
+            }], onSplitResize: [{
+                type: HostListener,
+                args: ['aparte-split-resize', ['$event']]
+            }] } });
 /** `<aparte-suggestions>` — Prompt starters — a row of suggested prompts a reader clicks instead of typing. */
 class AparteSuggestionsDirective extends AparteElementBase {
     /** The starters, as a JSON array: strings, or `{ "label", "prompt" }` objects when the visible label and the sent text differ. The `suggestions` PROPERTY takes the same shape without the JSON. */
@@ -1640,7 +1846,10 @@ const APARTE_ELEMENT_DIRECTIVES = [
     AparteOptgroupDirective,
     AparteOptionDirective,
     AparteProgressSpinnerDirective,
+    AparteScrollRailDirective,
     AparteSelectDirective,
+    AparteSidebarDirective,
+    AparteSplitDirective,
     AparteSuggestionsDirective,
 ];
 
@@ -1754,6 +1963,21 @@ class ConversationManagerService {
         this._assertInit();
         return this._manager.unarchive(id);
     }
+    /** Pin a conversation to the top of the list. */
+    async pin(id) {
+        this._assertInit();
+        return this._manager.pin(id);
+    }
+    /** Unpin a conversation. */
+    async unpin(id) {
+        this._assertInit();
+        return this._manager.unpin(id);
+    }
+    /** Rename a conversation. */
+    async updateTitle(id, title) {
+        this._assertInit();
+        return this._manager.updateTitle(id, title);
+    }
     // ─── Private ─────────────────────────────────────────────────────────────
     _assertInit() {
         if (!this._manager) {
@@ -1778,5 +2002,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { APARTE_CLIENT_OPTIONS, APARTE_CONFIG_TOKEN, APARTE_ELEMENT_DIRECTIVES, AparteAiService, AparteChatBubbleDirective, AparteChatComponent, AparteChatStatusDirective, AparteChatViewportDirective, AparteComposerActionDirective, AparteComposerAddAttachmentDirective, AparteComposerAttachmentsDirective, AparteComposerCancelDirective, AparteComposerDirective, AparteComposerInputDirective, AparteComposerSendDirective, AparteComposerToolbarDirective, AparteConversationListDirective, AparteElicitationDirective, AparteOptgroupDirective, AparteOptionDirective, AparteProgressSpinnerDirective, AparteSelectDirective, AparteUiComponent, ConversationManagerService, provideAparte };
+export { APARTE_CLIENT_OPTIONS, APARTE_CONFIG_TOKEN, APARTE_ELEMENT_DIRECTIVES, AparteAiService, AparteChatBubbleDirective, AparteChatComponent, AparteChatStatusDirective, AparteChatViewportDirective, AparteComposerActionDirective, AparteComposerAddAttachmentDirective, AparteComposerAttachmentsDirective, AparteComposerCancelDirective, AparteComposerDirective, AparteComposerInputDirective, AparteComposerSendDirective, AparteComposerToolbarDirective, AparteContextDirective, AparteConversationListDirective, AparteElicitationDirective, AparteIconDirective, AparteOptgroupDirective, AparteOptionDirective, AparteProgressSpinnerDirective, AparteScrollRailDirective, AparteSelectDirective, AparteSidebarDirective, AparteSplitDirective, AparteSuggestionsDirective, AparteUiComponent, ConversationManagerService, provideAparte };
 //# sourceMappingURL=aparte-angular.mjs.map