@gtkx/runtime 0.0.1 → 1.0.0-rc.2

package/dist/tuple.js

@@ -0,0 +1,26 @@
+const packTupleResult = (outs, primary, hasPrimary) => {
+    if (hasPrimary) {
+        return outs.length === 0 ? primary : [primary, ...outs];
+    }
+    if (outs.length === 0) {
+        return undefined;
+    }
+    if (outs.length === 1) {
+        return outs[0];
+    }
+    return outs;
+};
+const splitTupleResult = (result, hasPrimary, outCount) => {
+    if (hasPrimary) {
+        if (Array.isArray(result)) {
+            return { primary: result[0], outValues: result.slice(1) };
+        }
+        return { primary: result, outValues: [] };
+    }
+    if (outCount === 1) {
+        return { primary: undefined, outValues: [result] };
+    }
+    return { primary: undefined, outValues: Array.isArray(result) ? result : [] };
+};
+export { packTupleResult, splitTupleResult };
+//# sourceMappingURL=tuple.js.map

package/dist/tuple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../src/tuple.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,OAAgB,EAAE,UAAmB,EAAW,EAAE;IACxF,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACrB,MAAe,EACf,UAAmB,EACnB,QAAgB,EAC0B,EAAE;IAC5C,IAAI,UAAU,EAAE,CAAC;QACb,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAClF,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["const packTupleResult = (outs: unknown[], primary: unknown, hasPrimary: boolean): unknown => {\n    if (hasPrimary) {\n        return outs.length === 0 ? primary : [primary, ...outs];\n    }\n\n    if (outs.length === 0) {\n        return undefined;\n    }\n\n    if (outs.length === 1) {\n        return outs[0];\n    }\n\n    return outs;\n};\n\nconst splitTupleResult = (\n    result: unknown,\n    hasPrimary: boolean,\n    outCount: number,\n): { primary: unknown; outValues: unknown[] } => {\n    if (hasPrimary) {\n        if (Array.isArray(result)) {\n            return { primary: result[0], outValues: result.slice(1) };\n        }\n\n        return { primary: result, outValues: [] };\n    }\n\n    if (outCount === 1) {\n        return { primary: undefined, outValues: [result] };\n    }\n\n    return { primary: undefined, outValues: Array.isArray(result) ? result : [] };\n};\n\nexport { packTupleResult, splitTupleResult };\n"]}

package/dist/type.d.ts

@@ -0,0 +1,88 @@
+import { type Descriptor } from "@gtkx/native";
+import { type BoxedDescriptor, type FundamentalDescriptor } from "./descriptors.js";
+/** Object tagged with its GLib type through a `__type__` GType field. */
+type TypedClass = {
+    __type__: bigint;
+};
+type ResolvableKind = "enum" | "flags" | "boxed" | "fundamental" | "array";
+/** Descriptor kinds whose GType is resolved from library metadata rather than a fixed fundamental type. */
+type ResolvableDescriptor = Extract<Descriptor, {
+    kind: ResolvableKind;
+}>;
+/** GType tag for an invalid or uninitialized type. */
+declare const TYPE_INVALID = 0n;
+/** GType tag for the absence of a value (`void`). */
+declare const TYPE_NONE: bigint;
+/** GType tag for the base GInterface type. */
+declare const TYPE_INTERFACE: bigint;
+/** GType tag for `gchar` (signed 8-bit integer). */
+declare const TYPE_CHAR: bigint;
+/** GType tag for `guchar` (unsigned 8-bit integer). */
+declare const TYPE_UCHAR: bigint;
+/** GType tag for `gboolean`. */
+declare const TYPE_BOOLEAN: bigint;
+/** GType tag for `gint`. */
+declare const TYPE_INT: bigint;
+/** GType tag for `guint`. */
+declare const TYPE_UINT: bigint;
+/** GType tag for `glong`. */
+declare const TYPE_LONG: bigint;
+/** GType tag for `gulong`. */
+declare const TYPE_ULONG: bigint;
+/** GType tag for `gint64`. */
+declare const TYPE_INT64: bigint;
+/** GType tag for `guint64`. */
+declare const TYPE_UINT64: bigint;
+/** GType tag for the base GEnum type. */
+declare const TYPE_ENUM: bigint;
+/** GType tag for the base GFlags type. */
+declare const TYPE_FLAGS: bigint;
+/** GType tag for `gfloat`. */
+declare const TYPE_FLOAT: bigint;
+/** GType tag for `gdouble`. */
+declare const TYPE_DOUBLE: bigint;
+/** GType tag for `gchararray` (a nul-terminated C string). */
+declare const TYPE_STRING: bigint;
+/** GType tag for `gpointer` (an opaque pointer). */
+declare const TYPE_POINTER: bigint;
+/** GType tag for the base GBoxed type. */
+declare const TYPE_BOXED: bigint;
+/** GType tag for the base GParam type. */
+declare const TYPE_PARAM: bigint;
+/** GType tag for the base GObject type. */
+declare const TYPE_OBJECT: bigint;
+/** GType tag for a GType value itself. */
+declare const TYPE_GTYPE: bigint;
+/** GType tag for GVariant. */
+declare const TYPE_VARIANT: bigint;
+/** GType tag for a Unicode character stored as `guint`. */
+declare const TYPE_UNICHAR: bigint;
+declare const getErrorType: () => bigint;
+declare const getStrvType: () => bigint;
+declare const isTypedClass: (value: unknown) => value is TypedClass;
+/** Returns whether `type` is `ancestorType` or descends from it. */
+declare function typeIsA(type: bigint, ancestorType: bigint): boolean;
+/** Returns the immediate parent GType of the given type. */
+declare function typeParent(type: bigint): bigint;
+/** Returns the GTypes of the interfaces implemented by the given type. */
+declare function typeInterfaces(type: bigint): bigint[];
+/** Returns the GType registered under the given name, or `TYPE_INVALID` if none exists. */
+declare function typeFromName(name: string): bigint;
+declare function typeFundamental(type: bigint): bigint;
+/** Returns the registered name of a GType, or null if it has none. */
+declare function typeName(type: bigint): string | null;
+/** Returns whether `value` is a typed wrapper whose GType is or descends from `gtype`. */
+declare function valueIsA(value: unknown, gtype: bigint): boolean;
+/**
+ * Resolves the GType produced by a `get_type` function in a shared library, caching
+ * the result per library and function name.
+ * @param sharedLibrary Path or name of the shared library exporting the function.
+ * @param typeFnName Name of the `*_get_type` function to call.
+ */
+declare const resolveType: (sharedLibrary: string, typeFnName: string) => bigint;
+declare const resolveBoxedType: (descriptor: BoxedDescriptor) => bigint;
+declare const resolveFundamentalType: (descriptor: FundamentalDescriptor) => 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 ResolvableDescriptor, type TypedClass, };
+//# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

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

