@gtkx/runtime 0.0.1 → 1.0.0-rc.2

package/dist/register-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-class.js","sourceRoot":"","sources":["../src/register-class.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Descriptor } from \"@gtkx/native\";\nimport {\n    registerClass as nativeRegisterClass,\n    type RegisterClassOptions as NativeRegisterClassOptions,\n    type RegisterClassVfunc as NativeRegisterClassVfunc,\n} from \"@gtkx/native\";\nimport { type AnyClass, getParentClass, walkClassChain } from \"@gtkx/utils\";\nimport { wrapCallback } from \"./callback.js\";\nimport {\n    buildAccessors,\n    makeGetProperty,\n    makeSetProperty,\n    type PropertyAccessor,\n    type PropertySpec,\n    toNativeProperties,\n} from \"./properties.js\";\nimport {\n    getClassType,\n    getInterfaceVfuncRegistry,\n    getVfuncRegistry,\n    registerClassType,\n    type VfuncDescriptor,\n} from \"./registry.js\";\nimport { TYPE_INVALID, typeInterfaces } from \"./type.js\";\n\ntype RegisterClassOptions = {\n    typeName?: string;\n    /**\n     * Properties to install on the new type, keyed by canonical property name. Each value is the\n     * `GObject.ParamSpec` describing it, for example `GObject.paramSpecString(...)`. Accessors are\n     * generated on the prototype for the dashed, underscored and camelCased spellings of the name\n     * unless the class already defines one, and writing through them emits `notify`.\n     */\n    properties?: Record<string, PropertySpec>;\n};\n\ntype VfuncFn = NativeRegisterClassVfunc[\"fn\"];\ntype DiscoveredVfunc<K extends \"class\" | \"interface\"> = VfuncDescriptor<K> & { methodName: string; fn: VfuncFn };\ntype DiscoveredClassVfunc = DiscoveredVfunc<\"class\">;\ntype DiscoveredInterfaceVfunc = DiscoveredVfunc<\"interface\">;\ntype InterfaceVfuncBinding = { gtype: bigint; vtableSize: number; vfuncs: DiscoveredInterfaceVfunc[] };\n\nconst UNSUPPORTED_CONSTRUCT_VFUNCS: Set<string> = new Set([\"constructed\", \"setProperty\", \"getProperty\"]);\nconst VALUE_ARG_INDEX = 2;\n\n/**\n * Registers a subclass of a wrapper class as a new GType, wiring up any class and\n * inherited-interface virtual functions it overrides. Throws if the class does not\n * extend a registered wrapper class, has no derivable type name, or overrides an\n * unsupported construct-time vtable slot.\n *\n * @param klass The subclass to register.\n * @param options Registration options, such as an explicit type name.\n * @returns The same class, now registered.\n */\nfunction registerClass<T extends AnyClass>(klass: T, options: RegisterClassOptions = {}): T {\n    const parentType = resolveParentType(klass);\n\n    if (parentType === TYPE_INVALID) {\n        throw new TypeError(`registerClass: ${klass.name} must extend a registered wrapper class`);\n    }\n\n    const name = options.typeName ?? klass.name;\n\n    if (!name) {\n        throw new Error(\"registerClass: cannot derive a GType name (anonymous class with no typeName option)\");\n    }\n\n    const properties = options.properties ?? {};\n    const accessors = buildAccessors(klass, properties);\n    const classVfuncs = [...discoverClassVfuncs(klass), ...propertyVfuncs(klass, accessors)];\n    const claimedMethodNames = new Set(classVfuncs.map((vfunc) => vfunc.methodName));\n    const interfaceBindings = discoverInheritedInterfaceVfuncs(klass, parentType, claimedMethodNames);\n    const nativeOptions = toNativeOptions(classVfuncs, interfaceBindings, properties);\n    const newType: bigint = nativeRegisterClass(name, parentType, nativeOptions);\n    registerClassType(klass, newType);\n\n    return klass;\n}\n\nfunction resolveParentType(klass: AnyClass): bigint {\n    return (\n        walkClassChain(getParentClass(klass), (cls) => {\n            const gtype = getClassType(cls);\n\n            return gtype === TYPE_INVALID ? undefined : gtype;\n        }) ?? TYPE_INVALID\n    );\n}\n\nfunction ownInstanceMethodNames(klass: AnyClass): string[] {\n    const proto = (klass as { prototype?: object }).prototype;\n\n    if (!proto) {\n        return [];\n    }\n\n    return Object.getOwnPropertyNames(proto).filter((name) => {\n        if (name === \"constructor\") {\n            return false;\n        }\n\n        return typeof Object.getOwnPropertyDescriptor(proto, name)?.value === \"function\";\n    });\n}\n\nfunction buildDiscoveredVfunc<K extends \"class\" | \"interface\">(\n    proto: Record<string, VfuncFn>,\n    methodName: string,\n    resolveDescriptor: (methodName: string) => VfuncDescriptor<K> | undefined,\n    skip: Set<string> | undefined,\n): DiscoveredVfunc<K> | undefined {\n    if (skip?.has(methodName)) {\n        return undefined;\n    }\n\n    const descriptor = resolveDescriptor(methodName);\n\n    if (!descriptor) {\n        return undefined;\n    }\n\n    const fn = proto[methodName];\n\n    if (!fn) {\n        return undefined;\n    }\n\n    return {\n        ...descriptor,\n        methodName,\n        fn: wrapVfunc(fn, descriptor.argDescriptors, descriptor.returnDescriptor),\n    };\n}\n\nfunction collectDiscoveredVfuncs<K extends \"class\" | \"interface\">(\n    klass: AnyClass,\n    resolveDescriptor: (methodName: string) => VfuncDescriptor<K> | undefined,\n    skip?: Set<string>,\n): DiscoveredVfunc<K>[] {\n    const proto = (klass as { prototype: Record<string, VfuncFn> }).prototype;\n    const result: DiscoveredVfunc<K>[] = [];\n\n    for (const methodName of ownInstanceMethodNames(klass)) {\n        const discovered = buildDiscoveredVfunc(proto, methodName, resolveDescriptor, skip);\n\n        if (discovered) {\n            result.push(discovered);\n        }\n    }\n\n    return result;\n}\n\nfunction discoverClassVfuncs(klass: AnyClass): DiscoveredClassVfunc[] {\n    return collectDiscoveredVfuncs(klass, (methodName) => {\n        const descriptor = findClassVfuncDescriptor(klass, methodName);\n\n        if (descriptor && UNSUPPORTED_CONSTRUCT_VFUNCS.has(methodName)) {\n            throw new Error(\n                `registerClass: overriding the GObject construct-time vtable slot '${methodName}' is not ` +\n                \"supported; run construct-time initialization in the subclass constructor, after \" +\n                \"super(...), instead\",\n            );\n        }\n\n        return descriptor ?? undefined;\n    });\n}\n\nfunction wrapVfunc(\n    fn: VfuncFn,\n    argDescriptors: NativeRegisterClassVfunc[\"argDescriptors\"],\n    returnDescriptor: NativeRegisterClassVfunc[\"returnDescriptor\"],\n): VfuncFn {\n    return wrapCallback(fn as (...args: unknown[]) => unknown, { argDescriptors, returnDescriptor }, \"this\");\n}\n\nfunction discoverInheritedInterfaceVfuncs(\n    klass: AnyClass,\n    parentGtype: bigint,\n    claimedMethodNames: Set<string>,\n): InterfaceVfuncBinding[] {\n    const bindings: InterfaceVfuncBinding[] = [];\n\n    for (const interfaceGtype of typeInterfaces(parentGtype)) {\n        const [first, ...rest] = discoverInterfaceVfuncs(klass, interfaceGtype, claimedMethodNames);\n\n        if (first !== undefined) {\n            bindings.push({ gtype: interfaceGtype, vtableSize: first.vtableSize, vfuncs: [first, ...rest] });\n        }\n    }\n\n    return bindings;\n}\n\nfunction discoverInterfaceVfuncs(\n    klass: AnyClass,\n    interfaceGtype: bigint,\n    claimedMethodNames: Set<string>,\n): DiscoveredInterfaceVfunc[] {\n    const vfuncRegistry = getInterfaceVfuncRegistry(interfaceGtype);\n\n    if (!vfuncRegistry) {\n        return [];\n    }\n\n    return collectDiscoveredVfuncs(\n        klass,\n        (methodName) => {\n            const entry = vfuncRegistry[methodName];\n\n            return entry?.kind === \"interface\" ? entry : undefined;\n        },\n        claimedMethodNames,\n    );\n}\n\nfunction findClassVfuncDescriptor(klass: AnyClass, methodName: string): VfuncDescriptor<\"class\"> | null {\n    return (\n        walkClassChain(getParentClass(klass), (cls) => {\n            const entry = getVfuncRegistry(cls)?.[methodName];\n\n            return entry?.kind === \"class\" ? entry : undefined;\n        }) ?? null\n    );\n}\n\nfunction propertyVfuncs(klass: AnyClass, accessors: PropertyAccessor[]): DiscoveredClassVfunc[] {\n    if (accessors.length === 0) {\n        return [];\n    }\n\n    return [\n        buildPropertyVfunc(klass, \"getProperty\", makeGetProperty(accessors), true),\n        buildPropertyVfunc(klass, \"setProperty\", makeSetProperty(accessors), false),\n    ];\n}\n\n// `get_property` fills a GValue the caller owns, so the marshalled copy handed to JavaScript has to\n// be written back into it; `set_property` only reads its GValue and needs no copy back.\nfunction markValueCallerAllocated(argDescriptors: Descriptor[]): Descriptor[] {\n    return argDescriptors.map((arg, index) =>\n        index === VALUE_ARG_INDEX ? { ...arg, callerAllocated: true } : arg);\n}\n\nfunction buildPropertyVfunc(\n    klass: AnyClass,\n    methodName: string,\n    fn: VfuncFn,\n    isValueOut: boolean,\n): DiscoveredClassVfunc {\n    const descriptor = findClassVfuncDescriptor(klass, methodName);\n\n    if (!descriptor) {\n        throw new Error(`registerClass: the parent class exposes no '${methodName}' vtable slot`);\n    }\n\n    const argDescriptors = isValueOut\n        ? markValueCallerAllocated(descriptor.argDescriptors)\n        : descriptor.argDescriptors;\n\n    return {\n        ...descriptor,\n        methodName,\n        argDescriptors,\n        fn: wrapVfunc(fn, argDescriptors, descriptor.returnDescriptor),\n    };\n}\n\nfunction toNativeOptions(\n    classVfuncs: DiscoveredClassVfunc[],\n    interfaceBindings: InterfaceVfuncBinding[],\n    properties: Record<string, PropertySpec>,\n): NativeRegisterClassOptions | undefined {\n    const hasInterfaces = interfaceBindings.length > 0;\n    const hasClassVfuncs = classVfuncs.length > 0;\n    const hasProperties = Object.keys(properties).length > 0;\n\n    if (!hasClassVfuncs && !hasInterfaces && !hasProperties) {\n        return undefined;\n    }\n\n    const options: NativeRegisterClassOptions = {};\n\n    if (hasProperties) {\n        options.properties = toNativeProperties(properties);\n    }\n\n    if (hasClassVfuncs) {\n        options.vfuncs = [...classVfuncs];\n    }\n\n    if (hasInterfaces) {\n        options.interfaces = interfaceBindings.map((binding) => ({\n            type: binding.gtype,\n            vtableSize: binding.vtableSize,\n            vfuncs: [...binding.vfuncs],\n        }));\n    }\n\n    return options;\n}\n\nexport { registerClass };\n"]}

