@gtkx/codegen 1.0.0-rc.3 → 1.0.0

package/dist/gir/parameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../src/gir/parameter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport {\n    attr,\n    getChild,\n    getChildren,\n    getDoc,\n    intAttr,\n    isAttrTrue,\n    nameAttr,\n    parseEnumAttr,\n    type RawNode,\n} from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\ntype ParameterDirection = \"in\" | \"out\" | \"inout\";\ntype ParameterTransfer = \"none\" | \"full\" | \"container\";\ntype CallbackScope = \"call\" | \"notified\" | \"async\" | \"forever\";\n\ntype GirParameter = {\n    name: string;\n    type: TypeId | undefined;\n    direction: ParameterDirection;\n    transferOwnership: ParameterTransfer;\n    nullable: boolean;\n    optional: boolean;\n    callerAllocates: boolean;\n    scope: CallbackScope | undefined;\n    closureIndex: number | undefined;\n    destroyIndex: number | undefined;\n    isVarargs: boolean;\n};\n\ntype GirReturnValue = {\n    type: TypeId | undefined;\n    transferOwnership: ParameterTransfer;\n    nullable: boolean;\n    skip: boolean;\n};\n\ntype GirCallable = {\n    name: string;\n    doc: string | undefined;\n    parameters: GirParameter[];\n    returnValue: GirReturnValue;\n    throws: boolean;\n    introspectable: boolean;\n};\n\nconst DIRECTIONS: Set<ParameterDirection> = new Set([\"in\", \"out\", \"inout\"]);\nconst TRANSFERS: Set<ParameterTransfer> = new Set([\"none\", \"full\", \"container\"]);\nconst SCOPES: Set<CallbackScope> = new Set([\"call\", \"notified\", \"async\", \"forever\"]);\n\nconst transferOwnership = (node: RawNode): ParameterTransfer =>\n    parseEnumAttr(attr(node, \"transfer-ownership\"), TRANSFERS, \"none\", \"transfer-ownership\");\n\n// `allow-none` is the legacy spelling of two different attributes: on an in-parameter it means the\n// value may be NULL (`nullable`), but on an out-parameter it means the caller may pass a NULL\n// location (`optional`). Folding it into `nullable` for an out-parameter would claim the returned\n// value can be null for the 494 out-parameters across the installed GIRs that only say `allow-none`.\nconst isInDirection = (node: RawNode): boolean =>\n    parseEnumAttr(attr(node, \"direction\"), DIRECTIONS, \"in\", \"direction\") === \"in\";\n\nconst hasNullableAttr = (node: RawNode): boolean =>\n    isAttrTrue(node, \"nullable\") || (isInDirection(node) && isAttrTrue(node, \"allow-none\"));\n\nconst hasOptionalAttr = (node: RawNode): boolean =>\n    isAttrTrue(node, \"optional\") || (!isInDirection(node) && isAttrTrue(node, \"allow-none\"));\n\nconst parameterFromNode = (node: RawNode, context: ParseContext): GirParameter => ({\n    name: nameAttr(node),\n    type: typeRefFromNode(node, context),\n    direction: parseEnumAttr(attr(node, \"direction\"), DIRECTIONS, \"in\", \"direction\"),\n    transferOwnership: transferOwnership(node),\n    nullable: hasNullableAttr(node),\n    optional: hasOptionalAttr(node),\n    callerAllocates: isAttrTrue(node, \"caller-allocates\"),\n    scope: parseEnumAttr(attr(node, \"scope\"), SCOPES, undefined, \"scope\"),\n    closureIndex: intAttr(node, \"closure\"),\n    destroyIndex: intAttr(node, \"destroy\"),\n    isVarargs: getChild(node, \"varargs\") !== undefined,\n});\n\nconst isOutParameter = (parameter: GirParameter): boolean =>\n    parameter.direction === \"out\" && !parameter.callerAllocates;\n\nconst isCallerAllocatedOut = (parameter: GirParameter): boolean =>\n    parameter.direction === \"out\" && parameter.callerAllocates;\n\nconst isInoutParameter = (parameter: GirParameter): boolean => parameter.direction === \"inout\";\n\nconst returnValueFromNode = (node: RawNode | undefined, context: ParseContext): GirReturnValue => {\n    if (node === undefined) {\n        return { type: undefined, transferOwnership: \"none\", nullable: false, skip: false };\n    }\n\n    return {\n        type: typeRefFromNode(node, context),\n        transferOwnership: transferOwnership(node),\n        nullable: hasNullableAttr(node),\n        skip: isAttrTrue(node, \"skip\"),\n    };\n};\n\nconst parseCallable = (node: RawNode, context: ParseContext): GirCallable => {\n    const parametersNode = getChild(node, \"parameters\");\n    const parameterNodes = getChildren(parametersNode, \"parameter\");\n\n    return {\n        name: nameAttr(node),\n        doc: getDoc(node),\n        parameters: parameterNodes.map((parameter) => parameterFromNode(parameter, context)),\n        returnValue: returnValueFromNode(getChild(node, \"return-value\"), context),\n        throws: isAttrTrue(node, \"throws\"),\n        introspectable: isAttrTrue(node, \"introspectable\", true),\n    };\n};\n\nexport {\n    transferOwnership,\n    parameterFromNode,\n    isOutParameter,\n    isCallerAllocatedOut,\n    isInoutParameter,\n    parseCallable,\n    type ParameterTransfer,\n    type GirParameter,\n    type GirReturnValue,\n    type GirCallable,\n};\n"]}
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../src/gir/parameter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport {\n    attr,\n    getChild,\n    getChildren,\n    getDoc,\n    intAttr,\n    isAttrTrue,\n    nameAttr,\n    parseEnumAttr,\n    type RawNode,\n} from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\n/** Which way a parameter's value travels: into the call, back out of it, or both. */\ntype ParameterDirection = \"in\" | \"out\" | \"inout\";\n/** How much of a value the receiver takes ownership of: none, the whole value, or only its container. */\ntype ParameterTransfer = \"none\" | \"full\" | \"container\";\n/**\n * How long a callback parameter stays valid: for the duration of the call, until its destroy notify runs,\n * until the asynchronous operation invokes it, or forever.\n */\ntype CallbackScope = \"call\" | \"notified\" | \"async\" | \"forever\";\n\n/** A parameter of a {@link GirCallable}, with the annotations that decide how it is marshalled. */\ntype GirParameter = {\n    /** The name GIR gives the parameter. */\n    name: string;\n    /** What the parameter holds, absent when the GIR node declares no type. */\n    type: TypeId | undefined;\n    /** The C spelling of the parameter's type, taken from its `type` or `array` child. */\n    cType: string | undefined;\n    /** Documentation prose from GIR, emitted as the parameter's `@param` text. */\n    doc: string | undefined;\n    /** Decides whether the parameter is an argument, part of the returned tuple, or both. */\n    direction: ParameterDirection;\n    /** Ownership the marshalling descriptor is generated with, deciding whether the receiver frees the value. */\n    transferOwnership: ParameterTransfer;\n    /** Whether the value may be null. */\n    nullable: boolean;\n    /** Whether the caller may leave the parameter out entirely. */\n    optional: boolean;\n    /** Whether the caller supplies the storage an out parameter writes into. */\n    callerAllocates: boolean;\n    /** How long a callback parameter stays valid, absent when GIR carries no scope annotation. */\n    scope: CallbackScope | undefined;\n    /** Position of the parameter carrying the callback's user data. */\n    closureIndex: number | undefined;\n    /** Position of the parameter carrying the callback's destroy notify. */\n    destroyIndex: number | undefined;\n    /** Whether the parameter is the `...` varargs marker. */\n    isVarargs: boolean;\n};\n\n/** What a {@link GirCallable} hands back, with the annotations that decide how it is marshalled. */\ntype GirReturnValue = {\n    /** What the callable returns, absent when the GIR node declares no type. */\n    type: TypeId | undefined;\n    /** Documentation prose from GIR, emitted as the callable's `@returns` text. */\n    doc: string | undefined;\n    /** How much ownership the caller takes of the returned value. */\n    transferOwnership: ParameterTransfer;\n    /** Whether the returned value may be null. */\n    nullable: boolean;\n    /** Whether GIR marks the value as skipped, keeping it out of the generated signature. */\n    skip: boolean;\n};\n\n/** Anything GIR describes with parameters and a return value: functions, methods, signals, and callbacks. */\ntype GirCallable = {\n    /** The name GIR gives the callable. */\n    name: string;\n    /** The callable's documentation text, absent when GIR carries none. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the callable. */\n    annotations: GirAnnotations;\n    /** The parameters the callable takes, in declaration order. */\n    parameters: GirParameter[];\n    /** What the callable hands back. */\n    returnValue: GirReturnValue;\n    /** Whether the callable reports failure through a trailing `GError`. */\n    throws: boolean;\n    /** Whether GIR exposes the callable to bindings. */\n    introspectable: boolean;\n};\n\nconst DIRECTIONS: Set<ParameterDirection> = new Set([\"in\", \"out\", \"inout\"]);\nconst TRANSFERS: Set<ParameterTransfer> = new Set([\"none\", \"full\", \"container\"]);\nconst SCOPES: Set<CallbackScope> = new Set([\"call\", \"notified\", \"async\", \"forever\"]);\n\nconst transferOwnership = (node: RawNode): ParameterTransfer =>\n    parseEnumAttr(attr(node, \"transfer-ownership\"), TRANSFERS, \"none\", \"transfer-ownership\");\n\nconst isInDirection = (node: RawNode): boolean =>\n    parseEnumAttr(attr(node, \"direction\"), DIRECTIONS, \"in\", \"direction\") === \"in\";\n\nconst hasNullableAttr = (node: RawNode): boolean =>\n    isAttrTrue(node, \"nullable\") || (isInDirection(node) && isAttrTrue(node, \"allow-none\"));\n\nconst hasOptionalAttr = (node: RawNode): boolean =>\n    isAttrTrue(node, \"optional\") || (!isInDirection(node) && isAttrTrue(node, \"allow-none\"));\n\nconst parameterCType = (node: RawNode): string | undefined =>\n    attr(getChild(node, \"type\"), \"c:type\") ?? attr(getChild(node, \"array\"), \"c:type\");\n\nconst parameterFromNode = (node: RawNode, context: ParseContext): GirParameter => ({\n    name: nameAttr(node),\n    type: typeRefFromNode(node, context),\n    cType: parameterCType(node),\n    doc: getDoc(node),\n    direction: parseEnumAttr(attr(node, \"direction\"), DIRECTIONS, \"in\", \"direction\"),\n    transferOwnership: transferOwnership(node),\n    nullable: hasNullableAttr(node),\n    optional: hasOptionalAttr(node),\n    callerAllocates: isAttrTrue(node, \"caller-allocates\"),\n    scope: parseEnumAttr(attr(node, \"scope\"), SCOPES, undefined, \"scope\"),\n    closureIndex: intAttr(node, \"closure\"),\n    destroyIndex: intAttr(node, \"destroy\"),\n    isVarargs: getChild(node, \"varargs\") !== undefined,\n});\n\nconst isOutParameter = (parameter: GirParameter): boolean =>\n    parameter.direction === \"out\" && !parameter.callerAllocates;\n\nconst isCallerAllocatedOut = (parameter: GirParameter): boolean =>\n    parameter.direction === \"out\" && parameter.callerAllocates;\n\nconst isInoutParameter = (parameter: GirParameter): boolean => parameter.direction === \"inout\";\n\nconst returnValueFromNode = (node: RawNode | undefined, context: ParseContext): GirReturnValue => {\n    if (node === undefined) {\n        return { type: undefined, doc: undefined, transferOwnership: \"none\", nullable: false, skip: false };\n    }\n\n    return {\n        type: typeRefFromNode(node, context),\n        doc: getDoc(node),\n        transferOwnership: transferOwnership(node),\n        nullable: hasNullableAttr(node),\n        skip: isAttrTrue(node, \"skip\"),\n    };\n};\n\nconst parseCallable = (node: RawNode, context: ParseContext): GirCallable => {\n    const parametersNode = getChild(node, \"parameters\");\n    const parameterNodes = getChildren(parametersNode, \"parameter\");\n\n    return {\n        ...documentedFromNode(node),\n        parameters: parameterNodes.map((parameter) => parameterFromNode(parameter, context)),\n        returnValue: returnValueFromNode(getChild(node, \"return-value\"), context),\n        throws: isAttrTrue(node, \"throws\"),\n        introspectable: isAttrTrue(node, \"introspectable\", true),\n    };\n};\n\nexport {\n    transferOwnership,\n    parameterFromNode,\n    isOutParameter,\n    isCallerAllocatedOut,\n    isInoutParameter,\n    parseCallable,\n    type ParameterTransfer,\n    type GirParameter,\n    type GirReturnValue,\n    type GirCallable,\n};\n"]}

