@gtkx/runtime 0.0.1 → 1.0.0-rc.1

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACH,SAAS,EACT,aAAa,EACb,YAAY,EACZ,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,OAAO,GACV,MAAM,YAAY,CAAC"}

package/dist/internal.js

@@ -0,0 +1,5 @@
+export { checkError, createErrorDomain } from "./error.js";
+export { registerClassType, resolveWrapperClass, wrapHandle } from "./registry.js";
+export { resolveType } from "./type.js";
+export { fromValue, getBoxedValue, getValueType, inoutValueForBoxedDescriptor, newValueForDescriptor, outValueForBoxedDescriptor, toValue, } from "./value.js";
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACH,SAAS,EACT,aAAa,EACb,YAAY,EACZ,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,OAAO,GACV,MAAM,YAAY,CAAC","sourcesContent":["export { checkError, createErrorDomain } from \"./error.js\";\nexport { registerClassType, resolveWrapperClass, wrapHandle } from \"./registry.js\";\nexport { resolveType } from \"./type.js\";\nexport {\n    fromValue,\n    getBoxedValue,\n    getValueType,\n    inoutValueForBoxedDescriptor,\n    newValueForDescriptor,\n    outValueForBoxedDescriptor,\n    toValue,\n} from \"./value.js\";\n"]}

package/dist/library.d.ts

@@ -0,0 +1,7 @@
+import { type BoxedDescriptor, type FundamentalDescriptor } from "./descriptors.js";
+export declare const LIB = "libgobject-2.0.so.0,libglib-2.0.so.0";
+export declare const VALUE_SIZE = 24;
+export declare const VALUE_T: BoxedDescriptor;
+export declare const PARAM_T: FundamentalDescriptor;
+export declare const VARIANT_T: FundamentalDescriptor;
+//# sourceMappingURL=library.d.ts.map

package/dist/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAU,KAAK,qBAAqB,EAAgB,MAAM,kBAAkB,CAAC;AAE1G,eAAO,MAAM,GAAG,yCAAyC,CAAC;AAC1D,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,OAAO,EAAE,eAA6F,CAAC;AAEpH,eAAO,MAAM,OAAO,EAAE,qBAGpB,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,qBAGtB,CAAC"}

package/dist/library.js

@@ -0,0 +1,13 @@
+import { boxedT, fundamentalT } from "./descriptors.js";
+export const LIB = "libgobject-2.0.so.0,libglib-2.0.so.0";
+export const VALUE_SIZE = 24;
+export const VALUE_T = boxedT("GValue", { sharedLibrary: LIB, getTypeFnName: "g_value_get_type" });
+export const PARAM_T = fundamentalT(LIB, "g_param_spec_ref", "g_param_spec_unref", {
+    ownership: "borrowed",
+    typeName: "GParam",
+});
+export const VARIANT_T = fundamentalT(LIB, "g_variant_ref", "g_variant_unref", {
+    ownership: "borrowed",
+    typeName: "GVariant",
+});
+//# sourceMappingURL=library.js.map

package/dist/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAA8B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1G,MAAM,CAAC,MAAM,GAAG,GAAG,sCAAsC,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAEpH,MAAM,CAAC,MAAM,OAAO,GAA0B,YAAY,CAAC,GAAG,EAAE,kBAAkB,EAAE,oBAAoB,EAAE;IACtG,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,QAAQ;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAA0B,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,iBAAiB,EAAE;IAClG,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,UAAU;CACvB,CAAC,CAAC","sourcesContent":["import { type BoxedDescriptor, boxedT, type FundamentalDescriptor, fundamentalT } from \"./descriptors.js\";\n\nexport const LIB = \"libgobject-2.0.so.0,libglib-2.0.so.0\";\nexport const VALUE_SIZE = 24;\nexport const VALUE_T: BoxedDescriptor = boxedT(\"GValue\", { sharedLibrary: LIB, getTypeFnName: \"g_value_get_type\" });\n\nexport const PARAM_T: FundamentalDescriptor = fundamentalT(LIB, \"g_param_spec_ref\", \"g_param_spec_unref\", {\n    ownership: \"borrowed\",\n    typeName: \"GParam\",\n});\n\nexport const VARIANT_T: FundamentalDescriptor = fundamentalT(LIB, \"g_variant_ref\", \"g_variant_unref\", {\n    ownership: \"borrowed\",\n    typeName: \"GVariant\",\n});\n"]}