package/dist/registry.d.ts

@@ -0,0 +1,69 @@
+import type { AnyClass } from "@gtkx/utils";
+import { type ExternalObject, type Handle, type RegisterClassVfunc as NativeRegisterClassVfunc } from "@gtkx/native";
+import type { Mixin } from "./mixin.js";
+import { type TypedClass } from "./type.js";
+/**
+ * Static side of class `C` with its construct signature preserved but the member
+ * named `K` (default `"new"`) removed.
+ */
+type StaticBase<C, K extends PropertyKey = "new"> = Omit<C, K> & (C extends new (...args: infer A) => infer R ? new (...args: A) => R : never);
+type VfuncDescriptor<K extends "class" | "interface"> = {
+    kind: K;
+    className: string;
+    vfuncName: string;
+    byteOffset: number;
+    vtableSize: number;
+    argDescriptors: NativeRegisterClassVfunc["argDescriptors"];
+    returnDescriptor: NativeRegisterClassVfunc["returnDescriptor"];
+};
+type VfuncRegistry = Record<string, VfuncDescriptor<"class"> | VfuncDescriptor<"interface">>;
+declare function getClassType(cls: AnyClass): bigint;
+/** Returns the GType tag of the given wrapper instance. */
+declare function getInstanceType(instance: object): bigint;
+declare function registerClassType(cls: AnyClass, type: bigint): void;
+/**
+ * Registers a wrapper class as the JS representation of a GType, optionally
+ * installing a registry of virtual functions.
+ * @param cls Wrapper class to associate with the type.
+ * @param type GType the class wraps.
+ * @param vfuncs Virtual functions the class overrides.
+ */
+declare function registerWrapperClass(cls: AnyClass, type: bigint, vfuncs?: VfuncRegistry): void;
+/**
+ * Registers a GInterface, associating its GType with a mixin used to compose the
+ * interface onto wrapper classes and an optional virtual function registry.
+ * @param cls Class carrying the interface's GType tag.
+ * @param type GType of the interface.
+ * @param mixin Mixin that applies the interface to a wrapper class.
+ * @param vfuncs Virtual functions the interface exposes.
+ */
+declare function registerInterface(cls: AnyClass, type: bigint, mixin: Mixin, vfuncs?: VfuncRegistry): void;
+/**
+ * Wraps a native handle in a JS wrapper instance. With no class, resolves and
+ * reuses the wrapper for the handle's runtime GType (composing interface mixins);
+ * with an explicit class, creates a bare instance backed by the handle. Returns
+ * null for a null or undefined handle.
+ * @param handle Native handle to wrap.
+ * @param cls Wrapper class to instantiate, or omitted to resolve it from the runtime type.
+ */
+declare function wrapHandle(handle: null | undefined, cls?: AnyClass): null;
+declare function wrapHandle<T extends object>(handle: ExternalObject<Handle>, cls: AnyClass<T>): T;
+declare function wrapHandle<T extends object>(handle: ExternalObject<Handle> | null | undefined, cls: AnyClass<T>): T | null;
+declare function wrapHandle(handle: ExternalObject<Handle>, cls?: AnyClass): TypedClass;
+declare function wrapHandle(handle: ExternalObject<Handle> | null | undefined, cls?: AnyClass): TypedClass | null;
+/**
+ * Returns the wrapper class registered for a GType, walking up to ancestor types,
+ * and throws if none is registered.
+ */
+declare function getWrapperClass(type: bigint): AnyClass;
+declare function resolveWrapperClass(type: bigint): AnyClass | null;
+/** Returns the native handle bound to a wrapper instance, throwing if none is set. */
+declare function getHandle(instance: object): ExternalObject<Handle>;
+/** Returns the native handle bound to an instance, or undefined when there is none or the instance is null. */
+declare function tryGetHandle(instance: object | null | undefined): ExternalObject<Handle> | undefined;
+/** Associates a native handle with a wrapper instance. */
+declare function setHandle(instance: object, handle: ExternalObject<Handle>): void;
+declare function getVfuncRegistry(cls: object): VfuncRegistry | undefined;
+declare function getInterfaceVfuncRegistry(type: bigint): VfuncRegistry | undefined;
+export { getClassType, getInstanceType, registerClassType, registerWrapperClass, registerInterface, wrapHandle, getWrapperClass, resolveWrapperClass, getHandle, tryGetHandle, setHandle, getVfuncRegistry, getInterfaceVfuncRegistry, type StaticBase, type VfuncDescriptor, type VfuncRegistry, };
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/registry.js

