@gjsify/adwaita-core 0.36.0 → 0.38.0

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

@@ -2,43 +2,40 @@
 export interface CreditPersonVector {
     /** The raw credit line, as an app puts it in `developers` etc. */
     input: string;
-    /** `*name` after `g_strstrip` (:520, :528, :533). */
+    /** `*name` after `g_strstrip`. */
     name: string;
     /** `*link` — `null` is "no link", `''` is an EMPTY link and still a link. */
     link: string | null;
-    /** `*is_email`, i.e. `*q1 == '<'` (:521). */
+    /** `*is_email`, i.e. `*q1 == '<'`. */
     isEmail: boolean;
-    /** The URI the row gets (`add_credits_section` :571-580). */
+    /** The URI the row gets, per `add_credits_section`. */
     uri: string | null;
-    /** Why this row exists — the rule or edge case it pins down. */
     rule: string;
 }
 /**
- * `parse_person` (adw-about-dialog.c:490-534), verified against real GLib.
+ * `parse_person`, verified against real GLib.
  *
- * Seven of these rows are the browser renderer's divergences, and each was a
- * plausible-looking simplification: anchoring the angle pair at the end of the
- * string, testing the link for `@`, requiring whitespace before a bare URL,
- * accepting `mailto:` as a scheme, `String.trim()` instead of `g_strstrip`,
- * treating index 0 as falsy, and never reaching the `r1 <= q1 + 1` branch.
+ * Seven rows pin the plausible-looking simplifications a re-implementation reaches for:
+ * anchoring the angle pair at the end of the string, testing the link for `@`, requiring
+ * whitespace before a bare URL, accepting `mailto:` as a scheme, `String.trim()` instead
+ * of `g_strstrip`, treating index 0 as falsy, and never reaching the `r1 <= q1 + 1`
+ * branch.
  */
 export declare const CREDIT_PERSON_VECTORS: ReadonlyArray<CreditPersonVector>;
 /** One `translator-credits` split expectation. */
 export interface TranslatorCreditsVector {
-    /** The raw `translator-credits` property value. */
     value: string | null;
     /** The names the "Translated by" section is built from. */
     people: ReadonlyArray<string>;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * The sentinel guard + split (adw-about-dialog.c:603-608), with `g_strsplit`'s
+ * The sentinel guard + split, with `g_strsplit`'s
  * token behaviour verified against GLib 2.88.
  *
  * The empty-string row is the one a port gets wrong: `g_strsplit ("", "\n", 0)`
  * is a ZERO-length vector, so `add_credits_section` bails at `!*people`
- * (:545-546) and no section is drawn; JS `''.split('\n')` is `['']`, which
+ * and no section is drawn, where JS `''.split('\n')` is `['']` and
  * draws the section with one blank row.
  *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
@@ -46,7 +43,6 @@ export interface TranslatorCreditsVector {
 export declare const TRANSLATOR_CREDITS_VECTORS: ReadonlyArray<TranslatorCreditsVector>;
 /** One assembled credits-page expectation. */
 export interface CreditsSectionsVector {
-    /** The credit properties, as an app sets them. */
     input: {
         developers?: ReadonlyArray<string>;
         designers?: ReadonlyArray<string>;
@@ -66,26 +62,25 @@ export interface CreditsSectionsVector {
             uri: string | null;
         }>;
     }>;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `update_credits` (:593-627) — which groups exist, in which order.
+ * `update_credits` — which groups exist, in which order.
  *
- * The order is fixed by the five `add_credits_section` calls (:611-619) followed
- * by the app's own sections in insertion order (:621-625). An empty property is
- * not an empty group, it is no group (:545-546).
+ * The order is fixed by the five `add_credits_section` calls then the
+ * app's own sections in insertion order. An empty property is not an
+ * empty group, it is no group.
  */
 export declare const CREDITS_SECTIONS_VECTORS: ReadonlyArray<CreditsSectionsVector>;
-/** The `update_details` half of the truth table (:1102-1119). */
+/** The `update_details` half of the truth table. */
 export interface AboutDialogDetailsVector {
     /** `website` non-empty. */
     website: boolean;
     /** `comments` non-empty. */
     comments: boolean;
-    /** `add_link` was called at least once (:2820). */
+    /** `add_link` was called at least once. */
     customLinks: boolean;
-    /** `release-notes` non-empty (:1020-1021). */
+    /** `release-notes` non-empty. */
     releaseNotes: boolean;
     /** The seven widgets `update_details` decides. */
     visible: {
@@ -97,21 +92,19 @@ export interface AboutDialogDetailsVector {
         linksGroup: boolean;
         detailsWebsiteRow: boolean;
     };
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `update_details` (:1102-1119), exhaustive over (website, comments,
+ * `update_details`, exhaustive over (website, comments,
  * custom links) plus the two rows that show what release notes add.
  *
- * The row that matters most is `website only`: it is the ONE combination where
- * the website link stays on the main page and no Details row is offered, and it
- * is the combination a port reproduces incorrectly by folding `website` into
- * its "has details" predicate. `show_details` is `has_comments ||
- * has_custom_links` — website is deliberately not in it (:1108).
+ * `website only` matters most: the ONE combination where the website link stays
+ * on the main page and no Details row is offered, and the one a port gets wrong by
+ * folding `website` into its "has details" predicate. `show_details` is
+ * `has_comments || has_custom_links` — website is deliberately not in it.
  */
 export declare const ABOUT_DIALOG_DETAILS_VECTORS: ReadonlyArray<AboutDialogDetailsVector>;
-/** The `update_support` half of the truth table (:1121-1133). */
+/** The `update_support` half of the truth table. */
 export interface AboutDialogSupportVector {
     /** `support-url` non-empty. */
     supportUrl: boolean;
@@ -126,27 +119,25 @@ export interface AboutDialogSupportVector {
         issueRow: boolean;
         troubleshootingRow: boolean;
     };
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `update_support` (:1121-1133), exhaustive.
+ * `update_support`, exhaustive.
  *
- * Every widget here is a child of `support_group`, which the template puts on
- * the MAIN page (adw-about-dialog.ui:146-186) — the class docs say so outright
- * ("displays the following two links on the main page", :87-90). The browser
- * renderer put Support Questions and Report an Issue on the Details page
- * instead, which hid the issue tracker behind a navigation step AND made the
- * Details page appear for a dialog that has no Details content in GTK terms.
+ * Every widget here is a child of `support_group`, which the template puts on the
+ * MAIN page, as both the template and the class docs say. The
+ * browser renderer put Support Questions and Report an Issue on the Details page,
+ * hiding the issue tracker behind a navigation step AND making the Details page
+ * appear for a dialog with no Details content in GTK terms.
  */
 export declare const ABOUT_DIALOG_SUPPORT_VECTORS: ReadonlyArray<AboutDialogSupportVector>;
-/** The `update_credits_legal_group` half of the truth table (:480-487). */
+/** The `update_credits_legal_group` half of the truth table. */
 export interface AboutDialogCreditsLegalVector {
-    /** `credits_box` has children (:629-630). */
+    /** `credits_box` has children. */
     hasCredits: boolean;
-    /** `legal_box` has children (:745-746). */
+    /** `legal_box` has children. */
     hasLegal: boolean;
-    /** `add_acknowledgement_section` was called (:3297). */
+    /** `add_acknowledgement_section` was called. */
     hasAcknowledgements: boolean;
     /** The four widgets, all on the main page. */
     visible: {
@@ -155,12 +146,11 @@ export interface AboutDialogCreditsLegalVector {
         legalRow: boolean;
         acknowledgementsRow: boolean;
     };
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `update_credits_legal_group` (:480-487) with the three template bindings
- * (adw-about-dialog.ui:198, :215, :233), exhaustive.
+ * `update_credits_legal_group` with the three template bindings,
+ * exhaustive.
  *
  * Each row's visibility is bound directly to its page's box, so the group is
  * the OR of the three and never appears empty.
@@ -168,46 +158,37 @@ export interface AboutDialogCreditsLegalVector {
 export declare const ABOUT_DIALOG_CREDITS_LEGAL_VECTORS: ReadonlyArray<AboutDialogCreditsLegalVector>;
 /** One main-page header-field visibility expectation. */
 export interface AboutDialogHeaderVector {
-    /** The property being set. */
     property: 'application-icon' | 'application-name' | 'developer-name' | 'version';
-    /** Its value. */
     value: string;
-    /** Whether the corresponding widget is shown. */
     visible: boolean;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * The four `x && *x` visibility tests on the main page (:2313-2314, :2376-2377,
- * :2426-2427, :2476).
+ * The four `x && *x` visibility tests on the main page.
  *
- * All four are FIRST-CHARACTER tests, so a single space is content. There is no
- * fallback anywhere: an unset application name shows NO label, it does not show
- * the word "Application", and an unset icon shows NO image, not a generic
- * executable glyph. The browser renderer invented both.
+ * All four are FIRST-CHARACTER tests, so a single space is content, and there is no fallback
+ * anywhere: an unset application name shows NO label, an unset icon NO image.
  */
 export declare const ABOUT_DIALOG_HEADER_VECTORS: ReadonlyArray<AboutDialogHeaderVector>;
 /** One template-label expectation. */
 export interface AboutDialogLabelVector {
-    /** Which label. */
     label: 'dialogTitle' | 'detailsRow' | 'websiteRow' | 'supportRow' | 'issueRow' | 'troubleshootingRow' | 'creditsRow' | 'legalRow' | 'acknowledgementsRow' | 'whatsNewRow' | 'detailsPage' | 'creditsPage' | 'legalPage';
     /** The template string, mnemonic marker included. */
     text: string;
     /** What a renderer with no accelerator layer paints (`stripMnemonic`). */
     plain: string;
-    /** Why this row exists. */
     rule: string;
 }
 /**
  * The template labels (adw-about-dialog.ui), with and without their mnemonic
  * markers.
  *
- * `dialogTitle` is the row that catches the invented one: the main navigation
- * page binds its title to `AdwDialog:title`, whose template default is the bare
- * word "About" (.ui:6, :19). The application name is NOT part of it — it appears
- * on its own in the header revealer that fades in on scroll (.ui:29-31). A
- * renderer that titles the page "About <app>" AND labels the dialog "About
- * <app>" says the app's name three times on one screen.
+ * `dialogTitle` catches the invented one: the main navigation page binds its
+ * title to `AdwDialog:title`, whose template default is the bare word "About"
+ * from the template. The application name is NOT part of it — it appears on its own in the
+ * header revealer that fades in on scroll. A renderer titling the
+ * page "About <app>" AND labelling the dialog "About <app>" says the app's name
+ * three times on one screen.
  *
  * CORE-ONLY: a string table the renderers read THROUGH ADW_ABOUT_DIALOG_LABELS; the rendered text is asserted by ABOUT_DIALOG_HEADER/DETAILS_VECTORS
  */
@@ -220,16 +201,15 @@ export interface LicenseInfoVector {
     spdxId: string | null;
     /** `gtk_license_info[i].url`. */
     url: string | null;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * Spot rows from `gtk_license_info` (:215-252) — the ends and the boundaries,
+ * Spot rows from `gtk_license_info` — the ends and the boundaries,
  * not a second copy of the whole table.
  *
  * Index 18 is pinned because `G_STATIC_ASSERT (G_N_ELEMENTS (gtk_license_info)
- * - 1 == GTK_LICENSE_0BSD)` (:253-256) is the C's own check that the table and
- * the enum have not drifted; this is that assertion, ported.
+ * - 1 == GTK_LICENSE_0BSD)` is the C's own drift check; this is that
+ * assertion, ported.
  *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
  */
@@ -240,56 +220,51 @@ export interface LicenseSpdxVector {
     spdxId: string;
     /** The `GtkLicense` it resolves to, or `null` for no match. */
     licenseType: number | null;
-    /** Why this row exists. */
     rule: string;
 }
-/** The two lookup loops in `populate_from_appdata` (:1226-1239).  *
+/**
+ * The two lookup loops in `populate_from_appdata`.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (LICENSE_INFO_VECTORS → the legal section)
  */
 export declare const LICENSE_SPDX_VECTORS: ReadonlyArray<LicenseSpdxVector>;
 /** One `get_license_text` expectation. */
 export interface LicenseTextVector {
-    /** The `GtkLicense` value. */
     licenseType: number;
-    /** The `license` property. */
     license: string;
     /** What the Legal page shows, `null` meaning "no licence text at all". */
     text: string | null;
-    /** Why this row exists. */
     rule: string;
 }
-/** `get_license_text` (:635-651).  *
+/**
+ * `get_license_text`.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
  */
 export declare const LICENSE_TEXT_VECTORS: ReadonlyArray<LicenseTextVector>;
 /** One licence-setter step. */
 export interface LicenseSetterStep {
-    /** Which setter is called. */
     property: 'license' | 'license-type';
-    /** The argument. */
     value: string | number;
 }
 /** One licence-setter sequence expectation. */
 export interface LicenseSetterVector {
     /** The calls, in order, starting from the property defaults. */
     steps: ReadonlyArray<LicenseSetterStep>;
-    /** `license` afterwards. */
     license: string;
-    /** `license-type` afterwards. */
     licenseType: number;
     /** Every `g_object_notify_by_pspec` from every step, concatenated in order. */
     notify: ReadonlyArray<'license' | 'license-type'>;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * The two setters (:3396-3416, :3459-3480), which are ONE state machine.
+ * The two setters, which are ONE state machine.
  *
- * Each notifies BOTH properties whenever it does anything (:3414-3415,
- * :3476-3477), because setting either can move the other. The asymmetry in the
- * early-outs is the trap: `set_license` bails on an unchanged STRING before it
- * would have set the type to custom, so re-assigning the same text after a
- * licence-type change does switch the type, while assigning `""` to an already
+ * Each notifies BOTH properties whenever it does anything, so setting either can move the
+ * other. The trap is the
+ * asymmetry in the early-outs: `set_license` bails on an unchanged STRING before
+ * it would have set the type to custom, so re-assigning the same text after a
+ * licence-type change DOES switch the type, while assigning `""` to an already
  * empty licence does not.
  *
  * CORE-ONLY: a property-ordering table with no rendered surface — the RESULT is ABOUT_DIALOG_CREDITS_LEGAL_VECTORS, which both renderers drive
@@ -297,18 +272,16 @@ export interface LicenseSetterVector {
 export declare const LICENSE_SETTER_VECTORS: ReadonlyArray<LicenseSetterVector>;
 /** One Legal-page visibility expectation. */
 export interface LegalSectionVector {
-    /** The `copyright` property. */
     copyright: string;
-    /** The `license-type`. */
     licenseType: number;
-    /** The `license` text. */
     license: string;
-    /** Whether the app's own legal section is drawn at all (:666-671). */
+    /** Whether the app's own legal section is drawn at all. */
     visible: boolean;
-    /** Why this row exists. */
     rule: string;
 }
-/** `append_legal_section`'s early-outs for the default section (:666-671, :740).  *
+/**
+ * `append_legal_section`'s early-outs for the default section.
+ *
  * CORE-ONLY: an internal step of a pipeline whose COMPOSED result is renderer-driven — driving it separately would assert the same thing twice (ABOUT_DIALOG_CREDITS_LEGAL_VECTORS)
  */
 export declare const LEGAL_SECTION_VECTORS: ReadonlyArray<LegalSectionVector>;

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

@@ -0,0 +1,20 @@
+import type { AdwAccentColorName } from '../accent.js';
+/** One accent → its background and both standalone colours. */
+export interface AccentColorVector {
+    /** The `AdwAccentColor` member, lowercased. */
+    name: AdwAccentColorName;
+    /** `adw_accent_color_to_rgba` — the background colour. */
+    background: string;
+    /** `adw_accent_color_to_standalone_rgba (…, FALSE)` — for a light surface. */
+    standaloneLight: string;
+    /** `adw_accent_color_to_standalone_rgba (…, TRUE)` — for a dark surface. */
+    standaloneDark: string;
+}
+/**
+ * The nine accents of `AdwAccentColor`, measured against libadwaita 1.9.2.
+ *
+ * The background colours also appear in the C as literals; the standalone ones
+ * appear NOWHERE as literals — they are what `min(l, 0.5)` / `max(l, 0.85)`
+ * produce, which is why this table is the only place they are written down.
+ */
+export declare const ACCENT_COLOR_VECTORS: ReadonlyArray<AccentColorVector>;

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

@@ -2,24 +2,21 @@
 export interface LabelVisibilityVector {
     /** The label's text — `null` stands for "property unset / attribute absent". */
     text: string | null;
-    /** Whether the bound label is visible. */
     visible: boolean;
-    /** Why this row exists — the rule or edge case it pins down. */
     rule: string;
 }
 /**
- * `string_is_not_empty` (adw-action-row.c:112-117 ≡ adw-button-row.c:92-97,
- * inlined at adw-window-title.c:208 and :249).
+ * `string_is_not_empty`, declared identically in `adw-action-row.c` and
+ * `adw-button-row.c`.
  *
- * Applies to the TITLE and to the subtitle alike — the bindings are two copies
- * of the same closure (adw-action-row.ui:49-53 and :71-75). The title half is
- * what every port dropped: a row with `title=""` kept a zero-height but
- * line-height-consuming label, and `<adw-window-title>` reserved a title line in
- * every header bar that only had a subtitle.
+ * Applies to the TITLE and the subtitle alike — the `.ui` bindings are two copies of the
+ * same closure. The title half is the one a port drops: a row with `title=""` keeps a
+ * zero-height but line-height-consuming label, and `<adw-window-title>` reserves a title
+ * line in a header bar that only has a subtitle.
  *
- * `' '` is the canary row. The C never trims — `string && string[0]` reads ONE
- * byte — so a single space is a VISIBLE label. A port reaching for
- * `value.trim().length` passes every other row here and fails this one.
+ * `' '` is the canary row. The C never trims — `string && string[0]` reads ONE byte — so
+ * a single space is a VISIBLE label, and a port reaching for `value.trim().length` passes
+ * every other row here and fails this one.
  */
 export declare const LABEL_VISIBILITY_VECTORS: ReadonlyArray<LabelVisibilityVector>;
 /** One step of an {@link ActionRowActivationVector}. */
@@ -47,25 +44,22 @@ export type ActionRowStep =
 };
 /** One `activatable-widget` ↔ `activatable` expectation. */
 export interface ActionRowActivationVector {
-    /** What the scenario is called. */
     name: string;
-    /** The steps to run against a fresh row, in order. */
     steps: readonly ActionRowStep[];
     /** `GtkListBoxRow:activatable` afterwards. */
     activatable: boolean;
     /** `AdwActionRow:activatable-widget` afterwards, by id. */
     activatableWidget: string | null;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_action_row_set_activatable_widget` (adw-action-row.c:696-741).
+ * `adw_action_row_set_activatable_widget`.
  *
  * The two rows that decide whether a port read the C or guessed it:
  * `insensitive-widget-does-not-activate` (the binding is `sensitive` →
- * `activatable` with `G_BINDING_SYNC_CREATE`, C:729-732 — NOT a constant TRUE),
- * and `unsetting-keeps-activatable` (clearing only unbinds, C:709, so the flag
- * stays where the binding last left it — stated outright at C:28-30).
+ * `activatable` with `G_BINDING_SYNC_CREATE`, NOT a constant TRUE), and
+ * `unsetting-keeps-activatable` (clearing only unbinds, so the flag stays where the binding
+ * last left it — the class docs say so outright).
  */
 export declare const ACTION_ROW_ACTIVATION_VECTORS: ReadonlyArray<ActionRowActivationVector>;
 /** One step of a {@link SwitchRowNotifyVector}. */
@@ -81,26 +75,23 @@ export type SwitchRowStep =
 };
 /** One `notify::active` expectation. */
 export interface SwitchRowNotifyVector {
-    /** What the scenario is called. */
     name: string;
-    /** The steps to run against a fresh row, in order. */
     steps: readonly SwitchRowStep[];
     /** `Adw.SwitchRow:active` afterwards. */
     active: boolean;
     /** The `active` value carried by each `notify::active`, in emission order. */
     emitted: readonly boolean[];
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_switch_row_set_active` (C:216-228) → `slider_notify_active_cb` (C:66-77).
+ * `adw_switch_row_set_active` → `slider_notify_active_cb`.
  *
  * `programmatic-set-notifies` is the row the two renderers answered differently:
  * the notify is emitted by the SLIDER's own `notify::active`, which fires
  * whatever wrote it, so there is no programmatic-vs-interactive split to model.
  * `activate-row-toggles` is the row NEITHER had: `adw_switch_row_init` points
- * the activatable-widget at the slider (C:160-162) and the class docs spell out
- * the result (C:23-27).
+ * the activatable-widget at the slider and the class docs spell out
+ * the result.
  */
 export declare const SWITCH_ROW_NOTIFY_VECTORS: ReadonlyArray<SwitchRowNotifyVector>;
 /** One `Adw.ButtonRow` icon expectation. */
@@ -109,15 +100,14 @@ export interface ButtonRowIconVector {
     startIconName: string | null;
     /** `AdwButtonRow:end-icon-name`. */
     endIconName: string | null;
-    /** Whether the leading `image.icon.start` shows (adw-button-row.ui:20-24). */
+    /** Whether the leading `image.icon.start` shows. */
     startIconVisible: boolean;
-    /** Whether the trailing `image.icon.end` shows (adw-button-row.ui:55-59). */
+    /** Whether the trailing `image.icon.end` shows. */
     endIconVisible: boolean;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * The two icons of `Adw.ButtonRow` (C:201-223), each bound through the same
+ * The two icons of `Adw.ButtonRow`, each bound through the same
  * `string_is_not_empty` closure as the title.
  *
  * `end-icon-name` has existed since 1.6 and was missing from BOTH renderers, so
@@ -131,20 +121,16 @@ export interface ButtonRowActivatableVector {
     declared: string | null;
     /** Whether the row activates. Always `true`. */
     activatable: boolean;
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `Adw.ButtonRow` is always activatable — `adw-button-row.ui:5` sets it TRUE in
- * the template, `adw-button-row.c:31` documents it in one line, and the class
- * exposes no property, no setter and no getter for it (the whole public surface
- * is C:270-352: `new`, and the two icon-name pairs).
+ * `Adw.ButtonRow` is always activatable — the template sets it TRUE and the class exposes
+ * no property, no setter and no getter for it; the whole public surface is `new` plus the
+ * two icon-name pairs.
  *
- * The vector exists because the browser renderer had invented an
- * `activatable="false"` opt-out — and `adw-button-row.spec.ts` PINNED the
- * invention with a passing test, which is worse than not testing it: it made the
- * divergence look like a decision. A row that reads its own attribute is a row
- * that has to be told to ignore it.
+ * The vector exists because a renderer had invented an `activatable="false"` opt-out and
+ * its own spec PINNED the invention with a passing test, which made the divergence look
+ * like a decision.
  */
 export declare const BUTTON_ROW_ACTIVATABLE_VECTORS: ReadonlyArray<ButtonRowActivatableVector>;
 /** One step of a {@link WindowTitleVector}. */
@@ -157,25 +143,19 @@ export type WindowTitleStep = {
 };
 /** One `Adw.WindowTitle` expectation. */
 export interface WindowTitleVector {
-    /** What the scenario is called. */
     name: string;
     /** The steps to run against a fresh window title, in order. */
     steps: readonly WindowTitleStep[];
-    /** The title text afterwards. */
     title: string;
-    /** Whether the title label is visible (C:207-208). */
     titleVisible: boolean;
-    /** The subtitle text afterwards. */
     subtitle: string;
-    /** Whether the subtitle label is visible (C:248-249). */
     subtitleVisible: boolean;
     /** Which property each `notify::*` named, in emission order. */
     notified: readonly ('title' | 'subtitle')[];
-    /** Why this row exists. */
     rule: string;
 }
 /**
- * `adw_window_title_set_title` / `_set_subtitle` (C:197-211, C:238-252).
+ * `adw_window_title_set_title` / `_set_subtitle`.
  *
  * `null-over-empty-is-silent` is the one DIVERGENCE in this file, and it is
  * deliberate: libadwaita would notify there, because its guard compares a

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

@@ -4,11 +4,10 @@ export interface AvatarInitialsVector {
     text: string;
     /** What `extract_initials_from_text` produces for it. */
     initials: string;
-    /** Why this row exists — the rule or edge case it pins down. */
     rule: string;
 }
 /**
- * `extract_initials_from_text` (adw-avatar.c:85) — the first character, plus the
+ * `extract_initials_from_text` — the first character, plus the
  * character after the LAST ASCII space when there is one.
  */
 export declare const AVATAR_INITIALS_VECTORS: ReadonlyArray<AvatarInitialsVector>;
@@ -27,17 +26,16 @@ export interface AvatarFontSizeVector {
     size: number;
     /** `sqr_size - padding` for that diameter, rounded to 2dp for the table. */
     maxFontSize: number;
-    /** What the browser renderer's old heuristic asked for, before this landed. */
+    /** The pre-lift browser heuristic, kept as the counter-example. */
     legacyWebGuess: number;
 }
 /**
- * `update_font_size`'s cap (adw-avatar.c:221-227) — the inscribed square
+ * `update_font_size`'s cap — the inscribed square
  * `size / 1.4142` less `max(size * 0.4 - 5, 0)`.
  *
- * `legacyWebGuess` is kept in the table on purpose: it is `size * (size < 32 ?
- * 0.5 : 0.4)`, which OVERFLOWS the cap at 28, 30, 31 and every size from 64 up
- * (the initials spilled out of the circle), and is not even monotonic — it asked
- * for 16px at size 31 and 13px at size 32.
+ * `legacyWebGuess` is kept in the table on purpose: `size * (size < 32 ? 0.5 : 0.4)`
+ * OVERFLOWS the cap at 28, 30, 31 and every size from 64 up (the initials spill out of the
+ * circle), and is not even monotonic — 16px at size 31, 13px at size 32.
  */
 export declare const AVATAR_FONT_SIZE_VECTORS: ReadonlyArray<AvatarFontSizeVector>;
 /** One `avatarMode` expectation. */
@@ -48,10 +46,10 @@ export interface AvatarModeVector {
     mode: 'image' | 'initials' | 'icon';
     rule: string;
 }
-/** `update_visibility` (adw-avatar.c:117). */
+/** `update_visibility`. */
 export declare const AVATAR_MODE_VECTORS: ReadonlyArray<AvatarModeVector>;
 /**
- * `g_str_hash` + `set_class_color` (adw-avatar.c:143).
+ * `g_str_hash` + `set_class_color`.
  *
  * The non-ASCII rows are the ones that matter: GLib hashes the UTF-8 bytes as
  * `signed char`, so a port reading UTF-16 code units picks a different colour