@gtkx/codegen 0.21.0

package/dist/writers/param-classify.js

@@ -0,0 +1,163 @@
+import { toCamelCase, toIdentifier } from "@gtkx/utils";
+import { isCallerAllocatedOut, isOutParameter } from "../gir/parameter.js";
+/**
+ * The input parameters a callable's TypeScript signature exposes.
+ *
+ * Drops `<varargs>` slots, out-only and caller-allocated-out parameters,
+ * array-length parameters computed from a sibling array, and the
+ * `user_data`/`GDestroyNotify` slots folded into a callback descriptor. Each
+ * surviving parameter keeps its original index so callers can recover argument
+ * names.
+ *
+ * @param fn - The callable
+ */
+export const inputParameters = (fn) => {
+    const lengthIndices = arrayLengthIndices(fn);
+    const closureIndices = closureAndDestroyIndices(fn);
+    const result = [];
+    fn.parameters.forEach((parameter, index) => {
+        if (parameter.isVarargs)
+            return;
+        if (isOutParameter(parameter))
+            return;
+        if (isCallerAllocatedOut(parameter))
+            return;
+        if (lengthIndices.has(index))
+            return;
+        if (closureIndices.has(index))
+            return;
+        result.push({ parameter, index });
+    });
+    return result;
+};
+/**
+ * Indices of the `gpointer user_data` and `GDestroyNotify` parameters paired
+ * to a callback parameter. These slots are folded into the callback's
+ * trampoline descriptor and are not emitted as standalone FFI arguments.
+ *
+ * @param fn - The callable
+ */
+export const closureAndDestroyIndices = (fn) => {
+    const indices = new Set();
+    for (const parameter of fn.parameters) {
+        if (parameter.closureIndex !== undefined)
+            indices.add(parameter.closureIndex);
+        if (parameter.destroyIndex !== undefined)
+            indices.add(parameter.destroyIndex);
+    }
+    return indices;
+};
+const arrayLengthIndices = (fn) => {
+    const map = arrayLengthSources(fn);
+    return new Set(map.keys());
+};
+/**
+ * Maps each array-length parameter's index to the array parameter whose
+ * `.length` supplies it.
+ *
+ * @param fn - The callable
+ */
+export const arrayLengthSources = (fn) => {
+    const map = new Map();
+    fn.parameters.forEach((parameter, index) => {
+        if (parameter.type?.kind !== "array")
+            return;
+        const lengthIndex = parameter.type.lengthParameterIndex;
+        if (lengthIndex === undefined)
+            return;
+        map.set(lengthIndex, index);
+    });
+    return map;
+};
+/**
+ * Indices of parameters consumed as the length of the return array (and so
+ * dropped from the return tuple).
+ *
+ * @param fn - The callable
+ */
+export const returnArrayLengthIndices = (fn) => {
+    if (fn.returnValue.type?.kind !== "array")
+        return new Set();
+    const lengthIndex = fn.returnValue.type.lengthParameterIndex;
+    if (lengthIndex === undefined)
+        return new Set();
+    return new Set([lengthIndex]);
+};
+/**
+ * Whether a parameter is passed to the FFI binding as a `t.ref(...)` cell.
+ *
+ * Pure out parameters marshal through a `{ value }` ref cell the native layer
+ * writes into. Inout parameters do too — except handle-passing ones
+ * (objects, interfaces, boxed), which are passed by their existing handle
+ * and mutated in place, not through a pointer-to-pointer cell.
+ * Caller-allocated outs pass a pre-built handle and are excluded.
+ *
+ * @param context - The module context
+ * @param parameter - The parameter to test
+ */
+export const needsRefArg = (context, parameter) => {
+    if (parameter.direction !== "out" && parameter.direction !== "inout")
+        return false;
+    const passesHandleDirectly = (parameter.callerAllocates || parameter.direction === "inout") &&
+        parameter.type !== undefined &&
+        isHandlePassing(context, parameter.type);
+    return !passesHandleDirectly;
+};
+/**
+ * Whether a caller-allocated-out parameter is one the body can materialize and
+ * collect into the return — a boxed record or class the runtime can allocate
+ * via its wrapper constructor. Array and other caller-out buffers cannot be
+ * allocated here, so they are excluded from both the body and the return type.
+ *
+ * @param context - The module context
+ * @param parameter - The parameter to test
+ */
+export const isCollectibleCallerOut = (context, parameter) => {
+    if (parameter.type === undefined || parameter.type.kind !== "named")
+        return false;
+    const resolved = context.repository.resolveNamed(parameter.type.namespaceName ?? context.namespace.name, parameter.type.typeName);
+    return resolved?.kind === "boxed" || resolved?.kind === "class";
+};
+/**
+ * Whether a value of `ref` is passed across the FFI boundary as a native
+ * handle (object, interface, boxed, or an alias to one) instead of by value.
+ *
+ * @param context - The module context
+ * @param ref - The type reference to test
+ */
+export const isHandlePassing = (context, ref) => {
+    if (ref.kind !== "named")
+        return false;
+    const owner = ref.namespaceName ?? context.namespace.name;
+    const resolved = context.repository.resolveNamed(owner, ref.typeName);
+    if (resolved === undefined)
+        return true;
+    switch (resolved.kind) {
+        case "class":
+        case "interface":
+        case "boxed":
+            return true;
+        case "alias": {
+            const target = resolved.targetRef;
+            if (target === undefined || target.kind !== "named")
+                return false;
+            return isHandlePassing(context, target);
+        }
+        case "enum":
+        case "callback":
+            return false;
+    }
+};
+/**
+ * The JavaScript identifier for a parameter: the camelCased GIR name, or
+ * `arg<index>` for an unnamed position.
+ *
+ * @param parameter - The GIR parameter
+ * @param index - The parameter's position in the callable
+ */
+export const parameterIdentifier = (parameter, index) => {
+    if (parameter.name.length === 0)
+        return `arg${index}`;
+    return toIdentifier(toCamelCase(parameter.name));
+};
+//# sourceMappingURL=param-classify.js.map

