@gtkx/codegen 0.21.0 → 1.0.0-rc.2

package/dist/dsl/context.js

@@ -1,140 +0,0 @@
-import { ModuleBuilder } from "./module.js";
-/**
- * Shared context handed to every writer for a single generated FFI module.
- *
- * Bundles the namespace the writer is emitting for, the broader repository
- * (for cross-namespace lookups), and the in-progress {@link ModuleBuilder}.
- * Writers also call back into this context to register cross-namespace
- * runtime imports so individual writers do not need to know the relative
- * path layout of the generated output.
- *
- * Generated bindings live in the `@gtkx/gi` package at `<ns>/<ns>.{js,d.ts}`,
- * with a per-namespace barrel at `<ns>/index.js` and the augment overlay at
- * `<ns>/augment/*.js`. The hand-written runtime is reached through the single
- * `@gtkx/ffi` barrel; sibling generated namespaces are reached relative to the
- * gi package root.
- */
-export class ModuleContext {
-    namespace;
-    repository;
-    module = new ModuleBuilder();
-    /**
-     * @param namespace - The namespace this module corresponds to
-     * @param repository - The repository containing every loaded namespace
-     */
-    constructor(namespace, repository) {
-        this.namespace = namespace;
-        this.repository = repository;
-    }
-    /**
-     * Adds a named import from the `@gtkx/ffi` runtime barrel.
-     */
-    addRuntimeImport(name) {
-        this.module.imports.addNamed("@gtkx/ffi", name);
-    }
-    /**
-     * Adds a type-only named import from the `@gtkx/ffi` runtime barrel
-     * (`import { type Name }`), erased from the emitted `.js`.
-     */
-    addRuntimeTypeImport(name) {
-        this.module.imports.addNamed("@gtkx/ffi", name, true);
-    }
-    /**
-     * Adds a named import from the low-level `@gtkx/native` runtime.
-     *
-     * The transport primitives (`alloc`, `call`, `read`, `write`) live in
-     * `@gtkx/native`; generated bindings reach them directly so `@gtkx/ffi`
-     * stays the home of higher-level runtime helpers only.
-     */
-    addNativeImport(name) {
-        this.module.imports.addNamed("@gtkx/native", name);
-    }
-    /**
-     * Adds a type-only named import from `@gtkx/native`
-     * (`import { type Name }`), erased from the emitted `.js`.
-     */
-    addNativeTypeImport(name) {
-        this.module.imports.addNamed("@gtkx/native", name, true);
-    }
-    /** Adds the canonical `constructGObjectInstance` import from `@gtkx/ffi`. */
-    addConstructGObjectInstanceImport() {
-        this.module.imports.addNamed("@gtkx/ffi", "constructGObjectInstance");
-    }
-    /** Adds the `valueFromFfi` import from `@gtkx/ffi`. */
-    addValueFromFfiImport() {
-        this.module.imports.addNamed("@gtkx/ffi", "valueFromFfi");
-    }
-    /** Adds the `valueFromFfiOptional` import from `@gtkx/ffi`. */
-    addValueFromFfiOptionalImport() {
-        this.module.imports.addNamed("@gtkx/ffi", "valueFromFfiOptional");
-    }
-    /**
-     * Adds the canonical side-effect imports for `gobject/object.js` and
-     * `gobject/value.js`.
-     *
-     * Skipped for the `GObject` namespace itself (those modules import its
-     * generated classes) and for `GLib`, which lives below GObject in the
-     * import graph. Letting GLib bootstrap creates a runtime cycle:
-     * `gobject.js` imports `glib.js` for `GLib.Variant` return-wrapping,
-     * `glib.js`'s bootstrap re-enters `gobject/value.js`, and `value.ts`
-     * touches `Value.prototype` before `gobject.js` has finished defining
-     * `Value`. Other namespaces install the override on first import.
-     */
-    addGObjectBootstrapImports() {
-        if (this.namespace.name === "GObject")
-            return;
-        if (this.namespace.name === "GLib")
-            return;
-        this.module.imports.addSideEffect("../gobject/augment/object.js");
-        this.module.imports.addSideEffect("../gobject/augment/value.js");
-    }
-    /**
-     * Adds a wildcard import for another namespace and returns the local
-     * alias used.
-     *
-     * Most namespaces are routed through their hand-written `index.js` so any
-     * prototype augmentations (Cairo `Context` methods, Gdk `RGBA`, Graphene
-     * structs, …) load whenever a generated module references the namespace.
-     * The foundational `gobject` and `glib` namespaces are routed straight to
-     * their generated module instead, because their indexes pull in modules
-     * that depend on values still mid-initialization, which would deadlock the
-     * import graph.
-     *
-     * For non-foundational namespaces a side-effect import is recorded
-     * alongside the wildcard so the foreign module loads even when its alias
-     * appears only in type positions. The wildcard alias is type-stripped out
-     * of the emitted `.js` whenever it is never read as a value, which would
-     * otherwise drop the foreign module from the runtime graph and skip its
-     * eager `*_get_type` registrations. The side-effect import survives type
-     * stripping and pins the module in place. The foundational `gobject` and
-     * `glib` wildcards are always read as values (enums, base classes) and so
-     * are never stripped, needing no side-effect pin.
-     *
-     * @param namespaceName - The other namespace (e.g. `"GLib"`)
-     */
-    addCrossNamespaceImport(namespaceName) {
-        if (namespaceName === this.namespace.name)
-            return namespaceName;
-        const directory = namespaceName.toLowerCase();
-        const isFoundational = directory === "gobject" || directory === "glib";
-        const path = isFoundational ? `../${directory}/${directory}.js` : `../${directory}/index.js`;
-        if (!isFoundational)
-            this.module.imports.addSideEffect(`../${directory}/${directory}.js`);
-        this.module.imports.addNamespace(path, namespaceName);
-        return namespaceName;
-    }
-    /**
-     * Renders a namespace-qualified reference to `typeName`: the bare name when
-     * it lives in this module's own namespace, otherwise `Alias.Name` with the
-     * foreign namespace imported on demand via {@link addCrossNamespaceImport}.
-     *
-     * @param namespaceName - The namespace the referenced type lives in
-     * @param typeName - The local type or export name within that namespace
-     */
-    qualify(namespaceName, typeName) {
-        if (namespaceName === this.namespace.name)
-            return typeName;
-        return `${this.addCrossNamespaceImport(namespaceName)}.${typeName}`;
-    }
-}
-//# sourceMappingURL=context.js.map

package/dist/dsl/context.js.map

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

package/dist/dsl/emit.d.ts

@@ -1,28 +0,0 @@
-/**
- * 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 declare const indent: (block: string, level: number) => string;
-/**
- * Joins `parts` with commas, dropping `undefined` entries.
- */
-export declare const joinArgs: (parts: ReadonlyArray<string | undefined>) => string;
-/**
- * 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 declare const arrayLiteral: (elements: readonly string[]) => string;
-//# sourceMappingURL=emit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/dsl/emit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MAOrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,MACK,CAAC;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,SAAS,MAAM,EAAE,KAAG,MAI1D,CAAC"}

package/dist/dsl/emit.js

@@ -1,41 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,28 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,45 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,107 +0,0 @@
-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

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

package/dist/dsl/module.d.ts

@@ -1,53 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,76 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,19 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}