@gjsify/adwaita-core 0.47.0 → 0.49.0

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

@@ -0,0 +1,93 @@
+/** One node of an authored tree — the shape `ADWAITA_GALLERY_SHARED_TREES` is written in. */
+export interface SharedTreeNode {
+    /** A GIR class name, e.g. `AdwPreferencesGroup`. */
+    tag: string;
+    slot?: string;
+    props?: Readonly<Record<string, string | number | boolean>>;
+    children?: readonly SharedTreeNode[];
+}
+/**
+ * What a renderer must be able to READ off the widget it built.
+ *
+ * A closed vocabulary on purpose: it is the seam between this renderer-free module and the
+ * per-renderer drivers, and an open one would let a driver answer a question nobody else
+ * answers. Each name says WHICH widget and WHICH observation, never how to make it.
+ */
+export type SharedTreeObservable = 
+/** `adw_entry_row_get_text_length` — characters, not UTF-16 units. */
+'entry-text-length'
+/** `Adw.SwitchRow:active` after the tree's own write. */
+ | 'switch-row-active'
+/** Whether the banner's action button is on screen. */
+ | 'banner-button-visible'
+/** The text painted in the banner's action button, after mnemonic resolution. */
+ | 'banner-button-text';
+/** One vector row an authored node instantiates, addressed to the renderer that built it. */
+export interface SharedTreeExpectation {
+    /** Pre-order address inside the block, e.g. `AdwPreferencesGroup > AdwSwitchRow[1]`. */
+    path: string;
+    /** The GIR class of the node this is about. */
+    gtype: string;
+    /** The conformance table the row comes from — the name, so a failure cites its source. */
+    table: string;
+    observable: SharedTreeObservable;
+    expected: string | number | boolean;
+    /** The row's own `rule`, which is also the test title. */
+    rule: string;
+}
+/**
+ * The tables this module joins an authored tree against.
+ *
+ * NAMED IN CODE rather than in prose, because `check-adwaita-conformance-drivers.mjs` reads
+ * this list to decide which tables a tree driver drives. A table added here that no corpus
+ * node reaches fails the drivers' own suite — see `reachedTables` below, which is DERIVED
+ * from the corpus and not written down.
+ */
+export declare const SHARED_TREE_TABLES: readonly ["BANNER_BUTTON_TEXT_VECTORS", "BANNER_BUTTON_VISIBLE_VECTORS", "ENTRY_TEXT_LENGTH_VECTORS", "SWITCH_ROW_NOTIFY_VECTORS"];
+/**
+ * Blocks that reach NO vector row, with the measured reason — ADR 0051 § 4.
+ *
+ * A block in the corpus that proves nothing must SAY so, or the pass count reads as
+ * coverage it does not have. Self-retiring: a driver fails on a declared block that has
+ * started reaching a row, the same shape as arm 11's stale-divergence rule.
+ *
+ * A reason has to name the mechanism, not a consequence of it: the two below reach nothing
+ * for DIFFERENT reasons — one table is not joined, the other's rows do not match the
+ * authored values — and a declaration that blurs them is a silence nobody can retire.
+ */
+export declare const SHARED_TREE_BLOCKS_WITHOUT_EXPECTATIONS: Readonly<Record<string, string>>;
+/** Every authored node of `root`, in pre-order — the sequence a realised tree must reproduce. */
+export declare function authoredNodes(root: SharedTreeNode): {
+    node: SharedTreeNode;
+    path: string;
+}[];
+/**
+ * The authored classes a realised tree must carry, in authored order.
+ *
+ * `tagOf` is the renderer's own spelling of a GIR class name — `hostTagOf` on the web, the
+ * GIR name itself in GTK. Both drivers filter their real tree down to this list and compare
+ * against it, so it lives here rather than in each of them: a driver deriving it privately
+ * is a second walk, free to disagree with the one {@link subjectIndexOf} addresses into.
+ */
+export declare function authoredTags(root: SharedTreeNode, tagOf?: (gtype: string) => string): string[];
+/**
+ * Where the node an expectation is about sits in that filtered walk.
+ *
+ * The pre-order addresses are unique and the filter preserves them, so this index into
+ * {@link authoredTags} is also the index into the realised tree — which is why a driver may
+ * pick its subject by position instead of by hunting for the first widget of the class. Both
+ * halves of that are asserted on Node in `shared-trees.spec.ts`, before either renderer
+ * relies on them.
+ */
+export declare function subjectIndexOf(root: SharedTreeNode, path: string): number;
+/** Every vector row the tree rooted at `root` instantiates, in pre-order. */
+export declare function sharedTreeExpectations(root: SharedTreeNode): SharedTreeExpectation[];
+/**
+ * The tables the CORPUS actually reaches, derived from the trees themselves.
+ *
+ * The counterweight to {@link SHARED_TREE_TABLES}: that list is a claim about what this
+ * module joins, this is what the corpus delivers. A driver holding them against each other
+ * is what stops a table being listed as tree-driven while no tree touches it — the false
+ * coverage class `check-adwaita-conformance-drivers.mjs`'s three incidents are all about.
+ */
+export declare function reachedTables(roots: readonly SharedTreeNode[]): string[];

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