package/dist/lifecycle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Minimal structural interface of a GTK4/GIO application needed to register, run,
+ * and shut it down, plus the signals its lifecycle helpers connect to.
+ */
+export type ApplicationLike = {
+    getIsRegistered(): boolean;
+    register(cancellable: null): boolean;
+    activate(): void;
+    quit(): void;
+    run(argv: string[]): number;
+    getWindows?(): object[];
+    removeWindow?(window: object): void;
+    on(signal: "activate" | "shutdown", handler: () => void): unknown;
+};
+/**
+ * Registers a callback to run once when the process quits, before the native
+ * runtime is torn down.
+ *
+ * @param callback Invoked during shutdown.
+ */
+export declare const onExit: (callback: () => void) => void;
+/**
+ * Runs every registered exit callback and shuts down the native runtime. Safe to
+ * call more than once; only the first call takes effect.
+ */
+export declare const quit: () => void;
+/**
+ * Registers the application if needed and activates it, keeping the runtime alive
+ * while it is active and releasing it on shutdown.
+ *
+ * @param application The application to register and activate.
+ */
+export declare const runApplication: (application: ApplicationLike) => void;
+/**
+ * Closes all of the application's windows and drives its main loop until it quits,
+ * so pending shutdown work can complete before the process exits.
+ *
+ * @param application The application to shut down.
+ */
+export declare const quitApplication: (application: ApplicationLike) => void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,eAAe,IAAI,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC;IACrC,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,IAAI,IAAI,CAAC;IACb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC5B,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACrE,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,aAAc,MAAM,IAAI,KAAG,IAE7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,IAAI,QAAO,IAOvB,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gBAAiB,eAAe,KAAG,IAM7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAiB,eAAe,KAAG,IAM9D,CAAC"}

package/dist/lifecycle.js

@@ -0,0 +1,55 @@
+import { keepAlive, quit as nativeQuit } from "@gtkx/native";
+import { blockMatchedSignalHandlers } from "./signal.js";
+const shutdownCallbacks = [];
+let hasQuit = false;
+/**
+ * Registers a callback to run once when the process quits, before the native
+ * runtime is torn down.
+ *
+ * @param callback Invoked during shutdown.
+ */
+export const onExit = (callback) => {
+    shutdownCallbacks.push(callback);
+};
+/**
+ * Runs every registered exit callback and shuts down the native runtime. Safe to
+ * call more than once; only the first call takes effect.
+ */
+export const quit = () => {
+    if (hasQuit)
+        return;
+    hasQuit = true;
+    for (const callback of shutdownCallbacks)
+        callback();
+    nativeQuit();
+};
+process.on("exit", quit);
+/**
+ * Registers the application if needed and activates it, keeping the runtime alive
+ * while it is active and releasing it on shutdown.
+ *
+ * @param application The application to register and activate.
+ */
+export const runApplication = (application) => {
+    application.on("activate", () => keepAlive(true));
+    application.on("shutdown", () => keepAlive(false));
+    if (!application.getIsRegistered())
+        application.register(null);
+    application.activate();
+};
+/**
+ * Closes all of the application's windows and drives its main loop until it quits,
+ * so pending shutdown work can complete before the process exits.
+ *
+ * @param application The application to shut down.
+ */
+export const quitApplication = (application) => {
+    if (!application.getIsRegistered())
+        return;
+    for (const window of application.getWindows?.() ?? [])
+        application.removeWindow?.(window);
+    application.on("shutdown", () => application.quit());
+    blockMatchedSignalHandlers(application, "activate");
+    application.run([]);
+};
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAiBzD,MAAM,iBAAiB,GAAmB,EAAE,CAAC;AAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAoB,EAAQ,EAAE;IACjD,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAS,EAAE;IAC3B,IAAI,OAAO;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IAEf,KAAK,MAAM,QAAQ,IAAI,iBAAiB;QAAE,QAAQ,EAAE,CAAC;IAErD,UAAU,EAAE,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAA4B,EAAQ,EAAE;IACjE,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE;QAAE,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/D,WAAW,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAA4B,EAAQ,EAAE;IAClE,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE;QAAE,OAAO;IAC3C,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE;QAAE,WAAW,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1F,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,0BAA0B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC,CAAC","sourcesContent":["import { keepAlive, quit as nativeQuit } from \"@gtkx/native\";\nimport { blockMatchedSignalHandlers } from \"./signal.js\";\n\n/**\n * Minimal structural interface of a GTK4/GIO application needed to register, run,\n * and shut it down, plus the signals its lifecycle helpers connect to.\n */\nexport type ApplicationLike = {\n    getIsRegistered(): boolean;\n    register(cancellable: null): boolean;\n    activate(): void;\n    quit(): void;\n    run(argv: string[]): number;\n    getWindows?(): object[];\n    removeWindow?(window: object): void;\n    on(signal: \"activate\" | \"shutdown\", handler: () => void): unknown;\n};\n\nconst shutdownCallbacks: (() => void)[] = [];\nlet hasQuit = false;\n\n/**\n * Registers a callback to run once when the process quits, before the native\n * runtime is torn down.\n *\n * @param callback Invoked during shutdown.\n */\nexport const onExit = (callback: () => void): void => {\n    shutdownCallbacks.push(callback);\n};\n\n/**\n * Runs every registered exit callback and shuts down the native runtime. Safe to\n * call more than once; only the first call takes effect.\n */\nexport const quit = (): void => {\n    if (hasQuit) return;\n    hasQuit = true;\n\n    for (const callback of shutdownCallbacks) callback();\n\n    nativeQuit();\n};\n\nprocess.on(\"exit\", quit);\n\n/**\n * Registers the application if needed and activates it, keeping the runtime alive\n * while it is active and releasing it on shutdown.\n *\n * @param application The application to register and activate.\n */\nexport const runApplication = (application: ApplicationLike): void => {\n    application.on(\"activate\", () => keepAlive(true));\n    application.on(\"shutdown\", () => keepAlive(false));\n\n    if (!application.getIsRegistered()) application.register(null);\n    application.activate();\n};\n\n/**\n * Closes all of the application's windows and drives its main loop until it quits,\n * so pending shutdown work can complete before the process exits.\n *\n * @param application The application to shut down.\n */\nexport const quitApplication = (application: ApplicationLike): void => {\n    if (!application.getIsRegistered()) return;\n    for (const window of application.getWindows?.() ?? []) application.removeWindow?.(window);\n    application.on(\"shutdown\", () => application.quit());\n    blockMatchedSignalHandlers(application, \"activate\");\n    application.run([]);\n};\n"]}

