@gtkx/codegen 0.21.0

package/dist/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAgBnG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAA2B,EAAE,SAA4B,EAAU,EAAE;IACpG,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC,CAAC"}

package/dist/gi-store.d.ts

@@ -0,0 +1,34 @@
+import { type CodegenFingerprint } from "./fingerprint.js";
+import { type StoreOptions } from "./store-fs.js";
+/**
+ * Options for assembling the injected `@gtkx/gi` package.
+ */
+export type GiStoreOptions = StoreOptions & {
+    /** Real (symlink-resolved) directory of the installed `@gtkx/ffi`. */
+    readonly realFfiDir: string;
+    /** Real (symlink-resolved) directory of the installed `@gtkx/native`. */
+    readonly realNativeDir: string;
+};
+/** Per-namespace inputs the store assembler turns into gi modules. */
+export type GiNamespaceInput = {
+    /** Lowercased namespace directory name (e.g. `"gtk"`). */
+    readonly directory: string;
+    /** Transpilable raw module source, or `null` for augment-only namespaces (gl). */
+    readonly rawSource: string | null;
+};
+/**
+ * Assembles the self-contained injected `@gtkx/gi` package.
+ *
+ * Writes every namespace's raw generated module, its augment overlay, and its
+ * barrel into a temporary store, emits the `package.json` and gi's own
+ * `node_modules/@gtkx/{ffi,gi}` symlinks — the self-referential `@gtkx/gi` link
+ * lets augment modules resolve sibling namespaces without relying on the
+ * project's top-level alias — swaps it into place, and points the visible
+ * `node_modules/@gtkx/gi` alias at it.
+ *
+ * @param options - Resolved store/link/dependency paths
+ * @param namespaces - Per-namespace raw module inputs
+ * @param fingerprint - Staleness sentinel written into the store, when provided
+ */
+export declare const writeGiStore: (options: GiStoreOptions, namespaces: readonly GiNamespaceInput[], fingerprint?: CodegenFingerprint) => void;
+//# sourceMappingURL=gi-store.d.ts.map

package/dist/gi-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gi-store.d.ts","sourceRoot":"","sources":["../src/gi-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAwB,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,eAAe,CAAC;AAY9D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG;IACxC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAsGF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GACrB,SAAS,cAAc,EACvB,YAAY,SAAS,gBAAgB,EAAE,EACvC,cAAc,kBAAkB,KACjC,IA8CF,CAAC"}

package/dist/gi-store.js

