stimeo-ui 0.16.0 → 0.18.0

package/dist/controllers/dialog_controller.d.ts

@@ -20,20 +20,22 @@ import { Controller } from '@hotwired/stimulus';
  *
  * @remarks
  * Behavior only. The sole visual side effect is locking `document.body`'s scroll
- * while open (the minimum required by the pattern); all other styling is the
- * consumer's. Clicking the dialog backdrop (the dialog target itself, outside
- * its content) also closes it.
+ * while open; all other styling is the consumer's. Clicking the dialog backdrop
+ * (the dialog target itself, outside its content) also closes it.
  *
  * The modal lifecycle — focus trap, scroll lock, background `inert`, focus
  * restore, and teardown reversal — is delegated to the shared `FocusTrap`
- * primitive (also used by `stimeo--alert-dialog` and `stimeo--drawer`). This controller only owns
- * *when* to open/close and the dialog-specific backdrop click.
+ * primitive. This controller only owns *when* to open/close and the
+ * dialog-specific backdrop click.
  *
  * Each move of the open state is reported: `stimeo--dialog:open` and
  * `stimeo--dialog:close` dispatch `{ reason: StateReason }`, after the dialog's
  * `hidden` attribute is written and before focus moves. Both are informational,
  * so neither is cancelable. A call that leaves the state where it already was,
- * the normalization in {@link connect}, and {@link disconnect} are all silent.
+ * the normalization in {@link connect}, the reconciliation that follows dialog
+ * churn, and {@link disconnect} are all silent. A Turbo morph that puts the
+ * server's `hidden` back on an open dialog, or takes it off a closed one, is
+ * answered by writing the open state back, silently.
  */
 declare class DialogController extends Controller<HTMLElement> {
     #private;
@@ -42,6 +44,7 @@ declare class DialogController extends Controller<HTMLElement> {
     static events: readonly ["close", "open"];
     readonly triggerTarget: HTMLElement;
     readonly dialogTarget: HTMLElement;
+    readonly dialogTargets: HTMLElement[];
     readonly hasTriggerTarget: boolean;
     readonly hasDialogTarget: boolean;
     /** Starts closed (idempotently reflects the closed state on the markup). */
@@ -53,6 +56,14 @@ declare class DialogController extends Controller<HTMLElement> {
      * teardown.
      */
     disconnect(): void;
+    /** Applies the open state to a dialog that arrives after connect in front of the others. */
+    dialogTargetConnected(): void;
+    /**
+     * Gives a dialog that no longer resolves as the target its own `hidden` back — after
+     * `disconnect()` too, since dropping the identifier leaves the element on the page — and,
+     * while connected, applies the open state to the dialog left.
+     */
+    dialogTargetDisconnected(dialog: HTMLElement): void;
     /** Opens the dialog, traps focus, and locks background scroll. */
     open(event?: Event): void;
     /** Closes the dialog, restores scroll, and returns focus to the opener. */