package/dist/writers/param-classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-classify.js","sourceRoot":"","sources":["../../src/writers/param-classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAqB,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoB9F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAe,EAA6B,EAAE;IAC1E,MAAM,aAAa,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,SAAS,CAAC,SAAS;YAAE,OAAO;QAChC,IAAI,cAAc,CAAC,SAAS,CAAC;YAAE,OAAO;QACtC,IAAI,oBAAoB,CAAC,SAAS,CAAC;YAAE,OAAO;QAC5C,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QACrC,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QACtC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,EAAe,EAAuB,EAAE;IAC7E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC9E,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,EAAe,EAAuB,EAAE;IAChE,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAe,EAA+B,EAAE;IAC/E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO;YAAE,OAAO;QAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACxD,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QACtC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,EAAe,EAAuB,EAAE;IAC7E,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAC5D,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAC7D,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAChD,OAAO,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAsB,EAAE,SAAuB,EAAW,EAAE;IACpF,IAAI,SAAS,CAAC,SAAS,KAAK,KAAK,IAAI,SAAS,CAAC,SAAS,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACnF,MAAM,oBAAoB,GACtB,CAAC,SAAS,CAAC,eAAe,IAAI,SAAS,CAAC,SAAS,KAAK,OAAO,CAAC;QAC9D,SAAS,CAAC,IAAI,KAAK,SAAS;QAC5B,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,oBAAoB,CAAC;AACjC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAsB,EAAE,SAAuB,EAAW,EAAE;IAC/F,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAC5C,SAAS,CAAC,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EACtD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAC1B,CAAC;IACF,OAAO,QAAQ,EAAE,IAAI,KAAK,OAAO,IAAI,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAsB,EAAE,GAAe,EAAW,EAAE;IAChF,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,OAAO;YACR,OAAO,IAAI,CAAC;QAChB,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;YAClC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAClE,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU;YACX,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAuB,EAAE,KAAa,EAAU,EAAE;IAClF,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,KAAK,EAAE,CAAC;IACtD,OAAO,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/writers/property-accessor.d.ts