@@ -0,0 +1,154 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { FINGERPRINT_FILENAME } from "./fingerprint.js";
+import { writeStore } from "./store-fs.js";
+import { transpileSource } from "./transpile.js";
+import { typecheckGiStore } from "./typecheck-store.js";
+/**
+ * Absolute path to the hand-written augment overlay shipped with `@gtkx/codegen`.
+ *
+ * Resolves the same way whether codegen runs from `src/` (tsx) or `dist/`,
+ * since `overlay/` sits at the package root next to both.
+ */
+const OVERLAY_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "overlay");
+/** Returns the augment `.ts` files for a namespace, or `[]` when it is pure pass-through. */
+const overlayFiles = (directory) => {
+    const dir = join(OVERLAY_ROOT, directory);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir).filter((name) => name.endsWith(".ts") && name !== "index.ts");
+};
+const isAugmented = (directory) => existsSync(join(OVERLAY_ROOT, directory, "index.ts"));
+/**
+ * Whether an augmented namespace's barrel re-exports a generated module (and so
+ * may only be emitted when that namespace is generated), as opposed to a
+ * standalone overlay like `gl` that has no GIR backing.
+ */
+const barrelNeedsGenerated = (directory) => readFileSync(join(OVERLAY_ROOT, directory, "index.ts"), "utf8").includes("../generated/");
+/**
+ * Retargets a barrel-template specifier from its source layout (under
+ * `overlay/<ns>/`) to its emitted layout (under `gi/<ns>/`): the namespace's
+ * own generated module becomes a sibling, augment files move under `augment/`,
+ * and relative runtime modules collapse to the `@gtkx/ffi` barrel. The
+ * `@gtkx/native` specifier passes through so low-level primitives resolve
+ * straight to the native package.
+ */
+const retargetBarrelSpecifier = (spec, directory) => {
+    const generated = spec.match(/^\.\.\/generated\/[a-z0-9]+\/([a-z0-9]+)\.js$/);
+    if (generated)
+        return `./${generated[1]}.js`;
+    if (spec.startsWith("../"))
+        return "@gtkx/ffi";
+    const sibling = spec.match(/^\.\/([a-z0-9-]+)\.js$/);
+    if (sibling) {
+        return existsSync(join(OVERLAY_ROOT, directory, `${sibling[1]}.ts`))
+            ? `./augment/${sibling[1]}.js`
+            : "@gtkx/ffi";
+    }
+    return spec;
+};
+const barrelSource = (directory) => {
+    if (!isAugmented(directory)) {
+        return `export * from "./${directory}.js";\n`;
+    }
+    const template = readFileSync(join(OVERLAY_ROOT, directory, "index.ts"), "utf8");
+    return template.replace(/"([^"]+)"/g, (_match, spec) => `"${retargetBarrelSpecifier(spec, directory)}"`);
+};
+/**
+ * Gathers the per-namespace generated module, augment overlay, and barrel
+ * sources into a flat file list, building the package `exports` map alongside.
+ */
+const collectStoreSources = (directories, standaloneSet, rawByDirectory) => {
+    const exportsMap = { "./package.json": "./package.json" };
+    const collected = [];
+    for (const directory of directories) {
+        const rawSource = standaloneSet.has(directory) ? null : (rawByDirectory.get(directory) ?? null);
+        if (rawSource !== null) {
+            collected.push({
+                stem: `${directory}/${directory}`,
+                fileName: `${directory}/${directory}.ts`,
+                source: rawSource,
+                overlay: false,
+            });
+            exportsMap[`./${directory}/${directory}.js`] = {
+                types: `./${directory}/${directory}.d.ts`,
+                default: `./${directory}/${directory}.js`,
+            };
+        }
+        for (const file of overlayFiles(directory)) {
+            collected.push({
+                stem: `${directory}/augment/${file.slice(0, -".ts".length)}`,
+                fileName: `${directory}/augment/${file}`,
+                source: readFileSync(join(OVERLAY_ROOT, directory, file), "utf8"),
+                overlay: true,
+            });
+        }
+        collected.push({
+            stem: `${directory}/index`,
+            fileName: `${directory}/index.ts`,
+            source: barrelSource(directory),
+            overlay: false,
+        });
+        exportsMap[`./${directory}`] = {
+            types: `./${directory}/index.d.ts`,
+            default: `./${directory}/index.js`,
+        };
+    }
+    return { collected, exportsMap };
+};
+/**
+ * Assembles the self-contained injected `@gtkx/gi` package.
+ *
+ * Writes every namespace's raw generated module, its augment overlay, and its
+ * barrel into a temporary store, emits the `package.json` and gi's own
+ * `node_modules/@gtkx/{ffi,gi}` symlinks — the self-referential `@gtkx/gi` link
+ * lets augment modules resolve sibling namespaces without relying on the
+ * project's top-level alias — swaps it into place, and points the visible
+ * `node_modules/@gtkx/gi` alias at it.
+ *
+ * @param options - Resolved store/link/dependency paths
+ * @param namespaces - Per-namespace raw module inputs
+ * @param fingerprint - Staleness sentinel written into the store, when provided
+ */
+export const writeGiStore = (options, namespaces, fingerprint) => {
+    const standaloneOverlays = readdirSync(OVERLAY_ROOT).filter((name) => isAugmented(name) && !barrelNeedsGenerated(name));
+    const standaloneSet = new Set(standaloneOverlays);
+    const directories = new Set([...namespaces.map((n) => n.directory), ...standaloneOverlays]);
+    const rawByDirectory = new Map(namespaces.map((n) => [n.directory, n.rawSource]));
+    const { collected, exportsMap } = collectStoreSources(directories, standaloneSet, rawByDirectory);
+    writeStore({
+        storeDir: options.storeDir,
+        linkDir: options.linkDir,
+        files: collected.map((file) => ({ stem: file.stem, fileName: file.fileName, source: file.source })),
+        manifest: {
+            name: "@gtkx/gi",
+            type: "module",
+            version: options.version,
+            sideEffects: true,
+            exports: exportsMap,
+        },
+        rawFiles: fingerprint === undefined
+            ? []
+            : [{ relativePath: FINGERPRINT_FILENAME, content: `${JSON.stringify(fingerprint, null, 2)}\n` }],
+        symlinks: [
+            { segments: ["node_modules", "@gtkx", "ffi"], target: options.realFfiDir },
+            { segments: ["node_modules", "@gtkx", "native"], target: options.realNativeDir },
+            { segments: ["node_modules", "@gtkx", "gi"], target: "self" },
+        ],
+        validate: (tmp) => {
+            const sources = collected.map((file) => file.overlay
+                ? { path: join(tmp, file.fileName), source: file.source, overlay: true }
+                : {
+                    path: join(tmp, `${file.stem}.d.ts`),
+                    source: transpileSource(file.fileName, file.source).dts,
+                    overlay: false,
+                });
+            typecheckGiStore(tmp, sources, {
+                ffiEntry: join(options.realFfiDir, "src", "index.ts"),
+                nativeEntry: join(options.realNativeDir, "dist", "index.d.ts"),
+            });
+        },
+    });
+};
+//# sourceMappingURL=gi-store.js.map

