@gtkx/react 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/element-config.d.ts

@@ -0,0 +1,10 @@
+import { type ElementConfig } from "./reconciler/registry.js";
+declare const SINGLE_CHILD_TYPES: string[];
+/**
+ * The static, runtime-free half of the built-in element configuration: which base props interface each
+ * generated element extends, which component wraps it, and whether its GObject is created lazily by its
+ * parent. Codegen imports this module, so it must never reach the GObject bindings.
+ */
+declare const BUILTIN_ELEMENTS: Record<string, ElementConfig>;
+export { SINGLE_CHILD_TYPES, BUILTIN_ELEMENTS };
+//# sourceMappingURL=element-config.d.ts.map

package/dist/element-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-config.d.ts","sourceRoot":"","sources":["../src/element-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAElF,QAAA,MAAM,kBAAkB,EAAE,MAAM,EAsB/B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAqHnD,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/element-config.js

@@ -0,0 +1,149 @@
+import { forTypes, internal } from "./reconciler/registry.js";
+const SINGLE_CHILD_TYPES = [
+    "GtkAspectFrame",
+    "GtkButton",
+    "GtkCheckButton",
+    "GtkComboBox",
+    "GtkDragIcon",
+    "GtkExpander",
+    "GtkFlowBoxChild",
+    "GtkFrame",
+    "GtkGraphicsOffload",
+    "GtkListBoxRow",
+    "GtkListHeader",
+    "GtkListItem",
+    "GtkMenuButton",
+    "GtkPopover",
+    "GtkPopoverBin",
+    "GtkRevealer",
+    "GtkScrolledWindow",
+    "GtkSearchBar",
+    "GtkTreeExpander",
+    "GtkViewport",
+    "GtkWindowHandle",
+];
+/**
+ * The static, runtime-free half of the built-in element configuration: which base props interface each
+ * generated element extends, which component wraps it, and whether its GObject is created lazily by its
+ * parent. Codegen imports this module, so it must never reach the GObject bindings.
+ */
+const BUILTIN_ELEMENTS = {
+    ...forTypes(SINGLE_CHILD_TYPES, {
+        props: internal("ChildrenProps"),
+        omitProps: ["child"],
+    }),
+    ...forTypes(["GtkHeaderBar", "GtkActionBar"], {
+        props: internal("GtkHeaderBarProps"),
+    }),
+    GtkWindow: {
+        props: internal("ChildrenProps"),
+        component: internal("createWindowComponent"),
+        omitProps: ["child"],
+    },
+    GtkLabel: {
+        props: internal("ChildrenProps"),
+    },
+    GtkTextBuffer: {
+        props: internal("ChildrenProps"),
+    },
+    GtkTextTag: {
+        props: internal("ChildrenProps"),
+    },
+    GtkTextChildAnchor: {
+        props: internal("GtkTextChildAnchorProps"),
+    },
+    GtkGridLayoutChild: {
+        lazy: true,
+    },
+    GtkFixedLayoutChild: {
+        lazy: true,
+    },
+    GtkOverlayLayoutChild: {
+        lazy: true,
+    },
+    GtkStackPage: {
+        lazy: true,
+    },
+    GtkNotebookPage: {
+        lazy: true,
+    },
+    GActionGroup: {
+        props: internal("GActionGroupProps"),
+    },
+    GtkWidget: {
+        props: internal("GtkWidgetProps"),
+    },
+    GtkBox: {
+        props: internal("ChildrenProps"),
+    },
+    GtkListBox: {
+        props: internal("ChildrenProps"),
+    },
+    GtkFlowBox: {
+        props: internal("ChildrenProps"),
+    },
+    GtkOverlay: {
+        props: internal("GtkOverlayProps"),
+        omitProps: ["child"],
+    },
+    GtkShortcutController: {
+        props: internal("GtkShortcutControllerProps"),
+    },
+    GtkTextView: {
+        props: internal("ChildrenProps"),
+    },
+    GActionMap: {
+        props: internal("GActionMapProps"),
+    },
+    GMenu: {
+        props: internal("GMenuProps"),
+    },
+    GtkColumnView: {
+        props: internal("ChildrenProps"),
+    },
+    GtkGrid: {
+        props: internal("ChildrenProps"),
+    },
+    GtkFixed: {
+        props: internal("ChildrenProps"),
+    },
+    GtkSizeGroup: {
+        props: internal("GtkSizeGroupProps"),
+    },
+    GtkConstraintLayout: {
+        props: internal("GtkConstraintLayoutProps"),
+    },
+    GtkStack: {
+        props: internal("ChildrenProps"),
+    },
+    GtkNotebook: {
+        props: internal("ChildrenProps"),
+    },
+    GtkApplication: {
+        props: internal("GtkApplicationProps"),
+        component: internal("createApplicationComponent"),
+    },
+    GtkAboutDialog: {
+        props: internal("GtkAboutDialogProps"),
+    },
+    GtkScale: {
+        props: internal("GtkScaleProps"),
+    },
+    GtkCalendar: {
+        props: internal("GtkCalendarProps"),
+    },
+    GtkLevelBar: {
+        props: internal("GtkLevelBarProps"),
+    },
+    GtkDropTarget: {
+        props: internal("GtkDropTargetProps"),
+    },
+    GtkDrawingArea: {
+        props: internal("GtkDrawingAreaProps"),
+    },
+    GtkDragSource: {
+        props: internal("GtkDragSourceProps"),
+    },
+};
+export { SINGLE_CHILD_TYPES, BUILTIN_ELEMENTS };
+//# sourceMappingURL=element-config.js.map

