@gtkx/codegen 1.0.0-rc.3 → 1.0.0

package/dist/store/gi/vtable.js

@@ -1,19 +1,36 @@
-import { pascalCase, sourceStringLiteral, toCamelIdentifier } from "@gtkx/utils";
+import { pascalCase, sourceStringLiteral } from "@gtkx/utils";
 import { isInlineCallbackRef, isScalarRef, renderDescriptor, renderParamDescriptor, } from "../../analysis/descriptor-render.js";
-import { renderBraced } from "../../writer/emit.js";
+import { foldedLengthParameters, handlerParameters, parameterIdentifier, renamesWithInstance, renderHandlerParameters, renderHandlerResultType, } from "../../analysis/param-structure.js";
+import { renderTsType } from "../../analysis/ts-type.js";
+import { ancestorChain, resolveInterfaces } from "../../gir/ancestry.js";
+import { renderJsDoc } from "../../writer/doc.js";
+import { renderBlock, renderBraced } from "../../writer/emit.js";
+import { handlerSpec, THROWS_TEXT } from "./doc-spec.js";
 import { computeRecordFieldSlots } from "./record-layout.js";
-const renderVfuncMetadata = (context, klass) => {
-    if (klass.glibTypeStruct === undefined) {
-        return undefined;
-    }
-    const structName = pascalCase(klass.glibTypeStruct);
-    const kind = klass.isInterface ? "interface" : "class";
-    const entries = vtableEntries(context, structName, kind, klass.glibTypeStruct);
-    if (entries.length === 0) {
-        return undefined;
-    }
-    return renderBraced(entries.join("\n"));
-};
+const PADDING_FIELD_NAME = /^(?:reserved|padding)\d*$/i;
+const UNCALLABLE_SLOT_KEYS = new Set([
+    "vfuncDispose",
+    "vfuncFinalize",
+    "vfuncGetProperty",
+    "vfuncSetProperty",
+]);
+const PROTECTED_SLOT_NOTE = "It is `protected`, so only a subclass chaining up reaches it.";
+const PUBLIC_SLOT_NOTE = "Calling it from anywhere else re-enters the slot on a live instance.";
+const vfuncMemberName = (fieldName) => `vfunc${pascalCase(fieldName)}`;
+const vfuncOverrideNote = (slot, isProtected) => [
+    `Invokes the \`${slot.field.name}\` vtable slot. Override it on a class passed to \`registerClass\``,
+    `and chain up with \`super.${slot.key}()\`.`,
+    isProtected ? PROTECTED_SLOT_NOTE : PUBLIC_SLOT_NOTE,
+].join("\n");
+const vfuncRequirementNote = (slot, ownerRef) => [
+    `Fills the \`${slot.field.name}\` vtable slot. Declare it on a class passed to \`registerClass\``,
+    `with \`${ownerRef}\` in \`implements\`, which installs it in the interface vtable. Leaving it out`,
+    "keeps whatever the interface installs by default, the way it does for a C implementer.",
+].join("\n");
+const vfuncMemberNote = (options) => options.mode === "requirement"
+    ? vfuncRequirementNote(options.slot, options.ownerRef)
+    : vfuncOverrideNote(options.slot, options.isProtected);
+const isPaddingField = (field) => field.name.startsWith("_") || PADDING_FIELD_NAME.test(field.name);
 const vtableCallbackType = (context, field) => {
     if (field.type === undefined) {
         return undefined;
@@ -25,12 +42,15 @@ const vtableCallbackType = (context, field) => {
     return type.value;
 };
 const vtableSlotEntry = (context, field, claimedNames) => {
+    if (field.name === "constructor" || isPaddingField(field)) {
+        return undefined;
+    }
     const callback = vtableCallbackType(context, field);
     if (callback === undefined) {
         return undefined;
     }
-    const key = toCamelIdentifier(field.name);
-    if (key === "constructor" || claimedNames.has(key)) {
+    const key = vfuncMemberName(field.name);
+    if (claimedNames.has(key)) {
         return undefined;
     }
     if (!isVtableSlotEligible(context, callback)) {
@@ -38,42 +58,182 @@ const vtableSlotEntry = (context, field, claimedNames) => {
     }
     return { key, callback };
 };
-const vtableEntries = (context, structName, kind, typeStruct) => {
-    const resolved = context.library.resolveType(context.namespace.name, typeStruct);
-    if (resolved?.kind !== "record") {
-        return [];
-    }
-    const { slots, size } = computeRecordFieldSlots(context, resolved.value.fields, resolved.value.isUnion);
+const collectVtableSlots = (context, fields, isUnion) => {
+    const { slots, size } = computeRecordFieldSlots(context, fields, isUnion);
     const entries = [];
     const claimedNames = new Set();
     for (const { field, slot } of slots) {
         const entry = vtableSlotEntry(context, field, claimedNames);
-        if (entry === undefined) {
-            continue;
+        if (entry !== undefined) {
+            claimedNames.add(entry.key);
+            entries.push({ ...entry, field, vfunc: undefined, byteOffset: slot.byteOffset });
+        }
+    }
+    return { slots: entries, vtableSize: size };
+};
+const resolveVtableRecord = (context, namespaceName, klass) => {
+    const typeStruct = klass.glibTypeStruct;
+    const resolved = typeStruct === undefined ? undefined : context.library.resolveType(namespaceName, typeStruct);
+    if (typeStruct === undefined || resolved?.kind !== "record" || resolved.value.fields.length === 0) {
+        return undefined;
+    }
+    return { typeStruct, record: resolved.value };
+};
+const attachVirtualMethods = (slots, klass) => {
+    const byKey = new Map(klass.vfuncs.map((vfunc) => [vfuncMemberName(vfunc.name), vfunc]));
+    return slots.map((slot) => ({ ...slot, vfunc: byKey.get(slot.key) }));
+};
+const collectVtable = (context, namespaceName, klass) => {
+    const resolved = resolveVtableRecord(context, namespaceName, klass);
+    if (resolved === undefined) {
+        return undefined;
+    }
+    const { slots, vtableSize } = collectVtableSlots(context, resolved.record.fields, resolved.record.isUnion);
+    if (slots.length === 0) {
+        return undefined;
+    }
+    return {
+        structName: pascalCase(resolved.typeStruct),
+        kind: klass.isInterface ? "interface" : "class",
+        vtableSize,
+        slots: attachVirtualMethods(slots, klass),
+    };
+};
+const vfuncMemberNames = (context, namespaceName, klass) => collectVtable(context, namespaceName, klass)?.slots.map((slot) => slot.key) ?? [];
+const renderVfuncMetadata = (context, klass) => {
+    const vtable = collectVtable(context, context.namespace.name, klass);
+    if (vtable === undefined) {
+        return undefined;
+    }
+    const entries = vtable.slots.map((slot) => renderVtableSlotDescriptor(context, vtable, slot));
+    return renderBraced(entries.join("\n"));
+};
+const slotIdentity = (slot) => `${slot.key}:${String(slot.byteOffset)}`;
+const inheritedSlotIdentities = (context, namespaceName, klass) => {
+    const identities = new Set();
+    const [, ...ancestors] = [...ancestorChain(context.library, klass, namespaceName)];
+    for (const ancestor of ancestors) {
+        const vtable = collectVtable(context, ancestor.namespaceName, ancestor.klass);
+        const slots = vtable?.slots ?? [];
+        for (const slot of slots) {
+            identities.add(slotIdentity(slot));
         }
-        claimedNames.add(entry.key);
-        entries.push(renderVtableSlotDescriptor(context, {
-            key: entry.key,
-            structName,
-            kind,
-            field,
-            callback: entry.callback,
-            byteOffset: slot.byteOffset,
-            vtableSize: size,
-        }));
-    }
-    return entries;
-};
-const isUnsupportedOutParam = (context, param) => (param.direction === "out" || param.direction === "inout") &&
-    !param.callerAllocates &&
-    !isScalarRef(context.library, param.type);
+    }
+    return identities;
+};
+const addInterfaceSlotKeys = (context, iface, keys, seen) => {
+    const identity = `${iface.namespaceName}.${iface.klass.name}`;
+    if (seen.has(identity)) {
+        return;
+    }
+    seen.add(identity);
+    for (const key of vfuncMemberNames(context, iface.namespaceName, iface.klass)) {
+        keys.add(key);
+    }
+    for (const ref of resolveInterfaces(context.library, iface.namespaceName, iface.klass.prerequisites)) {
+        addInterfaceSlotKeys(context, ref, keys, seen);
+    }
+};
+const implementedSlotKeys = (context, namespaceName, klass) => {
+    const keys = new Set();
+    const seen = new Set();
+    for (const ancestor of ancestorChain(context.library, klass, namespaceName)) {
+        for (const ref of resolveInterfaces(context.library, ancestor.namespaceName, ancestor.klass.implements)) {
+            addInterfaceSlotKeys(context, ref, keys, seen);
+        }
+    }
+    return keys;
+};
+const protectedSlotKeys = (options, slots) => {
+    const { context, klass } = options;
+    if (klass.isInterface) {
+        return new Set();
+    }
+    const shared = implementedSlotKeys(context, context.namespace.name, klass);
+    return new Set(slots.map((slot) => slot.key).filter((key) => !shared.has(key)));
+};
+const callableVfuncSlots = (context, namespaceName, klass) => {
+    const vtable = collectVtable(context, namespaceName, klass);
+    if (vtable === undefined) {
+        return [];
+    }
+    const inherited = inheritedSlotIdentities(context, namespaceName, klass);
+    return vtable.slots.filter((slot) => isCallableSlot(context, slot) && !inherited.has(slotIdentity(slot)));
+};
+const hasCallableVfuncSlots = (context, namespaceName, klass) => callableVfuncSlots(context, namespaceName, klass).length > 0;
+const slotDoc = (slot) => slot.vfunc?.doc ?? slot.field.doc ?? slot.callback.doc;
+const slotDocParameters = (slot) => {
+    const [, ...parameters] = slot.callback.parameters;
+    const vfuncParameters = slot.vfunc?.parameters ?? [];
+    return parameters.map((parameter, index) => ({ ...parameter, doc: vfuncParameters[index]?.doc ?? parameter.doc }));
+};
+const slotDocSpec = (slot) => {
+    const parameters = slotDocParameters(slot);
+    const source = slot.vfunc ?? slot.callback;
+    return {
+        ...handlerSpec(source, parameters, renamesWithInstance(parameters, slot.callback.parameters[0])),
+        returns: slot.vfunc?.returnValue.doc ?? slot.callback.returnValue.doc,
+        throws: slot.callback.throws ? THROWS_TEXT : undefined,
+    };
+};
+const vfuncEntries = (context, namespaceName, klass) => callableVfuncSlots(context, namespaceName, klass).map((slot) => ({
+    name: slot.key,
+    signature: vfuncSlotSignature(context, slot).header,
+    doc: slotDoc(slot),
+}));
+const renderVfuncMembers = (options) => {
+    const { context, klass, mode } = options;
+    const ownerRef = pascalCase(klass.name);
+    const slots = callableVfuncSlots(context, context.namespace.name, klass);
+    if (slots.length === 0) {
+        return [];
+    }
+    if (mode === "implementation") {
+        context.addRuntimeImport("callVfunc");
+    }
+    const protectedKeys = protectedSlotKeys(options, slots);
+    return slots.map((slot) => renderVfuncMember({ context, ownerRef, slot, mode, isProtected: protectedKeys.has(slot.key) }));
+};
+const hasUnannotatedPointerParam = (context, slot) => {
+    const [, ...parameters] = slot.callback.parameters;
+    return parameters.some((parameter) => parameter.direction === "in" &&
+        parameter.cType?.endsWith("*") === true &&
+        isScalarRef(context.library, parameter.type));
+};
+const isCallableSlot = (context, slot) => !UNCALLABLE_SLOT_KEYS.has(slot.key) && !hasUnannotatedPointerParam(context, slot);
+const vfuncSlotSignature = (context, slot, isOptional = false) => {
+    const [, ...parameters] = slot.callback.parameters;
+    const renderType = (ref, isNullable) => renderTsType(context, ref, isNullable);
+    const signature = renderHandlerParameters(parameters, renderType).join(", ");
+    const folded = foldedLengthParameters(context.library, slot.callback);
+    const returnType = renderHandlerResultType({
+        library: context.library,
+        signal: { ...slot.callback, parameters },
+        renderType,
+        shouldIncludeCallerAllocated: true,
+        isOptOut: false,
+        shouldExcludeOut: (parameter) => folded.has(parameter),
+    });
+    return { header: `${slot.key}${isOptional ? "?" : ""}(${signature}): ${returnType}`, returnType };
+};
+const renderVfuncMember = (options) => {
+    const { context, ownerRef, slot, mode, isProtected } = options;
+    const { header, returnType } = vfuncSlotSignature(context, slot, mode === "requirement");
+    const declaration = `${isProtected ? "protected " : ""}${header}`;
+    const doc = renderJsDoc(slotDoc(slot), vfuncMemberNote(options), slotDocSpec(slot));
+    if (mode !== "implementation") {
+        return `${doc}${declaration};`;
+    }
+    const [, ...parameters] = slot.callback.parameters;
+    const inputs = handlerParameters(parameters).map((parameter, index) => parameterIdentifier(parameter, index));
+    const call = `callVfunc(${ownerRef}, ${sourceStringLiteral(slot.key)}, this, [${inputs.join(", ")}])`;
+    const body = returnType === "void" ? `${call};` : `return ${call} as ${returnType};`;
+    return `${doc}${renderBlock(declaration, body)}`;
+};
 const isEligibleVtableParam = (context, param) => {
     if (param.isVarargs) {
         return false;
     }
-    if (isUnsupportedOutParam(context, param)) {
-        return false;
-    }
     return !isInlineCallbackRef(context.library, param.type);
 };
 const isVtableSlotEligible = (context, callback) => {
@@ -87,22 +247,25 @@ const isVtableSlotEligible = (context, callback) => {
     }
     return !isInlineCallbackRef(context.library, callback.returnValue.type);
 };
-const renderVtableSlotDescriptor = (context, options) => {
-    const { key, structName, kind, field, callback, byteOffset, vtableSize } = options;
+const renderVtableSlotDescriptor = (context, vtable, slot) => {
+    const { key, field, callback, byteOffset } = slot;
     const argDescriptors = callback.parameters
         .map((param) => renderParamDescriptor(context, param, param.type))
         .join(", ");
     const returnDescriptor = renderDescriptor(context, callback.returnValue.type, callback.returnValue.transferOwnership);
     const lines = [
-        `kind: ${sourceStringLiteral(kind)} as const,`,
-        `className: ${sourceStringLiteral(structName)},`,
+        `className: ${sourceStringLiteral(vtable.structName)},`,
         `vfuncName: ${sourceStringLiteral(field.name)},`,
         `byteOffset: ${String(byteOffset)},`,
-        `vtableSize: ${String(vtableSize)},`,
-        `argDescriptors: [${argDescriptors}],`,
-        `returnDescriptor: ${returnDescriptor},`,
     ];
+    if (vtable.kind === "interface") {
+        lines.push(`vtableSize: ${String(vtable.vtableSize)},`);
+    }
+    lines.push(`argDescriptors: [${argDescriptors}],`, `returnDescriptor: ${returnDescriptor},`);
+    if (callback.throws) {
+        lines.push("canThrow: true,");
+    }
     return `${key}: ${renderBraced(lines.join("\n"))},`;
 };
-export { renderVfuncMetadata };
+export { hasCallableVfuncSlots, renderVfuncMembers, renderVfuncMetadata, vfuncEntries, vfuncMemberNames, };
 //# sourceMappingURL=vtable.js.map

package/dist/store/gi/vtable.js.map

@@ -1 +1 @@
-{"version":3,"file":"vtable.js","sourceRoot":"","sources":["../../../src/store/gi/vtable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMjF,OAAO,EACH,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAc7D,MAAM,mBAAmB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAsB,EAAE;IACxF,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACpD,MAAM,IAAI,GAAe,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAE/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAA2B,EAAE;IAC5F,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,IAAI,EAAE,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACjF,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACpB,OAAsB,EACtB,KAAe,EACf,YAAyB,EACyB,EAAE;IACpD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEpD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,GAAG,KAAK,aAAa,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,OAAsB,EAAE,UAAkB,EAAE,IAAgB,EAAE,UAAkB,EAAY,EAAE;IACjH,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEjF,IAAI,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxG,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE5C,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAE5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,SAAS;QACb,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5B,OAAO,CAAC,IAAI,CACR,0BAA0B,CAAC,OAAO,EAAE;YAChC,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,UAAU;YACV,IAAI;YACJ,KAAK;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI;SACnB,CAAC,CACL,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,OAAsB,EAAE,KAAmB,EAAW,EAAE,CACnF,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC;IAC1D,CAAC,KAAK,CAAC,eAAe;IACtB,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAE9C,MAAM,qBAAqB,GAAG,CAAC,OAAsB,EAAE,KAAmB,EAAW,EAAE;IACnF,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAsB,EAAE,QAAqB,EAAW,EAAE;IACpF,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,OAAsB,EAAE,OAA0C,EAAU,EAAE;IAC9G,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEnF,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU;SACrC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SACjE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhB,MAAM,gBAAgB,GAAG,gBAAgB,CACrC,OAAO,EACP,QAAQ,CAAC,WAAW,CAAC,IAAI,EACzB,QAAQ,CAAC,WAAW,CAAC,iBAAiB,CACzC,CAAC;IAEF,MAAM,KAAK,GAAG;QACV,SAAS,mBAAmB,CAAC,IAAI,CAAC,YAAY;QAC9C,cAAc,mBAAmB,CAAC,UAAU,CAAC,GAAG;QAChD,cAAc,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;QAChD,eAAe,MAAM,CAAC,UAAU,CAAC,GAAG;QACpC,eAAe,MAAM,CAAC,UAAU,CAAC,GAAG;QACpC,oBAAoB,cAAc,IAAI;QACtC,qBAAqB,gBAAgB,GAAG;KAC3C,CAAC;IAEF,OAAO,GAAG,GAAG,KAAK,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,CAAC","sourcesContent":["import { pascalCase, sourceStringLiteral, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirCallback } from \"../../gir/callback.js\";\nimport type { GirClass } from \"../../gir/class.js\";\nimport type { GirField } from \"../../gir/field.js\";\nimport type { GirParameter } from \"../../gir/parameter.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport {\n    isInlineCallbackRef,\n    isScalarRef,\n    renderDescriptor,\n    renderParamDescriptor,\n} from \"../../analysis/descriptor-render.js\";\nimport { renderBraced } from \"../../writer/emit.js\";\nimport { computeRecordFieldSlots } from \"./record-layout.js\";\n\ntype VtableKind = \"class\" | \"interface\";\n\ntype RenderVtableSlotDescriptorOptions = {\n    key: string;\n    structName: string;\n    kind: VtableKind;\n    field: GirField;\n    callback: GirCallback;\n    byteOffset: number;\n    vtableSize: number;\n};\n\nconst renderVfuncMetadata = (context: ModuleContext, klass: GirClass): string | undefined => {\n    if (klass.glibTypeStruct === undefined) {\n        return undefined;\n    }\n\n    const structName = pascalCase(klass.glibTypeStruct);\n    const kind: VtableKind = klass.isInterface ? \"interface\" : \"class\";\n    const entries = vtableEntries(context, structName, kind, klass.glibTypeStruct);\n\n    if (entries.length === 0) {\n        return undefined;\n    }\n\n    return renderBraced(entries.join(\"\\n\"));\n};\n\nconst vtableCallbackType = (context: ModuleContext, field: GirField): GirCallback | undefined => {\n    if (field.type === undefined) {\n        return undefined;\n    }\n\n    const type = context.library.typeFor(field.type);\n\n    if (type?.kind !== \"callback\" || context.library.nameFor(field.type) !== undefined) {\n        return undefined;\n    }\n\n    return type.value;\n};\n\nconst vtableSlotEntry = (\n    context: ModuleContext,\n    field: GirField,\n    claimedNames: Set<string>,\n): { key: string; callback: GirCallback } | undefined => {\n    const callback = vtableCallbackType(context, field);\n\n    if (callback === undefined) {\n        return undefined;\n    }\n\n    const key = toCamelIdentifier(field.name);\n\n    if (key === \"constructor\" || claimedNames.has(key)) {\n        return undefined;\n    }\n\n    if (!isVtableSlotEligible(context, callback)) {\n        return undefined;\n    }\n\n    return { key, callback };\n};\n\nconst vtableEntries = (context: ModuleContext, structName: string, kind: VtableKind, typeStruct: string): string[] => {\n    const resolved = context.library.resolveType(context.namespace.name, typeStruct);\n\n    if (resolved?.kind !== \"record\") {\n        return [];\n    }\n\n    const { slots, size } = computeRecordFieldSlots(context, resolved.value.fields, resolved.value.isUnion);\n    const entries: string[] = [];\n    const claimedNames: Set<string> = new Set();\n\n    for (const { field, slot } of slots) {\n        const entry = vtableSlotEntry(context, field, claimedNames);\n\n        if (entry === undefined) {\n            continue;\n        }\n\n        claimedNames.add(entry.key);\n\n        entries.push(\n            renderVtableSlotDescriptor(context, {\n                key: entry.key,\n                structName,\n                kind,\n                field,\n                callback: entry.callback,\n                byteOffset: slot.byteOffset,\n                vtableSize: size,\n            }),\n        );\n    }\n\n    return entries;\n};\n\nconst isUnsupportedOutParam = (context: ModuleContext, param: GirParameter): boolean =>\n    (param.direction === \"out\" || param.direction === \"inout\") &&\n    !param.callerAllocates &&\n    !isScalarRef(context.library, param.type);\n\nconst isEligibleVtableParam = (context: ModuleContext, param: GirParameter): boolean => {\n    if (param.isVarargs) {\n        return false;\n    }\n\n    if (isUnsupportedOutParam(context, param)) {\n        return false;\n    }\n\n    return !isInlineCallbackRef(context.library, param.type);\n};\n\nconst isVtableSlotEligible = (context: ModuleContext, callback: GirCallback): boolean => {\n    if (!callback.introspectable) {\n        return false;\n    }\n\n    for (const param of callback.parameters) {\n        if (!isEligibleVtableParam(context, param)) {\n            return false;\n        }\n    }\n\n    return !isInlineCallbackRef(context.library, callback.returnValue.type);\n};\n\nconst renderVtableSlotDescriptor = (context: ModuleContext, options: RenderVtableSlotDescriptorOptions): string => {\n    const { key, structName, kind, field, callback, byteOffset, vtableSize } = options;\n\n    const argDescriptors = callback.parameters\n        .map((param) => renderParamDescriptor(context, param, param.type))\n        .join(\", \");\n\n    const returnDescriptor = renderDescriptor(\n        context,\n        callback.returnValue.type,\n        callback.returnValue.transferOwnership,\n    );\n\n    const lines = [\n        `kind: ${sourceStringLiteral(kind)} as const,`,\n        `className: ${sourceStringLiteral(structName)},`,\n        `vfuncName: ${sourceStringLiteral(field.name)},`,\n        `byteOffset: ${String(byteOffset)},`,\n        `vtableSize: ${String(vtableSize)},`,\n        `argDescriptors: [${argDescriptors}],`,\n        `returnDescriptor: ${returnDescriptor},`,\n    ];\n\n    return `${key}: ${renderBraced(lines.join(\"\\n\"))},`;\n};\n\nexport { renderVfuncMetadata };\n"]}
+{"version":3,"file":"vtable.js","sourceRoot":"","sources":["../../../src/store/gi/vtable.ts"],"names":[],"mappings":"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","sourcesContent":["import { pascalCase, sourceStringLiteral } from \"@gtkx/utils\";\nimport type { GirCallback } from \"../../gir/callback.js\";\nimport type { GirClass, GirVirtualMethod } from \"../../gir/class.js\";\nimport type { GirField } from \"../../gir/field.js\";\nimport type { GirParameter } from \"../../gir/parameter.js\";\nimport type { GirRecord } from \"../../gir/record.js\";\nimport type { TypeId } from \"../../gir/type-id.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport type { JsDocSpec } from \"../../writer/doc.js\";\nimport {\n    isInlineCallbackRef,\n    isScalarRef,\n    renderDescriptor,\n    renderParamDescriptor,\n} from \"../../analysis/descriptor-render.js\";\nimport {\n    foldedLengthParameters,\n    handlerParameters,\n    parameterIdentifier,\n    renamesWithInstance,\n    renderHandlerParameters,\n    renderHandlerResultType,\n} from \"../../analysis/param-structure.js\";\nimport { renderTsType } from \"../../analysis/ts-type.js\";\nimport { ancestorChain, type ResolvedAncestor, resolveInterfaces } from \"../../gir/ancestry.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { renderBlock, renderBraced } from \"../../writer/emit.js\";\nimport { handlerSpec, THROWS_TEXT } from \"./doc-spec.js\";\nimport { computeRecordFieldSlots } from \"./record-layout.js\";\n\ntype VtableKind = \"class\" | \"interface\";\ntype VfuncMemberMode = \"implementation\" | \"requirement\" | \"signature\";\n\ntype VtableSlot = {\n    key: string;\n    field: GirField;\n    callback: GirCallback;\n    vfunc: GirVirtualMethod | undefined;\n    byteOffset: number;\n};\n\ntype VfuncMemberOptions = {\n    context: ModuleContext;\n    ownerRef: string;\n    slot: VtableSlot;\n    mode: VfuncMemberMode;\n    isProtected: boolean;\n};\n\ntype VfuncMembersOptions = {\n    context: ModuleContext;\n    klass: GirClass;\n    mode: VfuncMemberMode;\n};\n\ntype VfuncSignature = {\n    header: string;\n    returnType: string;\n};\n\ntype VfuncEntry = {\n    name: string;\n    signature: string;\n    doc: string | undefined;\n};\n\ntype Vtable = {\n    structName: string;\n    kind: VtableKind;\n    vtableSize: number;\n    slots: VtableSlot[];\n};\n\nconst PADDING_FIELD_NAME = /^(?:reserved|padding)\\d*$/i;\n\nconst UNCALLABLE_SLOT_KEYS: Set<string> = new Set([\n    \"vfuncDispose\",\n    \"vfuncFinalize\",\n    \"vfuncGetProperty\",\n    \"vfuncSetProperty\",\n]);\n\nconst PROTECTED_SLOT_NOTE = \"It is `protected`, so only a subclass chaining up reaches it.\";\nconst PUBLIC_SLOT_NOTE = \"Calling it from anywhere else re-enters the slot on a live instance.\";\n\nconst vfuncMemberName = (fieldName: string): string => `vfunc${pascalCase(fieldName)}`;\n\nconst vfuncOverrideNote = (slot: VtableSlot, isProtected: boolean): string =>\n    [\n        `Invokes the \\`${slot.field.name}\\` vtable slot. Override it on a class passed to \\`registerClass\\``,\n        `and chain up with \\`super.${slot.key}()\\`.`,\n        isProtected ? PROTECTED_SLOT_NOTE : PUBLIC_SLOT_NOTE,\n    ].join(\"\\n\");\n\nconst vfuncRequirementNote = (slot: VtableSlot, ownerRef: string): string =>\n    [\n        `Fills the \\`${slot.field.name}\\` vtable slot. Declare it on a class passed to \\`registerClass\\``,\n        `with \\`${ownerRef}\\` in \\`implements\\`, which installs it in the interface vtable. Leaving it out`,\n        \"keeps whatever the interface installs by default, the way it does for a C implementer.\",\n    ].join(\"\\n\");\n\nconst vfuncMemberNote = (options: VfuncMemberOptions): string =>\n    options.mode === \"requirement\"\n        ? vfuncRequirementNote(options.slot, options.ownerRef)\n        : vfuncOverrideNote(options.slot, options.isProtected);\n\nconst isPaddingField = (field: GirField): boolean =>\n    field.name.startsWith(\"_\") || PADDING_FIELD_NAME.test(field.name);\n\nconst vtableCallbackType = (context: ModuleContext, field: GirField): GirCallback | undefined => {\n    if (field.type === undefined) {\n        return undefined;\n    }\n\n    const type = context.library.typeFor(field.type);\n\n    if (type?.kind !== \"callback\" || context.library.nameFor(field.type) !== undefined) {\n        return undefined;\n    }\n\n    return type.value;\n};\n\nconst vtableSlotEntry = (\n    context: ModuleContext,\n    field: GirField,\n    claimedNames: Set<string>,\n): { key: string; callback: GirCallback } | undefined => {\n    if (field.name === \"constructor\" || isPaddingField(field)) {\n        return undefined;\n    }\n\n    const callback = vtableCallbackType(context, field);\n\n    if (callback === undefined) {\n        return undefined;\n    }\n\n    const key = vfuncMemberName(field.name);\n\n    if (claimedNames.has(key)) {\n        return undefined;\n    }\n\n    if (!isVtableSlotEligible(context, callback)) {\n        return undefined;\n    }\n\n    return { key, callback };\n};\n\nconst collectVtableSlots = (\n    context: ModuleContext,\n    fields: GirField[],\n    isUnion: boolean,\n): { slots: VtableSlot[]; vtableSize: number } => {\n    const { slots, size } = computeRecordFieldSlots(context, fields, isUnion);\n    const entries: VtableSlot[] = [];\n    const claimedNames: Set<string> = new Set();\n\n    for (const { field, slot } of slots) {\n        const entry = vtableSlotEntry(context, field, claimedNames);\n\n        if (entry !== undefined) {\n            claimedNames.add(entry.key);\n            entries.push({ ...entry, field, vfunc: undefined, byteOffset: slot.byteOffset });\n        }\n    }\n\n    return { slots: entries, vtableSize: size };\n};\n\nconst resolveVtableRecord = (\n    context: ModuleContext,\n    namespaceName: string,\n    klass: GirClass,\n): { typeStruct: string; record: GirRecord } | undefined => {\n    const typeStruct = klass.glibTypeStruct;\n    const resolved = typeStruct === undefined ? undefined : context.library.resolveType(namespaceName, typeStruct);\n\n    if (typeStruct === undefined || resolved?.kind !== \"record\" || resolved.value.fields.length === 0) {\n        return undefined;\n    }\n\n    return { typeStruct, record: resolved.value };\n};\n\nconst attachVirtualMethods = (slots: VtableSlot[], klass: GirClass): VtableSlot[] => {\n    const byKey: Map<string, GirVirtualMethod> = new Map(\n        klass.vfuncs.map((vfunc) => [vfuncMemberName(vfunc.name), vfunc]),\n    );\n\n    return slots.map((slot) => ({ ...slot, vfunc: byKey.get(slot.key) }));\n};\n\nconst collectVtable = (context: ModuleContext, namespaceName: string, klass: GirClass): Vtable | undefined => {\n    const resolved = resolveVtableRecord(context, namespaceName, klass);\n\n    if (resolved === undefined) {\n        return undefined;\n    }\n\n    const { slots, vtableSize } = collectVtableSlots(context, resolved.record.fields, resolved.record.isUnion);\n\n    if (slots.length === 0) {\n        return undefined;\n    }\n\n    return {\n        structName: pascalCase(resolved.typeStruct),\n        kind: klass.isInterface ? \"interface\" : \"class\",\n        vtableSize,\n        slots: attachVirtualMethods(slots, klass),\n    };\n};\n\nconst vfuncMemberNames = (context: ModuleContext, namespaceName: string, klass: GirClass): string[] =>\n    collectVtable(context, namespaceName, klass)?.slots.map((slot) => slot.key) ?? [];\n\nconst renderVfuncMetadata = (context: ModuleContext, klass: GirClass): string | undefined => {\n    const vtable = collectVtable(context, context.namespace.name, klass);\n\n    if (vtable === undefined) {\n        return undefined;\n    }\n\n    const entries = vtable.slots.map((slot) => renderVtableSlotDescriptor(context, vtable, slot));\n\n    return renderBraced(entries.join(\"\\n\"));\n};\n\nconst slotIdentity = (slot: VtableSlot): string => `${slot.key}:${String(slot.byteOffset)}`;\n\nconst inheritedSlotIdentities = (context: ModuleContext, namespaceName: string, klass: GirClass): Set<string> => {\n    const identities: Set<string> = new Set();\n    const [, ...ancestors] = [...ancestorChain(context.library, klass, namespaceName)];\n\n    for (const ancestor of ancestors) {\n        const vtable = collectVtable(context, ancestor.namespaceName, ancestor.klass);\n        const slots = vtable?.slots ?? [];\n\n        for (const slot of slots) {\n            identities.add(slotIdentity(slot));\n        }\n    }\n\n    return identities;\n};\n\nconst addInterfaceSlotKeys = (\n    context: ModuleContext,\n    iface: ResolvedAncestor,\n    keys: Set<string>,\n    seen: Set<string>,\n): void => {\n    const identity = `${iface.namespaceName}.${iface.klass.name}`;\n\n    if (seen.has(identity)) {\n        return;\n    }\n\n    seen.add(identity);\n\n    for (const key of vfuncMemberNames(context, iface.namespaceName, iface.klass)) {\n        keys.add(key);\n    }\n\n    for (const ref of resolveInterfaces(context.library, iface.namespaceName, iface.klass.prerequisites)) {\n        addInterfaceSlotKeys(context, ref, keys, seen);\n    }\n};\n\nconst implementedSlotKeys = (context: ModuleContext, namespaceName: string, klass: GirClass): Set<string> => {\n    const keys: Set<string> = new Set();\n    const seen: Set<string> = new Set();\n\n    for (const ancestor of ancestorChain(context.library, klass, namespaceName)) {\n        for (const ref of resolveInterfaces(context.library, ancestor.namespaceName, ancestor.klass.implements)) {\n            addInterfaceSlotKeys(context, ref, keys, seen);\n        }\n    }\n\n    return keys;\n};\n\nconst protectedSlotKeys = (options: VfuncMembersOptions, slots: VtableSlot[]): Set<string> => {\n    const { context, klass } = options;\n\n    if (klass.isInterface) {\n        return new Set();\n    }\n\n    const shared = implementedSlotKeys(context, context.namespace.name, klass);\n\n    return new Set(slots.map((slot) => slot.key).filter((key) => !shared.has(key)));\n};\n\nconst callableVfuncSlots = (context: ModuleContext, namespaceName: string, klass: GirClass): VtableSlot[] => {\n    const vtable = collectVtable(context, namespaceName, klass);\n\n    if (vtable === undefined) {\n        return [];\n    }\n\n    const inherited = inheritedSlotIdentities(context, namespaceName, klass);\n\n    return vtable.slots.filter((slot) => isCallableSlot(context, slot) && !inherited.has(slotIdentity(slot)));\n};\n\nconst hasCallableVfuncSlots = (context: ModuleContext, namespaceName: string, klass: GirClass): boolean =>\n    callableVfuncSlots(context, namespaceName, klass).length > 0;\n\nconst slotDoc = (slot: VtableSlot): string | undefined => slot.vfunc?.doc ?? slot.field.doc ?? slot.callback.doc;\n\nconst slotDocParameters = (slot: VtableSlot): GirParameter[] => {\n    const [, ...parameters] = slot.callback.parameters;\n    const vfuncParameters = slot.vfunc?.parameters ?? [];\n\n    return parameters.map((parameter, index) => ({ ...parameter, doc: vfuncParameters[index]?.doc ?? parameter.doc }));\n};\n\nconst slotDocSpec = (slot: VtableSlot): JsDocSpec => {\n    const parameters = slotDocParameters(slot);\n    const source = slot.vfunc ?? slot.callback;\n\n    return {\n        ...handlerSpec(source, parameters, renamesWithInstance(parameters, slot.callback.parameters[0])),\n        returns: slot.vfunc?.returnValue.doc ?? slot.callback.returnValue.doc,\n        throws: slot.callback.throws ? THROWS_TEXT : undefined,\n    };\n};\n\nconst vfuncEntries = (context: ModuleContext, namespaceName: string, klass: GirClass): VfuncEntry[] =>\n    callableVfuncSlots(context, namespaceName, klass).map((slot) => ({\n        name: slot.key,\n        signature: vfuncSlotSignature(context, slot).header,\n        doc: slotDoc(slot),\n    }));\n\nconst renderVfuncMembers = (options: VfuncMembersOptions): string[] => {\n    const { context, klass, mode } = options;\n    const ownerRef = pascalCase(klass.name);\n    const slots = callableVfuncSlots(context, context.namespace.name, klass);\n\n    if (slots.length === 0) {\n        return [];\n    }\n\n    if (mode === \"implementation\") {\n        context.addRuntimeImport(\"callVfunc\");\n    }\n\n    const protectedKeys = protectedSlotKeys(options, slots);\n\n    return slots.map((slot) =>\n        renderVfuncMember({ context, ownerRef, slot, mode, isProtected: protectedKeys.has(slot.key) }));\n};\n\nconst hasUnannotatedPointerParam = (context: ModuleContext, slot: VtableSlot): boolean => {\n    const [, ...parameters] = slot.callback.parameters;\n\n    return parameters.some(\n        (parameter) =>\n            parameter.direction === \"in\" &&\n            parameter.cType?.endsWith(\"*\") === true &&\n            isScalarRef(context.library, parameter.type),\n    );\n};\n\nconst isCallableSlot = (context: ModuleContext, slot: VtableSlot): boolean =>\n    !UNCALLABLE_SLOT_KEYS.has(slot.key) && !hasUnannotatedPointerParam(context, slot);\n\nconst vfuncSlotSignature = (context: ModuleContext, slot: VtableSlot, isOptional = false): VfuncSignature => {\n    const [, ...parameters] = slot.callback.parameters;\n\n    const renderType = (ref: TypeId | undefined, isNullable: boolean): string =>\n        renderTsType(context, ref, isNullable);\n\n    const signature = renderHandlerParameters(parameters, renderType).join(\", \");\n    const folded = foldedLengthParameters(context.library, slot.callback);\n\n    const returnType = renderHandlerResultType({\n        library: context.library,\n        signal: { ...slot.callback, parameters },\n        renderType,\n        shouldIncludeCallerAllocated: true,\n        isOptOut: false,\n        shouldExcludeOut: (parameter) => folded.has(parameter),\n    });\n\n    return { header: `${slot.key}${isOptional ? \"?\" : \"\"}(${signature}): ${returnType}`, returnType };\n};\n\nconst renderVfuncMember = (options: VfuncMemberOptions): string => {\n    const { context, ownerRef, slot, mode, isProtected } = options;\n    const { header, returnType } = vfuncSlotSignature(context, slot, mode === \"requirement\");\n    const declaration = `${isProtected ? \"protected \" : \"\"}${header}`;\n    const doc = renderJsDoc(slotDoc(slot), vfuncMemberNote(options), slotDocSpec(slot));\n\n    if (mode !== \"implementation\") {\n        return `${doc}${declaration};`;\n    }\n\n    const [, ...parameters] = slot.callback.parameters;\n\n    const inputs = handlerParameters(parameters).map((parameter, index) =>\n        parameterIdentifier(parameter, index));\n\n    const call = `callVfunc(${ownerRef}, ${sourceStringLiteral(slot.key)}, this, [${inputs.join(\", \")}])`;\n    const body = returnType === \"void\" ? `${call};` : `return ${call} as ${returnType};`;\n\n    return `${doc}${renderBlock(declaration, body)}`;\n};\n\nconst isEligibleVtableParam = (context: ModuleContext, param: GirParameter): boolean => {\n    if (param.isVarargs) {\n        return false;\n    }\n\n    return !isInlineCallbackRef(context.library, param.type);\n};\n\nconst isVtableSlotEligible = (context: ModuleContext, callback: GirCallback): boolean => {\n    if (!callback.introspectable) {\n        return false;\n    }\n\n    for (const param of callback.parameters) {\n        if (!isEligibleVtableParam(context, param)) {\n            return false;\n        }\n    }\n\n    return !isInlineCallbackRef(context.library, callback.returnValue.type);\n};\n\nconst renderVtableSlotDescriptor = (context: ModuleContext, vtable: Vtable, slot: VtableSlot): string => {\n    const { key, field, callback, byteOffset } = slot;\n\n    const argDescriptors = callback.parameters\n        .map((param) => renderParamDescriptor(context, param, param.type))\n        .join(\", \");\n\n    const returnDescriptor = renderDescriptor(\n        context,\n        callback.returnValue.type,\n        callback.returnValue.transferOwnership,\n    );\n\n    const lines = [\n        `className: ${sourceStringLiteral(vtable.structName)},`,\n        `vfuncName: ${sourceStringLiteral(field.name)},`,\n        `byteOffset: ${String(byteOffset)},`,\n    ];\n\n    if (vtable.kind === \"interface\") {\n        lines.push(`vtableSize: ${String(vtable.vtableSize)},`);\n    }\n\n    lines.push(`argDescriptors: [${argDescriptors}],`, `returnDescriptor: ${returnDescriptor},`);\n\n    if (callback.throws) {\n        lines.push(\"canThrow: true,\");\n    }\n\n    return `${key}: ${renderBraced(lines.join(\"\\n\"))},`;\n};\n\nexport {\n    hasCallableVfuncSlots,\n    renderVfuncMembers,\n    renderVfuncMetadata,\n    vfuncEntries,\n    vfuncMemberNames,\n    type VfuncMemberMode,\n};\n"]}

package/dist/store/gi-store.d.ts

@@ -1,10 +1,9 @@
 import { type GiFingerprint } from "../fingerprint.js";
 import { type StoreOptions } from "./store-fs.js";
-type GiStoreOptions = StoreOptions;
 type GiNamespaceInput = {
     directory: string;
     rawSource: string;
 };
-declare const writeGiStore: (options: GiStoreOptions, namespaces: GiNamespaceInput[], fingerprint: GiFingerprint) => void;
-export { writeGiStore, type GiStoreOptions, type GiNamespaceInput };
+declare const writeGiStore: (options: StoreOptions, namespaces: GiNamespaceInput[], fingerprint: GiFingerprint) => void;
+export { writeGiStore, type GiNamespaceInput };
 //# sourceMappingURL=gi-store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gi-store.d.ts","sourceRoot":"","sources":["../../src/store/gi-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAiB,KAAK,YAAY,EAA6B,MAAM,eAAe,CAAC;AAE5F,KAAK,cAAc,GAAG,YAAY,CAAC;AAEnC,KAAK,gBAAgB,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AA2DF,QAAA,MAAM,YAAY,GACd,SAAS,cAAc,EACvB,YAAY,gBAAgB,EAAE,EAC9B,aAAa,aAAa,KAC3B,IAeF,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"gi-store.d.ts","sourceRoot":"","sources":["../../src/store/gi-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAiB,KAAK,YAAY,EAA6B,MAAM,eAAe,CAAC;AAE5F,KAAK,gBAAgB,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AA2DF,QAAA,MAAM,YAAY,GACd,SAAS,YAAY,EACrB,YAAY,gBAAgB,EAAE,EAC9B,aAAa,aAAa,KAC3B,IAeF,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/store/gi-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"gi-store.js","sourceRoot":"","sources":["../../src/store/gi-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { FINGERPRINT_FILENAME, type GiFingerprint } from \"../fingerprint.js\";\nimport { buildManifest, type StoreOptions, subpathExport, writeStore } from \"./store-fs.js\";\n\ntype GiStoreOptions = StoreOptions;\n\ntype GiNamespaceInput = {\n    directory: string;\n    rawSource: string;\n};\n\ntype CollectedFile = {\n    fileName: string;\n    source: string;\n};\n\nconst OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"overrides\");\n\nconst overrideFiles = (directory: string): string[] => {\n    const dir = join(OVERRIDES_ROOT, directory);\n\n    if (!existsSync(dir)) {\n        return [];\n    }\n\n    return readdirSync(dir).filter((name) => name.endsWith(\".ejs\") && name !== \"index.ts.ejs\");\n};\n\nconst barrelSource = (directory: string): string => {\n    const overrideIndex = join(OVERRIDES_ROOT, directory, \"index.ts.ejs\");\n\n    if (!existsSync(overrideIndex)) {\n        return `export * from \"./${directory}.js\";\\n`;\n    }\n\n    return readFileSync(overrideIndex, \"utf8\");\n};\n\nconst collectStoreSources = (\n    namespaces: GiNamespaceInput[],\n): { collected: CollectedFile[]; exportsMap: Record<string, unknown> } => {\n    const exportsMap: Record<string, unknown> = {};\n    const collected: CollectedFile[] = [];\n\n    for (const { directory, rawSource } of namespaces) {\n        collected.push({\n            fileName: `${directory}/${directory}.ts`,\n            source: rawSource,\n        });\n\n        for (const file of overrideFiles(directory)) {\n            collected.push({\n                fileName: `${directory}/overrides/${file.replace(/\\.ejs$/, \"\")}`,\n                source: readFileSync(join(OVERRIDES_ROOT, directory, file), \"utf8\"),\n            });\n        }\n\n        collected.push({\n            fileName: `${directory}/index.ts`,\n            source: barrelSource(directory),\n        });\n\n        exportsMap[`./${directory}`] = subpathExport(`${directory}/index`);\n    }\n\n    return { collected, exportsMap };\n};\n\nconst writeGiStore = (\n    options: GiStoreOptions,\n    namespaces: GiNamespaceInput[],\n    fingerprint: GiFingerprint,\n): void => {\n    const { collected, exportsMap } = collectStoreSources(namespaces);\n\n    writeStore({\n        storeDir: options.storeDir,\n        linkDir: options.linkDir,\n        files: collected,\n        manifest: buildManifest({\n            name: \"@gtkx/gi\",\n            version: options.version,\n            exports: exportsMap,\n            peerDependencies: { \"@gtkx/runtime\": \"*\" },\n        }),\n        rawFiles: [{ relativePath: FINGERPRINT_FILENAME, content: `${JSON.stringify(fingerprint, null, 2)}\\n` }],\n    });\n};\n\nexport { writeGiStore, type GiStoreOptions, type GiNamespaceInput };\n"]}
+{"version":3,"file":"gi-store.js","sourceRoot":"","sources":["../../src/store/gi-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { FINGERPRINT_FILENAME, type GiFingerprint } from \"../fingerprint.js\";\nimport { buildManifest, type StoreOptions, subpathExport, writeStore } from \"./store-fs.js\";\n\ntype GiNamespaceInput = {\n    directory: string;\n    rawSource: string;\n};\n\ntype CollectedFile = {\n    fileName: string;\n    source: string;\n};\n\nconst OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"overrides\");\n\nconst overrideFiles = (directory: string): string[] => {\n    const dir = join(OVERRIDES_ROOT, directory);\n\n    if (!existsSync(dir)) {\n        return [];\n    }\n\n    return readdirSync(dir).filter((name) => name.endsWith(\".ejs\") && name !== \"index.ts.ejs\");\n};\n\nconst barrelSource = (directory: string): string => {\n    const overrideIndex = join(OVERRIDES_ROOT, directory, \"index.ts.ejs\");\n\n    if (!existsSync(overrideIndex)) {\n        return `export * from \"./${directory}.js\";\\n`;\n    }\n\n    return readFileSync(overrideIndex, \"utf8\");\n};\n\nconst collectStoreSources = (\n    namespaces: GiNamespaceInput[],\n): { collected: CollectedFile[]; exportsMap: Record<string, unknown> } => {\n    const exportsMap: Record<string, unknown> = {};\n    const collected: CollectedFile[] = [];\n\n    for (const { directory, rawSource } of namespaces) {\n        collected.push({\n            fileName: `${directory}/${directory}.ts`,\n            source: rawSource,\n        });\n\n        for (const file of overrideFiles(directory)) {\n            collected.push({\n                fileName: `${directory}/overrides/${file.replace(/\\.ejs$/, \"\")}`,\n                source: readFileSync(join(OVERRIDES_ROOT, directory, file), \"utf8\"),\n            });\n        }\n\n        collected.push({\n            fileName: `${directory}/index.ts`,\n            source: barrelSource(directory),\n        });\n\n        exportsMap[`./${directory}`] = subpathExport(`${directory}/index`);\n    }\n\n    return { collected, exportsMap };\n};\n\nconst writeGiStore = (\n    options: StoreOptions,\n    namespaces: GiNamespaceInput[],\n    fingerprint: GiFingerprint,\n): void => {\n    const { collected, exportsMap } = collectStoreSources(namespaces);\n\n    writeStore({\n        storeDir: options.storeDir,\n        linkDir: options.linkDir,\n        files: collected,\n        manifest: buildManifest({\n            name: \"@gtkx/gi\",\n            version: options.version,\n            exports: exportsMap,\n            peerDependencies: { \"@gtkx/runtime\": \"*\" },\n        }),\n        rawFiles: [{ relativePath: FINGERPRINT_FILENAME, content: `${JSON.stringify(fingerprint, null, 2)}\\n` }],\n    });\n};\n\nexport { writeGiStore, type GiNamespaceInput };\n"]}

package/dist/store/jsx/element-components.d.ts

@@ -3,12 +3,10 @@ import type { GirNamespace } from "../../gir/namespace.js";
 import type { ImportsBuilder } from "../../writer/imports.js";
 import type { LazyElementSpec } from "./element-prop-types.js";
 import { type GlibNamedClass } from "./intrinsic-elements.js";
-/** A component that wraps a generated element, keyed by GLib type name (built-in or user-provided). */
 type ElementComponent = {
     module: string;
     export: string;
 };
-/** Component wrappers keyed by GLib type name; the framework's built-ins merged with the project's own. */
 type ElementComponentOverrides = Record<string, ElementComponent>;
 declare const generateElementComponentsSection: (targetNamespace: GirNamespace, library: Library, options: {
     imports: ImportsBuilder;
@@ -19,5 +17,5 @@ declare const generateElementComponentsSection: (targetNamespace: GirNamespace,
     source: string;
     exportedNames: Set<string>;
 };
-export { generateElementComponentsSection, type ElementComponent, type ElementComponentOverrides };
+export { generateElementComponentsSection, type ElementComponentOverrides };
 //# sourceMappingURL=element-components.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"element-components.d.ts","sourceRoot":"","sources":["../../../src/store/jsx/element-components.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEjF,uGAAuG;AACvG,KAAK,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,2GAA2G;AAC3G,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAgBlE,QAAA,MAAM,gCAAgC,GAClC,iBAAiB,YAAY,EAC7B,SAAS,OAAO,EAChB,SAAS;IACL,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,yBAAyB,CAAC;CACzC,KACF;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAiB9C,CAAC;AAkGF,OAAO,EAAE,gCAAgC,EAAE,KAAK,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,CAAC"}
+{"version":3,"file":"element-components.d.ts","sourceRoot":"","sources":["../../../src/store/jsx/element-components.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEjF,KAAK,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAgBlE,QAAA,MAAM,gCAAgC,GAClC,iBAAiB,YAAY,EAC7B,SAAS,OAAO,EAChB,SAAS;IACL,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,yBAAyB,CAAC;CACzC,KACF;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAiB9C,CAAC;AAiGF,OAAO,EAAE,gCAAgC,EAAE,KAAK,yBAAyB,EAAE,CAAC"}

package/dist/store/jsx/element-components.js

@@ -1,5 +1,5 @@
 import { sourceStringLiteral } from "@gtkx/utils";
-import { renderJsDoc } from "../../writer/doc.js";
+import { getDoc } from "../gi/doc-spec.js";
 import { ancestorGlibNames } from "./intrinsic-elements.js";
 const generateElementComponentsSection = (targetNamespace, library, options) => {
     const collector = { imports: options.imports, exportedNames: new Set(), exportLines: [] };
@@ -28,9 +28,6 @@ const appendCandidateExport = (collector, candidate, options) => {
     collector.exportLines.push(line);
     collector.exportedNames.add(candidate.glibName);
 };
-// An abstract GType cannot be instantiated: `g_object_new` on one is a fatal GObject error rather
-// than a NULL return. Its props interface and metadata still have to be emitted, since every
-// concrete subclass extends them, so only the constructible component export is withheld.
 const collectCandidateExports = (collector, options) => {
     for (const candidate of options.intrinsicElements) {
         if (candidate.klass.isAbstract) {
@@ -48,9 +45,10 @@ const collectLazyElementExports = (collector, lazyElements) => {
     }
 };
 const renderLazyElementExport = (spec) => {
+    const doc = getDoc(spec);
     const factory = `createElementComponent(${sourceStringLiteral(spec.element)})`;
-    const component = `export const ${spec.element}: (props: ${spec.typeName}) => ReactNode = ${factory};`;
-    return `${spec.typeSource}\n\n${component}`;
+    const component = `${doc}export const ${spec.element}: (props: ${spec.typeName}) => ReactNode = ${factory};`;
+    return `${doc}${spec.typeSource}\n\n${component}`;
 };
 const renderCandidateExport = (candidate, library, imports, components) => {
     const { glibName, klass, namespace } = candidate;
@@ -61,9 +59,9 @@ const renderCandidateExport = (candidate, library, imports, components) => {
     if (component !== undefined) {
         imports.addNamed(component.module, component.export, false);
     }
-    return `${renderJsDoc(klass.doc)}${renderElementComponentExport(glibName, component)}`;
+    const doc = getDoc(klass);
+    return `${doc}${renderElementComponentExport(glibName, component)}`;
 };
-/** The component for the nearest ancestry match, most-derived first; user overrides win on their exact type. */
 const resolveElementComponent = (ancestry, components) => {
     for (const name of ancestry) {
         const found = components[name];

package/dist/store/jsx/element-components.js.map

@@ -1 +1 @@
-{"version":3,"file":"element-components.js","sourceRoot":"","sources":["../../../src/store/jsx/element-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKlD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAuB,MAAM,yBAAyB,CAAC;AAqBjF,MAAM,gCAAgC,GAAG,CACrC,eAA6B,EAC7B,OAAgB,EAChB,OAKC,EAC6C,EAAE;IAChD,MAAM,SAAS,GAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC3G,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzE,uBAAuB,CAAC,SAAS,EAAE;QAC/B,eAAe;QACf,OAAO;QACP,YAAY;QACZ,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,UAAU,EAAE,OAAO,CAAC,UAAU;KACjC,CAAC,CAAC;IAEH,yBAAyB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAElD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,SAA0B,EAC1B,SAAyB,EACzB,OAA+B,EAC3B,EAAE;IACN,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEvE,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;QACpD,OAAO;IACX,CAAC;IAED,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO;IACX,CAAC;IAED,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtF,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,kGAAkG;AAClG,6FAA6F;AAC7F,0FAA0F;AAC1F,MAAM,uBAAuB,GAAG,CAAC,SAA0B,EAAE,OAA+B,EAAQ,EAAE;IAClG,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAChD,IAAI,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC7B,SAAS;QACb,CAAC;QAED,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAAC,SAA0B,EAAE,YAA+B,EAAQ,EAAE;IACpG,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAC9B,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;QACpF,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACvD,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,IAAqB,EAAU,EAAE;IAC9D,MAAM,OAAO,GAAG,0BAA0B,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC/E,MAAM,SAAS,GAAG,gBAAgB,IAAI,CAAC,OAAO,aAAa,IAAI,CAAC,QAAQ,oBAAoB,OAAO,GAAG,CAAC;IAEvG,OAAO,GAAG,IAAI,CAAC,UAAU,OAAO,SAAS,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,SAAyB,EACzB,OAAgB,EAChB,OAAuB,EACvB,UAA4C,EACtC,EAAE;IACR,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IACjD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAE7C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,4BAA4B,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;AAC3F,CAAC,CAAC;AAEF,gHAAgH;AAChH,MAAM,uBAAuB,GAAG,CAC5B,QAAkB,EAClB,UAA4C,EAChB,EAAE;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,4BAA4B,GAAG,CAAC,QAAgB,EAAE,SAAuC,EAAU,EAAE;IACvG,MAAM,SAAS,GAAG,GAAG,QAAQ,OAAO,CAAC;IACrC,MAAM,UAAU,GAAG,WAAW,SAAS,gBAAgB,CAAC;IACxD,MAAM,WAAW,GAAG,0BAA0B,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC;IAE/E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,gBAAgB,QAAQ,KAAK,UAAU,MAAM,WAAW,GAAG,CAAC;IACvE,CAAC;IAED,OAAO,gBAAgB,QAAQ,KAAK,UAAU,MAAM,SAAS,CAAC,MAAM,IAAI,WAAW,IAAI,CAAC;AAC5F,CAAC,CAAC;AAEF,OAAO,EAAE,gCAAgC,EAAyD,CAAC","sourcesContent":["import { sourceStringLiteral } from \"@gtkx/utils\";\nimport type { Library } from \"../../gir/library.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { ImportsBuilder } from \"../../writer/imports.js\";\nimport type { LazyElementSpec } from \"./element-prop-types.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { ancestorGlibNames, type GlibNamedClass } from \"./intrinsic-elements.js\";\n\n/** A component that wraps a generated element, keyed by GLib type name (built-in or user-provided). */\ntype ElementComponent = { module: string; export: string };\n/** Component wrappers keyed by GLib type name; the framework's built-ins merged with the project's own. */\ntype ElementComponentOverrides = Record<string, ElementComponent>;\n\ntype ExportCollector = {\n    imports: ImportsBuilder;\n    exportedNames: Set<string>;\n    exportLines: string[];\n};\n\ntype CandidateExportOptions = {\n    targetNamespace: GirNamespace;\n    library: Library;\n    virtualNames: Set<string>;\n    intrinsicElements: GlibNamedClass[];\n    components: Record<string, ElementComponent>;\n};\n\nconst generateElementComponentsSection = (\n    targetNamespace: GirNamespace,\n    library: Library,\n    options: {\n        imports: ImportsBuilder;\n        lazyElements: LazyElementSpec[];\n        intrinsicElements: GlibNamedClass[];\n        components: ElementComponentOverrides;\n    },\n): { source: string; exportedNames: Set<string> } => {\n    const collector: ExportCollector = { imports: options.imports, exportedNames: new Set(), exportLines: [] };\n    const lazyElements = options.lazyElements;\n    const virtualNames = new Set(lazyElements.map((entry) => entry.element));\n\n    collectCandidateExports(collector, {\n        targetNamespace,\n        library,\n        virtualNames,\n        intrinsicElements: options.intrinsicElements,\n        components: options.components,\n    });\n\n    collectLazyElementExports(collector, lazyElements);\n    const source = collector.exportLines.join(\"\\n\\n\");\n\n    return { source, exportedNames: collector.exportedNames };\n};\n\nconst appendCandidateExport = (\n    collector: ExportCollector,\n    candidate: GlibNamedClass,\n    options: CandidateExportOptions,\n): void => {\n    const { targetNamespace, library, virtualNames, components } = options;\n\n    if (candidate.namespace.name !== targetNamespace.name) {\n        return;\n    }\n\n    if (virtualNames.has(candidate.glibName)) {\n        return;\n    }\n\n    const line = renderCandidateExport(candidate, library, collector.imports, components);\n    collector.exportLines.push(line);\n    collector.exportedNames.add(candidate.glibName);\n};\n\n// An abstract GType cannot be instantiated: `g_object_new` on one is a fatal GObject error rather\n// than a NULL return. Its props interface and metadata still have to be emitted, since every\n// concrete subclass extends them, so only the constructible component export is withheld.\nconst collectCandidateExports = (collector: ExportCollector, options: CandidateExportOptions): void => {\n    for (const candidate of options.intrinsicElements) {\n        if (candidate.klass.isAbstract) {\n            continue;\n        }\n\n        appendCandidateExport(collector, candidate, options);\n    }\n};\n\nconst collectLazyElementExports = (collector: ExportCollector, lazyElements: LazyElementSpec[]): void => {\n    for (const spec of lazyElements) {\n        collector.imports.addNamed(\"@gtkx/react/internal\", \"createElementComponent\", false);\n        collector.imports.addNamed(\"react\", \"ReactNode\", true);\n        collector.exportLines.push(renderLazyElementExport(spec));\n        collector.exportedNames.add(spec.element);\n    }\n};\n\nconst renderLazyElementExport = (spec: LazyElementSpec): string => {\n    const factory = `createElementComponent(${sourceStringLiteral(spec.element)})`;\n    const component = `export const ${spec.element}: (props: ${spec.typeName}) => ReactNode = ${factory};`;\n\n    return `${spec.typeSource}\\n\\n${component}`;\n};\n\nconst renderCandidateExport = (\n    candidate: GlibNamedClass,\n    library: Library,\n    imports: ImportsBuilder,\n    components: Record<string, ElementComponent>,\n): string => {\n    const { glibName, klass, namespace } = candidate;\n    const ancestry = ancestorGlibNames(klass, namespace, library);\n    const component = resolveElementComponent(ancestry, components);\n    imports.addNamed(\"@gtkx/react/internal\", \"createElementComponent\", false);\n    imports.addNamed(\"react\", \"ReactNode\", true);\n\n    if (component !== undefined) {\n        imports.addNamed(component.module, component.export, false);\n    }\n\n    return `${renderJsDoc(klass.doc)}${renderElementComponentExport(glibName, component)}`;\n};\n\n/** The component for the nearest ancestry match, most-derived first; user overrides win on their exact type. */\nconst resolveElementComponent = (\n    ancestry: string[],\n    components: Record<string, ElementComponent>,\n): ElementComponent | undefined => {\n    for (const name of ancestry) {\n        const found = components[name];\n\n        if (found !== undefined) {\n            return found;\n        }\n    }\n\n    return undefined;\n};\n\nconst renderElementComponentExport = (glibName: string, component: ElementComponent | undefined): string => {\n    const propsType = `${glibName}Props`;\n    const annotation = `(props: ${propsType}) => ReactNode`;\n    const factoryCall = `createElementComponent(${sourceStringLiteral(glibName)})`;\n\n    if (component === undefined) {\n        return `export const ${glibName}: ${annotation} = ${factoryCall};`;\n    }\n\n    return `export const ${glibName}: ${annotation} = ${component.export}(${factoryCall});`;\n};\n\nexport { generateElementComponentsSection, type ElementComponent, type ElementComponentOverrides };\n"]}
+{"version":3,"file":"element-components.js","sourceRoot":"","sources":["../../../src/store/jsx/element-components.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral } from \"@gtkx/utils\";\nimport type { Library } from \"../../gir/library.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { ImportsBuilder } from \"../../writer/imports.js\";\nimport type { LazyElementSpec } from \"./element-prop-types.js\";\nimport { getDoc } from \"../gi/doc-spec.js\";\nimport { ancestorGlibNames, type GlibNamedClass } from \"./intrinsic-elements.js\";\n\ntype ElementComponent = { module: string; export: string };\ntype ElementComponentOverrides = Record<string, ElementComponent>;\n\ntype ExportCollector = {\n    imports: ImportsBuilder;\n    exportedNames: Set<string>;\n    exportLines: string[];\n};\n\ntype CandidateExportOptions = {\n    targetNamespace: GirNamespace;\n    library: Library;\n    virtualNames: Set<string>;\n    intrinsicElements: GlibNamedClass[];\n    components: Record<string, ElementComponent>;\n};\n\nconst generateElementComponentsSection = (\n    targetNamespace: GirNamespace,\n    library: Library,\n    options: {\n        imports: ImportsBuilder;\n        lazyElements: LazyElementSpec[];\n        intrinsicElements: GlibNamedClass[];\n        components: ElementComponentOverrides;\n    },\n): { source: string; exportedNames: Set<string> } => {\n    const collector: ExportCollector = { imports: options.imports, exportedNames: new Set(), exportLines: [] };\n    const lazyElements = options.lazyElements;\n    const virtualNames = new Set(lazyElements.map((entry) => entry.element));\n\n    collectCandidateExports(collector, {\n        targetNamespace,\n        library,\n        virtualNames,\n        intrinsicElements: options.intrinsicElements,\n        components: options.components,\n    });\n\n    collectLazyElementExports(collector, lazyElements);\n    const source = collector.exportLines.join(\"\\n\\n\");\n\n    return { source, exportedNames: collector.exportedNames };\n};\n\nconst appendCandidateExport = (\n    collector: ExportCollector,\n    candidate: GlibNamedClass,\n    options: CandidateExportOptions,\n): void => {\n    const { targetNamespace, library, virtualNames, components } = options;\n\n    if (candidate.namespace.name !== targetNamespace.name) {\n        return;\n    }\n\n    if (virtualNames.has(candidate.glibName)) {\n        return;\n    }\n\n    const line = renderCandidateExport(candidate, library, collector.imports, components);\n    collector.exportLines.push(line);\n    collector.exportedNames.add(candidate.glibName);\n};\n\nconst collectCandidateExports = (collector: ExportCollector, options: CandidateExportOptions): void => {\n    for (const candidate of options.intrinsicElements) {\n        if (candidate.klass.isAbstract) {\n            continue;\n        }\n\n        appendCandidateExport(collector, candidate, options);\n    }\n};\n\nconst collectLazyElementExports = (collector: ExportCollector, lazyElements: LazyElementSpec[]): void => {\n    for (const spec of lazyElements) {\n        collector.imports.addNamed(\"@gtkx/react/internal\", \"createElementComponent\", false);\n        collector.imports.addNamed(\"react\", \"ReactNode\", true);\n        collector.exportLines.push(renderLazyElementExport(spec));\n        collector.exportedNames.add(spec.element);\n    }\n};\n\nconst renderLazyElementExport = (spec: LazyElementSpec): string => {\n    const doc = getDoc(spec);\n    const factory = `createElementComponent(${sourceStringLiteral(spec.element)})`;\n    const component = `${doc}export const ${spec.element}: (props: ${spec.typeName}) => ReactNode = ${factory};`;\n\n    return `${doc}${spec.typeSource}\\n\\n${component}`;\n};\n\nconst renderCandidateExport = (\n    candidate: GlibNamedClass,\n    library: Library,\n    imports: ImportsBuilder,\n    components: Record<string, ElementComponent>,\n): string => {\n    const { glibName, klass, namespace } = candidate;\n    const ancestry = ancestorGlibNames(klass, namespace, library);\n    const component = resolveElementComponent(ancestry, components);\n    imports.addNamed(\"@gtkx/react/internal\", \"createElementComponent\", false);\n    imports.addNamed(\"react\", \"ReactNode\", true);\n\n    if (component !== undefined) {\n        imports.addNamed(component.module, component.export, false);\n    }\n\n    const doc = getDoc(klass);\n\n    return `${doc}${renderElementComponentExport(glibName, component)}`;\n};\n\nconst resolveElementComponent = (\n    ancestry: string[],\n    components: Record<string, ElementComponent>,\n): ElementComponent | undefined => {\n    for (const name of ancestry) {\n        const found = components[name];\n\n        if (found !== undefined) {\n            return found;\n        }\n    }\n\n    return undefined;\n};\n\nconst renderElementComponentExport = (glibName: string, component: ElementComponent | undefined): string => {\n    const propsType = `${glibName}Props`;\n    const annotation = `(props: ${propsType}) => ReactNode`;\n    const factoryCall = `createElementComponent(${sourceStringLiteral(glibName)})`;\n\n    if (component === undefined) {\n        return `export const ${glibName}: ${annotation} = ${factoryCall};`;\n    }\n\n    return `export const ${glibName}: ${annotation} = ${component.export}(${factoryCall});`;\n};\n\nexport { generateElementComponentsSection, type ElementComponentOverrides };\n"]}

package/dist/store/jsx/element-prop-imports.d.ts

@@ -1,4 +1,3 @@
-/** Props interface a generated element's props extend, declared by hand in `@gtkx/react`. */
 type ElementPropTypeRef = {
     type: string;
     module: string;
@@ -9,9 +8,7 @@ type ElementProps = Record<string, {
     module: string;
     export: string;
 }>;
-/** Installs the base props each element extends (GLib type name → `{ module, export }`); set once per run. */
 declare const setElementProps: (props: ElementProps) => void;
-/** The base props interface an element extends, when its element config declares one. */
 declare const elementPropTypeFor: (glibName: string) => ElementPropTypeRef | undefined;
-export { setElementProps, elementPropTypeFor, type ElementPropTypeRef, type ElementProps };
+export { setElementProps, elementPropTypeFor, type ElementProps };
 //# sourceMappingURL=element-prop-imports.d.ts.map

package/dist/store/jsx/element-prop-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-prop-imports.d.ts","sourceRoot":"","sources":["../../../src/store/jsx/element-prop-imports.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,KAAK,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3E,kGAAkG;AAClG,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIvE,8GAA8G;AAC9G,QAAA,MAAM,eAAe,GAAI,OAAO,YAAY,KAAG,IAM9C,CAAC;AAEF,yFAAyF;AACzF,QAAA,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,kBAAkB,GAAG,SAInE,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"element-prop-imports.d.ts","sourceRoot":"","sources":["../../../src/store/jsx/element-prop-imports.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,kGAAkG;AAClG,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAIH,QAAA,MAAM,eAAe,GAAI,OAAO,YAAY,KAAG,IAM9C,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,kBAAkB,GAAG,SAInE,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/store/jsx/element-prop-imports.js

@@ -1,12 +1,10 @@
 const elementProps = new Map();
-/** Installs the base props each element extends (GLib type name → `{ module, export }`); set once per run. */
 const setElementProps = (props) => {
     elementProps.clear();
     for (const [glibName, ref] of Object.entries(props)) {
         elementProps.set(glibName, ref);
     }
 };
-/** The base props interface an element extends, when its element config declares one. */
 const elementPropTypeFor = (glibName) => {
     const ref = elementProps.get(glibName);
     return ref === undefined ? undefined : { type: glibName, module: ref.module, export: ref.export };