@gtkx/codegen 0.21.0 → 1.0.0-rc.1

package/README.md

@@ -0,0 +1,173 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
+</p>
+
+<h1 align="center">GTKX</h1>
+
+<p align="center">
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
+
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
+```
+
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
+
+## Why GTKX
+
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
+
+## Quick start
+
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
+cd my-app
+npm run dev
+```
+
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
+
+## Documentation
+
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
+
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
+
+## Requirements
+
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+
+## License
+
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/dist/analysis/descriptor-render.d.ts

@@ -0,0 +1,18 @@
+import type { Library } from "../gir/library.js";
+import { type GirParameter, type GirReturnValue, type ParameterTransfer } from "../gir/parameter.js";
+import type { TypeId } from "../gir/type-id.js";
+import type { ModuleContext } from "../writer/context.js";
+type RenderDescriptorOptions = {
+    argIndexOffset?: number;
+    callerAllocated?: boolean;
+};
+export declare const isInlineCallbackRef: (library: Library, ref: TypeId | undefined) => boolean;
+export declare const omitsPrimaryReturn: (library: Library, returnValue: GirReturnValue) => boolean;
+export declare const renderDescriptor: (context: ModuleContext, ref: TypeId | undefined, transfer?: ParameterTransfer, options?: RenderDescriptorOptions) => string;
+export declare const isScalarRef: (library: Library, ref: TypeId | undefined) => boolean;
+export declare const isCellInout: (library: Library, parameter: GirParameter) => boolean;
+export declare const renderParamDescriptor: (context: ModuleContext, parameter: GirParameter, ref: TypeId | undefined) => string;
+export declare const renderCallbackType: (context: ModuleContext, ref: TypeId | undefined, owningParameter: GirParameter, argOverrides?: Map<number, string>) => string | undefined;
+export declare const renderSelfDescriptor: (context: ModuleContext, instance: GirParameter) => string;
+export {};
+//# sourceMappingURL=descriptor-render.d.ts.map

package/dist/analysis/descriptor-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-render.d.ts","sourceRoot":"","sources":["../../src/analysis/descriptor-render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,cAAc,EAInB,KAAK,iBAAiB,EACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAA0B,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqC1D,KAAK,uBAAuB,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAQF,eAAO,MAAM,mBAAmB,YAAa,OAAO,OAAO,MAAM,GAAG,SAAS,KAAG,OACsB,CAAC;AAEvG,eAAO,MAAM,kBAAkB,YAAa,OAAO,eAAe,cAAc,KAAG,OACvB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,YAChB,aAAa,OACjB,MAAM,GAAG,SAAS,aACb,iBAAiB,YAClB,uBAAuB,KACjC,MAkCF,CAAC;AASF,eAAO,MAAM,WAAW,YAAa,OAAO,OAAO,MAAM,GAAG,SAAS,KAAG,OAQvE,CAAC;AAEF,eAAO,MAAM,WAAW,YAAa,OAAO,aAAa,YAAY,KAAG,OACD,CAAC;AAExE,eAAO,MAAM,qBAAqB,YACrB,aAAa,aACX,YAAY,OAClB,MAAM,GAAG,SAAS,KACxB,MAUF,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAClB,aAAa,OACjB,MAAM,GAAG,SAAS,mBACN,YAAY,iBACd,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACnC,MAAM,GAAG,SAoBX,CAAC;AAuFF,eAAO,MAAM,oBAAoB,YAAa,aAAa,YAAY,YAAY,KAAG,MAarF,CAAC"}

package/dist/analysis/descriptor-render.js