package/dist/listeners.d.ts

@@ -0,0 +1,36 @@
+import type { SignalHandler } from "./signal.js";
+type SignalConnectable = {
+    connect(signal: string, handler: SignalHandler, after?: boolean): number;
+    disconnect(handlerId: number): void;
+};
+/**
+ * Connects a handler to a signal and tracks it so it can later be removed with
+ * {@link offSignal}.
+ *
+ * @param instance The object emitting the signal.
+ * @param signal The signal name to connect to.
+ * @param handler The callback invoked on each emission.
+ * @param after When true, run the handler after the default handler.
+ */
+export declare function onSignal(instance: SignalConnectable, signal: string, handler: SignalHandler, after?: boolean): void;
+/**
+ * Connects a handler that runs at most once, disconnecting itself after the first
+ * emission.
+ *
+ * @param instance The object emitting the signal.
+ * @param signal The signal name to connect to.
+ * @param handler The callback invoked on the first emission.
+ * @param after When true, run the handler after the default handler.
+ */
+export declare function onceSignal(instance: SignalConnectable, signal: string, handler: SignalHandler, after?: boolean): void;
+/**
+ * Disconnects a handler previously connected with {@link onSignal} or
+ * {@link onceSignal}. Does nothing if the handler is not currently connected.
+ *
+ * @param instance The object the handler was connected to.
+ * @param signal The signal name the handler was connected to.
+ * @param handler The handler to disconnect.
+ */
+export declare function offSignal(instance: SignalConnectable, signal: string, handler: SignalHandler): void;
+export {};
+//# sourceMappingURL=listeners.d.ts.map

package/dist/listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../src/listeners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,iBAAiB,GAAG;IACrB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AA4BF;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAGnH;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAWrH;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAMnG"}

package/dist/listeners.js

@@ -0,0 +1,72 @@
+const listenerTable = new WeakMap();
+const findListenerHandlerId = (instance, signal, handler) => listenerTable.get(instance)?.get(signal)?.get(handler);
+const trackListener = (instance, signal, handler, handlerId) => {
+    let bySignal = listenerTable.get(instance);
+    if (!bySignal) {
+        bySignal = new Map();
+        listenerTable.set(instance, bySignal);
+    }
+    let byHandler = bySignal.get(signal);
+    if (!byHandler) {
+        byHandler = new Map();
+        bySignal.set(signal, byHandler);
+    }
+    byHandler.set(handler, handlerId);
+};
+const untrackListener = (instance, signal, handler) => {
+    const bySignal = listenerTable.get(instance);
+    const byHandler = bySignal?.get(signal);
+    byHandler?.delete(handler);
+    if (byHandler?.size === 0)
+        bySignal?.delete(signal);
+};
+/**
+ * Connects a handler to a signal and tracks it so it can later be removed with
+ * {@link offSignal}.
+ *
+ * @param instance The object emitting the signal.
+ * @param signal The signal name to connect to.
+ * @param handler The callback invoked on each emission.
+ * @param after When true, run the handler after the default handler.
+ */
+export function onSignal(instance, signal, handler, after) {
+    const handlerId = instance.connect(signal, handler, after);
+    trackListener(instance, signal, handler, handlerId);
+}
+/**
+ * Connects a handler that runs at most once, disconnecting itself after the first
+ * emission.
+ *
+ * @param instance The object emitting the signal.
+ * @param signal The signal name to connect to.
+ * @param handler The callback invoked on the first emission.
+ * @param after When true, run the handler after the default handler.
+ */
+export function onceSignal(instance, signal, handler, after) {
+    let handlerId = 0;
+    const wrapped = (...args) => {
+        untrackListener(instance, signal, wrapped);
+        untrackListener(instance, signal, handler);
+        instance.disconnect(handlerId);
+        return handler(...args);
+    };
+    handlerId = instance.connect(signal, wrapped, after);
+    trackListener(instance, signal, wrapped, handlerId);
+    trackListener(instance, signal, handler, handlerId);
+}
+/**
+ * Disconnects a handler previously connected with {@link onSignal} or
+ * {@link onceSignal}. Does nothing if the handler is not currently connected.
+ *
+ * @param instance The object the handler was connected to.
+ * @param signal The signal name the handler was connected to.
+ * @param handler The handler to disconnect.
+ */
+export function offSignal(instance, signal, handler) {
+    const handlerId = findListenerHandlerId(instance, signal, handler);
+    if (handlerId !== undefined) {
+        instance.disconnect(handlerId);
+        untrackListener(instance, signal, handler);
+    }
+}
+//# sourceMappingURL=listeners.js.map

