@gtkx/codegen 0.21.0

package/dist/dsl/emit.js

@@ -0,0 +1,41 @@
+/**
+ * Tiny string-builder helpers used by the writers to assemble TypeScript
+ * source. The DSL deliberately stops short of modelling expressions or
+ * statements — writers compose strings directly using these primitives.
+ */
+/**
+ * Indents each line of `block` by `level` four-space units.
+ *
+ * Lines that are empty stay empty (no trailing whitespace).
+ *
+ * @param block - The multi-line source fragment
+ * @param level - Number of indentation steps to apply
+ */
+export const indent = (block, level) => {
+    if (level <= 0)
+        return block;
+    const prefix = "    ".repeat(level);
+    return block
+        .split("\n")
+        .map((line) => (line.length === 0 ? line : `${prefix}${line}`))
+        .join("\n");
+};
+/**
+ * Joins `parts` with commas, dropping `undefined` entries.
+ */
+export const joinArgs = (parts) => parts.filter((part) => part !== undefined).join(", ");
+/**
+ * Renders an array literal multi-line, indenting each element four spaces
+ * and adding a trailing comma.
+ *
+ * Empty input renders as `[]`.
+ *
+ * @param elements - Already-rendered element expressions
+ */
+export const arrayLiteral = (elements) => {
+    if (elements.length === 0)
+        return "[]";
+    const lines = elements.map((element) => `    ${element},`);
+    return `[\n${lines.join("\n")}\n]`;
+};
+//# sourceMappingURL=emit.js.map

package/dist/dsl/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/dsl/emit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,KAAa,EAAU,EAAE;IAC3D,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,KAAK;SACP,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAwC,EAAU,EAAE,CACzE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAA2B,EAAU,EAAE;IAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,GAAG,CAAC,CAAC;IAC3D,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;AACvC,CAAC,CAAC"}

package/dist/dsl/identifier.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Derives the public camelCase export name for a namespace-level callable.
+ *
+ * The GIR `name` attribute is camelCased (`quark_from_string` →
+ * `quarkFromString`); for a shadowing function it is the shadowed short name,
+ * so `g_idle_add_full` (which shadows `idle_add`) exports as `idleAdd`. When the
+ * `name` is empty the C identifier is used instead, with the namespace's
+ * `c:symbol-prefixes` value stripped (e.g. `g_` from `g_quark_from_string`).
+ * The result is escaped so it never collides with a reserved word.
+ *
+ * @param cIdentifier - The C symbol identifier from GIR
+ * @param girName - The GIR `name` attribute (shadow-resolved)
+ * @param symbolPrefixes - The namespace's `c:symbol-prefixes` values
+ */
+export declare const namespaceFunctionExportName: (cIdentifier: string, girName: string, symbolPrefixes: readonly string[]) => string;
+/**
+ * Derives the exported identifier for a GIR `<alias>`.
+ *
+ * Aliases are surfaced under their GIR `name` (e.g. `Quark`, `Pid`,
+ * `Allocation`), matching the `@girs` convention. GObject's `Type` alias is the
+ * one exception: it is published as `GType` so it lines up with the GObject
+ * runtime's `GType` type and the references that resolve through it.
+ *
+ * @param namespaceName - The namespace the alias is declared in
+ * @param aliasName - The alias's GIR `name`
+ */
+export declare const aliasExportName: (namespaceName: string, aliasName: string) => string;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/dsl/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/dsl/identifier.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,GACpC,aAAa,MAAM,EACnB,SAAS,MAAM,EACf,gBAAgB,SAAS,MAAM,EAAE,KAClC,MAMF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,EAAE,WAAW,MAAM,KAAG,MACE,CAAC"}

package/dist/dsl/identifier.js