@@ -0,0 +1,19 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirFunction } from "../gir/function.js";
+import type { GirProperty } from "../gir/property.js";
+/**
+ * Renders the `get` / `set` accessor pair for a single GObject property
+ * on a class declaration.
+ *
+ * Read-only properties get only a getter; readonly + non-writable
+ * properties are skipped entirely. Properties whose name has already
+ * been claimed by an emitted method (its camelCase form clashes) are
+ * skipped, since the method takes precedence — the runtime accessor is
+ * always reachable via `this.getProperty(girName)` in that case.
+ *
+ * @param context - The module context
+ * @param property - The property to surface
+ * @param claimedNames - Names already used by emitted methods
+ */
+export declare const renderPropertyAccessor: (context: ModuleContext, property: GirProperty, claimedNames: ReadonlySet<string>, methodByName: ReadonlyMap<string, GirFunction>) => string | undefined;
+//# sourceMappingURL=property-accessor.d.ts.map

package/dist/writers/property-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-accessor.d.ts","sourceRoot":"","sources":["../../src/writers/property-accessor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2BtD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,aAAa,EACtB,UAAU,WAAW,EACrB,cAAc,WAAW,CAAC,MAAM,CAAC,EACjC,cAAc,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,KAC/C,MAAM,GAAG,SAiCX,CAAC"}

package/dist/writers/property-accessor.js

@@ -0,0 +1,117 @@
+import { quote, toCamelCase, toIdentifier } from "@gtkx/utils";
+import { indent } from "../dsl/emit.js";
+import { renderMethodReturnType } from "./method.js";
+import { renderTsType } from "./ts-type.js";
+/**
+ * Whether a GObject property of `type` can hold `null`.
+ *
+ * Reference values — objects, boxed records, interfaces, and containers —
+ * marshal to `null` when unset; scalar value types (numbers, booleans,
+ * strings, `unichar`, enums) are surfaced non-null to match their typed
+ * setters. Aliases resolve to their target.
+ *
+ * @param context - The module context
+ * @param type - The property's value type
+ */
+const isNullablePropertyType = (context, type) => {
+    if (type === undefined)
+        return false;
+    if (type.kind === "primitive")
+        return false;
+    if (type.kind !== "named")
+        return true;
+    const resolved = context.repository.resolveNamed(type.namespaceName ?? context.namespace.name, type.typeName);
+    if (resolved === undefined)
+        return true;
+    if (resolved.kind === "enum")
+        return false;
+    if (resolved.kind === "alias")
+        return isNullablePropertyType(context, resolved.targetRef);
+    return true;
+};
+/**
+ * Renders the `get` / `set` accessor pair for a single GObject property
+ * on a class declaration.
+ *
+ * Read-only properties get only a getter; readonly + non-writable
+ * properties are skipped entirely. Properties whose name has already
+ * been claimed by an emitted method (its camelCase form clashes) are
+ * skipped, since the method takes precedence — the runtime accessor is
+ * always reachable via `this.getProperty(girName)` in that case.
+ *
+ * @param context - The module context
+ * @param property - The property to surface
+ * @param claimedNames - Names already used by emitted methods
+ */
+export const renderPropertyAccessor = (context, property, claimedNames, methodByName) => {
+    const jsName = toIdentifier(toCamelCase(property.name));
+    if (claimedNames.has(jsName))
+        return undefined;
+    if (jsName === "constructor")
+        return undefined;
+    const writable = property.writable || property.construct || property.constructOnly;
+    const getterMember = delegateMember(property.getter, jsName, claimedNames);
+    const getMethod = getterMember !== undefined && property.getter !== undefined ? methodByName.get(property.getter) : undefined;
+    const setterMember = writable ? delegateMember(property.setter, jsName, claimedNames) : undefined;
+    const setMethod = setterMember !== undefined && property.setter !== undefined ? methodByName.get(property.setter) : undefined;
+    const setParam = setMethod?.parameters[0];
+    const tsType = setParam !== undefined
+        ? renderTsType(context, setParam.type, setParam.nullable || setParam.optional)
+        : getMethod !== undefined
+            ? renderMethodReturnType(context, getMethod)
+            : renderTsType(context, property.type, isNullablePropertyType(context, property.type));
+    const blocks = [];
+    const getBody = renderGetterBody({ context, property, getterMember, getMethod, tsType });
+    blocks.push(`get ${jsName}(): ${tsType} {\n${indent(getBody, 1)}\n}`);
+    if (writable) {
+        const setBody = setterMember !== undefined
+            ? `this.${setterMember}(value);`
+            : `this.setProperty(${quote(property.name)}, value);`;
+        blocks.push(`set ${jsName}(value: ${tsType}) {\n${indent(setBody, 1)}\n}`);
+    }
+    return blocks.join("\n\n");
+};
+/**
+ * Renders a property getter body.
+ *
+ * The property type follows the setter's parameter (what callers may assign),
+ * so a getter whose own GIR nullability differs is narrowed to it with a single
+ * assertion; matching nullability needs no cast. Properties with no typed
+ * getter read through the generic `getProperty` GValue path.
+ *
+ * @param options - {@link GetterBodyOptions}
+ */
+const renderGetterBody = (options) => {
+    const { context, property, getterMember, getMethod, tsType } = options;
+    if (getterMember === undefined)
+        return `return this.getProperty(${quote(property.name)}) as ${tsType};`;
+    if (getMethod === undefined)
+        return `return this.${getterMember}() as ${tsType};`;
+    const getType = renderMethodReturnType(context, getMethod);
+    return getType === tsType ? `return this.${getterMember}();` : `return this.${getterMember}() as ${tsType};`;
+};
+/**
+ * Resolves a property's GIR `getter`/`setter` method name to the camelCase
+ * member to delegate the accessor to, or `undefined` to fall back to the
+ * generic `getProperty`/`setProperty` GValue path.
+ *
+ * Delegation is used only when the named method was actually emitted on the
+ * class (so object, interface, and boxed values marshal through their typed
+ * setter rather than the GValue `valueFromJS` path) and the member name does
+ * not collide with the accessor itself, which would recurse.
+ *
+ * @param accessorName - The accessor's own camelCase member name
+ * @param attribute - The GIR `getter`/`setter` attribute, if present
+ * @param claimedNames - Names already emitted as methods on the class
+ */
+const delegateMember = (attribute, accessorName, claimedNames) => {
+    if (attribute === undefined)
+        return undefined;
+    const member = toCamelCase(attribute);
+    if (member === accessorName)
+        return undefined;
+    if (!claimedNames.has(member))
+        return undefined;
+    return member;
+};
+//# sourceMappingURL=property-accessor.js.map

