@gjsify/adwaita-core 0.36.0 → 0.38.0

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

@@ -1,21 +1,16 @@
-/** How long the empty↔filled title transition runs — adw-entry-row.c:18. */
+/** How long the empty↔filled title transition runs — adw-entry-row.c. */
 export declare const EMPTY_ANIMATION_DURATION_MS = 150;
 /**
- * Gap between the shrunken title and the text baseline, in px —
- * adw-entry-row.c:19 (`TITLE_SPACING`), used in the vertical measure (C:318,320)
- * and in both the title offset and the baseline shift (C:384,407).
- *
- * Exported as DATA rather than applied here: the two renderers currently
- * hardcode `1px` (web `_entry_row.scss`) and `2` (NS `theme/adwaita.css`), and
- * neither knew it was meant to be the same number as the other's.
+ * Gap between the shrunken title and the text baseline, in px — `TITLE_SPACING`, used in
+ * the vertical measure and in both the title offset and the baseline shift. Exported as
+ * DATA rather than applied here, so the renderers' stylesheets stop hardcoding a private
+ * number each.
  */
 export declare const ENTRY_ROW_TITLE_SPACING = 3;
 /**
- * Upper bound of `Adw.EntryRow:max-length` / `:text-length`.
- *
- * `text-length` is declared `0, G_MAXUINT16, 0` (adw-entry-row.c:666-669) and
- * `max-length` runs `0..GTK_ENTRY_BUFFER_MAX_SIZE` (C:678-682) — the same 16-bit
- * ceiling. `0` means unlimited, so this is only the clamp for an absurd input.
+ * Upper bound of `Adw.EntryRow:max-length` / `:text-length`. `text-length` is declared
+ * `0, G_MAXUINT16, 0` and `max-length` runs `0..GTK_ENTRY_BUFFER_MAX_SIZE` — the same
+ * 16-bit ceiling. `0` means unlimited, so this is only the clamp for an absurd input.
  */
 export declare const ENTRY_ROW_MAX_LENGTH_LIMIT = 65535;
 /** Icon name of the trailing pencil — adw-entry-row.ui (`edit_icon`). */
@@ -24,42 +19,37 @@ export declare const ENTRY_ROW_EDIT_ICON_NAME = "adw-entry-edit-symbolic";
 export declare const ENTRY_ROW_APPLY_ICON_NAME = "adw-entry-apply-symbolic";
 /** Tooltip of the apply button — adw-entry-row.ui. */
 export declare const ENTRY_ROW_APPLY_TOOLTIP = "Apply";
-/** Peek-button icon while the password is masked — adw-password-entry-row.c:74. */
+/** Peek-button icon while the password is masked — adw-password-entry-row.c. */
 export declare const PASSWORD_REVEAL_ICON_NAME = "view-reveal-symbolic";
-/** Peek-button icon while the password is revealed — adw-password-entry-row.c:69. */
+/** Peek-button icon while the password is revealed — adw-password-entry-row.c. */
 export declare const PASSWORD_CONCEAL_ICON_NAME = "view-conceal-symbolic";
-/** Peek-button tooltip while the password is masked — adw-password-entry-row.c:76. */
+/** Peek-button tooltip while the password is masked — adw-password-entry-row.c. */
 export declare const PASSWORD_REVEAL_LABEL = "Show Password";
-/** Peek-button tooltip while the password is revealed — adw-password-entry-row.c:71. */
+/** Peek-button tooltip while the password is revealed — adw-password-entry-row.c. */
 export declare const PASSWORD_CONCEAL_LABEL = "Hide Password";
-/** Caps-lock indicator icon — adw-password-entry-row.c:169. */
+/** Caps-lock indicator icon — adw-password-entry-row.c. */
 export declare const CAPS_LOCK_ICON_NAME = "caps-lock-symbolic";
