@gtkx/runtime 0.0.1 → 1.0.0-rc.2

package/dist/native-value.js

@@ -0,0 +1,105 @@
+import { getWrapperClass, tryGetHandle, wrapHandle } from "./registry.js";
+import { resolveDescriptorType } from "./type.js";
+const MARSHALLED_KINDS = new Set([
+    "object",
+    "struct",
+    "boxed",
+    "fundamental",
+    "array",
+    "hashtable",
+]);
+function isMarshalledDescriptor(descriptor) {
+    return MARSHALLED_KINDS.has(descriptor.kind);
+}
+function mapCollection(descriptor, value, convert) {
+    return value.map((item) => convert(descriptor.itemDescriptor, item));
+}
+function collectionFromNative(descriptor, value) {
+    return value === null ? null : mapCollection(descriptor, value, fromNative);
+}
+function boxedFromNative(descriptor, value) {
+    return value == null
+        ? null
+        : wrapHandle(value, getWrapperClass(resolveDescriptorType(descriptor)));
+}
+function fundamentalFromNative(descriptor, value) {
+    return value == null
+        ? null
+        : wrapHandle(value, descriptor.wrapperClass ?? getWrapperClass(resolveDescriptorType(descriptor)));
+}
+function hashTableFromNative(descriptor, value) {
+    if (value === null) {
+        return null;
+    }
+    const entries = value;
+    return new Map(entries.map(([key, val]) => [
+        fromNative(descriptor.keyDescriptor, key),
+        fromNative(descriptor.valueDescriptor, val),
+    ]));
+}
+/**
+ * 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.
+ */
+function fromNative(descriptor, value) {
+    if (!isMarshalledDescriptor(descriptor)) {
+        return value;
+    }
+    switch (descriptor.kind) {
+        case "object": {
+            return wrapHandle(value);
+        }
+        case "struct": {
+            return wrapHandle(value, descriptor.wrapperClass);
+        }
+        case "boxed": {
+            return boxedFromNative(descriptor, value);
+        }
+        case "fundamental": {
+            return fundamentalFromNative(descriptor, value);
+        }
+        case "array": {
+            return collectionFromNative(descriptor, value);
+        }
+        case "hashtable": {
+            return hashTableFromNative(descriptor, value);
+        }
+    }
+}
+function collectionToNative(descriptor, value) {
+    return value == null ? null : mapCollection(descriptor, value, toNative);
+}
+function hashTableToNative(descriptor, value) {
+    if (value == null) {
+        return null;
+    }
+    return [...value].map(([key, val]) => [
+        toNative(descriptor.keyDescriptor, key),
+        toNative(descriptor.valueDescriptor, val),
+    ]);
+}
+function toNative(descriptor, value) {
+    if (!isMarshalledDescriptor(descriptor)) {
+        return value;
+    }
+    switch (descriptor.kind) {
+        case "object":
+        case "struct":
+        case "boxed":
+        case "fundamental": {
+            return tryGetHandle(value) ?? null;
+        }
+        case "array": {
+            return collectionToNative(descriptor, value);
+        }
+        case "hashtable": {
+            return hashTableToNative(descriptor, value);
+        }
+    }
+}
+export { fromNative, toNative };
+//# 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, HashTableDescriptor, StructDescriptor } from \"./descriptors.js\";\nimport { getWrapperClass, tryGetHandle, wrapHandle } from \"./registry.js\";\nimport { resolveDescriptorType } from \"./type.js\";\n\ntype MarshalledKind = \"object\" | \"struct\" | \"boxed\" | \"fundamental\" | \"array\" | \"hashtable\";\ntype MarshalledDescriptor = Extract<Descriptor, { kind: MarshalledKind }>;\n\nconst MARSHALLED_KINDS: Set<Descriptor[\"kind\"]> = new Set<MarshalledKind>([\n    \"object\",\n    \"struct\",\n    \"boxed\",\n    \"fundamental\",\n    \"array\",\n    \"hashtable\",\n]);\n\nfunction isMarshalledDescriptor(descriptor: Descriptor): descriptor is MarshalledDescriptor {\n    return MARSHALLED_KINDS.has(descriptor.kind);\n}\n\nfunction mapCollection(\n    descriptor: ArrayDescriptor,\n    value: unknown,\n    convert: (itemDescriptor: Descriptor, item: unknown) => unknown,\n): unknown[] {\n    return (value as unknown[]).map((item) => convert(descriptor.itemDescriptor, item));\n}\n\nfunction collectionFromNative(descriptor: ArrayDescriptor, value: unknown): unknown {\n    return value === null ? null : mapCollection(descriptor, value, fromNative);\n}\n\nfunction boxedFromNative(descriptor: Descriptor, value: unknown): unknown {\n    return value == null\n        ? null\n        : wrapHandle(value as ExternalObject<Handle>, getWrapperClass(resolveDescriptorType(descriptor)));\n}\n\nfunction fundamentalFromNative(descriptor: FundamentalDescriptor, value: unknown): unknown {\n    return value == null\n        ? null\n        : wrapHandle(\n                value as ExternalObject<Handle>,\n                descriptor.wrapperClass ?? getWrapperClass(resolveDescriptorType(descriptor)),\n            );\n}\n\nfunction hashTableFromNative(descriptor: HashTableDescriptor, value: unknown): unknown {\n    if (value === null) {\n        return null;\n    }\n\n    const entries = value as [unknown, unknown][];\n\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\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 */\nfunction fromNative(descriptor: Descriptor, value: unknown): unknown {\n    if (!isMarshalledDescriptor(descriptor)) {\n        return value;\n    }\n\n    switch (descriptor.kind) {\n        case \"object\": {\n            return wrapHandle(value as ExternalObject<Handle> | null);\n        }\n        case \"struct\": {\n            return wrapHandle(value as ExternalObject<Handle> | null, (descriptor as StructDescriptor).wrapperClass);\n        }\n        case \"boxed\": {\n            return boxedFromNative(descriptor, value);\n        }\n        case \"fundamental\": {\n            return fundamentalFromNative(descriptor, value);\n        }\n        case \"array\": {\n            return collectionFromNative(descriptor, value);\n        }\n        case \"hashtable\": {\n            return hashTableFromNative(descriptor, value);\n        }\n    }\n}\n\nfunction collectionToNative(descriptor: ArrayDescriptor, value: unknown): unknown {\n    return value == null ? null : mapCollection(descriptor, value, toNative);\n}\n\nfunction hashTableToNative(descriptor: HashTableDescriptor, value: unknown): unknown {\n    if (value == null) {\n        return null;\n    }\n\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\nfunction toNative(descriptor: Descriptor, value: unknown): unknown {\n    if (!isMarshalledDescriptor(descriptor)) {\n        return value;\n    }\n\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        }\n        case \"array\": {\n            return collectionToNative(descriptor, value);\n        }\n        case \"hashtable\": {\n            return hashTableToNative(descriptor, value);\n        }\n    }\n}\n\nexport { fromNative, toNative };\n"]}