package/dist/listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.js","sourceRoot":"","sources":["../src/listeners.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SignalHandler } from \"./signal.js\";\n\ntype SignalConnectable = {\n    connect(signal: string, handler: SignalHandler, after?: boolean): number;\n    disconnect(handlerId: number): void;\n};\n\nconst listenerTable = new WeakMap<object, Map<string, Map<SignalHandler, number>>>();\n\nconst findListenerHandlerId = (instance: object, signal: string, handler: SignalHandler): number | undefined =>\n    listenerTable.get(instance)?.get(signal)?.get(handler);\n\nconst trackListener = (instance: object, signal: string, handler: SignalHandler, handlerId: number): void => {\n    let bySignal = listenerTable.get(instance);\n    if (!bySignal) {\n        bySignal = new Map();\n        listenerTable.set(instance, bySignal);\n    }\n    let byHandler = bySignal.get(signal);\n    if (!byHandler) {\n        byHandler = new Map();\n        bySignal.set(signal, byHandler);\n    }\n    byHandler.set(handler, handlerId);\n};\n\nconst untrackListener = (instance: object, signal: string, handler: SignalHandler): void => {\n    const bySignal = listenerTable.get(instance);\n    const byHandler = bySignal?.get(signal);\n    byHandler?.delete(handler);\n    if (byHandler?.size === 0) bySignal?.delete(signal);\n};\n\n/**\n * Connects a handler to a signal and tracks it so it can later be removed with\n * {@link offSignal}.\n *\n * @param instance The object emitting the signal.\n * @param signal The signal name to connect to.\n * @param handler The callback invoked on each emission.\n * @param after When true, run the handler after the default handler.\n */\nexport function onSignal(instance: SignalConnectable, signal: string, handler: SignalHandler, after?: boolean): void {\n    const handlerId = instance.connect(signal, handler, after);\n    trackListener(instance, signal, handler, handlerId);\n}\n\n/**\n * Connects a handler that runs at most once, disconnecting itself after the first\n * emission.\n *\n * @param instance The object emitting the signal.\n * @param signal The signal name to connect to.\n * @param handler The callback invoked on the first emission.\n * @param after When true, run the handler after the default handler.\n */\nexport function onceSignal(instance: SignalConnectable, signal: string, handler: SignalHandler, after?: boolean): void {\n    let handlerId = 0;\n    const wrapped: SignalHandler = (...args) => {\n        untrackListener(instance, signal, wrapped);\n        untrackListener(instance, signal, handler);\n        instance.disconnect(handlerId);\n        return handler(...args);\n    };\n    handlerId = instance.connect(signal, wrapped, after);\n    trackListener(instance, signal, wrapped, handlerId);\n    trackListener(instance, signal, handler, handlerId);\n}\n\n/**\n * Disconnects a handler previously connected with {@link onSignal} or\n * {@link onceSignal}. Does nothing if the handler is not currently connected.\n *\n * @param instance The object the handler was connected to.\n * @param signal The signal name the handler was connected to.\n * @param handler The handler to disconnect.\n */\nexport function offSignal(instance: SignalConnectable, signal: string, handler: SignalHandler): void {\n    const handlerId = findListenerHandlerId(instance, signal, handler);\n    if (handlerId !== undefined) {\n        instance.disconnect(handlerId);\n        untrackListener(instance, signal, handler);\n    }\n}\n"]}

package/dist/mixin.d.ts

@@ -0,0 +1,19 @@
+import type { AnyClass } from "@gtkx/utils";
+export type MixinReceiver = {
+    connect(signal: string, handler: (...args: unknown[]) => unknown, after?: boolean): number;
+    emit(signal: string, ...args: unknown[]): unknown;
+};
+/**
+ * A factory that, given a base class, returns a subclass adding extra members to
+ * be merged onto a target prototype.
+ */
+export type Mixin = (base: AnyClass<MixinReceiver>) => AnyClass;
+/**
+ * Copies each mixin's prototype members onto the target class prototype, skipping
+ * any member already defined anywhere in the target's class chain.
+ *
+ * @param target The class whose prototype receives the mixin members.
+ * @param mixins The mixins to apply, in order.
+ */
+export declare function installMixins(target: AnyClass, mixins: Mixin[]): void;
+//# sourceMappingURL=mixin.d.ts.map

package/dist/mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3F,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CACrD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC;AAWhE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAkBrE"}

package/dist/mixin.js