@@ -0,0 +1,297 @@
+import { sourceStringLiteral } from "@gtkx/utils";
+import { isCallerAllocatedOut, isInoutParameter, isOutParameter, } from "../gir/parameter.js";
+import { isRecordInout } from "../store/gi/param-marshal.js";
+import { computeRecordFieldSlots } from "../store/gi/record-layout.js";
+import { tArray, tBoxed, tByteArray, tCallback, tEnum, tFixedArray, tFlags, tFundamental, tGtype, tHashTable, tInt32, tList, tObject, tRef, tScalar, tSizedArray, tString, tStruct, tUint32, tUint64, tVoid, } from "./descriptor.js";
+const transferOwnership = (transfer) => {
+    if (transfer === "full")
+        return "full";
+    if (transfer === "container")
+        return "full";
+    return "borrowed";
+};
+const deriveElementTransfer = (transfer) => transfer === "container" ? "none" : transfer;
+const isVoidRef = (library, ref) => {
+    if (ref === undefined)
+        return true;
+    const type = library.typeOf(ref);
+    return type?.kind === "primitive" && type.category === "void";
+};
+export const isInlineCallbackRef = (library, ref) => ref !== undefined && library.typeOf(ref)?.kind === "callback" && library.nameOf(ref) === undefined;
+export const omitsPrimaryReturn = (library, returnValue) => isVoidRef(library, returnValue.type) || returnValue.skip;
+export const renderDescriptor = (context, ref, transfer = "none", options = {}) => {
+    if (ref === undefined)
+        return tVoid;
+    const { argIndexOffset = 0 } = options;
+    const ownership = transferOwnership(transfer);
+    const type = context.library.typeOf(ref);
+    if (type === undefined)
+        return tObject(ownership);
+    switch (type.kind) {
+        case "primitive":
+            return primitiveExpression(type.category, ownership);
+        case "varargs":
+        case "callback":
+            return tVoid;
+        case "class":
+        case "interface":
+        case "record":
+        case "enum":
+        case "alias":
+            return expressionForResolved(context, type, transfer, options);
+        case "carray":
+            return arrayExpression(context, type, transfer, argIndexOffset);
+        case "list": {
+            if (type.flavor === "gbytearray")
+                return tByteArray(ownership);
+            const element = renderDescriptor(context, type.element, deriveElementTransfer(transfer), {
+                argIndexOffset,
+            });
+            return tList(LIST_HELPERS[type.flavor], element, ownership);
+        }
+        case "hashtable": {
+            const elementTransfer = deriveElementTransfer(transfer);
+            const key = renderDescriptor(context, type.key, elementTransfer, { argIndexOffset });
+            const value = renderDescriptor(context, type.value, elementTransfer, { argIndexOffset });
+            return tHashTable(key, value, ownership);
+        }
+    }
+};
+const resolveCallbackType = (context, ref) => {
+    if (ref === undefined)
+        return undefined;
+    const type = context.library.typeOf(ref);
+    if (type?.kind !== "callback")
+        return undefined;
+    return type.value;
+};
+export const isScalarRef = (library, ref) => {
+    if (ref === undefined)
+        return false;
+    const type = library.typeOf(ref);
+    if (type === undefined)
+        return false;
+    if (type.kind === "primitive")
+        return type.category !== "string" && type.category !== "void";
+    if (type.kind === "enum")
+        return true;
+    if (type.kind === "alias")
+        return type.value.target !== undefined && isScalarRef(library, type.value.target);
+    return false;
+};
+export const isCellInout = (library, parameter) => isInoutParameter(parameter) && isScalarRef(library, parameter.type);
+export const renderParamDescriptor = (context, parameter, ref) => {
+    if (isCellInout(context.library, parameter)) {
+        return tRef(renderDescriptor(context, ref, parameter.transferOwnership), true);
+    }
+    if (isOutParameter(parameter)) {
+        return tRef(renderDescriptor(context, ref, parameter.transferOwnership));
+    }
+    return renderDescriptor(context, ref, parameter.transferOwnership, {
+        callerAllocated: isCallerAllocatedOut(parameter) || isRecordInout(context, parameter),
+    });
+};
+export const renderCallbackType = (context, ref, owningParameter, argOverrides) => {
+    const callback = resolveCallbackType(context, ref);
+    if (callback === undefined)
+        return undefined;
+    const argTypes = callback.parameters.map((parameter, index) => argOverrides?.get(index) ?? renderParamDescriptor(context, parameter, parameter.type));
+    let userDataIndex;
+    callback.parameters.forEach((parameter, index) => {
+        if (parameter.name === "user_data" || parameter.name === "data")
+            userDataIndex = index;
+    });
+    const returnRef = callback.returnValue.type;
+    const returnType = isVoidRef(context.library, returnRef)
+        ? tVoid
+        : renderDescriptor(context, returnRef, callback.returnValue.transferOwnership);
+    const options = [];
+    if (owningParameter.destroyIndex !== undefined)
+        options.push("hasDestroy: true");
+    if (userDataIndex !== undefined)
+        options.push(`userDataIndex: ${userDataIndex}`);
+    if (owningParameter.scope !== undefined)
+        options.push(`scope: ${sourceStringLiteral(owningParameter.scope)}`);
+    const optionsArg = options.length > 0 ? `{ ${options.join(", ")} }` : undefined;
+    return tCallback(argTypes, returnType, optionsArg);
+};
+const LIST_HELPERS = {
+    glist: "list",
+    gslist: "slist",
+    gptrarray: "ptrArray",
+    garray: "gArray",
+};
+const primitiveExpression = (category, ownership) => {
+    if (category === "void")
+        return tVoid;
+    if (category === "string")
+        return tString(ownership);
+    if (category === "pointer")
+        return tUint64;
+    if (category === "gtype")
+        return tGtype;
+    return tScalar(category);
+};
+const referenceAddingFunc = (refFunc) => refFunc.endsWith("_ref_sink") ? refFunc.slice(0, -"_sink".length) : refFunc;
+const renderFundamental = (descriptor) => {
+    const { lib, refFunc, unrefFunc, typeName, ownership, wrapperClass } = descriptor;
+    return tFundamental(lib, referenceAddingFunc(refFunc), unrefFunc, {
+        ownership,
+        typeName,
+        wrapperClass,
+    });
+};
+const classOrInterfaceExpression = (resolved, ownership) => {
+    const cls = resolved.value;
+    if (cls.glibRefFunc === undefined || cls.glibUnrefFunc === undefined) {
+        return tObject(ownership);
+    }
+    return renderFundamental({
+        lib: resolved.namespace.sharedLibrary ?? "",
+        refFunc: cls.glibRefFunc,
+        unrefFunc: cls.glibUnrefFunc,
+        typeName: cls.glibTypeName,
+        ownership,
+    });
+};
+const fundamentalAncestor = (context, start) => {
+    const seen = new Set();
+    let current = start;
+    while (current !== undefined && (current.kind === "class" || current.kind === "interface")) {
+        const key = `${current.namespace.name}.${current.value.name}`;
+        if (seen.has(key))
+            return undefined;
+        seen.add(key);
+        const cls = current.value;
+        if (cls.fundamental && cls.glibRefFunc !== undefined && cls.glibUnrefFunc !== undefined) {
+            return {
+                lib: current.namespace.sharedLibrary ?? "",
+                refFunc: cls.glibRefFunc,
+                unrefFunc: cls.glibUnrefFunc,
+                typeName: cls.glibTypeName,
+            };
+        }
+        if (cls.parent === undefined)
+            return undefined;
+        current = context.library.resolveType(current.namespace.name, cls.parent);
+    }
+    return undefined;
+};
+export const renderSelfDescriptor = (context, instance) => {
+    const ref = instance.type;
+    if (ref === undefined)
+        return tObject("borrowed");
+    const type = context.library.typeOf(ref);
+    if (type === undefined)
+        return tObject("borrowed");
+    if (type.kind === "class" || type.kind === "interface") {
+        const ancestor = fundamentalAncestor(context, type);
+        return ancestor === undefined ? tObject("borrowed") : renderFundamental({ ...ancestor, ownership: "borrowed" });
+    }
+    if (type.kind === "record") {
+        return recordExpression(context, type, transferOwnership(instance.transferOwnership));
+    }
+    return tObject("borrowed");
+};
+const recordRefPair = (record) => ({
+    refFunc: record.glibRefFunc ?? record.copyFunc,
+    unrefFunc: record.glibUnrefFunc ?? record.freeFunc,
+});
+const recordNeedsFallbackClass = (record) => {
+    const { refFunc, unrefFunc } = recordRefPair(record);
+    if (refFunc !== undefined && unrefFunc !== undefined)
+        return record.glibTypeName === undefined;
+    return record.glibGetType === undefined;
+};
+const structExpression = (context, resolved, ownership, callerAllocated) => {
+    const { size } = computeRecordFieldSlots(context, resolved.value.fields, resolved.value.isUnion);
+    const wrapperClass = context.qualify(resolved.namespace.name, resolved.value.name);
+    return tStruct(ownership, {
+        size: size > 0 ? size : undefined,
+        wrapperClass,
+        callerAllocated,
+    });
+};
+const recordExpression = (context, resolved, ownership, callerAllocated = false) => {
+    const record = resolved.value;
+    const { refFunc, unrefFunc } = recordRefPair(record);
+    const wrapperClass = recordNeedsFallbackClass(record)
+        ? context.qualify(resolved.namespace.name, record.name)
+        : undefined;
+    if (refFunc !== undefined && unrefFunc !== undefined) {
+        const lib = resolved.namespace.sharedLibrary ?? "";
+        return renderFundamental({
+            lib,
+            refFunc,
+            unrefFunc,
+            typeName: record.glibTypeName,
+            ownership,
+            wrapperClass,
+        });
+    }
+    if (record.glibGetType === undefined) {
+        return structExpression(context, resolved, ownership, callerAllocated);
+    }
+    const glibName = record.glibTypeName ?? record.cType ?? record.name;
+    const { size } = computeRecordFieldSlots(context, record.fields, record.isUnion);
+    return tBoxed(glibName, {
+        ownership,
+        sharedLibrary: resolved.namespace.sharedLibrary,
+        getTypeFnName: record.glibGetType,
+        callerAllocated,
+        size: size > 0 ? size : undefined,
+    });
+};
+const expressionForResolved = (context, resolved, transfer, options) => {
+    const ownership = transferOwnership(transfer);
+    switch (resolved.kind) {
+        case "class":
+        case "interface":
+            return classOrInterfaceExpression(resolved, ownership);
+        case "record":
+            return recordExpression(context, resolved, ownership, options.callerAllocated ?? false);
+        case "enum": {
+            const getter = resolved.value.glibGetType;
+            const signed = resolved.value.members.some((member) => member.value.startsWith("-"));
+            if (getter === undefined || getter === "")
+                return signed ? tInt32 : tUint32;
+            const lib = resolved.namespace.sharedLibrary ?? "";
+            return resolved.value.kind === "bitfield" ? tFlags(lib, getter, signed) : tEnum(lib, getter, signed);
+        }
+        case "alias":
+            return aliasExpression(context, resolved.value.target, transfer, options);
+    }
+};
+const arrayExpression = (context, ref, transfer, argIndexOffset) => {
+    const ownership = transferOwnership(transfer);
+    const element = renderDescriptor(context, ref.element, deriveElementTransfer(transfer), { argIndexOffset });
+    const size = inlineElementSize(context, ref.element, ref.elementCType);
+    if (ref.lengthParameterIndex !== undefined) {
+        return tSizedArray(element, ref.lengthParameterIndex + argIndexOffset, ownership, size);
+    }
+    if (ref.fixedSize !== undefined) {
+        return tFixedArray(element, ref.fixedSize, ownership, size);
+    }
+    return tArray(element, ownership, size);
+};
+const inlineElementSize = (context, element, elementCType) => {
+    if (element === undefined)
+        return undefined;
+    if (elementCType?.includes("*"))
+        return undefined;
+    const type = context.library.typeOf(element);
+    if (type?.kind !== "record")
+        return undefined;
+    const record = type.value;
+    if (record.opaque || record.disguised || record.fields.length === 0)
+        return undefined;
+    const { size } = computeRecordFieldSlots(context, record.fields, record.isUnion);
+    return size > 0 ? size : undefined;
+};
+const aliasExpression = (context, target, transfer, options) => {
+    if (target === undefined) {
+        return tObject(transferOwnership(transfer));
+    }
+    return renderDescriptor(context, target, transfer, options);
+};
+//# sourceMappingURL=descriptor-render.js.map