package/dist/object.d.ts

@@ -0,0 +1,32 @@
+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.
+ */
+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.
+ */
+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.
+ */
+declare function setObjectProperty(obj: object, propertyName: string, descriptor: Descriptor, jsValue: unknown): void;
+export { newObjectWithProperties, getObjectProperty, setObjectProperty };
+//# 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;AAiCvE;;;;;;;;GAQG;AACH,iBAAS,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAsBtG;AAED;;;;;;;GAOG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAK7F;AAED;;;;;;;;GAQG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAE5G;AAED,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/object.js

@@ -0,0 +1,66 @@
+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.
+ */
+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.
+ */
+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.
+ */
+function setObjectProperty(obj, propertyName, descriptor, jsValue) {
+    gObjectSetProperty(getHandle(obj), propertyName, toValue(descriptor, jsValue));
+}
+export { newObjectWithProperties, getObjectProperty, setObjectProperty };
+//# 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;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;AAEF;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,KAAa,EAAE,KAA8B;IAC1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAY,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QAED,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,KAA8B,CAAC;QAE3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,SAAS;QACb,CAAC;QAED,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,SAAS,iBAAiB,CAAC,GAAW,EAAE,YAAoB,EAAE,UAAsB;IAChF,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAChD,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAExD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,GAAW,EAAE,YAAoB,EAAE,UAAsB,EAAE,OAAgB;IAClG,kBAAkB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,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);\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 */\nfunction 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: unknown = props[name];\n\n        if (!Array.isArray(entry)) {\n            continue;\n        }\n\n        const [descriptor, value] = entry as [Descriptor, unknown];\n\n        if (value === undefined) {\n            continue;\n        }\n\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 */\nfunction getObjectProperty(obj: object, propertyName: string, descriptor: Descriptor): unknown {\n    const value = newValueForDescriptor(descriptor);\n    gObjectGetProperty(getHandle(obj), propertyName, value);\n\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 */\nfunction setObjectProperty(obj: object, propertyName: string, descriptor: Descriptor, jsValue: unknown): void {\n    gObjectSetProperty(getHandle(obj), propertyName, toValue(descriptor, jsValue));\n}\n\nexport { newObjectWithProperties, getObjectProperty, setObjectProperty };\n"]}

