@gtkx/codegen 1.0.0-rc.4 → 1.1.0

package/dist/gir/type-id.js

@@ -1,3 +1,4 @@
+/** GIR type names of the GLib containers, mapped to the {@link ListFlavor} each one parses to. */
 const LIST_FLAVOR_BY_NAME = {
     "GLib.List": "glist",
     "GLib.SList": "gslist",

package/dist/gir/type-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-id.js","sourceRoot":"","sources":["../../src/gir/type-id.ts"],"names":[],"mappings":"AAwCA,MAAM,mBAAmB,GAAG;IACxB,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,QAAQ;IACtB,gBAAgB,EAAE,YAAY;CACxB,CAAC;AAEX,MAAM,qBAAqB,GAAG,CAAC,GAAe,EAAW,EAAE,CACvD,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,oBAAoB,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;AAEnG,OAAO,EACH,qBAAqB,EACrB,mBAAmB,GAQtB,CAAC","sourcesContent":["import type { RawNode } from \"./parse.js\";\nimport type { PrimitiveCategory } from \"./primitives.js\";\n\ntype TypeId = { nsId: number; id: number };\ntype ListFlavor = (typeof LIST_FLAVOR_BY_NAME)[keyof typeof LIST_FLAVOR_BY_NAME];\ntype PrimitiveType = { kind: \"primitive\"; category: PrimitiveCategory };\ntype VarargsType = { kind: \"varargs\" };\n\ntype CArrayType = {\n    kind: \"carray\";\n    element: TypeId;\n    elementCType: string | undefined;\n    lengthParameterIndex: number | undefined;\n    fixedSize: number | undefined;\n    isZeroTerminated: boolean;\n};\n\ntype ListType = {\n    kind: \"list\";\n    flavor: ListFlavor;\n    element: TypeId;\n};\n\ntype HashTableType = {\n    kind: \"hashtable\";\n    key: TypeId;\n    value: TypeId;\n};\n\ntype StructuralType = PrimitiveType | VarargsType | CArrayType | ListType | HashTableType;\n\ntype ParseContext = {\n    nsId: number;\n    findType(name: string): TypeId;\n    addPrimitive(category: PrimitiveCategory): TypeId;\n    addVarargs(): TypeId;\n    addContainer(type: CArrayType | ListType | HashTableType): TypeId;\n    addAnonymousCallback(node: RawNode): TypeId;\n};\n\nconst LIST_FLAVOR_BY_NAME = {\n    \"GLib.List\": \"glist\",\n    \"GLib.SList\": \"gslist\",\n    \"GLib.PtrArray\": \"gptrarray\",\n    \"GLib.Array\": \"garray\",\n    \"GLib.ByteArray\": \"gbytearray\",\n} as const;\n\nconst hasUnknownArrayLength = (ref: CArrayType): boolean =>\n    !ref.isZeroTerminated && ref.lengthParameterIndex === undefined && ref.fixedSize === undefined;\n\nexport {\n    hasUnknownArrayLength,\n    LIST_FLAVOR_BY_NAME,\n    type TypeId,\n    type ListFlavor,\n    type CArrayType,\n    type ListType,\n    type HashTableType,\n    type StructuralType,\n    type ParseContext,\n};\n"]}
+{"version":3,"file":"type-id.js","sourceRoot":"","sources":["../../src/gir/type-id.ts"],"names":[],"mappings":"AAqFA,kGAAkG;AAClG,MAAM,mBAAmB,GAAG;IACxB,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,QAAQ;IACtB,gBAAgB,EAAE,YAAY;CACxB,CAAC;AAEX,MAAM,qBAAqB,GAAG,CAAC,GAAe,EAAW,EAAE,CACvD,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,oBAAoB,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;AAEnG,OAAO,EACH,qBAAqB,EACrB,mBAAmB,GAQtB,CAAC","sourcesContent":["import type { RawNode } from \"./parse.js\";\nimport type { PrimitiveCategory } from \"./primitives.js\";\n\n/** A reference to a parsed type: the type table holding it, and its slot in that table. */\ntype TypeId = {\n    /** Id of the table holding the type: a namespace's, or the internal one primitives and varargs intern into. */\n    nsId: number;\n    /** Slot the type occupies in that table. */\n    id: number;\n};\n\n/** Which GLib container a {@link ListType} is. */\ntype ListFlavor = (typeof LIST_FLAVOR_BY_NAME)[keyof typeof LIST_FLAVOR_BY_NAME];\n\n/** A type that marshals directly as a value, such as `gint` or `utf8`. */\ntype PrimitiveType = {\n    /** Discriminates {@link StructuralType}. */\n    kind: \"primitive\";\n    /** The scalar the type marshals as. */\n    category: PrimitiveCategory;\n};\n\n/** The trailing `...` argument list of a variadic C function. */\ntype VarargsType = {\n    /** Discriminates {@link StructuralType}. */\n    kind: \"varargs\";\n};\n\n/** A C array, along with whatever the GIR says about how its length is determined. */\ntype CArrayType = {\n    /** Discriminates {@link StructuralType}. */\n    kind: \"carray\";\n    /** Type of the array's elements, paired with `elementCType` to build the element descriptor. */\n    element: TypeId;\n    /** C declaration of an element, which tells an inline struct apart from a pointer to one. */\n    elementCType: string | undefined;\n    /** C declaration of the array itself. */\n    arrayCType: string | undefined;\n    /** Index of the parameter, or of the sibling record field, carrying the length. */\n    lengthParameterIndex: number | undefined;\n    /** Element count when the array has a fixed size. */\n    fixedSize: number | undefined;\n    /** Whether the array ends at a null element. */\n    isZeroTerminated: boolean;\n};\n\n/** A GLib list or array container over a single element type. */\ntype ListType = {\n    /** Discriminates {@link StructuralType}. */\n    kind: \"list\";\n    /** Which container the type is. */\n    flavor: ListFlavor;\n    /** Type the container's elements marshal as, which the list descriptor wraps. */\n    element: TypeId;\n};\n\n/** A `GLib.HashTable`. */\ntype HashTableType = {\n    /** Discriminates {@link StructuralType}. */\n    kind: \"hashtable\";\n    /** Type the keys marshal as, rendered as the key half of a `Record` or `Map`. */\n    key: TypeId;\n    /** Type the values marshal as, rendered as the value half of a `Record` or `Map`. */\n    value: TypeId;\n};\n\n/** A type the GIR describes by its structure rather than by a name it declares. */\ntype StructuralType = PrimitiveType | VarargsType | CArrayType | ListType | HashTableType;\n\n/** The hooks the GIR parsers use to reference and register types while walking one namespace. */\ntype ParseContext = {\n    /** Id of the namespace being parsed. */\n    nsId: number;\n    /** Resolves a GIR type name, optionally namespace-qualified, reserving a slot when it is not parsed yet. */\n    findType(name: string): TypeId;\n    /** Interns a primitive type and returns its id. */\n    addPrimitive(category: PrimitiveCategory): TypeId;\n    /** Interns the varargs type and returns its id. */\n    addVarargs(): TypeId;\n    /** Registers an unnamed container type in the namespace and returns its id. */\n    addContainer(type: CArrayType | ListType | HashTableType): TypeId;\n    /** Parses an inline `<callback>` node, registers it as an unnamed type, and returns its id. */\n    addAnonymousCallback(node: RawNode): TypeId;\n};\n\n/** GIR type names of the GLib containers, mapped to the {@link ListFlavor} each one parses to. */\nconst LIST_FLAVOR_BY_NAME = {\n    \"GLib.List\": \"glist\",\n    \"GLib.SList\": \"gslist\",\n    \"GLib.PtrArray\": \"gptrarray\",\n    \"GLib.Array\": \"garray\",\n    \"GLib.ByteArray\": \"gbytearray\",\n} as const;\n\nconst hasUnknownArrayLength = (ref: CArrayType): boolean =>\n    !ref.isZeroTerminated && ref.lengthParameterIndex === undefined && ref.fixedSize === undefined;\n\nexport {\n    hasUnknownArrayLength,\n    LIST_FLAVOR_BY_NAME,\n    type TypeId,\n    type ListFlavor,\n    type CArrayType,\n    type ListType,\n    type HashTableType,\n    type StructuralType,\n    type ParseContext,\n};\n"]}