package/dist/gir/parse.d.ts

@@ -1,3 +1,4 @@
+/** An element of the parsed GIR XML: attributes under `@_`-prefixed keys, children under their tag names. */
 type RawNode = Record<string, unknown>;
 declare const GIR_CONSTRUCTOR_TAG = "gir-constructor";
 declare const parseGirFile: (path: string) => RawNode;
@@ -9,5 +10,6 @@ declare const parseEnumAttr: <T extends string, F extends T | undefined>(raw: st
 declare const getChildren: (node: RawNode | undefined, tag: string) => RawNode[];
 declare const getChild: (node: RawNode | undefined, tag: string) => RawNode | undefined;
 declare const getDoc: (node: RawNode | undefined) => string | undefined;
-export { GIR_CONSTRUCTOR_TAG, parseGirFile, attr, isAttrTrue, nameAttr, intAttr, parseEnumAttr, getChildren, getChild, getDoc, type RawNode, };
+declare const getDocDeprecated: (node: RawNode | undefined) => string | undefined;
+export { GIR_CONSTRUCTOR_TAG, parseGirFile, attr, isAttrTrue, nameAttr, intAttr, parseEnumAttr, getChildren, getChild, getDoc, getDocDeprecated, type RawNode, };
 //# sourceMappingURL=parse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"AAGA,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAyBvC,QAAA,MAAM,mBAAmB,oBAAoB,CAAC;AAc9C,QAAA,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAIpC,CAAC;AAEF,QAAA,MAAM,IAAI,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAQhE,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,MAAM,MAAM,EAAE,yBAAuB,KAAG,OAQtF,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,MAAM,OAAO,KAAG,MAAkC,CAAC;AAErE,QAAA,MAAM,OAAO,GAAI,MAAM,OAAO,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAIvD,CAAC;AAYF,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,SAAS,EAC5D,KAAK,MAAM,GAAG,SAAS,EACvB,SAAS,GAAG,CAAC,CAAC,CAAC,EACf,UAAU,CAAC,EACX,OAAO,MAAM,KACd,CAAC,GAAG,CAAqE,CAAC;AAE7E,QAAA,MAAM,WAAW,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,MAAM,KAAG,OAAO,EAgBpE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,MAAM,KAAG,OAAO,GAAG,SAgBpE,CAAC;AAgBF,QAAA,MAAM,MAAM,GAAI,MAAM,OAAO,GAAG,SAAS,KAAG,MAAM,GAAG,SAgBpD,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,WAAW,EACX,QAAQ,EACR,MAAM,EACN,KAAK,OAAO,GACf,CAAC"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"AAGA,6GAA6G;AAC7G,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0BvC,QAAA,MAAM,mBAAmB,oBAAoB,CAAC;AAc9C,QAAA,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAIpC,CAAC;AAEF,QAAA,MAAM,IAAI,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAQhE,CAAC;AAEF,QAAA,MAAM,UAAU,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,MAAM,MAAM,EAAE,yBAAuB,KAAG,OAQtF,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,MAAM,OAAO,KAAG,MAAkC,CAAC;AAErE,QAAA,MAAM,OAAO,GAAI,MAAM,OAAO,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAIvD,CAAC;AAYF,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,SAAS,EAC5D,KAAK,MAAM,GAAG,SAAS,EACvB,SAAS,GAAG,CAAC,CAAC,CAAC,EACf,UAAU,CAAC,EACX,OAAO,MAAM,KACd,CAAC,GAAG,CAAqE,CAAC;AAE7E,QAAA,MAAM,WAAW,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,MAAM,KAAG,OAAO,EAgBpE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,MAAM,KAAG,OAAO,GAAG,SAgBpE,CAAC;AAkCF,QAAA,MAAM,MAAM,GAAI,MAAM,OAAO,GAAG,SAAS,KAAG,MAAM,GAAG,SAAwC,CAAC;AAC9F,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,GAAG,SAAS,KAAG,MAAM,GAAG,SAAmD,CAAC;AAEnH,OAAO,EACH,mBAAmB,EACnB,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,WAAW,EACX,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,KAAK,OAAO,GACf,CAAC"}

package/dist/gir/parse.js

@@ -13,6 +13,7 @@ const MULTI_TAGS = new Set([
     "alias",
     "union",
     "method",
+    "virtual-method",
     "constructor",
     "property",
     "field",
@@ -100,11 +101,11 @@ const docTextFromObject = (value) => {
     const text = value["#text"];
     return typeof text === "string" ? normalizeDoc(text) : undefined;
 };
-const getDoc = (node) => {
+const docElementText = (node, tag) => {
     if (node === undefined) {
         return undefined;
     }
-    const value = firstDocValue(node.doc);
+    const value = firstDocValue(node[tag]);
     if (typeof value === "string") {
         return normalizeDoc(value);
     }
@@ -113,5 +114,7 @@ const getDoc = (node) => {
     }
     return docTextFromObject(value);
 };
-export { GIR_CONSTRUCTOR_TAG, parseGirFile, attr, isAttrTrue, nameAttr, intAttr, parseEnumAttr, getChildren, getChild, getDoc, };
+const getDoc = (node) => docElementText(node, "doc");
+const getDocDeprecated = (node) => docElementText(node, "doc-deprecated");
+export { GIR_CONSTRUCTOR_TAG, parseGirFile, attr, isAttrTrue, nameAttr, intAttr, parseEnumAttr, getChildren, getChild, getDoc, getDocDeprecated, };
 //# sourceMappingURL=parse.js.map

package/dist/gir/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { createXmlParser } from \"../xml.js\";\n\ntype RawNode = Record<string, unknown>;\n\nconst MULTI_TAGS: Set<string> = new Set([\n    \"include\",\n    \"class\",\n    \"interface\",\n    \"record\",\n    \"enumeration\",\n    \"bitfield\",\n    \"callback\",\n    \"function\",\n    \"constant\",\n    \"alias\",\n    \"union\",\n    \"method\",\n    \"constructor\",\n    \"property\",\n    \"field\",\n    \"glib:signal\",\n    \"implements\",\n    \"prerequisite\",\n    \"member\",\n    \"parameter\",\n]);\n\nconst GIR_CONSTRUCTOR_TAG = \"gir-constructor\";\nconst RESERVED_TAG_RENAMES: Map<string, string> = new Map([[\"constructor\", GIR_CONSTRUCTOR_TAG]]);\nconst RENAMED_MULTI_TAGS: Set<string> = new Set([...MULTI_TAGS].map((tag) => renameReservedTag(tag)));\n\nconst PARSER = createXmlParser({\n    trimValues: true,\n    transformTagName: renameReservedTag,\n    isArray: (name) => RENAMED_MULTI_TAGS.has(name),\n});\n\nfunction renameReservedTag(tag: string): string {\n    return RESERVED_TAG_RENAMES.get(tag) ?? tag;\n}\n\nconst parseGirFile = (path: string): RawNode => {\n    const xml = readFileSync(path, \"utf8\");\n\n    return PARSER.parse(xml) as RawNode;\n};\n\nconst attr = (node: RawNode | undefined, name: string): string | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = node[`@_${name}`];\n\n    return typeof value === \"string\" ? value : undefined;\n};\n\nconst isAttrTrue = (node: RawNode | undefined, name: string, isTrueByDefault = false): boolean => {\n    const value = attr(node, name);\n\n    if (value === undefined) {\n        return isTrueByDefault;\n    }\n\n    return value === \"1\";\n};\n\nconst nameAttr = (node: RawNode): string => attr(node, \"name\") ?? \"\";\n\nconst intAttr = (node: RawNode, name: string): number | undefined => {\n    const raw = attr(node, name);\n\n    return raw === undefined ? undefined : Number(raw);\n};\n\nconst enumMember = <T extends string>(raw: string, members: Set<T>, label: string): T => {\n    for (const member of members) {\n        if (member === raw) {\n            return member;\n        }\n    }\n\n    throw new Error(`Unknown ${label} value \"${raw}\"`);\n};\n\nconst parseEnumAttr = <T extends string, F extends T | undefined>(\n    raw: string | undefined,\n    members: Set<T>,\n    fallback: F,\n    label: string,\n): T | F => (raw === undefined ? fallback : enumMember(raw, members, label));\n\nconst getChildren = (node: RawNode | undefined, tag: string): RawNode[] => {\n    if (node === undefined) {\n        return [];\n    }\n\n    const value = node[tag];\n\n    if (value === undefined) {\n        return [];\n    }\n\n    if (Array.isArray(value)) {\n        return value as RawNode[];\n    }\n\n    return [value as RawNode];\n};\n\nconst getChild = (node: RawNode | undefined, tag: string): RawNode | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = node[tag];\n\n    if (value === undefined) {\n        return undefined;\n    }\n\n    if (Array.isArray(value)) {\n        return value.length === 0 ? undefined : (value[0] as RawNode);\n    }\n\n    return value as RawNode;\n};\n\nconst normalizeDoc = (text: string): string | undefined => {\n    const trimmed = text.trim();\n\n    return trimmed.length === 0 ? undefined : trimmed;\n};\n\nconst firstDocValue = (raw: unknown): unknown => (Array.isArray(raw) ? raw[0] : raw);\n\nconst docTextFromObject = (value: object): string | undefined => {\n    const text = (value as RawNode)[\"#text\"];\n\n    return typeof text === \"string\" ? normalizeDoc(text) : undefined;\n};\n\nconst getDoc = (node: RawNode | undefined): string | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = firstDocValue(node.doc);\n\n    if (typeof value === \"string\") {\n        return normalizeDoc(value);\n    }\n\n    if (value === null || typeof value !== \"object\") {\n        return undefined;\n    }\n\n    return docTextFromObject(value);\n};\n\nexport {\n    GIR_CONSTRUCTOR_TAG,\n    parseGirFile,\n    attr,\n    isAttrTrue,\n    nameAttr,\n    intAttr,\n    parseEnumAttr,\n    getChildren,\n    getChild,\n    getDoc,\n    type RawNode,\n};\n"]}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { createXmlParser } from \"../xml.js\";\n\n/** An element of the parsed GIR XML: attributes under `@_`-prefixed keys, children under their tag names. */\ntype RawNode = Record<string, unknown>;\n\nconst MULTI_TAGS: Set<string> = new Set([\n    \"include\",\n    \"class\",\n    \"interface\",\n    \"record\",\n    \"enumeration\",\n    \"bitfield\",\n    \"callback\",\n    \"function\",\n    \"constant\",\n    \"alias\",\n    \"union\",\n    \"method\",\n    \"virtual-method\",\n    \"constructor\",\n    \"property\",\n    \"field\",\n    \"glib:signal\",\n    \"implements\",\n    \"prerequisite\",\n    \"member\",\n    \"parameter\",\n]);\n\nconst GIR_CONSTRUCTOR_TAG = \"gir-constructor\";\nconst RESERVED_TAG_RENAMES: Map<string, string> = new Map([[\"constructor\", GIR_CONSTRUCTOR_TAG]]);\nconst RENAMED_MULTI_TAGS: Set<string> = new Set([...MULTI_TAGS].map((tag) => renameReservedTag(tag)));\n\nconst PARSER = createXmlParser({\n    trimValues: true,\n    transformTagName: renameReservedTag,\n    isArray: (name) => RENAMED_MULTI_TAGS.has(name),\n});\n\nfunction renameReservedTag(tag: string): string {\n    return RESERVED_TAG_RENAMES.get(tag) ?? tag;\n}\n\nconst parseGirFile = (path: string): RawNode => {\n    const xml = readFileSync(path, \"utf8\");\n\n    return PARSER.parse(xml) as RawNode;\n};\n\nconst attr = (node: RawNode | undefined, name: string): string | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = node[`@_${name}`];\n\n    return typeof value === \"string\" ? value : undefined;\n};\n\nconst isAttrTrue = (node: RawNode | undefined, name: string, isTrueByDefault = false): boolean => {\n    const value = attr(node, name);\n\n    if (value === undefined) {\n        return isTrueByDefault;\n    }\n\n    return value === \"1\";\n};\n\nconst nameAttr = (node: RawNode): string => attr(node, \"name\") ?? \"\";\n\nconst intAttr = (node: RawNode, name: string): number | undefined => {\n    const raw = attr(node, name);\n\n    return raw === undefined ? undefined : Number(raw);\n};\n\nconst enumMember = <T extends string>(raw: string, members: Set<T>, label: string): T => {\n    for (const member of members) {\n        if (member === raw) {\n            return member;\n        }\n    }\n\n    throw new Error(`Unknown ${label} value \"${raw}\"`);\n};\n\nconst parseEnumAttr = <T extends string, F extends T | undefined>(\n    raw: string | undefined,\n    members: Set<T>,\n    fallback: F,\n    label: string,\n): T | F => (raw === undefined ? fallback : enumMember(raw, members, label));\n\nconst getChildren = (node: RawNode | undefined, tag: string): RawNode[] => {\n    if (node === undefined) {\n        return [];\n    }\n\n    const value = node[tag];\n\n    if (value === undefined) {\n        return [];\n    }\n\n    if (Array.isArray(value)) {\n        return value as RawNode[];\n    }\n\n    return [value as RawNode];\n};\n\nconst getChild = (node: RawNode | undefined, tag: string): RawNode | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = node[tag];\n\n    if (value === undefined) {\n        return undefined;\n    }\n\n    if (Array.isArray(value)) {\n        return value.length === 0 ? undefined : (value[0] as RawNode);\n    }\n\n    return value as RawNode;\n};\n\nconst normalizeDoc = (text: string): string | undefined => {\n    const trimmed = text.trim();\n\n    return trimmed.length === 0 ? undefined : trimmed;\n};\n\nconst firstDocValue = (raw: unknown): unknown => (Array.isArray(raw) ? raw[0] : raw);\n\nconst docTextFromObject = (value: object): string | undefined => {\n    const text = (value as RawNode)[\"#text\"];\n\n    return typeof text === \"string\" ? normalizeDoc(text) : undefined;\n};\n\nconst docElementText = (node: RawNode | undefined, tag: string): string | undefined => {\n    if (node === undefined) {\n        return undefined;\n    }\n\n    const value = firstDocValue(node[tag]);\n\n    if (typeof value === \"string\") {\n        return normalizeDoc(value);\n    }\n\n    if (value === null || typeof value !== \"object\") {\n        return undefined;\n    }\n\n    return docTextFromObject(value);\n};\n\nconst getDoc = (node: RawNode | undefined): string | undefined => docElementText(node, \"doc\");\nconst getDocDeprecated = (node: RawNode | undefined): string | undefined => docElementText(node, \"doc-deprecated\");\n\nexport {\n    GIR_CONSTRUCTOR_TAG,\n    parseGirFile,\n    attr,\n    isAttrTrue,\n    nameAttr,\n    intAttr,\n    parseEnumAttr,\n    getChildren,\n    getChild,\n    getDoc,\n    getDocDeprecated,\n    type RawNode,\n};\n"]}