package/dist/promisify.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Extracts the finished value from the async result a GIO-style operation completes with.
+ *
+ * @template R - The async result type passed to the completion callback.
+ * @template T - The finished value type.
+ */
+type FinishResult<R extends object, T> = (result: R) => T;
+/**
+ * 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.
+ */
+declare const promisify: <R extends object, T>(asyncFn: (...args: unknown[]) => void, finish: FinishResult<R, T>, cancellable: object | null | undefined, ...leading: unknown[]) => Promise<T>;
+export { promisify, type FinishResult };
+//# 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":"AAEA;;;;;GAKG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAgC1D;;;;;;;;;;GAUG;AACH,QAAA,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,EAClC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EACrC,QAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,aAAa,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,GAAG,SAAS,OAAO,EAAE,KACtB,OAAO,CAAC,CAAC,CAQN,CAAC;AAEP,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/promisify.js

@@ -0,0 +1,39 @@
+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;
+};
+const settle = (settlement, asyncResult) => {
+    const { finish, creationStack, resolve, reject } = settlement;
+    try {
+        resolve(finish(asyncResult));
+    }
+    catch (error) {
+        attachCreationStack(error, creationStack);
+        reject(error instanceof Error ? error : new Error(String(error)));
+    }
+};
+/**
+ * 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.
+ */
+const promisify = (asyncFn, finish, cancellable, ...leading) => new Promise((resolve, reject) => {
+    const creationStack = process.env.NODE_ENV === "production" ? undefined : new Error("gtkx async operation started here");
+    asyncFn(...leading, tryGetHandle(cancellable), (_source, asyncResult) => {
+        settle({ finish, creationStack, resolve, reject }, asyncResult);
+    });
+});
+export { promisify };
+//# sourceMappingURL=promisify.js.map

