@gtkx/codegen 0.21.0

package/dist/writers/boxed.d.ts

@@ -0,0 +1,20 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirBoxed } from "../gir/boxed.js";
+/**
+ * Emits a class declaration plus optional boxed registration for a
+ * `<record>`, `<union>`, or `<glib:boxed>`.
+ *
+ * Walks constructors, static functions, and methods just like
+ * {@link emitClass}, attaching them to the boxed class. Field accessors
+ * and construction metadata are emitted by their dedicated writers.
+ *
+ * Vtable records (`glib:is-gtype-struct-for`) are skipped here — they are
+ * consumed by the owning class's vtable registration. Class- and
+ * interface-struct records (`GTypeClass`, `GEnumClass`, …) are likewise skipped
+ * as they are runtime vtables rather than marshallable values.
+ *
+ * @param context - The module context
+ * @param boxed - The boxed to emit
+ */
+export declare const emitBoxed: (context: ModuleContext, boxed: GirBoxed) => void;
+//# sourceMappingURL=boxed.d.ts.map

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

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

package/dist/writers/boxed.js

@@ -0,0 +1,71 @@
+import { indent } from "../dsl/emit.js";
+import { renderBoxedConstructor, renderBoxedConstructorPropsInterface } from "./boxed-constructor.js";
+import { renderBoxedFieldAccessor } from "./boxed-field-accessor.js";
+import { computeBoxedFieldSlots } from "./boxed-layout.js";
+import { dedupeCallables, emitBindings, renderPlainTypeMembers } from "./callables.js";
+import { isClassStructRecord } from "./class-struct-record.js";
+import { renderGetTypeReference } from "./gtype-binding.js";
+import { appendNativeClassRegistration } from "./registration.js";
+/**
+ * Emits a class declaration plus optional boxed registration for a
+ * `<record>`, `<union>`, or `<glib:boxed>`.
+ *
+ * Walks constructors, static functions, and methods just like
+ * {@link emitClass}, attaching them to the boxed class. Field accessors
+ * and construction metadata are emitted by their dedicated writers.
+ *
+ * Vtable records (`glib:is-gtype-struct-for`) are skipped here — they are
+ * consumed by the owning class's vtable registration. Class- and
+ * interface-struct records (`GTypeClass`, `GEnumClass`, …) are likewise skipped
+ * as they are runtime vtables rather than marshallable values.
+ *
+ * @param context - The module context
+ * @param boxed - The boxed to emit
+ */
+export const emitBoxed = (context, boxed) => {
+    if (!boxed.introspectable)
+        return;
+    if (boxed.kind === "vtable")
+        return;
+    if (boxed.name.length === 0)
+        return;
+    if (isClassStructRecord(context.namespace.name, boxed))
+        return;
+    const className = boxed.name;
+    const callables = {
+        constructors: dedupeCallables(boxed.constructors),
+        functions: dedupeCallables(boxed.functions),
+        methods: dedupeCallables(boxed.methods),
+    };
+    emitBindings(context, callables);
+    const members = renderBoxedMembers(context, boxed, className, callables);
+    const body = members.map((member) => indent(member, 1)).join("\n\n");
+    context.module.appendDeclaration(`export class ${className} {\n${body}\n}`);
+    context.module.appendDeclaration(renderBoxedConstructorPropsInterface(context, boxed, className));
+    const getTypeRef = boxed.glibGetType === undefined
+        ? undefined
+        : renderGetTypeReference(context, boxed.glibGetType, boxed.glibTypeName);
+    appendNativeClassRegistration(context, {
+        className,
+        role: "boxed",
+        getTypeRef,
+    });
+};
+const renderBoxedMembers = (context, boxed, className, callables) => {
+    const { members, claimedNames } = renderPlainTypeMembers({
+        context,
+        className,
+        callables,
+        hasGType: boxed.glibGetType !== undefined,
+        wrap: "boxed",
+    });
+    members.unshift(renderBoxedConstructor(context, boxed, className));
+    const { slots } = computeBoxedFieldSlots(context, boxed.fields, boxed.isUnion);
+    for (const slot of slots) {
+        const block = renderBoxedFieldAccessor(context, slot, claimedNames, boxed.fields);
+        if (block !== undefined)
+            members.push(block);
+    }
+    return members;
+};
+//# sourceMappingURL=boxed.js.map

package/dist/writers/boxed.js.map

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

package/dist/writers/callables.d.ts