package/dist/gir/type-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-ref.d.ts","sourceRoot":"","sources":["../../src/gir/type-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,OAAO,EAAyD,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAUrH,QAAA,MAAM,eAAe,GAAI,QAAQ,OAAO,GAAG,SAAS,EAAE,SAAS,YAAY,KAAG,MAAM,GAAG,SA4BtF,CAAC;AA4DF,QAAA,MAAM,sBAAsB,GAAI,MAAM,MAAM,KAAG,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAQzE,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"type-ref.d.ts","sourceRoot":"","sources":["../../src/gir/type-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,OAAO,EAAyD,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAUrH,QAAA,MAAM,eAAe,GAAI,QAAQ,OAAO,GAAG,SAAS,EAAE,SAAS,YAAY,KAAG,MAAM,GAAG,SA4BtF,CAAC;AA6DF,QAAA,MAAM,sBAAsB,GAAI,MAAM,MAAM,KAAG,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAQzE,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/gir/type-ref.js

@@ -64,6 +64,7 @@ const arrayTypeRefFromNode = (arrayNode, context) => {
         kind: "carray",
         element,
         elementCType: elementNode === undefined ? undefined : attr(elementNode, "c:type"),
+        arrayCType: attr(arrayNode, "c:type"),
         lengthParameterIndex: intAttr(arrayNode, "length"),
         fixedSize: intAttr(arrayNode, "fixed-size"),
         isZeroTerminated: isAttrTrue(arrayNode, "zero-terminated", true),

package/dist/gir/type-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-ref.js","sourceRoot":"","sources":["../../src/gir/type-ref.ts"],"names":[],"mappings":"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","sourcesContent":["import { attr, getChild, getChildren, intAttr, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\nimport { primitiveCategory } from \"./primitives.js\";\nimport { type CArrayType, LIST_FLAVOR_BY_NAME, type ListFlavor, type ParseContext, type TypeId } from \"./type-id.js\";\n\nconst LIST_FLAVOR_BY_NAME_LOOKUP: Map<string, ListFlavor> = new Map(Object.entries(LIST_FLAVOR_BY_NAME));\n\nconst getElementRef = (node: RawNode, context: ParseContext): TypeId => {\n    const elementNode = getChild(node, \"type\");\n\n    return elementNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(elementNode, context);\n};\n\nconst typeRefFromNode = (parent: RawNode | undefined, context: ParseContext): TypeId | undefined => {\n    if (parent === undefined) {\n        return undefined;\n    }\n\n    if (getChild(parent, \"varargs\") !== undefined) {\n        return context.addVarargs();\n    }\n\n    const arrayNode = getChild(parent, \"array\");\n\n    if (arrayNode !== undefined) {\n        return arrayTypeRefFromNode(arrayNode, context);\n    }\n\n    const typeNode = getChild(parent, \"type\");\n\n    if (typeNode !== undefined) {\n        return typeRefFromTypeNode(typeNode, context);\n    }\n\n    const callback = getChild(parent, \"callback\");\n\n    if (callback !== undefined) {\n        return context.addAnonymousCallback(callback);\n    }\n\n    return undefined;\n};\n\nconst hashTableRefFromNode = (typeNode: RawNode, context: ParseContext): TypeId => {\n    const elementTypes = getChildren(typeNode, \"type\");\n    const keyNode = elementTypes[0];\n    const valueNode = elementTypes[1];\n\n    return context.addContainer({\n        kind: \"hashtable\",\n        key: keyNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(keyNode, context),\n        value: valueNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(valueNode, context),\n    });\n};\n\nconst typeRefFromTypeNode = (typeNode: RawNode, context: ParseContext): TypeId => {\n    const name = nameAttr(typeNode);\n    const listFlavor = LIST_FLAVOR_BY_NAME_LOOKUP.get(name);\n\n    if (listFlavor !== undefined) {\n        return context.addContainer({ kind: \"list\", flavor: listFlavor, element: getElementRef(typeNode, context) });\n    }\n\n    if (name === \"GLib.HashTable\") {\n        return hashTableRefFromNode(typeNode, context);\n    }\n\n    const primitive = primitiveCategory(name);\n\n    if (primitive !== undefined) {\n        return context.addPrimitive(primitive);\n    }\n\n    return context.findType(name);\n};\n\nconst arrayTypeRefFromNode = (arrayNode: RawNode, context: ParseContext): TypeId => {\n    const element = getElementRef(arrayNode, context);\n    const arrayName = attr(arrayNode, \"name\");\n    const listFlavor = arrayName === undefined ? undefined : LIST_FLAVOR_BY_NAME_LOOKUP.get(arrayName);\n\n    if (listFlavor !== undefined) {\n        return context.addContainer({ kind: \"list\", flavor: listFlavor, element });\n    }\n\n    const elementNode = getChild(arrayNode, \"type\");\n\n    const carray: CArrayType = {\n        kind: \"carray\",\n        element,\n        elementCType: elementNode === undefined ? undefined : attr(elementNode, \"c:type\"),\n        lengthParameterIndex: intAttr(arrayNode, \"length\"),\n        fixedSize: intAttr(arrayNode, \"fixed-size\"),\n        isZeroTerminated: isAttrTrue(arrayNode, \"zero-terminated\", true),\n    };\n\n    return context.addContainer(carray);\n};\n\nconst pointerFallback = (context: ParseContext): TypeId => context.addPrimitive(\"pointer\");\n\nconst splitOptionalNamespace = (name: string): [string | undefined, string] => {\n    const dot = name.indexOf(\".\");\n\n    if (dot === -1) {\n        return [undefined, name];\n    }\n\n    return [name.slice(0, dot), name.slice(dot + 1)];\n};\n\nexport { typeRefFromNode, splitOptionalNamespace };\n"]}
+{"version":3,"file":"type-ref.js","sourceRoot":"","sources":["../../src/gir/type-ref.ts"],"names":[],"mappings":"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","sourcesContent":["import { attr, getChild, getChildren, intAttr, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\nimport { primitiveCategory } from \"./primitives.js\";\nimport { type CArrayType, LIST_FLAVOR_BY_NAME, type ListFlavor, type ParseContext, type TypeId } from \"./type-id.js\";\n\nconst LIST_FLAVOR_BY_NAME_LOOKUP: Map<string, ListFlavor> = new Map(Object.entries(LIST_FLAVOR_BY_NAME));\n\nconst getElementRef = (node: RawNode, context: ParseContext): TypeId => {\n    const elementNode = getChild(node, \"type\");\n\n    return elementNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(elementNode, context);\n};\n\nconst typeRefFromNode = (parent: RawNode | undefined, context: ParseContext): TypeId | undefined => {\n    if (parent === undefined) {\n        return undefined;\n    }\n\n    if (getChild(parent, \"varargs\") !== undefined) {\n        return context.addVarargs();\n    }\n\n    const arrayNode = getChild(parent, \"array\");\n\n    if (arrayNode !== undefined) {\n        return arrayTypeRefFromNode(arrayNode, context);\n    }\n\n    const typeNode = getChild(parent, \"type\");\n\n    if (typeNode !== undefined) {\n        return typeRefFromTypeNode(typeNode, context);\n    }\n\n    const callback = getChild(parent, \"callback\");\n\n    if (callback !== undefined) {\n        return context.addAnonymousCallback(callback);\n    }\n\n    return undefined;\n};\n\nconst hashTableRefFromNode = (typeNode: RawNode, context: ParseContext): TypeId => {\n    const elementTypes = getChildren(typeNode, \"type\");\n    const keyNode = elementTypes[0];\n    const valueNode = elementTypes[1];\n\n    return context.addContainer({\n        kind: \"hashtable\",\n        key: keyNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(keyNode, context),\n        value: valueNode === undefined ? pointerFallback(context) : typeRefFromTypeNode(valueNode, context),\n    });\n};\n\nconst typeRefFromTypeNode = (typeNode: RawNode, context: ParseContext): TypeId => {\n    const name = nameAttr(typeNode);\n    const listFlavor = LIST_FLAVOR_BY_NAME_LOOKUP.get(name);\n\n    if (listFlavor !== undefined) {\n        return context.addContainer({ kind: \"list\", flavor: listFlavor, element: getElementRef(typeNode, context) });\n    }\n\n    if (name === \"GLib.HashTable\") {\n        return hashTableRefFromNode(typeNode, context);\n    }\n\n    const primitive = primitiveCategory(name);\n\n    if (primitive !== undefined) {\n        return context.addPrimitive(primitive);\n    }\n\n    return context.findType(name);\n};\n\nconst arrayTypeRefFromNode = (arrayNode: RawNode, context: ParseContext): TypeId => {\n    const element = getElementRef(arrayNode, context);\n    const arrayName = attr(arrayNode, \"name\");\n    const listFlavor = arrayName === undefined ? undefined : LIST_FLAVOR_BY_NAME_LOOKUP.get(arrayName);\n\n    if (listFlavor !== undefined) {\n        return context.addContainer({ kind: \"list\", flavor: listFlavor, element });\n    }\n\n    const elementNode = getChild(arrayNode, \"type\");\n\n    const carray: CArrayType = {\n        kind: \"carray\",\n        element,\n        elementCType: elementNode === undefined ? undefined : attr(elementNode, \"c:type\"),\n        arrayCType: attr(arrayNode, \"c:type\"),\n        lengthParameterIndex: intAttr(arrayNode, \"length\"),\n        fixedSize: intAttr(arrayNode, \"fixed-size\"),\n        isZeroTerminated: isAttrTrue(arrayNode, \"zero-terminated\", true),\n    };\n\n    return context.addContainer(carray);\n};\n\nconst pointerFallback = (context: ParseContext): TypeId => context.addPrimitive(\"pointer\");\n\nconst splitOptionalNamespace = (name: string): [string | undefined, string] => {\n    const dot = name.indexOf(\".\");\n\n    if (dot === -1) {\n        return [undefined, name];\n    }\n\n    return [name.slice(0, dot), name.slice(dot + 1)];\n};\n\nexport { typeRefFromNode, splitOptionalNamespace };\n"]}

package/dist/gir/type.d.ts

@@ -4,31 +4,51 @@ import type { GirEnum } from "./enum.js";
 import type { GirAlias, GirNamespace } from "./namespace.js";
 import type { GirRecord } from "./record.js";
 import type { StructuralType } from "./type-id.js";
+/** A named entity a GIR namespace declares, discriminated by `kind` and carrying the parsed node. */
 type EntityType = {
+    /** Discriminates {@link EntityType}. */
     kind: "class";
+    /** Namespace declaring the class. */
     namespace: GirNamespace;
+    /** Parsed class, carrying its GType metadata and the members it declares. */
     value: GirClass;
 } | {
+    /** Discriminates {@link EntityType}. */
     kind: "interface";
+    /** Namespace declaring the interface. */
     namespace: GirNamespace;
+    /** Parsed interface, modeled the same way as a class. */
     value: GirClass;
 } | {
+    /** Discriminates {@link EntityType}. */
     kind: "record";
+    /** Namespace declaring the record. */
     namespace: GirNamespace;
+    /** Parsed record, either a struct or a union. */
     value: GirRecord;
 } | {
+    /** Discriminates {@link EntityType}. */
     kind: "enum";
+    /** Namespace declaring the enumeration. */
     namespace: GirNamespace;
+    /** Parsed enumeration or bitfield. */
     value: GirEnum;
 } | {
+    /** Discriminates {@link EntityType}. */
     kind: "callback";
+    /** Namespace declaring the callback. */
     namespace: GirNamespace;
+    /** Parsed callback signature. */
     value: GirCallback;
 } | {
+    /** Discriminates {@link EntityType}. */
     kind: "alias";
+    /** Namespace declaring the alias. */
     namespace: GirNamespace;
+    /** Parsed alias, holding the type it stands for. */
     value: GirAlias;
 };
+/** What a GIR type reference resolves to: a structural type, or an entity a namespace declares. */
 type GirType = StructuralType | EntityType;
 export { type EntityType, type GirType };
 //# sourceMappingURL=type.d.ts.map

package/dist/gir/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/gir/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,KAAK,UAAU,GACT;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhE,KAAK,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;AAE3C,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,CAAC"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/gir/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,qGAAqG;AACrG,KAAK,UAAU,GACT;IACE,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,6EAA6E;IAC7E,KAAK,EAAE,QAAQ,CAAC;CACnB,GACD;IACI,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,YAAY,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,QAAQ,CAAC;CACnB,GACD;IACI,wCAAwC;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,sCAAsC;IACtC,SAAS,EAAE,YAAY,CAAC;IACxB,iDAAiD;IACjD,KAAK,EAAE,SAAS,CAAC;CACpB,GACD;IACI,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,SAAS,EAAE,YAAY,CAAC;IACxB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;CAClB,GACD;IACI,wCAAwC;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,YAAY,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,WAAW,CAAC;CACtB,GACD;IACI,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEN,mGAAmG;AACnG,KAAK,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;AAE3C,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,CAAC"}

