@gjsify/adwaita-web 0.31.0 → 0.32.0

package/lib/types/elements/adw-view-switcher.d.ts

@@ -1,29 +1,40 @@
-type Policy = 'wide' | 'narrow';
+import type { AdwViewSwitcherPage as AdwViewSwitcherPageInfo, AdwViewSwitcherPolicy } from '@gjsify/adwaita-core';
 /** A single page. Children of <adw-view-switcher>; consumed at connect time. */
 export declare class AdwViewSwitcherPage extends HTMLElement {
     static get observedAttributes(): string[];
 }
 export declare class AdwViewSwitcher extends HTMLElement {
+    private readonly _state;
     private _barEl;
     private _contentEl;
-    private _pages;
-    private _active;
+    private _nodes;
     private _policy;
     private _initialized;
     static get observedAttributes(): string[];
+    constructor();
     /** The policy controlling the button layout ('wide' | 'narrow'). */
-    get policy(): Policy;
-    set policy(value: Policy);
-    /** Zero-based index of the active page. */
+    get policy(): AdwViewSwitcherPolicy;
+    set policy(value: AdwViewSwitcherPolicy);
+    /** Zero-based index of the selected page, `-1` when nothing is selected. */
     get active(): number;
     set active(value: number);
-    /** The name of the currently visible page, or null when there are none. */
-    get visibleChildName(): string | null;
+    /** Name of the selected page, `''` when nothing is selected. */
+    get visibleChildName(): string;
+    set visibleChildName(name: string | null | undefined);
+    /** The resolved page records a bound layout can read. */
+    get pages(): readonly AdwViewSwitcherPageInfo[];
+    /**
+     * Show or hide a page (`AdwViewStackPage:visible`). Returns whether the
+     * SELECTION moved — hiding the selected page falls back to the first still
+     * visible one (adw-view-stack.c:1061-1082).
+     */
+    setPageVisible(name: string, visible: boolean): boolean;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
+    private _buildPage;
     private _readPolicyAttr;
-    private _readActiveAttr;
-    private _selectIndex;
+    private _onStateChange;
     private _render;
+    private _reflectActive;
 }
-export {};

package/lib/types/elements/adw-window-title.d.ts

@@ -1,9 +1,11 @@
 export declare class AdwWindowTitle extends HTMLElement {
     private _titleEl;
     private _subtitleEl;
+    /** The headless title/subtitle pair + change detection (ADR 0004). */
+    private readonly _state;
     private _initialized;
     static get observedAttributes(): string[];
     connectedCallback(): void;
-    attributeChangedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
     private _render;
 }

package/lib/types/elements/view-switcher-dom.d.ts

@@ -0,0 +1,44 @@
+import type { AdwViewSwitcherPageInit, ViewSwitcherScheduler } from '@gjsify/adwaita-core';
+import { type AdwIcon } from './adw-icon.js';
+/**
+ * The browser's timer behind the core's scheduler seam.
+ *
+ * One shared instance rather than one per element: it holds no state, and the
+ * seam exists so the CORE stays free of a global timer, not so each element
+ * invents its own.
+ */
+export declare const domViewSwitcherScheduler: ViewSwitcherScheduler;
+/**
+ * Build a switcher button's icon node, carrying its own position class.
+ *
+ * The core resolves NULL/empty to `image-missing` (which the stylesheet carries
+ * a real glyph for); the `-symbolic` strip and the CSS-token guard are
+ * `normalizeIconName`'s, applied by `<adw-icon>` — that strip is this package's
+ * own mask-class convention and has no counterpart in C, where the name reaches
+ * `GtkImage` untouched.
+ */
+export declare function createSwitcherIcon(iconName: string, extra: string): AdwIcon;
+/** Repaint an existing switcher icon from a page's declared name. */
+export declare function applySwitcherIcon(icon: AdwIcon, iconName: string): void;
+/**
+ * Read a declared page element into the core's page init.
+ *
+ * `getAttribute` returns `null` for an absent attribute, which is EXACTLY C's
+ * NULL — so the values are passed through unchanged rather than defaulted to
+ * `''`. That `?? ''` is what made the button-visibility rule unimplementable in
+ * the old code: once an absent title has become the empty string, "the page has
+ * no title" is no longer expressible.
+ */
+export declare function readSwitcherPage(element: Element): AdwViewSwitcherPageInit;
+/**
+ * Paint `AdwIndicatorBin`'s badge/dot onto a span: the badge text when there is
+ * one, a bare dot when only `needs-attention` is set, nothing otherwise
+ * (adw-indicator-bin.c:58-68 + the `.needs-attention` style class).
+ */
+export declare function applyIndicator(indicator: HTMLElement, badgeLabel: string, needsAttention: boolean): void;
+/**
+ * Mirror the derived screen-reader description onto the element, REMOVING the
+ * attribute when there is none — `update_description_cb` resets the accessible
+ * property rather than setting it to `""` (adw-view-switcher-button.c:104-113).
+ */
+export declare function applyDescription(element: HTMLElement, description: string): void;