@@ -0,0 +1,124 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirFunction } from "../gir/function.js";
+/**
+ * Constructors, static functions, and instance methods of a class, interface,
+ * or boxed record.
+ */
+export type Callables = {
+    readonly constructors: readonly GirFunction[];
+    readonly functions: readonly GirFunction[];
+    readonly methods: readonly GirFunction[];
+};
+/**
+ * Drops callables that lack a `c:identifier` or repeat one already retained.
+ *
+ * GIR sometimes lists the same callable twice (e.g. as both a class function
+ * and a constructor); the C identifier is the canonical key.
+ *
+ * @param callables - The raw GIR callables
+ */
+export declare const dedupeCallables: (callables: readonly GirFunction[]) => readonly GirFunction[];
+/**
+ * Appends the top-level `const fn = t.fn(...)` binding for every introspectable
+ * callable that has a C identifier and is not shadowed.
+ *
+ * @param context - The module context
+ * @param callables - The callables to bind
+ */
+/**
+ * Appends the top-level `const fn = t.fn(...)` binding for a single callable,
+ * deduplicated by its C identifier. Used when flattening interface and
+ * prerequisite methods onto a type one at a time.
+ *
+ * @param context - The module context
+ * @param method - The callable to bind
+ */
+export declare const appendMethodBinding: (context: ModuleContext, method: GirFunction) => void;
+export declare const emitBindings: (context: ModuleContext, callables: Callables) => void;
+/**
+ * How a type's static `<constructor>` factories wrap their result:
+ *
+ * - `"gobject"` — resolve the wrapper from the runtime GLib type (a class).
+ * - `"interface"` — resolve the runtime type, falling back to the closest
+ *   registered ancestor that implements the interface, then the interface itself.
+ * - `"boxed"` — wrap as the exact value-type class (boxed records).
+ */
+export type ConstructorWrap = "gobject" | "interface" | "boxed";
+/**
+ * Renders an instance method body for a GIR `<method>`.
+ *
+ * Hand-written runtime overrides (e.g. `g_value_get_boxed`) short-circuit the
+ * usual FFI call body with a throwing stub that the runtime replaces on the
+ * prototype at module load.
+ *
+ * Returns `undefined` for non-emittable callables.
+ *
+ * @param context - The module context
+ * @param callable - The GIR method callable
+ */
+export declare const renderInstanceMethod: (context: ModuleContext, callable: GirFunction, nameOverride?: string) => string | undefined;
+/**
+ * Inputs for {@link appendShadowedAliases}.
+ */
+export type ShadowedAliasOptions = {
+    readonly context: ModuleContext;
+    /** The full list of method callables. */
+    readonly methods: readonly GirFunction[];
+    /** Lookup table for shadower resolution. */
+    readonly methodByName: ReadonlyMap<string, GirFunction>;
+    /** The accumulating members list to append to. */
+    readonly members: string[];
+    /** Set of names already emitted on the class body. */
+    readonly claimedNames: Set<string>;
+};
+/**
+ * Appends shadowed-method aliases for every callable in `methods` whose
+ * shadower is introspectable.
+ *
+ * Records each emitted alias name in `claimedNames` so subsequent renderers
+ * can detect collisions.
+ *
+ * @param options - {@link ShadowedAliasOptions}
+ */
+export declare const appendShadowedAliases: (options: ShadowedAliasOptions) => void;
+/**
+ * Indexes a list of method callables by their GIR name for shadower lookup.
+ */
+export declare const indexMethodsByName: (methods: readonly GirFunction[]) => ReadonlyMap<string, GirFunction>;
+/**
+ * Renders the shared head of a class/interface/boxed body: every `static`
+ * constructor factory and every `static` namespace function on the same type.
+ *
+ * @param context - The module context
+ * @param callables - The class's emittable callables
+ * @param ownerClassName - The local PascalCase class name
+ * @param wrap - How static constructors lift their result to a wrapper
+ */
+export declare const renderStaticHead: (context: ModuleContext, callables: Callables, ownerClassName: string, wrap: ConstructorWrap) => readonly string[];
+/**
+ * Inputs for {@link renderPlainTypeMembers}.
+ */
+export type PlainTypeMembersOptions = {
+    readonly context: ModuleContext;
+    readonly className: string;
+    readonly callables: Callables;
+    /** Whether to prepend `declare __gtype__: number;`. */
+    readonly hasGType: boolean;
+    /** How static constructors lift their result to a wrapper. */
+    readonly wrap: ConstructorWrap;
+};
+/**
+ * Renders the shared head of an interface or boxed class body — `__gtype__`
+ * declaration (optional), statics, plain instance methods, and
+ * shadowed-method aliases — plus the `claimedNames` set populated by those
+ * renderers.
+ *
+ * Callers append the constructor, property accessors, field accessors, and
+ * signal members on top of the returned members list. The class writer takes
+ * a different path because it has to consult inherited signatures.
+ */
+export declare const renderPlainTypeMembers: (options: PlainTypeMembersOptions) => {
+    readonly members: string[];
+    readonly claimedNames: Set<string>;
+};
+//# sourceMappingURL=callables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callables.d.ts","sourceRoot":"","sources":["../../src/writers/callables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,SAAS,WAAW,EAAE,KAAG,SAAS,WAAW,EAUvF,CAAC;AAEF;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,aAAa,EAAE,QAAQ,WAAW,KAAG,IAMjF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,aAAa,EAAE,WAAW,SAAS,KAAG,IAW3E,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAqDhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC7B,SAAS,aAAa,EACtB,UAAU,WAAW,EACrB,eAAe,MAAM,KACtB,MAAM,GAAG,SAYX,CAAC;AA2BF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxD,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,oBAAoB,KAAG,IAerE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,WAAW,EAAE,KAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAInG,CAAC;AAcF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GACzB,SAAS,aAAa,EACtB,WAAW,SAAS,EACpB,gBAAgB,MAAM,EACtB,MAAM,eAAe,KACtB,SAAS,MAAM,EAWjB,CAAC;AAyBF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,uBAAuB,KACjC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAUlE,CAAC"}

