@gjsify/adwaita-core 0.53.0 → 0.55.0

package/lib/types/conformance/box-selection.d.ts

@@ -0,0 +1,47 @@
+import type { AdwBoxSelectResult, AdwBoxSelectionMode, AdwBoxSelectStep } from '../box-selection.js';
+/** One click on one row, and what it must produce. */
+export interface BoxSelectVector {
+    /** The C branch this row pins down. */
+    readonly rule: string;
+    /** The selection the box held before the click. */
+    readonly selection: readonly number[];
+    /** `box->selected_row` before the click; `-1` is the C's NULL. */
+    readonly anchor: number;
+    /** Which row was clicked. */
+    readonly position: number;
+    /** How many rows the box holds. */
+    readonly length: number;
+    readonly mode: AdwBoxSelectionMode;
+    /** The modifiers, and whether the row is `selectable` (`GtkListBoxRow:selectable`). */
+    readonly step: AdwBoxSelectStep & {
+        readonly selectable?: boolean;
+    };
+    readonly expected: AdwBoxSelectResult;
+}
+export declare const BOX_SELECT_VECTORS: readonly BoxSelectVector[];
+/** One programmatic call, and what it must produce. */
+export interface BoxRowVector {
+    readonly rule: string;
+    readonly op: 'select' | 'unselect';
+    readonly selection: readonly number[];
+    readonly anchor: number;
+    readonly position: number | null;
+    readonly length: number;
+    readonly mode: AdwBoxSelectionMode;
+    readonly step: AdwBoxSelectStep & {
+        readonly selectable?: boolean;
+    };
+    readonly expected: AdwBoxSelectResult;
+}
+export declare const BOX_ROW_VECTORS: readonly BoxRowVector[];
+/** One `select_all` / `unselect_all`, and what it must answer. */
+export interface BoxAllVector {
+    readonly rule: string;
+    readonly op: 'select-all' | 'unselect-all';
+    readonly selection: readonly number[];
+    readonly length: number;
+    readonly mode: AdwBoxSelectionMode;
+    /** `null` is the refusal — the C emits nothing. */
+    readonly expected: number[] | null;
+}
+export declare const BOX_ALL_VECTORS: readonly BoxAllVector[];

package/lib/types/conformance/breakpoint-bin.d.ts