@@ -0,0 +1,39 @@
+function definedInClassChain(prototype, key) {
+    let current = prototype;
+    while (current !== null && current !== Object.prototype) {
+        if (Object.hasOwn(current, key))
+            return true;
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+/**
+ * Copies each mixin's prototype members onto the target class prototype, skipping
+ * any member already defined anywhere in the target's class chain.
+ *
+ * @param target The class whose prototype receives the mixin members.
+ * @param mixins The mixins to apply, in order.
+ */
+export function installMixins(target, mixins) {
+    const empty = class {
+        connect() {
+            return 0;
+        }
+        emit() {
+            return undefined;
+        }
+    };
+    for (const mixin of mixins) {
+        const layer = mixin(empty).prototype;
+        for (const key of Object.getOwnPropertyNames(layer)) {
+            if (key === "constructor")
+                continue;
+            if (definedInClassChain(target.prototype, key))
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(layer, key);
+            if (descriptor !== undefined)
+                Object.defineProperty(target.prototype, key, descriptor);
+        }
+    }
+}
+//# sourceMappingURL=mixin.js.map

package/dist/mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin.js","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAaA,SAAS,mBAAmB,CAAC,SAAiB,EAAE,GAAW;IACvD,IAAI,OAAO,GAAkB,SAAS,CAAC;IACvC,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACtD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAgB,EAAE,MAAe;IAC3D,MAAM,KAAK,GAA4B;QACnC,OAAO;YACH,OAAO,CAAC,CAAC;QACb,CAAC;QACD,IAAI;YACA,OAAO,SAAS,CAAC;QACrB,CAAC;KACJ,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAW,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,KAAK,aAAa;gBAAE,SAAS;YACpC,IAAI,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC;gBAAE,SAAS;YACzD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/D,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;AACL,CAAC","sourcesContent":["import type { AnyClass } from \"@gtkx/utils\";\n\nexport type MixinReceiver = {\n    connect(signal: string, handler: (...args: unknown[]) => unknown, after?: boolean): number;\n    emit(signal: string, ...args: unknown[]): unknown;\n};\n\n/**\n * A factory that, given a base class, returns a subclass adding extra members to\n * be merged onto a target prototype.\n */\nexport type Mixin = (base: AnyClass<MixinReceiver>) => AnyClass;\n\nfunction definedInClassChain(prototype: object, key: string): boolean {\n    let current: object | null = prototype;\n    while (current !== null && current !== Object.prototype) {\n        if (Object.hasOwn(current, key)) return true;\n        current = Object.getPrototypeOf(current);\n    }\n    return false;\n}\n\n/**\n * Copies each mixin's prototype members onto the target class prototype, skipping\n * any member already defined anywhere in the target's class chain.\n *\n * @param target The class whose prototype receives the mixin members.\n * @param mixins The mixins to apply, in order.\n */\nexport function installMixins(target: AnyClass, mixins: Mixin[]): void {\n    const empty: AnyClass<MixinReceiver> = class {\n        connect(): number {\n            return 0;\n        }\n        emit(): unknown {\n            return undefined;\n        }\n    };\n    for (const mixin of mixins) {\n        const layer: object = mixin(empty).prototype;\n        for (const key of Object.getOwnPropertyNames(layer)) {\n            if (key === \"constructor\") continue;\n            if (definedInClassChain(target.prototype, key)) continue;\n            const descriptor = Object.getOwnPropertyDescriptor(layer, key);\n            if (descriptor !== undefined) Object.defineProperty(target.prototype, key, descriptor);\n        }\n    }\n}\n"]}

package/dist/native-value.d.ts

@@ -0,0 +1,12 @@
+import type { Descriptor } from "@gtkx/native";
+/**
+ * Converts a raw value returned from native code into its JavaScript form,
+ * wrapping object, struct, boxed, and fundamental handles and recursively
+ * converting arrays and hash tables according to the descriptor.
+ *
+ * @param descriptor Describes the native type of the value.
+ * @param value The raw native value to convert.
+ */
+export declare function fromNative(descriptor: Descriptor, value: unknown): unknown;
+export declare function toNative(descriptor: Descriptor, value: unknown): unknown;
+//# sourceMappingURL=native-value.d.ts.map

package/dist/native-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-value.d.ts","sourceRoot":"","sources":["../src/native-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAUvE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAiC1E;AAOD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBxE"}

package/dist/native-value.js

@@ -0,0 +1,72 @@
+import { getWrapperClass, tryGetHandle, wrapHandle } from "./registry.js";
+import { resolveDescriptorType } from "./type.js";
+const collectionFromNative = (descriptor, value) => {
+    if (value === null)
+        return null;
+    return value.map((item) => fromNative(descriptor.itemDescriptor, item));
+};
+/**
+ * Converts a raw value returned from native code into its JavaScript form,
+ * wrapping object, struct, boxed, and fundamental handles and recursively
+ * converting arrays and hash tables according to the descriptor.
+ *
+ * @param descriptor Describes the native type of the value.
+ * @param value The raw native value to convert.
+ */
+export function fromNative(descriptor, value) {
+    switch (descriptor.kind) {
+        case "object":
+            return wrapHandle(value, undefined);
+        case "struct":
+            return wrapHandle(value, descriptor.wrapperClass);
+        case "boxed":
+            return value == null
+                ? null
+                : wrapHandle(value, getWrapperClass(resolveDescriptorType(descriptor)));
+        case "fundamental":
+            return value == null
+                ? null
+                : wrapHandle(value, descriptor.wrapperClass ??
+                    getWrapperClass(resolveDescriptorType(descriptor)));
+        case "array":
+            return collectionFromNative(descriptor, value);
+        case "hashtable": {
+            if (value === null)
+                return null;
+            const entries = value;
+            return new Map(entries.map(([key, val]) => [
+                fromNative(descriptor.keyDescriptor, key),
+                fromNative(descriptor.valueDescriptor, val),
+            ]));
+        }
+        default:
+            return value;
+    }
+}
+const collectionToNative = (descriptor, value) => {
+    if (value == null)
+        return null;
+    return value.map((item) => toNative(descriptor.itemDescriptor, item));
+};
+export function toNative(descriptor, value) {
+    switch (descriptor.kind) {
+        case "object":
+        case "struct":
+        case "boxed":
+        case "fundamental":
+            return tryGetHandle(value) ?? null;
+        case "array":
+            return collectionToNative(descriptor, value);
+        case "hashtable": {
+            if (value == null)
+                return null;
+            return [...value].map(([key, val]) => [
+                toNative(descriptor.keyDescriptor, key),
+                toNative(descriptor.valueDescriptor, val),
+            ]);
+        }
+        default:
+            return value;
+    }
+}
+//# sourceMappingURL=native-value.js.map

