@gtkx/codegen 0.21.0

package/dist/gir/signal.js

@@ -0,0 +1,20 @@
+import { parameterFromNode, returnValueFromNode } from "./parameter.js";
+import { attr, attrBool, childOf, childrenOf } from "./parse.js";
+/**
+ * Builds a {@link GirSignal} from a `<glib:signal>` element.
+ */
+export const signalFromNode = (node) => {
+    const parametersNode = childOf(node, "parameters");
+    const parameterNodes = childrenOf(parametersNode, "parameter");
+    return {
+        name: attr(node, "name") ?? "",
+        parameters: parameterNodes.map((parameter) => parameterFromNode(parameter, false)),
+        returnValue: returnValueFromNode(childOf(node, "return-value")),
+        when: (attr(node, "when") ?? "last"),
+        detailed: attrBool(node, "detailed"),
+        action: attrBool(node, "action"),
+        noRecurse: attrBool(node, "no-recurse"),
+        noHooks: attrBool(node, "no-hooks"),
+    };
+};
+//# sourceMappingURL=signal.js.map

package/dist/gir/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/gir/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAkB/E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAa,EAAa,EAAE;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC/D,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9B,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClF,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAe;QAClD,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QACpC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QACvC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;KACtC,CAAC;AACN,CAAC,CAAC"}

package/dist/gir/size.d.ts

@@ -0,0 +1,67 @@
+import { type PrimitiveCategory } from "./primitives.js";
+/**
+ * Size and alignment of a single field as it appears in a C struct laid out
+ * according to the x86-64 ABI.
+ */
+export type FieldLayout = {
+    /** Width of the field in bytes. */
+    readonly size: number;
+    /** Required alignment in bytes; storage offset rounds up to a multiple of this. */
+    readonly align: number;
+};
+/**
+ * Returns the `{ size, align }` pair for a primitive category.
+ *
+ * Pointers and pointer-sized integers (the `pointer` and 64-bit categories)
+ * report 8/8. Smaller integers and floats report their natural width.
+ *
+ * @param category - The primitive category
+ */
+export declare const layoutOfPrimitive: (category: PrimitiveCategory) => FieldLayout;
+/**
+ * Layout slot for a single field that may participate in bitfield packing.
+ *
+ * `byteOffset` is always the offset of the underlying storage word; for
+ * non-bitfield fields it is the field's offset directly, and for bitfield
+ * members it is the start of the shared storage unit. `bitOffset` and
+ * `bitWidth` are populated only for bitfield members.
+ */
+export type FieldSlot = {
+    /** Byte offset of the storage word the field occupies. */
+    readonly byteOffset: number;
+    /** Bit position within the storage word, for bitfield members. */
+    readonly bitOffset: number | undefined;
+    /** Width in bits, for bitfield members. */
+    readonly bitWidth: number | undefined;
+};
+/**
+ * Describes a field for the purposes of layout computation.
+ */
+export type FieldLayoutInput = {
+    /** Natural byte size and alignment of the field's value type. */
+    readonly layout: FieldLayout;
+    /** When set, the field is a bitfield member with this many bits. */
+    readonly bits: number | undefined;
+};
+/**
+ * Computes per-field byte offsets for a record, grouping consecutive
+ * bitfield members of compatible storage widths into a shared storage
+ * word.
+ *
+ * Mirrors the GCC/Itanium ABI rules for C bitfield packing in a
+ * single-storage-word model: a new storage word is opened when the
+ * underlying type's size changes, when the new field is not a bitfield,
+ * or when adding the bits would exceed the word's bit count.
+ *
+ * A union (`isUnion`) overlays every member at byte offset 0; its size is the
+ * largest member rounded up to the strongest member alignment.
+ *
+ * @param fields - Ordered field layouts and bit widths
+ * @param isUnion - Whether the fields are union members (overlaid at offset 0)
+ * @returns Parallel slot array and the total record size in bytes
+ */
+export declare const computeFieldSlots: (fields: readonly FieldLayoutInput[], isUnion?: boolean) => {
+    readonly slots: readonly FieldSlot[];
+    readonly size: number;
+};
+//# sourceMappingURL=size.d.ts.map