package/dist/gir/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/gir/type.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAiC,CAAC","sourcesContent":["import type { GirCallback } from \"./callback.js\";\nimport type { GirClass } from \"./class.js\";\nimport type { GirEnum } from \"./enum.js\";\nimport type { GirAlias, GirNamespace } from \"./namespace.js\";\nimport type { GirRecord } from \"./record.js\";\nimport type { StructuralType } from \"./type-id.js\";\n\ntype EntityType =\n    | { kind: \"class\"; namespace: GirNamespace; value: GirClass } |\n    { kind: \"interface\"; namespace: GirNamespace; value: GirClass } |\n    { kind: \"record\"; namespace: GirNamespace; value: GirRecord } |\n    { kind: \"enum\"; namespace: GirNamespace; value: GirEnum } |\n    { kind: \"callback\"; namespace: GirNamespace; value: GirCallback } |\n    { kind: \"alias\"; namespace: GirNamespace; value: GirAlias };\n\ntype GirType = StructuralType | EntityType;\n\nexport { type EntityType, type GirType };\n"]}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/gir/type.ts"],"names":[],"mappings":"AA6DA,OAAO,EAAiC,CAAC","sourcesContent":["import type { GirCallback } from \"./callback.js\";\nimport type { GirClass } from \"./class.js\";\nimport type { GirEnum } from \"./enum.js\";\nimport type { GirAlias, GirNamespace } from \"./namespace.js\";\nimport type { GirRecord } from \"./record.js\";\nimport type { StructuralType } from \"./type-id.js\";\n\n/** A named entity a GIR namespace declares, discriminated by `kind` and carrying the parsed node. */\ntype EntityType =\n    | {\n        /** Discriminates {@link EntityType}. */\n        kind: \"class\";\n        /** Namespace declaring the class. */\n        namespace: GirNamespace;\n        /** Parsed class, carrying its GType metadata and the members it declares. */\n        value: GirClass;\n    } |\n    {\n        /** Discriminates {@link EntityType}. */\n        kind: \"interface\";\n        /** Namespace declaring the interface. */\n        namespace: GirNamespace;\n        /** Parsed interface, modeled the same way as a class. */\n        value: GirClass;\n    } |\n    {\n        /** Discriminates {@link EntityType}. */\n        kind: \"record\";\n        /** Namespace declaring the record. */\n        namespace: GirNamespace;\n        /** Parsed record, either a struct or a union. */\n        value: GirRecord;\n    } |\n    {\n        /** Discriminates {@link EntityType}. */\n        kind: \"enum\";\n        /** Namespace declaring the enumeration. */\n        namespace: GirNamespace;\n        /** Parsed enumeration or bitfield. */\n        value: GirEnum;\n    } |\n    {\n        /** Discriminates {@link EntityType}. */\n        kind: \"callback\";\n        /** Namespace declaring the callback. */\n        namespace: GirNamespace;\n        /** Parsed callback signature. */\n        value: GirCallback;\n    } |\n    {\n        /** Discriminates {@link EntityType}. */\n        kind: \"alias\";\n        /** Namespace declaring the alias. */\n        namespace: GirNamespace;\n        /** Parsed alias, holding the type it stands for. */\n        value: GirAlias;\n    };\n\n/** What a GIR type reference resolves to: a structural type, or an entity a namespace declares. */\ntype GirType = StructuralType | EntityType;\n\nexport { type EntityType, type GirType };\n"]}