package/dist/analysis/descriptor-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-render.js","sourceRoot":"","sources":["../../src/analysis/descriptor-render.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral } from \"@gtkx/utils\";\nimport type { GirCallback } from \"../gir/callback.js\";\nimport type { Library } from \"../gir/library.js\";\nimport {\n    type GirParameter,\n    type GirReturnValue,\n    isCallerAllocatedOut,\n    isInoutParameter,\n    isOutParameter,\n    type ParameterTransfer,\n} from \"../gir/parameter.js\";\nimport type { PrimitiveCategory } from \"../gir/primitives.js\";\nimport type { EntityType, GirType } from \"../gir/type.js\";\nimport type { CArrayType, ListFlavor, TypeId } from \"../gir/type-id.js\";\nimport { isRecordInout } from \"../store/gi/param-marshal.js\";\nimport { computeRecordFieldSlots } from \"../store/gi/record-layout.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\nimport {\n    type ListDescriptorName,\n    type Ownership,\n    type ScalarDescriptorName,\n    tArray,\n    tBoxed,\n    tByteArray,\n    tCallback,\n    tEnum,\n    tFixedArray,\n    tFlags,\n    tFundamental,\n    tGtype,\n    tHashTable,\n    tInt32,\n    tList,\n    tObject,\n    tRef,\n    tScalar,\n    tSizedArray,\n    tString,\n    tStruct,\n    tUint32,\n    tUint64,\n    tVoid,\n} from \"./descriptor.js\";\n\nconst transferOwnership = (transfer: ParameterTransfer): Ownership => {\n    if (transfer === \"full\") return \"full\";\n    if (transfer === \"container\") return \"full\";\n    return \"borrowed\";\n};\n\nconst deriveElementTransfer = (transfer: ParameterTransfer): ParameterTransfer =>\n    transfer === \"container\" ? \"none\" : transfer;\n\ntype RenderDescriptorOptions = {\n    argIndexOffset?: number;\n    callerAllocated?: boolean;\n};\n\nconst isVoidRef = (library: Library, ref: TypeId | undefined): boolean => {\n    if (ref === undefined) return true;\n    const type = library.typeOf(ref);\n    return type?.kind === \"primitive\" && type.category === \"void\";\n};\n\nexport const isInlineCallbackRef = (library: Library, ref: TypeId | undefined): boolean =>\n    ref !== undefined && library.typeOf(ref)?.kind === \"callback\" && library.nameOf(ref) === undefined;\n\nexport const omitsPrimaryReturn = (library: Library, returnValue: GirReturnValue): boolean =>\n    isVoidRef(library, returnValue.type) || returnValue.skip;\n\nexport const renderDescriptor = (\n    context: ModuleContext,\n    ref: TypeId | undefined,\n    transfer: ParameterTransfer = \"none\",\n    options: RenderDescriptorOptions = {},\n): string => {\n    if (ref === undefined) return tVoid;\n    const { argIndexOffset = 0 } = options;\n    const ownership = transferOwnership(transfer);\n    const type = context.library.typeOf(ref);\n    if (type === undefined) return tObject(ownership);\n    switch (type.kind) {\n        case \"primitive\":\n            return primitiveExpression(type.category, ownership);\n        case \"varargs\":\n        case \"callback\":\n            return tVoid;\n        case \"class\":\n        case \"interface\":\n        case \"record\":\n        case \"enum\":\n        case \"alias\":\n            return expressionForResolved(context, type, transfer, options);\n        case \"carray\":\n            return arrayExpression(context, type, transfer, argIndexOffset);\n        case \"list\": {\n            if (type.flavor === \"gbytearray\") return tByteArray(ownership);\n            const element = renderDescriptor(context, type.element, deriveElementTransfer(transfer), {\n                argIndexOffset,\n            });\n            return tList(LIST_HELPERS[type.flavor], element, ownership);\n        }\n        case \"hashtable\": {\n            const elementTransfer = deriveElementTransfer(transfer);\n            const key = renderDescriptor(context, type.key, elementTransfer, { argIndexOffset });\n            const value = renderDescriptor(context, type.value, elementTransfer, { argIndexOffset });\n            return tHashTable(key, value, ownership);\n        }\n    }\n};\n\nconst resolveCallbackType = (context: ModuleContext, ref: TypeId | undefined): GirCallback | undefined => {\n    if (ref === undefined) return undefined;\n    const type = context.library.typeOf(ref);\n    if (type?.kind !== \"callback\") return undefined;\n    return type.value;\n};\n\nexport const isScalarRef = (library: Library, ref: TypeId | undefined): boolean => {\n    if (ref === undefined) return false;\n    const type = library.typeOf(ref);\n    if (type === undefined) return false;\n    if (type.kind === \"primitive\") return type.category !== \"string\" && type.category !== \"void\";\n    if (type.kind === \"enum\") return true;\n    if (type.kind === \"alias\") return type.value.target !== undefined && isScalarRef(library, type.value.target);\n    return false;\n};\n\nexport const isCellInout = (library: Library, parameter: GirParameter): boolean =>\n    isInoutParameter(parameter) && isScalarRef(library, parameter.type);\n\nexport const renderParamDescriptor = (\n    context: ModuleContext,\n    parameter: GirParameter,\n    ref: TypeId | undefined,\n): string => {\n    if (isCellInout(context.library, parameter)) {\n        return tRef(renderDescriptor(context, ref, parameter.transferOwnership), true);\n    }\n    if (isOutParameter(parameter)) {\n        return tRef(renderDescriptor(context, ref, parameter.transferOwnership));\n    }\n    return renderDescriptor(context, ref, parameter.transferOwnership, {\n        callerAllocated: isCallerAllocatedOut(parameter) || isRecordInout(context, parameter),\n    });\n};\n\nexport const renderCallbackType = (\n    context: ModuleContext,\n    ref: TypeId | undefined,\n    owningParameter: GirParameter,\n    argOverrides?: Map<number, string>,\n): string | undefined => {\n    const callback = resolveCallbackType(context, ref);\n    if (callback === undefined) return undefined;\n    const argTypes = callback.parameters.map(\n        (parameter, index) => argOverrides?.get(index) ?? renderParamDescriptor(context, parameter, parameter.type),\n    );\n    let userDataIndex: number | undefined;\n    callback.parameters.forEach((parameter, index) => {\n        if (parameter.name === \"user_data\" || parameter.name === \"data\") userDataIndex = index;\n    });\n    const returnRef = callback.returnValue.type;\n    const returnType = isVoidRef(context.library, returnRef)\n        ? tVoid\n        : renderDescriptor(context, returnRef, callback.returnValue.transferOwnership);\n    const options: string[] = [];\n    if (owningParameter.destroyIndex !== undefined) options.push(\"hasDestroy: true\");\n    if (userDataIndex !== undefined) options.push(`userDataIndex: ${userDataIndex}`);\n    if (owningParameter.scope !== undefined) options.push(`scope: ${sourceStringLiteral(owningParameter.scope)}`);\n    const optionsArg = options.length > 0 ? `{ ${options.join(\", \")} }` : undefined;\n    return tCallback(argTypes, returnType, optionsArg);\n};\n\nconst LIST_HELPERS: Record<Exclude<ListFlavor, \"gbytearray\">, ListDescriptorName> = {\n    glist: \"list\",\n    gslist: \"slist\",\n    gptrarray: \"ptrArray\",\n    garray: \"gArray\",\n};\n\nconst primitiveExpression = (category: PrimitiveCategory, ownership: Ownership): string => {\n    if (category === \"void\") return tVoid;\n    if (category === \"string\") return tString(ownership);\n    if (category === \"pointer\") return tUint64;\n    if (category === \"gtype\") return tGtype;\n    return tScalar(category satisfies ScalarDescriptorName);\n};\n\ntype FundamentalDescriptor = {\n    lib: string;\n    refFunc: string;\n    unrefFunc: string;\n    typeName: string | undefined;\n    ownership: Ownership;\n    wrapperClass?: string | undefined;\n};\n\nconst referenceAddingFunc = (refFunc: string): string =>\n    refFunc.endsWith(\"_ref_sink\") ? refFunc.slice(0, -\"_sink\".length) : refFunc;\n\nconst renderFundamental = (descriptor: FundamentalDescriptor): string => {\n    const { lib, refFunc, unrefFunc, typeName, ownership, wrapperClass } = descriptor;\n    return tFundamental(lib, referenceAddingFunc(refFunc), unrefFunc, {\n        ownership,\n        typeName,\n        wrapperClass,\n    });\n};\n\nconst classOrInterfaceExpression = (\n    resolved: Extract<EntityType, { kind: \"class\" | \"interface\" }>,\n    ownership: Ownership,\n): string => {\n    const cls = resolved.value;\n    if (cls.glibRefFunc === undefined || cls.glibUnrefFunc === undefined) {\n        return tObject(ownership);\n    }\n    return renderFundamental({\n        lib: resolved.namespace.sharedLibrary ?? \"\",\n        refFunc: cls.glibRefFunc,\n        unrefFunc: cls.glibUnrefFunc,\n        typeName: cls.glibTypeName,\n        ownership,\n    });\n};\n\ntype AncestorFundamental = {\n    lib: string;\n    refFunc: string;\n    unrefFunc: string;\n    typeName: string | undefined;\n};\n\nconst fundamentalAncestor = (\n    context: ModuleContext,\n    start: Extract<EntityType, { kind: \"class\" | \"interface\" }>,\n): AncestorFundamental | undefined => {\n    const seen = new Set<string>();\n    let current: GirType | undefined = start;\n    while (current !== undefined && (current.kind === \"class\" || current.kind === \"interface\")) {\n        const key = `${current.namespace.name}.${current.value.name}`;\n        if (seen.has(key)) return undefined;\n        seen.add(key);\n        const cls = current.value;\n        if (cls.fundamental && cls.glibRefFunc !== undefined && cls.glibUnrefFunc !== undefined) {\n            return {\n                lib: current.namespace.sharedLibrary ?? \"\",\n                refFunc: cls.glibRefFunc,\n                unrefFunc: cls.glibUnrefFunc,\n                typeName: cls.glibTypeName,\n            };\n        }\n        if (cls.parent === undefined) return undefined;\n        current = context.library.resolveType(current.namespace.name, cls.parent);\n    }\n    return undefined;\n};\n\nexport const renderSelfDescriptor = (context: ModuleContext, instance: GirParameter): string => {\n    const ref = instance.type;\n    if (ref === undefined) return tObject(\"borrowed\");\n    const type = context.library.typeOf(ref);\n    if (type === undefined) return tObject(\"borrowed\");\n    if (type.kind === \"class\" || type.kind === \"interface\") {\n        const ancestor = fundamentalAncestor(context, type);\n        return ancestor === undefined ? tObject(\"borrowed\") : renderFundamental({ ...ancestor, ownership: \"borrowed\" });\n    }\n    if (type.kind === \"record\") {\n        return recordExpression(context, type, transferOwnership(instance.transferOwnership));\n    }\n    return tObject(\"borrowed\");\n};\n\ntype ResolvedRecord = Extract<EntityType, { kind: \"record\" }>[\"value\"];\n\nconst recordRefPair = (record: ResolvedRecord): { refFunc: string | undefined; unrefFunc: string | undefined } => ({\n    refFunc: record.glibRefFunc ?? record.copyFunc,\n    unrefFunc: record.glibUnrefFunc ?? record.freeFunc,\n});\n\nconst recordNeedsFallbackClass = (record: ResolvedRecord): boolean => {\n    const { refFunc, unrefFunc } = recordRefPair(record);\n    if (refFunc !== undefined && unrefFunc !== undefined) return record.glibTypeName === undefined;\n    return record.glibGetType === undefined;\n};\n\nconst structExpression = (\n    context: ModuleContext,\n    resolved: Extract<EntityType, { kind: \"record\" }>,\n    ownership: Ownership,\n    callerAllocated: boolean,\n): string => {\n    const { size } = computeRecordFieldSlots(context, resolved.value.fields, resolved.value.isUnion);\n    const wrapperClass = context.qualify(resolved.namespace.name, resolved.value.name);\n    return tStruct(ownership, {\n        size: size > 0 ? size : undefined,\n        wrapperClass,\n        callerAllocated,\n    });\n};\n\nconst recordExpression = (\n    context: ModuleContext,\n    resolved: Extract<EntityType, { kind: \"record\" }>,\n    ownership: Ownership,\n    callerAllocated = false,\n): string => {\n    const record = resolved.value;\n    const { refFunc, unrefFunc } = recordRefPair(record);\n    const wrapperClass = recordNeedsFallbackClass(record)\n        ? context.qualify(resolved.namespace.name, record.name)\n        : undefined;\n    if (refFunc !== undefined && unrefFunc !== undefined) {\n        const lib = resolved.namespace.sharedLibrary ?? \"\";\n        return renderFundamental({\n            lib,\n            refFunc,\n            unrefFunc,\n            typeName: record.glibTypeName,\n            ownership,\n            wrapperClass,\n        });\n    }\n    if (record.glibGetType === undefined) {\n        return structExpression(context, resolved, ownership, callerAllocated);\n    }\n    const glibName = record.glibTypeName ?? record.cType ?? record.name;\n    const { size } = computeRecordFieldSlots(context, record.fields, record.isUnion);\n    return tBoxed(glibName, {\n        ownership,\n        sharedLibrary: resolved.namespace.sharedLibrary,\n        getTypeFnName: record.glibGetType,\n        callerAllocated,\n        size: size > 0 ? size : undefined,\n    });\n};\n\nconst expressionForResolved = (\n    context: ModuleContext,\n    resolved: Extract<EntityType, { kind: \"class\" | \"interface\" | \"record\" | \"enum\" | \"alias\" }>,\n    transfer: ParameterTransfer,\n    options: RenderDescriptorOptions,\n): string => {\n    const ownership = transferOwnership(transfer);\n    switch (resolved.kind) {\n        case \"class\":\n        case \"interface\":\n            return classOrInterfaceExpression(resolved, ownership);\n        case \"record\":\n            return recordExpression(context, resolved, ownership, options.callerAllocated ?? false);\n        case \"enum\": {\n            const getter = resolved.value.glibGetType;\n            const signed = resolved.value.members.some((member) => member.value.startsWith(\"-\"));\n            if (getter === undefined || getter === \"\") return signed ? tInt32 : tUint32;\n            const lib = resolved.namespace.sharedLibrary ?? \"\";\n            return resolved.value.kind === \"bitfield\" ? tFlags(lib, getter, signed) : tEnum(lib, getter, signed);\n        }\n        case \"alias\":\n            return aliasExpression(context, resolved.value.target, transfer, options);\n    }\n};\n\nconst arrayExpression = (\n    context: ModuleContext,\n    ref: CArrayType,\n    transfer: ParameterTransfer,\n    argIndexOffset: number,\n): string => {\n    const ownership = transferOwnership(transfer);\n    const element = renderDescriptor(context, ref.element, deriveElementTransfer(transfer), { argIndexOffset });\n    const size = inlineElementSize(context, ref.element, ref.elementCType);\n    if (ref.lengthParameterIndex !== undefined) {\n        return tSizedArray(element, ref.lengthParameterIndex + argIndexOffset, ownership, size);\n    }\n    if (ref.fixedSize !== undefined) {\n        return tFixedArray(element, ref.fixedSize, ownership, size);\n    }\n    return tArray(element, ownership, size);\n};\n\nconst inlineElementSize = (\n    context: ModuleContext,\n    element: TypeId | undefined,\n    elementCType: string | undefined,\n): number | undefined => {\n    if (element === undefined) return undefined;\n    if (elementCType?.includes(\"*\")) return undefined;\n    const type = context.library.typeOf(element);\n    if (type?.kind !== \"record\") return undefined;\n    const record = type.value;\n    if (record.opaque || record.disguised || record.fields.length === 0) return undefined;\n    const { size } = computeRecordFieldSlots(context, record.fields, record.isUnion);\n    return size > 0 ? size : undefined;\n};\n\nconst aliasExpression = (\n    context: ModuleContext,\n    target: TypeId | undefined,\n    transfer: ParameterTransfer,\n    options: RenderDescriptorOptions,\n): string => {\n    if (target === undefined) {\n        return tObject(transferOwnership(transfer));\n    }\n    return renderDescriptor(context, target, transfer, options);\n};\n"]}