package/dist/element-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-config.js","sourceRoot":"","sources":["../src/element-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ElementConfig, forTypes, internal } from \"./reconciler/registry.js\";\n\nconst SINGLE_CHILD_TYPES: string[] = [\n    \"GtkAspectFrame\",\n    \"GtkButton\",\n    \"GtkCheckButton\",\n    \"GtkComboBox\",\n    \"GtkDragIcon\",\n    \"GtkExpander\",\n    \"GtkFlowBoxChild\",\n    \"GtkFrame\",\n    \"GtkGraphicsOffload\",\n    \"GtkListBoxRow\",\n    \"GtkListHeader\",\n    \"GtkListItem\",\n    \"GtkMenuButton\",\n    \"GtkPopover\",\n    \"GtkPopoverBin\",\n    \"GtkRevealer\",\n    \"GtkScrolledWindow\",\n    \"GtkSearchBar\",\n    \"GtkTreeExpander\",\n    \"GtkViewport\",\n    \"GtkWindowHandle\",\n];\n\n/**\n * The static, runtime-free half of the built-in element configuration: which base props interface each\n * generated element extends, which component wraps it, and whether its GObject is created lazily by its\n * parent. Codegen imports this module, so it must never reach the GObject bindings.\n */\nconst BUILTIN_ELEMENTS: Record<string, ElementConfig> = {\n    ...forTypes(SINGLE_CHILD_TYPES, {\n        props: internal(\"ChildrenProps\"),\n        omitProps: [\"child\"],\n    }),\n    ...forTypes([\"GtkHeaderBar\", \"GtkActionBar\"], {\n        props: internal(\"GtkHeaderBarProps\"),\n    }),\n    GtkWindow: {\n        props: internal(\"ChildrenProps\"),\n        component: internal(\"createWindowComponent\"),\n        omitProps: [\"child\"],\n    },\n    GtkLabel: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkTextBuffer: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkTextTag: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkTextChildAnchor: {\n        props: internal(\"GtkTextChildAnchorProps\"),\n    },\n    GtkGridLayoutChild: {\n        lazy: true,\n    },\n    GtkFixedLayoutChild: {\n        lazy: true,\n    },\n    GtkOverlayLayoutChild: {\n        lazy: true,\n    },\n    GtkStackPage: {\n        lazy: true,\n    },\n    GtkNotebookPage: {\n        lazy: true,\n    },\n    GActionGroup: {\n        props: internal(\"GActionGroupProps\"),\n    },\n    GtkWidget: {\n        props: internal(\"GtkWidgetProps\"),\n    },\n    GtkBox: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkListBox: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkFlowBox: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkOverlay: {\n        props: internal(\"GtkOverlayProps\"),\n        omitProps: [\"child\"],\n    },\n    GtkShortcutController: {\n        props: internal(\"GtkShortcutControllerProps\"),\n    },\n    GtkTextView: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GActionMap: {\n        props: internal(\"GActionMapProps\"),\n    },\n    GMenu: {\n        props: internal(\"GMenuProps\"),\n    },\n    GtkColumnView: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkGrid: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkFixed: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkSizeGroup: {\n        props: internal(\"GtkSizeGroupProps\"),\n    },\n    GtkConstraintLayout: {\n        props: internal(\"GtkConstraintLayoutProps\"),\n    },\n    GtkStack: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkNotebook: {\n        props: internal(\"ChildrenProps\"),\n    },\n    GtkApplication: {\n        props: internal(\"GtkApplicationProps\"),\n        component: internal(\"createApplicationComponent\"),\n    },\n    GtkAboutDialog: {\n        props: internal(\"GtkAboutDialogProps\"),\n    },\n    GtkScale: {\n        props: internal(\"GtkScaleProps\"),\n    },\n    GtkCalendar: {\n        props: internal(\"GtkCalendarProps\"),\n    },\n    GtkLevelBar: {\n        props: internal(\"GtkLevelBarProps\"),\n    },\n    GtkDropTarget: {\n        props: internal(\"GtkDropTargetProps\"),\n    },\n    GtkDrawingArea: {\n        props: internal(\"GtkDrawingAreaProps\"),\n    },\n    GtkDragSource: {\n        props: internal(\"GtkDragSourceProps\"),\n    },\n};\n\nexport { SINGLE_CHILD_TYPES, BUILTIN_ELEMENTS };\n"]}

package/dist/hooks/use-application.d.ts

@@ -1,8 +1,9 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import { type Context } from "react";
-export declare const ApplicationContext: Context<Gtk.Application | null>;
+declare const ApplicationContext: Context<Gtk.Application | null>;
 /**
- * Returns the `Gtk.Application` provided by the nearest `Application` ancestor, throwing if used outside one.
+ * Returns the `Gtk.Application` provided by the nearest `GtkApplication` ancestor, throwing if used outside one.
  */
-export declare const useApplication: () => Gtk.Application;
+declare const useApplication: () => Gtk.Application;
+export { ApplicationContext, useApplication };
 //# sourceMappingURL=use-application.d.ts.map