package/dist/writers/property-accessor.js.map

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

package/dist/writers/registration.d.ts

@@ -0,0 +1,27 @@
+import type { ModuleContext } from "../dsl/context.js";
+/**
+ * The pre-rendered pieces of a single `registerNativeClass(...)` descriptor.
+ *
+ * Each metadata field is the already-rendered object-literal fragment for that
+ * descriptor key, or `undefined` when the type contributes nothing for it.
+ */
+export type NativeClassRegistration = {
+    readonly className: string;
+    readonly role: "class" | "interface" | "boxed";
+    readonly getTypeRef?: string | undefined;
+    readonly construction?: string | undefined;
+    readonly vfuncs?: string | undefined;
+};
+/**
+ * Appends the single `registerNativeClass(Class, { … })` registration that
+ * collapses a type's GType, construction, and vfunc metadata into one
+ * module-load call.
+ *
+ * Emits nothing when the registration carries no metadata at all, so callers
+ * can pass the result of optional sub-renderers without pre-checking.
+ *
+ * @param context - The module context
+ * @param registration - The pre-rendered descriptor pieces
+ */
+export declare const appendNativeClassRegistration: (context: ModuleContext, registration: NativeClassRegistration) => void;
+//# sourceMappingURL=registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/writers/registration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,GAAI,SAAS,aAAa,EAAE,cAAc,uBAAuB,KAAG,IAY7G,CAAC"}

package/dist/writers/registration.js