package/dist/guards.d.ts

@@ -0,0 +1,16 @@
+type Guard<T> = (value: unknown) => value is T;
+type OptionalGuard<T> = Guard<T | undefined> & {
+    __optional__: true;
+};
+type FieldGuard<T> = [undefined] extends [T] ? OptionalGuard<NonNullable<T>> : Guard<T>;
+type FieldGuards<T> = {
+    [K in keyof Required<T>]: FieldGuard<T[K]>;
+};
+declare const isBoolean: (value: unknown) => value is boolean;
+declare const isNumber: (value: unknown) => value is number;
+declare const isString: (value: unknown) => value is string;
+declare const arrayGuard: <T>(isEntry: Guard<T>) => Guard<T[]>;
+declare const optionalGuard: <T>(isPresent: Guard<T>) => OptionalGuard<T>;
+declare const hasFields: <T extends object>(value: unknown, guards: FieldGuards<T>) => value is T;
+export { arrayGuard, hasFields, isBoolean, isNumber, isString, optionalGuard };
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;AAC/C,KAAK,aAAa,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG;IAAE,YAAY,EAAE,IAAI,CAAA;CAAE,CAAC;AACtE,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AACxF,KAAK,WAAW,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAErE,QAAA,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AACnF,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAChF,QAAA,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEhF,QAAA,MAAM,UAAU,GAAI,CAAC,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CACyD,CAAC;AAE9G,QAAA,MAAM,aAAa,GAAI,CAAC,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAGzD,CAAC;AAEP,QAAA,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,OAAO,EAAE,QAAQ,WAAW,CAAC,CAAC,CAAC,KAAG,KAAK,IAAI,CACuB,CAAC;AAE/G,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC"}

package/dist/guards.js

@@ -0,0 +1,11 @@
+import { isRecord } from "@gtkx/utils";
+const isBoolean = (value) => typeof value === "boolean";
+const isNumber = (value) => typeof value === "number";
+const isString = (value) => typeof value === "string";
+const arrayGuard = (isEntry) => (value) => Array.isArray(value) && value.every((entry) => isEntry(entry));
+const optionalGuard = (isPresent) => Object.assign((value) => value === undefined || isPresent(value), {
+    __optional__: true,
+});
+const hasFields = (value, guards) => isRecord(value) && Object.entries(guards).every(([name, guard]) => guard(value[name]));
+export { arrayGuard, hasFields, isBoolean, isNumber, isString, optionalGuard };
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC;AACnF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAChF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEhF,MAAM,UAAU,GAAG,CAAI,OAAiB,EAAc,EAAE,CACpD,CAAC,KAAc,EAAgB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE9G,MAAM,aAAa,GAAG,CAAI,SAAmB,EAAoB,EAAE,CAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,KAAc,EAA0B,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE;IAC/F,YAAY,EAAE,IAAa;CAC9B,CAAC,CAAC;AAEP,MAAM,SAAS,GAAG,CAAmB,KAAc,EAAE,MAAsB,EAAc,EAAE,CACvF,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAE,KAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE/G,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { isRecord } from \"@gtkx/utils\";\n\ntype Guard<T> = (value: unknown) => value is T;\ntype OptionalGuard<T> = Guard<T | undefined> & { __optional__: true };\ntype FieldGuard<T> = [undefined] extends [T] ? OptionalGuard<NonNullable<T>> : Guard<T>;\ntype FieldGuards<T> = { [K in keyof Required<T>]: FieldGuard<T[K]> };\n\nconst isBoolean = (value: unknown): value is boolean => typeof value === \"boolean\";\nconst isNumber = (value: unknown): value is number => typeof value === \"number\";\nconst isString = (value: unknown): value is string => typeof value === \"string\";\n\nconst arrayGuard = <T>(isEntry: Guard<T>): Guard<T[]> =>\n    (value: unknown): value is T[] => Array.isArray(value) && value.every((entry: unknown) => isEntry(entry));\n\nconst optionalGuard = <T>(isPresent: Guard<T>): OptionalGuard<T> =>\n    Object.assign((value: unknown): value is T | undefined => value === undefined || isPresent(value), {\n        __optional__: true as const,\n    });\n\nconst hasFields = <T extends object>(value: unknown, guards: FieldGuards<T>): value is T =>\n    isRecord(value) && Object.entries(guards).every(([name, guard]) => (guard as Guard<unknown>)(value[name]));\n\nexport { arrayGuard, hasFields, isBoolean, isNumber, isString, optionalGuard };\n"]}

package/dist/internal.d.ts

@@ -1,3 +1,5 @@
 export { writeDocs } from "./docs/pipeline.js";
 export { runGlCodegen } from "./runner.js";
+export { getShadowingStorePaths, sweepProjectStaging } from "./store/resolve-store.js";
+export { ensureStoreLinks } from "./store/store-links.js";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/internal.js

@@ -1,3 +1,5 @@
 export { writeDocs } from "./docs/pipeline.js";
 export { runGlCodegen } from "./runner.js";
+export { getShadowingStorePaths, sweepProjectStaging } from "./store/resolve-store.js";
+export { ensureStoreLinks } from "./store/store-links.js";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { writeDocs } from \"./docs/pipeline.js\";\nexport { runGlCodegen } from \"./runner.js\";\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { writeDocs } from \"./docs/pipeline.js\";\nexport { runGlCodegen } from \"./runner.js\";\nexport { getShadowingStorePaths, sweepProjectStaging } from \"./store/resolve-store.js\";\nexport { ensureStoreLinks } from \"./store/store-links.js\";\n"]}

package/dist/json.d.ts

@@ -0,0 +1,3 @@
+declare const readJsonFile: (path: string) => unknown;
+export { readJsonFile };
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAMpC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/json.js

@@ -0,0 +1,11 @@
+import { readFileSync } from "node:fs";
+const readJsonFile = (path) => {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+};
+export { readJsonFile };
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAW,EAAE;IAC3C,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { readFileSync } from \"node:fs\";\n\nconst readJsonFile = (path: string): unknown => {\n    try {\n        return JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n    } catch {\n        return undefined;\n    }\n};\n\nexport { readJsonFile };\n"]}

package/dist/khronos/args.d.ts

