@gjsify/adwaita-web 0.36.0 → 0.38.0

package/lib/types/accent.d.ts

@@ -0,0 +1,28 @@
+import { type AdwAccentColorName } from '@gjsify/adwaita-core';
+/** The custom property carrying the accent fill. */
+export declare const ACCENT_BG_PROPERTY = "--accent-bg-color";
+/** The custom property carrying the standalone accent, for text on the window. */
+export declare const ACCENT_PROPERTY = "--accent-color";
+/** Where and how to apply the accent. */
+export interface ApplyAccentOptions {
+    /** The element to set the properties on. Defaults to `document.documentElement`. */
+    readonly target?: HTMLElement;
+    /**
+     * Which standalone variant to use. Defaults to the target's RESOLVED scheme,
+     * because the standalone colour is the one thing about an accent that differs
+     * between light and dark — reading it beats assuming light.
+     */
+    readonly dark?: boolean;
+}
+/**
+ * Whether `element` is currently rendering dark.
+ *
+ * `.theme-dark` / `.theme-light` are the stylesheet's manual overrides and win
+ * over the media query, so an explicit class is checked first and
+ * `prefers-color-scheme` only decides when neither is present.
+ */
+export declare function isAdwaitaDark(element: HTMLElement): boolean;
+/** Set the accent custom properties for `name`. */
+export declare function applyAdwaitaAccent(name: AdwAccentColorName, options?: ApplyAccentOptions): void;
+/** Drop the properties, so the stylesheet's own values apply again. */
+export declare function clearAdwaitaAccent(target?: HTMLElement): void;

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

@@ -0,0 +1,2 @@
+import '@gjsify/adwaita-web';
+export declare const AdwAccentTest: () => Promise<void>;

package/lib/types/adw-shortcut-label.spec.d.ts

@@ -0,0 +1,2 @@
+import '@gjsify/adwaita-web';
+export declare const AdwShortcutLabelTest: () => Promise<void>;

package/lib/types/breakpoints.d.ts

@@ -2,21 +2,19 @@ import { AdwBreakpoint } from '@gjsify/adwaita-core';
 /**
  * Drive `breakpoints` from `element`'s own box, and return a dispose function.
  *
- * `ResizeObserver` delivers an initial observation on `observe()`, so the
- * breakpoints settle on the correct state before first paint — no flash of the
- * wrong layout, and no separate seeding pass.
- *
- * The size read is the BORDER box in CSS pixels, the browser's counterpart to
- * the `sp`/DIP units an Adwaita condition is written in.
+ * `ResizeObserver` delivers an initial observation on `observe()`, so the breakpoints
+ * settle on the correct state before first paint — no flash of the wrong layout, no
+ * separate seeding pass. The size read is the BORDER box in CSS pixels, the browser's
+ * counterpart to the `sp`/DIP units an Adwaita condition is written in.
  */
 export declare function addBreakpoints(element: Element, breakpoints: readonly AdwBreakpoint[]): () => void;
 /**
- * Wire a `breakpoint="<condition>"` attribute to a boolean setter, the browser
- * equivalent of an `Adw.Breakpoint` with one `add_setter()` call.
+ * Wire a `breakpoint="<condition>"` attribute to a boolean setter, the browser equivalent
+ * of an `Adw.Breakpoint` with one `add_setter()` call. Returns a dispose function; call it
+ * before re-binding and on disconnect.
  *
- * Returns a dispose function; call it before re-binding and on disconnect.
- * A missing or unparsable condition binds nothing and returns a no-op, leaving
- * whatever the attribute already says untouched — an element must not silently
- * flip state because its condition had a typo.
+ * A missing or unparsable condition binds nothing and returns a no-op, leaving whatever
+ * the attribute already says untouched — an element must not silently flip state because
+ * its condition had a typo.
  */
 export declare function bindBreakpointSetter(element: Element, condition: string | null, setValue: (active: boolean) => void): () => void;

package/lib/types/elements/adw-about-dialog.d.ts

