@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/gir/enum.d.ts

@@ -1,21 +1,41 @@
+import { type GirAnnotations } from "./annotations.js";
 import { type RawNode } from "./parse.js";
+/** One member of a {@link GirEnum}. */
 type EnumMember = {
+    /** The member's GIR name, which the emitted key is derived from. */
     name: string;
+    /** Documentation prose from GIR, emitted as the member's JSDoc. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the member. */
+    annotations: GirAnnotations;
+    /** The member's numeric value, `0` when GIR declares none. */
     value: string;
+    /** C constant the member is exposed as, such as `GTK_ORIENTATION_HORIZONTAL`. */
     cIdentifier: string | undefined;
 };
+/** Whether an enum is a plain enumeration or a bitfield of flags. */
 type EnumKind = "enumeration" | "bitfield";
+/** An enumeration or bitfield declared by a GIR namespace. */
 type GirEnum = {
+    /** Whether the declaration is a plain enumeration or a bitfield. */
     kind: EnumKind;
+    /** Name the enum is exported under, without its namespace prefix. */
     name: string;
+    /** Documentation prose from GIR, emitted as the enum's JSDoc. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the enum. */
+    annotations: GirAnnotations;
+    /** GType name of the enum, absent when it is not registered with GLib. */
     glibTypeName: string | undefined;
+    /** C function returning the enum's GType, absent when it is not registered with GLib. */
     glibGetType: string | undefined;
+    /** Quark name of the GError domain the members are codes of, absent on enums that carry no domain. */
     errorDomain: string | undefined;
+    /** Whether the enum is introspectable; code generation skips the ones that are not. */
     introspectable: boolean;
+    /** The enum's members, in declaration order. */
     members: EnumMember[];
 };
 declare const enumFromNode: (node: RawNode, kind: EnumKind) => GirEnum;
-export { enumFromNode, type GirEnum };
+export { enumFromNode, type EnumMember, type GirEnum };
 //# sourceMappingURL=enum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3F,KAAK,UAAU,GAAG;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,KAAK,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3C,KAAK,OAAO,GAAG;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,MAAM,OAAO,EAAE,MAAM,QAAQ,KAAG,OAcpD,CAAC;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,CAAC"}
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEzE,uCAAuC;AACvC,KAAK,UAAU,GAAG;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,cAAc,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,qEAAqE;AACrE,KAAK,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3C,8DAA8D;AAC9D,KAAK,OAAO,GAAG;IACX,oEAAoE;IACpE,IAAI,EAAE,QAAQ,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,mEAAmE;IACnE,WAAW,EAAE,cAAc,CAAC;IAC5B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yFAAyF;IACzF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sGAAsG;IACtG,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uFAAuF;IACvF,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAQF,QAAA,MAAM,YAAY,GAAI,MAAM,OAAO,EAAE,MAAM,QAAQ,KAAG,OAQpD,CAAC;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,CAAC"}

package/dist/gir/enum.js

@@ -1,18 +1,18 @@
-import { attr, getChildren, getDoc, isAttrTrue, nameAttr } from "./parse.js";
+import { documentedFromNode } from "./annotations.js";
+import { attr, getChildren, isAttrTrue } from "./parse.js";
+const enumMemberFromNode = (node) => ({
+    ...documentedFromNode(node),
+    value: attr(node, "value") ?? "0",
+    cIdentifier: attr(node, "c:identifier"),
+});
 const enumFromNode = (node, kind) => ({
     kind,
-    name: nameAttr(node),
-    doc: getDoc(node),
+    ...documentedFromNode(node),
     glibTypeName: attr(node, "glib:type-name"),
     glibGetType: attr(node, "glib:get-type"),
     errorDomain: attr(node, "glib:error-domain"),
     introspectable: isAttrTrue(node, "introspectable", true),
-    members: getChildren(node, "member").map((member) => ({
-        name: nameAttr(member),
-        doc: getDoc(member),
-        value: attr(member, "value") ?? "0",
-        cIdentifier: attr(member, "c:identifier"),
-    })),
+    members: getChildren(node, "member").map((member) => enumMemberFromNode(member)),
 });
 export { enumFromNode };
 //# sourceMappingURL=enum.js.map

package/dist/gir/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAsB3F,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,IAAc,EAAW,EAAE,CAAC,CAAC;IAC9D,IAAI;IACJ,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC1C,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAC5C,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,GAAG;QACnC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;KAC5C,CAAC,CAAC;CACN,CAAC,CAAC;AAEH,OAAO,EAAE,YAAY,EAAgB,CAAC","sourcesContent":["import { attr, getChildren, getDoc, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\n\ntype EnumMember = {\n    name: string;\n    doc: string | undefined;\n    value: string;\n    cIdentifier: string | undefined;\n};\n\ntype EnumKind = \"enumeration\" | \"bitfield\";\n\ntype GirEnum = {\n    kind: EnumKind;\n    name: string;\n    doc: string | undefined;\n    glibTypeName: string | undefined;\n    glibGetType: string | undefined;\n    errorDomain: string | undefined;\n    introspectable: boolean;\n    members: EnumMember[];\n};\n\nconst enumFromNode = (node: RawNode, kind: EnumKind): GirEnum => ({\n    kind,\n    name: nameAttr(node),\n    doc: getDoc(node),\n    glibTypeName: attr(node, \"glib:type-name\"),\n    glibGetType: attr(node, \"glib:get-type\"),\n    errorDomain: attr(node, \"glib:error-domain\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    members: getChildren(node, \"member\").map((member) => ({\n        name: nameAttr(member),\n        doc: getDoc(member),\n        value: attr(member, \"value\") ?? \"0\",\n        cIdentifier: attr(member, \"c:identifier\"),\n    })),\n});\n\nexport { enumFromNode, type GirEnum };\n"]}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAyCzE,MAAM,kBAAkB,GAAG,CAAC,IAAa,EAAc,EAAE,CAAC,CAAC;IACvD,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC3B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG;IACjC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,IAAc,EAAW,EAAE,CAAC,CAAC;IAC9D,IAAI;IACJ,GAAG,kBAAkB,CAAC,IAAI,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,mBAAmB,CAAC;IAC5C,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;IACxD,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACnF,CAAC,CAAC;AAEH,OAAO,EAAE,YAAY,EAAiC,CAAC","sourcesContent":["import { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport { attr, getChildren, isAttrTrue, type RawNode } from \"./parse.js\";\n\n/** One member of a {@link GirEnum}. */\ntype EnumMember = {\n    /** The member's GIR name, which the emitted key is derived from. */\n    name: string;\n    /** Documentation prose from GIR, emitted as the member's JSDoc. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the member. */\n    annotations: GirAnnotations;\n    /** The member's numeric value, `0` when GIR declares none. */\n    value: string;\n    /** C constant the member is exposed as, such as `GTK_ORIENTATION_HORIZONTAL`. */\n    cIdentifier: string | undefined;\n};\n\n/** Whether an enum is a plain enumeration or a bitfield of flags. */\ntype EnumKind = \"enumeration\" | \"bitfield\";\n\n/** An enumeration or bitfield declared by a GIR namespace. */\ntype GirEnum = {\n    /** Whether the declaration is a plain enumeration or a bitfield. */\n    kind: EnumKind;\n    /** Name the enum is exported under, without its namespace prefix. */\n    name: string;\n    /** Documentation prose from GIR, emitted as the enum's JSDoc. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the enum. */\n    annotations: GirAnnotations;\n    /** GType name of the enum, absent when it is not registered with GLib. */\n    glibTypeName: string | undefined;\n    /** C function returning the enum's GType, absent when it is not registered with GLib. */\n    glibGetType: string | undefined;\n    /** Quark name of the GError domain the members are codes of, absent on enums that carry no domain. */\n    errorDomain: string | undefined;\n    /** Whether the enum is introspectable; code generation skips the ones that are not. */\n    introspectable: boolean;\n    /** The enum's members, in declaration order. */\n    members: EnumMember[];\n};\n\nconst enumMemberFromNode = (node: RawNode): EnumMember => ({\n    ...documentedFromNode(node),\n    value: attr(node, \"value\") ?? \"0\",\n    cIdentifier: attr(node, \"c:identifier\"),\n});\n\nconst enumFromNode = (node: RawNode, kind: EnumKind): GirEnum => ({\n    kind,\n    ...documentedFromNode(node),\n    glibTypeName: attr(node, \"glib:type-name\"),\n    glibGetType: attr(node, \"glib:get-type\"),\n    errorDomain: attr(node, \"glib:error-domain\"),\n    introspectable: isAttrTrue(node, \"introspectable\", true),\n    members: getChildren(node, \"member\").map((member) => enumMemberFromNode(member)),\n});\n\nexport { enumFromNode, type EnumMember, type GirEnum };\n"]}

package/dist/gir/field.d.ts

@@ -1,18 +1,34 @@
 import type { ParseContext, TypeId } from "./type-id.js";
+import { type GirAnnotations } from "./annotations.js";
 import { type RawNode } from "./parse.js";
