@gtkx/runtime 1.2.2 → 1.4.0

package/dist/registry.js

@@ -1,7 +1,10 @@
-import { getType, getWrapper, setWrapper, } from "@gtkx/native";
+import { getFundamentalWrapper, getType, getTypeClass, getWrapper, setFundamentalWrapper, setWrapper, } from "@gtkx/native";
 import { walkClassChain } from "@gtkx/utils";
-import { TYPE_INVALID, typeInterfaces, typeIsA, typeName, typeParent } from "./type.js";
+import { copyLayerMembers } from "./mixin.js";
+import { TYPE_INVALID, TYPE_OBJECT, typeInterfaces, typeIsA, typeName, typeParent, } from "./type.js";
 const classRegistry = new Map();
+const classStructRegistry = new Map();
+const composedClassStructRegistry = new Map();
 const interfaceMixinRegistry = new Map();
 const composedClassRegistry = new Map();
 const handleMap = new WeakMap();
@@ -9,6 +12,8 @@ const vfuncRegistry = new WeakMap();
 const interfaceLayoutRegistry = new Map();
 const wrapperClasses = new WeakSet();
 const derivedClasses = new WeakSet();
+const typeClassHandles = new Map();
+const wrapperClassResolvers = new WeakMap();
 function setClassType(cls, type) {
     cls.prototype.__type__ = type;
 }
@@ -34,6 +39,13 @@ function getInstanceType(instance) {
     const handle = handleMap.get(instance);
     return handle === undefined ? TYPE_INVALID : getType(handle);
 }
