@gjsify/adwaita-core 0.51.1 → 0.53.0

package/lib/types/appearance.d.ts

@@ -0,0 +1,60 @@
+import { type AdwAccentColorName } from './accent.js';
+/**
+ * The system's colour-scheme preference, in the XDG Settings portal's own terms
+ * (`org.freedesktop.appearance color-scheme`: 0 no preference, 1 dark, 2 light).
+ * `no-preference` is an ANSWER — the user chose nothing — and differs from the
+ * field being absent, which means nothing could be read.
+ */
+export type AdwSystemColorScheme = 'light' | 'dark' | 'no-preference';
+/** Every {@link AdwSystemColorScheme}. */
+export declare const ADW_SYSTEM_COLOR_SCHEMES: readonly AdwSystemColorScheme[];
+/**
+ * What the desktop says about its appearance. Every field is optional and an
+ * absent field means UNKNOWN: a reader that cannot answer leaves it out rather
+ * than guessing the default, so a consumer can tell "the user picked blue"
+ * from "nothing was read".
+ */
+export interface DesktopAppearance {
+    /** The system accent, snapped to libadwaita's nine with `nearestAccent`. */
+    readonly accent?: AdwAccentColorName;
+    /** The raw system accent as `#rrggbb`, when the source reports a colour rather than a name. */
+    readonly accentRgb?: string;
+    /** The colour-scheme preference. */
+    readonly colorScheme?: AdwSystemColorScheme;
+}
+/** `<meta name="adw-accent" content="purple">` — one of the nine names, or `system` (see ADR 0078). */
+export declare const ADW_ACCENT_META = "adw-accent";
+/** `<meta name="adw-color-scheme" content="dark">` — an {@link AdwSystemColorScheme}. */
+export declare const ADW_COLOR_SCHEME_META = "adw-color-scheme";
+/**
+ * The `adw-accent` value that asks the page to follow the browser's CSS
+ * `AccentColor` instead of a named accent — for a server that knows it cannot
+ * read the desktop but wants the page to try.
+ */
+export declare const ADW_ACCENT_META_SYSTEM = "system";
+export declare function isAdwSystemColorScheme(value: unknown): value is AdwSystemColorScheme;
+/**
+ * Validate an untrusted value — a JSON payload, a message from another
+ * process — into a {@link DesktopAppearance}. Unknown or malformed fields are
+ * DROPPED, never guessed, so the result can be applied without further checks.
+ */
+export declare function parseDesktopAppearance(raw: unknown): DesktopAppearance;
+/**
+ * The `<meta>` tags that hand `appearance` to a page using
+ * `@gjsify/adwaita-web`, for the server to put in `<head>`. An unknown field
+ * renders no tag, so the page falls through to its next source. The values come
+ * from closed sets, so nothing here needs HTML escaping — anything outside them
+ * is dropped by {@link parseDesktopAppearance} first.
+ */
+export declare function renderAppearanceMeta(appearance: DesktopAppearance): string;
+/** What the handoff tags say, read back. `accent: 'system'` asks for the CSS system colour. */
+export interface AppearanceMeta {
+    readonly accent?: AdwAccentColorName | typeof ADW_ACCENT_META_SYSTEM;
+    readonly colorScheme?: AdwSystemColorScheme;
+}
+/**
+ * Read the handoff tags through `content(name)`, which returns a `<meta>`
+ * tag's `content` or `null` — `document.querySelector` in a browser, a
+ * template's own lookup anywhere else. Unknown values are ignored.
+ */
+export declare function appearanceFromMeta(content: (name: string) => string | null | undefined): AppearanceMeta;

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

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

package/lib/types/apple-accent.d.ts