@@ -15,10 +15,12 @@ export interface BreakpointPickVector {
  * `adw_breakpoint_bin_size_allocate` iterates backwards and takes the first match:
  * "Iterate in reverse order since we prioritize breakpoints added last" (:432).
  *
- * CORE-ONLY: GAP — no renderer drives this table yet. The NativeScript bin binds
- * breakpoints to a view's post-layout size and runs its own callbacks; moving it onto
- * `BreakpointBinState` is a diff with its own spec surface, and the rule lands first so
- * the React Native set is written against it. Tracked in #1343.
+ * DRIVEN from the browser renderer, by `packages/web/adwaita-web/src/
+ * adw-breakpoint-bin.spec.ts`: each row is a real `<adw-breakpoint-bin>` with a real
+ * `<adw-label>` per object, resized through a real `ResizeObserver`, and the pick read
+ * back off the element. The NativeScript port has no `AdwBreakpointBin` view yet —
+ * `status/open-todos/adwaita-ports.md` records that — so this table holds the browser
+ * side alone today, and the `#1343` React Native work is written against it.
  */
 export declare const BREAKPOINT_PICK_VECTORS: ReadonlyArray<BreakpointPickVector>;
 /**
@@ -47,9 +49,10 @@ export interface BreakpointTransitionVector {
  * their originals, skipping any the incoming breakpoint also sets, then write the
  * incoming values.
  *
- * CORE-ONLY: GAP — no renderer drives this table yet. The NativeScript bin binds
- * breakpoints to a view's post-layout size and runs its own callbacks; moving it onto
- * `BreakpointBinState` is a diff with its own spec surface, and the rule lands first so
- * the React Native set is written against it. Tracked in #1343.
+ * Driven from the browser renderer by `packages/web/adwaita-web/src/
+ * adw-breakpoint-bin.spec.ts`, which replays each row as a sequence of resizes of one
+ * mounted `<adw-breakpoint-bin>` and reads the attribute each write landed on. The
+ * NativeScript port has no `AdwBreakpointBin` view yet, so this table holds the browser
+ * side alone today; #1343 is the React Native set written against it.
  */
 export declare const BREAKPOINT_TRANSITION_VECTORS: ReadonlyArray<BreakpointTransitionVector>;

package/lib/types/conformance/calendar.d.ts

@@ -0,0 +1,71 @@
+import type { AdwCalendarDate, AdwCalendarStep } from '../calendar.js';
+/** One month, and the cells its grid must hold. */
+export interface CalendarDaysVector {
+    readonly rule: string;
+    readonly year: number;
+    /** 1-12, `GDateTime`'s own numbering. */
+    readonly month: number;
+    /** 0 = Sunday, as `_NL_TIME_FIRST_WEEKDAY` and `g_date_time_get_day_of_week` spell it. */
+    readonly weekStart: number;
+    /** How many leading cells belong to the PREVIOUS month. */
+    readonly leading: number;
+    /** How many trailing cells belong to the NEXT month. */
+    readonly trailing: number;
+    /** The last cell, as `YYYY-MM-DD` — the row that proves the tail ran where the C runs it. */
+    readonly last: string;
+}
+export declare const CALENDAR_DAYS_VECTORS: readonly CalendarDaysVector[];
+/** One date, and the ISO week its `week-number` label must show. */
+export interface CalendarWeekVector {
+    readonly rule: string;
+    readonly date: AdwCalendarDate;
+    readonly week: number;
+}
+export declare const CALENDAR_WEEK_VECTORS: readonly CalendarWeekVector[];
+/** One navigation press, and the date it must land on. */
+export interface CalendarStepVector {
+    readonly rule: string;
+    readonly from: AdwCalendarDate;
+    readonly step: AdwCalendarStep;
+    readonly expected: AdwCalendarDate;
+}
+export declare const CALENDAR_STEP_VECTORS: readonly CalendarStepVector[];
+/** One selection write, and what it changes. */
+export interface CalendarSelectVector {
+    readonly rule: string;
+    readonly current: AdwCalendarDate;
+    readonly target: AdwCalendarDate;
+    /** The `emit_day_signal` argument the caller passes. */
+    readonly emit: boolean;
+    readonly expected: {
+        readonly date: AdwCalendarDate;
+        readonly dayChanged: boolean;
+        readonly monthChanged: boolean;
+        readonly yearChanged: boolean;
+        readonly emitDaySignal: boolean;
+    };
+}
+export declare const CALENDAR_SELECT_VECTORS: readonly CalendarSelectVector[];
+/** One mark write, and what the 31-slot table must answer. */
+export interface CalendarMarkVector {
+    readonly rule: string;
+    readonly marked: readonly boolean[];
+    readonly day: number;
+    readonly mark: boolean;
+    /** The table afterwards; the IDENTITY is the point for the two no-op rows. */
+    readonly expected: readonly boolean[];
+    readonly changed: boolean;
+}
+export declare const CALENDAR_MARK_VECTORS: readonly CalendarMarkVector[];
+/** Which header arrows are live at a date — `calendar_update_navigation_buttons`. */
+export interface CalendarNavigationVector {
+    readonly rule: string;
+    readonly date: AdwCalendarDate;
+    readonly expected: {
+        readonly previousMonth: boolean;
+        readonly nextMonth: boolean;
+        readonly previousYear: boolean;
+        readonly nextYear: boolean;
+    };
+}
+export declare const CALENDAR_NAVIGATION_VECTORS: readonly CalendarNavigationVector[];

package/lib/types/conformance/constructs.d.ts

@@ -0,0 +1,86 @@
+import type { SharedTreeNode } from './shared-trees.js';
+/** The construct kinds, in the order the tables list them. */
+export declare const CONSTRUCT_KINDS: readonly ["layout", "strings", "responses", "page", "extern", "signal", "bind", "breakpoint"];
+export type ConstructKind = (typeof CONSTRUCT_KINDS)[number];
+/** `implemented`, or the sentence a human can act on — it is the text the error prints. */
+export type ConstructCapability = 'implemented' | {
+    readonly refused: string;
+};
+/** A renderer's `./capabilities` export: TOTAL over {@link ConstructKind}. */
+export type ConstructCapabilities = Readonly<Record<ConstructKind, ConstructCapability>>;
+/** One occurrence of a construct in a tree, addressed the way a failure has to name it. */
+export interface ConstructUse {
+    kind: ConstructKind;
+    /** The pre-order address `authoredNodes` gives the node. */
+    path: string;
+}
+/** Every construct `root` uses, in pre-order. */
+export declare function constructUsesOf(root: SharedTreeNode): ConstructUse[];
+/** A tree uses a construct the renderer it was handed to refuses. */
+export declare class UnsupportedConstructError extends Error {
+    readonly renderer: string;
+    readonly refused: readonly {
+        kind: ConstructKind;
+        path: string;
+        reason: string;
+    }[];
+    constructor(renderer: string, refused: readonly {
+        kind: ConstructKind;
+        path: string;
+        reason: string;
+    }[]);
+}
+/**
+ * The builder pre-check: throws {@link UnsupportedConstructError} for every construct of `root`
+ * that `capabilities` refuses, before the caller creates anything.
+ *
+ * A table that lacks a kind this tree uses is a defect of the table and says so rather than
+ * reading as permission.
+ */
+export declare function assertTreeConstructs(renderer: string, capabilities: ConstructCapabilities, root: SharedTreeNode): void;
+/**
+ * One construct, as an authored tree and what a renderer that builds it must show.
+ *
+ * `shows` is renderer-free data; each renderer's `read` turns its realised tree into the same
+ * shape, so a failure is attributable to the renderer and not to two suites disagreeing.
+ */
+export interface ConstructVector {
+    readonly kind: ConstructKind;
+    readonly rule: string;
+    readonly tree: SharedTreeNode;
+    readonly shows: unknown;
+}
+export declare const CONSTRUCT_VECTORS: readonly ConstructVector[];
+/**
+ * The sizes a renderer feeds the `breakpoint` vector through its own size source, in order, and
+ * reads the caption after each: wide, then narrow enough for the condition, then wide again.
+ */
+export declare const BREAKPOINT_VECTOR_SIZES: readonly {
+    readonly width: number;
+    readonly height: number;
+}[];
+/** The name the extern vector's class is registered under, so each renderer registers the same one. */
+export declare const EXTERN_VECTOR_CLASS = "CorpusExtern";
+/** What a renderer hands {@link driveConstructVectors}. */
+export interface ConstructRenderer {
+    /** The package name, as an error prints it. */
+    readonly name: string;
+    readonly capabilities: ConstructCapabilities;
+    /** The vectors it is held to — passed in so the renderer's own suite names the table it drives. */
+    readonly vectors: readonly ConstructVector[];
+    /** Builds `tree` through the renderer's REAL builder, reads it, and tears it down. */
+    observe(vector: ConstructVector): unknown;
+}
+/** The slice of `@gjsify/unit` this driver uses; the package cannot import it at run time. */
+export interface ConstructHarness {
+    describe(name: string, fn: () => void | Promise<void>): void | Promise<void>;
+    it(name: string, fn: () => void | Promise<void>): void | Promise<void>;
+    expect(actual: unknown): {
+        toBe(expected: unknown): void;
+    };
+}
+/**
+ * Holds a renderer's capability table to the vectors, in both directions, and fails a table
+ * that lacks a kind.
+ */
+export declare function driveConstructVectors(renderer: ConstructRenderer, harness: ConstructHarness): Promise<void>;

package/lib/types/conformance/grid-navigation.d.ts

@@ -0,0 +1,12 @@
+/** The geometry every row below is stated against. */
+export declare const GRID_NAVIGATION_GEOMETRY: {
+    readonly count: 7;
+    readonly columns: 3;
+};
+export interface GridNavigationVector {
+    key: string;
+    from: number;
+    /** The index the cursor lands on, `null` when it stays. */
+    to: number | null;
+}
+export declare const GRID_NAVIGATION_VECTORS: readonly GridNavigationVector[];

package/lib/types/conformance/index.d.ts

@@ -30,12 +30,22 @@ export { ADJUSTMENT_AUTHORED_VECTORS, ADJUSTMENT_PARSE_VECTORS, ADJUSTMENT_SNAP_
 export type { AdjustmentAuthoredVector, AdjustmentParseVector, AdjustmentSnapVector } from './adjustment.js';
 export { LIST_ITEMS_CHANGED_VECTORS, LIST_MODEL_OWNERSHIP_VECTORS, LIST_NORMALIZE_VECTORS, LIST_PARSE_VECTORS, LIST_SELECTION_CLAMP_VECTORS, TAB_PAGES_ITEMS_CHANGED_VECTORS, applyListReadback, replayTabPagesAsSplices, } from './list.js';
 export type { ListItemsChangedVector, ListModelOwnershipVector, ListNormalizeVector, ListParseVector, ListReadbackOp, ListSelectionClampVector, TabPagesItemsChangedVector, } from './list.js';
+export { COLUMN_VIEW_SORT_VECTORS, GRID_VIEW_COLUMN_VECTORS, LIST_VIEW_SELECT_VECTORS } from './list-view.js';
+export type { ColumnViewSortVector, GridViewColumnVector, ListViewClick, ListViewSelectVector } from './list-view.js';
+export { TREE_EXPANDER_LAYOUT_VECTORS, TREE_EXPANDER_SHORTCUT_VECTORS } from './tree-expander.js';
+export type { TreeExpanderLayoutVector, TreeExpanderShortcutVector } from './tree-expander.js';
+export { BOX_ALL_VECTORS, BOX_ROW_VECTORS, BOX_SELECT_VECTORS } from './box-selection.js';
+export type { BoxAllVector, BoxRowVector, BoxSelectVector } from './box-selection.js';
+export { CALENDAR_DAYS_VECTORS, CALENDAR_MARK_VECTORS, CALENDAR_NAVIGATION_VECTORS, CALENDAR_SELECT_VECTORS, CALENDAR_STEP_VECTORS, CALENDAR_WEEK_VECTORS, } from './calendar.js';
+export type { CalendarDaysVector, CalendarMarkVector, CalendarNavigationVector, CalendarSelectVector, CalendarStepVector, CalendarWeekVector, } from './calendar.js';
 export { MENU_DETAILED_ACTION_VECTORS, MENU_FLATTEN_VECTORS, MENU_ITEM_STATE_VECTORS, MENU_NORMALIZE_VECTORS, MENU_PARSE_VECTORS, MENU_REFUSAL_VECTORS, } from './menu.js';
 export type { MenuDetailedActionVector, MenuFlatRowVector, MenuFlattenVector, MenuItemStateVector, MenuNormalizeVector, MenuParseVector, MenuRefusalVector, } from './menu.js';
-export { INLINE_TOGGLE_VECTORS, INLINE_TOOLTIP_VECTORS, VIEW_SWITCHER_BADGE_VECTORS, VIEW_SWITCHER_BAR_REVEAL_VECTORS, VIEW_SWITCHER_BAR_VECTORS, VIEW_SWITCHER_BUTTON_VECTORS, VIEW_SWITCHER_BUTTON_VISIBILITY_VECTORS, VIEW_SWITCHER_DRAG_VECTORS, VIEW_SWITCHER_ICON_VECTORS, VIEW_SWITCHER_MNEMONIC_VECTORS, VIEW_SWITCHER_REBUILD_VECTORS, VIEW_SWITCHER_SELECTION_VECTORS, createViewSwitcherClock, } from './view-switcher.js';
-export type { ExpectedInlineToggle, ExpectedViewSwitcherButton, InlineToggleVector, InlineTooltipVector, MnemonicVector, ViewSwitcherBadgeVector, ViewSwitcherBarRevealVector, ViewSwitcherBarSnapshot, ViewSwitcherBarStep, ViewSwitcherBarVector, ViewSwitcherButtonVector, ViewSwitcherButtonVisibilityVector, ViewSwitcherClock, ViewSwitcherDragStep, ViewSwitcherDragVector, ViewSwitcherIconVector, ViewSwitcherRebuildVector, ViewSwitcherSelectionVector, ViewSwitcherVectorChange, ViewSwitcherVectorOp, ViewSwitcherVectorPage, } from './view-switcher.js';
-export { TABS_REVEALED_VECTORS, TAB_CLOSE_VISIBLE_VECTORS, TAB_DESCENDANT_VECTORS, TAB_ICON_STATE_VECTORS, TAB_PAGE_DESCRIPTOR_VECTORS, TAB_SUCCESSOR_VECTORS, TAB_TOOLTIP_VECTORS, TAB_VIEW_VECTORS, applyTabViewOp, seedTabViewPages, tabViewClosing, tabViewOrder, } from './tab-view.js';
-export type { TabCloseVisibleVector, TabDescendantVector, TabIconStateVector, TabPageDescriptorVector, TabSuccessorVector, TabTooltipVector, TabViewVector, TabViewVectorHandler, TabViewVectorOp, TabViewVectorPage, TabViewVectorPagesChange, TabViewVectorSelection, TabViewVectorTarget, TabsRevealedVector, } from './tab-view.js';
+export { INLINE_TOGGLE_VECTORS, INLINE_TOOLTIP_VECTORS, VIEW_SWITCHER_BADGE_VECTORS, VIEW_SWITCHER_SIDEBAR_SECTION_VECTORS, VIEW_SWITCHER_BAR_REVEAL_VECTORS, VIEW_SWITCHER_BAR_VECTORS, VIEW_SWITCHER_BUTTON_VECTORS, VIEW_SWITCHER_BUTTON_VISIBILITY_VECTORS, VIEW_SWITCHER_DRAG_VECTORS, VIEW_SWITCHER_ICON_VECTORS, VIEW_SWITCHER_MNEMONIC_VECTORS, VIEW_SWITCHER_REBUILD_VECTORS, VIEW_SWITCHER_SELECTION_VECTORS, createViewSwitcherClock, } from './view-switcher.js';
+export type { ExpectedInlineToggle, ExpectedViewSwitcherButton, InlineToggleVector, InlineTooltipVector, MnemonicVector, ViewSwitcherBadgeVector, ViewSwitcherSidebarSectionVector, ViewSwitcherBarRevealVector, ViewSwitcherBarSnapshot, ViewSwitcherBarStep, ViewSwitcherBarVector, ViewSwitcherButtonVector, ViewSwitcherButtonVisibilityVector, ViewSwitcherClock, ViewSwitcherDragStep, ViewSwitcherDragVector, ViewSwitcherIconVector, ViewSwitcherRebuildVector, ViewSwitcherSelectionVector, ViewSwitcherVectorChange, ViewSwitcherVectorOp, ViewSwitcherVectorPage, } from './view-switcher.js';
+export { TABS_REVEALED_VECTORS, TAB_CLOSE_VISIBLE_VECTORS, TAB_DESCENDANT_VECTORS, TAB_ICON_STATE_VECTORS, TAB_PAGE_DESCRIPTOR_VECTORS, TAB_SEARCH_VECTORS, TAB_SUCCESSOR_VECTORS, TAB_TOOLTIP_VECTORS, TAB_VIEW_VECTORS, applyTabViewOp, seedTabViewPages, tabViewClosing, tabViewOrder, } from './tab-view.js';
+export type { TabCloseVisibleVector, TabDescendantVector, TabIconStateVector, TabPageDescriptorVector, TabSearchVector, TabSuccessorVector, TabTooltipVector, TabViewVector, TabViewVectorHandler, TabViewVectorOp, TabViewVectorPage, TabViewVectorPagesChange, TabViewVectorSelection, TabViewVectorTarget, TabsRevealedVector, } from './tab-view.js';
+export { GRID_NAVIGATION_GEOMETRY, GRID_NAVIGATION_VECTORS } from './grid-navigation.js';
+export type { GridNavigationVector } from './grid-navigation.js';
 export { CAROUSEL_CLAMP_VECTORS, CAROUSEL_NAVIGATE_VECTORS, CAROUSEL_PAGE_ALLOCATION_VECTORS, CAROUSEL_PAGE_AT_POSITION_VECTORS, CAROUSEL_PAGE_LIST_VECTORS, CAROUSEL_PROPERTY_DEFAULT_VECTORS, CAROUSEL_RANGE_VECTORS, CAROUSEL_REORDER_SHIFT_VECTORS, CAROUSEL_REVEAL_VECTORS, CAROUSEL_SIZES_FROM_SNAP_POINTS_VECTORS, CAROUSEL_SNAP_POINT_VECTORS, CAROUSEL_WHEEL_LOCKOUT_VECTORS, CAROUSEL_WHEEL_VECTORS, } from './carousel.js';
 export type { CarouselClampVector, CarouselNavigateVector, CarouselPageAllocationVector, CarouselPageAtPositionVector, CarouselPageListVector, CarouselPageOp, CarouselPropertyDefaultVector, CarouselRangeVector, CarouselReorderShiftVector, CarouselRevealOp, CarouselRevealVector, CarouselSizesFromSnapPointsVector, CarouselSnapPointVector, CarouselStateSnapshot, CarouselWheelLockoutStep, CarouselWheelLockoutVector, CarouselWheelVector, } from './carousel.js';
 export { DATA_GRID_CELL_TEXT_VECTORS, DATA_GRID_COLUMN_CLASS_VECTORS, DATA_GRID_COLUMN_NORMALIZE_VECTORS, DATA_GRID_INTERACTIVE_VECTORS, DATA_GRID_TRACK_VECTORS, DATA_GRID_VARIANT_VECTORS, } from './data-grid.js';
@@ -72,3 +82,5 @@ export { VALUE_LIST_VECTORS } from './value-lists.js';
 export type { ValueListResponse, ValueListVector } from './value-lists.js';
 export { SHARED_TREE_BLOCKS_WITHOUT_EXPECTATIONS, SHARED_TREE_TABLES, authoredNodes, authoredTags, reachedTables, sharedTreeExpectations, sharedTreePlacements, subjectIndexOf, withoutPlacements, } from './shared-trees.js';
 export type { SharedTreeExpectation, SharedTreeNode, SharedTreeObservable, SharedTreePlacement, } from './shared-trees.js';
+export { CONSTRUCT_KINDS, BREAKPOINT_VECTOR_SIZES, EXTERN_VECTOR_CLASS, CONSTRUCT_VECTORS, UnsupportedConstructError, assertTreeConstructs, constructUsesOf, driveConstructVectors, } from './constructs.js';
+export type { ConstructCapabilities, ConstructCapability, ConstructHarness, ConstructKind, ConstructRenderer, ConstructUse, ConstructVector, } from './constructs.js';

package/lib/types/conformance/list-view.d.ts

@@ -0,0 +1,56 @@
+import type { AdwColumnViewSort, AdwListSelectionMode } from '../list-view.js';
+/** One click on a row, with the two modifiers GTK reads off the event. */
+export interface ListViewClick {
+    /** The row that was clicked. */
+    readonly position: number;
+    /** `<Ctrl>` — toggle rather than replace. */
+    readonly modify?: boolean;
+    /** `<Shift>` — extend from the anchor. */
+    readonly extend?: boolean;
+}
+/** One selection scenario: a fresh view of `length` rows, then these clicks. */
+export interface ListViewSelectVector {
+    /** What the row establishes, in one sentence. */
+    readonly rule: string;
+    /** Which `Gtk.SelectionModel` the view behaves as. */
+    readonly mode: AdwListSelectionMode;
+    /** How many items the model holds. */
+    readonly length: number;
+    /** The clicks, in order, from an empty selection. */
+    readonly clicks: readonly ListViewClick[];
+    /** The positions selected afterwards, ascending. */
+    readonly selection: readonly number[];
+}
+export declare const LIST_VIEW_SELECT_VECTORS: readonly ListViewSelectVector[];
+/** One column-count scenario — the four inputs `gtk_grid_view_compute_n_columns` takes. */
+export interface GridViewColumnVector {
+    /** What the row establishes, in one sentence. */
+    readonly rule: string;
+    /** The size available along the reflow axis, in px. */
+    readonly forSize: number;
+    /** One item's size along the same axis, in px. */
+    readonly itemSize: number;
+    /** The gap between two items, in px. */
+    readonly spacing: number;
+    /** `GtkGridView:min-columns`. */
+    readonly minColumns: number;
+    /** `GtkGridView:max-columns`. */
+    readonly maxColumns: number;
+    /** How many columns the view lays out. */
+    readonly columns: number;
+}
+export declare const GRID_VIEW_COLUMN_VECTORS: readonly GridViewColumnVector[];
+/** One header click: the sort before it, the column clicked, the sort after. */
+export interface ColumnViewSortVector {
+    /** What the row establishes, in one sentence. */
+    readonly rule: string;
+    /** The sort in force before the click. */
+    readonly current: AdwColumnViewSort | null;
+    /** The clicked column's id. */
+    readonly column: string;
+    /** Whether that column declares a sorter at all. */
+    readonly sortable: boolean;
+    /** The sort in force afterwards. */
+    readonly next: AdwColumnViewSort | null;
+}
+export declare const COLUMN_VIEW_SORT_VECTORS: readonly ColumnViewSortVector[];

package/lib/types/conformance/shared-trees.d.ts

@@ -33,6 +33,15 @@ export interface SharedTreeNode {
      * projection can be held against each other on it — and are, by stage D's addressing arm.
      */
     template?: string;
+    /**
+     * `tag` is a class the APPLICATION registers (`$SourceView`), in no GIR (ADR 0093).
+     *
+     * The tag is spelled as the `.blp` spells it, without a namespace default, and a renderer
+     * resolves it in its own `registerTemplateClass` registry instead of in the toolkit's class
+     * list. An unregistered name is a refusal that names it. What the registered class builds
+     * inside itself is its own business: typically its own `.blp?shared-tree`.
+     */
+    extern?: true;
     /**
      * Where in the parent this child goes — the placement, spelled as the GTK side spells it.
      *
@@ -55,6 +64,23 @@ export interface SharedTreeNode {
      */
     slot?: string;
     props?: Readonly<Record<string, string | number | boolean>>;
+    /**
+     * What a `Gtk.Notebook` or `Gtk.Stack` needs to know about THIS child as one of its pages.
+     *
+     * A page is not a widget: `GtkNotebookPage` and `GtkStackPage` are GObjects with no tag
+     * (gtknotebook.c:423, gtkstack.c:212), so their `tab-label` / `title` / `name` have no node
+     * to live on. They are data on the child, the way a grid cell is. `label` is the notebook's
+     * tab text and the stack's page title; `name` is the stack page's address. A notebook child
+     * with no `page` is numbered by GTK ("Page 3"), which is the page with no label.
+     *
+     * A renderer whose parent has no page concept REFUSES it by name rather than dropping it: a
+     * stack page with no name lands at exit 0 as a child nobody can switch to. Which renderers
+     * build it is each one's own answer (ADR 0093 § 2), not a rule of this shape.
+     */
+    page?: Readonly<{
+        label?: string;
+        name?: string;
+    }>;
     /**
      * Which of this node's `props` are marked for translation, keyed by the prop name.
      *
@@ -119,6 +145,50 @@ export interface SharedTreeNode {
             readonly enabled?: boolean;
         }[];
     }>;
+    /**
+     * The `layout { }` block: properties of the child's PLACEMENT in a layout manager
+     * (`GtkGridLayoutChild`'s `row`, `column`, `row-span`, `column-span`), as the source wrote
+     * them (ADR 0092). Never typed against the widget, so an identifier stays its spelling.
+     */
+    layout?: Readonly<Record<string, string | number | boolean>>;
+    /**
+     * The signal handlers this node binds (`clicked => $onClicked()`), in source order and spelled
+     * as the `.blp` wrote them (ADR 0093).
+     *
+     * `handler` is a NAME, never code: the builder resolves it against a scope object it is
+     * handed, as `Gtk.BuilderScope` does, and a missing handler is a refusal. `name` and `detail`
+     * are the two halves of `notify::sensitive`. `object` is the `(obj)` the handler is swapped
+     * with. A renderer that has not verified `swapped`, `after`, `not-swapped` or `object` refuses
+     * them by name rather than binding a handler that fires differently from GTK's.
+     */
+    signals?: readonly {
+        readonly name: string;
+        readonly detail?: string;
+        readonly handler: string;
+        readonly object?: string;
+        readonly flags?: readonly ('swapped' | 'after' | 'not-swapped')[];
+    }[];
+    /**
+     * The simple `bind`s, keyed by the TARGET property (ADR 0093): one source, one property, the
+     * flags as written. `source` is an object id in this tree, or `template` for the component
+     * itself. An expression form (lookup chain, closure, cast pair, `expr`) is not carried.
+     */
+    bindings?: Readonly<Record<string, {
+        readonly source: string;
+        readonly property: string;
+        readonly flags?: readonly ('bidirectional' | 'inverted' | 'no-sync-create')[];
+    }>>;
+    breakpoints?: readonly {
+        readonly condition: string;
+        readonly setters: readonly {
+            readonly object: string;
+            readonly property: string;
+            readonly value: string | number | boolean;
+            readonly translatable?: {
+                context?: string;
+            };
+        }[];
+    }[];
     children?: readonly SharedTreeNode[];
 }
 /**

package/lib/types/conformance/tab-view.d.ts

@@ -406,3 +406,32 @@ export interface TabPageDescriptorVector {
  * CORE-ONLY: GAP — a descriptor normaliser neither element routes its page input through. Tracked in #1072
  */
 export declare const TAB_PAGE_DESCRIPTOR_VECTORS: ReadonlyArray<TabPageDescriptorVector>;
+/** One `tabSearchMatches` expectation. */
+export interface TabSearchVector {
+    /** `AdwTabPage:title`. */
+    title: string;
+    /** `AdwTabPage:tooltip`. */
+    tooltip: string;
+    /** `AdwTabPage:keyword`. */
+    keyword: string;
+    /** What `AdwTabGrid`'s search entry holds. */
+    terms: string;
+    matches: boolean;
+    rule: string;
+}
+/**
+ * `AdwTabGrid`'s search: three `GtkStringFilter`s over the page's `title`,
+ * `tooltip` and `keyword`, ANDed by a `GtkMultiFilter`
+ * (adw-tab-grid.c:3532-3547), each with the `GtkStringFilter` defaults —
+ * SUBSTRING match, case folding, `G_NORMALIZE_ALL` on both sides
+ * (gtkstringfilter.c:276,297).
+ *
+ * The rule that a hand-written copy gets wrong is the EMPTY property: matching it
+ * would make every page with no tooltip match every term, because "no tooltip" is
+ * not a substring of anything.
+ *
+ * Reference: refs/libadwaita/src/adw-tab-grid.c:3532-3547 (the three filters)
+ * Reference: refs/gtk/gtk/gtkstringfilter.c:70-138 (prepare, has_search, match)
+ * Copyright (c) GNOME contributors (libadwaita). LGPLv2.1+.
+ */
+export declare const TAB_SEARCH_VECTORS: ReadonlyArray<TabSearchVector>;

package/lib/types/conformance/tree-expander.d.ts

@@ -0,0 +1,29 @@
+import type { AdwTreeExpanderAction, AdwTreeExpanderIcon, AdwTreeExpanderKeyState, AdwTreeExpanderOptions, AdwTreeExpanderRow } from '../tree-expander.js';
+/** One row under one set of the three properties, and the subtree it draws. */
+export interface TreeExpanderLayoutVector {
+    /** What the row establishes, in one sentence. */
+    readonly rule: string;
+    /** What the `Gtk.TreeListRow` says, or null for an expander with no row. */
+    readonly row: AdwTreeExpanderRow | null;
+    /** The three `Gtk.TreeExpander` properties, GTK's defaults where absent. */
+    readonly options: AdwTreeExpanderOptions;
+    /** How many `indent` nodes precede the expander and the child. */
+    readonly indents: number;
+    /** What the `expander` node is, or `none` where the row draws none. */
+    readonly expander: AdwTreeExpanderIcon;
+    /** `GTK_ACCESSIBLE_PROPERTY_LEVEL`, which the C notes "is >= 1". */
+    readonly level: number;
+}
+export declare const TREE_EXPANDER_LAYOUT_VECTORS: readonly TreeExpanderLayoutVector[];
+/** One key press under one modifier state, and the action it asks for. */
+export interface TreeExpanderShortcutVector {
+    /** What the row establishes, in one sentence. */
+    readonly rule: string;
+    /** The `KeyboardEvent.key` value. */
+    readonly key: string;
+    /** The modifiers and the text direction. */
+    readonly state: AdwTreeExpanderKeyState;
+    /** The `listitem.*` action, or `none`. */
+    readonly action: AdwTreeExpanderAction;
+}
+export declare const TREE_EXPANDER_SHORTCUT_VECTORS: readonly TreeExpanderShortcutVector[];

package/lib/types/conformance/view-switcher.d.ts

@@ -373,3 +373,28 @@ export interface ViewSwitcherClock extends ViewSwitcherScheduler {
  * drag surface and drives none of these rows.
  */
 export declare function createViewSwitcherClock(): ViewSwitcherClock;
+/** One `viewSwitcherSidebarSections` row: a page list in, section titles out. */
+export interface ViewSwitcherSidebarSectionVector {
+    /** Page names, comma-joined, in stack order. */
+    pages: string;
+    /** Page names that open a section, comma-joined. */
+    starts: string;
+    /** One `title` per resulting section, comma-joined (`-` for an empty heading). */
+    sections: string;
+    /** Page names per resulting section, groups separated by `/`. */
+    groups: string;
+    rule: string;
+}
+/**
+ * `populate_sidebar` (adw-view-switcher-sidebar.c:225-243): the grouping that makes
+ * `AdwViewSwitcherSidebar` different from every other Adw switcher.
+ *
+ * The rule a hand-written copy gets wrong is the FIRST page: C's condition is
+ * `if (!section || adw_view_stack_page_get_starts_section (page))`, so the first page
+ * opens a section whatever its `starts-section` says — a stack of four pages where only
+ * the last one starts a section yields TWO sections, not one section of four.
+ *
+ * Reference: refs/libadwaita/src/adw-view-switcher-sidebar.c:225-243
+ * Copyright (c) 2025 GNOME Foundation Inc. (libadwaita). LGPLv2.1-or-later.
+ */
+export declare const VIEW_SWITCHER_SIDEBAR_SECTION_VECTORS: ReadonlyArray<ViewSwitcherSidebarSectionVector>;

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

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

package/lib/types/grid-navigation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * How many items share the first row, from each item's top edge in visual order. Items
+ * whose tops differ by at most `tolerance` are one row (sub-pixel layout rounds).
+ * Always at least 1 for a non-empty grid, 0 for an empty one.
+ */
+export declare function gridColumns(tops: readonly number[], tolerance?: number): number;
+/**
+ * The index a key moves to, or `null` when the key is not a grid key or the move would
+ * leave the grid. `columns` below 1 is treated as 1.
+ */
+export declare function gridNavigate(key: string, index: number, count: number, columns: number): number | null;

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

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

package/lib/types/index.d.ts

@@ -29,6 +29,14 @@ export { AdwAlertResponses, BottomSheetPresentation, resolveBottomSheetChrome, r
 export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, BottomSheetChrome, BottomSheetChromeState, BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetCloseState, BottomSheetLayer, BottomSheetOpenOutcome, BottomSheetOpenSource, BottomSheetOpenState, BottomSheetPresentationListener, BottomSheetPresentationOptions, BottomSheetSwipeTrackerConfig, BottomSheetSwipeTrackerState, BottomSheetTeardownCallback, OrderedConfirmResponses, } from './dialog.js';
 export { ADW_COMBO_NO_SELECTION, clampListSelection, listItemsChanged, normalizeComboOptions, parseListModel, } from './list.js';
 export type { AdwComboOption, AdwComboOptionInput, AdwListItemsChanged, AdwListModel, AdwListModelInput, } from './list.js';
+export { ADW_COLUMN_VIEW_NO_FIXED_WIDTH, ADW_GRID_VIEW_MAX_COLUMNS, ADW_GRID_VIEW_MIN_COLUMNS, columnViewSort, columnViewTracks, gridViewColumns, listItemField, listViewSelect, listViewSelectAll, ListViewState, normalizeColumnViewColumns, normalizeListSelectionMode, parseColumnViewColumns, } from './list-view.js';
+export type { AdwColumnViewColumn, AdwColumnViewSort, AdwListItemContext, AdwListItemFactory, AdwListItemField, AdwListSelectStep, AdwListSelection, AdwListSelectionMode, AdwListSelectResult, ListViewItemsListener, ListViewSelectionChange, ListViewSelectionListener, } from './list-view.js';
+export { treeExpanderAction, treeExpanderExpanded, treeExpanderLayout } from './tree-expander.js';
+export type { AdwTreeExpanderAction, AdwTreeExpanderIcon, AdwTreeExpanderKeyState, AdwTreeExpanderLayout, AdwTreeExpanderOptions, AdwTreeExpanderRow, } from './tree-expander.js';
+export { listBoxSelect, listBoxSelectAll, listBoxSelectRow, listBoxUnselectAll, listBoxUnselectRow, normalizeBoxSelectionMode, } from './box-selection.js';
+export type { AdwBoxSelectResult, AdwBoxSelection, AdwBoxSelectionMode, AdwBoxSelectStep } from './box-selection.js';
+export { CALENDAR_MARK_MAX, CALENDAR_MARK_MIN, CALENDAR_YEAR_MAX, CALENDAR_YEAR_MIN, calendarClearMarks, calendarDayIsMarked, calendarDays, calendarDaysInMonth, calendarIsLeapYear, calendarMarkDay, calendarNavigationButtons, calendarSelectDay, calendarStep, calendarWeekNumber, calendarWeekStart, } from './calendar.js';
+export type { AdwCalendarCell, AdwCalendarCellMonth, AdwCalendarDate, AdwCalendarNavigation, AdwCalendarSelectResult, AdwCalendarStep, } from './calendar.js';
 export { ADW_ADJUSTMENT_DEFAULTS, adjustmentRange, clampAdjustmentValue, normalizeAdjustment, parseAdjustment, snapAdjustmentValue, SpinState, } from './adjustment.js';
 export type { AdwAdjustment, AdwAdjustmentInput, SpinStateChange, SpinStateListener, SpinStateRangeListener, } from './adjustment.js';
 export { GtkAdjustment } from './gtk-adjustment.js';
@@ -66,10 +74,11 @@ export type { AdwArrowIcon, SplitButtonChange, SplitButtonContentMode, SplitButt
 export { GioMenu, GioMenuItem } from './gio-menu.js';
 export { ADW_MENU_SURFACE_NATIVESCRIPT, ADW_MENU_SURFACE_WEB, assertMenuRenderable, flattenMenu, menuItemAt, menuNodeAt, menuRefusals, normalizeMenuModel, parseDetailedAction, parseMenuModel, resolveMenuItemState, } from './menu.js';
 export type { AdwDetailedAction, AdwMenuAction, AdwMenuActions, AdwMenuDisplayHint, AdwMenuEntryInput, AdwMenuFlatRow, AdwMenuHiddenWhen, AdwMenuInput, AdwMenuItem, AdwMenuItemInput, AdwMenuItemRole, AdwMenuItemState, AdwMenuModel, AdwMenuNode, AdwMenuPath, AdwMenuRefusal, AdwMenuSection, AdwMenuSectionInput, AdwMenuSubmenu, AdwMenuSubmenuInput, AdwMenuSurface, AdwMenuTextDirection, } from './menu.js';
-export { DEFAULT_INDICATOR_DESCRIPTION_STRINGS, INLINE_VIEW_SWITCHER_DISPLAY_MODES, VIEW_SWITCHER_BADGE_LIMIT, VIEW_SWITCHER_DRAG_SWITCH_DELAY, VIEW_SWITCHER_FALLBACK_ICON, VIEW_SWITCHER_NO_SELECTION, VIEW_SWITCHER_POLICIES, ViewSwitcherBarState, ViewSwitcherDragSwitch, ViewSwitcherState, buildInlineToggles, buildViewSwitcherButtons, createViewSwitcherPage, inlineToggleTooltip, isInlineViewSwitcherDisplayMode, isViewSwitcherButtonVisible, isViewSwitcherPolicy, pageIndexForToggle, shouldRevealViewSwitcherBar, stripMnemonic, toggleIndexForPage, viewSwitcherBadgeLabel, viewSwitcherButtonOrientation, viewSwitcherIconName, viewSwitcherIndicatorDescription, viewSwitcherLabel, viewSwitcherPageFromStackPage, viewSwitcherPagesFromStack, } from './view-switcher.js';
-export type { AdwInlineViewSwitcherDisplayMode, AdwViewSwitcherPage, AdwViewSwitcherPageInit, AdwViewSwitcherPolicy, IndicatorDescriptionStrings, InlineToggleModel, ViewSwitcherBarChange, ViewSwitcherBarListener, ViewSwitcherButtonModel, ViewSwitcherDragSwitchOptions, ViewSwitcherScheduler, ViewSwitcherStateChange, ViewSwitcherStateListener, ViewSwitcherStateOptions, ViewSwitcherTimerHandle, } from './view-switcher.js';
-export { DEFAULT_TAB_AUTOHIDE, TabViewState, isDescendantOfPage, successorAfterClose, tabCloseVisible, tabIconState, tabTooltip, tabTooltipIsMarkup, tabViewItemsChanged, tabsRevealed, } from './tab-view.js';
+export { DEFAULT_INDICATOR_DESCRIPTION_STRINGS, INLINE_VIEW_SWITCHER_DISPLAY_MODES, VIEW_SWITCHER_BADGE_LIMIT, VIEW_SWITCHER_DRAG_SWITCH_DELAY, VIEW_SWITCHER_FALLBACK_ICON, VIEW_SWITCHER_NO_SELECTION, VIEW_SWITCHER_POLICIES, ViewSwitcherBarState, ViewSwitcherDragSwitch, ViewSwitcherState, buildInlineToggles, buildViewSwitcherButtons, createViewSwitcherPage, inlineToggleTooltip, isInlineViewSwitcherDisplayMode, isViewSwitcherButtonVisible, isViewSwitcherPolicy, pageIndexForToggle, shouldRevealViewSwitcherBar, stripMnemonic, toggleIndexForPage, viewSwitcherBadgeLabel, viewSwitcherButtonOrientation, viewSwitcherIconName, viewSwitcherIndicatorDescription, viewSwitcherLabel, viewSwitcherPageFromStackPage, viewSwitcherPagesFromStack, viewSwitcherSidebarSections, } from './view-switcher.js';
+export type { AdwInlineViewSwitcherDisplayMode, AdwViewSwitcherPage, AdwViewSwitcherPageInit, AdwViewSwitcherPolicy, IndicatorDescriptionStrings, InlineToggleModel, ViewSwitcherBarChange, ViewSwitcherBarListener, ViewSwitcherButtonModel, ViewSwitcherDragSwitchOptions, ViewSwitcherScheduler, ViewSwitcherSidebarSection, ViewSwitcherStateChange, ViewSwitcherStateListener, ViewSwitcherStateOptions, ViewSwitcherTimerHandle, } from './view-switcher.js';
+export { DEFAULT_TAB_AUTOHIDE, TabViewState, isDescendantOfPage, successorAfterClose, tabCloseVisible, tabIconState, tabSearchMatches, tabTooltip, tabTooltipIsMarkup, tabViewItemsChanged, tabsRevealed, } from './tab-view.js';
 export type { AdwTabPageSpec, AdwTabPageState, TabIconState, TabViewHandlers, TabViewPagesChange, TabViewPagesChangeKind, TabViewPagesListener, TabViewSelectionChange, TabViewSelectionListener, } from './tab-view.js';
+export { gridColumns, gridNavigate } from './grid-navigation.js';
 export { ADW_SWIPE_DECELERATION_TOUCH, ADW_SWIPE_DECELERATION_TOUCHPAD, ADW_SWIPE_DRAG_THRESHOLD, ADW_SWIPE_EPSILON, ADW_SWIPE_HISTORY_THRESHOLD_MS, ADW_SWIPE_PARABOLA_MULTIPLIER, ADW_SWIPE_TOUCHPAD_BASE_DISTANCE_H, ADW_SWIPE_TOUCHPAD_BASE_DISTANCE_V, ADW_SWIPE_VELOCITY_CURVE_THRESHOLD, ADW_SWIPE_VELOCITY_THRESHOLD_TOUCH, ADW_SWIPE_VELOCITY_THRESHOLD_TOUCHPAD, SwipeTracker, swipeBounds, swipeClosestPointIndex, swipeEndProgress, swipeNextPointIndex, swipePreviousPointIndex, swipeProjectedPointIndex, swipeSlope, swipeVelocityThreshold, } from './swipe.js';
 export type { AdwSwipeEnd, AdwSwipeEndInput, AdwSwipeRange, AdwSwipeSource } from './swipe.js';
 export { CAROUSEL_SCROLL_TIMEOUT_MS, CAROUSEL_SETTLE_EPSILON, CarouselState, carouselClampPosition, carouselClosestSnapPoint, carouselNavigateTarget, carouselPageAllocation, carouselPageAtPosition, carouselRange, carouselReorderShift, carouselSizesFromSnapPoints, carouselSnapPoints, carouselWheelStep, } from './carousel.js';
@@ -79,6 +88,8 @@ export type { CaseFolder, MakeComparableOptions, PreferencesGroupHeaderInput, Pr
 export { ADW_CLAMP_DEFAULTS, ADW_CLAMP_SIZE_CLASSES, ADW_SPINNER_MAX_SIZE, ADW_SPINNER_MIN_SIZE, ADW_TOOLBAR_BAR_CLASSES, ADW_TOOLBAR_VIEW_CLASSES, ADW_TOOLBAR_VIEW_DEFAULTS, clampAllocate, clampChildSize, clampSizeFromChild, clampThresholds, normalizeClampSize, parseToolbarStyle, resolveSpinnerSize, spinnerGeometry, toolbarBarStyleClasses, toolbarViewAllocate, toolbarViewClasses, toolbarViewContentForSize, toolbarViewMeasure, } from './chrome.js';
 export type { AdwClampSizeClass, AdwMeasurement, AdwToolbarStyle, ClampAllocation, ClampParams, ClampThresholds, SpinnerGeometry, ToolbarViewAllocateInput, ToolbarViewAllocation, ToolbarViewClassInput, ToolbarViewClasses, ToolbarViewContentForSize, ToolbarViewContentForSizeInput, ToolbarViewMeasureInput, } from './chrome.js';
 export { BreakpointBinState } from './breakpoint-bin.js';
+export { createBreakpointDriver } from './breakpoint-driver.js';
+export type { BreakpointDriver, BreakpointDriverDefinition, BreakpointDriverIo, BreakpointDriverSetter, } from './breakpoint-driver.js';
 export type { BreakpointDefinition, BreakpointSetter, BreakpointTransition, BreakpointWrite, } from './breakpoint-bin.js';
 export { HeaderBarState, resolveHeaderBarTitle } from './header-bar.js';
 export type { HeaderBarRenderState, HeaderBarTitleSources } from './header-bar.js';