@gjsify/adwaita-nativescript 0.47.0 → 0.49.0

package/lib/types/widgets/label-text.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The string a `Gtk.Label` puts in `Label.text` for a given `label` and the two flags
+ * that transform it.
+ *
+ * ORDER MATTERS AND 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 this port could not reduce, so the raw string is shown. */
+export declare function labelMarkupIsUnparseable(label: string, useMarkup: boolean): boolean;

package/lib/types/widgets/menu-sheet.d.ts

@@ -0,0 +1,58 @@
+import type { AdwMenuActions, AdwMenuModel, AdwMenuPath } from '@gjsify/adwaita-core';
+/** Text of the sheet's dismiss button. */
+export declare const MENU_CANCEL_LABEL = "Cancel";
+/** One row of the sheet: the string presented, and where in the model it came from. */
+export interface MenuSheetRow {
+    /** The string handed to `action()`, unique within the page. */
+    readonly action: string;
+    readonly path: AdwMenuPath;
+    /** Whether choosing it opens another sheet rather than activating an item. */
+    readonly submenu: boolean;
+}
+/**
+ * The rows of ONE page — the model's root, or the submenu at `page`.
+ *
+ * `cancelLabel` seeds the uniqueness set, which is what makes a menu item literally
+ * called "Cancel" distinguishable from the reader dismissing the sheet.
+ */
+export declare function menuSheetRows(model: AdwMenuModel, page?: AdwMenuPath, actions?: AdwMenuActions, cancelLabel?: string): MenuSheetRow[];
+/** Just the strings, in order — what `action()` takes. */
+export declare const menuSheetActions: (rows: readonly MenuSheetRow[]) => string[];
+/**
+ * The row the reader chose, or `null` when the sheet was dismissed. Feed it the SAME
+ * rows {@link menuSheetRows} produced, or the lookup is a guess.
+ */
+export declare function resolveMenuChoice(rows: readonly MenuSheetRow[], chosen: string | null | undefined): MenuSheetRow | null;
+/** What a caller supplies so this module never imports `@nativescript/core`. */
+export type MenuSheetPresenter = (options: {
+    title?: string;
+    cancelButtonText: string;
+    actions: string[];
+}) => Promise<string | undefined>;
+/**
+ * Present the menu, descending into submenus, and answer with the chosen item's PATH.
+ *
+ * The loop is what makes a submenu a real submenu on a surface that has only one list:
+ * choosing a submenu row presents that submenu's rows, with the submenu's own label as
+ * the sheet title so the reader can see where they are. A dismissal at any depth ends
+ * the interaction — there is no "back" button on a platform sheet, and inventing one as
+ * a row would be a menu entry the model does not have.
+ */
+export declare function presentMenuSheet(present: MenuSheetPresenter, model: AdwMenuModel, options?: {
+    title?: string;
+    actions?: AdwMenuActions;
+    cancelLabel?: string;
+}): Promise<AdwMenuPath | null>;
+/**
+ * Refuse a JSON STRING where a menu model belongs, loudly.
+ *
+ * NativeScript's `Builder` assigns an XML attribute straight onto the property, so a
+ * `menuModel="[…]"` in a view file lands here as a string. The model does not accept one
+ * — the gallery probe that would have to prove the XML door compares a read-back by
+ * IDENTITY, which no structured value satisfies — and left to `normalizeMenuModel` a
+ * string is simply "not an array", so the author would get an EMPTY menu and no
+ * diagnostic at all.
+ *
+ * A door that is shut may not also be silent. This is the sentence that says which.
+ */
+export declare function refuseMenuString(value: unknown, widget: string): void;

package/lib/types/widgets/row-state.d.ts

