@gtkx/codegen 0.21.0

package/dist/gir/primitives.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Mapping from GIR primitive type names to the FFI marshaling categories
+ * the writers emit.
+ *
+ * The categories mirror the `t.*` helpers exposed by `@gtkx/ffi`'s runtime
+ * (see `packages/ffi/src/helpers.ts`). Categories that are not directly
+ * marshaled (e.g. `void`, `string`, `unichar`) are still listed so callers
+ * can branch on them without falling through to a default.
+ */
+export type PrimitiveCategory = "void" | "boolean" | "int8" | "uint8" | "int16" | "uint16" | "int32" | "uint32" | "int64" | "uint64" | "float32" | "float64" | "string" | "unichar" | "pointer";
+/**
+ * Width in bytes of each primitive category on the x86-64 ABI (Linux LP64).
+ *
+ * The widths are also used as the natural alignment requirement of each
+ * category — every native integer/float aligns to its own size.
+ */
+export declare const PRIMITIVE_SIZE: Readonly<Record<PrimitiveCategory, number>>;
+/**
+ * Returns the FFI category for a GIR primitive name (`"gint"`, `"utf8"`,
+ * `"gsize"`, …) or `undefined` when the name is not a primitive.
+ *
+ * Aliases that GIR uses inconsistently (`gint` / `int` / `gint32`, …) all
+ * map to the same canonical category.
+ *
+ * @param name - The GIR type name as it appears in `<type name="…">`
+ */
+export declare const primitiveCategory: (name: string) => PrimitiveCategory | undefined;
+/**
+ * TypeScript surface type for each primitive category.
+ *
+ * Codegen surfaces both raw C primitives and string-marshalled categories
+ * (`string`, `unichar`) through this map so writers in the FFI and React
+ * pipelines agree on the same annotation per category.
+ */
+export declare const PRIMITIVE_TS_TYPE: Readonly<Record<PrimitiveCategory, string>>;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/gir/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEhB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAgBrE,CAAC;AAsDH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SAAwC,CAAC;AAE9G;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAgBxE,CAAC"}

package/dist/gir/primitives.js

@@ -0,0 +1,109 @@
+/**
+ * Width in bytes of each primitive category on the x86-64 ABI (Linux LP64).
+ *
+ * The widths are also used as the natural alignment requirement of each
+ * category — every native integer/float aligns to its own size.
+ */
+export const PRIMITIVE_SIZE = Object.freeze({
+    void: 0,
+    boolean: 4,
+    int8: 1,
+    uint8: 1,
+    int16: 2,
+    uint16: 2,
+    int32: 4,
+    uint32: 4,
+    int64: 8,
+    uint64: 8,
+    float32: 4,
+    float64: 8,
+    string: 8,
+    unichar: 4,
+    pointer: 8,
+});
+const PRIMITIVE_BY_NAME = new Map([
+    ["none", "void"],
+    ["void", "void"],
+    ["gboolean", "boolean"],
+    ["gchar", "int8"],
+    ["gint8", "int8"],
+    ["guchar", "uint8"],
+    ["guint8", "uint8"],
+    ["gshort", "int16"],
+    ["gint16", "int16"],
+    ["gushort", "uint16"],
+    ["guint16", "uint16"],
+    ["gint", "int32"],
+    ["gint32", "int32"],
+    ["int", "int32"],
+    ["int8", "int8"],
+    ["uint8", "uint8"],
+    ["int16", "int16"],
+    ["uint16", "uint16"],
+    ["int32", "int32"],
+    ["uint32", "uint32"],
+    ["int64", "int64"],
+    ["uint64", "uint64"],
+    ["guint", "uint32"],
+    ["guint32", "uint32"],
+    ["glong", "int64"],
+    ["gint64", "int64"],
+    ["long", "int64"],
+    ["gssize", "int64"],
+    ["gintptr", "int64"],
+    ["gulong", "uint64"],
+    ["guint64", "uint64"],
+    ["gsize", "uint64"],
+    ["guintptr", "uint64"],
+    ["GType", "uint64"],
+    ["time_t", "int64"],
+    ["pid_t", "int32"],
+    ["uid_t", "uint32"],
+    ["gid_t", "uint32"],
+    ["gfloat", "float32"],
+    ["float", "float32"],
+    ["gdouble", "float64"],
+    ["double", "float64"],
+    ["long double", "float64"],
+    ["utf8", "string"],
+    ["filename", "string"],
+    ["gchararray", "string"],
+    ["gunichar", "unichar"],
+    ["gpointer", "pointer"],
+    ["gconstpointer", "pointer"],
+]);
+/**
+ * Returns the FFI category for a GIR primitive name (`"gint"`, `"utf8"`,
+ * `"gsize"`, …) or `undefined` when the name is not a primitive.
+ *
+ * Aliases that GIR uses inconsistently (`gint` / `int` / `gint32`, …) all
+ * map to the same canonical category.
+ *
+ * @param name - The GIR type name as it appears in `<type name="…">`
+ */
+export const primitiveCategory = (name) => PRIMITIVE_BY_NAME.get(name);
+/**
+ * TypeScript surface type for each primitive category.
+ *
+ * Codegen surfaces both raw C primitives and string-marshalled categories
+ * (`string`, `unichar`) through this map so writers in the FFI and React
+ * pipelines agree on the same annotation per category.
+ */
+export const PRIMITIVE_TS_TYPE = Object.freeze({
+    void: "void",
+    boolean: "boolean",
+    int8: "number",
+    uint8: "number",
+    int16: "number",
+    uint16: "number",
+    int32: "number",
+    uint32: "number",
+    int64: "number",
+    uint64: "number",
+    float32: "number",
+    float64: "number",
+    string: "string",
+    unichar: "string",
+    pointer: "number",
+});
+//# sourceMappingURL=primitives.js.map

