@gtkx/codegen 1.0.0 → 1.1.0

package/dist/gir/cursor-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-overrides.js","sourceRoot":"","sources":["../../src/gir/cursor-overrides.ts"],"names":[],"mappings":"AAMA,MAAM,+BAA+B,GAAwC,IAAI,GAAG,CAAC;IACjF,CAAC,iBAAiB,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC,qBAAqB,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CAC/E,CAAC,CAAC;AAEH,OAAO,EAAE,+BAA+B,EAA6B,CAAC","sourcesContent":["type CursorParameterNames = {\n    cursor: string;\n    base: string;\n    length: string;\n};\n\nconst PARAMETERS_MISSING_ARRAY_EXTENT: Map<string, CursorParameterNames[]> = new Map([\n    [\"g_utf8_validate\", [{ cursor: \"end\", base: \"str\", length: \"max_len\" }]],\n    [\"g_utf8_validate_len\", [{ cursor: \"end\", base: \"str\", length: \"max_len\" }]],\n]);\n\nexport { PARAMETERS_MISSING_ARRAY_EXTENT, type CursorParameterNames };\n"]}

package/dist/gir/emittable.d.ts

@@ -0,0 +1,7 @@
+type NamedEntity = {
+    name: string;
+    introspectable?: boolean | undefined;
+};
+declare const isEmittableEntity: (entity: NamedEntity) => boolean;
+export { isEmittableEntity };
+//# sourceMappingURL=emittable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emittable.d.ts","sourceRoot":"","sources":["../../src/gir/emittable.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,WAAW,KAAG,OAAoE,CAAC;AAEtH,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/gir/emittable.js

@@ -0,0 +1,3 @@
+const isEmittableEntity = (entity) => entity.name.length > 0 && entity.introspectable !== false;
+export { isEmittableEntity };
+//# sourceMappingURL=emittable.js.map

package/dist/gir/emittable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emittable.js","sourceRoot":"","sources":["../../src/gir/emittable.ts"],"names":[],"mappings":"AAKA,MAAM,iBAAiB,GAAG,CAAC,MAAmB,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC;AAEtH,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["type NamedEntity = {\n    name: string;\n    introspectable?: boolean | undefined;\n};\n\nconst isEmittableEntity = (entity: NamedEntity): boolean => entity.name.length > 0 && entity.introspectable !== false;\n\nexport { isEmittableEntity };\n"]}

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,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"}
+{"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;AAGjD,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;AAqDF,QAAA,MAAM,gBAAgB,GAAI,MAAM,OAAO,EAAE,SAAS,YAAY,KAAG,WAchE,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/gir/function.js

@@ -1,3 +1,4 @@
+import { PARAMETERS_MISSING_ARRAY_EXTENT } from "./cursor-overrides.js";
 import { PARAMETERS_MISSING_NULLABLE_ANNOTATION } from "./nullable-overrides.js";
 import { parameterFromNode, parseCallable } from "./parameter.js";
 import { attr, getChild } from "./parse.js";
@@ -15,9 +16,34 @@ const relaxMissingNullable = (fn) => {
     }
     return fn;
 };
+const parameterIndexFor = (parameters, name) => {
+    const index = parameters.findIndex((parameter) => parameter.name === name);
+    if (index === -1) {
+        throw new Error(`A cursor correction names a parameter the GIR does not declare: ${name}`);
+    }
+    return index;
+};
+const bindCursorParameters = (parameters, corrections) => {
+    for (const names of corrections) {
+        const parameter = parameters[parameterIndexFor(parameters, names.cursor)];
+        if (parameter !== undefined) {
+            parameter.cursor = {
+                baseIndex: parameterIndexFor(parameters, names.base),
+                lengthIndex: parameterIndexFor(parameters, names.length),
+            };
+        }
+    }
+};
+const bindMissingArrayExtent = (fn) => {
+    const corrections = fn.cIdentifier === undefined ? undefined : PARAMETERS_MISSING_ARRAY_EXTENT.get(fn.cIdentifier);
+    if (corrections !== undefined) {
+        bindCursorParameters(fn.parameters, corrections);
+    }
+    return fn;
+};
 const functionFromNode = (node, context) => {
     const instanceNode = getChild(getChild(node, "parameters"), "instance-parameter");
-    return relaxMissingNullable({
+    return bindMissingArrayExtent(relaxMissingNullable({
         ...parseCallable(node, context),
         name: attr(node, "shadows") ?? attr(node, "name") ?? "",
         cIdentifier: attr(node, "c:identifier"),
@@ -25,7 +51,7 @@ const functionFromNode = (node, context) => {
         shadowedBy: attr(node, "shadowed-by"),
         finishFunc: attr(node, "glib:finish-func"),
         instance: instanceNode === undefined ? undefined : parameterFromNode(instanceNode, context),
-    });
+    }));
 };
 export { functionFromNode };
 //# sourceMappingURL=function.js.map

package/dist/gir/function.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/gir/function.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GirAnnotations } from \"./annotations.js\";\nimport type { ParseContext } from \"./type-id.js\";\nimport { type CursorParameterNames, PARAMETERS_MISSING_ARRAY_EXTENT } from \"./cursor-overrides.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 parameterIndexFor = (parameters: GirParameter[], name: string): number => {\n    const index = parameters.findIndex((parameter) => parameter.name === name);\n\n    if (index === -1) {\n        throw new Error(`A cursor correction names a parameter the GIR does not declare: ${name}`);\n    }\n\n    return index;\n};\n\nconst bindCursorParameters = (parameters: GirParameter[], corrections: CursorParameterNames[]): void => {\n    for (const names of corrections) {\n        const parameter = parameters[parameterIndexFor(parameters, names.cursor)];\n\n        if (parameter !== undefined) {\n            parameter.cursor = {\n                baseIndex: parameterIndexFor(parameters, names.base),\n                lengthIndex: parameterIndexFor(parameters, names.length),\n            };\n        }\n    }\n};\n\nconst bindMissingArrayExtent = (fn: GirFunction): GirFunction => {\n    const corrections = fn.cIdentifier === undefined ? undefined : PARAMETERS_MISSING_ARRAY_EXTENT.get(fn.cIdentifier);\n\n    if (corrections !== undefined) {\n        bindCursorParameters(fn.parameters, corrections);\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 bindMissingArrayExtent(\n        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};\n\nexport { functionFromNode, type GirFunction };\n"]}