package/dist/native-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-value.js","sourceRoot":"","sources":["../src/native-value.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Descriptor, ExternalObject, Handle } from \"@gtkx/native\";\nimport type { ArrayDescriptor, FundamentalDescriptor, StructDescriptor } from \"./descriptors.js\";\nimport { getWrapperClass, tryGetHandle, wrapHandle } from \"./registry.js\";\nimport { resolveDescriptorType } from \"./type.js\";\n\nconst collectionFromNative = (descriptor: ArrayDescriptor, value: unknown): unknown => {\n    if (value === null) return null;\n    return (value as unknown[]).map((item) => fromNative(descriptor.itemDescriptor, item));\n};\n\n/**\n * Converts a raw value returned from native code into its JavaScript form,\n * wrapping object, struct, boxed, and fundamental handles and recursively\n * converting arrays and hash tables according to the descriptor.\n *\n * @param descriptor Describes the native type of the value.\n * @param value The raw native value to convert.\n */\nexport function fromNative(descriptor: Descriptor, value: unknown): unknown {\n    switch (descriptor.kind) {\n        case \"object\":\n            return wrapHandle(value as ExternalObject<Handle> | null, undefined);\n        case \"struct\":\n            return wrapHandle(value as ExternalObject<Handle> | null, (descriptor as StructDescriptor).wrapperClass);\n        case \"boxed\":\n            return value == null\n                ? null\n                : wrapHandle(value as ExternalObject<Handle>, getWrapperClass(resolveDescriptorType(descriptor)));\n        case \"fundamental\":\n            return value == null\n                ? null\n                : wrapHandle(\n                      value as ExternalObject<Handle>,\n                      (descriptor as FundamentalDescriptor).wrapperClass ??\n                          getWrapperClass(resolveDescriptorType(descriptor)),\n                  );\n        case \"array\":\n            return collectionFromNative(descriptor, value);\n        case \"hashtable\": {\n            if (value === null) return null;\n            const entries = value as [unknown, unknown][];\n            return new Map(\n                entries.map(([key, val]): [unknown, unknown] => [\n                    fromNative(descriptor.keyDescriptor, key),\n                    fromNative(descriptor.valueDescriptor, val),\n                ]),\n            );\n        }\n        default:\n            return value;\n    }\n}\n\nconst collectionToNative = (descriptor: ArrayDescriptor, value: unknown): unknown => {\n    if (value == null) return null;\n    return (value as unknown[]).map((item) => toNative(descriptor.itemDescriptor, item));\n};\n\nexport function toNative(descriptor: Descriptor, value: unknown): unknown {\n    switch (descriptor.kind) {\n        case \"object\":\n        case \"struct\":\n        case \"boxed\":\n        case \"fundamental\":\n            return tryGetHandle(value as object | null | undefined) ?? null;\n        case \"array\":\n            return collectionToNative(descriptor, value);\n        case \"hashtable\": {\n            if (value == null) return null;\n            return [...(value as Map<unknown, unknown>)].map(([key, val]): [unknown, unknown] => [\n                toNative(descriptor.keyDescriptor, key),\n                toNative(descriptor.valueDescriptor, val),\n            ]);\n        }\n        default:\n            return value;\n    }\n}\n"]}

package/dist/object.d.ts

@@ -0,0 +1,31 @@
+import type { Descriptor, ExternalObject, Handle } from "@gtkx/native";
+/**
+ * Constructs a new GObject of the given type, setting the supplied construct
+ * properties. Entries whose value is `undefined` or not a `[descriptor, value]`
+ * pair are skipped.
+ *
+ * @param gtype The GType of the object to construct.
+ * @param props Property names mapped to `[descriptor, value]` pairs.
+ * @returns The handle of the newly created object.
+ */
+export declare function newObjectWithProperties(gtype: bigint, props: Record<string, unknown>): ExternalObject<Handle>;
+/**
+ * Reads a GObject property and converts it to its JavaScript value using the
+ * descriptor.
+ *
+ * @param obj The object to read from.
+ * @param propertyName The property name.
+ * @param descriptor Describes the property's type.
+ */
+export declare function getObjectProperty(obj: object, propertyName: string, descriptor: Descriptor): unknown;
+/**
+ * Writes a JavaScript value to a GObject property, converting it to native form
+ * using the descriptor.
+ *
+ * @param obj The object to write to.
+ * @param propertyName The property name.
+ * @param descriptor Describes the property's type.
+ * @param jsValue The value to set.
+ */
+export declare function setObjectProperty(obj: object, propertyName: string, descriptor: Descriptor, jsValue: unknown): void;
+//# sourceMappingURL=object.d.ts.map