package/dist/gir/primitives.d.ts

@@ -1,3 +1,4 @@
+/** A fundamental C type GIR can name, collapsed to the marshalling category GTKX treats it as. */
 type PrimitiveCategory = "void" | "boolean" | "int8" | "uint8" | "int16" | "uint16" | "int32" | "uint32" | "int64" | "uint64" | "bigint64" | "biguint64" | "gtype" | "float32" | "float64" | "string" | "unichar" | "pointer";
 declare const PRIMITIVE_SIZE: Record<PrimitiveCategory, number>;
 declare const PRIMITIVE_TS_TYPE: Record<PrimitiveCategory, string>;

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

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/gir/primitives.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAChB,MAAM,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,GACV,WAAW,GACX,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAmBrD,CAAC;AAsDF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAmBxD,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SAAwC,CAAC;AAEvG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/gir/primitives.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,KAAK,iBAAiB,GAChB,MAAM,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,GACV,WAAW,GACX,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAmBrD,CAAC;AAsDF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAmBxD,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SAAwC,CAAC;AAEvG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/gir/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/gir/primitives.ts"],"names":[],"mappings":"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","sourcesContent":["type PrimitiveCategory =\n    | \"void\" |\n    \"boolean\" |\n    \"int8\" |\n    \"uint8\" |\n    \"int16\" |\n    \"uint16\" |\n    \"int32\" |\n    \"uint32\" |\n    \"int64\" |\n    \"uint64\" |\n    \"bigint64\" |\n    \"biguint64\" |\n    \"gtype\" |\n    \"float32\" |\n    \"float64\" |\n    \"string\" |\n    \"unichar\" |\n    \"pointer\";\n\nconst PRIMITIVE_SIZE: Record<PrimitiveCategory, number> = {\n    void: 0,\n    boolean: 4,\n    int8: 1,\n    uint8: 1,\n    int16: 2,\n    uint16: 2,\n    int32: 4,\n    uint32: 4,\n    int64: 8,\n    uint64: 8,\n    bigint64: 8,\n    biguint64: 8,\n    gtype: 8,\n    float32: 4,\n    float64: 8,\n    string: 8,\n    unichar: 4,\n    pointer: 8,\n};\n\nconst PRIMITIVE_BY_NAME: Map<string, PrimitiveCategory> = new Map([\n    [\"none\", \"void\"],\n    [\"void\", \"void\"],\n    [\"gboolean\", \"boolean\"],\n    [\"gchar\", \"int8\"],\n    [\"gint8\", \"int8\"],\n    [\"guchar\", \"uint8\"],\n    [\"guint8\", \"uint8\"],\n    [\"gshort\", \"int16\"],\n    [\"gint16\", \"int16\"],\n    [\"gushort\", \"uint16\"],\n    [\"guint16\", \"uint16\"],\n    [\"gint\", \"int32\"],\n    [\"gint32\", \"int32\"],\n    [\"int\", \"int32\"],\n    [\"int8\", \"int8\"],\n    [\"uint8\", \"uint8\"],\n    [\"int16\", \"int16\"],\n    [\"uint16\", \"uint16\"],\n    [\"int32\", \"int32\"],\n    [\"uint32\", \"uint32\"],\n    [\"int64\", \"bigint64\"],\n    [\"uint64\", \"biguint64\"],\n    [\"guint\", \"uint32\"],\n    [\"guint32\", \"uint32\"],\n    [\"glong\", \"bigint64\"],\n    [\"gint64\", \"bigint64\"],\n    [\"long\", \"bigint64\"],\n    [\"gssize\", \"int64\"],\n    [\"gintptr\", \"int64\"],\n    [\"gulong\", \"biguint64\"],\n    [\"guint64\", \"biguint64\"],\n    [\"gsize\", \"uint64\"],\n    [\"guintptr\", \"uint64\"],\n    [\"GType\", \"gtype\"],\n    [\"time_t\", \"bigint64\"],\n    [\"pid_t\", \"int32\"],\n    [\"uid_t\", \"uint32\"],\n    [\"gid_t\", \"uint32\"],\n    [\"gfloat\", \"float32\"],\n    [\"float\", \"float32\"],\n    [\"gdouble\", \"float64\"],\n    [\"double\", \"float64\"],\n    [\"long double\", \"float64\"],\n    [\"utf8\", \"string\"],\n    [\"filename\", \"string\"],\n    [\"gchararray\", \"string\"],\n    [\"gunichar\", \"unichar\"],\n    [\"gpointer\", \"pointer\"],\n    [\"gconstpointer\", \"pointer\"],\n] as const);\n\nconst PRIMITIVE_TS_TYPE: Record<PrimitiveCategory, string> = {\n    void: \"void\",\n    boolean: \"boolean\",\n    int8: \"number\",\n    uint8: \"number\",\n    int16: \"number\",\n    uint16: \"number\",\n    int32: \"number\",\n    uint32: \"number\",\n    int64: \"number\",\n    uint64: \"number\",\n    bigint64: \"bigint\",\n    biguint64: \"bigint\",\n    gtype: \"bigint\",\n    float32: \"number\",\n    float64: \"number\",\n    string: \"string\",\n    unichar: \"string\",\n    pointer: \"number\",\n};\n\nconst primitiveCategory = (name: string): PrimitiveCategory | undefined => PRIMITIVE_BY_NAME.get(name);\n\nexport { PRIMITIVE_SIZE, PRIMITIVE_TS_TYPE, primitiveCategory, type PrimitiveCategory };\n"]}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/gir/primitives.ts"],"names":[],"mappings":"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","sourcesContent":["/** A fundamental C type GIR can name, collapsed to the marshalling category GTKX treats it as. */\ntype PrimitiveCategory =\n    | \"void\" |\n    \"boolean\" |\n    \"int8\" |\n    \"uint8\" |\n    \"int16\" |\n    \"uint16\" |\n    \"int32\" |\n    \"uint32\" |\n    \"int64\" |\n    \"uint64\" |\n    \"bigint64\" |\n    \"biguint64\" |\n    \"gtype\" |\n    \"float32\" |\n    \"float64\" |\n    \"string\" |\n    \"unichar\" |\n    \"pointer\";\n\nconst PRIMITIVE_SIZE: Record<PrimitiveCategory, number> = {\n    void: 0,\n    boolean: 4,\n    int8: 1,\n    uint8: 1,\n    int16: 2,\n    uint16: 2,\n    int32: 4,\n    uint32: 4,\n    int64: 8,\n    uint64: 8,\n    bigint64: 8,\n    biguint64: 8,\n    gtype: 8,\n    float32: 4,\n    float64: 8,\n    string: 8,\n    unichar: 4,\n    pointer: 8,\n};\n\nconst PRIMITIVE_BY_NAME: Map<string, PrimitiveCategory> = new Map([\n    [\"none\", \"void\"],\n    [\"void\", \"void\"],\n    [\"gboolean\", \"boolean\"],\n    [\"gchar\", \"int8\"],\n    [\"gint8\", \"int8\"],\n    [\"guchar\", \"uint8\"],\n    [\"guint8\", \"uint8\"],\n    [\"gshort\", \"int16\"],\n    [\"gint16\", \"int16\"],\n    [\"gushort\", \"uint16\"],\n    [\"guint16\", \"uint16\"],\n    [\"gint\", \"int32\"],\n    [\"gint32\", \"int32\"],\n    [\"int\", \"int32\"],\n    [\"int8\", \"int8\"],\n    [\"uint8\", \"uint8\"],\n    [\"int16\", \"int16\"],\n    [\"uint16\", \"uint16\"],\n    [\"int32\", \"int32\"],\n    [\"uint32\", \"uint32\"],\n    [\"int64\", \"bigint64\"],\n    [\"uint64\", \"biguint64\"],\n    [\"guint\", \"uint32\"],\n    [\"guint32\", \"uint32\"],\n    [\"glong\", \"bigint64\"],\n    [\"gint64\", \"bigint64\"],\n    [\"long\", \"bigint64\"],\n    [\"gssize\", \"int64\"],\n    [\"gintptr\", \"int64\"],\n    [\"gulong\", \"biguint64\"],\n    [\"guint64\", \"biguint64\"],\n    [\"gsize\", \"uint64\"],\n    [\"guintptr\", \"uint64\"],\n    [\"GType\", \"gtype\"],\n    [\"time_t\", \"bigint64\"],\n    [\"pid_t\", \"int32\"],\n    [\"uid_t\", \"uint32\"],\n    [\"gid_t\", \"uint32\"],\n    [\"gfloat\", \"float32\"],\n    [\"float\", \"float32\"],\n    [\"gdouble\", \"float64\"],\n    [\"double\", \"float64\"],\n    [\"long double\", \"float64\"],\n    [\"utf8\", \"string\"],\n    [\"filename\", \"string\"],\n    [\"gchararray\", \"string\"],\n    [\"gunichar\", \"unichar\"],\n    [\"gpointer\", \"pointer\"],\n    [\"gconstpointer\", \"pointer\"],\n] as const);\n\nconst PRIMITIVE_TS_TYPE: Record<PrimitiveCategory, string> = {\n    void: \"void\",\n    boolean: \"boolean\",\n    int8: \"number\",\n    uint8: \"number\",\n    int16: \"number\",\n    uint16: \"number\",\n    int32: \"number\",\n    uint32: \"number\",\n    int64: \"number\",\n    uint64: \"number\",\n    bigint64: \"bigint\",\n    biguint64: \"bigint\",\n    gtype: \"bigint\",\n    float32: \"number\",\n    float64: \"number\",\n    string: \"string\",\n    unichar: \"string\",\n    pointer: \"number\",\n};\n\nconst primitiveCategory = (name: string): PrimitiveCategory | undefined => PRIMITIVE_BY_NAME.get(name);\n\nexport { PRIMITIVE_SIZE, PRIMITIVE_TS_TYPE, primitiveCategory, type PrimitiveCategory };\n"]}

