@gjsify/adwaita-web 0.15.1 → 0.16.0

package/lib/types/adw-data-grid.spec.d.ts

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

package/lib/types/adw-dialog.spec.d.ts

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

package/lib/types/adw-drop-down.spec.d.ts

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

package/lib/types/elements/adw-data-grid.d.ts

@@ -0,0 +1,60 @@
+/** Horizontal alignment of a column's header + cells. */
+export type AdwDataGridAlign = 'start' | 'end' | 'center';
+/** Accounting row emphasis. `normal` is the default plain data row. */
+export type AdwDataGridRowVariant = 'normal' | 'section' | 'subtotal' | 'total';
+/** A column descriptor — what to read (`key`), how to label + align it. */
+export interface AdwDataGridColumn {
+    /** The row-object key this column renders. */
+    key: string;
+    /** Header text (defaults to `key`). */
+    label?: string;
+    /** 'start' | 'end' | 'center'. Defaults to 'start' (or 'end' when numeric). */
+    align?: AdwDataGridAlign;
+    /** Fixed CSS track size (e.g. '80px', '6rem') — pins the column width. */
+    width?: string;
+    /** Fractional track weight (→ `<flex>fr`) — lets the column grow. */
+    flex?: number;
+    /** Render cells in a monospace family (tabular figures apply regardless). */
+    monospace?: boolean;
+    /** Convenience: right-align + tabular-nums (numeric columns of figures). */
+    numeric?: boolean;
+}
+/** A row: cell values keyed by column key + optional accounting metadata. */
+export interface AdwDataGridRow {
+    /** Accounting emphasis. Default 'normal'. */
+    variant?: AdwDataGridRowVariant;
+    /** Make just this row clickable (overrides the element-level flag). */
+    interactive?: boolean;
+    /** Cell values keyed by column key (pre-formatted strings, or numbers). */
+    [key: string]: string | number | boolean | AdwDataGridRowVariant | undefined;
+}
+export declare class AdwDataGrid extends HTMLElement {
+    private _captionEl;
+    private _scrollEl;
+    private _tableEl;
+    private _columns;
+    private _rows;
+    private _initialized;
+    static get observedAttributes(): string[];
+    /** The column descriptors. Setting rebuilds the grid. */
+    get columns(): AdwDataGridColumn[];
+    set columns(value: ReadonlyArray<AdwDataGridColumn>);
+    /** The row objects. Setting rebuilds the body. */
+    get rows(): AdwDataGridRow[];
+    set rows(value: ReadonlyArray<AdwDataGridRow>);
+    /** The optional grid caption/title (reflected to the attribute). */
+    get caption(): string;
+    set caption(value: string);
+    /** Whether every `normal` row is clickable (element-level flag). */
+    get interactive(): boolean;
+    set interactive(value: boolean);
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _parseJsonAttr;
+    private _renderCaption;
+    /** The CSS `grid-template-columns` value derived from the column descriptors. */
+    private _trackTemplate;
+    private _columnClasses;
+    private _render;
+    private _activate;
+}

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

@@ -0,0 +1,51 @@
+/** Adaptive presentation of the dialog — mirrors Adw.DialogPresentationMode. */
+export type AdwDialogPresentationMode = 'auto' | 'floating' | 'bottom-sheet';
+export declare class AdwDialog extends HTMLElement {
+    private _initialized;
+    private _scrimEl;
+    private _boxEl;
+    private _headerEl;
+    private _titleEl;
+    private _closeBtn;
+    private _contentEl;
+    private _previouslyFocused;
+    static get observedAttributes(): string[];
+    /** Whether the dialog is currently revealed. */
+    get open(): boolean;
+    set open(value: boolean);
+    /** The header title (Adw.Dialog:title). Setting a title renders the header. */
+    get title(): string;
+    set title(value: string);
+    /** Whether the user can dismiss the dialog (scrim / Escape / close button). */
+    get canClose(): boolean;
+    set canClose(value: boolean);
+    /** The dialog's preferred/max content width in px (Adw.Dialog:content-width). */
+    get contentWidth(): number;
+    set contentWidth(value: number);
+    /** The dialog's max content height in px, or 0 for "unconstrained" (Adw.Dialog:content-height). */
+    get contentHeight(): number;
+    set contentHeight(value: number);
+    /** The adaptive presentation mode (Adw.Dialog:presentation-mode). */
+    get presentationMode(): AdwDialogPresentationMode;
+    set presentationMode(value: AdwDialogPresentationMode);
+    /** The content container — arbitrary child markup lives here after connect. */
+    get contentArea(): HTMLDivElement;
+    /** Reveal the dialog (mirrors Adw.Dialog.present). Auto-attaches if disconnected. */
+    present(parent?: Element): void;
+    /** Dismiss the dialog, respecting `can-close` (mirrors Adw.Dialog.close). */
+    close(): void;
+    /** Dismiss the dialog regardless of `can-close` (mirrors Adw.Dialog.force_close). */
+    forceClose(): void;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** A dismissal was requested: honour `can-close`, else raise close-attempt. */
+    private _attemptClose;
+    /** Focus trap + Escape while the box has focus. */
+    private _onBoxKeyDown;
+    private _focusables;
+    /** On present: remember focus, then move it into the dialog. */
+    private _onPresented;
+    /** On close: emit `closed` and return focus to where it was before present. */
+    private _onClosed;
+    private _render;
+}

