@gtkx/codegen 0.21.0

package/dist/writers/constructor-props.d.ts

@@ -0,0 +1,32 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirClass } from "../gir/class.js";
+/**
+ * Renders the `export interface <Class>ConstructorProps` declaration.
+ *
+ * Each interface lists the camelCase, optional, nullable form of every
+ * property the class introduces and `extends` its parent's interface, so the
+ * full inherited prop set is available when typing `new <Class>(props)`.
+ *
+ * @param context - The module context
+ * @param klass - The class to render props for
+ * @param className - The local PascalCase class name
+ */
+export declare const renderConstructorPropsInterface: (context: ModuleContext, klass: GirClass, className: string) => string;
+/**
+ * Renders the constructor for a class, or `undefined` when none is needed.
+ *
+ * The parentless root of a GObject hierarchy gets the canonical base
+ * constructor that hands the assembled `GValue` record to
+ * `constructGObjectInstance`. A class that introduces constructable props gets
+ * a constructor that destructures and translates those props into `GValue`s,
+ * spreads the untranslated remainder, and forwards everything to `super`. A
+ * class that introduces no props gets no constructor and inherits its nearest
+ * typed ancestor's, keeping the chain free of redundant hops.
+ *
+ * @param context - The module context
+ * @param klass - The class being emitted
+ * @param className - The local PascalCase class name
+ * @param hasParent - Whether the class declares an `extends` clause
+ */
+export declare const renderClassConstructor: (context: ModuleContext, klass: GirClass, className: string, hasParent: boolean) => string | undefined;
+//# sourceMappingURL=constructor-props.d.ts.map

package/dist/writers/constructor-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-props.d.ts","sourceRoot":"","sources":["../../src/writers/constructor-props.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAyChD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,GAAI,SAAS,aAAa,EAAE,OAAO,QAAQ,EAAE,WAAW,MAAM,KAAG,MAQ5G,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,aAAa,EACtB,OAAO,QAAQ,EACf,WAAW,MAAM,EACjB,WAAW,OAAO,KACnB,MAAM,GAAG,SAKX,CAAC"}

package/dist/writers/constructor-props.js