package/dist/hooks/use-application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-application.d.ts","sourceRoot":"","sources":["../../src/hooks/use-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,OAAO,CAAC;AAEzD,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAA+C,CAAC;AAE/G;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,GAAG,CAAC,WAQrC,CAAC"}
+{"version":3,"file":"use-application.d.ts","sourceRoot":"","sources":["../../src/hooks/use-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,OAAO,CAAC;AAEzD,QAAA,MAAM,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAA+C,CAAC;AAExG;;GAEG;AACH,QAAA,MAAM,cAAc,QAAO,GAAG,CAAC,WAQ9B,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/use-application.js

@@ -1,13 +1,14 @@
 import { createContext, use } from "react";
-export const ApplicationContext = createContext(null);
+const ApplicationContext = createContext(null);
 /**
- * Returns the `Gtk.Application` provided by the nearest `Application` ancestor, throwing if used outside one.
+ * Returns the `Gtk.Application` provided by the nearest `GtkApplication` ancestor, throwing if used outside one.
  */
-export const useApplication = () => {
+const useApplication = () => {
     const context = use(ApplicationContext);
     if (!context) {
-        throw new Error("Expected ApplicationContext: useApplication must be called within Application");
+        throw new Error("useApplication must be called within GtkApplication");
     }
     return context;
 };
+export { ApplicationContext, useApplication };
 //# sourceMappingURL=use-application.js.map

package/dist/hooks/use-application.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-application.js","sourceRoot":"","sources":["../../src/hooks/use-application.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,CAAC,MAAM,kBAAkB,GAAoC,aAAa,CAAyB,IAAI,CAAC,CAAC;AAE/G;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAoB,EAAE;IAChD,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACrG,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type Context, createContext, use } from \"react\";\n\nexport const ApplicationContext: Context<Gtk.Application | null> = createContext<Gtk.Application | null>(null);\n\n/**\n * Returns the `Gtk.Application` provided by the nearest `Application` ancestor, throwing if used outside one.\n */\nexport const useApplication = (): Gtk.Application => {\n    const context = use(ApplicationContext);\n\n    if (!context) {\n        throw new Error(\"Expected ApplicationContext: useApplication must be called within Application\");\n    }\n\n    return context;\n};\n"]}
+{"version":3,"file":"use-application.js","sourceRoot":"","sources":["../../src/hooks/use-application.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,kBAAkB,GAAoC,aAAa,CAAyB,IAAI,CAAC,CAAC;AAExG;;GAEG;AACH,MAAM,cAAc,GAAG,GAAoB,EAAE;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type Context, createContext, use } from \"react\";\n\nconst ApplicationContext: Context<Gtk.Application | null> = createContext<Gtk.Application | null>(null);\n\n/**\n * Returns the `Gtk.Application` provided by the nearest `GtkApplication` ancestor, throwing if used outside one.\n */\nconst useApplication = (): Gtk.Application => {\n    const context = use(ApplicationContext);\n\n    if (!context) {\n        throw new Error(\"useApplication must be called within GtkApplication\");\n    }\n\n    return context;\n};\n\nexport { ApplicationContext, useApplication };\n"]}

package/dist/hooks/use-bind-setting.d.ts

@@ -1,6 +1,23 @@
-import * as Gio from "@gtkx/gi/gio";
 import type * as GObject from "@gtkx/gi/gobject";
-import type { ObjectProp } from "../utils/object-prop.js";
-import { type SchemaRef } from "./use-setting.js";
-export declare function useBindSetting<K extends object, P extends keyof K & string>(schema: SchemaRef<K>, key: P, object: ObjectProp<GObject.Object>, property: string, flags?: Gio.SettingsBindFlags): void;
+import * as Gio from "@gtkx/gi/gio";
+import type { SettingsSchema, SettingsSchemaKeys } from "../utils/settings.js";
+import { type RefProp } from "../utils/ref-prop.js";
+type UseBindSettingOptions<K extends SettingsSchemaKeys> = {
+    schema: SettingsSchema<K>;
+    key: keyof K & string;
+    object: RefProp<GObject.Object>;
+    property: string;
+    flags?: Gio.SettingsBindFlags;
+};
+/**
+ * Binds a GSettings key to a property of a GObject, keeping the two in sync for the object's lifetime.
+ *
+ * @param options.schema The schema reference identifying the settings backend.
+ * @param options.key The key within the schema to bind.
+ * @param options.object The GObject whose property is bound to the setting.
+ * @param options.property The name of the object property to bind.
+ * @param options.flags Flags controlling the binding's direction and behaviour.
+ */
+declare function useBindSetting<K extends SettingsSchemaKeys>({ schema, key, object, property, flags, }: UseBindSettingOptions<K>): void;
+export { useBindSetting };
 //# sourceMappingURL=use-bind-setting.d.ts.map