package/dist/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgCvE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAc7G;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAIpG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnH"}

package/dist/object.js

@@ -0,0 +1,63 @@
+import { bind } from "./bind.js";
+import { biguint64T, objectT, sizedArrayT, stringT, uint32T, voidT } from "./descriptors.js";
+import { LIB, VALUE_SIZE, VALUE_T } from "./library.js";
+import { getHandle } from "./registry.js";
+import { fromValue, newValueForDescriptor, toValue } from "./value.js";
+const gObjectNewWithProperties = bind(LIB, "g_object_new_with_properties", [
+    biguint64T,
+    uint32T,
+    sizedArrayT(stringT("borrowed"), 1, "borrowed"),
+    sizedArrayT(VALUE_T, 1, "borrowed", VALUE_SIZE),
+], objectT("full"));
+const gObjectGetProperty = bind(LIB, "g_object_get_property", [objectT("borrowed"), stringT("borrowed"), VALUE_T], voidT);
+const gObjectSetProperty = bind(LIB, "g_object_set_property", [objectT("borrowed"), stringT("borrowed"), VALUE_T], voidT);
+/**
+ * Constructs a new GObject of the given type, setting the supplied construct
+ * properties. Entries whose value is `undefined` or not a `[descriptor, value]`
+ * pair are skipped.
+ *
+ * @param gtype The GType of the object to construct.
+ * @param props Property names mapped to `[descriptor, value]` pairs.
+ * @returns The handle of the newly created object.
+ */
+export function newObjectWithProperties(gtype, props) {
+    const names = [];
+    const values = [];
+    for (const name in props) {
+        const entry = props[name];
+        if (!Array.isArray(entry))
+            continue;
+        const [descriptor, value] = entry;
+        if (value === undefined)
+            continue;
+        names.push(name);
+        values.push(toValue(descriptor, value));
+    }
+    return gObjectNewWithProperties(gtype, names.length, names, values);
+}
+/**
+ * Reads a GObject property and converts it to its JavaScript value using the
+ * descriptor.
+ *
+ * @param obj The object to read from.
+ * @param propertyName The property name.
+ * @param descriptor Describes the property's type.
+ */
+export function getObjectProperty(obj, propertyName, descriptor) {
+    const value = newValueForDescriptor(descriptor);
+    gObjectGetProperty(getHandle(obj), propertyName, value);
+    return fromValue(value);
+}
+/**
+ * Writes a JavaScript value to a GObject property, converting it to native form
+ * using the descriptor.
+ *
+ * @param obj The object to write to.
+ * @param propertyName The property name.
+ * @param descriptor Describes the property's type.
+ * @param jsValue The value to set.
+ */
+export function setObjectProperty(obj, propertyName, descriptor, jsValue) {
+    gObjectSetProperty(getHandle(obj), propertyName, toValue(descriptor, jsValue));
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,wBAAwB,GAAG,IAAI,CACjC,GAAG,EACH,8BAA8B,EAC9B;IACI,UAAU;IACV,OAAO;IACP,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC;IAC/C,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC;CAClD,EACD,OAAO,CAAC,MAAM,CAAC,CAClB,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,CAC3B,GAAG,EACH,uBAAuB,EACvB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EACnD,KAAK,CACR,CAAC;AACF,MAAM,kBAAkB,GAAG,IAAI,CAC3B,GAAG,EACH,uBAAuB,EACvB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EACnD,KAAK,CACR,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,KAA8B;IACjF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAA2B,CAAC;AAClG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,YAAoB,EAAE,UAAsB;IACvF,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAChD,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,YAAoB,EAAE,UAAsB,EAAE,OAAgB;IACzG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AACnF,CAAC","sourcesContent":["import type { Descriptor, ExternalObject, Handle } from \"@gtkx/native\";\nimport { bind } from \"./bind.js\";\nimport { biguint64T, objectT, sizedArrayT, stringT, uint32T, voidT } from \"./descriptors.js\";\nimport { LIB, VALUE_SIZE, VALUE_T } from \"./library.js\";\nimport { getHandle } from \"./registry.js\";\nimport { fromValue, newValueForDescriptor, toValue } from \"./value.js\";\n\nconst gObjectNewWithProperties = bind(\n    LIB,\n    \"g_object_new_with_properties\",\n    [\n        biguint64T,\n        uint32T,\n        sizedArrayT(stringT(\"borrowed\"), 1, \"borrowed\"),\n        sizedArrayT(VALUE_T, 1, \"borrowed\", VALUE_SIZE),\n    ],\n    objectT(\"full\"),\n);\n\nconst gObjectGetProperty = bind(\n    LIB,\n    \"g_object_get_property\",\n    [objectT(\"borrowed\"), stringT(\"borrowed\"), VALUE_T],\n    voidT,\n);\nconst gObjectSetProperty = bind(\n    LIB,\n    \"g_object_set_property\",\n    [objectT(\"borrowed\"), stringT(\"borrowed\"), VALUE_T],\n    voidT,\n);\n\n/**\n * Constructs a new GObject of the given type, setting the supplied construct\n * properties. Entries whose value is `undefined` or not a `[descriptor, value]`\n * pair are skipped.\n *\n * @param gtype The GType of the object to construct.\n * @param props Property names mapped to `[descriptor, value]` pairs.\n * @returns The handle of the newly created object.\n */\nexport function newObjectWithProperties(gtype: bigint, props: Record<string, unknown>): ExternalObject<Handle> {\n    const names: string[] = [];\n    const values: ExternalObject<Handle>[] = [];\n\n    for (const name in props) {\n        const entry = props[name];\n        if (!Array.isArray(entry)) continue;\n        const [descriptor, value] = entry;\n        if (value === undefined) continue;\n        names.push(name);\n        values.push(toValue(descriptor, value));\n    }\n\n    return gObjectNewWithProperties(gtype, names.length, names, values) as ExternalObject<Handle>;\n}\n\n/**\n * Reads a GObject property and converts it to its JavaScript value using the\n * descriptor.\n *\n * @param obj The object to read from.\n * @param propertyName The property name.\n * @param descriptor Describes the property's type.\n */\nexport function getObjectProperty(obj: object, propertyName: string, descriptor: Descriptor): unknown {\n    const value = newValueForDescriptor(descriptor);\n    gObjectGetProperty(getHandle(obj), propertyName, value);\n    return fromValue(value);\n}\n\n/**\n * Writes a JavaScript value to a GObject property, converting it to native form\n * using the descriptor.\n *\n * @param obj The object to write to.\n * @param propertyName The property name.\n * @param descriptor Describes the property's type.\n * @param jsValue The value to set.\n */\nexport function setObjectProperty(obj: object, propertyName: string, descriptor: Descriptor, jsValue: unknown): void {\n    gObjectSetProperty(getHandle(obj), propertyName, toValue(descriptor, jsValue));\n}\n"]}

