@design.estate/dees-catalog 12.0.0 → 12.1.0

package/dist_bundle/bundle.js

@@ -182712,6 +182712,11 @@ var _DeesTerminalView = class _DeesTerminalView extends (_a102 = DeesElement, _f
     __publicField(this, "pendingWriteBytes", 0);
     __publicField(this, "pendingWritesDropped", false);
     __publicField(this, "setupPromise");
+    /**
+     * Set only by an explicit `focus()` that arrived before the terminal existed. Nothing else sets
+     * it, so a re-render, a write, or a resize can never move the caret into this element.
+     */
+    __publicField(this, "focusWhenReady", false);
     __publicField(this, "readyPending", true);
     __publicField(this, "readyResolve", /* @__PURE__ */ __name(() => void 0, "readyResolve"));
     __publicField(this, "readyReject", /* @__PURE__ */ __name(() => void 0, "readyReject"));
@@ -182756,8 +182761,33 @@ var _DeesTerminalView = class _DeesTerminalView extends (_a102 = DeesElement, _f
     this.pendingWriteBytes = chunkByteLength(RIS);
     this.pendingWritesDropped = false;
   }
-  focus() {
-    this.terminal?.focus();
+  /**
+   * Moves the caret into the terminal's input surface, so the next keystroke goes to the pty
+   * rather than to whatever the page focused last. This is the call a host makes when the user
+   * selects a terminal in a list.
+   *
+   * The terminal is created asynchronously — the xterm modules are loaded on first connection —
+   * so a call that arrives before it exists is remembered and applied once it is ready, exactly
+   * once. The same applies to an element that is focused while detached and then reattached: the
+   * pending request is dropped on disconnect, because by then the user's intent has expired, and
+   * a fresh `focus()` after the move is what a host should issue.
+   *
+   * Only this method arms that behaviour; re-renders, buffered output and background updates
+   * never steal focus.
+   */
+  focus(optionsArg) {
+    const terminal = this.terminal;
+    if (terminal && this.isConnected) {
+      this.focusWhenReady = false;
+      terminal.focus();
+      return;
+    }
+    void optionsArg;
+    this.focusWhenReady = true;
+  }
+  /** True while an explicit `focus()` is waiting for the terminal to come up. */
+  get focusPending() {
+    return this.focusWhenReady;
   }
   /** Current grid size, or undefined while no terminal is live. */
   get currentSize() {
@@ -182882,6 +182912,10 @@ var _DeesTerminalView = class _DeesTerminalView extends (_a102 = DeesElement, _f
     this.refit();
     this.resizeObserver = new ResizeObserver(() => this.refit());
     this.resizeObserver.observe(host);
+    if (this.focusWhenReady) {
+      this.focusWhenReady = false;
+      terminal.focus();
+    }
     this.readyResolve();
   }
   refit() {
@@ -182912,6 +182946,7 @@ var _DeesTerminalView = class _DeesTerminalView extends (_a102 = DeesElement, _f
     this.fitAddon = void 0;
     this.lastReportedSize = "";
     this.setupPromise = void 0;
+    this.focusWhenReady = false;
     if (this.readyPending) {
       this.readyReject(
         new Error("dees-terminal-view was disconnected before the terminal became ready")
@@ -224465,7 +224500,7 @@ init_group_runtime();
 // ts_web/00_commitinfo_data.ts
 var commitinfo = {
   name: "@design.estate/dees-catalog",
-  version: "12.0.0",
+  version: "12.1.0",
   description: "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript."
 };