package/dist/gir/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/gir/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,iBAAiB,KAAG,WAG/D,CAAC;AAQF;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAC1B,QAAQ,SAAS,gBAAgB,EAAE,EACnC,iBAAe,KAChB;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAiD/D,CAAC"}

package/dist/gir/size.js

@@ -0,0 +1,87 @@
+import { PRIMITIVE_SIZE } from "./primitives.js";
+/**
+ * Returns the `{ size, align }` pair for a primitive category.
+ *
+ * Pointers and pointer-sized integers (the `pointer` and 64-bit categories)
+ * report 8/8. Smaller integers and floats report their natural width.
+ *
+ * @param category - The primitive category
+ */
+export const layoutOfPrimitive = (category) => {
+    const size = PRIMITIVE_SIZE[category];
+    return { size, align: size === 0 ? 1 : size };
+};
+const roundUp = (value, multiple) => {
+    if (multiple <= 1)
+        return value;
+    const remainder = value % multiple;
+    return remainder === 0 ? value : value + (multiple - remainder);
+};
+/**
+ * Computes per-field byte offsets for a record, grouping consecutive
+ * bitfield members of compatible storage widths into a shared storage
+ * word.
+ *
+ * Mirrors the GCC/Itanium ABI rules for C bitfield packing in a
+ * single-storage-word model: a new storage word is opened when the
+ * underlying type's size changes, when the new field is not a bitfield,
+ * or when adding the bits would exceed the word's bit count.
+ *
+ * A union (`isUnion`) overlays every member at byte offset 0; its size is the
+ * largest member rounded up to the strongest member alignment.
+ *
+ * @param fields - Ordered field layouts and bit widths
+ * @param isUnion - Whether the fields are union members (overlaid at offset 0)
+ * @returns Parallel slot array and the total record size in bytes
+ */
+export const computeFieldSlots = (fields, isUnion = false) => {
+    if (isUnion) {
+        let maxSize = 0;
+        let maxAlign = 1;
+        const unionSlots = fields.map((field) => {
+            maxSize = Math.max(maxSize, field.layout.size);
+            maxAlign = Math.max(maxAlign, field.layout.align);
+            return { byteOffset: 0, bitOffset: field.bits === undefined ? undefined : 0, bitWidth: field.bits };
+        });
+        return { slots: unionSlots, size: roundUp(maxSize, maxAlign) };
+    }
+    const slots = [];
+    let cursor = 0;
+    let maxAlign = 1;
+    let bitfieldWordOffset;
+    let bitfieldWordSize = 0;
+    let bitfieldUsedBits = 0;
+    for (const field of fields) {
+        const align = Math.max(1, field.layout.align);
+        if (align > maxAlign)
+            maxAlign = align;
+        if (field.bits === undefined) {
+            bitfieldWordOffset = undefined;
+            bitfieldWordSize = 0;
+            bitfieldUsedBits = 0;
+            cursor = roundUp(cursor, align);
+            slots.push({ byteOffset: cursor, bitOffset: undefined, bitWidth: undefined });
+            cursor += field.layout.size;
+            continue;
+        }
+        const wordSizeBits = field.layout.size * 8;
+        const fits = bitfieldWordOffset !== undefined &&
+            bitfieldWordSize === field.layout.size &&
+            bitfieldUsedBits + field.bits <= wordSizeBits;
+        if (!fits) {
+            cursor = roundUp(cursor, align);
+            bitfieldWordOffset = cursor;
+            bitfieldWordSize = field.layout.size;
+            bitfieldUsedBits = 0;
+            cursor += field.layout.size;
+        }
+        slots.push({
+            byteOffset: bitfieldWordOffset ?? 0,
+            bitOffset: bitfieldUsedBits,
+            bitWidth: field.bits,
+        });
+        bitfieldUsedBits += field.bits;
+    }
+    return { slots, size: roundUp(cursor, maxAlign) };
+};
+//# sourceMappingURL=size.js.map

package/dist/gir/size.js.map

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

package/dist/gir/type-ref.d.ts

