@peachy/hooks 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# @peachy/hooks
+
+Useful hooks for React applications.

package/dist/gobject/index.d.mts

@@ -0,0 +1,2 @@
+import { useBinding } from "./use-binding.mjs";
+export { useBinding };

package/dist/gobject/index.mjs

@@ -0,0 +1,3 @@
+import { useBinding } from "./use-binding.mjs";
+
+export { useBinding };

package/dist/gobject/use-binding.d.mts

@@ -0,0 +1,9 @@
+import { RefObject } from "react";
+import GObject from "gi://GObject?version=2.0";
+
+//#region src/gobject/use-binding.d.ts
+type NonFunctionKeys<T> = { [K in keyof T]: T[K] extends Function ? never : K extends Symbol ? never : K extends number ? never : K }[keyof T];
+declare function useBinding<T extends GObject.Object, Prop extends NonFunctionKeys<T>>(object: T | RefObject<T>, property: Prop, defaultValue?: T[Prop], converter?: undefined): T[Prop];
+declare function useBinding<T extends GObject.Object, Prop extends NonFunctionKeys<T>, Converter extends (value: T[Prop]) => any>(object: T | RefObject<T>, property: Prop, defaultValue: T[Prop] | undefined, converter: Converter): ReturnType<Converter>;
+//#endregion
+export { useBinding };

package/dist/gobject/use-binding.mjs

@@ -0,0 +1,38 @@
+import { useEffect, useState } from "react";
+
+//#region src/gobject/use-binding.ts
+function useBinding(object, _property, defaultValue, converter) {
+	const property = toKebabCase(_property);
+	const [result, setResult] = useState(() => {
+		const value = getValue(object);
+		if (!value) return defaultValue;
+		const initialResult = value[property];
+		return converter ? converter(initialResult) : initialResult;
+	});
+	useEffect(() => {
+		const value = getValue(object);
+		if (!value) {
+			console.error(`Object is null or undefined`);
+			return;
+		}
+		const id = value.connect(`notify::${property}`, () => {
+			setResult(value[property]);
+		});
+		return () => {
+			value.disconnect(id);
+		};
+	}, []);
+	return result;
+}
+function getValue(object) {
+	return isRef(object) ? object.current : object;
+}
+function isRef(object) {
+	return typeof object === "object" && object !== null && "current" in object;
+}
+function toKebabCase(str) {
+	return str.replace(/([A-Z])/g, "-$1").replace(/_/g, "-").toLowerCase();
+}
+
+//#endregion
+export { useBinding };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+import { useBinding } from "./gobject/use-binding.mjs";
+import "./gobject/index.mjs";
+export { useBinding };

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { useBinding } from "./gobject/use-binding.mjs";
+import "./gobject/index.mjs";
+
+export { useBinding };

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@peachy/hooks",
+  "version": "0.0.1",
+  "description": "",
+  "main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./*": {
+      "import": "./dist/*/index.mjs",
+      "types": "./dist/*/index.d.mts"
+    }
+  },
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "react": "^19.2.0",
+    "tsdown": "0.20.0-beta.3",
+    "typescript": "^5.9.3",
+    "@peachy/react": "0.0.1"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  },
+  "types": "./dist/index.d.mts"
+}

package/src/gobject/index.ts

@@ -0,0 +1 @@
+export * from "./use-binding";

package/src/gobject/use-binding.ts

@@ -0,0 +1,86 @@
+import GObject from "gi://GObject?version=2.0";
+import { RefObject, useEffect, useState } from "react";
+
+type NonFunctionKeys<T> = {
+  [K in keyof T]: T[K] extends Function
+    ? never
+    : K extends Symbol
+      ? never
+      : K extends number
+        ? never
+        : K;
+}[keyof T];
+
+export function useBinding<
+  T extends GObject.Object,
+  Prop extends NonFunctionKeys<T>,
+>(
+  object: T | RefObject<T>,
+  property: Prop,
+  defaultValue?: T[Prop],
+  converter?: undefined,
+): T[Prop];
+export function useBinding<
+  T extends GObject.Object,
+  Prop extends NonFunctionKeys<T>,
+  Converter extends (value: T[Prop]) => any,
+>(
+  object: T | RefObject<T>,
+  property: Prop,
+  defaultValue: T[Prop] | undefined,
+  converter: Converter,
+): ReturnType<Converter>;
+export function useBinding<
+  T extends GObject.Object,
+  Prop extends NonFunctionKeys<T>,
+  Converter extends (value: T[Prop]) => any,
+>(
+  object: T | RefObject<T>,
+  _property: Prop,
+  defaultValue?: any,
+  converter?: Converter,
+): any {
+  const property = toKebabCase(_property);
+
+  const [result, setResult] = useState(() => {
+    const value = getValue(object);
+    if (!value) return defaultValue;
+    const initialResult = value[property];
+    return converter ? converter(initialResult) : initialResult;
+  });
+
+  // run this on initial render
+  useEffect(() => {
+    const value = getValue(object);
+
+    if (!value) {
+      console.error(`Object is null or undefined`);
+      return;
+    }
+
+    const id = value.connect(`notify::${property}`, () => {
+      setResult(value[property]);
+    });
+
+    return () => {
+      value.disconnect(id);
+    };
+  }, []);
+
+  return result;
+}
+
+function getValue<T extends GObject.Object>(object: T | RefObject<T>) {
+  return isRef(object) ? object.current : object;
+}
+
+function isRef<T>(object: unknown): object is RefObject<T> {
+  return typeof object === "object" && object !== null && "current" in object;
+}
+
+function toKebabCase(str: string): string {
+  return str
+    .replace(/([A-Z])/g, "-$1")
+    .replace(/_/g, "-")
+    .toLowerCase();
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./gobject";

package/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "@peachy/react/tsconfig",
+}

package/tsdown.config.mjs

@@ -0,0 +1,10 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["./src/**/*.ts"],
+  dts: true,
+  external: [/^gi:\/\/*/],
+  outputOptions: {
+    preserveModules: true,
+  },
+});