@@ -0,0 +1,110 @@
+import { quote, toCamelCase, toIdentifier, toPascalCase } from "@gtkx/utils";
+import { indent } from "../dsl/emit.js";
+import { splitQualifiedName } from "../gir/qualified-name.js";
+import { collectInterfaceProperties } from "./inheritance.js";
+import { renderTsType } from "./ts-type.js";
+import { renderFfiType } from "./value.js";
+/**
+ * Whether a property can be passed to a constructor: writable, construct, or
+ * construct-only properties only. Read-only properties cannot be set through
+ * `g_object_new_with_properties`.
+ *
+ * @param property - The GIR property
+ */
+const isConstructable = (property) => property.writable || property.construct || property.constructOnly;
+/**
+ * The constructable properties a class introduces: its own writable/construct
+ * properties plus those it inherits from directly-implemented interfaces,
+ * deduplicated by camelCase JS name (the class's own declaration wins).
+ *
+ * Ancestor class properties are intentionally excluded — each class translates
+ * only the props it introduces and forwards the rest up the `super(...)` chain.
+ *
+ * @param context - The module context
+ * @param klass - The class whose construct props to collect
+ */
+const collectConstructableProps = (context, klass) => {
+    const all = [...klass.properties, ...collectInterfaceProperties(context, klass)].filter(isConstructable);
+    const seen = new Set();
+    const result = [];
+    for (const property of all) {
+        const jsName = toIdentifier(toCamelCase(property.name));
+        if (seen.has(jsName))
+            continue;
+        seen.add(jsName);
+        result.push(property);
+    }
+    return result;
+};
+/**
+ * Renders the `export interface <Class>ConstructorProps` declaration.
+ *
+ * Each interface lists the camelCase, optional, nullable form of every
+ * property the class introduces and `extends` its parent's interface, so the
+ * full inherited prop set is available when typing `new <Class>(props)`.
+ *
+ * @param context - The module context
+ * @param klass - The class to render props for
+ * @param className - The local PascalCase class name
+ */
+export const renderConstructorPropsInterface = (context, klass, className) => {
+    const parentRef = resolveParentPropsReference(context, klass);
+    const extendsClause = parentRef === undefined ? "" : ` extends ${parentRef}`;
+    const lines = collectConstructableProps(context, klass).map((property) => `${toIdentifier(toCamelCase(property.name))}?: ${renderTsType(context, property.type, true)};`);
+    const body = lines.length === 0 ? "" : `\n${indent(lines.join("\n"), 1)}\n`;
+    return `export interface ${className}ConstructorProps${extendsClause} {${body}}`;
+};
+/**
+ * Renders the constructor for a class, or `undefined` when none is needed.
+ *
+ * The parentless root of a GObject hierarchy gets the canonical base
+ * constructor that hands the assembled `GValue` record to
+ * `constructGObjectInstance`. A class that introduces constructable props gets
+ * a constructor that destructures and translates those props into `GValue`s,
+ * spreads the untranslated remainder, and forwards everything to `super`. A
+ * class that introduces no props gets no constructor and inherits its nearest
+ * typed ancestor's, keeping the chain free of redundant hops.
+ *
+ * @param context - The module context
+ * @param klass - The class being emitted
+ * @param className - The local PascalCase class name
+ * @param hasParent - Whether the class declares an `extends` clause
+ */
+export const renderClassConstructor = (context, klass, className, hasParent) => {
+    if (!hasParent)
+        return renderRootConstructor(context);
+    const props = collectConstructableProps(context, klass);
+    if (props.length === 0)
+        return undefined;
+    return renderTranslatingConstructor(context, props, className);
+};
+/** The forwarding record of marshalled `GValue`s a constructor hands to `super`. */
+const GVALUE_RECORD = "Record<string, GValue | undefined>";
+const renderRootConstructor = (context) => {
+    context.addConstructGObjectInstanceImport();
+    context.addRuntimeImport("GValue");
+    const body = "constructGObjectInstance(this, props);";
+    return `constructor(props: ${GVALUE_RECORD} = {}) {\n${indent(body, 1)}\n}`;
+};
+const renderTranslatingConstructor = (context, props, className) => {
+    context.addValueFromFfiOptionalImport();
+    context.addRuntimeImport("GValue");
+    const destructured = props.map((property) => toIdentifier(toCamelCase(property.name)));
+    const pattern = `{ ${[...destructured, "...rest"].join(", ")} }`;
+    const entries = props.map((property) => `${quote(property.name)}: valueFromFfiOptional(${renderFfiType(context, property.type, property.transferOwnership)}, ${toIdentifier(toCamelCase(property.name))}),`);
+    const recordLiteral = `{\n${indent(entries.join("\n"), 1)}\n}`;
+    const lines = [`const props: ${GVALUE_RECORD} = ${recordLiteral};`, "super({ ...props, ...rest });"];
+    const body = lines.join("\n");
+    return `constructor(${pattern}: ${className}ConstructorProps = {}) {\n${indent(body, 1)}\n}`;
+};
+const resolveParentPropsReference = (context, klass) => {
+    if (klass.parent === undefined)
+        return undefined;
+    const { namespaceName, typeName } = splitQualifiedName(klass.parent, context.namespace.name);
+    const propsName = `${toPascalCase(typeName)}ConstructorProps`;
+    if (namespaceName === context.namespace.name)
+        return propsName;
+    const alias = context.addCrossNamespaceImport(namespaceName);
+    return `${alias}.${propsName}`;
+};
+//# sourceMappingURL=constructor-props.js.map

package/dist/writers/constructor-props.js.map

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

package/dist/writers/enum.d.ts

