@gjsify/adwaita-core 0.64.12 → 0.64.13-next.283

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

@@ -28,7 +28,11 @@ export interface SplitButtonChange {
     mode: SplitButtonContentMode;
     /** The label, or `null` unless {@link mode} is `'label'`. */
     label: string | null;
-    /** The icon name, or `null` unless {@link mode} is `'icon'`. */
+    /**
+     * The icon name as `get_icon_name` reads it back: `null` unless {@link mode} is
+     * `'icon'`, and `null` as well for an icon name set to `''`
+     * ({@link gtkButtonIconNameReadback}).
+     */
     iconName: string | null;
     /** The child widget — the app's in `'child'` mode, an opaque internal node in `'label'`/`'icon'` mode. */
     child: object | null;
@@ -135,6 +139,11 @@ export declare class SplitButtonState {
     /** Subscribe to state changes. Returns an unsubscribe function. */
     subscribe(listener: SplitButtonListener): () => void;
     private _emit;
+    /**
+     * The `notify::*` sequence a content mutation owes, per {@link CONTENT_NOTIFY_ORDER}.
+     * Reads the PRE-state, so every caller must build its list before mutating.
+     */
+    private _contentNotify;
     /** Which content slot is filled. */
     get mode(): SplitButtonContentMode;
     /** The label, or `null` unless {@link mode} is `'label'`. */
@@ -145,11 +154,19 @@ export declare class SplitButtonState {
      * C, clearing it is a side effect of setting another slot.
      */
     setLabel(label: string): boolean;
-    /** The icon name, or `null` unless {@link mode} is `'icon'`. */
+    /**
+     * The icon name as `adw_split_button_get_icon_name` reads it back — `null` unless
+     * {@link mode} is `'icon'`, and `null` as well for an icon name set to `''`, which
+     * leaves GtkButton's internal image EMPTY ({@link gtkButtonIconNameReadback}).
+     */
     get iconName(): string | null;
     /**
      * Set the icon name, clearing `label` and `child`. A non-string is rejected —
      * `g_return_if_fail (icon_name != NULL)`.
+     *
+     * The guard is C's `g_strcmp0 (icon_name, get_icon_name (self))`: against the
+     * READBACK, so `''` is never equal to the `null` it reads back as and every
+     * `setIconName('')` is a change that notifies afresh.
      */
     setIconName(iconName: string): boolean;
     /**
@@ -190,15 +207,20 @@ export declare class SplitButtonState {
      * from a renderer's point of view. A model that is non-empty but draws nothing — one
      * empty section — is NOT collapsed: it has a node, so it is a menu, which is the
      * answer GTK gives for the same `GMenu`.
+     *
+     * Notifies both properties per {@link DROPDOWN_NOTIFY_ORDER}; the guard is on the
+     * menu model ALONE, so clearing it on a popover-only button emits nothing.
      */
     setMenuModel(input: AdwMenuInput | null | undefined): boolean;
     /** The popover: the one the app set, or the model-derived stand-in, or `null`. */
     get popover(): object | null;
     /**
-     * Set the popover, dissociating any menu model. The cleared property is notified before
-     * the set one, the order `set_label()`/`set_icon_name`/`set_child` use throughout this
-     * widget; GtkMenuButton's own internal ordering is not observable from the upstream
-     * suite, which only counts per-property notifications.
+     * Set (or clear, with `null`) the popover, dissociating any menu model. Both properties
+     * are notified per {@link DROPDOWN_NOTIFY_ORDER}, UNCONDITIONALLY — setting a popover on
+     * a split button that never had a menu model still emits `notify::menu-model`.
+     *
+     * The guard is pointer equality on the popover ALONE, so handing back the
+     * model-derived popover is a no-op that leaves the menu model in place.
      */
     setPopover(popover: object | null | undefined): boolean;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-core",
-    "version": "0.64.12",
+    "version": "0.64.13-next.283",
     "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",
@@ -67,9 +67,9 @@
         "headless"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.64.12",
+        "@gjsify/cli": "0.64.13-next.283",
         "@gjsify/node-gi": "file:../../../packages/node-gi/node-gi",
-        "@gjsify/unit": "^0.64.12",
+        "@gjsify/unit": "0.64.13-next.283",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -92,5 +92,6 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-core#readme"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-core#readme",
+    "gitHead": "05fae97125a374e84bf57c2d2d086fb53523f205"
 }