package/dist/gir/property.d.ts

@@ -1,18 +1,34 @@
 import type { ParseContext, TypeId } from "./type-id.js";
+import { type GirAnnotations } from "./annotations.js";
 import { type ParameterTransfer } from "./parameter.js";
 import { type RawNode } from "./parse.js";
+/** A GObject property declared on a class or interface, with the annotations its accessors are generated from. */
 type GirProperty = {
+    /** Canonical property name, dashed the way GObject registers it. */
     name: string;
+    /** Documentation prose from GIR, emitted as the accessor's JSDoc. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the property. */
+    annotations: GirAnnotations;
+    /** The property's value type, absent when GIR declares none. */
     type: TypeId | undefined;
+    /** Whether GObject exposes the value for reading, which admits a generated getter. */
     readable: boolean;
+    /** Whether GObject accepts a value for the property, which admits a generated setter. */
     writable: boolean;
+    /** Whether GObject sets the property during construction, using its default when none is supplied. */
     construct: boolean;
+    /** Whether the property can only be set at construction. */
     constructOnly: boolean;
+    /** Whether GIR exposes the property to bindings. */
     introspectable: boolean;
+    /** How ownership of the value transfers, which decides the descriptor the accessors marshal through. */
     transferOwnership: ParameterTransfer;
+    /** Method GIR names as reading the property, which the generated getter delegates to. */
     getter: string | undefined;
+    /** Method GIR names as writing the property, which the generated setter delegates to. */
     setter: string | undefined;
+    /** The property's default, as GIR spells it. */
     defaultValue: string | undefined;
 };
 declare const isConstructableProperty: (property: GirProperty) => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG9E,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,QAAA,MAAM,uBAAuB,GAAI,UAAU,WAAW,KAAG,OACY,CAAC;AAEtE,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAa/D,CAAC;AAEH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5D,kHAAkH;AAClH,KAAK,WAAW,GAAG;IACf,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,uEAAuE;IACvE,WAAW,EAAE,cAAc,CAAC;IAC5B,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,QAAQ,EAAE,OAAO,CAAC;IAClB,sGAAsG;IACtG,SAAS,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,yFAAyF;IACzF,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yFAAyF;IACzF,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,QAAA,MAAM,uBAAuB,GAAI,UAAU,WAAW,KAAG,OACY,CAAC;AAEtE,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAY/D,CAAC;AAEH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/gir/property.js

