@gjsify/adwaita-core 0.35.0 → 0.37.0

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

@@ -1,6 +1,5 @@
 /** A page as a vector declares it — the input half of `AdwViewStackPageSpec`. */
 export interface ViewStackVectorPage {
-    /** The page name. */
     name: string;
     /** Explicit title; omitted means "fall back to the name". */
     title?: string;
@@ -37,15 +36,12 @@ export interface ViewStackVectorChange {
 }
 /** One end-to-end view-stack expectation. */
 export interface ViewStackVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
     /** The pages, added in this order. */
     pages: readonly ViewStackVectorPage[];
     /** Changes emitted WHILE the pages are added (the auto-pick), in order. */
     setupChanges: readonly ViewStackVectorChange[];
-    /** Operations applied after the pages exist. */
     ops: readonly ViewStackVectorOp[];
     /**
      * Return value of each op, in order. Asserted by the core suite only — the
@@ -61,7 +57,6 @@ export interface ViewStackVector {
     visibleName: string;
     /** Final selected title, `''` for none. */
     visibleTitle: string;
-    /** Final page count. */
     count: number;
     /** Expected `duplicateNames`, when the row exercises them. */
     duplicateNames?: readonly string[];
@@ -78,15 +73,10 @@ export interface ViewStackVector {
 export declare const VIEW_STACK_VECTORS: ReadonlyArray<ViewStackVector>;
 /** One page-descriptor normalization expectation. */
 export interface ViewStackPageDescriptorVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C property it is derived from. */
     derivedFrom: string;
-    /** The declared page. */
     page: ViewStackVectorPage;
-    /** Resolved `title`. */
     title: string;
-    /** Resolved `icon`. */
     icon: string;
     /** Resolved `visible`. */
     visible: boolean;
@@ -101,9 +91,7 @@ export declare const VIEW_STACK_PAGE_VECTORS: ReadonlyArray<ViewStackPageDescrip
 export interface ViewStackIconNameVector {
     /** The declared `icon-name`. */
     icon: string | null | undefined;
-    /** The normalized result. */
     normalized: string;
-    /** What this row pins down. */
     rule: string;
 }
 /**

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

@@ -7,7 +7,6 @@ import type { AdwInlineViewSwitcherDisplayMode, AdwViewSwitcherPolicy, ViewSwitc
  * both to "do not set the attribute".
  */
 export interface ViewSwitcherVectorPage {
-    /** The page name. */
     name: string;
     /** `AdwViewStackPage:title`; absent means NULL. */
     title?: string | null;
@@ -24,20 +23,15 @@ export interface ViewSwitcherVectorPage {
 }
 /** One `stripMnemonic` expectation. */
 export interface MnemonicVector {
-    /** The raw title. */
     label: string;
     /** What `adw_strip_mnemonic` produces. */
     stripped: string;
-    /** What this row pins down. */
     rule: string;
 }
 /**
- * `adw_strip_mnemonic` (adw-widget-utils.c:685-703) — `g_markup_escape_text`
- * then `pango_parse_markup` with `'_'` as the accel marker.
- *
- * The escape/parse round trip is entity-NEUTRAL, which is what the `R&D` row
- * pins: a port that only escaped, or only unescaped, would drift on every
- * ampersand.
+ * `adw_strip_mnemonic` — `g_markup_escape_text`, then `pango_parse_markup` with `'_'`
+ * as the accel marker. The round trip is entity-NEUTRAL, which is what the `R&D` row
+ * pins: a port that only escaped, or only unescaped, would drift on every ampersand.
  */
 export declare const VIEW_SWITCHER_MNEMONIC_VECTORS: ReadonlyArray<MnemonicVector>;
 /** One `viewSwitcherIconName` expectation. */
@@ -46,17 +40,14 @@ export interface ViewSwitcherIconVector {
     iconName: string | null | undefined;
     /** The icon the switcher actually renders. */
     resolved: string;
-    /** What this row pins down. */
     rule: string;
 }
 /**
- * The `image-missing` substitution (adw-view-switcher-button.c:399-405,
- * adw-inline-view-switcher.c:137-142). Both ports rendered NO icon instead,
- * which is why an icons-mode toggle for a page without an icon was a blank box.
+ * The `image-missing` substitution for a page with no icon of its own — rendering NO
+ * icon leaves an icons-mode toggle as a blank box.
  *
- * Note there is no `-symbolic` stripping here: C passes the name to `GtkImage`
- * unchanged. Turning a name into a CSS class or an SVG document is the
- * renderer's job.
+ * No `-symbolic` stripping here: C passes the name to `GtkImage` unchanged, and turning
+ * a name into a CSS class or an SVG document is the renderer's job.
  */
 export declare const VIEW_SWITCHER_ICON_VECTORS: ReadonlyArray<ViewSwitcherIconVector>;
 /** One `isViewSwitcherButtonVisible` expectation. */
@@ -69,17 +60,12 @@ export interface ViewSwitcherButtonVisibilityVector {
     iconName: string | null;
     /** Whether `AdwViewSwitcher` shows the button. */
     buttonVisible: boolean;
-    /** What this row pins down. */
     rule: string;
 }
 /**
  * `update_button`'s `gtk_widget_set_visible (button, visible && (title != NULL ||
- * icon_name != NULL))` (adw-view-switcher.c:178).
- *
- * Implemented in NEITHER port: the browser one hid the label and icon spans but
- * always appended a visible `<button>`, the NativeScript one always added the
- * button `StackLayout` with an empty `Label`. Both therefore rendered an empty,
- * clickable, space-consuming tab for a page with no title and no icon.
+ * icon_name != NULL))` — a page with neither title nor icon gets no tab at all, not an
+ * empty clickable one.
  */
 export declare const VIEW_SWITCHER_BUTTON_VISIBILITY_VECTORS: ReadonlyArray<ViewSwitcherButtonVisibilityVector>;
 /** One badge-label + indicator-description expectation. */
@@ -92,17 +78,12 @@ export interface ViewSwitcherBadgeVector {
     badgeLabel: string;
     /** `update_description`'s text. */
     description: string;
-    /** What this row pins down. */
     rule: string;
 }
 /**
- * `get_badge_label` (adw-indicator-bin.c:58-68) and `update_description`
- * (:70-113), which both ports omit entirely — neither renders a badge, a
- * needs-attention dot, or an accessible description.
- *
- * The composition ORDER is the subtle part: when both clauses apply the format
- * is `"%s %s", badge_description, needs_attention_description` (:96), so the
- * BADGE comes first.
+ * `get_badge_label` and `update_description`. The composition ORDER is the subtle part:
+ * with both clauses the format is `"%s %s", badge_description,
+ * needs_attention_description` — badge first.
  */
 export declare const VIEW_SWITCHER_BADGE_VECTORS: ReadonlyArray<ViewSwitcherBadgeVector>;
 /** One `shouldRevealViewSwitcherBar` expectation. */
@@ -115,14 +96,12 @@ export interface ViewSwitcherBarRevealVector {
     }[];
     /** Whether the action bar is actually revealed. */
     revealed: boolean;
-    /** What this row pins down. */
     rule: string;
 }
 /**
- * `update_bar_revealed` (adw-view-switcher-bar.c:104-126) — absent from BOTH
- * ports, which each reduced `revealed` to their own boolean flag and never
- * consulted the page count. A bar bound to a one-page stack therefore showed an
- * empty strip libadwaita keeps collapsed.
+ * `update_bar_revealed` — absent from BOTH
+ * ports, which reduced `revealed` to a boolean flag and never consulted the page
+ * count, so a bar on a one-page stack showed a strip libadwaita keeps collapsed.
  */
 export declare const VIEW_SWITCHER_BAR_REVEAL_VECTORS: ReadonlyArray<ViewSwitcherBarRevealVector>;
 /** One step of a {@link ViewSwitcherBarVector} script. */
@@ -144,9 +123,7 @@ export interface ViewSwitcherBarSnapshot {
 }
 /** One end-to-end switcher-bar expectation. */
 export interface ViewSwitcherBarVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
     /** The script, applied in order to a fresh bar. */
     steps: readonly ViewSwitcherBarStep[];
@@ -162,10 +139,9 @@ export interface ViewSwitcherBarVector {
     changes: readonly ViewSwitcherBarSnapshot[];
 }
 /**
- * `AdwViewSwitcherBar`'s reveal machine end to end. `update_bar_revealed` is
- * re-run from `set_reveal`, from `set_stack` and from the pages' `items-changed`
- * (adw-view-switcher-bar.c:340-343, :383, :277), which is why the page set alone
- * can flip the bar while `reveal` never moves.
+ * `AdwViewSwitcherBar`'s reveal machine end to end. `update_bar_revealed` is re-run
+ * from `set_reveal`, from `set_stack` and from the pages' `items-changed`, which is why
+ * the page set alone can flip the bar while `reveal` never moves.
  */
 export declare const VIEW_SWITCHER_BAR_VECTORS: ReadonlyArray<ViewSwitcherBarVector>;
 /** One `inlineToggleTooltip` expectation. */
@@ -174,32 +150,26 @@ export interface InlineTooltipVector {
     title: string | null;
     /** `AdwViewStackPage:use-underline`. */
     useUnderline: boolean;
-    /** The current display mode. */
     displayMode: AdwInlineViewSwitcherDisplayMode;
     /** The tooltip text, as PLAIN text. */
     tooltip: string;
-    /** What this row pins down. */
     rule: string;
 }
 /**
- * `update_tooltip` (adw-inline-view-switcher.c:163-192). The browser port gated
- * on the mode correctly but used the RAW attribute, so `title="_Files"` produced
- * the tooltip `_Files`; the NativeScript port has no tooltip at all.
+ * `update_tooltip`. The browser port gated on
+ * the mode correctly but used the RAW attribute, so `title="_Files"` produced the
+ * tooltip `_Files`; NativeScript has no tooltip at all.
  */
 export declare const INLINE_TOOLTIP_VECTORS: ReadonlyArray<InlineTooltipVector>;
 /** The derived per-button model a vector expects. */
 export interface ExpectedViewSwitcherButton {
-    /** Position in the page list. */
     pageIndex: number;
-    /** The page name. */
     name: string;
     /** The text painted on the button. */
     label: string;
     /** The icon name painted on the button, never empty. */
     iconName: string;
-    /** Whether the button is shown at all. */
     visible: boolean;
-    /** Whether it is the selected one. */
     selected: boolean;
     /** Icon/label arrangement, from the policy. */
     orientation: 'horizontal' | 'vertical';
@@ -212,11 +182,8 @@ export interface ExpectedViewSwitcherButton {
 }
 /** One `buildViewSwitcherButtons` expectation. */
 export interface ViewSwitcherButtonVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
-    /** The pages, in order. */
     pages: readonly ViewSwitcherVectorPage[];
     /** The selected PAGE index, `-1` for none. */
     selected: number;
@@ -227,8 +194,8 @@ export interface ViewSwitcherButtonVector {
 }
 /**
  * `AdwViewSwitcher`'s per-button derivation: `populate_switcher` adds a button
- * for EVERY page (adw-view-switcher.c:230-238) and `update_button` decides what
- * it shows and whether it is visible (:149-182).
+ * for EVERY page and `update_button` decides what
+ * it shows and whether it is visible.
  */
 export declare const VIEW_SWITCHER_BUTTON_VECTORS: ReadonlyArray<ViewSwitcherButtonVector>;
 /** The derived per-toggle model a vector expects. */
@@ -237,15 +204,12 @@ export interface ExpectedInlineToggle {
     toggleIndex: number;
     /** Position in the page list — libadwaita's `child-index`. */
     pageIndex: number;
-    /** The page name. */
     name: string;
     /** The text painted on the toggle. */
     label: string;
     /** The icon name painted on the toggle, never empty. */
     iconName: string;
-    /** Whether this display mode builds an icon. */
     showIcon: boolean;
-    /** Whether this display mode builds a label. */
     showLabel: boolean;
     /** Tooltip text, `''` outside icons mode. */
     tooltip: string;
@@ -258,11 +222,8 @@ export interface ExpectedInlineToggle {
 }
 /** One `buildInlineToggles` + index-mapping expectation. */
 export interface InlineToggleVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
-    /** The pages, in order. */
     pages: readonly ViewSwitcherVectorPage[];
     /** `AdwInlineViewSwitcher:display-mode`. */
     displayMode: AdwInlineViewSwitcherDisplayMode;
@@ -276,12 +237,10 @@ export interface InlineToggleVector {
 /**
  * The inline switcher's TWO index spaces, plus what each display mode builds.
  *
- * `populate_group` calls `add_toggle` only for visible pages and passes the PAGE
- * index `i`, which `add_toggle` stashes as `child-index`
- * (adw-inline-view-switcher.c:370-378, :346); `notify_active_cb` reads it back
- * (:114-129) and `selection_changed_cb` walks the other way (:434-453). Neither
- * port filtered hidden pages, so the mapping looked like the identity and the
- * `-1` sentinel had no spelling.
+ * `populate_group` calls `add_toggle` only for visible pages and passes the PAGE index
+ * `i`, which `add_toggle` stashes as `child-index`; `notify_active_cb` reads it back and
+ * `selection_changed_cb` walks the other way. Skip the hidden-page filter and the two
+ * spaces collapse into the identity, which is where the `-1` sentinel gets lost.
  */
 export declare const INLINE_TOGGLE_VECTORS: ReadonlyArray<InlineToggleVector>;
 /** One change notification, in the order it is emitted. */
@@ -309,15 +268,12 @@ export type ViewSwitcherVectorOp = {
 };
 /** One end-to-end switcher-selection expectation. */
 export interface ViewSwitcherSelectionVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
     /** The pages, set in this order. */
     pages: readonly ViewSwitcherVectorPage[];
     /** Changes emitted WHILE the pages are set (the auto-pick), in order. */
     setupChanges: readonly ViewSwitcherVectorChange[];
-    /** Operations applied after the pages exist. */
     ops: readonly ViewSwitcherVectorOp[];
     /**
      * Return value of each op, in order. Asserted by the core and NativeScript
@@ -337,27 +293,22 @@ export interface ViewSwitcherSelectionVector {
     diagnostics?: readonly string[];
 }
 /**
- * The selection machine a switcher drives, which is the bound stack's — the
- * switcher owns no selection property of its own (adw-view-switcher.c:126-147
- * goes straight to `gtk_selection_model_select_item`).
+ * The selection machine a switcher drives, which is the bound stack's — the switcher
+ * owns no selection property of its own; it goes straight to
+ * `gtk_selection_model_select_item`.
  *
- * The refusal rows are the ones both ports failed differently: the browser
- * switcher CLAMPED an out-of-range or negative index into range (so `active="-1"`
- * jumped to the first page and `active="99"` to the last), and both stacks
- * accepted a fractional index and then matched no page at all.
+ * The refusal rows pin that a negative, out-of-range or FRACTIONAL index is refused
+ * outright: clamping it (`active="-1"` to the first page, `active="99"` to the last)
+ * silently selects a page the caller did not ask for.
  */
 export declare const VIEW_SWITCHER_SELECTION_VECTORS: ReadonlyArray<ViewSwitcherSelectionVector>;
 /** One page-list rebuild expectation. */
 export interface ViewSwitcherRebuildVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
-    /** The initial pages. */
     pages: readonly ViewSwitcherVectorPage[];
     /** A page name to select before the rebuild; omitted keeps the auto-pick. */
     select?: string;
-    /** The replacement pages. */
     nextPages: readonly ViewSwitcherVectorPage[];
     /** Changes emitted BY the rebuild, in order. */
     changes: readonly ViewSwitcherVectorChange[];
@@ -367,15 +318,13 @@ export interface ViewSwitcherRebuildVector {
     selectedName: string;
 }
 /**
- * What happens to the selection when the page list is replaced wholesale — the
- * shape both renderers actually use (`setViews` on NativeScript, a re-parse on
- * the browser side).
+ * What happens to the selection when the page list is replaced wholesale — the shape
+ * both renderers use (`setViews` on NativeScript, a re-parse on the browser side).
  *
  * libadwaita's selection is a page POINTER compared by identity
- * (`adw_view_stack_pages_is_selected`, adw-view-stack.c:660-672), so it follows
- * the page across inserts instead of pinning an index; a rebuild that drops the
- * selected page falls through to the first-visible auto-pick
- * (adw-view-switcher.c:258-263).
+ * (`adw_view_stack_pages_is_selected`), so it follows the page across inserts instead of
+ * pinning an index; a rebuild that drops the selected page falls through to the
+ * first-visible auto-pick.
  */
 export declare const VIEW_SWITCHER_REBUILD_VECTORS: ReadonlyArray<ViewSwitcherRebuildVector>;
 /** One step of a {@link ViewSwitcherDragVector} script. */
@@ -391,15 +340,11 @@ export type ViewSwitcherDragStep = {
 };
 /** One drag-hover auto-switch expectation. */
 export interface ViewSwitcherDragVector {
-    /** What this row pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
-    /** The pages. */
     pages: readonly ViewSwitcherVectorPage[];
     /** The page index selected before the drag starts. */
     initial: number;
-    /** The drag script. */
     steps: readonly ViewSwitcherDragStep[];
     /** Changes emitted by the script, in order. */
     changes: readonly ViewSwitcherVectorChange[];
@@ -407,13 +352,11 @@ export interface ViewSwitcherDragVector {
     selected: number;
 }
 /**
- * `TIMEOUT_EXPAND` — the 500 ms dwell that switches pages mid-drag. Defined
- * identically in both C files (adw-view-switcher-button.c:14, :58-96;
- * adw-inline-view-switcher.c:80, :194-236) and present in NEITHER port, which
- * only ever listened for `click`/`tap`.
+ * `TIMEOUT_EXPAND` — the 500 ms dwell that switches pages mid-drag, defined identically
+ * in `adw-view-switcher-button.c` and `adw-inline-view-switcher.c`.
  *
- * `interactive: true` on the resulting change: the C timeout activates the
- * toggle, which runs the very same `on_button_toggled` a click does.
+ * `interactive: true` on the resulting change because the C timeout activates the
+ * toggle, running the same `on_button_toggled` a click does.
  */
 export declare const VIEW_SWITCHER_DRAG_VECTORS: ReadonlyArray<ViewSwitcherDragVector>;
 /** A deterministic stand-in for a platform timer, driven by {@link advance}. */
@@ -424,20 +367,9 @@ export interface ViewSwitcherClock extends ViewSwitcherScheduler {
     readonly pending: number;
 }
 /**
- * A fake clock for the drag vectors.
- *
- * Note WHAT it is: a clock, not a stand-in for any behaviour under test. It
- * schedules and cancels callbacks and nothing else, so it cannot transcribe the
- * logic it is used to exercise.
- *
- * WHO DRIVES THOSE VECTORS: the core suite, and only it. This said "the core,
- * browser and NativeScript suites all" — a claim of coverage that was never
- * true, which is worse than silence, because it reads as a reason to stop
- * looking. The browser elements construct
- * `new ViewSwitcherState({ scheduler: domViewSwitcherScheduler })` inline
- * (`elements/adw-view-switcher.ts`, `elements/adw-inline-view-switcher.ts`), so
- * there is no seam to hand this clock through, and the NativeScript port has no
- * drag surface at all. Wiring the browser side means giving the elements a
- * scheduler seam first.
+ * A fake clock for the drag vectors. It schedules and cancels callbacks and nothing
+ * else, so it cannot transcribe the logic it is used to exercise. The browser suite
+ * injects it through the elements' `scheduler` property; the NativeScript port has no
+ * drag surface and drives none of these rows.
  */
 export declare function createViewSwitcherClock(): ViewSwitcherClock;

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

@@ -8,58 +8,51 @@ export interface WrapBoxLineVector {
     /** The widget's `align` property, already validated into `[0, 1]`. */
     align: number;
     /**
-     * Whether this is the FINAL line — `i == *n_lines - 1`
-     * (adw-wrap-layout.c:463-464). Note it is the final line, NOT merely an
-     * incomplete one: a wrap box whose children all fit on one line has that
-     * line as its last, so by default `justify` does nothing to it at all.
+     * Whether this is the FINAL line — `i == *n_lines - 1`.
+     * The final one, NOT merely an incomplete one:
+     * a box whose children all fit on one line has that line as its last, so by
+     * default `justify` does nothing to it at all.
      */
     lastLine: boolean;
     /**
      * How many children the line holds. Only `spread` reads it, and only to
-     * distinguish 1 from more (adw-wrap-layout.c:338).
+     * distinguish 1 from more.
      */
     childrenInLine: number;
-    /** What the renderer must do. */
     layout: WrapBoxLineLayout;
-    /** The rule or edge case this row pins down. */
     rule: string;
 }
 /**
- * The line-layout decision, row by row (adw-wrap-layout.c:317-341, :397-400,
- * :705-706, :717-725).
+ * The line-layout decision, row by row (`adw-wrap-layout.c`).
  *
- * Two rows are counter-intuitive and are the reason the table exists rather than
- * a sentence in a comment. First, `lastLine` is the FINAL line whether or not it
- * is full, so the single-line case — the common one — is governed by
- * `justify-last-line`, not by `justify`. Second, `spread` with exactly ONE child
- * in the line does not spread anything: `n_children > 1` guards the branch that
- * keeps children at `minimum_size`, so a lone child is STRETCHED instead, which
- * the property documentation states outright (adw-wrap-box.c:349-352).
+ * Two counter-intuitive rows are why this is a table and not a sentence.
+ * `lastLine` is the FINAL line whether or not it is full, so the single-line case
+ * — the common one — is governed by `justify-last-line`, not `justify`. And
+ * `spread` with exactly ONE child in the line spreads nothing: `n_children > 1`
+ * guards the branch keeping children at `minimum_size`, so a lone child is
+ * STRETCHED instead.
  */
 export declare const WRAP_BOX_LINE_VECTORS: ReadonlyArray<WrapBoxLineVector>;
 /** One `child-spacing` / `line-spacing` normalisation expectation. */
 export interface WrapBoxSpacingVector {
     /**
-     * The value handed to the setter. A string is what an HTML attribute or an
-     * XML layout carries; a number is what a JS property setter gets. C only
-     * ever sees an `int`, so the string rows are the PORTS' own edge — they
-     * exist because the browser port propagated `NaN` into the style where the
-     * NativeScript port coerced it to 0.
+     * The value handed to the setter — a string from an HTML attribute or XML
+     * layout, a number from a JS property setter. C only ever sees an `int`, so
+     * the string rows are the PORTS' own edge: the browser propagated `NaN` into
+     * the style where NativeScript coerced it to 0.
      */
     value: number | string | null;
     /** The value the widget stores and lays out with. */
     spacing: number;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
  * `adw_wrap_box_set_child_spacing` / `set_line_spacing`
- * (adw-wrap-box.c:587-588, :927-928) — a negative spacing is clamped to 0
+ * — a negative spacing is clamped to 0
  * BEFORE anything else happens, so it never reaches the layout.
  *
- * The property is declared with a minimum of 0 (adw-wrap-box.c:285-287,
- * :393-395), which is why the clamp exists at all: without it GObject would
- * reject the value and warn.
+ * The property is declared with a minimum of 0 , which is why the clamp exists: without it GObject would reject the
+ * value and warn.
  */
 export declare const WRAP_BOX_SPACING_VECTORS: ReadonlyArray<WrapBoxSpacingVector>;
 /** One "does the setter report a change" expectation. */
@@ -70,12 +63,11 @@ export interface WrapBoxSpacingNotifyVector {
     value: number | string;
     /** Whether the setter reaches `g_object_notify_by_pspec` at all. */
     notifies: boolean;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
- * The early return in `adw_wrap_box_set_child_spacing`
- * (adw-wrap-box.c:592-593, :930-931): the comparison happens AFTER the clamp,
+ * The early return in `adw_wrap_box_set_child_spacing`:
+ * the comparison happens AFTER the clamp,
  * so setting `-5` on a box that already holds 0 changes nothing and notifies
  * nobody. The browser port compared raw attribute strings and fired
  * `notify::child-spacing` for a value libadwaita had normalised away.
@@ -83,34 +75,29 @@ export interface WrapBoxSpacingNotifyVector {
 export declare const WRAP_BOX_SPACING_NOTIFY_VECTORS: ReadonlyArray<WrapBoxSpacingNotifyVector>;
 /**
  * Every `notify::` an `Adw.WrapBox` emits — the thirteen installed pspecs
- * (adw-wrap-box.c:284-495) plus the overridden `orientation` (:497).
+ * plus the overridden `orientation`.
  *
- * The count is the assertion. C notifies on all fourteen; the browser port
- * notified on TWO (`child-spacing`, `line-spacing`) and the NativeScript port on
- * none, so a consumer binding to any other property was watching a signal that
- * could not fire. A roster is the only shape that fails when a property is ADDED
- * without its notification, which is how the first twelve went missing.
+ * The count is the assertion: C notifies on all fourteen, and a port that notifies on two
+ * of them leaves a consumer bound to a signal that cannot fire. A roster is the only shape
+ * that fails when a property is ADDED without its notification.
  */
 export declare const WRAP_BOX_NOTIFY_PROPERTIES: readonly string[];
 /** One `wrap-policy` → child-shrink expectation. */
 export interface WrapBoxPolicyVector {
     /** The authored value. Anything not in the enum leaves the property at its default. */
     value: unknown;
-    /** The stored policy. */
     policy: AdwWrapPolicy;
     /** The `flex-shrink` a child gets — `FlexboxLayout.setFlexShrink` on NativeScript. */
     flexShrink: number;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
- * `Adw.WrapBox:wrap-policy` (adw-wrap-box.c:476-495).
+ * `Adw.WrapBox:wrap-policy`.
  *
- * The default is `natural`, which is the RESTRICTIVE one: a line wraps as soon
- * as the next child would not fit at its natural size. `minimum` packs harder by
- * squeezing children down to their minimum first. Both renderers had neither, so
- * they inherited whatever their flex container defaults to — and CSS defaults
- * `flex-shrink` to 1, i.e. to `minimum`, the value libadwaita does NOT default to.
+ * The default is `natural`, the RESTRICTIVE one: a line wraps as soon as the next
+ * child would not fit at its natural size, where `minimum` squeezes children down
+ * first. Both renderers had neither and inherited their flex container's default
+ * — and CSS defaults `flex-shrink` to 1, i.e. to `minimum`.
  */
 export declare const WRAP_BOX_POLICY_VECTORS: ReadonlyArray<WrapBoxPolicyVector>;
 /** One length-unit conversion expectation. */
@@ -121,65 +108,55 @@ export interface WrapBoxLengthVector {
     unit: unknown;
     /** The `gtk-xft-dpi` the renderer reports. */
     dpi: number;
-    /** The resolved pixel length. */
     px: number;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
- * `adw_length_unit_to_px` as the three wrap-box length properties reach it
- * (adw-wrap-layout.c:554-565, :798-804).
+ * `adw_length_unit_to_px` as the three wrap-box length properties reach it.
  *
  * The wrap box defaults its units to `px` where the split views default to `sp`
- * (adw-wrap-box.c:300-305) — the same helper, two different defaults, which is
+ * — the same helper, two different defaults, which is
  * why the fallback is the caller's argument and not the helper's.
  */
 export declare const WRAP_BOX_LENGTH_VECTORS: ReadonlyArray<WrapBoxLengthVector>;
 /** One `natural-line-length` normalisation expectation. */
 export interface WrapBoxNaturalLengthVector {
-    /** The authored value. */
     value: unknown;
     /** The stored length, `-1` when unset. */
     length: number;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
- * `Adw.WrapBox:natural-line-length` — `g_param_spec_int (…, -1, G_MAXINT, -1, …)`
- * (adw-wrap-box.c:438-441).
+ * `Adw.WrapBox:natural-line-length` — `g_param_spec_int (…, -1, G_MAXINT, -1, …)`.
  *
- * `-1` means UNSET, not "zero length", so it is the landing place for everything
- * out of range: a GObject setter would have refused those and left the property
- * where it was, and unset is where it was born.
+ * `-1` means UNSET, not "zero length", so it is where everything out of range
+ * lands: a GObject setter would have refused those and left the property where it
+ * was born.
  */
 export declare const WRAP_BOX_NATURAL_LENGTH_VECTORS: ReadonlyArray<WrapBoxNaturalLengthVector>;
 /** One `insert_child_after` / `reorder_child_after` expectation. */
 export interface WrapBoxChildOrderVector {
-    /** Which operation is being resolved. */
     op: 'insert-after' | 'reorder-after';
     /** The box's children before the call. */
     children: readonly string[];
-    /** The child being placed. */
     child: string;
     /** The sibling to place it after, or `null` for the FIRST position. */
     sibling: string | null;
     /** The children afterwards, or `null` when the call is refused. */
     result: readonly string[] | null;
-    /** The rule this row pins down. */
     rule: string;
 }
 /**
- * `adw_wrap_box_insert_child_after` (adw-wrap-box.c:1283-1300) and
- * `adw_wrap_box_reorder_child_after` (:1315-1332), both of which delegate to
+ * `adw_wrap_box_insert_child_after` and
+ * `adw_wrap_box_reorder_child_after`, both of which delegate to
  * `gtk_widget_insert_after (child, self, sibling)`.
  *
  * The counter-intuitive rule is the NULL sibling: it inserts at the FIRST
  * position, not the last. Reading it as "append" is the obvious misreading and a
- * silent one — the child lands somewhere plausible. Neither renderer had any of
- * this API, so there was nothing to misread yet, which is the good time to pin it.
+ * silent one — the child lands somewhere plausible.
  *
  * The refusals are the C's `g_return_if_fail`s: an insert wants the child
  * unparented, a reorder wants it already a child, the sibling must belong to this
- * box, and `child == sibling` is an explicit early return in both (:1297, :1329).
+ * box, and `child == sibling` is an explicit early return in both.
  */
 export declare const WRAP_BOX_CHILD_ORDER_VECTORS: ReadonlyArray<WrapBoxChildOrderVector>;