@gtkx/runtime 1.2.0 → 1.2.2

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export { resolveType, TYPE_BOOLEAN, TYPE_BOXED, TYPE_CHAR, TYPE_DOUBLE, TYPE_ENU
 /** @public */
 export { getBoxedValue, setBoxedValue } from "./value.js";
 /** @public */
+export { fromVariant, toVariant, type VariantValue } from "./variant.js";
+/** @public */
 export { callParent, callVfunc } from "./vfunc-call.js";
 /** @public */
 export { alloc, type ExternalObject, type Handle, read, write } from "@gtkx/native";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/G,cAAc;AACd,OAAO,EAAE,KAAK,eAAe,EAAE,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC1G,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACvD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,cAAc;AACd,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GACpB,MAAM,aAAa,CAAC;AACrB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc;AACd,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,cAAc;AACd,OAAO,EACH,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,UAAU,EACf,SAAS,EACT,UAAU,GACb,MAAM,eAAe,CAAC;AACvB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACjH,cAAc;AACd,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,cAAc;AACd,OAAO,EACH,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,KAAK,UAAU,EACf,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,GACX,MAAM,WAAW,CAAC;AACnB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpF,cAAc;AACd,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/G,cAAc;AACd,OAAO,EAAE,KAAK,eAAe,EAAE,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC1G,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACvD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,cAAc;AACd,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GACpB,MAAM,aAAa,CAAC;AACrB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc;AACd,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,cAAc;AACd,OAAO,EACH,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,UAAU,EACf,SAAS,EACT,UAAU,GACb,MAAM,eAAe,CAAC;AACvB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACjH,cAAc;AACd,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,cAAc;AACd,OAAO,EACH,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,KAAK,UAAU,EACf,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,GACX,MAAM,WAAW,CAAC;AACnB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,cAAc;AACd,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACzE,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpF,cAAc;AACd,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -30,6 +30,8 @@ export { resolveType, TYPE_BOOLEAN, TYPE_BOXED, TYPE_CHAR, TYPE_DOUBLE, TYPE_ENU
 /** @public */
 export { getBoxedValue, setBoxedValue } from "./value.js";
 /** @public */
+export { fromVariant, toVariant } from "./variant.js";
+/** @public */
 export { callParent, callVfunc } from "./vfunc-call.js";
 /** @public */
 export { alloc, read, write } from "@gtkx/native";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAsD,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/G,cAAc;AACd,OAAO,EAAwB,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAC1G,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AACvD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,cAAc;AACd,OAAO,EAGH,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GACpB,MAAM,aAAa,CAAC;AACrB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc;AACd,OAAO,EAAkB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,cAAc;AACd,OAAO,EACH,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EAEpB,SAAS,EACT,UAAU,GACb,MAAM,eAAe,CAAC;AACvB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACjH,cAAc;AACd,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,cAAc;AACd,OAAO,EACH,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,GACX,MAAM,WAAW,CAAC;AACnB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc;AACd,OAAO,EAAE,KAAK,EAAoC,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpF,cAAc;AACd,OAAO,EAAiB,MAAM,aAAa,CAAC","sourcesContent":["import \"./exit-hook.js\";\n\n/** @public */\nexport { type ApplicationClass, type CommandLineApplication, createApplication } from \"./application-class.js\";\n/** @public */\nexport { type ClosureCallback, ClosureMarshalError, toClosure, tryToClosure } from \"./closure.js\";\n/** @public */\nexport { createErrorDomain, type ErrorDomain } from \"./error.js\";\n/** @public */\nexport { onExit, quit, quitApplication, runApplication, type RunApplicationResult } from \"./lifecycle.js\";\n/** @public */\nexport { offSignal, onceSignal, onSignal } from \"./listeners.js\";\n/** @public */\nexport { installMixins, type Mixin } from \"./mixin.js\";\n/** @public */\nexport { fromNative, toNative } from \"./native-value.js\";\n/** @public */\nexport {\n    type ConstructBinding,\n    type ConstructBindings,\n    getObjectProperty,\n    newObjectWithProperties,\n    registerConstructProperties,\n    setObjectProperty,\n} from \"./object.js\";\n/** @public */\nexport { promisify } from \"./promisify.js\";\n/** @public */\nexport { type Interface, registerClass } from \"./register-class.js\";\n/** @public */\nexport {\n    getClassType,\n    getHandle,\n    getInstanceType,\n    getWrapperClass,\n    registerInterface,\n    registerWrapperClass,\n    type StaticBase,\n    setHandle,\n    wrapHandle,\n} from \"./registry.js\";\n/** @public */\nexport { connectSignal, disconnectSignal, emitSignal, getSignalBaseName, type SignalHandler } from \"./signal.js\";\n/** @public */\nexport { t } from \"./t.js\";\n/** @public */\nexport {\n    resolveType,\n    TYPE_BOOLEAN,\n    TYPE_BOXED,\n    TYPE_CHAR,\n    TYPE_DOUBLE,\n    TYPE_ENUM,\n    TYPE_FLAGS,\n    TYPE_FLOAT,\n    TYPE_GTYPE,\n    TYPE_INT,\n    TYPE_INT64,\n    TYPE_INTERFACE,\n    TYPE_INVALID,\n    TYPE_LONG,\n    TYPE_NONE,\n    TYPE_OBJECT,\n    TYPE_PARAM,\n    TYPE_POINTER,\n    TYPE_STRING,\n    TYPE_UCHAR,\n    TYPE_UINT,\n    TYPE_UINT64,\n    TYPE_ULONG,\n    TYPE_UNICHAR,\n    TYPE_VARIANT,\n    type TypedClass,\n    typeFromName,\n    typeInterfaces,\n    typeIsA,\n    typeName,\n    typeParent,\n    valueIsA,\n} from \"./type.js\";\n/** @public */\nexport { getBoxedValue, setBoxedValue } from \"./value.js\";\n/** @public */\nexport { callParent, callVfunc } from \"./vfunc-call.js\";\n/** @public */\nexport { alloc, type ExternalObject, type Handle, read, write } from \"@gtkx/native\";\n/** @public */\nexport { type AnyClass } from \"@gtkx/utils\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAsD,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/G,cAAc;AACd,OAAO,EAAwB,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAC1G,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjE,cAAc;AACd,OAAO,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AACvD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,cAAc;AACd,OAAO,EAGH,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,GACpB,MAAM,aAAa,CAAC;AACrB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc;AACd,OAAO,EAAkB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,cAAc;AACd,OAAO,EACH,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EAEpB,SAAS,EACT,UAAU,GACb,MAAM,eAAe,CAAC;AACvB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACjH,cAAc;AACd,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,cAAc;AACd,OAAO,EACH,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,GACX,MAAM,WAAW,CAAC;AACnB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,cAAc;AACd,OAAO,EAAE,WAAW,EAAE,SAAS,EAAqB,MAAM,cAAc,CAAC;AACzE,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc;AACd,OAAO,EAAE,KAAK,EAAoC,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpF,cAAc;AACd,OAAO,EAAiB,MAAM,aAAa,CAAC","sourcesContent":["import \"./exit-hook.js\";\n\n/** @public */\nexport { type ApplicationClass, type CommandLineApplication, createApplication } from \"./application-class.js\";\n/** @public */\nexport { type ClosureCallback, ClosureMarshalError, toClosure, tryToClosure } from \"./closure.js\";\n/** @public */\nexport { createErrorDomain, type ErrorDomain } from \"./error.js\";\n/** @public */\nexport { onExit, quit, quitApplication, runApplication, type RunApplicationResult } from \"./lifecycle.js\";\n/** @public */\nexport { offSignal, onceSignal, onSignal } from \"./listeners.js\";\n/** @public */\nexport { installMixins, type Mixin } from \"./mixin.js\";\n/** @public */\nexport { fromNative, toNative } from \"./native-value.js\";\n/** @public */\nexport {\n    type ConstructBinding,\n    type ConstructBindings,\n    getObjectProperty,\n    newObjectWithProperties,\n    registerConstructProperties,\n    setObjectProperty,\n} from \"./object.js\";\n/** @public */\nexport { promisify } from \"./promisify.js\";\n/** @public */\nexport { type Interface, registerClass } from \"./register-class.js\";\n/** @public */\nexport {\n    getClassType,\n    getHandle,\n    getInstanceType,\n    getWrapperClass,\n    registerInterface,\n    registerWrapperClass,\n    type StaticBase,\n    setHandle,\n    wrapHandle,\n} from \"./registry.js\";\n/** @public */\nexport { connectSignal, disconnectSignal, emitSignal, getSignalBaseName, type SignalHandler } from \"./signal.js\";\n/** @public */\nexport { t } from \"./t.js\";\n/** @public */\nexport {\n    resolveType,\n    TYPE_BOOLEAN,\n    TYPE_BOXED,\n    TYPE_CHAR,\n    TYPE_DOUBLE,\n    TYPE_ENUM,\n    TYPE_FLAGS,\n    TYPE_FLOAT,\n    TYPE_GTYPE,\n    TYPE_INT,\n    TYPE_INT64,\n    TYPE_INTERFACE,\n    TYPE_INVALID,\n    TYPE_LONG,\n    TYPE_NONE,\n    TYPE_OBJECT,\n    TYPE_PARAM,\n    TYPE_POINTER,\n    TYPE_STRING,\n    TYPE_UCHAR,\n    TYPE_UINT,\n    TYPE_UINT64,\n    TYPE_ULONG,\n    TYPE_UNICHAR,\n    TYPE_VARIANT,\n    type TypedClass,\n    typeFromName,\n    typeInterfaces,\n    typeIsA,\n    typeName,\n    typeParent,\n    valueIsA,\n} from \"./type.js\";\n/** @public */\nexport { getBoxedValue, setBoxedValue } from \"./value.js\";\n/** @public */\nexport { fromVariant, toVariant, type VariantValue } from \"./variant.js\";\n/** @public */\nexport { callParent, callVfunc } from \"./vfunc-call.js\";\n/** @public */\nexport { alloc, type ExternalObject, type Handle, read, write } from \"@gtkx/native\";\n/** @public */\nexport { type AnyClass } from \"@gtkx/utils\";\n"]}

package/dist/variant.d.ts

@@ -0,0 +1,85 @@
+import * as GLib from "@gtkx/gi/glib";
+/** JavaScript type every GVariant basic type code unpacks to. */
+type BasicValueMap = {
+    /** Boolean, held as a single byte reading 0 or 1. */
+    b: boolean;
+    /** Unsigned byte. */
+    y: number;
+    /** Signed 16-bit integer. */
+    n: number;
+    /** Unsigned 16-bit integer. */
+    q: number;
+    /** Signed 32-bit integer. */
+    i: number;
+    /** Unsigned 32-bit integer. */
+    u: number;
+    /** Index into the file descriptor list a message carries. */
+    h: number;
+    /** Double precision floating point number. */
+    d: number;
+    /** Signed 64-bit integer. */
+    x: bigint;
+    /** Unsigned 64-bit integer. */
+    t: bigint;
+    /** UTF-8 string, under no further constraint on what it holds. */
+    s: string;
+    /** D-Bus object path. */
+    o: string;
+    /** GVariant type signature. */
+    g: string;
+    /** Boxed variant holding a value of any type. */
+    v: GLib.Variant;
+};
+/** Single-character code of one of the GVariant basic types in {@link BasicValueMap}. */
+type BasicCode = keyof BasicValueMap;
+/** Parses the element type of an array, yielding the array type it produces and the rest of the string. */
+type ParseArray<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V[], R] : never;
+/** Parses the element type of a maybe, yielding the nullable type it produces and the rest of the string. */
+type ParseMaybe<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V | null, R] : never;
+/** Collects tuple member types into `Acc` up to the closing parenthesis, yielding them and the rest of the string. */
+type ParseTuple<S extends string, Acc extends unknown[]> = S extends `)${infer Rest}` ? [Acc, Rest] : [Parse<S>] extends [never] ? never : Parse<S> extends [infer V, infer R extends string] ? ParseTuple<R, [...Acc, V]> : never;
+/** Types a dictionary entry key can hold. */
+type DictKey = string | number | bigint | boolean;
+/** Parses the key and value types of a dictionary entry, yielding them and the rest of the string after its brace. */
+type ParsePair<S extends string> = Parse<S> extends [infer K, infer R1 extends string] ? Parse<R1> extends [infer V, infer R2 extends string] ? R2 extends `}${infer R3}` ? [K] extends [DictKey] ? [K, V, R3] : never : never : never : never;
+/**
+ * Parses a dictionary entry into the collection an array of those entries unpacks to, a record for string keys and a
+ * `Map` otherwise, plus the rest of the string.
+ */
+type ParseDict<S extends string> = ParsePair<S> extends [infer K, infer V, infer R extends string] ? [[K] extends [string] ? Record<string, V> : Map<K, V>, R] : never;
+/** Parses a standalone dictionary entry into a key and value pair, yielding it and the rest of the string. */
+type ParseEntry<S extends string> = ParsePair<S> extends [infer K, infer V, infer R extends string] ? [[K, V], R] : never;
+/** Parses what follows an `a` as a dictionary when it opens an entry, and as a plain array otherwise. */
+type ParseArrayOrDict<S extends string> = S extends `{${infer Rest}` ? ParseDict<Rest> : ParseArray<S>;
+/**
+ * Parses the type at the head of `S`, yielding the JavaScript type it unpacks to and the rest of the string, or
+ * `never` when the string is malformed.
+ */
+type Parse<S extends string> = S extends `a${infer Rest}` ? ParseArrayOrDict<Rest> : S extends `m${infer Rest}` ? ParseMaybe<Rest> : S extends `(${infer Rest}` ? ParseTuple<Rest, []> : S extends `{${infer Rest}` ? ParseEntry<Rest> : S extends `${infer C}${infer Rest}` ? C extends BasicCode ? [BasicValueMap[C], Rest] : never : never;
+/** JavaScript type a variant of type string `S` unpacks to, or `unknown` when `S` is not one complete type. */
+type VariantValue<S extends string> = [Parse<S>] extends [never] ? unknown : Parse<S> extends [infer V, ""] ? V : unknown;
+/**
+ * Packs a JavaScript value into the `GLib.Variant` a GVariant type string describes, building the
+ * nested arrays, dictionaries, tuples and maybes the type calls for. A type string given as a
+ * literal also types `value`, so `"as"` takes an array of strings, `"a{sv}"` a record of variants,
+ * `"(si)"` a string and a number pair, and a 64-bit type a `bigint`.
+ * @param typeString GVariant type of the variant to build, such as `"a{sv}"`.
+ * @param value Value to pack, shaped the way `typeString` describes.
+ * @returns The packed variant.
+ * @throws {Error} When the type string is not one complete GVariant type, or when a value packed as
+ * an object path or a type signature is not a valid one.
+ */
+declare const toVariant: <S extends string>(typeString: S, value: VariantValue<S>) => GLib.Variant;
+/**
+ * Unpacks a `GLib.Variant` into the JavaScript value a GVariant type string describes, the inverse
+ * of {@link toVariant}. A dictionary keyed by strings unpacks to a record and one keyed by anything
+ * else to a `Map`, an array to an array, a tuple to an array of its members, a maybe to its value or
+ * `null`, and a nested variant to the `GLib.Variant` itself.
+ * @param typeString GVariant type the variant holds, such as `"a{sv}"`.
+ * @param variant Variant to read, which has to hold that type.
+ * @returns The unpacked value, typed from `typeString` when it is given as a literal.
+ * @throws {Error} When the type string is not one complete GVariant type.
+ */
+declare const fromVariant: <S extends string>(typeString: S, variant: GLib.Variant) => VariantValue<S>;
+export { fromVariant, toVariant, type VariantValue };
+//# sourceMappingURL=variant.d.ts.map