package/dist/writers/callables.js

@@ -0,0 +1,283 @@
+import { toCamelCase } from "@gtkx/utils";
+import { indent } from "../dsl/emit.js";
+import { callableReferencesClassStruct } from "./class-struct-record.js";
+import { renderFnExpression } from "./function.js";
+import { methodExportName, renderMethodBody, renderMethodReturnType, renderMethodSignature } from "./method.js";
+import { renderRuntimeOverride } from "./runtime-override.js";
+/**
+ * Drops callables that lack a `c:identifier` or repeat one already retained.
+ *
+ * GIR sometimes lists the same callable twice (e.g. as both a class function
+ * and a constructor); the C identifier is the canonical key.
+ *
+ * @param callables - The raw GIR callables
+ */
+export const dedupeCallables = (callables) => {
+    const seen = new Set();
+    const result = [];
+    for (const callable of callables) {
+        if (callable.cIdentifier === undefined)
+            continue;
+        if (seen.has(callable.cIdentifier))
+            continue;
+        seen.add(callable.cIdentifier);
+        result.push(callable);
+    }
+    return result;
+};
+/**
+ * Appends the top-level `const fn = t.fn(...)` binding for every introspectable
+ * callable that has a C identifier and is not shadowed.
+ *
+ * @param context - The module context
+ * @param callables - The callables to bind
+ */
+/**
+ * Appends the top-level `const fn = t.fn(...)` binding for a single callable,
+ * deduplicated by its C identifier. Used when flattening interface and
+ * prerequisite methods onto a type one at a time.
+ *
+ * @param context - The module context
+ * @param method - The callable to bind
+ */
+export const appendMethodBinding = (context, method) => {
+    if (method.cIdentifier === undefined)
+        return;
+    if (callableReferencesClassStruct(context, method))
+        return;
+    const expression = renderFnExpression(context, method);
+    if (expression === undefined)
+        return;
+    context.module.appendBinding(`const ${method.cIdentifier} = ${expression};`, method.cIdentifier);
+};
+export const emitBindings = (context, callables) => {
+    const all = [...callables.constructors, ...callables.functions, ...callables.methods];
+    for (const callable of all) {
+        if (!callable.introspectable)
+            continue;
+        if (callable.shadowedBy !== undefined)
+            continue;
+        if (callable.cIdentifier === undefined)
+            continue;
+        if (callableReferencesClassStruct(context, callable))
+            continue;
+        const expression = renderFnExpression(context, callable);
+        if (expression === undefined)
+            continue;
+        context.module.appendBinding(`const ${callable.cIdentifier} = ${expression};`, callable.cIdentifier);
+    }
+};
+/**
+ * Renders a `static <name>(...): Owner` factory method for a GIR `<constructor>`.
+ *
+ * Returns `undefined` for non-introspectable, shadowed, identifier-less, or
+ * `constructor`-named entries.
+ *
+ * @param context - The module context
+ * @param callable - The GIR constructor callable
+ * @param ownerClassName - The local class name that wraps the result
+ * @param wrap - How the result is lifted to its JavaScript wrapper
+ */
+const renderConstructorStatic = (context, callable, ownerClassName, wrap) => {
+    if (!isEmittableCallable(context, callable))
+        return undefined;
+    const name = constructorMemberName(callable.name);
+    if (name === undefined)
+        return undefined;
+    const cIdentifier = callable.cIdentifier;
+    if (cIdentifier === undefined)
+        return undefined;
+    const signature = renderMethodSignature(context, callable);
+    const body = renderMethodBody(context, callable, {
+        bindingExpression: cIdentifier,
+        isStatic: true,
+        returnAs: wrap === "gobject" ? { via: "gobject" } : { via: wrap, className: ownerClassName },
+    });
+    return `static ${name}(${signature}): ${ownerClassName} {\n${indent(body, 1)}\n}`;
+};
+/**
+ * Renders a `static <name>(...): Return` member for a GIR `<function>`.
+ *
+ * Returns `undefined` when the callable cannot be emitted on a class body.
+ *
+ * @param context - The module context
+ * @param callable - The GIR function callable
+ */
+const renderStaticMember = (context, callable) => {
+    if (!isEmittableCallable(context, callable))
+        return undefined;
+    const cIdentifier = callable.cIdentifier;
+    if (cIdentifier === undefined)
+        return undefined;
+    const name = toCamelCase(callable.name);
+    if (name === "constructor")
+        return undefined;
+    const signature = renderMethodSignature(context, callable);
+    const returnType = renderMethodReturnType(context, callable);
+    const body = renderMethodBody(context, callable, { bindingExpression: cIdentifier, isStatic: true });
+    return `static ${name}(${signature}): ${returnType} {\n${indent(body, 1)}\n}`;
+};
+/**
+ * Renders an instance method body for a GIR `<method>`.
+ *
+ * Hand-written runtime overrides (e.g. `g_value_get_boxed`) short-circuit the
+ * usual FFI call body with a throwing stub that the runtime replaces on the
+ * prototype at module load.
+ *
+ * Returns `undefined` for non-emittable callables.
+ *
+ * @param context - The module context
+ * @param callable - The GIR method callable
+ */
+export const renderInstanceMethod = (context, callable, nameOverride) => {
+    if (!isEmittableCallable(context, callable))
+        return undefined;
+    const cIdentifier = callable.cIdentifier;
+    if (cIdentifier === undefined)
+        return undefined;
+    const name = nameOverride ?? methodExportName(callable);
+    if (name === "constructor")
+        return undefined;
+    const override = renderRuntimeOverride(callable, name);
+    if (override !== undefined)
+        return override;
+    const signature = renderMethodSignature(context, callable);
+    const returnType = renderMethodReturnType(context, callable);
+    const body = renderMethodBody(context, callable, { bindingExpression: cIdentifier, isStatic: false });
+    return `${name}(${signature}): ${returnType} {\n${indent(body, 1)}\n}`;
+};
+/**
+ * Renders the legacy-name alias of a method that has been shadowed by a
+ * variadic or kebab-cased successor.
+ *
+ * Returns `undefined` when the alias collides with `constructor` or the
+ * shadower lacks a C identifier.
+ *
+ * @param context - The module context
+ * @param original - The shadowed callable whose name should remain reachable
+ * @param shadower - The callable the alias dispatches into
+ */
+const renderInstanceAlias = (context, original, shadower) => {
+    if (shadower.cIdentifier === undefined)
+        return undefined;
+    const aliasName = toCamelCase(original.name);
+    if (aliasName === "constructor")
+        return undefined;
+    const signature = renderMethodSignature(context, shadower);
+    const returnType = renderMethodReturnType(context, shadower);
+    const body = renderMethodBody(context, shadower, { bindingExpression: shadower.cIdentifier, isStatic: false });
+    return `${aliasName}(${signature}): ${returnType} {\n${indent(body, 1)}\n}`;
+};
+/**
+ * Appends shadowed-method aliases for every callable in `methods` whose
+ * shadower is introspectable.
+ *
+ * Records each emitted alias name in `claimedNames` so subsequent renderers
+ * can detect collisions.
+ *
+ * @param options - {@link ShadowedAliasOptions}
+ */
+export const appendShadowedAliases = (options) => {
+    const { context, methods, methodByName, members, claimedNames } = options;
+    for (const callable of methods) {
+        if (callable.shadowedBy === undefined)
+            continue;
+        if (callable.introspectable)
+            continue;
+        const shadower = methodByName.get(callable.shadowedBy);
+        if (shadower === undefined || !shadower.introspectable)
+            continue;
+        const aliasName = toCamelCase(callable.name);
+        if (claimedNames.has(aliasName))
+            continue;
+        const block = renderInstanceAlias(context, callable, shadower);
+        if (block !== undefined) {
+            members.push(block);
+            claimedNames.add(aliasName);
+        }
+    }
+};
+/**
+ * Indexes a list of method callables by their GIR name for shadower lookup.
+ */
+export const indexMethodsByName = (methods) => {
+    const map = new Map();
+    for (const callable of methods)
+        map.set(callable.name, callable);
+    return map;
+};
+const isEmittableCallable = (context, callable) => callable.introspectable &&
+    callable.shadowedBy === undefined &&
+    callable.cIdentifier !== undefined &&
+    !callableReferencesClassStruct(context, callable);
+const constructorMemberName = (girName) => {
+    const camel = toCamelCase(girName);
+    if (camel === "constructor")
+        return undefined;
+    return camel;
+};
+/**
+ * Renders the shared head of a class/interface/boxed body: every `static`
+ * constructor factory and every `static` namespace function on the same type.
+ *
+ * @param context - The module context
+ * @param callables - The class's emittable callables
+ * @param ownerClassName - The local PascalCase class name
+ * @param wrap - How static constructors lift their result to a wrapper
+ */
+export const renderStaticHead = (context, callables, ownerClassName, wrap) => {
+    const blocks = [];
+    for (const callable of callables.constructors) {
+        const block = renderConstructorStatic(context, callable, ownerClassName, wrap);
+        if (block !== undefined)
+            blocks.push(block);
+    }
+    for (const callable of callables.functions) {
+        const block = renderStaticMember(context, callable);
+        if (block !== undefined)
+            blocks.push(block);
+    }
+    return blocks;
+};
+/**
+ * Renders the plain instance methods of a class/interface/boxed body, the
+ * variant that does NOT consult inherited-signature conflicts. Used for
+ * interfaces and boxed records that do not extend other widget shapes.
+ *
+ * Records each emitted method name in `claimedNames` so subsequent property
+ * and signal-method renderers can detect collisions.
+ */
+const renderPlainInstanceMethods = (context, methods, claimedNames) => {
+    const blocks = [];
+    for (const callable of methods) {
+        const block = renderInstanceMethod(context, callable);
+        if (block === undefined)
+            continue;
+        blocks.push(block);
+        claimedNames.add(methodExportName(callable));
+    }
+    return blocks;
+};
+/**
+ * Renders the shared head of an interface or boxed class body — `__gtype__`
+ * declaration (optional), statics, plain instance methods, and
+ * shadowed-method aliases — plus the `claimedNames` set populated by those
+ * renderers.
+ *
+ * Callers append the constructor, property accessors, field accessors, and
+ * signal members on top of the returned members list. The class writer takes
+ * a different path because it has to consult inherited signatures.
+ */
+export const renderPlainTypeMembers = (options) => {
+    const { context, className, callables, hasGType, wrap } = options;
+    const members = [];
+    if (hasGType)
+        members.push("declare __gtype__: number;");
+    const claimedNames = new Set();
+    members.push(...renderStaticHead(context, callables, className, wrap));
+    members.push(...renderPlainInstanceMethods(context, callables.methods, claimedNames));
+    const methodByName = indexMethodsByName(callables.methods);
+    appendShadowedAliases({ context, methods: callables.methods, methodByName, members, claimedNames });
+    return { members, claimedNames };
+};
+//# sourceMappingURL=callables.js.map