@@ -0,0 +1,45 @@
+import { toCamelCase, toIdentifier } from "@gtkx/utils";
+/**
+ * Derives the public camelCase export name for a namespace-level callable.
+ *
+ * The GIR `name` attribute is camelCased (`quark_from_string` →
+ * `quarkFromString`); for a shadowing function it is the shadowed short name,
+ * so `g_idle_add_full` (which shadows `idle_add`) exports as `idleAdd`. When the
+ * `name` is empty the C identifier is used instead, with the namespace's
+ * `c:symbol-prefixes` value stripped (e.g. `g_` from `g_quark_from_string`).
+ * The result is escaped so it never collides with a reserved word.
+ *
+ * @param cIdentifier - The C symbol identifier from GIR
+ * @param girName - The GIR `name` attribute (shadow-resolved)
+ * @param symbolPrefixes - The namespace's `c:symbol-prefixes` values
+ */
+export const namespaceFunctionExportName = (cIdentifier, girName, symbolPrefixes) => {
+    if (girName.length > 0) {
+        return toIdentifier(toCamelCase(girName));
+    }
+    const stripped = stripLongestPrefix(cIdentifier, symbolPrefixes);
+    return toIdentifier(toCamelCase(stripped));
+};
+/**
+ * Derives the exported identifier for a GIR `<alias>`.
+ *
+ * Aliases are surfaced under their GIR `name` (e.g. `Quark`, `Pid`,
+ * `Allocation`), matching the `@girs` convention. GObject's `Type` alias is the
+ * one exception: it is published as `GType` so it lines up with the GObject
+ * runtime's `GType` type and the references that resolve through it.
+ *
+ * @param namespaceName - The namespace the alias is declared in
+ * @param aliasName - The alias's GIR `name`
+ */
+export const aliasExportName = (namespaceName, aliasName) => namespaceName === "GObject" && aliasName === "Type" ? "GType" : aliasName;
+const stripLongestPrefix = (input, prefixes) => {
+    let best = "";
+    for (const prefix of prefixes) {
+        const candidate = `${prefix}_`;
+        if (input.startsWith(candidate) && candidate.length > best.length) {
+            best = candidate;
+        }
+    }
+    return best.length === 0 ? input : input.slice(best.length);
+};
+//# sourceMappingURL=identifier.js.map

package/dist/dsl/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/dsl/identifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACvC,WAAmB,EACnB,OAAe,EACf,cAAiC,EAC3B,EAAE;IACR,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACjE,OAAO,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAqB,EAAE,SAAiB,EAAU,EAAE,CAChF,aAAa,KAAK,SAAS,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAE9E,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,QAA2B,EAAU,EAAE;IAC9E,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,GAAG,MAAM,GAAG,CAAC;QAC/B,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChE,IAAI,GAAG,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC,CAAC"}

package/dist/dsl/imports.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Tracks imports for a single generated module.
+ *
+ * The DSL is intentionally tiny: it covers what is awkward to do with
+ * string concatenation (deduplicating named imports, sorting them, mixing
+ * side-effect and named imports from the same specifier) and leaves
+ * everything else to raw TS strings the writers compose themselves.
+ */
+export declare class ImportsBuilder {
+    private readonly named;
+    private readonly defaultNames;
+    private readonly namespaces;
+    private readonly sideEffects;
+    /**
+     * Records a named import: `import { foo, bar } from "lib"`.
+     *
+     * Repeated calls deduplicate; the final emit alphabetises within the
+     * braces. A name is emitted with the inline `type` modifier only when
+     * every recording of it is type-only — a single value import of the same
+     * name keeps it a value import.
+     *
+     * @param specifier - The module specifier (e.g. `"@gtkx/ffi"`)
+     * @param name - The identifier to import
+     * @param isType - Whether this recording is type-only (`import { type X }`)
+     */
+    addNamed(specifier: string, name: string, isType?: boolean): void;
+    /**
+     * Records a namespace import: `import * as Alias from "lib"`.
+     *
+     * The first call wins if a different alias is reused for the same
+     * specifier.
+     *
+     * @param specifier - The module specifier
+     * @param alias - The local alias bound by the import
+     */
+    addNamespace(specifier: string, alias: string): void;
+    /**
+     * Records a default import: `import Alias from "lib"`. Subsequent calls
+     * with a different alias are ignored.
+     *
+     * @param specifier - The module specifier
+     * @param alias - The local name bound to the default export
+     */
+    addDefault(specifier: string, alias: string): void;
+    /**
+     * Records a side-effect-only import: `import "lib"`.
+     *
+     * @param specifier - The module specifier
+     */
+    addSideEffect(specifier: string): void;
+    /**
+     * Renders all imports as a single string ending with a trailing
+     * newline. Side-effect imports come first (in insertion order),
+     * followed by named/namespace/default imports sorted by specifier.
+     */
+    toSource(): string;
+}
+//# sourceMappingURL=imports.d.ts.map

package/dist/dsl/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/dsl/imports.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI;IAS/D;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMpD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlD;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CA6BrB"}

package/dist/dsl/imports.js