package/dist/promisify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promisify.js","sourceRoot":"","sources":["../src/promisify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiB7C,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAE,aAAgC,EAAQ,EAAE;IACnF,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAsB,UAA4B,EAAE,WAAmB,EAAQ,EAAE;IAC5F,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAE9D,IAAI,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,WAAgB,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,SAAS,GAAG,CACd,OAAqC,EACrC,MAA0B,EAC1B,WAAsC,EACtC,GAAG,OAAkB,EACX,EAAE,CACZ,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC/B,MAAM,aAAa,GACf,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAEvG,OAAO,CAAC,GAAG,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC,OAAsB,EAAE,WAAmB,EAAE,EAAE;QAC3F,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEP,OAAO,EAAE,SAAS,EAAqB,CAAC","sourcesContent":["import { tryGetHandle } from \"./registry.js\";\n\n/**\n * Extracts the finished value from the async result a GIO-style operation completes with.\n *\n * @template R - The async result type passed to the completion callback.\n * @template T - The finished value type.\n */\ntype FinishResult<R extends object, T> = (result: R) => T;\n\ntype Settlement<R extends object, T> = {\n    finish: FinishResult<R, T>;\n    creationStack: Error | undefined;\n    resolve: (value: T) => void;\n    reject: (reason: Error) => void;\n};\n\nconst attachCreationStack = (error: unknown, creationStack: Error | undefined): void => {\n    if (creationStack === undefined || !(error instanceof Error)) {\n        return;\n    }\n\n    if (error.cause !== undefined || !Object.isExtensible(error)) {\n        return;\n    }\n\n    error.cause = creationStack;\n};\n\nconst settle = <R extends object, T>(settlement: Settlement<R, T>, asyncResult: object): void => {\n    const { finish, creationStack, resolve, reject } = settlement;\n\n    try {\n        resolve(finish(asyncResult as R));\n    } catch (error) {\n        attachCreationStack(error, creationStack);\n        reject(error instanceof Error ? error : new Error(String(error)));\n    }\n};\n\n/**\n * Wraps a GIO-style asynchronous function that takes a completion callback into a\n * promise, invoking the finish function to extract the result. Outside production,\n * the call site's stack is captured and attached as the rejection error's cause.\n *\n * @param asyncFn The async function, called with the leading arguments, the cancellable, and a completion callback.\n * @param finish Extracts the result from the async result passed to the completion callback.\n * @param cancellable A cancellable object, or null/undefined for none.\n * @param leading Arguments passed to `asyncFn` before the cancellable and callback.\n * @returns A promise resolving to the finished result, or rejecting if `finish` throws.\n */\nconst promisify = <R extends object, T>(\n    asyncFn: (...args: unknown[]) => void,\n    finish: FinishResult<R, T>,\n    cancellable: object | null | undefined,\n    ...leading: unknown[]\n): Promise<T> =>\n    new Promise<T>((resolve, reject) => {\n        const creationStack =\n            process.env.NODE_ENV === \"production\" ? undefined : new Error(\"gtkx async operation started here\");\n\n        asyncFn(...leading, tryGetHandle(cancellable), (_source: object | null, asyncResult: object) => {\n            settle({ finish, creationStack, resolve, reject }, asyncResult);\n        });\n    });\n\nexport { promisify, type FinishResult };\n"]}

package/dist/properties.d.ts

@@ -0,0 +1,14 @@
+import type { RegisterClassProperty } from "@gtkx/native";
+import type { AnyClass } from "@gtkx/utils";
+type PropertyAccessor = {
+    name: string;
+    storage: symbol;
+    pspec: object;
+};
+type PropertySpec = object;
+declare function makeGetProperty(accessors: PropertyAccessor[]): (this: object, propertyId: number, value: object) => void;
+declare function makeSetProperty(accessors: PropertyAccessor[]): (this: object, propertyId: number, value: object) => void;
+declare function buildAccessors(klass: AnyClass, properties: Record<string, PropertySpec>): PropertyAccessor[];
+declare function toNativeProperties(properties: Record<string, PropertySpec>): RegisterClassProperty[];
+export { buildAccessors, makeGetProperty, makeSetProperty, toNativeProperties, type PropertyAccessor, type PropertySpec, };
+//# sourceMappingURL=properties.d.ts.map

package/dist/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../src/properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAO5C,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC;AA0D3B,iBAAS,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,IACtB,MAAM,MAAM,EAAE,YAAY,MAAM,EAAE,OAAO,MAAM,KAAG,IAAI,CAKrF;AAED,iBAAS,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,IACtB,MAAM,MAAM,EAAE,YAAY,MAAM,EAAE,OAAO,MAAM,KAAG,IAAI,CAKrF;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,gBAAgB,EAAE,CAUrG;AAED,iBAAS,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,qBAAqB,EAAE,CAK7F;AAED,OAAO,EACH,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GACpB,CAAC"}

package/dist/properties.js