package/dist/gir/primitives.js.map

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

package/dist/gir/property.d.ts

@@ -0,0 +1,29 @@
+import type { ParameterTransfer } from "./parameter.js";
+import { type RawNode } from "./parse.js";
+import { type GirTypeRef } from "./type-ref.js";
+/**
+ * A `<property>` of a class or interface.
+ *
+ * GIR property names are kebab-case; the writers convert them to camelCase
+ * for the JS surface and pass the original GIR name through to
+ * `registerConstructionMeta` for `g_object_newv` parameter building.
+ */
+export type GirProperty = {
+    /** GIR property name, kebab-case (e.g. `"css-name"`). */
+    readonly name: string;
+    /** Property value type. */
+    readonly type: GirTypeRef | undefined;
+    readonly writable: boolean;
+    readonly construct: boolean;
+    readonly constructOnly: boolean;
+    readonly transferOwnership: ParameterTransfer;
+    /** Optional method name that backs the property's getter (`getter="get_foo"`). */
+    readonly getter: string | undefined;
+    /** Optional method name that backs the property's setter (`setter="set_foo"`). */
+    readonly setter: string | undefined;
+};
+/**
+ * Builds a {@link GirProperty} from a `<property>` element.
+ */
+export declare const propertyFromNode: (node: RawNode) => GirProperty;
+//# sourceMappingURL=property.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,eAAe,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,WAS/C,CAAC"}

package/dist/gir/property.js

@@ -0,0 +1,16 @@
+import { attr, attrBool } from "./parse.js";
+import { typeRefFromSlot } from "./type-ref.js";
+/**
+ * Builds a {@link GirProperty} from a `<property>` element.
+ */
+export const propertyFromNode = (node) => ({
+    name: attr(node, "name") ?? "",
+    type: typeRefFromSlot(node),
+    writable: attrBool(node, "writable"),
+    construct: attrBool(node, "construct"),
+    constructOnly: attrBool(node, "construct-only"),
+    transferOwnership: (attr(node, "transfer-ownership") ?? "none"),
+    getter: attr(node, "getter"),
+    setter: attr(node, "setter"),
+});
+//# sourceMappingURL=property.js.map

package/dist/gir/property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.js","sourceRoot":"","sources":["../../src/gir/property.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAwBjE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAe,EAAE,CAAC,CAAC;IAC7D,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;IAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IACtC,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAC/C,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,IAAI,MAAM,CAAsB;IACpF,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;CAC/B,CAAC,CAAC"}