@@ -0,0 +1,21 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirEnum } from "../gir/enum.js";
+/**
+ * Emits the runtime declaration for an `<enumeration>` or `<bitfield>`.
+ *
+ * Two branches:
+ * - `glib:error-domain` present → `export type Name = number` plus
+ *   `createErrorDomain(quark, members)` typed as `ErrorDomain<{ members }>`,
+ *   since the domain object must stay `instanceof`-matchable.
+ * - GLib-registered enum/flags or C-only enum (no GLib registration) →
+ *   a TypeScript `enum Name { members }` declaration.
+ *
+ * Member names are derived from the GIR `name` attribute, uppercased with
+ * hyphens normalized to underscores. Names that would start with a digit
+ * (e.g. `5_6_5` → `_5_6_5`) are prefixed with an underscore.
+ *
+ * @param context - The module context
+ * @param enumeration - The enum to emit
+ */
+export declare const emitEnum: (context: ModuleContext, enumeration: GirEnum) => void;
+//# sourceMappingURL=enum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/writers/enum.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,aAAa,EAAE,aAAa,OAAO,KAAG,IAkBvE,CAAC"}

package/dist/writers/enum.js

@@ -0,0 +1,48 @@
+import { quote } from "@gtkx/utils";
+/**
+ * Emits the runtime declaration for an `<enumeration>` or `<bitfield>`.
+ *
+ * Two branches:
+ * - `glib:error-domain` present → `export type Name = number` plus
+ *   `createErrorDomain(quark, members)` typed as `ErrorDomain<{ members }>`,
+ *   since the domain object must stay `instanceof`-matchable.
+ * - GLib-registered enum/flags or C-only enum (no GLib registration) →
+ *   a TypeScript `enum Name { members }` declaration.
+ *
+ * Member names are derived from the GIR `name` attribute, uppercased with
+ * hyphens normalized to underscores. Names that would start with a digit
+ * (e.g. `5_6_5` → `_5_6_5`) are prefixed with an underscore.
+ *
+ * @param context - The module context
+ * @param enumeration - The enum to emit
+ */
+export const emitEnum = (context, enumeration) => {
+    if (!enumeration.introspectable)
+        return;
+    const name = enumeration.name;
+    const memberKeys = enumeration.members.map((member) => memberKey(member.name));
+    if (enumeration.errorDomain !== undefined) {
+        const memberEntries = enumeration.members.map((member, index) => `${memberKeys[index]}: ${member.value}`);
+        const typeFields = memberKeys.map((key) => `readonly ${key}: number`).join("; ");
+        context.addRuntimeImport("createErrorDomain");
+        context.addRuntimeImport("ErrorDomain");
+        const quarkExpression = renderQuarkExpression(context, enumeration.errorDomain);
+        context.module.appendDeclaration(`export type ${name} = number;`);
+        context.module.appendDeclaration(`export const ${name}: ErrorDomain<{ ${typeFields} }> = createErrorDomain(${quarkExpression}, { ${memberEntries.join(", ")} });`);
+        return;
+    }
+    const memberDeclarations = enumeration.members.map((member, index) => `${memberKeys[index]} = ${member.value}`);
+    context.module.appendDeclaration(`export enum ${name} { ${memberDeclarations.join(", ")} }`);
+};
+const memberKey = (name) => {
+    const upper = name.toUpperCase().replaceAll("-", "_");
+    return /^[0-9]/.test(upper) ? `_${upper}` : upper;
+};
+const renderQuarkExpression = (context, errorDomain) => {
+    if (context.namespace.name === "GLib") {
+        return `() => quarkFromString(${quote(errorDomain)})`;
+    }
+    const alias = context.addCrossNamespaceImport("GLib");
+    return `() => ${alias}.quarkFromString(${quote(errorDomain)})`;
+};
+//# sourceMappingURL=enum.js.map

