@gtkx/codegen 0.21.0

package/dist/writers/interface.d.ts

@@ -0,0 +1,16 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirClass } from "../gir/class.js";
+/**
+ * Emits a class declaration for a `<interface>` element.
+ *
+ * Interfaces have no GIR parent — they extend the GObject base
+ * (`GObject.Object`) in the generated output because every implementor is
+ * itself a GObject. Methods, static functions, and constructors are
+ * surfaced on the interface class just like a regular class so JS callers
+ * can dispatch them directly on interface-typed values.
+ *
+ * @param context - The module context
+ * @param iface - The interface to emit
+ */
+export declare const emitInterface: (context: ModuleContext, iface: GirClass) => void;
+//# sourceMappingURL=interface.d.ts.map

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

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

package/dist/writers/interface.js

@@ -0,0 +1,155 @@
+import { toPascalCase } from "@gtkx/utils";
+import { indent } from "../dsl/emit.js";
+import { splitQualifiedName } from "../gir/qualified-name.js";
+import { qualifyFunction } from "../gir/qualify.js";
+import { appendMethodBinding, dedupeCallables, emitBindings, indexMethodsByName, renderInstanceMethod, renderPlainTypeMembers, } from "./callables.js";
+import { renderVfuncMetadata } from "./class-struct.js";
+import { renderGetTypeReference } from "./gtype-binding.js";
+import { resolveImplementedInterface } from "./inheritance.js";
+import { methodExportName } from "./method.js";
+import { renderPropertyAccessor } from "./property-accessor.js";
+import { appendNativeClassRegistration } from "./registration.js";
+import { renderSignalMembers } from "./signal.js";
+/**
+ * Emits a class declaration for a `<interface>` element.
+ *
+ * Interfaces have no GIR parent — they extend the GObject base
+ * (`GObject.Object`) in the generated output because every implementor is
+ * itself a GObject. Methods, static functions, and constructors are
+ * surfaced on the interface class just like a regular class so JS callers
+ * can dispatch them directly on interface-typed values.
+ *
+ * @param context - The module context
+ * @param iface - The interface to emit
+ */
+export const emitInterface = (context, iface) => {
+    if (!iface.introspectable)
+        return;
+    if (iface.name.length === 0)
+        return;
+    const className = toPascalCase(iface.name);
+    const callables = {
+        constructors: dedupeCallables(iface.constructors),
+        functions: dedupeCallables(iface.functions),
+        methods: dedupeCallables(iface.methods),
+    };
+    emitBindings(context, callables);
+    const parent = resolveInterfaceParent(context);
+    const members = renderInterfaceMembers(context, iface, callables);
+    const body = members.map((member) => indent(member, 1)).join("\n\n");
+    context.module.appendDeclaration(`export class ${className} extends ${parent} {\n${body}\n}`);
+    const prerequisiteRefs = iface.prerequisites
+        .map((name) => resolvePrerequisiteReference(context, name))
+        .filter((entry) => entry !== undefined);
+    if (prerequisiteRefs.length > 0) {
+        context.module.appendDeclaration(`export interface ${className} extends ${prerequisiteRefs.join(", ")} {}`);
+    }
+    appendInterfaceRegistrations(context, iface, className);
+};
+const renderInterfaceMembers = (context, iface, callables) => {
+    const className = toPascalCase(iface.name);
+    const { members, claimedNames } = renderPlainTypeMembers({
+        context,
+        className,
+        callables,
+        hasGType: true,
+        wrap: "interface",
+    });
+    appendPrerequisiteMethods(context, iface, members, claimedNames);
+    const methodByName = indexMethodsByName(callables.methods);
+    for (const property of iface.properties) {
+        const block = renderPropertyAccessor(context, property, claimedNames, methodByName);
+        if (block !== undefined)
+            members.push(block);
+    }
+    members.push(...renderSignalMembers(context, iface));
+    return members;
+};
+/**
+ * Copies the methods of an interface's transitive prerequisite interfaces onto
+ * the interface wrapper class.
+ *
+ * A `Gtk.SelectionModel` value is also a `Gio.ListModel`, but the JS wrapper
+ * only exposes `getNItems`/`getItem` if those prerequisite methods are emitted
+ * on the wrapper. Each prerequisite interface's methods are re-rooted to its
+ * namespace, bound, and emitted as direct members; names already provided by
+ * the interface itself are skipped.
+ *
+ * @param context - The module context
+ * @param iface - The interface being emitted
+ * @param members - The accumulating member list
+ * @param claimedNames - Names already emitted on the interface body
+ */
+const appendPrerequisiteMethods = (context, iface, members, claimedNames) => {
+    for (const method of collectPrerequisiteMethods(context, iface)) {
+        const name = methodExportName(method);
+        if (name === "constructor" || claimedNames.has(name))
+            continue;
+        const block = renderInstanceMethod(context, method);
+        if (block === undefined)
+            continue;
+        appendMethodBinding(context, method);
+        members.push(block);
+        claimedNames.add(name);
+    }
+};
+const collectPrerequisiteMethods = (context, iface) => {
+    const result = [];
+    const visited = new Set();
+    const seen = new Set();
+    for (const method of iface.methods) {
+        if (method.introspectable)
+            seen.add(methodExportName(method));
+    }
+    const visit = (klass, namespaceName) => {
+        for (const prerequisiteName of klass.prerequisites) {
+            const prerequisite = resolveImplementedInterface(context, prerequisiteName, namespaceName);
+            if (prerequisite === undefined)
+                continue;
+            const key = `${prerequisite.namespaceName}.${prerequisite.klass.name}`;
+            if (visited.has(key))
+                continue;
+            visited.add(key);
+            for (const method of dedupeCallables(prerequisite.klass.methods)) {
+                const name = methodExportName(method);
+                if (seen.has(name))
+                    continue;
+                seen.add(name);
+                result.push(qualifyFunction(method, prerequisite.namespaceName));
+            }
+            visit(prerequisite.klass, prerequisite.namespaceName);
+        }
+    };
+    visit(iface, context.namespace.name);
+    return result;
+};
+const appendInterfaceRegistrations = (context, iface, className) => {
+    const getTypeRef = iface.glibGetType === undefined
+        ? undefined
+        : renderGetTypeReference(context, iface.glibGetType, iface.glibTypeName);
+    appendNativeClassRegistration(context, {
+        className,
+        role: "interface",
+        getTypeRef,
+        vfuncs: renderVfuncMetadata(context, iface),
+    });
+};
+const resolveInterfaceParent = (context) => {
+    if (context.namespace.name === "GObject")
+        return "Object";
+    const alias = context.addCrossNamespaceImport("GObject");
+    return `${alias}.Object`;
+};
+const resolvePrerequisiteReference = (context, name) => {
+    const { namespaceName, typeName } = splitQualifiedName(name, context.namespace.name);
+    const resolved = context.repository.resolveNamed(namespaceName, typeName);
+    if (resolved === undefined)
+        return undefined;
+    if (resolved.kind !== "interface" && resolved.kind !== "class")
+        return undefined;
+    if (namespaceName === context.namespace.name)
+        return toPascalCase(typeName);
+    const alias = context.addCrossNamespaceImport(namespaceName);
+    return `${alias}.${toPascalCase(typeName)}`;
+};
+//# sourceMappingURL=interface.js.map