@@ -0,0 +1,79 @@
+import { type RawNode } from "./parse.js";
+import { type PrimitiveCategory } from "./primitives.js";
+/**
+ * Lazily-resolved reference to a GIR type as it appears in a `<type>` or
+ * `<array>` slot.
+ *
+ * The reference captures everything the writers need at emission time
+ * without forcing entity resolution to happen at parse time (which would
+ * impose a topological-sort order on namespace loading). Resolution into a
+ * concrete `GirClass` / `GirBoxed` / `GirEnum` / … is performed on demand
+ * by the writers via `GirRepository.resolveNamed`.
+ */
+export type GirTypeRef = PrimitiveTypeRef | NamedTypeRef | ArrayTypeRef | ListTypeRef | HashTableTypeRef | InlineCallbackTypeRef | VarargsTypeRef;
+/** A GIR scalar primitive: `gint`, `gboolean`, `utf8`, `gpointer`, etc. */
+export type PrimitiveTypeRef = {
+    readonly kind: "primitive";
+    readonly category: PrimitiveCategory;
+    readonly cType: string | undefined;
+};
+/**
+ * A named type that resolves to a class, interface, boxed, enum, alias, or
+ * fundamental in some namespace.
+ *
+ * `namespaceName` is the namespace prefix from the GIR (`"GLib"`, `"Gtk"`,
+ * …) or `undefined` for an unqualified reference. The unqualified form
+ * implies "look in the namespace the reference appears in".
+ */
+export type NamedTypeRef = {
+    readonly kind: "named";
+    readonly namespaceName: string | undefined;
+    readonly typeName: string;
+    readonly cType: string | undefined;
+};
+/** A C array (`<array>`) with optional length, fixed-size, or zero-terminated metadata. */
+export type ArrayTypeRef = {
+    readonly kind: "array";
+    readonly element: GirTypeRef;
+    readonly cType: string | undefined;
+    readonly lengthParameterIndex: number | undefined;
+    readonly fixedSize: number | undefined;
+    readonly zeroTerminated: boolean;
+};
+/** A GLib `GList` / `GSList` / `GPtrArray` / `GArray` / `GByteArray`. */
+export type ListTypeRef = {
+    readonly kind: "list";
+    readonly flavor: "glist" | "gslist" | "gptrarray" | "garray" | "gbytearray";
+    readonly element: GirTypeRef;
+    readonly cType: string | undefined;
+};
+/** A GLib `GHashTable` with key and value element types. */
+export type HashTableTypeRef = {
+    readonly kind: "hashtable";
+    readonly key: GirTypeRef;
+    readonly value: GirTypeRef;
+    readonly cType: string | undefined;
+};
+/** An inline `<callback>` (used for vtable slots and callback parameters). */
+type InlineCallbackTypeRef = {
+    readonly kind: "callback";
+    readonly callback: RawNode;
+};
+/** A `<varargs/>` parameter placeholder; not marshalable. */
+type VarargsTypeRef = {
+    readonly kind: "varargs";
+};
+/**
+ * Builds a {@link GirTypeRef} from a parent XML node whose first `<type>`,
+ * `<array>`, or `<varargs>` child describes the slot.
+ *
+ * Pass the parent (`<parameter>`, `<return-value>`, `<field>`, `<property>`,
+ * `<constant>`, `<alias>`). The helper extracts the right child and routes
+ * to {@link typeRefFromTypeNode}.
+ *
+ * @param parent - The element whose typed slot we are inspecting
+ * @returns The reference, or `undefined` if no type slot exists
+ */
+export declare const typeRefFromSlot: (parent: RawNode | undefined) => GirTypeRef | undefined;
+export {};
+//# sourceMappingURL=type-ref.d.ts.map

package/dist/gir/type-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-ref.d.ts","sourceRoot":"","sources":["../../src/gir/type-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,iBAAiB,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAChB,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,CAAC;AAErB,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC5E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,8EAA8E;AAC9E,KAAK,qBAAqB,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,6DAA6D;AAC7D,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAUnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,GAAG,SAAS,KAAG,UAAU,GAAG,SAU1E,CAAC"}