package/dist/writers/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/writers/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAsB,EAAE,WAAoB,EAAQ,EAAE;IAC3E,IAAI,CAAC,WAAW,CAAC,cAAc;QAAE,OAAO;IACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,IAAI,WAAW,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1G,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QAC9C,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;QAChF,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,eAAe,IAAI,YAAY,CAAC,CAAC;QAClE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAC5B,gBAAgB,IAAI,mBAAmB,UAAU,2BAA2B,eAAe,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CACnI,CAAC;QACF,OAAO;IACX,CAAC;IACD,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAChH,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,eAAe,IAAI,MAAM,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjG,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,OAAsB,EAAE,WAAmB,EAAU,EAAE;IAClF,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,yBAAyB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;IAC1D,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,SAAS,KAAK,oBAAoB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;AACnE,CAAC,CAAC"}

package/dist/writers/function.d.ts

@@ -0,0 +1,40 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirFunction } from "../gir/function.js";
+import type { GirNamespace } from "../gir/namespace.js";
+/**
+ * Renders the `t.fn(library, symbol, args, returnType)` expression for a
+ * callable. Returns `undefined` when the callable cannot be bound (no C
+ * identifier or missing namespace shared-library).
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export declare const renderFnExpression: (context: ModuleContext, fn: GirFunction) => string | undefined;
+/**
+ * Emits both the bound `const fooBinding = t.fn(...)` and the
+ * `export function camelName(...)` wrapper for a namespace-level callable.
+ *
+ * Silently skipped when {@link renderFnExpression} cannot bind the callable
+ * (e.g. macros, unintrospectable signatures) or when the GIR marks the
+ * callable as `introspectable="0"`.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export declare const emitNamespaceFunction: (context: ModuleContext, fn: GirFunction) => void;
+/**
+ * Emits a namespace's self-bootstrap statements as module-load side effects:
+ * a call to its zero-argument `init` entry point and a `whenStopped`
+ * registration for its zero-argument `finalize` entry point.
+ *
+ * GTK-style libraries expose top-level `init`/`finalize` functions (`gtk_init`,
+ * `adw_init`, `gtk_source_finalize`, …). Calling `init()` as the module is
+ * imported initializes the library's runtime before any of its types are
+ * touched — without it a `Gdk` display lookup can run before `gtk_init`.
+ * Deferring `finalize` to `whenStopped` runs it during shutdown.
+ *
+ * @param context - The module context
+ * @param namespace - The namespace being generated
+ */
+export declare const emitNamespaceBootstrap: (context: ModuleContext, namespace: GirNamespace) => void;
+//# sourceMappingURL=function.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/writers/function.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAmDxD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,MAAM,GAAG,SAarF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,IAiB/E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,aAAa,EAAE,WAAW,YAAY,KAAG,IAYxF,CAAC"}

package/dist/writers/function.js