package/dist/type.js

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

package/dist/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAEH,UAAU,EACV,QAAQ,EAGR,IAAI,EACJ,WAAW,EACX,OAAO,EACP,OAAO,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAWnC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,EAAE,CAAC;AACzD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC9E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AACnF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACxH,sDAAsD;AACtD,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,qDAAqD;AACrD,MAAM,SAAS,GAAW,YAAY,CAAC,MAAM,CAAC,CAAC;AAC/C,8CAA8C;AAC9C,MAAM,cAAc,GAAW,YAAY,CAAC,YAAY,CAAC,CAAC;AAC1D,oDAAoD;AACpD,MAAM,SAAS,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AAChD,uDAAuD;AACvD,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,gCAAgC;AAChC,MAAM,YAAY,GAAW,YAAY,CAAC,UAAU,CAAC,CAAC;AACtD,4BAA4B;AAC5B,MAAM,QAAQ,GAAW,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9C,6BAA6B;AAC7B,MAAM,SAAS,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AAChD,6BAA6B;AAC7B,MAAM,SAAS,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AAChD,8BAA8B;AAC9B,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,8BAA8B;AAC9B,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,+BAA+B;AAC/B,MAAM,WAAW,GAAW,YAAY,CAAC,SAAS,CAAC,CAAC;AACpD,yCAAyC;AACzC,MAAM,SAAS,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AAChD,0CAA0C;AAC1C,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,8BAA8B;AAC9B,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,+BAA+B;AAC/B,MAAM,WAAW,GAAW,YAAY,CAAC,SAAS,CAAC,CAAC;AACpD,8DAA8D;AAC9D,MAAM,WAAW,GAAW,YAAY,CAAC,YAAY,CAAC,CAAC;AACvD,oDAAoD;AACpD,MAAM,YAAY,GAAW,YAAY,CAAC,UAAU,CAAC,CAAC;AACtD,0CAA0C;AAC1C,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,0CAA0C;AAC1C,MAAM,UAAU,GAAW,YAAY,CAAC,QAAQ,CAAC,CAAC;AAClD,2CAA2C;AAC3C,MAAM,WAAW,GAAW,YAAY,CAAC,SAAS,CAAC,CAAC;AACpD,0CAA0C;AAC1C,MAAM,UAAU,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AACjD,8BAA8B;AAC9B,MAAM,YAAY,GAAW,YAAY,CAAC,UAAU,CAAC,CAAC;AACtD,2DAA2D;AAC3D,MAAM,YAAY,GAAW,YAAY,CAAC,OAAO,CAAC,CAAC;AACnD,MAAM,YAAY,GAAiB,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtD,MAAM,WAAW,GAAiB,QAAQ,CAAC,OAAO,CAAC,CAAC;AAEpD,MAAM,sBAAsB,GAAgD;IACxE,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,WAAW;CACtB,CAAC;AAEF,MAAM,2BAA2B,GAA4B,IAAI,GAAG,CAAiB;IACjF,MAAM;IACN,OAAO;IACP,OAAO;IACP,aAAa;IACb,OAAO;CACV,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,IAAY;IAC1B,IAAI,MAA0B,CAAC;IAE/B,OAAO,GAAG,EAAE;QACR,MAAM,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;QAE9B,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE,CACzD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAE7G,oEAAoE;AACpE,SAAS,OAAO,CAAC,IAAY,EAAE,YAAoB;IAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAY,CAAC;AACnD,CAAC;AAED,4DAA4D;AAC5D,SAAS,UAAU,CAAC,IAAY;IAC5B,OAAO,WAAW,CAAC,IAAI,CAAW,CAAC;AACvC,CAAC;AAED,0EAA0E;AAC1E,SAAS,cAAc,CAAC,IAAY;IAChC,MAAM,cAAc,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAEpC,OAAO,eAAe,CAAC,IAAI,EAAE,cAAc,CAAa,CAAC;AAC7D,CAAC;AAED,2FAA2F;AAC3F,SAAS,YAAY,CAAC,IAAY;IAC9B,OAAO,aAAa,CAAC,IAAI,CAAW,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACjC,OAAO,gBAAgB,CAAC,IAAI,CAAW,CAAC;AAC5C,CAAC;AAED,sEAAsE;AACtE,SAAS,QAAQ,CAAC,IAAY;IAC1B,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAkB,CAAC;AACtD,CAAC;AAED,0FAA0F;AAC1F,SAAS,QAAQ,CAAC,KAAc,EAAE,KAAa;IAC3C,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,aAAqB,EAAE,UAAkB,EAAU,EAAE;IACtE,MAAM,GAAG,GAAG,GAAG,aAAa,IAAI,UAAU,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC3D,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,UAA2B,EAAU,EAAE;IAC7D,IAAI,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;QACvD,OAAO,WAAW,CAAC,UAAU,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,UAAiC,EAAU,EAAE;IACzE,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEhD,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,SAAS,gBAAgB,CAAC,UAA2B;IACjD,IAAI,UAAU,CAAC,cAAc,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QAClF,OAAO,WAAW,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,CAAC,SAAS,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAsB;IAClD,OAAO,2BAA2B,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAsB;IACjD,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;QAC1D,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,OAAO,WAAW,CAAC,UAAU,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACjB,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;AACL,CAAC;AAED,OAAO,EACH,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,YAAY,EACZ,OAAO,EACP,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GAGxB,CAAC","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    __type__: bigint;\n};\n\ntype ResolvableKind = \"enum\" | \"flags\" | \"boxed\" | \"fundamental\" | \"array\";\n/** Descriptor kinds whose GType is resolved from library metadata rather than a fixed fundamental type. */\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. */\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`. */\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 ResolvableDescriptor,\n    type TypedClass,\n};\n"]}

