@gtkx/codegen 1.0.0 → 1.2.0

package/dist/fingerprint.js

@@ -1,12 +1,13 @@
 import { sortStrings } from "@gtkx/utils";
 import { createHash } from "node:crypto";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { createRequire } from "node:module";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-const require = createRequire(import.meta.url);
+import packageManifest from "../package.json" with { type: "json" };
+import { arrayGuard, hasFields, isNumber, isString, optionalGuard } from "./guards.js";
+import { readJsonFile } from "./json.js";
 const FINGERPRINT_FILENAME = ".codegen-fingerprint.json";
-const CODEGEN_VERSION = require("../package.json").version;
+const CODEGEN_VERSION = packageManifest.version;
 const OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "overrides");
 const sortAlpha = (values) => sortStrings(values).join(",");
 const overrideFiles = () => {
@@ -17,15 +18,17 @@ const overrideFiles = () => {
         .filter((entry) => entry.isFile())
         .map((entry) => join(entry.parentPath, entry.name));
 };
-const hashGi = (girFiles, libraries, girPath) => {
+const hashGi = (inputs) => {
     const hash = createHash("sha256");
     hash.update(CODEGEN_VERSION);
     hash.update("\n");
-    hash.update(sortAlpha(libraries));
+    hash.update(sortAlpha(inputs.libraries));
     hash.update("\n");
-    hash.update(sortAlpha(girPath));
+    hash.update(sortAlpha(inputs.girPath));
     hash.update("\n");
-    const hashedFiles = sortStrings([...girFiles, ...overrideFiles()]);
+    hash.update(String(inputs.isByteArrayTyped));
+    hash.update("\n");
+    const hashedFiles = sortStrings([...inputs.girFiles, ...overrideFiles()]);
     for (const file of hashedFiles) {
         hash.update("\n");
         hash.update(file);
@@ -34,35 +37,58 @@ const hashGi = (girFiles, libraries, girPath) => {
     }
     return hash.digest("hex");
 };
-const computeGiFingerprint = (girFiles, libraries, girPath) => ({
-    value: hashGi(girFiles, libraries, girPath),
-    girFiles,
-    libraries,
-    girPath,
+const computeGiFingerprint = (inputs) => ({
+    value: hashGi(inputs),
+    girFiles: inputs.girFiles,
+    libraries: inputs.libraries,
+    girPath: inputs.girPath,
 });
-const isGiStoreFresh = (giStoreDir, libraries, girPath) => {
-    const sentinelPath = join(giStoreDir, FINGERPRINT_FILENAME);
-    if (!existsSync(sentinelPath)) {
-        return false;
+const readSentinel = (storeDir) => readJsonFile(join(storeDir, FINGERPRINT_FILENAME));
+const isGiFingerprint = (value) => hasFields(value, {
+    value: isString,
+    girFiles: arrayGuard(isString),
+    libraries: arrayGuard(isString),
+    girPath: optionalGuard(arrayGuard(isString)),
+});
+const isDocsFingerprint = (value) => hasFields(value, { value: isString, gi: isGiFingerprint });
+const isJsxFingerprint = (value) => hasFields(value, { value: isString, intrinsicElementCount: isNumber });
+const recordedGiValue = (sentinel, inputs) => {
+    if (!hasMatchingRecordedInputs(sentinel, inputs)) {
+        return undefined;
     }
-    let sentinel;
     try {
-        sentinel = JSON.parse(readFileSync(sentinelPath, "utf8"));
+        return hashGi({ ...inputs, girFiles: sentinel.girFiles, libraries: sentinel.libraries });
     }
     catch {
-        return false;
-    }
-    if (!hasMatchingRecordedInputs(sentinel, libraries, girPath)) {
-        return false;
+        return undefined;
     }
-    try {
-        return hashGi(sentinel.girFiles, sentinel.libraries, girPath) === sentinel.value;
-    }
-    catch {
+};
+const isGiStoreFresh = (giStoreDir, inputs) => {
+    const sentinel = readSentinel(giStoreDir);
+    return isGiFingerprint(sentinel) && recordedGiValue(sentinel, inputs) === sentinel.value;
+};
+const hasMatchingRecordedInputs = (sentinel, inputs) => sortAlpha(sentinel.libraries) === sortAlpha(inputs.libraries) &&
+    sortAlpha(sentinel.girPath ?? []) === sortAlpha(inputs.girPath);
+const hashDocs = (giValue, input) => createHash("sha256")
+    .update(JSON.stringify([
+    giValue,
+    input.basePath,
+    serializeModuleExports(input.props),
+    serializeOmittedProps(input.omittedProps),
+]))
+    .digest("hex");
+const computeDocsFingerprint = (inputs, input) => {
+    const gi = computeGiFingerprint(inputs);
+    return { value: hashDocs(gi.value, input), gi };
+};
+const isDocsOutputFresh = (outDir, inputs, input) => {
+    const sentinel = readSentinel(outDir);
+    if (!isDocsFingerprint(sentinel)) {
         return false;
     }
+    const giValue = recordedGiValue(sentinel.gi, inputs);
+    return giValue !== undefined && hashDocs(giValue, input) === sentinel.value;
 };
-const hasMatchingRecordedInputs = (sentinel, libraries, girPath) => sortAlpha(sentinel.libraries) === sortAlpha(libraries) && sortAlpha(sentinel.girPath ?? []) === sortAlpha(girPath);
 const serializeModuleExports = (map) => sortStrings(Object.keys(map)).map((type) => [type, map[type]?.module ?? "", map[type]?.export ?? ""]);
 const serializeOmittedProps = (map) => sortStrings(Object.keys(map)).map((type) => [type, sortAlpha(map[type] ?? [])]);
 const hashJsx = (input) => createHash("sha256")
@@ -80,20 +106,13 @@ const computeJsxFingerprint = (input, intrinsicElementCount) => ({
     intrinsicElementCount,
 });
 const jsxStoreFreshness = (jsxStoreDir, input) => {
-    const sentinelPath = join(jsxStoreDir, FINGERPRINT_FILENAME);
-    if (!existsSync(sentinelPath)) {
-        return { isFresh: false, intrinsicElementCount: 0 };
-    }
-    let sentinel;
-    try {
-        sentinel = JSON.parse(readFileSync(sentinelPath, "utf8"));
-    }
-    catch {
+    const sentinel = readSentinel(jsxStoreDir);
+    if (!isJsxFingerprint(sentinel)) {
         return { isFresh: false, intrinsicElementCount: 0 };
     }
     return sentinel.value === hashJsx(input)
         ? { isFresh: true, intrinsicElementCount: sentinel.intrinsicElementCount }
         : { isFresh: false, intrinsicElementCount: 0 };
 };
-export { FINGERPRINT_FILENAME, computeGiFingerprint, isGiStoreFresh, computeJsxFingerprint, jsxStoreFreshness, };
+export { FINGERPRINT_FILENAME, computeGiFingerprint, computeDocsFingerprint, isGiStoreFresh, isDocsOutputFresh, computeJsxFingerprint, jsxStoreFreshness, };
 //# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport { createHash } from \"node:crypto\";\nimport { type Dirent, existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\ntype GiFingerprint = {\n    value: string;\n    girFiles: string[];\n    libraries: string[];\n    girPath?: string[];\n};\n\ntype ModuleExport = { module: string; export: string };\n\ntype JsxFingerprintInput = {\n    reactVersion: string;\n    components: Record<string, ModuleExport>;\n    lazyElements: string[];\n    props: Record<string, ModuleExport>;\n    omittedProps: Record<string, string[]>;\n};\n\ntype JsxFingerprint = {\n    value: string;\n    intrinsicElementCount: number;\n};\n\nconst require = createRequire(import.meta.url);\nconst FINGERPRINT_FILENAME = \".codegen-fingerprint.json\";\nconst CODEGEN_VERSION: string = (require(\"../package.json\") as { version: string }).version;\nconst OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\", \"overrides\");\n\nconst sortAlpha = (values: string[]): string => sortStrings(values).join(\",\");\n\nconst overrideFiles = (): string[] => {\n    if (!existsSync(OVERRIDES_ROOT)) {\n        return [];\n    }\n\n    return readdirSync(OVERRIDES_ROOT, { recursive: true, withFileTypes: true })\n        .filter((entry: Dirent) => entry.isFile())\n        .map((entry: Dirent) => join(entry.parentPath, entry.name));\n};\n\nconst hashGi = (girFiles: string[], libraries: string[], girPath: string[]): string => {\n    const hash = createHash(\"sha256\");\n    hash.update(CODEGEN_VERSION);\n    hash.update(\"\\n\");\n    hash.update(sortAlpha(libraries));\n    hash.update(\"\\n\");\n    hash.update(sortAlpha(girPath));\n    hash.update(\"\\n\");\n    const hashedFiles = sortStrings([...girFiles, ...overrideFiles()]);\n\n    for (const file of hashedFiles) {\n        hash.update(\"\\n\");\n        hash.update(file);\n        hash.update(\"\\0\");\n        hash.update(readFileSync(file));\n    }\n\n    return hash.digest(\"hex\");\n};\n\nconst computeGiFingerprint = (\n    girFiles: string[],\n    libraries: string[],\n    girPath: string[],\n): GiFingerprint => ({\n    value: hashGi(girFiles, libraries, girPath),\n    girFiles,\n    libraries,\n    girPath,\n});\n\nconst isGiStoreFresh = (\n    giStoreDir: string,\n    libraries: string[],\n    girPath: string[],\n): boolean => {\n    const sentinelPath = join(giStoreDir, FINGERPRINT_FILENAME);\n\n    if (!existsSync(sentinelPath)) {\n        return false;\n    }\n\n    let sentinel: GiFingerprint;\n\n    try {\n        sentinel = JSON.parse(readFileSync(sentinelPath, \"utf8\")) as GiFingerprint;\n    } catch {\n        return false;\n    }\n\n    if (!hasMatchingRecordedInputs(sentinel, libraries, girPath)) {\n        return false;\n    }\n\n    try {\n        return hashGi(sentinel.girFiles, sentinel.libraries, girPath) === sentinel.value;\n    } catch {\n        return false;\n    }\n};\n\nconst hasMatchingRecordedInputs = (sentinel: GiFingerprint, libraries: string[], girPath: string[]): boolean =>\n    sortAlpha(sentinel.libraries) === sortAlpha(libraries) && sortAlpha(sentinel.girPath ?? []) === sortAlpha(girPath);\n\nconst serializeModuleExports = (map: Record<string, ModuleExport>): [string, string, string][] =>\n    sortStrings(Object.keys(map)).map((type) => [type, map[type]?.module ?? \"\", map[type]?.export ?? \"\"]);\n\nconst serializeOmittedProps = (map: Record<string, string[]>): [string, string][] =>\n    sortStrings(Object.keys(map)).map((type) => [type, sortAlpha(map[type] ?? [])]);\n\nconst hashJsx = (input: JsxFingerprintInput): string =>\n    createHash(\"sha256\")\n        .update(\n            JSON.stringify([\n                CODEGEN_VERSION,\n                input.reactVersion,\n                serializeModuleExports(input.components),\n                sortStrings(input.lazyElements),\n                serializeModuleExports(input.props),\n                serializeOmittedProps(input.omittedProps),\n            ]),\n        )\n        .digest(\"hex\");\n\nconst computeJsxFingerprint = (input: JsxFingerprintInput, intrinsicElementCount: number): JsxFingerprint => ({\n    value: hashJsx(input),\n    intrinsicElementCount,\n});\n\nconst jsxStoreFreshness = (\n    jsxStoreDir: string,\n    input: JsxFingerprintInput,\n): { isFresh: boolean; intrinsicElementCount: number } => {\n    const sentinelPath = join(jsxStoreDir, FINGERPRINT_FILENAME);\n\n    if (!existsSync(sentinelPath)) {\n        return { isFresh: false, intrinsicElementCount: 0 };\n    }\n\n    let sentinel: JsxFingerprint;\n\n    try {\n        sentinel = JSON.parse(readFileSync(sentinelPath, \"utf8\")) as JsxFingerprint;\n    } catch {\n        return { isFresh: false, intrinsicElementCount: 0 };\n    }\n\n    return sentinel.value === hashJsx(input)\n        ? { isFresh: true, intrinsicElementCount: sentinel.intrinsicElementCount }\n        : { isFresh: false, intrinsicElementCount: 0 };\n};\n\nexport {\n    FINGERPRINT_FILENAME,\n    computeGiFingerprint,\n    isGiStoreFresh,\n    computeJsxFingerprint,\n    jsxStoreFreshness,\n    type GiFingerprint,\n    type JsxFingerprintInput,\n};\n"]}
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStrings } from \"@gtkx/utils\";\nimport { createHash } from \"node:crypto\";\nimport { type Dirent, existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport packageManifest from \"../package.json\" with { type: \"json\" };\nimport { arrayGuard, hasFields, isNumber, isString, optionalGuard } from \"./guards.js\";\nimport { readJsonFile } from \"./json.js\";\n\ntype GiInputs = {\n    girFiles: string[];\n    libraries: string[];\n    girPath: string[];\n    isByteArrayTyped: boolean;\n};\n\ntype GiFingerprint = {\n    value: string;\n    girFiles: string[];\n    libraries: string[];\n    girPath?: string[];\n};\n\ntype ModuleExport = { module: string; export: string };\n\ntype DocsFingerprintInput = {\n    basePath: string;\n    props: Record<string, ModuleExport>;\n    omittedProps: Record<string, string[]>;\n};\n\ntype DocsFingerprint = {\n    value: string;\n    gi: GiFingerprint;\n};\n\ntype JsxFingerprintInput = {\n    reactVersion: string;\n    components: Record<string, ModuleExport>;\n    lazyElements: string[];\n    props: Record<string, ModuleExport>;\n    omittedProps: Record<string, string[]>;\n};\n\ntype JsxFingerprint = {\n    value: string;\n    intrinsicElementCount: number;\n};\n\nconst FINGERPRINT_FILENAME = \".codegen-fingerprint.json\";\nconst CODEGEN_VERSION: string = packageManifest.version;\nconst OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\", \"overrides\");\n\nconst sortAlpha = (values: string[]): string => sortStrings(values).join(\",\");\n\nconst overrideFiles = (): string[] => {\n    if (!existsSync(OVERRIDES_ROOT)) {\n        return [];\n    }\n\n    return readdirSync(OVERRIDES_ROOT, { recursive: true, withFileTypes: true })\n        .filter((entry: Dirent) => entry.isFile())\n        .map((entry: Dirent) => join(entry.parentPath, entry.name));\n};\n\nconst hashGi = (inputs: GiInputs): string => {\n    const hash = createHash(\"sha256\");\n    hash.update(CODEGEN_VERSION);\n    hash.update(\"\\n\");\n    hash.update(sortAlpha(inputs.libraries));\n    hash.update(\"\\n\");\n    hash.update(sortAlpha(inputs.girPath));\n    hash.update(\"\\n\");\n    hash.update(String(inputs.isByteArrayTyped));\n    hash.update(\"\\n\");\n    const hashedFiles = sortStrings([...inputs.girFiles, ...overrideFiles()]);\n\n    for (const file of hashedFiles) {\n        hash.update(\"\\n\");\n        hash.update(file);\n        hash.update(\"\\0\");\n        hash.update(readFileSync(file));\n    }\n\n    return hash.digest(\"hex\");\n};\n\nconst computeGiFingerprint = (inputs: GiInputs): GiFingerprint => ({\n    value: hashGi(inputs),\n    girFiles: inputs.girFiles,\n    libraries: inputs.libraries,\n    girPath: inputs.girPath,\n});\n\nconst readSentinel = (storeDir: string): unknown => readJsonFile(join(storeDir, FINGERPRINT_FILENAME));\n\nconst isGiFingerprint = (value: unknown): value is GiFingerprint =>\n    hasFields<GiFingerprint>(value, {\n        value: isString,\n        girFiles: arrayGuard(isString),\n        libraries: arrayGuard(isString),\n        girPath: optionalGuard(arrayGuard(isString)),\n    });\n\nconst isDocsFingerprint = (value: unknown): value is DocsFingerprint =>\n    hasFields<DocsFingerprint>(value, { value: isString, gi: isGiFingerprint });\n\nconst isJsxFingerprint = (value: unknown): value is JsxFingerprint =>\n    hasFields<JsxFingerprint>(value, { value: isString, intrinsicElementCount: isNumber });\n\nconst recordedGiValue = (sentinel: GiFingerprint, inputs: GiInputs): string | undefined => {\n    if (!hasMatchingRecordedInputs(sentinel, inputs)) {\n        return undefined;\n    }\n\n    try {\n        return hashGi({ ...inputs, girFiles: sentinel.girFiles, libraries: sentinel.libraries });\n    } catch {\n        return undefined;\n    }\n};\n\nconst isGiStoreFresh = (giStoreDir: string, inputs: GiInputs): boolean => {\n    const sentinel = readSentinel(giStoreDir);\n\n    return isGiFingerprint(sentinel) && recordedGiValue(sentinel, inputs) === sentinel.value;\n};\n\nconst hasMatchingRecordedInputs = (sentinel: GiFingerprint, inputs: GiInputs): boolean =>\n    sortAlpha(sentinel.libraries) === sortAlpha(inputs.libraries) &&\n    sortAlpha(sentinel.girPath ?? []) === sortAlpha(inputs.girPath);\n\nconst hashDocs = (giValue: string, input: DocsFingerprintInput): string =>\n    createHash(\"sha256\")\n        .update(\n            JSON.stringify([\n                giValue,\n                input.basePath,\n                serializeModuleExports(input.props),\n                serializeOmittedProps(input.omittedProps),\n            ]),\n        )\n        .digest(\"hex\");\n\nconst computeDocsFingerprint = (inputs: GiInputs, input: DocsFingerprintInput): DocsFingerprint => {\n    const gi = computeGiFingerprint(inputs);\n\n    return { value: hashDocs(gi.value, input), gi };\n};\n\nconst isDocsOutputFresh = (outDir: string, inputs: GiInputs, input: DocsFingerprintInput): boolean => {\n    const sentinel = readSentinel(outDir);\n\n    if (!isDocsFingerprint(sentinel)) {\n        return false;\n    }\n\n    const giValue = recordedGiValue(sentinel.gi, inputs);\n\n    return giValue !== undefined && hashDocs(giValue, input) === sentinel.value;\n};\n\nconst serializeModuleExports = (map: Record<string, ModuleExport>): [string, string, string][] =>\n    sortStrings(Object.keys(map)).map((type) => [type, map[type]?.module ?? \"\", map[type]?.export ?? \"\"]);\n\nconst serializeOmittedProps = (map: Record<string, string[]>): [string, string][] =>\n    sortStrings(Object.keys(map)).map((type) => [type, sortAlpha(map[type] ?? [])]);\n\nconst hashJsx = (input: JsxFingerprintInput): string =>\n    createHash(\"sha256\")\n        .update(\n            JSON.stringify([\n                CODEGEN_VERSION,\n                input.reactVersion,\n                serializeModuleExports(input.components),\n                sortStrings(input.lazyElements),\n                serializeModuleExports(input.props),\n                serializeOmittedProps(input.omittedProps),\n            ]),\n        )\n        .digest(\"hex\");\n\nconst computeJsxFingerprint = (input: JsxFingerprintInput, intrinsicElementCount: number): JsxFingerprint => ({\n    value: hashJsx(input),\n    intrinsicElementCount,\n});\n\nconst jsxStoreFreshness = (\n    jsxStoreDir: string,\n    input: JsxFingerprintInput,\n): { isFresh: boolean; intrinsicElementCount: number } => {\n    const sentinel = readSentinel(jsxStoreDir);\n\n    if (!isJsxFingerprint(sentinel)) {\n        return { isFresh: false, intrinsicElementCount: 0 };\n    }\n\n    return sentinel.value === hashJsx(input)\n        ? { isFresh: true, intrinsicElementCount: sentinel.intrinsicElementCount }\n        : { isFresh: false, intrinsicElementCount: 0 };\n};\n\nexport {\n    FINGERPRINT_FILENAME,\n    computeGiFingerprint,\n    computeDocsFingerprint,\n    isGiStoreFresh,\n    isDocsOutputFresh,\n    computeJsxFingerprint,\n    jsxStoreFreshness,\n    type DocsFingerprintInput,\n    type GiInputs,\n    type GiFingerprint,\n    type JsxFingerprintInput,\n};\n"]}

package/dist/gi.d.ts

@@ -4,6 +4,7 @@ type GiCodegenOptions = {
     gi: StoreOptions;
     libraries: string[];
     girPath: string[];
+    isByteArrayTyped: boolean;
 };
 declare const runGiCodegen: (library: Library, options: GiCodegenOptions) => number;
 export { runGiCodegen };

package/dist/gi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gi.d.ts","sourceRoot":"","sources":["../src/gi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,KAAK,gBAAgB,GAAG;IACpB,EAAE,EAAE,YAAY,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,SAAS,OAAO,EAAE,SAAS,gBAAgB,KAAG,MAYnE,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"gi.d.ts","sourceRoot":"","sources":["../src/gi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,KAAK,gBAAgB,GAAG;IACpB,EAAE,EAAE,YAAY,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,SAAS,OAAO,EAAE,SAAS,gBAAgB,KAAG,MAmBnE,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/gi.js

@@ -3,12 +3,18 @@ import { namespaceDirectory } from "./gir/namespace.js";
 import { writeGiStore } from "./store/gi-store.js";
 import { generateNamespaceModule } from "./store/gi/pipeline.js";
 const runGiCodegen = (library, options) => {
-    const { gi, libraries, girPath } = options;
+    const { gi, libraries, girPath, isByteArrayTyped } = options;
     const namespaces = Array.from(library.namespaces.values(), (namespace) => ({
         directory: namespaceDirectory(namespace),
         rawSource: generateNamespaceModule(namespace, library),
+        girFile: namespace.girFile,
     }));
-    const fingerprint = computeGiFingerprint(library.girFiles, [...libraries], [...girPath]);
+    const fingerprint = computeGiFingerprint({
+        girFiles: library.girFiles,
+        libraries: [...libraries],
+        girPath: [...girPath],
+        isByteArrayTyped,
+    });
     writeGiStore(gi, namespaces, fingerprint);
     return library.namespaces.size;
 };

package/dist/gi.js.map

@@ -1 +1 @@
-{"version":3,"file":"gi.js","sourceRoot":"","sources":["../src/gi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAyB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAQjE,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAE,OAAyB,EAAU,EAAE;IACzE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE3C,MAAM,UAAU,GAAuB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3F,SAAS,EAAE,kBAAkB,CAAC,SAAS,CAAC;QACxC,SAAS,EAAE,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC;KACzD,CAAC,CAAC,CAAC;IAEJ,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzF,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AACnC,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { Library } from \"./gir/library.js\";\nimport type { StoreOptions } from \"./store/store-fs.js\";\nimport { computeGiFingerprint } from \"./fingerprint.js\";\nimport { namespaceDirectory } from \"./gir/namespace.js\";\nimport { type GiNamespaceInput, writeGiStore } from \"./store/gi-store.js\";\nimport { generateNamespaceModule } from \"./store/gi/pipeline.js\";\n\ntype GiCodegenOptions = {\n    gi: StoreOptions;\n    libraries: string[];\n    girPath: string[];\n};\n\nconst runGiCodegen = (library: Library, options: GiCodegenOptions): number => {\n    const { gi, libraries, girPath } = options;\n\n    const namespaces: GiNamespaceInput[] = Array.from(library.namespaces.values(), (namespace) => ({\n        directory: namespaceDirectory(namespace),\n        rawSource: generateNamespaceModule(namespace, library),\n    }));\n\n    const fingerprint = computeGiFingerprint(library.girFiles, [...libraries], [...girPath]);\n    writeGiStore(gi, namespaces, fingerprint);\n\n    return library.namespaces.size;\n};\n\nexport { runGiCodegen };\n"]}
+{"version":3,"file":"gi.js","sourceRoot":"","sources":["../src/gi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAyB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AASjE,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAE,OAAyB,EAAU,EAAE;IACzE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAE7D,MAAM,UAAU,GAAuB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3F,SAAS,EAAE,kBAAkB,CAAC,SAAS,CAAC;QACxC,SAAS,EAAE,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC;QACtD,OAAO,EAAE,SAAS,CAAC,OAAO;KAC7B,CAAC,CAAC,CAAC;IAEJ,MAAM,WAAW,GAAG,oBAAoB,CAAC;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,gBAAgB;KACnB,CAAC,CAAC;IAEH,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AACnC,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { Library } from \"./gir/library.js\";\nimport type { StoreOptions } from \"./store/store-fs.js\";\nimport { computeGiFingerprint } from \"./fingerprint.js\";\nimport { namespaceDirectory } from \"./gir/namespace.js\";\nimport { type GiNamespaceInput, writeGiStore } from \"./store/gi-store.js\";\nimport { generateNamespaceModule } from \"./store/gi/pipeline.js\";\n\ntype GiCodegenOptions = {\n    gi: StoreOptions;\n    libraries: string[];\n    girPath: string[];\n    isByteArrayTyped: boolean;\n};\n\nconst runGiCodegen = (library: Library, options: GiCodegenOptions): number => {\n    const { gi, libraries, girPath, isByteArrayTyped } = options;\n\n    const namespaces: GiNamespaceInput[] = Array.from(library.namespaces.values(), (namespace) => ({\n        directory: namespaceDirectory(namespace),\n        rawSource: generateNamespaceModule(namespace, library),\n        girFile: namespace.girFile,\n    }));\n\n    const fingerprint = computeGiFingerprint({\n        girFiles: library.girFiles,\n        libraries: [...libraries],\n        girPath: [...girPath],\n        isByteArrayTyped,\n    });\n\n    writeGiStore(gi, namespaces, fingerprint);\n\n    return library.namespaces.size;\n};\n\nexport { runGiCodegen };\n"]}

package/dist/gir/ancestry.d.ts

@@ -4,7 +4,13 @@ type ResolvedAncestor = {
     klass: GirClass;
     namespaceName: string;
 };
+type ParentRef = {
+    namespaceName: string | undefined;
+    typeName: string;
+};
+declare const getParentRef: (klass: GirClass) => ParentRef | undefined;
+declare const resolveClassOrInterface: (library: Library, defaultNamespace: string, name: string) => ResolvedAncestor | undefined;
 declare const resolveInterfaces: (library: Library, defaultNamespace: string, names: string[]) => ResolvedAncestor[];
 declare function ancestorChain(library: Library, klass: GirClass, namespaceName: string): Generator<ResolvedAncestor>;
-export { resolveInterfaces, ancestorChain, type ResolvedAncestor };
+export { resolveClassOrInterface, resolveInterfaces, ancestorChain, getParentRef, type ResolvedAncestor };
 //# sourceMappingURL=ancestry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ancestry.d.ts","sourceRoot":"","sources":["../../src/gir/ancestry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,KAAK,gBAAgB,GAAG;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAuBF,QAAA,MAAM,iBAAiB,GAAI,SAAS,OAAO,EAAE,kBAAkB,MAAM,EAAE,OAAO,MAAM,EAAE,KAAG,gBAAgB,EAYxG,CAAC;AAEF,iBAAU,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoB7G;AAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"ancestry.d.ts","sourceRoot":"","sources":["../../src/gir/ancestry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,KAAK,gBAAgB,GAAG;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,SAAS,GAAG;IACb,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,OAAO,QAAQ,KAAG,SAAS,GAAG,SAQnD,CAAC;AAOF,QAAA,MAAM,uBAAuB,GACzB,SAAS,OAAO,EAChB,kBAAkB,MAAM,EACxB,MAAM,MAAM,KACb,gBAAgB,GAAG,SAAqE,CAAC;AAY5F,QAAA,MAAM,iBAAiB,GAAI,SAAS,OAAO,EAAE,kBAAkB,MAAM,EAAE,OAAO,MAAM,EAAE,KAAG,gBAAgB,EAYxG,CAAC;AAEF,iBAAU,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAoB7G;AAED,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/gir/ancestry.js

@@ -1,3 +1,11 @@
+import { splitOptionalNamespace } from "./type-ref.js";
+const getParentRef = (klass) => {
+    if (klass.parent === undefined) {
+        return undefined;
+    }
+    const [namespaceName, typeName] = splitOptionalNamespace(klass.parent);
+    return { namespaceName, typeName };
+};
 const getAncestor = (resolved) => resolved !== undefined && (resolved.kind === "class" || resolved.kind === "interface")
     ? { klass: resolved.value, namespaceName: resolved.namespace.name }
     : undefined;
@@ -32,5 +40,5 @@ function* ancestorChain(library, klass, namespaceName) {
         current = resolveClassOrInterface(library, current.namespaceName, current.klass.parent);
     }
 }
-export { resolveInterfaces, ancestorChain };
+export { resolveClassOrInterface, resolveInterfaces, ancestorChain, getParentRef };
 //# sourceMappingURL=ancestry.js.map

package/dist/gir/ancestry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ancestry.js","sourceRoot":"","sources":["../../src/gir/ancestry.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAG,CAAC,QAA6B,EAAgC,EAAE,CAChF,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC;IAClF,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;IACnE,CAAC,CAAC,SAAS,CAAC;AAEpB,MAAM,uBAAuB,GAAG,CAC5B,OAAgB,EAChB,gBAAwB,EACxB,IAAY,EACgB,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;AAE5F,MAAM,gBAAgB,GAAG,CACrB,OAAgB,EAChB,gBAAwB,EACxB,IAAY,EACgB,EAAE;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAE7D,OAAO,QAAQ,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,OAAgB,EAAE,gBAAwB,EAAE,KAAe,EAAsB,EAAE;IAC1G,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAEhE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,QAAQ,CAAC,CAAC,aAAa,CAAC,OAAgB,EAAE,KAAe,EAAE,aAAqB;IAC5E,MAAM,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;IACvC,IAAI,OAAO,GAAiC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAErE,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAE7D,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,OAAO,CAAC;QAEd,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QAED,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5F,CAAC;AACL,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAyB,CAAC","sourcesContent":["import type { GirClass } from \"./class.js\";\nimport type { Library } from \"./library.js\";\nimport type { GirType } from \"./type.js\";\n\ntype ResolvedAncestor = {\n    klass: GirClass;\n    namespaceName: string;\n};\n\nconst getAncestor = (resolved: GirType | undefined): ResolvedAncestor | undefined =>\n    resolved !== undefined && (resolved.kind === \"class\" || resolved.kind === \"interface\")\n        ? { klass: resolved.value, namespaceName: resolved.namespace.name }\n        : undefined;\n\nconst resolveClassOrInterface = (\n    library: Library,\n    defaultNamespace: string,\n    name: string,\n): ResolvedAncestor | undefined => getAncestor(library.resolveType(defaultNamespace, name));\n\nconst resolveInterface = (\n    library: Library,\n    defaultNamespace: string,\n    name: string,\n): ResolvedAncestor | undefined => {\n    const resolved = library.resolveType(defaultNamespace, name);\n\n    return resolved?.kind === \"interface\" ? getAncestor(resolved) : undefined;\n};\n\nconst resolveInterfaces = (library: Library, defaultNamespace: string, names: string[]): ResolvedAncestor[] => {\n    const interfaces: ResolvedAncestor[] = [];\n\n    for (const name of names) {\n        const iface = resolveInterface(library, defaultNamespace, name);\n\n        if (iface !== undefined) {\n            interfaces.push(iface);\n        }\n    }\n\n    return interfaces;\n};\n\nfunction* ancestorChain(library: Library, klass: GirClass, namespaceName: string): Generator<ResolvedAncestor> {\n    const visited: Set<string> = new Set();\n    let current: ResolvedAncestor | undefined = { klass, namespaceName };\n\n    while (current !== undefined) {\n        const key = `${current.namespaceName}.${current.klass.name}`;\n\n        if (visited.has(key)) {\n            return;\n        }\n\n        visited.add(key);\n        yield current;\n\n        if (current.klass.parent === undefined) {\n            return;\n        }\n\n        current = resolveClassOrInterface(library, current.namespaceName, current.klass.parent);\n    }\n}\n\nexport { resolveInterfaces, ancestorChain, type ResolvedAncestor };\n"]}
+{"version":3,"file":"ancestry.js","sourceRoot":"","sources":["../../src/gir/ancestry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAYvD,MAAM,YAAY,GAAG,CAAC,KAAe,EAAyB,EAAE;IAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,QAA6B,EAAgC,EAAE,CAChF,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC;IAClF,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;IACnE,CAAC,CAAC,SAAS,CAAC;AAEpB,MAAM,uBAAuB,GAAG,CAC5B,OAAgB,EAChB,gBAAwB,EACxB,IAAY,EACgB,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;AAE5F,MAAM,gBAAgB,GAAG,CACrB,OAAgB,EAChB,gBAAwB,EACxB,IAAY,EACgB,EAAE;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAE7D,OAAO,QAAQ,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,OAAgB,EAAE,gBAAwB,EAAE,KAAe,EAAsB,EAAE;IAC1G,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAEhE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,QAAQ,CAAC,CAAC,aAAa,CAAC,OAAgB,EAAE,KAAe,EAAE,aAAqB;IAC5E,MAAM,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;IACvC,IAAI,OAAO,GAAiC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAErE,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAE7D,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,OAAO,CAAC;QAEd,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QAED,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5F,CAAC;AACL,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAyB,CAAC","sourcesContent":["import type { GirClass } from \"./class.js\";\nimport type { Library } from \"./library.js\";\nimport type { GirType } from \"./type.js\";\nimport { splitOptionalNamespace } from \"./type-ref.js\";\n\ntype ResolvedAncestor = {\n    klass: GirClass;\n    namespaceName: string;\n};\n\ntype ParentRef = {\n    namespaceName: string | undefined;\n    typeName: string;\n};\n\nconst getParentRef = (klass: GirClass): ParentRef | undefined => {\n    if (klass.parent === undefined) {\n        return undefined;\n    }\n\n    const [namespaceName, typeName] = splitOptionalNamespace(klass.parent);\n\n    return { namespaceName, typeName };\n};\n\nconst getAncestor = (resolved: GirType | undefined): ResolvedAncestor | undefined =>\n    resolved !== undefined && (resolved.kind === \"class\" || resolved.kind === \"interface\")\n        ? { klass: resolved.value, namespaceName: resolved.namespace.name }\n        : undefined;\n\nconst resolveClassOrInterface = (\n    library: Library,\n    defaultNamespace: string,\n    name: string,\n): ResolvedAncestor | undefined => getAncestor(library.resolveType(defaultNamespace, name));\n\nconst resolveInterface = (\n    library: Library,\n    defaultNamespace: string,\n    name: string,\n): ResolvedAncestor | undefined => {\n    const resolved = library.resolveType(defaultNamespace, name);\n\n    return resolved?.kind === \"interface\" ? getAncestor(resolved) : undefined;\n};\n\nconst resolveInterfaces = (library: Library, defaultNamespace: string, names: string[]): ResolvedAncestor[] => {\n    const interfaces: ResolvedAncestor[] = [];\n\n    for (const name of names) {\n        const iface = resolveInterface(library, defaultNamespace, name);\n\n        if (iface !== undefined) {\n            interfaces.push(iface);\n        }\n    }\n\n    return interfaces;\n};\n\nfunction* ancestorChain(library: Library, klass: GirClass, namespaceName: string): Generator<ResolvedAncestor> {\n    const visited: Set<string> = new Set();\n    let current: ResolvedAncestor | undefined = { klass, namespaceName };\n\n    while (current !== undefined) {\n        const key = `${current.namespaceName}.${current.klass.name}`;\n\n        if (visited.has(key)) {\n            return;\n        }\n\n        visited.add(key);\n        yield current;\n\n        if (current.klass.parent === undefined) {\n            return;\n        }\n\n        current = resolveClassOrInterface(library, current.namespaceName, current.klass.parent);\n    }\n}\n\nexport { resolveClassOrInterface, resolveInterfaces, ancestorChain, getParentRef, type ResolvedAncestor };\n"]}

package/dist/gir/annotations.d.ts

@@ -15,8 +15,7 @@ type DocumentedNode = {
     doc: string | undefined;
     annotations: GirAnnotations;
 };
-declare const annotationsFromNode: (node: RawNode | undefined) => GirAnnotations;
 declare const documentedFromNode: (node: RawNode) => DocumentedNode;
 declare const hasAnnotations: (annotations: GirAnnotations) => boolean;
-export { annotationsFromNode, documentedFromNode, hasAnnotations, type GirAnnotations };
+export { documentedFromNode, hasAnnotations, type GirAnnotations };
 //# sourceMappingURL=annotations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/gir/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhG,iFAAiF;AACjF,KAAK,cAAc,GAAG;IAClB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gEAAgE;IAChE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,WAAW,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,MAAM,OAAO,GAAG,SAAS,KAAG,cAKvD,CAAC;AAEH,QAAA,MAAM,kBAAkB,GAAI,MAAM,OAAO,KAAG,cAI1C,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,aAAa,cAAc,KAAG,OACsD,CAAC;AAE7G,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAC"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/gir/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhG,iFAAiF;AACjF,KAAK,cAAc,GAAG;IAClB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gEAAgE;IAChE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,WAAW,EAAE,cAAc,CAAC;CAC/B,CAAC;AASF,QAAA,MAAM,kBAAkB,GAAI,MAAM,OAAO,KAAG,cAI1C,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,aAAa,cAAc,KAAG,OACsD,CAAC;AAE7G,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAC"}

package/dist/gir/annotations.js

@@ -11,5 +11,5 @@ const documentedFromNode = (node) => ({
     annotations: annotationsFromNode(node),
 });
 const hasAnnotations = (annotations) => annotations.since !== undefined || annotations.isDeprecated || annotations.deprecatedSince !== undefined;
-export { annotationsFromNode, documentedFromNode, hasAnnotations };
+export { documentedFromNode, hasAnnotations };
 //# sourceMappingURL=annotations.js.map

package/dist/gir/annotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/gir/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAoBhG,MAAM,mBAAmB,GAAG,CAAC,IAAyB,EAAkB,EAAE,CAAC,CAAC;IACxE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;IAC5B,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5C,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACjD,cAAc,EAAE,gBAAgB,CAAC,IAAI,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,IAAa,EAAkB,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,WAA2B,EAAW,EAAE,CAC5D,WAAW,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,YAAY,IAAI,WAAW,CAAC,eAAe,KAAK,SAAS,CAAC;AAE7G,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAuB,CAAC","sourcesContent":["import { attr, getDoc, getDocDeprecated, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\n\n/** Release and deprecation annotations GIR carries on a documentable element. */\ntype GirAnnotations = {\n    /** Library release the symbol appeared in, from the `version` attribute. */\n    since: string | undefined;\n    /** Whether GIR marks the symbol deprecated. */\n    isDeprecated: boolean;\n    /** Release the symbol was deprecated in, from the `deprecated-version` attribute. */\n    deprecatedSince: string | undefined;\n    /** Prose from `<doc-deprecated>` naming what to use instead. */\n    deprecationDoc: string | undefined;\n};\n\ntype DocumentedNode = {\n    name: string;\n    doc: string | undefined;\n    annotations: GirAnnotations;\n};\n\nconst annotationsFromNode = (node: RawNode | undefined): GirAnnotations => ({\n    since: attr(node, \"version\"),\n    isDeprecated: isAttrTrue(node, \"deprecated\"),\n    deprecatedSince: attr(node, \"deprecated-version\"),\n    deprecationDoc: getDocDeprecated(node),\n});\n\nconst documentedFromNode = (node: RawNode): DocumentedNode => ({\n    name: nameAttr(node),\n    doc: getDoc(node),\n    annotations: annotationsFromNode(node),\n});\n\nconst hasAnnotations = (annotations: GirAnnotations): boolean =>\n    annotations.since !== undefined || annotations.isDeprecated || annotations.deprecatedSince !== undefined;\n\nexport { annotationsFromNode, documentedFromNode, hasAnnotations, type GirAnnotations };\n"]}
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/gir/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAoBhG,MAAM,mBAAmB,GAAG,CAAC,IAAyB,EAAkB,EAAE,CAAC,CAAC;IACxE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;IAC5B,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5C,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACjD,cAAc,EAAE,gBAAgB,CAAC,IAAI,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,IAAa,EAAkB,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,WAA2B,EAAW,EAAE,CAC5D,WAAW,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,YAAY,IAAI,WAAW,CAAC,eAAe,KAAK,SAAS,CAAC;AAE7G,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAuB,CAAC","sourcesContent":["import { attr, getDoc, getDocDeprecated, isAttrTrue, nameAttr, type RawNode } from \"./parse.js\";\n\n/** Release and deprecation annotations GIR carries on a documentable element. */\ntype GirAnnotations = {\n    /** Library release the symbol appeared in, from the `version` attribute. */\n    since: string | undefined;\n    /** Whether GIR marks the symbol deprecated. */\n    isDeprecated: boolean;\n    /** Release the symbol was deprecated in, from the `deprecated-version` attribute. */\n    deprecatedSince: string | undefined;\n    /** Prose from `<doc-deprecated>` naming what to use instead. */\n    deprecationDoc: string | undefined;\n};\n\ntype DocumentedNode = {\n    name: string;\n    doc: string | undefined;\n    annotations: GirAnnotations;\n};\n\nconst annotationsFromNode = (node: RawNode | undefined): GirAnnotations => ({\n    since: attr(node, \"version\"),\n    isDeprecated: isAttrTrue(node, \"deprecated\"),\n    deprecatedSince: attr(node, \"deprecated-version\"),\n    deprecationDoc: getDocDeprecated(node),\n});\n\nconst documentedFromNode = (node: RawNode): DocumentedNode => ({\n    name: nameAttr(node),\n    doc: getDoc(node),\n    annotations: annotationsFromNode(node),\n});\n\nconst hasAnnotations = (annotations: GirAnnotations): boolean =>\n    annotations.since !== undefined || annotations.isDeprecated || annotations.deprecatedSince !== undefined;\n\nexport { documentedFromNode, hasAnnotations, type GirAnnotations };\n"]}

package/dist/gir/cursor-overrides.d.ts

@@ -0,0 +1,8 @@
+type CursorParameterNames = {
+    cursor: string;
+    base: string;
+    length: string;
+};
+declare const PARAMETERS_MISSING_ARRAY_EXTENT: Map<string, CursorParameterNames[]>;
+export { PARAMETERS_MISSING_ARRAY_EXTENT, type CursorParameterNames };
+//# sourceMappingURL=cursor-overrides.d.ts.map

package/dist/gir/cursor-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-overrides.d.ts","sourceRoot":"","sources":["../../src/gir/cursor-overrides.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,QAAA,MAAM,+BAA+B,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAGvE,CAAC;AAEH,OAAO,EAAE,+BAA+B,EAAE,KAAK,oBAAoB,EAAE,CAAC"}

package/dist/gir/cursor-overrides.js

@@ -0,0 +1,6 @@
+const PARAMETERS_MISSING_ARRAY_EXTENT = new Map([
+    ["g_utf8_validate", [{ cursor: "end", base: "str", length: "max_len" }]],
+    ["g_utf8_validate_len", [{ cursor: "end", base: "str", length: "max_len" }]],
+]);
+export { PARAMETERS_MISSING_ARRAY_EXTENT };
+//# sourceMappingURL=cursor-overrides.js.map

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/gir-path.d.ts

@@ -1,7 +1,7 @@
 /**
  * The directories to search for `.gir` files, in precedence order: the config's own `girPath`, then
  * `GTKX_GIR_PATH`, then `/usr/share/gir-1.0`, then the girdir pkg-config reports for
- * gobject-introspection-1.0. Duplicates are dropped, and the last two are included only when they exist.
+ * gobject-introspection-1.0. Duplicates are dropped, and the system directories are included only when they exist.
  *
  * @throws If pkg-config is installed but fails while being queried.
  */

package/dist/gir/gir-path.js

@@ -5,7 +5,7 @@ const SYSTEM_GIR_PATH = "/usr/share/gir-1.0";
 /**
  * The directories to search for `.gir` files, in precedence order: the config's own `girPath`, then
  * `GTKX_GIR_PATH`, then `/usr/share/gir-1.0`, then the girdir pkg-config reports for
- * gobject-introspection-1.0. Duplicates are dropped, and the last two are included only when they exist.
+ * gobject-introspection-1.0. Duplicates are dropped, and the system directories are included only when they exist.
  *
  * @throws If pkg-config is installed but fails while being queried.
  */

package/dist/gir/gir-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"gir-path.js","sourceRoot":"","sources":["../../src/gir/gir-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,CAAC,aAAmC,EAAY,EAAE;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,aAAa,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAE1C,IAAI,OAAO,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC;IAE7C,IAAI,aAAa,KAAK,SAAS,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAS,EAAE;IACnD,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9C,OAAO,IAAI,KAAK,CAAC,8DAA8D,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/G,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAuB,EAAE;IAC9C,IAAI,CAAC;QACD,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,GAAuB,EAAE;IAClD,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IAErC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,EAAE;YACvF,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QAED,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { formatChildProcessError, resolveExecutable } from \"@gtkx/utils\";\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\n\nconst SYSTEM_GIR_PATH = \"/usr/share/gir-1.0\";\n\n/**\n * The directories to search for `.gir` files, in precedence order: the config's own `girPath`, then\n * `GTKX_GIR_PATH`, then `/usr/share/gir-1.0`, then the girdir pkg-config reports for\n * gobject-introspection-1.0. Duplicates are dropped, and the last two are included only when they exist.\n *\n * @throws If pkg-config is installed but fails while being queried.\n */\nconst resolveGirPath = (configGirPath: string[] | undefined): string[] => {\n    const paths: string[] = [];\n\n    if (configGirPath) {\n        paths.push(...configGirPath);\n    }\n\n    const envPath = process.env.GTKX_GIR_PATH;\n\n    if (envPath) {\n        paths.push(...envPath.split(\":\").filter((path) => path.length > 0));\n    }\n\n    if (existsSync(SYSTEM_GIR_PATH)) {\n        paths.push(SYSTEM_GIR_PATH);\n    }\n\n    const pkgConfigPath = queryPkgConfigGirDir();\n\n    if (pkgConfigPath !== undefined && existsSync(pkgConfigPath)) {\n        paths.push(pkgConfigPath);\n    }\n\n    return [...new Set(paths)];\n};\n\nconst pkgConfigGirDirError = (error: unknown): Error => {\n    const details = formatChildProcessError(error);\n    const suffix = details ? `:\\n${details}` : \"\";\n\n    return new Error(`pkg-config failed querying gobject-introspection-1.0 girdir${suffix}`, { cause: error });\n};\n\nconst resolvePkgConfig = (): string | undefined => {\n    try {\n        return resolveExecutable(\"pkg-config\");\n    } catch {\n        return undefined;\n    }\n};\n\nconst queryPkgConfigGirDir = (): string | undefined => {\n    const pkgConfig = resolvePkgConfig();\n\n    if (pkgConfig === undefined) {\n        return undefined;\n    }\n\n    try {\n        const output = execFileSync(pkgConfig, [\"--variable=girdir\", \"gobject-introspection-1.0\"], {\n            encoding: \"utf8\",\n            stdio: [\"ignore\", \"pipe\", \"pipe\"],\n        });\n\n        const trimmed = output.trim();\n\n        return trimmed.length > 0 ? trimmed : undefined;\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n            return;\n        }\n\n        throw pkgConfigGirDirError(error);\n    }\n};\n\nexport { resolveGirPath };\n"]}
+{"version":3,"file":"gir-path.js","sourceRoot":"","sources":["../../src/gir/gir-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,CAAC,aAAmC,EAAY,EAAE;IACrE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,aAAa,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAE1C,IAAI,OAAO,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC;IAE7C,IAAI,aAAa,KAAK,SAAS,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAS,EAAE;IACnD,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9C,OAAO,IAAI,KAAK,CAAC,8DAA8D,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/G,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAuB,EAAE;IAC9C,IAAI,CAAC;QACD,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,GAAuB,EAAE;IAClD,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IAErC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,EAAE;YACvF,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QAED,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { formatChildProcessError, resolveExecutable } from \"@gtkx/utils\";\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\n\nconst SYSTEM_GIR_PATH = \"/usr/share/gir-1.0\";\n\n/**\n * The directories to search for `.gir` files, in precedence order: the config's own `girPath`, then\n * `GTKX_GIR_PATH`, then `/usr/share/gir-1.0`, then the girdir pkg-config reports for\n * gobject-introspection-1.0. Duplicates are dropped, and the system directories are included only when they exist.\n *\n * @throws If pkg-config is installed but fails while being queried.\n */\nconst resolveGirPath = (configGirPath: string[] | undefined): string[] => {\n    const paths: string[] = [];\n\n    if (configGirPath) {\n        paths.push(...configGirPath);\n    }\n\n    const envPath = process.env.GTKX_GIR_PATH;\n\n    if (envPath) {\n        paths.push(...envPath.split(\":\").filter((path) => path.length > 0));\n    }\n\n    if (existsSync(SYSTEM_GIR_PATH)) {\n        paths.push(SYSTEM_GIR_PATH);\n    }\n\n    const pkgConfigPath = queryPkgConfigGirDir();\n\n    if (pkgConfigPath !== undefined && existsSync(pkgConfigPath)) {\n        paths.push(pkgConfigPath);\n    }\n\n    return [...new Set(paths)];\n};\n\nconst pkgConfigGirDirError = (error: unknown): Error => {\n    const details = formatChildProcessError(error);\n    const suffix = details ? `:\\n${details}` : \"\";\n\n    return new Error(`pkg-config failed querying gobject-introspection-1.0 girdir${suffix}`, { cause: error });\n};\n\nconst resolvePkgConfig = (): string | undefined => {\n    try {\n        return resolveExecutable(\"pkg-config\");\n    } catch {\n        return undefined;\n    }\n};\n\nconst queryPkgConfigGirDir = (): string | undefined => {\n    const pkgConfig = resolvePkgConfig();\n\n    if (pkgConfig === undefined) {\n        return undefined;\n    }\n\n    try {\n        const output = execFileSync(pkgConfig, [\"--variable=girdir\", \"gobject-introspection-1.0\"], {\n            encoding: \"utf8\",\n            stdio: [\"ignore\", \"pipe\", \"pipe\"],\n        });\n\n        const trimmed = output.trim();\n\n        return trimmed.length > 0 ? trimmed : undefined;\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n            return;\n        }\n\n        throw pkgConfigGirDirError(error);\n    }\n};\n\nexport { resolveGirPath };\n"]}

package/dist/gir/library.d.ts

@@ -12,15 +12,17 @@ declare class Library {
      *
      * @param libraries GIR identifiers to load, such as `Gtk-4.0`.
      * @param girPath Directories searched, in order, for each `.gir` file.
+     * @param isByteArrayTyped Whether byte sequences render as `Uint8Array` rather than `number[]`.
      * @returns A library holding every namespace that was parsed.
      */
-    static load(libraries: string[], girPath: string[]): Library;
+    static load(libraries: string[], girPath: string[], isByteArrayTyped?: boolean): Library;
     private namespacesByName;
     private namespaceById;
     private nsNameById;
     private nsIdByName;
     private typeTables;
     private girFilesValue;
+    private isByteArrayTypedValue;
     /** Creates a library with no namespaces loaded; {@link Library.load} builds a populated one. */
     constructor();
     private ensureNsId;
@@ -44,6 +46,8 @@ declare class Library {
     private discoverNamespaces;
     /** The loaded namespaces, keyed by their GIR name such as `Gtk`. */
     get namespaces(): Map<string, GirNamespace>;
+    /** Whether byte sequences render as `Uint8Array` rather than `number[]`. */
+    get isByteArrayTyped(): boolean;
     /** Paths of the `.gir` files that were read, in the order they were discovered. */
     get girFiles(): string[];
     /**

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

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