package/dist/gir/qualified-name.d.ts

@@ -0,0 +1,37 @@
+import type { GirClass } from "./class.js";
+import type { GirRepository } from "./repository.js";
+/**
+ * Splits a possibly cross-namespace GIR identifier (e.g. `"Gtk.Widget"`) into
+ * its namespace and local name.
+ *
+ * Identifiers without a dot are resolved against `defaultNamespace`. This
+ * mirrors the GIR convention where same-namespace references omit the
+ * namespace prefix.
+ *
+ * @param qualified - The GIR identifier as it appears in `<type>` / `parent`
+ * @param defaultNamespace - The namespace to assume when no prefix is present
+ */
+export declare const splitQualifiedName: (qualified: string, defaultNamespace: string) => {
+    readonly namespaceName: string;
+    readonly typeName: string;
+};
+/**
+ * A class or interface together with the namespace it was resolved through.
+ */
+export type ResolvedQualifiedClass = {
+    readonly klass: GirClass;
+    readonly namespaceName: string;
+};
+/**
+ * Resolves a possibly cross-namespace identifier to its `class` or `interface`
+ * entry plus the namespace that declares it.
+ *
+ * Returns `undefined` when the identifier resolves to a different kind of GIR
+ * entity (boxed, enum, …) or cannot be resolved at all.
+ *
+ * @param repository - The repository to query
+ * @param qualified - The GIR identifier (e.g. `"Gtk.Widget"`)
+ * @param defaultNamespace - Namespace to assume for unqualified identifiers
+ */
+export declare const resolveQualifiedClass: (repository: GirRepository, qualified: string, defaultNamespace: string) => ResolvedQualifiedClass | undefined;
+//# sourceMappingURL=qualified-name.d.ts.map

package/dist/gir/qualified-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-name.d.ts","sourceRoot":"","sources":["../../src/gir/qualified-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC3B,WAAW,MAAM,EACjB,kBAAkB,MAAM,KACzB;IAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAM7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAC9B,YAAY,aAAa,EACzB,WAAW,MAAM,EACjB,kBAAkB,MAAM,KACzB,sBAAsB,GAAG,SAM3B,CAAC"}

package/dist/gir/qualified-name.js

@@ -0,0 +1,39 @@
+/**
+ * Splits a possibly cross-namespace GIR identifier (e.g. `"Gtk.Widget"`) into
+ * its namespace and local name.
+ *
+ * Identifiers without a dot are resolved against `defaultNamespace`. This
+ * mirrors the GIR convention where same-namespace references omit the
+ * namespace prefix.
+ *
+ * @param qualified - The GIR identifier as it appears in `<type>` / `parent`
+ * @param defaultNamespace - The namespace to assume when no prefix is present
+ */
+export const splitQualifiedName = (qualified, defaultNamespace) => {
+    const dot = qualified.indexOf(".");
+    if (dot === -1) {
+        return { namespaceName: defaultNamespace, typeName: qualified };
+    }
+    return { namespaceName: qualified.slice(0, dot), typeName: qualified.slice(dot + 1) };
+};
+/**
+ * Resolves a possibly cross-namespace identifier to its `class` or `interface`
+ * entry plus the namespace that declares it.
+ *
+ * Returns `undefined` when the identifier resolves to a different kind of GIR
+ * entity (boxed, enum, …) or cannot be resolved at all.
+ *
+ * @param repository - The repository to query
+ * @param qualified - The GIR identifier (e.g. `"Gtk.Widget"`)
+ * @param defaultNamespace - Namespace to assume for unqualified identifiers
+ */
+export const resolveQualifiedClass = (repository, qualified, defaultNamespace) => {
+    const { namespaceName, typeName } = splitQualifiedName(qualified, defaultNamespace);
+    const resolved = repository.resolveNamed(namespaceName, typeName);
+    if (resolved === undefined)
+        return undefined;
+    if (resolved.kind !== "class" && resolved.kind !== "interface")
+        return undefined;
+    return { klass: resolved.value, namespaceName: resolved.namespace.name };
+};
+//# sourceMappingURL=qualified-name.js.map