@@ -1,12 +1,12 @@
-import type { CommandPlan, GlScalar } from "./plan.js";
+import type { CommandPlan, GlScalar, ReturnPlan } from "./plan.js";
 type InArg = {
-    out: false;
+    isOut: false;
     name: string;
     tsType: string;
     descriptor: string;
 };
 type OutArg = {
-    out: true;
+    isOut: true;
     cellName: string;
     seed: string;
     tsType: string;
@@ -15,16 +15,17 @@ type OutArg = {
 };
 type PlannedArg = InArg | OutArg;
 declare const scalarAliasOrGroup: (scalar: GlScalar, group: string | undefined) => string;
+declare const returnPlanTsType: (plan: ReturnPlan, group: string | undefined) => string;
 declare const trackInto: (usedTypes: Set<string>) => (alias: string) => string;
 declare const planArgs: (plan: CommandPlan & {
-    ok: true;
+    isOk: true;
 }, usedTypes: Set<string>) => {
     args: PlannedArg[];
     ins: InArg[];
     outs: OutArg[];
 };
 declare const scalarPrefixArgs: (plan: CommandPlan & {
-    ok: true;
+    isOk: true;
 }, usedTypes: Set<string>) => InArg[] | undefined;
-export { scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs, type InArg, type OutArg };
+export { returnPlanTsType, scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs, type InArg, type OutArg };
 //# sourceMappingURL=args.d.ts.map

package/dist/khronos/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAC;AAclE,KAAK,KAAK,GAAG;IACT,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,MAAM,GAAG;IACV,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAqBjC,QAAA,MAAM,kBAAkB,GAAI,QAAQ,QAAQ,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MACQ,CAAC;AA8InF,QAAA,MAAM,SAAS,GACV,WAAW,GAAG,CAAC,MAAM,CAAC,MAClB,OAAO,MAAM,KAAG,MAIhB,CAAC;AAEV,QAAA,MAAM,QAAQ,GACV,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAChC,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAsBpD,CAAC;AAwBF,QAAA,MAAM,gBAAgB,GAAI,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAAE,WAAW,GAAG,CAAC,MAAM,CAAC,KAAG,KAAK,EAAE,GAAG,SAe9F,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAa,UAAU,EAAE,MAAM,WAAW,CAAC;AAc9E,KAAK,KAAK,GAAG;IACT,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,MAAM,GAAG;IACV,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAqBjC,QAAA,MAAM,kBAAkB,GAAI,QAAQ,QAAQ,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MACQ,CAAC;AAEnF,QAAA,MAAM,gBAAgB,GAAI,MAAM,UAAU,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,MAqBvE,CAAC;AA8IF,QAAA,MAAM,SAAS,GACV,WAAW,GAAG,CAAC,MAAM,CAAC,MAClB,OAAO,MAAM,KAAG,MAIhB,CAAC;AAEV,QAAA,MAAM,QAAQ,GACV,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAClC,WAAW,GAAG,CAAC,MAAM,CAAC,KACvB;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAsBpD,CAAC;AAwBF,QAAA,MAAM,gBAAgB,GAAI,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,WAAW,GAAG,CAAC,MAAM,CAAC,KAAG,KAAK,EAAE,GAAG,SAehG,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC"}

package/dist/khronos/args.js

@@ -3,6 +3,28 @@ import { tArray, tBoolean, tBuffer, tFixedArray, tInlineStruct, tRef, tSizedArra
 import { paramPairAt } from "./param-pair.js";
 const OUT_PLAN_KINDS = new Set(["ref-out", "ref-array-out", "ref-fixed-out", "string-out"]);
 const scalarAliasOrGroup = (scalar, group) => group !== undefined && scalar.isGroupBearing === true ? group : scalar.tsAlias;
+const returnPlanTsType = (plan, group) => {
+    switch (plan.kind) {
+        case "void": {
+            return "void";
+        }
+        case "scalar": {
+            return scalarAliasOrGroup(plan.scalar, group);
+        }
+        case "boolean": {
+            return "boolean";
+        }
+        case "string": {
+            return "string";
+        }
+        case "sync": {
+            return "GLsync";
+        }
+        case "opaque-pointer": {
+            return "GLpointer";
+        }
+    }
+};
 const paramIndexByName = (command, name) => {
     const index = command.params.findIndex((param) => param.name === name);
     if (index === -1) {
@@ -15,7 +37,7 @@ const arrayInTsType = (scalar, group) => {
     return scalar.viewType === undefined ? `${element}[]` : `${element}[] | ${scalar.viewType}`;
 };
 const inArg = (name, tsType, descriptor) => ({
-    out: false,
+    isOut: false,
     name,
     tsType,
     descriptor,
@@ -78,7 +100,7 @@ const outArgFields = (options) => {
             const lenIdentifier = toCamelIdentifier(plan.lenParamName);
             return {
                 seed: `const ${cellName} = { value: new Array<number>(${lenIdentifier}).fill(0) };`,
-                tsType: `${track(plan.scalar.tsAlias)}[]`,
+                tsType: `${track(scalarAliasOrGroup(plan.scalar, param.group))}[]`,
                 descriptor: tRef(tSizedArray(plan.scalar.descriptor, sizeIndex)),
             };
         }
@@ -116,12 +138,12 @@ const buildOutArg = (options, track) => {
         throw new Error(`Parameter index ${String(index)} out of range on ${command.name}`);
     }
     const cellName = `out${String(outIndex)}`;
-    const cell = { out: true, cellName, paramIndex: index };
+    const cell = { isOut: true, cellName, paramIndex: index };
     return { ...cell, ...outArgFields({ command, plan, param, cellName, track }) };
 };
 const isOutPlan = (plan) => OUT_PLAN_KINDS.has(plan.kind);
-const isInArg = (arg) => !arg.out;
-const isOutArg = (arg) => arg.out;
+const isInArg = (arg) => !arg.isOut;
+const isOutArg = (arg) => arg.isOut;
 const buildArg = (options, name, track) => isOutPlan(options.plan) ? buildOutArg(options, track) : buildInArg(options, name, track);
 const trackInto = (usedTypes) => (alias) => {
     usedTypes.add(alias);
@@ -167,5 +189,5 @@ const scalarPrefixArgs = (plan, usedTypes) => {
     }
     return prefix;
 };
-export { scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs };
+export { returnPlanTsType, scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs };
 //# sourceMappingURL=args.js.map

package/dist/khronos/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GlCommand, GlParam } from \"./model.js\";\nimport type { CommandPlan, GlScalar, ParamPlan } from \"./plan.js\";\nimport {\n    tArray,\n    tBoolean,\n    tBuffer,\n    tFixedArray,\n    tInlineStruct,\n    tRef,\n    tSizedArray,\n    tString,\n    tUint64,\n} from \"../analysis/descriptor.js\";\nimport { paramPairAt } from \"./param-pair.js\";\n\ntype InArg = {\n    out: false;\n    name: string;\n    tsType: string;\n    descriptor: string;\n};\n\ntype OutArg = {\n    out: true;\n    cellName: string;\n    seed: string;\n    tsType: string;\n    descriptor: string;\n    paramIndex: number;\n};\n\ntype PlannedArg = InArg | OutArg;\ntype OutArgCell = Pick<OutArg, \"out\" | \"cellName\" | \"paramIndex\">;\ntype OutArgFields = Pick<OutArg, \"seed\" | \"tsType\" | \"descriptor\">;\n\ntype OutArgFieldsOptions = {\n    command: GlCommand;\n    plan: ParamPlan;\n    param: GlParam;\n    cellName: string;\n    track: (alias: string) => string;\n};\n\ntype BuildArgOptions = {\n    command: GlCommand;\n    index: number;\n    plan: ParamPlan;\n    outIndex: number;\n};\n\nconst OUT_PLAN_KINDS: Set<string> = new Set([\"ref-out\", \"ref-array-out\", \"ref-fixed-out\", \"string-out\"]);\n\nconst scalarAliasOrGroup = (scalar: GlScalar, group: string | undefined): string =>\n    group !== undefined && scalar.isGroupBearing === true ? group : scalar.tsAlias;\n\nconst paramIndexByName = (command: GlCommand, name: string): number => {\n    const index = command.params.findIndex((param) => param.name === name);\n\n    if (index === -1) {\n        throw new Error(`Command ${command.name} has no parameter named ${name}`);\n    }\n\n    return index;\n};\n\nconst arrayInTsType = (scalar: GlScalar, group: string | undefined): string => {\n    const element = scalarAliasOrGroup(scalar, group);\n\n    return scalar.viewType === undefined ? `${element}[]` : `${element}[] | ${scalar.viewType}`;\n};\n\nconst inArg = (name: string, tsType: string, descriptor: string): InArg => ({\n    out: false,\n    name,\n    tsType,\n    descriptor,\n});\n\nconst buildInArg = (options: BuildArgOptions, name: string, track: (alias: string) => string): InArg => {\n    const { command, index, plan } = options;\n    const param = command.params[index];\n\n    if (param === undefined) {\n        throw new Error(`Parameter index ${String(index)} out of range on ${command.name}`);\n    }\n\n    switch (plan.kind) {\n        case \"scalar\": {\n            return inArg(name, track(scalarAliasOrGroup(plan.scalar, param.group)), plan.scalar.descriptor);\n        }\n        case \"boolean\": {\n            return inArg(name, \"boolean\", tBoolean);\n        }\n        case \"sync\": {\n            return inArg(name, track(\"GLsync\"), tInlineStruct());\n        }\n        case \"string-in\": {\n            return inArg(name, \"string\", tString(\"borrowed\"));\n        }\n        case \"string-array-in\": {\n            return inArg(name, \"string[]\", tArray(tString(\"borrowed\")));\n        }\n        case \"array-in\": {\n            track(scalarAliasOrGroup(plan.scalar, param.group));\n\n            return inArg(name, arrayInTsType(plan.scalar, param.group), tArray(plan.scalar.descriptor));\n        }\n        case \"buffer\": {\n            return inArg(name, `ArrayBufferView | ${track(\"GLintptr\")} | null`, tBuffer);\n        }\n        case \"byte-offset\": {\n            return inArg(name, track(\"GLintptr\"), tUint64);\n        }\n        case \"byte-offset-array\": {\n            return inArg(name, `${track(\"GLintptr\")}[]`, tArray(tUint64));\n        }\n        case \"ref-array-out\":\n        case \"ref-fixed-out\":\n        case \"ref-out\":\n        case \"string-out\": {\n            throw new Error(`Plan kind ${plan.kind} is not an input parameter`);\n        }\n    }\n};\n\nconst outArgFields = (options: OutArgFieldsOptions): OutArgFields => {\n    const { command, plan, param, cellName, track } = options;\n\n    switch (plan.kind) {\n        case \"ref-out\": {\n            return {\n                seed: `const ${cellName} = { value: 0 };`,\n                tsType: track(scalarAliasOrGroup(plan.scalar, param.group)),\n                descriptor: tRef(plan.scalar.descriptor),\n            };\n        }\n        case \"ref-array-out\": {\n            const sizeIndex = paramIndexByName(command, plan.lenParamName);\n            const lenIdentifier = toCamelIdentifier(plan.lenParamName);\n\n            return {\n                seed: `const ${cellName} = { value: new Array<number>(${lenIdentifier}).fill(0) };`,\n                tsType: `${track(plan.scalar.tsAlias)}[]`,\n                descriptor: tRef(tSizedArray(plan.scalar.descriptor, sizeIndex)),\n            };\n        }\n        case \"ref-fixed-out\": {\n            return {\n                seed: `const ${cellName} = { value: new Array<number>(${String(plan.length)}).fill(0) };`,\n                tsType: `${track(plan.scalar.tsAlias)}[]`,\n                descriptor: tRef(tFixedArray(plan.scalar.descriptor, plan.length)),\n            };\n        }\n        case \"string-out\": {\n            return {\n                seed: `const ${cellName} = { value: \"\" };`,\n                tsType: \"string\",\n                descriptor: tRef(tString(\"borrowed\", toCamelIdentifier(plan.lenParamName))),\n            };\n        }\n        case \"array-in\":\n        case \"boolean\":\n        case \"buffer\":\n        case \"byte-offset\":\n        case \"byte-offset-array\":\n        case \"scalar\":\n        case \"string-array-in\":\n        case \"string-in\":\n        case \"sync\": {\n            throw new Error(`Plan kind ${plan.kind} is not an output parameter`);\n        }\n    }\n};\n\nconst buildOutArg = (options: BuildArgOptions, track: (alias: string) => string): OutArg => {\n    const { command, index, plan, outIndex } = options;\n    const param = command.params[index];\n\n    if (param === undefined) {\n        throw new Error(`Parameter index ${String(index)} out of range on ${command.name}`);\n    }\n\n    const cellName = `out${String(outIndex)}`;\n    const cell: OutArgCell = { out: true, cellName, paramIndex: index };\n\n    return { ...cell, ...outArgFields({ command, plan, param, cellName, track }) };\n};\n\nconst isOutPlan = (plan: ParamPlan): boolean => OUT_PLAN_KINDS.has(plan.kind);\nconst isInArg = (arg: PlannedArg): arg is InArg => !arg.out;\nconst isOutArg = (arg: PlannedArg): arg is OutArg => arg.out;\n\nconst buildArg = (options: BuildArgOptions, name: string, track: (alias: string) => string): PlannedArg =>\n    isOutPlan(options.plan) ? buildOutArg(options, track) : buildInArg(options, name, track);\n\nconst trackInto =\n    (usedTypes: Set<string>) =>\n        (alias: string): string => {\n            usedTypes.add(alias);\n\n            return alias;\n        };\n\nconst planArgs = (\n    plan: CommandPlan & { ok: true },\n    usedTypes: Set<string>,\n): { args: PlannedArg[]; ins: InArg[]; outs: OutArg[] } => {\n    const track = trackInto(usedTypes);\n    const args: PlannedArg[] = [];\n\n    for (const [index, paramPlan] of plan.params.entries()) {\n        const param = plan.command.params[index];\n\n        if (param === undefined) {\n            throw new Error(`Parameter index ${String(index)} out of range on ${plan.command.name}`);\n        }\n\n        const options: BuildArgOptions = {\n            command: plan.command,\n            index,\n            plan: paramPlan,\n            outIndex: args.filter(isOutArg).length,\n        };\n\n        args.push(buildArg(options, toCamelIdentifier(param.name), track));\n    }\n\n    return { args, ins: args.filter(isInArg), outs: args.filter(isOutArg) };\n};\n\nconst scalarPrefixArg = (\n    plan: CommandPlan & { ok: true },\n    index: number,\n    track: (alias: string) => string,\n): InArg | undefined => {\n    const { paramPlan, param } = paramPairAt(plan, index);\n\n    if (param === undefined) {\n        return undefined;\n    }\n\n    if (paramPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    return buildInArg(\n        { command: plan.command, index, plan: paramPlan, outIndex: 0 },\n        toCamelIdentifier(param.name),\n        track,\n    );\n};\n\nconst scalarPrefixArgs = (plan: CommandPlan & { ok: true }, usedTypes: Set<string>): InArg[] | undefined => {\n    const track = trackInto(usedTypes);\n    const prefix: InArg[] = [];\n\n    for (let index = 0; index < plan.params.length - 2; index++) {\n        const arg = scalarPrefixArg(plan, index, track);\n\n        if (arg === undefined) {\n            return undefined;\n        }\n\n        prefix.push(arg);\n    }\n\n    return prefix;\n};\n\nexport { scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs, type InArg, type OutArg };\n"]}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/khronos/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GlCommand, GlParam } from \"./model.js\";\nimport type { CommandPlan, GlScalar, ParamPlan, ReturnPlan } from \"./plan.js\";\nimport {\n    tArray,\n    tBoolean,\n    tBuffer,\n    tFixedArray,\n    tInlineStruct,\n    tRef,\n    tSizedArray,\n    tString,\n    tUint64,\n} from \"../analysis/descriptor.js\";\nimport { paramPairAt } from \"./param-pair.js\";\n\ntype InArg = {\n    isOut: false;\n    name: string;\n    tsType: string;\n    descriptor: string;\n};\n\ntype OutArg = {\n    isOut: true;\n    cellName: string;\n    seed: string;\n    tsType: string;\n    descriptor: string;\n    paramIndex: number;\n};\n\ntype PlannedArg = InArg | OutArg;\ntype OutArgCell = Pick<OutArg, \"isOut\" | \"cellName\" | \"paramIndex\">;\ntype OutArgFields = Pick<OutArg, \"seed\" | \"tsType\" | \"descriptor\">;\n\ntype OutArgFieldsOptions = {\n    command: GlCommand;\n    plan: ParamPlan;\n    param: GlParam;\n    cellName: string;\n    track: (alias: string) => string;\n};\n\ntype BuildArgOptions = {\n    command: GlCommand;\n    index: number;\n    plan: ParamPlan;\n    outIndex: number;\n};\n\nconst OUT_PLAN_KINDS: Set<string> = new Set([\"ref-out\", \"ref-array-out\", \"ref-fixed-out\", \"string-out\"]);\n\nconst scalarAliasOrGroup = (scalar: GlScalar, group: string | undefined): string =>\n    group !== undefined && scalar.isGroupBearing === true ? group : scalar.tsAlias;\n\nconst returnPlanTsType = (plan: ReturnPlan, group: string | undefined): string => {\n    switch (plan.kind) {\n        case \"void\": {\n            return \"void\";\n        }\n        case \"scalar\": {\n            return scalarAliasOrGroup(plan.scalar, group);\n        }\n        case \"boolean\": {\n            return \"boolean\";\n        }\n        case \"string\": {\n            return \"string\";\n        }\n        case \"sync\": {\n            return \"GLsync\";\n        }\n        case \"opaque-pointer\": {\n            return \"GLpointer\";\n        }\n    }\n};\n\nconst paramIndexByName = (command: GlCommand, name: string): number => {\n    const index = command.params.findIndex((param) => param.name === name);\n\n    if (index === -1) {\n        throw new Error(`Command ${command.name} has no parameter named ${name}`);\n    }\n\n    return index;\n};\n\nconst arrayInTsType = (scalar: GlScalar, group: string | undefined): string => {\n    const element = scalarAliasOrGroup(scalar, group);\n\n    return scalar.viewType === undefined ? `${element}[]` : `${element}[] | ${scalar.viewType}`;\n};\n\nconst inArg = (name: string, tsType: string, descriptor: string): InArg => ({\n    isOut: false,\n    name,\n    tsType,\n    descriptor,\n});\n\nconst buildInArg = (options: BuildArgOptions, name: string, track: (alias: string) => string): InArg => {\n    const { command, index, plan } = options;\n    const param = command.params[index];\n\n    if (param === undefined) {\n        throw new Error(`Parameter index ${String(index)} out of range on ${command.name}`);\n    }\n\n    switch (plan.kind) {\n        case \"scalar\": {\n            return inArg(name, track(scalarAliasOrGroup(plan.scalar, param.group)), plan.scalar.descriptor);\n        }\n        case \"boolean\": {\n            return inArg(name, \"boolean\", tBoolean);\n        }\n        case \"sync\": {\n            return inArg(name, track(\"GLsync\"), tInlineStruct());\n        }\n        case \"string-in\": {\n            return inArg(name, \"string\", tString(\"borrowed\"));\n        }\n        case \"string-array-in\": {\n            return inArg(name, \"string[]\", tArray(tString(\"borrowed\")));\n        }\n        case \"array-in\": {\n            track(scalarAliasOrGroup(plan.scalar, param.group));\n\n            return inArg(name, arrayInTsType(plan.scalar, param.group), tArray(plan.scalar.descriptor));\n        }\n        case \"buffer\": {\n            return inArg(name, `ArrayBufferView | ${track(\"GLintptr\")} | null`, tBuffer);\n        }\n        case \"byte-offset\": {\n            return inArg(name, track(\"GLintptr\"), tUint64);\n        }\n        case \"byte-offset-array\": {\n            return inArg(name, `${track(\"GLintptr\")}[]`, tArray(tUint64));\n        }\n        case \"ref-array-out\":\n        case \"ref-fixed-out\":\n        case \"ref-out\":\n        case \"string-out\": {\n            throw new Error(`Plan kind ${plan.kind} is not an input parameter`);\n        }\n    }\n};\n\nconst outArgFields = (options: OutArgFieldsOptions): OutArgFields => {\n    const { command, plan, param, cellName, track } = options;\n\n    switch (plan.kind) {\n        case \"ref-out\": {\n            return {\n                seed: `const ${cellName} = { value: 0 };`,\n                tsType: track(scalarAliasOrGroup(plan.scalar, param.group)),\n                descriptor: tRef(plan.scalar.descriptor),\n            };\n        }\n        case \"ref-array-out\": {\n            const sizeIndex = paramIndexByName(command, plan.lenParamName);\n            const lenIdentifier = toCamelIdentifier(plan.lenParamName);\n\n            return {\n                seed: `const ${cellName} = { value: new Array<number>(${lenIdentifier}).fill(0) };`,\n                tsType: `${track(scalarAliasOrGroup(plan.scalar, param.group))}[]`,\n                descriptor: tRef(tSizedArray(plan.scalar.descriptor, sizeIndex)),\n            };\n        }\n        case \"ref-fixed-out\": {\n            return {\n                seed: `const ${cellName} = { value: new Array<number>(${String(plan.length)}).fill(0) };`,\n                tsType: `${track(plan.scalar.tsAlias)}[]`,\n                descriptor: tRef(tFixedArray(plan.scalar.descriptor, plan.length)),\n            };\n        }\n        case \"string-out\": {\n            return {\n                seed: `const ${cellName} = { value: \"\" };`,\n                tsType: \"string\",\n                descriptor: tRef(tString(\"borrowed\", toCamelIdentifier(plan.lenParamName))),\n            };\n        }\n        case \"array-in\":\n        case \"boolean\":\n        case \"buffer\":\n        case \"byte-offset\":\n        case \"byte-offset-array\":\n        case \"scalar\":\n        case \"string-array-in\":\n        case \"string-in\":\n        case \"sync\": {\n            throw new Error(`Plan kind ${plan.kind} is not an output parameter`);\n        }\n    }\n};\n\nconst buildOutArg = (options: BuildArgOptions, track: (alias: string) => string): OutArg => {\n    const { command, index, plan, outIndex } = options;\n    const param = command.params[index];\n\n    if (param === undefined) {\n        throw new Error(`Parameter index ${String(index)} out of range on ${command.name}`);\n    }\n\n    const cellName = `out${String(outIndex)}`;\n    const cell: OutArgCell = { isOut: true, cellName, paramIndex: index };\n\n    return { ...cell, ...outArgFields({ command, plan, param, cellName, track }) };\n};\n\nconst isOutPlan = (plan: ParamPlan): boolean => OUT_PLAN_KINDS.has(plan.kind);\nconst isInArg = (arg: PlannedArg): arg is InArg => !arg.isOut;\nconst isOutArg = (arg: PlannedArg): arg is OutArg => arg.isOut;\n\nconst buildArg = (options: BuildArgOptions, name: string, track: (alias: string) => string): PlannedArg =>\n    isOutPlan(options.plan) ? buildOutArg(options, track) : buildInArg(options, name, track);\n\nconst trackInto =\n    (usedTypes: Set<string>) =>\n        (alias: string): string => {\n            usedTypes.add(alias);\n\n            return alias;\n        };\n\nconst planArgs = (\n    plan: CommandPlan & { isOk: true },\n    usedTypes: Set<string>,\n): { args: PlannedArg[]; ins: InArg[]; outs: OutArg[] } => {\n    const track = trackInto(usedTypes);\n    const args: PlannedArg[] = [];\n\n    for (const [index, paramPlan] of plan.params.entries()) {\n        const param = plan.command.params[index];\n\n        if (param === undefined) {\n            throw new Error(`Parameter index ${String(index)} out of range on ${plan.command.name}`);\n        }\n\n        const options: BuildArgOptions = {\n            command: plan.command,\n            index,\n            plan: paramPlan,\n            outIndex: args.filter(isOutArg).length,\n        };\n\n        args.push(buildArg(options, toCamelIdentifier(param.name), track));\n    }\n\n    return { args, ins: args.filter(isInArg), outs: args.filter(isOutArg) };\n};\n\nconst scalarPrefixArg = (\n    plan: CommandPlan & { isOk: true },\n    index: number,\n    track: (alias: string) => string,\n): InArg | undefined => {\n    const { paramPlan, param } = paramPairAt(plan, index);\n\n    if (param === undefined) {\n        return undefined;\n    }\n\n    if (paramPlan?.kind !== \"scalar\") {\n        return undefined;\n    }\n\n    return buildInArg(\n        { command: plan.command, index, plan: paramPlan, outIndex: 0 },\n        toCamelIdentifier(param.name),\n        track,\n    );\n};\n\nconst scalarPrefixArgs = (plan: CommandPlan & { isOk: true }, usedTypes: Set<string>): InArg[] | undefined => {\n    const track = trackInto(usedTypes);\n    const prefix: InArg[] = [];\n\n    for (let index = 0; index < plan.params.length - 2; index++) {\n        const arg = scalarPrefixArg(plan, index, track);\n\n        if (arg === undefined) {\n            return undefined;\n        }\n\n        prefix.push(arg);\n    }\n\n    return prefix;\n};\n\nexport { returnPlanTsType, scalarAliasOrGroup, trackInto, planArgs, scalarPrefixArgs, type InArg, type OutArg };\n"]}