@@ -0,0 +1,186 @@
+import { getType, getWrapper, setWrapper, } from "@gtkx/native";
+import { TYPE_INVALID, typeInterfaces, typeIsA, typeName, typeParent } from "./type.js";
+const classRegistry = new Map();
+const interfaceMixinRegistry = new Map();
+const composedClassRegistry = new Map();
+const handleMap = new WeakMap();
+const vfuncRegistry = new WeakMap();
+const interfaceVfuncRegistry = new Map();
+function setClassType(cls, type) {
+    cls.prototype.__type__ = type;
+}
+function getClassType(cls) {
+    const proto = cls.prototype;
+    return Object.hasOwn(proto, "__type__") ? proto.__type__ : TYPE_INVALID;
+}
+/** Returns the GType tag of the given wrapper instance. */
+function getInstanceType(instance) {
+    return getClassType(instance.constructor);
+}
+function registerClassType(cls, type) {
+    if (type === TYPE_INVALID) {
+        return;
+    }
+    classRegistry.set(type, cls);
+    setClassType(cls, type);
+}
+/**
+ * Registers a wrapper class as the JS representation of a GType, optionally
+ * installing a registry of virtual functions.
+ * @param cls Wrapper class to associate with the type.
+ * @param type GType the class wraps.
+ * @param vfuncs Virtual functions the class overrides.
+ */
+function registerWrapperClass(cls, type, vfuncs) {
+    registerClassType(cls, type);
+    if (vfuncs) {
+        registerVfuncRegistry(cls, vfuncs);
+    }
+}
+/**
+ * Registers a GInterface, associating its GType with a mixin used to compose the
+ * interface onto wrapper classes and an optional virtual function registry.
+ * @param cls Class carrying the interface's GType tag.
+ * @param type GType of the interface.
+ * @param mixin Mixin that applies the interface to a wrapper class.
+ * @param vfuncs Virtual functions the interface exposes.
+ */
+function registerInterface(cls, type, mixin, vfuncs) {
+    if (type === TYPE_INVALID) {
+        return;
+    }
+    setClassType(cls, type);
+    interfaceMixinRegistry.set(type, mixin);
+    if (vfuncs) {
+        registerInterfaceVfuncRegistry(type, vfuncs);
+    }
+}
+function wrapHandle(handle, cls) {
+    if (handle === null || handle === undefined) {
+        return null;
+    }
+    if (cls === undefined) {
+        return getOrCreateWrapper(handle);
+    }
+    const instance = Object.create(cls.prototype);
+    setHandle(instance, handle);
+    return instance;
+}
+/**
+ * Returns the wrapper class registered for a GType, walking up to ancestor types,
+ * and throws if none is registered.
+ */
+function getWrapperClass(type) {
+    const cls = resolveWrapperClass(type);
+    if (!cls) {
+        throw new Error(`No registered wrapper class for type '${typeName(type) ?? String(type)}'`);
+    }
+    return cls;
+}
+function resolveWrapperClass(type) {
+    let currentType = type;
+    while (currentType !== TYPE_INVALID) {
+        const cls = classRegistry.get(currentType);
+        if (cls) {
+            return cls;
+        }
+        currentType = typeParent(currentType);
+    }
+    return null;
+}
+function applyInterfaceMixin(cls, type, baseType, applied) {
+    if (applied.has(type) || typeIsA(baseType, type)) {
+        return cls;
+    }
+    const mixin = interfaceMixinRegistry.get(type);
+    if (mixin === undefined) {
+        return cls;
+    }
+    applied.add(type);
+    return mixin(cls);
+}
+function createComposedClass(base, runtimeType) {
+    const baseType = getClassType(base);
+    const applied = new Set();
+    let cls = base;
+    for (const type of typeInterfaces(runtimeType)) {
+        cls = applyInterfaceMixin(cls, type, baseType, applied);
+    }
+    return applied.size === 0 ? base : cls;
+}
+function resolveComposedClass(runtimeType) {
+    const exact = classRegistry.get(runtimeType);
+    if (exact) {
+        return exact;
+    }
+    const cached = composedClassRegistry.get(runtimeType);
+    if (cached) {
+        return cached;
+    }
+    const base = resolveWrapperClass(runtimeType);
+    if (base === null) {
+        return null;
+    }
+    const composed = createComposedClass(base, runtimeType);
+    if (composed === base) {
+        return base;
+    }
+    setClassType(composed, runtimeType);
+    composedClassRegistry.set(runtimeType, composed);
+    return composed;
+}
+function getOrCreateWrapper(handle) {
+    const existing = getWrapper(handle);
+    if (existing) {
+        return existing;
+    }
+    const runtimeType = getType(handle);
+    if (runtimeType === TYPE_INVALID) {
+        throw new Error("Cannot resolve runtime GLib type from handle");
+    }
+    const cls = resolveComposedClass(runtimeType);
+    if (!cls) {
+        throw new Error(`Expected registered GLib type, got type ${String(runtimeType)}`);
+    }
+    const instance = Object.create(cls.prototype);
+    registerWrapper(handle, instance);
+    return instance;
+}
+/** Returns the native handle bound to a wrapper instance, throwing if none is set. */
+function getHandle(instance) {
+    const handle = handleMap.get(instance);
+    if (handle === undefined) {
+        const name = instance.constructor?.name ?? "object";
+        throw new Error(`No native handle associated with ${name}`);
+    }
+    return handle;
+}
+/** Returns the native handle bound to an instance, or undefined when there is none or the instance is null. */
+function tryGetHandle(instance) {
+    return instance == null ? undefined : handleMap.get(instance);
+}
+/** Associates a native handle with a wrapper instance. */
+function setHandle(instance, handle) {
+    handleMap.set(instance, handle);
+}
+function registerWrapper(handle, instance) {
+    setHandle(instance, handle);
+    setWrapper(handle, instance);
+}
+function registerVfuncRegistry(cls, registry) {
+    vfuncRegistry.set(cls, registry);
+}
+function getVfuncRegistry(cls) {
+    return vfuncRegistry.get(cls);
+}
+function registerInterfaceVfuncRegistry(type, registry) {
+    if (type === TYPE_INVALID) {
+        return;
+    }
+    interfaceVfuncRegistry.set(type, registry);
+}
+function getInterfaceVfuncRegistry(type) {
+    return interfaceVfuncRegistry.get(type);
+}
+export { getClassType, getInstanceType, registerClassType, registerWrapperClass, registerInterface, wrapHandle, getWrapperClass, resolveWrapperClass, getHandle, tryGetHandle, setHandle, getVfuncRegistry, getInterfaceVfuncRegistry, };
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyClass } from \"@gtkx/utils\";\nimport {\n    type ExternalObject,\n    getType,\n    getWrapper,\n    type Handle,\n    type RegisterClassVfunc as NativeRegisterClassVfunc,\n    setWrapper,\n} from \"@gtkx/native\";\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 member\n * named `K` (default `\"new\"`) removed.\n */\ntype StaticBase<C, K extends PropertyKey = \"new\"> = Omit<C, K> &\n    (C extends new (...args: infer A) => infer R ? new (...args: A) => R : never);\n\ntype VfuncDescriptor<K extends \"class\" | \"interface\"> = {\n    kind: K;\n    className: string;\n    vfuncName: string;\n    byteOffset: number;\n    vtableSize: number;\n    argDescriptors: NativeRegisterClassVfunc[\"argDescriptors\"];\n    returnDescriptor: NativeRegisterClassVfunc[\"returnDescriptor\"];\n};\n\ntype VfuncRegistry = Record<string, VfuncDescriptor<\"class\"> | VfuncDescriptor<\"interface\">>;\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 interfaceVfuncRegistry: Map<bigint, VfuncRegistry> = new Map();\n\nfunction setClassType(cls: AnyClass, type: bigint): void {\n    (cls.prototype as { [K in keyof TypedClass]: TypedClass[K] }).__type__ = type;\n}\n\nfunction getClassType(cls: AnyClass): bigint {\n    const proto: object = cls.prototype;\n\n    return Object.hasOwn(proto, \"__type__\") ? (proto as TypedClass).__type__ : TYPE_INVALID;\n}\n\n/** Returns the GType tag of the given wrapper instance. */\nfunction getInstanceType(instance: object): bigint {\n    return getClassType(instance.constructor as AnyClass);\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 Virtual functions the class overrides.\n */\nfunction registerWrapperClass(cls: AnyClass, type: bigint, vfuncs?: VfuncRegistry): void {\n    registerClassType(cls, type);\n\n    if (vfuncs) {\n        registerVfuncRegistry(cls, vfuncs);\n    }\n}\n\n/**\n * Registers a GInterface, associating its GType with a mixin used to compose the\n * interface onto wrapper classes and an optional virtual function registry.\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 vfuncs Virtual functions the interface exposes.\n */\nfunction registerInterface(cls: AnyClass, type: bigint, mixin: Mixin, vfuncs?: VfuncRegistry): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    setClassType(cls, type);\n    interfaceMixinRegistry.set(type, mixin);\n\n    if (vfuncs) {\n        registerInterfaceVfuncRegistry(type, vfuncs);\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 * with an explicit class, creates a bare instance backed by the handle. Returns\n * null 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 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 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 = interfaceMixinRegistry.get(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    composedClassRegistry.set(runtimeType, composed);\n\n    return composed;\n}\n\nfunction getOrCreateWrapper(handle: ExternalObject<Handle>): object {\n    const existing = getWrapper(handle);\n\n    if (existing) {\n        return existing;\n    }\n\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    const instance: object = Object.create(cls.prototype) as object;\n    registerWrapper(handle, instance);\n\n    return instance;\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        const name = (instance as { constructor?: { name?: string } }).constructor?.name ?? \"object\";\n        throw new Error(`No native handle associated with ${name}`);\n    }\n\n    return handle;\n}\n\n/** Returns the native handle bound to an instance, or undefined when there is none or the instance is null. */\nfunction tryGetHandle(instance: object | null | undefined): ExternalObject<Handle> | undefined {\n    return instance == null ? undefined : handleMap.get(instance);\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 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 registerInterfaceVfuncRegistry(type: bigint, registry: VfuncRegistry): void {\n    if (type === TYPE_INVALID) {\n        return;\n    }\n\n    interfaceVfuncRegistry.set(type, registry);\n}\n\nfunction getInterfaceVfuncRegistry(type: bigint): VfuncRegistry | undefined {\n    return interfaceVfuncRegistry.get(type);\n}\n\nexport {\n    getClassType,\n    getInstanceType,\n    registerClassType,\n    registerWrapperClass,\n    registerInterface,\n    wrapHandle,\n    getWrapperClass,\n    resolveWrapperClass,\n    getHandle,\n    tryGetHandle,\n    setHandle,\n    getVfuncRegistry,\n    getInterfaceVfuncRegistry,\n    type StaticBase,\n    type VfuncDescriptor,\n    type VfuncRegistry,\n};\n"]}