package/dist/gi-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gi-store.js","sourceRoot":"","sources":["../src/gi-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAA2B,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAqB,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAwB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAoBvF,6FAA6F;AAC7F,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAqB,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC;AAC1F,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1G;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,CAAC,SAAiB,EAAW,EAAE,CACxD,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAE9F;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAU,EAAE;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC9E,IAAI,SAAS;QAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACrD,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChE,CAAC,CAAC,aAAa,OAAO,CAAC,CAAC,CAAC,KAAK;YAC9B,CAAC,CAAC,WAAW,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC/C,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,oBAAoB,SAAS,SAAS,CAAC;IAClD,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACjF,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,uBAAuB,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7G,CAAC,CAAC;AASF;;;GAGG;AACH,MAAM,mBAAmB,GAAG,CACxB,WAAgC,EAChC,aAAkC,EAClC,cAAkD,EACiB,EAAE;IACrE,MAAM,UAAU,GAA4B,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACnF,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC;QAChG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE;gBACjC,QAAQ,EAAE,GAAG,SAAS,IAAI,SAAS,KAAK;gBACxC,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,UAAU,CAAC,KAAK,SAAS,IAAI,SAAS,KAAK,CAAC,GAAG;gBAC3C,KAAK,EAAE,KAAK,SAAS,IAAI,SAAS,OAAO;gBACzC,OAAO,EAAE,KAAK,SAAS,IAAI,SAAS,KAAK;aAC5C,CAAC;QACN,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,SAAS,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,SAAS,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;gBAC5D,QAAQ,EAAE,GAAG,SAAS,YAAY,IAAI,EAAE;gBACxC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBACjE,OAAO,EAAE,IAAI;aAChB,CAAC,CAAC;QACP,CAAC;QACD,SAAS,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,SAAS,QAAQ;YAC1B,QAAQ,EAAE,GAAG,SAAS,WAAW;YACjC,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC;YAC/B,OAAO,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC,GAAG;YAC3B,KAAK,EAAE,KAAK,SAAS,aAAa;YAClC,OAAO,EAAE,KAAK,SAAS,WAAW;SACrC,CAAC;IACN,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CACxB,OAAuB,EACvB,UAAuC,EACvC,WAAgC,EAC5B,EAAE;IACN,MAAM,kBAAkB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CACvD,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAC7D,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,CAAC,CAAC,CAAC;IACpG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAElF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,mBAAmB,CAAC,WAAW,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IAElG,UAAU,CAAC;QACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACnG,QAAQ,EAAE;YACN,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,UAAU;SACtB;QACD,QAAQ,EACJ,WAAW,KAAK,SAAS;YACrB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxG,QAAQ,EAAE;YACN,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;YAC1E,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;YAChF,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;SAChE;QACD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,MAAM,OAAO,GAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtD,IAAI,CAAC,OAAO;gBACR,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;gBACxE,CAAC,CAAC;oBACI,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC;oBACpC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG;oBACvD,OAAO,EAAE,KAAK;iBACjB,CACV,CAAC;YACF,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE;gBAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC;gBACrD,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC;aACjE,CAAC,CAAC;QACP,CAAC;KACJ,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/gir/boxed.d.ts