+/**
+ * One slot in a record or union layout: a named field, or a nested struct or union
+ * whose own members are laid out inline.
+ */
 type GirField = {
+    /** Field name as GIR spells it. */
     name: string;
+    /** Documentation prose from GIR, emitted as the field accessor's JSDoc. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the field. */
+    annotations: GirAnnotations;
+    /** The field's value type, absent for a nested struct or union and for one GIR leaves undeclared. */
     type: TypeId | undefined;
+    /** The C type spelled on the field, which decides whether it is read through a pointer. */
     cType: string | undefined;
+    /** Whether the field can be read; one that is neither readable nor writable gets no accessor at all. */
     readable: boolean;
+    /** Whether the field can be written, which is what earns it a setter alongside its getter. */
     writable: boolean;
+    /** Whether the field is private to the library, as every nested struct or union is. */
     private: boolean;
+    /** Width in bits when the field is a C bitfield member. */
     bits: number | undefined;
+    /** Members of a nested struct or union, absent for a named field. */
     inlineMembers: GirField[] | undefined;
-    inlineIsUnion: boolean;
+    /** Whether {@link GirField.inlineMembers} overlap as a union rather than following one another as a struct. */
+    isInlineUnion: boolean;
 };
-declare const fieldFromNode: (node: RawNode, context: ParseContext) => GirField;
 declare const collectFields: (node: RawNode, context: ParseContext) => GirField[];
-export { collectFields, fieldFromNode, type GirField };
+export { collectFields, type GirField };
 //# sourceMappingURL=field.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/gir/field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAsE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG9G,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,aAAa,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACtC,aAAa,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,QAW5D,CAAC;AAeH,QAAA,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,QAAQ,EAIrE,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/gir/field.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,EAAoD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5F;;;GAGG;AACH,KAAK,QAAQ,GAAG;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,oEAAoE;IACpE,WAAW,EAAE,cAAc,CAAC;IAC5B,qGAAqG;IACrG,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,wGAAwG;IACxG,QAAQ,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qEAAqE;IACrE,aAAa,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACtC,+GAA+G;IAC/G,aAAa,EAAE,OAAO,CAAC;CAC1B,CAAC;AA0BF,QAAA,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,QAAQ,EAIrE,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,CAAC"}

package/dist/gir/field.js