package/dist/hooks/use-bind-setting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-bind-setting.d.ts","sourceRoot":"","sources":["../../src/hooks/use-bind-setting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAEvE,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACvE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,GAAG,CAAC,iBAAiB,GAC9B,IAAI,CAAC"}
+{"version":3,"file":"use-bind-setting.d.ts","sourceRoot":"","sources":["../../src/hooks/use-bind-setting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,KAAK,OAAO,EAAkB,MAAM,sBAAsB,CAAC;AAGpE,KAAK,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,IAAI;IACvD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACH,iBAAS,cAAc,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAClD,MAAM,EACN,GAAG,EACH,MAAM,EACN,QAAQ,EACR,KAAqC,GACxC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAiBjC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/use-bind-setting.js

@@ -1,19 +1,30 @@
 import * as Gio from "@gtkx/gi/gio";
-import { toKebabCase } from "@gtkx/utils";
-import { useObjectAttachment } from "./use-object-attachment.js";
-import { useSettingsInstance } from "./use-setting.js";
-export function useBindSetting(schema, key, object, property, flags = Gio.SettingsBindFlags.DEFAULT) {
-    const settings = useSettingsInstance(schema);
-    const propertyName = toKebabCase(property);
-    useObjectAttachment(object, {
-        attach: (obj) => {
-            settings.bind(key, obj, propertyName, flags);
-            return obj;
-        },
-        detach: (obj) => {
-            Gio.Settings.unbind(obj, propertyName);
-        },
-        isSame: (attachment, current) => attachment === current,
-    });
+import { kebabCase } from "@gtkx/utils";
+import { useLayoutEffect } from "react";
+import { resolveRefProp } from "../utils/ref-prop.js";
+import { useSettings } from "./use-setting.js";
+/**
+ * Binds a GSettings key to a property of a GObject, keeping the two in sync for the object's lifetime.
+ *
+ * @param options.schema The schema reference identifying the settings backend.
+ * @param options.key The key within the schema to bind.
+ * @param options.object The GObject whose property is bound to the setting.
+ * @param options.property The name of the object property to bind.
+ * @param options.flags Flags controlling the binding's direction and behaviour.
+ */
+function useBindSetting({ schema, key, object, property, flags = Gio.SettingsBindFlags.DEFAULT, }) {
+    const settings = useSettings(schema);
+    const propertyName = kebabCase(property);
+    useLayoutEffect(() => {
+        const resolved = resolveRefProp(object);
+        if (!resolved) {
+            return;
+        }
+        settings.bind(key, resolved, propertyName, flags);
+        return () => {
+            Gio.Settings.unbind(resolved, propertyName);
+        };
+    }, [settings, key, object, propertyName, flags]);
 }
+export { useBindSetting };
 //# sourceMappingURL=use-bind-setting.js.map

package/dist/hooks/use-bind-setting.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-bind-setting.js","sourceRoot":"","sources":["../../src/hooks/use-bind-setting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASvE,MAAM,UAAU,cAAc,CAC1B,MAAiB,EACjB,GAAW,EACX,MAAkC,EAClC,QAAgB,EAChB,KAAK,GAA0B,GAAG,CAAC,iBAAiB,CAAC,OAAO;IAE5D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE3C,mBAAmB,CAAiC,MAAM,EAAE;QACxD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACZ,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO,GAAG,CAAC;QACf,CAAC;QACD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACZ,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,KAAK,OAAO;KAC1D,CAAC,CAAC;AACP,CAAC","sourcesContent":["import * as Gio from \"@gtkx/gi/gio\";\nimport type * as GObject from \"@gtkx/gi/gobject\";\nimport { toKebabCase } from \"@gtkx/utils\";\nimport type { ObjectProp } from \"../utils/object-prop.js\";\nimport { useObjectAttachment } from \"./use-object-attachment.js\";\nimport { type SchemaRef, useSettingsInstance } from \"./use-setting.js\";\n\nexport function useBindSetting<K extends object, P extends keyof K & string>(\n    schema: SchemaRef<K>,\n    key: P,\n    object: ObjectProp<GObject.Object>,\n    property: string,\n    flags?: Gio.SettingsBindFlags,\n): void;\nexport function useBindSetting(\n    schema: SchemaRef,\n    key: string,\n    object: ObjectProp<GObject.Object>,\n    property: string,\n    flags: Gio.SettingsBindFlags = Gio.SettingsBindFlags.DEFAULT,\n): void {\n    const settings = useSettingsInstance(schema);\n    const propertyName = toKebabCase(property);\n\n    useObjectAttachment<GObject.Object, GObject.Object>(object, {\n        attach: (obj) => {\n            settings.bind(key, obj, propertyName, flags);\n            return obj;\n        },\n        detach: (obj) => {\n            Gio.Settings.unbind(obj, propertyName);\n        },\n        isSame: (attachment, current) => attachment === current,\n    });\n}\n"]}
+{"version":3,"file":"use-bind-setting.js","sourceRoot":"","sources":["../../src/hooks/use-bind-setting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAU/C;;;;;;;;GAQG;AACH,SAAS,cAAc,CAA+B,EAClD,MAAM,EACN,GAAG,EACH,MAAM,EACN,QAAQ,EACR,KAAK,GAAG,GAAG,CAAC,iBAAiB,CAAC,OAAO,GACd;IACvB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEzC,eAAe,CAAC,GAAG,EAAE;QACjB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAElD,OAAO,GAAG,EAAE;YACR,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gio from \"@gtkx/gi/gio\";\nimport { kebabCase } from \"@gtkx/utils\";\nimport { useLayoutEffect } from \"react\";\nimport type { SettingsSchema, SettingsSchemaKeys } from \"../utils/settings.js\";\nimport { type RefProp, resolveRefProp } from \"../utils/ref-prop.js\";\nimport { useSettings } from \"./use-setting.js\";\n\ntype UseBindSettingOptions<K extends SettingsSchemaKeys> = {\n    schema: SettingsSchema<K>;\n    key: keyof K & string;\n    object: RefProp<GObject.Object>;\n    property: string;\n    flags?: Gio.SettingsBindFlags;\n};\n\n/**\n * Binds a GSettings key to a property of a GObject, keeping the two in sync for the object's lifetime.\n *\n * @param options.schema The schema reference identifying the settings backend.\n * @param options.key The key within the schema to bind.\n * @param options.object The GObject whose property is bound to the setting.\n * @param options.property The name of the object property to bind.\n * @param options.flags Flags controlling the binding's direction and behaviour.\n */\nfunction useBindSetting<K extends SettingsSchemaKeys>({\n    schema,\n    key,\n    object,\n    property,\n    flags = Gio.SettingsBindFlags.DEFAULT,\n}: UseBindSettingOptions<K>): void {\n    const settings = useSettings(schema);\n    const propertyName = kebabCase(property);\n\n    useLayoutEffect(() => {\n        const resolved = resolveRefProp(object);\n\n        if (!resolved) {\n            return;\n        }\n\n        settings.bind(key, resolved, propertyName, flags);\n\n        return () => {\n            Gio.Settings.unbind(resolved, propertyName);\n        };\n    }, [settings, key, object, propertyName, flags]);\n}\n\nexport { useBindSetting };\n"]}

package/dist/hooks/use-merged-refs.d.ts

@@ -0,0 +1,8 @@
+import { type Ref, type RefCallback } from "react";
+type PossibleRef<T> = Ref<T> | undefined;
+type RefCleanup<T> = ReturnType<RefCallback<T>>;
+declare function assignRef<T>(ref: PossibleRef<T>, value: T): RefCleanup<T>;
+declare function mergeRefs<T>(...refs: PossibleRef<T>[]): RefCallback<T>;
+declare function useMergedRef<T>(first: PossibleRef<T>, second: PossibleRef<T>): RefCallback<T>;
+export { assignRef, mergeRefs, useMergedRef };
+//# sourceMappingURL=use-merged-refs.d.ts.map

package/dist/hooks/use-merged-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-merged-refs.d.ts","sourceRoot":"","sources":["../../src/hooks/use-merged-refs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,WAAW,EAAW,MAAM,OAAO,CAAC;AAE5D,KAAK,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AACzC,KAAK,UAAU,CAAC,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAGhD,iBAAS,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAQlE;AAsCD,iBAAS,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAI/D;AAED,iBAAS,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAEtF;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC"}

package/dist/hooks/use-merged-refs.js

@@ -0,0 +1,48 @@
+import { isRecord } from "@gtkx/utils";
+import { useMemo } from "react";
+function assignRef(ref, value) {
+    if (typeof ref === "function") {
+        return ref(value);
+    }
+    if (isRecord(ref) && "current" in ref) {
+        ref.current = value;
+    }
+}
+function collectCleanup(cleanupMap, ref, node) {
+    const cleanup = assignRef(ref, node);
+    if (cleanup) {
+        cleanupMap.set(ref, cleanup);
+    }
+}
+function cleanupRef(cleanupMap, ref) {
+    const cleanup = cleanupMap.get(ref);
+    if (cleanup && typeof cleanup === "function") {
+        cleanup();
+    }
+    else {
+        assignRef(ref, null);
+    }
+}
+function applyRefs(cleanupMap, refs, node) {
+    for (const ref of refs) {
+        collectCleanup(cleanupMap, ref, node);
+    }
+    if (cleanupMap.size === 0) {
+        return;
+    }
+    return () => {
+        for (const ref of refs) {
+            cleanupRef(cleanupMap, ref);
+        }
+        cleanupMap.clear();
+    };
+}
+function mergeRefs(...refs) {
+    const cleanupMap = new Map();
+    return (node) => applyRefs(cleanupMap, refs, node);
+}
+function useMergedRef(first, second) {
+    return useMemo(() => mergeRefs(first, second), [first, second]);
+}
+export { assignRef, mergeRefs, useMergedRef };
+//# sourceMappingURL=use-merged-refs.js.map

package/dist/hooks/use-merged-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-merged-refs.js","sourceRoot":"","sources":["../../src/hooks/use-merged-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAA8B,OAAO,EAAE,MAAM,OAAO,CAAC;AAM5D,SAAS,SAAS,CAAI,GAAmB,EAAE,KAAQ;IAC/C,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QACpC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACxB,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAI,UAAyB,EAAE,GAAmB,EAAE,IAAc;IACrF,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAErC,IAAI,OAAO,EAAE,CAAC;QACV,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAI,UAAyB,EAAE,GAAmB;IACjE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACJ,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAI,UAAyB,EAAE,IAAsB,EAAE,IAAc;IACnF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACX,CAAC;IAED,OAAO,GAAG,EAAE;QACR,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QAED,UAAU,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAI,GAAG,IAAsB;IAC3C,MAAM,UAAU,GAAkB,IAAI,GAAG,EAAE,CAAC;IAE5C,OAAO,CAAC,IAAc,EAAiB,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAI,KAAqB,EAAE,MAAsB;IAClE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { isRecord } from \"@gtkx/utils\";\nimport { type Ref, type RefCallback, useMemo } from \"react\";\n\ntype PossibleRef<T> = Ref<T> | undefined;\ntype RefCleanup<T> = ReturnType<RefCallback<T>>;\ntype CleanupMap<T> = Map<PossibleRef<T>, Exclude<RefCleanup<T>, void>>;\n\nfunction assignRef<T>(ref: PossibleRef<T>, value: T): RefCleanup<T> {\n    if (typeof ref === \"function\") {\n        return ref(value);\n    }\n\n    if (isRecord(ref) && \"current\" in ref) {\n        ref.current = value;\n    }\n}\n\nfunction collectCleanup<T>(cleanupMap: CleanupMap<T>, ref: PossibleRef<T>, node: T | null): void {\n    const cleanup = assignRef(ref, node);\n\n    if (cleanup) {\n        cleanupMap.set(ref, cleanup);\n    }\n}\n\nfunction cleanupRef<T>(cleanupMap: CleanupMap<T>, ref: PossibleRef<T>): void {\n    const cleanup = cleanupMap.get(ref);\n\n    if (cleanup && typeof cleanup === \"function\") {\n        cleanup();\n    } else {\n        assignRef(ref, null);\n    }\n}\n\nfunction applyRefs<T>(cleanupMap: CleanupMap<T>, refs: PossibleRef<T>[], node: T | null): RefCleanup<T> {\n    for (const ref of refs) {\n        collectCleanup(cleanupMap, ref, node);\n    }\n\n    if (cleanupMap.size === 0) {\n        return;\n    }\n\n    return () => {\n        for (const ref of refs) {\n            cleanupRef(cleanupMap, ref);\n        }\n\n        cleanupMap.clear();\n    };\n}\n\nfunction mergeRefs<T>(...refs: PossibleRef<T>[]): RefCallback<T> {\n    const cleanupMap: CleanupMap<T> = new Map();\n\n    return (node: T | null): RefCleanup<T> => applyRefs(cleanupMap, refs, node);\n}\n\nfunction useMergedRef<T>(first: PossibleRef<T>, second: PossibleRef<T>): RefCallback<T> {\n    return useMemo(() => mergeRefs(first, second), [first, second]);\n}\n\nexport { assignRef, mergeRefs, useMergedRef };\n"]}