package/dist/gir/type-ref.js

@@ -0,0 +1,101 @@
+import { attr, attrBool, childOf, childrenOf } from "./parse.js";
+import { primitiveCategory } from "./primitives.js";
+const LIST_KIND_BY_NAME = new Map([
+    ["GLib.List", "glist"],
+    ["GLib.SList", "gslist"],
+    ["GLib.PtrArray", "gptrarray"],
+    ["GLib.Array", "garray"],
+    ["GLib.ByteArray", "gbytearray"],
+]);
+/**
+ * Builds a {@link GirTypeRef} from a parent XML node whose first `<type>`,
+ * `<array>`, or `<varargs>` child describes the slot.
+ *
+ * Pass the parent (`<parameter>`, `<return-value>`, `<field>`, `<property>`,
+ * `<constant>`, `<alias>`). The helper extracts the right child and routes
+ * to {@link typeRefFromTypeNode}.
+ *
+ * @param parent - The element whose typed slot we are inspecting
+ * @returns The reference, or `undefined` if no type slot exists
+ */
+export const typeRefFromSlot = (parent) => {
+    if (parent === undefined)
+        return undefined;
+    if (childOf(parent, "varargs") !== undefined)
+        return { kind: "varargs" };
+    const arrayNode = childOf(parent, "array");
+    if (arrayNode !== undefined)
+        return arrayTypeRefFromNode(arrayNode);
+    const typeNode = childOf(parent, "type");
+    if (typeNode !== undefined)
+        return typeRefFromTypeNode(typeNode);
+    const callback = childOf(parent, "callback");
+    if (callback !== undefined)
+        return { kind: "callback", callback };
+    return undefined;
+};
+/**
+ * Builds a {@link GirTypeRef} from a `<type>` element.
+ *
+ * Splits a `Namespace.TypeName` form into namespace + type, recognises GLib
+ * container types (`GLib.List`, `GLib.HashTable`, …) by name and routes
+ * them to the dedicated branches, otherwise produces a primitive or named
+ * reference for later resolution.
+ *
+ * @param typeNode - A `<type>` element
+ */
+const typeRefFromTypeNode = (typeNode) => {
+    const name = attr(typeNode, "name") ?? "";
+    const cType = attr(typeNode, "c:type");
+    const listFlavor = LIST_KIND_BY_NAME.get(name);
+    if (listFlavor !== undefined) {
+        const elementNode = childOf(typeNode, "type");
+        const element = elementNode === undefined ? pointerFallback() : typeRefFromTypeNode(elementNode);
+        return { kind: "list", flavor: listFlavor, element, cType };
+    }
+    if (name === "GLib.HashTable") {
+        const elementTypes = childrenOf(typeNode, "type");
+        const keyNode = elementTypes[0];
+        const valueNode = elementTypes[1];
+        return {
+            kind: "hashtable",
+            key: keyNode === undefined ? pointerFallback() : typeRefFromTypeNode(keyNode),
+            value: valueNode === undefined ? pointerFallback() : typeRefFromTypeNode(valueNode),
+            cType,
+        };
+    }
+    const primitive = primitiveCategory(name);
+    if (primitive !== undefined) {
+        return { kind: "primitive", category: primitive, cType };
+    }
+    const [namespaceName, typeName] = splitOptionalNamespace(name);
+    return { kind: "named", namespaceName, typeName, cType };
+};
+const arrayTypeRefFromNode = (arrayNode) => {
+    const elementNode = childOf(arrayNode, "type");
+    const element = elementNode === undefined ? pointerFallback() : typeRefFromTypeNode(elementNode);
+    const cType = attr(arrayNode, "c:type");
+    const arrayName = attr(arrayNode, "name");
+    const listFlavor = arrayName === undefined ? undefined : LIST_KIND_BY_NAME.get(arrayName);
+    if (listFlavor !== undefined) {
+        return { kind: "list", flavor: listFlavor, element, cType };
+    }
+    const lengthAttr = attr(arrayNode, "length");
+    const fixedSizeAttr = attr(arrayNode, "fixed-size");
+    return {
+        kind: "array",
+        element,
+        cType,
+        lengthParameterIndex: lengthAttr === undefined ? undefined : Number.parseInt(lengthAttr, 10),
+        fixedSize: fixedSizeAttr === undefined ? undefined : Number.parseInt(fixedSizeAttr, 10),
+        zeroTerminated: attrBool(arrayNode, "zero-terminated", false),
+    };
+};
+const pointerFallback = () => ({ kind: "primitive", category: "pointer", cType: undefined });
+const splitOptionalNamespace = (name) => {
+    const dot = name.indexOf(".");
+    if (dot === -1)
+        return [undefined, name];
+    return [name.slice(0, dot), name.slice(dot + 1)];
+};
+//# sourceMappingURL=type-ref.js.map

