@gjsify/adwaita-core 0.64.12-next.279 → 0.64.12-next.281

package/lib/types/list.d.ts

@@ -16,8 +16,31 @@ export type AdwComboOptionInput = string | {
 };
 /** A normalised portable list model — what a `model` property holds on every surface. */
 export type AdwListModel = ReadonlyArray<AdwComboOption>;
-/** What a `model` property ACCEPTS: the widened form of {@link AdwListModel}. */
-export type AdwListModelInput = ReadonlyArray<AdwComboOptionInput>;
+/**
+ * The two methods this module needs off a REAL model — `g_list_model_get_n_items` and
+ * `g_list_model_get_item`, nothing else.
+ *
+ * Duck-typed on purpose. This module is pure data and must not import `Gtk.StringList`, which
+ * is a GObject and would drag the whole object system into every surface that only wants to
+ * normalise items. `Gio.ListModel` IS these two methods, so matching them is matching the
+ * interface rather than guessing at a class.
+ */
+export interface AdwListModelSource {
+    /** `g_list_model_get_n_items`. */
+    get_n_items(): number;
+    /** `g_list_model_get_item` — `null` past the end. */
+    get_item(position: number): unknown;
+}
+/**
+ * What a `model` property ACCEPTS: the widened form of {@link AdwListModel}, plus a real
+ * {@link AdwListModelSource}.
+ *
+ * The model arm is new in ADR 0122, which made `Gtk.StringList` a `Gio.ListModel` instead of
+ * an `Array` subclass — the one value that used to satisfy BOTH arms at once. It is not a
+ * permanent widening: ADR 0122 § 6 narrows `Adw.ComboRow:model` to `Gio.ListModel` alone, and
+ * the array arm goes with the widget that still reads a markup attribute.
+ */
+export type AdwListModelInput = ReadonlyArray<AdwComboOptionInput> | AdwListModelSource;
 /**
  * Raw authored items → the stable `{ value, label }` descriptors every list surface
  * works with.
@@ -28,6 +51,11 @@ export type AdwListModelInput = ReadonlyArray<AdwComboOptionInput>;
  * by `undefined`. ONE home for the rule, so no two list widgets can accept two different
  * item vocabularies.
  *
+ * A REAL `Gio.ListModel` is read through {@link AdwListModelSource}, and its items through the
+ * same three rules as any other entry: a `Gtk.StringObject` arrives as the string it holds,
+ * anything else falls to the descriptor rule it already matches or does not. There is no
+ * fourth vocabulary for items that came out of a model rather than out of an array.
+ *
  * TOTAL — it throws for no input. The doors this reaches are a property assignment and a
  * markup attribute, and an author's typo must not take the widget down.
  */

package/lib/types/rgba.d.ts

@@ -0,0 +1,15 @@
+export interface RGBAInit {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+}
+export declare class RGBA {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+    constructor(init?: Partial<RGBAInit>);
+    equal(other: RGBA): boolean;
+    to_string(): string;
+}

package/lib/types/rgba.gjs.spec.d.ts

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

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

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

package/lib/types/style-manager.d.ts