package/dist/writers/interface.js.map

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

package/dist/writers/method.d.ts

@@ -0,0 +1,150 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirFunction } from "../gir/function.js";
+import { type GirParameter } from "../gir/parameter.js";
+import type { GirTypeRef } from "../gir/type-ref.js";
+/**
+ * Returns the camelCased JS export name for a callable's method or static.
+ *
+ * @param fn - The callable
+ */
+export declare const methodExportName: (fn: GirFunction) => string;
+/**
+ * Renders the TypeScript parameter list for a callable.
+ *
+ * Drops out-only parameters, `<varargs>` slots, and array-length
+ * parameters whose value is computed from a sibling array's `.length`.
+ * Names follow `toCamelCase` of the GIR name, falling back to
+ * `arg<index>` for unnamed positions.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export declare const renderMethodSignature: (context: ModuleContext, fn: GirFunction) => string;
+/**
+ * Renders the TypeScript return-type annotation for a callable.
+ *
+ * Multi-out callables tuple the primary return with each out-parameter
+ * (`[primary, ...outs]`); when the primary return is void the tuple
+ * starts at the first out-parameter.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export declare const renderMethodReturnType: (context: ModuleContext, fn: GirFunction) => string;
+/**
+ * Optional override for the wrapper produced for the primary return value.
+ *
+ * Constructors use this to force the result to be wrapped as the owning
+ * class even when the GIR `<return-value>` is typed as a parent class.
+ */
+type ReturnOverride = {
+    /**
+     * Resolve the wrapper from the value's runtime GLib type, so a
+     * constructor that hands back a subclass instance (e.g.
+     * `ShortcutTrigger.parseString` returning a `KeyvalTrigger`) keeps
+     * its concrete class and identity registration.
+     */
+    readonly via: "gobject";
+} | {
+    /** Local interface identifier to fall back to when no registered class conforms. */
+    readonly className: string;
+    /**
+     * Resolve the wrapper from the runtime type, walking to the closest
+     * registered ancestor that still implements the interface and falling
+     * back to the interface class itself — the path interface-typed values
+     * take so a private implementation type still exposes the interface.
+     */
+    readonly via: "interface";
+} | {
+    /** Local class identifier to pass as the second argument of `getNativeObject`. */
+    readonly className: string;
+    /**
+     * Wrap as the exact value-type class. Boxed records carry no runtime
+     * GObject type instance, so the class must be supplied explicitly.
+     */
+    readonly via: "boxed";
+};
+/**
+ * Renders the JS body of a promisified `*_async` method that delegates to
+ * the runtime's `promisify` helper.
+ *
+ * The method's leading FFI args (everything before the `GCancellable*`
+ * slot) and the cancellable parameter are extracted from the GIR `*_async`
+ * signature; the trailing `GAsyncReadyCallback` slot is filled by
+ * `promisify`. The `*_finish` companion is bound from the same class via
+ * `this[finishName].bind(this)`.
+ *
+ * @param context - The module context
+ * @param asyncFn - The `*_async` callable
+ * @param finishMember - The camelCase JS name of the companion `*_finish` method
+ * @param bindingExpression - Expression that evaluates to the bound async `t.fn` callable
+ */
+export declare const renderPromisifiedBody: (context: ModuleContext, asyncFn: GirFunction, finishMember: string, bindingExpression: string) => string;
+/**
+ * Renders the TypeScript signature for a promisified `*_async` method.
+ *
+ * The signature drops the trailing `GAsyncReadyCallback` and `gpointer
+ * user_data` slots, marks the cancellable optional, and returns a
+ * `Promise` wrapping the finish method's return type.
+ *
+ * @param context - The module context
+ * @param asyncFn - The `*_async` callable
+ * @param finishFn - The companion `*_finish` callable
+ */
+export declare const renderPromisifiedSignature: (context: ModuleContext, asyncFn: GirFunction, finishFn: GirFunction) => {
+    readonly signature: string;
+    readonly returnType: string;
+};
+export type WriteMethodBodyOptions = {
+    /** Bound `t.fn` callable expression to invoke. */
+    readonly bindingExpression: string;
+    /** True for static methods, constructors, or namespace functions. */
+    readonly isStatic: boolean;
+    /** Optional override for the primary return wrapping class. */
+    readonly returnAs?: ReturnOverride;
+};
+export declare const renderMethodBody: (context: ModuleContext, fn: GirFunction, options: WriteMethodBodyOptions) => string;
+/**
+ * The marshalling plan for a callback or signal trampoline's incoming
+ * arguments: the rendered comma-separated handler call arguments and the
+ * trampoline-arg indices of any out-parameter cells.
+ */
+export type TrampolineArgPlan = {
+    readonly callArgs: string;
+    readonly outArgIndices: number[];
+};
+/**
+ * Plans how a callback or signal trampoline forwards its raw arguments to the
+ * user handler.
+ *
+ * In-parameters are wrapped via {@link wrapReturnValue} and joined into the
+ * handler call; out-parameters are dropped from the call and their trampoline
+ * cell indices collected for write-back. `argOffset` shifts every `args[...]`
+ * access: callbacks read from index `0`, while signal trampolines reserve
+ * index `0` for the emitting instance and so pass `1`.
+ *
+ * @param context - The module context
+ * @param parameters - The callback or signal parameters, varargs excluded
+ * @param namespaceName - The namespace the parameter type references resolve against
+ * @param argOffset - Added to each parameter's positional index
+ */
+export declare const planTrampolineArgs: (context: ModuleContext, parameters: readonly GirParameter[], namespaceName: string, argOffset: number) => TrampolineArgPlan;
+/**
+ * Renders the body of a native→JS callback wrapper that returns out-parameters
+ * as a tuple.
+ *
+ * The wrapped user function returns `[primary, ...outs]` (or the scalar out
+ * alone for a void return with a single out, or an out-only tuple otherwise).
+ * This emits `const _result = …;`, writes each out value into its `{ value }`
+ * cell's `value` slot (`args[i].value = …`), and returns the primary — keeping the
+ * tuple convention entirely in generated code so the native layer only flushes
+ * cells through their out-pointers. Shared by signal and callback writers.
+ *
+ * @param context - The module context
+ * @param callExpression - The expression that invokes the user function
+ * @param outArgIndices - Argument indices of the out-parameter cells
+ * @param returnRef - The primary return type, or `undefined` for void
+ */
+export declare const renderTupleWriteback: (context: ModuleContext, callExpression: string, outArgIndices: readonly number[], returnRef: GirTypeRef | undefined) => string;
+export {};
+//# sourceMappingURL=method.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"method.d.ts","sourceRoot":"","sources":["../../src/writers/method.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAA0D,MAAM,qBAAqB,CAAC;AAEhH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,oBAAoB,CAAC;AAcrF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,WAAW,KAAG,MAA8B,CAAC;AAElF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,MAM3E,CAAC;AAsBN;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,MAmBhF,CAAC;AAQF;;;;;GAKG;AACH,KAAK,cAAc,GACb;IACI;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CAC3B,GACD;IACI,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC7B,GACD;IACI,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACzB,CAAC;AAER;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAC9B,SAAS,aAAa,EACtB,SAAS,WAAW,EACpB,cAAc,MAAM,EACpB,mBAAmB,MAAM,KAC1B,MA+BF,CAAC;AAYF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GACnC,SAAS,aAAa,EACtB,SAAS,WAAW,EACpB,UAAU,WAAW,KACtB;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAS3D,CAAC;AA4CF,MAAM,MAAM,sBAAsB,GAAG;IACjC,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,EAAE,SAAS,sBAAsB,KAAG,MAoB3G,CAAC;AAgPF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAC3B,SAAS,aAAa,EACtB,YAAY,SAAS,YAAY,EAAE,EACnC,eAAe,MAAM,EACrB,WAAW,MAAM,KAClB,iBAsBF,CAAC;AAiBF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,GAC7B,SAAS,aAAa,EACtB,gBAAgB,MAAM,EACtB,eAAe,SAAS,MAAM,EAAE,EAChC,WAAW,UAAU,GAAG,SAAS,KAClC,MAqBF,CAAC"}