package/dist/signal.d.ts

@@ -0,0 +1,35 @@
+import type { Descriptor } from "@gtkx/native";
+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 SignalConnectSpec = {
+    callback: CallbackDescriptor;
+    handler: SignalHandler;
+    after: boolean;
+};
+type EmitArg = Arg & {
+    value?: unknown;
+};
+/** Returns the signal name without its detail suffix (the part after `::`). */
+declare const getSignalBaseName: (signal: string) => string;
+declare const isSignalHandlerConnected: (instance: object, handlerId: number) => boolean;
+/**
+ * Connects a handler to a GObject signal on an instance and returns the handler id.
+ * @param instance Emitter to connect to.
+ * @param signal Signal name, optionally including a `::detail` suffix.
+ * @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 blockMatchedSignalHandlers(instance: object, signal: string): void;
+/**
+ * Emits a signal on an instance with the given arguments and returns its result
+ * combined with any output-argument values.
+ * @param instance Emitter to emit the signal on.
+ * @param signal Signal name, optionally including a `::detail` suffix.
+ * @param args Arguments to pass, including output and inout arguments.
+ * @param returnDescriptor Descriptor for the signal's return value, omitted when it returns void.
+ */
+declare function emitSignal(instance: object, signal: string, args: EmitArg[], returnDescriptor?: Descriptor): unknown;
+export { getSignalBaseName, connectSignal, blockMatchedSignalHandlers, emitSignal, isSignalHandlerConnected, type SignalHandler, };
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +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,KAAK,iBAAiB,GAAG;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,OAAO,GAAG,GAAG,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA2BzC,+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;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAOxF;AAED,iBAAS,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG1E;AAoBD;;;;;;;GAOG;AACH,iBAAS,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,CAiC7G;AAED,OAAO,EACH,iBAAiB,EACjB,aAAa,EACb,0BAA0B,EAC1B,UAAU,EACV,wBAAwB,EACxB,KAAK,aAAa,GACrB,CAAC"}