package/dist/variant.d.ts.map

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

package/dist/variant.js

@@ -0,0 +1,220 @@
+import * as GLib from "@gtkx/gi/glib";
+const BASIC_CODES = "bynqiuxthdsogv";
+const STRING_KEY_CODES = new Set(["s", "o", "g"]);
+const CONTAINER_PARSERS = {
+    a: parseArrayNode,
+    m: parseMaybeNode,
+    "(": parseTupleNode,
+    "{": parseEntryNode,
+};
+const parsedTypes = new Map();
+const unpackBasic = {
+    b: (variant) => variant.getBoolean(),
+    y: (variant) => variant.getByte(),
+    n: (variant) => variant.getInt16(),
+    q: (variant) => variant.getUint16(),
+    i: (variant) => variant.getInt32(),
+    u: (variant) => variant.getUint32(),
+    h: (variant) => variant.getHandle(),
+    d: (variant) => variant.getDouble(),
+    x: (variant) => variant.getInt64(),
+    t: (variant) => variant.getUint64(),
+    s: (variant) => variant.getString()[0],
+    o: (variant) => variant.getString()[0],
+    g: (variant) => variant.getString()[0],
+    v: (variant) => variant.getVariant(),
+};
+const packBasic = {
+    b: (value) => GLib.Variant.newBoolean(value),
+    y: (value) => GLib.Variant.newByte(value),
+    n: (value) => GLib.Variant.newInt16(value),
+    q: (value) => GLib.Variant.newUint16(value),
+    i: (value) => GLib.Variant.newInt32(value),
+    u: (value) => GLib.Variant.newUint32(value),
+    h: (value) => GLib.Variant.newHandle(value),
+    d: (value) => GLib.Variant.newDouble(value),
+    x: (value) => GLib.Variant.newInt64(value),
+    t: (value) => GLib.Variant.newUint64(value),
+    s: (value) => GLib.Variant.newString(value),
+    o: packObjectPath,
+    g: packSignature,
+    v: (value) => GLib.Variant.newVariant(value),
+};
+const isBasicCode = (code) => BASIC_CODES.includes(code);
+const isStringKeyed = (key) => key.kind === "basic" && STRING_KEY_CODES.has(key.code);
+const invalidType = (source) => new Error(`Invalid GVariant type string "${source}"`);
+const parsePair = (source, start) => {
+    const [key, keyEnd] = parseNode(source, start);
+    if (key.kind !== "basic" || key.code === "v") {
+        throw invalidType(source);
+    }
+    const [value, valueEnd] = parseNode(source, keyEnd);
+    if (source[valueEnd] !== "}") {
+        throw invalidType(source);
+    }
+    return [key, value, valueEnd + 1];
+};
+function parseArrayNode(source, start) {
+    if (source[start] === "{") {
+        const [key, value, end] = parsePair(source, start + 1);
+        return [{ kind: "dict", entryTypeString: source.slice(start, end), key, value }, end];
+    }
+    const [element, end] = parseNode(source, start);
+    return [{ kind: "array", elementTypeString: source.slice(start, end), element }, end];
+}
+function parseMaybeNode(source, start) {
+    const [element, end] = parseNode(source, start);
+    return [{ kind: "maybe", elementTypeString: source.slice(start, end), element }, end];
+}
+function parseTupleNode(source, start) {
+    const items = [];
+    let position = start;
+    while (source[position] !== ")") {
+        if (position >= source.length) {
+            throw invalidType(source);
+        }
+        const [item, end] = parseNode(source, position);
+        items.push(item);
+        position = end;
+    }
+    return [{ kind: "tuple", items }, position + 1];
+}
+function parseEntryNode(source, start) {
+    const [key, value, end] = parsePair(source, start);
+    return [{ kind: "entry", key, value }, end];
+}
+const parseNode = (source, start) => {
+    const code = source[start];
+    if (code === undefined) {
+        throw invalidType(source);
+    }
+    const container = CONTAINER_PARSERS[code];
+    if (container !== undefined) {
+        return container(source, start + 1);
+    }
+    if (isBasicCode(code)) {
+        return [{ kind: "basic", code }, start + 1];
+    }
+    throw invalidType(source);
+};
+const parseVariantType = (typeString) => {
+    const cached = parsedTypes.get(typeString);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const [node, end] = parseNode(typeString, 0);
+    if (end !== typeString.length) {
+        throw invalidType(typeString);
+    }
+    parsedTypes.set(typeString, node);
+    return node;
+};
+const unpackChildren = (variant, unpackChild) => {
+    const children = [];
+    const count = variant.nChildren();
+    for (let index = 0; index < count; index += 1) {
+        children.push(unpackChild(variant.getChildValue(index)));
+    }
+    return children;
+};
+const unpackPair = (key, value, entry) => [
+    unpackNode(key, entry.getChildValue(0)),
+    unpackNode(value, entry.getChildValue(1)),
+];
+const unpackDict = (node, variant) => {
+    const entries = unpackChildren(variant, (entry) => unpackPair(node.key, node.value, entry));
+    if (!isStringKeyed(node.key)) {
+        return new Map(entries);
+    }
+    const stringEntries = entries.map(([key, value]) => [key, value]);
+    return Object.fromEntries(stringEntries);
+};
+const unpackMaybe = (element, variant) => {
+    const child = variant.getMaybe();
+    return child === null ? null : unpackNode(element, child);
+};
+const unpackNode = (node, variant) => {
+    switch (node.kind) {
+        case "basic": {
+            return unpackBasic[node.code](variant);
+        }
+        case "array": {
+            return unpackChildren(variant, (child) => unpackNode(node.element, child));
+        }
+        case "dict": {
+            return unpackDict(node, variant);
+        }
+        case "entry": {
+            return unpackPair(node.key, node.value, variant);
+        }
+        case "tuple": {
+            return node.items.map((item, index) => unpackNode(item, variant.getChildValue(index)));
+        }
+        case "maybe": {
+            return unpackMaybe(node.element, variant);
+        }
+    }
+};
+const packValidatedString = (value, isValid, description, construct) => {
+    if (typeof value !== "string" || !isValid(value)) {
+        throw new Error(`"${String(value)}" is not a valid GVariant ${description}`);
+    }
+    return construct(value);
+};
+function packObjectPath(value) {
+    return packValidatedString(value, (path) => GLib.Variant.isObjectPath(path), "object path", (path) => GLib.Variant.newObjectPath(path));
+}
+function packSignature(value) {
+    return packValidatedString(value, (signature) => GLib.Variant.isSignature(signature), "type signature", (signature) => GLib.Variant.newSignature(signature));
+}
+const packEntry = (key, value, pair) => GLib.Variant.newDictEntry(packNode(key, pair[0]), packNode(value, pair[1]));
+const dictEntries = (value) => value instanceof Map ? [...value] : Object.entries(value);
+const packDict = (node, value) => GLib.Variant.newArray(GLib.VariantType.new(node.entryTypeString), dictEntries(value).map((pair) => packEntry(node.key, node.value, pair)));
+const packMaybe = (node, value) => GLib.Variant.newMaybe(GLib.VariantType.new(node.elementTypeString), value === null ? null : packNode(node.element, value));
+const packNode = (node, value) => {
+    switch (node.kind) {
+        case "basic": {
+            return packBasic[node.code](value);
+        }
+        case "array": {
+            return GLib.Variant.newArray(GLib.VariantType.new(node.elementTypeString), value.map((item) => packNode(node.element, item)));
+        }
+        case "dict": {
+            return packDict(node, value);
+        }
+        case "entry": {
+            return packEntry(node.key, node.value, value);
+        }
+        case "tuple": {
+            return GLib.Variant.newTuple(node.items.map((item, index) => packNode(item, value[index])));
+        }
+        case "maybe": {
+            return packMaybe(node, value);
+        }
+    }
+};
+/**
+ * Packs a JavaScript value into the `GLib.Variant` a GVariant type string describes, building the
+ * nested arrays, dictionaries, tuples and maybes the type calls for. A type string given as a
+ * literal also types `value`, so `"as"` takes an array of strings, `"a{sv}"` a record of variants,
+ * `"(si)"` a string and a number pair, and a 64-bit type a `bigint`.
+ * @param typeString GVariant type of the variant to build, such as `"a{sv}"`.
+ * @param value Value to pack, shaped the way `typeString` describes.
+ * @returns The packed variant.
+ * @throws {Error} When the type string is not one complete GVariant type, or when a value packed as
+ * an object path or a type signature is not a valid one.
+ */
+const toVariant = (typeString, value) => packNode(parseVariantType(typeString), value);
+/**
+ * Unpacks a `GLib.Variant` into the JavaScript value a GVariant type string describes, the inverse
+ * of {@link toVariant}. A dictionary keyed by strings unpacks to a record and one keyed by anything
+ * else to a `Map`, an array to an array, a tuple to an array of its members, a maybe to its value or
+ * `null`, and a nested variant to the `GLib.Variant` itself.
+ * @param typeString GVariant type the variant holds, such as `"a{sv}"`.
+ * @param variant Variant to read, which has to hold that type.
+ * @returns The unpacked value, typed from `typeString` when it is given as a literal.
+ * @throws {Error} When the type string is not one complete GVariant type.
+ */
+const fromVariant = (typeString, variant) => unpackNode(parseVariantType(typeString), variant);
+export { fromVariant, toVariant };
+//# sourceMappingURL=variant.js.map