@@ -1,10 +1,10 @@
+import { documentedFromNode } from "./annotations.js";
 import { transferOwnership } from "./parameter.js";
-import { attr, getDoc, isAttrTrue, nameAttr } from "./parse.js";
+import { attr, isAttrTrue } from "./parse.js";
 import { typeRefFromNode } from "./type-ref.js";
 const isConstructableProperty = (property) => property.writable || property.construct || property.constructOnly;
 const propertyFromNode = (node, context) => ({
-    name: nameAttr(node),
-    doc: getDoc(node),
+    ...documentedFromNode(node),
     type: typeRefFromNode(node, context),
     readable: isAttrTrue(node, "readable", true),
     writable: isAttrTrue(node, "writable"),

package/dist/gir/property.js.map

@@ -1 +1 @@
-{"version":3,"file":"property.js","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAiBhD,MAAM,uBAAuB,GAAG,CAAC,QAAqB,EAAW,EAAE,CAC/D,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;AAEtE,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAe,EAAE,CAAC,CAAC;IAC7E,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;IAC5C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IACtC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;IACxC,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC;IACjD,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC;IAC1C,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;CAC5C,CAAC,CAAC;AAEH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAoB,CAAC","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { type ParameterTransfer, transferOwnership } from \"./parameter.js\";\nimport { attr, getDoc, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\ntype GirProperty = {\n    name: string;\n    doc: string | undefined;\n    type: TypeId | undefined;\n    readable: boolean;\n    writable: boolean;\n    construct: boolean;\n    constructOnly: boolean;\n    introspectable: boolean;\n    transferOwnership: ParameterTransfer;\n    getter: string | undefined;\n    setter: string | undefined;\n    defaultValue: string | undefined;\n};\n\nconst isConstructableProperty = (property: GirProperty): boolean =>\n    property.writable || property.construct || property.constructOnly;\n\nconst propertyFromNode = (node: RawNode, context: ParseContext): GirProperty => ({\n    name: nameAttr(node),\n    doc: getDoc(node),\n    type: typeRefFromNode(node, context),\n    readable: isAttrTrue(node, \"readable\", true),\n    writable: isAttrTrue(node, \"writable\"),\n    construct: isAttrTrue(node, \"construct\"),\n    constructOnly: isAttrTrue(node, \"construct-only\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    transferOwnership: transferOwnership(node),\n    getter: attr(node, \"getter\"),\n    setter: attr(node, \"setter\"),\n    defaultValue: attr(node, \"default-value\"),\n});\n\nexport { isConstructableProperty, propertyFromNode, type GirProperty };\n"]}
+{"version":3,"file":"property.js","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAA0B,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAgChD,MAAM,uBAAuB,GAAG,CAAC,QAAqB,EAAW,EAAE,CAC/D,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;AAEtE,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAe,EAAE,CAAC,CAAC;IAC7E,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;IAC5C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IACtC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;IACxC,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC;IACjD,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC;IAC1C,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;CAC5C,CAAC,CAAC;AAEH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAoB,CAAC","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport { type ParameterTransfer, transferOwnership } from \"./parameter.js\";\nimport { attr, isAttrTrue, type RawNode } from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\n/** A GObject property declared on a class or interface, with the annotations its accessors are generated from. */\ntype GirProperty = {\n    /** Canonical property name, dashed the way GObject registers it. */\n    name: string;\n    /** Documentation prose from GIR, emitted as the accessor's JSDoc. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the property. */\n    annotations: GirAnnotations;\n    /** The property's value type, absent when GIR declares none. */\n    type: TypeId | undefined;\n    /** Whether GObject exposes the value for reading, which admits a generated getter. */\n    readable: boolean;\n    /** Whether GObject accepts a value for the property, which admits a generated setter. */\n    writable: boolean;\n    /** Whether GObject sets the property during construction, using its default when none is supplied. */\n    construct: boolean;\n    /** Whether the property can only be set at construction. */\n    constructOnly: boolean;\n    /** Whether GIR exposes the property to bindings. */\n    introspectable: boolean;\n    /** How ownership of the value transfers, which decides the descriptor the accessors marshal through. */\n    transferOwnership: ParameterTransfer;\n    /** Method GIR names as reading the property, which the generated getter delegates to. */\n    getter: string | undefined;\n    /** Method GIR names as writing the property, which the generated setter delegates to. */\n    setter: string | undefined;\n    /** The property's default, as GIR spells it. */\n    defaultValue: string | undefined;\n};\n\nconst isConstructableProperty = (property: GirProperty): boolean =>\n    property.writable || property.construct || property.constructOnly;\n\nconst propertyFromNode = (node: RawNode, context: ParseContext): GirProperty => ({\n    ...documentedFromNode(node),\n    type: typeRefFromNode(node, context),\n    readable: isAttrTrue(node, \"readable\", true),\n    writable: isAttrTrue(node, \"writable\"),\n    construct: isAttrTrue(node, \"construct\"),\n    constructOnly: isAttrTrue(node, \"construct-only\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    transferOwnership: transferOwnership(node),\n    getter: attr(node, \"getter\"),\n    setter: attr(node, \"setter\"),\n    defaultValue: attr(node, \"default-value\"),\n});\n\nexport { isConstructableProperty, propertyFromNode, type GirProperty };\n"]}

package/dist/gir/record.d.ts

@@ -1,25 +1,47 @@
 import type { ParseContext } from "./type-id.js";
+import { type GirAnnotations } from "./annotations.js";
 import { type GirField } from "./field.js";
 import { type GirFunction } from "./function.js";
 import { type RawNode } from "./parse.js";