@@ -0,0 +1,107 @@
+import { quote } from "@gtkx/utils";
+/**
+ * Tracks imports for a single generated module.
+ *
+ * The DSL is intentionally tiny: it covers what is awkward to do with
+ * string concatenation (deduplicating named imports, sorting them, mixing
+ * side-effect and named imports from the same specifier) and leaves
+ * everything else to raw TS strings the writers compose themselves.
+ */
+export class ImportsBuilder {
+    named = new Map();
+    defaultNames = new Map();
+    namespaces = new Map();
+    sideEffects = new Set();
+    /**
+     * Records a named import: `import { foo, bar } from "lib"`.
+     *
+     * Repeated calls deduplicate; the final emit alphabetises within the
+     * braces. A name is emitted with the inline `type` modifier only when
+     * every recording of it is type-only — a single value import of the same
+     * name keeps it a value import.
+     *
+     * @param specifier - The module specifier (e.g. `"@gtkx/ffi"`)
+     * @param name - The identifier to import
+     * @param isType - Whether this recording is type-only (`import { type X }`)
+     */
+    addNamed(specifier, name, isType = false) {
+        let bucket = this.named.get(specifier);
+        if (bucket === undefined) {
+            bucket = new Map();
+            this.named.set(specifier, bucket);
+        }
+        bucket.set(name, (bucket.get(name) ?? true) && isType);
+    }
+    /**
+     * Records a namespace import: `import * as Alias from "lib"`.
+     *
+     * The first call wins if a different alias is reused for the same
+     * specifier.
+     *
+     * @param specifier - The module specifier
+     * @param alias - The local alias bound by the import
+     */
+    addNamespace(specifier, alias) {
+        if (!this.namespaces.has(specifier)) {
+            this.namespaces.set(specifier, alias);
+        }
+    }
+    /**
+     * Records a default import: `import Alias from "lib"`. Subsequent calls
+     * with a different alias are ignored.
+     *
+     * @param specifier - The module specifier
+     * @param alias - The local name bound to the default export
+     */
+    addDefault(specifier, alias) {
+        if (!this.defaultNames.has(specifier)) {
+            this.defaultNames.set(specifier, alias);
+        }
+    }
+    /**
+     * Records a side-effect-only import: `import "lib"`.
+     *
+     * @param specifier - The module specifier
+     */
+    addSideEffect(specifier) {
+        this.sideEffects.add(specifier);
+    }
+    /**
+     * Renders all imports as a single string ending with a trailing
+     * newline. Side-effect imports come first (in insertion order),
+     * followed by named/namespace/default imports sorted by specifier.
+     */
+    toSource() {
+        const lines = [];
+        for (const specifier of this.sideEffects) {
+            lines.push(`import ${quote(specifier)};`);
+        }
+        const specifiers = new Set([
+            ...this.named.keys(),
+            ...this.namespaces.keys(),
+            ...this.defaultNames.keys(),
+        ]);
+        const sortedSpecifiers = [...specifiers].sort((a, b) => a.localeCompare(b));
+        for (const specifier of sortedSpecifiers) {
+            const defaultAlias = this.defaultNames.get(specifier);
+            const namespaceAlias = this.namespaces.get(specifier);
+            const namedNames = this.named.get(specifier);
+            const parts = [];
+            if (defaultAlias !== undefined)
+                parts.push(defaultAlias);
+            if (namespaceAlias !== undefined)
+                parts.push(`* as ${namespaceAlias}`);
+            if (namedNames !== undefined && namedNames.size > 0) {
+                const sortedNames = [...namedNames.entries()]
+                    .sort(([a], [b]) => a.localeCompare(b))
+                    .map(([name, isType]) => (isType ? `type ${name}` : name));
+                parts.push(`{ ${sortedNames.join(", ")} }`);
+            }
+            if (parts.length === 0)
+                continue;
+            lines.push(`import ${parts.join(", ")} from ${quote(specifier)};`);
+        }
+        return lines.length === 0 ? "" : `${lines.join("\n")}\n`;
+    }
+}
+//# sourceMappingURL=imports.js.map

package/dist/dsl/imports.js.map

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

package/dist/dsl/module.d.ts