package/dist/variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.js","sourceRoot":"","sources":["../src/variant.ts"],"names":[],"mappings":"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","sourcesContent":["import * as GLib from \"@gtkx/gi/glib\";\n\n/** JavaScript type every GVariant basic type code unpacks to. */\ntype BasicValueMap = {\n    /** Boolean, held as a single byte reading 0 or 1. */\n    b: boolean;\n    /** Unsigned byte. */\n    y: number;\n    /** Signed 16-bit integer. */\n    n: number;\n    /** Unsigned 16-bit integer. */\n    q: number;\n    /** Signed 32-bit integer. */\n    i: number;\n    /** Unsigned 32-bit integer. */\n    u: number;\n    /** Index into the file descriptor list a message carries. */\n    h: number;\n    /** Double precision floating point number. */\n    d: number;\n    /** Signed 64-bit integer. */\n    x: bigint;\n    /** Unsigned 64-bit integer. */\n    t: bigint;\n    /** UTF-8 string, under no further constraint on what it holds. */\n    s: string;\n    /** D-Bus object path. */\n    o: string;\n    /** GVariant type signature. */\n    g: string;\n    /** Boxed variant holding a value of any type. */\n    v: GLib.Variant;\n};\n\n/** Single-character code of one of the GVariant basic types in {@link BasicValueMap}. */\ntype BasicCode = keyof BasicValueMap;\n/** Parses the element type of an array, yielding the array type it produces and the rest of the string. */\ntype ParseArray<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V[], R] : never;\n/** Parses the element type of a maybe, yielding the nullable type it produces and the rest of the string. */\ntype ParseMaybe<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V | null, R] : never;\n\n/** Collects tuple member types into `Acc` up to the closing parenthesis, yielding them and the rest of the string. */\ntype ParseTuple<S extends string, Acc extends unknown[]> = S extends `)${infer Rest}`\n    ? [Acc, Rest]\n    : [Parse<S>] extends [never]\n            ? never\n            : Parse<S> extends [infer V, infer R extends string]\n                ? ParseTuple<R, [...Acc, V]>\n                : never;\n\n/** Types a dictionary entry key can hold. */\ntype DictKey = string | number | bigint | boolean;\n\n/** Parses the key and value types of a dictionary entry, yielding them and the rest of the string after its brace. */\ntype ParsePair<S extends string> =\n    Parse<S> extends [infer K, infer R1 extends string]\n        ? Parse<R1> extends [infer V, infer R2 extends string]\n            ? R2 extends `}${infer R3}`\n                ? [K] extends [DictKey]\n                        ? [K, V, R3]\n                        : never\n                : never\n            : never\n        : never;\n\n/**\n * Parses a dictionary entry into the collection an array of those entries unpacks to, a record for string keys and a\n * `Map` otherwise, plus the rest of the string.\n */\ntype ParseDict<S extends string> =\n    ParsePair<S> extends [infer K, infer V, infer R extends string]\n        ? [[K] extends [string] ? Record<string, V> : Map<K, V>, R]\n        : never;\n\n/** Parses a standalone dictionary entry into a key and value pair, yielding it and the rest of the string. */\ntype ParseEntry<S extends string> =\n    ParsePair<S> extends [infer K, infer V, infer R extends string] ? [[K, V], R] : never;\n\n/** Parses what follows an `a` as a dictionary when it opens an entry, and as a plain array otherwise. */\ntype ParseArrayOrDict<S extends string> = S extends `{${infer Rest}` ? ParseDict<Rest> : ParseArray<S>;\n\n/**\n * Parses the type at the head of `S`, yielding the JavaScript type it unpacks to and the rest of the string, or\n * `never` when the string is malformed.\n */\ntype Parse<S extends string> = S extends `a${infer Rest}`\n    ? ParseArrayOrDict<Rest>\n    : S extends `m${infer Rest}`\n        ? ParseMaybe<Rest>\n        : S extends `(${infer Rest}`\n            ? ParseTuple<Rest, []>\n            : S extends `{${infer Rest}`\n                ? ParseEntry<Rest>\n                : S extends `${infer C}${infer Rest}`\n                    ? C extends BasicCode\n                        ? [BasicValueMap[C], Rest]\n                        : never\n                    : never;\n\n/** JavaScript type a variant of type string `S` unpacks to, or `unknown` when `S` is not one complete type. */\ntype VariantValue<S extends string> = [Parse<S>] extends [never]\n    ? unknown\n    : Parse<S> extends [infer V, \"\"]\n        ? V\n        : unknown;\n\ntype VariantTypeNode =\n    | { kind: \"basic\"; code: BasicCode } |\n    { kind: \"array\"; elementTypeString: string; element: VariantTypeNode } |\n    { kind: \"dict\"; entryTypeString: string; key: VariantTypeNode; value: VariantTypeNode } |\n    { kind: \"entry\"; key: VariantTypeNode; value: VariantTypeNode } |\n    { kind: \"tuple\"; items: VariantTypeNode[] } |\n    { kind: \"maybe\"; elementTypeString: string; element: VariantTypeNode };\n\nconst BASIC_CODES = \"bynqiuxthdsogv\";\nconst STRING_KEY_CODES: Set<string> = new Set([\"s\", \"o\", \"g\"]);\n\nconst CONTAINER_PARSERS: Record<string, (source: string, start: number) => [VariantTypeNode, number]> = {\n    a: parseArrayNode,\n    m: parseMaybeNode,\n    \"(\": parseTupleNode,\n    \"{\": parseEntryNode,\n};\n\nconst parsedTypes: Map<string, VariantTypeNode> = new Map();\n\nconst unpackBasic: Record<BasicCode, (variant: GLib.Variant) => unknown> = {\n    b: (variant) => variant.getBoolean(),\n    y: (variant) => variant.getByte(),\n    n: (variant) => variant.getInt16(),\n    q: (variant) => variant.getUint16(),\n    i: (variant) => variant.getInt32(),\n    u: (variant) => variant.getUint32(),\n    h: (variant) => variant.getHandle(),\n    d: (variant) => variant.getDouble(),\n    x: (variant) => variant.getInt64(),\n    t: (variant) => variant.getUint64(),\n    s: (variant) => variant.getString()[0],\n    o: (variant) => variant.getString()[0],\n    g: (variant) => variant.getString()[0],\n    v: (variant) => variant.getVariant(),\n};\n\nconst packBasic: Record<BasicCode, (value: unknown) => GLib.Variant> = {\n    b: (value) => GLib.Variant.newBoolean(value as boolean),\n    y: (value) => GLib.Variant.newByte(value as number),\n    n: (value) => GLib.Variant.newInt16(value as number),\n    q: (value) => GLib.Variant.newUint16(value as number),\n    i: (value) => GLib.Variant.newInt32(value as number),\n    u: (value) => GLib.Variant.newUint32(value as number),\n    h: (value) => GLib.Variant.newHandle(value as number),\n    d: (value) => GLib.Variant.newDouble(value as number),\n    x: (value) => GLib.Variant.newInt64(value as bigint),\n    t: (value) => GLib.Variant.newUint64(value as bigint),\n    s: (value) => GLib.Variant.newString(value as string),\n    o: packObjectPath,\n    g: packSignature,\n    v: (value) => GLib.Variant.newVariant(value as GLib.Variant),\n};\n\nconst isBasicCode = (code: string): code is BasicCode => BASIC_CODES.includes(code);\nconst isStringKeyed = (key: VariantTypeNode): boolean => key.kind === \"basic\" && STRING_KEY_CODES.has(key.code);\nconst invalidType = (source: string): Error => new Error(`Invalid GVariant type string \"${source}\"`);\n\nconst parsePair = (source: string, start: number): [VariantTypeNode, VariantTypeNode, number] => {\n    const [key, keyEnd] = parseNode(source, start);\n\n    if (key.kind !== \"basic\" || key.code === \"v\") {\n        throw invalidType(source);\n    }\n\n    const [value, valueEnd] = parseNode(source, keyEnd);\n\n    if (source[valueEnd] !== \"}\") {\n        throw invalidType(source);\n    }\n\n    return [key, value, valueEnd + 1];\n};\n\nfunction parseArrayNode(source: string, start: number): [VariantTypeNode, number] {\n    if (source[start] === \"{\") {\n        const [key, value, end] = parsePair(source, start + 1);\n\n        return [{ kind: \"dict\", entryTypeString: source.slice(start, end), key, value }, end];\n    }\n\n    const [element, end] = parseNode(source, start);\n\n    return [{ kind: \"array\", elementTypeString: source.slice(start, end), element }, end];\n}\n\nfunction parseMaybeNode(source: string, start: number): [VariantTypeNode, number] {\n    const [element, end] = parseNode(source, start);\n\n    return [{ kind: \"maybe\", elementTypeString: source.slice(start, end), element }, end];\n}\n\nfunction parseTupleNode(source: string, start: number): [VariantTypeNode, number] {\n    const items: VariantTypeNode[] = [];\n    let position = start;\n\n    while (source[position] !== \")\") {\n        if (position >= source.length) {\n            throw invalidType(source);\n        }\n\n        const [item, end] = parseNode(source, position);\n        items.push(item);\n        position = end;\n    }\n\n    return [{ kind: \"tuple\", items }, position + 1];\n}\n\nfunction parseEntryNode(source: string, start: number): [VariantTypeNode, number] {\n    const [key, value, end] = parsePair(source, start);\n\n    return [{ kind: \"entry\", key, value }, end];\n}\n\nconst parseNode = (source: string, start: number): [VariantTypeNode, number] => {\n    const code = source[start];\n\n    if (code === undefined) {\n        throw invalidType(source);\n    }\n\n    const container = CONTAINER_PARSERS[code];\n\n    if (container !== undefined) {\n        return container(source, start + 1);\n    }\n\n    if (isBasicCode(code)) {\n        return [{ kind: \"basic\", code }, start + 1];\n    }\n\n    throw invalidType(source);\n};\n\nconst parseVariantType = (typeString: string): VariantTypeNode => {\n    const cached = parsedTypes.get(typeString);\n\n    if (cached !== undefined) {\n        return cached;\n    }\n\n    const [node, end] = parseNode(typeString, 0);\n\n    if (end !== typeString.length) {\n        throw invalidType(typeString);\n    }\n\n    parsedTypes.set(typeString, node);\n\n    return node;\n};\n\nconst unpackChildren = (variant: GLib.Variant, unpackChild: (child: GLib.Variant) => unknown): unknown[] => {\n    const children: unknown[] = [];\n    const count = variant.nChildren();\n\n    for (let index = 0; index < count; index += 1) {\n        children.push(unpackChild(variant.getChildValue(index)));\n    }\n\n    return children;\n};\n\nconst unpackPair = (key: VariantTypeNode, value: VariantTypeNode, entry: GLib.Variant): [unknown, unknown] => [\n    unpackNode(key, entry.getChildValue(0)),\n    unpackNode(value, entry.getChildValue(1)),\n];\n\nconst unpackDict = (\n    node: { key: VariantTypeNode; value: VariantTypeNode },\n    variant: GLib.Variant,\n): Record<string, unknown> | Map<unknown, unknown> => {\n    const entries = unpackChildren(variant, (entry) => unpackPair(node.key, node.value, entry)) as [unknown, unknown][];\n\n    if (!isStringKeyed(node.key)) {\n        return new Map(entries);\n    }\n\n    const stringEntries: [string, unknown][] = entries.map(([key, value]) => [key as string, value]);\n\n    return Object.fromEntries(stringEntries);\n};\n\nconst unpackMaybe = (element: VariantTypeNode, variant: GLib.Variant): unknown => {\n    const child = variant.getMaybe();\n\n    return child === null ? null : unpackNode(element, child);\n};\n\nconst unpackNode = (node: VariantTypeNode, variant: GLib.Variant): unknown => {\n    switch (node.kind) {\n        case \"basic\": {\n            return unpackBasic[node.code](variant);\n        }\n        case \"array\": {\n            return unpackChildren(variant, (child) => unpackNode(node.element, child));\n        }\n        case \"dict\": {\n            return unpackDict(node, variant);\n        }\n        case \"entry\": {\n            return unpackPair(node.key, node.value, variant);\n        }\n        case \"tuple\": {\n            return node.items.map((item, index) => unpackNode(item, variant.getChildValue(index)));\n        }\n        case \"maybe\": {\n            return unpackMaybe(node.element, variant);\n        }\n    }\n};\n\nconst packValidatedString = (\n    value: unknown,\n    isValid: (value: string) => boolean,\n    description: string,\n    construct: (value: string) => GLib.Variant,\n): GLib.Variant => {\n    if (typeof value !== \"string\" || !isValid(value)) {\n        throw new Error(`\"${String(value)}\" is not a valid GVariant ${description}`);\n    }\n\n    return construct(value);\n};\n\nfunction packObjectPath(value: unknown): GLib.Variant {\n    return packValidatedString(\n        value,\n        (path) => GLib.Variant.isObjectPath(path),\n        \"object path\",\n        (path) => GLib.Variant.newObjectPath(path),\n    );\n}\n\nfunction packSignature(value: unknown): GLib.Variant {\n    return packValidatedString(\n        value,\n        (signature) => GLib.Variant.isSignature(signature),\n        \"type signature\",\n        (signature) => GLib.Variant.newSignature(signature),\n    );\n}\n\nconst packEntry = (key: VariantTypeNode, value: VariantTypeNode, pair: [unknown, unknown]): GLib.Variant =>\n    GLib.Variant.newDictEntry(packNode(key, pair[0]), packNode(value, pair[1]));\n\nconst dictEntries = (value: unknown): [unknown, unknown][] =>\n    value instanceof Map ? [...value] : Object.entries(value as Record<string, unknown>);\n\nconst packDict = (\n    node: { entryTypeString: string; key: VariantTypeNode; value: VariantTypeNode },\n    value: unknown,\n): GLib.Variant =>\n    GLib.Variant.newArray(\n        GLib.VariantType.new(node.entryTypeString),\n        dictEntries(value).map((pair) => packEntry(node.key, node.value, pair)),\n    );\n\nconst packMaybe = (node: { elementTypeString: string; element: VariantTypeNode }, value: unknown): GLib.Variant =>\n    GLib.Variant.newMaybe(\n        GLib.VariantType.new(node.elementTypeString),\n        value === null ? null : packNode(node.element, value),\n    );\n\nconst packNode = (node: VariantTypeNode, value: unknown): GLib.Variant => {\n    switch (node.kind) {\n        case \"basic\": {\n            return packBasic[node.code](value);\n        }\n        case \"array\": {\n            return GLib.Variant.newArray(\n                GLib.VariantType.new(node.elementTypeString),\n                (value as unknown[]).map((item) => packNode(node.element, item)),\n            );\n        }\n        case \"dict\": {\n            return packDict(node, value);\n        }\n        case \"entry\": {\n            return packEntry(node.key, node.value, value as [unknown, unknown]);\n        }\n        case \"tuple\": {\n            return GLib.Variant.newTuple(\n                node.items.map((item, index) => packNode(item, (value as unknown[])[index])),\n            );\n        }\n        case \"maybe\": {\n            return packMaybe(node, value);\n        }\n    }\n};\n\n/**\n * Packs a JavaScript value into the `GLib.Variant` a GVariant type string describes, building the\n * nested arrays, dictionaries, tuples and maybes the type calls for. A type string given as a\n * literal also types `value`, so `\"as\"` takes an array of strings, `\"a{sv}\"` a record of variants,\n * `\"(si)\"` a string and a number pair, and a 64-bit type a `bigint`.\n * @param typeString GVariant type of the variant to build, such as `\"a{sv}\"`.\n * @param value Value to pack, shaped the way `typeString` describes.\n * @returns The packed variant.\n * @throws {Error} When the type string is not one complete GVariant type, or when a value packed as\n * an object path or a type signature is not a valid one.\n */\nconst toVariant = <S extends string>(typeString: S, value: VariantValue<S>): GLib.Variant =>\n    packNode(parseVariantType(typeString), value);\n\n/**\n * Unpacks a `GLib.Variant` into the JavaScript value a GVariant type string describes, the inverse\n * of {@link toVariant}. A dictionary keyed by strings unpacks to a record and one keyed by anything\n * else to a `Map`, an array to an array, a tuple to an array of its members, a maybe to its value or\n * `null`, and a nested variant to the `GLib.Variant` itself.\n * @param typeString GVariant type the variant holds, such as `\"a{sv}\"`.\n * @param variant Variant to read, which has to hold that type.\n * @returns The unpacked value, typed from `typeString` when it is given as a literal.\n * @throws {Error} When the type string is not one complete GVariant type.\n */\nconst fromVariant = <S extends string>(typeString: S, variant: GLib.Variant): VariantValue<S> =>\n    unpackNode(parseVariantType(typeString), variant) as VariantValue<S>;\n\nexport { fromVariant, toVariant, type VariantValue };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/runtime",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "FFI runtime the generated GTKX bindings call into: type descriptors, GValue marshalling, signals, GObject lifecycle",
   "keywords": [
     "gtkx",
@@ -55,11 +55,11 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/utils": "1.2.0",
-    "@gtkx/native": "1.2.0"
+    "@gtkx/native": "1.2.2",
+    "@gtkx/utils": "1.2.2"
   },
   "devDependencies": {
-    "@gtkx/vitest": "1.2.0"
+    "@gtkx/vitest": "1.2.2"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/index.ts

@@ -81,6 +81,8 @@ export {
 /** @public */
 export { getBoxedValue, setBoxedValue } from "./value.js";
 /** @public */
+export { fromVariant, toVariant, type VariantValue } from "./variant.js";
+/** @public */
 export { callParent, callVfunc } from "./vfunc-call.js";
 /** @public */
 export { alloc, type ExternalObject, type Handle, read, write } from "@gtkx/native";

package/src/variant.ts

@@ -0,0 +1,427 @@
+import * as GLib from "@gtkx/gi/glib";
+
+/** JavaScript type every GVariant basic type code unpacks to. */
+type BasicValueMap = {
+    /** Boolean, held as a single byte reading 0 or 1. */
+    b: boolean;
+    /** Unsigned byte. */
+    y: number;
+    /** Signed 16-bit integer. */
+    n: number;
+    /** Unsigned 16-bit integer. */
+    q: number;
+    /** Signed 32-bit integer. */
+    i: number;
+    /** Unsigned 32-bit integer. */
+    u: number;
+    /** Index into the file descriptor list a message carries. */
+    h: number;
+    /** Double precision floating point number. */
+    d: number;
+    /** Signed 64-bit integer. */
+    x: bigint;
+    /** Unsigned 64-bit integer. */
+    t: bigint;
+    /** UTF-8 string, under no further constraint on what it holds. */
+    s: string;
+    /** D-Bus object path. */
+    o: string;
+    /** GVariant type signature. */
+    g: string;
+    /** Boxed variant holding a value of any type. */
+    v: GLib.Variant;
+};
+
+/** Single-character code of one of the GVariant basic types in {@link BasicValueMap}. */
+type BasicCode = keyof BasicValueMap;
+/** Parses the element type of an array, yielding the array type it produces and the rest of the string. */
+type ParseArray<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V[], R] : never;
+/** Parses the element type of a maybe, yielding the nullable type it produces and the rest of the string. */
+type ParseMaybe<S extends string> = Parse<S> extends [infer V, infer R extends string] ? [V | null, R] : never;
+
+/** Collects tuple member types into `Acc` up to the closing parenthesis, yielding them and the rest of the string. */
+type ParseTuple<S extends string, Acc extends unknown[]> = S extends `)${infer Rest}`
+    ? [Acc, Rest]
+    : [Parse<S>] extends [never]
+            ? never
+            : Parse<S> extends [infer V, infer R extends string]
+                ? ParseTuple<R, [...Acc, V]>
+                : never;
+
+/** Types a dictionary entry key can hold. */
+type DictKey = string | number | bigint | boolean;
+
+/** Parses the key and value types of a dictionary entry, yielding them and the rest of the string after its brace. */
+type ParsePair<S extends string> =
+    Parse<S> extends [infer K, infer R1 extends string]
+        ? Parse<R1> extends [infer V, infer R2 extends string]
+            ? R2 extends `}${infer R3}`
+                ? [K] extends [DictKey]
+                        ? [K, V, R3]
+                        : never
+                : never
+            : never
+        : never;
+
+/**
+ * Parses a dictionary entry into the collection an array of those entries unpacks to, a record for string keys and a
+ * `Map` otherwise, plus the rest of the string.
+ */
+type ParseDict<S extends string> =
+    ParsePair<S> extends [infer K, infer V, infer R extends string]
+        ? [[K] extends [string] ? Record<string, V> : Map<K, V>, R]
+        : never;
+
+/** Parses a standalone dictionary entry into a key and value pair, yielding it and the rest of the string. */
+type ParseEntry<S extends string> =
+    ParsePair<S> extends [infer K, infer V, infer R extends string] ? [[K, V], R] : never;
+
+/** Parses what follows an `a` as a dictionary when it opens an entry, and as a plain array otherwise. */
+type ParseArrayOrDict<S extends string> = S extends `{${infer Rest}` ? ParseDict<Rest> : ParseArray<S>;
+
+/**
+ * Parses the type at the head of `S`, yielding the JavaScript type it unpacks to and the rest of the string, or
+ * `never` when the string is malformed.
+ */
+type Parse<S extends string> = S extends `a${infer Rest}`
+    ? ParseArrayOrDict<Rest>
+    : S extends `m${infer Rest}`
+        ? ParseMaybe<Rest>
+        : S extends `(${infer Rest}`
+            ? ParseTuple<Rest, []>
+            : S extends `{${infer Rest}`
+                ? ParseEntry<Rest>
+                : S extends `${infer C}${infer Rest}`
+                    ? C extends BasicCode
+                        ? [BasicValueMap[C], Rest]
+                        : never
+                    : never;
+
+/** JavaScript type a variant of type string `S` unpacks to, or `unknown` when `S` is not one complete type. */
+type VariantValue<S extends string> = [Parse<S>] extends [never]
+    ? unknown
+    : Parse<S> extends [infer V, ""]
+        ? V
+        : unknown;
+
+type VariantTypeNode =
+    | { kind: "basic"; code: BasicCode } |
+    { kind: "array"; elementTypeString: string; element: VariantTypeNode } |
+    { kind: "dict"; entryTypeString: string; key: VariantTypeNode; value: VariantTypeNode } |
+    { kind: "entry"; key: VariantTypeNode; value: VariantTypeNode } |
+    { kind: "tuple"; items: VariantTypeNode[] } |
+    { kind: "maybe"; elementTypeString: string; element: VariantTypeNode };
+
+const BASIC_CODES = "bynqiuxthdsogv";
+const STRING_KEY_CODES: Set<string> = new Set(["s", "o", "g"]);
+
+const CONTAINER_PARSERS: Record<string, (source: string, start: number) => [VariantTypeNode, number]> = {
+    a: parseArrayNode,
+    m: parseMaybeNode,
+    "(": parseTupleNode,
+    "{": parseEntryNode,
+};
+
+const parsedTypes: Map<string, VariantTypeNode> = new Map();
+
+const unpackBasic: Record<BasicCode, (variant: GLib.Variant) => unknown> = {
+    b: (variant) => variant.getBoolean(),
+    y: (variant) => variant.getByte(),
+    n: (variant) => variant.getInt16(),
+    q: (variant) => variant.getUint16(),
+    i: (variant) => variant.getInt32(),
+    u: (variant) => variant.getUint32(),
+    h: (variant) => variant.getHandle(),
+    d: (variant) => variant.getDouble(),
+    x: (variant) => variant.getInt64(),
+    t: (variant) => variant.getUint64(),
+    s: (variant) => variant.getString()[0],
+    o: (variant) => variant.getString()[0],
+    g: (variant) => variant.getString()[0],
+    v: (variant) => variant.getVariant(),
+};
+
+const packBasic: Record<BasicCode, (value: unknown) => GLib.Variant> = {
+    b: (value) => GLib.Variant.newBoolean(value as boolean),
+    y: (value) => GLib.Variant.newByte(value as number),
+    n: (value) => GLib.Variant.newInt16(value as number),
+    q: (value) => GLib.Variant.newUint16(value as number),
+    i: (value) => GLib.Variant.newInt32(value as number),
+    u: (value) => GLib.Variant.newUint32(value as number),
+    h: (value) => GLib.Variant.newHandle(value as number),
+    d: (value) => GLib.Variant.newDouble(value as number),
+    x: (value) => GLib.Variant.newInt64(value as bigint),
+    t: (value) => GLib.Variant.newUint64(value as bigint),
+    s: (value) => GLib.Variant.newString(value as string),
+    o: packObjectPath,
+    g: packSignature,
+    v: (value) => GLib.Variant.newVariant(value as GLib.Variant),
+};
+
+const isBasicCode = (code: string): code is BasicCode => BASIC_CODES.includes(code);
+const isStringKeyed = (key: VariantTypeNode): boolean => key.kind === "basic" && STRING_KEY_CODES.has(key.code);
+const invalidType = (source: string): Error => new Error(`Invalid GVariant type string "${source}"`);
+
+const parsePair = (source: string, start: number): [VariantTypeNode, VariantTypeNode, number] => {
+    const [key, keyEnd] = parseNode(source, start);
+
+    if (key.kind !== "basic" || key.code === "v") {
+        throw invalidType(source);
+    }
+
+    const [value, valueEnd] = parseNode(source, keyEnd);
+
+    if (source[valueEnd] !== "}") {
+        throw invalidType(source);
+    }
+
+    return [key, value, valueEnd + 1];
+};
+
+function parseArrayNode(source: string, start: number): [VariantTypeNode, number] {
+    if (source[start] === "{") {
+        const [key, value, end] = parsePair(source, start + 1);
+
+        return [{ kind: "dict", entryTypeString: source.slice(start, end), key, value }, end];
+    }
+
+    const [element, end] = parseNode(source, start);
+
+    return [{ kind: "array", elementTypeString: source.slice(start, end), element }, end];
+}
+
+function parseMaybeNode(source: string, start: number): [VariantTypeNode, number] {
+    const [element, end] = parseNode(source, start);
+
+    return [{ kind: "maybe", elementTypeString: source.slice(start, end), element }, end];
+}
+
+function parseTupleNode(source: string, start: number): [VariantTypeNode, number] {
+    const items: VariantTypeNode[] = [];
+    let position = start;
+
+    while (source[position] !== ")") {
+        if (position >= source.length) {
+            throw invalidType(source);
+        }
+
+        const [item, end] = parseNode(source, position);
+        items.push(item);
+        position = end;
+    }
+
+    return [{ kind: "tuple", items }, position + 1];
+}
+
+function parseEntryNode(source: string, start: number): [VariantTypeNode, number] {
+    const [key, value, end] = parsePair(source, start);
+
+    return [{ kind: "entry", key, value }, end];
+}
+
+const parseNode = (source: string, start: number): [VariantTypeNode, number] => {
+    const code = source[start];
+
+    if (code === undefined) {
+        throw invalidType(source);
+    }
+
+    const container = CONTAINER_PARSERS[code];
+
+    if (container !== undefined) {
+        return container(source, start + 1);
+    }
+
+    if (isBasicCode(code)) {
+        return [{ kind: "basic", code }, start + 1];
+    }
+
+    throw invalidType(source);
+};
+
+const parseVariantType = (typeString: string): VariantTypeNode => {
+    const cached = parsedTypes.get(typeString);
+
+    if (cached !== undefined) {
+        return cached;
+    }
+
+    const [node, end] = parseNode(typeString, 0);
+
+    if (end !== typeString.length) {
+        throw invalidType(typeString);
+    }
+
+    parsedTypes.set(typeString, node);
+
+    return node;
+};
+
+const unpackChildren = (variant: GLib.Variant, unpackChild: (child: GLib.Variant) => unknown): unknown[] => {
+    const children: unknown[] = [];
+    const count = variant.nChildren();
+
+    for (let index = 0; index < count; index += 1) {
+        children.push(unpackChild(variant.getChildValue(index)));
+    }
+
+    return children;
+};
+
+const unpackPair = (key: VariantTypeNode, value: VariantTypeNode, entry: GLib.Variant): [unknown, unknown] => [
+    unpackNode(key, entry.getChildValue(0)),
+    unpackNode(value, entry.getChildValue(1)),
+];
+
+const unpackDict = (
+    node: { key: VariantTypeNode; value: VariantTypeNode },
+    variant: GLib.Variant,
+): Record<string, unknown> | Map<unknown, unknown> => {
+    const entries = unpackChildren(variant, (entry) => unpackPair(node.key, node.value, entry)) as [unknown, unknown][];
+
+    if (!isStringKeyed(node.key)) {
+        return new Map(entries);
+    }
+
+    const stringEntries: [string, unknown][] = entries.map(([key, value]) => [key as string, value]);
+
+    return Object.fromEntries(stringEntries);
+};
+
+const unpackMaybe = (element: VariantTypeNode, variant: GLib.Variant): unknown => {
+    const child = variant.getMaybe();
+
+    return child === null ? null : unpackNode(element, child);
+};
+
+const unpackNode = (node: VariantTypeNode, variant: GLib.Variant): unknown => {
+    switch (node.kind) {
+        case "basic": {
+            return unpackBasic[node.code](variant);
+        }
+        case "array": {
+            return unpackChildren(variant, (child) => unpackNode(node.element, child));
+        }
+        case "dict": {
+            return unpackDict(node, variant);
+        }
+        case "entry": {
+            return unpackPair(node.key, node.value, variant);
+        }
+        case "tuple": {
+            return node.items.map((item, index) => unpackNode(item, variant.getChildValue(index)));
+        }
+        case "maybe": {
+            return unpackMaybe(node.element, variant);
+        }
+    }
+};
+
+const packValidatedString = (
+    value: unknown,
+    isValid: (value: string) => boolean,
+    description: string,
+    construct: (value: string) => GLib.Variant,
+): GLib.Variant => {
+    if (typeof value !== "string" || !isValid(value)) {
+        throw new Error(`"${String(value)}" is not a valid GVariant ${description}`);
+    }
+
+    return construct(value);
+};
+
+function packObjectPath(value: unknown): GLib.Variant {
+    return packValidatedString(
+        value,
+        (path) => GLib.Variant.isObjectPath(path),
+        "object path",
+        (path) => GLib.Variant.newObjectPath(path),
+    );
+}
+
+function packSignature(value: unknown): GLib.Variant {
+    return packValidatedString(
+        value,
+        (signature) => GLib.Variant.isSignature(signature),
+        "type signature",
+        (signature) => GLib.Variant.newSignature(signature),
+    );
+}
+
+const packEntry = (key: VariantTypeNode, value: VariantTypeNode, pair: [unknown, unknown]): GLib.Variant =>
+    GLib.Variant.newDictEntry(packNode(key, pair[0]), packNode(value, pair[1]));
+
+const dictEntries = (value: unknown): [unknown, unknown][] =>
+    value instanceof Map ? [...value] : Object.entries(value as Record<string, unknown>);
+
+const packDict = (
+    node: { entryTypeString: string; key: VariantTypeNode; value: VariantTypeNode },
+    value: unknown,
+): GLib.Variant =>
+    GLib.Variant.newArray(
+        GLib.VariantType.new(node.entryTypeString),
+        dictEntries(value).map((pair) => packEntry(node.key, node.value, pair)),
+    );
+
+const packMaybe = (node: { elementTypeString: string; element: VariantTypeNode }, value: unknown): GLib.Variant =>
+    GLib.Variant.newMaybe(
+        GLib.VariantType.new(node.elementTypeString),
+        value === null ? null : packNode(node.element, value),
+    );
+
+const packNode = (node: VariantTypeNode, value: unknown): GLib.Variant => {
+    switch (node.kind) {
+        case "basic": {
+            return packBasic[node.code](value);
+        }
+        case "array": {
+            return GLib.Variant.newArray(
+                GLib.VariantType.new(node.elementTypeString),
+                (value as unknown[]).map((item) => packNode(node.element, item)),
+            );
+        }
+        case "dict": {
+            return packDict(node, value);
+        }
+        case "entry": {
+            return packEntry(node.key, node.value, value as [unknown, unknown]);
+        }
+        case "tuple": {
+            return GLib.Variant.newTuple(
+                node.items.map((item, index) => packNode(item, (value as unknown[])[index])),
+            );
+        }
+        case "maybe": {
+            return packMaybe(node, value);
+        }
+    }
+};
+
+/**
+ * Packs a JavaScript value into the `GLib.Variant` a GVariant type string describes, building the
+ * nested arrays, dictionaries, tuples and maybes the type calls for. A type string given as a
+ * literal also types `value`, so `"as"` takes an array of strings, `"a{sv}"` a record of variants,
+ * `"(si)"` a string and a number pair, and a 64-bit type a `bigint`.
+ * @param typeString GVariant type of the variant to build, such as `"a{sv}"`.
+ * @param value Value to pack, shaped the way `typeString` describes.
+ * @returns The packed variant.
+ * @throws {Error} When the type string is not one complete GVariant type, or when a value packed as
+ * an object path or a type signature is not a valid one.
+ */
+const toVariant = <S extends string>(typeString: S, value: VariantValue<S>): GLib.Variant =>
+    packNode(parseVariantType(typeString), value);
+
+/**
+ * Unpacks a `GLib.Variant` into the JavaScript value a GVariant type string describes, the inverse
+ * of {@link toVariant}. A dictionary keyed by strings unpacks to a record and one keyed by anything
+ * else to a `Map`, an array to an array, a tuple to an array of its members, a maybe to its value or
+ * `null`, and a nested variant to the `GLib.Variant` itself.
+ * @param typeString GVariant type the variant holds, such as `"a{sv}"`.
+ * @param variant Variant to read, which has to hold that type.
+ * @returns The unpacked value, typed from `typeString` when it is given as a literal.
+ * @throws {Error} When the type string is not one complete GVariant type.
+ */
+const fromVariant = <S extends string>(typeString: S, variant: GLib.Variant): VariantValue<S> =>
+    unpackNode(parseVariantType(typeString), variant) as VariantValue<S>;
+
+export { fromVariant, toVariant, type VariantValue };