-/** Caps-lock indicator tooltip — adw-password-entry-row.c:171. */
+/** Caps-lock indicator tooltip — adw-password-entry-row.c. */
 export declare const CAPS_LOCK_TOOLTIP = "Caps Lock is on";
 /**
- * The number of CHARACTERS in `text`, i.e. what `adw_entry_row_get_text_length`
- * reports ("The current number of characters in @self", adw-entry-row.c:1304).
+ * The number of CHARACTERS in `text`, i.e. what `adw_entry_row_get_text_length` reports.
  *
- * Code points, never UTF-16 units: a port that reaches for `.length` reports 3
- * for `'🔒é'` where GTK reports 2, and then truncates a surrogate pair in half.
- * This one function is why `max-length` and `text-length` cannot be left to the
- * renderers.
+ * Code points, never UTF-16 units: `.length` reports 3 for `'🔒é'` where GTK reports 2, and
+ * then truncates a surrogate pair in half. This is why `max-length` and `text-length`
+ * cannot be left to the renderers.
  */
 export declare function entryTextLength(text: string): number;
 /**
  * Truncate `text` to `maxLength` CHARACTERS, with `0` meaning unlimited —
- * `Adw.EntryRow:max-length` is documented as "Maximum number of characters for
- * the entry" and both its default and its range floor are `0`
- * (adw-entry-row.c:674 + :678-682).
- *
- * Split out of {@link EntryRowState} so a renderer can also apply it on an
- * IME/paste path before the state sees the value.
+ * `Adw.EntryRow:max-length` is "Maximum number of characters for the entry" and both its
+ * default and its range floor are `0`. Split out of {@link EntryRowState} so a renderer can
+ * also apply it on an IME/paste path before the state sees the value.
  */
 export declare function clampEntryText(text: string, maxLength: number): string;
 /**
  * The complete render snapshot of an entry row: the five outputs of
- * `update_empty` (adw-entry-row.c:149-154), the animation endpoint it drives
- * (C:158-161), and the inputs a renderer echoes into CSS classes.
+ * `update_empty`, the animation endpoint it drives
+ *, and the inputs a renderer echoes into CSS classes.
  *
  * ONE object rather than per-flag notifications so a renderer applies the whole
  * derivation in a single pass and can never apply half of it.
@@ -69,28 +59,28 @@ export interface EntryRowRenderState {
     text: string;
     /** {@link entryTextLength} of {@link text} — `Adw.EntryRow:text-length`. */
     textLength: number;
-    /** `empty && !(focused && editable) && !text_changed` — C:154. Drives the placeholder title. */
+    /** `empty && !(focused && editable) && !text_changed`. Drives the placeholder title. */
     empty: boolean;
-    /** Whether the embedded entry has focus — C:181. Renderers mirror it as the `focused` state class (C:183-186). */
+    /** Whether the embedded entry has focus. Renderers mirror it as the `focused` state class. */
     editing: boolean;
     /** Whether the embedded entry accepts edits (`GtkEditable:editable`). */
     editable: boolean;
-    /** The pending-apply latch — C:170-172. */
+    /** The pending-apply latch. */
     textChanged: boolean;
-    /** `!text_changed && (!editing || !editable)` — C:149. */
+    /** `!text_changed && (!editing || !editable)`. */
     editIconVisible: boolean;
-    /** `editable` — C:150. The pencil stays VISIBLE but goes insensitive on a read-only row. */
+    /** `editable`. The pencil stays VISIBLE but goes insensitive on a read-only row. */
     editIconSensitive: boolean;
-    /** `editing && show_indicator` — C:151. */
+    /** `editing && show_indicator`. */
     indicatorVisible: boolean;
-    /** `text_changed` — C:152. */
+    /** `text_changed`. */
     applyButtonVisible: boolean;
     /**
-     * Where the empty↔filled transition is headed: `0` while {@link empty}, `1`
-     * otherwise — C:160-161. The renderer animates its OWN progress toward this
-     * over {@link EMPTY_ANIMATION_DURATION_MS}, starting from wherever the
-     * progress currently is (C:158-159 sets `value_from` to the live value), so
-     * an interrupted transition resumes instead of restarting.
+     * Where the empty↔filled transition is headed: `0` while {@link empty}, `1` otherwise.
+     * The renderer animates its OWN progress toward this over
+     * {@link EMPTY_ANIMATION_DURATION_MS}, starting from wherever the progress currently is
+     * — the C sets `value_from` to the live value — so an interrupted transition resumes
+     * instead of restarting.
      */
     emptyTarget: 0 | 1;
 }
