@gtkx/codegen 0.21.0

package/dist/react/props.js

@@ -0,0 +1,231 @@
+import { toCamelCase, toIdentifier, toPascalCase } from "@gtkx/utils";
+import { isInoutParameter, isOutParameter } from "../gir/parameter.js";
+import { resolveQualifiedClass, splitQualifiedName } from "../gir/qualified-name.js";
+import { qualifyTypeRef } from "../gir/qualify.js";
+import { renderBaseTypeFor } from "../writers/ts-type.js";
+import { isScalarRef } from "../writers/value.js";
+import { signalHandlerName } from "./widgets.js";
+/**
+ * Builds a typed prop bag for one widget intrinsic.
+ *
+ * Combines the widget's own properties + signal handlers with those declared
+ * by its directly-implemented interfaces and by every non-widget ancestor up
+ * to the first widget parent (whose props are inherited via `extends`).
+ * Property types are written as TypeScript surface types resolved against the
+ * loaded GIR repository.
+ *
+ * @param options - {@link WidgetPropsOptions}
+ */
+export const buildWidgetPropsEntries = (options) => {
+    const { repository, klass, slotPropNames = new Set(), isWidgetAncestor = () => false } = options;
+    const imports = new Map();
+    const propEntries = [];
+    const seen = new Set();
+    const ownerName = klass.glibTypeName ?? klass.cType ?? klass.name;
+    const selfNamespace = currentNamespaceKey(repository, klass);
+    const selfTypeName = resolveSelfTypeName(klass, selfNamespace, imports);
+    const acceptProperty = (property, owningNamespace) => {
+        const jsName = toIdentifier(toCamelCase(property.name));
+        if (seen.has(jsName))
+            return;
+        seen.add(jsName);
+        if (isPropOverridden(ownerName, jsName))
+            return;
+        if (slotPropNames.has(jsName)) {
+            propEntries.push(`${jsName}?: ReactNode | null;`);
+            return;
+        }
+        const qualified = qualifyTypeRef(property.type, owningNamespace);
+        const tsType = renderReactPropType(repository, qualified, true, imports);
+        propEntries.push(`${jsName}?: ${tsType} | null;`);
+    };
+    const acceptSignal = (signal, owningNamespace) => {
+        const handlerName = signalHandlerName(signal.name);
+        if (seen.has(handlerName))
+            return;
+        seen.add(handlerName);
+        if (isSignalOverridden(ownerName, handlerName))
+            return;
+        const signature = renderSignalHandler({
+            repository,
+            signal,
+            imports,
+            selfType: selfTypeName,
+            owningNamespace,
+        });
+        propEntries.push(`${handlerName}?: ${signature};`);
+    };
+    visitClassAndAncestors({ repository, klass, selfNamespace, isWidgetAncestor }, acceptProperty, acceptSignal);
+    return { propLines: propEntries, imports };
+};
+const resolveSelfTypeName = (klass, selfNamespace, imports) => {
+    if (selfNamespace === "?")
+        return toPascalCase(klass.name);
+    imports.set(selfNamespace, selfNamespace);
+    return `${selfNamespace}.${toPascalCase(klass.name)}`;
+};
+const visitClassAndAncestors = (walk, acceptProperty, acceptSignal) => {
+    const visit = (current, owningNamespace) => {
+        for (const property of current.properties)
+            acceptProperty(property, owningNamespace);
+        for (const signal of current.signals)
+            acceptSignal(signal, owningNamespace);
+        for (const implementsName of current.implements) {
+            const resolved = resolveInterface(walk.repository, current, implementsName);
+            if (resolved === undefined)
+                continue;
+            for (const property of resolved.value.properties)
+                acceptProperty(property, resolved.namespace.name);
+            for (const signal of resolved.value.signals)
+                acceptSignal(signal, resolved.namespace.name);
+        }
+    };
+    visit(walk.klass, walk.selfNamespace);
+    const visited = new Set([`${walk.selfNamespace}.${walk.klass.name}`]);
+    let parentRef = resolveParent(walk.repository, walk.klass, walk.selfNamespace);
+    while (parentRef !== undefined && !walk.isWidgetAncestor(parentRef.klass)) {
+        const key = `${parentRef.namespaceName}.${parentRef.klass.name}`;
+        if (visited.has(key))
+            break;
+        visited.add(key);
+        visit(parentRef.klass, parentRef.namespaceName);
+        parentRef = resolveParent(walk.repository, parentRef.klass, parentRef.namespaceName);
+    }
+};
+const resolveParent = (repository, klass, defaultNamespace) => {
+    if (klass.parent === undefined)
+        return undefined;
+    return resolveQualifiedClass(repository, klass.parent, defaultNamespace);
+};
+const currentNamespaceKey = (repository, klass) => {
+    for (const namespace of repository.namespaces.values()) {
+        if (namespace.classes.includes(klass) || namespace.interfaces.includes(klass)) {
+            return namespace.name;
+        }
+    }
+    return "?";
+};
+const resolveInterface = (repository, declaringClass, implementsName) => {
+    const { namespaceName, typeName } = splitQualifiedName(implementsName, currentNamespaceKey(repository, declaringClass));
+    const resolved = repository.resolveNamed(namespaceName, typeName);
+    if (resolved === undefined)
+        return undefined;
+    if (resolved.kind !== "interface")
+        return undefined;
+    return { namespace: resolved.namespace, value: resolved.value };
+};
+/**
+ * Per-widget prop names that the React package re-types in a hand-written
+ * `declare module` augmentation. Skipping them in the generated bag
+ * prevents TS2717 "subsequent property declarations must have the same
+ * type" when the augmentation widens the GIR property to a declarative
+ * React shape (e.g. an array of child-props instead of a raw GObject
+ * model).
+ *
+ * Entries are matched against the widget's GLib type name (e.g.
+ * `"AdwToggleGroup"`); values are the JS prop names to skip.
+ */
+const PROP_OVERRIDES_BY_WIDGET = {
+    AdwToggleGroup: new Set(["toggles"]),
+    AdwAlertDialog: new Set(["responses"]),
+    GtkColumnView: new Set(["columns"]),
+    GtkScale: new Set(["marks"]),
+};
+const isPropOverridden = (ownerName, propName) => {
+    const overrides = PROP_OVERRIDES_BY_WIDGET[ownerName];
+    return overrides?.has(propName) ?? false;
+};
+/**
+ * Per-widget signal-handler names whose generated emission is skipped so
+ * a hand-written `declare module` augmentation can supply a refined
+ * signature without triggering TS2717.
+ */
+const SIGNAL_OVERRIDES_BY_WIDGET = {
+    GtkRange: new Set(["onValueChanged"]),
+    GtkScale: new Set(["onValueChanged"]),
+    GtkScaleButton: new Set(["onValueChanged"]),
+    GtkSpinButton: new Set(["onValueChanged"]),
+    AdwSpinRow: new Set(["onValueChanged"]),
+    AdwSwitchRow: new Set(["onActivated"]),
+};
+const isSignalOverridden = (ownerName, handlerName) => {
+    const overrides = SIGNAL_OVERRIDES_BY_WIDGET[ownerName];
+    return overrides?.has(handlerName) ?? false;
+};
+const renderSignalHandler = (options) => {
+    const { repository, signal, imports, selfType, owningNamespace } = options;
+    const visible = signal.parameters.filter((parameter) => !parameter.isVarargs);
+    const params = visible
+        .filter((parameter) => !isOutParameter(parameter))
+        .map((parameter, index) => {
+        const name = parameter.name.length === 0 ? `arg${index + 1}` : toIdentifier(toCamelCase(parameter.name));
+        const qualified = qualifyTypeRef(parameter.type, owningNamespace);
+        const baseType = renderReactPropType(repository, qualified, false, imports);
+        return `${name}: ${baseType}`;
+    });
+    params.push(`self: ${selfType}`);
+    return `(${params.join(", ")}) => ${renderSignalReturnType(options, visible)}`;
+};
+/**
+ * Computes a signal handler's return type.
+ *
+ * Pure out-parameters (`direction="out"`, not caller-allocated) are surfaced
+ * through the return value as a tuple `[primary, ...outs]`, mirroring the
+ * convention {@link renderMethodReturnType} produces for methods: a value return
+ * with no outs stays scalar (with `| void` so handlers may opt out); a void
+ * return with a single out unwraps to that out's type; otherwise the primary
+ * (when present) leads a tuple of the out types.
+ *
+ * @param options - The signal render options
+ * @param visible - The signal's non-varargs parameters
+ */
+const renderSignalReturnType = (options, visible) => {
+    const { repository, signal, imports, owningNamespace } = options;
+    const qualifiedReturn = qualifyTypeRef(signal.returnValue.type, owningNamespace);
+    const baseReturn = renderReactPropType(repository, qualifiedReturn, signal.returnValue.nullable, imports);
+    const outTypes = visible
+        .filter((parameter) => isOutParameter(parameter) ||
+        (isInoutParameter(parameter) && isScalarRef(repository, owningNamespace, parameter.type)))
+        .map((parameter) => renderReactPropType(repository, qualifyTypeRef(parameter.type, owningNamespace), false, imports));
+    if (outTypes.length === 0) {
+        return baseReturn === "void" ? "void" : `${baseReturn} | void`;
+    }
+    if (baseReturn !== "void") {
+        return `[${baseReturn}, ${outTypes.join(", ")}]`;
+    }
+    const [single, ...rest] = outTypes;
+    if (rest.length === 0 && single !== undefined)
+        return single;
+    return `[${outTypes.join(", ")}]`;
+};
+const reactTarget = (repository, imports) => ({
+    containerStyle: "record",
+    callbackType: "(...args: unknown[]) => unknown",
+    byteArrayAsNumber: false,
+    renderNamed: (ref) => namedTsType(repository, ref, imports),
+});
+const renderReactPropType = (repository, ref, isNullable, imports) => {
+    const base = renderBaseTypeFor(reactTarget(repository, imports), ref);
+    return isNullable ? `${base} | null` : base;
+};
+const namedTsType = (repository, ref, imports) => {
+    const namespaceName = ref.namespaceName;
+    if (namespaceName === undefined) {
+        return ref.typeName;
+    }
+    const resolved = repository.resolveNamed(namespaceName, ref.typeName);
+    if (resolved === undefined) {
+        imports.set(namespaceName, namespaceName);
+        return `${namespaceName}.${ref.typeName}`;
+    }
+    if (resolved.kind === "callback")
+        return "(...args: unknown[]) => unknown";
+    if (resolved.kind === "alias") {
+        if (resolved.target === undefined)
+            return "number";
+        return namedTsType(repository, { kind: "named", namespaceName: resolved.namespace.name, typeName: resolved.target, cType: undefined }, imports);
+    }
+    imports.set(namespaceName, namespaceName);
+    return `${namespaceName}.${ref.typeName}`;
+};
+//# sourceMappingURL=props.js.map