package/lib/types/elements/adw-drop-down.d.ts

@@ -0,0 +1,63 @@
+/** A dropdown option — `value` is the stable id, `label` the shown text. */
+export interface AdwDropDownOption {
+    value: string;
+    label: string;
+}
+type RawOption = string | {
+    value?: unknown;
+    label?: unknown;
+};
+export declare class AdwDropDown extends HTMLElement {
+    private _buttonEl;
+    private _labelEl;
+    private _popoverEl;
+    private _listEl;
+    private _searchEl;
+    private _options;
+    private _itemButtons;
+    private _selected;
+    private _active;
+    private _initialized;
+    private _typeAheadBuffer;
+    private _typeAheadTimer;
+    private _onDocumentPointerDown;
+    private _onDocumentKeyDown;
+    static get observedAttributes(): string[];
+    /** The options list. Setting it rebuilds the popover and clamps the selection. */
+    get options(): AdwDropDownOption[];
+    set options(value: ReadonlyArray<RawOption>);
+    /** Alias of `options` (Gtk.DropDown's model is often called "items"). */
+    get items(): AdwDropDownOption[];
+    set items(value: ReadonlyArray<RawOption>);
+    /** The selected index. Out-of-range values are ignored (Gtk.DropDown:selected). */
+    get selected(): number;
+    set selected(value: number);
+    /** The selected option's value, or '' when empty (Gtk.DropDown:selected-item). */
+    get selectedValue(): string;
+    set selectedValue(value: string);
+    /** The selected option descriptor, or null when empty. */
+    get selectedItem(): AdwDropDownOption | null;
+    /** Whether the search entry is shown in the popover. */
+    get enableSearch(): boolean;
+    set enableSearch(value: boolean);
+    /** Whether the popover is currently open. */
+    get active(): boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _parseOptionsAttr;
+    private _selectIndex;
+    private _setActive;
+    private _onButtonKeyDown;
+    private _onPopoverKeyDown;
+    /** Type-ahead: accumulate keys, focus/select the next matching option. */
+    private _typeAhead;
+    /** Filter the visible items by a search query (case-insensitive substring). */
+    private _filter;
+    private _visibleItems;
+    private _renderAll;
+    private _updateLabel;
+    private _updateSelectedStates;
+    private _renderPopover;
+}
+export {};

package/lib/types/index.d.ts

@@ -2,6 +2,8 @@ import '@gjsify/adwaita-fonts';
 export { AdwAvatar } from './elements/adw-avatar.js';
 export { AdwBanner } from './elements/adw-banner.js';
 export { AdwCard } from './elements/adw-card.js';
+export { AdwDataGrid } from './elements/adw-data-grid.js';
+export type { AdwDataGridAlign, AdwDataGridColumn, AdwDataGridRow, AdwDataGridRowVariant, } from './elements/adw-data-grid.js';
 export { AdwClamp } from './elements/adw-clamp.js';
 export { AdwSpinner } from './elements/adw-spinner.js';
 export { AdwStatusPage } from './elements/adw-status-page.js';
@@ -36,9 +38,13 @@ export type { AdwViewStackPageInfo } from './elements/adw-view-stack.js';
 export { AdwViewSwitcherBar } from './elements/adw-view-switcher-bar.js';
 export { AdwMenuButton } from './elements/adw-menu-button.js';
 export type { AdwMenuItem } from './elements/adw-menu-button.js';
+export { AdwDropDown } from './elements/adw-drop-down.js';
+export type { AdwDropDownOption } from './elements/adw-drop-down.js';
 export { AdwNavigationPage, AdwNavigationView } from './elements/adw-navigation-view.js';
 export { AdwBottomSheet, AdwBottomSheetContent, AdwBottomSheetSheet } from './elements/adw-bottom-sheet.js';
 export { AdwSidebar, AdwSidebarItem, AdwSidebarSection } from './elements/adw-sidebar.js';
 export { AdwAboutDialog } from './elements/adw-about-dialog.js';
 export { AdwAlertDialog, AdwAlertResponse } from './elements/adw-alert-dialog.js';
 export { AdwPreferencesDialog, AdwPreferencesPage } from './elements/adw-preferences-dialog.js';
+export { AdwDialog } from './elements/adw-dialog.js';
+export type { AdwDialogPresentationMode } from './elements/adw-dialog.js';