@@ -0,0 +1,127 @@
+import { quote } from "@gtkx/utils";
+import { arrayLiteral, indent, joinArgs } from "../dsl/emit.js";
+import { namespaceFunctionExportName } from "../dsl/identifier.js";
+import { callableReferencesClassStruct } from "./class-struct-record.js";
+import { renderMethodBody, renderMethodReturnType, renderMethodSignature } from "./method.js";
+import { closureAndDestroyIndices, needsRefArg } from "./param-classify.js";
+import { renderFfiType, renderSelfFfiType, renderTrampolineType } from "./value.js";
+/**
+ * Renders the FFI argument list for a callable, as a TypeScript array
+ * literal suitable as the third argument to `t.fn(...)`.
+ *
+ * Includes the instance parameter (if any), every regular parameter, and
+ * the implicit `GError**` ref when `throws=1`.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+const renderArgsLiteral = (context, fn) => {
+    const args = [];
+    const instanceOffset = fn.instance === undefined ? 0 : 1;
+    if (fn.instance !== undefined) {
+        context.addRuntimeImport("t");
+        args.push(`{ type: ${renderSelfFfiType(context, fn.instance)} }`);
+    }
+    const closureIndices = closureAndDestroyIndices(fn);
+    fn.parameters.forEach((parameter, index) => {
+        if (parameter.isVarargs)
+            return;
+        if (closureIndices.has(index))
+            return;
+        const optional = parameter.direction === "in" && (parameter.nullable || parameter.optional);
+        args.push(argLiteral(context, parameter, optional, instanceOffset));
+    });
+    if (fn.throws) {
+        context.addRuntimeImport("t");
+        args.push(`{ type: t.ref(t.boxed("GError", "full", "libgobject-2.0.so.0", "g_error_get_type")) }`);
+    }
+    return arrayLiteral(args);
+};
+const argLiteral = (context, parameter, optional, instanceOffset) => {
+    const trampoline = renderTrampolineType(context, parameter.type, parameter);
+    const inner = trampoline ?? renderFfiType(context, parameter.type, parameter.transferOwnership, instanceOffset);
+    const refWrapped = needsRefArg(context, parameter);
+    const expression = refWrapped ? `t.ref(${inner})` : inner;
+    return optional && !refWrapped ? `{ type: ${expression}, optional: true }` : `{ type: ${expression} }`;
+};
+/**
+ * Renders the `t.fn(library, symbol, args, returnType)` expression for a
+ * callable. Returns `undefined` when the callable cannot be bound (no C
+ * identifier or missing namespace shared-library).
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export const renderFnExpression = (context, fn) => {
+    if (fn.cIdentifier === undefined)
+        return undefined;
+    const library = context.namespace.sharedLibrary;
+    if (library === undefined)
+        return undefined;
+    context.addRuntimeImport("t");
+    const args = renderArgsLiteral(context, fn);
+    const returnType = renderFfiType(context, fn.returnValue.type, fn.returnValue.transferOwnership, fn.instance === undefined ? 0 : 1);
+    return `t.fn(${joinArgs([quote(library), quote(fn.cIdentifier), args, returnType])})`;
+};
+/**
+ * Emits both the bound `const fooBinding = t.fn(...)` and the
+ * `export function camelName(...)` wrapper for a namespace-level callable.
+ *
+ * Silently skipped when {@link renderFnExpression} cannot bind the callable
+ * (e.g. macros, unintrospectable signatures) or when the GIR marks the
+ * callable as `introspectable="0"`.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export const emitNamespaceFunction = (context, fn) => {
+    if (!fn.introspectable)
+        return;
+    if (fn.shadowedBy !== undefined)
+        return;
+    if (callableReferencesClassStruct(context, fn))
+        return;
+    const expression = renderFnExpression(context, fn);
+    if (expression === undefined)
+        return;
+    const bindingName = fn.cIdentifier;
+    if (bindingName === undefined)
+        return;
+    context.module.appendBinding(`const ${bindingName} = ${expression};`, bindingName);
+    const exportName = namespaceFunctionExportName(bindingName, fn.name, context.namespace.cSymbolPrefixes);
+    const signature = renderMethodSignature(context, fn);
+    const returnType = renderMethodReturnType(context, fn);
+    const body = renderMethodBody(context, fn, { bindingExpression: bindingName, isStatic: true });
+    context.module.appendDeclaration(`export function ${exportName}(${signature}): ${returnType} {\n${indent(body, 1)}\n}`);
+};
+/**
+ * Emits a namespace's self-bootstrap statements as module-load side effects:
+ * a call to its zero-argument `init` entry point and a `whenStopped`
+ * registration for its zero-argument `finalize` entry point.
+ *
+ * GTK-style libraries expose top-level `init`/`finalize` functions (`gtk_init`,
+ * `adw_init`, `gtk_source_finalize`, …). Calling `init()` as the module is
+ * imported initializes the library's runtime before any of its types are
+ * touched — without it a `Gdk` display lookup can run before `gtk_init`.
+ * Deferring `finalize` to `whenStopped` runs it during shutdown.
+ *
+ * @param context - The module context
+ * @param namespace - The namespace being generated
+ */
+export const emitNamespaceBootstrap = (context, namespace) => {
+    for (const fn of namespace.functions) {
+        if (fn.parameters.length > 0)
+            continue;
+        if (!fn.introspectable || fn.shadowedBy !== undefined || fn.cIdentifier === undefined)
+            continue;
+        const exportName = namespaceFunctionExportName(fn.cIdentifier, fn.name, context.namespace.cSymbolPrefixes);
+        if (fn.name === "init") {
+            context.module.appendRegistration(`${exportName}();`);
+        }
+        else if (fn.name === "finalize") {
+            context.module.imports.addNamed("@gtkx/ffi", "whenStopped");
+            context.module.appendRegistration(`whenStopped().then(${exportName});`);
+        }
+    }
+};
+//# sourceMappingURL=function.js.map