@@ -0,0 +1,79 @@
+import { camelCase } from "@gtkx/utils";
+import { bind } from "./bind.js";
+import { LIB, PARAM_T, VALUE_T } from "./library.js";
+import { getHandle } from "./registry.js";
+import { fromValue, intoValue } from "./value.js";
+const FIRST_PROPERTY_ID = 1;
+const paramSpecDefaultValue = bind(LIB, "g_param_spec_get_default_value", [PARAM_T], VALUE_T);
+const underscoreCase = (name) => name.replaceAll("-", "_");
+const accessorNames = (name) => [...new Set([name, underscoreCase(name), camelCase(name)])];
+function readStored(instance, accessor) {
+    if (!Object.hasOwn(instance, accessor.storage)) {
+        const defaults = paramSpecDefaultValue(getHandle(accessor.pspec));
+        instance[accessor.storage] = fromValue(defaults);
+    }
+    return instance[accessor.storage];
+}
+function defineAccessor(prototype, accessor, alias) {
+    if (Object.getOwnPropertyDescriptor(prototype, alias) !== undefined) {
+        return;
+    }
+    Object.defineProperty(prototype, alias, {
+        configurable: true,
+        enumerable: true,
+        get() {
+            return readStored(this, accessor);
+        },
+        set(value) {
+            if (readStored(this, accessor) === value) {
+                return;
+            }
+            this[accessor.storage] = value;
+            this.notify?.(accessor.name);
+        },
+    });
+}
+function installAccessors(klass, accessor) {
+    const prototype = klass.prototype;
+    for (const alias of accessorNames(accessor.name)) {
+        defineAccessor(prototype, accessor, alias);
+    }
+}
+function resolveAccessor(accessors, propertyId) {
+    const accessor = accessors[propertyId - FIRST_PROPERTY_ID];
+    if (accessor === undefined) {
+        throw new RangeError(`registerClass: no property registered for id ${String(propertyId)}`);
+    }
+    return accessor;
+}
+function makeGetProperty(accessors) {
+    return function getProperty(propertyId, value) {
+        const accessor = resolveAccessor(accessors, propertyId);
+        const current = this[camelCase(accessor.name)];
+        intoValue(getHandle(value), current);
+    };
+}
+function makeSetProperty(accessors) {
+    return function setProperty(propertyId, value) {
+        const accessor = resolveAccessor(accessors, propertyId);
+        const jsValue = fromValue(getHandle(value));
+        this[camelCase(accessor.name)] = jsValue;
+    };
+}
+function buildAccessors(klass, properties) {
+    const accessors = [];
+    for (const [name, pspec] of Object.entries(properties)) {
+        const accessor = { name, storage: Symbol(`gtkx:property:${name}`), pspec };
+        installAccessors(klass, accessor);
+        accessors.push(accessor);
+    }
+    return accessors;
+}
+function toNativeProperties(properties) {
+    return Object.values(properties).map((pspec, index) => ({
+        id: index + FIRST_PROPERTY_ID,
+        pspec: getHandle(pspec),
+    }));
+}
+export { buildAccessors, makeGetProperty, makeSetProperty, toNativeProperties, };
+//# sourceMappingURL=properties.js.map