@@ -0,0 +1,18 @@
+import type { AdwAccentColorName } from './accent.js';
+/**
+ * `AppleAccentColor`'s values → the Adwaita accent of the same name.
+ * `-1` graphite, `0` red, `1` orange, `2` yellow, `3` green, `4` blue, `5` purple, `6` pink.
+ */
+export declare const APPLE_ACCENT_COLORS: Readonly<Record<number, AdwAccentColorName>>;
+/** The accent for "Multicolor" (key absent): the app's own, and an Adwaita app's own is blue. */
+export declare const APPLE_MULTICOLOR_ACCENT: AdwAccentColorName;
+/**
+ * The Adwaita accent for an `AppleAccentColor` value.
+ *
+ * Takes what `defaults read` prints (surrounding whitespace allowed) or the
+ * number itself. `null`/`undefined` means the key is absent — Multicolor —
+ * and gives {@link APPLE_MULTICOLOR_ACCENT}. Anything else macOS does not
+ * define (a new value, a non-integer) gives `null`, never a guess: the caller
+ * then keeps whatever it would do without a system accent.
+ */
+export declare function adwAccentFromAppleAccentColor(value: string | number | null | undefined): AdwAccentColorName | null;

package/lib/types/apple-accent.spec.d.ts

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

package/lib/types/box.d.ts

@@ -0,0 +1,18 @@
+/** `Gtk.Box:spacing`'s default — `0` in the pspec. */
+export declare const DEFAULT_BOX_SPACING = 0;
+/** `Gtk.Orientation`'s two nicks — the value `orientation` takes on every surface. */
+export type BoxOrientation = 'horizontal' | 'vertical';
+/**
+ * A spacing value as the box will hold it: a finite, non-negative number.
+ *
+ * The pspec's minimum is 0, and a negative write lands there — measured on `Gtk.Box`
+ * under gjs 1.88.1 / gtk 4.22.4 (`conformance/box.ts` records the rows).
+ * A box that pulled its children together would look like a theme bug, not a refusal.
+ */
+export declare function normalizeBoxSpacing(value: unknown): number;
+/**
+ * `GtkOrientable:orientation` from its nick. Anything but `vertical` is the pspec
+ * default, `horizontal` — the same answer an unknown enum nick gets from GtkBuilder,
+ * which rejects it and leaves the property untouched.
+ */
+export declare function normalizeBoxOrientation(value: unknown): BoxOrientation;

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

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

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