@@ -1,8 +1,8 @@
-import { attr, getChild, getChildren, getDoc, intAttr, isAttrTrue, nameAttr } from "./parse.js";
+import { documentedFromNode } from "./annotations.js";
+import { attr, getChild, getChildren, intAttr, isAttrTrue } from "./parse.js";
 import { typeRefFromNode } from "./type-ref.js";
 const fieldFromNode = (node, context) => ({
-    name: nameAttr(node),
-    doc: getDoc(node),
+    ...documentedFromNode(node),
     type: typeRefFromNode(node, context),
     cType: attr(getChild(node, "type"), "c:type"),
     readable: isAttrTrue(node, "readable", true),
@@ -10,11 +10,10 @@ const fieldFromNode = (node, context) => ({
     private: isAttrTrue(node, "private", false),
     bits: intAttr(node, "bits"),
     inlineMembers: undefined,
-    inlineIsUnion: false,
+    isInlineUnion: false,
 });
 const anonymousMemberFromNode = (node, isUnion, context) => ({
-    name: nameAttr(node),
-    doc: getDoc(node),
+    ...documentedFromNode(node),
     type: undefined,
     cType: undefined,
     readable: false,
@@ -22,12 +21,12 @@ const anonymousMemberFromNode = (node, isUnion, context) => ({
     private: true,
     bits: undefined,
     inlineMembers: collectFields(node, context),
-    inlineIsUnion: isUnion,
+    isInlineUnion: isUnion,
 });
 const collectFields = (node, context) => [
     ...getChildren(node, "field").map((field) => fieldFromNode(field, context)),
     ...getChildren(node, "union").map((member) => anonymousMemberFromNode(member, true, context)),
     ...getChildren(node, "record").map((member) => anonymousMemberFromNode(member, false, context)),
 ];
-export { collectFields, fieldFromNode };
+export { collectFields };
 //# sourceMappingURL=field.js.map

package/dist/gir/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/gir/field.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAehD,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAY,EAAE,CAAC,CAAC;IACvE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC7C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;IAC5C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC;IAC7C,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;IAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,KAAK;CACvB,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,IAAa,EAAE,OAAgB,EAAE,OAAqB,EAAY,EAAE,CAAC,CAAC;IACnG,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;IAC3C,aAAa,EAAE,OAAO;CACzB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAc,EAAE,CAAC;IACxE,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7F,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;CAClG,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAiB,CAAC","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { attr, getChild, getChildren, getDoc, intAttr, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\ntype GirField = {\n    name: string;\n    doc: string | undefined;\n    type: TypeId | undefined;\n    cType: string | undefined;\n    readable: boolean;\n    writable: boolean;\n    private: boolean;\n    bits: number | undefined;\n    inlineMembers: GirField[] | undefined;\n    inlineIsUnion: boolean;\n};\n\nconst fieldFromNode = (node: RawNode, context: ParseContext): GirField => ({\n    name: nameAttr(node),\n    doc: getDoc(node),\n    type: typeRefFromNode(node, context),\n    cType: attr(getChild(node, \"type\"), \"c:type\"),\n    readable: isAttrTrue(node, \"readable\", true),\n    writable: isAttrTrue(node, \"writable\", false),\n    private: isAttrTrue(node, \"private\", false),\n    bits: intAttr(node, \"bits\"),\n    inlineMembers: undefined,\n    inlineIsUnion: false,\n});\n\nconst anonymousMemberFromNode = (node: RawNode, isUnion: boolean, context: ParseContext): GirField => ({\n    name: nameAttr(node),\n    doc: getDoc(node),\n    type: undefined,\n    cType: undefined,\n    readable: false,\n    writable: false,\n    private: true,\n    bits: undefined,\n    inlineMembers: collectFields(node, context),\n    inlineIsUnion: isUnion,\n});\n\nconst collectFields = (node: RawNode, context: ParseContext): GirField[] => [\n    ...getChildren(node, \"field\").map((field) => fieldFromNode(field, context)),\n    ...getChildren(node, \"union\").map((member) => anonymousMemberFromNode(member, true, context)),\n    ...getChildren(node, \"record\").map((member) => anonymousMemberFromNode(member, false, context)),\n];\n\nexport { collectFields, fieldFromNode, type GirField };\n"]}
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/gir/field.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA+BhD,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAY,EAAE,CAAC,CAAC;IACvE,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC;IACpC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC7C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;IAC5C,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC;IAC7C,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;IAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,KAAK;CACvB,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,IAAa,EAAE,OAAgB,EAAE,OAAqB,EAAY,EAAE,CAAC,CAAC;IACnG,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC3B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;IAC3C,aAAa,EAAE,OAAO;CACzB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAc,EAAE,CAAC;IACxE,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7F,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;CAClG,CAAC;AAEF,OAAO,EAAE,aAAa,EAAiB,CAAC","sourcesContent":["import type { ParseContext, TypeId } from \"./type-id.js\";\nimport { documentedFromNode, type GirAnnotations } from \"./annotations.js\";\nimport { attr, getChild, getChildren, intAttr, isAttrTrue, type RawNode } from \"./parse.js\";\nimport { typeRefFromNode } from \"./type-ref.js\";\n\n/**\n * One slot in a record or union layout: a named field, or a nested struct or union\n * whose own members are laid out inline.\n */\ntype GirField = {\n    /** Field name as GIR spells it. */\n    name: string;\n    /** Documentation prose from GIR, emitted as the field accessor's JSDoc. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the field. */\n    annotations: GirAnnotations;\n    /** The field's value type, absent for a nested struct or union and for one GIR leaves undeclared. */\n    type: TypeId | undefined;\n    /** The C type spelled on the field, which decides whether it is read through a pointer. */\n    cType: string | undefined;\n    /** Whether the field can be read; one that is neither readable nor writable gets no accessor at all. */\n    readable: boolean;\n    /** Whether the field can be written, which is what earns it a setter alongside its getter. */\n    writable: boolean;\n    /** Whether the field is private to the library, as every nested struct or union is. */\n    private: boolean;\n    /** Width in bits when the field is a C bitfield member. */\n    bits: number | undefined;\n    /** Members of a nested struct or union, absent for a named field. */\n    inlineMembers: GirField[] | undefined;\n    /** Whether {@link GirField.inlineMembers} overlap as a union rather than following one another as a struct. */\n    isInlineUnion: boolean;\n};\n\nconst fieldFromNode = (node: RawNode, context: ParseContext): GirField => ({\n    ...documentedFromNode(node),\n    type: typeRefFromNode(node, context),\n    cType: attr(getChild(node, \"type\"), \"c:type\"),\n    readable: isAttrTrue(node, \"readable\", true),\n    writable: isAttrTrue(node, \"writable\", false),\n    private: isAttrTrue(node, \"private\", false),\n    bits: intAttr(node, \"bits\"),\n    inlineMembers: undefined,\n    isInlineUnion: false,\n});\n\nconst anonymousMemberFromNode = (node: RawNode, isUnion: boolean, context: ParseContext): GirField => ({\n    ...documentedFromNode(node),\n    type: undefined,\n    cType: undefined,\n    readable: false,\n    writable: false,\n    private: true,\n    bits: undefined,\n    inlineMembers: collectFields(node, context),\n    isInlineUnion: isUnion,\n});\n\nconst collectFields = (node: RawNode, context: ParseContext): GirField[] => [\n    ...getChildren(node, \"field\").map((field) => fieldFromNode(field, context)),\n    ...getChildren(node, \"union\").map((member) => anonymousMemberFromNode(member, true, context)),\n    ...getChildren(node, \"record\").map((member) => anonymousMemberFromNode(member, false, context)),\n];\n\nexport { collectFields, type GirField };\n"]}

package/dist/gir/function.d.ts

@@ -1,17 +1,32 @@
+import type { GirAnnotations } from "./annotations.js";
 import type { ParseContext } from "./type-id.js";
 import { type GirParameter, type GirReturnValue } from "./parameter.js";
 import { type RawNode } from "./parse.js";
+/** A callable declared by a GIR namespace, class, or record: a function, a method, or a constructor. */
 type GirFunction = {
+    /** Local name within its owner, taken from the `shadows` annotation when the callable has one. */
     name: string;
+    /** Documentation text carried by the GIR node. */
     doc: string | undefined;
+    /** Release and deprecation annotations GIR carries on the callable. */
+    annotations: GirAnnotations;
+    /** C symbol the callable is invoked through. */
     cIdentifier: string | undefined;
+    /** Whether the C function takes a trailing `GError` out parameter and can fail. */
     throws: boolean;
+    /** Whether the GIR marks the callable as introspectable, and so bindable. */
     introspectable: boolean;
+    /** Qualified `Type.member` the GIR redirects the callable to, from its `moved-to` annotation. */
     movedTo: string | undefined;
+    /** Name of the callable that shadows this one, from the GIR's `shadowed-by` annotation. */
     shadowedBy: string | undefined;
+    /** Name of the callable that completes this asynchronous one, from the GIR's `glib:finish-func`. */
     finishFunc: string | undefined;
+    /** The instance the callable is invoked on, absent for constructors and namespace-level functions. */
     instance: GirParameter | undefined;
+    /** Parameters other than the instance one, in declaration order. */
     parameters: GirParameter[];
+    /** What the callable returns, with its transfer and nullability. */
     returnValue: GirReturnValue;
 };
 declare const functionFromNode: (node: RawNode, context: ParseContext) => GirFunction;

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

@@ -1 +1 @@
-{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/gir/function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAoC,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,EAAE,cAAc,CAAC;CAC/B,CAAC;AAoBF,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAYhE,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/gir/function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAoC,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,wGAAwG;AACxG,KAAK,WAAW,GAAG;IACf,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,uEAAuE;IACvE,WAAW,EAAE,cAAc,CAAC;IAC5B,gDAAgD;IAChD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,cAAc,EAAE,OAAO,CAAC;IACxB,iGAAiG;IACjG,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,2FAA2F;IAC3F,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oGAAoG;IACpG,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sGAAsG;IACtG,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,oEAAoE;IACpE,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,oEAAoE;IACpE,WAAW,EAAE,cAAc,CAAC;CAC/B,CAAC;AAoBF,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAYhE,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/gir/function.js.map

@@ -1 +1 @@
-{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/gir/function.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAA0C,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAgB1D,MAAM,eAAe,GAAG,CAAC,UAA0B,EAAE,KAAe,EAAQ,EAAE;IAC1E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC9B,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,EAAe,EAAe,EAAE;IAC1D,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sCAAsC,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IAEpH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAe,EAAE;IAC3E,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAElF,OAAO,oBAAoB,CAAC;QACxB,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACvD,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC/B,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACrC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAC1C,QAAQ,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC;KAC9F,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAoB,CAAC","sourcesContent":["import type { ParseContext } from \"./type-id.js\";\nimport { PARAMETERS_MISSING_NULLABLE_ANNOTATION } from \"./nullable-overrides.js\";\nimport { type GirParameter, type GirReturnValue, parameterFromNode, parseCallable } from \"./parameter.js\";\nimport { attr, getChild, type RawNode } from \"./parse.js\";\n\ntype GirFunction = {\n    name: string;\n    doc: string | undefined;\n    cIdentifier: string | undefined;\n    throws: boolean;\n    introspectable: boolean;\n    movedTo: string | undefined;\n    shadowedBy: string | undefined;\n    finishFunc: string | undefined;\n    instance: GirParameter | undefined;\n    parameters: GirParameter[];\n    returnValue: GirReturnValue;\n};\n\nconst relaxParameters = (parameters: GirParameter[], names: string[]): void => {\n    for (const parameter of parameters) {\n        if (names.includes(parameter.name)) {\n            parameter.nullable = true;\n        }\n    }\n};\n\nconst relaxMissingNullable = (fn: GirFunction): GirFunction => {\n    const names = fn.cIdentifier === undefined ? undefined : PARAMETERS_MISSING_NULLABLE_ANNOTATION.get(fn.cIdentifier);\n\n    if (names !== undefined) {\n        relaxParameters(fn.parameters, names);\n    }\n\n    return fn;\n};\n\nconst functionFromNode = (node: RawNode, context: ParseContext): GirFunction => {\n    const instanceNode = getChild(getChild(node, \"parameters\"), \"instance-parameter\");\n\n    return relaxMissingNullable({\n        ...parseCallable(node, context),\n        name: attr(node, \"shadows\") ?? attr(node, \"name\") ?? \"\",\n        cIdentifier: attr(node, \"c:identifier\"),\n        movedTo: attr(node, \"moved-to\"),\n        shadowedBy: attr(node, \"shadowed-by\"),\n        finishFunc: attr(node, \"glib:finish-func\"),\n        instance: instanceNode === undefined ? undefined : parameterFromNode(instanceNode, context),\n    });\n};\n\nexport { functionFromNode, type GirFunction };\n"]}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/gir/function.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAA0C,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AA8B1D,MAAM,eAAe,GAAG,CAAC,UAA0B,EAAE,KAAe,EAAQ,EAAE;IAC1E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC9B,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,EAAe,EAAe,EAAE;IAC1D,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sCAAsC,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IAEpH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,OAAqB,EAAe,EAAE;IAC3E,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAElF,OAAO,oBAAoB,CAAC;QACxB,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACvD,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC/B,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACrC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAC1C,QAAQ,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC;KAC9F,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAoB,CAAC","sourcesContent":["import type { GirAnnotations } from \"./annotations.js\";\nimport type { ParseContext } from \"./type-id.js\";\nimport { PARAMETERS_MISSING_NULLABLE_ANNOTATION } from \"./nullable-overrides.js\";\nimport { type GirParameter, type GirReturnValue, parameterFromNode, parseCallable } from \"./parameter.js\";\nimport { attr, getChild, type RawNode } from \"./parse.js\";\n\n/** A callable declared by a GIR namespace, class, or record: a function, a method, or a constructor. */\ntype GirFunction = {\n    /** Local name within its owner, taken from the `shadows` annotation when the callable has one. */\n    name: string;\n    /** Documentation text carried by the GIR node. */\n    doc: string | undefined;\n    /** Release and deprecation annotations GIR carries on the callable. */\n    annotations: GirAnnotations;\n    /** C symbol the callable is invoked through. */\n    cIdentifier: string | undefined;\n    /** Whether the C function takes a trailing `GError` out parameter and can fail. */\n    throws: boolean;\n    /** Whether the GIR marks the callable as introspectable, and so bindable. */\n    introspectable: boolean;\n    /** Qualified `Type.member` the GIR redirects the callable to, from its `moved-to` annotation. */\n    movedTo: string | undefined;\n    /** Name of the callable that shadows this one, from the GIR's `shadowed-by` annotation. */\n    shadowedBy: string | undefined;\n    /** Name of the callable that completes this asynchronous one, from the GIR's `glib:finish-func`. */\n    finishFunc: string | undefined;\n    /** The instance the callable is invoked on, absent for constructors and namespace-level functions. */\n    instance: GirParameter | undefined;\n    /** Parameters other than the instance one, in declaration order. */\n    parameters: GirParameter[];\n    /** What the callable returns, with its transfer and nullability. */\n    returnValue: GirReturnValue;\n};\n\nconst relaxParameters = (parameters: GirParameter[], names: string[]): void => {\n    for (const parameter of parameters) {\n        if (names.includes(parameter.name)) {\n            parameter.nullable = true;\n        }\n    }\n};\n\nconst relaxMissingNullable = (fn: GirFunction): GirFunction => {\n    const names = fn.cIdentifier === undefined ? undefined : PARAMETERS_MISSING_NULLABLE_ANNOTATION.get(fn.cIdentifier);\n\n    if (names !== undefined) {\n        relaxParameters(fn.parameters, names);\n    }\n\n    return fn;\n};\n\nconst functionFromNode = (node: RawNode, context: ParseContext): GirFunction => {\n    const instanceNode = getChild(getChild(node, \"parameters\"), \"instance-parameter\");\n\n    return relaxMissingNullable({\n        ...parseCallable(node, context),\n        name: attr(node, \"shadows\") ?? attr(node, \"name\") ?? \"\",\n        cIdentifier: attr(node, \"c:identifier\"),\n        movedTo: attr(node, \"moved-to\"),\n        shadowedBy: attr(node, \"shadowed-by\"),\n        finishFunc: attr(node, \"glib:finish-func\"),\n        instance: instanceNode === undefined ? undefined : parameterFromNode(instanceNode, context),\n    });\n};\n\nexport { functionFromNode, type GirFunction };\n"]}

package/dist/gir/libraries.d.ts

@@ -1,7 +1,5 @@
 /** A `libraries` config value: an explicit list, `"*"` for everything installed, or absent for the default. */
-type LibrarySelection = typeof LIBRARIES_WILDCARD | string[] | undefined;
-/** The `libraries` value that stands for every GIR library installed on the search path. */
-declare const LIBRARIES_WILDCARD = "*";
+type LibrarySelection = "*" | string[] | undefined;
 /**
  * Expands a `libraries` config value into the GIR identifiers to generate from: `"Gtk-4.0"` alone when
  * nothing is configured, everything installed for `"*"`, and otherwise the given list with `"Gtk-4.0"`

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

@@ -1 +1 @@
-{"version":3,"file":"libraries.d.ts","sourceRoot":"","sources":["../../src/gir/libraries.ts"],"names":[],"mappings":"AAIA,+GAA+G;AAC/G,KAAK,gBAAgB,GAAG,OAAO,kBAAkB,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAEzE,4FAA4F;AAC5F,QAAA,MAAM,kBAAkB,MAAM,CAAC;AAK/B;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,GAAI,WAAW,gBAAgB,EAAE,SAAS,MAAM,EAAE,KAAG,MAAM,EAqBhF,CAAC;AA4CF;;;GAGG;AACH,QAAA,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,MAAM,EAQxD,CAAC;AAkBF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"libraries.d.ts","sourceRoot":"","sources":["../../src/gir/libraries.ts"],"names":[],"mappings":"AAaA,+GAA+G;AAC/G,KAAK,gBAAgB,GAAG,GAAG,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAOnD;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,GAAI,WAAW,gBAAgB,EAAE,SAAS,MAAM,EAAE,KAAG,MAAM,EAqBhF,CAAC;AA4CF;;;GAGG;AACH,QAAA,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,MAAM,EAQxD,CAAC;AAkBF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/gir/libraries.js

@@ -1,6 +1,5 @@
 import { sortStrings } from "@gtkx/utils";
 import { readdirSync } from "node:fs";
-/** The `libraries` value that stands for every GIR library installed on the search path. */
 const LIBRARIES_WILDCARD = "*";
 const GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\d+(?:\.\d+)*$/;
 const DEFAULT_LIBRARIES = ["Gtk-4.0"];

package/dist/gir/libraries.js.map

@@ -1 +1 @@
-{"version":3,"file":"libraries.js","sourceRoot":"","sources":["../../src/gir/libraries.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport { readdirSync } from \"node:fs\";\n\ntype GirNamespace = { name: string; version: string; identifier: string };\n/** A `libraries` config value: an explicit list, `\"*\"` for everything installed, or absent for the default. */\ntype LibrarySelection = typeof LIBRARIES_WILDCARD | string[] | undefined;\n\n/** The `libraries` value that stands for every GIR library installed on the search path. */\nconst LIBRARIES_WILDCARD = \"*\";\nconst GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\\d+(?:\\.\\d+)*$/;\nconst DEFAULT_LIBRARIES: string[] = [\"Gtk-4.0\"];\nconst GIR_FILE_SUFFIX = \".gir\";\n\n/**\n * Expands a `libraries` config value into the GIR identifiers to generate from: `\"Gtk-4.0\"` alone when\n * nothing is configured, everything installed for `\"*\"`, and otherwise the given list with `\"Gtk-4.0\"`\n * prepended unless it already names a Gtk version.\n *\n * @throws If `\"*\"` matched no `.gir` file anywhere on the GIR path.\n */\nconst resolveLibraries = (libraries: LibrarySelection, girPath: string[]): string[] => {\n    if (libraries === undefined) {\n        return [...DEFAULT_LIBRARIES];\n    }\n\n    if (libraries === LIBRARIES_WILDCARD) {\n        const discovered = discoverGirNamespaces(girPath);\n\n        if (discovered.length === 0) {\n            throw new Error(\n                `gtkx.config.ts: \\`libraries: \"*\"\\` matched no .gir files in [${girPath.join(\", \")}]. ` +\n                \"Install gobject-introspection data packages, or list the libraries explicitly.\",\n            );\n        }\n\n        return discovered;\n    }\n\n    const hasGtk = libraries.some((library) => library.startsWith(\"Gtk-\"));\n\n    return [...new Set([...(hasGtk ? [] : DEFAULT_LIBRARIES), ...libraries])];\n};\n\nconst readDirEntries = (dir: string): string[] => {\n    try {\n        return readdirSync(dir);\n    } catch {\n        return [];\n    }\n};\n\nconst parseGirNamespace = (entry: string): GirNamespace | undefined => {\n    if (!entry.endsWith(GIR_FILE_SUFFIX)) {\n        return undefined;\n    }\n\n    const identifier = entry.slice(0, -GIR_FILE_SUFFIX.length);\n\n    if (!GIR_LIBRARY_PATTERN.test(identifier)) {\n        return undefined;\n    }\n\n    const separator = identifier.indexOf(\"-\");\n\n    return { name: identifier.slice(0, separator), version: identifier.slice(separator + 1), identifier };\n};\n\nconst recordHighest = (highestByName: Map<string, GirNamespace>, parsed: GirNamespace): void => {\n    const existing = highestByName.get(parsed.name);\n\n    if (existing === undefined || compareVersions(parsed.version, existing.version) > 0) {\n        highestByName.set(parsed.name, parsed);\n    }\n};\n\nconst collectDirNamespaces = (highestByName: Map<string, GirNamespace>, dir: string): void => {\n    for (const entry of readDirEntries(dir)) {\n        const parsed = parseGirNamespace(entry);\n\n        if (parsed !== undefined) {\n            recordHighest(highestByName, parsed);\n        }\n    }\n};\n\n/**\n * Every GIR library installed on the search path, as sorted `Name-Version` identifiers. A namespace found\n * in more than one version contributes only its highest, and unreadable directories are skipped.\n */\nconst discoverGirNamespaces = (girPath: string[]): string[] => {\n    const highestByName: Map<string, GirNamespace> = new Map();\n\n    for (const dir of girPath) {\n        collectDirNamespaces(highestByName, dir);\n    }\n\n    return sortStrings(highestByName.values().map(({ identifier }) => identifier));\n};\n\nconst compareVersions = (a: string, b: string): number => {\n    const aParts = a.split(\".\");\n    const bParts = b.split(\".\");\n    const length = Math.max(aParts.length, bParts.length);\n\n    for (let index = 0; index < length; index += 1) {\n        const difference = Number(aParts[index] ?? 0) - Number(bParts[index] ?? 0);\n\n        if (difference !== 0) {\n            return difference;\n        }\n    }\n\n    return 0;\n};\n\nexport { resolveLibraries, discoverGirNamespaces, type LibrarySelection };\n"]}
+{"version":3,"file":"libraries.js","sourceRoot":"","sources":["../../src/gir/libraries.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport { readdirSync } from \"node:fs\";\n\n/** A namespace found on the GIR path, taken from the name of its `.gir` file. */\ntype GirNamespace = {\n    /** Namespace the file describes, such as `Gtk`. */\n    name: string;\n    /** API version the file describes, such as `4.0`. */\n    version: string;\n    /** Name and version joined the way a `libraries` entry spells them, such as `Gtk-4.0`. */\n    identifier: string;\n};\n\n/** A `libraries` config value: an explicit list, `\"*\"` for everything installed, or absent for the default. */\ntype LibrarySelection = \"*\" | string[] | undefined;\n\nconst LIBRARIES_WILDCARD = \"*\";\nconst GIR_LIBRARY_PATTERN = /^[A-Za-z][A-Za-z0-9]*-\\d+(?:\\.\\d+)*$/;\nconst DEFAULT_LIBRARIES: string[] = [\"Gtk-4.0\"];\nconst GIR_FILE_SUFFIX = \".gir\";\n\n/**\n * Expands a `libraries` config value into the GIR identifiers to generate from: `\"Gtk-4.0\"` alone when\n * nothing is configured, everything installed for `\"*\"`, and otherwise the given list with `\"Gtk-4.0\"`\n * prepended unless it already names a Gtk version.\n *\n * @throws If `\"*\"` matched no `.gir` file anywhere on the GIR path.\n */\nconst resolveLibraries = (libraries: LibrarySelection, girPath: string[]): string[] => {\n    if (libraries === undefined) {\n        return [...DEFAULT_LIBRARIES];\n    }\n\n    if (libraries === LIBRARIES_WILDCARD) {\n        const discovered = discoverGirNamespaces(girPath);\n\n        if (discovered.length === 0) {\n            throw new Error(\n                `gtkx.config.ts: \\`libraries: \"*\"\\` matched no .gir files in [${girPath.join(\", \")}]. ` +\n                \"Install gobject-introspection data packages, or list the libraries explicitly.\",\n            );\n        }\n\n        return discovered;\n    }\n\n    const hasGtk = libraries.some((library) => library.startsWith(\"Gtk-\"));\n\n    return [...new Set([...(hasGtk ? [] : DEFAULT_LIBRARIES), ...libraries])];\n};\n\nconst readDirEntries = (dir: string): string[] => {\n    try {\n        return readdirSync(dir);\n    } catch {\n        return [];\n    }\n};\n\nconst parseGirNamespace = (entry: string): GirNamespace | undefined => {\n    if (!entry.endsWith(GIR_FILE_SUFFIX)) {\n        return undefined;\n    }\n\n    const identifier = entry.slice(0, -GIR_FILE_SUFFIX.length);\n\n    if (!GIR_LIBRARY_PATTERN.test(identifier)) {\n        return undefined;\n    }\n\n    const separator = identifier.indexOf(\"-\");\n\n    return { name: identifier.slice(0, separator), version: identifier.slice(separator + 1), identifier };\n};\n\nconst recordHighest = (highestByName: Map<string, GirNamespace>, parsed: GirNamespace): void => {\n    const existing = highestByName.get(parsed.name);\n\n    if (existing === undefined || compareVersions(parsed.version, existing.version) > 0) {\n        highestByName.set(parsed.name, parsed);\n    }\n};\n\nconst collectDirNamespaces = (highestByName: Map<string, GirNamespace>, dir: string): void => {\n    for (const entry of readDirEntries(dir)) {\n        const parsed = parseGirNamespace(entry);\n\n        if (parsed !== undefined) {\n            recordHighest(highestByName, parsed);\n        }\n    }\n};\n\n/**\n * Every GIR library installed on the search path, as sorted `Name-Version` identifiers. A namespace found\n * in more than one version contributes only its highest, and unreadable directories are skipped.\n */\nconst discoverGirNamespaces = (girPath: string[]): string[] => {\n    const highestByName: Map<string, GirNamespace> = new Map();\n\n    for (const dir of girPath) {\n        collectDirNamespaces(highestByName, dir);\n    }\n\n    return sortStrings(highestByName.values().map(({ identifier }) => identifier));\n};\n\nconst compareVersions = (a: string, b: string): number => {\n    const aParts = a.split(\".\");\n    const bParts = b.split(\".\");\n    const length = Math.max(aParts.length, bParts.length);\n\n    for (let index = 0; index < length; index += 1) {\n        const difference = Number(aParts[index] ?? 0) - Number(bParts[index] ?? 0);\n\n        if (difference !== 0) {\n            return difference;\n        }\n    }\n\n    return 0;\n};\n\nexport { resolveLibraries, discoverGirNamespaces, type LibrarySelection };\n"]}

package/dist/gir/library.d.ts

@@ -1,8 +1,19 @@
 import type { TypeId } from "./type-id.js";
 import type { GirType } from "./type.js";
 import { type GirNamespace } from "./namespace.js";
+/**
+ * The parsed GIR universe: every requested namespace plus everything those namespaces include,
+ * with types resolvable across namespace boundaries.
+ */
 declare class Library {
     private static drive;
+    /**
+     * Parses the named GIR libraries along with every namespace they transitively include.
+     *
+     * @param libraries GIR identifiers to load, such as `Gtk-4.0`.
+     * @param girPath Directories searched, in order, for each `.gir` file.
+     * @returns A library holding every namespace that was parsed.
+     */
     static load(libraries: string[], girPath: string[]): Library;
     private namespacesByName;
     private namespaceById;
@@ -10,6 +21,7 @@ declare class Library {
     private nsIdByName;
     private typeTables;
     private girFilesValue;
+    /** Creates a library with no namespaces loaded; {@link Library.load} builds a populated one. */
     constructor();
     private ensureNsId;
     private registerNamespace;
@@ -30,13 +42,37 @@ declare class Library {
     private addValueDeclarations;
     private processIdentifier;
     private discoverNamespaces;
+    /** The loaded namespaces, keyed by their GIR name such as `Gtk`. */
     get namespaces(): Map<string, GirNamespace>;
+    /** Paths of the `.gir` files that were read, in the order they were discovered. */
     get girFiles(): string[];
+    /**
+     * Reads the type a {@link TypeId} points at.
+     *
+     * @param tid The type id to dereference.
+     * @returns The parsed type, or `undefined` when nothing has been parsed into that slot.
+     */
     typeFor(tid: TypeId): GirType | undefined;
+    /**
+     * Reads the name a {@link TypeId} was registered under.
+     *
+     * @param tid The type id to name.
+     * @returns The namespace and type name, or `undefined` for an anonymous type.
+     */
     nameFor(tid: TypeId): {
+        /** GIR namespace to qualify the type with, such as `Gtk`. */
         namespaceName: string;
+        /** Unqualified type name as GIR declares it, such as `Widget`. */
         typeName: string;
     } | undefined;
+    /**
+     * Looks up a type by the name a GIR file writes, resolving an unqualified name against the
+     * namespace it appears in and a `Namespace.Type` name against the loaded namespaces.
+     *
+     * @param currentNamespaceName Namespace the name is written in.
+     * @param name Type name, optionally qualified with a namespace prefix.
+     * @returns The parsed type, or `undefined` when the name is unknown or only a forward reference to it exists.
+     */
     resolveType(currentNamespaceName: string, name: string): GirType | undefined;
 }
 export { Library };

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

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/gir/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqD,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAEH,KAAK,YAAY,EAIpB,MAAM,gBAAgB,CAAC;AAwCxB,cAAM,OAAO;IACT,OAAO,CAAC,MAAM,CAAC,KAAK;IAcpB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO;IAO5D,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,aAAa,CAAgB;;IAQrC,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,kBAAkB;IAoB1B,IAAW,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAEjD;IAED,IAAW,QAAQ,IAAI,MAAM,EAAE,CAE9B;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAW7E,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAsB/E;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/gir/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqD,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAEH,KAAK,YAAY,EAIpB,MAAM,gBAAgB,CAAC;AAkDxB;;;GAGG;AACH,cAAM,OAAO;IACT,OAAO,CAAC,MAAM,CAAC,KAAK;IAcpB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO;IAO5D,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,aAAa,CAAgB;IAErC,gGAAgG;;IAOhG,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,kBAAkB;IAoB1B,oEAAoE;IACpE,IAAW,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAEjD;IAED,mFAAmF;IACnF,IAAW,QAAQ,IAAI,MAAM,EAAE,CAE9B;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIzC;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAClB,6DAA6D;QAC7D,aAAa,EAAE,MAAM,CAAC;QACtB,kEAAkE;QAClE,QAAQ,EAAE,MAAM,CAAC;KACpB,GAAG,SAAS;IAWb;;;;;;;OAOG;IACH,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAsB/E;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/gir/library.js

@@ -24,6 +24,10 @@ const locateGirFile = (identifier, girPath) => {
     const tried = girPath.map((directory) => join(directory, filename)).join(", ");
     throw new Error(`GIR file ${filename} not found on girPath. Tried: ${tried}`);
 };
+/**
+ * The parsed GIR universe: every requested namespace plus everything those namespaces include,
+ * with types resolvable across namespace boundaries.
+ */
 class Library {
     static drive(library, libraries, girPath) {
         const { discovered, girFiles } = library.discoverNamespaces(libraries, girPath);
@@ -35,6 +39,13 @@ class Library {
         }
         library.girFilesValue = girFiles;
     }
+    /**
+     * Parses the named GIR libraries along with every namespace they transitively include.
+     *
+     * @param libraries GIR identifiers to load, such as `Gtk-4.0`.
+     * @param girPath Directories searched, in order, for each `.gir` file.
+     * @returns A library holding every namespace that was parsed.
+     */
     static load(libraries, girPath) {
         const library = new Library();
         this.drive(library, libraries, girPath);
@@ -46,6 +57,7 @@ class Library {
     nsIdByName = new Map();
     typeTables = [];
     girFilesValue = [];
+    /** Creates a library with no namespaces loaded; {@link Library.load} builds a populated one. */
     constructor() {
         this.typeTables[INTERNAL_NS_ID] = { types: [], names: [], index: new Map() };
         this.namespaceById[INTERNAL_NS_ID] = undefined;
@@ -204,15 +216,29 @@ class Library {
         }
         return { discovered, girFiles };
     }
+    /** The loaded namespaces, keyed by their GIR name such as `Gtk`. */
     get namespaces() {
         return this.namespacesByName;
     }
+    /** Paths of the `.gir` files that were read, in the order they were discovered. */
     get girFiles() {
         return this.girFilesValue;
     }
+    /**
+     * Reads the type a {@link TypeId} points at.
+     *
+     * @param tid The type id to dereference.
+     * @returns The parsed type, or `undefined` when nothing has been parsed into that slot.
+     */
     typeFor(tid) {
         return this.typeTables[tid.nsId]?.types[tid.id];
     }
+    /**
+     * Reads the name a {@link TypeId} was registered under.
+     *
+     * @param tid The type id to name.
+     * @returns The namespace and type name, or `undefined` for an anonymous type.
+     */
     nameFor(tid) {
         const typeName = this.typeTables[tid.nsId]?.names[tid.id];
         const namespaceName = this.nsNameById[tid.nsId];
@@ -221,6 +247,14 @@ class Library {
         }
         return { namespaceName, typeName };
     }
+    /**
+     * Looks up a type by the name a GIR file writes, resolving an unqualified name against the
+     * namespace it appears in and a `Namespace.Type` name against the loaded namespaces.
+     *
+     * @param currentNamespaceName Namespace the name is written in.
+     * @param name Type name, optionally qualified with a namespace prefix.
+     * @returns The parsed type, or `undefined` when the name is unknown or only a forward reference to it exists.
+     */
     resolveType(currentNamespaceName, name) {
         const currentNsId = this.nsIdByName.get(currentNamespaceName);
         if (currentNsId === undefined) {

package/dist/gir/library.js.map

@@ -1 +1 @@
-{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/gir/library.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { PrimitiveCategory } from \"./primitives.js\";\nimport type { CArrayType, HashTableType, ListType, ParseContext, TypeId } from \"./type-id.js\";\nimport type { GirType } from \"./type.js\";\nimport { callbackFromNode } from \"./callback.js\";\nimport {\n    createNamespaceShell,\n    type GirNamespace,\n    type NamespaceHeader,\n    parseNamespaceHeader,\n    populateNamespaceBody,\n} from \"./namespace.js\";\nimport { parseGirFile, type RawNode } from \"./parse.js\";\nimport { splitOptionalNamespace } from \"./type-ref.js\";\n\ntype TypeTable = {\n    types: (GirType | undefined)[];\n    names: (string | undefined)[];\n    index: Map<string, number>;\n};\n\ntype DiscoveredNamespace = { header: NamespaceHeader; shell: GirNamespace };\n\nconst INTERNAL_NS_ID = 0;\n\nconst readRepositoryNode = (path: string): RawNode => {\n    const root = parseGirFile(path);\n    const repository = root.repository;\n\n    if (typeof repository !== \"object\" || repository === null) {\n        throw new Error(`GIR file at ${path} has no <repository> root`);\n    }\n\n    return repository as RawNode;\n};\n\nconst locateGirFile = (identifier: string, girPath: string[]): string => {\n    const filename = `${identifier}.gir`;\n\n    for (const directory of girPath) {\n        const candidate = join(directory, filename);\n\n        if (existsSync(candidate)) {\n            return candidate;\n        }\n    }\n\n    const tried = girPath.map((directory) => join(directory, filename)).join(\", \");\n    throw new Error(`GIR file ${filename} not found on girPath. Tried: ${tried}`);\n};\n\nclass Library {\n    private static drive(library: Library, libraries: string[], girPath: string[]): void {\n        const { discovered, girFiles } = library.discoverNamespaces(libraries, girPath);\n\n        for (const { header, shell } of discovered) {\n            populateNamespaceBody(shell, header.namespaceNode, library.parseContext(shell.id));\n        }\n\n        for (const { shell } of discovered) {\n            library.addDeclarations(shell);\n        }\n\n        library.girFilesValue = girFiles;\n    }\n\n    static load(libraries: string[], girPath: string[]): Library {\n        const library = new Library();\n        this.drive(library, libraries, girPath);\n\n        return library;\n    }\n\n    private namespacesByName: Map<string, GirNamespace> = new Map();\n    private namespaceById: (GirNamespace | undefined)[] = [];\n    private nsNameById: string[] = [];\n    private nsIdByName: Map<string, number> = new Map();\n    private typeTables: TypeTable[] = [];\n    private girFilesValue: string[] = [];\n\n    constructor() {\n        this.typeTables[INTERNAL_NS_ID] = { types: [], names: [], index: new Map() };\n        this.namespaceById[INTERNAL_NS_ID] = undefined;\n        this.nsNameById[INTERNAL_NS_ID] = \"$internal\";\n    }\n\n    private ensureNsId(name: string): number {\n        const existing = this.nsIdByName.get(name);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        const nsId = this.typeTables.length;\n        this.typeTables[nsId] = { types: [], names: [], index: new Map() };\n        this.namespaceById[nsId] = undefined;\n        this.nsNameById[nsId] = name;\n        this.nsIdByName.set(name, nsId);\n\n        return nsId;\n    }\n\n    private registerNamespace(header: NamespaceHeader): GirNamespace {\n        const nsId = this.ensureNsId(header.name);\n        const shell = createNamespaceShell(header, nsId);\n        this.namespaceById[nsId] = shell;\n        this.namespacesByName.set(header.name, shell);\n\n        return shell;\n    }\n\n    private namespaceFor(nsId: number): GirNamespace {\n        const namespace = this.namespaceById[nsId];\n\n        if (namespace === undefined) {\n            throw new Error(`No namespace registered for type table id ${String(nsId)}`);\n        }\n\n        return namespace;\n    }\n\n    private typeTableFor(nsId: number): TypeTable {\n        const typeTable = this.typeTables[nsId];\n\n        if (typeTable === undefined) {\n            throw new Error(`No type table for namespace id ${String(nsId)}`);\n        }\n\n        return typeTable;\n    }\n\n    private insertIntoTypeTable(\n        typeTable: TypeTable,\n        slot: { type: GirType | undefined; indexKey?: string; displayName?: string },\n    ): number {\n        const id = typeTable.types.length;\n        typeTable.types.push(slot.type);\n        typeTable.names.push(slot.displayName);\n\n        if (slot.indexKey !== undefined) {\n            typeTable.index.set(slot.indexKey, id);\n        }\n\n        return id;\n    }\n\n    private resolveTypeId(nsId: number, name: string, type: GirType | undefined): number {\n        const typeTable = this.typeTableFor(nsId);\n        const existing = typeTable.index.get(name);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        return this.insertIntoTypeTable(typeTable, { type, indexKey: name, displayName: name });\n    }\n\n    private addType(nsId: number, name: string, type: GirType): void {\n        this.typeTableFor(nsId).types[this.resolveTypeId(nsId, name, type)] = type;\n    }\n\n    private findType(nsId: number, name: string): TypeId {\n        return { nsId, id: this.resolveTypeId(nsId, name, undefined) };\n    }\n\n    private addAnonymousType(nsId: number, type: GirType): TypeId {\n        const typeTable = this.typeTableFor(nsId);\n        const id = this.insertIntoTypeTable(typeTable, { type });\n\n        return { nsId, id };\n    }\n\n    private findTypeByName(currentNsId: number, name: string): TypeId {\n        const [namespaceName, localName] = splitOptionalNamespace(name);\n        const targetNsId = namespaceName === undefined ? currentNsId : this.ensureNsId(namespaceName);\n\n        return this.findType(targetNsId, localName);\n    }\n\n    private parseContext(nsId: number): ParseContext {\n        const context: ParseContext = {\n            nsId,\n            findType: (name) => this.findTypeByName(nsId, name),\n            addPrimitive: (category) => this.addPrimitive(category),\n            addVarargs: () => this.addVarargs(),\n            addContainer: (type: CArrayType | ListType | HashTableType) => this.addAnonymousType(nsId, type),\n            addAnonymousCallback: (node) =>\n                this.addAnonymousType(nsId, {\n                    kind: \"callback\",\n                    namespace: this.namespaceFor(nsId),\n                    value: callbackFromNode(node, context),\n                }),\n        };\n\n        return context;\n    }\n\n    private addPrimitive(category: PrimitiveCategory): TypeId {\n        return this.findOrAddContainer(`primitive:${category}`, { kind: \"primitive\", category });\n    }\n\n    private addVarargs(): TypeId {\n        return this.findOrAddContainer(\"varargs\", { kind: \"varargs\" });\n    }\n\n    private findOrAddContainer(key: string, type: GirType): TypeId {\n        const typeTable = this.typeTableFor(INTERNAL_NS_ID);\n        const existing = typeTable.index.get(key);\n\n        if (existing !== undefined) {\n            return { nsId: INTERNAL_NS_ID, id: existing };\n        }\n\n        const id = this.insertIntoTypeTable(typeTable, { type, indexKey: key });\n\n        return { nsId: INTERNAL_NS_ID, id };\n    }\n\n    private addDeclarations(shell: GirNamespace): void {\n        this.addClassDeclarations(shell);\n        this.addValueDeclarations(shell);\n    }\n\n    private addClassDeclarations(shell: GirNamespace): void {\n        const nsId = shell.id;\n\n        for (const value of shell.classes) {\n            this.addType(nsId, value.name, { kind: \"class\", namespace: shell, value });\n        }\n\n        for (const value of shell.interfaces) {\n            this.addType(nsId, value.name, { kind: \"interface\", namespace: shell, value });\n        }\n\n        for (const value of shell.records) {\n            this.addType(nsId, value.name, { kind: \"record\", namespace: shell, value });\n        }\n    }\n\n    private addValueDeclarations(shell: GirNamespace): void {\n        const nsId = shell.id;\n\n        for (const value of shell.enums) {\n            this.addType(nsId, value.name, { kind: \"enum\", namespace: shell, value });\n        }\n\n        for (const value of shell.callbacks) {\n            this.addType(nsId, value.name, { kind: \"callback\", namespace: shell, value });\n        }\n\n        for (const alias of shell.aliases) {\n            this.addType(nsId, alias.name, { kind: \"alias\", namespace: shell, value: alias });\n        }\n    }\n\n    private processIdentifier(input: {\n        identifier: string;\n        girPath: string[];\n        seen: Set<string>;\n        queue: string[];\n        girFiles: string[];\n        discovered: DiscoveredNamespace[];\n    }): void {\n        const { identifier, girPath, seen, queue, girFiles, discovered } = input;\n        const namespaceName = identifier.split(\"-\", 1)[0] ?? identifier;\n\n        if (seen.has(namespaceName)) {\n            return;\n        }\n\n        seen.add(namespaceName);\n        const path = locateGirFile(identifier, girPath);\n        girFiles.push(path);\n        const header = parseNamespaceHeader(readRepositoryNode(path));\n        const shell = this.registerNamespace(header);\n        discovered.push({ header, shell });\n\n        for (const include of header.includes) {\n            queue.push(`${include.name}-${include.version}`);\n        }\n    }\n\n    private discoverNamespaces(\n        libraries: string[],\n        girPath: string[],\n    ): { discovered: DiscoveredNamespace[]; girFiles: string[] } {\n        const queue: string[] = [...libraries];\n        const seen: Set<string> = new Set();\n        const discovered: DiscoveredNamespace[] = [];\n        const girFiles: string[] = [];\n\n        while (queue.length > 0) {\n            const identifier = queue.shift();\n\n            if (identifier !== undefined) {\n                this.processIdentifier({ identifier, girPath, seen, queue, girFiles, discovered });\n            }\n        }\n\n        return { discovered, girFiles };\n    }\n\n    public get namespaces(): Map<string, GirNamespace> {\n        return this.namespacesByName;\n    }\n\n    public get girFiles(): string[] {\n        return this.girFilesValue;\n    }\n\n    typeFor(tid: TypeId): GirType | undefined {\n        return this.typeTables[tid.nsId]?.types[tid.id];\n    }\n\n    nameFor(tid: TypeId): { namespaceName: string; typeName: string } | undefined {\n        const typeName = this.typeTables[tid.nsId]?.names[tid.id];\n        const namespaceName = this.nsNameById[tid.nsId];\n\n        if (typeName === undefined || namespaceName === undefined) {\n            return undefined;\n        }\n\n        return { namespaceName, typeName };\n    }\n\n    resolveType(currentNamespaceName: string, name: string): GirType | undefined {\n        const currentNsId = this.nsIdByName.get(currentNamespaceName);\n\n        if (currentNsId === undefined) {\n            return undefined;\n        }\n\n        const [namespaceName, localName] = splitOptionalNamespace(name);\n        const targetNsId = namespaceName === undefined ? currentNsId : this.nsIdByName.get(namespaceName);\n\n        if (targetNsId === undefined) {\n            return undefined;\n        }\n\n        const id = this.typeTableFor(targetNsId).index.get(localName);\n\n        if (id === undefined) {\n            return undefined;\n        }\n\n        return this.typeTableFor(targetNsId).types[id];\n    }\n}\n\nexport { Library };\n"]}
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/gir/library.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { PrimitiveCategory } from \"./primitives.js\";\nimport type { CArrayType, HashTableType, ListType, ParseContext, TypeId } from \"./type-id.js\";\nimport type { GirType } from \"./type.js\";\nimport { callbackFromNode } from \"./callback.js\";\nimport {\n    createNamespaceShell,\n    type GirNamespace,\n    type NamespaceHeader,\n    parseNamespaceHeader,\n    populateNamespaceBody,\n} from \"./namespace.js\";\nimport { parseGirFile, type RawNode } from \"./parse.js\";\nimport { splitOptionalNamespace } from \"./type-ref.js\";\n\n/** The types belonging to one namespace, addressed by the id half of a {@link TypeId}. */\ntype TypeTable = {\n    /** Parsed type in each slot, still `undefined` while only a forward reference to it has been seen. */\n    types: (GirType | undefined)[];\n    /** Declared name of each slot, `undefined` for anonymous types such as containers and inline callbacks. */\n    names: (string | undefined)[];\n    /** Slot id each named type occupies, so repeated references resolve to the same id. */\n    index: Map<string, number>;\n};\n\n/** A namespace whose header has been read and whose shell is registered, before its body is parsed. */\ntype DiscoveredNamespace = {\n    /** Attributes and includes read from the namespace's GIR file. */\n    header: NamespaceHeader;\n    /** Empty namespace registered for the header, populated once every header is known. */\n    shell: GirNamespace;\n};\n\nconst INTERNAL_NS_ID = 0;\n\nconst readRepositoryNode = (path: string): RawNode => {\n    const root = parseGirFile(path);\n    const repository = root.repository;\n\n    if (typeof repository !== \"object\" || repository === null) {\n        throw new Error(`GIR file at ${path} has no <repository> root`);\n    }\n\n    return repository as RawNode;\n};\n\nconst locateGirFile = (identifier: string, girPath: string[]): string => {\n    const filename = `${identifier}.gir`;\n\n    for (const directory of girPath) {\n        const candidate = join(directory, filename);\n\n        if (existsSync(candidate)) {\n            return candidate;\n        }\n    }\n\n    const tried = girPath.map((directory) => join(directory, filename)).join(\", \");\n    throw new Error(`GIR file ${filename} not found on girPath. Tried: ${tried}`);\n};\n\n/**\n * The parsed GIR universe: every requested namespace plus everything those namespaces include,\n * with types resolvable across namespace boundaries.\n */\nclass Library {\n    private static drive(library: Library, libraries: string[], girPath: string[]): void {\n        const { discovered, girFiles } = library.discoverNamespaces(libraries, girPath);\n\n        for (const { header, shell } of discovered) {\n            populateNamespaceBody(shell, header.namespaceNode, library.parseContext(shell.id));\n        }\n\n        for (const { shell } of discovered) {\n            library.addDeclarations(shell);\n        }\n\n        library.girFilesValue = girFiles;\n    }\n\n    /**\n     * Parses the named GIR libraries along with every namespace they transitively include.\n     *\n     * @param libraries GIR identifiers to load, such as `Gtk-4.0`.\n     * @param girPath Directories searched, in order, for each `.gir` file.\n     * @returns A library holding every namespace that was parsed.\n     */\n    static load(libraries: string[], girPath: string[]): Library {\n        const library = new Library();\n        this.drive(library, libraries, girPath);\n\n        return library;\n    }\n\n    private namespacesByName: Map<string, GirNamespace> = new Map();\n    private namespaceById: (GirNamespace | undefined)[] = [];\n    private nsNameById: string[] = [];\n    private nsIdByName: Map<string, number> = new Map();\n    private typeTables: TypeTable[] = [];\n    private girFilesValue: string[] = [];\n\n    /** Creates a library with no namespaces loaded; {@link Library.load} builds a populated one. */\n    constructor() {\n        this.typeTables[INTERNAL_NS_ID] = { types: [], names: [], index: new Map() };\n        this.namespaceById[INTERNAL_NS_ID] = undefined;\n        this.nsNameById[INTERNAL_NS_ID] = \"$internal\";\n    }\n\n    private ensureNsId(name: string): number {\n        const existing = this.nsIdByName.get(name);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        const nsId = this.typeTables.length;\n        this.typeTables[nsId] = { types: [], names: [], index: new Map() };\n        this.namespaceById[nsId] = undefined;\n        this.nsNameById[nsId] = name;\n        this.nsIdByName.set(name, nsId);\n\n        return nsId;\n    }\n\n    private registerNamespace(header: NamespaceHeader): GirNamespace {\n        const nsId = this.ensureNsId(header.name);\n        const shell = createNamespaceShell(header, nsId);\n        this.namespaceById[nsId] = shell;\n        this.namespacesByName.set(header.name, shell);\n\n        return shell;\n    }\n\n    private namespaceFor(nsId: number): GirNamespace {\n        const namespace = this.namespaceById[nsId];\n\n        if (namespace === undefined) {\n            throw new Error(`No namespace registered for type table id ${String(nsId)}`);\n        }\n\n        return namespace;\n    }\n\n    private typeTableFor(nsId: number): TypeTable {\n        const typeTable = this.typeTables[nsId];\n\n        if (typeTable === undefined) {\n            throw new Error(`No type table for namespace id ${String(nsId)}`);\n        }\n\n        return typeTable;\n    }\n\n    private insertIntoTypeTable(\n        typeTable: TypeTable,\n        slot: { type: GirType | undefined; indexKey?: string; displayName?: string },\n    ): number {\n        const id = typeTable.types.length;\n        typeTable.types.push(slot.type);\n        typeTable.names.push(slot.displayName);\n\n        if (slot.indexKey !== undefined) {\n            typeTable.index.set(slot.indexKey, id);\n        }\n\n        return id;\n    }\n\n    private resolveTypeId(nsId: number, name: string, type: GirType | undefined): number {\n        const typeTable = this.typeTableFor(nsId);\n        const existing = typeTable.index.get(name);\n\n        if (existing !== undefined) {\n            return existing;\n        }\n\n        return this.insertIntoTypeTable(typeTable, { type, indexKey: name, displayName: name });\n    }\n\n    private addType(nsId: number, name: string, type: GirType): void {\n        this.typeTableFor(nsId).types[this.resolveTypeId(nsId, name, type)] = type;\n    }\n\n    private findType(nsId: number, name: string): TypeId {\n        return { nsId, id: this.resolveTypeId(nsId, name, undefined) };\n    }\n\n    private addAnonymousType(nsId: number, type: GirType): TypeId {\n        const typeTable = this.typeTableFor(nsId);\n        const id = this.insertIntoTypeTable(typeTable, { type });\n\n        return { nsId, id };\n    }\n\n    private findTypeByName(currentNsId: number, name: string): TypeId {\n        const [namespaceName, localName] = splitOptionalNamespace(name);\n        const targetNsId = namespaceName === undefined ? currentNsId : this.ensureNsId(namespaceName);\n\n        return this.findType(targetNsId, localName);\n    }\n\n    private parseContext(nsId: number): ParseContext {\n        const context: ParseContext = {\n            nsId,\n            findType: (name) => this.findTypeByName(nsId, name),\n            addPrimitive: (category) => this.addPrimitive(category),\n            addVarargs: () => this.addVarargs(),\n            addContainer: (type: CArrayType | ListType | HashTableType) => this.addAnonymousType(nsId, type),\n            addAnonymousCallback: (node) =>\n                this.addAnonymousType(nsId, {\n                    kind: \"callback\",\n                    namespace: this.namespaceFor(nsId),\n                    value: callbackFromNode(node, context),\n                }),\n        };\n\n        return context;\n    }\n\n    private addPrimitive(category: PrimitiveCategory): TypeId {\n        return this.findOrAddContainer(`primitive:${category}`, { kind: \"primitive\", category });\n    }\n\n    private addVarargs(): TypeId {\n        return this.findOrAddContainer(\"varargs\", { kind: \"varargs\" });\n    }\n\n    private findOrAddContainer(key: string, type: GirType): TypeId {\n        const typeTable = this.typeTableFor(INTERNAL_NS_ID);\n        const existing = typeTable.index.get(key);\n\n        if (existing !== undefined) {\n            return { nsId: INTERNAL_NS_ID, id: existing };\n        }\n\n        const id = this.insertIntoTypeTable(typeTable, { type, indexKey: key });\n\n        return { nsId: INTERNAL_NS_ID, id };\n    }\n\n    private addDeclarations(shell: GirNamespace): void {\n        this.addClassDeclarations(shell);\n        this.addValueDeclarations(shell);\n    }\n\n    private addClassDeclarations(shell: GirNamespace): void {\n        const nsId = shell.id;\n\n        for (const value of shell.classes) {\n            this.addType(nsId, value.name, { kind: \"class\", namespace: shell, value });\n        }\n\n        for (const value of shell.interfaces) {\n            this.addType(nsId, value.name, { kind: \"interface\", namespace: shell, value });\n        }\n\n        for (const value of shell.records) {\n            this.addType(nsId, value.name, { kind: \"record\", namespace: shell, value });\n        }\n    }\n\n    private addValueDeclarations(shell: GirNamespace): void {\n        const nsId = shell.id;\n\n        for (const value of shell.enums) {\n            this.addType(nsId, value.name, { kind: \"enum\", namespace: shell, value });\n        }\n\n        for (const value of shell.callbacks) {\n            this.addType(nsId, value.name, { kind: \"callback\", namespace: shell, value });\n        }\n\n        for (const alias of shell.aliases) {\n            this.addType(nsId, alias.name, { kind: \"alias\", namespace: shell, value: alias });\n        }\n    }\n\n    private processIdentifier(input: {\n        identifier: string;\n        girPath: string[];\n        seen: Set<string>;\n        queue: string[];\n        girFiles: string[];\n        discovered: DiscoveredNamespace[];\n    }): void {\n        const { identifier, girPath, seen, queue, girFiles, discovered } = input;\n        const namespaceName = identifier.split(\"-\", 1)[0] ?? identifier;\n\n        if (seen.has(namespaceName)) {\n            return;\n        }\n\n        seen.add(namespaceName);\n        const path = locateGirFile(identifier, girPath);\n        girFiles.push(path);\n        const header = parseNamespaceHeader(readRepositoryNode(path));\n        const shell = this.registerNamespace(header);\n        discovered.push({ header, shell });\n\n        for (const include of header.includes) {\n            queue.push(`${include.name}-${include.version}`);\n        }\n    }\n\n    private discoverNamespaces(\n        libraries: string[],\n        girPath: string[],\n    ): { discovered: DiscoveredNamespace[]; girFiles: string[] } {\n        const queue: string[] = [...libraries];\n        const seen: Set<string> = new Set();\n        const discovered: DiscoveredNamespace[] = [];\n        const girFiles: string[] = [];\n\n        while (queue.length > 0) {\n            const identifier = queue.shift();\n\n            if (identifier !== undefined) {\n                this.processIdentifier({ identifier, girPath, seen, queue, girFiles, discovered });\n            }\n        }\n\n        return { discovered, girFiles };\n    }\n\n    /** The loaded namespaces, keyed by their GIR name such as `Gtk`. */\n    public get namespaces(): Map<string, GirNamespace> {\n        return this.namespacesByName;\n    }\n\n    /** Paths of the `.gir` files that were read, in the order they were discovered. */\n    public get girFiles(): string[] {\n        return this.girFilesValue;\n    }\n\n    /**\n     * Reads the type a {@link TypeId} points at.\n     *\n     * @param tid The type id to dereference.\n     * @returns The parsed type, or `undefined` when nothing has been parsed into that slot.\n     */\n    typeFor(tid: TypeId): GirType | undefined {\n        return this.typeTables[tid.nsId]?.types[tid.id];\n    }\n\n    /**\n     * Reads the name a {@link TypeId} was registered under.\n     *\n     * @param tid The type id to name.\n     * @returns The namespace and type name, or `undefined` for an anonymous type.\n     */\n    nameFor(tid: TypeId): {\n        /** GIR namespace to qualify the type with, such as `Gtk`. */\n        namespaceName: string;\n        /** Unqualified type name as GIR declares it, such as `Widget`. */\n        typeName: string;\n    } | undefined {\n        const typeName = this.typeTables[tid.nsId]?.names[tid.id];\n        const namespaceName = this.nsNameById[tid.nsId];\n\n        if (typeName === undefined || namespaceName === undefined) {\n            return undefined;\n        }\n\n        return { namespaceName, typeName };\n    }\n\n    /**\n     * Looks up a type by the name a GIR file writes, resolving an unqualified name against the\n     * namespace it appears in and a `Namespace.Type` name against the loaded namespaces.\n     *\n     * @param currentNamespaceName Namespace the name is written in.\n     * @param name Type name, optionally qualified with a namespace prefix.\n     * @returns The parsed type, or `undefined` when the name is unknown or only a forward reference to it exists.\n     */\n    resolveType(currentNamespaceName: string, name: string): GirType | undefined {\n        const currentNsId = this.nsIdByName.get(currentNamespaceName);\n\n        if (currentNsId === undefined) {\n            return undefined;\n        }\n\n        const [namespaceName, localName] = splitOptionalNamespace(name);\n        const targetNsId = namespaceName === undefined ? currentNsId : this.nsIdByName.get(namespaceName);\n\n        if (targetNsId === undefined) {\n            return undefined;\n        }\n\n        const id = this.typeTableFor(targetNsId).index.get(localName);\n\n        if (id === undefined) {\n            return undefined;\n        }\n\n        return this.typeTableFor(targetNsId).types[id];\n    }\n}\n\nexport { Library };\n"]}