package/dist/gir/type-ref.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public API of `@gtkx/codegen`.
+ *
+ * The package exposes a single entry point — {@link CodegenRunner} — that
+ * orchestrates the GIR-driven code generation for the FFI and React
+ * surfaces. Internal modules (`gir/`, `dsl/`, `writers/`, `ffi/`,
+ * `react/`) are not part of the supported surface and may change in any
+ * release.
+ */
+export { CODEGEN_VERSION, type CodegenFingerprint, computeFingerprint, FINGERPRINT_FILENAME, } from "./fingerprint.js";
+export { CodegenRunner } from "./runner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACH,eAAe,EACf,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Public API of `@gtkx/codegen`.
+ *
+ * The package exposes a single entry point — {@link CodegenRunner} — that
+ * orchestrates the GIR-driven code generation for the FFI and React
+ * surfaces. Internal modules (`gir/`, `dsl/`, `writers/`, `ffi/`,
+ * `react/`) are not part of the supported surface and may change in any
+ * release.
+ */
+export { CODEGEN_VERSION, computeFingerprint, FINGERPRINT_FILENAME, } from "./fingerprint.js";
+export { CodegenRunner } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACH,eAAe,EAEf,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/jsx-store.d.ts

@@ -0,0 +1,22 @@
+import { type StoreOptions } from "./store-fs.js";
+/**
+ * Options for assembling the injected `@gtkx/react-jsx` unit.
+ */
+export type JsxStoreOptions = StoreOptions & {
+    /** Absolute path to the gi store, for the unit's own `node_modules/@gtkx/gi`. */
+    readonly giStoreDir: string;
+    /** Real (symlink-resolved) directory of the installed `react` runtime. */
+    readonly realReactRuntimeDir: string;
+    /** Real (symlink-resolved) directory of the installed `@gtkx/react`. */
+    readonly realReactPackageDir: string;
+};
+/**
+ * Assembles the self-contained injected `@gtkx/react-jsx` unit: the generated
+ * `jsx`/`internal`/`compounds` modules plus a `package.json` and the unit's own
+ * `node_modules` symlinks to `@gtkx/gi` and `react`.
+ *
+ * @param options - Resolved store/link/dependency paths
+ * @param files - React pipeline output keyed by source filename
+ */
+export declare const writeJsxStore: (options: JsxStoreOptions, files: ReadonlyMap<string, string>) => void;
+//# sourceMappingURL=jsx-store.d.ts.map

package/dist/jsx-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-store.d.ts","sourceRoot":"","sources":["../src/jsx-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG;IACzC,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACxC,CAAC;AAIF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,eAAe,EAAE,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,IA4B5F,CAAC"}

package/dist/jsx-store.js

