@design.estate/dees-catalog 6.8.1 → 6.9.0

package/dist_bundle/bundle.js

@@ -179350,6 +179350,10 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
     __publicField(this, "lastVirtualViewportWidth", 0);
     __publicField(this, "pendingVirtualAnchor");
     __publicField(this, "pendingFullAnchor");
+    __publicField(this, "activeFullAnchor");
+    __publicField(this, "fullAnchorRestoreGeneration", 0);
+    __publicField(this, "fullAnchorRestoreFrame", null);
+    __publicField(this, "fullAnchorRestoreSecondFrame", null);
     __publicField(this, "measurementAnchor");
     __publicField(this, "pendingVirtualRepin", false);
     __publicField(this, "virtualizationEnabled", false);
@@ -179383,9 +179387,18 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
       if (event.composedPath().some(
         (candidate) => candidate instanceof _DeesHarnessMessageList && candidate !== this
       )) return;
-      if (event.type === "wheel" && event.deltaY >= 0) return;
-      if (event.type === "keydown" && !["ArrowUp", "PageUp", "Home"].includes(event.key)) return;
+      if (event.type === "wheel") {
+        this.cancelFullAnchorRestore();
+        if (event.deltaY >= 0) return;
+      }
+      if (event.type === "keydown" && !["ArrowUp", "PageUp", "Home"].includes(event.key)) {
+        if (["ArrowDown", "PageDown", "End", " "].includes(event.key)) {
+          this.cancelFullAnchorRestore();
+        }
+        return;
+      }
       if (event.type === "pointerdown" && event.target !== this.scrollContainer) return;
+      this.cancelFullAnchorRestore();
       this.userUnpinned = true;
       this.measurementAnchor = void 0;
     }, "handleUserScrollIntent"));
@@ -179555,16 +179568,15 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
   rebuildTimeline() {
     const container = this.scrollContainer;
     const preserveAnchor = this.userUnpinned || !this.autoFollow;
-    const anchor = container && preserveAnchor ? this.captureCurrentAnchor(container) : void 0;
+    const anchor = container && preserveAnchor ? this.activeFullAnchor ?? this.captureCurrentAnchor(container) : void 0;
+    const anchorContentBoundaryKey = anchor ? this.lastContentKeyForTimelineItem(anchor.key) : void 0;
+    this.cancelFullAnchorRestore();
     const nextItems = this.buildTimelineRenderItems();
     const retainedKeys = new Set(nextItems.map((item) => item.key));
-    const contentKeys = [
-      ...this.messages.map((message2) => `message:${message2.id}`),
-      ...this.permissions.map((request) => `permission:${request.id}`),
-      ...this.questions.map((request) => `question:${request.id}`)
-    ];
+    const contentKeys = nextItems.flatMap((item) => this.contentKeysForTimelineItem(item));
+    const anchorContentBoundaryIndex = anchorContentBoundaryKey ? contentKeys.indexOf(anchorContentBoundaryKey) : -1;
     this.currentNewContentKeys = new Set(
-      contentKeys.filter((key2) => !this.knownContentKeys.has(key2))
+      contentKeys.filter((key2, index3) => !this.knownContentKeys.has(key2) && (anchorContentBoundaryIndex < 0 || index3 > anchorContentBoundaryIndex))
     );
     this.knownContentKeys.clear();
     for (const key2 of contentKeys) this.knownContentKeys.add(key2);
@@ -179641,6 +179653,14 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
       this.setInitialVirtualRange();
     }
   }
+  contentKeysForTimelineItem(itemArg) {
+    return itemArg.kind === "tool-group" ? itemArg.messages.map((item) => item.key) : [itemArg.key];
+  }
+  lastContentKeyForTimelineItem(keyArg) {
+    const item = this.timelineRenderItems.find((candidate) => candidate.key === keyArg);
+    if (!item) return void 0;
+    return item.kind === "tool-group" ? item.messages.at(-1)?.key : item.key;
+  }
   pruneViewState(stateArg, messageIdsArg, permissionIdsArg, questionIdsArg) {
     const messageIds = new Set(messageIdsArg);
     const permissionIds = new Set(permissionIdsArg);
@@ -179998,6 +180018,7 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
     const container = this.scrollContainer;
     if (!container) return;
     if (force) {
+      this.cancelFullAnchorRestore();
       this.userUnpinned = false;
       this.measurementAnchor = void 0;
     }
@@ -180072,7 +180093,7 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
     } else {
       this.disconnectVirtualObservers();
       if (this.pendingFullAnchor) {
-        this.restoreFullAnchor(this.scrollContainer, this.pendingFullAnchor);
+        this.scheduleFullAnchorRestore(this.scrollContainer, this.pendingFullAnchor);
         this.pendingFullAnchor = void 0;
       }
     }
@@ -180220,6 +180241,37 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
     if (!element4) return;
     containerArg.scrollTop += element4.getBoundingClientRect().top - containerArg.getBoundingClientRect().top + anchorArg.offset;
   }
