@gtkx/codegen 0.21.0

package/dist/runner.js

@@ -0,0 +1,60 @@
+import { generateNamespaceModule } from "./ffi/pipeline.js";
+import { computeFingerprint } from "./fingerprint.js";
+import { writeGiStore } from "./gi-store.js";
+import { loadGirRepository } from "./gir/repository.js";
+import { writeJsxStore } from "./jsx-store.js";
+import { generateReactFiles } from "./react/pipeline.js";
+/**
+ * Single-entry orchestrator for the GTKX codegen.
+ *
+ * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
+ * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
+ * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
+ *
+ * @example
+ * ```ts
+ * import { CodegenRunner } from "@gtkx/codegen";
+ *
+ * await new CodegenRunner({
+ *     libraries: ["Gtk-4.0", "Adw-1"],
+ *     girPath: ["/usr/share/gir-1.0"],
+ *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
+ * }).run();
+ * ```
+ */
+export class CodegenRunner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Executes the full codegen pipeline and materializes the output packages.
+     */
+    async run() {
+        const start = Date.now();
+        const repository = loadGirRepository(this.options.libraries, this.options.girPath);
+        const namespaces = [];
+        for (const namespace of repository.namespaces.values()) {
+            const { source } = generateNamespaceModule(namespace, repository);
+            namespaces.push({ directory: namespace.name.toLowerCase(), rawSource: source });
+        }
+        const libraries = [...this.options.libraries];
+        writeGiStore(this.options.gi, namespaces, {
+            value: computeFingerprint(repository.girFiles, libraries),
+            girFiles: repository.girFiles,
+            libraries,
+        });
+        let widgetCount = 0;
+        if (this.options.jsx !== undefined) {
+            const reactPipeline = generateReactFiles(repository, this.options.slotProps);
+            writeJsxStore(this.options.jsx, reactPipeline.files);
+            widgetCount = reactPipeline.widgetCount;
+        }
+        return {
+            namespaces: repository.namespaces.size,
+            widgets: widgetCount,
+            duration: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAA8C,YAAY,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAwB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAa;IACO;IAA7B,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,GAAG;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnF,MAAM,UAAU,GAAuB,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACrD,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAClE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE;YACtC,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;YACzD,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS;SACZ,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7E,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YACrD,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;QAC5C,CAAC;QAED,OAAO;YACH,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI;YACtC,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACN,CAAC;CACJ"}

package/dist/store-fs.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Filesystem primitives shared by the injected-package assemblers
+ * ({@link ../gi-store.js}, {@link ../jsx-store.js}).
+ */
+/**
+ * Fields every injected-package store assembler needs: where the hidden store
+ * lives, the visible alias symlink, and the version stamped onto its manifest.
+ */
+export type StoreOptions = {
+    /** Absolute path to the hidden store directory (e.g. `node_modules/.gtkx/gi`). */
+    readonly storeDir: string;
+    /** Absolute path to the visible alias symlink (e.g. `node_modules/@gtkx/gi`). */
+    readonly linkDir: string;
+    /** Version string copied onto the emitted package's `package.json`. */
+    readonly version: string;
+};
+/** A transpilable source destined for the store, addressed by output stem. */
+export type StoreFile = {
+    /** Output path without extension, relative to the store root. */
+    readonly stem: string;
+    /** Source filename TypeScript uses for diagnostics. */
+    readonly fileName: string;
+    /** The TypeScript source to transpile and write. */
+    readonly source: string;
+};
+/** A symlink to create inside the store's own bundled `node_modules`. */
+export type StoreSymlink = {
+    /** Path segments under the store root the symlink is created at. */
+    readonly segments: readonly string[];
+    /** Absolute symlink target, or `"self"` for the store root itself. */
+    readonly target: string | "self";
+};
+/**
+ * Assembles a store in a fresh temp directory and atomically swaps it into
+ * place: writes every file pair, the `package.json`, the bundled
+ * `node_modules` symlinks, then promotes the temp tree and re-points the
+ * visible alias. An optional {@link WriteStoreParams.validate} runs against the
+ * temp root before any file is written, so a failure aborts before the store
+ * goes live.
+ *
+ * @param params - {@link WriteStoreParams}
+ */
+export declare const writeStore: (params: WriteStoreParams) => void;
+/** Inputs for {@link writeStore}. */
+export type WriteStoreParams = {
+    /** Absolute hidden store directory. */
+    readonly storeDir: string;
+    /** Absolute visible alias symlink. */
+    readonly linkDir: string;
+    /** The source files to transpile and write. */
+    readonly files: readonly StoreFile[];
+    /** The `package.json` manifest to serialize. */
+    readonly manifest: unknown;
+    /** The bundled `node_modules` symlinks to create. */
+    readonly symlinks: readonly StoreSymlink[];
+    /** Verbatim files (e.g. a fingerprint sentinel) written under the store root. */
+    readonly rawFiles?: readonly {
+        readonly relativePath: string;
+        readonly content: string;
+    }[];
+    /** Optional in-memory validation run on the temp root before files are written. */
+    readonly validate?: (tmp: string) => void;
+};
+/**
+ * Transpiles `source` and writes the resulting `.js`/`.d.ts` pair at `stem`
+ * (relative to `storeDir`), creating parent directories as needed.
+ *
+ * @param storeDir - Absolute store root the file is written under
+ * @param stem - Output path without extension, relative to `storeDir`
+ * @param fileName - Source filename TypeScript uses for diagnostics
+ * @param source - The TypeScript source to transpile
+ */
+export declare const writeFilePair: (storeDir: string, stem: string, fileName: string, source: string) => void;
+/**
+ * Creates (or replaces) a relative directory symlink at `linkPath` pointing at
+ * `realTarget`. Relative so the link survives the store being moved or cached.
+ *
+ * @param linkPath - Absolute path of the symlink to create
+ * @param realTarget - Absolute path the symlink resolves to
+ */
+export declare const symlinkRelative: (linkPath: string, realTarget: string) => void;
+/**
+ * Writes a pretty-printed `package.json` into `storeDir`.
+ *
+ * @param storeDir - Absolute directory to write `package.json` into
+ * @param manifest - The manifest object to serialize
+ */
+export declare const writePackageJson: (storeDir: string, manifest: unknown) => void;
+/**
+ * Swaps a fully-assembled temp store into place and re-points the visible alias
+ * at it.
+ *
+ * The live store is renamed aside and the temp store renamed in before the old
+ * tree is deleted, so the store is unavailable only for the duration of a single
+ * rename instead of a full recursive delete. Not safe against a second codegen
+ * run swapping the same store concurrently.
+ *
+ * @param tmp - Absolute temp store directory to promote
+ * @param storeDir - Absolute final store directory
+ * @param visibleLink - Absolute path of the visible alias symlink
+ */
+export declare const swapStore: (tmp: string, storeDir: string, visibleLink: string) => void;
+/**
+ * Creates a fresh, per-run temporary store directory next to `storeDir` and
+ * returns its path. The random suffix isolates concurrent or repeated runs so
+ * they cannot corrupt each other's in-progress trees.
+ */
+export declare const tempStoreFor: (storeDir: string) => string;
+//# sourceMappingURL=store-fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-fs.d.ts","sourceRoot":"","sources":["../src/store-fs.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG;IACpB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IACvB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,gBAAgB,KAAG,IAcrD,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3F,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,QAAQ,MAAM,KAAG,IAMhG,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,KAAG,IAItE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,EAAE,UAAU,OAAO,KAAG,IAEtE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,EAAE,aAAa,MAAM,KAAG,IAS9E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,MAG/C,CAAC"}

package/dist/store-fs.js

@@ -0,0 +1,98 @@
+import { existsSync, mkdirSync, mkdtempSync, renameSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { transpileSource } from "./transpile.js";
+/**
+ * Assembles a store in a fresh temp directory and atomically swaps it into
+ * place: writes every file pair, the `package.json`, the bundled
+ * `node_modules` symlinks, then promotes the temp tree and re-points the
+ * visible alias. An optional {@link WriteStoreParams.validate} runs against the
+ * temp root before any file is written, so a failure aborts before the store
+ * goes live.
+ *
+ * @param params - {@link WriteStoreParams}
+ */
+export const writeStore = (params) => {
+    const tmp = tempStoreFor(params.storeDir);
+    params.validate?.(tmp);
+    for (const file of params.files) {
+        writeFilePair(tmp, file.stem, file.fileName, file.source);
+    }
+    writePackageJson(tmp, params.manifest);
+    for (const raw of params.rawFiles ?? []) {
+        writeFileSync(join(tmp, raw.relativePath), raw.content);
+    }
+    for (const { segments, target } of params.symlinks) {
+        symlinkRelative(join(tmp, ...segments), target === "self" ? tmp : target);
+    }
+    swapStore(tmp, params.storeDir, params.linkDir);
+};
+/**
+ * Transpiles `source` and writes the resulting `.js`/`.d.ts` pair at `stem`
+ * (relative to `storeDir`), creating parent directories as needed.
+ *
+ * @param storeDir - Absolute store root the file is written under
+ * @param stem - Output path without extension, relative to `storeDir`
+ * @param fileName - Source filename TypeScript uses for diagnostics
+ * @param source - The TypeScript source to transpile
+ */
+export const writeFilePair = (storeDir, stem, fileName, source) => {
+    const { js, dts } = transpileSource(fileName, source);
+    const jsPath = join(storeDir, `${stem}.js`);
+    mkdirSync(dirname(jsPath), { recursive: true });
+    writeFileSync(jsPath, js);
+    writeFileSync(join(storeDir, `${stem}.d.ts`), dts);
+};
+/**
+ * Creates (or replaces) a relative directory symlink at `linkPath` pointing at
+ * `realTarget`. Relative so the link survives the store being moved or cached.
+ *
+ * @param linkPath - Absolute path of the symlink to create
+ * @param realTarget - Absolute path the symlink resolves to
+ */
+export const symlinkRelative = (linkPath, realTarget) => {
+    mkdirSync(dirname(linkPath), { recursive: true });
+    rmSync(linkPath, { recursive: true, force: true });
+    symlinkSync(relative(dirname(linkPath), realTarget), linkPath, "dir");
+};
+/**
+ * Writes a pretty-printed `package.json` into `storeDir`.
+ *
+ * @param storeDir - Absolute directory to write `package.json` into
+ * @param manifest - The manifest object to serialize
+ */
+export const writePackageJson = (storeDir, manifest) => {
+    writeFileSync(join(storeDir, "package.json"), `${JSON.stringify(manifest, null, 2)}\n`);
+};
+/**
+ * Swaps a fully-assembled temp store into place and re-points the visible alias
+ * at it.
+ *
+ * The live store is renamed aside and the temp store renamed in before the old
+ * tree is deleted, so the store is unavailable only for the duration of a single
+ * rename instead of a full recursive delete. Not safe against a second codegen
+ * run swapping the same store concurrently.
+ *
+ * @param tmp - Absolute temp store directory to promote
+ * @param storeDir - Absolute final store directory
+ * @param visibleLink - Absolute path of the visible alias symlink
+ */
+export const swapStore = (tmp, storeDir, visibleLink) => {
+    const previous = `${storeDir}.old`;
+    rmSync(previous, { recursive: true, force: true });
+    if (existsSync(storeDir)) {
+        renameSync(storeDir, previous);
+    }
+    renameSync(tmp, storeDir);
+    rmSync(previous, { recursive: true, force: true });
+    symlinkRelative(visibleLink, storeDir);
+};
+/**
+ * Creates a fresh, per-run temporary store directory next to `storeDir` and
+ * returns its path. The random suffix isolates concurrent or repeated runs so
+ * they cannot corrupt each other's in-progress trees.
+ */
+export const tempStoreFor = (storeDir) => {
+    mkdirSync(dirname(storeDir), { recursive: true });
+    return mkdtempSync(`${storeDir}.tmp-`);
+};
+//# sourceMappingURL=store-fs.js.map

package/dist/store-fs.js.map

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

package/dist/transpile.d.ts

@@ -0,0 +1,32 @@
+import ts from "typescript";
+/**
+ * Output of a single TypeScript transpile: the stripped `.js` and the
+ * isolated-declaration `.d.ts` it produces.
+ */
+export type TranspiledFile = {
+    /** Stripped-types JavaScript output. */
+    readonly js: string;
+    /** Generated TypeScript declaration output. */
+    readonly dts: string;
+};
+/**
+ * The compiler options shared by the store's two TypeScript passes — the
+ * single-file transpile here and the overlay type-check in `typecheck-store.ts`.
+ * Each pass spreads these and adds its own emit/check-specific keys.
+ */
+export declare const baseCompilerOptions: () => ts.CompilerOptions;
+/**
+ * Transpiles a single TypeScript source string to a `.js` / `.d.ts` pair.
+ *
+ * Uses `ts.transpileModule` for the JS half (type-stripping only, no
+ * type checking) and `ts.transpileDeclaration` for the declaration half
+ * (single-file declaration emit). Generated sources annotate every export
+ * for isolated-declaration emit, so `transpileDeclaration` always
+ * succeeds; an error-category diagnostic from it represents a writer bug
+ * and is surfaced rather than swallowed.
+ *
+ * @param fileName - Source filename, used by TS for path resolution
+ * @param source - The TypeScript source string
+ */
+export declare const transpileSource: (fileName: string, source: string) => TranspiledFile;
+//# sourceMappingURL=transpile.d.ts.map

package/dist/transpile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.d.ts","sourceRoot":"","sources":["../src/transpile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,EAAE,CAAC,eAOxC,CAAC;AAWH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,QAAQ,MAAM,KAAG,cA8BlE,CAAC"}

package/dist/transpile.js

@@ -0,0 +1,63 @@
+import ts from "typescript";
+/**
+ * The compiler options shared by the store's two TypeScript passes — the
+ * single-file transpile here and the overlay type-check in `typecheck-store.ts`.
+ * Each pass spreads these and adds its own emit/check-specific keys.
+ */
+export const baseCompilerOptions = () => ({
+    module: ts.ModuleKind.ESNext,
+    moduleResolution: ts.ModuleResolutionKind.Bundler,
+    target: ts.ScriptTarget.ESNext,
+    skipLibCheck: true,
+    jsx: ts.JsxEmit.ReactJSX,
+    jsxImportSource: "react",
+});
+const COMPILER_OPTIONS = {
+    ...baseCompilerOptions(),
+    declaration: true,
+    skipDefaultLibCheck: true,
+    removeComments: false,
+    sourceMap: false,
+    declarationMap: false,
+};
+/**
+ * Transpiles a single TypeScript source string to a `.js` / `.d.ts` pair.
+ *
+ * Uses `ts.transpileModule` for the JS half (type-stripping only, no
+ * type checking) and `ts.transpileDeclaration` for the declaration half
+ * (single-file declaration emit). Generated sources annotate every export
+ * for isolated-declaration emit, so `transpileDeclaration` always
+ * succeeds; an error-category diagnostic from it represents a writer bug
+ * and is surfaced rather than swallowed.
+ *
+ * @param fileName - Source filename, used by TS for path resolution
+ * @param source - The TypeScript source string
+ */
+export const transpileSource = (fileName, source) => {
+    const jsResult = ts.transpileModule(source, {
+        compilerOptions: COMPILER_OPTIONS,
+        fileName,
+        reportDiagnostics: false,
+    });
+    const dtsResult = ts.transpileDeclaration(source, {
+        compilerOptions: COMPILER_OPTIONS,
+        fileName,
+    });
+    const errorDiagnostics = (dtsResult.diagnostics ?? []).filter((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error);
+    if (errorDiagnostics.length > 0) {
+        const messages = errorDiagnostics
+            .slice(0, 5)
+            .map((diagnostic) => {
+            const text = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+            if (diagnostic.file && diagnostic.start !== undefined) {
+                const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+                return `[${line + 1}:${character + 1}] ${text}`;
+            }
+            return text;
+        })
+            .join("\n");
+        throw new Error(`transpileDeclaration produced ${errorDiagnostics.length} diagnostic(s) for ${fileName}:\n${messages}`);
+    }
+    return { js: jsResult.outputText, dts: dtsResult.outputText };
+};
+//# sourceMappingURL=transpile.js.map

package/dist/transpile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.js","sourceRoot":"","sources":["../src/transpile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAa5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAuB,EAAE,CAAC,CAAC;IAC1D,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;IAC5B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO;IACjD,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;IAC9B,YAAY,EAAE,IAAI;IAClB,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;IACxB,eAAe,EAAE,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAuB;IACzC,GAAG,mBAAmB,EAAE;IACxB,WAAW,EAAE,IAAI;IACjB,mBAAmB,EAAE,IAAI;IACzB,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,KAAK;CACxB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAkB,EAAE;IAChF,MAAM,QAAQ,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE;QACxC,eAAe,EAAE,gBAAgB;QACjC,QAAQ;QACR,iBAAiB,EAAE,KAAK;KAC3B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE;QAC9C,eAAe,EAAE,gBAAgB;QACjC,QAAQ;KACX,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACzD,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,EAAE,CAAC,kBAAkB,CAAC,KAAK,CACtE,CAAC;IACF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,gBAAgB;aAC5B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;YAChB,MAAM,IAAI,GAAG,EAAE,CAAC,4BAA4B,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC3E,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC5F,OAAO,IAAI,IAAI,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,IAAI,KAAK,CACX,iCAAiC,gBAAgB,CAAC,MAAM,sBAAsB,QAAQ,MAAM,QAAQ,EAAE,CACzG,CAAC;IACN,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;AAClE,CAAC,CAAC"}

package/dist/typecheck-store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * One in-memory source destined for the injected `@gtkx/gi` store, plus whether
+ * it is a hand-written overlay (the type-check target) or a generated module
+ * declaration (checked against, but not reported on).
+ */
+export type StoreSourceFile = {
+    /** Absolute virtual path of the source, under the store root. */
+    readonly path: string;
+    /** TypeScript source text (overlay `.ts`) or declaration text (generated `.d.ts`). */
+    readonly source: string;
+    /** Whether this is a hand-written overlay/augment source. */
+    readonly overlay: boolean;
+};
+/**
+ * Source entries the overlay type-check resolves the runtime packages to.
+ */
+export type RuntimeEntries = {
+    /** Absolute path to `@gtkx/ffi`'s source entry (`src/index.ts`). */
+    readonly ffiEntry: string;
+    /** Absolute path to `@gtkx/native`'s declaration entry (`dist/index.d.ts`). */
+    readonly nativeEntry: string;
+};
+/**
+ * Type-checks the hand-written overlay sources against the freshly generated
+ * `@gtkx/gi` declarations, entirely in memory.
+ *
+ * The overlay augments generated classes (e.g. installs `Value.prototype.getBoxed`),
+ * so its correctness is only meaningful relative to the exact API codegen just
+ * produced. A {@link ts.Program} is assembled over the in-memory generated
+ * declarations and overlay sources, resolving `@gtkx/gi/*` to the generated
+ * declarations and `@gtkx/ffi` to its package source; every other specifier
+ * (`react`, lib files) resolves from the real filesystem. Semantic errors on the
+ * overlay sources abort codegen rather than ship broken bindings.
+ *
+ * @param storeRoot - Absolute root the virtual source paths are rooted at.
+ * @param files - The in-memory generated declarations and overlay sources.
+ * @param entries - Absolute source entries for `@gtkx/ffi` and `@gtkx/native`.
+ * @throws When any overlay source has a semantic type error.
+ */
+export declare const typecheckGiStore: (storeRoot: string, files: readonly StoreSourceFile[], entries: RuntimeEntries) => void;
+//# sourceMappingURL=typecheck-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck-store.d.ts","sourceRoot":"","sources":["../src/typecheck-store.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B,CAAC;AAYF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC,CAAC;AAsEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GACzB,WAAW,MAAM,EACjB,OAAO,SAAS,eAAe,EAAE,EACjC,SAAS,cAAc,KACxB,IAOF,CAAC"}

package/dist/typecheck-store.js

@@ -0,0 +1,102 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import ts from "typescript";
+import { baseCompilerOptions } from "./transpile.js";
+const GI_SPECIFIER = "@gtkx/gi/";
+const COMPILER_OPTIONS = {
+    ...baseCompilerOptions(),
+    customConditions: ["source"],
+    strict: true,
+    noEmit: true,
+    types: [],
+};
+const buildCompilerHost = (storeRoot, virtualSources, entries) => {
+    const readSource = (fileName) => virtualSources.get(fileName) ?? (existsSync(fileName) ? readFileSync(fileName, "utf8") : undefined);
+    const resolveInjected = (specifier) => {
+        if (specifier === "@gtkx/ffi")
+            return entries.ffiEntry;
+        if (specifier === "@gtkx/native")
+            return entries.nativeEntry;
+        if (!specifier.startsWith(GI_SPECIFIER))
+            return undefined;
+        const stem = specifier.slice(GI_SPECIFIER.length).replace(/\.js$/, "");
+        return [`${stem}.d.ts`, `${stem}.ts`, `${stem}/index.d.ts`, `${stem}/index.ts`]
+            .map((candidate) => join(storeRoot, candidate))
+            .find((candidate) => virtualSources.has(candidate));
+    };
+    const moduleResolutionHost = {
+        fileExists: (fileName) => virtualSources.has(fileName) || existsSync(fileName),
+        readFile: readSource,
+    };
+    return {
+        getSourceFile: (fileName, languageVersion) => {
+            const source = readSource(fileName);
+            return source === undefined ? undefined : ts.createSourceFile(fileName, source, languageVersion, true);
+        },
+        getDefaultLibFileName: (options) => ts.getDefaultLibFilePath(options),
+        writeFile: () => { },
+        getCurrentDirectory: () => storeRoot,
+        getCanonicalFileName: (fileName) => fileName,
+        useCaseSensitiveFileNames: () => true,
+        getNewLine: () => "\n",
+        fileExists: (fileName) => virtualSources.has(fileName) || existsSync(fileName),
+        readFile: readSource,
+        resolveModuleNameLiterals: (literals, containingFile, _redirectedReference, options) => literals.map((literal) => {
+            const injected = resolveInjected(literal.text);
+            if (injected !== undefined) {
+                return { resolvedModule: { resolvedFileName: injected, extension: ts.Extension.Ts } };
+            }
+            return {
+                resolvedModule: ts.resolveModuleName(literal.text, containingFile, options, moduleResolutionHost)
+                    .resolvedModule,
+            };
+        }),
+    };
+};
+const reportOverlayErrors = (program, overlayPaths, storeRoot) => {
+    const errors = [];
+    for (const path of overlayPaths) {
+        const sourceFile = program.getSourceFile(path);
+        if (!sourceFile)
+            continue;
+        for (const diagnostic of program.getSemanticDiagnostics(sourceFile)) {
+            if (diagnostic.category === ts.DiagnosticCategory.Error)
+                errors.push(diagnostic);
+        }
+    }
+    if (errors.length === 0)
+        return;
+    const formatted = ts.formatDiagnosticsWithColorAndContext(errors, {
+        getCurrentDirectory: () => storeRoot,
+        getCanonicalFileName: (fileName) => fileName,
+        getNewLine: () => "\n",
+    });
+    throw new Error(`Overlay type-check failed against the generated @gtkx/gi API:\n${formatted}`);
+};
+/**
+ * Type-checks the hand-written overlay sources against the freshly generated
+ * `@gtkx/gi` declarations, entirely in memory.
+ *
+ * The overlay augments generated classes (e.g. installs `Value.prototype.getBoxed`),
+ * so its correctness is only meaningful relative to the exact API codegen just
+ * produced. A {@link ts.Program} is assembled over the in-memory generated
+ * declarations and overlay sources, resolving `@gtkx/gi/*` to the generated
+ * declarations and `@gtkx/ffi` to its package source; every other specifier
+ * (`react`, lib files) resolves from the real filesystem. Semantic errors on the
+ * overlay sources abort codegen rather than ship broken bindings.
+ *
+ * @param storeRoot - Absolute root the virtual source paths are rooted at.
+ * @param files - The in-memory generated declarations and overlay sources.
+ * @param entries - Absolute source entries for `@gtkx/ffi` and `@gtkx/native`.
+ * @throws When any overlay source has a semantic type error.
+ */
+export const typecheckGiStore = (storeRoot, files, entries) => {
+    const overlayPaths = files.filter((file) => file.overlay).map((file) => file.path);
+    if (overlayPaths.length === 0)
+        return;
+    const virtualSources = new Map(files.map((file) => [file.path, file.source]));
+    const host = buildCompilerHost(storeRoot, virtualSources, entries);
+    const program = ts.createProgram({ rootNames: files.map((file) => file.path), options: COMPILER_OPTIONS, host });
+    reportOverlayErrors(program, overlayPaths, storeRoot);
+};
+//# sourceMappingURL=typecheck-store.js.map

package/dist/typecheck-store.js.map

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

package/dist/writers/alias.d.ts

@@ -0,0 +1,13 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirAlias } from "../gir/namespace.js";
+/**
+ * Emits an `export type` declaration for a GIR `<alias>`.
+ *
+ * The alias is exported under {@link aliasExportName} — its GIR `name`, with
+ * GObject's `Type` published as `GType`.
+ *
+ * @param context - The module context
+ * @param alias - The alias to emit
+ */
+export declare const emitAlias: (context: ModuleContext, alias: GirAlias) => void;
+//# sourceMappingURL=alias.d.ts.map

package/dist/writers/alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../../src/writers/alias.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,aAAa,EAAE,OAAO,QAAQ,KAAG,IAInE,CAAC"}

package/dist/writers/alias.js

@@ -0,0 +1,17 @@
+import { aliasExportName } from "../dsl/identifier.js";
+import { renderTsType } from "./ts-type.js";
+/**
+ * Emits an `export type` declaration for a GIR `<alias>`.
+ *
+ * The alias is exported under {@link aliasExportName} — its GIR `name`, with
+ * GObject's `Type` published as `GType`.
+ *
+ * @param context - The module context
+ * @param alias - The alias to emit
+ */
+export const emitAlias = (context, alias) => {
+    const exportName = aliasExportName(context.namespace.name, alias.name);
+    const targetType = renderTsType(context, alias.target);
+    context.module.appendDeclaration(`export type ${exportName} = ${targetType};`);
+};
+//# sourceMappingURL=alias.js.map

package/dist/writers/alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.js","sourceRoot":"","sources":["../../src/writers/alias.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAQ,EAAE;IACvE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,eAAe,UAAU,MAAM,UAAU,GAAG,CAAC,CAAC;AACnF,CAAC,CAAC"}

package/dist/writers/async.d.ts

@@ -0,0 +1,22 @@
+import type { GirFunction } from "../gir/function.js";
+/**
+ * Detects the start half of a `Gio.AsyncReady` callable pair.
+ *
+ * Pairs follow two GIR conventions: an explicit `*_async` / `*_finish`
+ * suffix (the older style), or a base name paired with a `<root>_finish`
+ * (the modern GTK 4 style, e.g. `gtk_file_dialog_open` /
+ * `gtk_file_dialog_open_finish`).
+ *
+ * The runtime convention is to wrap the pair with `promisify(asyncFn,
+ * finishFn, cancellable, { leading })`. This detector returns the
+ * matching finish counterpart's GIR name when one exists in the same
+ * set of callables, so the class writer can wire the wrapper.
+ *
+ * @param fn - The candidate async-start callable
+ * @param siblings - Other callables on the same type to scan for the
+ *     matching `*_finish`
+ * @returns The matching `*_finish` GIR name, or `undefined` when there is
+ *     no pair
+ */
+export declare const matchAsyncFinishName: (fn: GirFunction, siblings: readonly GirFunction[]) => string | undefined;
+//# sourceMappingURL=async.d.ts.map

package/dist/writers/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/writers/async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,WAAW,EAAE,UAAU,SAAS,WAAW,EAAE,KAAG,MAAM,GAAG,SAajG,CAAC"}