package/dist/react/props.js.map

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

package/dist/react/slot-props.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Merges built-in slot props with the user-supplied `slotProps` map.
+ *
+ * Per JSX element name, the resulting list is the union of both sources
+ * with duplicates removed and a stable alphabetical sort.
+ *
+ * @param userSlotProps - The user-provided `slotProps` map, or `undefined`
+ */
+export declare const mergeSlotProps: (userSlotProps: Readonly<Record<string, readonly string[]>> | undefined) => Readonly<Record<string, readonly string[]>>;
+//# sourceMappingURL=slot-props.d.ts.map

package/dist/react/slot-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-props.d.ts","sourceRoot":"","sources":["../../src/react/slot-props.ts"],"names":[],"mappings":"AAiCA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACvB,eAAe,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,KACvE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAa5C,CAAC"}

package/dist/react/slot-props.js

@@ -0,0 +1,56 @@
+/**
+ * Built-in widget-typed properties that should be exposed as JSX child
+ * slots (typed as `ReactNode`) rather than as raw widget refs.
+ *
+ * The keys are JSX element names (i.e. GLib type names such as
+ * `"AdwWindow"`, `"GtkHeaderBar"`); the values are the camelCase property
+ * names that should be promoted. User-supplied `slotProps` from
+ * `gtkx.config.ts` merge into this map.
+ */
+const BUILT_IN_SLOT_PROPS = Object.freeze({
+    GtkWindow: ["titlebar"],
+    AdwWindow: ["content"],
+    AdwApplicationWindow: ["content"],
+    AdwAlertDialog: ["extraChild"],
+    AdwBottomSheet: ["bottomBar", "content", "sheet"],
+    GtkCenterBox: ["centerWidget", "endWidget", "startWidget"],
+    GtkExpander: ["labelWidget"],
+    AdwFlap: ["content", "flap", "separator"],
+    GtkFrame: ["labelWidget"],
+    GtkHeaderBar: ["titleWidget"],
+    AdwHeaderBar: ["titleWidget"],
+    GtkMenuButton: ["popover"],
+    AdwMessageDialog: ["extraChild"],
+    AdwNavigationSplitView: ["content", "sidebar"],
+    AdwOverlaySplitView: ["content", "sidebar"],
+    GtkPaned: ["endChild", "startChild"],
+    AdwPreferencesGroup: ["headerSuffix"],
+    AdwPreferencesPage: ["banner"],
+    AdwSplitButton: ["popover"],
+    AdwTabBar: ["endActionWidget", "startActionWidget"],
+    AdwToolbarView: ["content"],
+});
+/**
+ * Merges built-in slot props with the user-supplied `slotProps` map.
+ *
+ * Per JSX element name, the resulting list is the union of both sources
+ * with duplicates removed and a stable alphabetical sort.
+ *
+ * @param userSlotProps - The user-provided `slotProps` map, or `undefined`
+ */
+export const mergeSlotProps = (userSlotProps) => {
+    const result = {};
+    for (const [key, values] of Object.entries(BUILT_IN_SLOT_PROPS)) {
+        result[key] = [...values];
+    }
+    if (userSlotProps !== undefined) {
+        for (const [key, values] of Object.entries(userSlotProps)) {
+            const merged = new Set(result[key] ?? []);
+            for (const value of values)
+                merged.add(value);
+            result[key] = [...merged].sort((a, b) => a.localeCompare(b));
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=slot-props.js.map

package/dist/react/slot-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-props.js","sourceRoot":"","sources":["../../src/react/slot-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAgD,MAAM,CAAC,MAAM,CAAC;IACnF,SAAS,EAAE,CAAC,UAAU,CAAC;IACvB,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,oBAAoB,EAAE,CAAC,SAAS,CAAC;IACjC,cAAc,EAAE,CAAC,YAAY,CAAC;IAC9B,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;IACjD,YAAY,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,aAAa,CAAC;IAC1D,WAAW,EAAE,CAAC,aAAa,CAAC;IAC5B,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC;IACzC,QAAQ,EAAE,CAAC,aAAa,CAAC;IACzB,YAAY,EAAE,CAAC,aAAa,CAAC;IAC7B,YAAY,EAAE,CAAC,aAAa,CAAC;IAC7B,aAAa,EAAE,CAAC,SAAS,CAAC;IAC1B,gBAAgB,EAAE,CAAC,YAAY,CAAC;IAChC,sBAAsB,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9C,mBAAmB,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC3C,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IACpC,mBAAmB,EAAE,CAAC,cAAc,CAAC;IACrC,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,cAAc,EAAE,CAAC,SAAS,CAAC;IAC3B,SAAS,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IACnD,cAAc,EAAE,CAAC,SAAS,CAAC;CAC9B,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC1B,aAAsE,EAC3B,EAAE;IAC7C,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/react/widgets.d.ts

@@ -0,0 +1,83 @@
+import type { GirClass } from "../gir/class.js";
+import type { GirNamespace } from "../gir/namespace.js";
+import type { GirRepository } from "../gir/repository.js";
+/**
+ * Maps a kebab-case signal name to its `on`-prefixed camelCase handler prop
+ * name (e.g. `value-changed` → `onValueChanged`).
+ *
+ * @param signalName - The GIR signal name
+ */
+export declare const signalHandlerName: (signalName: string) => string;
+/** A class qualified by its declaring namespace and the GLib type name it exposes. */
+export type WidgetCandidate = {
+    readonly glibName: string;
+    readonly klass: GirClass;
+    readonly namespace: GirNamespace;
+};
+/**
+ * Iterates every `(class, namespace, glibName)` triple in the repository whose
+ * `glib:type-name` (or C type fallback) is defined.
+ *
+ * The order follows GIR file order within a namespace and `namespaces` map
+ * iteration order between namespaces; callers that need stable output should
+ * sort the result themselves.
+ *
+ * @param repository - The repository to walk
+ */
+export declare function iterateClassesWithGlibName(repository: GirRepository): IterableIterator<WidgetCandidate>;
+/** A resolved interface qualified by the namespace that declares it. */
+export type ResolvedQualifiedInterface = {
+    readonly klass: GirClass;
+    readonly namespace: GirNamespace;
+};
+/**
+ * Resolves every interface a class implements, including the transitive
+ * prerequisite interfaces of those interfaces, nearest first.
+ *
+ * Interfaces never appear in the GObject type-parent chain, so the React
+ * runtime cannot reach an interface's signals or properties by walking a
+ * widget's ancestors. Each implementing class must therefore carry its
+ * interfaces' metadata directly. Prerequisite interfaces (e.g. a
+ * `Gtk.SelectionModel`'s `Gio.ListModel`) are folded in transitively; class
+ * prerequisites are ignored because their metadata is reachable through the
+ * type-parent chain.
+ *
+ * @param klass - The class whose interfaces to resolve
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace lookups
+ */
+export declare const implementedInterfaces: (klass: GirClass, namespace: GirNamespace, repository: GirRepository) => readonly ResolvedQualifiedInterface[];
+/**
+ * Returns the GLib type names of a class and every ancestor it descends from,
+ * nearest first. Used to let a subclass inherit slot-prop declarations made on
+ * its ancestors.
+ *
+ * @param klass - The class to start from
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export declare const ancestorGlibNames: (klass: GirClass, namespace: GirNamespace, repository: GirRepository) => readonly string[];
+/**
+ * Decides whether a `<class>` is a "widget" for the React reconciler — a
+ * descendant (direct or transitive) of `GtkWidget`.
+ *
+ * Walks the parent chain across namespaces. Returns `false` if any
+ * ancestor cannot be resolved (which is preferable to silently treating
+ * an unknown type as a widget).
+ *
+ * @param klass - The class to inspect
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export declare const isWidgetClass: (klass: GirClass, namespace: GirNamespace, repository: GirRepository) => boolean;
+/**
+ * Decides whether a `<class>` is any React reconciler node — a widget or one
+ * of the auxiliary node kinds. This is the set of classes that need generated
+ * prop, signal, and construct-only metadata.
+ *
+ * @param klass - The class to inspect
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export declare const isReactNodeClass: (klass: GirClass, namespace: GirNamespace, repository: GirRepository) => boolean;
+//# sourceMappingURL=widgets.d.ts.map

package/dist/react/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/react/widgets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,MACO,CAAC;AAE/D,sFAAsF;AACtF,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAiB,0BAA0B,CAAC,UAAU,EAAE,aAAa,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAQxG;AAaD,wEAAwE;AACxE,MAAM,MAAM,0BAA0B,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC;AAExG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,GAC9B,OAAO,QAAQ,EACf,WAAW,YAAY,EACvB,YAAY,aAAa,KAC1B,SAAS,0BAA0B,EAiBrC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC1B,OAAO,QAAQ,EACf,WAAW,YAAY,EACvB,YAAY,aAAa,KAC1B,SAAS,MAAM,EAcjB,CAAC;AAsBF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,QAAQ,EAAE,WAAW,YAAY,EAAE,YAAY,aAAa,KAAG,OACd,CAAC;AAiBvF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,EAAE,WAAW,YAAY,EAAE,YAAY,aAAa,KAAG,OACF,CAAC"}

package/dist/react/widgets.js

@@ -0,0 +1,152 @@
+import { toCamelCase, toIdentifier, toUpperFirst } from "@gtkx/utils";
+import { splitQualifiedName } from "../gir/qualified-name.js";
+/**
+ * Maps a kebab-case signal name to its `on`-prefixed camelCase handler prop
+ * name (e.g. `value-changed` → `onValueChanged`).
+ *
+ * @param signalName - The GIR signal name
+ */
+export const signalHandlerName = (signalName) => `on${toUpperFirst(toIdentifier(toCamelCase(signalName)))}`;
+/**
+ * Iterates every `(class, namespace, glibName)` triple in the repository whose
+ * `glib:type-name` (or C type fallback) is defined.
+ *
+ * The order follows GIR file order within a namespace and `namespaces` map
+ * iteration order between namespaces; callers that need stable output should
+ * sort the result themselves.
+ *
+ * @param repository - The repository to walk
+ */
+export function* iterateClassesWithGlibName(repository) {
+    for (const namespace of repository.namespaces.values()) {
+        for (const klass of namespace.classes) {
+            const glibName = klass.glibTypeName ?? klass.cType;
+            if (glibName === undefined)
+                continue;
+            yield { glibName, klass, namespace };
+        }
+    }
+}
+const resolveParentClass = (repository, parent, namespace) => {
+    const { namespaceName, typeName } = splitQualifiedName(parent, namespace.name);
+    const resolved = repository.resolveNamed(namespaceName, typeName);
+    if (resolved === undefined || (resolved.kind !== "class" && resolved.kind !== "interface"))
+        return undefined;
+    return { klass: resolved.value, namespace: resolved.namespace };
+};
+/**
+ * Resolves every interface a class implements, including the transitive
+ * prerequisite interfaces of those interfaces, nearest first.
+ *
+ * Interfaces never appear in the GObject type-parent chain, so the React
+ * runtime cannot reach an interface's signals or properties by walking a
+ * widget's ancestors. Each implementing class must therefore carry its
+ * interfaces' metadata directly. Prerequisite interfaces (e.g. a
+ * `Gtk.SelectionModel`'s `Gio.ListModel`) are folded in transitively; class
+ * prerequisites are ignored because their metadata is reachable through the
+ * type-parent chain.
+ *
+ * @param klass - The class whose interfaces to resolve
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace lookups
+ */
+export const implementedInterfaces = (klass, namespace, repository) => {
+    const result = [];
+    const visited = new Set();
+    const visit = (names, fromNamespace) => {
+        for (const name of names) {
+            const { namespaceName, typeName } = splitQualifiedName(name, fromNamespace.name);
+            const resolved = repository.resolveNamed(namespaceName, typeName);
+            if (resolved === undefined || resolved.kind !== "interface")
+                continue;
+            const key = `${resolved.namespace.name}.${resolved.value.name}`;
+            if (visited.has(key))
+                continue;
+            visited.add(key);
+            result.push({ klass: resolved.value, namespace: resolved.namespace });
+            visit(resolved.value.prerequisites, resolved.namespace);
+        }
+    };
+    visit(klass.implements, namespace);
+    return result;
+};
+/**
+ * Returns the GLib type names of a class and every ancestor it descends from,
+ * nearest first. Used to let a subclass inherit slot-prop declarations made on
+ * its ancestors.
+ *
+ * @param klass - The class to start from
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export const ancestorGlibNames = (klass, namespace, repository) => {
+    const names = [];
+    let currentClass = klass;
+    let currentNamespace = namespace;
+    while (currentClass !== undefined && currentNamespace !== undefined) {
+        const glibName = currentClass.glibTypeName ?? currentClass.cType;
+        if (glibName !== undefined)
+            names.push(glibName);
+        if (currentClass.parent === undefined)
+            break;
+        const next = resolveParentClass(repository, currentClass.parent, currentNamespace);
+        if (next === undefined)
+            break;
+        currentClass = next.klass;
+        currentNamespace = next.namespace;
+    }
+    return names;
+};
+const descendsFrom = (klass, namespace, repository, matches) => {
+    let currentClass = klass;
+    let currentNamespace = namespace;
+    while (currentClass !== undefined && currentNamespace !== undefined) {
+        const glibName = currentClass.glibTypeName ?? currentClass.cType ?? "";
+        if (matches(glibName))
+            return true;
+        if (currentClass.parent === undefined)
+            return false;
+        const next = resolveParentClass(repository, currentClass.parent, currentNamespace);
+        if (next === undefined)
+            return false;
+        currentClass = next.klass;
+        currentNamespace = next.namespace;
+    }
+    return false;
+};
+/**
+ * Decides whether a `<class>` is a "widget" for the React reconciler — a
+ * descendant (direct or transitive) of `GtkWidget`.
+ *
+ * Walks the parent chain across namespaces. Returns `false` if any
+ * ancestor cannot be resolved (which is preferable to silently treating
+ * an unknown type as a widget).
+ *
+ * @param klass - The class to inspect
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export const isWidgetClass = (klass, namespace, repository) => descendsFrom(klass, namespace, repository, (glibName) => glibName === "GtkWidget");
+const AUXILIARY_BASE_TYPES = new Set(["GtkEventController", "GtkGesture", "GtkLayoutManager"]);
+/**
+ * Decides whether a `<class>` is a non-widget React reconciler node — an event
+ * controller, gesture, or layout manager (direct or transitive descendant of
+ * `GtkEventController`, `GtkGesture`, or `GtkLayoutManager`). These are JSX
+ * elements that need the same prop/signal metadata as widgets.
+ *
+ * @param klass - The class to inspect
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+const isAuxiliaryReactType = (klass, namespace, repository) => descendsFrom(klass, namespace, repository, (glibName) => AUXILIARY_BASE_TYPES.has(glibName));
+/**
+ * Decides whether a `<class>` is any React reconciler node — a widget or one
+ * of the auxiliary node kinds. This is the set of classes that need generated
+ * prop, signal, and construct-only metadata.
+ *
+ * @param klass - The class to inspect
+ * @param namespace - The namespace the class lives in
+ * @param repository - The repository for cross-namespace parent lookups
+ */
+export const isReactNodeClass = (klass, namespace, repository) => isWidgetClass(klass, namespace, repository) || isAuxiliaryReactType(klass, namespace, repository);
+//# sourceMappingURL=widgets.js.map

package/dist/react/widgets.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,55 @@
+import { type GiStoreOptions } from "./gi-store.js";
+import { type JsxStoreOptions } from "./jsx-store.js";
+/**
+ * Options for {@link CodegenRunner}.
+ */
+export type CodegenRunnerOptions = {
+    /** Resolved `Name-Version` namespace identifiers to generate. */
+    readonly libraries: readonly string[];
+    /** Directories searched for `.gir` files. */
+    readonly girPath: readonly string[];
+    /** Optional user slot-prop overrides keyed by JSX element name. */
+    readonly slotProps?: Readonly<Record<string, readonly string[]>>;
+    /** Target for the injected `@gtkx/gi` bindings package. */
+    readonly gi: GiStoreOptions;
+    /** Target for the injected `@gtkx/react-jsx` unit; React is skipped when omitted. */
+    readonly jsx?: JsxStoreOptions;
+};
+/**
+ * Result returned from {@link CodegenRunner.run}.
+ */
+export type CodegenRunnerResult = {
+    /** Number of FFI namespaces produced. */
+    readonly namespaces: number;
+    /** Number of widget intrinsics emitted into `jsx.ts`. */
+    readonly widgets: number;
+    /** Wall-clock duration in milliseconds. */
+    readonly duration: number;
+};
+/**
+ * Single-entry orchestrator for the GTKX codegen.
+ *
+ * Loads the GIR repository, runs the FFI pipeline per namespace, runs the
+ * React pipeline once, and materializes the self-contained `@gtkx/gi` (and
+ * optional `@gtkx/react-jsx`) packages into the project's `node_modules`.
+ *
+ * @example
+ * ```ts
+ * import { CodegenRunner } from "@gtkx/codegen";
+ *
+ * await new CodegenRunner({
+ *     libraries: ["Gtk-4.0", "Adw-1"],
+ *     girPath: ["/usr/share/gir-1.0"],
+ *     gi: { storeDir, linkDir, realFfiDir, realNativeDir, version },
+ * }).run();
+ * ```
+ */
+export declare class CodegenRunner {
+    private readonly options;
+    constructor(options: CodegenRunnerOptions);
+    /**
+     * Executes the full codegen pipeline and materializes the output packages.
+     */
+    run(): Promise<CodegenRunnerResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,cAAc,EAAgB,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA6B5C"}