package/dist/gir/qualified-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-name.js","sourceRoot":"","sources":["../../src/gir/qualified-name.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAC9B,SAAiB,EACjB,gBAAwB,EACqC,EAAE;IAC/D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AAC1F,CAAC,CAAC;AAUF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,UAAyB,EACzB,SAAiB,EACjB,gBAAwB,EACU,EAAE;IACpC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAClE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AAC7E,CAAC,CAAC"}

package/dist/gir/qualify.d.ts

@@ -0,0 +1,32 @@
+import type { GirFunction } from "./function.js";
+import type { GirTypeRef } from "./type-ref.js";
+/**
+ * Stamps a default namespace onto an unqualified `named` reference and
+ * recurses into composite (`array`, `list`, `hashtable`) references.
+ *
+ * GIR omits the namespace when a reference points to a sibling in the same
+ * file. When writers walk a class hierarchy across namespaces, the parent's
+ * references must be qualified with the parent's namespace before they can be
+ * resolved against the repository.
+ *
+ * Returns `undefined` for an `undefined` input so callers can pass through
+ * void return types unchanged.
+ *
+ * @param ref - The reference to qualify, or `undefined`
+ * @param defaultNamespace - The namespace to stamp on unqualified refs
+ */
+export declare const qualifyTypeRef: (ref: GirTypeRef | undefined, defaultNamespace: string) => GirTypeRef | undefined;
+/**
+ * Re-roots every type reference of a callable to `defaultNamespace`.
+ *
+ * Interface methods are flattened onto each implementing class, but their
+ * GIR type references are unqualified relative to the interface's own
+ * namespace. Stamping the interface namespace onto the instance parameter,
+ * each regular parameter, and the return value lets the class writer resolve
+ * and import those references as if the method had been authored on the class.
+ *
+ * @param fn - The callable whose references to qualify
+ * @param defaultNamespace - The namespace the callable's references belong to
+ */
+export declare const qualifyFunction: (fn: GirFunction, defaultNamespace: string) => GirFunction;
+//# sourceMappingURL=qualify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualify.d.ts","sourceRoot":"","sources":["../../src/gir/qualify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,UAAU,GAAG,SAAS,EAAE,kBAAkB,MAAM,KAAG,UAAU,GAAG,SAoBnG,CAAC;AAOF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,IAAI,WAAW,EAAE,kBAAkB,MAAM,KAAG,WAK1E,CAAC"}

package/dist/gir/qualify.js

@@ -0,0 +1,60 @@
+/**
+ * Stamps a default namespace onto an unqualified `named` reference and
+ * recurses into composite (`array`, `list`, `hashtable`) references.
+ *
+ * GIR omits the namespace when a reference points to a sibling in the same
+ * file. When writers walk a class hierarchy across namespaces, the parent's
+ * references must be qualified with the parent's namespace before they can be
+ * resolved against the repository.
+ *
+ * Returns `undefined` for an `undefined` input so callers can pass through
+ * void return types unchanged.
+ *
+ * @param ref - The reference to qualify, or `undefined`
+ * @param defaultNamespace - The namespace to stamp on unqualified refs
+ */
+export const qualifyTypeRef = (ref, defaultNamespace) => {
+    if (ref === undefined)
+        return undefined;
+    switch (ref.kind) {
+        case "named":
+            return { ...ref, namespaceName: ref.namespaceName ?? defaultNamespace };
+        case "array":
+            return { ...ref, element: qualifyTypeRef(ref.element, defaultNamespace) ?? ref.element };
+        case "list":
+            return { ...ref, element: qualifyTypeRef(ref.element, defaultNamespace) ?? ref.element };
+        case "hashtable":
+            return {
+                ...ref,
+                key: qualifyTypeRef(ref.key, defaultNamespace) ?? ref.key,
+                value: qualifyTypeRef(ref.value, defaultNamespace) ?? ref.value,
+            };
+        case "primitive":
+        case "callback":
+        case "varargs":
+            return ref;
+    }
+};
+const qualifyParameter = (parameter, defaultNamespace) => ({
+    ...parameter,
+    type: qualifyTypeRef(parameter.type, defaultNamespace),
+});
+/**
+ * Re-roots every type reference of a callable to `defaultNamespace`.
+ *
+ * Interface methods are flattened onto each implementing class, but their
+ * GIR type references are unqualified relative to the interface's own
+ * namespace. Stamping the interface namespace onto the instance parameter,
+ * each regular parameter, and the return value lets the class writer resolve
+ * and import those references as if the method had been authored on the class.
+ *
+ * @param fn - The callable whose references to qualify
+ * @param defaultNamespace - The namespace the callable's references belong to
+ */
+export const qualifyFunction = (fn, defaultNamespace) => ({
+    ...fn,
+    instance: fn.instance === undefined ? undefined : qualifyParameter(fn.instance, defaultNamespace),
+    parameters: fn.parameters.map((parameter) => qualifyParameter(parameter, defaultNamespace)),
+    returnValue: { ...fn.returnValue, type: qualifyTypeRef(fn.returnValue.type, defaultNamespace) },
+});
+//# sourceMappingURL=qualify.js.map