@@ -0,0 +1,66 @@
+import { type GirField } from "./field.js";
+import { type GirFunction } from "./function.js";
+import { type RawNode } from "./parse.js";
+/**
+ * Discriminator for the different shapes a `<record>` (or `<glib:boxed>`)
+ * can take in GIR.
+ *
+ * - `boxed` — a record with a `glib:get-type`; registers as a GObject boxed.
+ * - `plain-struct` — a record without GType; passed by pointer using
+ *   `t.struct(ownership)`.
+ * - `vtable` — a record carrying `glib:is-gtype-struct-for`; its fields are
+ *   function pointers consumed by the class struct registration.
+ * - `glib-boxed` — a top-level `<glib:boxed>` element with no struct body.
+ */
+export type BoxedKind = "boxed" | "plain-struct" | "vtable" | "glib-boxed";
+/** A `<record>`, `<glib:boxed>`, or `<union>` declaration. */
+export type GirBoxed = {
+    readonly kind: BoxedKind;
+    /** Local name inside the namespace (no prefix). */
+    readonly name: string;
+    readonly cType: string | undefined;
+    /** GLib type name (e.g. `"GtkBorder"`); absent on plain structs. */
+    readonly glibTypeName: string | undefined;
+    /** GLib get-type C symbol; absent on plain structs. */
+    readonly glibGetType: string | undefined;
+    /** Class name this record is the vtable for (`glib:is-gtype-struct-for`). */
+    readonly glibIsGTypeStructFor: string | undefined;
+    /** GLib ref/unref/etc. function names on fundamentals. */
+    readonly glibRefFunc: string | undefined;
+    readonly glibUnrefFunc: string | undefined;
+    readonly glibSetValueFunc: string | undefined;
+    readonly glibGetValueFunc: string | undefined;
+    /** `copy-function`/`free-function` — the ref/unref pair for records that are reference-counted rather than g_boxed-copyable. */
+    readonly copyFunc: string | undefined;
+    readonly freeFunc: string | undefined;
+    /** `disguised="1"` — record has no introspectable fields. */
+    readonly disguised: boolean;
+    /** `opaque="1"` — record is opaque to callers. */
+    readonly opaque: boolean;
+    readonly introspectable: boolean;
+    readonly fields: readonly GirField[];
+    readonly methods: readonly GirFunction[];
+    readonly constructors: readonly GirFunction[];
+    readonly functions: readonly GirFunction[];
+    /** `true` when the source element was `<union>` rather than `<record>`. */
+    readonly isUnion: boolean;
+};
+/**
+ * Builds a {@link GirBoxed} from a `<record>`, `<union>`, or `<glib:boxed>` element.
+ *
+ * @param node - The XML element
+ * @param kind - The kind inferred from element name and attribute set
+ * @param isUnion - `true` when the source element was `<union>`
+ */
+export declare const boxedFromNode: (node: RawNode, kind: BoxedKind, isUnion: boolean) => GirBoxed;
+/**
+ * Decides which {@link BoxedKind} applies to a `<record>` or `<union>` element.
+ *
+ * Vtable records (`glib:is-gtype-struct-for`) take precedence; otherwise a
+ * `glib:get-type` flips the record to a registered boxed; otherwise it's a
+ * plain struct.
+ *
+ * @param node - The `<record>` or `<union>` element
+ */
+export declare const boxedKind: (node: RawNode) => BoxedKind;
+//# sourceMappingURL=boxed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boxed.d.ts","sourceRoot":"","sources":["../../src/gir/boxed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAmD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE3E,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,gIAAgI;IAChI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,OAAO,KAAG,QAqB/E,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,KAAG,SAIzC,CAAC"}

package/dist/gir/boxed.js