package/dist/khronos/doc-context.d.ts

@@ -0,0 +1,29 @@
+import type { GlExtensionAttribution, GlExtensionIndex } from "./extensions.js";
+import type { GlEnum, GlRegistry, GlType } from "./model.js";
+import type { CommandPlan } from "./plan.js";
+type GlDocEnumRow = {
+    token: GlEnum;
+    exportName: string;
+};
+type GlDocContext = {
+    registryComment?: string;
+    kinds: Map<string, string>;
+    types: Map<string, GlType>;
+    aliasTargets: Map<string, string[]>;
+    extensionCommands: Map<string, GlExtensionAttribution[]>;
+    extensionEnums: Map<string, GlExtensionAttribution[]>;
+    bitmaskGroups: Set<string>;
+    emittedCommands: Set<string>;
+    groupMembers: Map<string, string[]>;
+};
+type BuildDocContextOptions = {
+    registry: GlRegistry;
+    extensions: GlExtensionIndex;
+    plans: (CommandPlan & {
+        isOk: true;
+    })[];
+    enumRows: GlDocEnumRow[];
+};
+declare const buildDocContext: (options: BuildDocContextOptions) => GlDocContext;
+export { buildDocContext, type GlDocContext };
+//# sourceMappingURL=doc-context.d.ts.map