package/dist/gir/qualify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualify.js","sourceRoot":"","sources":["../../src/gir/qualify.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAA2B,EAAE,gBAAwB,EAA0B,EAAE;IAC5G,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,OAAO;YACR,OAAO,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,gBAAgB,EAAE,CAAC;QAC5E,KAAK,OAAO;YACR,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7F,KAAK,MAAM;YACP,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7F,KAAK,WAAW;YACZ,OAAO;gBACH,GAAG,GAAG;gBACN,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,IAAI,GAAG,CAAC,GAAG;gBACzD,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,GAAG,CAAC,KAAK;aAClE,CAAC;QACN,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACV,OAAO,GAAG,CAAC;IACnB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAuB,EAAE,gBAAwB,EAAgB,EAAE,CAAC,CAAC;IAC3F,GAAG,SAAS;IACZ,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACzD,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAe,EAAE,gBAAwB,EAAe,EAAE,CAAC,CAAC;IACxF,GAAG,EAAE;IACL,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACjG,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC3F,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE;CAClG,CAAC,CAAC"}

package/dist/gir/repository.d.ts

@@ -0,0 +1,82 @@
+import type { GirBoxed } from "./boxed.js";
+import type { GirCallback } from "./callback.js";
+import type { GirClass } from "./class.js";
+import type { GirEnum } from "./enum.js";
+import { type GirNamespace } from "./namespace.js";
+import type { GirTypeRef } from "./type-ref.js";
+/**
+ * Resolved entity that a {@link GirRepository.resolveNamed} call returns.
+ *
+ * Wraps the matching entity along with the namespace it lives in, so
+ * writers can pull the namespace identifier or shared library name without
+ * a second lookup.
+ */
+export type ResolvedNamed = {
+    readonly kind: "class";
+    readonly namespace: GirNamespace;
+    readonly value: GirClass;
+} | {
+    readonly kind: "interface";
+    readonly namespace: GirNamespace;
+    readonly value: GirClass;
+} | {
+    readonly kind: "boxed";
+    readonly namespace: GirNamespace;
+    readonly value: GirBoxed;
+} | {
+    readonly kind: "enum";
+    readonly namespace: GirNamespace;
+    readonly value: GirEnum;
+} | {
+    readonly kind: "callback";
+    readonly namespace: GirNamespace;
+    readonly value: GirCallback;
+} | {
+    readonly kind: "alias";
+    readonly namespace: GirNamespace;
+    readonly target: string | undefined;
+    readonly targetRef: GirTypeRef | undefined;
+};
+/**
+ * In-memory database of every loaded GIR namespace, indexed by name.
+ *
+ * Construct via {@link loadGirRepository}; the public API after that is the
+ * `namespaces` map and {@link resolveNamed} for cross-namespace lookups.
+ */
+export declare class GirRepository {
+    /** Namespaces keyed by their unqualified name (e.g. `"Gtk"`, `"GLib"`). */
+    readonly namespaces: ReadonlyMap<string, GirNamespace>;
+    /** Absolute paths of every `.gir` file loaded, for staleness fingerprinting. */
+    readonly girFiles: readonly string[];
+    private readonly entityIndex;
+    /**
+     * Constructs a repository from the supplied namespace map.
+     *
+     * Callers should prefer {@link loadGirRepository} which discovers and
+     * parses files for you.
+     *
+     * @param namespaces - Namespaces keyed by unqualified name
+     * @param girFiles - Absolute paths of the `.gir` files the namespaces came from
+     */
+    constructor(namespaces: ReadonlyMap<string, GirNamespace>, girFiles?: readonly string[]);
+    /**
+     * Looks up a type by `(namespace, name)`. Aliases are followed one step
+     * to their target. Returns `undefined` when neither the namespace nor a
+     * matching entity exists.
+     *
+     * @param namespaceName - Namespace to look in (e.g. `"GLib"`)
+     * @param typeName - Local type name within the namespace (e.g. `"Variant"`)
+     */
+    resolveNamed(namespaceName: string, typeName: string): ResolvedNamed | undefined;
+}
+/**
+ * Discovers and parses every GIR file needed to satisfy `libraries` and
+ * their transitive `<include>` dependencies.
+ *
+ * @param libraries - Resolved `Name-Version` namespace identifiers
+ * @param girPath - Ordered list of directories to search for `.gir` files
+ * @returns A populated {@link GirRepository}
+ * @throws If any required GIR file cannot be located on `girPath`
+ */
+export declare const loadGirRepository: (libraries: readonly string[], girPath: readonly string[]) => GirRepository;
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/gir/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,gBAAgB,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC5F;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C,CAAC;AAER;;;;;GAKG;AACH,qBAAa,aAAa;IACtB,2EAA2E;IAC3E,SAAgB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9D,gFAAgF;IAChF,SAAgB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD;;;;;;;;OAQG;gBACS,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO;IAS3F;;;;;;;OAOG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAMnF;AA+BD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,SAAS,MAAM,EAAE,EAAE,SAAS,SAAS,MAAM,EAAE,KAAG,aAuB5F,CAAC"}