@@ -0,0 +1,30 @@
+import { quote } from "@gtkx/utils";
+import { indent } from "../dsl/emit.js";
+/**
+ * Appends the single `registerNativeClass(Class, { … })` registration that
+ * collapses a type's GType, construction, and vfunc metadata into one
+ * module-load call.
+ *
+ * Emits nothing when the registration carries no metadata at all, so callers
+ * can pass the result of optional sub-renderers without pre-checking.
+ *
+ * @param context - The module context
+ * @param registration - The pre-rendered descriptor pieces
+ */
+export const appendNativeClassRegistration = (context, registration) => {
+    const { className, role, getTypeRef, construction, vfuncs } = registration;
+    if (getTypeRef === undefined && construction === undefined && vfuncs === undefined) {
+        return;
+    }
+    context.addRuntimeImport("registerNativeClass");
+    const lines = [`role: ${quote(role)},`];
+    if (getTypeRef !== undefined)
+        lines.push(`gtype: ${getTypeRef},`);
+    if (construction !== undefined)
+        lines.push(`construction: ${construction},`);
+    if (vfuncs !== undefined)
+        lines.push(`vfuncs: ${vfuncs},`);
+    const body = lines.map((line) => indent(line, 1)).join("\n");
+    context.module.appendRegistration(`registerNativeClass(${className}, {\n${body}\n});`);
+};
+//# sourceMappingURL=registration.js.map

package/dist/writers/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/writers/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgBxC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,OAAsB,EAAE,YAAqC,EAAQ,EAAE;IACjH,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;IAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACjF,OAAO;IACX,CAAC;IACD,OAAO,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAChD,MAAM,KAAK,GAAa,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,UAAU,GAAG,CAAC,CAAC;IAClE,IAAI,YAAY,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,YAAY,GAAG,CAAC,CAAC;IAC7E,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,uBAAuB,SAAS,QAAQ,IAAI,OAAO,CAAC,CAAC;AAC3F,CAAC,CAAC"}

package/dist/writers/return-wrap.d.ts

@@ -0,0 +1,39 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { ParameterTransfer } from "../gir/parameter.js";
+import type { GirTypeRef } from "../gir/type-ref.js";
+/**
+ * Lifting raw FFI call results into their typed JavaScript form: objects to
+ * their runtime-registered wrappers, boxed values to typed wrappers,
+ * collections per element, and primitives with the appropriate coercion.
+ * Shared by method-body return handling, signal/callback argument marshalling,
+ * and boxed field accessors.
+ */
+/**
+ * Casts a raw FFI call result to a native handle so the registry wrappers
+ * (`getNativeObject` / `getNativeObjectAsInterface`) accept it. The cast widens
+ * to `NativeHandle | null` for a GIR-nullable value so the wrapper result type
+ * stays nullable, matching the declared return.
+ */
+export declare const handleCast: (context: ModuleContext, valueExpression: string, nullable: boolean) => string;
+/**
+ * Inputs for {@link wrapReturnValue}.
+ */
+export type WrapReturnOptions = {
+    readonly ref: GirTypeRef | undefined;
+    readonly transfer: ParameterTransfer;
+    readonly nullable: boolean;
+    readonly valueExpression: string;
+};
+/**
+ * Wraps a raw FFI value into its typed JavaScript form.
+ *
+ * Objects resolve to their runtime-registered wrapper, interfaces to the
+ * interface wrapper, boxed values to a typed wrapper, collections recurse per
+ * element, and primitives pass through with the appropriate coercion. Shared
+ * by return-value handling and signal-handler argument marshalling.
+ *
+ * @param context - The module context
+ * @param options - {@link WrapReturnOptions}
+ */
+export declare const wrapReturnValue: (context: ModuleContext, options: WrapReturnOptions) => string;
+//# sourceMappingURL=return-wrap.d.ts.map

package/dist/writers/return-wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-wrap.d.ts","sourceRoot":"","sources":["../../src/writers/return-wrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,oBAAoB,CAAC;AAGrF;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,EAAE,iBAAiB,MAAM,EAAE,UAAU,OAAO,KAAG,MAG/F,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,aAAa,EAAE,SAAS,iBAAiB,KAAG,MAsBpF,CAAC"}