package/dist/writers/function.js.map

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

package/dist/writers/gtype-binding.d.ts

@@ -0,0 +1,19 @@
+import type { ModuleContext } from "../dsl/context.js";
+/**
+ * Renders the JS expression that resolves a class's `GType`, appending any
+ * required `t.fn` bindings to the module.
+ *
+ * For regular get-type symbols (`g_object_get_type`, `g_array_get_type`, …)
+ * the helper appends a `t.fn(...)` binding for the symbol and returns the bare
+ * function reference (`g_object_get_type`), which the runtime invokes once. For
+ * the GIR sentinel `"intern"` — used on `GVariant` and a few other types whose
+ * `GType` is registered intrinsically — it appends a binding for
+ * `g_type_from_name` and returns a `() => g_type_from_name("…")` thunk. Returns
+ * `undefined` when neither path is available.
+ *
+ * @param context - The module context
+ * @param getType - The C symbol name or the GIR sentinel `"intern"`
+ * @param glibTypeName - The GLib type name (for `"intern"` get-types)
+ */
+export declare const renderGetTypeReference: (context: ModuleContext, getType: string, glibTypeName: string | undefined) => string | undefined;
+//# sourceMappingURL=gtype-binding.d.ts.map

package/dist/writers/gtype-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtype-binding.d.ts","sourceRoot":"","sources":["../../src/writers/gtype-binding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,aAAa,EACtB,SAAS,MAAM,EACf,cAAc,MAAM,GAAG,SAAS,KACjC,MAAM,GAAG,SAQX,CAAC"}

package/dist/writers/gtype-binding.js

@@ -0,0 +1,40 @@
+import { quote } from "@gtkx/utils";
+const TYPE_FROM_NAME_BINDING = "g_type_from_name";
+const TYPE_FROM_NAME_LIB = "libgobject-2.0.so.0";
+/**
+ * Renders the JS expression that resolves a class's `GType`, appending any
+ * required `t.fn` bindings to the module.
+ *
+ * For regular get-type symbols (`g_object_get_type`, `g_array_get_type`, …)
+ * the helper appends a `t.fn(...)` binding for the symbol and returns the bare
+ * function reference (`g_object_get_type`), which the runtime invokes once. For
+ * the GIR sentinel `"intern"` — used on `GVariant` and a few other types whose
+ * `GType` is registered intrinsically — it appends a binding for
+ * `g_type_from_name` and returns a `() => g_type_from_name("…")` thunk. Returns
+ * `undefined` when neither path is available.
+ *
+ * @param context - The module context
+ * @param getType - The C symbol name or the GIR sentinel `"intern"`
+ * @param glibTypeName - The GLib type name (for `"intern"` get-types)
+ */
+export const renderGetTypeReference = (context, getType, glibTypeName) => {
+    if (getType === "intern" || getType === "") {
+        if (glibTypeName === undefined)
+            return undefined;
+        appendGTypeFromNameBinding(context);
+        return `() => ${TYPE_FROM_NAME_BINDING}(${quote(glibTypeName)})`;
+    }
+    appendGetTypeBinding(context, getType);
+    return getType;
+};
+const appendGetTypeBinding = (context, getType) => {
+    const lib = context.namespace.sharedLibrary ?? "";
+    const expression = `t.fn(${quote(lib)}, ${quote(getType)}, [], t.uint64)`;
+    context.module.appendBinding(`const ${getType} = ${expression};`, getType);
+};
+const appendGTypeFromNameBinding = (context) => {
+    const expression = `t.fn(${quote(TYPE_FROM_NAME_LIB)}, ${quote(TYPE_FROM_NAME_BINDING)}, ` +
+        `[{ type: t.string("borrowed") }], t.uint64)`;
+    context.module.appendBinding(`const ${TYPE_FROM_NAME_BINDING} = ${expression};`, TYPE_FROM_NAME_BINDING);
+};
+//# sourceMappingURL=gtype-binding.js.map