+/** A C struct or union declared by a GIR namespace: a plain record, a boxed type, or a GObject vtable. */
 type GirRecord = {
+    /** Whether the record is the class or interface struct holding another type's virtual methods. */
     isVtable: boolean;
+    /** Name within the declaring namespace, such as `"TextIter"`. */
     name: string;
+    /** Raw gtk-doc text from the GIR, undefined when the record is undocumented. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the record. */
+    annotations: GirAnnotations;
+    /** C struct name, such as `"GtkTextIter"`. */
     cType: string | undefined;
+    /** GLib type name the record is registered under, present when it is a boxed type. */
     glibTypeName: string | undefined;
+    /** Name of the function registering the record's GType, such as `"gtk_text_iter_get_type"`. */
     glibGetType: string | undefined;
+    /** Name of the function taking a reference, for reference-counted records. */
     glibRefFunc: string | undefined;
+    /** Name of the function dropping a reference, for reference-counted records. */
     glibUnrefFunc: string | undefined;
+    /** Name of the function duplicating an instance, used when the record has no ref function. */
     copyFunc: string | undefined;
+    /** Name of the function releasing an instance, used when the record has no unref function. */
     freeFunc: string | undefined;
+    /** Whether the struct is only ever handled behind a pointer, so its layout stays hidden. */
     disguised: boolean;
+    /** Whether the struct's fields are private, so instances cannot be allocated or read directly. */
     opaque: boolean;
+    /** Whether the record is exposed to language bindings. */
     introspectable: boolean;
+    /** Struct members: the named fields first, then the anonymous inline unions, then the inline records. */
     fields: GirField[];
+    /** Functions taking an instance of the record as their first argument. */
     methods: GirFunction[];
+    /** Functions returning a new instance of the record. */
     constructors: GirFunction[];
+    /** Functions scoped to the record but taking no instance. */
     functions: GirFunction[];
+    /** Whether the record is a union, so its fields overlap instead of following one another. */
     isUnion: boolean;
 };
 declare const recordFromNode: (node: RawNode, isVtable: boolean, isUnion: boolean, context: ParseContext) => GirRecord;

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

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/gir/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,KAAK,SAAS,GAAG;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,cAAc,GAChB,MAAM,OAAO,EACb,UAAU,OAAO,EACjB,SAAS,OAAO,EAChB,SAAS,YAAY,KACtB,SAmBD,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,MAAM,OAAO,KAAG,OAA+D,CAAC;AAExG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,CAAC"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/gir/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAsD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9F,0GAA0G;AAC1G,KAAK,SAAS,GAAG;IACb,kGAAkG;IAClG,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,cAAc,CAAC;IAC5B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,sFAAsF;IACtF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+FAA+F;IAC/F,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gFAAgF;IAChF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,4FAA4F;IAC5F,SAAS,EAAE,OAAO,CAAC;IACnB,kGAAkG;IAClG,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,cAAc,EAAE,OAAO,CAAC;IACxB,yGAAyG;IACzG,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,wDAAwD;IACxD,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,6DAA6D;IAC7D,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,6FAA6F;IAC7F,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,cAAc,GAChB,MAAM,OAAO,EACb,UAAU,OAAO,EACjB,SAAS,OAAO,EAChB,SAAS,YAAY,KACtB,SAmBD,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,MAAM,OAAO,KAAG,OAA+D,CAAC;AAExG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,CAAC"}

package/dist/gir/record.js

@@ -1,10 +1,11 @@
+import { documentedFromNode } from "./annotations.js";
 import { collectFields } from "./field.js";
 import { functionFromNode } from "./function.js";
-import { attr, getChildren, getDoc, GIR_CONSTRUCTOR_TAG, isAttrTrue } from "./parse.js";
+import { attr, getChildren, GIR_CONSTRUCTOR_TAG, isAttrTrue } from "./parse.js";
 const recordFromNode = (node, isVtable, isUnion, context) => ({
     isVtable,
+    ...documentedFromNode(node),
     name: attr(node, "name") ?? attr(node, "glib:name") ?? "",
-    doc: getDoc(node),
     cType: attr(node, "c:type"),
     glibTypeName: attr(node, "glib:type-name"),
     glibGetType: attr(node, "glib:get-type"),

package/dist/gir/record.js.map

@@ -1 +1 @@
-{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/gir/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAuBtG,MAAM,cAAc,GAAG,CACnB,IAAa,EACb,QAAiB,EACjB,OAAgB,EAChB,OAAqB,EACZ,EAAE,CAAC,CAAC;IACb,QAAQ;IACR,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC1C,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAC5C,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;IACxC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;IAClC,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvF,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnG,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,OAAO;CACV,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,KAAK,SAAS,CAAC;AAExG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAkB,CAAC","sourcesContent":["import type { ParseContext } from \"./type-id.js\";\nimport { collectFields, type GirField } from \"./field.js\";\nimport { functionFromNode, type GirFunction } from \"./function.js\";\nimport { attr, getChildren, getDoc, GIR_CONSTRUCTOR_TAG, isAttrTrue, type RawNode } from \"./parse.js\";\n\ntype GirRecord = {\n    isVtable: boolean;\n    name: string;\n    doc: string | undefined;\n    cType: string | undefined;\n    glibTypeName: string | undefined;\n    glibGetType: string | undefined;\n    glibRefFunc: string | undefined;\n    glibUnrefFunc: string | undefined;\n    copyFunc: string | undefined;\n    freeFunc: string | undefined;\n    disguised: boolean;\n    opaque: boolean;\n    introspectable: boolean;\n    fields: GirField[];\n    methods: GirFunction[];\n    constructors: GirFunction[];\n    functions: GirFunction[];\n    isUnion: boolean;\n};\n\nconst recordFromNode = (\n    node: RawNode,\n    isVtable: boolean,\n    isUnion: boolean,\n    context: ParseContext,\n): GirRecord => ({\n    isVtable,\n    name: attr(node, \"name\") ?? attr(node, \"glib:name\") ?? \"\",\n    doc: getDoc(node),\n    cType: attr(node, \"c:type\"),\n    glibTypeName: attr(node, \"glib:type-name\"),\n    glibGetType: attr(node, \"glib:get-type\"),\n    glibRefFunc: attr(node, \"glib:ref-func\"),\n    glibUnrefFunc: attr(node, \"glib:unref-func\"),\n    copyFunc: attr(node, \"copy-function\"),\n    freeFunc: attr(node, \"free-function\"),\n    disguised: isAttrTrue(node, \"disguised\"),\n    opaque: isAttrTrue(node, \"opaque\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    fields: collectFields(node, context),\n    methods: getChildren(node, \"method\").map((method) => functionFromNode(method, context)),\n    constructors: getChildren(node, GIR_CONSTRUCTOR_TAG).map((ctor) => functionFromNode(ctor, context)),\n    functions: getChildren(node, \"function\").map((fn) => functionFromNode(fn, context)),\n    isUnion,\n});\n\nconst isVtableRecord = (node: RawNode): boolean => attr(node, \"glib:is-gtype-struct-for\") !== undefined;\n\nexport { recordFromNode, isVtableRecord, type GirRecord };\n"]}
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/gir/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AA4C9F,MAAM,cAAc,GAAG,CACnB,IAAa,EACb,QAAiB,EACjB,OAAgB,EAChB,OAAqB,EACZ,EAAE,CAAC,CAAC;IACb,QAAQ;IACR,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE;IACzD,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC1C,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAC5C,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;IACxC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;IAClC,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvF,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnG,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,OAAO;CACV,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,KAAK,SAAS,CAAC;AAExG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAkB,CAAC","sourcesContent":["import type { ParseContext } from \"./type-id.js\";\nimport { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport { collectFields, type GirField } from \"./field.js\";\nimport { functionFromNode, type GirFunction } from \"./function.js\";\nimport { attr, getChildren, GIR_CONSTRUCTOR_TAG, isAttrTrue, type RawNode } from \"./parse.js\";\n\n/** A C struct or union declared by a GIR namespace: a plain record, a boxed type, or a GObject vtable. */\ntype GirRecord = {\n    /** Whether the record is the class or interface struct holding another type's virtual methods. */\n    isVtable: boolean;\n    /** Name within the declaring namespace, such as `\"TextIter\"`. */\n    name: string;\n    /** Raw gtk-doc text from the GIR, undefined when the record is undocumented. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the record. */\n    annotations: GirAnnotations;\n    /** C struct name, such as `\"GtkTextIter\"`. */\n    cType: string | undefined;\n    /** GLib type name the record is registered under, present when it is a boxed type. */\n    glibTypeName: string | undefined;\n    /** Name of the function registering the record's GType, such as `\"gtk_text_iter_get_type\"`. */\n    glibGetType: string | undefined;\n    /** Name of the function taking a reference, for reference-counted records. */\n    glibRefFunc: string | undefined;\n    /** Name of the function dropping a reference, for reference-counted records. */\n    glibUnrefFunc: string | undefined;\n    /** Name of the function duplicating an instance, used when the record has no ref function. */\n    copyFunc: string | undefined;\n    /** Name of the function releasing an instance, used when the record has no unref function. */\n    freeFunc: string | undefined;\n    /** Whether the struct is only ever handled behind a pointer, so its layout stays hidden. */\n    disguised: boolean;\n    /** Whether the struct's fields are private, so instances cannot be allocated or read directly. */\n    opaque: boolean;\n    /** Whether the record is exposed to language bindings. */\n    introspectable: boolean;\n    /** Struct members: the named fields first, then the anonymous inline unions, then the inline records. */\n    fields: GirField[];\n    /** Functions taking an instance of the record as their first argument. */\n    methods: GirFunction[];\n    /** Functions returning a new instance of the record. */\n    constructors: GirFunction[];\n    /** Functions scoped to the record but taking no instance. */\n    functions: GirFunction[];\n    /** Whether the record is a union, so its fields overlap instead of following one another. */\n    isUnion: boolean;\n};\n\nconst recordFromNode = (\n    node: RawNode,\n    isVtable: boolean,\n    isUnion: boolean,\n    context: ParseContext,\n): GirRecord => ({\n    isVtable,\n    ...documentedFromNode(node),\n    name: attr(node, \"name\") ?? attr(node, \"glib:name\") ?? \"\",\n    cType: attr(node, \"c:type\"),\n    glibTypeName: attr(node, \"glib:type-name\"),\n    glibGetType: attr(node, \"glib:get-type\"),\n    glibRefFunc: attr(node, \"glib:ref-func\"),\n    glibUnrefFunc: attr(node, \"glib:unref-func\"),\n    copyFunc: attr(node, \"copy-function\"),\n    freeFunc: attr(node, \"free-function\"),\n    disguised: isAttrTrue(node, \"disguised\"),\n    opaque: isAttrTrue(node, \"opaque\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    fields: collectFields(node, context),\n    methods: getChildren(node, \"method\").map((method) => functionFromNode(method, context)),\n    constructors: getChildren(node, GIR_CONSTRUCTOR_TAG).map((ctor) => functionFromNode(ctor, context)),\n    functions: getChildren(node, \"function\").map((fn) => functionFromNode(fn, context)),\n    isUnion,\n});\n\nconst isVtableRecord = (node: RawNode): boolean => attr(node, \"glib:is-gtype-struct-for\") !== undefined;\n\nexport { recordFromNode, isVtableRecord, type GirRecord };\n"]}