package/dist/writers/return-wrap.js

@@ -0,0 +1,152 @@
+import { renderTsType } from "./ts-type.js";
+/**
+ * Lifting raw FFI call results into their typed JavaScript form: objects to
+ * their runtime-registered wrappers, boxed values to typed wrappers,
+ * collections per element, and primitives with the appropriate coercion.
+ * Shared by method-body return handling, signal/callback argument marshalling,
+ * and boxed field accessors.
+ */
+/**
+ * Casts a raw FFI call result to a native handle so the registry wrappers
+ * (`getNativeObject` / `getNativeObjectAsInterface`) accept it. The cast widens
+ * to `NativeHandle | null` for a GIR-nullable value so the wrapper result type
+ * stays nullable, matching the declared return.
+ */
+export const handleCast = (context, valueExpression, nullable) => {
+    context.addNativeTypeImport("NativeHandle");
+    return `${valueExpression} as NativeHandle${nullable ? " | null" : ""}`;
+};
+/**
+ * Wraps a raw FFI value into its typed JavaScript form.
+ *
+ * Objects resolve to their runtime-registered wrapper, interfaces to the
+ * interface wrapper, boxed values to a typed wrapper, collections recurse per
+ * element, and primitives pass through with the appropriate coercion. Shared
+ * by return-value handling and signal-handler argument marshalling.
+ *
+ * @param context - The module context
+ * @param options - {@link WrapReturnOptions}
+ */
+export const wrapReturnValue = (context, options) => {
+    const { ref, nullable, valueExpression } = options;
+    if (ref === undefined)
+        return valueExpression;
+    switch (ref.kind) {
+        case "primitive":
+            return wrapPrimitive(ref, nullable, valueExpression);
+        case "named":
+            return wrapNamed(context, ref, valueExpression, nullable);
+        case "array":
+            return wrapCollection(context, ref.element, valueExpression, nullable);
+        case "list":
+            return ref.flavor === "gbytearray"
+                ? `(${valueExpression} as number[]${nullable ? " | null" : ""})`
+                : wrapCollection(context, ref.element, valueExpression, nullable);
+        case "hashtable":
+            return nullable
+                ? `(${valueExpression} === null ? null : new globalThis.Map(${valueExpression} as Iterable<readonly [unknown, unknown]>))`
+                : `new globalThis.Map(${valueExpression} as Iterable<readonly [unknown, unknown]>)`;
+        case "callback":
+        case "varargs":
+            return `(${valueExpression} as unknown[])`;
+    }
+};
+/**
+ * Wraps a collection return value, mapping each element through the runtime
+ * wrapper its type requires.
+ *
+ * The native layer hands collection returns back as arrays of raw element
+ * values; object, interface, and boxed elements must be lifted into their
+ * typed JavaScript wrappers (matching the per-element wrapping a scalar
+ * return of the same type receives) while primitive and enum elements pass
+ * through untouched.
+ */
+const wrapCollection = (context, element, valueExpression, nullable) => {
+    const itemExpression = collectionItemWrap(context, element);
+    if (itemExpression === undefined) {
+        const elementTs = element === undefined ? "unknown" : renderTsType(context, element, false);
+        return `(${valueExpression} as ${elementTs}[]${nullable ? " | null" : ""})`;
+    }
+    return nullable
+        ? `((${valueExpression} as unknown[] | null)?.map((item) => ${itemExpression}) ?? null)`
+        : `(${valueExpression} as unknown[]).map((item) => ${itemExpression})`;
+};
+const collectionItemWrap = (context, element) => {
+    if (element === undefined || element.kind !== "named")
+        return undefined;
+    const owner = element.namespaceName ?? context.namespace.name;
+    const resolved = context.repository.resolveNamed(owner, element.typeName);
+    if (resolved === undefined) {
+        context.addRuntimeImport("getNativeObject");
+        return `getNativeObject(${handleCast(context, "item", false)})`;
+    }
+    switch (resolved.kind) {
+        case "class":
+        case "boxed":
+            context.addRuntimeImport("getNativeObject");
+            return `getNativeObject(${handleCast(context, "item", false)})`;
+        case "interface": {
+            context.addRuntimeImport("getNativeObjectAsInterface");
+            return `getNativeObjectAsInterface(${handleCast(context, "item", false)}, ${context.qualify(owner, element.typeName)})`;
+        }
+        case "alias":
+            return resolved.target === undefined
+                ? undefined
+                : collectionItemWrap(context, {
+                    kind: "named",
+                    namespaceName: resolved.namespace.name,
+                    typeName: resolved.target,
+                    cType: undefined,
+                });
+        case "enum":
+        case "callback":
+            return undefined;
+    }
+};
+const wrapPrimitive = (ref, nullable, valueExpression) => {
+    const category = ref.category;
+    if (category === "void")
+        return valueExpression;
+    if (category === "string")
+        return `(${valueExpression} as ${nullable ? "string | null" : "string"})`;
+    if (category === "boolean")
+        return `Boolean(${valueExpression})`;
+    return `(${valueExpression} as number)`;
+};
+const wrapNamed = (context, ref, valueExpression, nullable) => {
+    const owner = ref.namespaceName ?? context.namespace.name;
+    const resolved = context.repository.resolveNamed(owner, ref.typeName);
+    if (resolved === undefined) {
+        context.addRuntimeImport("getNativeObject");
+        return `getNativeObject(${handleCast(context, valueExpression, nullable)})`;
+    }
+    return wrapResolved(context, resolved, { namespaceName: owner, typeName: ref.typeName, valueExpression, nullable });
+};
+const wrapResolved = (context, resolved, options) => {
+    const { namespaceName, typeName, valueExpression, nullable } = options;
+    switch (resolved.kind) {
+        case "class": {
+            context.addRuntimeImport("getNativeObject");
+            return `getNativeObject(${handleCast(context, valueExpression, nullable)})`;
+        }
+        case "interface": {
+            const classExpression = context.qualify(namespaceName, typeName);
+            context.addRuntimeImport("getNativeObjectAsInterface");
+            return `getNativeObjectAsInterface(${handleCast(context, valueExpression, nullable)}, ${classExpression})`;
+        }
+        case "boxed": {
+            const classExpression = context.qualify(namespaceName, typeName);
+            context.addRuntimeImport("getNativeObject");
+            return `getNativeObject(${handleCast(context, valueExpression, nullable)}, ${classExpression})`;
+        }
+        case "enum":
+            return `(${valueExpression} as number)`;
+        case "callback":
+            return valueExpression;
+        case "alias":
+            return resolved.targetRef === undefined
+                ? valueExpression
+                : wrapReturnValue(context, { ref: resolved.targetRef, transfer: "full", nullable, valueExpression });
+    }
+};
+//# sourceMappingURL=return-wrap.js.map

package/dist/writers/return-wrap.js.map

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

package/dist/writers/runtime-override.d.ts

@@ -0,0 +1,18 @@
+import type { GirFunction } from "../gir/function.js";
+/**
+ * Renders the method body for a callable whose marshaling is provided by a
+ * hand-written runtime override.
+ *
+ * `gpointer` exchanges (`GValue` boxed accessors and similar) cannot be
+ * marshaled from GIR alone; the FFI runtime replaces them on the prototype
+ * at module load. The codegen emits a stub with the override's signature
+ * so the consumer types resolve to the runtime shape and the runtime's
+ * `prototype` assignment type-checks.
+ *
+ * Returns `undefined` for callables without a registered override.
+ *
+ * @param callable - The callable to consider
+ * @param memberName - The camelCase JS method name
+ */
+export declare const renderRuntimeOverride: (callable: GirFunction, memberName: string) => string | undefined;
+//# sourceMappingURL=runtime-override.d.ts.map

package/dist/writers/runtime-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-override.d.ts","sourceRoot":"","sources":["../../src/writers/runtime-override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqCtD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,WAAW,EAAE,YAAY,MAAM,KAAG,MAAM,GAAG,SAM1F,CAAC"}