package/dist/value.d.ts

@@ -0,0 +1,29 @@
+import { type Descriptor, type ExternalObject, type Handle } from "@gtkx/native";
+declare function getValueType(value: ExternalObject<Handle>): bigint;
+declare function copyValue(dest: ExternalObject<Handle>, src: ExternalObject<Handle>): void;
+/**
+ * Reads the boxed pointer out of a GValue and returns it wrapped in its registered
+ * class, or null when the value does not hold a boxed type.
+ */
+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 JavaScript value into an already-initialized GValue, converting it to
+ * whatever type the GValue holds.
+ *
+ * @param value The initialized GValue to write into.
+ * @param jsValue The JavaScript value to store.
+ */
+declare function intoValue(value: ExternalObject<Handle>, jsValue: unknown): void;
+declare function toValue(descriptor: Descriptor, value: unknown): ExternalObject<Handle>;
+declare function fromValue(value: ExternalObject<Handle>): unknown;
+declare function newValueForDescriptor(descriptor: Descriptor): ExternalObject<Handle>;
+declare function outValueForDescriptor(descriptor: Descriptor, initial?: unknown): {
+    value: ExternalObject<Handle>;
+    read: () => 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, outValueForDescriptor, outValueForBoxedDescriptor, inoutValueForBoxedDescriptor, };
+//# sourceMappingURL=value.d.ts.map

package/dist/value.d.ts.map

@@ -0,0 +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;AAmL9G,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;AAqBD;;;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;AAgGD;;;;;;GAMG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CASxE;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,CAczD;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,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC/B,CAAC"}