@gtkx/runtime 1.2.2 → 1.4.0

package/dist/t.js

@@ -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";
 /**
  * Type descriptor builder: a collection of factory helpers that describe C types for
@@ -45,6 +46,8 @@ const t = {
     cursorArray: helpers.cursorArrayT,
     callback: helpers.callbackT,
     fn,
+    field,
+    fieldAt,
 };
 export { t };
 //# sourceMappingURL=t.js.map

package/dist/t.js.map

@@ -1 +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;AAwF7B;;;;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,WAAW,EAAE,OAAO,CAAC,YAAY;IACjC,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\n/** The descriptor factories and function binders exposed as {@link t}. */\ntype T = {\n    /** Binds a symbol in a shared library to a callable that marshals its arguments and return value. */\n    bind: typeof bind;\n    /** Descriptor for a `gint8`, marshalled as a number. */\n    int8: typeof helpers.int8T;\n    /** Descriptor for a `guint8`, marshalled as a number. */\n    uint8: typeof helpers.uint8T;\n    /** Descriptor for a `gint16`, marshalled as a number. */\n    int16: typeof helpers.int16T;\n    /** Descriptor for a `guint16`, marshalled as a number. */\n    uint16: typeof helpers.uint16T;\n    /** Descriptor for a `gint32`, marshalled as a number. */\n    int32: typeof helpers.int32T;\n    /** Descriptor for a `guint32`, marshalled as a number. */\n    uint32: typeof helpers.uint32T;\n    /** Descriptor for a `gint64`, marshalled as a number and rejected outside the 2^53 safe range. */\n    int64: typeof helpers.int64T;\n    /** Descriptor for a `guint64`, marshalled as a number and rejected outside the 2^53 safe range. */\n    uint64: typeof helpers.uint64T;\n    /** Descriptor for a `gint64`, marshalled as a bigint so the full 64-bit range survives. */\n    bigint64: typeof helpers.bigint64T;\n    /** Descriptor for a `guint64`, marshalled as a bigint so the full 64-bit range survives. */\n    biguint64: typeof helpers.biguint64T;\n    /** Descriptor for a `GType`, marshalled as a bigint and recognized as a GType by GValue conversion. */\n    gtype: typeof helpers.gtypeT;\n    /** Descriptor for a `gfloat`. */\n    float32: typeof helpers.float32T;\n    /** Descriptor for a `gdouble`. */\n    float64: typeof helpers.float64T;\n    /** Descriptor for a `gboolean`, marshalled as a JavaScript boolean. */\n    boolean: typeof helpers.booleanT;\n    /** Descriptor for the absence of a value, used as the return descriptor of a `void` function. */\n    void: typeof helpers.voidT;\n    /** Descriptor for a `gunichar`, marshalled as a single-character string or a codepoint number. */\n    unichar: typeof helpers.unicharT;\n    /** Descriptor for an opaque `gpointer` argument, taken from a typed array's memory or a numeric address. */\n    buffer: typeof helpers.bufferT;\n    /**\n     * Builds a descriptor for a C string, whose optional length sizes the caller-allocated buffer\n     * used when the string is passed by reference.\n     */\n    string: typeof helpers.stringT;\n    /** Builds a descriptor for a `GObject`, wrapped in the class registered for its runtime GType. */\n    object: typeof helpers.objectT;\n    /** Builds a descriptor for a `GBoxed` value of the named type. */\n    boxed: typeof helpers.boxedT;\n    /** Builds a descriptor for a plain C struct. */\n    struct: typeof helpers.structT;\n    /** Builds a descriptor for a fundamental type whose lifetime is managed by named ref and unref functions. */\n    fundamental: typeof helpers.fundamentalT;\n    /** Wraps a descriptor in a pointer to it, for an output or inout argument. */\n    ref: typeof helpers.refT;\n    /** Builds a descriptor for a `GHashTable`, marshalled as an array of key/value pairs. */\n    hashTable: typeof helpers.hashTableT;\n    /** Builds a descriptor for an enumeration, resolving its GType from the named `get_type` function. */\n    enum: typeof helpers.enumT;\n    /** Builds a descriptor for a flags type, resolving its GType from the named `get_type` function. */\n    flags: typeof helpers.flagsT;\n    /** Builds a descriptor for an array of items in one of the supported container layouts. */\n    array: typeof helpers.arrayT;\n    /** Builds a descriptor for a `GList` of items. */\n    list: typeof helpers.listT;\n    /** Builds a descriptor for a `GSList` of items. */\n    slist: typeof helpers.slistT;\n    /** Builds a descriptor for a `GPtrArray` of items. */\n    ptrArray: typeof helpers.ptrArrayT;\n    /** Builds a descriptor for a `GArray` of items. */\n    gArray: typeof helpers.gArrayT;\n    /** Builds a descriptor for a `GByteArray`. */\n    byteArray: typeof helpers.byteArrayT;\n    /** Builds a descriptor for a C array whose length is carried by another argument. */\n    sizedArray: typeof helpers.sizedArrayT;\n    /** Builds a descriptor for a C array of a fixed length. */\n    fixedArray: typeof helpers.fixedArrayT;\n    /** Builds a descriptor for an out pointer into the buffer another argument supplied. */\n    cursorArray: typeof helpers.cursorArrayT;\n    /** Builds a descriptor for a function pointer, marshalling a JavaScript function into a native closure. */\n    callback: typeof helpers.callbackT;\n    /**\n     * Binds a native function, wiring up argument directions, `GError` checking, and packing output\n     * arguments into the result.\n     */\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    cursorArray: helpers.cursorArrayT,\n    callback: helpers.callbackT,\n    fn,\n};\n\nexport { t };\n"]}
+{"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,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAkG7B;;;;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,WAAW,EAAE,OAAO,CAAC,YAAY;IACjC,QAAQ,EAAE,OAAO,CAAC,SAAS;IAC3B,EAAE;IACF,KAAK;IACL,OAAO;CACV,CAAC;AAEF,OAAO,EAAE,CAAC,EAAE,CAAC","sourcesContent":["import { bind } from \"./bind.js\";\nimport * as helpers from \"./descriptors.js\";\nimport { field, fieldAt } from \"./field.js\";\nimport { fn } from \"./fn.js\";\n\n/** The descriptor factories and function binders exposed as {@link t}. */\ntype T = {\n    /** Binds a symbol in a shared library to a callable that marshals its arguments and return value. */\n    bind: typeof bind;\n    /** Descriptor for a `gint8`, marshalled as a number. */\n    int8: typeof helpers.int8T;\n    /** Descriptor for a `guint8`, marshalled as a number. */\n    uint8: typeof helpers.uint8T;\n    /** Descriptor for a `gint16`, marshalled as a number. */\n    int16: typeof helpers.int16T;\n    /** Descriptor for a `guint16`, marshalled as a number. */\n    uint16: typeof helpers.uint16T;\n    /** Descriptor for a `gint32`, marshalled as a number. */\n    int32: typeof helpers.int32T;\n    /** Descriptor for a `guint32`, marshalled as a number. */\n    uint32: typeof helpers.uint32T;\n    /** Descriptor for a `gint64`, marshalled as a number and rejected outside the 2^53 safe range. */\n    int64: typeof helpers.int64T;\n    /** Descriptor for a `guint64`, marshalled as a number and rejected outside the 2^53 safe range. */\n    uint64: typeof helpers.uint64T;\n    /** Descriptor for a `gint64`, marshalled as a bigint so the full 64-bit range survives. */\n    bigint64: typeof helpers.bigint64T;\n    /** Descriptor for a `guint64`, marshalled as a bigint so the full 64-bit range survives. */\n    biguint64: typeof helpers.biguint64T;\n    /** Descriptor for a `GType`, marshalled as a bigint and recognized as a GType by GValue conversion. */\n    gtype: typeof helpers.gtypeT;\n    /** Descriptor for a `gfloat`. */\n    float32: typeof helpers.float32T;\n    /** Descriptor for a `gdouble`. */\n    float64: typeof helpers.float64T;\n    /** Descriptor for a `gboolean`, marshalled as a JavaScript boolean. */\n    boolean: typeof helpers.booleanT;\n    /** Descriptor for the absence of a value, used as the return descriptor of a `void` function. */\n    void: typeof helpers.voidT;\n    /** Descriptor for a `gunichar`, marshalled as a single-character string or a codepoint number. */\n    unichar: typeof helpers.unicharT;\n    /** Descriptor for an opaque `gpointer` argument, taken from a typed array's memory or a numeric address. */\n    buffer: typeof helpers.bufferT;\n    /**\n     * Builds a descriptor for a C string, whose optional length sizes the caller-allocated buffer\n     * used when the string is passed by reference.\n     */\n    string: typeof helpers.stringT;\n    /** Builds a descriptor for a `GObject`, wrapped in the class registered for its runtime GType. */\n    object: typeof helpers.objectT;\n    /** Builds a descriptor for a `GBoxed` value of the named type. */\n    boxed: typeof helpers.boxedT;\n    /** Builds a descriptor for a plain C struct. */\n    struct: typeof helpers.structT;\n    /** Builds a descriptor for a fundamental type whose lifetime is managed by named ref and unref functions. */\n    fundamental: typeof helpers.fundamentalT;\n    /** Wraps a descriptor in a pointer to it, for an output or inout argument. */\n    ref: typeof helpers.refT;\n    /** Builds a descriptor for a `GHashTable`, marshalled as an array of key/value pairs. */\n    hashTable: typeof helpers.hashTableT;\n    /** Builds a descriptor for an enumeration, resolving its GType from the named `get_type` function. */\n    enum: typeof helpers.enumT;\n    /** Builds a descriptor for a flags type, resolving its GType from the named `get_type` function. */\n    flags: typeof helpers.flagsT;\n    /** Builds a descriptor for an array of items in one of the supported container layouts. */\n    array: typeof helpers.arrayT;\n    /** Builds a descriptor for a `GList` of items. */\n    list: typeof helpers.listT;\n    /** Builds a descriptor for a `GSList` of items. */\n    slist: typeof helpers.slistT;\n    /** Builds a descriptor for a `GPtrArray` of items. */\n    ptrArray: typeof helpers.ptrArrayT;\n    /** Builds a descriptor for a `GArray` of items. */\n    gArray: typeof helpers.gArrayT;\n    /** Builds a descriptor for a `GByteArray`. */\n    byteArray: typeof helpers.byteArrayT;\n    /** Builds a descriptor for a C array whose length is carried by another argument. */\n    sizedArray: typeof helpers.sizedArrayT;\n    /** Builds a descriptor for a C array of a fixed length. */\n    fixedArray: typeof helpers.fixedArrayT;\n    /** Builds a descriptor for an out pointer into the buffer another argument supplied. */\n    cursorArray: typeof helpers.cursorArrayT;\n    /** Builds a descriptor for a function pointer, marshalling a JavaScript function into a native closure. */\n    callback: typeof helpers.callbackT;\n    /**\n     * Binds a native function, wiring up argument directions, `GError` checking, and packing output\n     * arguments into the result.\n     */\n    fn: typeof fn;\n    /**\n     * Binds a struct field at a fixed offset, compiling its descriptor once into an accessor that\n     * reads and writes it.\n     */\n    field: typeof field;\n    /**\n     * Binds a struct field whose offset is supplied per access, for walking records stored at a\n     * stride in a buffer.\n     */\n    fieldAt: typeof fieldAt;\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    cursorArray: helpers.cursorArrayT,\n    callback: helpers.callbackT,\n    fn,\n    field,\n    fieldAt,\n};\n\nexport { t };\n"]}