package/dist/signal.js

@@ -0,0 +1,95 @@
+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 { 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";
+const connectCache = createBindCache();
+const gQuarkFromString = bind(LIB, "g_quark_from_string", [stringT("borrowed")], uint32T);
+const gSignalLookup = bind(LIB, "g_signal_lookup", [stringT("borrowed"), biguint64T], uint32T);
+const gSignalEmitv = bind(LIB, "g_signal_emitv", [arrayT(VALUE_T, "array", "borrowed", { elementSize: VALUE_SIZE }), uint32T, uint32T, VALUE_T], voidT);
+const gSignalHandlersBlockMatched = bind(LIB, "g_signal_handlers_block_matched", [objectT("borrowed"), uint32T, uint32T, uint32T, objectT("borrowed"), objectT("borrowed"), objectT("borrowed")], uint32T);
+const gSignalHandlerIsConnected = bind(LIB, "g_signal_handler_is_connected", [objectT("borrowed"), uint64T], booleanT);
+/** Returns the signal name without its detail suffix (the part after `::`). */
+const getSignalBaseName = (signal) => {
+    const detailIndex = signal.indexOf("::");
+    return detailIndex === -1 ? signal : signal.slice(0, detailIndex);
+};
+function getSignalDetailQuark(signal) {
+    const detailIndex = signal.indexOf("::");
+    if (detailIndex === -1) {
+        return 0;
+    }
+    return gQuarkFromString(signal.slice(detailIndex + 2));
+}
+const isSignalHandlerConnected = (instance, handlerId) => gSignalHandlerIsConnected(getHandle(instance), handlerId);
+const getSignalId = (instance, signal) => {
+    const type = instance.__type__;
+    return gSignalLookup(getSignalBaseName(signal), type);
+};
+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);
+}
+/**
+ * Connects a handler to a GObject signal on an instance and returns the handler id.
+ * @param instance Emitter to connect to.
+ * @param signal Signal name, optionally including a `::detail` suffix.
+ * @param spec Callback descriptor, handler function, and whether to run after the default handler.
+ */
+function connectSignal(instance, signal, spec) {
+    const { callback, handler, after } = spec;
+    const wrapped = wrapCallback(handler, callback, "emitter");
+    const type = instance.__type__;
+    const connect = connectBind(type, signal, callback);
+    return connect(getHandle(instance), signal, wrapped, after ? 1 : 0);
+}
+function blockMatchedSignalHandlers(instance, signal) {
+    const signalId = getSignalId(instance, signal);
+    gSignalHandlersBlockMatched(getHandle(instance), 1, signalId, 0, undefined, undefined, undefined);
+}
+const createEmitValue = (arg) => {
+    if (!isOutputArg(arg)) {
+        return { value: toValue(arg.type, arg.value) };
+    }
+    if (isCallerAllocatedArg(arg)) {
+        if (isInoutArg(arg)) {
+            return { value: inoutValueForBoxedDescriptor(arg.type, arg.value) };
+        }
+        const value = outValueForBoxedDescriptor(arg.type, arg.value);
+        return { value, read: () => getBoxedValue(value) };
+    }
+    return isInoutArg(arg) ? outValueForDescriptor(arg.type, arg.value) : outValueForDescriptor(arg.type);
+};
+/**
+ * Emits a signal on an instance with the given arguments and returns its result
+ * combined with any output-argument values.
+ * @param instance Emitter to emit the signal on.
+ * @param signal Signal name, optionally including a `::detail` suffix.
+ * @param args Arguments to pass, including output and inout arguments.
+ * @param returnDescriptor Descriptor for the signal's return value, omitted when it returns void.
+ */
+function emitSignal(instance, signal, args, returnDescriptor) {
+    const signalId = getSignalId(instance, signal);
+    const detail = getSignalDetailQuark(signal);
+    const values = [toValue(objectT("full"), instance)];
+    const reads = [];
+    for (const arg of args) {
+        const { value, read } = createEmitValue(arg);
+        values.push(value);
+        if (read) {
+            reads.push(read);
+        }
+    }
+    if (returnDescriptor !== undefined) {
+        const returnValue = newValueForDescriptor(returnDescriptor);
+        gSignalEmitv(values, signalId, detail, returnValue);
+        return packTupleResult(reads.map((read) => read()), fromValue(returnValue), true);
+    }
+    gSignalEmitv(values, signalId, detail, undefined);
+    return packTupleResult(reads.map((read) => read()), undefined, false);
+}
+export { getSignalBaseName, connectSignal, blockMatchedSignalHandlers, emitSignal, isSignalHandlerConnected, };
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -0,0 +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\ntype SignalConnectSpec = {\n    callback: CallbackDescriptor;\n    handler: SignalHandler;\n    after: boolean;\n};\n\ntype EmitArg = Arg & { value?: unknown };\n\nconst connectCache = createBindCache();\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 gSignalHandlersBlockMatched = bind(\n    LIB,\n    \"g_signal_handlers_block_matched\",\n    [objectT(\"borrowed\"), uint32T, uint32T, uint32T, objectT(\"borrowed\"), objectT(\"borrowed\"), objectT(\"borrowed\")],\n    uint32T,\n);\n\nconst gSignalHandlerIsConnected = bind(\n    LIB,\n    \"g_signal_handler_is_connected\",\n    [objectT(\"borrowed\"), uint64T],\n    booleanT,\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 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, after } = spec;\n    const wrapped = wrapCallback(handler, callback, \"emitter\");\n    const type: bigint = (instance as TypedClass).__type__;\n    const connect = connectBind(type, signal, callback);\n\n    return connect(getHandle(instance), signal, wrapped, after ? 1 : 0) as number;\n}\n\nfunction blockMatchedSignalHandlers(instance: object, signal: string): void {\n    const signalId = getSignalId(instance, signal);\n    gSignalHandlersBlockMatched(getHandle(instance), 1, signalId, 0, undefined, undefined, undefined);\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\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 returnDescriptor Descriptor for the signal's return value, omitted when it returns void.\n */\nfunction emitSignal(instance: object, signal: string, args: EmitArg[], returnDescriptor?: Descriptor): unknown {\n    const signalId = getSignalId(instance, signal);\n    const detail = getSignalDetailQuark(signal);\n    const values: ExternalObject<Handle>[] = [toValue(objectT(\"full\"), instance)];\n    const reads: (() => unknown)[] = [];\n\n    for (const arg of args) {\n        const { value, read } = createEmitValue(arg);\n        values.push(value);\n\n        if (read) {\n            reads.push(read);\n        }\n    }\n\n    if (returnDescriptor !== undefined) {\n        const returnValue = newValueForDescriptor(returnDescriptor);\n        gSignalEmitv(values, signalId, detail, returnValue);\n\n        return packTupleResult(\n            reads.map((read) => read()),\n            fromValue(returnValue),\n            true,\n        );\n    }\n\n    gSignalEmitv(values, signalId, detail, undefined);\n\n    return packTupleResult(\n        reads.map((read) => read()),\n        undefined,\n        false,\n    );\n}\n\nexport {\n    getSignalBaseName,\n    connectSignal,\n    blockMatchedSignalHandlers,\n    emitSignal,\n    isSignalHandlerConnected,\n    type SignalHandler,\n};\n"]}