+  scheduleFullAnchorRestore(containerArg, anchorArg) {
+    this.cancelFullAnchorRestore();
+    const generation = this.fullAnchorRestoreGeneration;
+    this.activeFullAnchor = anchorArg;
+    const restore = /* @__PURE__ */ __name(() => {
+      if (generation !== this.fullAnchorRestoreGeneration || !this.isConnected || this.scrollContainer !== containerArg) return false;
+      this.restoreFullAnchor(containerArg, anchorArg);
+      return true;
+    }, "restore");
+    restore();
+    queueMicrotask(() => {
+      if (!restore()) return;
+      this.fullAnchorRestoreFrame = requestAnimationFrame(() => {
+        this.fullAnchorRestoreFrame = null;
+        if (!restore()) return;
+        this.fullAnchorRestoreSecondFrame = requestAnimationFrame(() => {
+          this.fullAnchorRestoreSecondFrame = null;
+          if (!restore()) return;
+          this.activeFullAnchor = void 0;
+        });
+      });
+    });
+  }
+  cancelFullAnchorRestore() {
+    this.fullAnchorRestoreGeneration += 1;
+    if (this.fullAnchorRestoreFrame !== null) cancelAnimationFrame(this.fullAnchorRestoreFrame);
+    if (this.fullAnchorRestoreSecondFrame !== null) cancelAnimationFrame(this.fullAnchorRestoreSecondFrame);
+    this.fullAnchorRestoreFrame = null;
+    this.fullAnchorRestoreSecondFrame = null;
+    this.activeFullAnchor = void 0;
+  }
   virtualLocalScrollTop(containerArg) {
     const stack = this.shadowRoot?.querySelector(".virtualStack");
     return Math.max(0, containerArg.scrollTop - (stack?.offsetTop ?? 0));
@@ -180425,6 +180477,7 @@ var _DeesHarnessMessageList = class _DeesHarnessMessageList extends (_a86 = Dees
   }
   async disconnectedCallback() {
     this.disconnectSelectionChangeListener();
+    this.cancelFullAnchorRestore();
     if (this.followFrame !== null) cancelAnimationFrame(this.followFrame);
     if (this.followSecondFrame !== null) cancelAnimationFrame(this.followSecondFrame);
     if (this.entryFrame !== null) cancelAnimationFrame(this.entryFrame);
@@ -180758,11 +180811,12 @@ var demoFunc62 = /* @__PURE__ */ __name(() => b2`
 init_dist_ts26();
 init_theme();
 init_dees_icon();
-var _showModelControls_dec, _modeOptions_dec, _mode_dec2, _effortOptions_dec, _reasoningEffort_dec, _modelOptions_dec, _model_dec, _accountOptions_dec, _account_dec, _maxAttachmentCount_dec, _maxTotalAttachmentBytes_dec, _maxAttachmentBytes_dec, _attachments_dec, _queuedCount_dec, _busy_dec3, _disabled_dec5, _docked_dec, _placeholder_dec6, _value_dec17, _a87, _DeesHarnessComposer_decorators, _init88, _value17, _placeholder6, _docked, _disabled5, _busy3, _queuedCount, _attachments, _maxAttachmentBytes, _maxTotalAttachmentBytes, _maxAttachmentCount, _account, _accountOptions, _model, _modelOptions, _reasoningEffort, _effortOptions, _mode2, _modeOptions, _showModelControls;
+var _showModelControls_dec, _modeOptions_dec, _mode_dec2, _effortOptions_dec, _reasoningEffort_dec, _modelOptions_dec, _model_dec, _accountOptions_dec, _account_dec, _maxAttachmentCount_dec, _maxTotalAttachmentBytes_dec, _maxAttachmentBytes_dec, _promptFocused_dec, _suggestionsDismissed_dec, _activeSuggestionIndex_dec, _suggestions_dec2, _attachments_dec, _queuedCount_dec, _busy_dec3, _disabled_dec5, _docked_dec, _placeholder_dec6, _value_dec17, _a87, _DeesHarnessComposer_decorators, _init88, _value17, _placeholder6, _docked, _disabled5, _busy3, _queuedCount, _attachments, _suggestions2, _activeSuggestionIndex, _suggestionsDismissed, _promptFocused, _maxAttachmentBytes, _maxTotalAttachmentBytes, _maxAttachmentCount, _account, _accountOptions, _model, _modelOptions, _reasoningEffort, _effortOptions, _mode2, _modeOptions, _showModelControls;
 var toDropdownOptions = /* @__PURE__ */ __name((values) => values.map((value2) => ({ option: value2, key: value2 })), "toDropdownOptions");
 var toLabeledDropdownOptions = /* @__PURE__ */ __name((values) => values.map((value2) => ({ option: value2.label, key: value2.value })), "toLabeledDropdownOptions");
+var nextSuggestionListId = 0;
 _DeesHarnessComposer_decorators = [customElement("dees-harness-composer")];
-var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElement, _value_dec17 = [n5()], _placeholder_dec6 = [n5()], _docked_dec = [n5({ type: Boolean, reflect: true })], _disabled_dec5 = [n5({ type: Boolean })], _busy_dec3 = [n5({ type: Boolean })], _queuedCount_dec = [n5({ type: Number })], _attachments_dec = [n5({ attribute: false })], _maxAttachmentBytes_dec = [n5({ type: Number })], _maxTotalAttachmentBytes_dec = [n5({ type: Number })], _maxAttachmentCount_dec = [n5({ type: Number })], _account_dec = [n5()], _accountOptions_dec = [n5({ attribute: false })], _model_dec = [n5()], _modelOptions_dec = [n5({ attribute: false })], _reasoningEffort_dec = [n5()], _effortOptions_dec = [n5({ attribute: false })], _mode_dec2 = [n5()], _modeOptions_dec = [n5({ attribute: false })], _showModelControls_dec = [n5({ type: Boolean })], _a87) {
+var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElement, _value_dec17 = [n5()], _placeholder_dec6 = [n5()], _docked_dec = [n5({ type: Boolean, reflect: true })], _disabled_dec5 = [n5({ type: Boolean })], _busy_dec3 = [n5({ type: Boolean })], _queuedCount_dec = [n5({ type: Number })], _attachments_dec = [n5({ attribute: false })], _suggestions_dec2 = [n5({ attribute: false })], _activeSuggestionIndex_dec = [r5()], _suggestionsDismissed_dec = [r5()], _promptFocused_dec = [r5()], _maxAttachmentBytes_dec = [n5({ type: Number })], _maxTotalAttachmentBytes_dec = [n5({ type: Number })], _maxAttachmentCount_dec = [n5({ type: Number })], _account_dec = [n5()], _accountOptions_dec = [n5({ attribute: false })], _model_dec = [n5()], _modelOptions_dec = [n5({ attribute: false })], _reasoningEffort_dec = [n5()], _effortOptions_dec = [n5({ attribute: false })], _mode_dec2 = [n5()], _modeOptions_dec = [n5({ attribute: false })], _showModelControls_dec = [n5({ type: Boolean })], _a87) {
   constructor() {
     super(...arguments);
     __privateAdd(this, _value17, __runInitializers(_init88, 8, this, "")), __runInitializers(_init88, 11, this);
@@ -180772,30 +180826,62 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
     __privateAdd(this, _busy3, __runInitializers(_init88, 24, this, false)), __runInitializers(_init88, 27, this);
     __privateAdd(this, _queuedCount, __runInitializers(_init88, 28, this, 0)), __runInitializers(_init88, 31, this);
     __privateAdd(this, _attachments, __runInitializers(_init88, 32, this, [])), __runInitializers(_init88, 35, this);
-    __privateAdd(this, _maxAttachmentBytes, __runInitializers(_init88, 36, this, harnessMaxAttachmentBytes)), __runInitializers(_init88, 39, this);
-    __privateAdd(this, _maxTotalAttachmentBytes, __runInitializers(_init88, 40, this, harnessMaxTotalAttachmentBytes)), __runInitializers(_init88, 43, this);
-    __privateAdd(this, _maxAttachmentCount, __runInitializers(_init88, 44, this, Number.POSITIVE_INFINITY)), __runInitializers(_init88, 47, this);
-    __privateAdd(this, _account, __runInitializers(_init88, 48, this, "")), __runInitializers(_init88, 51, this);
-    __privateAdd(this, _accountOptions, __runInitializers(_init88, 52, this, [])), __runInitializers(_init88, 55, this);
-    __privateAdd(this, _model, __runInitializers(_init88, 56, this, "")), __runInitializers(_init88, 59, this);
-    __privateAdd(this, _modelOptions, __runInitializers(_init88, 60, this, [])), __runInitializers(_init88, 63, this);
-    __privateAdd(this, _reasoningEffort, __runInitializers(_init88, 64, this, "")), __runInitializers(_init88, 67, this);
-    __privateAdd(this, _effortOptions, __runInitializers(_init88, 68, this, [])), __runInitializers(_init88, 71, this);
-    __privateAdd(this, _mode2, __runInitializers(_init88, 72, this, "")), __runInitializers(_init88, 75, this);
-    __privateAdd(this, _modeOptions, __runInitializers(_init88, 76, this, [])), __runInitializers(_init88, 79, this);
-    __privateAdd(this, _showModelControls, __runInitializers(_init88, 80, this, true)), __runInitializers(_init88, 83, this);
+    __privateAdd(this, _suggestions2, __runInitializers(_init88, 36, this, [])), __runInitializers(_init88, 39, this);
+    __privateAdd(this, _activeSuggestionIndex, __runInitializers(_init88, 40, this, -1)), __runInitializers(_init88, 43, this);
+    __privateAdd(this, _suggestionsDismissed, __runInitializers(_init88, 44, this, false)), __runInitializers(_init88, 47, this);
+    __privateAdd(this, _promptFocused, __runInitializers(_init88, 48, this, false)), __runInitializers(_init88, 51, this);
+    __publicField(this, "composing", false);
+    __publicField(this, "suggestionListId", `dees-harness-composer-suggestions-${++nextSuggestionListId}`);
+    __privateAdd(this, _maxAttachmentBytes, __runInitializers(_init88, 52, this, harnessMaxAttachmentBytes)), __runInitializers(_init88, 55, this);
+    __privateAdd(this, _maxTotalAttachmentBytes, __runInitializers(_init88, 56, this, harnessMaxTotalAttachmentBytes)), __runInitializers(_init88, 59, this);
+    __privateAdd(this, _maxAttachmentCount, __runInitializers(_init88, 60, this, Number.POSITIVE_INFINITY)), __runInitializers(_init88, 63, this);
+    __privateAdd(this, _account, __runInitializers(_init88, 64, this, "")), __runInitializers(_init88, 67, this);
+    __privateAdd(this, _accountOptions, __runInitializers(_init88, 68, this, [])), __runInitializers(_init88, 71, this);
+    __privateAdd(this, _model, __runInitializers(_init88, 72, this, "")), __runInitializers(_init88, 75, this);
+    __privateAdd(this, _modelOptions, __runInitializers(_init88, 76, this, [])), __runInitializers(_init88, 79, this);
+    __privateAdd(this, _reasoningEffort, __runInitializers(_init88, 80, this, "")), __runInitializers(_init88, 83, this);
+    __privateAdd(this, _effortOptions, __runInitializers(_init88, 84, this, [])), __runInitializers(_init88, 87, this);
+    __privateAdd(this, _mode2, __runInitializers(_init88, 88, this, "")), __runInitializers(_init88, 91, this);
+    __privateAdd(this, _modeOptions, __runInitializers(_init88, 92, this, [])), __runInitializers(_init88, 95, this);
+    __privateAdd(this, _showModelControls, __runInitializers(_init88, 96, this, true)), __runInitializers(_init88, 99, this);
     // ------------------------------------------------------------------ input
     __publicField(this, "handleTextInput", /* @__PURE__ */ __name((event) => {
       this.value = event.currentTarget.value;
+      this.resetSuggestionInteraction();
       this.emitInput(this.value);
       this.autogrow();
     }, "handleTextInput"));
     __publicField(this, "handleKeydown", /* @__PURE__ */ __name((event) => {
+      if (event.isComposing || this.composing) return;
       if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) {
         event.preventDefault();
         this.send();
         return;
       }
+      if (this.suggestionsVisible) {
+        if (event.key === "Escape") {
+          event.preventDefault();
+          this.suggestionsDismissed = true;
+          return;
+        }
+        if (!event.altKey && !event.ctrlKey && !event.metaKey && !event.shiftKey) {
+          if (event.key === "ArrowDown") {
+            event.preventDefault();
+            this.moveActiveSuggestion(1);
+            return;
+          }
+          if (event.key === "ArrowUp") {
+            event.preventDefault();
+            this.moveActiveSuggestion(-1);
+            return;
+          }
+          if (event.key === "Enter") {
+            event.preventDefault();
+            void this.selectSuggestion(this.activeSuggestionIndex);
+            return;
+          }
+        }
+      }
       if (event.key === "Tab" && event.shiftKey && this.modeOptions.length) {
         event.preventDefault();
         const currentIndex = this.modeOptions.indexOf(this.mode);
@@ -180804,6 +180890,21 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
         this.emit("harness-mode-change", { mode: nextMode });
       }
     }, "handleKeydown"));
+    __publicField(this, "handleCompositionStart", /* @__PURE__ */ __name(() => {
+      this.composing = true;
+    }, "handleCompositionStart"));
+    __publicField(this, "handleCompositionEnd", /* @__PURE__ */ __name(() => {
+      this.composing = false;
+    }, "handleCompositionEnd"));
+    __publicField(this, "handlePromptFocus", /* @__PURE__ */ __name(() => {
+      this.promptFocused = true;
+    }, "handlePromptFocus"));
+    __publicField(this, "handlePromptBlur", /* @__PURE__ */ __name(() => {
+      this.promptFocused = false;
+    }, "handlePromptBlur"));
+    __publicField(this, "handleSuggestionPointerDown", /* @__PURE__ */ __name((event) => {
+      event.preventDefault();
+    }, "handleSuggestionPointerDown"));
     // ------------------------------------------------------------ attachments
     __publicField(this, "handleFileInputChange", /* @__PURE__ */ __name((event) => {
       const input = event.currentTarget;
@@ -180839,17 +180940,28 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
   }
   clear() {
     this.value = "";
+    this.resetSuggestionInteraction();
     this.emitInput("");
     this.autogrow();
   }
+  willUpdate(changedProperties) {
+    super.willUpdate(changedProperties);
+    if (changedProperties.has("suggestions")) this.resetSuggestionInteraction();
+  }
+  updated(changedProperties) {
+    super.updated(changedProperties);
+    this.syncTextareaSuggestionAria();
+  }
   render() {
     return b2`
-      <div
-        class="composer"
-        @dragover=${this.handleDragOver}
-        @dragleave=${this.handleDragLeave}
-        @drop=${this.handleDrop}
-      >
+      <div class="composerShell">
+        ${this.suggestionsVisible ? this.renderSuggestions() : ""}
+        <div
+          class="composer"
+          @dragover=${this.handleDragOver}
+          @dragleave=${this.handleDragLeave}
+          @drop=${this.handleDrop}
+        >
         <input
           class="fileInput"
           type="file"
@@ -180863,11 +180975,16 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
             ` : ""}
         <textarea
           .value=${this.value}
+          aria-label="Message"
           placeholder=${this.placeholder}
           ?disabled=${this.disabled}
           rows="1"
           @input=${this.handleTextInput}
           @keydown=${this.handleKeydown}
+          @focus=${this.handlePromptFocus}
+          @blur=${this.handlePromptBlur}
+          @compositionstart=${this.handleCompositionStart}
+          @compositionend=${this.handleCompositionEnd}
           @paste=${this.handlePaste}
         ></textarea>
         <div class="controlsRow">
@@ -180957,10 +181074,38 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
                   Send
                 </dees-button>
               `}
+          </div>
         </div>
       </div>
     `;
   }
+  renderSuggestions() {
+    return b2`
+      <ul
+        id=${this.suggestionListId}
+        class="suggestionList"
+        role="listbox"
+        aria-label="Suggestions"
+        @pointerdown=${this.handleSuggestionPointerDown}
+      >
+        ${this.suggestions.map((suggestion, index3) => b2`
+          <li
+            id=${this.suggestionOptionId(index3)}
+            class=${`suggestionOption ${index3 === this.activeSuggestionIndex ? "active" : ""}`}
+            role="option"
+            aria-selected=${String(index3 === this.activeSuggestionIndex)}
+            @pointerenter=${() => {
+      this.activeSuggestionIndex = index3;
+    }}
+            @click=${() => void this.selectSuggestion(index3)}
+          >
+            <span class="suggestionLabel">${suggestion.label}</span>
+            ${suggestion.description ? b2`<span class="suggestionDescription">${suggestion.description}</span>` : ""}
+          </li>
+        `)}
+      </ul>
+    `;
+  }
   renderChip(attachment) {
     const imageUrl = attachment.kind === "image" && attachment.dataBase64 ? `data:${attachment.mediaType};base64,${attachment.dataBase64}` : "";
     return b2`
@@ -180981,6 +181126,75 @@ var _DeesHarnessComposer = class _DeesHarnessComposer extends (_a87 = DeesElemen
       </span>
     `;
   }
+  resetSuggestionInteraction() {
+    this.activeSuggestionIndex = this.suggestions.length ? 0 : -1;
+    this.suggestionsDismissed = false;
+  }
+  get suggestionsVisible() {
+    return this.promptFocused && !this.disabled && !this.suggestionsDismissed && this.suggestions.length > 0;
+  }
+  suggestionOptionId(indexArg) {
+    return `${this.suggestionListId}-option-${indexArg}`;
+  }
+  syncTextareaSuggestionAria() {
+    const textarea = this.shadowRoot?.querySelector("textarea");
+    if (!textarea) return;
+    const suggestionsAvailable = !this.disabled && this.suggestions.length > 0;
+    if (suggestionsAvailable) {
+      textarea.setAttribute("aria-autocomplete", "list");
+      textarea.setAttribute("aria-haspopup", "listbox");
+    } else {
+      textarea.removeAttribute("aria-autocomplete");
+      textarea.removeAttribute("aria-haspopup");
+    }
+    if (this.suggestionsVisible) {
+      textarea.setAttribute("aria-controls", this.suggestionListId);
+    } else {
+      textarea.removeAttribute("aria-controls");
+    }
+    if (this.suggestionsVisible && this.activeSuggestionIndex >= 0 && this.activeSuggestionIndex < this.suggestions.length) {
+      textarea.setAttribute(
+        "aria-activedescendant",
+        this.suggestionOptionId(this.activeSuggestionIndex)
+      );
+    } else {
+      textarea.removeAttribute("aria-activedescendant");
+    }
+  }
+  moveActiveSuggestion(offsetArg) {
+    if (!this.suggestions.length) return;
+    this.activeSuggestionIndex = this.activeSuggestionIndex < 0 ? offsetArg === 1 ? 0 : this.suggestions.length - 1 : (this.activeSuggestionIndex + offsetArg + this.suggestions.length) % this.suggestions.length;
+    void this.scrollActiveSuggestionIntoView();
+  }
+  async scrollActiveSuggestionIntoView() {
+    await this.updateComplete;
+    const list5 = this.shadowRoot?.getElementById(this.suggestionListId);
+    const option2 = this.shadowRoot?.getElementById(
+      this.suggestionOptionId(this.activeSuggestionIndex)
+    );
+    if (!list5 || !option2) return;
+    const optionTop = option2.offsetTop;
+    const optionBottom = optionTop + option2.offsetHeight;
+    if (optionTop < list5.scrollTop) {
+      list5.scrollTop = optionTop;
+    } else if (optionBottom > list5.scrollTop + list5.clientHeight) {
+      list5.scrollTop = optionBottom - list5.clientHeight;
+    }
+  }
+  async selectSuggestion(indexArg) {
+    if (this.disabled) return;
+    const suggestion = this.suggestions[indexArg];
+    if (!suggestion) return;
+    this.value = suggestion.value;
+    this.suggestionsDismissed = true;
+    this.emitInput(this.value);
+    await this.updateComplete;
+    const textarea = this.shadowRoot?.querySelector("textarea");
+    if (!textarea) return;
+    textarea.focus();
+    textarea.setSelectionRange(this.value.length, this.value.length);
+    this.autogrow();
+  }
   autogrow() {
     const textarea = this.shadowRoot?.querySelector("textarea");
     if (!textarea) return;
@@ -181073,6 +181287,10 @@ _disabled5 = new WeakMap();
 _busy3 = new WeakMap();
 _queuedCount = new WeakMap();
 _attachments = new WeakMap();
+_suggestions2 = new WeakMap();
+_activeSuggestionIndex = new WeakMap();
+_suggestionsDismissed = new WeakMap();
+_promptFocused = new WeakMap();
 _maxAttachmentBytes = new WeakMap();
 _maxTotalAttachmentBytes = new WeakMap();
 _maxAttachmentCount = new WeakMap();
@@ -181092,6 +181310,10 @@ __decorateElement(_init88, 4, "disabled", _disabled_dec5, _DeesHarnessComposer,
 __decorateElement(_init88, 4, "busy", _busy_dec3, _DeesHarnessComposer, _busy3);
 __decorateElement(_init88, 4, "queuedCount", _queuedCount_dec, _DeesHarnessComposer, _queuedCount);
 __decorateElement(_init88, 4, "attachments", _attachments_dec, _DeesHarnessComposer, _attachments);
+__decorateElement(_init88, 4, "suggestions", _suggestions_dec2, _DeesHarnessComposer, _suggestions2);
+__decorateElement(_init88, 4, "activeSuggestionIndex", _activeSuggestionIndex_dec, _DeesHarnessComposer, _activeSuggestionIndex);
+__decorateElement(_init88, 4, "suggestionsDismissed", _suggestionsDismissed_dec, _DeesHarnessComposer, _suggestionsDismissed);
+__decorateElement(_init88, 4, "promptFocused", _promptFocused_dec, _DeesHarnessComposer, _promptFocused);
 __decorateElement(_init88, 4, "maxAttachmentBytes", _maxAttachmentBytes_dec, _DeesHarnessComposer, _maxAttachmentBytes);
 __decorateElement(_init88, 4, "maxTotalAttachmentBytes", _maxTotalAttachmentBytes_dec, _DeesHarnessComposer, _maxTotalAttachmentBytes);
 __decorateElement(_init88, 4, "maxAttachmentCount", _maxAttachmentCount_dec, _DeesHarnessComposer, _maxAttachmentCount);
@@ -181118,6 +181340,69 @@ __publicField(_DeesHarnessComposer, "styles", [
         container-type: inline-size;
       }
 
+      .composerShell {
+        position: relative;
+        min-width: 0;
+      }
+
+      .suggestionList {
+        position: absolute;
+        z-index: 2;
+        inset-inline: 0;
+        bottom: calc(100% + var(--dees-spacing-xs));
+        box-sizing: border-box;
+        max-height: min(240px, 35dvh);
+        margin: 0;
+        padding: var(--dees-spacing-xs);
+        overflow-x: hidden;
+        overflow-y: auto;
+        overscroll-behavior: contain;
+        list-style: none;
+        border: 1px solid var(--dees-color-border-subtle);
+        border-radius: var(--dees-radius-xl);
+        corner-shape: var(--dees-corner-shape);
+        background: var(--dees-color-bg-primary);
+        box-shadow: var(--dees-shadow-up-sm);
+      }
+
+      .suggestionOption {
+        display: grid;
+        align-content: center;
+        box-sizing: border-box;
+        min-width: 0;
+        min-height: 44px;
+        padding: var(--dees-spacing-xs) var(--dees-spacing-sm);
+        border-radius: var(--dees-radius-lg);
+        corner-shape: var(--dees-corner-shape);
+        color: var(--dees-color-text-primary);
+        cursor: pointer;
+        touch-action: manipulation;
+      }
+
+      .suggestionOption:hover,
+      .suggestionOption.active {
+        background: var(--dees-color-fill-secondary);
+      }
+
+      .suggestionLabel {
+        min-width: 0;
+        overflow: hidden;
+        font-size: var(--dees-font-control-size, 13px);
+        font-weight: 600;
+        line-height: 1.35;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+
+      .suggestionDescription {
+        min-width: 0;
+        margin-top: 2px;
+        color: var(--dees-color-text-secondary);
+        font-size: var(--dees-font-caption1-size, 11px);
+        line-height: 1.35;
+        overflow-wrap: anywhere;
+      }
+
       .composer {
         display: grid;
         gap: var(--dees-spacing-sm);
@@ -182412,9 +182697,9 @@ var DeesHarnessUsage = _DeesHarnessUsage;
 init_dist_ts26();
 init_theme();
 init_dees_icon();
-var _toolRegistry_dec6, _modeOptions_dec2, _mode_dec3, _effortOptions_dec2, _reasoningEffort_dec2, _modelOptions_dec2, _model_dec2, _accountOptions_dec2, _account_dec2, _maxTotalAttachmentBytes_dec2, _maxAttachmentBytes_dec2, _maxAttachmentCount_dec2, _attachments_dec2, _composerValue_dec, _queuedCount_dec2, _busy_dec4, _disabled_dec7, _showTimestamps_dec2, _showRoles_dec2, _showToolbar_dec, _subheading_dec, _heading_dec6, _narrowSessionLayout_dec, _desktopSessionSidebarVisible_dec, _sessionSidebarOpen_dec, _intelligenceError_dec2, _intelligenceBusy_dec2, _intelligenceExchanges_dec2, _sessionIntelligenceEnabled_dec, _scratchpadError_dec2, _scratchpadBusy_dec2, _scratchpad_dec2, _sessionMetrics_dec, _showSessionSidebar_dec, _showTodosPanel_dec, _todos_dec3, _usage_dec2, _status_dec6, _questions_dec2, _permissions_dec2, _messages_dec2, _a90, _DeesHarnessChat_decorators, _init91, _messages2, _permissions2, _questions2, _status6, _usage2, _todos3, _showTodosPanel, _showSessionSidebar, _sessionMetrics, _scratchpad2, _scratchpadBusy2, _scratchpadError2, _sessionIntelligenceEnabled, _intelligenceExchanges2, _intelligenceBusy2, _intelligenceError2, _sessionSidebarOpen, _desktopSessionSidebarVisible, _narrowSessionLayout, _heading6, _subheading, _showToolbar, _showRoles2, _showTimestamps2, _disabled7, _busy4, _queuedCount2, _composerValue, _attachments2, _maxAttachmentCount2, _maxAttachmentBytes2, _maxTotalAttachmentBytes2, _account2, _accountOptions2, _model2, _modelOptions2, _reasoningEffort2, _effortOptions2, _mode3, _modeOptions2, _toolRegistry6;
+var _toolRegistry_dec6, _modeOptions_dec2, _mode_dec3, _effortOptions_dec2, _reasoningEffort_dec2, _modelOptions_dec2, _model_dec2, _accountOptions_dec2, _account_dec2, _maxTotalAttachmentBytes_dec2, _maxAttachmentBytes_dec2, _maxAttachmentCount_dec2, _suggestions_dec3, _attachments_dec2, _composerValue_dec, _queuedCount_dec2, _busy_dec4, _disabled_dec7, _showTimestamps_dec2, _showRoles_dec2, _showToolbar_dec, _subheading_dec, _heading_dec6, _narrowSessionLayout_dec, _desktopSessionSidebarVisible_dec, _sessionSidebarOpen_dec, _intelligenceError_dec2, _intelligenceBusy_dec2, _intelligenceExchanges_dec2, _sessionIntelligenceEnabled_dec, _scratchpadError_dec2, _scratchpadBusy_dec2, _scratchpad_dec2, _sessionMetrics_dec, _showSessionSidebar_dec, _showTodosPanel_dec, _todos_dec3, _usage_dec2, _status_dec6, _questions_dec2, _permissions_dec2, _messages_dec2, _a90, _DeesHarnessChat_decorators, _init91, _messages2, _permissions2, _questions2, _status6, _usage2, _todos3, _showTodosPanel, _showSessionSidebar, _sessionMetrics, _scratchpad2, _scratchpadBusy2, _scratchpadError2, _sessionIntelligenceEnabled, _intelligenceExchanges2, _intelligenceBusy2, _intelligenceError2, _sessionSidebarOpen, _desktopSessionSidebarVisible, _narrowSessionLayout, _heading6, _subheading, _showToolbar, _showRoles2, _showTimestamps2, _disabled7, _busy4, _queuedCount2, _composerValue, _attachments2, _suggestions3, _maxAttachmentCount2, _maxAttachmentBytes2, _maxTotalAttachmentBytes2, _account2, _accountOptions2, _model2, _modelOptions2, _reasoningEffort2, _effortOptions2, _mode3, _modeOptions2, _toolRegistry6;
 _DeesHarnessChat_decorators = [customElement("dees-harness-chat")];
-var _DeesHarnessChat = class _DeesHarnessChat extends (_a90 = DeesElement, _messages_dec2 = [n5({ attribute: false })], _permissions_dec2 = [n5({ attribute: false })], _questions_dec2 = [n5({ attribute: false })], _status_dec6 = [n5({ attribute: false })], _usage_dec2 = [n5({ attribute: false })], _todos_dec3 = [n5({ attribute: false })], _showTodosPanel_dec = [n5({ type: Boolean })], _showSessionSidebar_dec = [n5({ type: Boolean })], _sessionMetrics_dec = [n5({ attribute: false })], _scratchpad_dec2 = [n5({ attribute: false })], _scratchpadBusy_dec2 = [n5({ type: Boolean })], _scratchpadError_dec2 = [n5()], _sessionIntelligenceEnabled_dec = [n5({ type: Boolean })], _intelligenceExchanges_dec2 = [n5({ attribute: false })], _intelligenceBusy_dec2 = [n5({ type: Boolean })], _intelligenceError_dec2 = [n5()], _sessionSidebarOpen_dec = [r5()], _desktopSessionSidebarVisible_dec = [r5()], _narrowSessionLayout_dec = [r5()], _heading_dec6 = [n5()], _subheading_dec = [n5()], _showToolbar_dec = [n5({ type: Boolean })], _showRoles_dec2 = [n5({ type: Boolean })], _showTimestamps_dec2 = [n5({ type: Boolean })], _disabled_dec7 = [n5({ type: Boolean })], _busy_dec4 = [n5({ type: Boolean })], _queuedCount_dec2 = [n5({ type: Number })], _composerValue_dec = [n5()], _attachments_dec2 = [n5({ attribute: false })], _maxAttachmentCount_dec2 = [n5({ type: Number })], _maxAttachmentBytes_dec2 = [n5({ type: Number })], _maxTotalAttachmentBytes_dec2 = [n5({ type: Number })], _account_dec2 = [n5()], _accountOptions_dec2 = [n5({ attribute: false })], _model_dec2 = [n5()], _modelOptions_dec2 = [n5({ attribute: false })], _reasoningEffort_dec2 = [n5()], _effortOptions_dec2 = [n5({ attribute: false })], _mode_dec3 = [n5()], _modeOptions_dec2 = [n5({ attribute: false })], _toolRegistry_dec6 = [n5({ attribute: false })], _a90) {
+var _DeesHarnessChat = class _DeesHarnessChat extends (_a90 = DeesElement, _messages_dec2 = [n5({ attribute: false })], _permissions_dec2 = [n5({ attribute: false })], _questions_dec2 = [n5({ attribute: false })], _status_dec6 = [n5({ attribute: false })], _usage_dec2 = [n5({ attribute: false })], _todos_dec3 = [n5({ attribute: false })], _showTodosPanel_dec = [n5({ type: Boolean })], _showSessionSidebar_dec = [n5({ type: Boolean })], _sessionMetrics_dec = [n5({ attribute: false })], _scratchpad_dec2 = [n5({ attribute: false })], _scratchpadBusy_dec2 = [n5({ type: Boolean })], _scratchpadError_dec2 = [n5()], _sessionIntelligenceEnabled_dec = [n5({ type: Boolean })], _intelligenceExchanges_dec2 = [n5({ attribute: false })], _intelligenceBusy_dec2 = [n5({ type: Boolean })], _intelligenceError_dec2 = [n5()], _sessionSidebarOpen_dec = [r5()], _desktopSessionSidebarVisible_dec = [r5()], _narrowSessionLayout_dec = [r5()], _heading_dec6 = [n5()], _subheading_dec = [n5()], _showToolbar_dec = [n5({ type: Boolean })], _showRoles_dec2 = [n5({ type: Boolean })], _showTimestamps_dec2 = [n5({ type: Boolean })], _disabled_dec7 = [n5({ type: Boolean })], _busy_dec4 = [n5({ type: Boolean })], _queuedCount_dec2 = [n5({ type: Number })], _composerValue_dec = [n5()], _attachments_dec2 = [n5({ attribute: false })], _suggestions_dec3 = [n5({ attribute: false })], _maxAttachmentCount_dec2 = [n5({ type: Number })], _maxAttachmentBytes_dec2 = [n5({ type: Number })], _maxTotalAttachmentBytes_dec2 = [n5({ type: Number })], _account_dec2 = [n5()], _accountOptions_dec2 = [n5({ attribute: false })], _model_dec2 = [n5()], _modelOptions_dec2 = [n5({ attribute: false })], _reasoningEffort_dec2 = [n5()], _effortOptions_dec2 = [n5({ attribute: false })], _mode_dec3 = [n5()], _modeOptions_dec2 = [n5({ attribute: false })], _toolRegistry_dec6 = [n5({ attribute: false })], _a90) {
   constructor() {
     super(...arguments);
     __privateAdd(this, _messages2, __runInitializers(_init91, 8, this, [])), __runInitializers(_init91, 11, this);
@@ -182447,18 +182732,19 @@ var _DeesHarnessChat = class _DeesHarnessChat extends (_a90 = DeesElement, _mess
     __privateAdd(this, _queuedCount2, __runInitializers(_init91, 112, this, 0)), __runInitializers(_init91, 115, this);
     __privateAdd(this, _composerValue, __runInitializers(_init91, 116, this, "")), __runInitializers(_init91, 119, this);
     __privateAdd(this, _attachments2, __runInitializers(_init91, 120, this, [])), __runInitializers(_init91, 123, this);
-    __privateAdd(this, _maxAttachmentCount2, __runInitializers(_init91, 124, this, Number.POSITIVE_INFINITY)), __runInitializers(_init91, 127, this);
-    __privateAdd(this, _maxAttachmentBytes2, __runInitializers(_init91, 128, this, harnessMaxAttachmentBytes)), __runInitializers(_init91, 131, this);
-    __privateAdd(this, _maxTotalAttachmentBytes2, __runInitializers(_init91, 132, this, harnessMaxTotalAttachmentBytes)), __runInitializers(_init91, 135, this);
-    __privateAdd(this, _account2, __runInitializers(_init91, 136, this, "")), __runInitializers(_init91, 139, this);
-    __privateAdd(this, _accountOptions2, __runInitializers(_init91, 140, this, [])), __runInitializers(_init91, 143, this);
-    __privateAdd(this, _model2, __runInitializers(_init91, 144, this, "")), __runInitializers(_init91, 147, this);
-    __privateAdd(this, _modelOptions2, __runInitializers(_init91, 148, this, [])), __runInitializers(_init91, 151, this);
-    __privateAdd(this, _reasoningEffort2, __runInitializers(_init91, 152, this, "")), __runInitializers(_init91, 155, this);
-    __privateAdd(this, _effortOptions2, __runInitializers(_init91, 156, this, [])), __runInitializers(_init91, 159, this);
-    __privateAdd(this, _mode3, __runInitializers(_init91, 160, this, "")), __runInitializers(_init91, 163, this);
-    __privateAdd(this, _modeOptions2, __runInitializers(_init91, 164, this, [])), __runInitializers(_init91, 167, this);
-    __privateAdd(this, _toolRegistry6, __runInitializers(_init91, 168, this, DeesHarnessToolRegistry.default)), __runInitializers(_init91, 171, this);
+    __privateAdd(this, _suggestions3, __runInitializers(_init91, 124, this, [])), __runInitializers(_init91, 127, this);
+    __privateAdd(this, _maxAttachmentCount2, __runInitializers(_init91, 128, this, Number.POSITIVE_INFINITY)), __runInitializers(_init91, 131, this);
+    __privateAdd(this, _maxAttachmentBytes2, __runInitializers(_init91, 132, this, harnessMaxAttachmentBytes)), __runInitializers(_init91, 135, this);
+    __privateAdd(this, _maxTotalAttachmentBytes2, __runInitializers(_init91, 136, this, harnessMaxTotalAttachmentBytes)), __runInitializers(_init91, 139, this);
+    __privateAdd(this, _account2, __runInitializers(_init91, 140, this, "")), __runInitializers(_init91, 143, this);
+    __privateAdd(this, _accountOptions2, __runInitializers(_init91, 144, this, [])), __runInitializers(_init91, 147, this);
+    __privateAdd(this, _model2, __runInitializers(_init91, 148, this, "")), __runInitializers(_init91, 151, this);
+    __privateAdd(this, _modelOptions2, __runInitializers(_init91, 152, this, [])), __runInitializers(_init91, 155, this);
+    __privateAdd(this, _reasoningEffort2, __runInitializers(_init91, 156, this, "")), __runInitializers(_init91, 159, this);
+    __privateAdd(this, _effortOptions2, __runInitializers(_init91, 160, this, [])), __runInitializers(_init91, 163, this);
+    __privateAdd(this, _mode3, __runInitializers(_init91, 164, this, "")), __runInitializers(_init91, 167, this);
+    __privateAdd(this, _modeOptions2, __runInitializers(_init91, 168, this, [])), __runInitializers(_init91, 171, this);
+    __privateAdd(this, _toolRegistry6, __runInitializers(_init91, 172, this, DeesHarnessToolRegistry.default)), __runInitializers(_init91, 175, this);
     __publicField(this, "toggleSessionSidebar", /* @__PURE__ */ __name(() => {
       if (!this.narrowSessionLayout) {
         this.desktopSessionSidebarVisible = !this.desktopSessionSidebarVisible;
@@ -182644,6 +182930,7 @@ var _DeesHarnessChat = class _DeesHarnessChat extends (_a90 = DeesElement, _mess
           docked
           .value=${this.composerValue}
           .attachments=${this.attachments}
+          .suggestions=${this.suggestions}
           .maxAttachmentCount=${this.maxAttachmentCount}
           .maxAttachmentBytes=${this.maxAttachmentBytes}
           .maxTotalAttachmentBytes=${this.maxTotalAttachmentBytes}
@@ -182738,6 +183025,7 @@ _busy4 = new WeakMap();
 _queuedCount2 = new WeakMap();
 _composerValue = new WeakMap();
 _attachments2 = new WeakMap();
+_suggestions3 = new WeakMap();
 _maxAttachmentCount2 = new WeakMap();
 _maxAttachmentBytes2 = new WeakMap();
 _maxTotalAttachmentBytes2 = new WeakMap();
@@ -182779,6 +183067,7 @@ __decorateElement(_init91, 4, "busy", _busy_dec4, _DeesHarnessChat, _busy4);
 __decorateElement(_init91, 4, "queuedCount", _queuedCount_dec2, _DeesHarnessChat, _queuedCount2);
 __decorateElement(_init91, 4, "composerValue", _composerValue_dec, _DeesHarnessChat, _composerValue);
 __decorateElement(_init91, 4, "attachments", _attachments_dec2, _DeesHarnessChat, _attachments2);
+__decorateElement(_init91, 4, "suggestions", _suggestions_dec3, _DeesHarnessChat, _suggestions3);
 __decorateElement(_init91, 4, "maxAttachmentCount", _maxAttachmentCount_dec2, _DeesHarnessChat, _maxAttachmentCount2);
 __decorateElement(_init91, 4, "maxAttachmentBytes", _maxAttachmentBytes_dec2, _DeesHarnessChat, _maxAttachmentBytes2);
 __decorateElement(_init91, 4, "maxTotalAttachmentBytes", _maxTotalAttachmentBytes_dec2, _DeesHarnessChat, _maxTotalAttachmentBytes2);
@@ -207460,7 +207749,7 @@ init_group_runtime();
 // ts_web/00_commitinfo_data.ts
 var commitinfo = {
   name: "@design.estate/dees-catalog",
-  version: "6.8.1",
+  version: "6.9.0",
   description: "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript."
 };
 

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@design.estate/dees-catalog',
-    version: '6.8.1',
+    version: '6.9.0',
     description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUsNkJBQTZCO0lBQ25DLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxzSkFBc0o7Q0FDcEssQ0FBQSJ9

package/dist_ts_web/elements/00group-harness/dees-harness-chat/dees-harness-chat.d.ts

@@ -1,5 +1,5 @@
 import { DeesElement, type TemplateResult } from '@design.estate/dees-element';
-import type { IHarnessAttachment, IHarnessComposerOption, IHarnessMessage, IHarnessPermissionRequest, IHarnessQuestionRequest, IHarnessIntelligenceExchange, IHarnessScratchpad, IHarnessSessionMetrics, IHarnessStatus, IHarnessTodoItem, IHarnessUsage, THarnessStreamDelta } from '../interfaces.js';
+import type { IHarnessAttachment, IHarnessComposerOption, IHarnessComposerSuggestion, IHarnessMessage, IHarnessPermissionRequest, IHarnessQuestionRequest, IHarnessIntelligenceExchange, IHarnessScratchpad, IHarnessSessionMetrics, IHarnessStatus, IHarnessTodoItem, IHarnessUsage, THarnessStreamDelta } from '../interfaces.js';
 import { DeesHarnessToolRegistry } from '../toolregistry.js';
 import '../dees-harness-todos/dees-harness-todos.js';
 import '../dees-harness-session-sidebar/dees-harness-session-sidebar.js';
@@ -58,6 +58,7 @@ export declare class DeesHarnessChat extends DeesElement {
     accessor queuedCount: number;
     accessor composerValue: string;
     accessor attachments: IHarnessAttachment[];
+    accessor suggestions: IHarnessComposerSuggestion[];
     accessor maxAttachmentCount: number;
     accessor maxAttachmentBytes: number;
     accessor maxTotalAttachmentBytes: number;