@aparte/core 0.3.0-alpha.0 → 0.4.0-alpha.0

package/dist/index.css

@@ -216,6 +216,10 @@
   --aparte-status-bg: transparent;
   --aparte-status-dot-size: 6px;
 
+  /* Waiting Indicator (the bubble's own dots, before the first token) */
+  --aparte-waiting-height: 1.5em;
+  --aparte-waiting-dot-gap: 4px;
+
   /* Thinking Segment */
   --aparte-thinking-border: var(--aparte-border);
   --aparte-thinking-bg: var(--aparte-surface-2);
@@ -712,8 +716,8 @@ aparte-chat-bubble {
   min-width: 0;
 }
 
-/* The message bubble — the surface fills ONLY the content (attachments +
-   segments + text). The sender name (above) and the action bar (below) are
+/* The message bubble — the surface fills ONLY the content (segments + text).
+   The sender name and attachment strip (above) and the action bar (below) are
    siblings in .aparte-body, so they stay OUTSIDE the coloured surface. */
 .aparte-message-content {
   border-radius: var(--aparte-message-content-radius, 0);
@@ -782,8 +786,11 @@ aparte-chat-bubble {
 .aparte-attachments {
   display: flex;
   flex-wrap: wrap;
-  /* Bubble attachments only ever render for user messages — anchor right. */
-  justify-content: flex-end;
+  /* The strip sits directly above the message bubble and belongs to it, so it
+     must share the bubble's edge. The user bubble hugs its text on the LEADING
+     edge (AI-chat convention, see .aparte-message-content below), so anchoring
+     the strip to the trailing edge would split one message across both sides. */
+  justify-content: flex-start;
   gap: var(--aparte-space-3, 6px);
   margin-bottom: var(--aparte-space-4, 8px);
   /* Really small tiles inside the conversation. */
@@ -1320,6 +1327,47 @@ aparte-chat-status:not([visible]) {
   align-items: center;
 }
 
+/* Screen-reader-only text. Used by the bubble's waiting indicator, whose dots are
+   decorative: the state is conveyed by aria-busy + this localized label. */
+.aparte-sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* The waiting indicator: between "user sends" and the first token. Built into the
+   bubble, so it needs no wiring and behaves the same in core and every wrapper.
+   Sits in the content region and disappears as soon as there is anything to show. */
+.aparte-waiting {
+  display: flex;
+  align-items: center;
+  min-height: var(--aparte-waiting-height, 1.5em);
+}
+
+.aparte-waiting[hidden] {
+  display: none;
+}
+
+.aparte-waiting .aparte-dots {
+  gap: var(--aparte-waiting-dot-gap, 4px);
+}
+
+/* Staggered so it reads as "working", not as three synchronized blobs. Scoped to
+   the waiting region — the status element keeps its single-dot pulse. */
+.aparte-waiting .aparte-dot:nth-child(2) {
+  animation-delay: 0.15s;
+}
+
+.aparte-waiting .aparte-dot:nth-child(3) {
+  animation-delay: 0.3s;
+}
+
 .aparte-dot {
   width: var(--aparte-status-dot-size, 6px);
   height: var(--aparte-status-dot-size, 6px);
@@ -2409,9 +2457,15 @@ aparte-option[data-active] {
     box-shadow: inset 0 0 0 2px var(--aparte-primary, #3b82f6);
 }
 
+/* Selected option: an accent TINT plus an accent bar, keeping the theme's own
+   text colour. A solid `--aparte-primary` fill with white text failed WCAG AA in
+   both themes (the brass accent is mid-luminance, so white sits around 3.4:1),
+   and an unreadable selected row is the one row that must be readable. Both
+   tokens stay overridable for a design that wants the solid fill back. */
 aparte-option[selected] {
-    background: var(--aparte-select-option-selected, var(--aparte-primary, #3b82f6));
-    color: var(--aparte-select-option-selected-text, #fff);
+    background: var(--aparte-select-option-selected, color-mix(in srgb, var(--aparte-primary, #3b82f6) 18%, transparent));
+    color: var(--aparte-select-option-selected-text, var(--aparte-select-text, var(--aparte-text, #1e293b)));
+    box-shadow: inset 2px 0 0 var(--aparte-primary, #3b82f6);
 }
 
 aparte-option[disabled] {

package/dist/index.d.ts

@@ -3,6 +3,14 @@
  * High-performance AI conversation engine in Vanilla TypeScript
  * Zero-dependency Web Components for LLM streaming
  *
+ * ⚠️ This is the **browser** entry: it defines the custom elements and imports CSS
+ * at module scope, so it needs a DOM. **Node resolves `index.node.ts` instead**
+ * (via the `node` condition in package.json) — a DOM-free entry with the client,
+ * host, transports, the chat handler and every type. This file sits first in the
+ * exports map only because of the repo-local `@aparte-workspace/source` condition,
+ * which is why reading it can look like "this package can't run in Node".
+ * See the "Node / SSR" section of the README.
+ *
  * @packageDocumentation
  */
 
@@ -36,6 +44,8 @@ export type { AparteMarkdownProvider, AparteStreamingMarkdownProvider, AparteStr
 export { DEFAULT_ICON_FALLBACKS, DEFAULT_SKELETON_FALLBACKS, DEFAULT_LOCALE, defaultSanitizer, isSafeUrl } from './config/index.js';
 export { AparteClient } from './client/aparte-client.js';
 export { applyElementProps, DEFAULT_UI_EVENTS } from './interop/element-props.js';
+export { filesToAttachments } from './utils/files-to-attachments.js';
+export { isAwaitingReply } from './utils/is-awaiting-reply.js';
 export type { AparteClientOptions, AparteToolApprovalResolver, AparteCompactionSelector } from './client/aparte-client.js';
 export { createStreamAdapter, readableToAsyncIterable } from './client/stream-adapter.js';
 export type { AparteStreamRunEvent, AparteStreamRunEmitter, StreamAdapterTarget, CreateStreamAdapterOptions, AparteStreamRunner, AparteStreamRunOptions } from './client/stream-adapter.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,5 +1,5 @@
-import { N as resolveConfig, y as getSegmentRenderer, O as runWithConfig, M as MessageRepository, H as populateBubbleFromMessage, d as AparteConfig, p as buildElicitationPanel } from "./index-CW2BCAqn.js";
-import { A, a, b, c, e, f, g, h, i, B, C, D, j, k, l, m, n, o, q, r, s, t, u, v, w, x, z, E, F, G, I, J, K, L, P } from "./index-CW2BCAqn.js";
+import { P as resolveConfig, z as getSegmentRenderer, Q as runWithConfig, M as MessageRepository, E as isAwaitingReply, J as populateBubbleFromMessage, d as AparteConfig, p as buildElicitationPanel } from "./index-BBg6dsYx.js";
+import { A, a, b, c, e, f, g, h, i, B, C, D, j, k, l, m, n, o, q, r, s, t, u, v, w, x, y, F, G, H, I, K, L, N, O, R } from "./index-BBg6dsYx.js";
 class AparteOption extends HTMLElement {
   static get observedAttributes() {
     return ["value", "disabled", "selected", "data-status"];
@@ -73,6 +73,8 @@ if (!customElements.get("aparte-option")) {
   customElements.define("aparte-option", AparteOption);
 }
 class AparteOptgroup extends HTMLElement {
+  /** Ids for the label span the group points `aria-labelledby` at. */
+  static _labelIdSeq = 0;
   static get observedAttributes() {
     return ["label", "collapsible", "collapsed", "loading"];
   }
@@ -121,10 +123,11 @@ class AparteOptgroup extends HTMLElement {
       if (!existingHeader) {
         const header = document.createElement("div");
         header.className = "aparte-optgroup-header";
-        header.setAttribute("aria-label", this.label);
         const labelSpan = document.createElement("span");
         labelSpan.className = "aparte-optgroup-label";
+        labelSpan.id = `aparte-optgroup-label-${++AparteOptgroup._labelIdSeq}`;
         labelSpan.textContent = this.label;
+        this.setAttribute("aria-labelledby", labelSpan.id);
         header.appendChild(labelSpan);
         if (this.collapsible) {
           const chevron = document.createElement("span");
@@ -179,6 +182,8 @@ if (!customElements.get("aparte-optgroup")) {
 }
 class AparteSelect extends HTMLElement {
   static _optIdSeq = 0;
+  /** Fallback ids for the listbox `aria-controls` target when the host has no id. */
+  static _listboxSeq = 0;
   _value = "";
   _isOpen = false;
   _activeIndex = -1;
@@ -271,17 +276,21 @@ class AparteSelect extends HTMLElement {
     trigger.append(labelSpan, chevronSpan);
     const dropdown = document.createElement("div");
     dropdown.className = "aparte-select-dropdown";
-    dropdown.setAttribute("role", "listbox");
     dropdown.hidden = !this._isOpen;
     if (searchable) {
       const searchInput = document.createElement("input");
       searchInput.type = "text";
       searchInput.className = "aparte-select-search";
       searchInput.placeholder = "Search...";
+      searchInput.setAttribute("aria-label", "Search options");
       dropdown.appendChild(searchInput);
     }
     const optionsContainer = document.createElement("div");
     optionsContainer.className = "aparte-select-options";
+    optionsContainer.setAttribute("role", "listbox");
+    optionsContainer.setAttribute("aria-label", trigger.getAttribute("aria-label") ?? placeholder);
+    optionsContainer.id = this.id ? `${this.id}-listbox` : `aparte-listbox-${++AparteSelect._listboxSeq}`;
+    trigger.setAttribute("aria-controls", optionsContainer.id);
     slottedChildren.forEach((child) => {
       if (child.tagName === "APARTE-OPTION" || child.tagName === "APARTE-OPTGROUP") {
         optionsContainer.appendChild(child);
@@ -589,9 +598,15 @@ if (!customElements.get("aparte-progress-spinner")) {
 }
 class AparteChat extends HTMLElement {
   static get observedAttributes() {
-    return ["placeholder", "disabled", "center-empty"];
+    return ["placeholder", "disabled", "center-empty", "attachments"];
   }
   _observer = null;
+  /**
+   * True only for the composition THIS element injected. An author-provided
+   * composer (or a `framework-managed` host) is never edited by the attachments
+   * toggle below — those own their own markup.
+   */
+  _ownsShell = false;
   connectedCallback() {
     this._render();
     this._forwardAttr("placeholder");
@@ -608,6 +623,10 @@ class AparteChat extends HTMLElement {
       this._syncEmptyWatch();
       return;
     }
+    if (name === "attachments") {
+      this._syncAttachments();
+      return;
+    }
     const composer = this.querySelector("aparte-composer");
     if (!composer) return;
     if (newValue !== null) composer.setAttribute(name, newValue);
@@ -626,17 +645,43 @@ class AparteChat extends HTMLElement {
     if (this.querySelector("aparte-chat-viewport")) return;
     const placeholder = this.getAttribute("placeholder");
     const composerAttrs = (placeholder !== null ? ` placeholder="${this._escapeAttr(placeholder)}"` : "") + (this.hasAttribute("disabled") ? " disabled" : "");
+    const attachments = this.hasAttribute("attachments");
     this.innerHTML = `
       <aparte-chat-viewport></aparte-chat-viewport>
       <aparte-composer${composerAttrs}>
         <div class="aparte-composer-shell">
+          ${attachments ? "<aparte-composer-attachments></aparte-composer-attachments>" : ""}
           <div class="aparte-composer-row">
+            ${attachments ? "<aparte-composer-add-attachment></aparte-composer-add-attachment>" : ""}
             <aparte-composer-input></aparte-composer-input>
             <aparte-composer-send></aparte-composer-send>
           </div>
         </div>
       </aparte-composer>
     `;
+    this._ownsShell = true;
+  }
+  /**
+   * Add/remove the two attachment primitives on the composition we injected, so
+   * toggling the attribute after mount works like the wrappers' reactive prop
+   * (there, a re-render does it). Author-provided markup is left alone.
+   */
+  _syncAttachments() {
+    if (!this._ownsShell) return;
+    const composer = this.composer;
+    const shell = composer?.querySelector(".aparte-composer-shell");
+    const row = shell?.querySelector(".aparte-composer-row");
+    if (!composer || !shell || !row) return;
+    const strip = shell.querySelector("aparte-composer-attachments");
+    const picker = row.querySelector("aparte-composer-add-attachment");
+    if (this.hasAttribute("attachments")) {
+      if (!strip) shell.insertBefore(document.createElement("aparte-composer-attachments"), row);
+      if (!picker) row.insertBefore(document.createElement("aparte-composer-add-attachment"), row.firstChild);
+      return;
+    }
+    strip?.remove();
+    picker?.remove();
+    composer.clearAttachments();
   }
   /** Set an attribute on the inner composer only when the shell carries it. */
   _forwardAttr(name) {
@@ -795,11 +840,13 @@ class AparteChatBubble extends HTMLElement {
   setSegments(segments) {
     this._segments = segments;
     this._renderSegments();
+    this._updateWaiting();
   }
   /** Add a segment */
   addSegment(segment) {
     this._segments.push(segment);
     this._appendSegmentEl(segment);
+    this._updateWaiting();
   }
   /** Update a specific segment */
   updateSegment(segmentId, updates) {
@@ -830,6 +877,7 @@ class AparteChatBubble extends HTMLElement {
     }
     const el = this._segmentsEl?.querySelector(`[data-segment-id="${cssEscape(segmentId)}"]`);
     el?.remove();
+    this._updateWaiting();
   }
   /** Set attachments (chips shown above message content, user role only) */
   setAttachments(attachments) {
@@ -976,6 +1024,10 @@ class AparteChatBubble extends HTMLElement {
           <div class="aparte-message-content">
             <div class="aparte-segments"></div>
             <div class="aparte-content"></div>
+            <div class="aparte-waiting" hidden>
+              <span class="aparte-dots" aria-hidden="true"><span class="aparte-dot"></span><span class="aparte-dot"></span><span class="aparte-dot"></span></span>
+              <span class="aparte-sr-only"></span>
+            </div>
           </div>
           <div class="aparte-footer">
             <div class="aparte-branch-picker" hidden>
@@ -997,6 +1049,28 @@ class AparteChatBubble extends HTMLElement {
     this._setupBranchPickerListeners();
     this._updateActionBar();
     this._renderAvatar();
+    if (this._streaming) this._updateStreaming(true);
+    this._updateWaiting();
+  }
+  /**
+   * Show the built-in waiting indicator while this bubble is in flight and has
+   * nothing to show yet — the gap between "user sends" and the first token, which
+   * used to be a bubble with a name and an empty body.
+   *
+   * The dots are CSS (no per-token work, themable, honours reduced-motion); the
+   * accessible name is `locale.typing`, next to the `aria-busy` the streaming state
+   * already sets. A custom bubble shell without the region simply has no indicator
+   * (same null-guarded degradation as the other region hooks).
+   */
+  _updateWaiting() {
+    const el = this.querySelector(".aparte-waiting");
+    if (!el) return;
+    const waiting = this._streaming && this._role !== "user" && this._segments.length === 0 && !this._content.trim();
+    el.hidden = !waiting;
+    if (!waiting) return;
+    const label = this._cfg.getLocale().typing;
+    const sr = el.querySelector(".aparte-sr-only");
+    if (sr && sr.textContent !== label) sr.textContent = label;
   }
   /**
    * Hand the avatar host element off to the registered AvatarProvider, if
@@ -1047,10 +1121,12 @@ class AparteChatBubble extends HTMLElement {
     if (!this._contentEl) return;
     if (this._segments.length > 0) {
       this._contentEl.style.display = "none";
+      this._updateWaiting();
       return;
     }
     this._contentEl.style.display = "";
     this._contentEl.innerHTML = this._cfg.renderMarkdown(this._content);
+    this._updateWaiting();
     if (!this._streaming) this._highlightContentCode();
   }
   /**
@@ -1505,6 +1581,7 @@ class AparteChatBubble extends HTMLElement {
         message.classList.remove("aparte-message-streaming");
       }
     }
+    this._updateWaiting();
     if (wasStreaming && !streaming) this._highlightContentCode();
   }
 }
@@ -1903,7 +1980,7 @@ class AparteChatViewport extends HTMLElement {
         bubble.setAttribute("role", message.role);
         if (message.timestamp) bubble.setAttribute("timestamp", String(message.timestamp));
         if (message.content) bubble.setAttribute("content", message.content);
-        if (message.status === "streaming" || message.status === "pending") {
+        if (isAwaitingReply(message)) {
           bubble.setAttribute("streaming", "");
         }
         if (this._bottomSpacer && this._bottomSpacer.parentNode === wrapper) {
@@ -1911,6 +1988,7 @@ class AparteChatViewport extends HTMLElement {
         } else {
           wrapper.appendChild(bubble);
         }
+        populateBubbleFromMessage(bubble, message);
       }
     }
     this._pruneRenderedBubbles();
@@ -1991,7 +2069,7 @@ class AparteChatViewport extends HTMLElement {
     if (currentIdx === -1) return;
     const targetIdx = direction === "prev" ? currentIdx - 1 : currentIdx + 1;
     if (targetIdx < 0 || targetIdx >= siblings.length) return;
-    this._isAutoScrollEnabled = false;
+    this._isAutoScrollEnabled = this._isAtBottom();
     this._updateScrollButton();
     this._repo.switchToBranch(siblings[targetIdx]);
     this._reRenderActivePath();
@@ -2181,11 +2259,14 @@ class AparteChatViewport extends HTMLElement {
       case "setUsage":
         bubble.setUsage?.(payload);
         break;
-      case "update":
-        if ("status" in payload || "segments" in payload) {
+      case "update": {
+        const updates = payload;
+        const renderable = ["status", "segments", "content", "attachments", "usage"];
+        if (renderable.some((key) => key in updates)) {
           bubble.updateMessage?.(payload);
         }
         break;
+      }
       case "complete":
         bubble.updateMessage?.(payload);
         break;
@@ -2222,7 +2303,7 @@ class AparteChatViewport extends HTMLElement {
       bubble.setAttribute("message-id", message.id);
       bubble.setAttribute("role", message.role);
       if (message.timestamp) bubble.setAttribute("timestamp", String(message.timestamp));
-      if (message.status === "streaming" || message.status === "pending") {
+      if (isAwaitingReply(message)) {
         bubble.setAttribute("streaming", "");
       }
       wrapper.appendChild(bubble);
@@ -2230,7 +2311,6 @@ class AparteChatViewport extends HTMLElement {
     }
     this._dispatchPathChanged(activeMessages, siblingsInfo);
     this._recalculateSpacer();
-    requestAnimationFrame(() => this._handleScroll());
   }
   _dispatchPathChanged(messages, siblings) {
     const detail = { messages, siblings };
@@ -2400,11 +2480,15 @@ class AparteChatViewport extends HTMLElement {
       });
     }
   }
+  /** Is the scroll surface within `_scrollThreshold` of its bottom, right now? */
+  _isAtBottom() {
+    if (!this._container) return true;
+    const { scrollTop, scrollHeight, clientHeight } = this._container;
+    return scrollHeight - scrollTop - clientHeight <= this._scrollThreshold;
+  }
   _handleScroll() {
     if (!this._container) return;
-    const { scrollTop, scrollHeight, clientHeight } = this._container;
-    const distanceFromBottom = scrollHeight - scrollTop - clientHeight;
-    this._isAutoScrollEnabled = distanceFromBottom <= this._scrollThreshold;
+    this._isAutoScrollEnabled = this._isAtBottom();
     this._updateScrollButton();
   }
   _scrollToBottom() {
@@ -2423,11 +2507,20 @@ class AparteChatViewport extends HTMLElement {
     return typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
   }
   /**
-   * Show/hide the scroll-to-bottom button based on the current auto-scroll state.
-   * Hidden when already at bottom (_isAutoScrollEnabled = true).
+   * Show/hide the scroll-to-bottom button from the **current geometry**, not from
+   * `_isAutoScrollEnabled`.
+   *
+   * The two answer different questions: the flag is intent ("should new content
+   * pull the view down"), the button is a fact ("is there anything below the
+   * fold"). Mirroring the flag made the button lie whenever the two diverged —
+   * `navigateBranch` deliberately disarms auto-follow, so swapping a branch while
+   * already at the bottom of a scrollable transcript left the button offering to
+   * scroll nowhere (reported from bonaparte, React). Re-derived on scroll, on the
+   * post-mutation frame and after a path swap, so it converges to the truth
+   * whatever a framework's render timing does in between.
    */
   _updateScrollButton() {
-    this._scrollBtn?.classList.toggle("aparte-scroll-btn--hidden", this._isAutoScrollEnabled);
+    this._scrollBtn?.classList.toggle("aparte-scroll-btn--hidden", this._isAtBottom());
   }
   /**
    * Recalculate the bottom spacer height so the last user message is always
@@ -2486,6 +2579,7 @@ class AparteChatViewport extends HTMLElement {
     this._spacerRafId = requestAnimationFrame(() => {
       this._spacerRafId = null;
       this._recalculateSpacer();
+      this._updateScrollButton();
     });
   }
   /**
@@ -3746,19 +3840,21 @@ export {
   v as defaultSanitizer,
   w as deriveArtifactKind,
   x as detachConfig,
+  y as filesToAttachments,
   getSegmentRenderer,
-  z as isFormatAdapter,
-  E as isSafeUrl,
-  F as parseAparteEventStream,
-  G as parseMarkdownToSegments,
+  isAwaitingReply,
+  F as isFormatAdapter,
+  G as isSafeUrl,
+  H as parseAparteEventStream,
+  I as parseMarkdownToSegments,
   populateBubbleFromMessage,
-  I as readableToAsyncIterable,
+  K as readableToAsyncIterable,
   registerAllComponents,
-  J as registerDefaultRenderers,
-  K as registerSegmentRenderer,
-  L as requestUserInput,
+  L as registerDefaultRenderers,
+  N as registerSegmentRenderer,
+  O as requestUserInput,
   resolveConfig,
   runWithConfig,
-  P as unregisterSegmentRenderer
+  R as unregisterSegmentRenderer
 };
 //# sourceMappingURL=index.js.map