package/dist/khronos/doc-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-context.d.ts","sourceRoot":"","sources":["../../src/khronos/doc-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,KAAK,YAAY,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACzD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,EAAE,CAAC;IACxC,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC5B,CAAC;AAkBF,QAAA,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,YAc1D,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/khronos/doc-context.js

@@ -0,0 +1,29 @@
+import { sortStrings } from "@gtkx/utils";
+const buildGroupMembers = (rows) => {
+    const members = new Map();
+    for (const row of rows) {
+        for (const group of row.token.groups) {
+            members.set(group, [...(members.get(group) ?? []), row.exportName]);
+        }
+    }
+    for (const [group, names] of members) {
+        members.set(group, sortStrings(names));
+    }
+    return members;
+};
+const buildDocContext = (options) => {
+    const { registry, extensions, plans, enumRows } = options;
+    return {
+        ...(registry.comment !== undefined && { registryComment: registry.comment }),
+        kinds: registry.kinds,
+        types: registry.types,
+        aliasTargets: registry.aliasTargets,
+        extensionCommands: extensions.commands,
+        extensionEnums: extensions.enums,
+        bitmaskGroups: registry.bitmaskGroups,
+        emittedCommands: new Set(plans.map((plan) => plan.command.name)),
+        groupMembers: buildGroupMembers(enumRows),
+    };
+};
+export { buildDocContext };
+//# sourceMappingURL=doc-context.js.map