package/dist/hooks/use-object-value.d.ts

@@ -1,4 +1,5 @@
 import type * as GObject from "@gtkx/gi/gobject";
-import { type ObjectProp } from "../utils/object-prop.js";
-export declare function useObjectValue<T extends GObject.Object, V>(object: ObjectProp<T>, signal: string, read: (object: T | null) => V): V;
+import { type RefProp } from "../utils/ref-prop.js";
+declare function useObjectValue<T extends GObject.Object, V>(object: RefProp<T>, signal: string, read: (object: T | null) => V): V;
+export { useObjectValue };
 //# sourceMappingURL=use-object-value.d.ts.map

package/dist/hooks/use-object-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-object-value.d.ts","sourceRoot":"","sources":["../../src/hooks/use-object-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,yBAAyB,CAAC;AAQ7E,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,EACtD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAC9B,CAAC,CAkCH"}
+{"version":3,"file":"use-object-value.d.ts","sourceRoot":"","sources":["../../src/hooks/use-object-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,KAAK,OAAO,EAAkB,MAAM,sBAAsB,CAAC;AAQpE,iBAAS,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,EAC/C,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAC9B,CAAC,CAoCH;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/use-object-value.js

@@ -1,32 +1,29 @@
 import { useCallback, useRef, useSyncExternalStore } from "react";
-import { resolveObjectProp } from "../utils/object-prop.js";
-export function useObjectValue(object, signal, read) {
-    const resolved = resolveObjectProp(object);
-    const readRef = useRef(read);
-    readRef.current = read;
+import { resolveRefProp } from "../utils/ref-prop.js";
+function useObjectValue(object, signal, read) {
+    const resolved = resolveRefProp(object);
     const cacheRef = useRef(null);
-    const readNow = useCallback(() => {
-        const cache = { object: resolved, signal, value: readRef.current(resolved) };
-        cacheRef.current = cache;
-        return cache;
-    }, [resolved, signal]);
-    const getSnapshot = useCallback(() => {
-        const cache = cacheRef.current;
-        if (cache !== null && cache.object === resolved && cache.signal === signal) {
-            return cache.value;
-        }
-        return readNow().value;
-    }, [resolved, signal, readNow]);
     const subscribe = useCallback((onStoreChange) => {
-        if (resolved === null)
-            return () => { };
+        if (resolved === null) {
+            return () => undefined;
+        }
         const handler = () => {
-            readNow();
+            cacheRef.current = null;
             onStoreChange();
         };
         resolved.on(signal, handler);
         return () => resolved.off(signal, handler);
-    }, [resolved, signal, readNow]);
+    }, [resolved, signal]);
+    const getSnapshot = () => {
+        const cache = cacheRef.current;
+        if (cache !== null && cache.object === resolved && cache.signal === signal) {
+            return cache.value;
+        }
+        const value = read(resolved);
+        cacheRef.current = { object: resolved, signal, value };
+        return value;
+    };
     return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 }
+export { useObjectValue };
 //# sourceMappingURL=use-object-value.js.map

package/dist/hooks/use-object-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-object-value.js","sourceRoot":"","sources":["../../src/hooks/use-object-value.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAmB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQ7E,MAAM,UAAU,cAAc,CAC1B,MAAqB,EACrB,MAAc,EACd,IAA6B;IAE7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,MAAM,QAAQ,GAAG,MAAM,CAAgC,IAAI,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,WAAW,CAAC,GAA2B,EAAE;QACrD,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7E,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QACzB,OAAO,KAAK,CAAC;IACjB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAM,EAAE;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC,KAAK,CAAC;QACvB,CAAC;QACD,OAAO,OAAO,EAAE,CAAC,KAAK,CAAC;IAC3B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,WAAW,CACzB,CAAC,aAAyB,EAAgB,EAAE;QACxC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QACvC,MAAM,OAAO,GAAkB,GAAG,EAAE;YAChC,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;QACpB,CAAC,CAAC;QACF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,EACD,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAC9B,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport type { SignalHandler } from \"@gtkx/runtime\";\nimport { useCallback, useRef, useSyncExternalStore } from \"react\";\nimport { type ObjectProp, resolveObjectProp } from \"../utils/object-prop.js\";\n\ntype ObjectValueCache<T extends GObject.Object, V> = {\n    object: T | null;\n    signal: string;\n    value: V;\n};\n\nexport function useObjectValue<T extends GObject.Object, V>(\n    object: ObjectProp<T>,\n    signal: string,\n    read: (object: T | null) => V,\n): V {\n    const resolved = resolveObjectProp(object);\n    const readRef = useRef(read);\n    readRef.current = read;\n    const cacheRef = useRef<ObjectValueCache<T, V> | null>(null);\n\n    const readNow = useCallback((): ObjectValueCache<T, V> => {\n        const cache = { object: resolved, signal, value: readRef.current(resolved) };\n        cacheRef.current = cache;\n        return cache;\n    }, [resolved, signal]);\n\n    const getSnapshot = useCallback((): V => {\n        const cache = cacheRef.current;\n        if (cache !== null && cache.object === resolved && cache.signal === signal) {\n            return cache.value;\n        }\n        return readNow().value;\n    }, [resolved, signal, readNow]);\n\n    const subscribe = useCallback(\n        (onStoreChange: () => void): (() => void) => {\n            if (resolved === null) return () => {};\n            const handler: SignalHandler = () => {\n                readNow();\n                onStoreChange();\n            };\n            resolved.on(signal, handler);\n            return () => resolved.off(signal, handler);\n        },\n        [resolved, signal, readNow],\n    );\n\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n"]}
+{"version":3,"file":"use-object-value.js","sourceRoot":"","sources":["../../src/hooks/use-object-value.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQpE,SAAS,cAAc,CACnB,MAAkB,EAClB,MAAc,EACd,IAA6B;IAE7B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAgC,IAAI,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,WAAW,CACzB,CAAC,aAAyB,EAAgB,EAAE;QACxC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,GAAS,EAAE,CAAC,SAAS,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAkB,GAAG,EAAE;YAChC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,aAAa,EAAE,CAAC;QACpB,CAAC,CAAC;QAEF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,EACD,CAAC,QAAQ,EAAE,MAAM,CAAC,CACrB,CAAC;IAEF,MAAM,WAAW,GAAG,GAAM,EAAE;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC,KAAK,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,QAAQ,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAEvD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport type { SignalHandler } from \"@gtkx/runtime\";\nimport { useCallback, useRef, useSyncExternalStore } from \"react\";\nimport { type RefProp, resolveRefProp } from \"../utils/ref-prop.js\";\n\ntype ObjectValueCache<T extends GObject.Object, V> = {\n    object: T | null;\n    signal: string;\n    value: V;\n};\n\nfunction useObjectValue<T extends GObject.Object, V>(\n    object: RefProp<T>,\n    signal: string,\n    read: (object: T | null) => V,\n): V {\n    const resolved = resolveRefProp(object);\n    const cacheRef = useRef<ObjectValueCache<T, V> | null>(null);\n\n    const subscribe = useCallback(\n        (onStoreChange: () => void): (() => void) => {\n            if (resolved === null) {\n                return (): void => undefined;\n            }\n\n            const handler: SignalHandler = () => {\n                cacheRef.current = null;\n                onStoreChange();\n            };\n\n            resolved.on(signal, handler);\n\n            return () => resolved.off(signal, handler);\n        },\n        [resolved, signal],\n    );\n\n    const getSnapshot = (): V => {\n        const cache = cacheRef.current;\n\n        if (cache !== null && cache.object === resolved && cache.signal === signal) {\n            return cache.value;\n        }\n\n        const value = read(resolved);\n        cacheRef.current = { object: resolved, signal, value };\n\n        return value;\n    };\n\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nexport { useObjectValue };\n"]}