@@ -0,0 +1,49 @@
+import { fieldFromNode } from "./field.js";
+import { functionFromNode } from "./function.js";
+import { attr, attrBool, childrenOf, GIR_CONSTRUCTOR_TAG } from "./parse.js";
+/**
+ * Builds a {@link GirBoxed} from a `<record>`, `<union>`, or `<glib:boxed>` element.
+ *
+ * @param node - The XML element
+ * @param kind - The kind inferred from element name and attribute set
+ * @param isUnion - `true` when the source element was `<union>`
+ */
+export const boxedFromNode = (node, kind, isUnion) => ({
+    kind,
+    name: attr(node, "name") ?? attr(node, "glib:name") ?? "",
+    cType: attr(node, "c:type"),
+    glibTypeName: attr(node, "glib:type-name"),
+    glibGetType: attr(node, "glib:get-type"),
+    glibIsGTypeStructFor: attr(node, "glib:is-gtype-struct-for"),
+    glibRefFunc: attr(node, "glib:ref-func"),
+    glibUnrefFunc: attr(node, "glib:unref-func"),
+    glibSetValueFunc: attr(node, "glib:set-value-func"),
+    glibGetValueFunc: attr(node, "glib:get-value-func"),
+    copyFunc: attr(node, "copy-function"),
+    freeFunc: attr(node, "free-function"),
+    disguised: attrBool(node, "disguised"),
+    opaque: attrBool(node, "opaque"),
+    introspectable: attr(node, "introspectable") !== "0",
+    fields: childrenOf(node, "field").map(fieldFromNode),
+    methods: childrenOf(node, "method").map((method) => functionFromNode(method, "method")),
+    constructors: childrenOf(node, GIR_CONSTRUCTOR_TAG).map((ctor) => functionFromNode(ctor, "constructor")),
+    functions: childrenOf(node, "function").map((function_) => functionFromNode(function_, "function")),
+    isUnion,
+});
+/**
+ * Decides which {@link BoxedKind} applies to a `<record>` or `<union>` element.
+ *
+ * Vtable records (`glib:is-gtype-struct-for`) take precedence; otherwise a
+ * `glib:get-type` flips the record to a registered boxed; otherwise it's a
+ * plain struct.
+ *
+ * @param node - The `<record>` or `<union>` element
+ */
+export const boxedKind = (node) => {
+    if (attr(node, "glib:is-gtype-struct-for") !== undefined)
+        return "vtable";
+    if (attr(node, "glib:get-type") !== undefined)
+        return "boxed";
+    return "plain-struct";
+};
+//# sourceMappingURL=boxed.js.map

package/dist/gir/boxed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boxed.js","sourceRoot":"","sources":["../../src/gir/boxed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAgB,MAAM,YAAY,CAAC;AAgD3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,IAAe,EAAE,OAAgB,EAAY,EAAE,CAAC,CAAC;IAC1F,IAAI;IACJ,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE;IACzD,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC1C,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,oBAAoB,EAAE,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC5D,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAC5C,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACrC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IACtC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAChC,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,GAAG;IACpD,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;IACpD,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvF,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxG,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACnG,OAAO;CACV,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAa,EAAa,EAAE;IAClD,IAAI,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC1E,IAAI,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC9D,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC"}

package/dist/gir/callback.d.ts

@@ -0,0 +1,15 @@
+import { type GirParameter, type GirReturnValue } from "./parameter.js";
+import { type RawNode } from "./parse.js";
+/** A `<callback>` declaration (top-level inside a namespace or nested in a field). */
+export type GirCallback = {
+    readonly name: string;
+    readonly cType: string | undefined;
+    readonly parameters: readonly GirParameter[];
+    readonly returnValue: GirReturnValue;
+    readonly introspectable: boolean;
+};
+/**
+ * Builds a {@link GirCallback} from a `<callback>` element.
+ */
+export declare const callbackFromNode: (node: RawNode) => GirCallback;
+//# sourceMappingURL=callback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../src/gir/callback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAA0C,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAErE,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,WAUhD,CAAC"}

package/dist/gir/callback.js