@@ -1,3 +1,5 @@
+import { type AdwAccentColorName } from './accent.js';
+import { RGBA } from './rgba.js';
 import { GIR_TYPE, GObjectObject } from './gobject.js';
 /** Where a platform reads "is the interface dark" and hears it change. */
 export interface StyleSource {
@@ -8,6 +10,10 @@ export interface StyleSource {
     force?(dark: boolean | null): void;
     /** Whether the platform reports a light/dark preference at all. Absent means it cannot. */
     supportsColorSchemes?(): boolean;
+    /** Whether the platform asks for more contrast. Absent means it cannot. */
+    highContrast?(): boolean;
+    /** The system accent, snapped to one of the nine; `null` (or absent) when the platform has none. */
+    accentColor?(): AdwAccentColorName | null;
 }
 /** `Adw.ColorScheme`, with the values of the GIR. */
 export declare const ColorScheme: {
@@ -17,6 +23,20 @@ export declare const ColorScheme: {
     readonly PREFER_DARK: 3;
     readonly FORCE_DARK: 4;
 };
+/** `Adw.AccentColor`, with the values of the GIR, and its two functions. */
+export declare const AccentColor: {
+    BLUE: number;
+    TEAL: number;
+    GREEN: number;
+    YELLOW: number;
+    ORANGE: number;
+    RED: number;
+    PINK: number;
+    PURPLE: number;
+    SLATE: number;
+    to_rgba: (accent: number) => RGBA;
+    to_standalone_rgba: (accent: number, dark: boolean) => RGBA;
+};
 export declare class StyleManagerBase extends GObjectObject {
     static [GIR_TYPE]: string;
     static source: StyleSource | undefined;
@@ -25,6 +45,14 @@ export declare class StyleManagerBase extends GObjectObject {
     get_dark(): boolean;
     get system_supports_color_schemes(): boolean;
     get_system_supports_color_schemes(): boolean;
+    get high_contrast(): boolean;
+    get_high_contrast(): boolean;
+    get system_supports_accent_colors(): boolean;
+    get_system_supports_accent_colors(): boolean;
+    get accent_color(): number;
+    get_accent_color(): number;
+    get accent_color_rgba(): RGBA;
+    get_accent_color_rgba(): RGBA;
     get color_scheme(): number;
     set color_scheme(scheme: number);
     get_color_scheme(): number;

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

@@ -1,7 +1,10 @@
+import { type PointNode } from './graphene.js';
 /** The slice of a DOM element these members read; core has no DOM lib. */
-interface WidgetNode {
+interface WidgetNode extends PointNode {
     dir: string;
     readonly isConnected: boolean;
+    readonly offsetWidth: number;
+    readonly offsetHeight: number;
     removeAttribute(name: string): void;
     hasAttribute(name: string): boolean;
     toggleAttribute(name: string, force?: boolean): boolean;

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

@@ -30,6 +30,23 @@ export declare class WindowMemberState<TWidget> {
     /** The platform says which widget holds focus. Returns whether that was news. */
     reportFocus(next: TWidget | null): boolean;
 }
+/** The `Gtk.Window` size properties, in the order GTK notifies them. */
+export type DefaultSizeProperty = 'default-height' | 'default-width';
+/** What `gtk_window_set_default_size` does with one call. */
+export interface DefaultSizeStep {
+    readonly width: number;
+    readonly height: number;
+    /** The properties that moved, in notification order: height BEFORE width. */
+    readonly changed: readonly DefaultSizeProperty[];
+}
+/**
+ * `gtk_window_set_default_size` (gtkwindow.c:5030, `gtk_window_set_default_size_internal`): `-1`
+ * and `0` both mean "no size asked", anything below `-1` is a `g_return_if_fail` — a CRITICAL and no
+ * change — and a write that equals the held value does not notify. When both move, `default-height`
+ * notifies first. Answers `null` for a refused call, else the sizes to hold and what to notify; the
+ * port stores the sizes and fires the notifications.
+ */
+export declare function stepDefaultSize(current: readonly [number, number], width: number, height: number): DefaultSizeStep | null;
 /**
  * `_gtk_boolean_handled_accumulator` for `close-request`: the first handler to return something
  * truthy has handled the signal and STOPS the emission — the remaining handlers and the class
@@ -106,6 +123,9 @@ export interface WindowCommon<TWidget = unknown> {
     is_maximized(): boolean;
     maximize(): void;
     unmaximize(): void;
+    /** `Gtk.Window:default-width` / `default-height`; `[0, 0]` until one is set. */
+    get_default_size(): [number, number];
+    set_default_size(width: number, height: number): void;
     present(): void;
     /**
      * `Gtk.Window:application`; writing it is `set_application`, which adds the window to the

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-core",
-    "version": "0.64.12-next.279",
+    "version": "0.64.12-next.281",
     "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-next.279",
+        "@gjsify/cli": "0.64.12-next.281",
         "@gjsify/node-gi": "file:../../../packages/node-gi/node-gi",
-        "@gjsify/unit": "0.64.12-next.279",
+        "@gjsify/unit": "0.64.12-next.281",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -93,5 +93,5 @@
         "url": "https://github.com/gjsify/gjsify/issues"
     },
     "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-core#readme",
-    "gitHead": "e9026ad9f11b386102628e9e6fb93cb8b6cbd5ee"
+    "gitHead": "c4d2e266c0d9849860b9828c14ebfe37b6d493b8"
 }