@gjsify/adwaita-core 0.36.0 → 0.37.0

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

@@ -9,10 +9,11 @@ export interface ClampThresholdsVector {
     max: number;
     /** `lower + 3 * (max - lower)`. */
     upper: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `lower`/`max`/`upper` (adw-clamp-layout.c:173-176, :210-213).  *
+/**
+ * `lower`/`max`/`upper`.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (CLAMP_ALLOCATE_VECTORS)
  */
 export declare const CLAMP_THRESHOLD_VECTORS: ReadonlyArray<ClampThresholdsVector>;
@@ -24,10 +25,11 @@ export interface ClampChildSizeVector {
     params: ClampParams;
     /** What the child is allocated. */
     childSize: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `child_size_from_clamp` (adw-clamp-layout.c:193-232).  *
+/**
+ * `child_size_from_clamp`.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (CLAMP_ALLOCATE_VECTORS)
  */
 export declare const CLAMP_CHILD_SIZE_VECTORS: ReadonlyArray<ClampChildSizeVector>;
@@ -39,10 +41,11 @@ export interface ClampSizeFromChildVector {
     params: ClampParams;
     /** The size the clamp itself reports for it. */
     clampSize: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `clamp_size_from_child` (adw-clamp-layout.c:156-191) — the inverse ease.  *
+/**
+ * `clamp_size_from_child` — the inverse ease.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (CLAMP_ALLOCATE_VECTORS)
  */
 export declare const CLAMP_SIZE_FROM_CHILD_VECTORS: ReadonlyArray<ClampSizeFromChildVector>;
@@ -60,37 +63,30 @@ export interface ClampAllocateVector {
     lowerThreshold: number;
     /** The style class the CHILD carries. */
     sizeClass: AdwClampSizeClass;
-    /** The centring offset. */
     offset: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `adw_clamp_layout_allocate` (adw-clamp-layout.c:317-386). */
+/** `adw_clamp_layout_allocate`. */
 export declare const CLAMP_ALLOCATE_VECTORS: ReadonlyArray<ClampAllocateVector>;
 /** One `normalizeClampSize` expectation. */
 export interface ClampPropertyVector {
     /** The raw attribute value or property assignment. */
     value: number | string | null | undefined;
-    /** The default the property falls back to. */
     fallback: number;
     /** The value that reaches the layout. */
     size: number;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `maximum-size` / `tightening-threshold` as `g_param_spec_int (…, 0, G_MAXINT, …)`
- * (adw-clamp-layout.c:413-416, :448-451).
+ * `maximum-size` / `tightening-threshold` as `g_param_spec_int (…, 0, G_MAXINT, …)`.
  *
- * The three interesting rows are the three the ports disagreed on: `"0"` (valid,
- * and NOT the default), a non-numeric value (never reaches the layout, so the
- * DEFAULT applies — the browser port kept whatever cap was already set), and a
+ * The three interesting rows: `"0"` (valid, and NOT the default), a non-numeric value
+ * (never reaches the layout, so the DEFAULT applies rather than the cap already set), and a
  * negative (out of range, clamped to the range floor).
  */
 export declare const CLAMP_PROPERTY_VECTORS: ReadonlyArray<ClampPropertyVector>;
 /** One `toolbarViewAllocate` expectation. */
 export interface ToolbarViewAllocateVector {
-    /** The measured sizes going in. */
     input: ToolbarViewAllocateInput;
     /** `Adw.ToolbarView:top-bar-height`. */
     topBarHeight: number;
@@ -100,25 +96,26 @@ export interface ToolbarViewAllocateVector {
     contentHeight: number;
     /** The content's offset from the top edge. */
     contentOffset: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `adw_toolbar_view_size_allocate` (adw-toolbar-view.c:357-406).  *
+/**
+ * `adw_toolbar_view_size_allocate`.
+ *
  * CORE-ONLY: both renderers let the BROWSER and NativeScript lay the bars out rather than allocating by hand, so there is no allocation of theirs to compare — the rule they DO apply is TOOLBAR_VIEW_CLASS_VECTORS, which both drive. This reason used to live in the two `adw-toolbar-view.ts` files and nowhere a reader of this table would look
  */
 export declare const TOOLBAR_VIEW_ALLOCATE_VECTORS: ReadonlyArray<ToolbarViewAllocateVector>;
 /** One `toolbarViewMeasure` expectation. */
 export interface ToolbarViewMeasureVector {
-    /** The measured sizes going in. */
     input: ToolbarViewMeasureInput;
     /** The view's minimum along the measured axis. */
     minimum: number;
     /** The view's natural along the measured axis. */
     natural: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `adw_toolbar_view_measure` (adw-toolbar-view.c:266-354).  *
+/**
+ * `adw_toolbar_view_measure`.
+ *
  * CORE-ONLY: same as TOOLBAR_VIEW_ALLOCATE_VECTORS — neither renderer measures the bars itself
  */
 export declare const TOOLBAR_VIEW_MEASURE_VECTORS: ReadonlyArray<ToolbarViewMeasureVector>;
@@ -126,16 +123,16 @@ export declare const TOOLBAR_VIEW_MEASURE_VECTORS: ReadonlyArray<ToolbarViewMeas
 export interface ToolbarViewContentForSizeVector {
     /** The `for_size` the view was measured at. */
     forSize: number;
-    /** The bar heights and extend flags. */
     input: ToolbarViewContentForSizeInput;
     /** `for_size` for the content's minimum. */
     forSizeMin: number;
     /** `for_size` for the content's natural. */
     forSizeNat: number;
-    /** Why this row exists. */
     rule: string;
 }
-/** `adw_toolbar_view_measure`'s height-for-width branch (adw-toolbar-view.c:292-316).  *
+/**
+ * `adw_toolbar_view_measure`'s height-for-width branch.
+ *
  * CORE-ONLY: same as TOOLBAR_VIEW_ALLOCATE_VECTORS — neither renderer measures the bars itself
  */
 export declare const TOOLBAR_VIEW_CONTENT_FOR_SIZE_VECTORS: ReadonlyArray<ToolbarViewContentForSizeVector>;
@@ -149,16 +146,13 @@ export interface ToolbarViewClassVector {
     topBar: readonly string[];
     /** Classes on the bottom-bar box. */
     bottomBar: readonly string[];
-    /** Why this row exists. */
     rule: string;
 }
-/** `update_undershoots` (adw-toolbar-view.c:215-232) + the style setters (:1011-1024, :1097-1110). */
+/** `update_undershoots` + the style setters. */
 export declare const TOOLBAR_VIEW_CLASS_VECTORS: ReadonlyArray<ToolbarViewClassVector>;
 /** One `spinnerGeometry` expectation. */
 export interface SpinnerGeometryVector {
-    /** Allocated box width. */
     width: number;
-    /** Allocated box height. */
     height: number;
     /** `MIN (floorf (MIN (w, h) / 2), MAX_RADIUS)`. */
     radius: number;
@@ -171,16 +165,15 @@ export interface SpinnerGeometryVector {
     /** `roundf (height / 2)`. */
     centerY: number;
     /**
-     * What the browser element drew before this landed — `max(2, round(size / 12))`
-     * — or `null` for a non-square box, which that element had no notion of.
+     * The pre-lift browser formula `max(2, round(size / 12))`, or `null` for a
+     * non-square box, which that element had no notion of.
      */
     legacyWebLineWidth: number | null;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_spinner_paintable_snapshot_with_weight` (adw-spinner-paintable.c:342-352)
- * + `calculate_line_width` (:314-321) at the default weight 400.
+ * `adw_spinner_paintable_snapshot_with_weight`
+ * + `calculate_line_width` at the default weight 400.
  *
  * `legacyWebLineWidth` stays in the table on purpose: it is the formula the
  * browser element shipped, and it is wrong at every size above 16 — 2px where
@@ -193,11 +186,10 @@ export interface SpinnerSizeVector {
     value: number | string | null | undefined;
     /** The box the spinner is given. */
     size: number;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_spinner_measure` (adw-spinner.c:70-84) — minimum AND natural are both
+ * `adw_spinner_measure` — minimum AND natural are both
  * `MIN_SIZE`, and GTK never allocates below a widget's minimum.
  *
  * The rows without a usable value all land on 16, which is the measured natural

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

@@ -1,7 +1,6 @@
 import type { AdwDataGridColumn, AdwDataGridRowVariant, DataGridTrack } from '../data-grid.js';
 /** One track-derivation expectation. */
 export interface DataGridTrackVector {
-    /** What the row is about. */
     name: string;
     /** The column descriptors handed to `dataGridTracks`. */
     columns: ReadonlyArray<AdwDataGridColumn>;
@@ -9,64 +8,55 @@ export interface DataGridTrackVector {
     tracks: ReadonlyArray<DataGridTrack>;
     /** The browser mapping — a `grid-template-columns` value. */
     template: string;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `dataGridTracks` + `dataGridTrackTemplate`.
  *
- * The rule that needs the most rows is the implicit one: with NO `width` and NO
+ * The rule needing the most rows is the implicit one: with NO `width` and NO
  * `flex` anywhere, the FIRST column absorbs the slack and the rest size to
- * content. It is global, so a single declared size anywhere in the list turns it
- * off for every column — the pair of two-column rows below is the whole
- * difference between "label column stretches, figures hug the right edge" and
- * "every column hugs its content".
+ * content. It is global, so one declared size anywhere turns it off for every
+ * column — the difference between "label column stretches, figures hug the right
+ * edge" and "every column hugs its content".
  */
 export declare const DATA_GRID_TRACK_VECTORS: ReadonlyArray<DataGridTrackVector>;
 /** One cell-class expectation. */
 export interface DataGridColumnClassVector {
-    /** What the row is about. */
     name: string;
-    /** The column descriptor. */
     column: AdwDataGridColumn;
-    /** The effective alignment. */
     align: string;
     /** The full class list, in order. */
     classes: ReadonlyArray<string>;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `dataGridColumnAlign` + `dataGridColumnClasses`.
  *
- * `numeric` and `mono` are libadwaita's own label classes
- * (`_labels.scss:81-88`): `.numeric` is `font-variant-numeric: tabular-nums`,
- * `.monospace` additionally the monospace family. They are opt-ins that stack,
- * and `numeric` additionally moves the default alignment to the right edge —
- * which is the entire difference between this widget and a boxed list.
+ * `numeric` and `mono` are libadwaita's own label classes (`_labels.scss`):
+ * `.numeric` is `font-variant-numeric: tabular-nums`, `.monospace` additionally
+ * the monospace family. They stack, and `numeric` also moves the default
+ * alignment to the right edge.
  *
  * `align` is deliberately unvalidated (the last row): a value outside the union
- * produces a class no stylesheet claims, and the cell keeps the base rule's
- * alignment. The variant table below IS validated, because a bogus variant would
- * pick an emphasis rather than merely fail to move text.
+ * produces a class no stylesheet claims and the cell keeps the base alignment.
+ * The variant table below IS validated, a bogus variant picking an emphasis
+ * rather than merely failing to move text.
  */
 export declare const DATA_GRID_COLUMN_CLASS_VECTORS: ReadonlyArray<DataGridColumnClassVector>;
 /** One variant-normalisation expectation. */
 export interface DataGridVariantVector {
     /** The raw `variant` value off the row object. */
     input: unknown;
-    /** What it normalises to. */
     variant: AdwDataGridRowVariant;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `normalizeDataGridVariant`.
  *
- * Unlike the alignment, this one IS clamped: the variant picks a row's EMPHASIS
- * — a spanning bold section title, a hairline rule above a subtotal, a double
- * rule above the total — so an unrecognised value must fall back to the plain
- * data row rather than to no rule at all.
+ * Unlike the alignment, this one IS clamped: the variant picks a row's EMPHASIS —
+ * a spanning bold section title, a hairline above a subtotal, a double rule above
+ * the total — so an unrecognised value falls back to the plain data row rather
+ * than to no rule at all.
  */
 export declare const DATA_GRID_VARIANT_VECTORS: ReadonlyArray<DataGridVariantVector>;
 /** One cell-text expectation. */
@@ -75,61 +65,52 @@ export interface DataGridCellTextVector {
     input: string | number | boolean | undefined | null;
     /** What the cell paints. */
     text: string;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `dataGridCellText`.
  *
- * The grid formats NOTHING — a cell value is a pre-formatted string, because
- * only the app knows the locale, the currency and the rounding. So the rule is
- * only about the two empties, and the rows that matter are `0` and `false`: a
- * truthiness test would blank both, and a blanked `0` in a statement column is a
- * missing figure, not a zero one.
+ * The grid formats NOTHING — a cell value is a pre-formatted string, only the app
+ * knowing the locale, currency and rounding. So the rule is only about the two
+ * empties, and the rows that matter are `0` and `false`: a truthiness test blanks
+ * both, and a blanked `0` in a statement column is a missing figure, not a zero.
  */
 export declare const DATA_GRID_CELL_TEXT_VECTORS: ReadonlyArray<DataGridCellTextVector>;
 /** One activation expectation. */
 export interface DataGridInteractiveVector {
-    /** The row's normalised variant. */
     variant: AdwDataGridRowVariant;
     /** The row's own `interactive` value, as it arrives (JSON can hold anything). */
     rowFlag: unknown;
     /** The grid-level `interactive` flag. */
     gridInteractive: boolean;
-    /** Whether the row activates. */
     interactive: boolean;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `dataGridRowInteractive`.
  *
- * Two independent rules, and both have a failure mode worth a row. Only a
- * `normal` row can ever activate: a section header, a subtotal and a total are
- * structure, and offering a detail view for a computed line leads nowhere. And
- * the per-row flag overrides the grid-level one in BOTH directions, which is the
- * part a single `||` or `&&` gets wrong.
+ * Two independent rules, each with a failure mode worth a row. Only a `normal`
+ * row can activate — a header, subtotal and total are structure, and a detail
+ * view for a computed line leads nowhere. And the per-row flag overrides the
+ * grid-level one in BOTH directions, which a single `||` or `&&` gets wrong.
  */
 export declare const DATA_GRID_INTERACTIVE_VECTORS: ReadonlyArray<DataGridInteractiveVector>;
 /** One column-normalisation expectation. */
 export interface DataGridColumnNormalizeVector {
-    /** What the row is about. */
     name: string;
     /** The raw value — a parsed JSON attribute, so genuinely anything. */
     input: unknown;
-    /** The normalised descriptors. */
     columns: ReadonlyArray<AdwDataGridColumn>;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `normalizeDataGridColumns`.
  *
- * The input is a parsed JSON attribute, so every field has to survive a value of
- * the wrong type. Two policies run side by side and the rows say which is which:
- * an entry WITHOUT a `key` is dropped (there is nothing to read from a row), and
- * a field of the wrong type is coerced (`key`, `label`, `width`) or discarded
- * (`flex`, `monospace`, `numeric`) rather than taking the whole entry down.
+ * The input is a parsed JSON attribute, so every field must survive a value of
+ * the wrong type. Two policies run side by side: an entry WITHOUT a `key` is
+ * dropped (nothing to read from a row), and a field of the wrong type is coerced
+ * (`key`, `label`, `width`) or discarded (`flex`, `monospace`, `numeric`) rather
+ * than taking the whole entry down.
  *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (DATA_GRID_TRACK_VECTORS)
  */

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

@@ -9,9 +9,7 @@ export interface BottomSheetCloseVector {
     canClose: boolean;
     /** What the C source does with it. */
     outcome: BottomSheetCloseOutcome;
-    /** Why this row exists — the rule or corner it pins down. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
 }
 /**
@@ -59,9 +57,7 @@ export interface BottomSheetPresentationVector {
     open: boolean;
     /** `has_been_open` after the last step. */
     hasBeenOpen: boolean;
-    /** Why this row exists. */
     rule: string;
-    /** The C function + lines it is derived from. */
     derivedFrom: string;
 }
 /**
@@ -88,10 +84,9 @@ export declare function runBottomSheetSteps(adapter: BottomSheetPresentationAdap
  * `adw_bottom_sheet_set_open`'s state machine as scripts: the idempotent guard,
  * the never-been-open teardown replay, and which paths notify.
  *
- * The `notifications` column is the one that caught a live bug: the browser port
- * emitted `notify::open` whenever the open ATTRIBUTE VALUE changed rather than
- * when the open STATE changed, so `setAttribute('open','')` followed by
- * `setAttribute('open','false')` fired a second notification carrying an
- * unchanged payload.
+ * The `notifications` column caught a live bug: emitting `notify::open` whenever the open
+ * ATTRIBUTE VALUE changes rather than when the open STATE changes makes
+ * `setAttribute('open','')` then `setAttribute('open','false')` fire a second notification
+ * carrying an unchanged payload.
  */
 export declare const BOTTOM_SHEET_PRESENTATION_VECTORS: ReadonlyArray<BottomSheetPresentationVector>;

package/lib/types/conformance/entry-row.d.ts

@@ -1,16 +1,13 @@
 import type { EntryRowActivation, EntryRowRenderState, PasswordEntryRowRenderState } from '../entry-row.js';
 /** One `entryTextLength` expectation. */
 export interface EntryTextLengthVector {
-    /** The entry contents. */
     text: string;
     /** `adw_entry_row_get_text_length` — "The current number of characters". */
     length: number;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_entry_row_get_text_length` (adw-entry-row.c:1304-1318), whose property is
- * declared `0, G_MAXUINT16, 0` (C:666-669).
+ * `adw_entry_row_get_text_length`, whose property is declared `0, G_MAXUINT16, 0`.
  *
  * The astral rows are the point: `'🔒é'.length` is 3 in JS because JS counts
  * UTF-16 units, and GTK counts characters. A port that gets this wrong also
@@ -27,14 +24,13 @@ export interface EntryMaxLengthVector {
     clamped: string;
     /** {@link EntryTextLengthVector.length} of {@link clamped}. */
     length: number;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_entry_row_set_max_length` (adw-entry-row.c:1329-1343) read together with
+ * `adw_entry_row_set_max_length` read together with
  * the property doc "Maximum number of characters for the entry" and its
- * `0..GTK_ENTRY_BUFFER_MAX_SIZE` range with `0` as both default and floor
- * (C:674, :678-682).
+ * `0..GTK_ENTRY_BUFFER_MAX_SIZE` range with `0` as both default and floor.
+ *
  */
 export declare const ENTRY_MAX_LENGTH_VECTORS: ReadonlyArray<EntryMaxLengthVector>;
 /**
@@ -67,28 +63,22 @@ export type EntryRowStep = {
 };
 /** One `update_empty` truth-table row: a scenario and the FULL snapshot it lands on. */
 export interface EntryRowStateVector {
-    /** Human-readable scenario name (used as the test title). */
     name: string;
-    /** Applied in order to a freshly-constructed entry row. */
     steps: ReadonlyArray<EntryRowStep>;
-    /** Every output of the derivation afterwards. */
     expected: EntryRowRenderState;
-    /** The C rule this row pins down. */
     rule: string;
 }
 /**
- * `update_empty` (adw-entry-row.c:147-161) plus the `text_changed` latch
- * (C:170-172) and its two reset paths (the apply click C:237, the property
- * turned off C:989-992).
+ * `update_empty` plus the `text_changed` latch and its two reset paths (the apply click, the
+ * property turned off).
  *
  * Defaults of a fresh row: no text, unlimited length, not editing, EDITABLE,
  * no apply button, no indicator — plus the indicator and apply button starting
- * child-invisible (`adw_entry_row_init`, C:764-765).
+ * child-invisible (`adw_entry_row_init`).
  */
 export declare const ENTRY_ROW_STATE_VECTORS: ReadonlyArray<EntryRowStateVector>;
 /** One `text_activated_cb` expectation. */
 export interface EntryRowActivationVector {
-    /** Human-readable scenario name. */
     name: string;
     /** Applied in order to a freshly-constructed entry row before pressing Enter. */
     steps: ReadonlyArray<EntryRowStep>;
@@ -96,35 +86,31 @@ export interface EntryRowActivationVector {
     activation: EntryRowActivation;
     /** The latch afterwards (`apply` clears it; `entry-activated` leaves state alone). */
     textChangedAfter: boolean;
-    /** The C rule this row pins down. */
     rule: string;
 }
 /**
- * `text_activated_cb` (adw-entry-row.c:243-266): the apply path when the apply
- * button is child-visible, otherwise activate-the-default (C:253-254) followed
- * by `entry-activated` (C:256) — in that order.
+ * `text_activated_cb`: the apply path when the apply
+ * button is child-visible, otherwise activate-the-default followed
+ * by `entry-activated` — in that order.
  */
 export declare const ENTRY_ROW_ACTIVATION_VECTORS: ReadonlyArray<EntryRowActivationVector>;
 /** One setter-guard expectation: what each step returns, and how many re-derivations the sequence causes. */
 export interface EntryRowGuardVector {
-    /** Human-readable scenario name. */
     name: string;
-    /** Applied in order to a freshly-constructed entry row. */
     steps: ReadonlyArray<EntryRowStep>;
     /** Per step: the setter's return value, or `null` for the `void` `setShowIndicator`. */
     returns: ReadonlyArray<boolean | null>;
     /** How many times subscribers are notified across the whole sequence. */
     notifications: number;
-    /** The C rule this row pins down. */
     rule: string;
 }
 /**
  * The guards are NOT uniform, and the asymmetry is the point: every public
- * setter early-outs on an unchanged value (C:984, :1198, :1247, :1339), while
- * the private `adw_entry_row_set_show_indicator` (C:1281-1296) deliberately has
+ * setter early-outs on an unchanged value, while
+ * the private `adw_entry_row_set_show_indicator` deliberately has
  * NO equality check and re-derives unconditionally.
  *
- * CORE-ONLY: GAP — the browser element discards the setter’s boolean, so the guard has no observable answer. Tracked in #1072
+ * CORE-ONLY: GAP — the browser element exposes these as attributes and void methods, so a setter's boolean return is not observable through the DOM surface. Tracked in #1072
  */
 export declare const ENTRY_ROW_GUARD_VECTORS: ReadonlyArray<EntryRowGuardVector>;
 /** One mutation in a password-entry-row scenario. */
@@ -144,7 +130,6 @@ export type PasswordEntryRowStep = {
 };
 /** One password-entry-row expectation: the peek/caps-lock snapshot plus what it did to the parent row. */
 export interface PasswordEntryRowVector {
-    /** Human-readable scenario name. */
     name: string;
     /** Applied in order to a freshly-constructed password entry row. */
     steps: ReadonlyArray<PasswordEntryRowStep>;
@@ -152,19 +137,17 @@ export interface PasswordEntryRowVector {
     expected: PasswordEntryRowRenderState;
     /** `indicatorVisible` on the composed entry row — the caps-lock warning the user actually sees. */
     entryIndicatorVisible: boolean;
-    /** The C rule this row pins down. */
     rule: string;
 }
 /**
- * `notify_visibility_cb` (adw-password-entry-row.c:62-81) + `update_caps_lock`
- * (C:52-60), and the two rules that make the caps-lock warning more than a
- * boolean: it is suppressed while PEEKING (C:58, `!gtk_text_get_visibility`) and
- * suppressed while UNFOCUSED (adw-entry-row.c:151, `editing && show_indicator`).
+ * `notify_visibility_cb` + `update_caps_lock`,
+ * and the two rules that make the caps-lock warning more than a
+ * boolean: it is suppressed while PEEKING (`!gtk_text_get_visibility`) and while UNFOCUSED
+ * (`editing && show_indicator`).
  */
 export declare const PASSWORD_ENTRY_ROW_VECTORS: ReadonlyArray<PasswordEntryRowVector>;
 /** One peek-notification expectation — how often a reveal change is observable. */
 export interface PasswordRevealGuardVector {
-    /** Human-readable scenario name. */
     name: string;
     /** Reveal-only steps applied to a freshly-constructed password entry row. */
     steps: ReadonlyArray<{
@@ -175,13 +158,11 @@ export interface PasswordRevealGuardVector {
     }>;
     /** How many reveal notifications the sequence produces. */
     notifications: number;
-    /** The C rule this row pins down. */
     rule: string;
 }
 /**
- * The peek guard. Every settable property in this family early-outs on an
- * unchanged value (adw-entry-row.c:984, :1198, :1247), so a redundant set is
- * silent by house rule — which is what makes the web port's unguarded
- * `notify::revealed` on a same-value `setAttribute` a defect.
+ * The peek guard. Every settable property in this family early-outs on an unchanged value,
+ * so a redundant set is silent — an unguarded `notify::revealed` on a same-value
+ * `setAttribute` is a defect.
  */
 export declare const PASSWORD_REVEAL_GUARD_VECTORS: ReadonlyArray<PasswordRevealGuardVector>;

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

@@ -40,6 +40,8 @@ export { BOTTOM_SHEET_CLOSE_VECTORS, BOTTOM_SHEET_PRESENTATION_VECTORS, runBotto
 export type { BottomSheetCloseVector, BottomSheetPresentationAdapter, BottomSheetPresentationStep, BottomSheetPresentationVector, } from './dialog.js';
 export { POPOVER_KEY_VECTORS, POPOVER_SURFACE_VECTORS } from './popover.js';
 export type { PopoverKeyVector, PopoverSurfaceVariant, PopoverSurfaceVector } from './popover.js';
+export { formatShortcutLabelNodes, SHORTCUT_LABEL_VECTORS } from './shortcut-label.js';
+export type { ShortcutLabelVector } from './shortcut-label.js';
 export { SPINNER_ARC_ENVELOPE, SPINNER_ARC_PHASE_VECTORS, SPINNER_ARC_TOLERANCE, SPINNER_CONSTANT_VECTORS, } from './spinner.js';
 export type { SpinnerArcShapeVector, SpinnerConstantVector } from './spinner.js';
 export { WRAP_BOX_CHILD_ORDER_VECTORS, WRAP_BOX_LENGTH_VECTORS, WRAP_BOX_LINE_VECTORS, WRAP_BOX_NATURAL_LENGTH_VECTORS, WRAP_BOX_NOTIFY_PROPERTIES, WRAP_BOX_POLICY_VECTORS, WRAP_BOX_SPACING_NOTIFY_VECTORS, WRAP_BOX_SPACING_VECTORS, } from './wrap-box.js';

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

@@ -124,13 +124,9 @@ export interface NavigationExpectation {
 export interface NavigationVector {
     /** Stable name — also the test title. */
     name: string;
-    /** What rule the row pins down. */
     rule: string;
-    /** The mutations to run, in order. */
     steps: readonly NavigationStep[];
-    /** What must hold afterwards. */
     expect: NavigationExpectation;
-    /** The C function + line the row is derived from. */
     derivedFrom: string;
 }
 /**

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

@@ -9,7 +9,6 @@ export type PopoverSurfaceVariant =
  | 'menu-item';
 /** One popover surface expectation, derived from the vendored stylesheet. */
 export interface PopoverSurfaceVector {
-    /** The surface under test. */
     variant: PopoverSurfaceVariant;
     /** Inner inset in px — where the whitespace around the content actually comes from. */
     padding: number;
@@ -29,29 +28,25 @@ export interface PopoverSurfaceVector {
     selector: string;
     /** Where it is vendored, with lines. */
     source: string;
-    /** Why this row exists. */
     rule: string;
 }
-/** Popover surface metrics (_popovers.scss:13-21, _menus.scss:58-66, :134-138). */
+/** Popover surface metrics (_popovers.scss:13-21, _menus.scss:58-66). */
 export declare const POPOVER_SURFACE_VECTORS: ReadonlyArray<PopoverSurfaceVector>;
 /** One `resolvePopoverKey` expectation. */
 export interface PopoverKeyVector {
     /** `KeyboardEvent.key`. */
     key: string;
-    /** The list state it is resolved against. */
     context: PopoverKeyContext;
-    /** What the renderer must do. */
     expected: PopoverKeyResolution;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * `resolvePopoverKey` — the wrap arithmetic `adw-menu-button.ts` and
  * `adw-drop-down.ts` each carried a copy of, reconciled.
  *
- * The rows that matter are the ones where the copies were WRONG rather than
- * merely duplicated: ArrowUp from an unfocused list (both computed `n - 2`), and
- * Home/End while a search entry owns the caret (the drop-down stole both).
+ * The rows that matter are the ones the two copies got WRONG rather than merely
+ * duplicated: ArrowUp from an unfocused list (both computed `n - 2`), and Home/End while a
+ * search entry owns the caret (the drop-down stole both).
  *
  * CORE-ONLY: GAP — `adw-popover` calls `resolvePopoverKey` on keydown but publishes no readable outcome for a spec to compare. Tracked in #1072
  */