@@ -0,0 +1,17 @@
+import { parameterFromNode, returnValueFromNode } from "./parameter.js";
+import { attr, childOf, childrenOf } from "./parse.js";
+/**
+ * Builds a {@link GirCallback} from a `<callback>` element.
+ */
+export const callbackFromNode = (node) => {
+    const parametersNode = childOf(node, "parameters");
+    const parameterNodes = childrenOf(parametersNode, "parameter");
+    return {
+        name: attr(node, "name") ?? "",
+        cType: attr(node, "c:type"),
+        parameters: parameterNodes.map((parameter) => parameterFromNode(parameter, false)),
+        returnValue: returnValueFromNode(childOf(node, "return-value")),
+        introspectable: attr(node, "introspectable") !== "0",
+    };
+};
+//# sourceMappingURL=callback.js.map

package/dist/gir/callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.js","sourceRoot":"","sources":["../../src/gir/callback.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAWrE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAe,EAAE;IAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC/D,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC3B,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClF,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/D,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,GAAG;KACvD,CAAC;AACN,CAAC,CAAC"}

package/dist/gir/class.d.ts

@@ -0,0 +1,49 @@
+import { type GirField } from "./field.js";
+import { type GirFunction } from "./function.js";
+import { type RawNode } from "./parse.js";
+import { type GirProperty } from "./property.js";
+import { type GirSignal } from "./signal.js";
+/** A `<class>` or `<interface>` declaration. */
+export type GirClass = {
+    /** Local name inside the namespace (no prefix). */
+    readonly name: string;
+    readonly cType: string | undefined;
+    /** GIR `parent`, possibly cross-namespace (e.g. `"GObject.InitiallyUnowned"`). */
+    readonly parent: string | undefined;
+    /** GLib type name (e.g. `"GtkWidget"`). */
+    readonly glibTypeName: string | undefined;
+    /** C symbol that returns the GType integer (e.g. `"gtk_widget_get_type"`). */
+    readonly glibGetType: string | undefined;
+    /** Local record name that holds this class's vtable (`glib:type-struct`). */
+    readonly glibTypeStruct: string | undefined;
+    /** Glib ref/unref/etc. function names on fundamentals; not used for GObject subclasses. */
+    readonly glibRefFunc: string | undefined;
+    readonly glibUnrefFunc: string | undefined;
+    readonly glibSetValueFunc: string | undefined;
+    readonly glibGetValueFunc: string | undefined;
+    /** `glib:fundamental="1"` — a non-GObject fundamental type (e.g. `GdkEvent`, `GskRenderNode`). */
+    readonly fundamental: boolean;
+    readonly abstract: boolean;
+    readonly final: boolean;
+    readonly isInterface: boolean;
+    readonly introspectable: boolean;
+    /** Names of interfaces this class implements (cross-namespace possible). */
+    readonly implements: readonly string[];
+    /** Names of interfaces a `<interface>` requires (`<prerequisite>` elements). */
+    readonly prerequisites: readonly string[];
+    readonly methods: readonly GirFunction[];
+    readonly constructors: readonly GirFunction[];
+    readonly functions: readonly GirFunction[];
+    readonly virtualMethods: readonly GirFunction[];
+    readonly properties: readonly GirProperty[];
+    readonly signals: readonly GirSignal[];
+    readonly fields: readonly GirField[];
+};
+/**
+ * Builds a {@link GirClass} from a `<class>` or `<interface>` element.
+ *
+ * @param node - The XML element
+ * @param isInterface - `true` when the source element was `<interface>`
+ */
+export declare const classFromNode: (node: RawNode, isInterface: boolean) => GirClass;
+//# sourceMappingURL=class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../src/gir/class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAmD,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,KAAK,WAAW,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,aAAa,CAAC;AAE7D,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG;IACnB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,kGAAkG;IAClG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,SAAS,WAAW,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CACxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,aAAa,OAAO,KAAG,QA6BlE,CAAC"}

package/dist/gir/class.js

