@gjsify/adwaita-core 0.51.1 → 0.53.0

package/lib/types/index.d.ts

@@ -14,22 +14,33 @@ 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_ACCENT_FG_COLOR, ADW_DEFAULT_ACCENT_COLOR, adwaitaAccent, adwaitaAccentBgColor, adwaitaAccentColor, adwaitaStandaloneColor, isAdwAccentColorName, onAdwaitaAccentChanged, setAdwaitaAccent, } from './accent.js';
-export type { AdwAccentColorName } from './accent.js';
+export { ADW_ACCENT_BG_COLORS, ADW_ACCENT_COLOR_NAMES, ADW_ACCENT_FG_COLOR, ADW_DEFAULT_ACCENT_COLOR, adwaitaAccent, adwaitaAccentBgColor, adwaitaAccentColor, adwaitaStandaloneColor, formatAdwRgb, isAdwAccentColorName, nearestAccent, onAdwaitaAccentChanged, parseAdwRgb, setAdwaitaAccent, } from './accent.js';
+export type { AdwAccentColorName, AdwRgb } from './accent.js';
+export { APPLE_ACCENT_COLORS, APPLE_MULTICOLOR_ACCENT, adwAccentFromAppleAccentColor } from './apple-accent.js';
+export { ADW_ACCENT_META, ADW_ACCENT_META_SYSTEM, ADW_COLOR_SCHEME_META, ADW_SYSTEM_COLOR_SCHEMES, appearanceFromMeta, isAdwSystemColorScheme, parseDesktopAppearance, renderAppearanceMeta, } from './appearance.js';
+export type { AdwSystemColorScheme, AppearanceMeta, DesktopAppearance } from './appearance.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';
 export type { AdwDataGridAlign, AdwDataGridCellValue, AdwDataGridColumn, AdwDataGridRow, AdwDataGridRowVariant, DataGridTrack, } from './data-grid.js';
 export { AdwToast, AdwToastQueue, DEFAULT_TOAST_TIMEOUT } from './toast.js';
 export type { AdwToastOptions, AdwToastQueueHandlers, AdwToastQueueOptions, ToastScheduler, ToastTimerHandle, } from './toast.js';
-export { AdwAlertResponses, BottomSheetPresentation, resolveBottomSheetClose } from './dialog.js';
-export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetCloseState, BottomSheetPresentationListener, BottomSheetPresentationOptions, BottomSheetTeardownCallback, OrderedConfirmResponses, } from './dialog.js';
+export { AdwAlertResponses, BottomSheetPresentation, resolveBottomSheetChrome, resolveBottomSheetClose, resolveBottomSheetOpen, resolveBottomSheetSwipeTracker, } from './dialog.js';
+export type { AdwAlertResponse, AdwResponseAppearance, AdwResponseOptions, BottomSheetChrome, BottomSheetChromeState, BottomSheetCloseOutcome, BottomSheetCloseSource, BottomSheetCloseState, BottomSheetLayer, BottomSheetOpenOutcome, BottomSheetOpenSource, BottomSheetOpenState, BottomSheetPresentationListener, BottomSheetPresentationOptions, BottomSheetSwipeTrackerConfig, BottomSheetSwipeTrackerState, BottomSheetTeardownCallback, OrderedConfirmResponses, } from './dialog.js';
 export { ADW_COMBO_NO_SELECTION, clampListSelection, listItemsChanged, normalizeComboOptions, parseListModel, } from './list.js';
 export type { AdwComboOption, AdwComboOptionInput, AdwListItemsChanged, AdwListModel, AdwListModelInput, } from './list.js';
 export { ADW_ADJUSTMENT_DEFAULTS, adjustmentRange, clampAdjustmentValue, normalizeAdjustment, parseAdjustment, snapAdjustmentValue, SpinState, } from './adjustment.js';
 export type { AdwAdjustment, AdwAdjustmentInput, SpinStateChange, SpinStateListener, SpinStateRangeListener, } from './adjustment.js';
-export { ComboState, ExpanderState, ToggleGroupState } from './rows.js';
+export { GtkAdjustment } from './gtk-adjustment.js';
+export type { GtkAdjustmentProps } from './gtk-adjustment.js';
+export { GtkStringList } from './gtk-string-list.js';
+export type { GtkStringListProps } from './gtk-string-list.js';
+export { ComboState, ExpanderState, ToggleGroupState, keptToggles, toggleIndexOfName } from './rows.js';
 export type { ComboItemsListener, ComboStateChange, ComboStateListener, ExpanderStateListener, ToggleGroupStateChange, ToggleGroupStateListener, } from './rows.js';