package/dist/hooks/use-parent-window.d.ts

@@ -1,8 +1,9 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import { type Context } from "react";
-export declare const ParentWindowContext: Context<Gtk.Window | null>;
+declare const ParentWindowContext: Context<Gtk.Window | null>;
 /**
  * Returns the `Gtk.Window` provided by the nearest window ancestor, or `null` when there is none.
  */
-export declare const useParentWindow: () => Gtk.Window | null;
+declare const useParentWindow: () => Gtk.Window | null;
+export { ParentWindowContext, useParentWindow };
 //# sourceMappingURL=use-parent-window.d.ts.map

package/dist/hooks/use-parent-window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-parent-window.d.ts","sourceRoot":"","sources":["../../src/hooks/use-parent-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,OAAO,CAAC;AAEzD,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAA0C,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,GAAG,CAAC,MAAM,GAAG,IAAgC,CAAC"}
+{"version":3,"file":"use-parent-window.d.ts","sourceRoot":"","sources":["../../src/hooks/use-parent-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,OAAO,CAAC;AAEzD,QAAA,MAAM,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAA0C,CAAC;AAE/F;;GAEG;AACH,QAAA,MAAM,eAAe,QAAO,GAAG,CAAC,MAAM,GAAG,IAAgC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC"}

package/dist/hooks/use-parent-window.js

@@ -1,7 +1,8 @@
 import { createContext, use } from "react";
-export const ParentWindowContext = createContext(null);
+const ParentWindowContext = createContext(null);
 /**
  * Returns the `Gtk.Window` provided by the nearest window ancestor, or `null` when there is none.
  */
-export const useParentWindow = () => use(ParentWindowContext);
+const useParentWindow = () => use(ParentWindowContext);
+export { ParentWindowContext, useParentWindow };
 //# sourceMappingURL=use-parent-window.js.map

package/dist/hooks/use-parent-window.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-parent-window.js","sourceRoot":"","sources":["../../src/hooks/use-parent-window.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,CAAC,MAAM,mBAAmB,GAA+B,aAAa,CAAoB,IAAI,CAAC,CAAC;AAEtG;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAsB,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type Context, createContext, use } from \"react\";\n\nexport const ParentWindowContext: Context<Gtk.Window | null> = createContext<Gtk.Window | null>(null);\n\n/**\n * Returns the `Gtk.Window` provided by the nearest window ancestor, or `null` when there is none.\n */\nexport const useParentWindow = (): Gtk.Window | null => use(ParentWindowContext);\n"]}
+{"version":3,"file":"use-parent-window.js","sourceRoot":"","sources":["../../src/hooks/use-parent-window.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,mBAAmB,GAA+B,aAAa,CAAoB,IAAI,CAAC,CAAC;AAE/F;;GAEG;AACH,MAAM,eAAe,GAAG,GAAsB,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type Context, createContext, use } from \"react\";\n\nconst ParentWindowContext: Context<Gtk.Window | null> = createContext<Gtk.Window | null>(null);\n\n/**\n * Returns the `Gtk.Window` provided by the nearest window ancestor, or `null` when there is none.\n */\nconst useParentWindow = (): Gtk.Window | null => use(ParentWindowContext);\n\nexport { ParentWindowContext, useParentWindow };\n"]}