package/dist/type.d.ts

@@ -82,7 +82,8 @@ declare function valueIsA(value: unknown, gtype: bigint): boolean;
 declare const resolveType: (sharedLibrary: string, typeFnName: string) => bigint;
 declare const resolveBoxedType: (descriptor: BoxedDescriptor) => bigint;
 declare const resolveFundamentalType: (descriptor: FundamentalDescriptor) => bigint;
+declare const getByteArrayType: () => bigint;
 declare function isResolvableDescriptor(descriptor: Descriptor): descriptor is ResolvableDescriptor;
 declare function resolveDescriptorType(descriptor: Descriptor): bigint;
-export { TYPE_INVALID, TYPE_NONE, TYPE_INTERFACE, TYPE_CHAR, TYPE_UCHAR, TYPE_BOOLEAN, TYPE_INT, TYPE_UINT, TYPE_LONG, TYPE_ULONG, TYPE_INT64, TYPE_UINT64, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_DOUBLE, TYPE_STRING, TYPE_POINTER, TYPE_BOXED, TYPE_PARAM, TYPE_OBJECT, TYPE_GTYPE, TYPE_VARIANT, TYPE_UNICHAR, getErrorType, getStrvType, isResolvableDescriptor, isTypedClass, typeIsA, typeParent, typeInterfaces, typeFromName, typeFundamental, typeName, valueIsA, resolveType, resolveBoxedType, resolveFundamentalType, resolveDescriptorType, type TypedClass, };
+export { TYPE_INVALID, TYPE_NONE, TYPE_INTERFACE, TYPE_CHAR, TYPE_UCHAR, TYPE_BOOLEAN, TYPE_INT, TYPE_UINT, TYPE_LONG, TYPE_ULONG, TYPE_INT64, TYPE_UINT64, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_DOUBLE, TYPE_STRING, TYPE_POINTER, TYPE_BOXED, TYPE_PARAM, TYPE_OBJECT, TYPE_GTYPE, TYPE_VARIANT, TYPE_UNICHAR, getByteArrayType, getErrorType, getStrvType, isResolvableDescriptor, isTypedClass, typeIsA, typeParent, typeInterfaces, typeFromName, typeFundamental, typeName, valueIsA, resolveType, resolveBoxedType, resolveFundamentalType, resolveDescriptorType, type TypedClass, };
 //# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

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

package/dist/type.js

@@ -156,10 +156,14 @@ const resolveFundamentalType = (descriptor) => {
     }
     throw new Error("Cannot resolve gtype for fundamental type without a typeName");
 };
+const getByteArrayType = () => resolveType(LIB, "g_byte_array_get_type");
 function resolveArrayType(descriptor) {
     if (descriptor.itemDescriptor.kind === "string" && descriptor.arrayKind === "array") {
         return getStrvType();
     }
+    if (descriptor.arrayKind === "gbytearray") {
+        return getByteArrayType();
+    }
     throw new Error(`Unsupported array type ${descriptor.arrayKind} of ${descriptor.itemDescriptor.kind}`);
 }
 function isResolvableDescriptor(descriptor) {
@@ -192,5 +196,5 @@ function resolveDescriptorType(descriptor) {
         }
     }
 }
-export { TYPE_INVALID, TYPE_NONE, TYPE_INTERFACE, TYPE_CHAR, TYPE_UCHAR, TYPE_BOOLEAN, TYPE_INT, TYPE_UINT, TYPE_LONG, TYPE_ULONG, TYPE_INT64, TYPE_UINT64, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_DOUBLE, TYPE_STRING, TYPE_POINTER, TYPE_BOXED, TYPE_PARAM, TYPE_OBJECT, TYPE_GTYPE, TYPE_VARIANT, TYPE_UNICHAR, getErrorType, getStrvType, isResolvableDescriptor, isTypedClass, typeIsA, typeParent, typeInterfaces, typeFromName, typeFundamental, typeName, valueIsA, resolveType, resolveBoxedType, resolveFundamentalType, resolveDescriptorType, };
+export { TYPE_INVALID, TYPE_NONE, TYPE_INTERFACE, TYPE_CHAR, TYPE_UCHAR, TYPE_BOOLEAN, TYPE_INT, TYPE_UINT, TYPE_LONG, TYPE_ULONG, TYPE_INT64, TYPE_UINT64, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_DOUBLE, TYPE_STRING, TYPE_POINTER, TYPE_BOXED, TYPE_PARAM, TYPE_OBJECT, TYPE_GTYPE, TYPE_VARIANT, TYPE_UNICHAR, getByteArrayType, getErrorType, getStrvType, isResolvableDescriptor, isTypedClass, typeIsA, typeParent, typeInterfaces, typeFromName, typeFundamental, typeName, valueIsA, resolveType, resolveBoxedType, resolveFundamentalType, resolveDescriptorType, };
 //# sourceMappingURL=type.js.map