package/dist/t.d.ts

@@ -0,0 +1,50 @@
+import { bind } from "./bind.js";
+import * as helpers from "./descriptors.js";
+import { fn } from "./fn.js";
+type T = {
+    bind: typeof bind;
+    int8: typeof helpers.int8T;
+    uint8: typeof helpers.uint8T;
+    int16: typeof helpers.int16T;
+    uint16: typeof helpers.uint16T;
+    int32: typeof helpers.int32T;
+    uint32: typeof helpers.uint32T;
+    int64: typeof helpers.int64T;
+    uint64: typeof helpers.uint64T;
+    bigint64: typeof helpers.bigint64T;
+    biguint64: typeof helpers.biguint64T;
+    gtype: typeof helpers.gtypeT;
+    float32: typeof helpers.float32T;
+    float64: typeof helpers.float64T;
+    boolean: typeof helpers.booleanT;
+    void: typeof helpers.voidT;
+    unichar: typeof helpers.unicharT;
+    buffer: typeof helpers.bufferT;
+    string: typeof helpers.stringT;
+    object: typeof helpers.objectT;
+    boxed: typeof helpers.boxedT;
+    struct: typeof helpers.structT;
+    fundamental: typeof helpers.fundamentalT;
+    ref: typeof helpers.refT;
+    hashTable: typeof helpers.hashTableT;
+    enum: typeof helpers.enumT;
+    flags: typeof helpers.flagsT;
+    array: typeof helpers.arrayT;
+    list: typeof helpers.listT;
+    slist: typeof helpers.slistT;
+    ptrArray: typeof helpers.ptrArrayT;
+    gArray: typeof helpers.gArrayT;
+    byteArray: typeof helpers.byteArrayT;
+    sizedArray: typeof helpers.sizedArrayT;
+    fixedArray: typeof helpers.fixedArrayT;
+    callback: typeof helpers.callbackT;
+    fn: typeof fn;
+};
+/**
+ * Type descriptor builder: a collection of factory helpers that describe C types for
+ * FFI marshalling, plus `bind` to bind a native function and `fn` to describe a
+ * function signature.
+ */
+declare const t: T;
+export { t };
+//# sourceMappingURL=t.d.ts.map