package/dist/gir/library.js

@@ -196,7 +196,7 @@ class Library {
         seen.add(namespaceName);
         const path = locateGirFile(identifier, girPath);
         girFiles.push(path);
-        const header = parseNamespaceHeader(readRepositoryNode(path));
+        const header = parseNamespaceHeader(readRepositoryNode(path), path);
         const shell = this.registerNamespace(header);
         discovered.push({ header, shell });
         for (const include of header.includes) {

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\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"]}
+{"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), 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"]}

package/dist/gir/namespace.d.ts

@@ -40,6 +40,8 @@ type GirNamespace = {
     id: number;
     /** Namespace name as it appears in the GIR, such as `Gtk`. */
     name: string;
+    /** Path of the `.gir` file the namespace was parsed from, named by every diagnostic the namespace causes. */
+    girFile: 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`. */
@@ -72,6 +74,8 @@ type NamespaceInclude = {
 type NamespaceHeader = {
     /** Namespace name as it appears in the GIR, such as `Gtk`. */
     name: string;
+    /** Path of the `.gir` file the header was read from. */
+    girFile: 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`. */
@@ -82,7 +86,7 @@ type NamespaceHeader = {
     namespaceNode: RawNode;
 };
 declare const namespaceDirectory: (namespace: Pick<GirNamespace, "name">) => string;
-declare const parseNamespaceHeader: (repositoryNode: RawNode) => NamespaceHeader;
+declare const parseNamespaceHeader: (repositoryNode: RawNode, path: string) => NamespaceHeader;
 declare const createNamespaceShell: (header: NamespaceHeader, id: number) => GirNamespace;
 declare const populateNamespaceBody: (shell: GirNamespace, namespaceNode: RawNode, context: ParseContext) => void;
 export { namespaceDirectory, parseNamespaceHeader, createNamespaceShell, populateNamespaceBody, type GirConstant, type GirAlias, type GirNamespace, type NamespaceHeader, };

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

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

package/dist/gir/namespace.js

@@ -7,17 +7,18 @@ 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();
-const parseNamespaceHeader = (repositoryNode) => {
+const parseNamespaceHeader = (repositoryNode, path) => {
     const includes = getChildren(repositoryNode, "include").map((include) => ({
         name: nameAttr(include),
         version: attr(include, "version") ?? "",
     }));
     const namespaceNode = getChildren(repositoryNode, "namespace")[0];
     if (namespaceNode === undefined) {
-        throw new Error("GIR repository has no <namespace> child");
+        throw new Error(`GIR file at ${path} has no <namespace> child in its <repository>`);
     }
     return {
         name: nameAttr(namespaceNode),
+        girFile: path,
         sharedLibrary: attr(namespaceNode, "shared-library"),
         cSymbolPrefixes: splitPrefixes(attr(namespaceNode, "c:symbol-prefixes")),
         includes,
@@ -27,6 +28,7 @@ const parseNamespaceHeader = (repositoryNode) => {
 const createNamespaceShell = (header, id) => ({
     id,
     name: header.name,
+    girFile: header.girFile,
     sharedLibrary: header.sharedLibrary,
     cSymbolPrefixes: header.cSymbolPrefixes,
     classes: [],

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 { 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"]}
+{"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    /** Path of the `.gir` file the namespace was parsed from, named by every diagnostic the namespace causes. */\n    girFile: 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    /** Path of the `.gir` file the header was read from. */\n    girFile: 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, path: string): 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 file at ${path} has no <namespace> child in its <repository>`);\n    }\n\n    return {\n        name: nameAttr(namespaceNode),\n        girFile: path,\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    girFile: header.girFile,\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

@@ -10,6 +10,16 @@ type ParameterTransfer = "none" | "full" | "container";
  * until the asynchronous operation invokes it, or forever.
  */
 type CallbackScope = "call" | "notified" | "async" | "forever";
+/**
+ * Bounds of an out parameter that points into the buffer of a sibling parameter instead of to an
+ * array of its own, which GIR describes as an array with no extent of any kind.
+ */
+type GirCursorBounds = {
+    /** Position of the parameter holding the buffer the pointer points into. */
+    baseIndex: number;
+    /** Position of the parameter carrying that buffer's element count. */
+    lengthIndex: number;
+};
 /** A parameter of a {@link GirCallable}, with the annotations that decide how it is marshalled. */
 type GirParameter = {
     /** The name GIR gives the parameter. */
@@ -38,6 +48,8 @@ type GirParameter = {
     destroyIndex: number | undefined;
     /** Whether the parameter is the `...` varargs marker. */
     isVarargs: boolean;
+    /** Where the buffer is that the parameter points into, when it carries a cursor rather than an array. */
+    cursor: GirCursorBounds | undefined;
 };
 /** What a {@link GirCallable} hands back, with the annotations that decide how it is marshalled. */
 type GirReturnValue = {
@@ -75,5 +87,5 @@ declare const isOutParameter: (parameter: GirParameter) => boolean;
 declare const isCallerAllocatedOut: (parameter: GirParameter) => boolean;
 declare const isInoutParameter: (parameter: GirParameter) => boolean;
 declare const parseCallable: (node: RawNode, context: ParseContext) => GirCallable;
-export { transferOwnership, parameterFromNode, isOutParameter, isCallerAllocatedOut, isInoutParameter, parseCallable, type ParameterTransfer, type GirParameter, type GirReturnValue, type GirCallable, };
+export { transferOwnership, parameterFromNode, isOutParameter, isCallerAllocatedOut, isInoutParameter, parseCallable, type ParameterTransfer, type GirCursorBounds, type GirParameter, type GirReturnValue, type GirCallable, };
 //# sourceMappingURL=parameter.d.ts.map

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

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

package/dist/gir/parameter.js

@@ -23,6 +23,7 @@ const parameterFromNode = (node, context) => ({
     closureIndex: intAttr(node, "closure"),
     destroyIndex: intAttr(node, "destroy"),
     isVarargs: getChild(node, "varargs") !== undefined,
+    cursor: undefined,
 });
 const isOutParameter = (parameter) => parameter.direction === "out" && !parameter.callerAllocates;
 const isCallerAllocatedOut = (parameter) => parameter.direction === "out" && parameter.callerAllocates;

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 { 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"]}
+{"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/**\n * Bounds of an out parameter that points into the buffer of a sibling parameter instead of to an\n * array of its own, which GIR describes as an array with no extent of any kind.\n */\ntype GirCursorBounds = {\n    /** Position of the parameter holding the buffer the pointer points into. */\n    baseIndex: number;\n    /** Position of the parameter carrying that buffer's element count. */\n    lengthIndex: number;\n};\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    /** Where the buffer is that the parameter points into, when it carries a cursor rather than an array. */\n    cursor: GirCursorBounds | undefined;\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    cursor: 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 GirCursorBounds,\n    type GirParameter,\n    type GirReturnValue,\n    type GirCallable,\n};\n"]}

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"AAEA,6GAA6G;AAC7G,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4BvC,QAAA,MAAM,mBAAmB,oBAAoB,CAAC;AAc9C,QAAA,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACkC,CAAC;AAExE,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

@@ -1,5 +1,5 @@
-import { readFileSync } from "node:fs";
-import { createXmlParser } from "../xml.js";
+import { createXmlParser, parseXmlFile } from "../xml.js";
+const GIR_LABEL = "GIR file";
 const MULTI_TAGS = new Set([
     "include",
     "class",
@@ -34,10 +34,7 @@ const PARSER = createXmlParser({
 function renameReservedTag(tag) {
     return RESERVED_TAG_RENAMES.get(tag) ?? tag;
 }
-const parseGirFile = (path) => {
-    const xml = readFileSync(path, "utf8");
-    return PARSER.parse(xml);
-};
+const parseGirFile = (path) => parseXmlFile({ parser: PARSER, label: GIR_LABEL, path });
 const attr = (node, name) => {
     if (node === undefined) {
         return undefined;

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\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"]}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/gir/parse.ts"],"names":[],"mappings":"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","sourcesContent":["import { createXmlParser, parseXmlFile } 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 GIR_LABEL = \"GIR file\";\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    parseXmlFile({ parser: PARSER, label: GIR_LABEL, path }) as RawNode;\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/guards.d.ts

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

package/dist/guards.d.ts.map

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