@gjsify/adwaita-web 0.21.0 → 0.23.0

package/lib/types/adw-row-state.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwRowStateTest: () => Promise<void>;

package/lib/types/adw-toast-overlay.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwToastOverlayTest: () => Promise<void>;

package/lib/types/adw-view-switcher-bar.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwViewSwitcherBarTest: () => Promise<void>;

package/lib/types/elements/adw-alert-dialog.d.ts

@@ -1,5 +1,6 @@
+import type { AdwResponseAppearance } from '@gjsify/adwaita-core';
 /** Response button appearance — mirrors Adw.ResponseAppearance. */
-export type AdwResponseAppearance = 'default' | 'suggested' | 'destructive';
+export type { AdwResponseAppearance } from '@gjsify/adwaita-core';
 /**
  * A single response declared in markup. Child of <adw-alert-dialog>; its `id`
  * attribute is the response ID, its text content the label. Optional
@@ -17,10 +18,10 @@ export declare class AdwAlertDialog extends HTMLElement {
     private _bodyEl;
     private _childEl;
     private _responseAreaEl;
-    private _responses;
-    private _byId;
-    private _defaultResponse;
-    private _closeResponse;
+    /** The headless response registry + default/close semantics + resolution (ADR 0004). */
+    private _model;
+    /** The rendered button per registered response id (the DOM half of the model). */
+    private readonly _buttons;
     private _blockCloseResponse;
     static get observedAttributes(): string[];
     /** The heading of the dialog. */

package/lib/types/elements/adw-combo-row.d.ts

@@ -3,7 +3,8 @@ export declare class AdwComboRow extends HTMLElement {
     private _valueEl;
     private _titleEl;
     private _subtitleEl;
-    private _items;
+    /** The headless options list + selectedIndex↔selectedValue state machine (ADR 0004). */
+    private readonly _state;
     private _initialized;
     static get observedAttributes(): string[];
     get selected(): number;

package/lib/types/elements/adw-expander-row.d.ts

@@ -8,7 +8,10 @@ export declare class AdwExpanderRow extends HTMLElement {
     private _contentEl;
     private _prefixEl;
     private _suffixEl;
+    /** The headless expanded/collapsed disclosure state machine (ADR 0004). */
+    private readonly _state;
     private _initialized;
+    constructor();
     static get observedAttributes(): string[];
     get expanded(): boolean;
     set expanded(value: boolean);
@@ -21,6 +24,6 @@ export declare class AdwExpanderRow extends HTMLElement {
     /** The header prefix section — append icons/widgets here imperatively. */
     get prefixSection(): HTMLDivElement;
     connectedCallback(): void;
-    attributeChangedCallback(): void;
+    attributeChangedCallback(name: string): void;
     private _render;
 }

package/lib/types/elements/adw-spin-row.d.ts

@@ -2,10 +2,8 @@ export declare class AdwSpinRow extends HTMLElement {
     private _input;
     private _titleEl;
     private _subtitleEl;
-    private _min;
-    private _max;
-    private _step;
-    private _value;
+    /** The headless value/min/max/step adjustment with clamping (ADR 0004). */
+    private readonly _state;
     private _initialized;
     static get observedAttributes(): string[];
     get value(): number;
@@ -13,8 +11,12 @@ export declare class AdwSpinRow extends HTMLElement {
     connectedCallback(): void;
     attributeChangedCallback(name: string, _old: string | null, val: string | null): void;
     private _renderText;
+    /** A stepper press — the interactive path, so it emits `notify::value`. */
     private _adjust;
     private _emitChange;
+    /** Mirror the core value into the input display + the reflected attribute. */
+    private _syncValue;
+    private _roundToStep;
     private _countDecimals;
     private _formatValue;
 }

package/lib/types/elements/adw-toast-overlay.d.ts

@@ -1,3 +1,6 @@
+import { AdwToast } from '@gjsify/adwaita-core';
+import type { ToastScheduler } from '@gjsify/adwaita-core';
+export type { ToastScheduler, ToastTimerHandle } from '@gjsify/adwaita-core';
 /** Options for {@link AdwToastOverlay.addToast}, mirroring Adw.Toast's properties. */
 export interface AdwToastOptions {
     /** Seconds before the toast auto-dismisses; `0` keeps it until dismissed. Mirrors Adw.Toast:timeout (default 5). */
@@ -10,14 +13,52 @@ export interface AdwToastOptions {
 export declare class AdwToastOverlay extends HTMLElement {
     private _toasts;
     private _initialized;
+    /** The headless one-at-a-time + FIFO + auto-dismiss state machine (ADR 0004). */
+    private readonly _queue;
+    /** The timing source the queue's auto-dismiss runs on — swappable, see {@link scheduler}. */
+    private _scheduler;
+    /** The strip currently mounted for {@link AdwToastQueue.current}, if any. */
+    private _currentEl;
+    /** Per-toast action callbacks (the core toast descriptor carries only the label). */
+    private readonly _actions;
+    constructor();
     connectedCallback(): void;
+    /**
+     * The timing source driving the queue's auto-dismiss and the exit transition.
+     * Defaults to the browser's `setTimeout`/`clearTimeout`; swap it for a
+     * deterministic fake to drive toast lifetimes without real timers (the
+     * {@link ToastScheduler} seam `@gjsify/adwaita-core` defines).
+     */
+    get scheduler(): ToastScheduler;
+    set scheduler(scheduler: ToastScheduler);
+    /** The toast currently on screen, or `null` when nothing is shown. */
+    get currentToast(): AdwToast | null;
+    /** Number of toasts queued behind the visible one. */
+    get pendingToasts(): number;
     /**
      * Show a toast notification — the web equivalent of Adw.ToastOverlay.add_toast()
      * with a freshly-built Adw.Toast.
      *
+     * Like Adw.ToastOverlay, only ONE toast is visible at a time: this one shows
+     * immediately when the slot is free, otherwise it waits its turn behind the
+     * toasts already queued.
+     *
      * @param title   The text to display.
-     * @param options Either a timeout in seconds (legacy shorthand) or an
+     * @param options Either a timeout in milliseconds (legacy shorthand) or an
      *                {@link AdwToastOptions} bag (title text already supplied here).
      */
     addToast(title: string, options?: number | AdwToastOptions): void;
+    /** Dismiss the visible toast early; the next queued toast takes its place. */
+    dismiss(): void;
+    /** Dismiss the visible toast and discard everything still queued behind it. */
+    clearToasts(): void;
+    /** Build + attach the strip for `toast` — the DOM half of the queue's `onShow`. */
+    private _mountToast;
+    /**
+     * Detach the mounted strip — the DOM half of the queue's `onHide`.
+     *
+     * @param immediate Skip the exit transition because the next queued toast is
+     *                  about to take this slot (keeps exactly one strip mounted).
+     */
+    private _unmountToast;
 }

package/lib/types/elements/adw-toggle-group.d.ts

@@ -5,7 +5,8 @@ export declare class AdwToggle extends HTMLElement {
 export declare class AdwToggleGroup extends HTMLElement {
     private _innerEl;
     private _buttons;
-    private _active;
+    /** The headless segment list + guarded selection state machine (ADR 0004). */
+    private readonly _state;
     private _initialized;
     static get observedAttributes(): string[];
     /** Zero-based index of the active toggle. */

package/lib/types/style-isolation.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwStyleIsolationTest: () => Promise<void>;