package/lib/types/entry-rows.spec.d.ts

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

package/lib/types/index.d.ts

@@ -1,4 +1,5 @@
 import '@gjsify/adwaita-fonts';
+export { addBreakpoints, bindBreakpointSetter } from './breakpoints.js';
 export { AdwAvatar } from './elements/adw-avatar.js';
 export { AdwBanner } from './elements/adw-banner.js';
 export { AdwCard } from './elements/adw-card.js';
@@ -12,6 +13,12 @@ export { AdwHeaderBar } from './elements/adw-header-bar.js';
 export { AdwWindowTitle } from './elements/adw-window-title.js';
 export { AdwButton } from './elements/adw-button.js';
 export { AdwButtonContent } from './elements/adw-button-content.js';
+export { AdwIcon, createAdwIcon } from './elements/adw-icon.js';
+export { AdwSwitch } from './elements/adw-switch.js';
+export { AdwCheckbox, AdwRadio } from './elements/adw-checks.js';
+export { AdwProgressBar } from './elements/adw-progress-bar.js';
+export { AdwPopover } from './elements/adw-popover.js';
+export type { AdwPopoverAlign, AdwPopoverPosition, AdwPopoverRole } from './elements/adw-popover.js';
 export { AdwSplitButton } from './elements/adw-split-button.js';
 export { AdwToggle, AdwToggleGroup } from './elements/adw-toggle-group.js';
 export { AdwEntry } from './elements/adw-entry.js';

package/lib/types/navigation-view.spec.d.ts

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

package/lib/types/preferences-search.d.ts

@@ -0,0 +1,20 @@
+import { type PreferencesSearchPage, type PreferencesSearchResult, type SearchPreferencesOptions } from '@gjsify/adwaita-core';
+/**
+ * Describe every `<adw-preferences-page>` under `root` as the tree
+ * `searchPreferences` indexes.
+ *
+ * Page identity is read off the element itself — which is why the dialog keeps
+ * the page elements in its subtree instead of hoisting their children out. A
+ * flattened dialog has no page titles, and `create_search_row_subtitle` needs
+ * them the moment a second page exists.
+ */
+export declare function describePreferencesPages(root: ParentNode): PreferencesSearchPage<Element>[];
+/**
+ * Search the preferences pages under `root`, returning the result rows a
+ * `search_results` list box would be bound to.
+ *
+ * Each result carries the `<adw-preferences-page>` and the row element, so a
+ * caller can reproduce `search_result_activated_cb`: reveal the page, focus
+ * the row.
+ */
+export declare function searchPreferencesDom(root: ParentNode, query: string, options?: SearchPreferencesOptions): PreferencesSearchResult<Element>[];

package/lib/types/preferences.spec.d.ts

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

package/lib/types/split-button.spec.d.ts

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

package/lib/types/split-views.spec.d.ts

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