@@ -0,0 +1,40 @@
+import { writeStore } from "./store-fs.js";
+const stem = (relativePath) => relativePath.replace(/\.(tsx|ts)$/, "");
+/**
+ * Assembles the self-contained injected `@gtkx/react-jsx` unit: the generated
+ * `jsx`/`internal`/`compounds` modules plus a `package.json` and the unit's own
+ * `node_modules` symlinks to `@gtkx/gi` and `react`.
+ *
+ * @param options - Resolved store/link/dependency paths
+ * @param files - React pipeline output keyed by source filename
+ */
+export const writeJsxStore = (options, files) => {
+    writeStore({
+        storeDir: options.storeDir,
+        linkDir: options.linkDir,
+        files: [...files].map(([relativePath, source]) => ({
+            stem: stem(relativePath),
+            fileName: relativePath,
+            source,
+        })),
+        manifest: {
+            name: "@gtkx/react-jsx",
+            type: "module",
+            version: options.version,
+            sideEffects: ["./internal.js"],
+            exports: {
+                "./package.json": "./package.json",
+                ".": { types: "./jsx.d.ts", default: "./jsx.js" },
+                "./jsx": { types: "./jsx.d.ts", default: "./jsx.js" },
+                "./compounds": { types: "./compounds.d.ts", default: "./compounds.js" },
+                "./internal": { types: "./internal.d.ts", default: "./internal.js" },
+            },
+        },
+        symlinks: [
+            { segments: ["node_modules", "@gtkx", "gi"], target: options.giStoreDir },
+            { segments: ["node_modules", "@gtkx", "react"], target: options.realReactPackageDir },
+            { segments: ["node_modules", "react"], target: options.realReactRuntimeDir },
+        ],
+    });
+};
+//# sourceMappingURL=jsx-store.js.map

package/dist/jsx-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-store.js","sourceRoot":"","sources":["../src/jsx-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,eAAe,CAAC;AAc9D,MAAM,IAAI,GAAG,CAAC,YAAoB,EAAU,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAwB,EAAE,KAAkC,EAAQ,EAAE;IAChG,UAAU,CAAC;QACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC;YACxB,QAAQ,EAAE,YAAY;YACtB,MAAM;SACT,CAAC,CAAC;QACH,QAAQ,EAAE;YACN,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,CAAC,eAAe,CAAC;YAC9B,OAAO,EAAE;gBACL,gBAAgB,EAAE,gBAAgB;gBAClC,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE;gBACjD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE;gBACrD,aAAa,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,gBAAgB,EAAE;gBACvE,YAAY,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE;aACvE;SACJ;QACD,QAAQ,EAAE;YACN,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;YACzE,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;YACrF,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE;SAC/E;KACJ,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/react/compounds-meta.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Returns the container-slot method names for a JSX element name, or an
+ * empty array if no container slots exist.
+ *
+ * @param jsxName - The JSX element name (PascalCase / GLib type name)
+ */
+export declare const containerSlotsFor: (jsxName: string) => readonly string[];
+/**
+ * Returns the virtual-subcomponent record for a JSX element name, or an
+ * empty array if no virtual subcomponents exist.
+ *
+ * @param jsxName - The JSX element name (PascalCase / GLib type name)
+ */
+export declare const virtualSubcomponentsFor: (jsxName: string) => ReadonlyArray<{
+    readonly child: string;
+    readonly intrinsic: string;
+}>;
+//# sourceMappingURL=compounds-meta.d.ts.map

package/dist/react/compounds-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compounds-meta.d.ts","sourceRoot":"","sources":["../../src/react/compounds-meta.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,SAAS,MAAM,EAAoC,CAAC;AA2DxG;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAChC,SAAS,MAAM,KAChB,aAAa,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAyC,CAAC"}

package/dist/react/compounds-meta.js