+export { DEFAULT_BOX_SPACING, normalizeBoxOrientation, normalizeBoxSpacing } from './box.js';
+export type { BoxOrientation } from './box.js';
+export { DEFAULT_LABEL_ELLIPSIZE, DEFAULT_LABEL_LINES, DEFAULT_LABEL_MAX_WIDTH_CHARS, DEFAULT_LABEL_WIDTH_CHARS, DEFAULT_LABEL_WRAP_MODE, DEFAULT_LABEL_XALIGN, DEFAULT_LABEL_YALIGN, LABEL_ELLIPSIZE_MODES, LABEL_JUSTIFICATIONS, LABEL_WRAP_MODES, labelDisplayText, labelEffectiveLines, labelEllipsizeOverflowValue, labelMarkupIsUnparseable, labelWidthCharsExtent, labelYalignAlignItems, normalizeLabelEllipsize, normalizeLabelJustify, normalizeLabelLines, normalizeLabelMaxWidthChars, normalizeLabelWidthChars, normalizeLabelWrapMode, normalizeLabelXalign, normalizeLabelYalign, } from './label.js';
+export type { LabelAlignItems, LabelEllipsizeMode, LabelJustification, LabelWidthCharsExtent, LabelWrapMode, } from './label.js';
 export { glibClamp, gStrStrip, stringIsNotEmpty } from './glib.js';
 export { ViewStackState, normalizeIconName, resolvePageTitle } from './view-stack.js';
 export type { AdwViewStackPageInfo, AdwViewStackPageSpec, ViewStackStateChange, ViewStackStateListener, } from './view-stack.js';