+function coerceGType(value) {
+    if (typeof value !== "function") {
+        return value;
+    }
+    const type = getClassType(value);
+    return type === TYPE_INVALID ? value : type;
+}
 function registerClassType(cls, type) {
     if (type === TYPE_INVALID) {
         return;
@@ -58,9 +70,118 @@ function registerWrapperClass(cls, type, vfuncs) {
         registerVfuncRegistry(cls, vfuncs);
     }
 }
+/**
+ * Lets a class registered with `registerWrapperClass` pick a subclass for each handle it wraps, for
+ * types whose one GType covers several C-level subtypes, the way a cairo surface reports image or
+ * recording through `cairo_surface_get_type`. The resolver runs when a handle is wrapped as that class
+ * explicitly, the way a boxed value a binding hands back is; a wrapper resolved from a handle's runtime
+ * GType never consults it, and a subclass passed to `wrapHandle` directly is used as given.
+ * @param cls Registered wrapper class whose handles the resolver classifies.
+ * @param resolver Returns the class to instantiate for one handle, `cls` itself included.
+ * @throws If `cls` is not a registered wrapper class.
+ */
+function registerWrapperClassResolver(cls, resolver) {
+    if (!wrapperClasses.has(cls)) {
+        throw new Error(`Cannot register a wrapper class resolver for ${cls.name}: ` +
+            "register the class with registerWrapperClass first");
+    }
+    wrapperClassResolvers.set(cls, resolver);
+}
 function markDerivedClass(cls) {
     derivedClasses.add(cls);
 }
+/**
+ * Registers the wrapper class of a type's class struct, such as `Gtk.WidgetClass` for `Gtk.Widget`,
+ * so `registerClass` can hand a `classInit` hook the new type's class struct wrapped in it.
+ * @param cls Wrapper class of the type's instances, already registered through
+ * `registerWrapperClass`.
+ * @param structClass Wrapper class of the type's class struct.
+ */
+function registerClassStruct(cls, structClass) {
+    const type = getClassType(cls);
+    if (type !== TYPE_INVALID) {
+        classStructRegistry.set(type, structClass);
+    }
+}
+function collectClassStructClasses(type) {
+    const structs = [];
+    let current = type;
+    while (current !== TYPE_INVALID) {
+        const structClass = classStructRegistry.get(current);
+        if (structClass !== undefined) {
+            structs.push(structClass);
+        }
+        current = typeParent(current);
+    }
+    return structs;
+}
+function composeClassStructClass(structs) {
+    const [nearest, ...ancestors] = structs;
+    if (nearest === undefined || ancestors.length === 0) {
+        return nearest;
+    }
+    const composed = class extends nearest {
+    };
+    Object.defineProperty(composed, "name", { value: nearest.name });
+    for (const structClass of ancestors) {
+        copyLayerMembers(composed, structClass.prototype);
+    }
+    return composed;
+}
+function getClassStructClass(type) {
+    const cached = composedClassStructRegistry.get(type);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const composed = composeClassStructClass(collectClassStructClasses(type));
+    if (composed !== undefined) {
+        composedClassStructRegistry.set(type, composed);
+    }
+    return composed;
+}
+function peekedTypeLabel(type, gtype) {
+    const name = typeName(gtype);
+    if (name !== null) {
+        return name;
+    }
+    return typeof type === "bigint" ? String(type) : type.name;
+}
+function getTypeClassHandle(gtype) {
+    const cached = typeClassHandles.get(gtype);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const handle = getTypeClass(gtype);
+    typeClassHandles.set(gtype, handle);
+    return handle;
+}
+/**
+ * Returns a GObject type's class struct, wrapped in the class-struct wrapper classes registered
+ * for the type's ancestry, such as `Gtk.WidgetClass` composed with `GObject.ObjectClass` for a
+ * widget type. The class is referenced so it exists even before the type's first instance, and
+ * the reference is deliberately never released: once created, a class struct lives for the rest
+ * of the process. Backs the `peek` statics of generated GTypeStruct wrappers, such as
+ * `GObject.ObjectClass.peek` and `Gtk.WidgetClass.peek`.
+ *
+ * @param type GType to peek the class struct of, or a registered wrapper class of the type.
+ * @param base When given, wrapper class of the type the peeked type must derive from; the peek
+ * throws for a type outside that lineage. Without it any GObject type is accepted.
+ * @returns The wrapped class struct.
+ */
+function peekTypeClass(type, base) {
+    const gtype = typeof type === "bigint" ? type : getClassType(type);
+    if (!typeIsA(gtype, TYPE_OBJECT)) {
+        throw new TypeError(`peekTypeClass: '${peekedTypeLabel(type, gtype)}' is not a GObject type`);
+    }
+    if (base !== undefined && !typeIsA(gtype, getClassType(base))) {
+        throw new TypeError(`peekTypeClass: '${peekedTypeLabel(type, gtype)}' does not derive from '${base.name}'`);
+    }
+    const structClass = getClassStructClass(gtype);
+    if (structClass === undefined) {
+        throw new TypeError(`peekTypeClass: no ancestor of '${peekedTypeLabel(type, gtype)}' registers a class struct wrapper`);
+    }
+    return wrapHandle(getTypeClassHandle(gtype), structClass);
+}
 function resolveAncestorType(ancestor) {
     if (derivedClasses.has(ancestor) || !wrapperClasses.has(ancestor)) {
         return undefined;
@@ -100,8 +221,22 @@ function wrapHandle(handle, cls) {
     if (cls === undefined) {
         return getOrCreateWrapper(handle);
     }
+    const resolver = wrapperClassResolvers.get(cls);
+    const instance = Object.create((resolver === undefined ? cls : resolver(handle)).prototype);
+    setHandle(instance, handle);
+    return instance;
+}
+function wrapFundamentalHandle(handle, cls) {
+    if (handle === null || handle === undefined) {
+        return null;
+    }
+    const existing = getFundamentalWrapper(handle);
+    if (existing) {
+        return existing;
+    }
     const instance = Object.create(cls.prototype);
     setHandle(instance, handle);
+    setFundamentalWrapper(handle, instance);
     return instance;
 }
 /**
@@ -206,6 +341,15 @@ function getOrCreateWrapper(handle) {
 function instanceClassName(instance) {
     return instance.constructor?.name ?? "object";
 }
+function describeValueKind(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value !== "object") {
+        return typeof value;
+    }
+    return instanceClassName(value);
+}
 /** Returns the native handle bound to a wrapper instance, throwing if none is set. */
 function getHandle(instance) {
     const handle = handleMap.get(instance);
@@ -237,5 +381,5 @@ function getInterfaceVfuncRegistry(type) {
 function getInterfaceProperties(type) {
     return interfaceLayoutRegistry.get(type)?.properties;
 }
-export { getClassType, getInstanceType, markDerivedClass, registerClassType, registerWrapperClass, registerInterface, wrapHandle, getWrapperClass, resolveWrapperClass, getHandle, setHandle, getVfuncRegistry, getInterfaceMixin, getInterfaceProperties, getInterfaceVfuncRegistry, instanceClassName, registerWrapper, resolveWrapperType, wrapCallScopedObject, wrapObject, };
+export { coerceGType, describeValueKind, getClassStructClass, getClassType, getInstanceType, getTypeClassHandle, markDerivedClass, peekTypeClass, registerClassStruct, registerClassType, registerWrapperClass, registerWrapperClassResolver, registerInterface, wrapFundamentalHandle, wrapHandle, getWrapperClass, resolveWrapperClass, getHandle, setHandle, getVfuncRegistry, getInterfaceMixin, getInterfaceProperties, getInterfaceVfuncRegistry, instanceClassName, registerWrapper, resolveWrapperType, wrapCallScopedObject, wrapObject, };
 //# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type ExternalObject,\n    getType,\n    getWrapper,\n    type Handle,\n    type RegisterClassVfunc as NativeRegisterClassVfunc,\n    setWrapper,\n} from \"@gtkx/native\";\nimport { type AnyClass, walkClassChain } from \"@gtkx/utils\";\nimport type { Mixin, MixinReceiver } from \"./mixin.js\";\nimport { TYPE_INVALID, type TypedClass, typeInterfaces, typeIsA, typeName, typeParent } from \"./type.js\";\n\n/**\n * Static side of class `C` with its construct signature preserved but the members named `K`\n * removed. A generated class lists every static it declares itself, so a static it narrows never\n * has to stay assignable to the one it shadows. The signature is kept abstract so an abstract `C`\n * survives it: a subclass extends the result, and only the subclass's own declarations decide\n * which statics reach it.\n */\ntype StaticBase<C, K extends PropertyKey> = Omit<C, K> &\n    (C extends abstract new (...args: infer A) => infer R ? abstract new (...args: A) => R : never);\n\n/** One overridable vtable slot: where it sits in the vtable struct and how it is marshalled. */\ntype VfuncDescriptor = {\n    /** GIR name of the type struct holding the slot, without its namespace, such as `WidgetClass`. */\n    className: string;\n    /** Name of the slot's field in that struct. */\n    vfuncName: string;\n    /** Byte offset of the slot within the struct. */\n    byteOffset: number;\n    /**\n     * Byte size of an interface's vtable struct, used to bounds-check `VfuncDescriptor.byteOffset`.\n     * A class struct is bounds-checked against the size `g_type_query` reports for it, so a slot in\n     * one carries no size of its own.\n     */\n    vtableSize?: number;\n    /** Descriptor for each argument the slot receives, starting with the instance. */\n    argDescriptors: NativeRegisterClassVfunc[\"argDescriptors\"];\n    /** Descriptor for the value the slot returns. */\n    returnDescriptor: NativeRegisterClassVfunc[\"returnDescriptor\"];\n    /**\n     * GIR marks the slot's return value as one the bindings do not surface, so a call through the\n     * slot drops it and an implementation of the slot reports success in its place, while\n     * `VfuncDescriptor.returnDescriptor` keeps the C type the slot is called against either way.\n     */\n    isReturnSkipped?: boolean;\n    /**\n     * The slot takes a trailing `GError**` that `VfuncDescriptor.argDescriptors` leaves out, the\n     * way GIR leaves it out of a callable's parameters. A call through the slot has to append it\n     * or it passes one argument fewer than the implementation reads.\n     */\n    canThrow?: boolean;\n};\n\n/**\n * The vtable slots a wrapper class or interface exposes, keyed by the JavaScript method name that\n * overrides each one.\n */\ntype VfuncRegistry = Record<string, VfuncDescriptor>;\ntype WrapperBinding = (handle: ExternalObject<Handle>, instance: object) => void;\n\n/**\n * How one property an interface declares reaches the vtable, given as the interface's own accessor\n * members. A direction introspection does not route through a vtable slot is left out, and the\n * property owns that direction's state itself.\n */\ntype InterfaceProperty = {\n    /** Member reading the slot the property's value comes from, such as `getEnabled`. */\n    getter?: string;\n    /** Member writing the slot the property's value goes to, such as `setActionName`. */\n    setter?: string;\n};\n\n/**\n * What an interface's vtable struct looks like, for the classes that adopt the interface.\n * `g_type_query` reports no size for an interface, so each slot's generated metadata carries the\n * struct's byte size to bounds-check the slot's offset; an interface introspection describes no\n * vtable for simply contributes no slots.\n */\ntype InterfaceLayout = {\n    /** The slots the struct declares, keyed by the JavaScript method name that fills each one. */\n    vfuncs?: VfuncRegistry;\n    /**\n     * The properties a vtable slot backs, keyed by canonical property name, so a class adopting the\n     * interface answers `g_object_get` and `g_object_set` with what the slot holds.\n     */\n    properties?: Record<string, InterfaceProperty>;\n};\n\nconst classRegistry: Map<bigint, AnyClass> = new Map();\nconst interfaceMixinRegistry: Map<bigint, Mixin> = new Map();\nconst composedClassRegistry: Map<bigint, AnyClass> = new Map();\nconst handleMap: WeakMap<object, ExternalObject<Handle>> = new WeakMap();\nconst vfuncRegistry: WeakMap<object, VfuncRegistry> = new WeakMap();\nconst interfaceLayoutRegistry: Map<bigint, InterfaceLayout> = new Map();\nconst wrapperClasses: WeakSet<AnyClass> = new WeakSet();\nconst derivedClasses: WeakSet<AnyClass> = new WeakSet();\n\nfunction setClassType(cls: AnyClass, type: bigint): void {\n    (cls.prototype as { [K in keyof TypedClass]: TypedClass[K] }).__type__ = type;\n}\n\n/**\n * Returns the GType a class was registered under, or the invalid type when it carries none. The tag is\n * read off the class's own prototype, so a subclass that never went through `registerClass` reports the\n * invalid type rather than inheriting the one its parent was registered with.\n */\nfunction getClassType(cls: AnyClass | undefined): bigint {\n    const proto: object | undefined = cls?.prototype;\n\n    if (proto === undefined || !Object.hasOwn(proto, \"__type__\")) {\n        return TYPE_INVALID;\n    }\n\n    return (proto as TypedClass).__type__;\n}\n\n/**\n * Returns the GType the given instance's handle carries, or the invalid type when it has no handle.\n * This is the object's own type rather than the type of the class it was wrapped as, and the two differ\n * for an object GTK created itself, such as the row widget inside a `Gtk.ListView`, which GTKX wraps as\n * the nearest registered ancestor.\n */\nfunction getInstanceType(instance: object): bigint {\n    const handle = handleMap.get(instance);\n\n    return handle === undefined ? TYPE_INVALID : getType(handle);\n}\n\nfunction registerClassType(cls: AnyClass, type: bigint): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    classRegistry.set(type, cls);\n    setClassType(cls, type);\n}\n\n/**\n * Registers a wrapper class as the JS representation of a GType, optionally\n * installing a registry of virtual functions.\n * @param cls Wrapper class to associate with the type.\n * @param type GType the class wraps.\n * @param vfuncs Vtable slots the class exposes, so `registerClass` can bind the ones a subclass\n * overrides.\n */\nfunction registerWrapperClass(cls: AnyClass, type: bigint, vfuncs?: VfuncRegistry): void {\n    registerClassType(cls, type);\n\n    if (type !== TYPE_INVALID) {\n        wrapperClasses.add(cls);\n    }\n\n    if (vfuncs) {\n        registerVfuncRegistry(cls, vfuncs);\n    }\n}\n\nfunction markDerivedClass(cls: AnyClass): void {\n    derivedClasses.add(cls);\n}\n\nfunction resolveAncestorType(ancestor: AnyClass): bigint | undefined {\n    if (derivedClasses.has(ancestor) || !wrapperClasses.has(ancestor)) {\n        return undefined;\n    }\n\n    return getClassType(ancestor);\n}\n\nfunction resolveWrapperType(instance: object): bigint {\n    const cls = instance.constructor as AnyClass | undefined;\n\n    if (cls === undefined) {\n        return TYPE_INVALID;\n    }\n\n    return walkClassChain(cls, (ancestor) => resolveAncestorType(ancestor)) ?? TYPE_INVALID;\n}\n\n/**\n * Registers a GInterface, associating its GType with a mixin used to compose the\n * interface onto wrapper classes and, when introspection describes its vtable, that layout.\n * @param cls Class carrying the interface's GType tag.\n * @param type GType of the interface.\n * @param mixin Mixin that applies the interface to a wrapper class.\n * @param layout The interface's vtable struct, so `registerClass` can bind the slots an\n * implementing class overrides and take over the ones it leaves alone.\n */\nfunction registerInterface(cls: AnyClass, type: bigint, mixin: Mixin, layout?: InterfaceLayout): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    setClassType(cls, type);\n    interfaceMixinRegistry.set(type, mixin);\n\n    if (layout) {\n        interfaceLayoutRegistry.set(type, layout);\n    }\n}\n\n/**\n * Wraps a native handle in a JS wrapper instance. With no class, resolves and\n * reuses the wrapper for the handle's runtime GType (composing interface mixins),\n * and hands back an instance that already carries a handle unchanged; with an\n * explicit class, creates a bare instance backed by the handle. Returns null for\n * a null or undefined handle.\n * @param handle Native handle to wrap.\n * @param cls Wrapper class to instantiate, or omitted to resolve it from the runtime type.\n */\nfunction wrapHandle(handle: null | undefined, cls?: AnyClass): null;\nfunction wrapHandle<T extends object>(handle: ExternalObject<Handle>, cls: AnyClass<T>): T;\n\nfunction wrapHandle<T extends object>(\n    handle: ExternalObject<Handle> | null | undefined,\n    cls: AnyClass<T>,\n): T | null;\n\nfunction wrapHandle(handle: ExternalObject<Handle>, cls?: AnyClass): TypedClass;\nfunction wrapHandle(handle: ExternalObject<Handle> | null | undefined, cls?: AnyClass): TypedClass | null;\n\nfunction wrapHandle(handle: ExternalObject<Handle> | null | undefined, cls?: AnyClass): object | null {\n    if (handle === null || handle === undefined) {\n        return null;\n    }\n\n    if (cls === undefined) {\n        return getOrCreateWrapper(handle);\n    }\n\n    const instance: object = Object.create(cls.prototype) as object;\n    setHandle(instance, handle);\n\n    return instance;\n}\n\n/**\n * Returns the wrapper class registered for a GType, walking up to ancestor types,\n * and throws if none is registered.\n */\nfunction getWrapperClass(type: bigint): AnyClass {\n    const cls = resolveWrapperClass(type);\n\n    if (!cls) {\n        throw new Error(`No registered wrapper class for type '${typeName(type) ?? String(type)}'`);\n    }\n\n    return cls;\n}\n\nfunction resolveWrapperClass(type: bigint): AnyClass | null {\n    let currentType = type;\n\n    while (currentType !== TYPE_INVALID) {\n        const cls = classRegistry.get(currentType);\n\n        if (cls) {\n            return cls;\n        }\n\n        currentType = typeParent(currentType);\n    }\n\n    return null;\n}\n\nfunction getInterfaceMixin(type: bigint): Mixin | undefined {\n    return interfaceMixinRegistry.get(type);\n}\n\nfunction applyInterfaceMixin(cls: AnyClass, type: bigint, baseType: bigint, applied: Set<bigint>): AnyClass {\n    if (applied.has(type) || typeIsA(baseType, type)) {\n        return cls;\n    }\n\n    const mixin = getInterfaceMixin(type);\n\n    if (mixin === undefined) {\n        return cls;\n    }\n\n    applied.add(type);\n\n    return mixin(cls as AnyClass<MixinReceiver>);\n}\n\nfunction createComposedClass(base: AnyClass, runtimeType: bigint): AnyClass {\n    const baseType = getClassType(base);\n    const applied: Set<bigint> = new Set();\n    let cls: AnyClass = base;\n\n    for (const type of typeInterfaces(runtimeType)) {\n        cls = applyInterfaceMixin(cls, type, baseType, applied);\n    }\n\n    return applied.size === 0 ? base : cls;\n}\n\nfunction resolveComposedClass(runtimeType: bigint): AnyClass | null {\n    const exact = classRegistry.get(runtimeType);\n\n    if (exact) {\n        return exact;\n    }\n\n    const cached = composedClassRegistry.get(runtimeType);\n\n    if (cached) {\n        return cached;\n    }\n\n    const base = resolveWrapperClass(runtimeType);\n\n    if (base === null) {\n        return null;\n    }\n\n    const composed = createComposedClass(base, runtimeType);\n\n    if (composed === base) {\n        return base;\n    }\n\n    setClassType(composed, runtimeType);\n    wrapperClasses.add(composed);\n    composedClassRegistry.set(runtimeType, composed);\n\n    return composed;\n}\n\nfunction wrapObject(value: unknown): object | null {\n    return value == null ? null : getOrCreateWrapper(value as ExternalObject<Handle>);\n}\n\nfunction wrapCallScopedObject(value: unknown): object | null {\n    return value == null ? null : wrapperFor(value as ExternalObject<Handle>, bindCallScopedWrapper);\n}\n\nfunction existingWrapperFor(handle: ExternalObject<Handle>): object | null {\n    return handleMap.has(handle) ? handle : getWrapper(handle);\n}\n\nfunction createWrapper(handle: ExternalObject<Handle>): object {\n    const runtimeType: bigint = getType(handle);\n\n    if (runtimeType === TYPE_INVALID) {\n        throw new Error(\"Cannot resolve runtime GLib type from handle\");\n    }\n\n    const cls = resolveComposedClass(runtimeType);\n\n    if (!cls) {\n        throw new Error(`Expected registered GLib type, got type ${String(runtimeType)}`);\n    }\n\n    return Object.create(cls.prototype) as object;\n}\n\nfunction wrapperFor(handle: ExternalObject<Handle>, bind: WrapperBinding): object {\n    const existing = existingWrapperFor(handle);\n\n    if (existing) {\n        return existing;\n    }\n\n    const instance = createWrapper(handle);\n    bind(handle, instance);\n\n    return instance;\n}\n\nfunction getOrCreateWrapper(handle: ExternalObject<Handle>): object {\n    return wrapperFor(handle, registerWrapper);\n}\n\nfunction instanceClassName(instance: object): string {\n    return (instance as { constructor?: { name?: string } }).constructor?.name ?? \"object\";\n}\n\n/** Returns the native handle bound to a wrapper instance, throwing if none is set. */\nfunction getHandle(instance: object): ExternalObject<Handle> {\n    const handle = handleMap.get(instance);\n\n    if (handle === undefined) {\n        throw new Error(`No native handle associated with ${instanceClassName(instance)}`);\n    }\n\n    return handle;\n}\n\n/** Associates a native handle with a wrapper instance. */\nfunction setHandle(instance: object, handle: ExternalObject<Handle>): void {\n    handleMap.set(instance, handle);\n}\n\nfunction bindCallScopedWrapper(handle: ExternalObject<Handle>, instance: object): void {\n    setHandle(instance, handle);\n}\n\nfunction registerWrapper(handle: ExternalObject<Handle>, instance: object): void {\n    setHandle(instance, handle);\n    setWrapper(handle, instance);\n}\n\nfunction registerVfuncRegistry(cls: object, registry: VfuncRegistry): void {\n    vfuncRegistry.set(cls, registry);\n}\n\nfunction getVfuncRegistry(cls: object): VfuncRegistry | undefined {\n    return vfuncRegistry.get(cls);\n}\n\nfunction getInterfaceVfuncRegistry(type: bigint): VfuncRegistry | undefined {\n    return interfaceLayoutRegistry.get(type)?.vfuncs;\n}\n\nfunction getInterfaceProperties(type: bigint): Record<string, InterfaceProperty> | undefined {\n    return interfaceLayoutRegistry.get(type)?.properties;\n}\n\nexport {\n    getClassType,\n    getInstanceType,\n    markDerivedClass,\n    registerClassType,\n    registerWrapperClass,\n    registerInterface,\n    wrapHandle,\n    getWrapperClass,\n    resolveWrapperClass,\n    getHandle,\n    setHandle,\n    getVfuncRegistry,\n    getInterfaceMixin,\n    getInterfaceProperties,\n    getInterfaceVfuncRegistry,\n    instanceClassName,\n    registerWrapper,\n    resolveWrapperType,\n    wrapCallScopedObject,\n    wrapObject,\n    type InterfaceProperty,\n    type StaticBase,\n    type VfuncDescriptor,\n};\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type ExternalObject,\n    getFundamentalWrapper,\n    getType,\n    getTypeClass,\n    getWrapper,\n    type Handle,\n    type RegisterClassVfunc as NativeRegisterClassVfunc,\n    setFundamentalWrapper,\n    setWrapper,\n} from \"@gtkx/native\";\nimport { type AnyClass, walkClassChain } from \"@gtkx/utils\";\nimport { copyLayerMembers, type Mixin, type MixinReceiver } from \"./mixin.js\";\nimport {\n    TYPE_INVALID,\n    TYPE_OBJECT,\n    type TypedClass,\n    typeInterfaces,\n    typeIsA,\n    typeName,\n    typeParent,\n} from \"./type.js\";\n\n/**\n * Static side of class `C` with its construct signature preserved but the members named `K`\n * removed. A generated class lists every static it declares itself, so a static it narrows never\n * has to stay assignable to the one it shadows. The signature is kept abstract so an abstract `C`\n * survives it: a subclass extends the result, and only the subclass's own declarations decide\n * which statics reach it.\n */\ntype StaticBase<C, K extends PropertyKey> = Omit<C, K> &\n    (C extends abstract new (...args: infer A) => infer R ? abstract new (...args: A) => R : never);\n\n/** One overridable vtable slot: where it sits in the vtable struct and how it is marshalled. */\ntype VfuncDescriptor = {\n    /** GIR name of the type struct holding the slot, without its namespace, such as `WidgetClass`. */\n    className: string;\n    /** Name of the slot's field in that struct. */\n    vfuncName: string;\n    /** Byte offset of the slot within the struct. */\n    byteOffset: number;\n    /**\n     * Byte size of an interface's vtable struct, used to bounds-check `VfuncDescriptor.byteOffset`.\n     * A class struct is bounds-checked against the size `g_type_query` reports for it, so a slot in\n     * one carries no size of its own.\n     */\n    vtableSize?: number;\n    /** Descriptor for each argument the slot receives, starting with the instance. */\n    argDescriptors: NativeRegisterClassVfunc[\"argDescriptors\"];\n    /** Descriptor for the value the slot returns. */\n    returnDescriptor: NativeRegisterClassVfunc[\"returnDescriptor\"];\n    /**\n     * GIR marks the slot's return value as one the bindings do not surface, so a call through the\n     * slot drops it and an implementation of the slot reports success in its place, while\n     * `VfuncDescriptor.returnDescriptor` keeps the C type the slot is called against either way.\n     */\n    isReturnSkipped?: boolean;\n    /**\n     * The slot takes a trailing `GError**` that `VfuncDescriptor.argDescriptors` leaves out, the\n     * way GIR leaves it out of a callable's parameters. A call through the slot has to append it\n     * or it passes one argument fewer than the implementation reads.\n     */\n    canThrow?: boolean;\n};\n\n/**\n * The vtable slots a wrapper class or interface exposes, keyed by the JavaScript method name that\n * overrides each one.\n */\ntype VfuncRegistry = Record<string, VfuncDescriptor>;\ntype WrapperBinding = (handle: ExternalObject<Handle>, instance: object) => void;\n/**\n * Picks the wrapper class for one handle of a registered type, such as a subclass keyed on a tag the\n * handle carries.\n */\ntype WrapperClassResolver = (handle: ExternalObject<Handle>) => AnyClass;\n\n/**\n * How one property an interface declares reaches the vtable, given as the interface's own accessor\n * members. A direction introspection does not route through a vtable slot is left out, and the\n * property owns that direction's state itself.\n */\ntype InterfaceProperty = {\n    /** Member reading the slot the property's value comes from, such as `getEnabled`. */\n    getter?: string;\n    /** Member writing the slot the property's value goes to, such as `setActionName`. */\n    setter?: string;\n};\n\n/**\n * What an interface's vtable struct looks like, for the classes that adopt the interface.\n * `g_type_query` reports no size for an interface, so each slot's generated metadata carries the\n * struct's byte size to bounds-check the slot's offset; an interface introspection describes no\n * vtable for simply contributes no slots.\n */\ntype InterfaceLayout = {\n    /** The slots the struct declares, keyed by the JavaScript method name that fills each one. */\n    vfuncs?: VfuncRegistry;\n    /**\n     * The properties a vtable slot backs, keyed by canonical property name, so a class adopting the\n     * interface answers `g_object_get` and `g_object_set` with what the slot holds.\n     */\n    properties?: Record<string, InterfaceProperty>;\n};\n\nconst classRegistry: Map<bigint, AnyClass> = new Map();\nconst classStructRegistry: Map<bigint, AnyClass> = new Map();\nconst composedClassStructRegistry: Map<bigint, AnyClass> = new Map();\nconst interfaceMixinRegistry: Map<bigint, Mixin> = new Map();\nconst composedClassRegistry: Map<bigint, AnyClass> = new Map();\nconst handleMap: WeakMap<object, ExternalObject<Handle>> = new WeakMap();\nconst vfuncRegistry: WeakMap<object, VfuncRegistry> = new WeakMap();\nconst interfaceLayoutRegistry: Map<bigint, InterfaceLayout> = new Map();\nconst wrapperClasses: WeakSet<AnyClass> = new WeakSet();\nconst derivedClasses: WeakSet<AnyClass> = new WeakSet();\nconst typeClassHandles: Map<bigint, ExternalObject<Handle>> = new Map();\nconst wrapperClassResolvers: WeakMap<AnyClass, WrapperClassResolver> = new WeakMap();\n\nfunction setClassType(cls: AnyClass, type: bigint): void {\n    (cls.prototype as { [K in keyof TypedClass]: TypedClass[K] }).__type__ = type;\n}\n\n/**\n * Returns the GType a class was registered under, or the invalid type when it carries none. The tag is\n * read off the class's own prototype, so a subclass that never went through `registerClass` reports the\n * invalid type rather than inheriting the one its parent was registered with.\n */\nfunction getClassType(cls: AnyClass | undefined): bigint {\n    const proto: object | undefined = cls?.prototype;\n\n    if (proto === undefined || !Object.hasOwn(proto, \"__type__\")) {\n        return TYPE_INVALID;\n    }\n\n    return (proto as TypedClass).__type__;\n}\n\n/**\n * Returns the GType the given instance's handle carries, or the invalid type when it has no handle.\n * This is the object's own type rather than the type of the class it was wrapped as, and the two differ\n * for an object GTK created itself, such as the row widget inside a `Gtk.ListView`, which GTKX wraps as\n * the nearest registered ancestor.\n */\nfunction getInstanceType(instance: object): bigint {\n    const handle = handleMap.get(instance);\n\n    return handle === undefined ? TYPE_INVALID : getType(handle);\n}\n\nfunction coerceGType(value: unknown): unknown {\n    if (typeof value !== \"function\") {\n        return value;\n    }\n\n    const type = getClassType(value as AnyClass);\n\n    return type === TYPE_INVALID ? value : type;\n}\n\nfunction registerClassType(cls: AnyClass, type: bigint): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    classRegistry.set(type, cls);\n    setClassType(cls, type);\n}\n\n/**\n * Registers a wrapper class as the JS representation of a GType, optionally\n * installing a registry of virtual functions.\n * @param cls Wrapper class to associate with the type.\n * @param type GType the class wraps.\n * @param vfuncs Vtable slots the class exposes, so `registerClass` can bind the ones a subclass\n * overrides.\n */\nfunction registerWrapperClass(cls: AnyClass, type: bigint, vfuncs?: VfuncRegistry): void {\n    registerClassType(cls, type);\n\n    if (type !== TYPE_INVALID) {\n        wrapperClasses.add(cls);\n    }\n\n    if (vfuncs) {\n        registerVfuncRegistry(cls, vfuncs);\n    }\n}\n\n/**\n * Lets a class registered with `registerWrapperClass` pick a subclass for each handle it wraps, for\n * types whose one GType covers several C-level subtypes, the way a cairo surface reports image or\n * recording through `cairo_surface_get_type`. The resolver runs when a handle is wrapped as that class\n * explicitly, the way a boxed value a binding hands back is; a wrapper resolved from a handle's runtime\n * GType never consults it, and a subclass passed to `wrapHandle` directly is used as given.\n * @param cls Registered wrapper class whose handles the resolver classifies.\n * @param resolver Returns the class to instantiate for one handle, `cls` itself included.\n * @throws If `cls` is not a registered wrapper class.\n */\nfunction registerWrapperClassResolver(cls: AnyClass, resolver: WrapperClassResolver): void {\n    if (!wrapperClasses.has(cls)) {\n        throw new Error(\n            `Cannot register a wrapper class resolver for ${cls.name}: ` +\n            \"register the class with registerWrapperClass first\",\n        );\n    }\n\n    wrapperClassResolvers.set(cls, resolver);\n}\n\nfunction markDerivedClass(cls: AnyClass): void {\n    derivedClasses.add(cls);\n}\n\n/**\n * Registers the wrapper class of a type's class struct, such as `Gtk.WidgetClass` for `Gtk.Widget`,\n * so `registerClass` can hand a `classInit` hook the new type's class struct wrapped in it.\n * @param cls Wrapper class of the type's instances, already registered through\n * `registerWrapperClass`.\n * @param structClass Wrapper class of the type's class struct.\n */\nfunction registerClassStruct(cls: AnyClass, structClass: AnyClass): void {\n    const type = getClassType(cls);\n\n    if (type !== TYPE_INVALID) {\n        classStructRegistry.set(type, structClass);\n    }\n}\n\nfunction collectClassStructClasses(type: bigint): AnyClass[] {\n    const structs: AnyClass[] = [];\n    let current = type;\n\n    while (current !== TYPE_INVALID) {\n        const structClass = classStructRegistry.get(current);\n\n        if (structClass !== undefined) {\n            structs.push(structClass);\n        }\n\n        current = typeParent(current);\n    }\n\n    return structs;\n}\n\nfunction composeClassStructClass(structs: AnyClass[]): AnyClass | undefined {\n    const [nearest, ...ancestors] = structs;\n\n    if (nearest === undefined || ancestors.length === 0) {\n        return nearest;\n    }\n\n    const composed: AnyClass = class extends nearest {};\n    Object.defineProperty(composed, \"name\", { value: nearest.name });\n\n    for (const structClass of ancestors) {\n        copyLayerMembers(composed, structClass.prototype);\n    }\n\n    return composed;\n}\n\nfunction getClassStructClass(type: bigint): AnyClass | undefined {\n    const cached = composedClassStructRegistry.get(type);\n\n    if (cached !== undefined) {\n        return cached;\n    }\n\n    const composed = composeClassStructClass(collectClassStructClasses(type));\n\n    if (composed !== undefined) {\n        composedClassStructRegistry.set(type, composed);\n    }\n\n    return composed;\n}\n\nfunction peekedTypeLabel(type: bigint | AnyClass, gtype: bigint): string {\n    const name = typeName(gtype);\n\n    if (name !== null) {\n        return name;\n    }\n\n    return typeof type === \"bigint\" ? String(type) : type.name;\n}\n\nfunction getTypeClassHandle(gtype: bigint): ExternalObject<Handle> {\n    const cached = typeClassHandles.get(gtype);\n\n    if (cached !== undefined) {\n        return cached;\n    }\n\n    const handle = getTypeClass(gtype);\n    typeClassHandles.set(gtype, handle);\n\n    return handle;\n}\n\n/**\n * Returns a GObject type's class struct, wrapped in the class-struct wrapper classes registered\n * for the type's ancestry, such as `Gtk.WidgetClass` composed with `GObject.ObjectClass` for a\n * widget type. The class is referenced so it exists even before the type's first instance, and\n * the reference is deliberately never released: once created, a class struct lives for the rest\n * of the process. Backs the `peek` statics of generated GTypeStruct wrappers, such as\n * `GObject.ObjectClass.peek` and `Gtk.WidgetClass.peek`.\n *\n * @param type GType to peek the class struct of, or a registered wrapper class of the type.\n * @param base When given, wrapper class of the type the peeked type must derive from; the peek\n * throws for a type outside that lineage. Without it any GObject type is accepted.\n * @returns The wrapped class struct.\n */\nfunction peekTypeClass(type: bigint | AnyClass, base?: AnyClass): object {\n    const gtype = typeof type === \"bigint\" ? type : getClassType(type);\n\n    if (!typeIsA(gtype, TYPE_OBJECT)) {\n        throw new TypeError(`peekTypeClass: '${peekedTypeLabel(type, gtype)}' is not a GObject type`);\n    }\n\n    if (base !== undefined && !typeIsA(gtype, getClassType(base))) {\n        throw new TypeError(`peekTypeClass: '${peekedTypeLabel(type, gtype)}' does not derive from '${base.name}'`);\n    }\n\n    const structClass = getClassStructClass(gtype);\n\n    if (structClass === undefined) {\n        throw new TypeError(\n            `peekTypeClass: no ancestor of '${peekedTypeLabel(type, gtype)}' registers a class struct wrapper`,\n        );\n    }\n\n    return wrapHandle(getTypeClassHandle(gtype), structClass);\n}\n\nfunction resolveAncestorType(ancestor: AnyClass): bigint | undefined {\n    if (derivedClasses.has(ancestor) || !wrapperClasses.has(ancestor)) {\n        return undefined;\n    }\n\n    return getClassType(ancestor);\n}\n\nfunction resolveWrapperType(instance: object): bigint {\n    const cls = instance.constructor as AnyClass | undefined;\n\n    if (cls === undefined) {\n        return TYPE_INVALID;\n    }\n\n    return walkClassChain(cls, (ancestor) => resolveAncestorType(ancestor)) ?? TYPE_INVALID;\n}\n\n/**\n * Registers a GInterface, associating its GType with a mixin used to compose the\n * interface onto wrapper classes and, when introspection describes its vtable, that layout.\n * @param cls Class carrying the interface's GType tag.\n * @param type GType of the interface.\n * @param mixin Mixin that applies the interface to a wrapper class.\n * @param layout The interface's vtable struct, so `registerClass` can bind the slots an\n * implementing class overrides and take over the ones it leaves alone.\n */\nfunction registerInterface(cls: AnyClass, type: bigint, mixin: Mixin, layout?: InterfaceLayout): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    setClassType(cls, type);\n    interfaceMixinRegistry.set(type, mixin);\n\n    if (layout) {\n        interfaceLayoutRegistry.set(type, layout);\n    }\n}\n\n/**\n * Wraps a native handle in a JS wrapper instance. With no class, resolves and\n * reuses the wrapper for the handle's runtime GType (composing interface mixins),\n * and hands back an instance that already carries a handle unchanged; with an\n * explicit class, creates a bare instance backed by the handle, of the subclass the\n * class's `registerWrapperClassResolver` resolver picks when it has one. Returns null\n * for a null or undefined handle.\n * @param handle Native handle to wrap.\n * @param cls Wrapper class to instantiate, or omitted to resolve it from the runtime type.\n */\nfunction wrapHandle(handle: null | undefined, cls?: AnyClass): null;\nfunction wrapHandle<T extends object>(handle: ExternalObject<Handle>, cls: AnyClass<T>): T;\n\nfunction wrapHandle<T extends object>(\n    handle: ExternalObject<Handle> | null | undefined,\n    cls: AnyClass<T>,\n): T | null;\n\nfunction wrapHandle(handle: ExternalObject<Handle>, cls?: AnyClass): TypedClass;\nfunction wrapHandle(handle: ExternalObject<Handle> | null | undefined, cls?: AnyClass): TypedClass | null;\n\nfunction wrapHandle(handle: ExternalObject<Handle> | null | undefined, cls?: AnyClass): object | null {\n    if (handle === null || handle === undefined) {\n        return null;\n    }\n\n    if (cls === undefined) {\n        return getOrCreateWrapper(handle);\n    }\n\n    const resolver = wrapperClassResolvers.get(cls);\n    const instance: object = Object.create((resolver === undefined ? cls : resolver(handle)).prototype) as object;\n    setHandle(instance, handle);\n\n    return instance;\n}\n\nfunction wrapFundamentalHandle(handle: ExternalObject<Handle> | null | undefined, cls: AnyClass): object | null {\n    if (handle === null || handle === undefined) {\n        return null;\n    }\n\n    const existing = getFundamentalWrapper(handle);\n\n    if (existing) {\n        return existing;\n    }\n\n    const instance: object = Object.create(cls.prototype) as object;\n    setHandle(instance, handle);\n    setFundamentalWrapper(handle, instance);\n\n    return instance;\n}\n\n/**\n * Returns the wrapper class registered for a GType, walking up to ancestor types,\n * and throws if none is registered.\n */\nfunction getWrapperClass(type: bigint): AnyClass {\n    const cls = resolveWrapperClass(type);\n\n    if (!cls) {\n        throw new Error(`No registered wrapper class for type '${typeName(type) ?? String(type)}'`);\n    }\n\n    return cls;\n}\n\nfunction resolveWrapperClass(type: bigint): AnyClass | null {\n    let currentType = type;\n\n    while (currentType !== TYPE_INVALID) {\n        const cls = classRegistry.get(currentType);\n\n        if (cls) {\n            return cls;\n        }\n\n        currentType = typeParent(currentType);\n    }\n\n    return null;\n}\n\nfunction getInterfaceMixin(type: bigint): Mixin | undefined {\n    return interfaceMixinRegistry.get(type);\n}\n\nfunction applyInterfaceMixin(cls: AnyClass, type: bigint, baseType: bigint, applied: Set<bigint>): AnyClass {\n    if (applied.has(type) || typeIsA(baseType, type)) {\n        return cls;\n    }\n\n    const mixin = getInterfaceMixin(type);\n\n    if (mixin === undefined) {\n        return cls;\n    }\n\n    applied.add(type);\n\n    return mixin(cls as AnyClass<MixinReceiver>);\n}\n\nfunction createComposedClass(base: AnyClass, runtimeType: bigint): AnyClass {\n    const baseType = getClassType(base);\n    const applied: Set<bigint> = new Set();\n    let cls: AnyClass = base;\n\n    for (const type of typeInterfaces(runtimeType)) {\n        cls = applyInterfaceMixin(cls, type, baseType, applied);\n    }\n\n    return applied.size === 0 ? base : cls;\n}\n\nfunction resolveComposedClass(runtimeType: bigint): AnyClass | null {\n    const exact = classRegistry.get(runtimeType);\n\n    if (exact) {\n        return exact;\n    }\n\n    const cached = composedClassRegistry.get(runtimeType);\n\n    if (cached) {\n        return cached;\n    }\n\n    const base = resolveWrapperClass(runtimeType);\n\n    if (base === null) {\n        return null;\n    }\n\n    const composed = createComposedClass(base, runtimeType);\n\n    if (composed === base) {\n        return base;\n    }\n\n    setClassType(composed, runtimeType);\n    wrapperClasses.add(composed);\n    composedClassRegistry.set(runtimeType, composed);\n\n    return composed;\n}\n\nfunction wrapObject(value: unknown): object | null {\n    return value == null ? null : getOrCreateWrapper(value as ExternalObject<Handle>);\n}\n\nfunction wrapCallScopedObject(value: unknown): object | null {\n    return value == null ? null : wrapperFor(value as ExternalObject<Handle>, bindCallScopedWrapper);\n}\n\nfunction existingWrapperFor(handle: ExternalObject<Handle>): object | null {\n    return handleMap.has(handle) ? handle : getWrapper(handle);\n}\n\nfunction createWrapper(handle: ExternalObject<Handle>): object {\n    const runtimeType: bigint = getType(handle);\n\n    if (runtimeType === TYPE_INVALID) {\n        throw new Error(\"Cannot resolve runtime GLib type from handle\");\n    }\n\n    const cls = resolveComposedClass(runtimeType);\n\n    if (!cls) {\n        throw new Error(`Expected registered GLib type, got type ${String(runtimeType)}`);\n    }\n\n    return Object.create(cls.prototype) as object;\n}\n\nfunction wrapperFor(handle: ExternalObject<Handle>, bind: WrapperBinding): object {\n    const existing = existingWrapperFor(handle);\n\n    if (existing) {\n        return existing;\n    }\n\n    const instance = createWrapper(handle);\n    bind(handle, instance);\n\n    return instance;\n}\n\nfunction getOrCreateWrapper(handle: ExternalObject<Handle>): object {\n    return wrapperFor(handle, registerWrapper);\n}\n\nfunction instanceClassName(instance: object): string {\n    return (instance as { constructor?: { name?: string } }).constructor?.name ?? \"object\";\n}\n\nfunction describeValueKind(value: unknown): string {\n    if (value === null) {\n        return \"null\";\n    }\n\n    if (typeof value !== \"object\") {\n        return typeof value;\n    }\n\n    return instanceClassName(value);\n}\n\n/** Returns the native handle bound to a wrapper instance, throwing if none is set. */\nfunction getHandle(instance: object): ExternalObject<Handle> {\n    const handle = handleMap.get(instance);\n\n    if (handle === undefined) {\n        throw new Error(`No native handle associated with ${instanceClassName(instance)}`);\n    }\n\n    return handle;\n}\n\n/** Associates a native handle with a wrapper instance. */\nfunction setHandle(instance: object, handle: ExternalObject<Handle>): void {\n    handleMap.set(instance, handle);\n}\n\nfunction bindCallScopedWrapper(handle: ExternalObject<Handle>, instance: object): void {\n    setHandle(instance, handle);\n}\n\nfunction registerWrapper(handle: ExternalObject<Handle>, instance: object): void {\n    setHandle(instance, handle);\n    setWrapper(handle, instance);\n}\n\nfunction registerVfuncRegistry(cls: object, registry: VfuncRegistry): void {\n    vfuncRegistry.set(cls, registry);\n}\n\nfunction getVfuncRegistry(cls: object): VfuncRegistry | undefined {\n    return vfuncRegistry.get(cls);\n}\n\nfunction getInterfaceVfuncRegistry(type: bigint): VfuncRegistry | undefined {\n    return interfaceLayoutRegistry.get(type)?.vfuncs;\n}\n\nfunction getInterfaceProperties(type: bigint): Record<string, InterfaceProperty> | undefined {\n    return interfaceLayoutRegistry.get(type)?.properties;\n}\n\nexport {\n    coerceGType,\n    describeValueKind,\n    getClassStructClass,\n    getClassType,\n    getInstanceType,\n    getTypeClassHandle,\n    markDerivedClass,\n    peekTypeClass,\n    registerClassStruct,\n    registerClassType,\n    registerWrapperClass,\n    registerWrapperClassResolver,\n    registerInterface,\n    wrapFundamentalHandle,\n    wrapHandle,\n    getWrapperClass,\n    resolveWrapperClass,\n    getHandle,\n    setHandle,\n    getVfuncRegistry,\n    getInterfaceMixin,\n    getInterfaceProperties,\n    getInterfaceVfuncRegistry,\n    instanceClassName,\n    registerWrapper,\n    resolveWrapperType,\n    wrapCallScopedObject,\n    wrapObject,\n    type InterfaceProperty,\n    type StaticBase,\n    type VfuncDescriptor,\n    type WrapperClassResolver,\n};\n"]}

package/dist/signal.d.ts

@@ -3,6 +3,10 @@ import { type Arg } from "./arg.js";
 import { type CallbackDescriptor } from "./descriptors.js";
 /** Function invoked when a connected GObject signal is emitted. */
 type SignalHandler = (...args: unknown[]) => unknown;
+type DeclaredSignalTypes = {
+    paramTypes: bigint[];
+    returnType?: bigint;
+};
 /** The marshalling and handler that make up a single signal connection. */
 type SignalConnectSpec = {
     /**
@@ -34,6 +38,9 @@ declare const untrackConnection: (instance: object, handlerId: number) => void;
  */
 declare const disconnectSignal: (instance: object, handlerId: number) => void;
 declare function hasSignalListener(instance: object, signals?: string[]): boolean;
+declare const signalIdFor: (type: bigint, signal: string) => number;
+/** The signal a generated `on…` handler prop names on the given type, or `undefined` when it carries none. */
+declare const signalForHandlerName: (type: bigint, handlerName: string) => string | undefined;
 /**
  * Connects a handler to a GObject signal on an instance and returns the handler id.
  * @param instance Emitter to connect to.
@@ -41,6 +48,9 @@ declare function hasSignalListener(instance: object, signals?: string[]): boolea
  * @param spec Callback descriptor, handler function, and whether to run after the default handler.
  */
 declare function connectSignal(instance: object, signal: string, spec: SignalConnectSpec): number;
+declare function overrideSignalClassClosure(type: bigint, signalId: number, handler: SignalHandler): void;
+declare function connectClosureSignal(instance: object, signal: string, handler: SignalHandler, isAfter: boolean): number;
+declare function emitDeclaredSignal(instance: object, signal: string, types: DeclaredSignalTypes, args: unknown[]): unknown;
 /**
  * Emits a signal on an instance with the given arguments and returns its result
  * combined with any output-argument values.
@@ -50,5 +60,5 @@ declare function connectSignal(instance: object, signal: string, spec: SignalCon
  * @param returns Descriptor for the signal's return value, omitted when it returns void.
  */
 declare function emitSignal(instance: object, signal: string, args: EmitArg[], returns?: Descriptor): unknown;
-export { getSignalBaseName, connectSignal, disconnectSignal, emitSignal, hasSignalListener, isSignalHandlerConnected, untrackConnection, type SignalHandler, };
+export { signalForHandlerName, getSignalBaseName, signalIdFor, connectClosureSignal, connectSignal, type DeclaredSignalTypes, disconnectSignal, emitDeclaredSignal, emitSignal, hasSignalListener, isSignalHandlerConnected, overrideSignalClassClosure, untrackConnection, type SignalHandler, };
 //# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,KAAK,GAAG,EAAiD,MAAM,UAAU,CAAC;AAGnF,OAAO,EAIH,KAAK,kBAAkB,EAM1B,MAAM,kBAAkB,CAAC;AAc1B,mEAAmE;AACnE,KAAK,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAErD,2EAA2E;AAC3E,KAAK,iBAAiB,GAAG;IACrB;;;OAGG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,4FAA4F;IAC5F,OAAO,EAAE,aAAa,CAAC;IACvB,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAOF,uFAAuF;AACvF,KAAK,OAAO,GAAG,GAAG,GAAG;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAuBF,+EAA+E;AAC/E,QAAA,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAI3C,CAAC;AAYF,QAAA,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,OACA,CAAC;AAoBzE,QAAA,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,IAchE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,IAG/D,CAAC;AAgBF,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAexE;AAoBD;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CASxF;AAqCD;;;;;;;GAOG;AACH,iBAAS,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAepG;AAED,OAAO,EACH,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,aAAa,GACrB,CAAC"}
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,KAAK,GAAG,EAAiD,MAAM,UAAU,CAAC;AAInF,OAAO,EAKH,KAAK,kBAAkB,EAQ1B,MAAM,kBAAkB,CAAC;AAiB1B,mEAAmE;AACnE,KAAK,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAErD,KAAK,mBAAmB,GAAG;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,2EAA2E;AAC3E,KAAK,iBAAiB,GAAG;IACrB;;;OAGG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,4FAA4F;IAC5F,OAAO,EAAE,aAAa,CAAC;IACvB,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAOF,uFAAuF;AACvF,KAAK,OAAO,GAAG,GAAG,GAAG;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAyCF,+EAA+E;AAC/E,QAAA,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAI3C,CAAC;AAYF,QAAA,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,OACA,CAAC;AAoBzE,QAAA,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,IAchE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,IAG/D,CAAC;AAgBF,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAexE;AAED,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MACQ,CAAC;AAgB7D,8GAA8G;AAC9G,QAAA,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MAAM,GAAG,SACM,CAAC;AAiClF;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CASxF;AAED,iBAAS,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhG;AAED,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAMhH;AAED,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CA6BlH;AAqCD;;;;;;;GAOG;AACH,iBAAS,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAepG;AAED,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,aAAa,GACrB,CAAC"}

package/dist/signal.js

@@ -1,18 +1,27 @@
+import { getOrInsert, toCamelIdentifier, upperFirst } from "@gtkx/utils";
 import { isCallerAllocatedArg, isInoutArg, isOutputArg } from "./arg.js";
 import { bind, createBindCache } from "./bind.js";
 import { wrapCallback } from "./callback.js";
-import { arrayT, biguint64T, booleanT, objectT, stringT, uint32T, uint64T, voidT, } from "./descriptors.js";
+import { toClosure } from "./closure.js";
+import { arrayT, biguint64T, booleanT, boxedT, objectT, refT, sizedArrayT, stringT, uint32T, uint64T, voidT, } from "./descriptors.js";
 import { LIB, VALUE_SIZE, VALUE_T } from "./library.js";
 import { getHandle } from "./registry.js";
 import { packTupleResult } from "./tuple.js";
-import { fromValue, getBoxedValue, inoutValueForBoxedDescriptor, newValueForDescriptor, outValueForBoxedDescriptor, outValueForDescriptor, toValue, } from "./value.js";
+import { TYPE_INVALID, typeInterfaces, typeParent } from "./type.js";
+import { fromValue, getBoxedValue, inoutValueForBoxedDescriptor, intoValue, newValueForDescriptor, newValueForType, outValueForBoxedDescriptor, outValueForDescriptor, toValue, } from "./value.js";
 const connectCache = createBindCache();
 const connectionTable = new WeakMap();
 const gQuarkFromString = bind(LIB, "g_quark_from_string", [stringT("borrowed")], uint32T);
 const gSignalLookup = bind(LIB, "g_signal_lookup", [stringT("borrowed"), biguint64T], uint32T);
+const gSignalName = bind(LIB, "g_signal_name", [uint32T], stringT("borrowed"));
+const signalNameCache = new Map();
+const gSignalListIds = bind(LIB, "g_signal_list_ids", [biguint64T, refT(uint32T)], sizedArrayT(uint32T, 1, "full"));
 const gSignalEmitv = bind(LIB, "g_signal_emitv", [arrayT(VALUE_T, "array", "borrowed", { elementSize: VALUE_SIZE }), uint32T, uint32T, VALUE_T], voidT);
 const gSignalHandlerIsConnected = bind(LIB, "g_signal_handler_is_connected", [objectT("borrowed"), uint64T], booleanT);
 const gSignalHandlerDisconnect = bind(LIB, "g_signal_handler_disconnect", [objectT("borrowed"), uint64T], voidT);
+const CLOSURE_T = boxedT("GClosure", { sharedLibrary: LIB, getTypeFnName: "g_closure_get_type" });
+const gSignalConnectClosure = bind(LIB, "g_signal_connect_closure", [objectT("borrowed"), stringT("borrowed"), CLOSURE_T, booleanT], uint64T);
+const gSignalOverrideClassClosure = bind(LIB, "g_signal_override_class_closure", [uint32T, biguint64T, CLOSURE_T], voidT);
 /** Returns the signal name without its detail suffix (the part after `::`). */
 const getSignalBaseName = (signal) => {
     const detailIndex = signal.indexOf("::");
@@ -83,10 +92,31 @@ function hasSignalListener(instance, signals) {
         return handlerIds !== undefined && hasLiveConnection(instance, handlerIds);
     });
 }
-const getSignalId = (instance, signal) => {
-    const type = instance.__type__;
-    return gSignalLookup(getSignalBaseName(signal), type);
+const signalIdFor = (type, signal) => gSignalLookup(getSignalBaseName(signal), type);
+const ownSignalNames = (type) => {
+    const countRef = { value: 0 };
+    return gSignalListIds(type, countRef).map((id) => gSignalName(id));
+};
+const addSignalNames = (names, type) => {
+    for (const name of ownSignalNames(type)) {
+        names.add(name);
+    }
 };
+const handlerNameFor = (signal) => `on${upperFirst(toCamelIdentifier(signal))}`;
+/** The signal a generated `on…` handler prop names on the given type, or `undefined` when it carries none. */
+const signalForHandlerName = (type, handlerName) => signalNamesFor(type).find((signal) => handlerNameFor(signal) === handlerName);
+const buildSignalNames = (type) => {
+    const names = new Set();
+    for (let current = type; current !== TYPE_INVALID; current = typeParent(current)) {
+        addSignalNames(names, current);
+        for (const iface of typeInterfaces(current)) {
+            addSignalNames(names, iface);
+        }
+    }
+    return [...names];
+};
+const signalNamesFor = (type) => getOrInsert(signalNameCache, type, buildSignalNames);
+const getSignalId = (instance, signal) => signalIdFor(instance.__type__, signal);
 function connectBind(type, signal, callback) {
     const key = `${String(type)}\0${getSignalBaseName(signal)}`;
     return connectCache(key, LIB, "g_signal_connect_data", [objectT("borrowed"), stringT("borrowed"), callback, uint32T], uint64T);
@@ -106,6 +136,36 @@ function connectSignal(instance, signal, spec) {
     trackConnection(instance, getSignalBaseName(signal), handlerId);
     return handlerId;
 }
+function overrideSignalClassClosure(type, signalId, handler) {
+    gSignalOverrideClassClosure(signalId, type, toClosure(handler));
+}
+function connectClosureSignal(instance, signal, handler, isAfter) {
+    const closure = toClosure((...args) => Reflect.apply(handler, null, args.slice(1)));
+    const handlerId = gSignalConnectClosure(getHandle(instance), signal, closure, isAfter);
+    trackConnection(instance, getSignalBaseName(signal), handlerId);
+    return handlerId;
+}
+function emitDeclaredSignal(instance, signal, types, args) {
+    const { paramTypes, returnType } = types;
+    if (args.length !== paramTypes.length) {
+        throw new TypeError(`emit: signal '${signal}' takes ${String(paramTypes.length)} arguments, got ${String(args.length)}`);
+    }
+    const signalId = getSignalId(instance, signal);
+    const detail = getSignalDetailQuark(signal);
+    const values = [toValue(objectT("full"), instance)];
+    for (const [index, paramType] of paramTypes.entries()) {
+        const value = newValueForType(paramType);
+        intoValue(value, args[index]);
+        values.push(value);
+    }
+    if (returnType === undefined) {
+        gSignalEmitv(values, signalId, detail, undefined);
+        return undefined;
+    }
+    const returnValue = newValueForType(returnType);
+    gSignalEmitv(values, signalId, detail, returnValue);
+    return fromValue(returnValue);
+}
 const createEmitValue = (arg) => {
     if (!isOutputArg(arg)) {
         return { value: toValue(arg.type, arg.value) };
@@ -151,5 +211,5 @@ function emitSignal(instance, signal, args, returns) {
     gSignalEmitv(values, signalId, detail, returnValue);
     return packTupleResult(readEmitOutputs(reads), fromValue(returnValue), true);
 }
-export { getSignalBaseName, connectSignal, disconnectSignal, emitSignal, hasSignalListener, isSignalHandlerConnected, untrackConnection, };
+export { signalForHandlerName, getSignalBaseName, signalIdFor, connectClosureSignal, connectSignal, disconnectSignal, emitDeclaredSignal, emitSignal, hasSignalListener, isSignalHandlerConnected, overrideSignalClassClosure, untrackConnection, };
 //# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Descriptor, ExternalObject, Handle } from \"@gtkx/native\";\nimport type { TypedClass } from \"./type.js\";\nimport { type Arg, isCallerAllocatedArg, isInoutArg, isOutputArg } from \"./arg.js\";\nimport { bind, createBindCache } from \"./bind.js\";\nimport { wrapCallback } from \"./callback.js\";\nimport {\n    arrayT,\n    biguint64T,\n    booleanT,\n    type CallbackDescriptor,\n    objectT,\n    stringT,\n    uint32T,\n    uint64T,\n    voidT,\n} from \"./descriptors.js\";\nimport { LIB, VALUE_SIZE, VALUE_T } from \"./library.js\";\nimport { getHandle } from \"./registry.js\";\nimport { packTupleResult } from \"./tuple.js\";\nimport {\n    fromValue,\n    getBoxedValue,\n    inoutValueForBoxedDescriptor,\n    newValueForDescriptor,\n    outValueForBoxedDescriptor,\n    outValueForDescriptor,\n    toValue,\n} from \"./value.js\";\n\n/** Function invoked when a connected GObject signal is emitted. */\ntype SignalHandler = (...args: unknown[]) => unknown;\n\n/** The marshalling and handler that make up a single signal connection. */\ntype SignalConnectSpec = {\n    /**\n     * Marshalling for the emission, whose `argDescriptors` lead with the emitter and include the\n     * closure's user data slot.\n     */\n    callback: CallbackDescriptor;\n    /** Called on each emission with the signal's own arguments, without the leading emitter. */\n    handler: SignalHandler;\n    /** When true, run the handler after the class's default handler instead of before it. */\n    isAfter: boolean;\n};\n\ntype EmitValues = {\n    values: ExternalObject<Handle>[];\n    reads: (() => unknown)[];\n};\n\n/** One argument of a signal emission: how to marshal it, plus the value to marshal. */\ntype EmitArg = Arg & {\n    /**\n     * The value to pass for an input or inout argument, or the caller-allocated storage to fill for\n     * a caller-allocated output argument; omitted for a plain output argument.\n     */\n    value?: unknown;\n};\n\nconst connectCache = createBindCache();\nconst connectionTable: WeakMap<object, Map<string, Set<number>>> = new WeakMap();\nconst gQuarkFromString = bind(LIB, \"g_quark_from_string\", [stringT(\"borrowed\")], uint32T);\nconst gSignalLookup = bind(LIB, \"g_signal_lookup\", [stringT(\"borrowed\"), biguint64T], uint32T);\n\nconst gSignalEmitv = bind(\n    LIB,\n    \"g_signal_emitv\",\n    [arrayT(VALUE_T, \"array\", \"borrowed\", { elementSize: VALUE_SIZE }), uint32T, uint32T, VALUE_T],\n    voidT,\n);\n\nconst gSignalHandlerIsConnected = bind(\n    LIB,\n    \"g_signal_handler_is_connected\",\n    [objectT(\"borrowed\"), uint64T],\n    booleanT,\n);\n\nconst gSignalHandlerDisconnect = bind(LIB, \"g_signal_handler_disconnect\", [objectT(\"borrowed\"), uint64T], voidT);\n\n/** Returns the signal name without its detail suffix (the part after `::`). */\nconst getSignalBaseName = (signal: string): string => {\n    const detailIndex = signal.indexOf(\"::\");\n\n    return detailIndex === -1 ? signal : signal.slice(0, detailIndex);\n};\n\nfunction getSignalDetailQuark(signal: string): number {\n    const detailIndex = signal.indexOf(\"::\");\n\n    if (detailIndex === -1) {\n        return 0;\n    }\n\n    return gQuarkFromString(signal.slice(detailIndex + 2)) as number;\n}\n\nconst isSignalHandlerConnected = (instance: object, handlerId: number): boolean =>\n    gSignalHandlerIsConnected(getHandle(instance), handlerId) as boolean;\n\nconst trackConnection = (instance: object, signal: string, handlerId: number): void => {\n    let bySignal = connectionTable.get(instance);\n\n    if (!bySignal) {\n        bySignal = new Map();\n        connectionTable.set(instance, bySignal);\n    }\n\n    let handlerIds = bySignal.get(signal);\n\n    if (!handlerIds) {\n        handlerIds = new Set();\n        bySignal.set(signal, handlerIds);\n    }\n\n    handlerIds.add(handlerId);\n};\n\nconst untrackConnection = (instance: object, handlerId: number): void => {\n    const bySignal = connectionTable.get(instance);\n\n    if (bySignal === undefined) {\n        return;\n    }\n\n    for (const [name, handlerIds] of bySignal) {\n        handlerIds.delete(handlerId);\n\n        if (handlerIds.size === 0) {\n            bySignal.delete(name);\n        }\n    }\n};\n\n/**\n * Disconnects the handler an instance connected under the given id, and forgets the connection.\n * @param instance Emitter the handler was connected to.\n * @param handlerId Id {@link connectSignal} returned for the handler.\n */\nconst disconnectSignal = (instance: object, handlerId: number): void => {\n    untrackConnection(instance, handlerId);\n    gSignalHandlerDisconnect(getHandle(instance), handlerId);\n};\n\nconst hasLiveConnection = (instance: object, handlerIds: Set<number>): boolean => {\n    let isLive = false;\n\n    for (const handlerId of handlerIds) {\n        if (isSignalHandlerConnected(instance, handlerId)) {\n            isLive = true;\n        } else {\n            handlerIds.delete(handlerId);\n        }\n    }\n\n    return isLive;\n};\n\nfunction hasSignalListener(instance: object, signals?: string[]): boolean {\n    const bySignal = connectionTable.get(instance);\n\n    if (!bySignal) {\n        return false;\n    }\n\n    const names =\n        signals === undefined ? bySignal.keys().toArray() : signals.map((signal) => getSignalBaseName(signal));\n\n    return names.some((name) => {\n        const handlerIds = bySignal.get(name);\n\n        return handlerIds !== undefined && hasLiveConnection(instance, handlerIds);\n    });\n}\n\nconst getSignalId = (instance: object, signal: string): number => {\n    const type: bigint = (instance as TypedClass).__type__;\n\n    return gSignalLookup(getSignalBaseName(signal), type) as number;\n};\n\nfunction connectBind(type: bigint, signal: string, callback: CallbackDescriptor): (...values: unknown[]) => unknown {\n    const key = `${String(type)}\\0${getSignalBaseName(signal)}`;\n\n    return connectCache(\n        key,\n        LIB,\n        \"g_signal_connect_data\",\n        [objectT(\"borrowed\"), stringT(\"borrowed\"), callback, uint32T],\n        uint64T,\n    );\n}\n\n/**\n * Connects a handler to a GObject signal on an instance and returns the handler id.\n * @param instance Emitter to connect to.\n * @param signal Signal name, optionally including a `::detail` suffix.\n * @param spec Callback descriptor, handler function, and whether to run after the default handler.\n */\nfunction connectSignal(instance: object, signal: string, spec: SignalConnectSpec): number {\n    const { callback, handler, isAfter } = spec;\n    const wrapped = wrapCallback(handler, callback, \"signal\");\n    const type: bigint = (instance as TypedClass).__type__;\n    const connect = connectBind(type, signal, callback);\n    const handlerId = connect(getHandle(instance), signal, wrapped, isAfter ? 1 : 0) as number;\n    trackConnection(instance, getSignalBaseName(signal), handlerId);\n\n    return handlerId;\n}\n\nconst createEmitValue = (arg: EmitArg): { value: ExternalObject<Handle>; read?: () => unknown } => {\n    if (!isOutputArg(arg)) {\n        return { value: toValue(arg.type, arg.value) };\n    }\n\n    if (isCallerAllocatedArg(arg)) {\n        if (isInoutArg(arg)) {\n            return { value: inoutValueForBoxedDescriptor(arg.type, arg.value as object) };\n        }\n\n        const value = outValueForBoxedDescriptor(arg.type, arg.value as object);\n\n        return { value, read: () => getBoxedValue(value) };\n    }\n\n    return isInoutArg(arg) ? outValueForDescriptor(arg.type, arg.value) : outValueForDescriptor(arg.type);\n};\n\nconst collectEmitValues = (instance: object, args: EmitArg[]): EmitValues => {\n    const collected: EmitValues = { values: [toValue(objectT(\"full\"), instance)], reads: [] };\n\n    for (const arg of args) {\n        const { value, read } = createEmitValue(arg);\n        collected.values.push(value);\n\n        if (read) {\n            collected.reads.push(read);\n        }\n    }\n\n    return collected;\n};\n\nconst readEmitOutputs = (reads: (() => unknown)[]): unknown[] => reads.map((read) => read());\n\n/**\n * Emits a signal on an instance with the given arguments and returns its result\n * combined with any output-argument values.\n * @param instance Emitter to emit the signal on.\n * @param signal Signal name, optionally including a `::detail` suffix.\n * @param args Arguments to pass, including output and inout arguments.\n * @param returns Descriptor for the signal's return value, omitted when it returns void.\n */\nfunction emitSignal(instance: object, signal: string, args: EmitArg[], returns?: Descriptor): unknown {\n    const signalId = getSignalId(instance, signal);\n    const detail = getSignalDetailQuark(signal);\n    const { values, reads } = collectEmitValues(instance, args);\n\n    if (returns === undefined) {\n        gSignalEmitv(values, signalId, detail, undefined);\n\n        return packTupleResult(readEmitOutputs(reads), undefined, false);\n    }\n\n    const returnValue = newValueForDescriptor(returns);\n    gSignalEmitv(values, signalId, detail, returnValue);\n\n    return packTupleResult(readEmitOutputs(reads), fromValue(returnValue), true);\n}\n\nexport {\n    getSignalBaseName,\n    connectSignal,\n    disconnectSignal,\n    emitSignal,\n    hasSignalListener,\n    isSignalHandlerConnected,\n    untrackConnection,\n    type SignalHandler,\n};\n"]}
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Descriptor, ExternalObject, Handle } from \"@gtkx/native\";\nimport { getOrInsert, toCamelIdentifier, upperFirst } from \"@gtkx/utils\";\nimport { type Arg, isCallerAllocatedArg, isInoutArg, isOutputArg } from \"./arg.js\";\nimport { bind, createBindCache } from \"./bind.js\";\nimport { wrapCallback } from \"./callback.js\";\nimport { toClosure } from \"./closure.js\";\nimport {\n    arrayT,\n    biguint64T,\n    booleanT,\n    boxedT,\n    type CallbackDescriptor,\n    objectT,\n    refT,\n    sizedArrayT,\n    stringT,\n    uint32T,\n    uint64T,\n    voidT,\n} from \"./descriptors.js\";\nimport { LIB, VALUE_SIZE, VALUE_T } from \"./library.js\";\nimport { getHandle } from \"./registry.js\";\nimport { packTupleResult } from \"./tuple.js\";\nimport { TYPE_INVALID, type TypedClass, typeInterfaces, typeParent } from \"./type.js\";\nimport {\n    fromValue,\n    getBoxedValue,\n    inoutValueForBoxedDescriptor,\n    intoValue,\n    newValueForDescriptor,\n    newValueForType,\n    outValueForBoxedDescriptor,\n    outValueForDescriptor,\n    toValue,\n} from \"./value.js\";\n\n/** Function invoked when a connected GObject signal is emitted. */\ntype SignalHandler = (...args: unknown[]) => unknown;\n\ntype DeclaredSignalTypes = {\n    paramTypes: bigint[];\n    returnType?: bigint;\n};\n\n/** The marshalling and handler that make up a single signal connection. */\ntype SignalConnectSpec = {\n    /**\n     * Marshalling for the emission, whose `argDescriptors` lead with the emitter and include the\n     * closure's user data slot.\n     */\n    callback: CallbackDescriptor;\n    /** Called on each emission with the signal's own arguments, without the leading emitter. */\n    handler: SignalHandler;\n    /** When true, run the handler after the class's default handler instead of before it. */\n    isAfter: boolean;\n};\n\ntype EmitValues = {\n    values: ExternalObject<Handle>[];\n    reads: (() => unknown)[];\n};\n\n/** One argument of a signal emission: how to marshal it, plus the value to marshal. */\ntype EmitArg = Arg & {\n    /**\n     * The value to pass for an input or inout argument, or the caller-allocated storage to fill for\n     * a caller-allocated output argument; omitted for a plain output argument.\n     */\n    value?: unknown;\n};\n\nconst connectCache = createBindCache();\nconst connectionTable: WeakMap<object, Map<string, Set<number>>> = new WeakMap();\nconst gQuarkFromString = bind(LIB, \"g_quark_from_string\", [stringT(\"borrowed\")], uint32T);\nconst gSignalLookup = bind(LIB, \"g_signal_lookup\", [stringT(\"borrowed\"), biguint64T], uint32T);\nconst gSignalName = bind(LIB, \"g_signal_name\", [uint32T], stringT(\"borrowed\"));\nconst signalNameCache: Map<bigint, string[]> = new Map();\nconst gSignalListIds = bind(LIB, \"g_signal_list_ids\", [biguint64T, refT(uint32T)], sizedArrayT(uint32T, 1, \"full\"));\n\nconst gSignalEmitv = bind(\n    LIB,\n    \"g_signal_emitv\",\n    [arrayT(VALUE_T, \"array\", \"borrowed\", { elementSize: VALUE_SIZE }), uint32T, uint32T, VALUE_T],\n    voidT,\n);\n\nconst gSignalHandlerIsConnected = bind(\n    LIB,\n    \"g_signal_handler_is_connected\",\n    [objectT(\"borrowed\"), uint64T],\n    booleanT,\n);\n\nconst gSignalHandlerDisconnect = bind(LIB, \"g_signal_handler_disconnect\", [objectT(\"borrowed\"), uint64T], voidT);\nconst CLOSURE_T = boxedT(\"GClosure\", { sharedLibrary: LIB, getTypeFnName: \"g_closure_get_type\" });\n\nconst gSignalConnectClosure = bind(\n    LIB,\n    \"g_signal_connect_closure\",\n    [objectT(\"borrowed\"), stringT(\"borrowed\"), CLOSURE_T, booleanT],\n    uint64T,\n);\n\nconst gSignalOverrideClassClosure = bind(\n    LIB,\n    \"g_signal_override_class_closure\",\n    [uint32T, biguint64T, CLOSURE_T],\n    voidT,\n);\n\n/** Returns the signal name without its detail suffix (the part after `::`). */\nconst getSignalBaseName = (signal: string): string => {\n    const detailIndex = signal.indexOf(\"::\");\n\n    return detailIndex === -1 ? signal : signal.slice(0, detailIndex);\n};\n\nfunction getSignalDetailQuark(signal: string): number {\n    const detailIndex = signal.indexOf(\"::\");\n\n    if (detailIndex === -1) {\n        return 0;\n    }\n\n    return gQuarkFromString(signal.slice(detailIndex + 2)) as number;\n}\n\nconst isSignalHandlerConnected = (instance: object, handlerId: number): boolean =>\n    gSignalHandlerIsConnected(getHandle(instance), handlerId) as boolean;\n\nconst trackConnection = (instance: object, signal: string, handlerId: number): void => {\n    let bySignal = connectionTable.get(instance);\n\n    if (!bySignal) {\n        bySignal = new Map();\n        connectionTable.set(instance, bySignal);\n    }\n\n    let handlerIds = bySignal.get(signal);\n\n    if (!handlerIds) {\n        handlerIds = new Set();\n        bySignal.set(signal, handlerIds);\n    }\n\n    handlerIds.add(handlerId);\n};\n\nconst untrackConnection = (instance: object, handlerId: number): void => {\n    const bySignal = connectionTable.get(instance);\n\n    if (bySignal === undefined) {\n        return;\n    }\n\n    for (const [name, handlerIds] of bySignal) {\n        handlerIds.delete(handlerId);\n\n        if (handlerIds.size === 0) {\n            bySignal.delete(name);\n        }\n    }\n};\n\n/**\n * Disconnects the handler an instance connected under the given id, and forgets the connection.\n * @param instance Emitter the handler was connected to.\n * @param handlerId Id {@link connectSignal} returned for the handler.\n */\nconst disconnectSignal = (instance: object, handlerId: number): void => {\n    untrackConnection(instance, handlerId);\n    gSignalHandlerDisconnect(getHandle(instance), handlerId);\n};\n\nconst hasLiveConnection = (instance: object, handlerIds: Set<number>): boolean => {\n    let isLive = false;\n\n    for (const handlerId of handlerIds) {\n        if (isSignalHandlerConnected(instance, handlerId)) {\n            isLive = true;\n        } else {\n            handlerIds.delete(handlerId);\n        }\n    }\n\n    return isLive;\n};\n\nfunction hasSignalListener(instance: object, signals?: string[]): boolean {\n    const bySignal = connectionTable.get(instance);\n\n    if (!bySignal) {\n        return false;\n    }\n\n    const names =\n        signals === undefined ? bySignal.keys().toArray() : signals.map((signal) => getSignalBaseName(signal));\n\n    return names.some((name) => {\n        const handlerIds = bySignal.get(name);\n\n        return handlerIds !== undefined && hasLiveConnection(instance, handlerIds);\n    });\n}\n\nconst signalIdFor = (type: bigint, signal: string): number =>\n    gSignalLookup(getSignalBaseName(signal), type) as number;\n\nconst ownSignalNames = (type: bigint): string[] => {\n    const countRef = { value: 0 };\n\n    return (gSignalListIds(type, countRef) as number[]).map((id) => gSignalName(id) as string);\n};\n\nconst addSignalNames = (names: Set<string>, type: bigint): void => {\n    for (const name of ownSignalNames(type)) {\n        names.add(name);\n    }\n};\n\nconst handlerNameFor = (signal: string): string => `on${upperFirst(toCamelIdentifier(signal))}`;\n\n/** The signal a generated `on…` handler prop names on the given type, or `undefined` when it carries none. */\nconst signalForHandlerName = (type: bigint, handlerName: string): string | undefined =>\n    signalNamesFor(type).find((signal) => handlerNameFor(signal) === handlerName);\n\nconst buildSignalNames = (type: bigint): string[] => {\n    const names: Set<string> = new Set();\n\n    for (let current = type; current !== TYPE_INVALID; current = typeParent(current)) {\n        addSignalNames(names, current);\n\n        for (const iface of typeInterfaces(current)) {\n            addSignalNames(names, iface);\n        }\n    }\n\n    return [...names];\n};\n\nconst signalNamesFor = (type: bigint): string[] => getOrInsert(signalNameCache, type, buildSignalNames);\n\nconst getSignalId = (instance: object, signal: string): number =>\n    signalIdFor((instance as TypedClass).__type__, signal);\n\nfunction connectBind(type: bigint, signal: string, callback: CallbackDescriptor): (...values: unknown[]) => unknown {\n    const key = `${String(type)}\\0${getSignalBaseName(signal)}`;\n\n    return connectCache(\n        key,\n        LIB,\n        \"g_signal_connect_data\",\n        [objectT(\"borrowed\"), stringT(\"borrowed\"), callback, uint32T],\n        uint64T,\n    );\n}\n\n/**\n * Connects a handler to a GObject signal on an instance and returns the handler id.\n * @param instance Emitter to connect to.\n * @param signal Signal name, optionally including a `::detail` suffix.\n * @param spec Callback descriptor, handler function, and whether to run after the default handler.\n */\nfunction connectSignal(instance: object, signal: string, spec: SignalConnectSpec): number {\n    const { callback, handler, isAfter } = spec;\n    const wrapped = wrapCallback(handler, callback, \"signal\");\n    const type: bigint = (instance as TypedClass).__type__;\n    const connect = connectBind(type, signal, callback);\n    const handlerId = connect(getHandle(instance), signal, wrapped, isAfter ? 1 : 0) as number;\n    trackConnection(instance, getSignalBaseName(signal), handlerId);\n\n    return handlerId;\n}\n\nfunction overrideSignalClassClosure(type: bigint, signalId: number, handler: SignalHandler): void {\n    gSignalOverrideClassClosure(signalId, type, toClosure(handler));\n}\n\nfunction connectClosureSignal(instance: object, signal: string, handler: SignalHandler, isAfter: boolean): number {\n    const closure = toClosure((...args: unknown[]) => Reflect.apply(handler, null, args.slice(1)));\n    const handlerId = gSignalConnectClosure(getHandle(instance), signal, closure, isAfter) as number;\n    trackConnection(instance, getSignalBaseName(signal), handlerId);\n\n    return handlerId;\n}\n\nfunction emitDeclaredSignal(instance: object, signal: string, types: DeclaredSignalTypes, args: unknown[]): unknown {\n    const { paramTypes, returnType } = types;\n\n    if (args.length !== paramTypes.length) {\n        throw new TypeError(\n            `emit: signal '${signal}' takes ${String(paramTypes.length)} arguments, got ${String(args.length)}`,\n        );\n    }\n\n    const signalId = getSignalId(instance, signal);\n    const detail = getSignalDetailQuark(signal);\n    const values = [toValue(objectT(\"full\"), instance)];\n\n    for (const [index, paramType] of paramTypes.entries()) {\n        const value = newValueForType(paramType);\n        intoValue(value, args[index]);\n        values.push(value);\n    }\n\n    if (returnType === undefined) {\n        gSignalEmitv(values, signalId, detail, undefined);\n\n        return undefined;\n    }\n\n    const returnValue = newValueForType(returnType);\n    gSignalEmitv(values, signalId, detail, returnValue);\n\n    return fromValue(returnValue);\n}\n\nconst createEmitValue = (arg: EmitArg): { value: ExternalObject<Handle>; read?: () => unknown } => {\n    if (!isOutputArg(arg)) {\n        return { value: toValue(arg.type, arg.value) };\n    }\n\n    if (isCallerAllocatedArg(arg)) {\n        if (isInoutArg(arg)) {\n            return { value: inoutValueForBoxedDescriptor(arg.type, arg.value as object) };\n        }\n\n        const value = outValueForBoxedDescriptor(arg.type, arg.value as object);\n\n        return { value, read: () => getBoxedValue(value) };\n    }\n\n    return isInoutArg(arg) ? outValueForDescriptor(arg.type, arg.value) : outValueForDescriptor(arg.type);\n};\n\nconst collectEmitValues = (instance: object, args: EmitArg[]): EmitValues => {\n    const collected: EmitValues = { values: [toValue(objectT(\"full\"), instance)], reads: [] };\n\n    for (const arg of args) {\n        const { value, read } = createEmitValue(arg);\n        collected.values.push(value);\n\n        if (read) {\n            collected.reads.push(read);\n        }\n    }\n\n    return collected;\n};\n\nconst readEmitOutputs = (reads: (() => unknown)[]): unknown[] => reads.map((read) => read());\n\n/**\n * Emits a signal on an instance with the given arguments and returns its result\n * combined with any output-argument values.\n * @param instance Emitter to emit the signal on.\n * @param signal Signal name, optionally including a `::detail` suffix.\n * @param args Arguments to pass, including output and inout arguments.\n * @param returns Descriptor for the signal's return value, omitted when it returns void.\n */\nfunction emitSignal(instance: object, signal: string, args: EmitArg[], returns?: Descriptor): unknown {\n    const signalId = getSignalId(instance, signal);\n    const detail = getSignalDetailQuark(signal);\n    const { values, reads } = collectEmitValues(instance, args);\n\n    if (returns === undefined) {\n        gSignalEmitv(values, signalId, detail, undefined);\n\n        return packTupleResult(readEmitOutputs(reads), undefined, false);\n    }\n\n    const returnValue = newValueForDescriptor(returns);\n    gSignalEmitv(values, signalId, detail, returnValue);\n\n    return packTupleResult(readEmitOutputs(reads), fromValue(returnValue), true);\n}\n\nexport {\n    signalForHandlerName,\n    getSignalBaseName,\n    signalIdFor,\n    connectClosureSignal,\n    connectSignal,\n    type DeclaredSignalTypes,\n    disconnectSignal,\n    emitDeclaredSignal,\n    emitSignal,\n    hasSignalListener,\n    isSignalHandlerConnected,\n    overrideSignalClassClosure,\n    untrackConnection,\n    type SignalHandler,\n};\n"]}

package/dist/t.d.ts

@@ -1,5 +1,6 @@
 import { bind } from "./bind.js";
 import * as helpers from "./descriptors.js";
+import { field, fieldAt } from "./field.js";
 import { fn } from "./fn.js";
 /** The descriptor factories and function binders exposed as {@link t}. */
 type T = {
@@ -85,6 +86,16 @@ type T = {
      * arguments into the result.
      */
     fn: typeof fn;
+    /**
+     * Binds a struct field at a fixed offset, compiling its descriptor once into an accessor that
+     * reads and writes it.
+     */
+    field: typeof field;
+    /**
+     * Binds a struct field whose offset is supplied per access, for walking records stored at a
+     * stride in a buffer.
+     */
+    fieldAt: typeof fieldAt;
 };
 /**
  * Type descriptor builder: a collection of factory helpers that describe C types for

package/dist/t.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"t.d.ts","sourceRoot":"","sources":["../src/t.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"t.d.ts","sourceRoot":"","sources":["../src/t.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,0EAA0E;AAC1E,KAAK,CAAC,GAAG;IACL,qGAAqG;IACrG,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,yDAAyD;IACzD,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,yDAAyD;IACzD,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,yDAAyD;IACzD,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,kGAAkG;IAClG,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,mGAAmG;IACnG,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,2FAA2F;IAC3F,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC,4FAA4F;IAC5F,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,uGAAuG;IACvG,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,iCAAiC;IACjC,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,kCAAkC;IAClC,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,uEAAuE;IACvE,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,iGAAiG;IACjG,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,kGAAkG;IAClG,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,4GAA4G;IAC5G,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B;;;OAGG;IACH,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,kGAAkG;IAClG,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,kEAAkE;IAClE,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,gDAAgD;IAChD,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,6GAA6G;IAC7G,WAAW,EAAE,OAAO,OAAO,CAAC,YAAY,CAAC;IACzC,8EAA8E;IAC9E,GAAG,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IACzB,yFAAyF;IACzF,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,sGAAsG;IACtG,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,oGAAoG;IACpG,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,kDAAkD;IAClD,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,mDAAmD;IACnD,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC,mDAAmD;IACnD,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,qFAAqF;IACrF,UAAU,EAAE,OAAO,OAAO,CAAC,WAAW,CAAC;IACvC,2DAA2D;IAC3D,UAAU,EAAE,OAAO,OAAO,CAAC,WAAW,CAAC;IACvC,wFAAwF;IACxF,WAAW,EAAE,OAAO,OAAO,CAAC,YAAY,CAAC;IACzC,2GAA2G;IAC3G,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC;;;OAGG;IACH,EAAE,EAAE,OAAO,EAAE,CAAC;IACd;;;OAGG;IACH,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,OAAO,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,CAAC,EAAE,CAyCR,CAAC;AAEF,OAAO,EAAE,CAAC,EAAE,CAAC"}