@@ -0,0 +1,93 @@
+/**
+ * Container-slot mapping for compound widgets — JSX element name to the
+ * camelCase GTK method names that append a child onto the widget.
+ *
+ * Each method name doubles as a `ReactNode` prop on the compound and as the
+ * `<ContainerSlot id="…">` identifier the reconciler dispatches to. For
+ * example `packStart` on `AdwHeaderBar` maps to `adw_header_bar_pack_start(…)`;
+ * `<AdwHeaderBar packStart={…} />` packs the value at the start.
+ *
+ * Unlike setter slots ({@link BUILT_IN_SLOT_PROPS}), a container slot accepts
+ * multiple children and appends rather than replaces.
+ *
+ * The list is small and stable; defining it in code keeps the lookup
+ * fast and avoids one more GIR-introspection pass.
+ */
+const CONTAINER_SLOTS = Object.freeze({
+    AdwActionRow: ["addPrefix", "addSuffix"],
+    AdwEntryRow: ["addPrefix", "addSuffix"],
+    AdwExpanderRow: ["addPrefix", "addSuffix", "addRow", "addAction"],
+    AdwHeaderBar: ["packStart", "packEnd"],
+    AdwToolbarView: ["addTopBar", "addBottomBar"],
+    GtkActionBar: ["packStart", "packEnd"],
+    GtkHeaderBar: ["packStart", "packEnd"],
+});
+/**
+ * Returns the container-slot method names for a JSX element name, or an
+ * empty array if no container slots exist.
+ *
+ * @param jsxName - The JSX element name (PascalCase / GLib type name)
+ */
+export const containerSlotsFor = (jsxName) => CONTAINER_SLOTS[jsxName] ?? [];
+/**
+ * Virtual-child subcomponent mapping — JSX element name to the map of
+ * subcomponent property → virtual JSX intrinsic name it routes through.
+ *
+ * For example `GtkConstraintLayout.Constraint` renders the
+ * `<Constraint>` virtual intrinsic so the reconciler can attach a
+ * GtkConstraint to the layout. Unlike container slots, virtual
+ * subcomponents render an existing intrinsic element rather than
+ * invoking a setter on the parent widget.
+ */
+const VIRTUAL_SUBCOMPONENTS = Object.freeze({
+    GtkShortcutController: [{ child: "Shortcut", intrinsic: "Shortcut" }],
+    GtkConstraintLayout: [
+        { child: "Constraint", intrinsic: "Constraint" },
+        { child: "Guide", intrinsic: "ConstraintGuide" },
+        { child: "Widget", intrinsic: "ConstraintLayoutWidget" },
+        { child: "Vfl", intrinsic: "ConstraintVfl" },
+    ],
+    GtkStack: [{ child: "Page", intrinsic: "StackPage" }],
+    AdwViewStack: [{ child: "Page", intrinsic: "StackPage" }],
+    GtkNotebook: [
+        { child: "Page", intrinsic: "NotebookPage" },
+        { child: "PageTab", intrinsic: "NotebookPageTab" },
+    ],
+    GtkGrid: [{ child: "Child", intrinsic: "GridChild" }],
+    GtkFixed: [{ child: "Child", intrinsic: "FixedChild" }],
+    GtkOverlay: [{ child: "Child", intrinsic: "OverlayChild" }],
+    GtkColumnView: [{ child: "Column", intrinsic: "ColumnViewColumn" }],
+    GtkTextView: [
+        { child: "Tag", intrinsic: "TextTag" },
+        { child: "Anchor", intrinsic: "TextAnchor" },
+        { child: "Paintable", intrinsic: "TextPaintable" },
+    ],
+    GtkSourceView: [
+        { child: "Tag", intrinsic: "TextTag" },
+        { child: "Anchor", intrinsic: "TextAnchor" },
+        { child: "Paintable", intrinsic: "TextPaintable" },
+    ],
+    GtkMenuButton: [
+        { child: "MenuItem", intrinsic: "MenuItem" },
+        { child: "MenuSection", intrinsic: "MenuSection" },
+        { child: "MenuSubmenu", intrinsic: "MenuSubmenu" },
+    ],
+    GtkPopoverMenu: [
+        { child: "Item", intrinsic: "MenuItem" },
+        { child: "Section", intrinsic: "MenuSection" },
+        { child: "Submenu", intrinsic: "MenuSubmenu" },
+    ],
+    GtkPopoverMenuBar: [
+        { child: "Item", intrinsic: "MenuItem" },
+        { child: "Section", intrinsic: "MenuSection" },
+        { child: "Submenu", intrinsic: "MenuSubmenu" },
+    ],
+});
+/**
+ * Returns the virtual-subcomponent record for a JSX element name, or an
+ * empty array if no virtual subcomponents exist.
+ *
+ * @param jsxName - The JSX element name (PascalCase / GLib type name)
+ */
+export const virtualSubcomponentsFor = (jsxName) => VIRTUAL_SUBCOMPONENTS[jsxName] ?? [];
+//# sourceMappingURL=compounds-meta.js.map

package/dist/react/compounds-meta.js.map

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