package/dist/writers/gtype-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtype-binding.js","sourceRoot":"","sources":["../../src/writers/gtype-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAClD,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAClC,OAAsB,EACtB,OAAe,EACf,YAAgC,EACd,EAAE;IACpB,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACzC,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACjD,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,SAAS,sBAAsB,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;IACrE,CAAC;IACD,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAsB,EAAE,OAAe,EAAQ,EAAE;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,QAAQ,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,OAAO,MAAM,UAAU,GAAG,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,OAAsB,EAAQ,EAAE;IAChE,MAAM,UAAU,GACZ,QAAQ,KAAK,CAAC,kBAAkB,CAAC,KAAK,KAAK,CAAC,sBAAsB,CAAC,IAAI;QACvE,6CAA6C,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,sBAAsB,MAAM,UAAU,GAAG,EAAE,sBAAsB,CAAC,CAAC;AAC7G,CAAC,CAAC"}

package/dist/writers/inheritance.d.ts

@@ -0,0 +1,48 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirClass } from "../gir/class.js";
+import type { GirProperty } from "../gir/property.js";
+import { type ResolvedQualifiedClass } from "../gir/qualified-name.js";
+/**
+ * A directly-implemented interface resolved to its declaration and the
+ * namespace that declares it.
+ */
+export type ResolvedInterface = {
+    readonly klass: GirClass;
+    readonly namespaceName: string;
+};
+/**
+ * Resolves an `<implements>` entry to its `<interface>` declaration.
+ *
+ * Returns `undefined` when the name resolves to a non-interface entity or
+ * cannot be resolved at all.
+ *
+ * @param context - The module context
+ * @param name - The (possibly cross-namespace) interface name
+ */
+export declare const resolveImplementedInterface: (context: ModuleContext, name: string, defaultNamespace?: string) => ResolvedInterface | undefined;
+/**
+ * Invokes `visit` for each ancestor class of `klass`, nearest first.
+ *
+ * Walks the same-namespace and cross-namespace parent chain, stopping at the
+ * first unresolved parent or a cycle. Each ancestor is reported together with
+ * the namespace it was resolved through so callers can qualify its references.
+ *
+ * @param context - The module context
+ * @param klass - The class whose ancestors to visit
+ * @param visit - Callback invoked once per resolved ancestor
+ */
+export declare const forEachAncestor: (context: ModuleContext, klass: GirClass, visit: (ancestor: ResolvedQualifiedClass) => void) => void;
+/**
+ * Collects the properties contributed by a class's directly-implemented
+ * interfaces that are not already declared on the class itself or inherited
+ * from an ancestor (or an ancestor-implemented interface).
+ *
+ * Each returned property carries its references re-rooted to the interface's
+ * namespace so the class writer can emit its accessor and constructor prop
+ * as if the property had been authored on the class.
+ *
+ * @param context - The module context
+ * @param klass - The implementing class
+ */
+export declare const collectInterfaceProperties: (context: ModuleContext, klass: GirClass) => readonly GirProperty[];
+//# sourceMappingURL=inheritance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance.d.ts","sourceRoot":"","sources":["../../src/writers/inheritance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,sBAAsB,EAA6C,MAAM,0BAA0B,CAAC;AAGlH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GACpC,SAAS,aAAa,EACtB,MAAM,MAAM,EACZ,mBAAkB,MAA+B,KAClD,iBAAiB,GAAG,SAKtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GACxB,SAAS,aAAa,EACtB,OAAO,QAAQ,EACf,OAAO,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,KAClD,IAeF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,aAAa,EAAE,OAAO,QAAQ,KAAG,SAAS,WAAW,EAuBxG,CAAC"}