@@ -0,0 +1,53 @@
+import { ImportsBuilder } from "./imports.js";
+/**
+ * Accumulator for one generated TypeScript module's source.
+ *
+ * Writers append code in three logical phases:
+ *
+ * 1. *Bindings* — the `const fn_name = t.fn(...)` block at the top.
+ * 2. *Declarations* — the class bodies, free function exports, enums,
+ *    constants.
+ * 3. *Registrations* — the trailing `registerNativeClass(...)` block.
+ *
+ * Keeping the three buckets independent removes ordering constraints
+ * between writers and lets {@link emit} stitch a final source string with
+ * the same shape every generated file uses today.
+ */
+export declare class ModuleBuilder {
+    /** Imports manifest the writers feed into. */
+    readonly imports: ImportsBuilder;
+    private readonly bindings;
+    private readonly bindingNames;
+    private readonly declarations;
+    private readonly registrations;
+    /**
+     * Appends a top-level FFI binding (`const foo = t.fn(...)`).
+     *
+     * Duplicates are dropped when a `name` is supplied that matches a
+     * previously appended binding; this is the common case for GIR
+     * callables that appear both as a namespace function and as a
+     * constructor or static on a class.
+     *
+     * @param code - The source fragment, without a trailing newline
+     * @param name - Optional binding identifier used for deduplication
+     */
+    appendBinding(code: string, name?: string): void;
+    /**
+     * Appends a declaration (class, function, enum, constant).
+     *
+     * @param code - The source fragment, without a trailing newline
+     */
+    appendDeclaration(code: string): void;
+    /**
+     * Appends a trailing registration statement (`registerNativeClass(…)`).
+     *
+     * @param code - The source fragment, without a trailing newline
+     */
+    appendRegistration(code: string): void;
+    /**
+     * Renders the full TypeScript source: imports, bindings, declarations,
+     * registrations — separated by a single blank line.
+     */
+    toSource(): string;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/dsl/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/dsl/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACtB,8CAA8C;IAC9C,SAAgB,OAAO,iBAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACH,QAAQ,IAAI,MAAM;CASrB"}

package/dist/dsl/module.js

@@ -0,0 +1,76 @@
+import { ImportsBuilder } from "./imports.js";
+/**
+ * Accumulator for one generated TypeScript module's source.
+ *
+ * Writers append code in three logical phases:
+ *
+ * 1. *Bindings* — the `const fn_name = t.fn(...)` block at the top.
+ * 2. *Declarations* — the class bodies, free function exports, enums,
+ *    constants.
+ * 3. *Registrations* — the trailing `registerNativeClass(...)` block.
+ *
+ * Keeping the three buckets independent removes ordering constraints
+ * between writers and lets {@link emit} stitch a final source string with
+ * the same shape every generated file uses today.
+ */
+export class ModuleBuilder {
+    /** Imports manifest the writers feed into. */
+    imports = new ImportsBuilder();
+    bindings = [];
+    bindingNames = new Set();
+    declarations = [];
+    registrations = [];
+    /**
+     * Appends a top-level FFI binding (`const foo = t.fn(...)`).
+     *
+     * Duplicates are dropped when a `name` is supplied that matches a
+     * previously appended binding; this is the common case for GIR
+     * callables that appear both as a namespace function and as a
+     * constructor or static on a class.
+     *
+     * @param code - The source fragment, without a trailing newline
+     * @param name - Optional binding identifier used for deduplication
+     */
+    appendBinding(code, name) {
+        if (name !== undefined) {
+            if (this.bindingNames.has(name))
+                return;
+            this.bindingNames.add(name);
+        }
+        this.bindings.push(code);
+    }
+    /**
+     * Appends a declaration (class, function, enum, constant).
+     *
+     * @param code - The source fragment, without a trailing newline
+     */
+    appendDeclaration(code) {
+        this.declarations.push(code);
+    }
+    /**
+     * Appends a trailing registration statement (`registerNativeClass(…)`).
+     *
+     * @param code - The source fragment, without a trailing newline
+     */
+    appendRegistration(code) {
+        this.registrations.push(code);
+    }
+    /**
+     * Renders the full TypeScript source: imports, bindings, declarations,
+     * registrations — separated by a single blank line.
+     */
+    toSource() {
+        const sections = [];
+        const importsBlock = this.imports.toSource();
+        if (importsBlock.length > 0)
+            sections.push(importsBlock.trimEnd());
+        if (this.bindings.length > 0)
+            sections.push(this.bindings.join("\n\n"));
+        if (this.declarations.length > 0)
+            sections.push(this.declarations.join("\n\n"));
+        if (this.registrations.length > 0)
+            sections.push(this.registrations.join("\n\n"));
+        return `${sections.join("\n\n")}\n`;
+    }
+}
+//# sourceMappingURL=module.js.map

package/dist/dsl/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/dsl/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IACtB,8CAA8C;IAC9B,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAC9B,QAAQ,GAAa,EAAE,CAAC;IACxB,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,YAAY,GAAa,EAAE,CAAC;IAC5B,aAAa,GAAa,EAAE,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAY,EAAE,IAAa;QACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO;YACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAY;QAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,IAAY;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,QAAQ;QACJ,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAClF,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IACxC,CAAC;CACJ"}

package/dist/ffi/pipeline.d.ts

@@ -0,0 +1,19 @@
+import type { GirNamespace } from "../gir/namespace.js";
+import type { GirRepository } from "../gir/repository.js";
+/**
+ * Generates the TypeScript source for one FFI namespace module.
+ *
+ * Walks the namespace's declared enums, boxeds, classes, interfaces,
+ * callbacks, functions, constants, and aliases, dispatching to the
+ * per-construct writers in `writers/`: bindings first, declarations second,
+ * registrations trailing.
+ *
+ * @param namespace - The namespace to emit
+ * @param repository - The full repository (for cross-namespace lookups)
+ * @returns The relative output path and the TypeScript source string
+ */
+export declare const generateNamespaceModule: (namespace: GirNamespace, repository: GirRepository) => {
+    readonly path: string;
+    readonly source: string;
+};
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/ffi/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/ffi/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAChC,WAAW,YAAY,EACvB,YAAY,aAAa,KAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAmClD,CAAC"}

package/dist/ffi/pipeline.js

@@ -0,0 +1,107 @@
+import { ModuleContext } from "../dsl/context.js";
+import { emitAlias } from "../writers/alias.js";
+import { emitBoxed } from "../writers/boxed.js";
+import { emitCallback } from "../writers/callback.js";
+import { emitClass } from "../writers/class.js";
+import { emitConstant } from "../writers/constant.js";
+import { emitEnum } from "../writers/enum.js";
+import { emitNamespaceBootstrap, emitNamespaceFunction } from "../writers/function.js";
+import { emitInterface } from "../writers/interface.js";
+/**
+ * Generates the TypeScript source for one FFI namespace module.
+ *
+ * Walks the namespace's declared enums, boxeds, classes, interfaces,
+ * callbacks, functions, constants, and aliases, dispatching to the
+ * per-construct writers in `writers/`: bindings first, declarations second,
+ * registrations trailing.
+ *
+ * @param namespace - The namespace to emit
+ * @param repository - The full repository (for cross-namespace lookups)
+ * @returns The relative output path and the TypeScript source string
+ */
+export const generateNamespaceModule = (namespace, repository) => {
+    const context = new ModuleContext(namespace, repository);
+    context.addGObjectBootstrapImports();
+    for (const enumeration of namespace.enums) {
+        emitEnum(context, enumeration);
+    }
+    for (const boxed of namespace.boxeds) {
+        emitBoxed(context, boxed);
+    }
+    for (const klass of topologicalClassOrder(namespace.classes, namespace.name)) {
+        emitClass(context, klass);
+    }
+    for (const iface of namespace.interfaces) {
+        emitInterface(context, iface);
+    }
+    for (const callback of namespace.callbacks) {
+        emitCallback(context, callback);
+    }
+    for (const fn of namespace.functions) {
+        emitNamespaceFunction(context, fn);
+    }
+    emitNamespaceBootstrap(context, namespace);
+    for (const constant of namespace.constants) {
+        emitConstant(context, constant);
+    }
+    for (const alias of namespace.aliases) {
+        emitAlias(context, alias);
+    }
+    const directory = namespace.name.toLowerCase();
+    return {
+        path: `${directory}/${directory}.ts`,
+        source: context.module.toSource(),
+    };
+};
+/**
+ * Returns the namespace's classes ordered so each class is preceded by every
+ * same-namespace ancestor it extends.
+ *
+ * Generated JS classes use `extends`, which is a runtime reference: a child
+ * class declaration that names its parent before the parent's class body runs
+ * hits a temporal dead-zone error. GIR file order is source order, which does
+ * not match the inheritance order for namespaces where a leaf type (e.g.
+ * `GObject.Binding`) is declared earlier in the file than its base (e.g.
+ * `GObject.Object`). The codegen sorts by inheritance instead.
+ *
+ * Cross-namespace parents are imported by the writer and do not participate in
+ * the sort.
+ *
+ * @param classes - The classes to order
+ * @param namespaceName - The namespace these classes live in
+ */
+const topologicalClassOrder = (classes, namespaceName) => {
+    const byLocalName = new Map();
+    for (const klass of classes)
+        byLocalName.set(klass.name, klass);
+    const result = [];
+    const placed = new Set();
+    const visiting = new Set();
+    const visit = (klass) => {
+        if (placed.has(klass))
+            return;
+        if (visiting.has(klass))
+            return;
+        visiting.add(klass);
+        const parent = sameNamespaceParent(klass, namespaceName, byLocalName);
+        if (parent !== undefined)
+            visit(parent);
+        visiting.delete(klass);
+        placed.add(klass);
+        result.push(klass);
+    };
+    for (const klass of classes)
+        visit(klass);
+    return result;
+};
+const sameNamespaceParent = (klass, namespaceName, byLocalName) => {
+    if (klass.parent === undefined)
+        return undefined;
+    const dot = klass.parent.indexOf(".");
+    if (dot === -1)
+        return byLocalName.get(klass.parent);
+    if (klass.parent.slice(0, dot) !== namespaceName)
+        return undefined;
+    return byLocalName.get(klass.parent.slice(dot + 1));
+};
+//# sourceMappingURL=pipeline.js.map

package/dist/ffi/pipeline.js.map

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

package/dist/fingerprint.d.ts

@@ -0,0 +1,30 @@
+/** Filename of the staleness sentinel written into the `@gtkx/gi` store root. */
+export declare const FINGERPRINT_FILENAME = ".codegen-fingerprint.json";
+/**
+ * The `@gtkx/codegen` package version, mixed into the store fingerprint so a
+ * codegen upgrade invalidates a previously-generated store.
+ */
+export declare const CODEGEN_VERSION: string;
+/**
+ * The staleness sentinel written into the generated `@gtkx/gi` store: the
+ * fingerprint value plus the inputs that produced it, so a consumer can
+ * recompute and compare without reloading the GIR repository.
+ */
+export type CodegenFingerprint = {
+    /** The fingerprint hash of {@link CODEGEN_VERSION}, libraries, and GIR contents. */
+    readonly value: string;
+    /** Absolute paths of every loaded `.gir` file, in load order. */
+    readonly girFiles: readonly string[];
+    /** The resolved `Name-Version` library identifiers the store was built for. */
+    readonly libraries: readonly string[];
+};
+/**
+ * Computes a content fingerprint over the codegen version, the resolved library
+ * set, and the contents of every loaded GIR file. A change to any of these
+ * means the generated bindings are stale and must be regenerated.
+ *
+ * @param girFiles - Absolute paths of the loaded `.gir` files
+ * @param libraries - The resolved `Name-Version` library identifiers
+ */
+export declare const computeFingerprint: (girFiles: readonly string[], libraries: readonly string[]) => string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAoE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,WAAW,SAAS,MAAM,EAAE,KAAG,MAY9F,CAAC"}

package/dist/fingerprint.js

@@ -0,0 +1,33 @@
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/** Filename of the staleness sentinel written into the `@gtkx/gi` store root. */
+export const FINGERPRINT_FILENAME = ".codegen-fingerprint.json";
+/**
+ * The `@gtkx/codegen` package version, mixed into the store fingerprint so a
+ * codegen upgrade invalidates a previously-generated store.
+ */
+export const CODEGEN_VERSION = require("../package.json").version;
+/**
+ * Computes a content fingerprint over the codegen version, the resolved library
+ * set, and the contents of every loaded GIR file. A change to any of these
+ * means the generated bindings are stale and must be regenerated.
+ *
+ * @param girFiles - Absolute paths of the loaded `.gir` files
+ * @param libraries - The resolved `Name-Version` library identifiers
+ */
+export const computeFingerprint = (girFiles, libraries) => {
+    const hash = createHash("sha256");
+    hash.update(CODEGEN_VERSION);
+    hash.update("\n");
+    hash.update([...libraries].sort((a, b) => a.localeCompare(b)).join(","));
+    for (const file of [...girFiles].sort((a, b) => a.localeCompare(b))) {
+        hash.update("\n");
+        hash.update(file);
+        hash.update("\0");
+        hash.update(readFileSync(file));
+    }
+    return hash.digest("hex");
+};
+//# sourceMappingURL=fingerprint.js.map