@aparte/core 0.15.1 → 0.16.0

package/dist/components/conversation-list/aparte-conversation-list.d.ts

@@ -1,9 +1,12 @@
 export interface AparteConversationListItem {
     id: string;
     title: string;
+    /** Drives the date groups. A list where no item carries one renders flat. */
     updatedAt?: number;
-    /** When set, the item renders the unarchive action instead of archive. */
+    /** When set, the row is italic and its menu offers unarchive instead of archive. */
     archivedAt?: number;
+    /** When set, the row sits in the "Pinned" group first, and its menu offers unpin. */
+    pinnedAt?: number;
 }
 export interface AparteConversationSelectDetail {
     id: string;
@@ -14,10 +17,27 @@ export interface AparteConversationDeleteDetail {
 export interface AparteConversationArchiveDetail {
     id: string;
 }
+export interface AparteConversationPinDetail {
+    id: string;
+}
+export interface AparteConversationRenameDetail {
+    id: string;
+    /** The new title, trimmed and non-empty — an unchanged or emptied title fires nothing. */
+    title: string;
+}
 /**
  * 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.
+ * rows and fires the user's intent, never acting on it itself.
+ *
+ * A row is two real buttons: the title, which selects, and a `⋯` that opens the row's
+ * menu — rename, pin or unpin, archive or unarchive, delete. Every item fires an event
+ * and stops; the one exception is delete, which asks first, inline in the menu,
+ * because it is the one action the host cannot undo. Rename swaps the title for an
+ * input: Enter or leaving the field commits, Escape cancels, and an unchanged or
+ * emptied title fires nothing. The rows are grouped by date — Pinned, Today,
+ * Yesterday, Previous 7 days, Previous 30 days, then one heading per month — as soon
+ * as any item carries `updatedAt`; set `no-groups` to render them flat.
  *
  * Children are not a composition point: `_render()` assigns `innerHTML` from the
  * `conversations` array, so any light-DOM child a host writes inside the element is
@@ -25,29 +45,33 @@ export interface AparteConversationArchiveDetail {
  * enough to trigger one. Compose around the element, not inside it: it renders rows
  * and nothing else, with no header, no new-conversation button and no search field.
  *
- * What it is not: a store. Clicking a row selects nothing, and the two row actions
- * delete and archive nothing — the four events carry an id and stop. A row's text
- * comes from the array, so it changes when the host assigns `conversations` again;
- * the exception is an empty title, which falls back to the locale's new-chat label
- * and therefore follows a locale switch. An archived item is still rendered (it gains
- * `aparte-conv-item--archived` and swaps its action's icon and event name); filtering
- * archived conversations out of the list is the host's decision, not this element's.
- * The asymmetry between the two inputs is deliberate: `active-id` is an attribute
- * because moving the selection patches the rendered rows in place, while
- * `conversations` is a JS property because it is structured data an attribute cannot
- * carry, and setting it re-renders the whole list.
+ * What it is not: a store. Selecting, renaming, pinning, archiving and deleting all
+ * leave the array untouched — the events carry an id (and, for rename, the title) and
+ * stop. A row's text comes from the array, so it changes when the host assigns
+ * `conversations` again; the exception is an empty title, which falls back to the
+ * locale's new-chat label and therefore follows a locale switch. An archived item is
+ * still rendered (it gains `aparte-conv-item--archived`); filtering archived
+ * conversations out of the list is the host's decision, not this element's. The
+ * asymmetry between the two inputs is deliberate: `active-id` is an attribute because
+ * moving the selection patches the rendered rows in place, while `conversations` is a
+ * JS property because it is structured data an attribute cannot carry, and setting it
+ * re-renders the whole list.
  *
  * @element aparte-conversation-list
  * @attr {string} active-id - The id of the conversation to render as selected.
+ * @attr {boolean} no-groups - Render the rows flat, in host order, with no date headings.
  *
- * @fires {CustomEvent<AparteConversationSelectDetail>} aparte-select-conversation - A row was activated; the host loads that conversation.
- * @fires {CustomEvent<AparteConversationDeleteDetail>} aparte-delete-conversation - The delete action was pressed. Nothing is removed here.
- * @fires {CustomEvent<AparteConversationArchiveDetail>} aparte-archive-conversation - The archive action was pressed on a live conversation.
- * @fires {CustomEvent<AparteConversationArchiveDetail>} aparte-unarchive-conversation - The same action on an already-archived one; same detail shape, opposite intent.
+ * @fires {CustomEvent<AparteConversationSelectDetail>} aparte-select-conversation - A row's title was activated; the host loads that conversation.
+ * @fires {CustomEvent<AparteConversationRenameDetail>} aparte-rename-conversation - A rename was committed with a new, non-empty title. Nothing is renamed here.
+ * @fires {CustomEvent<AparteConversationPinDetail>} aparte-pin-conversation - The pin item was chosen on an unpinned row.
+ * @fires {CustomEvent<AparteConversationPinDetail>} aparte-unpin-conversation - The same item on a pinned row; same detail shape, opposite intent.
+ * @fires {CustomEvent<AparteConversationArchiveDetail>} aparte-archive-conversation - The archive item was chosen on a live conversation.
+ * @fires {CustomEvent<AparteConversationArchiveDetail>} aparte-unarchive-conversation - The same item on an already-archived one; same detail shape, opposite intent.
+ * @fires {CustomEvent<AparteConversationDeleteDetail>} aparte-delete-conversation - The delete was confirmed. Nothing is removed here.
  *
- * @cssprop [--aparte-conv-list-gap=2px] - Vertical gap between rows. The element itself is the flex column, so this is its `gap`.
- * @cssprop [--aparte-conv-item-padding=7px 10px] - Padding of a row.
- * @cssprop [--aparte-conv-item-gap=6px] - Gap between a row's title and its two action buttons.
+ * @cssprop [--aparte-conv-list-gap=2px] - Vertical gap between rows, and between a group's heading and its rows.
+ * @cssprop [--aparte-conv-item-padding=7px 10px] - Padding of a row's title button.
+ * @cssprop [--aparte-conv-item-gap=6px] - Gap between a row's title and its `⋯` button.
  * @cssprop [--aparte-conv-item-radius=var(--aparte-radius-md)] - Corner radius of a row.
  * @cssprop [--aparte-conv-item-font-size=0.8125rem] - Font size of a row's title.
  * @cssprop [--aparte-conv-item-color=var(--aparte-text-muted)] - Title colour of an inactive row.
@@ -55,15 +79,7 @@ export interface AparteConversationArchiveDetail {
  * @cssprop [--aparte-conv-item-bg-active=var(--aparte-surface-3)] - Background of the row matching `active-id`.
  * @cssprop [--aparte-conv-item-color-active=var(--aparte-text)] - Title colour of the active row.
  * @cssprop [--aparte-conv-item-font-weight-active=var(--aparte-font-weight-medium, 500)] - Title weight of the active row.
- * @cssprop [--aparte-conv-action-btn-size=20px] - Square size of both action buttons. Under `(pointer: coarse)` the stylesheet redeclares it as 28px on the buttons themselves, so a value set on the element does not reach them there; the buttons also stay visible instead of appearing on hover.
- * @cssprop [--aparte-conv-delete-color=var(--aparte-text-muted)] - Icon colour of the delete button.
- * @cssprop [--aparte-conv-delete-bg-hover=var(--aparte-error)] - Delete button background on hover.
- * @cssprop [--aparte-conv-delete-color-hover=var(--aparte-text-inverse)] - Delete button icon colour on hover.
- * @cssprop [--aparte-conv-delete-radius=var(--aparte-radius-sm)] - Corner radius of the delete button.
- * @cssprop [--aparte-conv-archive-color=var(--aparte-text-muted)] - Icon colour of the archive/unarchive button.
- * @cssprop [--aparte-conv-archive-bg-hover=var(--aparte-surface-4, var(--aparte-surface-3))] - Archive button background on hover. Core declares no `--aparte-surface-4`, so unset it resolves to `--aparte-surface-3`.
- * @cssprop [--aparte-conv-archive-color-hover=var(--aparte-text)] - Archive button icon colour on hover.
- * @cssprop [--aparte-conv-archive-radius=var(--aparte-radius-sm)] - Corner radius of the archive button.
+ * @cssprop [--aparte-conv-action-btn-size=20px] - Square size of the `⋯` button. Under `(pointer: coarse)` the stylesheet redeclares it as 28px on the button itself, so a value set on the element does not reach it there; the button also stays visible instead of appearing on hover.
  *
  * @example
  * <!-- It stores nothing and fetches nothing: an empty tag renders the empty state, and
@@ -71,9 +87,12 @@ export interface AparteConversationArchiveDetail {
  * <aparte-conversation-list active-id="c1" style="max-width: 20rem"></aparte-conversation-list>
  *
  * <script>
+ *   const day = 864e5;
  *   document.querySelector('aparte-conversation-list').conversations = [
+ *     { id: 'c0', title: 'Release checklist', updatedAt: Date.now() - 3 * day, pinnedAt: Date.now() },
  *     { id: 'c1', title: 'Deploy checklist', updatedAt: Date.now() },
- *     { id: 'c2', title: 'Rename the segment types', updatedAt: Date.now() - 864e5 },
+ *     { id: 'c2', title: 'Rename the segment types', updatedAt: Date.now() - day },
+ *     { id: 'c3', title: 'Tokens, not selectors', updatedAt: Date.now() - 4 * day },
  *   ];
  * </script>
  *
@@ -87,31 +106,69 @@ export interface AparteConversationArchiveDetail {
  * list.setAttribute('active-id', 'c1');
  *
  * list.addEventListener('aparte-select-conversation', (e) => load(e.detail.id));
- * list.addEventListener('aparte-delete-conversation', (e) => remove(e.detail.id));
+ * list.addEventListener('aparte-rename-conversation', (e) => manager.updateTitle(e.detail.id, e.detail.title));
+ * list.addEventListener('aparte-pin-conversation', (e) => manager.pin(e.detail.id));
+ * list.addEventListener('aparte-delete-conversation', (e) => manager.delete(e.detail.id));
  */
 export declare class AparteConversationList extends HTMLElement {
     private _conversations;
     private _activeId;
+    private _open;
+    private _renaming;
     static get observedAttributes(): string[];
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     /**
-     * Re-render on a locale switch: every row's title fallback and both button
-     * labels come from the locale, so without this the list stayed in the previous
-     * language until something else happened to re-render it. Only OUR config.
+     * Re-render on a locale switch: every row's title fallback, the `⋯` button's name
+     * and the group headings come from the locale, so without this the list stayed in
+     * the previous language until something else happened to re-render it. Only OUR
+     * config.
      */
     private _onConfigChange;
     /** Set the list of conversations to display. Triggers a re-render. */
     set conversations(items: AparteConversationListItem[]);
     get conversations(): AparteConversationListItem[];
     private _render;
+    private _t;
+    /**
+     * Pinned first, then the calendar buckets every chat product uses, then a heading
+     * per month (newest first), then whatever carries no date. Flat when nothing is
+     * dated or the host asked for `no-groups`: a heading over the only group would say
+     * nothing.
+     */
+    private _groups;
+    private _renderGroup;
     private _renderItem;
-    private _bindEvents;
+    private _menuMarkup;
+    private _confirmMarkup;
+    private _openMenu;
+    /**
+     * Fixed, below the button's end edge, flipped above it when the viewport ends
+     * first. Fixed rather than absolute because a sidebar scrolls: an absolute menu on
+     * the last rows would be clipped by the list's own overflow. No anchoring library —
+     * the menu closes on any scroll or resize, which is what makes the arithmetic
+     * safe to do once.
+     */
+    private _placeMenu;
+    private _closeMenu;
+    private _onDocumentPointerDown;
+    private _onWindowScroll;
+    private _onFocusOut;
+    private _onMenuAction;
+    private _menuFocusables;
+    private _onMenuKeydown;
+    private _startRename;
+    /**
+     * One exit for the three ways out (Enter, Escape, leaving the field), guarded so
+     * the blur a removal causes cannot commit a second time. The row is re-rendered
+     * from the array either way: the list shows data, and the host's re-assignment is
+     * what makes the new title appear.
+     */
+    private _finishRename;
     private _onClick;
     private _onKeydown;
     /** Update active class without full re-render (perf optimisation). */
     private _updateActiveState;
-    private _esc;
 }
 //# sourceMappingURL=aparte-conversation-list.d.ts.map

package/dist/components/conversation-list/aparte-conversation-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-conversation-list.d.ts","sourceRoot":"","sources":["../../../src/components/conversation-list/aparte-conversation-list.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,0BAA0B;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC3C,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,8BAA8B;IAC3C,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,+BAA+B;IAC5C,EAAE,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACnD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,SAAS,CAAuB;IAExC,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAID,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAI5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ9F;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAIrB;IAIF,sEAAsE;IACtE,IAAI,aAAa,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAGpD;IAED,IAAI,aAAa,IAAI,0BAA0B,EAAE,CAEhD;IAID,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,WAAW;IA8CnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,QAAQ,CAkCd;IAEF,OAAO,CAAC,UAAU,CAoBhB;IAEF,sEAAsE;IACtE,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,IAAI;CAQf"}
+{"version":3,"file":"aparte-conversation-list.d.ts","sourceRoot":"","sources":["../../../src/components/conversation-list/aparte-conversation-list.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,0BAA0B;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC3C,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,8BAA8B;IAC3C,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,+BAA+B;IAC5C,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,2BAA2B;IACxC,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,8BAA8B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;CACjB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACnD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAuE;IAExF,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAID,iBAAiB,IAAI,IAAI;IAczB,oBAAoB,IAAI,IAAI;IAQ5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAU9F;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAIrB;IAIF,sEAAsE;IACtE,IAAI,aAAa,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAGpD;IAED,IAAI,aAAa,IAAI,0BAA0B,EAAE,CAEhD;IAID,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,EAAE;IAKV;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IA6Cf,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,SAAS;IAoBjB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,sBAAsB,CAO5B;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,WAAW,CAQjB;IAEF,OAAO,CAAC,aAAa;IA8DrB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,YAAY;IAgBpB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,QAAQ,CA2Bd;IAEF,OAAO,CAAC,UAAU,CAYhB;IAEF,sEAAsE;IACtE,OAAO,CAAC,kBAAkB;CAQ7B"}

package/dist/components/conversation-list/index.d.ts

@@ -1,2 +1,2 @@
-export { AparteConversationList, type AparteConversationListItem, type AparteConversationSelectDetail, type AparteConversationDeleteDetail, type AparteConversationArchiveDetail, } from './aparte-conversation-list.js';
+export { AparteConversationList, type AparteConversationListItem, type AparteConversationSelectDetail, type AparteConversationDeleteDetail, type AparteConversationArchiveDetail, type AparteConversationPinDetail, type AparteConversationRenameDetail, } from './aparte-conversation-list.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/conversation-list/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,GACvC,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,GACtC,MAAM,+BAA+B,CAAC"}

package/dist/components/elicitation/aparte-elicitation.d.ts

@@ -79,11 +79,13 @@ import type { AparteConfig } from '../../config/aparte-config.js';
  * @cssprop [--aparte-approval-option-size=0.85rem] - Font size of an approval option button.
  * @cssprop [--aparte-approval-option-padding=8px 10px] - Padding of an approval option button.
  * @cssprop [--aparte-approval-option-radius=8px] - Corner radius of an approval option button.
+ * @cssprop [--aparte-approval-args-max-height=8.5rem] - Height cap of the arguments block before it scrolls.
+ * @cssprop [--aparte-approval-args-size=var(--aparte-font-size-sm)] - Font size of the arguments block.
  *
  * @example
  * <!-- Renders nothing by itself: it registers as the presenter for its subtree, so a
  *      tool handler calling requestUserInput() gets its panel mounted in the composer. -->
- * <aparte-chat>
+ * <aparte-chat style="height: 20rem">
  *   <aparte-chat-viewport></aparte-chat-viewport>
  *   <aparte-elicitation></aparte-elicitation>
  *   <aparte-composer>
@@ -93,6 +95,22 @@ import type { AparteConfig } from '../../config/aparte-config.js';
  *     </div>
  *   </aparte-composer>
  * </aparte-chat>
+ *
+ * <script>
+ *   // `aparte` is the `@aparte/core` module the frame exposes; in your app this line is
+ *   // `import { requestUserInput } from '@aparte/core'`. A tool handler asks; the panel
+ *   // mounts in the composer of the chat whose presenter this element is.
+ *   aparte.requestUserInput({
+ *     message: 'Which environment should I deploy to?',
+ *     schema: {
+ *       type: 'enum',
+ *       options: [
+ *         { value: 'staging', label: 'Staging', recommended: true },
+ *         { value: 'prod', label: 'Production', description: 'Live traffic' },
+ *       ],
+ *     },
+ *   });
+ * </script>
  */
 export declare class AparteElicitation extends HTMLElement implements AparteConfigAware {
     private _pending;

package/dist/components/elicitation/aparte-elicitation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aparte-elicitation.d.ts","sourceRoot":"","sources":["../../../src/components/elicitation/aparte-elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,iBAAiB;IAC3E,OAAO,CAAC,QAAQ,CAAwB;IACxC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,iBAAiB,IAAI,IAAI;IAiBzB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQrE,oBAAoB,IAAI,IAAI;IAY5B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,QAAQ,CA0Md;IAEF,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,YAAY;CAwBvB"}
+{"version":3,"file":"aparte-elicitation.d.ts","sourceRoot":"","sources":["../../../src/components/elicitation/aparte-elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAiClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,iBAAiB;IAC3E,OAAO,CAAC,QAAQ,CAAwB;IACxC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,iBAAiB,IAAI,IAAI;IAiBzB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQrE,oBAAoB,IAAI,IAAI;IAY5B;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,QAAQ,CAoMd;IAEF,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,YAAY;CAwBvB"}

package/dist/components/index.d.ts

@@ -6,9 +6,15 @@ export { AparteChatViewport } from './viewport/index.js';
 export { AparteComposer, AparteComposerInput, AparteComposerSend, AparteComposerCancel, AparteComposerAttachments, AparteComposerAddAttachment, AparteComposerAction, AparteComposerToolbar } from './composer/index.js';
 export type { AparteComposerEventMap, AparteComposerEventType, AparteComposerState, AparteComposerChangeEventDetail, AparteComposerPanelMode, AparteActionClickEventDetail } from './composer/index.js';
 export { AparteConversationList } from './conversation-list/index.js';
-export type { AparteConversationListItem, AparteConversationSelectDetail, AparteConversationDeleteDetail, AparteConversationArchiveDetail } from './conversation-list/index.js';
+export type { AparteConversationListItem, AparteConversationSelectDetail, AparteConversationDeleteDetail, AparteConversationArchiveDetail, AparteConversationPinDetail, AparteConversationRenameDetail } from './conversation-list/index.js';
 export { AparteSuggestions } from './suggestions/index.js';
 export type { AparteSuggestion, AparteSuggestionEventDetail } from './suggestions/index.js';
 export { AparteContext } from './context/index.js';
 export type { AparteContextLevel, AparteContextThresholdEventDetail } from './context/index.js';
+export { AparteScrollRail } from './scroll-rail/index.js';
+export type { AparteScrollRailJumpDetail, AparteScrollRailEvery } from './scroll-rail/index.js';
+export { AparteSidebar } from './sidebar/index.js';
+export type { AparteSidebarToggleDetail } from './sidebar/index.js';
+export { AparteSplit } from './split/index.js';
+export type { AparteSplitResizeDetail } from './split/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACzN,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGxM,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAGhL,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACzN,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGxM,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAG7O,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGhG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/scroll-rail/aparte-scroll-rail.d.ts

@@ -0,0 +1,105 @@
+/** Detail of `aparte-scroll-rail-jump`: the message a tick points at. */
+export interface AparteScrollRailJumpDetail {
+    messageId: string;
+}
+/** What a tick is drawn for: one per user turn (the default), or one per message. */
+export type AparteScrollRailEvery = 'user' | 'message';
+/**
+ * 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.
+ *
+ * The thing every long chat is missing and no product ships natively: the scrollbar says
+ * how far down you are, not which question you are under. This is the minimap of a code
+ * editor reduced to its ticks, the search marks of a browser's scrollbar, the scrollspy
+ * of a documentation site — the same ancestry, applied to turns. A tick per USER message
+ * by default, because a user's turns are the questions and a rail with a tick per reply
+ * is unreadable on a long thread; `every="message"` marks each one.
+ *
+ * It owns nothing of the transcript: the viewport keeps its scroll, the bubbles keep
+ * their markup, and the rail only READS them — which bubbles exist (a mutation observer
+ * on the chat), which one is under the reader (an intersection observer on the scroll
+ * surface, never scroll arithmetic), and the first few words of each for the tick's
+ * name. A click is a `scrollIntoView` on the bubble, announced first by a cancelable
+ * `aparte-scroll-rail-jump` so a host that pages history in can load it before the
+ * jump. Honoured by core alone, so it is live by default (ratified decision #8, tier a).
+ *
+ * Place it as a direct child of `<aparte-chat>` (or the wrapper's `[data-aparte-chat]`
+ * host): the stylesheet floats it on the transcript's end edge, vertically centred, and
+ * hides it under a coarse pointer, where a 2px tick is not a target. Under two ticks it
+ * renders nothing — a rail with one mark says nothing.
+ *
+ * @element aparte-scroll-rail
+ *
+ * @attr {string} target - The id of the `<aparte-chat>` to follow, when the element is not inside it.
+ * @attr {string} every - `user` (default): one tick per user turn. `message`: one per message.
+ * @attr {boolean} data-empty - Reflected BY the element while it has fewer than two ticks. Read-only.
+ *
+ * @fires {CustomEvent<AparteScrollRailJumpDetail>} aparte-scroll-rail-jump - A tick was activated. Bubbles, cancelable: `preventDefault()` leaves the transcript where it is.
+ *
+ * @cssprop [--aparte-scroll-rail-width=20px] - The rail's column, the ticks right-aligned in it.
+ * @cssprop [--aparte-scroll-rail-tick-size=14px] - Length of a tick; the current one is 1.6× that.
+ * @cssprop [--aparte-scroll-rail-tick-thickness=2px] - Thickness of a tick.
+ * @cssprop [--aparte-scroll-rail-gap=8px] - Space between ticks.
+ *
+ * @example
+ * <aparte-chat style="height: 18rem">
+ *   <aparte-chat-viewport>
+ *     <aparte-chat-bubble message-id="u1" data-role="user" content="What is a web component?"></aparte-chat-bubble>
+ *     <aparte-chat-bubble message-id="a1" data-role="assistant" name="Assistant" content="A custom element: a tag the browser upgrades to a class you wrote. It carries its own markup, behaviour and, if you want, its own styles — and it works in any framework, or none, because it is the platform's own component model."></aparte-chat-bubble>
+ *     <aparte-chat-bubble message-id="u2" data-role="user" content="And a light-DOM one?"></aparte-chat-bubble>
+ *     <aparte-chat-bubble message-id="a2" data-role="assistant" name="Assistant" content="One that renders its children into the page rather than into a shadow root, so the page's CSS reaches inside it. aparté is light DOM on purpose: a theme is a stylesheet, not an API."></aparte-chat-bubble>
+ *     <aparte-chat-bubble message-id="u3" data-role="user" content="Which one is this rail?"></aparte-chat-bubble>
+ *     <aparte-chat-bubble message-id="a3" data-role="assistant" name="Assistant" content="Light DOM, like everything else here. Its ticks are plain buttons in a list; scroll the transcript and watch the current one move."></aparte-chat-bubble>
+ *   </aparte-chat-viewport>
+ *   <aparte-scroll-rail></aparte-scroll-rail>
+ *   <aparte-composer></aparte-composer>
+ * </aparte-chat>
+ */
+export declare class AparteScrollRail extends HTMLElement {
+    static get observedAttributes(): string[];
+    private _host;
+    private _mutations;
+    private _intersections;
+    private _rebuildQueued;
+    private _currentId;
+    /** Visible ratio per message id, from the intersection observer. */
+    private _visible;
+    private _onConfigChange;
+    /** The id of the message the rail currently marks, or `null`. */
+    get currentMessageId(): string | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    /** The chat this rail follows: `target`, else the host above it — the gauge's rule. */
+    private _findHost;
+    private _attach;
+    private _detach;
+    /** Coalesce a burst of mutations (a streaming reply is one per token) into one rebuild. */
+    private _queueRebuild;
+    private _viewport;
+    /** The element that scrolls: the vanilla container, or the viewport itself under a wrapper. */
+    private _scrollSurface;
+    private _bubbles;
+    /** The first words of a message, for the tick's name. An excerpt, never a summary. */
+    private _excerpt;
+    private _tickLabel;
+    private _rebuild;
+    /**
+     * Which tick is current is read, not computed: the scroll surface is the root, and
+     * the bubble with the largest visible share of a reading band near the top wins.
+     * Scroll arithmetic was the alternative, and every scroll-position rule in the
+     * viewport carries a regression note — this one has none to carry.
+     */
+    private _observe;
+    private _pickCurrent;
+    private _setCurrent;
+    private _onClick;
+    /** The ticks are buttons; the arrows walk them, as in any toolbar. */
+    private _onKeydown;
+    /**
+     * Scroll the transcript to a message. Announced first, cancelable; then a
+     * `scrollIntoView` on the bubble, smooth unless the reader prefers reduced motion.
+     */
+    jumpTo(messageId: string): void;
+}
+//# sourceMappingURL=aparte-scroll-rail.d.ts.map

package/dist/components/scroll-rail/aparte-scroll-rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aparte-scroll-rail.d.ts","sourceRoot":"","sources":["../../../src/components/scroll-rail/aparte-scroll-rail.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACvC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC7C,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAuB;IACzC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAA6B;IAE7C,OAAO,CAAC,eAAe,CAA+B;IAEtD,iEAAiE;IACjE,IAAI,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEpC;IAED,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAO5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5C,uFAAuF;IACvF,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,OAAO;IASf,2FAA2F;IAC3F,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;IAIjB,+FAA+F;IAC/F,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,QAAQ;IAUhB,sFAAsF;IACtF,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ;IAwChB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,QAAQ,CAMd;IAEF,sEAAsE;IACtE,OAAO,CAAC,UAAU,CAWhB;IAEF;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAelC"}

package/dist/components/scroll-rail/index.d.ts

@@ -0,0 +1,3 @@
+export { AparteScrollRail } from './aparte-scroll-rail.js';
+export type { AparteScrollRailJumpDetail, AparteScrollRailEvery } from './aparte-scroll-rail.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/scroll-rail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/scroll-rail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/components/sidebar/aparte-sidebar.d.ts

@@ -0,0 +1,186 @@
+/** Detail of `aparte-sidebar-toggle`: the state just entered. */
+export interface AparteSidebarToggleDetail {
+    collapsed: boolean;
+    /** True while the sidebar is a drawer — the window is under the breakpoint. */
+    drawer: boolean;
+}
+/**
+ * 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.
+ *
+ * What it does NOT own is its content. Children are yours, in the order you want them:
+ * a `.aparte-sidebar__header`, a `.aparte-sidebar__search`, a `.aparte-sidebar__body`
+ * holding the `<aparte-conversation-list>`, a `.aparte-sidebar__footer`. The
+ * stylesheet lays those out and draws nothing you did not put there — the recipe
+ * (`.aparte-sidebar`, in `styles/shell/sidebar.css`) is the look, this element is
+ * the three behaviours.
+ *
+ * **Collapse.** `collapsed` is an attribute, reflected, so the host can set it, read
+ * it and persist it. Any element carrying `data-aparte-sidebar-toggle` anywhere on
+ * the page toggles the nearest sidebar (or the one whose id the attribute names), so
+ * a hamburger in the header needs no script. `aparte-sidebar-toggle` fires on every
+ * change, whoever caused it.
+ *
+ * **Drawer.** Under 48rem of window the sidebar leaves the flow and slides over the
+ * page (`data-drawer`, set by the element from a media query); open, it draws a
+ * scrim, moves the focus to its first focusable child, closes on Escape from anywhere
+ * on the page or on a click outside, and hands the focus back to the control that
+ * opened it. Nothing here is a portal: the drawer is the same element in the same
+ * place, positioned fixed, which is all a sidebar needs and what a dialog would not
+ * get away with. Collapsed — folded as a column or slid off as a drawer — it carries
+ * `inert` and `aria-hidden`, so nothing invisible keeps a tab stop.
+ *
+ * **Search.** An input carrying `data-aparte-sidebar-search` filters the conversation
+ * list below it by title as the user types — rows that do not match are hidden, and a
+ * date group with nothing left hides with them. Client-side, on the titles the list
+ * already has: an index over message bodies is the storage adapter's business.
+ *
+ * @element aparte-sidebar
+ *
+ * @attr {boolean} collapsed - Hidden (in the flow) or closed (as a drawer). Reflected; set it to start closed.
+ * @attr {string} breakpoint - The window width under which the sidebar becomes a drawer: a length (default `48rem`), or `none` for a column that never does.
+ * @attr {boolean} data-drawer - Reflected BY the element while the window is under 48rem. Read-only.
+ *
+ * @fires {CustomEvent<AparteSidebarToggleDetail>} aparte-sidebar-toggle - The sidebar opened or closed, by a toggle, by Escape, by a click on the scrim or by `collapsed` being set. Bubbles.
+ *
+ * @cssprop [--aparte-sidebar-width=260px] - Width of the column, and of the drawer.
+ * @cssprop [--aparte-sidebar-bg=var(--aparte-surface-2)] - Its ground.
+ *
+ * @example
+ * <!-- The sidebar alone, as a column: its header, a search field that filters the list,
+ *      the list, a footer. The shell it sits in — header, chat — is the app-shell guide's.
+ *      breakpoint="none" keeps it a column at any width; without it, under 48rem of
+ *      window it becomes a drawer behind a [data-aparte-sidebar-toggle] control. -->
+ * <aparte-sidebar breakpoint="none" style="height: 22rem">
+ *   <div class="aparte-sidebar__header">
+ *     <span class="aparte-sidebar__brand">aparté</span>
+ *     <button class="aparte-btn aparte-btn--icon aparte-btn--sm" type="button" aria-label="New chat">
+ *       <aparte-icon name="edit"></aparte-icon>
+ *     </button>
+ *   </div>
+ *   <div class="aparte-sidebar__search aparte-field-group">
+ *     <input class="aparte-field aparte-field--sm" type="search" placeholder="Search conversations" data-aparte-sidebar-search>
+ *   </div>
+ *   <div class="aparte-sidebar__body">
+ *     <aparte-conversation-list active-id="c1"></aparte-conversation-list>
+ *   </div>
+ *   <div class="aparte-sidebar__footer">
+ *     <span class="aparte-avatar aparte-avatar--sm">P</span> Paul
+ *   </div>
+ * </aparte-sidebar>
+ * <script>
+ *   const day = 864e5;
+ *   document.querySelector('aparte-conversation-list').conversations = [
+ *     { id: 'c1', title: 'Deploy checklist', updatedAt: Date.now() },
+ *     { id: 'c2', title: 'Rename the segment types', updatedAt: Date.now() - day },
+ *     { id: 'c3', title: 'Tokens, not selectors', updatedAt: Date.now() - 4 * day },
+ *     { id: 'c4', title: 'The first release', updatedAt: Date.now() - 60 * day },
+ *   ];
+ * </script>
+ */
+export declare class AparteSidebar extends HTMLElement {
+    static get observedAttributes(): string[];
+    private _media;
+    private _scrim;
+    /** The control that last opened the drawer, to hand the focus back to. */
+    private _opener;
+    private _lastCollapsed;
+    /**
+     * `connectedCallback` has run and the element knows what its markup asked for.
+     *
+     * Not `isConnected`: during an UPGRADE the element is already in the document, so
+     * `attributeChangedCallback` fires for every authored attribute — connected, and
+     * before `connectedCallback` — which is the ordinary case for a server-rendered
+     * `<aparte-sidebar collapsed>` upgraded when the module loads. Announcing there
+     * tells the host its sidebar just closed when all that happened is that the markup
+     * was read, and says `drawer: false` because the media query has not run yet.
+     */
+    private _ready;
+    /**
+     * The host (or the markup) asked for the column to be folded, so widening the
+     * window must not unfold it. Only a collapse taken OUTSIDE the drawer state counts:
+     * dismissing an overlay says nothing about what a wide window should show.
+     */
+    private _closedByHost;
+    /**
+     * `_closedByHost` has been taken from the markup once. A re-parent runs
+     * `connectedCallback` again, and by then `collapsed` may be the BREAKPOINT's own
+     * write — a drawer closes itself on the way in — so reading it back a second time
+     * records the element's own doing as the host's word and the column never reopens.
+     * Like `_initialCaptured` on `<aparte-split>`, it must survive the move.
+     */
+    private _hostIntentSeeded;
+    /** Raised around `_applyDrawer`'s own writes, so the breakpoint is never read as a host's intent. */
+    private _auto;
+    /**
+     * The element wrote `inert`/`aria-hidden` and may take them back. A host that inerts
+     * the sidebar behind its own modal wrote them itself, and `_syncHidden` runs on every
+     * breakpoint re-evaluation: without this it would un-inert the page behind the overlay.
+     * Same convention as `_relabel`, which leaves a host-authored `aria-label` alone.
+     */
+    private _ownHidden;
+    /** Whether the sidebar is collapsed (hidden in the flow, or closed as a drawer). */
+    get collapsed(): boolean;
+    set collapsed(value: boolean);
+    /** True while the window is under the breakpoint and the sidebar is a drawer. */
+    get drawer(): boolean;
+    connectedCallback(): void;
+    /**
+     * The drawer's media query, from the `breakpoint` attribute: a length (`48rem`, the
+     * default, or `640px`), or `none` for a column that never becomes a drawer — which
+     * a narrow host that has room for it wants, and a documentation frame needs.
+     */
+    private _watchBreakpoint;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    /** Open the sidebar. `opener` is the control to hand the focus back to when it closes. */
+    open(opener?: HTMLElement): void;
+    close(): void;
+    toggle(opener?: HTMLElement): void;
+    private _onMediaChange;
+    /**
+     * Entering the drawer state closes the sidebar: a narrow window that opens on an
+     * overlay covering the chat is the wrong first screen. Leaving it reopens, since
+     * a wide window has room for the column — unless the host had collapsed it before.
+     */
+    private _applyDrawer;
+    /**
+     * A collapsed sidebar is invisible — folded to nothing in the flow, slid off the
+     * screen as a drawer — so it must not keep its tab stops or its place in the
+     * accessibility tree. `inert` covers focus and the pointer, `aria-hidden` covers
+     * the readers that predate it; a browser without `inert` still gets the second.
+     *
+     * It removes only what it wrote. Both are standard global attributes a host sets
+     * itself — inerting the sidebar behind its own modal is the ordinary pattern — and
+     * this runs on every breakpoint re-evaluation, so clearing them unconditionally lets
+     * an unrelated resize re-expose the page under an overlay. Same convention as
+     * `_relabel`, which leaves a host-authored `aria-label` alone.
+     *
+     * Neither is declared `@attr`, and `data-drawer` is not the precedent: a `@attr` on a
+     * STANDARD name displaces the wrappers' own prop for it — React's JSX props are
+     * `Omit<HTMLAttributes, keyof T>`, so declaring `inert` here would retype
+     * `<aparte-sidebar inert={busy}>` out of existence. The class docblock says it in prose.
+     */
+    private _syncHidden;
+    /**
+     * The drawer covers the page, so the focus has to follow it in — otherwise the next
+     * Tab walks the transcript under the overlay. The host owns the children, so this
+     * takes the first thing that can hold focus and leaves the rest alone; a drawer with
+     * nothing focusable in it keeps the focus where it was, which is the honest outcome.
+     */
+    private _focusFirst;
+    private _syncScrim;
+    private _onKeydown;
+    /** A `[data-aparte-sidebar-toggle]` anywhere toggles this sidebar — no script in the host. */
+    private _onDocumentClick;
+    private _onInput;
+    /**
+     * Hide the conversation rows whose title does not contain `query`, and the date
+     * groups left empty. Case- and accent-insensitive. An empty query shows everything.
+     */
+    filter(query: string): void;
+    private _onConfigChange;
+    private _relabel;
+}
+//# sourceMappingURL=aparte-sidebar.d.ts.map

package/dist/components/sidebar/aparte-sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aparte-sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/aparte-sidebar.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAC;CACnB;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC1C,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAC1C,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAAwB;IAE9C;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB,CAAS;IAElC,qGAAqG;IACrG,OAAO,CAAC,KAAK,CAAS;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B,oFAAoF;IACpF,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAE3B;IAED,iFAAiF;IACjF,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,iBAAiB,IAAI,IAAI;IAyBzB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAexB,oBAAoB,IAAI,IAAI;IAU5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA8B5C,0FAA0F;IAC1F,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAKhC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAOlC,OAAO,CAAC,cAAc,CAAkE;IAExF;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,UAAU,CAKhB;IAEF,8FAA8F;IAC9F,OAAO,CAAC,gBAAgB,CAUtB;IAIF,OAAO,CAAC,QAAQ,CAId;IAEF;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe3B,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,QAAQ;CAMnB"}

package/dist/components/sidebar/index.d.ts

@@ -0,0 +1,3 @@
+export { AparteSidebar } from './aparte-sidebar.js';
+export type { AparteSidebarToggleDetail } from './aparte-sidebar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sidebar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}