@@ -0,0 +1,42 @@
+import { fieldFromNode } from "./field.js";
+import { functionFromNode } from "./function.js";
+import { attr, attrBool, childrenOf, GIR_CONSTRUCTOR_TAG } from "./parse.js";
+import { propertyFromNode } from "./property.js";
+import { signalFromNode } from "./signal.js";
+/**
+ * Builds a {@link GirClass} from a `<class>` or `<interface>` element.
+ *
+ * @param node - The XML element
+ * @param isInterface - `true` when the source element was `<interface>`
+ */
+export const classFromNode = (node, isInterface) => ({
+    name: attr(node, "name") ?? "",
+    cType: attr(node, "c:type"),
+    parent: attr(node, "parent"),
+    glibTypeName: attr(node, "glib:type-name"),
+    glibGetType: attr(node, "glib:get-type"),
+    glibTypeStruct: attr(node, "glib:type-struct"),
+    glibRefFunc: attr(node, "glib:ref-func"),
+    glibUnrefFunc: attr(node, "glib:unref-func"),
+    glibSetValueFunc: attr(node, "glib:set-value-func"),
+    glibGetValueFunc: attr(node, "glib:get-value-func"),
+    fundamental: attrBool(node, "glib:fundamental"),
+    abstract: attrBool(node, "abstract"),
+    final: attrBool(node, "final"),
+    isInterface,
+    introspectable: attr(node, "introspectable") !== "0",
+    implements: childrenOf(node, "implements")
+        .map((implement) => attr(implement, "name"))
+        .filter((name) => name !== undefined),
+    prerequisites: childrenOf(node, "prerequisite")
+        .map((prerequisite) => attr(prerequisite, "name"))
+        .filter((name) => name !== undefined),
+    methods: childrenOf(node, "method").map((method) => functionFromNode(method, "method")),
+    constructors: childrenOf(node, GIR_CONSTRUCTOR_TAG).map((ctor) => functionFromNode(ctor, "constructor")),
+    functions: childrenOf(node, "function").map((function_) => functionFromNode(function_, "function")),
+    virtualMethods: childrenOf(node, "virtual-method").map((vmethod) => functionFromNode(vmethod, "virtual-method")),
+    properties: childrenOf(node, "property").map(propertyFromNode),
+    signals: childrenOf(node, "glib:signal").map(signalFromNode),
+    fields: childrenOf(node, "field").map(fieldFromNode),
+});
+//# sourceMappingURL=class.js.map

package/dist/gir/class.js.map

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

package/dist/gir/enum.d.ts

@@ -0,0 +1,39 @@
+import { type GirFunction } from "./function.js";
+import { type RawNode } from "./parse.js";
+/** A single `<member>` of an `<enumeration>` or `<bitfield>`. */
+type EnumMember = {
+    /** GIR `name`, snake_case lowercase (e.g. `"fill"`). */
+    readonly name: string;
+    /** GIR `c:identifier`, SCREAMING_SNAKE_CASE (e.g. `"GTK_ALIGN_FILL"`). */
+    readonly cIdentifier: string | undefined;
+    /** Numeric value as a string; preserved verbatim from GIR. */
+    readonly value: string;
+};
+/** Discriminator for enums vs bitfields. */
+export type EnumKind = "enumeration" | "bitfield";
+/** An `<enumeration>` or `<bitfield>` declaration. */
+export type GirEnum = {
+    readonly kind: EnumKind;
+    /** Local name within the namespace (no namespace prefix). */
+    readonly name: string;
+    readonly cType: string | undefined;
+    /** GLib type name (e.g. `"GtkAlign"`); absent for unregistered enums. */
+    readonly glibTypeName: string | undefined;
+    /** GLib get-type C symbol; absent for unregistered enums. */
+    readonly glibGetType: string | undefined;
+    /** Optional `glib:error-domain` marker; presence flips emission to `createErrorDomain`. */
+    readonly errorDomain: string | undefined;
+    readonly introspectable: boolean;
+    readonly members: readonly EnumMember[];
+    /** Free functions nested inside the enum (e.g. error quark accessors). */
+    readonly functions: readonly GirFunction[];
+};
+/**
+ * Builds a {@link GirEnum} from an `<enumeration>` or `<bitfield>` element.
+ *
+ * @param node - The XML element
+ * @param kind - `"enumeration"` or `"bitfield"`, matching the element name
+ */
+export declare const enumFromNode: (node: RawNode, kind: EnumKind) => GirEnum;
+export {};
+//# sourceMappingURL=enum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5D,iEAAiE;AACjE,KAAK,UAAU,GAAG;IACd,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAElD,sDAAsD;AACtD,MAAM,MAAM,OAAO,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,EAAE,MAAM,QAAQ,KAAG,OAc3D,CAAC"}