package/dist/writers/callables.js.map

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

package/dist/writers/callback.d.ts

@@ -0,0 +1,16 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirCallback } from "../gir/callback.js";
+/**
+ * Emits an `export type` alias for a top-level GIR `<callback>`.
+ *
+ * The callback is surfaced under its GIR `name` verbatim with a fully typed
+ * call signature: input parameters follow {@link renderMethodSignature} (the
+ * folded `user_data`/`GDestroyNotify` slots are dropped) and the return follows
+ * {@link renderMethodReturnType}, so out-parameters tuple into the return the
+ * same way a method's would.
+ *
+ * @param context - The module context
+ * @param callback - The callback to emit
+ */
+export declare const emitCallback: (context: ModuleContext, callback: GirCallback) => void;
+//# sourceMappingURL=callback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../src/writers/callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmBtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,aAAa,EAAE,UAAU,WAAW,KAAG,IAO5E,CAAC"}

package/dist/writers/callback.js

@@ -0,0 +1,38 @@
+import { renderMethodReturnType, renderMethodSignature } from "./method.js";
+const callbackAsFunction = (callback) => ({
+    kind: "function",
+    name: callback.name,
+    cIdentifier: undefined,
+    throws: false,
+    introspectable: callback.introspectable,
+    shadows: undefined,
+    shadowedBy: undefined,
+    movedTo: undefined,
+    instance: undefined,
+    parameters: callback.parameters,
+    returnValue: callback.returnValue,
+    invoker: undefined,
+});
+/**
+ * Emits an `export type` alias for a top-level GIR `<callback>`.
+ *
+ * The callback is surfaced under its GIR `name` verbatim with a fully typed
+ * call signature: input parameters follow {@link renderMethodSignature} (the
+ * folded `user_data`/`GDestroyNotify` slots are dropped) and the return follows
+ * {@link renderMethodReturnType}, so out-parameters tuple into the return the
+ * same way a method's would.
+ *
+ * @param context - The module context
+ * @param callback - The callback to emit
+ */
+export const emitCallback = (context, callback) => {
+    if (!callback.introspectable)
+        return;
+    if (callback.name.length === 0)
+        return;
+    const fn = callbackAsFunction(callback);
+    const signature = renderMethodSignature(context, fn);
+    const returnType = renderMethodReturnType(context, fn);
+    context.module.appendDeclaration(`export type ${callback.name} = (${signature}) => ${returnType};`);
+};
+//# sourceMappingURL=callback.js.map