package/dist/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../src/properties.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalObject, Handle, RegisterClassProperty } from \"@gtkx/native\";\nimport type { AnyClass } from \"@gtkx/utils\";\nimport { camelCase } from \"@gtkx/utils\";\nimport { bind } from \"./bind.js\";\nimport { LIB, PARAM_T, VALUE_T } from \"./library.js\";\nimport { getHandle } from \"./registry.js\";\nimport { fromValue, intoValue } from \"./value.js\";\n\ntype PropertyAccessor = {\n    name: string;\n    storage: symbol;\n    pspec: object;\n};\n\ntype PropertySpec = object;\ntype NotifyingObject = { notify?: (propertyName: string) => void };\n\nconst FIRST_PROPERTY_ID = 1;\nconst paramSpecDefaultValue = bind(LIB, \"g_param_spec_get_default_value\", [PARAM_T], VALUE_T);\n\nconst underscoreCase = (name: string): string => name.replaceAll(\"-\", \"_\");\nconst accessorNames = (name: string): string[] => [...new Set([name, underscoreCase(name), camelCase(name)])];\n\nfunction readStored(instance: Record<symbol, unknown>, accessor: PropertyAccessor): unknown {\n    if (!Object.hasOwn(instance, accessor.storage)) {\n        const defaults = paramSpecDefaultValue(getHandle(accessor.pspec)) as ExternalObject<Handle>;\n        instance[accessor.storage] = fromValue(defaults);\n    }\n\n    return instance[accessor.storage];\n}\n\nfunction defineAccessor(prototype: object, accessor: PropertyAccessor, alias: string): void {\n    if (Object.getOwnPropertyDescriptor(prototype, alias) !== undefined) {\n        return;\n    }\n\n    Object.defineProperty(prototype, alias, {\n        configurable: true,\n        enumerable: true,\n        get(this: Record<symbol, unknown>) {\n            return readStored(this, accessor);\n        },\n        set(this: Record<symbol, unknown>, value: unknown) {\n            if (readStored(this, accessor) === value) {\n                return;\n            }\n\n            this[accessor.storage] = value;\n            (this as NotifyingObject).notify?.(accessor.name);\n        },\n    });\n}\n\nfunction installAccessors(klass: AnyClass, accessor: PropertyAccessor): void {\n    const prototype = (klass as { prototype: object }).prototype;\n\n    for (const alias of accessorNames(accessor.name)) {\n        defineAccessor(prototype, accessor, alias);\n    }\n}\n\nfunction resolveAccessor(accessors: PropertyAccessor[], propertyId: number): PropertyAccessor {\n    const accessor = accessors[propertyId - FIRST_PROPERTY_ID];\n\n    if (accessor === undefined) {\n        throw new RangeError(`registerClass: no property registered for id ${String(propertyId)}`);\n    }\n\n    return accessor;\n}\n\nfunction makeGetProperty(accessors: PropertyAccessor[]) {\n    return function getProperty(this: object, propertyId: number, value: object): void {\n        const accessor = resolveAccessor(accessors, propertyId);\n        const current = (this as Record<string, unknown>)[camelCase(accessor.name)];\n        intoValue(getHandle(value), current);\n    };\n}\n\nfunction makeSetProperty(accessors: PropertyAccessor[]) {\n    return function setProperty(this: object, propertyId: number, value: object): void {\n        const accessor = resolveAccessor(accessors, propertyId);\n        const jsValue = fromValue(getHandle(value));\n        (this as Record<string, unknown>)[camelCase(accessor.name)] = jsValue;\n    };\n}\n\nfunction buildAccessors(klass: AnyClass, properties: Record<string, PropertySpec>): PropertyAccessor[] {\n    const accessors: PropertyAccessor[] = [];\n\n    for (const [name, pspec] of Object.entries(properties)) {\n        const accessor: PropertyAccessor = { name, storage: Symbol(`gtkx:property:${name}`), pspec };\n        installAccessors(klass, accessor);\n        accessors.push(accessor);\n    }\n\n    return accessors;\n}\n\nfunction toNativeProperties(properties: Record<string, PropertySpec>): RegisterClassProperty[] {\n    return Object.values(properties).map((pspec, index) => ({\n        id: index + FIRST_PROPERTY_ID,\n        pspec: getHandle(pspec),\n    }));\n}\n\nexport {\n    buildAccessors,\n    makeGetProperty,\n    makeSetProperty,\n    toNativeProperties,\n    type PropertyAccessor,\n    type PropertySpec,\n};\n"]}

package/dist/register-class.d.ts

@@ -0,0 +1,25 @@
+import { type AnyClass } from "@gtkx/utils";
+import { type PropertySpec } from "./properties.js";
+type RegisterClassOptions = {
+    typeName?: string;
+    /**
+     * Properties to install on the new type, keyed by canonical property name. Each value is the
+     * `GObject.ParamSpec` describing it, for example `GObject.paramSpecString(...)`. Accessors are
+     * generated on the prototype for the dashed, underscored and camelCased spellings of the name
+     * unless the class already defines one, and writing through them emits `notify`.
+     */
+    properties?: Record<string, PropertySpec>;
+};
+/**
+ * Registers a subclass of a wrapper class as a new GType, wiring up any class and
+ * inherited-interface virtual functions it overrides. Throws if the class does not
+ * extend a registered wrapper class, has no derivable type name, or overrides an
+ * unsupported construct-time vtable slot.
+ *
+ * @param klass The subclass to register.
+ * @param options Registration options, such as an explicit type name.
+ * @returns The same class, now registered.
+ */
+declare function registerClass<T extends AnyClass>(klass: T, options?: RegisterClassOptions): T;
+export { registerClass };
+//# sourceMappingURL=register-class.d.ts.map