@@ -101,11 +91,9 @@ export interface EntryRowRenderState {
  */
 export type EntryRowStateListener = (state: EntryRowRenderState) => void;
 /**
- * What <kbd>Enter</kbd> resolves to. A discriminated union because
- * `text_activated_cb` (adw-entry-row.c:243-266) emits exactly ONE of the two
- * signals, never both; `activateDefault` carries the ordering requirement that
- * the default widget is activated BEFORE `entry-activated` is emitted (the
- * `gtk_widget_activate_default` call is C:254, the `g_signal_emit` is C:256).
+ * What <kbd>Enter</kbd> resolves to. A discriminated union because `text_activated_cb`
+ * emits exactly ONE of the two signals, never both; `activateDefault` carries the ordering
+ * requirement that the default widget is activated BEFORE `entry-activated` is emitted.
  */
 export type EntryRowActivation = {
     signal: 'apply';
@@ -119,11 +107,10 @@ export type EntryRowActivation = {
  * max-length truncation, and the two-way <kbd>Enter</kbd> dispatch.
  *
  * The setter guards are NOT uniform, and that is faithful rather than sloppy:
- * {@link setShowApplyButton} early-outs on an unchanged value and retracts a
- * pending latch when turned off (C:982-995), while {@link setShowIndicator}
- * deliberately has NO equality guard and always re-derives (C:1281-1296) — it is
- * the private `adw-entry-row-private.h` hook the password row drives, not a
- * public property, which is why it returns `void`.
+ * {@link setShowApplyButton} early-outs on an unchanged value and retracts a pending latch
+ * when turned off, while {@link setShowIndicator} deliberately has NO equality guard and
+ * always re-derives — it is the private `adw-entry-row-private.h` hook the password row
+ * drives, not a public property, which is why it returns `void`.
  */
 export declare class EntryRowState {
     private _text;
@@ -144,37 +131,35 @@ export declare class EntryRowState {
     /** The entry contents. */
     get text(): string;
     /**
-     * Set the contents (truncated to {@link maxLength}) and run the latch +
-     * derivation, exactly as the buffer's `changed` signal does — C:166-174.
-     *
-     * Idempotent on an identical value. GTK routes this through GtkEntryBuffer,
-     * whose emission for a same-value set is a GtkText internal this checkout
-     * has no source for (`refs/gtk` is empty), so the headless contract is the
-     * house convention — and it is what a renderer's `input`/`textChange` event
-     * produces anyway, since neither platform fires one without a real edit.
+     * Set the contents (truncated to {@link maxLength}) and run the latch + derivation,
+     * exactly as the buffer's `changed` signal does. Returns whether the text changed.
      *
-     * Returns whether the text changed.
+     * Idempotent on an identical value. GTK routes this through GtkEntryBuffer, whose
+     * emission for a same-value set is a GtkText internal this checkout has no source for
+     * (`refs/gtk` is empty), so the headless contract is the house convention — and it is
+     * what a renderer's `input`/`textChange` event produces anyway, since neither platform
+     * fires one without a real edit.
      */
     setText(text: string): boolean;
-    /** `text_changed_cb` — latch iff the apply button is armed AND we are editing (C:170-171), then re-derive (C:173). */
+    /** `text_changed_cb` — latch iff the apply button is armed AND we are editing, then re-derive. */
     private _latchAndUpdate;
-    /** {@link entryTextLength} of the contents — `Adw.EntryRow:text-length` (C:1308-1318). */
+    /** {@link entryTextLength} of the contents — `Adw.EntryRow:text-length`. */
     get textLength(): number;
-    /** Maximum number of CHARACTERS, `0` = unlimited (C:674, :678-682). */
+    /** Maximum number of CHARACTERS, `0` = unlimited. */
     get maxLength(): number;
     /**
-     * Set the maximum length, clamped into `[0, ENTRY_ROW_MAX_LENGTH_LIMIT]`
-     * (C:678-682). Over-long contents are truncated immediately, which runs the
-     * same latch + derivation a buffer edit does.
+     * Set the maximum length, clamped into `[0, ENTRY_ROW_MAX_LENGTH_LIMIT]`. Over-long
+     * contents are truncated immediately, which runs the same latch + derivation a buffer
+     * edit does.
      *
-     * Returns whether the property changed. Upstream emits NO `notify` here
-     * (there is no `g_object_notify_by_pspec` in C:1329-1343) — pinned by a
-     * vector so a port does not "helpfully" add one.
+     * Returns whether the property changed. Upstream emits NO `notify` here — its setter has
+     * no `g_object_notify_by_pspec` at all — and a vector pins that so a port does not
+     * "helpfully" add one.
      */
     setMaxLength(maxLength: number): boolean;
-    /** Whether the embedded entry has focus — `priv->editing` (C:181). */
+    /** Whether the embedded entry has focus — `priv->editing`. */
     get editing(): boolean;
-    /** Feed the focus state in and re-derive — `text_state_flags_changed_cb` (C:176-189). Returns whether it changed. */
+    /** Feed the focus state in and re-derive — `text_state_flags_changed_cb`. Returns whether it changed. */
     setEditing(editing: boolean): boolean;
     /** Whether the embedded entry accepts edits (`GtkEditable:editable`). */
     get editable(): boolean;
@@ -183,9 +168,8 @@ export declare class EntryRowState {
     /** Whether typing reveals an apply button — `Adw.EntryRow:show-apply-button`. */
     get showApplyButton(): boolean;
     /**
-     * Arm/disarm the apply button (C:982-995). Turning it OFF retracts a pending
-     * apply (C:989-992); turning it ON changes no derived output, which is why
-     * the C re-derives only in the retract branch.
+     * Arm/disarm the apply button. Turning it OFF retracts a pending apply; turning it ON
+     * changes no derived output, which is why the C re-derives only in the retract branch.
      *
      * Returns whether the property changed — the caller's cue to re-emit
      * `notify::show-apply-button`.
@@ -193,65 +177,56 @@ export declare class EntryRowState {
     setShowApplyButton(show: boolean): boolean;
     /**
      * The private indicator hook — `adw_entry_row_set_show_indicator`
-     * (adw-entry-row-private.h, C:1281-1296). `void` and UNGUARDED on purpose:
-     * the C assigns and calls `update_empty` unconditionally, with no equality
-     * check, so a redundant call still re-derives and still notifies.
-     *
-     * `Adw.PasswordEntryRow` is the only caller upstream; a renderer reaches it
-     * through {@link PasswordEntryRowState}.
+     * (adw-entry-row-private.h). `void` and UNGUARDED on purpose: the C assigns and calls
+     * `update_empty` unconditionally, with no equality check, so a redundant call still
+     * re-derives and still notifies. `Adw.PasswordEntryRow` is the only caller upstream; a
+     * renderer reaches it through {@link PasswordEntryRowState}.
      */
     setShowIndicator(show: boolean): void;
     /** Whether <kbd>Enter</kbd> may activate the default widget — `Adw.EntryRow:activates-default`. */
     get activatesDefault(): boolean;
     /**
-     * Set `activates-default` (C:1238-1253). Returns whether it changed — the
-     * caller's cue to re-emit `notify::activates-default`.
-     *
-     * The C compares the raw `gboolean` because GValue already normalised it;
-     * a JS caller has no such guarantee, so coerce first.
+     * Set `activates-default`. Returns whether it changed — the caller's cue to re-emit
+     * `notify::activates-default`. The C compares the raw `gboolean` because GValue already
+     * normalised it; a JS caller has no such guarantee, so coerce first.
      */
     setActivatesDefault(value: boolean): boolean;
-    /** The pending-apply latch (C:170-172) — `true` while the apply button is showing. */
+    /** The pending-apply latch — `true` while the apply button is showing. */
     get textChanged(): boolean;
     /**
-     * Clear the latch and re-derive — `apply_button_clicked_cb` (C:237-238). The
-     * renderer emits `apply` right after (C:240); focus handling (C:234-235) is
+     * Clear the latch and re-derive — `apply_button_clicked_cb`. The
+     * renderer emits `apply` right after; focus handling is
      * a platform concern and stays there.
      */
     apply(): void;
     /**
-     * <kbd>Enter</kbd> — `text_activated_cb` (C:243-266). Dispatches to the
-     * apply path when the apply button is showing (C:248-249), otherwise reports
-     * `entry-activated` plus whether the default widget must be activated FIRST
-     * (C:253-256).
-     *
-     * The `GtkActionable` action fired afterwards (C:258-264) has no headless
+     * <kbd>Enter</kbd> — `text_activated_cb`. Dispatches to the apply path when the apply
+     * button is showing, otherwise reports `entry-activated` plus whether the default widget
+     * must be activated FIRST. The `GtkActionable` action fired afterwards has no headless
      * equivalent and stays with the renderer.
      */
     activate(): EntryRowActivation;
 }
 /**
  * The render snapshot of a password entry row: `notify_visibility_cb`'s icon +
- * tooltip pair (adw-password-entry-row.c:62-81) plus the caps-lock inputs, as
+ * tooltip pair plus the caps-lock inputs, as
  * data.
  *
- * The icon names and English strings are the literals from the C source, so the
- * two renderers stop inventing their own spellings (`revealed` vs `peeking`,
- * `view-reveal` vs `viewRevealSymbolic`) and a renderer can map ONE canonical
- * name onto whatever asset it actually ships.
+ * The icon names and English strings are the literals from the C source, so a renderer maps
+ * ONE canonical name onto whatever asset it actually ships instead of inventing a spelling.
  */
 export interface PasswordEntryRowRenderState {
     /** Whether the contents are shown in clear text (`GtkText:visibility`). */
     revealed: boolean;
     /** Whether the keyboard reports Caps Lock engaged (`gdk_device_get_caps_lock_state`). */
     capsLockOn: boolean;
-    /** Icon the peek button shows — C:68,73. */
+    /** Icon the peek button shows. */
     peekIconName: typeof PASSWORD_REVEAL_ICON_NAME | typeof PASSWORD_CONCEAL_ICON_NAME;
-    /** Tooltip/accessible label of the peek button — C:71,76. */
+    /** Tooltip/accessible label of the peek button. */
     peekLabel: typeof PASSWORD_REVEAL_LABEL | typeof PASSWORD_CONCEAL_LABEL;
-    /** Icon of the caps-lock indicator — C:169. Constant, exposed so a renderer reads one object. */
+    /** Icon of the caps-lock indicator. Constant, exposed so a renderer reads one object. */
     indicatorIconName: typeof CAPS_LOCK_ICON_NAME;
-    /** Tooltip of the caps-lock indicator — C:171. */
+    /** Tooltip of the caps-lock indicator. */
     indicatorTooltip: typeof CAPS_LOCK_TOOLTIP;
 }
 /** Per-instance subscriber for {@link PasswordEntryRowState}. */
@@ -265,12 +240,11 @@ export type PasswordEntryRowStateListener = (state: PasswordEntryRowRenderState)
  * `adw_entry_row_set_show_indicator` hook, not a protected field. Composition
  * also keeps `EntryRowState` usable on its own for a plain entry row.
  *
- * Every reveal/caps-lock change recomputes `!revealed && capsLockOn` and pushes
- * it into the entry (C:57-59) — which is why peeking makes the caps-lock warning
- * disappear. The second suppression is the entry's own (`editing && show_indicator`,
- * C:151): the warning only shows while the entry has focus. Focus changes
- * therefore need no push from here — they re-derive on the entry side, which is
- * what `notify_has_focus_cb` (C:83-88) achieves by re-running `update_caps_lock`.
+ * Every reveal/caps-lock change recomputes `!revealed && capsLockOn` and pushes it into the
+ * entry — which is why peeking makes the caps-lock warning disappear. The second suppression
+ * is the entry's own (`editing && show_indicator`): the warning only shows while the entry
+ * has focus, so focus changes need no push from here — they re-derive on the entry side,
+ * which is what `notify_has_focus_cb` achieves by re-running `update_caps_lock`.
  */
 export declare class PasswordEntryRowState {
     private readonly _entry;
@@ -281,28 +255,25 @@ export declare class PasswordEntryRowState {
     /** Subscribe to peek/caps-lock changes. Returns an unsubscribe function. */
     subscribe(listener: PasswordEntryRowStateListener): () => void;
     private _emit;
-    /** The current render snapshot — `notify_visibility_cb`'s derivation (C:62-81). */
+    /** The current render snapshot — `notify_visibility_cb`'s derivation. */
     get state(): PasswordEntryRowRenderState;
     /** Whether the contents are shown in clear text. */
     get revealed(): boolean;
     /**
-     * Set the peek state. Early-outs on an unchanged value — every settable
-     * property in this family does (C:984, :1198, :1247), which is why the web
-     * port's unguarded `notify::revealed` on a redundant `setAttribute` is a
-     * defect and not a style choice.
-     *
-     * Returns whether it changed.
+     * Set the peek state. Early-outs on an unchanged value — every settable property in this
+     * family does, so an unguarded `notify::revealed` on a redundant `setAttribute` is a
+     * defect, not a style choice. Returns whether it changed.
      */
     setRevealed(revealed: boolean): boolean;
-    /** Flip masked↔revealed — `show_text_clicked_cb` (C:94-96). Returns whether it changed. */
+    /** Flip masked↔revealed — `show_text_clicked_cb`. Returns whether it changed. */
     togglePeek(): boolean;
     /** Whether Caps Lock is engaged. */
     get capsLockOn(): boolean;
     /**
      * Feed the keyboard's caps-lock state in — the `notify::caps-lock-state`
-     * handler (C:111-115). Returns whether it changed.
+     * handler. Returns whether it changed.
      */
     setCapsLockOn(on: boolean): boolean;
-    /** `update_caps_lock` — C:57-59. */
+    /** `update_caps_lock`. */
     private _pushIndicator;
 }

package/lib/types/glib.d.ts

@@ -2,48 +2,40 @@
  * GLib's `g_strstrip` — trim ASCII whitespace from both ends, and ONLY ASCII
  * whitespace.
  *
- * NOT `String.prototype.trim()`, which also eats U+00A0 NBSP, U+FEFF and the
- * Unicode space separators. Two widgets already depend on the difference:
- * `Adw.Avatar` derives its initials from the stripped name, so a name that
- * starts with U+00A0 keeps the NBSP as its initial in GTK, where a
- * `trim()`-based port yields the first LETTER instead; and
- * `Adw.AboutDialog`'s `parse_person` (adw-about-dialog.c:533) strips the credit
- * name the same way, so an NBSP-padded contributor name keeps its padding.
+ * NOT `String.prototype.trim()`, which also eats U+00A0 NBSP, U+FEFF and the Unicode
+ * space separators. Two widgets depend on the difference: `Adw.Avatar` derives its
+ * initials from the stripped name, so a name starting with U+00A0 keeps the NBSP as its
+ * initial in GTK where a `trim()`-based port yields the first LETTER; and
+ * `Adw.AboutDialog`'s `parse_person` strips credit names the same way.
  */
 export declare function gStrStrip(value: string): string;
 /**
- * libadwaita's `string_is_not_empty` template closure — the predicate EVERY
+ * libadwaita's `string_is_not_empty` template closure — the predicate every
  * Adwaita label binds its `visible` property to.
  *
- * `return string && string[0];` — verbatim in six widgets that each declare
- * their own private copy (`adw-action-row.c:112-117`, `adw-button-row.c:92-97`,
- * `adw-sidebar.c`, `adw-shortcut-row.c`, `adw-status-page.c`,
- * `adw-toast-widget.c`), bound from the matching `.ui`
- * (`adw-action-row.ui:49-53` for the title, `:71-75` for the subtitle).
+ * `return string && string[0];` — declared privately, verbatim, in six widgets
+ * (`adw-action-row.c`, `adw-button-row.c`, `adw-sidebar.c`, `adw-shortcut-row.c`,
+ * `adw-status-page.c`, `adw-toast-widget.c`) and bound from the matching `.ui`.
  *
- * Two properties of it are load-bearing and are what a hand-rolled copy gets
- * wrong: only the EXACT empty string (and NULL) is false — one space is a
- * visible label, because the C never trims — and the rule applies to the TITLE
- * as much as to the subtitle. Every port so far hid an empty subtitle and left
- * an empty title occupying a line.
+ * Two traps: only the EXACT empty string (and NULL) is false — one space is a visible
+ * label, because the C never trims — and the rule governs the TITLE as much as the
+ * subtitle.
  */
 export declare function stringIsNotEmpty(value: string | null | undefined): boolean;
 /**
  * GLib's `CLAMP`, which tests the HIGH bound FIRST:
  * `x > high ? high : (x < low ? low : x)`.
  *
- * NOT interchangeable with `Math.min(high, Math.max(low, x))` — the two disagree
- * whenever the bounds are inverted, and Adwaita reaches inverted bounds for
- * real: a split view's sidebar caps invert whenever the content minimum exceeds
- * what is left of the width.
+ * NOT interchangeable with `Math.min(high, Math.max(low, x))` — the two disagree on
+ * inverted bounds, which Adwaita reaches for real: a split view's sidebar caps invert
+ * whenever the content minimum exceeds what is left of the width.
  */
 export declare function glibClamp(x: number, low: number, high: number): number;
 /**
  * Drop GTK mnemonic markers from a label (`gtk_label_new_with_mnemonic`).
  *
  * A single `_` marks the character after it and is itself removed; `__` is an
- * escaped literal underscore. A renderer with no accelerator layer wants the
- * plain text, which is what this returns — GTK would underline the marked
- * character instead.
+ * escaped literal underscore. GTK underlines the marked character; a renderer with
+ * no accelerator layer wants this plain text instead.
  */
 export declare function stripMnemonic(text: string): string;

package/lib/types/index.d.ts

@@ -12,6 +12,8 @@ export { RadioGroupState, resolveCheckState } from './checks.js';
 export type { AdwCheckState, RadioGroupChange, RadioGroupListener } from './checks.js';
 export { AdwBreakpoint, evaluateBreakpointCondition, parseBreakpointCondition } from './breakpoint.js';
 export type { AdwBreakpointHandlers, BreakpointBound, BreakpointConditionGroup, BreakpointConditionLeaf, BreakpointConditionNode, BreakpointDimension, BreakpointSize, } from './breakpoint.js';
+export { ADW_ACCENT_BG_COLORS, ADW_ACCENT_COLOR_NAMES, ADW_DEFAULT_ACCENT_COLOR, adwaitaAccent, adwaitaAccentBgColor, adwaitaAccentColor, adwaitaStandaloneColor, isAdwAccentColorName, onAdwaitaAccentChanged, setAdwaitaAccent, } from './accent.js';
+export type { AdwAccentColorName } from './accent.js';
 export { DEFAULT_ICON_COLOR, DEFAULT_ICON_COLOR_DARK, adwaitaColorScheme, isThemeIconColor, onAdwaitaColorSchemeChanged, setAdwaitaColorScheme, themeIconColor, toggleAdwaitaColorScheme, } from './color-scheme.js';
 export type { AdwColorScheme } from './color-scheme.js';
 export { ADW_DATA_GRID_ROW_VARIANTS, DATA_GRID_CELL_CLASS, DATA_GRID_ROW_CLASS, dataGridCellText, dataGridColumnAlign, dataGridColumnClasses, dataGridRowInteractive, dataGridTrackTemplate, dataGridTracks, normalizeDataGridColumns, normalizeDataGridVariant, } from './data-grid.js';
@@ -34,6 +36,8 @@ export type { EntryRowActivation, EntryRowRenderState, EntryRowStateListener, Pa
 export { adwLerp, easeInOutSine, easeOutCubic, inverseLerp } from './easing.js';
 export { ADW_SPINNER_CYCLES_PER_LOOP, ADW_SPINNER_CYCLE_LENGTH, ADW_SPINNER_CONTRACT_DISTANCE, ADW_SPINNER_EXTEND_DISTANCE, ADW_SPINNER_IDLE_DISTANCE, ADW_SPINNER_MAX_ARC_LENGTH, ADW_SPINNER_MIN_ARC_LENGTH, ADW_SPINNER_N_CYCLES, ADW_SPINNER_OVERLAP_DISTANCE, ADW_SPINNER_SPIN_DURATION_MS, ADW_SPINNER_START_ANGLE, ADW_SPINNER_STILL_PROGRESS, ADW_SPINNER_TRACK_OPACITY, normalizeSpinnerAngle, spinnerArc, spinnerArcEnd, spinnerArcStart, spinnerProgressAt, } from './spinner.js';
 export type { SpinnerArc } from './spinner.js';
+export { parseAccelerator, parseShortcutLabel, shortcutKeycaps } from './shortcut-label.js';
+export type { ShortcutKeycap, ShortcutLabelNode, ShortcutLabelOptions, ShortcutLabelParse } from './shortcut-label.js';
 export { ADW_LENGTH_UNITS, DEFAULT_DPI, adwLengthToPx, normalizeLengthUnit } from './length-unit.js';
 export type { AdwLengthUnit } from './length-unit.js';
 export { ADW_SWIPE_BORDER, DEFAULT_MAX_SIDEBAR_WIDTH, DEFAULT_MIN_SIDEBAR_WIDTH, DEFAULT_SIDEBAR_WIDTH_FRACTION, DEFAULT_SIDEBAR_WIDTH_UNIT, INSTANT_SPLIT_VIEW_ANIMATOR, NAVIGATION_SPLIT_VIEW_CRITICALS, NavigationSplitViewState, OverlaySplitViewState, isSidebarAtVisualStart, layoutNavigationSplitView, layoutOverlaySplitView, measureSplitViewHorizontal, resolveNaturalSidebarWidth, resolveNavigationAction, resolveNavigationSidebarWidth, resolveNavigationStack, resolveOverlaySidebarWidth, resolveSidebarBounds, resolveSwipeArea, resolveSwipeRelease, resolveSwipeSnapPoints, resolveSwipeStart, swipeCancelProgress, tagsConflict, } from './split-view.js';

package/lib/types/length-unit.d.ts

@@ -5,20 +5,15 @@ export declare const ADW_LENGTH_UNITS: readonly AdwLengthUnit[];
 /** The dpi `adw_length_unit_to_px` falls back to when `gtk-xft-dpi` is unset. */
 export declare const DEFAULT_DPI = 96;
 /**
- * `adw_length_unit_to_px` (adw-length-unit.c:57-82) — convert `value` to pixels.
- *
- * `pt` and `sp` both scale with the text-scale factor, which GTK reads from
- * `gtk-xft-dpi`; a renderer that has no such setting passes the default 96, where
- * `sp` is a pixel passthrough and `pt` is the familiar 4/3 ratio.
+ * `adw_length_unit_to_px` — convert `value` to pixels. `pt` and `sp` both scale with the
+ * text-scale factor, which GTK reads from `gtk-xft-dpi`; a renderer with no such setting
+ * passes the default 96, where `sp` is a pixel passthrough and `pt` the 4/3 ratio.
  */
 export declare function adwLengthToPx(unit: AdwLengthUnit, value: number, dpi?: number): number;
 /**
- * An authored unit → the enum value, or the caller's default.
- *
- * A GObject enum property REJECTS an out-of-range value and keeps what it had;
- * a renderer reading an HTML attribute or an XML layout has no such gate, so the
- * unusable value has to land somewhere deliberate. `fallback` is the property's
- * own default, which differs between the widgets that use this vocabulary — the
- * split views default to `sp`, the wrap box to `px`.
+ * An authored unit → the enum value, or the caller's default. A GObject enum property
+ * rejects an out-of-range value and keeps what it had; a renderer reading an HTML
+ * attribute or an XML layout has no such gate, so `fallback` is the property's own
+ * default — `sp` for the split views, `px` for the wrap box.
  */
 export declare function normalizeLengthUnit(value: unknown, fallback: AdwLengthUnit): AdwLengthUnit;