@@ -37,7 +37,7 @@ export interface NsButtonRowIconVisuals {
  * title through a second state object would give one label two sources of truth.
  * {@link rowLabelVisuals} paints it.
  *
- * The icon payload is the symbolic SVG SOURCE, not GTK's icon name, because `AdwIcon`
+ * The icon payload is whatever the caller set — a name or the symbolic SVG source, because `GtkImage`
  * renders SVG rather than resolving a name. `ButtonRowState` is indifferent: its rule
  * is `string_is_not_empty`, which reads the first byte.
  */

package/lib/types/widgets/signals.d.ts

@@ -0,0 +1,40 @@
+import type { EventData, Observable } from '@nativescript/core';
+/** The two methods the mixin adds. Named so a consumer can annotate with it. */
+export interface GObjectSignals {
+    /**
+     * Subscribe to `eventName` — a NativeScript event, or one of the `notify::<prop>`
+     * events this port's widgets emit — and get back the id that `disconnect` takes.
+     *
+     * The callback receives the emitting widget FIRST, as a GJS signal handler does,
+     * then the NativeScript payload.
+     */
+    connect(eventName: string, callback: (self: this, data: EventData) => void): number;
+    /** Remove exactly the handler `connect` returned this id for. Throws on an id nothing holds. */
+    disconnect(handlerId: number): void;
+}
+/**
+ * A constructor the mixin can wrap: anything that is an `Observable`, abstract or not.
+ *
+ * `any[]` and not `unknown[]`: TypeScript accepts a mixin base only as a constructor with a
+ * single rest parameter of type `any[]` (TS2545), so the wider spelling is the one the
+ * language requires here rather than a shortcut.
+ */
+export type ObservableConstructor = abstract new (...args: any[]) => Observable;
+/**
+ * Give a `@nativescript/core` base GJS's `connect` / `disconnect`.
+ *
+ * Applied ONCE per class that extends a platform base — `extends withSignals(GridLayout)`
+ * — and never on a class whose base is already a widget of this package, which inherits
+ * the two methods and would otherwise carry a second, identical copy one prototype up.
+ */
+export declare function withSignals<TBase extends ObservableConstructor>(Base: TBase): (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & TBase;

package/lib/types/widgets/split-button.d.ts

@@ -1,30 +1,11 @@
-import type { AdwArrowIcon, AdwMenuEntry, SplitButtonDirection, SplitButtonState } from '@gjsify/adwaita-core';
-export type { AdwMenuEntry, SplitButtonDirection };
-/** Text of the sheet's dismiss button. */
-export declare const MENU_CANCEL_LABEL = "Cancel";
+import type { AdwArrowIcon, SplitButtonDirection, SplitButtonState } from '@gjsify/adwaita-core';
+export type { SplitButtonDirection };
 /**
  * The libadwaita arrow glyph names mapped to real Adwaita symbolic SVGs. Keyed by
  * {@link AdwArrowIcon} and therefore TOTAL: which glyph a direction gets is decided in
  * core, and a glyph with no SVG here is a compile error rather than a fallback arrow.
  */
 export declare const ARROW_SVGS: Readonly<Record<AdwArrowIcon, string>>;
-/**
- * Normalise a menu assigned from XML or app code into entries. A bare `string[]` is
- * accepted (the storybook passes one) and widens to the shared {@link AdwMenuEntry}.
- */
-export declare function toMenuEntries(value: readonly (string | AdwMenuEntry)[] | null | undefined): AdwMenuEntry[];
-/**
- * The strings handed to `Dialogs.action()`, one per entry and each unique: a label
- * that collides with another entry — or with the dismiss button — gets zero-width
- * spaces appended until it is distinct, so {@link resolveMenuChoice} can tell them
- * apart.
- */
-export declare function menuSheetActions(entries: readonly AdwMenuEntry[], cancelLabel?: string): string[];
-/**
- * The position the user chose, or `-1` when the sheet was dismissed. Feed it the SAME
- * array {@link menuSheetActions} produced, or the lookup is a guess.
- */
-export declare function resolveMenuChoice(sheetActions: readonly string[], chosen: string | null | undefined): number;
 /** The arrow SVG for a direction; the split button's `none` is the down caret, not a hamburger. */
 export declare function splitButtonArrowSvg(direction: SplitButtonDirection): string;
 /**

package/lib/types/widgets/split-view-base.d.ts

@@ -10,7 +10,18 @@ export interface NotifyShowSidebarEventData extends EventData {
     /** Whether the view is in its collapsed (narrow) mode. */
     collapsed: boolean;
 }
-export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState = NsSplitViewState> extends GridLayout {
+declare const AdwSplitViewBase_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
+export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState = NsSplitViewState> extends AdwSplitViewBase_base {
     /** Which widget's width rule applies — they differ once a pane has a minimum. */
     protected readonly _widthRule: SplitViewWidthRule;
     /** The headless state machine this widget renders (`split-view-state.ts`). */
@@ -20,7 +31,7 @@ export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState =
     /** The three width PROPERTIES; the drawn width is derived from them. */
     protected _widthProps: SidebarWidthProps;
     /** The container width the sidebar was last sized against, in DIPs. */
-    protected _measuredWidth: number;
+    protected _splitWidth: number;
     /** An explicit `sidebarWidth` assignment, which overrides the derivation. */
     protected _sidebarWidthOverride: number | null;
     constructor(rootClass: string, 
@@ -74,10 +85,10 @@ export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState =
     protected _cancelPending(): void;
     /** Whether `view` is currently a child of this layout. */
     protected _isChild(view: View): boolean;
-    /** Set (or replace) the sidebar pane. */
-    setSidebar(view: View | null): void;
-    /** Set (or replace) the content pane. */
-    setContent(view: View | null): void;
+    /** Set (or replace) the sidebar pane — `set_sidebar` on both split views. */
+    set_sidebar(view: View | null): void;
+    /** Set (or replace) the content pane — `set_content` on both split views. */
+    set_content(view: View | null): void;
     /**
      * An XML child asks for `sidebar` or `content`, and a bare one is CONTENT.
      *
@@ -135,3 +146,4 @@ export declare abstract class AdwSplitViewBase<TState extends NsSplitViewState =
     /** The content pane, or `null`. */
     get content(): View | null;
 }
+export {};

package/lib/types/widgets/status-page-content.d.ts

@@ -10,7 +10,7 @@ export declare function statusPageLabelVisibility(text: string | null | undefine
  * `has_image`, bound to the image's `visible`.
  *
  * C is `paintable || (icon_name && icon_name[0])`; this port has no `paintable`
- * counterpart (the icon is an SVG string handed to `AdwIcon`), so only the second
+ * counterpart (the icon is a name or an SVG string handed to `GtkImage`), so only the second
  * half applies. Kept as its own predicate rather than folded into
  * {@link statusPageLabelVisibility} because upstream really are two closures, and
  * the missing half is a real gap rather than a simplification.

package/lib/types/widgets/style-classes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * What a `styleClasses` write means here.
+ *
+ * THE DOOR TAKES A STRING AND THE READ-BACK IS A LIST, which is the DOM's own
+ * `className`/`classList` split and not a compromise: the two places that WRITE this are a
+ * NativeScript XML attribute and `View.className`, and both are strings, while
+ * `GtkWidget:css-classes` holds a list and so does the getter. An array-taking door would
+ * need a fourth attribute kind in `check-generated-website-data` — it has `number`,
+ * `boolean` and `json`, and `json` there means "parses to a plain OBJECT", so not even
+ * `'["pill"]'` reaches it — and inventing one to offer a second spelling of a door that
+ * already works is the "second way to say what the table can already say" that gate's own
+ * header refuses.
+ *
+ * NO ARRAY ARM. It had one, "because the widget's internals rebuild the list through it";
+ * the internals are the two setters and both are typed `string | null | undefined`, so the
+ * arm was unreachable and its `String(name)` coercion guarded nothing.
+ */
+export type AdwStyleClassesInput = string | null | undefined;
+/**
+ * The class list a `styleClasses` write means: split on whitespace, trimmed,
+ * de-duplicated, order preserved.
+ *
+ * A STRING IS THE XML DOOR. NativeScript's `setPropertyValue` ends in `instance[name] =
+ * value`, so `<gtk:Button styleClasses="pill suggested-action">` hands the setter that
+ * whole string — the same fact `xmlNumber`/`xmlBoolean` exist for, one type over.
+ */
+export declare function normalizeStyleClasses(value: AdwStyleClassesInput): string[];
+/**
+ * `className` for a widget whose own class is `base` and which carries `classes`.
+ *
+ * AN EMPTY `base` IS A WIDGET WITH NO CLASS OF ITS OWN, and two of them ship: `Gtk.Box`
+ * and `Gtk.Label` are transparent — there is no Adwaita fill, radius or typography to give
+ * a box or a bare label, so they carry only what a caller puts on them. The empties are
+ * filtered rather than joined, because `` `${''} ${'title-1'}` `` is a leading space and
+ * NativeScript's `className` splitter turns that into an empty class name.
+ */
+export declare function classNameWith(base: string, classes: readonly string[]): string;
+/**
+ * The list after `gtk_widget_add_css_class(name)` — GTK's own method, and the door a GJS
+ * snippet reaches for.
+ *
+ * WHY THE METHODS EXIST BESIDE THE `styleClasses` PROPERTY. A NativeScript XML attribute
+ * can only carry a string, which is what `styleClasses` is for; a TypeScript caller ported
+ * off GJS writes `button.add_css_class('pill')`, and that line is in every Adwaita snippet
+ * that gives a button a look. The two doors hold the SAME list, so a widget that offers
+ * both cannot have them disagree — which is why the mutation is a pure function over the
+ * list rather than a second `className` rewrite per method.
+ *
+ * ADDS AT THE END, AND ONLY IF ABSENT. `gtk_widget_add_css_class` is a no-op for a class
+ * the widget already has (the quark is already in the list), so a second add does not move
+ * it — measured under gjs 1.88.1: `add_css_class('a'); add_css_class('b');
+ * add_css_class('a')` reads back two classes.
+ *
+ * ONE NAME, TRIMMED. GTK takes a single class name and would happily intern `'a b'` as one
+ * unmatchable class; here the string door already means "a whitespace-separated list", so a
+ * name with whitespace in it is the caller confusing the two doors. It is trimmed, and an
+ * empty name is dropped rather than added as a class nothing can be.
+ */
+export declare function withCssClass(classes: readonly string[], name: string): string[];
+/** The list after `gtk_widget_remove_css_class(name)`. Absent is a no-op, as in C. */
+export declare function withoutCssClass(classes: readonly string[], name: string): string[];

package/lib/types/widgets/view-switcher-base.d.ts

@@ -11,11 +11,22 @@ export declare const NOTIFY_SELECTED = "notify::selected";
  */
 export interface NotifyViewSelectedEventData extends EventData, ViewSwitcherNotifyPayload {
 }
+declare const AdwViewSwitcherBase_base: (abstract new (...args: any[]) => {
+    connect(eventName: string, callback: (self: /*elided*/ any, data: EventData) => void): number;
+    disconnect(handlerId: number): void;
+    _emit(eventName: string): void;
+    addEventListener(eventName: string, callback: (data: EventData) => void, thisArg?: unknown, once?: boolean): void;
+    removeEventListener(eventName: string, callback?: (data: EventData) => void, thisArg?: unknown): void;
+    notify<T extends EventData>(data: T): void;
+    notifyPropertyChange(name: string, value: unknown, oldValue?: unknown): void;
+    set(name: string, value: unknown): void;
+    get(name: string): unknown;
+}) & typeof GridLayout;
 /**
  * Shared base: a switcher bar (row 0) + a content area (row 1), one page visible.
  * Subclasses set the bar/button CSS classes for their look.
  */
-export declare abstract class AdwViewSwitcherBase extends GridLayout {
+export declare abstract class AdwViewSwitcherBase extends AdwViewSwitcherBase_base {
     /** The horizontal switcher bar holding the buttons. */
     protected readonly _bar: GridLayout;
     /** `Adw.ViewSwitcher:policy`, default NARROW as in C. */

package/lib/types/widgets/view-switcher-model.d.ts

@@ -8,9 +8,9 @@ import type { AdwViewSwitcherPageInit, ViewSwitcherStateChange } from '@gjsify/a
  * `icon` are NULLABLE on purpose: a page with neither renders no button at all, and
  * an absent title flattened to `''` makes that rule inexpressible.
  *
- * `icon` is an Adwaita symbolic SVG DOCUMENT here, not a GTK icon name: `AdwIcon`
+ * `icon` is an Adwaita symbolic SVG DOCUMENT here, not a GTK icon name: `GtkImage`
  * rasterises the path data natively. The core treats the field as an opaque
- * handle and only ever interprets "absent or empty"; {@link nsIconSvg} resolves
+ * handle and only ever interprets "absent or empty"; `icon-theme.ts` resolves
  * the fallback sentinel it hands back.
  */
 export interface AdwViewPage {
@@ -18,7 +18,7 @@ export interface AdwViewPage {
     title?: string;
     /** The page content view, shown when this page is selected. */
     content: View;
-    /** Adwaita symbolic SVG shown on the switcher button; absent means none. */
+    /** The icon shown on the switcher button — a NAME or SVG source; absent means none. */
     icon?: string;
     /** Stable id used by `visible-child-name`; defaults to the page's position. */
     name?: string;
@@ -47,15 +47,6 @@ export declare function createViewSwitcherBarState(): ViewSwitcherBarState;
 export declare function viewSwitcherPageSpec(page: AdwViewPage, index: number): AdwViewSwitcherPageInit;
 /** {@link viewSwitcherPageSpec} over a whole page list. */
 export declare function viewSwitcherPageSpecs(pages: readonly AdwViewPage[]): AdwViewSwitcherPageInit[];
-/**
- * Resolve the core's icon slot to something `AdwIcon` can rasterise.
- *
- * The core substitutes the NAME `image-missing` for an absent icon. On the browser
- * side that name becomes a CSS mask class; here it has to become the actual
- * symbolic document, so the sentinel is swapped for the vendored
- * `image-missing-symbolic` SVG. Anything else is already an SVG and passes through.
- */
-export declare function nsIconSvg(iconName: string): string;
 /**
  * The `visibility` each page's content view must carry for the current
  * selection, in page order. Exactly one entry is `'visible'` — none when nothing

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-nativescript",
-    "version": "0.47.0",
+    "version": "0.49.0",
     "description": "Native Adwaita widgets for the NativeScript runtime — real NativeScript components (StackLayout/GridLayout/Switch/Label) styled like Libadwaita, not a webview",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -10,9 +10,13 @@
             "types": "./lib/types/index.d.ts",
             "default": "./lib/esm/index.js"
         },
-        "./widgets": {
-            "types": "./lib/types/widgets/index.d.ts",
-            "default": "./lib/esm/widgets/index.js"
+        "./adw": {
+            "types": "./lib/types/namespace/adw.d.ts",
+            "default": "./lib/esm/namespace/adw.js"
+        },
+        "./gtk": {
+            "types": "./lib/types/namespace/gtk.d.ts",
+            "default": "./lib/esm/namespace/gtk.js"
         },
         "./theme/adwaita.css": "./src/theme/adwaita.css",
         "./fonts": {
@@ -47,10 +51,10 @@
         "design-system"
     ],
     "dependencies": {
-        "@gjsify/adwaita-core": "^0.47.0",
-        "@gjsify/adwaita-fonts": "^0.47.0",
-        "@gjsify/adwaita-icons": "^0.47.0",
-        "@gjsify/native-platform": "^0.47.0"
+        "@gjsify/adwaita-core": "^0.49.0",
+        "@gjsify/adwaita-fonts": "^0.49.0",
+        "@gjsify/adwaita-icons": "^0.49.0",
+        "@gjsify/native-platform": "^0.49.0"
     },
     "peerDependencies": {
         "@nativescript/core": "*"
@@ -61,8 +65,8 @@
         }
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.47.0",
-        "@gjsify/unit": "^0.47.0",
+        "@gjsify/cli": "^0.49.0",
+        "@gjsify/unit": "^0.49.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },

package/src/theme/adwaita.css

@@ -264,7 +264,7 @@ Page.adw-window {
  * Their 24×24 + 5 padding box (_lists.scss:194-198) is deliberately NOT
  * reproduced. It is a hit/alignment box around a 16 glyph, and NS would read a
  * `min-width` on an `Image` as room to SCALE the bitmap into — an icon half
- * again too large rather than a roomier one. The glyph size is AdwIcon's own. */
+ * again too large rather than a roomier one. The glyph size is GtkImage's own. */
 .adw-entry-indicator,
 .adw-entry-edit {
     margin: 0 0 0 6;
@@ -329,7 +329,7 @@ Page.adw-window {
 }
 
 .adw-combo-chevron {
-    /* An AdwIcon (Image) rendering `pan-down-symbolic`; size + dim colour are set
+    /* A GtkImage (Image) rendering `pan-down-symbolic`; size + dim colour are set
      * on the widget. Only the gap to the value label is styled here. */
     margin: 0 0 0 2;
     vertical-align: middle;
@@ -362,7 +362,7 @@ Page.adw-window {
 
 /* `dropdown > button > box { border-spacing: 6px }` (_dropdowns.scss:2-3) — the
  * gap between label and arrow. The arrow's 16px size (_dropdowns.scss:10-13) is
- * the AdwIcon default, and its colour follows the light/dark scheme, so neither
+ * the GtkImage default, and its colour follows the light/dark scheme, so neither
  * is set anywhere. */
 .adw-drop-down-chevron {
     margin: 0 0 0 6;
@@ -448,7 +448,7 @@ Page.adw-window {
  *
  * The `width: 32` / `height: 32` that used to be here NEVER APPLIED. NativeScript
  * ignores a CSS value for a property the widget has set as a LOCAL one
- * (properties/index.js:585-598), and `AdwIcon` assigns `width`/`height` in its
+ * (properties/index.js:585-598), and `GtkImage` assigns `width`/`height` in its
  * constructor — so the chevron has always been the 16 `expander`'s own minimum
  * asks for (_expanders.scss:2-3), which is right, while the stylesheet claimed
  * a 32 tap target it never got. `color` and `font-size` were dead for the other
@@ -499,6 +499,49 @@ Page.adw-window {
     padding: 10 32 10 32;
 }
 
+/* `%circular_button` — the explicit exception to the 9px rounded square: a full
+ * circle at 34×34 with no padding (_buttons.scss:312-317). It is the shape an
+ * icon-only button takes, which is why the rule arrives with the icon: while
+ * `Gtk.Button` was the platform's text-only `Button` the variant "had no counterpart
+ * at all", and a class with no rule would have drawn a rounded rectangle instead. The
+ * 34 is the same number `.adw-image-button` above carries, from the same line. */
+.adw-button.circular {
+    width: 34;
+    height: 34;
+    border-radius: 9999;
+    padding: 0;
+}
+
+/* The button's OWN label, and it exists because the button is a `GridLayout`.
+ *
+ * `.adw-button` above declares `color` and `font-weight`; a `GridLayout` has no text,
+ * so neither reaches anything and the label would render at the platform default —
+ * silently, since a wrong font is not an error. `.adw-button-content-label` next to it
+ * had to exist for the same reason, and these are the same numbers: the 15pt / 700 of
+ * libadwaita's `button { font-weight: bold }` (_buttons.scss:1) over the label colour
+ * `.adw-button` carries.
+ *
+ * NOT MERGED WITH `.adw-button-content-label`: that class is `Adw.ButtonContent`'s and
+ * comes with the icon's 6 right-margin and the content's own padding rule; a plain
+ * text button has neither, and one selector for both would give every text button
+ * `image-text-button` spacing. */
+.adw-button-label {
+    font-size: 15;
+    font-weight: 700;
+    color: rgba(0, 0, 0, 0.8);
+}
+
+/* On a suggested/destructive button the label takes the button's intent colour — the
+ * explicit label colour above would otherwise win over the inherited one, which is the
+ * same override `.adw-button-content-label` needs two blocks down. */
+.adw-button.suggested-action .adw-button-label {
+    color: #ffffff;
+}
+
+.adw-button.destructive-action .adw-button-label {
+    color: #c01c28;
+}
+
 /* Pressed (`:highlighted`) — Adwaita darkens the button on press rather than
  * showing a Material ripple. Mirrors adwaita-web's `:active` shades
  * (`--button-active-color` / darker `--accent-color`). Pill inherits the base. */
@@ -911,7 +954,7 @@ Page.adw-window {
     padding: 24 32 24 32;
 }
 
-/* The symbolic icon (AdwIcon) — only spacing; size/colour are baked by AdwIcon. */
+/* The symbolic icon (GtkImage) — only spacing; size/colour are baked by GtkImage. */
 .adw-status-page-icon {
     margin: 0 0 12 0;
 }
@@ -961,7 +1004,7 @@ Page.adw-window {
  * three children with `border-spacing: 6px` (_lists.scss:458-462), which the NS
  * subset has no property for — so the 6 rides on the icons, mirrored.
  *
- * MARGIN ONLY. Both are `AdwIcon`s, i.e. `Image`s showing a bitmap that was
+ * MARGIN ONLY. Both are `GtkImage`s, i.e. `Image`s showing a bitmap that was
  * rendered in its fill colour, so `color` here reaches nothing and `font-size`
  * has no text to size. They used to be declared anyway, which put a dead accent
  * declaration in the runtime-accent table as well; the colour now follows the
@@ -1012,7 +1055,7 @@ Page.adw-window {
 
 /* On a suggested/destructive button the label must take the button's foreground
  * (the explicit dark label colour above would otherwise win over the inherited
- * one). The matching ICON colour is pre-baked by the caller via AdwIcon.iconColor. */
+ * one). The matching ICON colour is pre-baked by the caller via GtkImage.iconColor. */
 .adw-button.suggested-action .adw-button-content-label {
     color: #ffffff;
 }
@@ -1711,7 +1754,7 @@ Page.ns-dark.adw-window {
 /* ===== Dark: expander row ===== */
 
 /* No dark counterpart for the chevron: the 70% is an alpha over whatever the
- * bitmap was rendered in, and AdwIcon re-renders that on a scheme change. The
+ * bitmap was rendered in, and GtkImage re-renders that on a scheme change. The
  * `color` this rule used to set reached an `Image` and did nothing. */
 
 .ns-dark .adw-expander-disclosure {
@@ -1740,6 +1783,21 @@ Page.ns-dark.adw-window {
     color: #ffffff;
 }
 
+/* Dark: the button's own label. Same three colours the dark `.adw-button` rules
+ * carry — near-white on the plain and flat button, white on suggested, the dark
+ * destructive red. */
+.ns-dark .adw-button-label {
+    color: #ffffff;
+}
+
+.ns-dark .adw-button.suggested-action .adw-button-label {
+    color: #ffffff;
+}
+
+.ns-dark .adw-button.destructive-action .adw-button-label {
+    color: #ff7b80;
+}
+
 /* Dark pressed (`:highlighted`) — Adwaita's lighter-overlay press shade. */
 .ns-dark .adw-button:highlighted {
     background-color: rgba(255, 255, 255, 0.22);

package/lib/esm/namespace.js

@@ -1 +0,0 @@
-import{AdwPreferencesPage as e}from"./widgets/adw-preferences-page.js";import{AdwPreferencesGroup as t}from"./widgets/adw-preferences-group.js";import{AdwActionRow as n}from"./widgets/adw-action-row.js";import{AdwSwitchRow as r}from"./widgets/adw-switch-row.js";import{AdwIcon as i}from"./widgets/adw-icon.js";import{AdwEntryRow as a}from"./widgets/adw-entry-row.js";import{AdwPasswordEntryRow as o}from"./widgets/adw-password-entry-row.js";import{GtkEntry as s}from"./widgets/gtk-entry.js";import{AdwComboRow as c}from"./widgets/adw-combo-row.js";import{GtkDropDown as l}from"./widgets/gtk-drop-down.js";import{AdwSpinRow as u}from"./widgets/adw-spin-row.js";import{AdwExpanderRow as d}from"./widgets/adw-expander-row.js";import{GtkButton as f}from"./widgets/gtk-button.js";import{GtkMenuButton as p}from"./widgets/gtk-menu-button.js";import{AdwBanner as m}from"./widgets/adw-banner.js";import{AdwAvatar as h}from"./widgets/adw-avatar.js";import{AdwWindowTitle as g}from"./widgets/adw-window-title.js";import{AdwClamp as _}from"./widgets/adw-clamp.js";import{AdwHeaderBar as v}from"./widgets/adw-header-bar.js";import{AdwToolbarView as y}from"./widgets/adw-toolbar-view.js";import{AdwWrapBox as b}from"./widgets/adw-wrap-box.js";import{AdwSpinner as x}from"./widgets/adw-spinner.js";import{AdwStatusPage as S}from"./widgets/adw-status-page.js";import{AdwButtonRow as C}from"./widgets/adw-button-row.js";import{AdwButtonContent as w}from"./widgets/adw-button-content.js";import{AdwSplitButton as T}from"./widgets/adw-split-button.js";import{AdwToggleGroup as E}from"./widgets/adw-toggle-group.js";import{AdwShortcutLabel as D}from"./widgets/adw-shortcut-label.js";import{AdwViewStack as O}from"./widgets/adw-view-stack.js";import{AdwViewSwitcher as k}from"./widgets/adw-view-switcher.js";import{AdwViewSwitcherBar as A}from"./widgets/adw-view-switcher-bar.js";import{AdwInlineViewSwitcher as j}from"./widgets/adw-inline-view-switcher.js";import{AdwTabView as M}from"./widgets/adw-tab-view.js";import{AdwCarousel as N}from"./widgets/adw-carousel.js";import{AdwNavigationView as P}from"./widgets/adw-navigation-view.js";import{AdwNavigationSplitView as F}from"./widgets/adw-navigation-split-view.js";import{AdwOverlaySplitView as I}from"./widgets/adw-overlay-split-view.js";import{AdwSidebar as L}from"./widgets/adw-sidebar.js";import{AdwBottomSheet as R}from"./widgets/adw-bottom-sheet.js";import{AdwToastOverlay as z}from"./widgets/adw-toast-overlay.js";import{AdwAlertDialog as B}from"./widgets/adw-alert-dialog.js";import{AdwAboutDialog as V}from"./widgets/adw-about-dialog.js";import{AdwPreferencesDialog as H}from"./widgets/adw-preferences-dialog.js";const U={AboutDialog:V,ActionRow:n,AlertDialog:B,Avatar:h,Banner:m,BottomSheet:R,ButtonContent:w,ButtonRow:C,Carousel:N,Clamp:_,ComboRow:c,EntryRow:a,ExpanderRow:d,HeaderBar:v,InlineViewSwitcher:j,NavigationSplitView:F,NavigationView:P,OverlaySplitView:I,PasswordEntryRow:o,PreferencesDialog:H,PreferencesGroup:t,PreferencesPage:e,ShortcutLabel:D,Sidebar:L,Spinner:x,SpinRow:u,SplitButton:T,StatusPage:S,SwitchRow:r,TabView:M,ToastOverlay:z,ToggleGroup:E,ToolbarView:y,ViewStack:O,ViewSwitcher:k,ViewSwitcherBar:A,WindowTitle:g,WrapBox:b},W={Button:f,DropDown:l,Entry:s,Image:i,MenuButton:p};export{U as Adw,W as Gtk};

package/lib/esm/widgets/adw-icon.js

@@ -1 +0,0 @@
-import"../_virtual/_rolldown/runtime.js";import{xmlNumber as e}from"./xml-values.js";import{onAdwaitaColorSchemeChanged as t,themeIconColor as n}from"./color-scheme.js";import{DEFAULT_ICON_COLOR as r}from"./icon-path.js";import{renderSymbolicIcon as i}from"./icons.js";import{Image as a}from"@nativescript/core";const o=16;var AdwIcon=class extends a{_iconSvg=``;_iconColor=n();_explicitColor=!1;_iconSize=16;_unsubScheme=null;constructor(){super(),this.className=`adw-icon`,this.stretch=`aspectFit`,this.width=this._iconSize,this.height=this._iconSize,this.addEventListener(`loaded`,()=>{this._syncThemeColor(),this._unsubScheme??=t(()=>this._syncThemeColor())}),this.addEventListener(`unloaded`,()=>{this._unsubScheme?.(),this._unsubScheme=null})}_syncThemeColor(){if(this._explicitColor)return;let e=n();e!==this._iconColor&&(this._iconColor=e,this._render())}_render(){if(!this._iconSvg)return;let e=i(this._iconSvg,{size:this._iconSize,color:this._iconColor});e&&(this.imageSource=e)}get iconName(){return this._iconSvg}set iconName(e){this._iconSvg=e??``,this._render()}get iconColor(){return this._iconColor}set iconColor(e){this._explicitColor=!0,this._iconColor=e||r,this._render()}get iconSize(){return this._iconSize}set iconSize(t){let n=e(t,this.iconSize);this._iconSize=Number.isFinite(n)&&n>0?n:16,this.width=this._iconSize,this.height=this._iconSize,this._render()}};export{AdwIcon,o as DEFAULT_ADW_ICON_SIZE};

package/lib/types/namespace.d.ts

@@ -1,92 +0,0 @@
-import { AdwAboutDialog } from './widgets/adw-about-dialog.js';
-import { AdwActionRow } from './widgets/adw-action-row.js';
-import { AdwAlertDialog } from './widgets/adw-alert-dialog.js';
-import { AdwAvatar } from './widgets/adw-avatar.js';
-import { AdwBanner } from './widgets/adw-banner.js';
-import { AdwBottomSheet } from './widgets/adw-bottom-sheet.js';
-import { AdwButtonContent } from './widgets/adw-button-content.js';
-import { AdwButtonRow } from './widgets/adw-button-row.js';
-import { AdwCarousel } from './widgets/adw-carousel.js';
-import { AdwClamp } from './widgets/adw-clamp.js';
-import { AdwComboRow } from './widgets/adw-combo-row.js';
-import { AdwEntryRow } from './widgets/adw-entry-row.js';
-import { AdwExpanderRow } from './widgets/adw-expander-row.js';
-import { AdwHeaderBar } from './widgets/adw-header-bar.js';
-import { AdwIcon } from './widgets/adw-icon.js';
-import { AdwInlineViewSwitcher } from './widgets/adw-inline-view-switcher.js';
-import { AdwNavigationSplitView } from './widgets/adw-navigation-split-view.js';
-import { AdwNavigationView } from './widgets/adw-navigation-view.js';
-import { AdwOverlaySplitView } from './widgets/adw-overlay-split-view.js';
-import { AdwPasswordEntryRow } from './widgets/adw-password-entry-row.js';
-import { AdwPreferencesDialog } from './widgets/adw-preferences-dialog.js';
-import { AdwPreferencesGroup } from './widgets/adw-preferences-group.js';
-import { AdwPreferencesPage } from './widgets/adw-preferences-page.js';
-import { AdwShortcutLabel } from './widgets/adw-shortcut-label.js';
-import { AdwSidebar } from './widgets/adw-sidebar.js';
-import { AdwSpinRow } from './widgets/adw-spin-row.js';
-import { AdwSpinner } from './widgets/adw-spinner.js';
-import { AdwSplitButton } from './widgets/adw-split-button.js';
-import { AdwStatusPage } from './widgets/adw-status-page.js';
-import { AdwSwitchRow } from './widgets/adw-switch-row.js';
-import { AdwTabView } from './widgets/adw-tab-view.js';
-import { AdwToastOverlay } from './widgets/adw-toast-overlay.js';
-import { AdwToggleGroup } from './widgets/adw-toggle-group.js';
-import { AdwToolbarView } from './widgets/adw-toolbar-view.js';
-import { AdwViewStack } from './widgets/adw-view-stack.js';
-import { AdwViewSwitcherBar } from './widgets/adw-view-switcher-bar.js';
-import { AdwViewSwitcher } from './widgets/adw-view-switcher.js';
-import { AdwWindowTitle } from './widgets/adw-window-title.js';
-import { AdwWrapBox } from './widgets/adw-wrap-box.js';
-import { GtkButton } from './widgets/gtk-button.js';
-import { GtkDropDown } from './widgets/gtk-drop-down.js';
-import { GtkEntry } from './widgets/gtk-entry.js';
-import { GtkMenuButton } from './widgets/gtk-menu-button.js';
-/** The libadwaita half: every widget whose own spelling is an `adw-*` tag. */
-export declare const Adw: {
-    AboutDialog: typeof AdwAboutDialog;
-    ActionRow: typeof AdwActionRow;
-    AlertDialog: typeof AdwAlertDialog;
-    Avatar: typeof AdwAvatar;
-    Banner: typeof AdwBanner;
-    BottomSheet: typeof AdwBottomSheet;
-    ButtonContent: typeof AdwButtonContent;
-    ButtonRow: typeof AdwButtonRow;
-    Carousel: typeof AdwCarousel;
-    Clamp: typeof AdwClamp;
-    ComboRow: typeof AdwComboRow;
-    EntryRow: typeof AdwEntryRow;
-    ExpanderRow: typeof AdwExpanderRow;
-    HeaderBar: typeof AdwHeaderBar;
-    InlineViewSwitcher: typeof AdwInlineViewSwitcher;
-    NavigationSplitView: typeof AdwNavigationSplitView;
-    NavigationView: typeof AdwNavigationView;
-    OverlaySplitView: typeof AdwOverlaySplitView;
-    PasswordEntryRow: typeof AdwPasswordEntryRow;
-    PreferencesDialog: typeof AdwPreferencesDialog;
-    PreferencesGroup: typeof AdwPreferencesGroup;
-    PreferencesPage: typeof AdwPreferencesPage;
-    ShortcutLabel: typeof AdwShortcutLabel;
-    Sidebar: typeof AdwSidebar;
-    Spinner: typeof AdwSpinner;
-    SpinRow: typeof AdwSpinRow;
-    SplitButton: typeof AdwSplitButton;
-    StatusPage: typeof AdwStatusPage;
-    SwitchRow: typeof AdwSwitchRow;
-    TabView: typeof AdwTabView;
-    ToastOverlay: typeof AdwToastOverlay;
-    ToggleGroup: typeof AdwToggleGroup;
-    ToolbarView: typeof AdwToolbarView;
-    ViewStack: typeof AdwViewStack;
-    ViewSwitcher: typeof AdwViewSwitcher;
-    ViewSwitcherBar: typeof AdwViewSwitcherBar;
-    WindowTitle: typeof AdwWindowTitle;
-    WrapBox: typeof AdwWrapBox;
-};
-/** The GTK half: the widgets `NS_WIDGET_ALIGNMENT` declares a `gir` alias of a GTK type. */
-export declare const Gtk: {
-    Button: typeof GtkButton;
-    DropDown: typeof GtkDropDown;
-    Entry: typeof GtkEntry;
-    Image: typeof AdwIcon;
-    MenuButton: typeof GtkMenuButton;
-};