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

package/lib/types/widget-members.d.ts

@@ -8,17 +8,52 @@ interface WidgetNode extends PointNode {
     removeAttribute(name: string): void;
     hasAttribute(name: string): boolean;
     toggleAttribute(name: string, force?: boolean): boolean;
-    readonly firstElementChild: unknown;
-    readonly lastElementChild: unknown;
-    readonly nextElementSibling: unknown;
-    readonly previousElementSibling: unknown;
-    readonly parentElement: unknown;
+    readonly localName: string;
+    readonly firstElementChild: LinkedNode | null;
+    readonly lastElementChild: LinkedNode | null;
+    readonly nextElementSibling: LinkedNode | null;
+    readonly previousElementSibling: LinkedNode | null;
+    readonly parentElement: LinkedNode | null;
     readonly classList: {
         add(name: string): void;
         remove(name: string): void;
         contains(name: string): boolean;
     };
 }
+/**
+ * What the tree walkers need of a node they STEP OVER: its name, and the link to the next
+ * candidate. A `<span>` a label built answers both and is no `WidgetNode` — the whole point.
+ */
+interface LinkedNode {
+    readonly localName: string;
+    readonly firstElementChild: LinkedNode | null;
+    readonly lastElementChild: LinkedNode | null;
+    readonly nextElementSibling: LinkedNode | null;
+    readonly previousElementSibling: LinkedNode | null;
+    readonly parentElement: LinkedNode | null;
+}
+/**
+ * Is this element a WIDGET, or a piece of a widget's own insides?
+ *
+ * `gtk_widget_get_first_child` walks the WIDGET tree — every node it hands back is a
+ * `GtkWidget`, including the template children of a composite one. A DOM port has a second
+ * kind of child in the same `children` list: the `<span>` a label's markup renderer builds,
+ * the `<div>` a row lays its slots out in. Those are not widgets in any renderer, and a
+ * caller that got one back found `instanceof Gtk.Label` false and, one step further, no
+ * `get_first_child` on it at all — a `TypeError` thrown in the consumer's walk, far from
+ * the port that produced the node. (Measured in Learn6502: a depth-first walk over the
+ * rendered tutorial hit the spans inside a label and died.)
+ *
+ * The test is the one the DOM itself guarantees: a custom element name MUST contain a
+ * hyphen and a built-in one may not, so `localName.includes('-')` separates the two kinds
+ * exactly. `compute-expand.ts` reads the same signal for the same reason.
+ *
+ * Reference: GTK gtk/gtkwidget.c (gtk_widget_get_first_child — `priv->first_child`, a
+ * GtkWidget), WHATWG HTML § custom element name (the hyphen requirement).
+ */
+export declare function isWidgetNode(node: {
+    readonly localName: string;
+} | null | undefined): boolean;
 /**
  * Mirrors the held direction onto the `dir` attribute. A custom element may not take an attribute
  * while `createElement` constructs it, and a widget's constructor is where GTK code pins its

package/lib/types/widget-members.spec.d.ts

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

package/package.json

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