@@ -44,12 +55,15 @@ export { ADW_SPINNER_CYCLES_PER_LOOP, ADW_SPINNER_CYCLE_LENGTH, ADW_SPINNER_CONT
 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 { formatAcceleratorLabel, formatManifestShortcut } from './shortcut-format.js';
+export type { ShortcutPlatform } from './shortcut-format.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';
 export type { AdwPackType, AdwTextDirection, NavigationActionInput, NavigationActionResult, NavigationPageRef, NavigationSplitViewChange, NavigationSplitViewHandlers, NavigationSplitViewLayout, NavigationSplitViewListener, NavigationSplitViewOptions, NavigationSplitViewProperty, NavigationStackPlan, OverlaySplitViewChange, OverlaySplitViewLayout, OverlaySplitViewListener, OverlaySplitViewOptions, OverlaySplitViewProperty, SidebarBounds, SidebarWidthInput, SidebarWidthSpec, SplitViewAnimation, SplitViewAnimationRequest, SplitViewAnimator, SplitViewMeasureInput, SplitViewPane, SplitViewPaneRect, SwipeReleasePlan, } from './split-view.js';
 export { DEFAULT_DROPDOWN_TOOLTIP, SPLIT_BUTTON_DISABLED_OPACITY, SplitButtonState, isSplitButtonDirection, menuButtonArrowIcon, menuButtonPopupDirection, resolveDropdownTooltip, splitButtonArrowIcon, splitButtonPopupDirection, splitButtonRootState, splitButtonStyleClasses, } from './split-button.js';
 export type { AdwArrowIcon, SplitButtonChange, SplitButtonContentMode, SplitButtonDirection, SplitButtonHalfState, SplitButtonListener, SplitButtonProperty, SplitButtonStyleClass, } from './split-button.js';
+export { GioMenu, GioMenuItem } from './gio-menu.js';
 export { ADW_MENU_SURFACE_NATIVESCRIPT, ADW_MENU_SURFACE_WEB, assertMenuRenderable, flattenMenu, menuItemAt, menuNodeAt, menuRefusals, normalizeMenuModel, parseDetailedAction, parseMenuModel, resolveMenuItemState, } from './menu.js';
 export type { AdwDetailedAction, AdwMenuAction, AdwMenuActions, AdwMenuDisplayHint, AdwMenuEntryInput, AdwMenuFlatRow, AdwMenuHiddenWhen, AdwMenuInput, AdwMenuItem, AdwMenuItemInput, AdwMenuItemRole, AdwMenuItemState, AdwMenuModel, AdwMenuNode, AdwMenuPath, AdwMenuRefusal, AdwMenuSection, AdwMenuSectionInput, AdwMenuSubmenu, AdwMenuSubmenuInput, AdwMenuSurface, AdwMenuTextDirection, } from './menu.js';
 export { DEFAULT_INDICATOR_DESCRIPTION_STRINGS, INLINE_VIEW_SWITCHER_DISPLAY_MODES, VIEW_SWITCHER_BADGE_LIMIT, VIEW_SWITCHER_DRAG_SWITCH_DELAY, VIEW_SWITCHER_FALLBACK_ICON, VIEW_SWITCHER_NO_SELECTION, VIEW_SWITCHER_POLICIES, ViewSwitcherBarState, ViewSwitcherDragSwitch, ViewSwitcherState, buildInlineToggles, buildViewSwitcherButtons, createViewSwitcherPage, inlineToggleTooltip, isInlineViewSwitcherDisplayMode, isViewSwitcherButtonVisible, isViewSwitcherPolicy, pageIndexForToggle, shouldRevealViewSwitcherBar, stripMnemonic, toggleIndexForPage, viewSwitcherBadgeLabel, viewSwitcherButtonOrientation, viewSwitcherIconName, viewSwitcherIndicatorDescription, viewSwitcherLabel, viewSwitcherPageFromStackPage, viewSwitcherPagesFromStack, } from './view-switcher.js';
@@ -74,3 +88,5 @@ export { POPOVER_ITEM_RADIUS, POPOVER_MENU_PADDING, POPOVER_PADDING, POPOVER_RAD
 export type { PopoverKeyAction, PopoverKeyContext, PopoverKeyResolution, PopoverStateChange, PopoverStateListener, } from './popover.js';
 export { ADW_WRAP_BOX_DEFAULT_ALIGN, ADW_WRAP_BOX_DEFAULT_JUSTIFY, ADW_WRAP_BOX_DEFAULT_JUSTIFY_LAST_LINE, ADW_WRAP_BOX_DEFAULT_LENGTH_UNIT, ADW_WRAP_BOX_DEFAULT_PACK_DIRECTION, ADW_WRAP_BOX_DEFAULT_SPACING, ADW_WRAP_BOX_DEFAULT_WRAP_POLICY, ADW_WRAP_BOX_JUSTIFY_MODES, ADW_WRAP_BOX_NATURAL_LINE_LENGTH_UNSET, ADW_WRAP_BOX_PACK_DIRECTIONS, ADW_WRAP_POLICIES, normalizeNaturalLineLength, normalizeWrapBoxAlign, normalizeWrapBoxJustify, normalizeWrapBoxLengthUnit, normalizeWrapBoxPackDirection, normalizeWrapBoxSpacing, normalizeWrapPolicy, resolveWrapBoxChildOrder, resolveWrapBoxLine, wrapBoxChildFlex, wrapBoxFlexStyle, wrapBoxLengthToPx, wrapPolicyFlexShrink, } from './wrap-box.js';
 export type { AdwWrapBoxJustify, AdwWrapBoxOrientation, AdwWrapBoxPackDirection, AdwWrapPolicy, WrapBoxChildFlex, WrapBoxChildOrderOp, WrapBoxFlexInput, WrapBoxFlexStyle, WrapBoxLineLayout, } from './wrap-box.js';
+export { ADW_SOURCE_6502_DIRECTIVES, ADW_SOURCE_6502_LINE_COMMENT, ADW_SOURCE_6502_OPCODES, ADW_SOURCE_6502_REGISTERS, ADW_SOURCE_6502_TOKEN_ROLES, ADW_SOURCE_HEX_STRIDE, ADW_SOURCE_PALETTE_DARK, ADW_SOURCE_PALETTE_LIGHT, ADW_SOURCE_SYNTAX_ROLES, classifyAsm6502Word, formatHexAddress, formatLineNumber, stripSourceWhitespace, tokenizeAsm6502, } from './source.js';
+export type { AdwSourcePalette, AdwSourceSyntaxRole, AdwSourceTokenClass, AdwSourceTokenStream } from './source.js';

package/lib/types/label.d.ts

@@ -0,0 +1,135 @@
+/** `Gtk.Label:xalign`'s default — `0.5` in the pspec: a label centres its text. */
+export declare const DEFAULT_LABEL_XALIGN = 0.5;
+/** `Gtk.Justification`'s four nicks, in enum order. */
+export declare const LABEL_JUSTIFICATIONS: readonly ["left", "right", "center", "fill"];
+export type LabelJustification = (typeof LABEL_JUSTIFICATIONS)[number];
+/**
+ * The string a label shows for a given `label` and the two flags that transform it.
+ *
+ * ORDER FOLLOWS THE C: markup is reduced first, the mnemonic marker second.
+ * `gtk_label_set_markup_with_mnemonic` parses the markup and then takes the underscore out
+ * of the resulting TEXT, so an `_` inside a tag's attributes is not a mnemonic. Doing it
+ * the other way round would let `<span font_desc="Sans">` lose its underscore and stop
+ * parsing.
+ */
+export declare function labelDisplayText(label: string, useMarkup: boolean, useUnderline: boolean): string;
+/** Whether `label` carries markup that could not be reduced, so the raw string is shown. */
+export declare function labelMarkupIsUnparseable(label: string, useMarkup: boolean): boolean;
+/**
+ * `Gtk.Label:xalign` as the label holds it. `gtk_label_set_xalign` CLAMPs to 0…1 itself,
+ * so an out-of-range value lands on the nearer end; only an unparseable one is the default.
+ */
+export declare function normalizeLabelXalign(value: unknown): number;
+/** `Gtk.Label:justify` from its nick. An unknown nick leaves the default, `left`. */
+export declare function normalizeLabelJustify(value: unknown): LabelJustification;
+/** `Gtk.Label:yalign`'s default — `0.5`, the same pspec shape as `xalign`. */
+export declare const DEFAULT_LABEL_YALIGN = 0.5;
+/**
+ * `Gtk.Label:yalign` as the label holds it. `gtk_label_set_yalign` CLAMPs to 0…1 itself,
+ * the same shape `normalizeLabelXalign` already carries for `xalign`.
+ */
+export declare function normalizeLabelYalign(value: unknown): number;
+/** The one CSS `align-items` keyword a `yalign` zone maps to. */
+export type LabelAlignItems = 'flex-start' | 'center' | 'flex-end';
+/**
+ * `yalign`'s three-zone CSS mapping — the DECLARED divergence past `yalign`'s three exact
+ * values (0, 0.5, 1): CSS `align-items` has three keywords and no ratio the way `xalign`'s
+ * `flex-grow` gives the main axis one (`_labels.scss`'s header has the full reasoning for
+ * why a second spacer pair is not the fix). This is the NEAREST of the three — the
+ * boundary between "nearest 0" and "nearest 0.5" is their midpoint, `0.25`, and
+ * symmetrically `0.75` between "nearest 0.5" and "nearest 1"; a value sitting exactly on a
+ * boundary is equidistant and reads as the CENTRE zone (`<`/`>`, not `<=`/`>=`), the same
+ * "high bound first" tie a strict inequality gives {@link glibClamp} at its own edges.
+ */
+export declare function labelYalignAlignItems(yalign: number): LabelAlignItems;
+/** `Pango.EllipsizeMode`'s four nicks, in enum order. */
+export declare const LABEL_ELLIPSIZE_MODES: readonly ["none", "start", "middle", "end"];
+export type LabelEllipsizeMode = (typeof LABEL_ELLIPSIZE_MODES)[number];
+/** `Gtk.Label:ellipsize`'s default — `none`, no ellipsization. */
+export declare const DEFAULT_LABEL_ELLIPSIZE: LabelEllipsizeMode;
+/** `Gtk.Label:ellipsize` from its nick. An unknown nick leaves the default, `none`. */
+export declare function normalizeLabelEllipsize(value: unknown): LabelEllipsizeMode;
+/**
+ * `Gtk.Label:ellipsize` as the ONE truncating value CSS `text-overflow` and
+ * NativeScript's `textOverflow` can both hold — each accepts only `clip` or `ellipsis`,
+ * neither has a start- or middle-truncating mode of its own.
+ *
+ * `start` and `middle` are held on the PROPERTY faithfully: `normalizeLabelEllipsize`
+ * never lies about what was asked for, and a consumer reading `label.ellipsize` back gets
+ * exactly that nick. What a renderer can DRAW is a different question, answered here once
+ * for both renderers so neither invents its own fallback: every non-`none` mode draws an
+ * END ellipsis, the nearer of the two values a platform actually has — never a silent
+ * `clip`, which would drop the same characters with no indication at all that anything is
+ * missing. A DECLARED divergence, not a guessed one: `LABEL_ELLIPSIZE_OVERFLOW_VECTORS`
+ * pins this fallback, the same way `LABEL_DISPLAY_TEXT_VECTORS` pins use-markup's.
+ */
+export declare function labelEllipsizeOverflowValue(ellipsize: LabelEllipsizeMode): 'clip' | 'ellipsis';
+/** `Pango.WrapMode`'s three nicks, in enum order. */
+export declare const LABEL_WRAP_MODES: readonly ["word", "char", "word-char"];
+export type LabelWrapMode = (typeof LABEL_WRAP_MODES)[number];
+/** `Gtk.Label:wrap-mode`'s default — `word`, wrap on word boundaries. */
+export declare const DEFAULT_LABEL_WRAP_MODE: LabelWrapMode;
+/** `Gtk.Label:wrap-mode` from its nick. An unknown nick leaves the default, `word`. */
+export declare function normalizeLabelWrapMode(value: unknown): LabelWrapMode;
+/** `Gtk.Label:width-chars`'s default — `-1`, the width is calculated automatically. */
+export declare const DEFAULT_LABEL_WIDTH_CHARS = -1;
+/** `Gtk.Label:width-chars` as the label holds it. See {@link normalizeLabelCharCount}. */
+export declare function normalizeLabelWidthChars(value: unknown): number;
+/** `Gtk.Label:max-width-chars`'s default — `-1`, the width is calculated automatically. */
+export declare const DEFAULT_LABEL_MAX_WIDTH_CHARS = -1;
+/** `Gtk.Label:max-width-chars` as the label holds it. See {@link normalizeLabelCharCount}. */
+export declare function normalizeLabelMaxWidthChars(value: unknown): number;
+/** `Gtk.Label:lines`'s default — `-1`, no line limit. */
+export declare const DEFAULT_LABEL_LINES = -1;
+/** `Gtk.Label:lines` as the label holds it. See {@link normalizeLabelCharCount}. */
+export declare function normalizeLabelLines(value: unknown): number;
+/**
+ * `Gtk.Label:lines` — the line count Pango will actually show before it ellipsizes, or
+ * `null` when nothing caps it at all.
+ *
+ * THE PSPEC'S OWN WORDS ARE IMPRECISE, MEASURED AGAINST WHAT GTK DOES. "Has no effect if
+ * the label is not wrapping or ellipsized" reads as `wrap || ellipsize !== 'none'` — this
+ * function's first, WRONG implementation — but `gtk_label_ensure_layout` (gtklabel.c) only
+ * ever calls `pango_layout_set_height(layout, -self->lines)`, and `wrap` plays NO PART in
+ * whether Pango HONOURS that call: measured on gjs 1.88.1 / gtk 4.22.5, a real
+ * `Gtk.Label` with `wrap=TRUE, ellipsize=NONE, lines=2`, allocated 100px wide, laid out
+ * **15 lines** — the `lines` hint sits there unused, because Pango only consults a
+ * layout's height/line-count when ELLIPSIZATION is active; wrapping alone never asks
+ * Pango to stop. The same label with `wrap=FALSE, ellipsize=END, lines=2` (the case the
+ * old implementation returned `null`, "no effect", for) laid out exactly **2 lines**,
+ * ellipsized — `wrap` is `false` there and it changed nothing: `ellipsize || wrap` in the
+ * C is the gate on whether the layout gets a WIDTH at all (a `Gtk.Label:ellipsize`
+ * request supplies its own width, exactly like `wrap` does), not on whether `lines` has
+ * an effect. So `wrap` is not a parameter here — passing it would invite exactly the
+ * misreading the pspec's prose does.
+ *
+ * WHAT AN UNSET `lines` (`≤ 0`) MEANS ONCE ELLIPSIZE IS ACTIVE IS NOT "UNLIMITED" — it is
+ * Pango's OWN default: `gtk_label_set_lines` only calls `pango_layout_set_height` when
+ * `lines > 0`, so an unset `lines` leaves Pango's height at ITS default, which
+ * `PangoLayout` documents as "the first line will be shown" — measured: `lines` absent
+ * (or `0`) with `ellipsize=END` laid out to exactly **1 line**, same as `lines=1`
+ * explicitly. `lines < 0` (GTK's own "unlimited" spelling once `lines` IS being read,
+ * i.e. while ellipsize is active) was never reachable through this function in the first
+ * place, since {@link normalizeLabelLines} floors at `-1` and this reads it before any
+ * positive check — folded into the `lines > 0 ? lines : 1` branch below.
+ */
+export declare function labelEffectiveLines(lines: number, ellipsize: LabelEllipsizeMode): number | null;
+/** One `width-chars` + `max-width-chars` pair and the `ch`-unit extent a renderer draws. */
+export interface LabelWidthCharsExtent {
+    /** `width-chars`, in `ch` — the MINIMUM width — or `null` while it is unset (`-1`). */
+    minCh: number | null;
+    /**
+     * `MAX(width-chars, max-width-chars)`, in `ch` — the NATURAL/maximum width — or `null`
+     * while `max-width-chars` is unset. `width-chars` alone sets no maximum: GTK reads it
+     * only as a floor under `max-width-chars`, never as a ceiling by itself.
+     */
+    maxCh: number | null;
+}
+/**
+ * `get_default_widths` (gtklabel.c): the label's MINIMUM width is `width-chars` alone; its
+ * NATURAL width is `MAX(width-chars, max-width-chars)`, and that MAX is read only while
+ * `max-width-chars` is set — `width-chars` without a maximum has nothing to be a floor
+ * under. Either property at its default (`-1`) drops out of the pair it belongs to, the
+ * same "negative means auto" rule both share.
+ */
+export declare function labelWidthCharsExtent(widthChars: number, maxWidthChars: number): LabelWidthCharsExtent;

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

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

package/lib/types/markup.d.ts

@@ -0,0 +1,14 @@
+import type { SharedTreeNode } from './conformance/shared-trees.js';
+/**
+ * The tree as `<adw-*>`/`<gtk-*>` markup: what `buildSharedTree` would build, spelled as the
+ * HTML a page could hold instead. Parsed into a document, it yields the same elements with
+ * the same attributes, classes and `slot=` as `mountSharedTree(node)` does.
+ */
+export declare function sharedTreeHtml(node: SharedTreeNode): string;
+/**
+ * The tree as a NativeScript XML template: what the port's `build` would build, spelled as
+ * markup NativeScript's `Builder` loads. The root declares NativeScript's default namespace
+ * and one `xmlns` barrel per library the tree uses — no more, since each is a module the app
+ * then has to provide.
+ */
+export declare function sharedTreeNativeScriptXml(node: SharedTreeNode): string;

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

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

package/lib/types/rows.d.ts

@@ -222,3 +222,23 @@ export declare class ToggleGroupState {
     /** Number of segments. */
     get count(): number;
 }
+/**
+ * The toggles a group keeps, in add order.
+ *
+ * A NAME IS UNIQUE, AND THE SECOND CLAIM IS REFUSED WHOLE. `add_toggle` looks the name up
+ * before adding and, when another toggle already carries it, prints a `g_critical` and
+ * drops the toggle — it is never added, so it draws no button and takes no index
+ * (adw-toggle-group.c:849). An unnamed toggle is always kept.
+ */
+export declare function keptToggles<T extends {
+    readonly name?: string | null;
+}>(toggles: readonly T[]): T[];
+/**
+ * The toggle `adw_toggle_group_set_active_name` selects: its index among the names of the
+ * KEPT toggles ({@link keptToggles}), or `-1` when none carries `name`.
+ *
+ * `-1` is not a selection. The C answers a name nothing carries with a `g_critical` and
+ * returns (:2001) — the active toggle stays where it was — so a renderer leaves its
+ * selection alone on `-1` rather than clearing it.
+ */
+export declare function toggleIndexOfName(names: readonly (string | null | undefined)[], name: string): number;

package/lib/types/shortcut-format.d.ts

@@ -0,0 +1,25 @@
+/** `'mac'` picks Apple's glyphs and modifier order; `'other'` leaves the input alone. */
+export type ShortcutPlatform = 'mac' | 'other';
+/**
+ * `raw` as a WebExtension manifest or `browser.commands.getAll()` spells it
+ * (e.g. `"Alt+Shift+B"`, `"MacCtrl+Shift+B"`). Empty input stays empty:
+ * whether that means "show nothing" or "show a fallback" is a decision for
+ * the caller, not this formatter. A value some engine already rendered as
+ * glyphs (Safari, Chromium in places) passes through unchanged — formatting
+ * it twice would be wrong twice — and so does every non-mac platform, because
+ * that IS how Windows/Linux/ChromeOS show it.
+ */
+export declare function formatManifestShortcut(raw: string, platform: ShortcutPlatform): string;
+/**
+ * `accelerator` as GTK spells it (`"<Control><Shift>b"`, `"<Primary>q"`,
+ * `"<Alt>F4"`). Delegates the actual parse to `shortcutKeycaps` so the
+ * modifier table — including `<Primary>` resolving to ⌘ on mac and `<Control>`
+ * staying ⌃, GTK's own macOS behaviour — lives in exactly one place. Returns
+ * the accelerator unchanged if it fails to parse (an unknown modifier, an
+ * unterminated `<`).
+ *
+ * Non-mac renders the GTK-style human label (`"Ctrl+Shift+B"`, `+`-joined,
+ * letter keys upper-cased); mac renders Apple's glyphs in HIG order with no
+ * separator (`"⌃⇧B"`), matching `formatManifestShortcut`.
+ */
+export declare function formatAcceleratorLabel(accelerator: string, platform: ShortcutPlatform): string;

package/lib/types/shortcut-format.spec.d.ts

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

package/lib/types/source.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The read/advance surface a stream tokenizer needs from its host editor — the
+ * exact eight members {@link tokenizeAsm6502} touches, with CodeMirror's
+ * `StringStream` signatures, so passing one satisfies this structurally.
+ *
+ * `next()` returns `string | void` rather than `string | undefined` because
+ * that is what `StringStream` declares, and `void` is not assignable to
+ * `undefined`: narrowing here would reject the very class this exists to accept.
+ */
+export interface AdwSourceTokenStream {
+    /** The text consumed since the current token started. */
+    current(): string;
+    /** Consume the whitespace run ahead of the cursor; true if any was there. */
+    eatSpace(): boolean;
+    /** Consume while characters match; true if any were consumed. */
+    eatWhile(match: string | RegExp | ((ch: string) => boolean)): boolean;
+    /** True at the end of the line. */
+    eol(): boolean;
+    /** Read one character and advance. */
+    next(): string | void;
+    /** The character at the cursor, without advancing. */
+    peek(): string | undefined;
+    /** Jump to the end of the line. */
+    skipToEnd(): void;
+    /** True at the start of the line — what makes a bare word a label. */
+    sol(): boolean;
+}
+/** The token classes {@link tokenizeAsm6502} can emit. */
+export type AdwSourceTokenClass = 'comment' | 'directive' | 'identifier' | 'label' | 'number' | 'opcode' | 'operator' | 'register' | 'string';
+/** The 56 official NMOS 6502 mnemonics (uppercased for case-insensitive match). */
+export declare const ADW_SOURCE_6502_OPCODES: ReadonlySet<string>;
+/** The registers that appear as bare operands (`ASL A`, `LDA $00,X`). */
+export declare const ADW_SOURCE_6502_REGISTERS: ReadonlySet<string>;
+/** Assembler pseudo-ops. `define`/`dcb` are the easy6502 dialect; the rest are
+ *  common cross-assembler directives (with the leading dot handled separately). */
+export declare const ADW_SOURCE_6502_DIRECTIVES: ReadonlySet<string>;
+/** The comment introducer 6502 assembly uses, for an editor's comment command. */
+export declare const ADW_SOURCE_6502_LINE_COMMENT = ";";
+/**
+ * Classify an identifier-shaped token. Pure + side-effect-free so it is unit
+ * testable without a stream at all. `atLineStart` decides whether an unknown
+ * word is a label DEFINITION (column 0) or a symbol REFERENCE.
+ */
+export declare function classifyAsm6502Word(word: string, atLineStart: boolean): AdwSourceTokenClass;
+/**
+ * Tokenize one token from `stream`. Returns a token class or `null` for
+ * whitespace and unclassified punctuation, which is the contract a CodeMirror
+ * `StreamParser.token` wants — and, being typed on
+ * {@link AdwSourceTokenStream}, the contract any other editor can meet too.
+ */
+export declare function tokenizeAsm6502(stream: AdwSourceTokenStream): AdwSourceTokenClass | null;
+/**
+ * The colourable roles a token class maps onto. Fewer than the token classes,
+ * because a language names tokens after its own grammar (`opcode`) while a
+ * colour scheme names them after what a reader sees (`keyword`) — and the
+ * second set is what a scheme, a stylesheet or another language shares.
+ */
+export type AdwSourceSyntaxRole = 'comment' | 'directive' | 'keyword' | 'label' | 'number' | 'operator' | 'register' | 'string';
+/** The roles in the order a generated stylesheet emits them. */
+export declare const ADW_SOURCE_SYNTAX_ROLES: readonly AdwSourceSyntaxRole[];
+/** One colour per {@link AdwSourceSyntaxRole}, as a CSS-parsable colour. */
+export type AdwSourcePalette = Readonly<Record<AdwSourceSyntaxRole, string>>;
+/**
+ * Which role paints a token class. `identifier` maps to `null`: a plain symbol
+ * reference is deliberately UNCOLOURED, taking the view's foreground, exactly
+ * as the native GtkSourceView scheme leaves it.
+ */
+export declare const ADW_SOURCE_6502_TOKEN_ROLES: Readonly<Record<AdwSourceTokenClass, AdwSourceSyntaxRole | null>>;
+/** Light-scheme syntax colours (Adwaita named palette). */
+export declare const ADW_SOURCE_PALETTE_LIGHT: AdwSourcePalette;
+/** Dark-scheme syntax colours (Adwaita named palette). */
+export declare const ADW_SOURCE_PALETTE_DARK: AdwSourcePalette;
+/** Bytes represented per visual line in the hex monitor / hexdump gutter. */
+export declare const ADW_SOURCE_HEX_STRIDE = 16;
+/**
+ * Format a 1-based line number as a 4-digit uppercase hex address, the way the
+ * native GtkSourceView hex gutter renders monitor/hexdump rows: each row advances
+ * the address by `stride` bytes from `start` (the base address of the first row,
+ * e.g. 0x0600 for a 6502 program). `lineNo` is 1-based, per CodeMirror's
+ * `formatNumber` contract.
+ */
+export declare function formatHexAddress(lineNo: number, start: number, stride?: number): string;
+/**
+ * Format a 1-based line number for the normal (decimal) gutter, offset so
+ * `start` is the value shown on the first line — the web twin of the native
+ * renderer's `line + startValue`.
+ */
+export declare function formatLineNumber(lineNo: number, start?: number): string;
+/**
+ * Strip every whitespace character from `text` — the copy-without-spaces
+ * transform the native hex monitor applies so a copied address/byte run pastes
+ * as a compact hex string. Mirrors `text.replace(/\s/g, '')` in the GTK widget.
+ */
+export declare function stripSourceWhitespace(text: string): string;

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

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

package/lib/types/tags.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `AdwPreferencesGroup` -> `adw-preferences-group`.
+ *
+ * THE RULE: the last capital of an acronym run opens the next word, which is why `GLArea`
+ * is `gl-area` and not `g-l-area`. The first version of this function was a naive
+ * `([a-z0-9])([A-Z])` split, and `GtkGLArea` caught it — it produced `gtk-glarea` where
+ * `gtk-host` stamps `gtk-gl-area`, which is why arm 11 of `check-generated-website-data.mjs`
+ * holds the `scripts/` restatement against every row of the generated table rather than
+ * against a handful of tags a corpus happens to use today.
+ *
+ * NOT AN INVERSE OF ANYTHING. Tag -> GType is lossy in exactly that case — `gtk-gl-area`
+ * reads back as `GtkGlArea` and no case rule can know better — so a reverse lookup has to be
+ * a table read backwards, never a second rule.
+ */
+export declare const hostTagOf: (gtype: string) => string;
+/**
+ * `buttonLabel` -> `button-label`.
+ *
+ * NOT AN ALIAS TABLE and not a second transform beside {@link hostTagOf}: a case rule over
+ * the authored property NAME, with no entry to give a name it does not recognise. A markup
+ * renderer's tree builder turns an authored prop into a DOM attribute with this rule, and
+ * arm 13 of `check-generated-website-data.mjs` reads a gallery fence's attributes back
+ * through the `scripts/` restatement of it, so the two stay one spelling rather than two.
+ */
+export declare const attributeOf: (prop: string) => string;
+/**
+ * `maximum-size` -> `maximumSize`: a GObject property name as the JavaScript member a
+ * NativeScript widget declares for it.
+ *
+ * A `.blp` projects its properties under their GIR spelling, because that is what GtkBuilder
+ * and the `<adw-*>` attributes read. The NativeScript port names the same property in camel
+ * case (`Adw.Clamp:maximum-size` is `AdwClamp.maximumSize`), so a builder handed a projected
+ * tree needs this rule to find the member, and without it every hyphenated property of a real
+ * `.blp` is refused as reaching nothing. GObject treats `_` and `-` in a property name as one
+ * separator, so both close a word here. Idempotent on a camel-case name, which is how the
+ * gallery's hand-authored trees already spell theirs.
+ */
+export declare const propertyOf: (name: string) => string;
+/**
+ * `GtkWidget`'s four margins, as the CSS property each one is — `start`/`end` the LOGICAL
+ * edges `gtk_widget_set_margin_start` documents, `top`/`bottom` physical as in GTK.
+ *
+ * A markup renderer writes them as inline style, because an attribute cannot carry a length
+ * into a stylesheet portably (`attr()` with a type is not in every engine). ONE table for the
+ * two places that do it: `buildSharedTree` in `@gjsify/adwaita-web`, and `sharedTreeHtml` in
+ * `./markup.ts`, whose markup has to parse back to exactly what that builder made.
+ */
+export declare const GTK_WIDGET_MARGIN_CSS: Readonly<Record<string, string>>;

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

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

package/lib/types/tokens.generated.d.ts

@@ -31,4 +31,4 @@ export declare const ADWAITA_DARK_ONLY_TOKENS: readonly string[];
  */
 export declare const ADWAITA_UNRESOLVED_TOKENS: readonly string[];
 /** How many tokens the light contract carries — derived, never typed. */
-export declare const ADWAITA_TOKEN_COUNT = 68;
+export declare const ADWAITA_TOKEN_COUNT = 69;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-core",
-    "version": "0.51.1",
+    "version": "0.53.0",
     "description": "Headless Adwaita widget behavior (breakpoint condition grammar + apply/unapply state machine, color-scheme observable, avatar derivation) shared by the web and NativeScript Adwaita renderers — pure TS, no platform imports",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -17,6 +17,14 @@
         "./tokens": {
             "types": "./lib/types/tokens.d.ts",
             "default": "./lib/esm/tokens.js"
+        },
+        "./tags": {
+            "types": "./lib/types/tags.d.ts",
+            "default": "./lib/esm/tags.js"
+        },
+        "./markup": {
+            "types": "./lib/types/markup.d.ts",
+            "default": "./lib/esm/markup.js"
         }
     },
     "files": [
@@ -36,7 +44,7 @@
         "test:gjs": "gjsify run test.gjs.mjs",
         "test:node": "node test.node.mjs",
         "test:bun": "bun test.node.mjs",
-        "test:deno": "deno run -A --no-lock --node-modules-dir=none test.node.mjs",
+        "test:deno": "deno run -A --no-lock --node-modules-dir=none --min-dep-age=0 test.node.mjs",
         "test:cross-runtime": "gjsify run build:test:node && gjsify run test:node && gjsify run test:bun && gjsify run test:deno"
     },
     "keywords": [
@@ -50,8 +58,8 @@
         "headless"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.51.1",
-        "@gjsify/unit": "^0.51.1",
+        "@gjsify/cli": "^0.53.0",
+        "@gjsify/unit": "^0.53.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },