@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/gir/namespace.d.ts

@@ -1,46 +1,84 @@
 import type { ParseContext, TypeId } from "./type-id.js";
+import { type GirAnnotations } from "./annotations.js";
 import { type GirCallback } from "./callback.js";
 import { type GirClass } from "./class.js";
 import { type GirEnum } from "./enum.js";
 import { type GirFunction } from "./function.js";
 import { type RawNode } from "./parse.js";
 import { type GirRecord } from "./record.js";
+/** A compile-time constant declared by a namespace. */
 type GirConstant = {
+    /** Local name within the namespace. */
     name: string;
+    /** Documentation text carried by the GIR node. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the constant. */
+    annotations: GirAnnotations;
+    /** Literal as written in the GIR, still to be interpreted according to {@link GirConstant.type}. */
     value: string;
+    /** Type of the constant, unresolved until looked up in the library's type tables. */
     type: TypeId | undefined;
 };
+/** A named alias for another type. */
 type GirAlias = {
+    /** Local name within the namespace. */
     name: string;
+    /** Documentation text carried by the GIR node. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the alias. */
+    annotations: GirAnnotations;
+    /** C typedef name introduced by the alias. */
     cType: string | undefined;
+    /** Type the alias stands for, unresolved until looked up in the library's type tables. */
     target: TypeId | undefined;
+    /** C type name of the target, which decides how the alias marshals. */
     targetCType: string | undefined;
 };
+/** Everything one GIR namespace declares, keyed into the library that parsed it. */
 type GirNamespace = {
+    /** Identifier of the namespace's type table within its library. */
     id: number;
+    /** Namespace name as it appears in the GIR, such as `Gtk`. */
     name: string;
+    /** The `shared-library` attribute verbatim: the objects to load symbols from, separated by commas. */
     sharedLibrary: string | undefined;
+    /** Prefixes stripped off C identifiers to derive export names, such as `gtk`. */
     cSymbolPrefixes: string[];
+    /** GObject classes declared by the namespace. */
     classes: GirClass[];
+    /** GObject interfaces declared by the namespace. */
     interfaces: GirClass[];
+    /** Structs and unions declared by the namespace. */
     records: GirRecord[];
+    /** Enumerations and bitfields declared by the namespace. */
     enums: GirEnum[];
+    /** Callback types declared by the namespace. */
     callbacks: GirCallback[];
+    /** Free functions declared by the namespace. */
     functions: GirFunction[];
+    /** Compile-time values, emitted as module-level `const` bindings. */
     constants: GirConstant[];
+    /** Typedefs, emitted as TypeScript type aliases and resolvable as types themselves. */
     aliases: GirAlias[];
 };
+/** Another namespace a GIR repository depends on. */
 type NamespaceInclude = {
+    /** Name of the included namespace, such as `Gio`. */
     name: string;
+    /** Version of the included namespace, such as `2.0`. */
     version: string;
 };
+/** A namespace's declaration and dependencies, read before its body is parsed. */
 type NamespaceHeader = {
+    /** Namespace name as it appears in the GIR, such as `Gtk`. */
     name: string;
+    /** The `shared-library` attribute verbatim: the objects to load symbols from, separated by commas. */
     sharedLibrary: string | undefined;
+    /** Prefixes stripped off C identifiers to derive export names, such as `gtk`. */
     cSymbolPrefixes: string[];
+    /** Namespaces this repository includes, each of which is parsed in turn. */
     includes: NamespaceInclude[];
+    /** The `<namespace>` node whose children hold the declarations. */
     namespaceNode: RawNode;
 };
 declare const namespaceDirectory: (namespace: Pick<GirNamespace, "name">) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/gir/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAiD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,KAAK,SAAS,EAAkC,MAAM,aAAa,CAAC;AAG7E,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,WAAW,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,KAAG,MAAsC,CAAC;AAE3G,QAAA,MAAM,oBAAoB,GAAI,gBAAgB,OAAO,KAAG,eAmBvD,CAAC;AAEF,QAAA,MAAM,oBAAoB,GAAI,QAAQ,eAAe,EAAE,IAAI,MAAM,KAAG,YAalE,CAAC;AAEH,QAAA,MAAM,qBAAqB,GAAI,OAAO,YAAY,EAAE,eAAe,OAAO,EAAE,SAAS,YAAY,KAAG,IAsBnG,CAAC;AAiBF,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,eAAe,GACvB,CAAC"}
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/gir/namespace.ts"],"names":[],"mappings":"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"}

package/dist/gir/namespace.js

@@ -1,8 +1,9 @@
+import { documentedFromNode } from "./annotations.js";
 import { callbackFromNode } from "./callback.js";
 import { classFromNode } from "./class.js";
 import { enumFromNode } from "./enum.js";
 import { functionFromNode } from "./function.js";
-import { attr, getChild, getChildren, getDoc, nameAttr } from "./parse.js";
+import { attr, getChild, getChildren, nameAttr } from "./parse.js";
 import { isVtableRecord, recordFromNode } from "./record.js";
 import { typeRefFromNode } from "./type-ref.js";
 const namespaceDirectory = (namespace) => namespace.name.toLowerCase();
@@ -45,14 +46,12 @@ const populateNamespaceBody = (shell, namespaceNode, context) => {
     shell.callbacks = getChildren(namespaceNode, "callback").map((callback) => callbackFromNode(callback, context));
     shell.functions = getChildren(namespaceNode, "function").map((fn) => functionFromNode(fn, context));
     shell.constants = getChildren(namespaceNode, "constant").map((constant) => ({
-        name: nameAttr(constant),
-        doc: getDoc(constant),
+        ...documentedFromNode(constant),
         value: attr(constant, "value") ?? "",
         type: typeRefFromNode(constant, context),
     }));
     shell.aliases = getChildren(namespaceNode, "alias").map((alias) => ({
-        name: nameAttr(alias),
-        doc: getDoc(alias),
+        ...documentedFromNode(alias),
         cType: attr(alias, "c:type"),
         target: typeRefFromNode(alias, context),
         targetCType: attr(getChild(alias, "type"), "c:type"),

package/dist/gir/namespace.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/gir/namespace.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { callbackFromNode, type GirCallback } from \"./callback.js\";\nimport { classFromNode, type GirClass } from \"./class.js\";\nimport { enumFromNode, type GirEnum } from \"./enum.js\";\nimport { functionFromNode, type GirFunction } from \"./function.js\";\nimport { attr, getChild, getChildren, getDoc, nameAttr, type RawNode } from \"./parse.js\";\nimport { type GirRecord, isVtableRecord, recordFromNode } from \"./record.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\ntype GirConstant = {\n    name: string;\n    doc: string | undefined;\n    value: string;\n    type: TypeId | undefined;\n};\n\ntype GirAlias = {\n    name: string;\n    doc: string | undefined;\n    cType: string | undefined;\n    target: TypeId | undefined;\n    targetCType: string | undefined;\n};\n\ntype GirNamespace = {\n    id: number;\n    name: string;\n    sharedLibrary: string | undefined;\n    cSymbolPrefixes: string[];\n    classes: GirClass[];\n    interfaces: GirClass[];\n    records: GirRecord[];\n    enums: GirEnum[];\n    callbacks: GirCallback[];\n    functions: GirFunction[];\n    constants: GirConstant[];\n    aliases: GirAlias[];\n};\n\ntype NamespaceInclude = {\n    name: string;\n    version: string;\n};\n\ntype NamespaceHeader = {\n    name: string;\n    sharedLibrary: string | undefined;\n    cSymbolPrefixes: string[];\n    includes: NamespaceInclude[];\n    namespaceNode: RawNode;\n};\n\nconst namespaceDirectory = (namespace: Pick<GirNamespace, \"name\">): string => namespace.name.toLowerCase();\n\nconst parseNamespaceHeader = (repositoryNode: RawNode): NamespaceHeader => {\n    const includes = getChildren(repositoryNode, \"include\").map<NamespaceInclude>((include) => ({\n        name: nameAttr(include),\n        version: attr(include, \"version\") ?? \"\",\n    }));\n\n    const namespaceNode = getChildren(repositoryNode, \"namespace\")[0];\n\n    if (namespaceNode === undefined) {\n        throw new Error(\"GIR repository has no <namespace> child\");\n    }\n\n    return {\n        name: nameAttr(namespaceNode),\n        sharedLibrary: attr(namespaceNode, \"shared-library\"),\n        cSymbolPrefixes: splitPrefixes(attr(namespaceNode, \"c:symbol-prefixes\")),\n        includes,\n        namespaceNode,\n    };\n};\n\nconst createNamespaceShell = (header: NamespaceHeader, id: number): GirNamespace => ({\n    id,\n    name: header.name,\n    sharedLibrary: header.sharedLibrary,\n    cSymbolPrefixes: header.cSymbolPrefixes,\n    classes: [],\n    interfaces: [],\n    records: [],\n    enums: [],\n    callbacks: [],\n    functions: [],\n    constants: [],\n    aliases: [],\n});\n\nconst populateNamespaceBody = (shell: GirNamespace, namespaceNode: RawNode, context: ParseContext): void => {\n    shell.classes = getChildren(namespaceNode, \"class\").map((klass) => classFromNode(klass, false, context));\n    shell.interfaces = getChildren(namespaceNode, \"interface\").map((iface) => classFromNode(iface, true, context));\n    shell.records = collectRecords(namespaceNode, context);\n    shell.enums = collectEnums(namespaceNode);\n    shell.callbacks = getChildren(namespaceNode, \"callback\").map((callback) => callbackFromNode(callback, context));\n    shell.functions = getChildren(namespaceNode, \"function\").map((fn) => functionFromNode(fn, context));\n\n    shell.constants = getChildren(namespaceNode, \"constant\").map((constant) => ({\n        name: nameAttr(constant),\n        doc: getDoc(constant),\n        value: attr(constant, \"value\") ?? \"\",\n        type: typeRefFromNode(constant, context),\n    }));\n\n    shell.aliases = getChildren(namespaceNode, \"alias\").map((alias) => ({\n        name: nameAttr(alias),\n        doc: getDoc(alias),\n        cType: attr(alias, \"c:type\"),\n        target: typeRefFromNode(alias, context),\n        targetCType: attr(getChild(alias, \"type\"), \"c:type\"),\n    }));\n};\n\nconst splitPrefixes = (raw: string | undefined): string[] =>\n    (raw ?? \"\").split(\",\").filter((prefix) => prefix.length > 0);\n\nconst collectRecords = (namespaceNode: RawNode, context: ParseContext): GirRecord[] => [\n    ...getChildren(namespaceNode, \"record\").map((record) =>\n        recordFromNode(record, isVtableRecord(record), false, context),\n    ),\n    ...getChildren(namespaceNode, \"union\").map((union) => recordFromNode(union, isVtableRecord(union), true, context)),\n];\n\nconst collectEnums = (namespaceNode: RawNode): GirEnum[] => [\n    ...getChildren(namespaceNode, \"enumeration\").map((enumeration) => enumFromNode(enumeration, \"enumeration\")),\n    ...getChildren(namespaceNode, \"bitfield\").map((bitfield) => enumFromNode(bitfield, \"bitfield\")),\n];\n\nexport {\n    namespaceDirectory,\n    parseNamespaceHeader,\n    createNamespaceShell,\n    populateNamespaceBody,\n    type GirConstant,\n    type GirAlias,\n    type GirNamespace,\n    type NamespaceHeader,\n};\n"]}
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/gir/namespace.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport { callbackFromNode, type GirCallback } from \"./callback.js\";\nimport { classFromNode, type GirClass } from \"./class.js\";\nimport { enumFromNode, type GirEnum } from \"./enum.js\";\nimport { functionFromNode, type GirFunction } from \"./function.js\";\nimport { attr, getChild, getChildren, nameAttr, type RawNode } from \"./parse.js\";\nimport { type GirRecord, isVtableRecord, recordFromNode } from \"./record.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\n/** A compile-time constant declared by a namespace. */\ntype GirConstant = {\n    /** Local name within the namespace. */\n    name: string;\n    /** Documentation text carried by the GIR node. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the constant. */\n    annotations: GirAnnotations;\n    /** Literal as written in the GIR, still to be interpreted according to {@link GirConstant.type}. */\n    value: string;\n    /** Type of the constant, unresolved until looked up in the library's type tables. */\n    type: TypeId | undefined;\n};\n\n/** A named alias for another type. */\ntype GirAlias = {\n    /** Local name within the namespace. */\n    name: string;\n    /** Documentation text carried by the GIR node. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the alias. */\n    annotations: GirAnnotations;\n    /** C typedef name introduced by the alias. */\n    cType: string | undefined;\n    /** Type the alias stands for, unresolved until looked up in the library's type tables. */\n    target: TypeId | undefined;\n    /** C type name of the target, which decides how the alias marshals. */\n    targetCType: string | undefined;\n};\n\n/** Everything one GIR namespace declares, keyed into the library that parsed it. */\ntype GirNamespace = {\n    /** Identifier of the namespace's type table within its library. */\n    id: number;\n    /** Namespace name as it appears in the GIR, such as `Gtk`. */\n    name: string;\n    /** The `shared-library` attribute verbatim: the objects to load symbols from, separated by commas. */\n    sharedLibrary: string | undefined;\n    /** Prefixes stripped off C identifiers to derive export names, such as `gtk`. */\n    cSymbolPrefixes: string[];\n    /** GObject classes declared by the namespace. */\n    classes: GirClass[];\n    /** GObject interfaces declared by the namespace. */\n    interfaces: GirClass[];\n    /** Structs and unions declared by the namespace. */\n    records: GirRecord[];\n    /** Enumerations and bitfields declared by the namespace. */\n    enums: GirEnum[];\n    /** Callback types declared by the namespace. */\n    callbacks: GirCallback[];\n    /** Free functions declared by the namespace. */\n    functions: GirFunction[];\n    /** Compile-time values, emitted as module-level `const` bindings. */\n    constants: GirConstant[];\n    /** Typedefs, emitted as TypeScript type aliases and resolvable as types themselves. */\n    aliases: GirAlias[];\n};\n\n/** Another namespace a GIR repository depends on. */\ntype NamespaceInclude = {\n    /** Name of the included namespace, such as `Gio`. */\n    name: string;\n    /** Version of the included namespace, such as `2.0`. */\n    version: string;\n};\n\n/** A namespace's declaration and dependencies, read before its body is parsed. */\ntype NamespaceHeader = {\n    /** Namespace name as it appears in the GIR, such as `Gtk`. */\n    name: string;\n    /** The `shared-library` attribute verbatim: the objects to load symbols from, separated by commas. */\n    sharedLibrary: string | undefined;\n    /** Prefixes stripped off C identifiers to derive export names, such as `gtk`. */\n    cSymbolPrefixes: string[];\n    /** Namespaces this repository includes, each of which is parsed in turn. */\n    includes: NamespaceInclude[];\n    /** The `<namespace>` node whose children hold the declarations. */\n    namespaceNode: RawNode;\n};\n\nconst namespaceDirectory = (namespace: Pick<GirNamespace, \"name\">): string => namespace.name.toLowerCase();\n\nconst parseNamespaceHeader = (repositoryNode: RawNode): NamespaceHeader => {\n    const includes = getChildren(repositoryNode, \"include\").map<NamespaceInclude>((include) => ({\n        name: nameAttr(include),\n        version: attr(include, \"version\") ?? \"\",\n    }));\n\n    const namespaceNode = getChildren(repositoryNode, \"namespace\")[0];\n\n    if (namespaceNode === undefined) {\n        throw new Error(\"GIR repository has no <namespace> child\");\n    }\n\n    return {\n        name: nameAttr(namespaceNode),\n        sharedLibrary: attr(namespaceNode, \"shared-library\"),\n        cSymbolPrefixes: splitPrefixes(attr(namespaceNode, \"c:symbol-prefixes\")),\n        includes,\n        namespaceNode,\n    };\n};\n\nconst createNamespaceShell = (header: NamespaceHeader, id: number): GirNamespace => ({\n    id,\n    name: header.name,\n    sharedLibrary: header.sharedLibrary,\n    cSymbolPrefixes: header.cSymbolPrefixes,\n    classes: [],\n    interfaces: [],\n    records: [],\n    enums: [],\n    callbacks: [],\n    functions: [],\n    constants: [],\n    aliases: [],\n});\n\nconst populateNamespaceBody = (shell: GirNamespace, namespaceNode: RawNode, context: ParseContext): void => {\n    shell.classes = getChildren(namespaceNode, \"class\").map((klass) => classFromNode(klass, false, context));\n    shell.interfaces = getChildren(namespaceNode, \"interface\").map((iface) => classFromNode(iface, true, context));\n    shell.records = collectRecords(namespaceNode, context);\n    shell.enums = collectEnums(namespaceNode);\n    shell.callbacks = getChildren(namespaceNode, \"callback\").map((callback) => callbackFromNode(callback, context));\n    shell.functions = getChildren(namespaceNode, \"function\").map((fn) => functionFromNode(fn, context));\n\n    shell.constants = getChildren(namespaceNode, \"constant\").map((constant) => ({\n        ...documentedFromNode(constant),\n        value: attr(constant, \"value\") ?? \"\",\n        type: typeRefFromNode(constant, context),\n    }));\n\n    shell.aliases = getChildren(namespaceNode, \"alias\").map((alias) => ({\n        ...documentedFromNode(alias),\n        cType: attr(alias, \"c:type\"),\n        target: typeRefFromNode(alias, context),\n        targetCType: attr(getChild(alias, \"type\"), \"c:type\"),\n    }));\n};\n\nconst splitPrefixes = (raw: string | undefined): string[] =>\n    (raw ?? \"\").split(\",\").filter((prefix) => prefix.length > 0);\n\nconst collectRecords = (namespaceNode: RawNode, context: ParseContext): GirRecord[] => [\n    ...getChildren(namespaceNode, \"record\").map((record) =>\n        recordFromNode(record, isVtableRecord(record), false, context),\n    ),\n    ...getChildren(namespaceNode, \"union\").map((union) => recordFromNode(union, isVtableRecord(union), true, context)),\n];\n\nconst collectEnums = (namespaceNode: RawNode): GirEnum[] => [\n    ...getChildren(namespaceNode, \"enumeration\").map((enumeration) => enumFromNode(enumeration, \"enumeration\")),\n    ...getChildren(namespaceNode, \"bitfield\").map((bitfield) => enumFromNode(bitfield, \"bitfield\")),\n];\n\nexport {\n    namespaceDirectory,\n    parseNamespaceHeader,\n    createNamespaceShell,\n    populateNamespaceBody,\n    type GirConstant,\n    type GirAlias,\n    type GirNamespace,\n    type NamespaceHeader,\n};\n"]}

package/dist/gir/parameter.d.ts

@@ -1,33 +1,72 @@
 import type { ParseContext, TypeId } from "./type-id.js";
+import { type GirAnnotations } from "./annotations.js";
 import { type RawNode } from "./parse.js";
+/** Which way a parameter's value travels: into the call, back out of it, or both. */
 type ParameterDirection = "in" | "out" | "inout";
+/** How much of a value the receiver takes ownership of: none, the whole value, or only its container. */
 type ParameterTransfer = "none" | "full" | "container";
+/**
+ * How long a callback parameter stays valid: for the duration of the call, until its destroy notify runs,
+ * until the asynchronous operation invokes it, or forever.
+ */
 type CallbackScope = "call" | "notified" | "async" | "forever";
+/** A parameter of a {@link GirCallable}, with the annotations that decide how it is marshalled. */
 type GirParameter = {
+    /** The name GIR gives the parameter. */
     name: string;
+    /** What the parameter holds, absent when the GIR node declares no type. */
     type: TypeId | undefined;
+    /** The C spelling of the parameter's type, taken from its `type` or `array` child. */
+    cType: string | undefined;
+    /** Documentation prose from GIR, emitted as the parameter's `@param` text. */
+    doc: string | undefined;
+    /** Decides whether the parameter is an argument, part of the returned tuple, or both. */
     direction: ParameterDirection;
+    /** Ownership the marshalling descriptor is generated with, deciding whether the receiver frees the value. */
     transferOwnership: ParameterTransfer;
+    /** Whether the value may be null. */
     nullable: boolean;
+    /** Whether the caller may leave the parameter out entirely. */
     optional: boolean;
+    /** Whether the caller supplies the storage an out parameter writes into. */
     callerAllocates: boolean;
+    /** How long a callback parameter stays valid, absent when GIR carries no scope annotation. */
     scope: CallbackScope | undefined;
+    /** Position of the parameter carrying the callback's user data. */
     closureIndex: number | undefined;
+    /** Position of the parameter carrying the callback's destroy notify. */
     destroyIndex: number | undefined;
+    /** Whether the parameter is the `...` varargs marker. */
     isVarargs: boolean;
 };
+/** What a {@link GirCallable} hands back, with the annotations that decide how it is marshalled. */
 type GirReturnValue = {
+    /** What the callable returns, absent when the GIR node declares no type. */
     type: TypeId | undefined;
+    /** Documentation prose from GIR, emitted as the callable's `@returns` text. */
+    doc: string | undefined;
+    /** How much ownership the caller takes of the returned value. */
     transferOwnership: ParameterTransfer;
+    /** Whether the returned value may be null. */
     nullable: boolean;
+    /** Whether GIR marks the value as skipped, keeping it out of the generated signature. */
     skip: boolean;
 };
+/** Anything GIR describes with parameters and a return value: functions, methods, signals, and callbacks. */
 type GirCallable = {
+    /** The name GIR gives the callable. */
     name: string;
+    /** The callable's documentation text, absent when GIR carries none. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the callable. */
+    annotations: GirAnnotations;
+    /** The parameters the callable takes, in declaration order. */
     parameters: GirParameter[];
+    /** What the callable hands back. */
     returnValue: GirReturnValue;
+    /** Whether the callable reports failure through a trailing `GError`. */
     throws: boolean;
+    /** Whether GIR exposes the callable to bindings. */
     introspectable: boolean;
 };
 declare const transferOwnership: (node: RawNode) => ParameterTransfer;

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

@@ -1 +1 @@
-{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../src/gir/parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EASH,KAAK,OAAO,EACf,MAAM,YAAY,CAAC;AAGpB,KAAK,kBAAkB,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AACjD,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AACvD,KAAK,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,EAAE,cAAc,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CAC3B,CAAC;AAMF,QAAA,MAAM,iBAAiB,GAAI,MAAM,OAAO,KAAG,iBACiD,CAAC;AAW7F,QAAA,MAAM,iBAAiB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,YAYhE,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,WAAW,YAAY,KAAG,OACa,CAAC;AAEhE,QAAA,MAAM,oBAAoB,GAAI,WAAW,YAAY,KAAG,OACM,CAAC;AAE/D,QAAA,MAAM,gBAAgB,GAAI,WAAW,YAAY,KAAG,OAA0C,CAAC;AAe/F,QAAA,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAY7D,CAAC;AAEF,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,GACnB,CAAC"}
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../src/gir/parameter.ts"],"names":[],"mappings":"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"}

package/dist/gir/parameter.js

@@ -1,3 +1,4 @@
+import { documentedFromNode } from "./annotations.js";
 import { attr, getChild, getChildren, getDoc, intAttr, isAttrTrue, nameAttr, parseEnumAttr, } from "./parse.js";
 import { typeRefFromNode } from "./type-ref.js";
 const DIRECTIONS = new Set(["in", "out", "inout"]);
@@ -7,9 +8,12 @@ const transferOwnership = (node) => parseEnumAttr(attr(node, "transfer-ownership
 const isInDirection = (node) => parseEnumAttr(attr(node, "direction"), DIRECTIONS, "in", "direction") === "in";
 const hasNullableAttr = (node) => isAttrTrue(node, "nullable") || (isInDirection(node) && isAttrTrue(node, "allow-none"));
 const hasOptionalAttr = (node) => isAttrTrue(node, "optional") || (!isInDirection(node) && isAttrTrue(node, "allow-none"));
+const parameterCType = (node) => attr(getChild(node, "type"), "c:type") ?? attr(getChild(node, "array"), "c:type");
 const parameterFromNode = (node, context) => ({
     name: nameAttr(node),
     type: typeRefFromNode(node, context),
+    cType: parameterCType(node),
+    doc: getDoc(node),
     direction: parseEnumAttr(attr(node, "direction"), DIRECTIONS, "in", "direction"),
     transferOwnership: transferOwnership(node),
     nullable: hasNullableAttr(node),
@@ -25,10 +29,11 @@ const isCallerAllocatedOut = (parameter) => parameter.direction === "out" && par
 const isInoutParameter = (parameter) => parameter.direction === "inout";
 const returnValueFromNode = (node, context) => {
     if (node === undefined) {
-        return { type: undefined, transferOwnership: "none", nullable: false, skip: false };
+        return { type: undefined, doc: undefined, transferOwnership: "none", nullable: false, skip: false };
     }
     return {
         type: typeRefFromNode(node, context),
+        doc: getDoc(node),
         transferOwnership: transferOwnership(node),
         nullable: hasNullableAttr(node),
         skip: isAttrTrue(node, "skip"),
@@ -38,8 +43,7 @@ const parseCallable = (node, context) => {
     const parametersNode = getChild(node, "parameters");
     const parameterNodes = getChildren(parametersNode, "parameter");
     return {
-        name: nameAttr(node),
-        doc: getDoc(node),
+        ...documentedFromNode(node),
         parameters: parameterNodes.map((parameter) => parameterFromNode(parameter, context)),
         returnValue: returnValueFromNode(getChild(node, "return-value"), context),
         throws: isAttrTrue(node, "throws"),

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\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"]}