package/dist/register-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-class.d.ts","sourceRoot":"","sources":["../src/register-class.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,QAAQ,EAAkC,MAAM,aAAa,CAAC;AAE5E,OAAO,EAKH,KAAK,YAAY,EAEpB,MAAM,iBAAiB,CAAC;AAUzB,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C,CAAC;AAWF;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,CAAC,CAuB1F;AAkOD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/register-class.js

@@ -0,0 +1,178 @@
+import { registerClass as nativeRegisterClass, } from "@gtkx/native";
+import { getParentClass, walkClassChain } from "@gtkx/utils";
+import { wrapCallback } from "./callback.js";
+import { buildAccessors, makeGetProperty, makeSetProperty, toNativeProperties, } from "./properties.js";
+import { getClassType, getInterfaceVfuncRegistry, getVfuncRegistry, registerClassType, } from "./registry.js";
+import { TYPE_INVALID, typeInterfaces } from "./type.js";
+const UNSUPPORTED_CONSTRUCT_VFUNCS = new Set(["constructed", "setProperty", "getProperty"]);
+const VALUE_ARG_INDEX = 2;
+/**
+ * Registers a subclass of a wrapper class as a new GType, wiring up any class and
+ * inherited-interface virtual functions it overrides. Throws if the class does not
+ * extend a registered wrapper class, has no derivable type name, or overrides an
+ * unsupported construct-time vtable slot.
+ *
+ * @param klass The subclass to register.
+ * @param options Registration options, such as an explicit type name.
+ * @returns The same class, now registered.
+ */
+function registerClass(klass, options = {}) {
+    const parentType = resolveParentType(klass);
+    if (parentType === TYPE_INVALID) {
+        throw new TypeError(`registerClass: ${klass.name} must extend a registered wrapper class`);
+    }
+    const name = options.typeName ?? klass.name;
+    if (!name) {
+        throw new Error("registerClass: cannot derive a GType name (anonymous class with no typeName option)");
+    }
+    const properties = options.properties ?? {};
+    const accessors = buildAccessors(klass, properties);
+    const classVfuncs = [...discoverClassVfuncs(klass), ...propertyVfuncs(klass, accessors)];
+    const claimedMethodNames = new Set(classVfuncs.map((vfunc) => vfunc.methodName));
+    const interfaceBindings = discoverInheritedInterfaceVfuncs(klass, parentType, claimedMethodNames);
+    const nativeOptions = toNativeOptions(classVfuncs, interfaceBindings, properties);
+    const newType = nativeRegisterClass(name, parentType, nativeOptions);
+    registerClassType(klass, newType);
+    return klass;
+}
+function resolveParentType(klass) {
+    return (walkClassChain(getParentClass(klass), (cls) => {
+        const gtype = getClassType(cls);
+        return gtype === TYPE_INVALID ? undefined : gtype;
+    }) ?? TYPE_INVALID);
+}
+function ownInstanceMethodNames(klass) {
+    const proto = klass.prototype;
+    if (!proto) {
+        return [];
+    }
+    return Object.getOwnPropertyNames(proto).filter((name) => {
+        if (name === "constructor") {
+            return false;
+        }
+        return typeof Object.getOwnPropertyDescriptor(proto, name)?.value === "function";
+    });
+}
+function buildDiscoveredVfunc(proto, methodName, resolveDescriptor, skip) {
+    if (skip?.has(methodName)) {
+        return undefined;
+    }
+    const descriptor = resolveDescriptor(methodName);
+    if (!descriptor) {
+        return undefined;
+    }
+    const fn = proto[methodName];
+    if (!fn) {
+        return undefined;
+    }
+    return {
+        ...descriptor,
+        methodName,
+        fn: wrapVfunc(fn, descriptor.argDescriptors, descriptor.returnDescriptor),
+    };
+}
+function collectDiscoveredVfuncs(klass, resolveDescriptor, skip) {
+    const proto = klass.prototype;
+    const result = [];
+    for (const methodName of ownInstanceMethodNames(klass)) {
+        const discovered = buildDiscoveredVfunc(proto, methodName, resolveDescriptor, skip);
+        if (discovered) {
+            result.push(discovered);
+        }
+    }
+    return result;
+}
+function discoverClassVfuncs(klass) {
+    return collectDiscoveredVfuncs(klass, (methodName) => {
+        const descriptor = findClassVfuncDescriptor(klass, methodName);
+        if (descriptor && UNSUPPORTED_CONSTRUCT_VFUNCS.has(methodName)) {
+            throw new Error(`registerClass: overriding the GObject construct-time vtable slot '${methodName}' is not ` +
+                "supported; run construct-time initialization in the subclass constructor, after " +
+                "super(...), instead");
+        }
+        return descriptor ?? undefined;
+    });
+}
+function wrapVfunc(fn, argDescriptors, returnDescriptor) {
+    return wrapCallback(fn, { argDescriptors, returnDescriptor }, "this");
+}
+function discoverInheritedInterfaceVfuncs(klass, parentGtype, claimedMethodNames) {
+    const bindings = [];
+    for (const interfaceGtype of typeInterfaces(parentGtype)) {
+        const [first, ...rest] = discoverInterfaceVfuncs(klass, interfaceGtype, claimedMethodNames);
+        if (first !== undefined) {
+            bindings.push({ gtype: interfaceGtype, vtableSize: first.vtableSize, vfuncs: [first, ...rest] });
+        }
+    }
+    return bindings;
+}
+function discoverInterfaceVfuncs(klass, interfaceGtype, claimedMethodNames) {
+    const vfuncRegistry = getInterfaceVfuncRegistry(interfaceGtype);
+    if (!vfuncRegistry) {
+        return [];
+    }
+    return collectDiscoveredVfuncs(klass, (methodName) => {
+        const entry = vfuncRegistry[methodName];
+        return entry?.kind === "interface" ? entry : undefined;
+    }, claimedMethodNames);
+}
+function findClassVfuncDescriptor(klass, methodName) {
+    return (walkClassChain(getParentClass(klass), (cls) => {
+        const entry = getVfuncRegistry(cls)?.[methodName];
+        return entry?.kind === "class" ? entry : undefined;
+    }) ?? null);
+}
+function propertyVfuncs(klass, accessors) {
+    if (accessors.length === 0) {
+        return [];
+    }
+    return [
+        buildPropertyVfunc(klass, "getProperty", makeGetProperty(accessors), true),
+        buildPropertyVfunc(klass, "setProperty", makeSetProperty(accessors), false),
+    ];
+}
+// `get_property` fills a GValue the caller owns, so the marshalled copy handed to JavaScript has to
+// be written back into it; `set_property` only reads its GValue and needs no copy back.
+function markValueCallerAllocated(argDescriptors) {
+    return argDescriptors.map((arg, index) => index === VALUE_ARG_INDEX ? { ...arg, callerAllocated: true } : arg);
+}
+function buildPropertyVfunc(klass, methodName, fn, isValueOut) {
+    const descriptor = findClassVfuncDescriptor(klass, methodName);
+    if (!descriptor) {
+        throw new Error(`registerClass: the parent class exposes no '${methodName}' vtable slot`);
+    }
+    const argDescriptors = isValueOut
+        ? markValueCallerAllocated(descriptor.argDescriptors)
+        : descriptor.argDescriptors;
+    return {
+        ...descriptor,
+        methodName,
+        argDescriptors,
+        fn: wrapVfunc(fn, argDescriptors, descriptor.returnDescriptor),
+    };
+}
+function toNativeOptions(classVfuncs, interfaceBindings, properties) {
+    const hasInterfaces = interfaceBindings.length > 0;
+    const hasClassVfuncs = classVfuncs.length > 0;
+    const hasProperties = Object.keys(properties).length > 0;
+    if (!hasClassVfuncs && !hasInterfaces && !hasProperties) {
+        return undefined;
+    }
+    const options = {};
+    if (hasProperties) {
+        options.properties = toNativeProperties(properties);
+    }
+    if (hasClassVfuncs) {
+        options.vfuncs = [...classVfuncs];
+    }
+    if (hasInterfaces) {
+        options.interfaces = interfaceBindings.map((binding) => ({
+            type: binding.gtype,
+            vtableSize: binding.vtableSize,
+            vfuncs: [...binding.vfuncs],
+        }));
+    }
+    return options;
+}
+export { registerClass };
+//# sourceMappingURL=register-class.js.map