package/dist/gir/size.d.ts

@@ -8,14 +8,15 @@ type FieldSlot = {
     bitOffset: number | undefined;
     bitWidth: number | undefined;
 };
+type FieldSlots = {
+    slots: FieldSlot[];
+    size: number;
+};
 type FieldLayoutInput = {
     layout: FieldLayout;
     bits: number | undefined;
 };
 declare const layoutOfPrimitive: (category: PrimitiveCategory) => FieldLayout;
-declare const computeFieldSlots: (fields: FieldLayoutInput[], isUnion?: boolean) => {
-    slots: FieldSlot[];
-    size: number;
-};
+declare const computeFieldSlots: (fields: FieldLayoutInput[], isUnion?: boolean) => FieldSlots;
 export { layoutOfPrimitive, computeFieldSlots, type FieldLayout, type FieldSlot, type FieldLayoutInput };
 //# sourceMappingURL=size.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/gir/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,SAAS,GAAG;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AASF,QAAA,MAAM,iBAAiB,GAAI,UAAU,iBAAiB,KAAG,WAIxD,CAAC;AAkFF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,gBAAgB,EAAE,EAAE,iBAAe,KAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CACvC,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/gir/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,SAAS,GAAG;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,KAAK,UAAU,GAAG;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AASF,QAAA,MAAM,iBAAiB,GAAI,UAAU,iBAAiB,KAAG,WAIxD,CAAC;AA+EF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,gBAAgB,EAAE,EAAE,iBAAe,KAAG,UACL,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/gir/size.js

@@ -26,9 +26,6 @@ const pushPlainField = (state, slots, field, align) => {
     slots.push({ byteOffset, bitOffset: undefined, bitWidth: undefined });
     state.bitCursor = (byteOffset + field.layout.size) * 8;
 };
-// SysV AMD64 places a bit-field at the current bit offset whenever it still fits inside a storage
-// unit of its declared type aligned to that type's alignment, so the unit the cursor already sits in
-// may have room even though the cursor is not on a unit boundary.
 const pushBitfield = (input) => {
     const { state, slots, field, align, bits } = input;
     const unitStart = floorDown(floorDown(state.bitCursor, 8) / 8, align);

package/dist/gir/size.js.map

@@ -1 +1 @@
-{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/gir/size.ts"],"names":[],"mappings":"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","sourcesContent":["import { PRIMITIVE_SIZE, type PrimitiveCategory } from \"./primitives.js\";\n\ntype FieldLayout = {\n    size: number;\n    align: number;\n};\n\ntype FieldSlot = {\n    byteOffset: number;\n    bitOffset: number | undefined;\n    bitWidth: number | undefined;\n};\n\ntype FieldLayoutInput = {\n    layout: FieldLayout;\n    bits: number | undefined;\n};\n\ntype StructLayoutState = {\n    bitCursor: number;\n    maxAlign: number;\n};\n\nconst floorDown = (value: number, multiple: number): number => value - (value % multiple);\n\nconst layoutOfPrimitive = (category: PrimitiveCategory): FieldLayout => {\n    const size = PRIMITIVE_SIZE[category];\n\n    return { size, align: size === 0 ? 1 : size };\n};\n\nconst roundUp = (value: number, multiple: number): number => {\n    if (multiple <= 1) {\n        return value;\n    }\n\n    const remainder = value % multiple;\n\n    return remainder === 0 ? value : value + (multiple - remainder);\n};\n\nconst computeUnionSlots = (fields: FieldLayoutInput[]): { slots: FieldSlot[]; size: number } => {\n    let maxSize = 0;\n    let maxAlign = 1;\n\n    const slots = fields.map((field) => {\n        maxSize = Math.max(maxSize, field.layout.size);\n        maxAlign = Math.max(maxAlign, field.layout.align);\n\n        return { byteOffset: 0, bitOffset: field.bits === undefined ? undefined : 0, bitWidth: field.bits };\n    });\n\n    return { slots, size: roundUp(maxSize, maxAlign) };\n};\n\nconst pushPlainField = (state: StructLayoutState, slots: FieldSlot[], field: FieldLayoutInput, align: number): void => {\n    const byteOffset = roundUp(roundUp(state.bitCursor, 8) / 8, align);\n    slots.push({ byteOffset, bitOffset: undefined, bitWidth: undefined });\n    state.bitCursor = (byteOffset + field.layout.size) * 8;\n};\n\n// SysV AMD64 places a bit-field at the current bit offset whenever it still fits inside a storage\n// unit of its declared type aligned to that type's alignment, so the unit the cursor already sits in\n// may have room even though the cursor is not on a unit boundary.\nconst pushBitfield = (input: {\n    state: StructLayoutState;\n    slots: FieldSlot[];\n    field: FieldLayoutInput;\n    align: number;\n    bits: number;\n}): void => {\n    const { state, slots, field, align, bits } = input;\n    const unitStart = floorDown(floorDown(state.bitCursor, 8) / 8, align);\n    const isFitsInCurrentUnit = state.bitCursor + bits <= (unitStart + field.layout.size) * 8;\n    const byteOffset = isFitsInCurrentUnit ? unitStart : roundUp(roundUp(state.bitCursor, 8) / 8, align);\n\n    if (!isFitsInCurrentUnit) {\n        state.bitCursor = byteOffset * 8;\n    }\n\n    slots.push({ byteOffset, bitOffset: state.bitCursor - byteOffset * 8, bitWidth: bits });\n    state.bitCursor += bits;\n};\n\nconst processStructField = (state: StructLayoutState, slots: FieldSlot[], field: FieldLayoutInput): void => {\n    const align = Math.max(1, field.layout.align);\n\n    if (align > state.maxAlign) {\n        state.maxAlign = align;\n    }\n\n    if (field.bits === undefined) {\n        pushPlainField(state, slots, field, align);\n\n        return;\n    }\n\n    pushBitfield({ state, slots, field, align, bits: field.bits });\n};\n\nconst computeStructSlots = (fields: FieldLayoutInput[]): { slots: FieldSlot[]; size: number } => {\n    const slots: FieldSlot[] = [];\n    const state: StructLayoutState = { bitCursor: 0, maxAlign: 1 };\n\n    for (const field of fields) {\n        processStructField(state, slots, field);\n    }\n\n    return { slots, size: roundUp(roundUp(state.bitCursor, 8) / 8, state.maxAlign) };\n};\n\nconst computeFieldSlots = (fields: FieldLayoutInput[], isUnion = false): { slots: FieldSlot[]; size: number } =>\n    isUnion ? computeUnionSlots(fields) : computeStructSlots(fields);\n\nexport { layoutOfPrimitive, computeFieldSlots, type FieldLayout, type FieldSlot, type FieldLayoutInput };\n"]}
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/gir/size.ts"],"names":[],"mappings":"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","sourcesContent":["import { PRIMITIVE_SIZE, type PrimitiveCategory } from \"./primitives.js\";\n\ntype FieldLayout = {\n    size: number;\n    align: number;\n};\n\ntype FieldSlot = {\n    byteOffset: number;\n    bitOffset: number | undefined;\n    bitWidth: number | undefined;\n};\n\ntype FieldSlots = {\n    slots: FieldSlot[];\n    size: number;\n};\n\ntype FieldLayoutInput = {\n    layout: FieldLayout;\n    bits: number | undefined;\n};\n\ntype StructLayoutState = {\n    bitCursor: number;\n    maxAlign: number;\n};\n\nconst floorDown = (value: number, multiple: number): number => value - (value % multiple);\n\nconst layoutOfPrimitive = (category: PrimitiveCategory): FieldLayout => {\n    const size = PRIMITIVE_SIZE[category];\n\n    return { size, align: size === 0 ? 1 : size };\n};\n\nconst roundUp = (value: number, multiple: number): number => {\n    if (multiple <= 1) {\n        return value;\n    }\n\n    const remainder = value % multiple;\n\n    return remainder === 0 ? value : value + (multiple - remainder);\n};\n\nconst computeUnionSlots = (fields: FieldLayoutInput[]): FieldSlots => {\n    let maxSize = 0;\n    let maxAlign = 1;\n\n    const slots = fields.map((field) => {\n        maxSize = Math.max(maxSize, field.layout.size);\n        maxAlign = Math.max(maxAlign, field.layout.align);\n\n        return { byteOffset: 0, bitOffset: field.bits === undefined ? undefined : 0, bitWidth: field.bits };\n    });\n\n    return { slots, size: roundUp(maxSize, maxAlign) };\n};\n\nconst pushPlainField = (state: StructLayoutState, slots: FieldSlot[], field: FieldLayoutInput, align: number): void => {\n    const byteOffset = roundUp(roundUp(state.bitCursor, 8) / 8, align);\n    slots.push({ byteOffset, bitOffset: undefined, bitWidth: undefined });\n    state.bitCursor = (byteOffset + field.layout.size) * 8;\n};\n\nconst pushBitfield = (input: {\n    state: StructLayoutState;\n    slots: FieldSlot[];\n    field: FieldLayoutInput;\n    align: number;\n    bits: number;\n}): void => {\n    const { state, slots, field, align, bits } = input;\n    const unitStart = floorDown(floorDown(state.bitCursor, 8) / 8, align);\n    const isFitsInCurrentUnit = state.bitCursor + bits <= (unitStart + field.layout.size) * 8;\n    const byteOffset = isFitsInCurrentUnit ? unitStart : roundUp(roundUp(state.bitCursor, 8) / 8, align);\n\n    if (!isFitsInCurrentUnit) {\n        state.bitCursor = byteOffset * 8;\n    }\n\n    slots.push({ byteOffset, bitOffset: state.bitCursor - byteOffset * 8, bitWidth: bits });\n    state.bitCursor += bits;\n};\n\nconst processStructField = (state: StructLayoutState, slots: FieldSlot[], field: FieldLayoutInput): void => {\n    const align = Math.max(1, field.layout.align);\n\n    if (align > state.maxAlign) {\n        state.maxAlign = align;\n    }\n\n    if (field.bits === undefined) {\n        pushPlainField(state, slots, field, align);\n\n        return;\n    }\n\n    pushBitfield({ state, slots, field, align, bits: field.bits });\n};\n\nconst computeStructSlots = (fields: FieldLayoutInput[]): FieldSlots => {\n    const slots: FieldSlot[] = [];\n    const state: StructLayoutState = { bitCursor: 0, maxAlign: 1 };\n\n    for (const field of fields) {\n        processStructField(state, slots, field);\n    }\n\n    return { slots, size: roundUp(roundUp(state.bitCursor, 8) / 8, state.maxAlign) };\n};\n\nconst computeFieldSlots = (fields: FieldLayoutInput[], isUnion = false): FieldSlots =>\n    isUnion ? computeUnionSlots(fields) : computeStructSlots(fields);\n\nexport { layoutOfPrimitive, computeFieldSlots, type FieldLayout, type FieldSlot, type FieldLayoutInput };\n"]}