package/dist/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Descriptor, resolveType as nativeResolveType } from \"@gtkx/native\";\nimport { bind } from \"./bind.js\";\nimport {\n    type ArrayDescriptor,\n    biguint64T,\n    booleanT,\n    type BoxedDescriptor,\n    type FundamentalDescriptor,\n    refT,\n    sizedArrayT,\n    stringT,\n    uint32T,\n} from \"./descriptors.js\";\nimport { LIB } from \"./library.js\";\n\n/** Object tagged with its GLib type through a `__type__` GType field. */\ntype TypedClass = {\n    /** GType the object's class is registered under. */\n    __type__: bigint;\n};\n\ntype ResolvableKind = \"enum\" | \"flags\" | \"boxed\" | \"fundamental\" | \"array\";\ntype ResolvableDescriptor = Extract<Descriptor, { kind: ResolvableKind }>;\n\nconst resolvedTypeCache: Map<string, bigint> = new Map();\nconst gTypeFromName = bind(LIB, \"g_type_from_name\", [stringT(\"borrowed\")], biguint64T);\nconst gTypeIsA = bind(LIB, \"g_type_is_a\", [biguint64T, biguint64T], booleanT);\nconst gTypeParent = bind(LIB, \"g_type_parent\", [biguint64T], biguint64T);\nconst gTypeFundamental = bind(LIB, \"g_type_fundamental\", [biguint64T], biguint64T);\nconst gTypeName = bind(LIB, \"g_type_name\", [biguint64T], stringT(\"borrowed\"));\nconst gTypeInterfaces = bind(LIB, \"g_type_interfaces\", [biguint64T, refT(uint32T)], sizedArrayT(biguint64T, 1, \"full\"));\n/** GType tag for an invalid or uninitialized type. */\nconst TYPE_INVALID = 0n;\n/** GType tag for the absence of a value (`void`). */\nconst TYPE_NONE: bigint = typeFromName(\"void\");\n/** GType tag for the base GInterface type. */\nconst TYPE_INTERFACE: bigint = typeFromName(\"GInterface\");\n/** GType tag for `gchar` (signed 8-bit integer). */\nconst TYPE_CHAR: bigint = typeFromName(\"gchar\");\n/** GType tag for `guchar` (unsigned 8-bit integer). */\nconst TYPE_UCHAR: bigint = typeFromName(\"guchar\");\n/** GType tag for `gboolean`. */\nconst TYPE_BOOLEAN: bigint = typeFromName(\"gboolean\");\n/** GType tag for `gint`. */\nconst TYPE_INT: bigint = typeFromName(\"gint\");\n/** GType tag for `guint`. */\nconst TYPE_UINT: bigint = typeFromName(\"guint\");\n/** GType tag for `glong`. */\nconst TYPE_LONG: bigint = typeFromName(\"glong\");\n/** GType tag for `gulong`. */\nconst TYPE_ULONG: bigint = typeFromName(\"gulong\");\n/** GType tag for `gint64`. */\nconst TYPE_INT64: bigint = typeFromName(\"gint64\");\n/** GType tag for `guint64`. */\nconst TYPE_UINT64: bigint = typeFromName(\"guint64\");\n/** GType tag for the base GEnum type. */\nconst TYPE_ENUM: bigint = typeFromName(\"GEnum\");\n/** GType tag for the base GFlags type. */\nconst TYPE_FLAGS: bigint = typeFromName(\"GFlags\");\n/** GType tag for `gfloat`. */\nconst TYPE_FLOAT: bigint = typeFromName(\"gfloat\");\n/** GType tag for `gdouble`. */\nconst TYPE_DOUBLE: bigint = typeFromName(\"gdouble\");\n/** GType tag for `gchararray` (a nul-terminated C string). */\nconst TYPE_STRING: bigint = typeFromName(\"gchararray\");\n/** GType tag for `gpointer` (an opaque pointer). */\nconst TYPE_POINTER: bigint = typeFromName(\"gpointer\");\n/** GType tag for the base GBoxed type. */\nconst TYPE_BOXED: bigint = typeFromName(\"GBoxed\");\n/** GType tag for the base GParam type. */\nconst TYPE_PARAM: bigint = typeFromName(\"GParam\");\n/** GType tag for the base GObject type. */\nconst TYPE_OBJECT: bigint = typeFromName(\"GObject\");\n/** GType tag for a GType value itself. */\nconst TYPE_GTYPE: bigint = typeFromName(\"GType\");\n/** GType tag for GVariant. */\nconst TYPE_VARIANT: bigint = typeFromName(\"GVariant\");\n/** GType tag for a Unicode character stored as `guint`. */\nconst TYPE_UNICHAR: bigint = typeFromName(\"guint\");\nconst getErrorType: () => bigint = lazyType(\"GError\");\nconst getStrvType: () => bigint = lazyType(\"GStrv\");\n\nconst PLAIN_DESCRIPTOR_TYPES: Partial<Record<Descriptor[\"kind\"], bigint>> = {\n    boolean: TYPE_BOOLEAN,\n    string: TYPE_STRING,\n    int8: TYPE_INT,\n    int16: TYPE_INT,\n    int32: TYPE_INT,\n    uint8: TYPE_UINT,\n    uint16: TYPE_UINT,\n    uint32: TYPE_UINT,\n    int64: TYPE_INT64,\n    bigint64: TYPE_INT64,\n    uint64: TYPE_UINT64,\n    biguint64: TYPE_UINT64,\n    float32: TYPE_FLOAT,\n    float64: TYPE_DOUBLE,\n    object: TYPE_OBJECT,\n};\n\nconst RESOLVABLE_DESCRIPTOR_KINDS: Set<Descriptor[\"kind\"]> = new Set<ResolvableKind>([\n    \"enum\",\n    \"flags\",\n    \"boxed\",\n    \"fundamental\",\n    \"array\",\n]);\n\nfunction lazyType(name: string): () => bigint {\n    let cached: bigint | undefined;\n\n    return () => {\n        cached ??= typeFromName(name);\n\n        return cached;\n    };\n}\n\nconst isTypedClass = (value: unknown): value is TypedClass =>\n    typeof value === \"object\" && value !== null && \"__type__\" in value && typeof value.__type__ === \"bigint\";\n\n/** Returns whether `type` is `ancestorType` or descends from it. */\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- mirrors g_type_is_a from the C API */\nfunction typeIsA(type: bigint, ancestorType: bigint): boolean {\n    return gTypeIsA(type, ancestorType) as boolean;\n}\n\n/** Returns the immediate parent GType of the given type. */\nfunction typeParent(type: bigint): bigint {\n    return gTypeParent(type) as bigint;\n}\n\n/** Returns the GTypes of the interfaces implemented by the given type. */\nfunction typeInterfaces(type: bigint): bigint[] {\n    const nInterfacesRef = { value: 0 };\n\n    return gTypeInterfaces(type, nInterfacesRef) as bigint[];\n}\n\n/** Returns the GType registered under the given name, or `TYPE_INVALID` if none exists. */\nfunction typeFromName(name: string): bigint {\n    return gTypeFromName(name) as bigint;\n}\n\nfunction typeFundamental(type: bigint): bigint {\n    return gTypeFundamental(type) as bigint;\n}\n\n/** Returns the registered name of a GType, or null if it has none. */\nfunction typeName(type: bigint): string | null {\n    return (gTypeName(type) ?? null) as string | null;\n}\n\n/** Returns whether `value` is a typed wrapper whose GType is or descends from `gtype`. */\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- mirrors g_type_is_a from the C API */\nfunction valueIsA(value: unknown, gtype: bigint): boolean {\n    return isTypedClass(value) && typeIsA(value.__type__, gtype);\n}\n\n/**\n * Resolves the GType produced by a `get_type` function in a shared library, caching\n * the result per library and function name.\n * @param sharedLibrary Path or name of the shared library exporting the function.\n * @param typeFnName Name of the `*_get_type` function to call.\n */\nconst resolveType = (sharedLibrary: string, typeFnName: string): bigint => {\n    const key = `${sharedLibrary}:${typeFnName}`;\n    const cached = resolvedTypeCache.get(key);\n\n    if (cached !== undefined) {\n        return cached;\n    }\n\n    const gtype = nativeResolveType(sharedLibrary, typeFnName);\n    resolvedTypeCache.set(key, gtype);\n\n    return gtype;\n};\n\nconst resolveBoxedType = (descriptor: BoxedDescriptor): bigint => {\n    if (descriptor.getTypeFnName && descriptor.sharedLibrary) {\n        return resolveType(descriptor.sharedLibrary, descriptor.getTypeFnName);\n    }\n\n    const gtype = typeFromName(descriptor.typeName);\n\n    if (gtype === TYPE_INVALID) {\n        throw new Error(`Cannot resolve gtype for boxed type '${descriptor.typeName}'`);\n    }\n\n    return gtype;\n};\n\nconst resolveFundamentalType = (descriptor: FundamentalDescriptor): bigint => {\n    if (descriptor.typeName) {\n        const gtype = typeFromName(descriptor.typeName);\n\n        if (gtype !== TYPE_INVALID) {\n            return gtype;\n        }\n    }\n\n    throw new Error(\"Cannot resolve gtype for fundamental type without a typeName\");\n};\n\nfunction resolveArrayType(descriptor: ArrayDescriptor): bigint {\n    if (descriptor.itemDescriptor.kind === \"string\" && descriptor.arrayKind === \"array\") {\n        return getStrvType();\n    }\n\n    throw new Error(`Unsupported array type ${descriptor.arrayKind} of ${descriptor.itemDescriptor.kind}`);\n}\n\nfunction isResolvableDescriptor(descriptor: Descriptor): descriptor is ResolvableDescriptor {\n    return RESOLVABLE_DESCRIPTOR_KINDS.has(descriptor.kind);\n}\n\nfunction resolveDescriptorType(descriptor: Descriptor): bigint {\n    if (descriptor.kind === \"biguint64\" && \"type\" in descriptor) {\n        return TYPE_GTYPE;\n    }\n\n    const plain = PLAIN_DESCRIPTOR_TYPES[descriptor.kind];\n\n    if (plain !== undefined) {\n        return plain;\n    }\n\n    if (!isResolvableDescriptor(descriptor)) {\n        throw new Error(`Unsupported type descriptor '${descriptor.kind}'`);\n    }\n\n    switch (descriptor.kind) {\n        case \"enum\":\n        case \"flags\": {\n            return resolveType(descriptor.sharedLibrary, descriptor.getTypeFnName);\n        }\n        case \"boxed\": {\n            return resolveBoxedType(descriptor);\n        }\n        case \"fundamental\": {\n            return resolveFundamentalType(descriptor);\n        }\n        case \"array\": {\n            return resolveArrayType(descriptor);\n        }\n    }\n}\n\nexport {\n    TYPE_INVALID,\n    TYPE_NONE,\n    TYPE_INTERFACE,\n    TYPE_CHAR,\n    TYPE_UCHAR,\n    TYPE_BOOLEAN,\n    TYPE_INT,\n    TYPE_UINT,\n    TYPE_LONG,\n    TYPE_ULONG,\n    TYPE_INT64,\n    TYPE_UINT64,\n    TYPE_ENUM,\n    TYPE_FLAGS,\n    TYPE_FLOAT,\n    TYPE_DOUBLE,\n    TYPE_STRING,\n    TYPE_POINTER,\n    TYPE_BOXED,\n    TYPE_PARAM,\n    TYPE_OBJECT,\n    TYPE_GTYPE,\n    TYPE_VARIANT,\n    TYPE_UNICHAR,\n    getErrorType,\n    getStrvType,\n    isResolvableDescriptor,\n    isTypedClass,\n    typeIsA,\n    typeParent,\n    typeInterfaces,\n    typeFromName,\n    typeFundamental,\n    typeName,\n    valueIsA,\n    resolveType,\n    resolveBoxedType,\n    resolveFundamentalType,\n    resolveDescriptorType,\n    type TypedClass,\n};\n"]}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Descriptor, resolveType as nativeResolveType } from \"@gtkx/native\";\nimport { bind } from \"./bind.js\";\nimport {\n    type ArrayDescriptor,\n    biguint64T,\n    booleanT,\n    type BoxedDescriptor,\n    type FundamentalDescriptor,\n    refT,\n    sizedArrayT,\n    stringT,\n    uint32T,\n} from \"./descriptors.js\";\nimport { LIB } from \"./library.js\";\n\n/** Object tagged with its GLib type through a `__type__` GType field. */\ntype TypedClass = {\n    /** GType the object's class is registered under. */\n    __type__: bigint;\n};\n\ntype ResolvableKind = \"enum\" | \"flags\" | \"boxed\" | \"fundamental\" | \"array\";\ntype ResolvableDescriptor = Extract<Descriptor, { kind: ResolvableKind }>;\n\nconst resolvedTypeCache: Map<string, bigint> = new Map();\nconst gTypeFromName = bind(LIB, \"g_type_from_name\", [stringT(\"borrowed\")], biguint64T);\nconst gTypeIsA = bind(LIB, \"g_type_is_a\", [biguint64T, biguint64T], booleanT);\nconst gTypeParent = bind(LIB, \"g_type_parent\", [biguint64T], biguint64T);\nconst gTypeFundamental = bind(LIB, \"g_type_fundamental\", [biguint64T], biguint64T);\nconst gTypeName = bind(LIB, \"g_type_name\", [biguint64T], stringT(\"borrowed\"));\nconst gTypeInterfaces = bind(LIB, \"g_type_interfaces\", [biguint64T, refT(uint32T)], sizedArrayT(biguint64T, 1, \"full\"));\n/** GType tag for an invalid or uninitialized type. */\nconst TYPE_INVALID = 0n;\n/** GType tag for the absence of a value (`void`). */\nconst TYPE_NONE: bigint = typeFromName(\"void\");\n/** GType tag for the base GInterface type. */\nconst TYPE_INTERFACE: bigint = typeFromName(\"GInterface\");\n/** GType tag for `gchar` (signed 8-bit integer). */\nconst TYPE_CHAR: bigint = typeFromName(\"gchar\");\n/** GType tag for `guchar` (unsigned 8-bit integer). */\nconst TYPE_UCHAR: bigint = typeFromName(\"guchar\");\n/** GType tag for `gboolean`. */\nconst TYPE_BOOLEAN: bigint = typeFromName(\"gboolean\");\n/** GType tag for `gint`. */\nconst TYPE_INT: bigint = typeFromName(\"gint\");\n/** GType tag for `guint`. */\nconst TYPE_UINT: bigint = typeFromName(\"guint\");\n/** GType tag for `glong`. */\nconst TYPE_LONG: bigint = typeFromName(\"glong\");\n/** GType tag for `gulong`. */\nconst TYPE_ULONG: bigint = typeFromName(\"gulong\");\n/** GType tag for `gint64`. */\nconst TYPE_INT64: bigint = typeFromName(\"gint64\");\n/** GType tag for `guint64`. */\nconst TYPE_UINT64: bigint = typeFromName(\"guint64\");\n/** GType tag for the base GEnum type. */\nconst TYPE_ENUM: bigint = typeFromName(\"GEnum\");\n/** GType tag for the base GFlags type. */\nconst TYPE_FLAGS: bigint = typeFromName(\"GFlags\");\n/** GType tag for `gfloat`. */\nconst TYPE_FLOAT: bigint = typeFromName(\"gfloat\");\n/** GType tag for `gdouble`. */\nconst TYPE_DOUBLE: bigint = typeFromName(\"gdouble\");\n/** GType tag for `gchararray` (a nul-terminated C string). */\nconst TYPE_STRING: bigint = typeFromName(\"gchararray\");\n/** GType tag for `gpointer` (an opaque pointer). */\nconst TYPE_POINTER: bigint = typeFromName(\"gpointer\");\n/** GType tag for the base GBoxed type. */\nconst TYPE_BOXED: bigint = typeFromName(\"GBoxed\");\n/** GType tag for the base GParam type. */\nconst TYPE_PARAM: bigint = typeFromName(\"GParam\");\n/** GType tag for the base GObject type. */\nconst TYPE_OBJECT: bigint = typeFromName(\"GObject\");\n/** GType tag for a GType value itself. */\nconst TYPE_GTYPE: bigint = typeFromName(\"GType\");\n/** GType tag for GVariant. */\nconst TYPE_VARIANT: bigint = typeFromName(\"GVariant\");\n/** GType tag for a Unicode character stored as `guint`. */\nconst TYPE_UNICHAR: bigint = typeFromName(\"guint\");\nconst getErrorType: () => bigint = lazyType(\"GError\");\nconst getStrvType: () => bigint = lazyType(\"GStrv\");\n\nconst PLAIN_DESCRIPTOR_TYPES: Partial<Record<Descriptor[\"kind\"], bigint>> = {\n    boolean: TYPE_BOOLEAN,\n    string: TYPE_STRING,\n    int8: TYPE_INT,\n    int16: TYPE_INT,\n    int32: TYPE_INT,\n    uint8: TYPE_UINT,\n    uint16: TYPE_UINT,\n    uint32: TYPE_UINT,\n    int64: TYPE_INT64,\n    bigint64: TYPE_INT64,\n    uint64: TYPE_UINT64,\n    biguint64: TYPE_UINT64,\n    float32: TYPE_FLOAT,\n    float64: TYPE_DOUBLE,\n    object: TYPE_OBJECT,\n};\n\nconst RESOLVABLE_DESCRIPTOR_KINDS: Set<Descriptor[\"kind\"]> = new Set<ResolvableKind>([\n    \"enum\",\n    \"flags\",\n    \"boxed\",\n    \"fundamental\",\n    \"array\",\n]);\n\nfunction lazyType(name: string): () => bigint {\n    let cached: bigint | undefined;\n\n    return () => {\n        cached ??= typeFromName(name);\n\n        return cached;\n    };\n}\n\nconst isTypedClass = (value: unknown): value is TypedClass =>\n    typeof value === \"object\" && value !== null && \"__type__\" in value && typeof value.__type__ === \"bigint\";\n\n/** Returns whether `type` is `ancestorType` or descends from it. */\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- mirrors g_type_is_a from the C API */\nfunction typeIsA(type: bigint, ancestorType: bigint): boolean {\n    return gTypeIsA(type, ancestorType) as boolean;\n}\n\n/** Returns the immediate parent GType of the given type. */\nfunction typeParent(type: bigint): bigint {\n    return gTypeParent(type) as bigint;\n}\n\n/** Returns the GTypes of the interfaces implemented by the given type. */\nfunction typeInterfaces(type: bigint): bigint[] {\n    const nInterfacesRef = { value: 0 };\n\n    return gTypeInterfaces(type, nInterfacesRef) as bigint[];\n}\n\n/** Returns the GType registered under the given name, or `TYPE_INVALID` if none exists. */\nfunction typeFromName(name: string): bigint {\n    return gTypeFromName(name) as bigint;\n}\n\nfunction typeFundamental(type: bigint): bigint {\n    return gTypeFundamental(type) as bigint;\n}\n\n/** Returns the registered name of a GType, or null if it has none. */\nfunction typeName(type: bigint): string | null {\n    return (gTypeName(type) ?? null) as string | null;\n}\n\n/** Returns whether `value` is a typed wrapper whose GType is or descends from `gtype`. */\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- mirrors g_type_is_a from the C API */\nfunction valueIsA(value: unknown, gtype: bigint): boolean {\n    return isTypedClass(value) && typeIsA(value.__type__, gtype);\n}\n\n/**\n * Resolves the GType produced by a `get_type` function in a shared library, caching\n * the result per library and function name.\n * @param sharedLibrary Path or name of the shared library exporting the function.\n * @param typeFnName Name of the `*_get_type` function to call.\n */\nconst resolveType = (sharedLibrary: string, typeFnName: string): bigint => {\n    const key = `${sharedLibrary}:${typeFnName}`;\n    const cached = resolvedTypeCache.get(key);\n\n    if (cached !== undefined) {\n        return cached;\n    }\n\n    const gtype = nativeResolveType(sharedLibrary, typeFnName);\n    resolvedTypeCache.set(key, gtype);\n\n    return gtype;\n};\n\nconst resolveBoxedType = (descriptor: BoxedDescriptor): bigint => {\n    if (descriptor.getTypeFnName && descriptor.sharedLibrary) {\n        return resolveType(descriptor.sharedLibrary, descriptor.getTypeFnName);\n    }\n\n    const gtype = typeFromName(descriptor.typeName);\n\n    if (gtype === TYPE_INVALID) {\n        throw new Error(`Cannot resolve gtype for boxed type '${descriptor.typeName}'`);\n    }\n\n    return gtype;\n};\n\nconst resolveFundamentalType = (descriptor: FundamentalDescriptor): bigint => {\n    if (descriptor.typeName) {\n        const gtype = typeFromName(descriptor.typeName);\n\n        if (gtype !== TYPE_INVALID) {\n            return gtype;\n        }\n    }\n\n    throw new Error(\"Cannot resolve gtype for fundamental type without a typeName\");\n};\n\nconst getByteArrayType = (): bigint => resolveType(LIB, \"g_byte_array_get_type\");\n\nfunction resolveArrayType(descriptor: ArrayDescriptor): bigint {\n    if (descriptor.itemDescriptor.kind === \"string\" && descriptor.arrayKind === \"array\") {\n        return getStrvType();\n    }\n\n    if (descriptor.arrayKind === \"gbytearray\") {\n        return getByteArrayType();\n    }\n\n    throw new Error(`Unsupported array type ${descriptor.arrayKind} of ${descriptor.itemDescriptor.kind}`);\n}\n\nfunction isResolvableDescriptor(descriptor: Descriptor): descriptor is ResolvableDescriptor {\n    return RESOLVABLE_DESCRIPTOR_KINDS.has(descriptor.kind);\n}\n\nfunction resolveDescriptorType(descriptor: Descriptor): bigint {\n    if (descriptor.kind === \"biguint64\" && \"type\" in descriptor) {\n        return TYPE_GTYPE;\n    }\n\n    const plain = PLAIN_DESCRIPTOR_TYPES[descriptor.kind];\n\n    if (plain !== undefined) {\n        return plain;\n    }\n\n    if (!isResolvableDescriptor(descriptor)) {\n        throw new Error(`Unsupported type descriptor '${descriptor.kind}'`);\n    }\n\n    switch (descriptor.kind) {\n        case \"enum\":\n        case \"flags\": {\n            return resolveType(descriptor.sharedLibrary, descriptor.getTypeFnName);\n        }\n        case \"boxed\": {\n            return resolveBoxedType(descriptor);\n        }\n        case \"fundamental\": {\n            return resolveFundamentalType(descriptor);\n        }\n        case \"array\": {\n            return resolveArrayType(descriptor);\n        }\n    }\n}\n\nexport {\n    TYPE_INVALID,\n    TYPE_NONE,\n    TYPE_INTERFACE,\n    TYPE_CHAR,\n    TYPE_UCHAR,\n    TYPE_BOOLEAN,\n    TYPE_INT,\n    TYPE_UINT,\n    TYPE_LONG,\n    TYPE_ULONG,\n    TYPE_INT64,\n    TYPE_UINT64,\n    TYPE_ENUM,\n    TYPE_FLAGS,\n    TYPE_FLOAT,\n    TYPE_DOUBLE,\n    TYPE_STRING,\n    TYPE_POINTER,\n    TYPE_BOXED,\n    TYPE_PARAM,\n    TYPE_OBJECT,\n    TYPE_GTYPE,\n    TYPE_VARIANT,\n    TYPE_UNICHAR,\n    getByteArrayType,\n    getErrorType,\n    getStrvType,\n    isResolvableDescriptor,\n    isTypedClass,\n    typeIsA,\n    typeParent,\n    typeInterfaces,\n    typeFromName,\n    typeFundamental,\n    typeName,\n    valueIsA,\n    resolveType,\n    resolveBoxedType,\n    resolveFundamentalType,\n    resolveDescriptorType,\n    type TypedClass,\n};\n"]}