package/dist/writers/inheritance.js

@@ -0,0 +1,90 @@
+import { toCamelCase, toIdentifier } from "@gtkx/utils";
+import { resolveQualifiedClass, splitQualifiedName } from "../gir/qualified-name.js";
+import { qualifyTypeRef } from "../gir/qualify.js";
+/**
+ * Resolves an `<implements>` entry to its `<interface>` declaration.
+ *
+ * Returns `undefined` when the name resolves to a non-interface entity or
+ * cannot be resolved at all.
+ *
+ * @param context - The module context
+ * @param name - The (possibly cross-namespace) interface name
+ */
+export const resolveImplementedInterface = (context, name, defaultNamespace = context.namespace.name) => {
+    const { namespaceName, typeName } = splitQualifiedName(name, defaultNamespace);
+    const resolved = context.repository.resolveNamed(namespaceName, typeName);
+    if (resolved === undefined || resolved.kind !== "interface")
+        return undefined;
+    return { klass: resolved.value, namespaceName: resolved.namespace.name };
+};
+/**
+ * Invokes `visit` for each ancestor class of `klass`, nearest first.
+ *
+ * Walks the same-namespace and cross-namespace parent chain, stopping at the
+ * first unresolved parent or a cycle. Each ancestor is reported together with
+ * the namespace it was resolved through so callers can qualify its references.
+ *
+ * @param context - The module context
+ * @param klass - The class whose ancestors to visit
+ * @param visit - Callback invoked once per resolved ancestor
+ */
+export const forEachAncestor = (context, klass, visit) => {
+    const visited = new Set();
+    let current = klass.parent === undefined ? undefined : { name: klass.parent, defaultNamespace: context.namespace.name };
+    while (current !== undefined) {
+        const resolved = resolveQualifiedClass(context.repository, current.name, current.defaultNamespace);
+        if (resolved === undefined)
+            break;
+        const key = `${resolved.namespaceName}.${resolved.klass.name}`;
+        if (visited.has(key))
+            break;
+        visited.add(key);
+        visit(resolved);
+        current = resolved.klass.parent
+            ? { name: resolved.klass.parent, defaultNamespace: resolved.namespaceName }
+            : undefined;
+    }
+};
+/**
+ * Collects the properties contributed by a class's directly-implemented
+ * interfaces that are not already declared on the class itself or inherited
+ * from an ancestor (or an ancestor-implemented interface).
+ *
+ * Each returned property carries its references re-rooted to the interface's
+ * namespace so the class writer can emit its accessor and constructor prop
+ * as if the property had been authored on the class.
+ *
+ * @param context - The module context
+ * @param klass - The implementing class
+ */
+export const collectInterfaceProperties = (context, klass) => {
+    const seen = new Set();
+    for (const property of klass.properties)
+        seen.add(toIdentifier(toCamelCase(property.name)));
+    forEachAncestor(context, klass, (ancestor) => {
+        for (const property of ancestor.klass.properties)
+            seen.add(toIdentifier(toCamelCase(property.name)));
+        for (const implementName of ancestor.klass.implements) {
+            const iface = resolveImplementedInterface(context, implementName, ancestor.namespaceName);
+            if (iface === undefined)
+                continue;
+            for (const property of iface.klass.properties)
+                seen.add(toIdentifier(toCamelCase(property.name)));
+        }
+    });
+    const result = [];
+    for (const implementName of klass.implements) {
+        const iface = resolveImplementedInterface(context, implementName);
+        if (iface === undefined)
+            continue;
+        for (const property of iface.klass.properties) {
+            const name = toIdentifier(toCamelCase(property.name));
+            if (seen.has(name))
+                continue;
+            seen.add(name);
+            result.push({ ...property, type: qualifyTypeRef(property.type, iface.namespaceName) });
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=inheritance.js.map

package/dist/writers/inheritance.js.map

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