package/dist/analysis/descriptor.d.ts

@@ -0,0 +1,59 @@
+export type Ownership = "borrowed" | "full";
+export declare const tVoid: string;
+export declare const tBoolean: string;
+export declare const tUint8: string;
+export declare const tUint32: string;
+export declare const tInt32: string;
+export declare const tUint64: string;
+export declare const tGtype: string;
+export declare const tBuffer: string;
+export type ScalarDescriptorName = "boolean" | "int8" | "uint8" | "int16" | "uint16" | "int32" | "uint32" | "int64" | "uint64" | "bigint64" | "biguint64" | "float32" | "float64" | "unichar";
+export declare const tScalar: (name: ScalarDescriptorName) => string;
+export declare const tString: (ownership: Ownership, length?: string) => string;
+export declare const tObject: (ownership: Ownership) => string;
+export type BoxedOptions = {
+    ownership: Ownership;
+    sharedLibrary: string | undefined;
+    getTypeFnName: string;
+    callerAllocated: boolean;
+    size: number | undefined;
+};
+export declare const tBoxed: (glibName: string, options: BoxedOptions) => string;
+export type StructOptions = {
+    size: number | string | undefined;
+    wrapperClass: string | undefined;
+    callerAllocated: boolean;
+};
+export declare const tStruct: (ownership: Ownership, options: StructOptions) => string;
+export declare const tInlineStruct: () => string;
+export type FundamentalOptions = {
+    ownership: Ownership;
+    typeName: string | undefined;
+    wrapperClass: string | undefined;
+};
+export declare const tFundamental: (lib: string, refFunc: string, unrefFunc: string, options: FundamentalOptions) => string;
+export declare const tRef: (inner: string, inout?: boolean) => string;
+export declare const tHashTable: (key: string, value: string, ownership: Ownership) => string;
+export declare const tEnum: (lib: string, getType: string, signed: boolean) => string;
+export declare const tFlags: (lib: string, getType: string, signed: boolean) => string;
+export declare const tByteArray: (ownership: Ownership) => string;
+export type ListDescriptorName = "list" | "slist" | "ptrArray" | "gArray";
+export declare const tList: (name: ListDescriptorName, element: string, ownership: Ownership) => string;
+export declare const tArray: (element: string, ownership?: Ownership, elementSize?: number) => string;
+export declare const tSizedArray: (element: string, lengthIndex: number, ownership?: Ownership, elementSize?: number) => string;
+export declare const tFixedArray: (element: string, length: number, ownership?: Ownership, elementSize?: number) => string;
+export declare const tCallback: (argTypes: string[], returnType: string, options?: string) => string;
+type BindArgs = {
+    libExpr: string;
+    symbolExpr: string;
+    argList: string;
+    returnType: string;
+};
+export declare const tBind: (args: BindArgs) => string;
+export declare const tFn: (lib: string, cIdentifier: string, spec: {
+    args: string;
+    returns: string;
+    throws: boolean;
+}) => string;
+export {};
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/analysis/descriptor.d.ts.map

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