package/dist/value.d.ts

@@ -1,25 +1,64 @@
 import { type Descriptor, type ExternalObject, type Handle } from "@gtkx/native";
+import { type ValueGuard } from "./param-spec.js";
+import { type TypedClass } from "./type.js";
 type ValueType = {
     set: (value: ExternalObject<Handle>, nativeValue: unknown) => void;
     get: (value: ExternalObject<Handle>) => unknown;
 };
 type ValueWriter = ValueType["set"];
 type ValueNarrower = (jsValue: unknown) => unknown;
+/**
+ * JavaScript value a `GObject.Value` can be built from without being told which GType to hold, for the
+ * parameters that take one. A string holds `gchararray`, a boolean `gboolean`, an integer within `gint`
+ * range `gint` and any other number `gdouble`, a `bigint` `gint64` or `guint64` past its range, an array
+ * of strings `GStrv`, a wrapper instance the GType it carries, and `null` a NULL `gpointer`, which is
+ * what GJS infers for it and which few callees accept. Reaching a GType inference cannot name, such as
+ * `guchar` or an enumeration, takes an explicitly initialized `GObject.Value` instead.
+ */
+type JsValue = string | number | bigint | boolean | string[] | TypedClass | null;
 declare function getValueType(value: ExternalObject<Handle>): bigint;
 declare function copyValue(dest: ExternalObject<Handle>, src: ExternalObject<Handle>): void;
 declare const newValueForType: (type: bigint) => ExternalObject<Handle>;
 /**
  * Duplicates the boxed value held by a GValue and returns the copy wrapped in the
- * class registered for its GType, or null when the GValue holds no boxed type.
+ * class its GType resolves to, or null when the GValue holds no boxed type.
+ * A `GByteArray` payload is copied into a `Uint8Array` instead of being wrapped.
  */
 declare function getBoxedValue(value: ExternalObject<Handle>): object | null;