package/dist/writers/callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.js","sourceRoot":"","sources":["../../src/writers/callback.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,kBAAkB,GAAG,CAAC,QAAqB,EAAe,EAAE,CAAC,CAAC;IAChE,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,WAAW,EAAE,SAAS;IACtB,MAAM,EAAE,KAAK;IACb,cAAc,EAAE,QAAQ,CAAC,cAAc;IACvC,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;IAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,OAAO,EAAE,SAAS;CACrB,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,QAAqB,EAAQ,EAAE;IAChF,IAAI,CAAC,QAAQ,CAAC,cAAc;QAAE,OAAO;IACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvC,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,eAAe,QAAQ,CAAC,IAAI,OAAO,SAAS,QAAQ,UAAU,GAAG,CAAC,CAAC;AACxG,CAAC,CAAC"}

package/dist/writers/class-struct-record.d.ts

@@ -0,0 +1,31 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirBoxed } from "../gir/boxed.js";
+import type { GirFunction } from "../gir/function.js";
+import type { GirTypeRef } from "../gir/type-ref.js";
+/**
+ * Reports whether a `<record>` is a GObject class- or interface-struct — the
+ * runtime vtable of a type rather than a marshallable value. These are never
+ * constructed or passed by value from JavaScript, so codegen emits neither the
+ * record nor any binding that references it.
+ *
+ * @param namespaceName - The namespace the record lives in
+ * @param boxed - The record under consideration
+ */
+export declare const isClassStructRecord: (namespaceName: string, boxed: GirBoxed) => boolean;
+/**
+ * Reports whether a type reference resolves to a class/interface-struct record,
+ * following array and list element types.
+ *
+ * @param context - The module context
+ * @param ref - The type reference, or `undefined`
+ */
+export declare const typeRefIsClassStruct: (context: ModuleContext, ref: GirTypeRef | undefined) => boolean;
+/**
+ * Reports whether a callable's return type or any parameter resolves to a
+ * class/interface-struct record, so its binding and wrapper can be dropped.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export declare const callableReferencesClassStruct: (context: ModuleContext, fn: GirFunction) => boolean;
+//# sourceMappingURL=class-struct-record.d.ts.map

package/dist/writers/class-struct-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-struct-record.d.ts","sourceRoot":"","sources":["../../src/writers/class-struct-record.ts"],"names":[],"mappings":"AAAA,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,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,EAAE,OAAO,QAAQ,KAAG,OAO5E,CAAC;AAmBF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,aAAa,EAAE,KAAK,UAAU,GAAG,SAAS,KAAG,OACzD,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,OAER,CAAC"}