package/dist/gir/type-id.d.ts

@@ -1,44 +1,79 @@
 import type { RawNode } from "./parse.js";
 import type { PrimitiveCategory } from "./primitives.js";
+/** A reference to a parsed type: the type table holding it, and its slot in that table. */
 type TypeId = {
+    /** Id of the table holding the type: a namespace's, or the internal one primitives and varargs intern into. */
     nsId: number;
+    /** Slot the type occupies in that table. */
     id: number;
 };
+/** Which GLib container a {@link ListType} is. */
 type ListFlavor = (typeof LIST_FLAVOR_BY_NAME)[keyof typeof LIST_FLAVOR_BY_NAME];
+/** A type that marshals directly as a value, such as `gint` or `utf8`. */
 type PrimitiveType = {
+    /** Discriminates {@link StructuralType}. */
     kind: "primitive";
+    /** The scalar the type marshals as. */
     category: PrimitiveCategory;
 };
+/** The trailing `...` argument list of a variadic C function. */
 type VarargsType = {
+    /** Discriminates {@link StructuralType}. */
     kind: "varargs";
 };
+/** A C array, along with whatever the GIR says about how its length is determined. */
 type CArrayType = {
+    /** Discriminates {@link StructuralType}. */
     kind: "carray";
+    /** Type of the array's elements, paired with `elementCType` to build the element descriptor. */
     element: TypeId;
+    /** C declaration of an element, which tells an inline struct apart from a pointer to one. */
     elementCType: string | undefined;
+    /** C declaration of the array itself. */
+    arrayCType: string | undefined;
+    /** Index of the parameter, or of the sibling record field, carrying the length. */
     lengthParameterIndex: number | undefined;
+    /** Element count when the array has a fixed size. */
     fixedSize: number | undefined;
-    zeroTerminated: boolean;
+    /** Whether the array ends at a null element. */
+    isZeroTerminated: boolean;
 };
+/** A GLib list or array container over a single element type. */
 type ListType = {
+    /** Discriminates {@link StructuralType}. */
     kind: "list";
+    /** Which container the type is. */
     flavor: ListFlavor;
+    /** Type the container's elements marshal as, which the list descriptor wraps. */
     element: TypeId;
 };
+/** A `GLib.HashTable`. */
 type HashTableType = {
+    /** Discriminates {@link StructuralType}. */
     kind: "hashtable";
+    /** Type the keys marshal as, rendered as the key half of a `Record` or `Map`. */
     key: TypeId;
+    /** Type the values marshal as, rendered as the value half of a `Record` or `Map`. */
     value: TypeId;
 };
+/** A type the GIR describes by its structure rather than by a name it declares. */
 type StructuralType = PrimitiveType | VarargsType | CArrayType | ListType | HashTableType;
+/** The hooks the GIR parsers use to reference and register types while walking one namespace. */
 type ParseContext = {
+    /** Id of the namespace being parsed. */
     nsId: number;
+    /** Resolves a GIR type name, optionally namespace-qualified, reserving a slot when it is not parsed yet. */
     findType(name: string): TypeId;
+    /** Interns a primitive type and returns its id. */
     addPrimitive(category: PrimitiveCategory): TypeId;
+    /** Interns the varargs type and returns its id. */
     addVarargs(): TypeId;
+    /** Registers an unnamed container type in the namespace and returns its id. */
     addContainer(type: CArrayType | ListType | HashTableType): TypeId;
+    /** Parses an inline `<callback>` node, registers it as an unnamed type, and returns its id. */
     addAnonymousCallback(node: RawNode): TypeId;
 };
+/** GIR type names of the GLib containers, mapped to the {@link ListFlavor} each one parses to. */
 declare const LIST_FLAVOR_BY_NAME: {
     readonly "GLib.List": "glist";
     readonly "GLib.SList": "gslist";

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

@@ -1 +1 @@
-{"version":3,"file":"type-id.d.ts","sourceRoot":"","sources":["../../src/gir/type-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3C,KAAK,UAAU,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AACjF,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CAAC;AACxE,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvC,KAAK,UAAU,GAAG;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1F,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAClD,UAAU,IAAI,MAAM,CAAC;IACrB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IAClE,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/C,CAAC;AAEF,QAAA,MAAM,mBAAmB;;;;;;CAMf,CAAC;AAIX,QAAA,MAAM,qBAAqB,GAAI,KAAK,UAAU,KAAG,OAC+C,CAAC;AAEjG,OAAO,EACH,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,GACpB,CAAC"}
+{"version":3,"file":"type-id.d.ts","sourceRoot":"","sources":["../../src/gir/type-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,2FAA2F;AAC3F,KAAK,MAAM,GAAG;IACV,+GAA+G;IAC/G,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,kDAAkD;AAClD,KAAK,UAAU,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjF,0EAA0E;AAC1E,KAAK,aAAa,GAAG;IACjB,4CAA4C;IAC5C,IAAI,EAAE,WAAW,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,iEAAiE;AACjE,KAAK,WAAW,GAAG;IACf,4CAA4C;IAC5C,IAAI,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,sFAAsF;AACtF,KAAK,UAAU,GAAG;IACd,4CAA4C;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yCAAyC;IACzC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,iEAAiE;AACjE,KAAK,QAAQ,GAAG;IACZ,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,0BAA0B;AAC1B,KAAK,aAAa,GAAG;IACjB,4CAA4C;IAC5C,IAAI,EAAE,WAAW,CAAC;IAClB,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,mFAAmF;AACnF,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1F,iGAAiG;AACjG,KAAK,YAAY,GAAG;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,mDAAmD;IACnD,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAClD,mDAAmD;IACnD,UAAU,IAAI,MAAM,CAAC;IACrB,+EAA+E;IAC/E,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IAClE,+FAA+F;IAC/F,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/C,CAAC;AAEF,kGAAkG;AAClG,QAAA,MAAM,mBAAmB;;;;;;CAMf,CAAC;AAEX,QAAA,MAAM,qBAAqB,GAAI,KAAK,UAAU,KAAG,OACiD,CAAC;AAEnG,OAAO,EACH,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,GACpB,CAAC"}

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",
@@ -5,8 +6,6 @@ const LIST_FLAVOR_BY_NAME = {
     "GLib.Array": "garray",
     "GLib.ByteArray": "gbytearray",
 };
-// An array with no length parameter, no fixed size and an explicit `zero-terminated="0"` carries no
-// way to recover its length, so it is a bare pointer rather than something that can be walked.
-const hasUnknownArrayLength = (ref) => !ref.zeroTerminated && ref.lengthParameterIndex === undefined && ref.fixedSize === undefined;
+const hasUnknownArrayLength = (ref) => !ref.isZeroTerminated && ref.lengthParameterIndex === undefined && ref.fixedSize === undefined;
 export { hasUnknownArrayLength, LIST_FLAVOR_BY_NAME, };
 //# sourceMappingURL=type-id.js.map

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,oGAAoG;AACpG,+FAA+F;AAC/F,MAAM,qBAAqB,GAAG,CAAC,GAAe,EAAW,EAAE,CACvD,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,oBAAoB,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;AAEjG,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    zeroTerminated: 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\n// An array with no length parameter, no fixed size and an explicit `zero-terminated=\"0\"` carries no\n// way to recover its length, so it is a bare pointer rather than something that can be walked.\nconst hasUnknownArrayLength = (ref: CArrayType): boolean =>\n    !ref.zeroTerminated && 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"}