-/** Stores a boxed object, or null, into a GValue that holds a boxed type. */
-declare function setBoxedValue(value: ExternalObject<Handle>, boxed: object | null): void;
+/**
+ * Stores a boxed object, or null, into a GValue that holds a boxed type. A GValue holding
+ * `G_TYPE_VALUE` also takes any other {@link JsValue}, which is boxed into a nested `GObject.Value`
+ * of the GType inferred from it, and one holding a `GByteArray` also takes the bytes as a
+ * `Uint8Array` or an array of byte values.
+ * @param value Handle of an initialized value to write into.
+ * @param boxed The boxed instance, bytes, or {@link JsValue} to store.
+ * @throws {ValueMarshalError} When the value cannot hold what was passed.
+ */
+declare function setBoxedValue(value: ExternalObject<Handle>, boxed: JsValue | object): void;
 declare function valueNarrowerFor(type: bigint): ValueNarrower;
 declare function valueWriterFor(type: bigint): ValueWriter;
 declare function intoValue(value: ExternalObject<Handle>, jsValue: unknown): void;
+/**
+ * Marshals a value passed where a `GObject.Value` is expected into a value handle: an already-built
+ * value yields its own handle, and any other {@link JsValue} is stored in a new one initialized to the
+ * GType inferred from it.
+ * @param jsValue Value to store, or an already-built `GObject.Value`.
+ * @throws {ValueMarshalError} When no GType can be inferred from the value.
+ */
+declare function toValueHandle(jsValue: unknown): ExternalObject<Handle>;
+/** Same as {@link toValueHandle}, but passes a null or undefined value through as no value at all. */
+declare const tryToValueHandle: (jsValue: unknown) => ExternalObject<Handle> | undefined;
 declare function toValue(descriptor: Descriptor, value: unknown): ExternalObject<Handle>;