@@ -1,4 +1,5 @@
-import type { AdwArrowIcon, AdwMenuEntry, SplitButtonContentMode, SplitButtonDirection, SplitButtonHalfState, SplitButtonProperty, SplitButtonStyleClass } from '../split-button.js';
+import type { AdwMenuItem, AdwMenuModel, AdwMenuPath } from '../menu.js';
+import type { AdwArrowIcon, SplitButtonContentMode, SplitButtonDirection, SplitButtonHalfState, SplitButtonProperty, SplitButtonStyleClass } from '../split-button.js';
 /** One mutation in a {@link SplitButtonContentVector} sequence, with its outcome. */
 export interface SplitButtonContentStep {
     op: 'label' | 'icon-name' | 'child';
@@ -122,29 +123,18 @@ export interface SplitButtonRootStateVector {
  * CORE-ONLY: GAP — two of its three axes are hardcoded in the renderer, so there is nothing to vary. Tracked in #1072
  */
 export declare const SPLIT_BUTTON_ROOT_STATE_VECTORS: ReadonlyArray<SplitButtonRootStateVector>;
-/** One `parseMenuEntries` expectation. */
-export interface SplitButtonMenuParseVector {
-    /** The raw `menu` attribute (or `null` when absent). */
-    json: string | null;
-    entries: readonly AdwMenuEntry[];
-    rule: string;
-}
-/**
- * Menu-attribute parsing — the byte-identical helper both browser elements
- * carried. Total: nothing an author can type may prevent the widget upgrading.
- */
-export declare const SPLIT_BUTTON_MENU_PARSE_VECTORS: ReadonlyArray<SplitButtonMenuParseVector>;
 /** One activate-by-position expectation. */
 export interface SplitButtonMenuActivationVector {
-    entries: readonly AdwMenuEntry[];
-    index: number;
-    /** The entry that must be dispatched, or `null`. */
-    activated: AdwMenuEntry | null;
+    model: AdwMenuModel;
+    path: AdwMenuPath;
+    /** The item that must be dispatched, or `null`. */
+    activated: AdwMenuItem | null;
     rule: string;
 }
 /**
  * Activation is BY POSITION, never by label lookup: a `GMenuModel` addresses its
- * items by index and each carries its own detailed action.
+ * items by index and each carries its own detailed action. A PATH since ADR 0042,
+ * because a link is a model of its own and a flat index cannot name a nested item.
  */
 export declare const SPLIT_BUTTON_MENU_ACTIVATION_VECTORS: ReadonlyArray<SplitButtonMenuActivationVector>;
 /**
@@ -154,7 +144,7 @@ export declare const SPLIT_BUTTON_MENU_ACTIVATION_VECTORS: ReadonlyArray<SplitBu
  */
 export interface SplitButtonDropdownVector {
     /** The menu model to install (empty = none). */
-    entries: readonly AdwMenuEntry[];
+    model: AdwMenuModel;
     /** Whether a popover is installed before it. */
     popover: boolean;
     /** Whether the dropdown half is live. */

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@ export { ActionRowState, BUTTON_ROW_ACTIVATABLE, ButtonRowState, SwitchRowState,
 export type { ActionRowRenderState, AdwRowLabelInput, AdwRowLabels, ButtonRowRenderState, WindowTitleRenderState, } from './action-row.js';
 export { ADW_ABOUT_DIALOG_LABELS, ADW_CREDITS_SECTION_TITLES, ADW_LICENSES, ADW_LICENSE_ALIASES, ADW_LICENSE_DEFAULTS, ADW_LICENSE_WARRANTY_TEMPLATE, ADW_TRANSLATOR_CREDITS_SENTINELS, GTK_LICENSE, aboutDialogVisibility, creditsSections, isLicenseType, legalSectionVisible, licenseText, licenseTypeForSpdxId, parseCreditPerson, setLicense, setLicenseType, translatorCreditsPeople, } from './about-dialog.js';
 export type { AdwAboutDialogProps, AdwAboutDialogVisibility, AdwCreditPerson, AdwCreditsInput, AdwCreditsSection, AdwCreditsSectionInput, AdwLicenseAlias, AdwLicenseInfo, AdwLicenseNotify, AdwLicenseState, AdwLicenseTransition, AdwLicenseType, } from './about-dialog.js';
-export { AVATAR_COLOR_COUNT, AVATAR_COLORS, avatarColor, avatarColorClass, avatarFontSize, avatarInitials, avatarMaxFontSize, avatarMode, flattenAvatarGradient, gStrHash, randomAvatarColorClass, } from './avatar.js';
+export { AVATAR_COLOR_COUNT, AVATAR_COLORS, avatarColor, avatarColorClass, avatarFontSize, avatarIconSize, avatarInitials, avatarMaxFontSize, avatarMode, flattenAvatarGradient, gStrHash, randomAvatarColorClass, } from './avatar.js';
 export type { AdwAvatarColor, AdwAvatarMode } from './avatar.js';
 export { ADW_BANNER_BUTTON_STYLES, ADW_BANNER_BUTTON_STYLE_CLASSES, ADW_BANNER_DEFAULTS, bannerButtonStyleClasses, bannerButtonText, bannerButtonVisible, bannerRenderState, isBannerButtonStyle, parseBannerButtonStyle, } from './banner.js';
 export type { AdwBannerButtonStyle, AdwBannerProps, AdwBannerRenderState } from './banner.js';
@@ -24,8 +24,12 @@ export { AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT } from './toast.js';
 export type { AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, } from './toast.js';
 export { AdwAlertResponses, BottomSheetPresentation, resolveBottomSheetClose } from './dialog.js';
 export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetCloseState, BottomSheetPresentationListener, BottomSheetPresentationOptions, BottomSheetTeardownCallback, OrderedConfirmResponses, } from './dialog.js';
-export { ADW_COMBO_NO_SELECTION, ComboState, ExpanderState, SpinState, ToggleGroupState, normalizeComboOptions, } from './rows.js';
-export type { AdwComboOption, AdwComboOptionInput, ComboStateChange, ComboStateListener, ExpanderStateListener, SpinStateChange, SpinStateListener, ToggleGroupStateChange, ToggleGroupStateListener, } from './rows.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_ADJUSTMENT_DEFAULTS, adjustmentRange, clampAdjustmentValue, normalizeAdjustment, parseAdjustment, snapAdjustmentValue, SpinState, } from './adjustment.js';
+export type { AdwAdjustment, AdwAdjustmentInput, SpinStateChange, SpinStateListener, SpinStateRangeListener, } from './adjustment.js';
+export { ComboState, ExpanderState, ToggleGroupState } from './rows.js';
+export type { ComboItemsListener, ComboStateChange, ComboStateListener, ExpanderStateListener, ToggleGroupStateChange, ToggleGroupStateListener, } from './rows.js';
 export { glibClamp, gStrStrip, stringIsNotEmpty } from './glib.js';
 export { ViewStackState, normalizeIconName, resolvePageTitle } from './view-stack.js';
 export type { AdwViewStackPageInfo, AdwViewStackPageSpec, ViewStackStateChange, ViewStackStateListener, } from './view-stack.js';
@@ -44,11 +48,13 @@ export { ADW_LENGTH_UNITS, DEFAULT_DPI, adwLengthToPx, normalizeLengthUnit } fro
 export type { AdwLengthUnit } from './length-unit.js';
 export { ADW_SWIPE_BORDER, DEFAULT_MAX_SIDEBAR_WIDTH, DEFAULT_MIN_SIDEBAR_WIDTH, DEFAULT_SIDEBAR_WIDTH_FRACTION, DEFAULT_SIDEBAR_WIDTH_UNIT, INSTANT_SPLIT_VIEW_ANIMATOR, NAVIGATION_SPLIT_VIEW_CRITICALS, NavigationSplitViewState, OverlaySplitViewState, isSidebarAtVisualStart, layoutNavigationSplitView, layoutOverlaySplitView, measureSplitViewHorizontal, resolveNaturalSidebarWidth, resolveNavigationAction, resolveNavigationSidebarWidth, resolveNavigationStack, resolveOverlaySidebarWidth, resolveSidebarBounds, resolveSwipeArea, resolveSwipeRelease, resolveSwipeSnapPoints, resolveSwipeStart, swipeCancelProgress, tagsConflict, } from './split-view.js';
 export type { AdwPackType, AdwTextDirection, NavigationActionInput, NavigationActionResult, NavigationPageRef, NavigationSplitViewChange, NavigationSplitViewHandlers, NavigationSplitViewLayout, NavigationSplitViewListener, NavigationSplitViewOptions, NavigationSplitViewProperty, NavigationStackPlan, OverlaySplitViewChange, OverlaySplitViewLayout, OverlaySplitViewListener, OverlaySplitViewOptions, OverlaySplitViewProperty, SidebarBounds, SidebarWidthInput, SidebarWidthSpec, SplitViewAnimation, SplitViewAnimationRequest, SplitViewAnimator, SplitViewMeasureInput, SplitViewPane, SplitViewPaneRect, SwipeReleasePlan, } from './split-view.js';
-export { DEFAULT_DROPDOWN_TOOLTIP, SPLIT_BUTTON_DISABLED_OPACITY, SplitButtonState, isSplitButtonDirection, menuButtonArrowIcon, menuButtonPopupDirection, parseMenuEntries, resolveDropdownTooltip, splitButtonArrowIcon, splitButtonPopupDirection, splitButtonRootState, splitButtonStyleClasses, } from './split-button.js';
-export type { AdwArrowIcon, AdwMenuEntry, SplitButtonChange, SplitButtonContentMode, SplitButtonDirection, SplitButtonHalfState, SplitButtonListener, SplitButtonProperty, SplitButtonStyleClass, } from './split-button.js';
+export { DEFAULT_DROPDOWN_TOOLTIP, SPLIT_BUTTON_DISABLED_OPACITY, SplitButtonState, isSplitButtonDirection, menuButtonArrowIcon, menuButtonPopupDirection, resolveDropdownTooltip, splitButtonArrowIcon, splitButtonPopupDirection, splitButtonRootState, splitButtonStyleClasses, } from './split-button.js';
+export type { AdwArrowIcon, SplitButtonChange, SplitButtonContentMode, SplitButtonDirection, SplitButtonHalfState, SplitButtonListener, SplitButtonProperty, SplitButtonStyleClass, } from './split-button.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, tabsRevealed, } from './tab-view.js';
+export { DEFAULT_TAB_AUTOHIDE, TabViewState, isDescendantOfPage, successorAfterClose, tabCloseVisible, tabIconState, tabTooltip, tabTooltipIsMarkup, tabViewItemsChanged, tabsRevealed, } from './tab-view.js';
 export type { AdwTabPageSpec, AdwTabPageState, TabIconState, TabViewHandlers, TabViewPagesChange, TabViewPagesChangeKind, TabViewPagesListener, TabViewSelectionChange, TabViewSelectionListener, } from './tab-view.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';

package/lib/types/list.d.ts

@@ -0,0 +1,109 @@
+/** One selectable item — the display text plus the value it is addressed by. */
+export interface AdwComboOption {
+    /** Display label shown in the row + chooser. */
+    label: string;
+    /** Underlying value the item is addressed by. */
+    value: string;
+}
+/**
+ * What an author may write for one item before {@link normalizeComboOptions} has seen it:
+ * a bare string (value === label, the `Gtk.StringList` case), or a partial descriptor
+ * where either half may stand in for the other.
+ */
+export type AdwComboOptionInput = string | {
+    value?: unknown;
+    label?: unknown;
+};
+/** A normalised portable list model — what a `model` property holds on every surface. */
+export type AdwListModel = ReadonlyArray<AdwComboOption>;
+/** What a `model` property ACCEPTS: the widened form of {@link AdwListModel}. */
+export type AdwListModelInput = ReadonlyArray<AdwComboOptionInput>;
+/**
+ * Raw authored items → the stable `{ value, label }` descriptors every list surface
+ * works with.
+ *
+ * A bare string is both value and label (`Gtk.StringList`'s model, which is what
+ * `Adw.ComboRow` is fed in the common case). In a descriptor either half stands in for the
+ * missing other, so `{ label: 'Apple' }` is addressable by the value `'Apple'` rather than
+ * by `undefined`. ONE home for the rule, so no two list widgets can accept two different
+ * item vocabularies.
+ *
+ * TOTAL — it throws for no input. The doors this reaches are a property assignment and a
+ * markup attribute, and an author's typo must not take the widget down.
+ */
+export declare function normalizeComboOptions(raw: AdwListModelInput | null | undefined): AdwComboOption[];
+/**
+ * The MARKUP door: a JSON attribute → the normalised model.
+ *
+ * Total in both of its failure modes, which are different things and both an author slip:
+ * unparseable JSON and well-formed JSON that is not an array (an object, a number)
+ * each yield the empty model. Neither may stop the element upgrading — the reasoning
+ * `parseMenuModel` records for the same door on the same surfaces.
+ *
+ * It lives here rather than in each element because it was written twice, byte for byte,
+ * in `<adw-combo-row>` and `<gtk-drop-down>`: the second copy is where a helper is lifted.
+ */
+export declare function parseListModel(raw: string | null | undefined): AdwComboOption[];
+/**
+ * The "no item is selected" index — the TS mirror of `GTK_INVALID_LIST_POSITION`
+ * (`AdwComboRow:selected`'s default and empty value).
+ *
+ * libadwaita spells it `G_MAXUINT` because the property is a `guint`; `-1` is the idiomatic
+ * TS sentinel and the spelling {@link ADW_SIDEBAR_NO_SELECTION} uses for the same GTK
+ * constant. Without it, an EMPTY model and a model whose first item has an empty label are
+ * indistinguishable — both report index 0 with an empty value — so a renderer that wants to
+ * draw a placeholder has nothing to test.
+ */
+export declare const ADW_COMBO_NO_SELECTION = -1;
+/**
+ * Where a selection lands after the model under it was REPLACED.
+ *
+ * `GtkSingleSelection` autoselects, so a position the new model does not have falls back
+ * to 0 — including the sentinel, which is how a widget recovers a selection when its model
+ * grows. An EMPTY model has no 0 to fall back to and lands on
+ * {@link ADW_COMBO_NO_SELECTION}.
+ *
+ * The test is membership and not `selected >= length`: the sentinel is BELOW the range, so
+ * a one-sided comparison leaves a `-1` in place and a model that was emptied and refilled
+ * comes back with nothing selected.
+ *
+ * Lifted out of `ComboState.setModel` so a second list widget cannot re-derive it. The
+ * cross-renderer rule it encodes was already conformance data — `conformance/rows.ts`
+ * carries it as "the ports' shared answer" — it just had no name of its own.
+ */
+export declare function clampListSelection(selected: number, length: number): number;
+/**
+ * One positional change — `Gio.ListModel::items-changed`'s own three parameters.
+ *
+ * `position` is where the model changed, `removed` how many items went, `added` how many
+ * arrived. WHAT arrived is deliberately absent, because that is GLib's contract too: a
+ * consumer re-reads the model over `[position, position + added)`. Carrying the items
+ * would make the signal a second copy of the model that can disagree with it.
+ */
+export interface AdwListItemsChanged {
+    /** The position at which the model changed. */
+    readonly position: number;
+    /** The number of items removed at {@link position}. */
+    readonly removed: number;
+    /** The number of items added at {@link position}. */
+    readonly added: number;
+}
+/**
+ * The ONE splice that turns `previous` into `next` — the `items-changed` a model
+ * replacement should emit, or `null` when the two are equal and GTK would emit nothing.
+ *
+ * It is the minimal single range: the shared prefix and the shared suffix are kept, and
+ * everything between them is the change. That is `g_list_store_splice`'s shape and its
+ * stated reason — one emission per change rather than one per item — and it is what lets
+ * a renderer append an item to a hundred-item list by adding ONE node.
+ *
+ * Items compare by BOTH halves: a descriptor whose label changed at an unchanged value is
+ * a different thing to draw, so it is inside the range. Comparing by `value` alone would
+ * leave a renamed row showing its old text, which is the exact failure `selection_item_changed`
+ * exists for upstream.
+ *
+ * NOT a diff algorithm. A model that moves one item from the front to the back reports the
+ * whole span, because `items-changed` has no vocabulary for a move — GTK's own list store
+ * reports `g_list_store_move` the same way.
+ */
+export declare function listItemsChanged(previous: AdwListModel | null | undefined, next: AdwListModel | null | undefined): AdwListItemsChanged | null;

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

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