package/dist/t.d.ts.map

@@ -0,0 +1 @@
+{"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,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,KAAK,CAAC,GAAG;IACL,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,OAAO,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjC,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,WAAW,EAAE,OAAO,OAAO,CAAC,YAAY,CAAC;IACzC,GAAG,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IACzB,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IAC3B,KAAK,EAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC7B,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC/B,SAAS,EAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACrC,UAAU,EAAE,OAAO,OAAO,CAAC,WAAW,CAAC;IACvC,UAAU,EAAE,OAAO,OAAO,CAAC,WAAW,CAAC;IACvC,QAAQ,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACnC,EAAE,EAAE,OAAO,EAAE,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,CAAC,EAAE,CAsCR,CAAC;AAEF,OAAO,EAAE,CAAC,EAAE,CAAC"}

package/dist/t.js

@@ -0,0 +1,49 @@
+import { bind } from "./bind.js";
+import * as helpers from "./descriptors.js";
+import { fn } from "./fn.js";
+/**
+ * Type descriptor builder: a collection of factory helpers that describe C types for
+ * FFI marshalling, plus `bind` to bind a native function and `fn` to describe a
+ * function signature.
+ */
+const t = {
+    bind,
+    int8: helpers.int8T,
+    uint8: helpers.uint8T,
+    int16: helpers.int16T,
+    uint16: helpers.uint16T,
+    int32: helpers.int32T,
+    uint32: helpers.uint32T,
+    int64: helpers.int64T,
+    uint64: helpers.uint64T,
+    bigint64: helpers.bigint64T,
+    biguint64: helpers.biguint64T,
+    gtype: helpers.gtypeT,
+    float32: helpers.float32T,
+    float64: helpers.float64T,
+    boolean: helpers.booleanT,
+    void: helpers.voidT,
+    unichar: helpers.unicharT,
+    buffer: helpers.bufferT,
+    string: helpers.stringT,
+    object: helpers.objectT,
+    boxed: helpers.boxedT,
+    struct: helpers.structT,
+    fundamental: helpers.fundamentalT,
+    ref: helpers.refT,
+    hashTable: helpers.hashTableT,
+    enum: helpers.enumT,
+    flags: helpers.flagsT,
+    array: helpers.arrayT,
+    list: helpers.listT,
+    slist: helpers.slistT,
+    ptrArray: helpers.ptrArrayT,
+    gArray: helpers.gArrayT,
+    byteArray: helpers.byteArrayT,
+    sizedArray: helpers.sizedArrayT,
+    fixedArray: helpers.fixedArrayT,
+    callback: helpers.callbackT,
+    fn,
+};
+export { t };
+//# sourceMappingURL=t.js.map