+/**
+ * Reads what a `GObject.Value` holds as its JavaScript form, wrapping an object, boxed, param, variant,
+ * or fundamental payload in the class registered for its GType, and handing back a string, number,
+ * `bigint`, boolean, or array of strings for the rest.
+ * @param value Handle of an initialized value to read.
+ * @throws {Error} When the GType it holds has no JavaScript form, such as a non-null `gpointer`.
+ */
 declare function fromValue(value: ExternalObject<Handle>): unknown;
+declare const fromValueForDescriptor: (descriptor: Descriptor, value: ExternalObject<Handle>) => unknown;
+declare const valueGuardOverrideFor: (valueType: bigint) => ValueGuard | undefined;
 declare function newValueForDescriptor(descriptor: Descriptor): ExternalObject<Handle>;
 declare function outValueForDescriptor(descriptor: Descriptor, initial?: unknown): {
     value: ExternalObject<Handle>;
@@ -27,5 +66,10 @@ declare function outValueForDescriptor(descriptor: Descriptor, initial?: unknown
 };
 declare function outValueForBoxedDescriptor(descriptor: Descriptor, boxed: object): ExternalObject<Handle>;
 declare function inoutValueForBoxedDescriptor(descriptor: Descriptor, boxed: object): ExternalObject<Handle>;
-export { getValueType, intoValue, copyValue, getBoxedValue, setBoxedValue, toValue, fromValue, newValueForDescriptor, newValueForType, outValueForDescriptor, outValueForBoxedDescriptor, inoutValueForBoxedDescriptor, type ValueNarrower, valueNarrowerFor, type ValueWriter, valueWriterFor, };
+/** Thrown when a value passed where a `GObject.Value` is expected holds no GType one can be built from. */
+declare class ValueMarshalError extends TypeError {
+    /** Name callers match on when the error is caught as a plain `TypeError`. */
+    name: string;
+}
+export { getValueType, intoValue, copyValue, getBoxedValue, setBoxedValue, type JsValue, toValue, toValueHandle, tryToValueHandle, ValueMarshalError, fromValue, fromValueForDescriptor, valueGuardOverrideFor, newValueForDescriptor, newValueForType, outValueForDescriptor, outValueForBoxedDescriptor, inoutValueForBoxedDescriptor, type ValueNarrower, valueNarrowerFor, type ValueWriter, valueWriterFor, };
 //# sourceMappingURL=value.d.ts.map

package/dist/value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,UAAU,EAAE,KAAK,cAAc,EAAW,KAAK,MAAM,EAAe,MAAM,cAAc,CAAC;AA2D9G,KAAK,SAAS,GAAG;IACb,GAAG,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,GAAG,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC;CACnD,CAAC;AAGF,KAAK,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;AACpC,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;AAoLnD,iBAAS,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,CAE3D;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAMlF;AAED,QAAA,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,cAAc,CAAC,MAAM,CAK5D,CAAC;AAcF;;;GAGG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAWnE;AAED,6EAA6E;AAC7E,iBAAS,aAAa,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGhF;AA8ID,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAErD;AAED,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQjD;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAExE;AAoBD,iBAAS,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAO/E;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CASzD;AAED,iBAAS,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAE7E;AAED,iBAAS,qBAAqB,CAC1B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,OAAO,GAClB;IAAE,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAA;CAAE,CAYxD;AAED,iBAAS,0BAA0B,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAEjG;AAED,iBAAS,4BAA4B,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAEnG;AAED,OAAO,EACH,YAAY,EACZ,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,aAAa,EAClB,gBAAgB,EAChB,KAAK,WAAW,EAChB,cAAc,GACjB,CAAC"}
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":"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"}

package/dist/value.js

@@ -1,10 +1,11 @@
 import { alloc, getType, read, write } from "@gtkx/native";
 import { bind, createBindCache } from "./bind.js";
-import { arrayT, bigint64T, biguint64T, booleanT, boxedT, float32T, float64T, fundamentalLifecycleFor, fundamentalT, int8T, int32T, objectT, stringT, uint8T, uint32T, uint64T, voidT, } from "./descriptors.js";
+import { arrayT, bigint64T, biguint64T, booleanT, boxedT, byteArrayT, float32T, float64T, fundamentalLifecycleFor, fundamentalT, int8T, int32T, objectT, stringT, uint8T, uint32T, uint64T, voidT, } from "./descriptors.js";
 import { LIB, PARAM_T, VALUE_SIZE, VALUE_T, VARIANT_T } from "./library.js";
 import { toNative } from "./native-value.js";
-import { getHandle, getWrapperClass, wrapHandle, wrapObject } from "./registry.js";
-import { getStrvType, isResolvableDescriptor, resolveBoxedType, resolveDescriptorType, resolveFundamentalType, resolveType, TYPE_BOOLEAN, TYPE_BOXED, TYPE_CHAR, TYPE_DOUBLE, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_GTYPE, TYPE_INT, TYPE_INT64, TYPE_INTERFACE, TYPE_INVALID, TYPE_LONG, TYPE_OBJECT, TYPE_PARAM, TYPE_POINTER, TYPE_STRING, TYPE_UCHAR, TYPE_UINT, TYPE_UINT64, TYPE_ULONG, TYPE_VARIANT, typeFundamental, typeName, } from "./type.js";
+import { INT32_MAXIMUM, INT32_MINIMUM, INT64_MAXIMUM, INT64_MINIMUM, isStringArray, resolveGtype, UINT64_MAXIMUM, } from "./param-spec.js";
+import { coerceGType, describeValueKind, getHandle, getWrapperClass, wrapFundamentalHandle, wrapHandle, wrapObject, } from "./registry.js";
+import { getByteArrayType, getStrvType, isResolvableDescriptor, resolveBoxedType, resolveDescriptorType, resolveFundamentalType, resolveType, TYPE_BOOLEAN, TYPE_BOXED, TYPE_CHAR, TYPE_DOUBLE, TYPE_ENUM, TYPE_FLAGS, TYPE_FLOAT, TYPE_GTYPE, TYPE_INT, TYPE_INT64, TYPE_INTERFACE, TYPE_INVALID, TYPE_LONG, TYPE_OBJECT, TYPE_PARAM, TYPE_POINTER, TYPE_STRING, TYPE_UCHAR, TYPE_UINT, TYPE_UINT64, TYPE_ULONG, TYPE_VARIANT, typeFundamental, typeIsA, typeName, } from "./type.js";
 const setBoxedCache = createBindCache();
 const setStaticBoxedCache = createBindCache();
 const dupBoxedCache = createBindCache();
@@ -13,7 +14,13 @@ const peekPointerCache = createBindCache();
 const gValueInit = bind(LIB, "g_value_init", [VALUE_T, biguint64T], voidT);
 const gValueCopy = bind(LIB, "g_value_copy", [VALUE_T, VALUE_T], voidT);
 const booleanValueType = bindValueType("boolean", booleanT);
-const typeValueType = bindValueType("gtype", biguint64T);
+const boundTypeValueType = bindValueType("gtype", biguint64T);
+const typeValueType = {
+    set: (value, jsValue) => {
+        boundTypeValueType.set(value, coerceGType(jsValue));
+    },
+    get: boundTypeValueType.get,
+};
 const scharValueType = bindValueType("schar", int8T);
 const ucharValueType = bindValueType("uchar", uint8T);
 const intValueType = bindValueType("int", int32T);
@@ -36,6 +43,10 @@ const strvValueType = {
     set: setStrvValue,
     get: bind(LIB, "g_value_get_boxed", [VALUE_T], arrayT(stringT("borrowed"))),
 };
+const setByteArrayBoxed = bind(LIB, "g_value_set_boxed", [VALUE_T, byteArrayT()], voidT);
+const getBoxedPointer = bind(LIB, "g_value_get_boxed", [VALUE_T], uint64T);
+const getBytesBoxed = bind(LIB, "g_value_get_boxed", [VALUE_T], byteArrayT());
+const getByteItemsBoxed = bind(LIB, "g_value_get_boxed", [VALUE_T], arrayT(uint8T, "gbytearray"));
 const PLAIN_VALUE_TYPES = {
     boolean: booleanValueType,
     string: stringValueType,
@@ -53,6 +64,18 @@ const PLAIN_VALUE_TYPES = {
     float64: doubleValueType,
     object: objectValueType,
 };
+const WHOLE_NUMBER_KINDS = new Set([
+    "int8",
+    "int16",
+    "int32",
+    "uint8",
+    "uint16",
+    "uint32",
+    "int64",
+    "uint64",
+    "enum",
+    "flags",
+]);
 const PLAIN_VALUE_GETTERS = new Map([
     [TYPE_BOOLEAN, booleanValueType.get],
     [TYPE_CHAR, scharValueType.get],
@@ -107,6 +130,15 @@ const boxedValueType = (type) => {
     const name = getBoxedTypeName(type);
     return { set: setBoxedBind(name), get: dupBoxedBind(name) };
 };
+const byteArrayValueGetterFor = (isBytes) => {
+    const get = isBytes ? getBytesBoxed : getByteItemsBoxed;
+    return (value) => (getBoxedPointer(value) ? get(value) : null);
+};
+const byteArrayValueType = (descriptor) => ({
+    set: setByteArrayValue,
+    get: byteArrayValueGetterFor(descriptor.isBytes === true),
+});
+const isByteArraySource = (jsValue) => jsValue instanceof Uint8Array || Array.isArray(jsValue);
 const enumOrFlagsValueType = (type) => typeFundamental(type) === TYPE_FLAGS ? flagsValueType : enumValueType;
 function unsupportedFundamental(type) {
     throw new Error(`Unsupported fundamental type '${typeName(type) ?? String(type)}' for value`);
@@ -173,26 +205,57 @@ const newBoxedValue = (descriptor, boxed, resolveSetBind) => {
 };
 /**
  * Duplicates the boxed value held by a GValue and returns the copy wrapped in the
- * class registered for its GType, or null when the GValue holds no boxed type.
+ * class its GType resolves to, or null when the GValue holds no boxed type.
+ * A `GByteArray` payload is copied into a `Uint8Array` instead of being wrapped.
  */
 function getBoxedValue(value) {
     const type = getValueType(value);
     if (typeFundamental(type) !== TYPE_BOXED) {
         return null;
     }
-    const cls = getWrapperClass(type);
+    if (type === getByteArrayType()) {
+        return byteArrayValueGetterFor(true)(value);
+    }
     const boxed = dupBoxedBind(getBoxedTypeName(type))(value);
-    return wrapHandle(boxed, cls);
+    if (boxed === null) {
+        return null;
+    }
+    return wrapHandle(boxed, getWrapperClass(type));
 }
-/** Stores a boxed object, or null, into a GValue that holds a boxed type. */
+/**
+ * Stores a boxed object, or null, into a GValue that holds a boxed type. A GValue holding
+ * `G_TYPE_VALUE` also takes any other {@link JsValue}, which is boxed into a nested `GObject.Value`
+ * of the GType inferred from it, and one holding a `GByteArray` also takes the bytes as a
+ * `Uint8Array` or an array of byte values.
+ * @param value Handle of an initialized value to write into.
+ * @param boxed The boxed instance, bytes, or {@link JsValue} to store.
+ * @throws {ValueMarshalError} When the value cannot hold what was passed.
+ */
 function setBoxedValue(value, boxed) {
-    const name = getBoxedTypeName(getValueType(value));
-    setBoxedBind(name)(value, boxed === null ? null : getHandle(boxed));
+    const type = getValueType(value);
+    if (type === resolveBoxedType(VALUE_T)) {
+        setBoxedBind("GValue")(value, boxed === null ? null : toValueHandle(boxed));
+        return;
+    }
+    if (type === getByteArrayType() && isByteArraySource(boxed)) {
+        setByteArrayBoxed(value, boxed);
+        return;
+    }
+    setWrappedBoxedValue(value, type, boxed);
+}
+function setWrappedBoxedValue(value, type, boxed) {
+    if (boxed !== null && typeof boxed !== "object") {
+        throw new ValueMarshalError(`Cannot marshal ${describeValueKind(boxed)} into a '${getBoxedTypeName(type)}' value`);
+    }
+    setBoxedBind(getBoxedTypeName(type))(value, boxed === null ? null : getHandle(boxed));
 }
 const arrayValueType = (descriptor) => {
     if (descriptor.itemDescriptor.kind === "string" && descriptor.arrayKind === "array") {
         return strvValueType;
     }
+    if (descriptor.arrayKind === "gbytearray") {
+        return byteArrayValueType(descriptor);
+    }
     throw new Error(`Unsupported array type ${descriptor.arrayKind} of ${descriptor.itemDescriptor.kind}`);
 };
 const resolveValueType = (descriptor) => {
@@ -232,10 +295,10 @@ const wrappedValueGetter = (fundamental) => {
             return (value) => wrapObject(objectValueType.get(value));
         }
         case TYPE_PARAM: {
-            return (value) => wrapHandle(paramValueType.get(value), getWrapperClass(TYPE_PARAM));
+            return (value) => wrapFundamentalHandle(paramValueType.get(value), getWrapperClass(TYPE_PARAM));
         }
         case TYPE_VARIANT: {
-            return (value) => wrapHandle(variantValueType.get(value), getWrapperClass(TYPE_VARIANT));
+            return (value) => wrapFundamentalHandle(variantValueType.get(value), getWrapperClass(TYPE_VARIANT));
         }
         case TYPE_BOXED: {
             return getBoxedValue;
@@ -259,6 +322,9 @@ function setStringValue(value, nativeValue) {
 function setStrvValue(value, nativeValue) {
     setStrvBoxed(value, nativeValue ?? null);
 }
+function setByteArrayValue(value, nativeValue) {
+    setByteArrayBoxed(value, nativeValue ?? null);
+}
 function setPointerValue(value, nativeValue) {
     if (nativeValue != null) {
         throw new Error("G_TYPE_POINTER non-null values cannot be marshalled from JS");
@@ -278,7 +344,7 @@ const customFundamentalGetter = (type) => {
     if (valueType === undefined) {
         return undefined;
     }
-    return (value) => wrapHandle(valueType.get(value), getWrapperClass(type));
+    return (value) => wrapFundamentalHandle(valueType.get(value), getWrapperClass(type));
 };
 const customFundamentalSetter = (type) => {
     const valueType = customFundamentalValueType(type);
@@ -309,12 +375,76 @@ function valueWriterFor(type) {
 function intoValue(value, jsValue) {
     valueWriterFor(getValueType(value))(value, jsValue);
 }
+const numberValueGType = (jsValue) => Number.isSafeInteger(jsValue) && jsValue >= INT32_MINIMUM && jsValue <= INT32_MAXIMUM ? TYPE_INT : TYPE_DOUBLE;
+const arrayValueGType = (jsValue) => (isStringArray(jsValue) ? getStrvType() : TYPE_INVALID);
+const wideValueGType = (jsValue) => (jsValue > INT64_MAXIMUM ? TYPE_UINT64 : TYPE_INT64);
+const bigintValueGType = (jsValue) => jsValue < INT64_MINIMUM || jsValue > UINT64_MAXIMUM ? TYPE_INVALID : wideValueGType(jsValue);
+const objectValueGType = (jsValue, wrapperType) => {
+    if (jsValue === null) {
+        return TYPE_POINTER;
+    }
+    return Array.isArray(jsValue) ? arrayValueGType(jsValue) : wrapperType;
+};
+function inferValueGType(jsValue, wrapperType) {
+    switch (typeof jsValue) {
+        case "string": {
+            return TYPE_STRING;
+        }
+        case "boolean": {
+            return TYPE_BOOLEAN;
+        }
+        case "number": {
+            return numberValueGType(jsValue);
+        }
+        case "bigint": {
+            return bigintValueGType(jsValue);
+        }
+        case "object": {
+            return objectValueGType(jsValue, wrapperType);
+        }
+        case "function":
+        case "symbol":
+        case "undefined": {
+            return TYPE_INVALID;
+        }
+    }
+}
+const marshalFailure = (jsValue) => typeof jsValue === "bigint"
+    ? `Cannot marshal ${String(jsValue)} into a GObject.Value: outside the range of gint64 and guint64`
+    : `Cannot marshal ${describeValueKind(jsValue)} into a GObject.Value`;
+const wrapperGType = (jsValue) => typeof jsValue === "object" && jsValue !== null ? resolveGtype(jsValue) : TYPE_INVALID;
+/**
+ * Marshals a value passed where a `GObject.Value` is expected into a value handle: an already-built
+ * value yields its own handle, and any other {@link JsValue} is stored in a new one initialized to the
+ * GType inferred from it.
+ * @param jsValue Value to store, or an already-built `GObject.Value`.
+ * @throws {ValueMarshalError} When no GType can be inferred from the value.
+ */
+function toValueHandle(jsValue) {
+    const wrapperType = wrapperGType(jsValue);
+    if (typeIsA(wrapperType, resolveBoxedType(VALUE_T))) {
+        return getHandle(jsValue);
+    }
+    const type = inferValueGType(jsValue, wrapperType);
+    if (type === TYPE_INVALID) {
+        throw new ValueMarshalError(marshalFailure(jsValue));
+    }
+    const value = newValueForType(type);
+    intoValue(value, jsValue);
+    return value;
+}
+/** Same as {@link toValueHandle}, but passes a null or undefined value through as no value at all. */
+const tryToValueHandle = (jsValue) => jsValue == null ? undefined : toValueHandle(jsValue);
+const isValueDescriptor = (descriptor) => descriptor.kind === "boxed" && descriptor.typeName === "GValue";
 const resolveNativeValue = (descriptor, value) => {
     const isHandleKind = descriptor.kind === "object" || descriptor.kind === "boxed";
     if (!isHandleKind) {
         return toNative(descriptor, value);
     }
-    return value == null ? null : getHandle(value);
+    if (value == null) {
+        return null;
+    }
+    return isValueDescriptor(descriptor) ? toValueHandle(value) : getHandle(value);
 };
 const resolveValueGType = (descriptor, nativeValue) => {
     if (descriptor.kind !== "object") {
@@ -322,13 +452,23 @@ const resolveValueGType = (descriptor, nativeValue) => {
     }
     return nativeValue == null ? TYPE_OBJECT : getType(nativeValue);
 };
+const toWholeNumber = (descriptor, value) => typeof value === "number" && Number.isFinite(value) && WHOLE_NUMBER_KINDS.has(descriptor.kind)
+    ? Math.trunc(value)
+    : value;
 function toValue(descriptor, value) {
-    const nativeValue = resolveNativeValue(descriptor, value);
+    const nativeValue = resolveNativeValue(descriptor, toWholeNumber(descriptor, value));
     const type = resolveValueGType(descriptor, nativeValue);
     const gValue = newValueForType(type);
     resolveValueType(descriptor).set(gValue, nativeValue);
     return gValue;
 }
+/**
+ * Reads what a `GObject.Value` holds as its JavaScript form, wrapping an object, boxed, param, variant,
+ * or fundamental payload in the class registered for its GType, and handing back a string, number,
+ * `bigint`, boolean, or array of strings for the rest.
+ * @param value Handle of an initialized value to read.
+ * @throws {Error} When the GType it holds has no JavaScript form, such as a non-null `gpointer`.
+ */
 function fromValue(value) {
     const type = getValueType(value);
     const get = resolveValueGetter(type);
@@ -337,6 +477,17 @@ function fromValue(value) {
     }
     return get(value);
 }
+const fromValueForDescriptor = (descriptor, value) => descriptor.kind === "array" && descriptor.arrayKind === "gbytearray"
+    ? byteArrayValueGetterFor(descriptor.isBytes === true)(value)
+    : fromValue(value);
+const inferredValueGuard = (jsValue) => inferValueGType(jsValue, wrapperGType(jsValue)) !== TYPE_INVALID;
+const byteArrayValueGuard = (jsValue) => jsValue == null || isByteArraySource(jsValue) || typeIsA(resolveGtype(jsValue), getByteArrayType());
+const valueGuardOverrideFor = (valueType) => {
+    if (valueType === resolveBoxedType(VALUE_T)) {
+        return inferredValueGuard;
+    }
+    return valueType === getByteArrayType() ? byteArrayValueGuard : undefined;
+};
 function newValueForDescriptor(descriptor) {
     return newValueForType(resolveDescriptorType(descriptor));
 }
@@ -356,5 +507,10 @@ function outValueForBoxedDescriptor(descriptor, boxed) {
 function inoutValueForBoxedDescriptor(descriptor, boxed) {
     return newBoxedValue(descriptor, boxed, setStaticBoxedBind);
 }
-export { getValueType, intoValue, copyValue, getBoxedValue, setBoxedValue, toValue, fromValue, newValueForDescriptor, newValueForType, outValueForDescriptor, outValueForBoxedDescriptor, inoutValueForBoxedDescriptor, valueNarrowerFor, valueWriterFor, };
+/** Thrown when a value passed where a `GObject.Value` is expected holds no GType one can be built from. */
+class ValueMarshalError extends TypeError {
+    /** Name callers match on when the error is caught as a plain `TypeError`. */
+    name = "ValueMarshalError";
+}
+export { getValueType, intoValue, copyValue, getBoxedValue, setBoxedValue, toValue, toValueHandle, tryToValueHandle, ValueMarshalError, fromValue, fromValueForDescriptor, valueGuardOverrideFor, newValueForDescriptor, newValueForType, outValueForDescriptor, outValueForBoxedDescriptor, inoutValueForBoxedDescriptor, valueNarrowerFor, valueWriterFor, };
 //# sourceMappingURL=value.js.map