@@ -32,7 +32,6 @@ export declare class AdwAboutDialog extends HTMLElement {
     set license(value: string);
     get licenseUrl(): string;
     set licenseUrl(value: string);
-    /** Whether the dialog is presented. */
     get open(): boolean;
     set open(value: boolean);
     get developers(): string[];
@@ -54,62 +53,46 @@ export declare class AdwAboutDialog extends HTMLElement {
     /** The credit groups the Credits page shows, straight from `update_credits`. */
     private _creditsSections;
     /**
-     * Whether the Legal page has anything on it.
-     *
-     * This element's licence model is the simplified one — a name plus an
-     * optional URL — so it maps onto `GtkLicense` as "custom text when a licence
-     * is set, unknown otherwise", which is what `adw_about_dialog_set_license`
-     * does to the type anyway (:3472).
+     * Whether the Legal page has anything on it. This element's licence model is the
+     * simplified one — a name plus an optional URL — so it maps onto `GtkLicense` as
+     * "custom text when a licence is set, unknown otherwise", which is what
+     * `adw_about_dialog_set_license` does to the type anyway.
      */
     private _hasLegal;
-    /** Rebuild the sheet contents from the current attributes / credit lists. */
     private _render;
     /**
      * A navigation page wrapping a header bar (with the close button) + content.
-     *
-     * `headerTitle` defaults to the page title; the main page overrides it,
-     * because its page title is the dialog's ("About", .ui:19) while its header
-     * shows the application name (.ui:30).
+     * `headerTitle` defaults to the page title; the main page overrides it, because its
+     * page title is the dialog's ("About") while its header shows the application name.
      */
     private _buildPage;
-    /** The main page: icon, name, developer, version pill, then the three groups. */
     private _buildMainPage;
     /**
-     * One `AdwPreferencesGroup` in its spacing wrapper.
-     *
-     * `data-group` carries the template's widget id so a test — and a reader —
-     * can tell the four named groups apart; nothing styles off it. The credits
-     * sections pass `null`, because the template has no id for them: they are
-     * built one per section at runtime (:548-549).
+     * One `AdwPreferencesGroup` in its spacing wrapper. `data-group` carries the
+     * template's widget id so a test — and a reader — can tell the named groups apart;
+     * nothing styles off it. The credits sections pass `null`, because the template has
+     * no id for them: they are built one per section at runtime.
      */
     private _buildGroup;
-    /** An activatable row that pushes a subpage, with a trailing go-next chevron. */
     private _buildNavRow;
     /**
-     * Emit `activate-link` and navigate unless a handler took over.
-     *
-     * The GObject signal is `BOOLEAN__STRING` with `g_signal_accumulator_true_handled`
-     * (:2093-2103) and its default handler returns `GDK_EVENT_PROPAGATE`
-     * (:455-460), i.e. "not handled, do the default". A handler returning TRUE
-     * suppresses it — which is what `preventDefault()` on a cancelable event
-     * means, and why `dispatchEvent`'s return value is the gate here.
+     * Emit `activate-link` and navigate unless a handler took over. The GObject signal
+     * is `BOOLEAN__STRING` with `g_signal_accumulator_true_handled` and its default
+     * handler returns `GDK_EVENT_PROPAGATE` ("not handled, do the default"); a handler
+     * returning TRUE suppresses it, which is what `preventDefault()` on a cancelable
+     * event means — hence the gate on `dispatchEvent`'s return value.
      */
     private _activateLink;
-    /** The Details page: comments + the links group (website + future custom links). */
     private _buildDetailsPage;
-    /** A link row that opens a URL in a new tab and emits `activate-link`. */
     private _buildLinkRow;
-    /** The Credits page: one group per section the core assembled. */
     private _buildCreditsPage;
     /**
-     * A credit row — a plain title, or a link row when the entry carries a URI.
-     *
-     * The gate is `link !== null`, not the URI's truthiness: `"Ada <>"` parses to
-     * an EMPTY link, which is still a link in the C (`if (link)` tests the
-     * pointer, :562) and still produces an `AdwLinkRow`, to `mailto:`.
+     * A credit row — a plain title, or a link row when the entry carries a URI. The gate
+     * is `link !== null`, not the URI's truthiness: `"Ada <>"` parses to an EMPTY link,
+     * which is still a link in the C (`if (link)` tests the pointer) and still produces
+     * an `AdwLinkRow`, to `mailto:`.
      */
     private _buildCreditRow;
-    /** The Legal page: copyright + license text. */
     private _buildLegalPage;
     /** Show the header title only once the main page is scrolled (AdwAboutDialog). */
     private _updateHeaderTitle;

package/lib/types/elements/adw-action-row.d.ts

@@ -16,10 +16,9 @@ export declare class AdwActionRow extends HTMLElement {
     /** `Adw.ActionRow:activatable-widget` — the widget this row activates. */
     get activatableWidget(): HTMLElement | null;
     /**
-     * Set the activatable widget. Its sensitivity is copied into `activatable`
-     * right away and then tracked, exactly as libadwaita's `sensitive` →
-     * `activatable` binding does (adw-action-row.c:729-732) — including the part
-     * that surprises: clearing the widget LEAVES the row activatable (C:709).
+     * Set the activatable widget. Its sensitivity is copied into `activatable` right
+     * away and then tracked, as libadwaita's `sensitive` → `activatable` binding does —
+     * including the surprising part: clearing the widget LEAVES the row activatable.
      */
     set activatableWidget(widget: HTMLElement | null);
     /** Whether a click activates this row — `GtkListBoxRow:activatable`. */
@@ -30,15 +29,13 @@ export declare class AdwActionRow extends HTMLElement {
     disconnectedCallback(): void;
     attributeChangedCallback(): void;
     /**
-     * `adw_action_row_activate_real` (adw-action-row.c:297-307): forward the
-     * activation to the activatable widget, then emit `activated`.
+     * `adw_action_row_activate_real`: forward the activation to the activatable widget,
+     * then emit `activated`.
      *
-     * A click that ORIGINATED inside the activatable widget does not activate the
-     * row at all — no forwarding, no `activated`. That is GTK's answer too: the
-     * widget claims the gesture, so `GtkListBox` never emits `row-activated`, and
-     * `pressed_cb` denies anything picked below the row / header / prefixes /
-     * suffixes (C:120-137). It is also what keeps the forwarding from looping —
-     * the synthetic click dispatched below bubbles straight back into this same
+     * A click that ORIGINATED inside the activatable widget does not activate the row at
+     * all — no forwarding, no `activated`. That is GTK's answer too: the widget claims
+     * the gesture, so `GtkListBox` never emits `row-activated`. It is also what keeps the
+     * forwarding from looping — the synthetic click below bubbles back into this same
      * listener, and without the guard one activation emitted `activated` twice.
      */
     private _onClick;

package/lib/types/elements/adw-alert-dialog.d.ts

@@ -24,13 +24,10 @@ export declare class AdwAlertDialog extends HTMLElement {
     private readonly _buttons;
     private _blockCloseResponse;
     static get observedAttributes(): string[];
-    /** The heading of the dialog. */
     get heading(): string;
     set heading(value: string);
-    /** The body text of the dialog. */
     get body(): string;
     set body(value: string);
-    /** Whether the dialog is currently shown. */
     get open(): boolean;
     set open(value: boolean);
     /** Whether to prefer horizontal button layout when the buttons fit. */
@@ -46,23 +43,15 @@ export declare class AdwAlertDialog extends HTMLElement {
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     /** Present the dialog. `parent` is accepted for API parity; unused. */
     present(_parent?: unknown): void;
-    /** Adds a response button with the given ID and label. */
     addResponse(id: string, label: string): void;
     /** Adds multiple responses at once — id/label pairs (Adw.add_responses parity). */
     addResponses(...idLabelPairs: string[]): void;
-    /** Removes a response. */
     removeResponse(id: string): void;
-    /** Whether a response with the given ID exists. */
     hasResponse(id: string): boolean;
-    /** Gets a response's label. */
     getResponseLabel(id: string): string | null;
-    /** Sets a response's label. */
     setResponseLabel(id: string, label: string): void;
-    /** Gets a response's appearance. */
     getResponseAppearance(id: string): AdwResponseAppearance | null;
-    /** Sets a response's appearance (default / suggested / destructive). */
     setResponseAppearance(id: string, appearance: AdwResponseAppearance): void;
-    /** Gets whether a response is enabled. */
     getResponseEnabled(id: string): boolean;
     /** Sets whether a response is enabled (disabled buttons can't be activated). */
     setResponseEnabled(id: string, enabled: boolean): void;
@@ -70,7 +59,6 @@ export declare class AdwAlertDialog extends HTMLElement {
     setDefaultResponse(id: string | null): void;
     /** Sets the close response — emitted on dismissal (Escape / scrim click). */
     setCloseResponse(id: string): void;
-    /** A response button was activated: close, then emit `response`. */
     private _activateResponse;
     /** Dismissal (Escape / scrim) — close, then emit the close-response. */
     private _dismiss;

package/lib/types/elements/adw-avatar.d.ts

@@ -1,6 +1,7 @@
 export declare class AdwAvatar extends HTMLElement {
     private _textEl;
     private _iconEl;
+    private _imageEl;
     private _initialized;
     static get observedAttributes(): string[];
     connectedCallback(): void;

package/lib/types/elements/adw-bottom-sheet.d.ts

@@ -16,27 +16,23 @@ export declare class AdwBottomSheet extends HTMLElement {
     /** Set while the element writes `open` back, so the write does not re-enter. */
     private _reflecting;
     static get observedAttributes(): string[];
-    /** Whether the sheet is revealed. */
     get open(): boolean;
     set open(value: boolean);
-    /** Whether the content is dimmed + blocked while the sheet is open. */
     get modal(): boolean;
     set modal(value: boolean);
     /** Whether the user can dismiss the sheet (dimming / Escape / sheet.close). */
     get canClose(): boolean;
     set canClose(value: boolean);
-    /** Whether the overlaid drag handle is shown. */
     get showDragHandle(): boolean;
     set showDragHandle(value: boolean);
     /**
-     * Route a dismissal affordance through the shared gate and act on the
-     * verdict: close, raise `close-attempt`, forward `sheet.close` to an
-     * ancestor, or do nothing. The element calls this for the dimming layer and
-     * Escape; a close button inside the sheet calls it with `'close-button'`.
+     * Route a dismissal affordance through the shared gate and act on the verdict: close,
+     * raise `close-attempt`, forward `sheet.close` to an ancestor, or do nothing. Called
+     * for the dimming layer and Escape; a close button inside the sheet passes
+     * `'close-button'`.
      *
-     * The verdict differs per source — a locked sheet signals a scrim click but
-     * swallows a swipe, and the drag handle never closes anything. See
-     * `resolveBottomSheetClose` in `@gjsify/adwaita-core`.
+     * The verdict differs PER SOURCE — a locked sheet signals a scrim click but swallows
+     * a swipe, and the drag handle never closes anything (`resolveBottomSheetClose`).
      */
     requestClose(source: BottomSheetCloseSource): BottomSheetCloseOutcome;
     connectedCallback(): void;
@@ -44,7 +40,6 @@ export declare class AdwBottomSheet extends HTMLElement {
     /** The programmatic open/close — `AdwBottomSheet:open`, ungated by `can-close`. */
     private _setOpen;
     private _render;
-    /** Mirror the state onto the `open` attribute (the CSS + markup hook). */
     private _reflectOpen;
     /** Read a boolean attribute: absent → `fallback`, explicit `="false"` → off. */
     private _boolAttr;
@@ -55,7 +50,7 @@ export declare class AdwBottomSheet extends HTMLElement {
      *
      * The `<adw-bottom-sheet-sheet>` / `<adw-bottom-sheet-content>` wrappers are
      * markup, not widgets — GtkBuilder's `<child type="sheet">` leaves nothing in
-     * the tree (adw-bottom-sheet.c:1278-1293) — so the wrapper itself is claimed
+     * the tree — so the wrapper itself is claimed
      * too. It used to fall through to `unslotted` and be appended to the content
      * layer, leaving an empty custom element behind after its children were
      * pulled out.

package/lib/types/elements/adw-button-content.d.ts

@@ -10,10 +10,9 @@ export declare class AdwButtonContent extends HTMLElement {
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
     /**
-     * `adw_button_content_root` (:108-116): the nearest button ancestor, unless
-     * that button's DIRECT parent is a split button — then the split button
-     * takes the class, because `splitbutton.image-text-button > button` is the
-     * rule that styles it (_buttons.scss:499-507).
+     * `adw_button_content_root`: the nearest button ancestor, unless that button's DIRECT
+     * parent is a split button — then the split button takes the class, because
+     * `splitbutton.image-text-button > button` is the rule that styles it.
      */
     private _hostButton;
     private _root;

package/lib/types/elements/adw-button-row.d.ts

@@ -11,7 +11,7 @@ export declare class AdwButtonRow extends HTMLElement {
     attributeChangedCallback(): void;
     private _render;
     /**
-     * Paint one of the two `image.icon.{start,end}` nodes (adw-button-row.c:39-40).
+     * Paint one of the two `image.icon.{start,end}` nodes.
      *
      * The `start` / `end` position class is set once at construction — it is
      * where the node sits, not what it draws — so only the name changes here.

package/lib/types/elements/adw-carousel.d.ts

@@ -27,25 +27,20 @@ export declare class AdwCarousel extends HTMLElement implements CarouselHost {
     private _pendingInteractive;
     static get observedAttributes(): string[];
     constructor();
-    /** Number of pages in the carousel. */
     get nPages(): number;
     /** Fractional scroll position (0 = first page, 1 = second, …). */
     get position(): number;
     /**
-     * Scroll to the page this position settles on.
-     *
-     * `AdwCarousel:position` is READ-ONLY in C (adw-carousel.c:1036-1041) — the
-     * setter is a port convenience, and it resolves the value with the same
-     * `get_page_at_position` rule the carousel uses everywhere else, so setting
-     * 0.5 lands on page 0 exactly as scrolling there would.
+     * Scroll to the page this position settles on. MODIFICATION: `AdwCarousel:position`
+     * is READ-ONLY in C; this setter is a port convenience that resolves through the
+     * same `get_page_at_position` rule, so 0.5 lands on page 0 exactly as scrolling
+     * there would.
      */
     set position(value: number);
-    /** The page the current position settles on, `-1` when the carousel is empty. */
     get currentPage(): number;
     /** Whether the scroll wheel navigates between pages. Defaults to TRUE, as in libadwaita. */
     get allowScrollWheel(): boolean;
     set allowScrollWheel(value: boolean);
-    /** Whether a single flick may cross more than one page. */
     get allowLongSwipes(): boolean;
     set allowLongSwipes(value: boolean);
     /** Whether the carousel can be navigated at all. Defaults to TRUE. */
@@ -57,87 +52,71 @@ export declare class AdwCarousel extends HTMLElement implements CarouselHost {
     connectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
     disconnectedCallback(): void;
-    /** One attribute → one state property. Shared by the initial read and later changes. */
     private _applyAttribute;
     /**
-     * Scroll to `value`, waiting for the first layout when the track has no
-     * width yet.
-     *
-     * `connectedCallback` runs DURING insertion, so the track is still 0px wide
-     * and a scroll offset has nowhere to land — a declared
-     * `<adw-carousel position="2">` silently stayed on page 0. Deferring to the
-     * first non-zero measurement is the only point at which the offset means
-     * anything; a later assignment simply replaces the pending one.
+     * Scroll to `value`, waiting for the first layout when the track has no width yet:
+     * `connectedCallback` runs DURING insertion, so the track is still 0px wide and a
+     * scroll offset has nowhere to land. The first non-zero measurement is the earliest
+     * point at which the offset means anything; a later assignment replaces the pending
+     * one.
      */
     private _positionWhenMeasurable;
     /**
-     * Jump to `value` without the reveal animation.
-     *
-     * A DECLARED position is where the carousel STARTS, not somewhere it travels
-     * to — `<adw-carousel position="2">` should render already showing page 2.
-     * Left smooth, the track is still at offset 0 while the animation runs, and
-     * the `scroll` event that fires from there recomputes the position back to
-     * page 0. So the one assignment is made instant and the caller's
-     * `scroll-behavior` is put back.
+     * Jump to `value` without the reveal animation: a DECLARED position is where the
+     * carousel STARTS, not somewhere it travels to. Left smooth, the track is still at
+     * offset 0 while the animation runs and the `scroll` event fired from there
+     * recomputes the position back to page 0 — so this one assignment is made instant
+     * and the caller's `scroll-behavior` restored.
      */
     private _scrollInstantly;
-    /** Drop a pending declared position and stop watching for a layout. */
     private _cancelPendingPosition;
-    /** Resolve a fractional position to a page and scroll there; a no-op when there is none. */
     private _scrollToPosition;
     /**
-     * Insert `page` at `position` — `adw_carousel_insert` (adw-carousel.c:1370-1407).
+     * Insert `page` at `position` — `adw_carousel_insert`.
      * `-1` or a position past the end appends. Returns whether it was added.
      */
     insertPage(page: HTMLElement, position?: number): boolean;
-    /** `adw_carousel_append` (adw-carousel.c:1348-1357). */
+    /** `adw_carousel_append`. */
     appendPage(page: HTMLElement): boolean;
-    /** `adw_carousel_prepend` (adw-carousel.c:1330-1339). */
+    /** `adw_carousel_prepend`. */
     prependPage(page: HTMLElement): boolean;
-    /** Remove `page` — `adw_carousel_remove` (adw-carousel.c:1508-1532). */
+    /** Remove `page` — `adw_carousel_remove`. */
     removePage(page: HTMLElement): boolean;
-    /** Move `page` — `adw_carousel_reorder` (adw-carousel.c:1419-1499). */
+    /** Move `page` — `adw_carousel_reorder`. */
     reorderPage(page: HTMLElement, position: number): boolean;
     /**
      * Scroll to the page at `index`. Out-of-range, fractional and NaN indices are
      * refused rather than clamped, matching `adw_carousel_get_nth_page`'s
-     * precondition (adw-carousel.c:1616).
+     * precondition.
      */
     scrollToPage(index: number): void;
-    /** One keynav step — `navigate_to_direction` (adw-carousel.c:475-508). */
+    /** One keynav step — `navigate_to_direction`. */
     navigate(direction: 'back' | 'forward'): boolean;
     private _insert;
-    /** The state's id for a page element, or `null` when it is not one of ours. */
     private _idOf;
-    /** Make the DOM order match the model order, and drop slots whose page is gone. */
     private _syncTrack;
     /**
-     * Put the scroll offset back where the model says it is, instantly.
-     *
-     * A page revealed at or before the current one moves the position with it
-     * (`shift_position`, adw-carousel.c:241-258) precisely so the page on screen
-     * does not slide sideways — but a scroll container knows nothing about that
-     * and would keep its old offset, showing the newly-inserted page instead. GTK
-     * gets this for free because the same allocation that adds the child also
-     * lays it out; here it takes one write.
+     * Put the scroll offset back where the model says it is, instantly. A page revealed
+     * at or before the current one moves the position with it (`shift_position`)
+     * precisely so the page on screen does not slide sideways — but a scroll container
+     * keeps its old offset and would show the newly-inserted page instead. GTK gets this
+     * from the allocation that adds the child; here it takes one write.
      */
     private _applyScrollFromModel;
     /**
      * `allow-long-swipes` in CSS: `scroll-snap-stop: always` forces the scroll to
      * stop at every page, which is exactly what the property being FALSE means —
-     * "each swipe can only move to the adjacent pages" (adw-carousel.c:1111-1113).
+     * "each swipe can only move to the adjacent pages".
      */
     private _applySnapStop;
-    /** The px pitch between two page origins — `self->distance` (adw-carousel.c:767). */
+    /** The px pitch between two page origins — `self->distance`. */
     private _distance;
-    /** Run the scroll the state asked for, in the track's own scroll coordinates. */
     private _performScroll;
     private _onScroll;
     private _onWheel;
     private _updatePositionFromScroll;
     private _onStateChange;
 }
-/** Shared base for the dot / line indicator elements. */
 declare abstract class AdwCarouselIndicator extends HTMLElement {
     protected _carousel: CarouselHost | null;
     protected _initialized: boolean;

package/lib/types/elements/adw-checks.d.ts

@@ -8,24 +8,19 @@ declare abstract class AdwCheckBase extends HTMLElement {
     protected abstract get inputType(): 'checkbox' | 'radio';
     /** What a click / Space / arrow key on the control means for this kind. */
     protected abstract activate(): void;
-    /** Whether the control is checked. */
     get checked(): boolean;
     set checked(value: boolean);
     /** Whether the control is in the third, inconsistent state. */
     get indeterminate(): boolean;
     set indeterminate(value: boolean);
-    /** Whether the control is inert. */
     get disabled(): boolean;
     set disabled(value: boolean);
-    /** The label text beside the indicator. */
     get label(): string;
     set label(value: string);
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
-    /** Extra wiring for a subclass on connect. */
     protected onConnected(): void;
-    /** Extra teardown for a subclass on disconnect. */
     protected onDisconnected(): void;
     protected render(): void;
 }
@@ -40,12 +35,11 @@ export declare class AdwRadio extends AdwCheckBase {
     private _unsubscribe;
     static get observedAttributes(): string[];
     protected get inputType(): 'radio';
-    /** The group this member belongs to. */
     get name(): string;
     set name(value: string);
     /**
-     * This member's value. Falls back to the label text so a group authored
-     * without values still has members the group state can tell apart.
+     * This member's value. Falls back to the label text so a group authored without
+     * values still has members the group state can tell apart.
      */
     get value(): string;
     set value(value: string);

package/lib/types/elements/adw-combo-row.d.ts

@@ -12,13 +12,13 @@ export declare class AdwComboRow extends HTMLElement {
     connectedCallback(): void;
     attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
     /**
-     * `model_changed` (adw-combo-row.c:187-195) — one option or none is not a
-     * choice, so the arrow goes and the row stops being activatable.
+     * `model_changed`: one option or none is not a choice, so the arrow goes and the row
+     * stops being activatable.
      *
-     * Both halves have to be expressed: `data-presents-chooser` gates the
-     * `.adw-row-value::after` mask in the stylesheet, and DISABLING the overlaid
-     * `<select>` is what makes the row inert — hiding the arrow alone would leave
-     * a row that still opens a one-entry popup on click.
+     * Both halves have to be expressed — `data-presents-chooser` gates the
+     * `.adw-row-value::after` mask in the stylesheet, and DISABLING the overlaid `<select>`
+     * is what makes the row inert. Hiding the arrow alone leaves a row that still opens a
+     * one-entry popup on click.
      */
     private _syncChooser;
     private _renderText;

package/lib/types/elements/adw-data-grid.d.ts

@@ -8,16 +8,13 @@ export declare class AdwDataGrid extends HTMLElement {
     private _rows;
     private _initialized;
     static get observedAttributes(): string[];
-    /** The column descriptors. Setting rebuilds the grid. */
     get columns(): AdwDataGridColumn[];
     set columns(value: ReadonlyArray<AdwDataGridColumn>);
-    /** The row objects. Setting rebuilds the body. */
     get rows(): AdwDataGridRow[];
     set rows(value: ReadonlyArray<AdwDataGridRow>);
     /** The optional grid caption/title (reflected to the attribute). */
     get caption(): string;
     set caption(value: string);
-    /** Whether every `normal` row is clickable (element-level flag). */
     get interactive(): boolean;
     set interactive(value: boolean);
     connectedCallback(): void;
@@ -25,13 +22,11 @@ export declare class AdwDataGrid extends HTMLElement {
     private _parseJsonAttr;
     private _renderCaption;
     /**
-     * The CSS `grid-template-columns` value derived from the column descriptors.
-     *
-     * The DERIVATION is core's (`dataGridTracks`), because NativeScript needs the
-     * same one for its `ItemSpec`s and can do nothing with a CSS string; the
-     * mapping onto CSS text — including the `minmax(0px, 1fr)` slack track whose
-     * `0px` must keep its unit to round-trip through the CSSOM — is
-     * `dataGridTrackTemplate`.
+     * The CSS `grid-template-columns` value derived from the column descriptors. The
+     * DERIVATION is core's (`dataGridTracks`), because NativeScript needs the same one for
+     * its `ItemSpec`s and can do nothing with a CSS string; the mapping onto CSS text —
+     * including the `minmax(0px, 1fr)` slack track whose `0px` must keep its unit to
+     * round-trip through the CSSOM — is `dataGridTrackTemplate`.
      */
     private _trackTemplate;
     private _columnClasses;

package/lib/types/elements/adw-drop-down.d.ts

@@ -1,11 +1,9 @@
 import './adw-popover.js';
 import type { AdwComboOption, AdwComboOptionInput } from '@gjsify/adwaita-core';
 /**
- * A dropdown option — `value` is the stable id, `label` the shown text.
- *
- * An alias of core's {@link AdwComboOption}: the drop-down and the combo row are
- * the same selection model behind two chromes, and they had two names for one
- * descriptor. Kept exported so the published type name does not break.
+ * A dropdown option — `value` is the stable id, `label` the shown text. An alias of
+ * core's {@link AdwComboOption}, since the drop-down and the combo row are the same
+ * selection model behind two chromes; still exported so the published name keeps working.
  */
 export type AdwDropDownOption = AdwComboOption;
 export declare class AdwDropDown extends HTMLElement {
@@ -24,7 +22,6 @@ export declare class AdwDropDown extends HTMLElement {
     /** The options list. Setting it rebuilds the popover and clamps the selection. */
     get options(): AdwDropDownOption[];
     set options(value: ReadonlyArray<AdwComboOptionInput>);
-    /** Alias of `options` (Gtk.DropDown's model is often called "items"). */
     get items(): AdwDropDownOption[];
     set items(value: ReadonlyArray<AdwComboOptionInput>);
     /** The selected index. Out-of-range values are ignored (Gtk.DropDown:selected). */
@@ -33,12 +30,9 @@ export declare class AdwDropDown extends HTMLElement {
     /** The selected option's value, or '' when empty (Gtk.DropDown:selected-item). */
     get selectedValue(): string;
     set selectedValue(value: string);
-    /** The selected option descriptor, or null when empty. */
     get selectedItem(): AdwDropDownOption | null;
-    /** Whether the search entry is shown in the popover. */
     get enableSearch(): boolean;
     set enableSearch(value: boolean);
-    /** Whether the popover is currently open. */
     get active(): boolean;
     connectedCallback(): void;
     attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
@@ -48,9 +42,7 @@ export declare class AdwDropDown extends HTMLElement {
     private _onButtonKeyDown;
     /** Printable keys inside an OPEN popover, when there is no search entry to type into. */
     private _onPopoverTypeAhead;
-    /** Type-ahead: accumulate keys, focus/select the next matching option. */
     private _typeAhead;
-    /** Filter the visible items by a search query (case-insensitive substring). */
     private _filter;
     private _visibleItems;
     private _renderAll;