package/dist/t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t.js","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,EAAE,EAAE,MAAM,SAAS,CAAC;AA0C7B;;;;GAIG;AACH,MAAM,CAAC,GAAM;IACT,IAAI;IACJ,IAAI,EAAE,OAAO,CAAC,KAAK;IACnB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,QAAQ,EAAE,OAAO,CAAC,SAAS;IAC3B,SAAS,EAAE,OAAO,CAAC,UAAU;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,IAAI,EAAE,OAAO,CAAC,KAAK;IACnB,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,WAAW,EAAE,OAAO,CAAC,YAAY;IACjC,GAAG,EAAE,OAAO,CAAC,IAAI;IACjB,SAAS,EAAE,OAAO,CAAC,UAAU;IAC7B,IAAI,EAAE,OAAO,CAAC,KAAK;IACnB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,IAAI,EAAE,OAAO,CAAC,KAAK;IACnB,KAAK,EAAE,OAAO,CAAC,MAAM;IACrB,QAAQ,EAAE,OAAO,CAAC,SAAS;IAC3B,MAAM,EAAE,OAAO,CAAC,OAAO;IACvB,SAAS,EAAE,OAAO,CAAC,UAAU;IAC7B,UAAU,EAAE,OAAO,CAAC,WAAW;IAC/B,UAAU,EAAE,OAAO,CAAC,WAAW;IAC/B,QAAQ,EAAE,OAAO,CAAC,SAAS;IAC3B,EAAE;CACL,CAAC;AAEF,OAAO,EAAE,CAAC,EAAE,CAAC","sourcesContent":["import { bind } from \"./bind.js\";\nimport * as helpers from \"./descriptors.js\";\nimport { fn } from \"./fn.js\";\n\ntype T = {\n    bind: typeof bind;\n    int8: typeof helpers.int8T;\n    uint8: typeof helpers.uint8T;\n    int16: typeof helpers.int16T;\n    uint16: typeof helpers.uint16T;\n    int32: typeof helpers.int32T;\n    uint32: typeof helpers.uint32T;\n    int64: typeof helpers.int64T;\n    uint64: typeof helpers.uint64T;\n    bigint64: typeof helpers.bigint64T;\n    biguint64: typeof helpers.biguint64T;\n    gtype: typeof helpers.gtypeT;\n    float32: typeof helpers.float32T;\n    float64: typeof helpers.float64T;\n    boolean: typeof helpers.booleanT;\n    void: typeof helpers.voidT;\n    unichar: typeof helpers.unicharT;\n    buffer: typeof helpers.bufferT;\n    string: typeof helpers.stringT;\n    object: typeof helpers.objectT;\n    boxed: typeof helpers.boxedT;\n    struct: typeof helpers.structT;\n    fundamental: typeof helpers.fundamentalT;\n    ref: typeof helpers.refT;\n    hashTable: typeof helpers.hashTableT;\n    enum: typeof helpers.enumT;\n    flags: typeof helpers.flagsT;\n    array: typeof helpers.arrayT;\n    list: typeof helpers.listT;\n    slist: typeof helpers.slistT;\n    ptrArray: typeof helpers.ptrArrayT;\n    gArray: typeof helpers.gArrayT;\n    byteArray: typeof helpers.byteArrayT;\n    sizedArray: typeof helpers.sizedArrayT;\n    fixedArray: typeof helpers.fixedArrayT;\n    callback: typeof helpers.callbackT;\n    fn: typeof fn;\n};\n\n/**\n * Type descriptor builder: a collection of factory helpers that describe C types for\n * FFI marshalling, plus `bind` to bind a native function and `fn` to describe a\n * function signature.\n */\nconst t: T = {\n    bind,\n    int8: helpers.int8T,\n    uint8: helpers.uint8T,\n    int16: helpers.int16T,\n    uint16: helpers.uint16T,\n    int32: helpers.int32T,\n    uint32: helpers.uint32T,\n    int64: helpers.int64T,\n    uint64: helpers.uint64T,\n    bigint64: helpers.bigint64T,\n    biguint64: helpers.biguint64T,\n    gtype: helpers.gtypeT,\n    float32: helpers.float32T,\n    float64: helpers.float64T,\n    boolean: helpers.booleanT,\n    void: helpers.voidT,\n    unichar: helpers.unicharT,\n    buffer: helpers.bufferT,\n    string: helpers.stringT,\n    object: helpers.objectT,\n    boxed: helpers.boxedT,\n    struct: helpers.structT,\n    fundamental: helpers.fundamentalT,\n    ref: helpers.refT,\n    hashTable: helpers.hashTableT,\n    enum: helpers.enumT,\n    flags: helpers.flagsT,\n    array: helpers.arrayT,\n    list: helpers.listT,\n    slist: helpers.slistT,\n    ptrArray: helpers.ptrArrayT,\n    gArray: helpers.gArrayT,\n    byteArray: helpers.byteArrayT,\n    sizedArray: helpers.sizedArrayT,\n    fixedArray: helpers.fixedArrayT,\n    callback: helpers.callbackT,\n    fn,\n};\n\nexport { t };\n"]}

package/dist/tuple.d.ts

@@ -0,0 +1,7 @@
+declare const packTupleResult: (outs: unknown[], primary: unknown, hasPrimary: boolean) => unknown;
+declare const splitTupleResult: (result: unknown, hasPrimary: boolean, outCount: number) => {
+    primary: unknown;
+    outValues: unknown[];
+};
+export { packTupleResult, splitTupleResult };
+//# sourceMappingURL=tuple.d.ts.map

package/dist/tuple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.d.ts","sourceRoot":"","sources":["../src/tuple.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,eAAe,GAAI,MAAM,OAAO,EAAE,EAAE,SAAS,OAAO,EAAE,YAAY,OAAO,KAAG,OAcjF,CAAC;AAEF,QAAA,MAAM,gBAAgB,GAClB,QAAQ,OAAO,EACf,YAAY,OAAO,EACnB,UAAU,MAAM,KACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,EAAE,CAAA;CAc1C,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC"}