package/dist/promisify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Wraps a GIO-style asynchronous function that takes a completion callback into a
+ * promise, invoking the finish function to extract the result. Outside production,
+ * the call site's stack is captured and attached as the rejection error's cause.
+ *
+ * @param asyncFn The async function, called with the leading arguments, the cancellable, and a completion callback.
+ * @param finish Extracts the result from the async result passed to the completion callback.
+ * @param cancellable A cancellable object, or null/undefined for none.
+ * @param leading Arguments passed to `asyncFn` before the cancellable and callback.
+ * @returns A promise resolving to the finished result, or rejecting if `finish` throws.
+ */
+export declare const promisify: <R extends object, T>(asyncFn: (...args: unknown[]) => void, finish: (result: R) => T, cancellable: object | null | undefined, ...leading: unknown[]) => Promise<T>;
+//# sourceMappingURL=promisify.d.ts.map

package/dist/promisify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promisify.d.ts","sourceRoot":"","sources":["../src/promisify.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,WAChC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,UAC7B,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eACX,MAAM,GAAG,IAAI,GAAG,SAAS,cAC1B,OAAO,EAAE,KACtB,OAAO,CAAC,CAAC,CAeN,CAAC"}

package/dist/promisify.js

@@ -0,0 +1,36 @@
+import { tryGetHandle } from "./registry.js";
+const attachCreationStack = (error, creationStack) => {
+    if (creationStack === undefined || !(error instanceof Error))
+        return;
+    if (error.cause !== undefined || !Object.isExtensible(error))
+        return;
+    error.cause = creationStack;
+};
+/**
+ * Wraps a GIO-style asynchronous function that takes a completion callback into a
+ * promise, invoking the finish function to extract the result. Outside production,
+ * the call site's stack is captured and attached as the rejection error's cause.
+ *
+ * @param asyncFn The async function, called with the leading arguments, the cancellable, and a completion callback.
+ * @param finish Extracts the result from the async result passed to the completion callback.
+ * @param cancellable A cancellable object, or null/undefined for none.
+ * @param leading Arguments passed to `asyncFn` before the cancellable and callback.
+ * @returns A promise resolving to the finished result, or rejecting if `finish` throws.
+ */
+export const promisify = (asyncFn, finish, cancellable, ...leading) => new Promise((resolve, reject) => {
+    let creationStack;
+    if (process.env.NODE_ENV !== "production") {
+        creationStack = new Error("gtkx async operation started here");
+        Error.captureStackTrace(creationStack, promisify);
+    }
+    asyncFn(...leading, tryGetHandle(cancellable), (_source, asyncResult) => {
+        try {
+            resolve(finish(asyncResult));
+        }
+        catch (error) {
+            attachCreationStack(error, creationStack);
+            reject(error);
+        }
+    });
+});
+//# sourceMappingURL=promisify.js.map