package/dist/hooks/use-property.d.ts

@@ -1,7 +1,7 @@
 import type * as GObject from "@gtkx/gi/gobject";
-import type { ObjectProp } from "../utils/object-prop.js";
-type PropertiesOf<T extends GObject.Object> = NonNullable<T["__properties__"]>;
-export type PropertyNameOf<T extends GObject.Object> = keyof PropertiesOf<T> & keyof T & string;
+import type { RefProp } from "../utils/ref-prop.js";
+type Properties<T extends GObject.Object> = NonNullable<T["__properties__"]>;
+type PropertyName<T extends GObject.Object> = keyof Properties<T> & keyof T;
 /**
  * Subscribes to a GObject property and returns its current value, re-rendering when the property changes.
  *
@@ -9,6 +9,6 @@ export type PropertyNameOf<T extends GObject.Object> = keyof PropertiesOf<T> & k
  * @param propertyName The camelCase name of a readable property on the object.
  * @returns The current property value, or `undefined` when the object is not resolved.
  */
-export declare function useProperty<T extends GObject.Object, K extends PropertyNameOf<T>>(object: ObjectProp<T>, propertyName: K): T[K] | undefined;
-export {};
+declare function useProperty<T extends GObject.Object, P extends PropertyName<T>>(object: RefProp<T>, propertyName: P & string): T[P] | undefined;
+export { useProperty, type PropertyName };
 //# sourceMappingURL=use-property.d.ts.map