package/dist/gir/repository.js

@@ -0,0 +1,122 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { namespaceFromRepository } from "./namespace.js";
+import { parseGirFile } from "./parse.js";
+/**
+ * In-memory database of every loaded GIR namespace, indexed by name.
+ *
+ * Construct via {@link loadGirRepository}; the public API after that is the
+ * `namespaces` map and {@link resolveNamed} for cross-namespace lookups.
+ */
+export class GirRepository {
+    /** Namespaces keyed by their unqualified name (e.g. `"Gtk"`, `"GLib"`). */
+    namespaces;
+    /** Absolute paths of every `.gir` file loaded, for staleness fingerprinting. */
+    girFiles;
+    entityIndex;
+    /**
+     * Constructs a repository from the supplied namespace map.
+     *
+     * Callers should prefer {@link loadGirRepository} which discovers and
+     * parses files for you.
+     *
+     * @param namespaces - Namespaces keyed by unqualified name
+     * @param girFiles - Absolute paths of the `.gir` files the namespaces came from
+     */
+    constructor(namespaces, girFiles = []) {
+        this.namespaces = namespaces;
+        this.girFiles = girFiles;
+        this.entityIndex = new Map();
+        for (const namespace of namespaces.values()) {
+            indexNamespace(this.entityIndex, namespace);
+        }
+    }
+    /**
+     * Looks up a type by `(namespace, name)`. Aliases are followed one step
+     * to their target. Returns `undefined` when neither the namespace nor a
+     * matching entity exists.
+     *
+     * @param namespaceName - Namespace to look in (e.g. `"GLib"`)
+     * @param typeName - Local type name within the namespace (e.g. `"Variant"`)
+     */
+    resolveNamed(namespaceName, typeName) {
+        const key = entityKey(namespaceName, typeName);
+        const direct = this.entityIndex.get(key);
+        if (direct !== undefined)
+            return direct;
+        return undefined;
+    }
+}
+const entityKey = (namespaceName, typeName) => `${namespaceName}.${typeName}`;
+const indexNamespace = (index, namespace) => {
+    for (const value of namespace.classes) {
+        index.set(entityKey(namespace.name, value.name), { kind: "class", namespace, value });
+    }
+    for (const value of namespace.interfaces) {
+        index.set(entityKey(namespace.name, value.name), { kind: "interface", namespace, value });
+    }
+    for (const value of namespace.boxeds) {
+        index.set(entityKey(namespace.name, value.name), { kind: "boxed", namespace, value });
+    }
+    for (const value of namespace.enums) {
+        index.set(entityKey(namespace.name, value.name), { kind: "enum", namespace, value });
+    }
+    for (const value of namespace.callbacks) {
+        index.set(entityKey(namespace.name, value.name), { kind: "callback", namespace, value });
+    }
+    for (const alias of namespace.aliases) {
+        const target = alias.target?.kind === "named" ? alias.target.typeName : undefined;
+        index.set(entityKey(namespace.name, alias.name), {
+            kind: "alias",
+            namespace,
+            target,
+            targetRef: alias.target,
+        });
+    }
+};
+/**
+ * Discovers and parses every GIR file needed to satisfy `libraries` and
+ * their transitive `<include>` dependencies.
+ *
+ * @param libraries - Resolved `Name-Version` namespace identifiers
+ * @param girPath - Ordered list of directories to search for `.gir` files
+ * @returns A populated {@link GirRepository}
+ * @throws If any required GIR file cannot be located on `girPath`
+ */
+export const loadGirRepository = (libraries, girPath) => {
+    const namespaces = new Map();
+    const girFiles = [];
+    const queue = [...libraries];
+    while (queue.length > 0) {
+        const identifier = queue.shift();
+        if (identifier === undefined)
+            continue;
+        const namespaceName = identifier.split("-")[0] ?? identifier;
+        if (namespaces.has(namespaceName))
+            continue;
+        const path = locateGirFile(identifier, girPath);
+        girFiles.push(path);
+        const root = parseGirFile(path);
+        const repository = root.repository;
+        if (typeof repository !== "object" || repository === null) {
+            throw new Error(`GIR file at ${path} has no <repository> root`);
+        }
+        const namespace = namespaceFromRepository(repository);
+        namespaces.set(namespace.name, namespace);
+        for (const include of namespace.includes) {
+            queue.push(`${include.name}-${include.version}`);
+        }
+    }
+    return new GirRepository(namespaces, girFiles);
+};
+const locateGirFile = (identifier, girPath) => {
+    const filename = `${identifier}.gir`;
+    for (const directory of girPath) {
+        const candidate = join(directory, filename);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    const tried = girPath.map((directory) => join(directory, filename)).join(", ");
+    throw new Error(`GIR file ${filename} not found on girPath. Tried: ${tried}`);
+};
+//# sourceMappingURL=repository.js.map

package/dist/gir/repository.js.map

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

package/dist/gir/signal.d.ts

@@ -0,0 +1,22 @@
+import { type GirParameter, type GirReturnValue } from "./parameter.js";
+import { type RawNode } from "./parse.js";
+/** Emission stage (`<glib:signal when="…">`). */
+type SignalWhen = "first" | "last" | "cleanup";
+/** A GObject `<glib:signal>` declaration. */
+export type GirSignal = {
+    /** GIR signal name, kebab-case (e.g. `"activate-link"`). */
+    readonly name: string;
+    readonly parameters: readonly GirParameter[];
+    readonly returnValue: GirReturnValue;
+    readonly when: SignalWhen;
+    readonly detailed: boolean;
+    readonly action: boolean;
+    readonly noRecurse: boolean;
+    readonly noHooks: boolean;
+};
+/**
+ * Builds a {@link GirSignal} from a `<glib:signal>` element.
+ */
+export declare const signalFromNode: (node: RawNode) => GirSignal;
+export {};
+//# sourceMappingURL=signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/gir/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAA0C,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/E,iDAAiD;AACjD,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,KAAG,SAa9C,CAAC"}