package/dist/gir/enum.js

@@ -0,0 +1,24 @@
+import { functionFromNode } from "./function.js";
+import { attr, childrenOf } from "./parse.js";
+/**
+ * Builds a {@link GirEnum} from an `<enumeration>` or `<bitfield>` element.
+ *
+ * @param node - The XML element
+ * @param kind - `"enumeration"` or `"bitfield"`, matching the element name
+ */
+export const enumFromNode = (node, kind) => ({
+    kind,
+    name: attr(node, "name") ?? "",
+    cType: attr(node, "c:type"),
+    glibTypeName: attr(node, "glib:type-name"),
+    glibGetType: attr(node, "glib:get-type"),
+    errorDomain: attr(node, "glib:error-domain"),
+    introspectable: attr(node, "introspectable") !== "0",
+    members: childrenOf(node, "member").map((member) => ({
+        name: attr(member, "name") ?? "",
+        cIdentifier: attr(member, "c:identifier"),
+        value: attr(member, "value") ?? "0",
+    })),
+    functions: childrenOf(node, "function").map((function_) => functionFromNode(function_, "function")),
+});
+//# sourceMappingURL=enum.js.map

package/dist/gir/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/gir/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAiC5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,IAAc,EAAW,EAAE,CAAC,CAAC;IACrE,IAAI;IACJ,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;IAC9B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC3B,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC1C,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;IACxC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAC5C,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,GAAG;IACpD,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QAChC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;QACzC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,GAAG;KACtC,CAAC,CAAC;IACH,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;CACtG,CAAC,CAAC"}

package/dist/gir/field.d.ts

@@ -0,0 +1,27 @@
+import { type RawNode } from "./parse.js";
+import { type GirTypeRef } from "./type-ref.js";
+/**
+ * A `<field>` inside a class, interface, record, or union.
+ *
+ * Vtable slots (fields holding `<callback>` children inside a
+ * `glib:is-gtype-struct-for` record) keep `callback` populated; ordinary
+ * data fields keep `type`. The two are mutually exclusive.
+ */
+export type GirField = {
+    /** GIR field name, snake_case. */
+    readonly name: string;
+    /** Field type, or `undefined` when the field is a vtable callback slot. */
+    readonly type: GirTypeRef | undefined;
+    /** Inline callback for vtable slots; `undefined` for data fields. */
+    readonly callback: RawNode | undefined;
+    readonly readable: boolean;
+    readonly writable: boolean;
+    readonly private: boolean;
+    /** GIR `bits` attribute width when the field is a bitfield member. */
+    readonly bits: number | undefined;
+};
+/**
+ * Builds a {@link GirField} from a `<field>` element.
+ */
+export declare const fieldFromNode: (node: RawNode) => GirField;
+//# sourceMappingURL=field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/gir/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,eAAe,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACnB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,KAAG,QAY7C,CAAC"}

package/dist/gir/field.js

@@ -0,0 +1,19 @@
+import { attr, attrBool, childOf } from "./parse.js";
+import { typeRefFromSlot } from "./type-ref.js";
+/**
+ * Builds a {@link GirField} from a `<field>` element.
+ */
+export const fieldFromNode = (node) => {
+    const callback = childOf(node, "callback");
+    const bitsAttr = attr(node, "bits");
+    return {
+        name: attr(node, "name") ?? "",
+        type: callback === undefined ? typeRefFromSlot(node) : undefined,
+        callback,
+        readable: attrBool(node, "readable", true),
+        writable: attrBool(node, "writable", false),
+        private: attrBool(node, "private", false),
+        bits: bitsAttr === undefined ? undefined : Number.parseInt(bitsAttr, 10),
+    };
+};
+//# sourceMappingURL=field.js.map

package/dist/gir/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/gir/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAuBjE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAa,EAAY,EAAE;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9B,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAChE,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;QAC1C,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC;QAC3C,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QACzC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;KAC3E,CAAC;AACN,CAAC,CAAC"}