package/dist/hooks/use-property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-property.d.ts","sourceRoot":"","sources":["../../src/hooks/use-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,KAAK,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,IAAI,MAAM,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAC7E,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,YAAY,EAAE,CAAC,GAChB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAElB"}
+{"version":3,"file":"use-property.d.ts","sourceRoot":"","sources":["../../src/hooks/use-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,KAAK,UAAU,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC7E,KAAK,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACpE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,YAAY,EAAE,CAAC,GAAG,MAAM,GACzB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAElB;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/hooks/use-property.js

@@ -1,4 +1,4 @@
-import { propToNotifySignal } from "../utils/notify-name.js";
+import { kebabCase } from "@gtkx/utils";
 import { useObjectValue } from "./use-object-value.js";
 /**
  * Subscribes to a GObject property and returns its current value, re-rendering when the property changes.
@@ -7,7 +7,8 @@ import { useObjectValue } from "./use-object-value.js";
  * @param propertyName The camelCase name of a readable property on the object.
  * @returns The current property value, or `undefined` when the object is not resolved.
  */
-export function useProperty(object, propertyName) {
-    return useObjectValue(object, propToNotifySignal(propertyName), (obj) => (obj ? obj[propertyName] : undefined));
+function useProperty(object, propertyName) {
+    return useObjectValue(object, `notify::${kebabCase(propertyName)}`, (obj) => obj?.[propertyName]);
 }
+export { useProperty };
 //# sourceMappingURL=use-property.js.map

package/dist/hooks/use-property.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-property.js","sourceRoot":"","sources":["../../src/hooks/use-property.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACvB,MAAqB,EACrB,YAAe;IAEf,OAAO,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACpH,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport { propToNotifySignal } from \"../utils/notify-name.js\";\nimport type { ObjectProp } from \"../utils/object-prop.js\";\nimport { useObjectValue } from \"./use-object-value.js\";\n\ntype PropertiesOf<T extends GObject.Object> = NonNullable<T[\"__properties__\"]>;\n\nexport type PropertyNameOf<T extends GObject.Object> = keyof PropertiesOf<T> & keyof T & string;\n\n/**\n * Subscribes to a GObject property and returns its current value, re-rendering when the property changes.\n *\n * @param object The GObject (or ref to one) whose property to observe.\n * @param propertyName The camelCase name of a readable property on the object.\n * @returns The current property value, or `undefined` when the object is not resolved.\n */\nexport function useProperty<T extends GObject.Object, K extends PropertyNameOf<T>>(\n    object: ObjectProp<T>,\n    propertyName: K,\n): T[K] | undefined {\n    return useObjectValue(object, propToNotifySignal(propertyName), (obj) => (obj ? obj[propertyName] : undefined));\n}\n"]}
+{"version":3,"file":"use-property.js","sourceRoot":"","sources":["../../src/hooks/use-property.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKvD;;;;;;GAMG;AACH,SAAS,WAAW,CAChB,MAAkB,EAClB,YAAwB;IAExB,OAAO,cAAc,CAAC,MAAM,EAAE,WAAW,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,OAAO,EAAE,WAAW,EAAqB,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport { kebabCase } from \"@gtkx/utils\";\nimport type { RefProp } from \"../utils/ref-prop.js\";\nimport { useObjectValue } from \"./use-object-value.js\";\n\ntype Properties<T extends GObject.Object> = NonNullable<T[\"__properties__\"]>;\ntype PropertyName<T extends GObject.Object> = keyof Properties<T> & keyof T;\n\n/**\n * Subscribes to a GObject property and returns its current value, re-rendering when the property changes.\n *\n * @param object The GObject (or ref to one) whose property to observe.\n * @param propertyName The camelCase name of a readable property on the object.\n * @returns The current property value, or `undefined` when the object is not resolved.\n */\nfunction useProperty<T extends GObject.Object, P extends PropertyName<T>>(\n    object: RefProp<T>,\n    propertyName: P & string,\n): T[P] | undefined {\n    return useObjectValue(object, `notify::${kebabCase(propertyName)}`, (obj) => obj?.[propertyName]);\n}\n\nexport { useProperty, type PropertyName };\n"]}