package/dist/khronos/doc-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-context.js","sourceRoot":"","sources":["../../src/khronos/doc-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6B1C,MAAM,iBAAiB,GAAG,CAAC,IAAoB,EAAyB,EAAE;IACtE,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAA+B,EAAgB,EAAE;IACtE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1D,OAAO;QACH,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5E,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,iBAAiB,EAAE,UAAU,CAAC,QAAQ;QACtC,cAAc,EAAE,UAAU,CAAC,KAAK;QAChC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,eAAe,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;KAC5C,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAqB,CAAC","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport type { GlExtensionAttribution, GlExtensionIndex } from \"./extensions.js\";\nimport type { GlEnum, GlRegistry, GlType } from \"./model.js\";\nimport type { CommandPlan } from \"./plan.js\";\n\ntype GlDocEnumRow = {\n    token: GlEnum;\n    exportName: string;\n};\n\ntype GlDocContext = {\n    registryComment?: string;\n    kinds: Map<string, string>;\n    types: Map<string, GlType>;\n    aliasTargets: Map<string, string[]>;\n    extensionCommands: Map<string, GlExtensionAttribution[]>;\n    extensionEnums: Map<string, GlExtensionAttribution[]>;\n    bitmaskGroups: Set<string>;\n    emittedCommands: Set<string>;\n    groupMembers: Map<string, string[]>;\n};\n\ntype BuildDocContextOptions = {\n    registry: GlRegistry;\n    extensions: GlExtensionIndex;\n    plans: (CommandPlan & { isOk: true })[];\n    enumRows: GlDocEnumRow[];\n};\n\nconst buildGroupMembers = (rows: GlDocEnumRow[]): Map<string, string[]> => {\n    const members: Map<string, string[]> = new Map();\n\n    for (const row of rows) {\n        for (const group of row.token.groups) {\n            members.set(group, [...(members.get(group) ?? []), row.exportName]);\n        }\n    }\n\n    for (const [group, names] of members) {\n        members.set(group, sortStrings(names));\n    }\n\n    return members;\n};\n\nconst buildDocContext = (options: BuildDocContextOptions): GlDocContext => {\n    const { registry, extensions, plans, enumRows } = options;\n\n    return {\n        ...(registry.comment !== undefined && { registryComment: registry.comment }),\n        kinds: registry.kinds,\n        types: registry.types,\n        aliasTargets: registry.aliasTargets,\n        extensionCommands: extensions.commands,\n        extensionEnums: extensions.enums,\n        bitmaskGroups: registry.bitmaskGroups,\n        emittedCommands: new Set(plans.map((plan) => plan.command.name)),\n        groupMembers: buildGroupMembers(enumRows),\n    };\n};\n\nexport { buildDocContext, type GlDocContext };\n"]}

package/dist/khronos/extensions.d.ts

@@ -0,0 +1,13 @@
+import type { GlRegistry } from "./model.js";
+import type { GlSelection } from "./select.js";
+type GlExtensionAttribution = {
+    name: string;
+    notes: string[];
+};
+type GlExtensionIndex = {
+    commands: Map<string, GlExtensionAttribution[]>;
+    enums: Map<string, GlExtensionAttribution[]>;
+};
+declare const buildExtensionIndex: (registry: GlRegistry, selection: GlSelection) => GlExtensionIndex;
+export { buildExtensionIndex, type GlExtensionAttribution, type GlExtensionIndex };
+//# sourceMappingURL=extensions.d.ts.map

package/dist/khronos/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/khronos/extensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiC,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,sBAAsB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;CAChD,CAAC;AA4DF,QAAA,MAAM,mBAAmB,GAAI,UAAU,UAAU,EAAE,WAAW,WAAW,KAAG,gBAU3E,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/khronos/extensions.js

@@ -0,0 +1,49 @@
+import { sortStrings } from "@gtkx/utils";
+const SUPPORTED_APIS = new Set(["gl", "glcore"]);
+const isExtensionSupported = (extension) => extension.supported.some((api) => SUPPORTED_APIS.has(api));
+const isBlockIncluded = (block, selection) => block.kind === "require" &&
+    (block.api === undefined || block.api === selection.api) &&
+    (block.profile === undefined || block.profile === selection.profile);
+const blockNotes = (extension, block) => [
+    ...(extension.comment === undefined ? [] : [extension.comment]),
+    ...(block.comment === undefined ? [] : [block.comment]),
+];
+const appendMembers = (index, names, extension, notes) => {
+    for (const name of names) {
+        const byExtension = index.get(name) ?? new Map();
+        byExtension.set(extension, [...(byExtension.get(extension) ?? []), ...notes]);
+        index.set(name, byExtension);
+    }
+};
+const indexExtension = (index, extension, selection) => {
+    for (const block of extension.blocks) {
+        if (!isBlockIncluded(block, selection)) {
+            continue;
+        }
+        const notes = blockNotes(extension, block);
+        appendMembers(index.commands, block.commands, extension.name, notes);
+        appendMembers(index.enums, block.enums, extension.name, notes);
+    }
+};
+const attributionsFor = (byExtension) => sortStrings(byExtension.keys()).map((name) => ({
+    name,
+    notes: [...new Set(byExtension.get(name))],
+}));
+const finalizeIndex = (pending) => {
+    const index = new Map();
+    for (const [name, byExtension] of pending) {
+        index.set(name, attributionsFor(byExtension));
+    }
+    return index;
+};
+const buildExtensionIndex = (registry, selection) => {
+    const pending = { commands: new Map(), enums: new Map() };
+    for (const extension of registry.extensions) {
+        if (isExtensionSupported(extension)) {
+            indexExtension(pending, extension, selection);
+        }
+    }
+    return { commands: finalizeIndex(pending.commands), enums: finalizeIndex(pending.enums) };
+};
+export { buildExtensionIndex };
+//# sourceMappingURL=extensions.js.map