@@ -18,3 +18,24 @@ export interface AccentColorVector {
  * produce, which is why this table is the only place they are written down.
  */
 export declare const ACCENT_COLOR_VECTORS: ReadonlyArray<AccentColorVector>;
+/** One colour a desktop may report → the accent libadwaita snaps it to. */
+export interface NearestAccentVector {
+    /** The system colour, `#rrggbb`. */
+    color: string;
+    /** `adw_accent_color_nearest_from_rgba (color)`, lowercased. */
+    expected: AdwAccentColorName;
+    /** Which palette the colour comes from, as libadwaita's test groups it. */
+    source: string;
+}
+/**
+ * `adw_accent_color_nearest_from_rgba` reference cases, transcribed verbatim
+ * from libadwaita's own test (`tests/test-accent-color.c` at the pinned
+ * `refs/libadwaita` commit): the GNOME icon palette and the accent sets of
+ * elementary, KDE, Ubuntu, Cinnamon, COSMIC and macOS. Unlike the table above
+ * these are upstream's EXPECTATIONS, not a runtime read-out: the function is
+ * private in libadwaita, so introspection cannot reach it.
+ *
+ * The test's first loop, each of the nine palette colours mapping to itself,
+ * is asserted from `ACCENT_COLOR_VECTORS` rather than repeated here.
+ */
+export declare const NEAREST_ACCENT_VECTORS: ReadonlyArray<NearestAccentVector>;

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

@@ -0,0 +1,13 @@
+import type { AdwAccentColorName } from '../accent.js';
+import type { DesktopAppearance } from '../appearance.js';
+export interface AppearanceHandoffVector {
+    /** What the server read. May carry values outside the closed sets, as untrusted input does. */
+    appearance: DesktopAppearance;
+    /** The exact tags `renderAppearanceMeta` must write. */
+    meta: string;
+    /** The accent the page paints from those tags; `null` = the stylesheet's own blue. */
+    paints: AdwAccentColorName | null;
+    /** The theme class the page puts on `<html>`, or `null`. */
+    themeClass: 'theme-dark' | 'theme-light' | null;
+}
+export declare const APPEARANCE_HANDOFF_VECTORS: ReadonlyArray<AppearanceHandoffVector>;

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

@@ -0,0 +1,21 @@
+/** One authored `spacing` and the gap the box lays out with. */
+export interface BoxSpacingVector {
+    /** As authored: a number from code, a string from an attribute, `null` when absent. */
+    value: number | string | null;
+    spacing: number;
+    rule: string;
+}
+/**
+ * `Gtk.Box:spacing`. The negative rows are the ones a port gets wrong quietly — measured
+ * under gjs 1.88.1 / gtk 4.22.4, a negative write reads back as 0, so a box never pulls
+ * its children together.
+ */
+export declare const BOX_SPACING_VECTORS: ReadonlyArray<BoxSpacingVector>;
+/** One authored `orientation` and the axis the box stacks along. */
+export interface BoxOrientationVector {
+    value: string | null;
+    orientation: 'horizontal' | 'vertical';
+    rule: string;
+}
+/** `GtkOrientable:orientation`, read by nick as GtkBuilder reads an enum. */
+export declare const BOX_ORIENTATION_VECTORS: ReadonlyArray<BoxOrientationVector>;

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

@@ -1,4 +1,4 @@
-import type { BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetTeardownCallback } from '../dialog.js';
+import type { BottomSheetChrome, BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetOpenOutcome, BottomSheetOpenSource, BottomSheetSwipeTrackerConfig, BottomSheetSwipeTrackerState, BottomSheetTeardownCallback } from '../dialog.js';
 /** One `resolveBottomSheetClose` expectation. */
 export interface BottomSheetCloseVector {
     /** Which affordance asked to close. */
@@ -90,3 +90,125 @@ export declare function runBottomSheetSteps(adapter: BottomSheetPresentationAdap
  * carrying an unchanged payload.
  */
 export declare const BOTTOM_SHEET_PRESENTATION_VECTORS: ReadonlyArray<BottomSheetPresentationVector>;
+/** One `resolveBottomSheetOpen` expectation. */
+export interface BottomSheetOpenVector {
+    /** Which affordance asked to open. */
+    source: BottomSheetOpenSource;
+    /** `AdwBottomSheet:open` at the time of the request. */
+    open: boolean;
+    /** `AdwBottomSheet:can-open` at the time of the request. */
+    canOpen: boolean;
+    /** Whether `AdwBottomSheet:bottom-bar` is set. */
+    hasBottomBar: boolean;
+    /** `AdwBottomSheet:reveal-bottom-bar`. */
+    revealBottomBar: boolean;
+    /** What the C source does with it. */
+    outcome: BottomSheetOpenOutcome;
+    rule: string;
+    derivedFrom: string;
+}
+/**
+ * Every distinguishable `(source, open, canOpen, hasBottomBar, revealBottomBar)` the open
+ * gate answers differently for — so a renderer cannot pass by wiring the bar to `open = true`
+ * and calling it done.
+ */
+export declare const BOTTOM_SHEET_OPEN_VECTORS: ReadonlyArray<BottomSheetOpenVector>;
+/** One `resolveBottomSheetSwipeTracker` expectation. */
+export interface BottomSheetSwipeTrackerVector {
+    /** The four properties `update_swipe_tracker` reads. */
+    state: BottomSheetSwipeTrackerState;
+    /** The three settings it writes. */
+    config: BottomSheetSwipeTrackerConfig;
+    rule: string;
+    derivedFrom: string;
+}
+/**
+ * `update_swipe_tracker`'s three assignments, row by row.
+ *
+ * CORE-ONLY: an `AdwSwipeTracker` has no counterpart in either port — neither renderer runs a
+ * gesture tracker, so there is no object to read these settings off. Its `enabled` line is
+ * the same fact as the `'swipe'` rows of BOTTOM_SHEET_OPEN_VECTORS and BOTTOM_SHEET_CLOSE_VECTORS,
+ * which both renderers drive against their real widgets; this table is the third assignment
+ * and the conjunction written out, not a second source of truth.
+ */
+export declare const BOTTOM_SHEET_SWIPE_TRACKER_VECTORS: ReadonlyArray<BottomSheetSwipeTrackerVector>;
+/** One step of a {@link BottomSheetBottomBarVector}, in the order it is applied. */
+export type BottomSheetBottomBarStep = 
+/** `adw_bottom_sheet_set_bottom_bar` — a widget, or NULL. */
+{
+    readonly kind: 'setBottomBar';
+    readonly present: boolean;
+}
+/** `adw_bottom_sheet_set_can_open`. */
+ | {
+    readonly kind: 'setCanOpen';
+    readonly canOpen: boolean;
+}
+/** `adw_bottom_sheet_set_reveal_bottom_bar`. */
+ | {
+    readonly kind: 'setRevealBottomBar';
+    readonly reveal: boolean;
+}
+/** `adw_bottom_sheet_set_modal`. */
+ | {
+    readonly kind: 'setModal';
+    readonly modal: boolean;
+}
+/** The programmatic path — `adw_bottom_sheet_set_open`, ignores `can-open`. */
+ | {
+    readonly kind: 'setOpen';
+    readonly open: boolean;
+}
+/** The interactive path — runs the {@link BOTTOM_SHEET_OPEN_VECTORS} gate. */
+ | {
+    readonly kind: 'requestOpen';
+    readonly source: BottomSheetOpenSource;
+};
+/**
+ * One end-to-end bottom-bar expectation.
+ *
+ * Every field is observable from a RENDERER: `chrome` is what it has to paint (which layer
+ * shows, whether the surface is on screen, whether the bar looks inert) and `notifications`
+ * is the `notify::open` stream. So the same row drives the core suite and both renderer
+ * suites against their real widgets.
+ */
+export interface BottomSheetBottomBarVector {
+    /** Applied in order, through the surface every implementation exposes. */
+    steps: readonly BottomSheetBottomBarStep[];
+    /** The outcome of each `requestOpen` step, in order. */
+    outcomes: readonly BottomSheetOpenOutcome[];
+    /** Every `notify::open` payload, in order. */
+    notifications: readonly boolean[];
+    /** `open` after the last step. */
+    open: boolean;
+    /** What the renderer must be showing after the last step. */
+    chrome: BottomSheetChrome;
+    rule: string;
+    derivedFrom: string;
+}
+/**
+ * The three-plus-two-method surface a {@link BottomSheetBottomBarVector} is replayed
+ * against. Core implements it directly; each renderer implements it by driving its REAL
+ * widget (adopting a bar child, writing an attribute, clicking the bar).
+ */
+export interface BottomSheetBottomBarAdapter {
+    /** Give the sheet a bottom bar, or take it away (`AdwBottomSheet:bottom-bar`). */
+    setBottomBar(present: boolean): void;
+    /** `AdwBottomSheet:can-open`. */
+    setCanOpen(canOpen: boolean): void;
+    /** `AdwBottomSheet:reveal-bottom-bar`. */
+    setRevealBottomBar(reveal: boolean): void;
+    /** `AdwBottomSheet:modal`. */
+    setModal(modal: boolean): void;
+    /** The programmatic path (`AdwBottomSheet:open`). */
+    setOpen(open: boolean): void;
+    /** The interactive path — returns what the gate decided. */
+    requestOpen(source: BottomSheetOpenSource): BottomSheetOpenOutcome;
+}
+/**
+ * Replay a vector's steps against `adapter`, collecting the outcome of each `requestOpen`
+ * step in order. Shared by all three suites so no side can drift in HOW it replays a row.
+ */
+export declare function runBottomSheetBottomBarSteps(adapter: BottomSheetBottomBarAdapter, steps: readonly BottomSheetBottomBarStep[]): BottomSheetOpenOutcome[];
+/** The bottom bar's life as scripts: adopting one, gating it, revealing it, clicking it. */
+export declare const BOTTOM_SHEET_BOTTOM_BAR_VECTORS: ReadonlyArray<BottomSheetBottomBarVector>;

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

@@ -12,8 +12,8 @@ export { BUTTON_STYLE_CLASS_VECTORS } from './button.js';
 export type { ButtonStyleClassVector } from './button.js';
 export { RADIO_GROUP_VECTORS } from './checks.js';
 export type { RadioGroupStep, RadioGroupVector } from './checks.js';
-export { COMBO_CHOOSER_VECTORS, COMBO_SELECTION_VECTORS } from './rows.js';
-export type { ComboChooserVector, ComboSelectionStep, ComboSelectionVector } from './rows.js';
+export { COMBO_CHOOSER_VECTORS, COMBO_SELECTION_VECTORS, TOGGLE_ACTIVE_NAME_VECTORS } from './rows.js';
+export type { ComboChooserVector, ComboSelectionStep, ComboSelectionVector, ToggleActiveNameVector } from './rows.js';
 export { VIEW_STACK_ICON_NAME_VECTORS, VIEW_STACK_PAGE_VECTORS, VIEW_STACK_VECTORS } from './view-stack.js';
 export type { ViewStackIconNameVector, ViewStackPageDescriptorVector, ViewStackVector, ViewStackVectorChange, ViewStackVectorOp, ViewStackVectorPage, } from './view-stack.js';
 export { NAVIGATION_VIEW_VECTORS, collectNavigationState, navigationEventLog, runNavigationSteps, } from './navigation-view.js';
@@ -44,21 +44,31 @@ export { CASE_FOLD_VECTORS, MAKE_COMPARABLE_VECTORS, PREFERENCES_GROUP_HEADER_VE
 export type { CaseFoldVector, MakeComparableVector, PreferencesGroupHeaderVector, PreferencesSearchExpectation, PreferencesSearchVector, RowMatchVector, SearchCorpusVector, SearchRowSubtitleVector, StripMarkupVector, StripMnemonicVector, } from './preferences.js';
 export { CLAMP_ALLOCATE_VECTORS, CLAMP_CHILD_SIZE_VECTORS, CLAMP_PROPERTY_VECTORS, CLAMP_SIZE_FROM_CHILD_VECTORS, CLAMP_THRESHOLD_VECTORS, SPINNER_GEOMETRY_VECTORS, SPINNER_SIZE_VECTORS, TOOLBAR_VIEW_ALLOCATE_VECTORS, TOOLBAR_VIEW_CLASS_VECTORS, TOOLBAR_VIEW_CONTENT_FOR_SIZE_VECTORS, TOOLBAR_VIEW_MEASURE_VECTORS, } from './chrome.js';
 export type { ClampAllocateVector, ClampChildSizeVector, ClampPropertyVector, ClampSizeFromChildVector, ClampThresholdsVector, SpinnerGeometryVector, SpinnerSizeVector, ToolbarViewAllocateVector, ToolbarViewClassVector, ToolbarViewContentForSizeVector, ToolbarViewMeasureVector, } from './chrome.js';
-export { BOTTOM_SHEET_CLOSE_VECTORS, BOTTOM_SHEET_PRESENTATION_VECTORS, runBottomSheetSteps } from './dialog.js';
-export type { BottomSheetCloseVector, BottomSheetPresentationAdapter, BottomSheetPresentationStep, BottomSheetPresentationVector, } from './dialog.js';
+export { BOTTOM_SHEET_BOTTOM_BAR_VECTORS, BOTTOM_SHEET_CLOSE_VECTORS, BOTTOM_SHEET_OPEN_VECTORS, BOTTOM_SHEET_PRESENTATION_VECTORS, BOTTOM_SHEET_SWIPE_TRACKER_VECTORS, runBottomSheetBottomBarSteps, runBottomSheetSteps, } from './dialog.js';
+export type { BottomSheetBottomBarAdapter, BottomSheetBottomBarStep, BottomSheetBottomBarVector, BottomSheetCloseVector, BottomSheetOpenVector, BottomSheetPresentationAdapter, BottomSheetPresentationStep, BottomSheetPresentationVector, BottomSheetSwipeTrackerVector, } from './dialog.js';
 export { POPOVER_KEY_VECTORS, POPOVER_SURFACE_VECTORS } from './popover.js';
 export type { PopoverKeyVector, PopoverSurfaceVariant, PopoverSurfaceVector } from './popover.js';
-export { ACCENT_COLOR_VECTORS } from './accent.js';
-export type { AccentColorVector } from './accent.js';
+export { ACCENT_COLOR_VECTORS, NEAREST_ACCENT_VECTORS } from './accent.js';
+export type { AccentColorVector, NearestAccentVector } from './accent.js';
+export { APPEARANCE_HANDOFF_VECTORS } from './appearance.js';
+export type { AppearanceHandoffVector } from './appearance.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 { BOX_ORIENTATION_VECTORS, BOX_SPACING_VECTORS } from './box.js';
+export type { BoxOrientationVector, BoxSpacingVector } from './box.js';
+export { LABEL_CHAR_COUNT_VECTORS, LABEL_DISPLAY_TEXT_VECTORS, LABEL_EFFECTIVE_LINES_VECTORS, LABEL_ELLIPSIZE_OVERFLOW_VECTORS, LABEL_ELLIPSIZE_VECTORS, LABEL_JUSTIFY_VECTORS, LABEL_WIDTH_CHARS_EXTENT_VECTORS, LABEL_WRAP_MODE_VECTORS, LABEL_XALIGN_VECTORS, LABEL_YALIGN_ALIGN_ITEMS_VECTORS, LABEL_YALIGN_VECTORS, } from './label.js';
+export type { LabelCharCountVector, LabelDisplayTextVector, LabelEffectiveLinesVector, LabelEllipsizeOverflowVector, LabelEllipsizeVector, LabelJustifyVector, LabelWidthCharsExtentVector, LabelWrapModeVector, LabelXalignVector, LabelYalignAlignItemsVector, LabelYalignVector, } from './label.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';
 export type { WrapBoxChildOrderVector, WrapBoxLengthVector, WrapBoxLineVector, WrapBoxNaturalLengthVector, WrapBoxPolicyVector, WrapBoxSpacingNotifyVector, WrapBoxSpacingVector, } from './wrap-box.js';
 export { BREAKPOINT_PICK_VECTORS, BREAKPOINT_TRANSITION_VECTORS } from './breakpoint-bin.js';
 export type { BreakpointPickVector, BreakpointTransitionVector } from './breakpoint-bin.js';
 export { HEADER_BAR_PACK_VECTORS, HEADER_BAR_TITLE_SOURCE_VECTORS, HEADER_BAR_TITLE_WIDGET_VECTORS, } from './header-bar.js';
 export type { HeaderBarPackVector, HeaderBarTitleSourceVector, HeaderBarTitleWidgetVector } from './header-bar.js';
-export { SHARED_TREE_BLOCKS_WITHOUT_EXPECTATIONS, SHARED_TREE_TABLES, authoredNodes, authoredTags, reachedTables, sharedTreeExpectations, subjectIndexOf, } from './shared-trees.js';
-export type { SharedTreeExpectation, SharedTreeNode, SharedTreeObservable } from './shared-trees.js';
+export { ATTRIBUTE_OF_VECTORS, HOST_TAG_VECTORS, PROPERTY_OF_VECTORS } from './tags.js';
+export type { AttributeOfVector, HostTagVector, PropertyOfVector } from './tags.js';
+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';

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

@@ -0,0 +1,115 @@
+/** One `label` + flags and the text shown. */
+export interface LabelDisplayTextVector {
+    label: string;
+    useMarkup: boolean;
+    useUnderline: boolean;
+    text: string;
+    rule: string;
+}
+export declare const LABEL_DISPLAY_TEXT_VECTORS: ReadonlyArray<LabelDisplayTextVector>;
+/** One authored `xalign` and the value the label holds. */
+export interface LabelXalignVector {
+    value: number | string | null;
+    xalign: number;
+    rule: string;
+}
+/** `gtk_label_set_xalign` CLAMPs to 0…1 itself; the pspec default is 0.5. */
+export declare const LABEL_XALIGN_VECTORS: ReadonlyArray<LabelXalignVector>;
+/** One authored `justify` and the `Gtk.Justification` nick the label holds. */
+export interface LabelJustifyVector {
+    value: string | null;
+    justify: 'left' | 'right' | 'center' | 'fill';
+    rule: string;
+}
+export declare const LABEL_JUSTIFY_VECTORS: ReadonlyArray<LabelJustifyVector>;
+/** One authored `yalign` and the value the label holds. Same shape as `xalign`. */
+export interface LabelYalignVector {
+    value: number | string | null;
+    yalign: number;
+    rule: string;
+}
+/** `gtk_label_set_yalign` CLAMPs to 0…1 itself; the pspec default is 0.5. */
+export declare const LABEL_YALIGN_VECTORS: ReadonlyArray<LabelYalignVector>;
+/** One `yalign` and the `align-items` zone it is nearest to. */
+export interface LabelYalignAlignItemsVector {
+    yalign: number;
+    alignItems: 'flex-start' | 'center' | 'flex-end';
+    rule: string;
+}
+/**
+ * TRUE nearest-of-three, not a strict half-split: the boundary between "nearest 0" and
+ * "nearest 0.5" is their midpoint, `0.25`, and symmetrically `0.75` on the other side —
+ * a `yalign` short of a full CSS continuum still lands on the CLOSER zone rather than
+ * whichever half of `[0, 1]` it falls in. Exact at the three values GTK's own default and
+ * both edges take (0, 0.5, 1); the four intermediate rows (`0.2`/`0.3`/`0.7`/`0.8`) are the
+ * ones a strict `< 0.5`/`> 0.5` split gets wrong — `0.3` is closer to `0.5` than to `0`,
+ * so it belongs in `center`, not `flex-start`.
+ */
+export declare const LABEL_YALIGN_ALIGN_ITEMS_VECTORS: ReadonlyArray<LabelYalignAlignItemsVector>;
+/** One authored `ellipsize` and the `Pango.EllipsizeMode` nick the label holds. */
+export interface LabelEllipsizeVector {
+    value: string | null;
+    ellipsize: 'none' | 'start' | 'middle' | 'end';
+    rule: string;
+}
+/** `Pango-1.0.gir`'s four `EllipsizeMode` nicks, read via `gi://Pango` under gjs 1.88.1. */
+export declare const LABEL_ELLIPSIZE_VECTORS: ReadonlyArray<LabelEllipsizeVector>;
+/** One `Pango.EllipsizeMode` nick and the ONE truncating value both renderers can draw. */
+export interface LabelEllipsizeOverflowVector {
+    ellipsize: 'none' | 'start' | 'middle' | 'end';
+    overflow: 'clip' | 'ellipsis';
+    rule: string;
+}
+/**
+ * Neither CSS `text-overflow` nor NativeScript's `textOverflow` has a start- or
+ * middle-truncating mode — see `labelEllipsizeOverflowValue`'s own comment for why every
+ * non-`none` mode draws an end-ellipsis rather than a silent `clip`. `start` and `middle`
+ * are the DECLARED divergence these two rows pin.
+ */
+export declare const LABEL_ELLIPSIZE_OVERFLOW_VECTORS: ReadonlyArray<LabelEllipsizeOverflowVector>;
+/** One authored `wrap-mode` and the `Pango.WrapMode` nick the label holds. */
+export interface LabelWrapModeVector {
+    value: string | null;
+    wrapMode: 'word' | 'char' | 'word-char';
+    rule: string;
+}
+/** `Pango-1.0.gir`'s three `WrapMode` nicks, read via `gi://Pango` under gjs 1.88.1. */
+export declare const LABEL_WRAP_MODE_VECTORS: ReadonlyArray<LabelWrapModeVector>;
+/** One authored value and the int `width-chars` / `max-width-chars` / `lines` all hold. */
+export interface LabelCharCountVector {
+    value: number | string | null;
+    count: number;
+    rule: string;
+}
+/**
+ * `width-chars`, `max-width-chars` and `lines` share one pspec shape — floor `-1`, default
+ * `-1` — so one table drives all three normalizers in `label.spec.ts`. Measured through
+ * `label.set_property()`, the door an attribute-driven tree uses (`label.ts`'s header).
+ */
+export declare const LABEL_CHAR_COUNT_VECTORS: ReadonlyArray<LabelCharCountVector>;
+/** One `lines` / `ellipsize` combination and the line count a renderer applies. */
+export interface LabelEffectiveLinesVector {
+    lines: number;
+    ellipsize: 'none' | 'start' | 'middle' | 'end';
+    effective: number | null;
+    rule: string;
+}
+/**
+ * MEASURED (a real `Gtk.Label`, allocated, gjs 1.88.1 / gtk 4.22.5) — `wrap` is
+ * deliberately not a column here, because it changes NONE of these outcomes.
+ * `wrap=TRUE, ellipsize=NONE, lines=2` laid out 15 lines (the cap ignored);
+ * `wrap=FALSE, ellipsize=END, lines=2` laid out exactly 2, ellipsized. `label.ts`'s header
+ * carries the fuller measurement, including the two prior, WRONG readings of the pspec's
+ * "has no effect if the label is not wrapping or ellipsized" this table replaced.
+ */
+export declare const LABEL_EFFECTIVE_LINES_VECTORS: ReadonlyArray<LabelEffectiveLinesVector>;
+/** One `width-chars` + `max-width-chars` pair and the `ch`-unit extent it derives. */
+export interface LabelWidthCharsExtentVector {
+    widthChars: number;
+    maxWidthChars: number;
+    minCh: number | null;
+    maxCh: number | null;
+    rule: string;
+}
+/** `get_default_widths` (gtklabel.c): minimum is `width-chars`, natural is their MAX. */
+export declare const LABEL_WIDTH_CHARS_EXTENT_VECTORS: ReadonlyArray<LabelWidthCharsExtentVector>;

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

@@ -15,7 +15,7 @@ export interface ListNormalizeVector {
  *
  * The NativeScript widgets take the same input and NOTHING there asserts it. That
  * package's specs reach `ComboState` and never the widget class, for the reason
- * `drop-down.spec.ts`' own header gives, and the gap is filed in `status/open-todos.md`
+ * `drop-down.spec.ts`' own header gives, and the gap is filed in `status/open-todos/README.md`
  * under "The NativeScript list-model setter is held by core's vectors, not by a widget
  * test". This docblock used to say "every surface that takes a `model` … must answer
  * these rows: … the NativeScript widgets through theirs", which reads as coverage for a

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

@@ -65,3 +65,32 @@ export interface ComboChooserVector {
  * which is why this lives on the combo ROW rather than in the shared chooser.
  */
 export declare const COMBO_CHOOSER_VECTORS: ReadonlyArray<ComboChooserVector>;
+/** One authored `active-name`, over toggles carrying these names. */
+export interface ToggleActiveNameVector {
+    /** Each authored toggle's `name`, in document order; `null` is unnamed. */
+    names: readonly (string | null)[];
+    /** The authored `Adw.ToggleGroup:active-name`. */
+    activeName: string;
+    /** How many toggles the group keeps — `keptToggles`, the buttons a built group draws. */
+    kept: number;
+    /** What `toggleIndexOfName` answers over the kept names — `-1` for none. */
+    index: number;
+    /** The button a BUILT group shows active afterwards. */
+    active: number;
+    rule: string;
+}
+/**
+ * `adw_toggle_group_set_active_name` (adw-toggle-group.c:1989) resolves the name through
+ * the table `add_toggle` fills (:898), and a `.blp` writes it BEFORE the toggles exist —
+ * GtkBuilder sets properties first and children after, which is why the C holds the name
+ * back in `delayed_active_name` until `parser_finished` (:1247). `active` is therefore a
+ * row about the built tree, not about the lookup: a renderer that resolves the name the
+ * moment it is written finds no toggles and drops it.
+ *
+ * The first toggle is active before the name is applied, because `add_toggle` activates
+ * the first toggle it is given (:903). Every row was measured against libadwaita 1.9.3
+ * through `Gtk.Builder`, and the shared-name row is the one the source reading got wrong
+ * first: the table insert at :898 looks like "last one wins", but :849 refuses the second
+ * toggle before it is ever reached.
+ */
+export declare const TOGGLE_ACTIVE_NAME_VECTORS: ReadonlyArray<ToggleActiveNameVector>;