@gtkx/codegen 1.0.0-rc.4 → 1.0.0

package/dist/analysis/inheritance.js

@@ -1,7 +1,8 @@
 import { camelCase, lowerFirst, pascalCase, toCamelIdentifier } from "@gtkx/utils";
-import { ancestorChain, resolveInterface } from "../gir/ancestry.js";
+import { ancestorChain, resolveInterfaces } from "../gir/ancestry.js";
 import { methodExportName } from "../store/gi/method.js";
 import { resolveAccessorType } from "../store/gi/property-accessor.js";
+import { vfuncMemberNames } from "../store/gi/vtable.js";
 import { inputParameters } from "./param-structure.js";
 import { renderTsType } from "./ts-type.js";
 const RESERVED_SIGNAL_MEMBERS = new Set([
@@ -14,17 +15,7 @@ const RESERVED_SIGNAL_MEMBERS = new Set([
     "addEventListener",
     "removeEventListener",
 ]);
-const resolveImplementedInterface = (context, name, defaultNamespace = context.namespace.name) => resolveInterface(context.library, defaultNamespace, name);
-const resolveDirectInterfaces = (context, klass, defaultNamespace) => {
-    const interfaces = [];
-    for (const implementName of klass.implements) {
-        const iface = resolveImplementedInterface(context, implementName, defaultNamespace);
-        if (iface !== undefined) {
-            interfaces.push(iface);
-        }
-    }
-    return interfaces;
-};
+const resolveDirectInterfaces = (context, klass, defaultNamespace) => resolveInterfaces(context.library, defaultNamespace, klass.implements);
 const resolvePrerequisiteReference = (context, name) => {
     const resolved = context.library.resolveType(context.namespace.name, name);
     if (resolved === undefined) {
@@ -123,17 +114,29 @@ const mergeOmissionName = (context, method, ancestors) => {
     const arity = inputParameters(context.library, method).length;
     return ancestor.returnType !== returnType || ancestor.arity !== arity ? name : undefined;
 };
-const collectInterfaceMergeOmissions = (context, klass, iface) => {
-    const ancestors = ancestorClassMethodSignatures(context, klass);
-    const omissions = [];
-    for (const method of iface.klass.methods) {
-        const name = mergeOmissionName(context, method, ancestors);
-        if (name !== undefined) {
-            omissions.push(name);
+const classChainVfuncNames = (context, klass) => {
+    const names = new Set(vfuncMemberNames(context, context.namespace.name, klass));
+    forEachAncestor(context, klass, (ancestor) => {
+        for (const name of vfuncMemberNames(context, ancestor.namespaceName, ancestor.klass)) {
+            names.add(name);
         }
-    }
-    return omissions;
+    });
+    return names;
 };
+const methodMergeOmissions = (context, klass, iface) => {
+    const ancestors = ancestorClassMethodSignatures(context, klass);
+    return iface.methods
+        .map((method) => mergeOmissionName(context, method, ancestors))
+        .filter((name) => name !== undefined);
+};
+const vfuncMergeOmissions = (context, klass, iface) => {
+    const claimed = classChainVfuncNames(context, klass);
+    return vfuncMemberNames(context, iface.namespaceName, iface.klass).filter((name) => claimed.has(name));
+};
+const collectInterfaceMergeOmissions = (context, klass, iface) => [
+    ...methodMergeOmissions(context, klass, iface.klass),
+    ...vfuncMergeOmissions(context, klass, iface),
+];
 const collectInheritedPropertyTypes = (context, klass) => {
     const types = new Map();
     const record = (owner, property) => {
@@ -244,5 +247,5 @@ const enumIdentity = (context, ref) => {
     }
     return `${resolved.namespace.name}.${resolved.value.name}`;
 };
-export { resolveImplementedInterface, resolvePrerequisiteReference, forEachAncestor, collectInterfaceProperties, collectInterfaceMergeOmissions, collectInheritedPropertyTypes, collectInheritedMethods, conflictRename, reservedSignalMemberRename, };
+export { resolvePrerequisiteReference, forEachAncestor, collectInterfaceProperties, collectInterfaceMergeOmissions, collectInheritedPropertyTypes, collectInheritedMethods, conflictRename, reservedSignalMemberRename, };
 //# sourceMappingURL=inheritance.js.map

package/dist/analysis/inheritance.js.map

@@ -1 +1 @@
-{"version":3,"file":"inheritance.js","sourceRoot":"","sources":["../../src/analysis/inheritance.ts"],"names":[],"mappings":"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","sourcesContent":["import { camelCase, lowerFirst, pascalCase, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { GirProperty } from \"../gir/property.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\nimport { ancestorChain, type ResolvedAncestor, resolveInterface } from \"../gir/ancestry.js\";\nimport { methodExportName } from \"../store/gi/method.js\";\nimport { resolveAccessorType } from \"../store/gi/property-accessor.js\";\nimport { inputParameters } from \"./param-structure.js\";\nimport { renderTsType } from \"./ts-type.js\";\n\ntype AncestryContext = {\n    library: Library;\n    namespace: { name: string };\n};\n\ntype OwnedProperty = { owner: GirClass; property: GirProperty };\ntype MethodSignature = { returnType: string; arity: number };\n\ntype InheritedMethod = {\n    method: GirFunction;\n    namespaceName: string;\n};\n\ntype InheritedMethods = {\n    returnTypes: Map<string, string>;\n    definitions: Map<string, InheritedMethod>;\n};\n\ntype InheritedMatch = {\n    inheritedReturn: string;\n    inheritedMethod: InheritedMethod;\n};\n\nconst RESERVED_SIGNAL_MEMBERS = new Set([\n    \"connect\",\n    \"disconnect\",\n    \"emit\",\n    \"on\",\n    \"once\",\n    \"off\",\n    \"addEventListener\",\n    \"removeEventListener\",\n]);\n\nconst resolveImplementedInterface = (\n    context: AncestryContext,\n    name: string,\n    defaultNamespace: string = context.namespace.name,\n): ResolvedAncestor | undefined => resolveInterface(context.library, defaultNamespace, name);\n\nconst resolveDirectInterfaces = (\n    context: AncestryContext,\n    klass: GirClass,\n    defaultNamespace: string,\n): ResolvedAncestor[] => {\n    const interfaces: ResolvedAncestor[] = [];\n\n    for (const implementName of klass.implements) {\n        const iface = resolveImplementedInterface(context, implementName, defaultNamespace);\n\n        if (iface !== undefined) {\n            interfaces.push(iface);\n        }\n    }\n\n    return interfaces;\n};\n\nconst resolvePrerequisiteReference = (context: ModuleContext, name: string): string | undefined => {\n    const resolved = context.library.resolveType(context.namespace.name, name);\n\n    if (resolved === undefined) {\n        return undefined;\n    }\n\n    if (resolved.kind !== \"interface\" && resolved.kind !== \"class\") {\n        return undefined;\n    }\n\n    return context.qualify(resolved.namespace.name, pascalCase(resolved.value.name));\n};\n\nconst forEachAncestor = (\n    context: AncestryContext,\n    klass: GirClass,\n    visit: (ancestor: ResolvedAncestor, interfaces: ResolvedAncestor[]) => void,\n    shouldStop: (ancestor: GirClass) => boolean = () => false,\n): void => {\n    let isFirst = true;\n\n    for (const ancestor of ancestorChain(context.library, klass, context.namespace.name)) {\n        if (isFirst) {\n            isFirst = false;\n            continue;\n        }\n\n        if (shouldStop(ancestor.klass)) {\n            break;\n        }\n\n        visit(ancestor, resolveDirectInterfaces(context, ancestor.klass, ancestor.namespaceName));\n    }\n};\n\nconst visitInterfaceProperties = (\n    interfaces: ResolvedAncestor[],\n    visit: (owner: GirClass, property: GirProperty) => void,\n): void => {\n    for (const iface of interfaces) {\n        for (const property of iface.klass.properties) {\n            visit(iface.klass, property);\n        }\n    }\n};\n\nconst forEachInheritedProperty = (\n    context: ModuleContext,\n    klass: GirClass,\n    visit: (owner: GirClass, property: GirProperty) => void,\n): void => {\n    forEachAncestor(context, klass, (ancestor, interfaces) => {\n        for (const property of ancestor.klass.properties) {\n            visit(ancestor.klass, property);\n        }\n\n        visitInterfaceProperties(interfaces, visit);\n    });\n};\n\nconst collectSeenPropertyNames = (context: ModuleContext, klass: GirClass): Set<string> => {\n    const seen: Set<string> = new Set();\n\n    for (const property of klass.properties) {\n        seen.add(toCamelIdentifier(property.name));\n    }\n\n    forEachInheritedProperty(context, klass, (_owner, property) => seen.add(toCamelIdentifier(property.name)));\n\n    return seen;\n};\n\nconst collectNewInterfaceProperties = (iface: ResolvedAncestor, seen: Set<string>): OwnedProperty[] => {\n    const result: OwnedProperty[] = [];\n\n    for (const property of iface.klass.properties) {\n        const name = toCamelIdentifier(property.name);\n\n        if (seen.has(name)) {\n            continue;\n        }\n\n        seen.add(name);\n        result.push({ owner: iface.klass, property });\n    }\n\n    return result;\n};\n\nconst collectInterfaceProperties = (context: ModuleContext, klass: GirClass): OwnedProperty[] => {\n    const seen = collectSeenPropertyNames(context, klass);\n    const result: OwnedProperty[] = [];\n\n    for (const iface of resolveDirectInterfaces(context, klass, context.namespace.name)) {\n        result.push(...collectNewInterfaceProperties(iface, seen));\n    }\n\n    return result;\n};\n\nconst recordAncestorSignatures = (\n    context: ModuleContext,\n    klass: GirClass,\n    signatures: Map<string, MethodSignature>,\n): void => {\n    for (const method of klass.methods) {\n        const name = camelCase(method.name);\n\n        if (!method.introspectable || signatures.has(name)) {\n            continue;\n        }\n\n        signatures.set(name, {\n            returnType: renderTsType(context, method.returnValue.type, method.returnValue.nullable),\n            arity: inputParameters(context.library, method).length,\n        });\n    }\n};\n\nconst ancestorClassMethodSignatures = (context: ModuleContext, klass: GirClass): Map<string, MethodSignature> => {\n    const signatures: Map<string, MethodSignature> = new Map();\n\n    forEachAncestor(context, klass, (ancestor) => {\n        recordAncestorSignatures(context, ancestor.klass, signatures);\n    });\n\n    return signatures;\n};\n\nconst mergeOmissionName = (\n    context: ModuleContext,\n    method: GirFunction,\n    ancestors: Map<string, MethodSignature>,\n): string | undefined => {\n    if (!method.introspectable) {\n        return undefined;\n    }\n\n    const name = camelCase(method.name);\n    const ancestor = ancestors.get(name);\n\n    if (ancestor === undefined) {\n        return undefined;\n    }\n\n    const returnType = renderTsType(context, method.returnValue.type, method.returnValue.nullable);\n    const arity = inputParameters(context.library, method).length;\n\n    return ancestor.returnType !== returnType || ancestor.arity !== arity ? name : undefined;\n};\n\nconst collectInterfaceMergeOmissions = (\n    context: ModuleContext,\n    klass: GirClass,\n    iface: { klass: GirClass; namespaceName: string },\n): string[] => {\n    const ancestors = ancestorClassMethodSignatures(context, klass);\n    const omissions: string[] = [];\n\n    for (const method of iface.klass.methods) {\n        const name = mergeOmissionName(context, method, ancestors);\n\n        if (name !== undefined) {\n            omissions.push(name);\n        }\n    }\n\n    return omissions;\n};\n\nconst collectInheritedPropertyTypes = (context: ModuleContext, klass: GirClass): Map<string, string> => {\n    const types: Map<string, string> = new Map();\n\n    const record = (owner: GirClass, property: GirProperty): void => {\n        const jsName = toCamelIdentifier(property.name);\n\n        if (types.has(jsName)) {\n            return;\n        }\n\n        const tsType = resolveAccessorType(context, property, owner.methods);\n\n        if (tsType !== undefined) {\n            types.set(jsName, tsType);\n        }\n    };\n\n    forEachInheritedProperty(context, klass, record);\n\n    return types;\n};\n\nconst collectInheritedMethods = (context: ModuleContext, klass: GirClass): InheritedMethods => {\n    const accumulator: InheritedMethods = {\n        returnTypes: new Map<string, string>(),\n        definitions: new Map<string, InheritedMethod>(),\n    };\n\n    for (const iface of resolveDirectInterfaces(context, klass, context.namespace.name)) {\n        absorbInheritedMethods(context, iface, accumulator);\n    }\n\n    forEachAncestor(context, klass, (ancestor, interfaces) => {\n        absorbInheritedMethods(context, ancestor, accumulator);\n\n        for (const iface of interfaces) {\n            absorbInheritedMethods(context, iface, accumulator);\n        }\n    });\n\n    return accumulator;\n};\n\nconst absorbInheritedMethods = (\n    context: ModuleContext,\n    resolved: { klass: GirClass; namespaceName: string },\n    accumulator: InheritedMethods,\n): void => {\n    const { returnTypes, definitions } = accumulator;\n\n    for (const method of resolved.klass.methods) {\n        if (!method.introspectable) {\n            continue;\n        }\n\n        const name = camelCase(method.name);\n\n        if (returnTypes.has(name)) {\n            continue;\n        }\n\n        definitions.set(name, { method, namespaceName: resolved.namespaceName });\n        returnTypes.set(name, renderTsType(context, method.returnValue.type, method.returnValue.nullable));\n    }\n};\n\nconst inheritedMatch = (inherited: InheritedMethods, name: string): InheritedMatch | undefined => {\n    const inheritedReturn = inherited.returnTypes.get(name);\n    const inheritedMethod = inherited.definitions.get(name);\n\n    if (inheritedReturn === undefined || inheritedMethod === undefined) {\n        return undefined;\n    }\n\n    return { inheritedReturn, inheritedMethod };\n};\n\nconst hasMethodConflict = (options: {\n    context: ModuleContext;\n    callable: GirFunction;\n    inheritedReturn: string;\n    inheritedMethod: InheritedMethod;\n}): boolean => {\n    const { context, callable, inheritedReturn, inheritedMethod } = options;\n    const ownReturn = renderTsType(context, callable.returnValue.type, callable.returnValue.nullable);\n\n    return (\n        inheritedReturn !== ownReturn ||\n        hasParameterEnumConflict(context, callable, inheritedMethod) ||\n        inputParameters(context.library, callable).length !==\n        inputParameters(context.library, inheritedMethod.method).length\n    );\n};\n\nconst conflictRename = (\n    context: ModuleContext,\n    callable: GirFunction,\n    inherited: InheritedMethods,\n    className: string,\n): string | undefined => {\n    if (!callable.introspectable) {\n        return undefined;\n    }\n\n    const name = methodExportName(callable);\n\n    if (RESERVED_SIGNAL_MEMBERS.has(name)) {\n        return conflictingMethodName(className, callable.name);\n    }\n\n    const match = inheritedMatch(inherited, name);\n\n    if (match === undefined) {\n        return undefined;\n    }\n\n    const hasConflict = hasMethodConflict({ context, callable, ...match });\n\n    return hasConflict ? conflictingMethodName(className, callable.name) : undefined;\n};\n\nconst conflictingMethodName = (className: string, methodName: string): string =>\n    `${lowerFirst(className)}${pascalCase(methodName)}`;\n\nconst reservedSignalMemberRename = (className: string, callable: GirFunction): string | undefined =>\n    RESERVED_SIGNAL_MEMBERS.has(methodExportName(callable))\n        ? conflictingMethodName(className, callable.name)\n        : undefined;\n\nconst hasEnumConflict = (\n    context: ModuleContext,\n    ownRef: TypeId | undefined,\n    inheritedRef: TypeId | undefined,\n): boolean => {\n    const ownEnum = enumIdentity(context, ownRef);\n    const inheritedEnum = enumIdentity(context, inheritedRef);\n\n    return ownEnum !== undefined && inheritedEnum !== undefined && ownEnum !== inheritedEnum;\n};\n\nconst hasParameterEnumConflict = (context: ModuleContext, own: GirFunction, inherited: InheritedMethod): boolean => {\n    const ownParams = inputParameters(context.library, own);\n    const inheritedParams = inputParameters(context.library, inherited.method);\n    const count = Math.min(ownParams.length, inheritedParams.length);\n\n    for (let index = 0; index < count; index += 1) {\n        const ownParam = ownParams[index];\n        const inheritedParam = inheritedParams[index];\n\n        if (\n            ownParam !== undefined &&\n            inheritedParam !== undefined &&\n            hasEnumConflict(context, ownParam.parameter.type, inheritedParam.parameter.type)\n        ) {\n            return true;\n        }\n    }\n\n    return false;\n};\n\nconst enumIdentity = (context: ModuleContext, ref: TypeId | undefined): string | undefined => {\n    if (ref === undefined) {\n        return undefined;\n    }\n\n    const resolved = context.library.typeFor(ref);\n\n    if (resolved?.kind !== \"enum\") {\n        return undefined;\n    }\n\n    return `${resolved.namespace.name}.${resolved.value.name}`;\n};\n\nexport {\n    resolveImplementedInterface,\n    resolvePrerequisiteReference,\n    forEachAncestor,\n    collectInterfaceProperties,\n    collectInterfaceMergeOmissions,\n    collectInheritedPropertyTypes,\n    collectInheritedMethods,\n    conflictRename,\n    reservedSignalMemberRename,\n    type OwnedProperty,\n    type InheritedMethods,\n};\n"]}
+{"version":3,"file":"inheritance.js","sourceRoot":"","sources":["../../src/analysis/inheritance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOnF,OAAO,EAAE,aAAa,EAAyB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAyB5C,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACpC,SAAS;IACT,YAAY;IACZ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,kBAAkB;IAClB,qBAAqB;CACxB,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAC5B,OAAwB,EACxB,KAAe,EACf,gBAAwB,EACN,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;AAEhG,MAAM,4BAA4B,GAAG,CAAC,OAAsB,EAAE,IAAY,EAAsB,EAAE;IAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE3E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACpB,OAAwB,EACxB,KAAe,EACf,KAA2E,EAC3E,aAA8C,GAAG,EAAE,CAAC,KAAK,EACrD,EAAE;IACN,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACnF,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACb,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM;QACV,CAAC;QAED,KAAK,CAAC,QAAQ,EAAE,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9F,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC7B,UAA8B,EAC9B,KAAuD,EACnD,EAAE;IACN,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5C,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC7B,OAAsB,EACtB,KAAe,EACf,KAAuD,EACnD,EAAE;IACN,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE;QACrD,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC/C,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;QAED,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAe,EAAE;IACtF,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3G,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,KAAuB,EAAE,IAAiB,EAAmB,EAAE;IAClG,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,SAAS;QACb,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAmB,EAAE;IAC5F,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,GAAG,6BAA6B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC7B,OAAsB,EACtB,KAAe,EACf,UAAwC,EACpC,EAAE;IACN,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,SAAS;QACb,CAAC;QAED,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB,UAAU,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;YACvF,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM;SACzD,CAAC,CAAC;IACP,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAgC,EAAE;IAC5G,MAAM,UAAU,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE3D,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE;QACzC,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACtB,OAAsB,EACtB,MAAmB,EACnB,SAAuC,EACrB,EAAE;IACpB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC;IAE9D,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAe,EAAE;IAClF,MAAM,KAAK,GAAgB,IAAI,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAE7F,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE;QACzC,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnF,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAE,KAAe,EAAY,EAAE;IAChG,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEhE,OAAO,KAAK,CAAC,OAAO;SACf,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;SAC9D,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CACxB,OAAsB,EACtB,KAAe,EACf,KAAiD,EACzC,EAAE;IACV,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAErD,OAAO,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3G,CAAC,CAAC;AAEF,MAAM,8BAA8B,GAAG,CACnC,OAAsB,EACtB,KAAe,EACf,KAAiD,EACzC,EAAE,CAAC;IACX,GAAG,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACpD,GAAG,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC;CAChD,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAuB,EAAE;IACnG,MAAM,KAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE7C,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,QAAqB,EAAQ,EAAE;QAC5D,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC,CAAC;IAEF,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEjD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,OAAsB,EAAE,KAAe,EAAoB,EAAE;IAC1F,MAAM,WAAW,GAAqB;QAClC,WAAW,EAAE,IAAI,GAAG,EAAkB;QACtC,WAAW,EAAE,IAAI,GAAG,EAA2B;KAClD,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;IAED,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE;QACrD,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEvD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC7B,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAC3B,OAAsB,EACtB,QAAoD,EACpD,WAA6B,EACzB,EAAE;IACN,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QAED,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;QACzE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvG,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,SAA2B,EAAE,IAAY,EAA8B,EAAE;IAC7F,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAExD,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,OAK1B,EAAW,EAAE;IACV,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IACxE,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAElG,OAAO,CACH,eAAe,KAAK,SAAS;QAC7B,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC;QAC5D,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,MAAM;YACjD,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAClE,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACnB,OAAsB,EACtB,QAAqB,EACrB,SAA2B,EAC3B,SAAiB,EACC,EAAE;IACpB,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAE9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAEvE,OAAO,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAE,UAAkB,EAAU,EAAE,CAC5E,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;AAExD,MAAM,0BAA0B,GAAG,CAAC,SAAiB,EAAE,QAAqB,EAAsB,EAAE,CAChG,uBAAuB,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC,CAAC,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC;IACjD,CAAC,CAAC,SAAS,CAAC;AAEpB,MAAM,eAAe,GAAG,CACpB,OAAsB,EACtB,MAA0B,EAC1B,YAAgC,EACzB,EAAE;IACT,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE1D,OAAO,OAAO,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,KAAK,aAAa,CAAC;AAC7F,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,OAAsB,EAAE,GAAgB,EAAE,SAA0B,EAAW,EAAE;IAC/G,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAEjE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAE9C,IACI,QAAQ,KAAK,SAAS;YACtB,cAAc,KAAK,SAAS;YAC5B,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,EAClF,CAAC;YACC,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,GAAuB,EAAsB,EAAE;IACzF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,QAAQ,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF,OAAO,EACH,4BAA4B,EAC5B,eAAe,EACf,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,cAAc,EACd,0BAA0B,GAE7B,CAAC","sourcesContent":["import { camelCase, lowerFirst, pascalCase, toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { GirProperty } from \"../gir/property.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\nimport { ancestorChain, type ResolvedAncestor, resolveInterfaces } from \"../gir/ancestry.js\";\nimport { methodExportName } from \"../store/gi/method.js\";\nimport { resolveAccessorType } from \"../store/gi/property-accessor.js\";\nimport { vfuncMemberNames } from \"../store/gi/vtable.js\";\nimport { inputParameters } from \"./param-structure.js\";\nimport { renderTsType } from \"./ts-type.js\";\n\ntype AncestryContext = {\n    library: Library;\n    namespace: { name: string };\n};\n\ntype OwnedProperty = { owner: GirClass; property: GirProperty };\ntype MethodSignature = { returnType: string; arity: number };\n\ntype InheritedMethod = {\n    method: GirFunction;\n    namespaceName: string;\n};\n\ntype InheritedMethods = {\n    returnTypes: Map<string, string>;\n    definitions: Map<string, InheritedMethod>;\n};\n\ntype InheritedMatch = {\n    inheritedReturn: string;\n    inheritedMethod: InheritedMethod;\n};\n\nconst RESERVED_SIGNAL_MEMBERS = new Set([\n    \"connect\",\n    \"disconnect\",\n    \"emit\",\n    \"on\",\n    \"once\",\n    \"off\",\n    \"addEventListener\",\n    \"removeEventListener\",\n]);\n\nconst resolveDirectInterfaces = (\n    context: AncestryContext,\n    klass: GirClass,\n    defaultNamespace: string,\n): ResolvedAncestor[] => resolveInterfaces(context.library, defaultNamespace, klass.implements);\n\nconst resolvePrerequisiteReference = (context: ModuleContext, name: string): string | undefined => {\n    const resolved = context.library.resolveType(context.namespace.name, name);\n\n    if (resolved === undefined) {\n        return undefined;\n    }\n\n    if (resolved.kind !== \"interface\" && resolved.kind !== \"class\") {\n        return undefined;\n    }\n\n    return context.qualify(resolved.namespace.name, pascalCase(resolved.value.name));\n};\n\nconst forEachAncestor = (\n    context: AncestryContext,\n    klass: GirClass,\n    visit: (ancestor: ResolvedAncestor, interfaces: ResolvedAncestor[]) => void,\n    shouldStop: (ancestor: GirClass) => boolean = () => false,\n): void => {\n    let isFirst = true;\n\n    for (const ancestor of ancestorChain(context.library, klass, context.namespace.name)) {\n        if (isFirst) {\n            isFirst = false;\n            continue;\n        }\n\n        if (shouldStop(ancestor.klass)) {\n            break;\n        }\n\n        visit(ancestor, resolveDirectInterfaces(context, ancestor.klass, ancestor.namespaceName));\n    }\n};\n\nconst visitInterfaceProperties = (\n    interfaces: ResolvedAncestor[],\n    visit: (owner: GirClass, property: GirProperty) => void,\n): void => {\n    for (const iface of interfaces) {\n        for (const property of iface.klass.properties) {\n            visit(iface.klass, property);\n        }\n    }\n};\n\nconst forEachInheritedProperty = (\n    context: ModuleContext,\n    klass: GirClass,\n    visit: (owner: GirClass, property: GirProperty) => void,\n): void => {\n    forEachAncestor(context, klass, (ancestor, interfaces) => {\n        for (const property of ancestor.klass.properties) {\n            visit(ancestor.klass, property);\n        }\n\n        visitInterfaceProperties(interfaces, visit);\n    });\n};\n\nconst collectSeenPropertyNames = (context: ModuleContext, klass: GirClass): Set<string> => {\n    const seen: Set<string> = new Set();\n\n    for (const property of klass.properties) {\n        seen.add(toCamelIdentifier(property.name));\n    }\n\n    forEachInheritedProperty(context, klass, (_owner, property) => seen.add(toCamelIdentifier(property.name)));\n\n    return seen;\n};\n\nconst collectNewInterfaceProperties = (iface: ResolvedAncestor, seen: Set<string>): OwnedProperty[] => {\n    const result: OwnedProperty[] = [];\n\n    for (const property of iface.klass.properties) {\n        const name = toCamelIdentifier(property.name);\n\n        if (seen.has(name)) {\n            continue;\n        }\n\n        seen.add(name);\n        result.push({ owner: iface.klass, property });\n    }\n\n    return result;\n};\n\nconst collectInterfaceProperties = (context: ModuleContext, klass: GirClass): OwnedProperty[] => {\n    const seen = collectSeenPropertyNames(context, klass);\n    const result: OwnedProperty[] = [];\n\n    for (const iface of resolveDirectInterfaces(context, klass, context.namespace.name)) {\n        result.push(...collectNewInterfaceProperties(iface, seen));\n    }\n\n    return result;\n};\n\nconst recordAncestorSignatures = (\n    context: ModuleContext,\n    klass: GirClass,\n    signatures: Map<string, MethodSignature>,\n): void => {\n    for (const method of klass.methods) {\n        const name = camelCase(method.name);\n\n        if (!method.introspectable || signatures.has(name)) {\n            continue;\n        }\n\n        signatures.set(name, {\n            returnType: renderTsType(context, method.returnValue.type, method.returnValue.nullable),\n            arity: inputParameters(context.library, method).length,\n        });\n    }\n};\n\nconst ancestorClassMethodSignatures = (context: ModuleContext, klass: GirClass): Map<string, MethodSignature> => {\n    const signatures: Map<string, MethodSignature> = new Map();\n\n    forEachAncestor(context, klass, (ancestor) => {\n        recordAncestorSignatures(context, ancestor.klass, signatures);\n    });\n\n    return signatures;\n};\n\nconst mergeOmissionName = (\n    context: ModuleContext,\n    method: GirFunction,\n    ancestors: Map<string, MethodSignature>,\n): string | undefined => {\n    if (!method.introspectable) {\n        return undefined;\n    }\n\n    const name = camelCase(method.name);\n    const ancestor = ancestors.get(name);\n\n    if (ancestor === undefined) {\n        return undefined;\n    }\n\n    const returnType = renderTsType(context, method.returnValue.type, method.returnValue.nullable);\n    const arity = inputParameters(context.library, method).length;\n\n    return ancestor.returnType !== returnType || ancestor.arity !== arity ? name : undefined;\n};\n\nconst classChainVfuncNames = (context: ModuleContext, klass: GirClass): Set<string> => {\n    const names: Set<string> = new Set(vfuncMemberNames(context, context.namespace.name, klass));\n\n    forEachAncestor(context, klass, (ancestor) => {\n        for (const name of vfuncMemberNames(context, ancestor.namespaceName, ancestor.klass)) {\n            names.add(name);\n        }\n    });\n\n    return names;\n};\n\nconst methodMergeOmissions = (context: ModuleContext, klass: GirClass, iface: GirClass): string[] => {\n    const ancestors = ancestorClassMethodSignatures(context, klass);\n\n    return iface.methods\n        .map((method) => mergeOmissionName(context, method, ancestors))\n        .filter((name): name is string => name !== undefined);\n};\n\nconst vfuncMergeOmissions = (\n    context: ModuleContext,\n    klass: GirClass,\n    iface: { klass: GirClass; namespaceName: string },\n): string[] => {\n    const claimed = classChainVfuncNames(context, klass);\n\n    return vfuncMemberNames(context, iface.namespaceName, iface.klass).filter((name) => claimed.has(name));\n};\n\nconst collectInterfaceMergeOmissions = (\n    context: ModuleContext,\n    klass: GirClass,\n    iface: { klass: GirClass; namespaceName: string },\n): string[] => [\n    ...methodMergeOmissions(context, klass, iface.klass),\n    ...vfuncMergeOmissions(context, klass, iface),\n];\n\nconst collectInheritedPropertyTypes = (context: ModuleContext, klass: GirClass): Map<string, string> => {\n    const types: Map<string, string> = new Map();\n\n    const record = (owner: GirClass, property: GirProperty): void => {\n        const jsName = toCamelIdentifier(property.name);\n\n        if (types.has(jsName)) {\n            return;\n        }\n\n        const tsType = resolveAccessorType(context, property, owner.methods);\n\n        if (tsType !== undefined) {\n            types.set(jsName, tsType);\n        }\n    };\n\n    forEachInheritedProperty(context, klass, record);\n\n    return types;\n};\n\nconst collectInheritedMethods = (context: ModuleContext, klass: GirClass): InheritedMethods => {\n    const accumulator: InheritedMethods = {\n        returnTypes: new Map<string, string>(),\n        definitions: new Map<string, InheritedMethod>(),\n    };\n\n    for (const iface of resolveDirectInterfaces(context, klass, context.namespace.name)) {\n        absorbInheritedMethods(context, iface, accumulator);\n    }\n\n    forEachAncestor(context, klass, (ancestor, interfaces) => {\n        absorbInheritedMethods(context, ancestor, accumulator);\n\n        for (const iface of interfaces) {\n            absorbInheritedMethods(context, iface, accumulator);\n        }\n    });\n\n    return accumulator;\n};\n\nconst absorbInheritedMethods = (\n    context: ModuleContext,\n    resolved: { klass: GirClass; namespaceName: string },\n    accumulator: InheritedMethods,\n): void => {\n    const { returnTypes, definitions } = accumulator;\n\n    for (const method of resolved.klass.methods) {\n        if (!method.introspectable) {\n            continue;\n        }\n\n        const name = camelCase(method.name);\n\n        if (returnTypes.has(name)) {\n            continue;\n        }\n\n        definitions.set(name, { method, namespaceName: resolved.namespaceName });\n        returnTypes.set(name, renderTsType(context, method.returnValue.type, method.returnValue.nullable));\n    }\n};\n\nconst inheritedMatch = (inherited: InheritedMethods, name: string): InheritedMatch | undefined => {\n    const inheritedReturn = inherited.returnTypes.get(name);\n    const inheritedMethod = inherited.definitions.get(name);\n\n    if (inheritedReturn === undefined || inheritedMethod === undefined) {\n        return undefined;\n    }\n\n    return { inheritedReturn, inheritedMethod };\n};\n\nconst hasMethodConflict = (options: {\n    context: ModuleContext;\n    callable: GirFunction;\n    inheritedReturn: string;\n    inheritedMethod: InheritedMethod;\n}): boolean => {\n    const { context, callable, inheritedReturn, inheritedMethod } = options;\n    const ownReturn = renderTsType(context, callable.returnValue.type, callable.returnValue.nullable);\n\n    return (\n        inheritedReturn !== ownReturn ||\n        hasParameterEnumConflict(context, callable, inheritedMethod) ||\n        inputParameters(context.library, callable).length !==\n        inputParameters(context.library, inheritedMethod.method).length\n    );\n};\n\nconst conflictRename = (\n    context: ModuleContext,\n    callable: GirFunction,\n    inherited: InheritedMethods,\n    className: string,\n): string | undefined => {\n    if (!callable.introspectable) {\n        return undefined;\n    }\n\n    const name = methodExportName(callable);\n\n    if (RESERVED_SIGNAL_MEMBERS.has(name)) {\n        return conflictingMethodName(className, callable.name);\n    }\n\n    const match = inheritedMatch(inherited, name);\n\n    if (match === undefined) {\n        return undefined;\n    }\n\n    const hasConflict = hasMethodConflict({ context, callable, ...match });\n\n    return hasConflict ? conflictingMethodName(className, callable.name) : undefined;\n};\n\nconst conflictingMethodName = (className: string, methodName: string): string =>\n    `${lowerFirst(className)}${pascalCase(methodName)}`;\n\nconst reservedSignalMemberRename = (className: string, callable: GirFunction): string | undefined =>\n    RESERVED_SIGNAL_MEMBERS.has(methodExportName(callable))\n        ? conflictingMethodName(className, callable.name)\n        : undefined;\n\nconst hasEnumConflict = (\n    context: ModuleContext,\n    ownRef: TypeId | undefined,\n    inheritedRef: TypeId | undefined,\n): boolean => {\n    const ownEnum = enumIdentity(context, ownRef);\n    const inheritedEnum = enumIdentity(context, inheritedRef);\n\n    return ownEnum !== undefined && inheritedEnum !== undefined && ownEnum !== inheritedEnum;\n};\n\nconst hasParameterEnumConflict = (context: ModuleContext, own: GirFunction, inherited: InheritedMethod): boolean => {\n    const ownParams = inputParameters(context.library, own);\n    const inheritedParams = inputParameters(context.library, inherited.method);\n    const count = Math.min(ownParams.length, inheritedParams.length);\n\n    for (let index = 0; index < count; index += 1) {\n        const ownParam = ownParams[index];\n        const inheritedParam = inheritedParams[index];\n\n        if (\n            ownParam !== undefined &&\n            inheritedParam !== undefined &&\n            hasEnumConflict(context, ownParam.parameter.type, inheritedParam.parameter.type)\n        ) {\n            return true;\n        }\n    }\n\n    return false;\n};\n\nconst enumIdentity = (context: ModuleContext, ref: TypeId | undefined): string | undefined => {\n    if (ref === undefined) {\n        return undefined;\n    }\n\n    const resolved = context.library.typeFor(ref);\n\n    if (resolved?.kind !== \"enum\") {\n        return undefined;\n    }\n\n    return `${resolved.namespace.name}.${resolved.value.name}`;\n};\n\nexport {\n    resolvePrerequisiteReference,\n    forEachAncestor,\n    collectInterfaceProperties,\n    collectInterfaceMergeOmissions,\n    collectInheritedPropertyTypes,\n    collectInheritedMethods,\n    conflictRename,\n    reservedSignalMemberRename,\n    type InheritedMethods,\n};\n"]}

package/dist/analysis/nul-terminated-bytes.d.ts

@@ -0,0 +1,5 @@
+import type { Library } from "../gir/library.js";
+import type { GirCallable, GirParameter } from "../gir/parameter.js";
+declare const nulTerminatedByteParams: (library: Library, callable: GirCallable) => GirParameter[];
+export { nulTerminatedByteParams };
+//# sourceMappingURL=nul-terminated-bytes.d.ts.map

package/dist/analysis/nul-terminated-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-terminated-bytes.d.ts","sourceRoot":"","sources":["../../src/analysis/nul-terminated-bytes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAwBrE,QAAA,MAAM,uBAAuB,GAAI,SAAS,OAAO,EAAE,UAAU,WAAW,KAAG,YAAY,EAGlF,CAAC;AAEN,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/analysis/nul-terminated-bytes.js

@@ -0,0 +1,18 @@
+import { isOutParameter } from "../gir/parameter.js";
+import { carrayFor, isUnboundedArray, primitiveCategoryFor } from "./type-shape.js";
+const BYTE_CATEGORIES = new Set(["int8", "uint8"]);
+const CHAR_POINTER = /char\s*\*/;
+const isByteElement = (library, element) => {
+    const category = primitiveCategoryFor(library, element);
+    return category !== undefined && BYTE_CATEGORIES.has(category);
+};
+const isNulTerminatedBytes = (library, ref) => {
+    const type = carrayFor(library, ref);
+    if (type?.arrayCType === undefined || !CHAR_POINTER.test(type.arrayCType)) {
+        return false;
+    }
+    return isUnboundedArray(type) && isByteElement(library, type.element);
+};
+const nulTerminatedByteParams = (library, callable) => callable.parameters.filter((parameter) => !isOutParameter(parameter) && isNulTerminatedBytes(library, parameter.type));
+export { nulTerminatedByteParams };
+//# sourceMappingURL=nul-terminated-bytes.js.map

package/dist/analysis/nul-terminated-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nul-terminated-bytes.js","sourceRoot":"","sources":["../../src/analysis/nul-terminated-bytes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,eAAe,GAAgB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC,MAAM,aAAa,GAAG,CAAC,OAAgB,EAAE,OAAe,EAAW,EAAE;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAExD,OAAO,QAAQ,KAAK,SAAS,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAW,EAAE;IAChF,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAErC,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,OAAgB,EAAE,QAAqB,EAAkB,EAAE,CACxF,QAAQ,CAAC,UAAU,CAAC,MAAM,CACtB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAC7F,CAAC;AAEN,OAAO,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { GirCallable, GirParameter } from \"../gir/parameter.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport { isOutParameter } from \"../gir/parameter.js\";\nimport { carrayFor, isUnboundedArray, primitiveCategoryFor } from \"./type-shape.js\";\n\nconst BYTE_CATEGORIES: Set<string> = new Set([\"int8\", \"uint8\"]);\nconst CHAR_POINTER = /char\\s*\\*/;\n\nconst isByteElement = (library: Library, element: TypeId): boolean => {\n    const category = primitiveCategoryFor(library, element);\n\n    return category !== undefined && BYTE_CATEGORIES.has(category);\n};\n\nconst isNulTerminatedBytes = (library: Library, ref: TypeId | undefined): boolean => {\n    const type = carrayFor(library, ref);\n\n    if (type?.arrayCType === undefined || !CHAR_POINTER.test(type.arrayCType)) {\n        return false;\n    }\n\n    return isUnboundedArray(type) && isByteElement(library, type.element);\n};\n\nconst nulTerminatedByteParams = (library: Library, callable: GirCallable): GirParameter[] =>\n    callable.parameters.filter(\n        (parameter) => !isOutParameter(parameter) && isNulTerminatedBytes(library, parameter.type),\n    );\n\nexport { nulTerminatedByteParams };\n"]}

package/dist/analysis/param-capability.d.ts

@@ -0,0 +1,5 @@
+import type { GirCallable } from "../gir/parameter.js";
+import type { ModuleContext } from "../writer/context.js";
+declare const hasUnmarshalableParam: (context: ModuleContext, callable: GirCallable) => boolean;
+export { hasUnmarshalableParam };
+//# sourceMappingURL=param-capability.d.ts.map

package/dist/analysis/param-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-capability.d.ts","sourceRoot":"","sources":["../../src/analysis/param-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqK1D,QAAA,MAAM,qBAAqB,GAAI,SAAS,aAAa,EAAE,UAAU,WAAW,KAAG,OACU,CAAC;AAE1F,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/analysis/param-capability.js

@@ -0,0 +1,130 @@
+import { isCallerAllocatedOut, isInoutParameter } from "../gir/parameter.js";
+import { constructibleName } from "../store/gi/method.js";
+import { isCollectibleCallerOut, isHandlePassedInPlace, underlyingType } from "../store/gi/param-marshal.js";
+import { isScalarRef, recordInlineSize } from "./descriptor-render.js";
+const POINTER_DEPTH = 1;
+const isPointerType = (context, type) => {
+    switch (type.kind) {
+        case "primitive": {
+            return type.category === "string";
+        }
+        case "record": {
+            return recordInlineSize(context, type.value) === undefined;
+        }
+        case "class":
+        case "interface":
+        case "carray":
+        case "list":
+        case "hashtable": {
+            return true;
+        }
+        case "alias":
+        case "callback":
+        case "enum":
+        case "varargs": {
+            return false;
+        }
+    }
+};
+const isPointerElement = (context, element) => {
+    if (isScalarRef(context.library, element)) {
+        return false;
+    }
+    const type = underlyingType(context, element);
+    return type !== undefined && isPointerType(context, type);
+};
+const carrayIndirection = (context, type) => POINTER_DEPTH + (isPointerElement(context, type.element) ? POINTER_DEPTH : 0);
+const typeIndirection = (context, type) => {
+    switch (type.kind) {
+        case "primitive": {
+            return type.category === "string" ? POINTER_DEPTH : undefined;
+        }
+        case "callback":
+        case "class":
+        case "hashtable":
+        case "interface":
+        case "list":
+        case "record": {
+            return POINTER_DEPTH;
+        }
+        case "carray": {
+            return carrayIndirection(context, type);
+        }
+        case "alias":
+        case "enum":
+        case "varargs": {
+            return undefined;
+        }
+    }
+};
+const baseIndirection = (context, ref) => {
+    if (isScalarRef(context.library, ref)) {
+        return 0;
+    }
+    const type = ref === undefined ? undefined : underlyingType(context, ref);
+    return type === undefined ? undefined : typeIndirection(context, type);
+};
+const declaredIndirection = (parameter) => {
+    const cType = parameter.cType;
+    if (cType === undefined) {
+        return undefined;
+    }
+    return cType.split("*").length - 1;
+};
+const marshalledIndirection = (context, parameter) => {
+    const base = baseIndirection(context, parameter.type);
+    if (base === undefined) {
+        return undefined;
+    }
+    if (isCallerAllocatedOut(parameter) || isHandlePassedInPlace(context, parameter)) {
+        return base;
+    }
+    if (isInoutParameter(parameter) && !isScalarRef(context.library, parameter.type)) {
+        return base;
+    }
+    return base + POINTER_DEPTH;
+};
+const hasCallerSuppliedLength = (context, parameter) => {
+    const type = parameter.type === undefined ? undefined : underlyingType(context, parameter.type);
+    return type?.kind === "carray" && type.lengthParameterIndex !== undefined;
+};
+const isUnbuildableCallerOut = (context, parameter) => constructibleName(context, parameter.type) === undefined || !isCollectibleCallerOut(context, parameter);
+const isUnmarshalableCallerOut = (context, parameter) => {
+    if (hasCallerSuppliedLength(context, parameter)) {
+        return true;
+    }
+    return isUnbuildableCallerOut(context, parameter) && !parameter.optional;
+};
+const hasIndirectionMismatch = (context, parameter) => {
+    const declared = declaredIndirection(parameter);
+    const marshalled = marshalledIndirection(context, parameter);
+    if (declared === undefined || marshalled === undefined) {
+        return false;
+    }
+    return declared !== marshalled;
+};
+const isTypeErasedCallback = (context, parameter) => {
+    if (parameter.closureIndex === undefined) {
+        return false;
+    }
+    const type = parameter.type === undefined ? undefined : underlyingType(context, parameter.type);
+    return type?.kind === "callback" && type.value.parameters.length === 0;
+};
+const isUnmarshalableCallParam = (context, parameter) => {
+    if (parameter.isVarargs) {
+        return false;
+    }
+    if (isTypeErasedCallback(context, parameter)) {
+        return true;
+    }
+    if (parameter.direction === "in") {
+        return false;
+    }
+    if (isCallerAllocatedOut(parameter)) {
+        return isUnmarshalableCallerOut(context, parameter);
+    }
+    return hasIndirectionMismatch(context, parameter);
+};
+const hasUnmarshalableParam = (context, callable) => callable.parameters.some((parameter) => isUnmarshalableCallParam(context, parameter));
+export { hasUnmarshalableParam };
+//# sourceMappingURL=param-capability.js.map

package/dist/analysis/param-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-capability.js","sourceRoot":"","sources":["../../src/analysis/param-capability.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GirCallable, GirParameter } from \"../gir/parameter.js\";\nimport type { CArrayType, TypeId } from \"../gir/type-id.js\";\nimport type { GirType } from \"../gir/type.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\nimport { isCallerAllocatedOut, isInoutParameter } from \"../gir/parameter.js\";\nimport { constructibleName } from \"../store/gi/method.js\";\nimport { isCollectibleCallerOut, isHandlePassedInPlace, underlyingType } from \"../store/gi/param-marshal.js\";\nimport { isScalarRef, recordInlineSize } from \"./descriptor-render.js\";\n\nconst POINTER_DEPTH = 1;\n\nconst isPointerType = (context: ModuleContext, type: GirType): boolean => {\n    switch (type.kind) {\n        case \"primitive\": {\n            return type.category === \"string\";\n        }\n        case \"record\": {\n            return recordInlineSize(context, type.value) === undefined;\n        }\n        case \"class\":\n        case \"interface\":\n        case \"carray\":\n        case \"list\":\n        case \"hashtable\": {\n            return true;\n        }\n        case \"alias\":\n        case \"callback\":\n        case \"enum\":\n        case \"varargs\": {\n            return false;\n        }\n    }\n};\n\nconst isPointerElement = (context: ModuleContext, element: TypeId): boolean => {\n    if (isScalarRef(context.library, element)) {\n        return false;\n    }\n\n    const type = underlyingType(context, element);\n\n    return type !== undefined && isPointerType(context, type);\n};\n\nconst carrayIndirection = (context: ModuleContext, type: CArrayType): number =>\n    POINTER_DEPTH + (isPointerElement(context, type.element) ? POINTER_DEPTH : 0);\n\nconst typeIndirection = (context: ModuleContext, type: GirType): number | undefined => {\n    switch (type.kind) {\n        case \"primitive\": {\n            return type.category === \"string\" ? POINTER_DEPTH : undefined;\n        }\n        case \"callback\":\n        case \"class\":\n        case \"hashtable\":\n        case \"interface\":\n        case \"list\":\n        case \"record\": {\n            return POINTER_DEPTH;\n        }\n        case \"carray\": {\n            return carrayIndirection(context, type);\n        }\n        case \"alias\":\n        case \"enum\":\n        case \"varargs\": {\n            return undefined;\n        }\n    }\n};\n\nconst baseIndirection = (context: ModuleContext, ref: TypeId | undefined): number | undefined => {\n    if (isScalarRef(context.library, ref)) {\n        return 0;\n    }\n\n    const type = ref === undefined ? undefined : underlyingType(context, ref);\n\n    return type === undefined ? undefined : typeIndirection(context, type);\n};\n\nconst declaredIndirection = (parameter: GirParameter): number | undefined => {\n    const cType = parameter.cType;\n\n    if (cType === undefined) {\n        return undefined;\n    }\n\n    return cType.split(\"*\").length - 1;\n};\n\nconst marshalledIndirection = (context: ModuleContext, parameter: GirParameter): number | undefined => {\n    const base = baseIndirection(context, parameter.type);\n\n    if (base === undefined) {\n        return undefined;\n    }\n\n    if (isCallerAllocatedOut(parameter) || isHandlePassedInPlace(context, parameter)) {\n        return base;\n    }\n\n    if (isInoutParameter(parameter) && !isScalarRef(context.library, parameter.type)) {\n        return base;\n    }\n\n    return base + POINTER_DEPTH;\n};\n\nconst hasCallerSuppliedLength = (context: ModuleContext, parameter: GirParameter): boolean => {\n    const type = parameter.type === undefined ? undefined : underlyingType(context, parameter.type);\n\n    return type?.kind === \"carray\" && type.lengthParameterIndex !== undefined;\n};\n\nconst isUnbuildableCallerOut = (context: ModuleContext, parameter: GirParameter): boolean =>\n    constructibleName(context, parameter.type) === undefined || !isCollectibleCallerOut(context, parameter);\n\nconst isUnmarshalableCallerOut = (context: ModuleContext, parameter: GirParameter): boolean => {\n    if (hasCallerSuppliedLength(context, parameter)) {\n        return true;\n    }\n\n    return isUnbuildableCallerOut(context, parameter) && !parameter.optional;\n};\n\nconst hasIndirectionMismatch = (context: ModuleContext, parameter: GirParameter): boolean => {\n    const declared = declaredIndirection(parameter);\n    const marshalled = marshalledIndirection(context, parameter);\n\n    if (declared === undefined || marshalled === undefined) {\n        return false;\n    }\n\n    return declared !== marshalled;\n};\n\nconst isTypeErasedCallback = (context: ModuleContext, parameter: GirParameter): boolean => {\n    if (parameter.closureIndex === undefined) {\n        return false;\n    }\n\n    const type = parameter.type === undefined ? undefined : underlyingType(context, parameter.type);\n\n    return type?.kind === \"callback\" && type.value.parameters.length === 0;\n};\n\nconst isUnmarshalableCallParam = (context: ModuleContext, parameter: GirParameter): boolean => {\n    if (parameter.isVarargs) {\n        return false;\n    }\n\n    if (isTypeErasedCallback(context, parameter)) {\n        return true;\n    }\n\n    if (parameter.direction === \"in\") {\n        return false;\n    }\n\n    if (isCallerAllocatedOut(parameter)) {\n        return isUnmarshalableCallerOut(context, parameter);\n    }\n\n    return hasIndirectionMismatch(context, parameter);\n};\n\nconst hasUnmarshalableParam = (context: ModuleContext, callable: GirCallable): boolean =>\n    callable.parameters.some((parameter) => isUnmarshalableCallParam(context, parameter));\n\nexport { hasUnmarshalableParam };\n"]}

package/dist/analysis/param-structure.d.ts

@@ -1,6 +1,7 @@
 import type { GirFunction } from "../gir/function.js";
 import type { Library } from "../gir/library.js";
 import type { TypeId } from "../gir/type-id.js";
+import type { JsDocParam } from "../writer/doc-tags.js";
 import { type GirCallable, type GirParameter } from "../gir/parameter.js";
 type InputParameter = {
     parameter: GirParameter;
@@ -12,16 +13,22 @@ type HandlerResultOptions = {
     renderType: (ref: TypeId | undefined, isNullable: boolean) => string;
     shouldIncludeCallerAllocated: boolean;
     isOptOut: boolean;
+    shouldExcludeOut?: (parameter: GirParameter) => boolean;
 };
 declare const inputParameters: (library: Library, fn: GirFunction) => InputParameter[];
 declare const closureAndDestroyIndices: (fn: GirFunction) => Set<number>;
 declare const emittedArgIndices: (fn: GirFunction, instanceOffset: number) => Map<number, number>;
-declare const arrayLengthSources: (library: Library, fn: GirFunction) => Map<number, number>;
-declare const hasCallerAllocatedArrayLength: (library: Library, fn: GirFunction) => boolean;
-declare const foldedLengthIndices: (library: Library, fn: GirFunction) => Set<number>;
+declare const arrayLengthSources: (library: Library, fn: GirCallable) => Map<number, number>;
+declare const foldedLengthIndices: (library: Library, fn: GirCallable) => Set<number>;
+declare const foldedLengthParameters: (library: Library, fn: GirCallable) => Set<GirParameter>;
 declare const parameterIdentifier: (parameter: GirParameter, index: number) => string;
+declare const handlerParameters: (parameters: GirParameter[], shouldExclude?: (parameter: GirParameter) => boolean) => GirParameter[];
+declare const documentedParameters: (library: Library, fn: GirFunction, shouldSkip?: (parameter: GirParameter) => boolean, renames?: Map<string, string>) => JsDocParam[];
+declare const documentedHandlerParameters: (parameters: GirParameter[]) => JsDocParam[];
+declare const handlerRenames: (parameters: GirParameter[]) => Map<string, string>;
+declare const renamesWithInstance: (parameters: GirParameter[], instance: GirParameter | undefined) => Map<string, string>;
 declare const renderHandlerParameters: (parameters: GirParameter[], renderType: (ref: TypeId | undefined, isNullable: boolean) => string, shouldExclude?: (parameter: GirParameter) => boolean) => string[];
 declare const foldOutParamShape: (primary: string | undefined, outTypes: string[]) => string;
 declare const renderHandlerResultType: (options: HandlerResultOptions) => string;
-export { emittedArgIndices, inputParameters, closureAndDestroyIndices, arrayLengthSources, hasCallerAllocatedArrayLength, foldedLengthIndices, parameterIdentifier, renderHandlerParameters, foldOutParamShape, renderHandlerResultType, };
+export { emittedArgIndices, inputParameters, closureAndDestroyIndices, arrayLengthSources, foldedLengthIndices, foldedLengthParameters, parameterIdentifier, documentedParameters, documentedHandlerParameters, handlerRenames, renamesWithInstance, handlerParameters, renderHandlerParameters, foldOutParamShape, renderHandlerResultType, type InputParameter, };
 //# sourceMappingURL=param-structure.d.ts.map

package/dist/analysis/param-structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param-structure.d.ts","sourceRoot":"","sources":["../../src/analysis/param-structure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAwC,MAAM,qBAAqB,CAAC;AAGhH,KAAK,cAAc,GAAG;IAClB,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,CAAC;IACrE,4BAA4B,EAAE,OAAO,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AA6BF,QAAA,MAAM,eAAe,GAAI,SAAS,OAAO,EAAE,IAAI,WAAW,KAAG,cAAc,EAY1E,CAAC;AAEF,QAAA,MAAM,wBAAwB,GAAI,IAAI,WAAW,KAAG,GAAG,CAAC,MAAM,CAc7D,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,IAAI,WAAW,EAAE,gBAAgB,MAAM,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAetF,CAAC;AAkBF,QAAA,MAAM,kBAAkB,GAAI,SAAS,OAAO,EAAE,IAAI,WAAW,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAYjF,CAAC;AAEF,QAAA,MAAM,6BAA6B,GAAI,SAAS,OAAO,EAAE,IAAI,WAAW,KAAG,OAU1E,CAAC;AAkBF,QAAA,MAAM,mBAAmB,GAAI,SAAS,OAAO,EAAE,IAAI,WAAW,KAAG,GAAG,CAAC,MAAM,CAQ1E,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,WAAW,YAAY,EAAE,OAAO,MAAM,KAAG,MAMrE,CAAC;AAEF,QAAA,MAAM,uBAAuB,GACzB,YAAY,YAAY,EAAE,EAC1B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,EACpE,gBAAe,CAAC,SAAS,EAAE,YAAY,KAAK,OAAqB,KAClE,MAAM,EAMA,CAAC;AAEV,QAAA,MAAM,iBAAiB,GAAI,SAAS,MAAM,GAAG,SAAS,EAAE,UAAU,MAAM,EAAE,KAAG,MAY5E,CAAC;AAgCF,QAAA,MAAM,uBAAuB,GAAI,SAAS,oBAAoB,KAAG,MAgBhE,CAAC;AAEF,OAAO,EACH,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,GAC1B,CAAC"}
+{"version":3,"file":"param-structure.d.ts","sourceRoot":"","sources":["../../src/analysis/param-structure.ts"],"names":[],"mappings":"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"}

package/dist/analysis/param-structure.js

@@ -74,15 +74,6 @@ const arrayLengthSources = (library, fn) => {
     }
     return map;
 };
-const hasCallerAllocatedArrayLength = (library, fn) => {
-    for (const arrayIndex of arrayLengthSources(library, fn).values()) {
-        const array = fn.parameters[arrayIndex];
-        if (array !== undefined && isCallerAllocatedOut(array)) {
-            return true;
-        }
-    }
-    return false;
-};
 const returnArrayLengthIndices = (library, fn) => {
     const returnType = fn.returnValue.type === undefined ? undefined : library.typeFor(fn.returnValue.type);
     if (returnType?.kind !== "carray") {
@@ -101,15 +92,48 @@ const foldedLengthIndices = (library, fn) => {
     }
     return indices;
 };
+const foldedLengthParameters = (library, fn) => {
+    const folded = new Set();
+    for (const index of foldedLengthIndices(library, fn)) {
+        const parameter = fn.parameters[index];
+        if (parameter !== undefined) {
+            folded.add(parameter);
+        }
+    }
+    return folded;
+};
 const parameterIdentifier = (parameter, index) => {
     if (parameter.name.length === 0) {
         return `arg${String(index)}`;
     }
     return toCamelIdentifier(parameter.name);
 };
-const renderHandlerParameters = (parameters, renderType, shouldExclude = () => false) => parameters
-    .filter((parameter) => !parameter.isVarargs && !isOutParameter(parameter) && !shouldExclude(parameter))
-    .map((parameter, index) => `${parameterIdentifier(parameter, index)}: ${renderType(parameter.type, parameter.nullable)}`);
+const handlerParameters = (parameters, shouldExclude = () => false) => parameters.filter((parameter) => !parameter.isVarargs && !isOutParameter(parameter) && !shouldExclude(parameter));
+const documentedParameters = (library, fn, shouldSkip = () => false, renames) => inputParameters(library, fn)
+    .filter(({ parameter }) => !shouldSkip(parameter))
+    .map(({ parameter, index }) => ({
+    name: renames?.get(parameter.name) ?? parameterIdentifier(parameter, index),
+    doc: parameter.doc ?? "",
+}))
+    .filter((entry) => entry.doc.length > 0);
+const documentedHandlerParameters = (parameters) => handlerParameters(parameters)
+    .map((parameter, index) => ({ name: parameterIdentifier(parameter, index), doc: parameter.doc ?? "" }))
+    .filter((entry) => entry.doc.length > 0);
+const handlerRenames = (parameters) => {
+    const renames = new Map();
+    for (const [index, parameter] of parameters.entries()) {
+        renames.set(parameter.name, parameterIdentifier(parameter, index));
+    }
+    return renames;
+};
+const renamesWithInstance = (parameters, instance) => {
+    const renames = handlerRenames(parameters);
+    if (instance !== undefined && instance.name.length > 0) {
+        renames.set(instance.name, "this");
+    }
+    return renames;
+};
+const renderHandlerParameters = (parameters, renderType, shouldExclude = () => false) => handlerParameters(parameters, shouldExclude).map((parameter, index) => `${parameterIdentifier(parameter, index)}: ${renderType(parameter.type, parameter.nullable)}`);
 const foldOutParamShape = (primary, outTypes) => {
     if (primary !== undefined) {
         return `[${primary}, ${outTypes.join(", ")}]`;
@@ -141,16 +165,18 @@ const scalarResultType = (primary, isOptOut) => {
 };
 const renderHandlerResultType = (options) => {
     const { library, signal, renderType, shouldIncludeCallerAllocated, isOptOut } = options;
+    const shouldExcludeOut = options.shouldExcludeOut ?? (() => false);
     const primary = shouldOmitPrimaryReturn(library, signal.returnValue)
         ? undefined
         : renderType(signal.returnValue.type, signal.returnValue.nullable);
     const outTypes = signal.parameters
-        .filter((parameter) => isHandlerOutParameter({ library, parameter, shouldIncludeCallerAllocated }))
+        .filter((parameter) => isHandlerOutParameter({ library, parameter, shouldIncludeCallerAllocated }) &&
+        !shouldExcludeOut(parameter))
         .map((parameter) => renderType(parameter.type, parameter.nullable));
     if (outTypes.length === 0) {
         return scalarResultType(primary, isOptOut);
     }
     return foldOutParamShape(primary, outTypes);
 };
-export { emittedArgIndices, inputParameters, closureAndDestroyIndices, arrayLengthSources, hasCallerAllocatedArrayLength, foldedLengthIndices, parameterIdentifier, renderHandlerParameters, foldOutParamShape, renderHandlerResultType, };
+export { emittedArgIndices, inputParameters, closureAndDestroyIndices, arrayLengthSources, foldedLengthIndices, foldedLengthParameters, parameterIdentifier, documentedParameters, documentedHandlerParameters, handlerRenames, renamesWithInstance, handlerParameters, renderHandlerParameters, foldOutParamShape, renderHandlerResultType, };
 //# sourceMappingURL=param-structure.js.map

package/dist/analysis/param-structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"param-structure.js","sourceRoot":"","sources":["../../src/analysis/param-structure.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport { type GirCallable, type GirParameter, isCallerAllocatedOut, isOutParameter } from \"../gir/parameter.js\";\nimport { isCellInout, shouldOmitPrimaryReturn } from \"./descriptor-render.js\";\n\ntype InputParameter = {\n    parameter: GirParameter;\n    index: number;\n};\n\ntype HandlerResultOptions = {\n    library: Library;\n    signal: GirCallable;\n    renderType: (ref: TypeId | undefined, isNullable: boolean) => string;\n    shouldIncludeCallerAllocated: boolean;\n    isOptOut: boolean;\n};\n\nconst isInputParameter = (options: {\n    parameter: GirParameter;\n    index: number;\n    lengthIndices: Set<number>;\n    closureIndices: Set<number>;\n}): boolean => {\n    const { parameter, index, lengthIndices, closureIndices } = options;\n\n    if (parameter.isVarargs) {\n        return false;\n    }\n\n    if (isOutParameter(parameter)) {\n        return false;\n    }\n\n    if (isCallerAllocatedOut(parameter)) {\n        return false;\n    }\n\n    if (lengthIndices.has(index)) {\n        return false;\n    }\n\n    return !closureIndices.has(index);\n};\n\nconst inputParameters = (library: Library, fn: GirFunction): InputParameter[] => {\n    const lengthIndices = arrayLengthIndices(library, fn);\n    const closureIndices = closureAndDestroyIndices(fn);\n    const result: InputParameter[] = [];\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        if (isInputParameter({ parameter, index, lengthIndices, closureIndices })) {\n            result.push({ parameter, index });\n        }\n    }\n\n    return result;\n};\n\nconst closureAndDestroyIndices = (fn: GirFunction): Set<number> => {\n    const indices: Set<number> = new Set();\n\n    for (const parameter of fn.parameters) {\n        if (parameter.closureIndex !== undefined) {\n            indices.add(parameter.closureIndex);\n        }\n\n        if (parameter.destroyIndex !== undefined) {\n            indices.add(parameter.destroyIndex);\n        }\n    }\n\n    return indices;\n};\n\nconst emittedArgIndices = (fn: GirFunction, instanceOffset: number): Map<number, number> => {\n    const closureIndices = closureAndDestroyIndices(fn);\n    const map: Map<number, number> = new Map();\n    let emitted = instanceOffset;\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        if (parameter.isVarargs || closureIndices.has(index)) {\n            continue;\n        }\n\n        map.set(index, emitted);\n        emitted += 1;\n    }\n\n    return map;\n};\n\nconst arrayLengthIndices = (library: Library, fn: GirFunction): Set<number> => {\n    const map = arrayLengthSources(library, fn);\n\n    return new Set(map.keys());\n};\n\nconst carrayLengthIndex = (library: Library, ref: TypeId | undefined): number | undefined => {\n    const type = ref === undefined ? undefined : library.typeFor(ref);\n\n    if (type?.kind !== \"carray\") {\n        return undefined;\n    }\n\n    return type.lengthParameterIndex;\n};\n\nconst arrayLengthSources = (library: Library, fn: GirFunction): Map<number, number> => {\n    const map: Map<number, number> = new Map();\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        const lengthIndex = carrayLengthIndex(library, parameter.type);\n\n        if (lengthIndex !== undefined) {\n            map.set(lengthIndex, index);\n        }\n    }\n\n    return map;\n};\n\nconst hasCallerAllocatedArrayLength = (library: Library, fn: GirFunction): boolean => {\n    for (const arrayIndex of arrayLengthSources(library, fn).values()) {\n        const array = fn.parameters[arrayIndex];\n\n        if (array !== undefined && isCallerAllocatedOut(array)) {\n            return true;\n        }\n    }\n\n    return false;\n};\n\nconst returnArrayLengthIndices = (library: Library, fn: GirFunction): Set<number> => {\n    const returnType = fn.returnValue.type === undefined ? undefined : library.typeFor(fn.returnValue.type);\n\n    if (returnType?.kind !== \"carray\") {\n        return new Set();\n    }\n\n    const lengthIndex = returnType.lengthParameterIndex;\n\n    if (lengthIndex === undefined) {\n        return new Set();\n    }\n\n    return new Set([lengthIndex]);\n};\n\nconst foldedLengthIndices = (library: Library, fn: GirFunction): Set<number> => {\n    const indices: Set<number> = new Set(arrayLengthSources(library, fn).keys());\n\n    for (const index of returnArrayLengthIndices(library, fn)) {\n        indices.add(index);\n    }\n\n    return indices;\n};\n\nconst parameterIdentifier = (parameter: GirParameter, index: number): string => {\n    if (parameter.name.length === 0) {\n        return `arg${String(index)}`;\n    }\n\n    return toCamelIdentifier(parameter.name);\n};\n\nconst renderHandlerParameters = (\n    parameters: GirParameter[],\n    renderType: (ref: TypeId | undefined, isNullable: boolean) => string,\n    shouldExclude: (parameter: GirParameter) => boolean = () => false,\n): string[] =>\n    parameters\n        .filter((parameter) => !parameter.isVarargs && !isOutParameter(parameter) && !shouldExclude(parameter))\n        .map(\n            (parameter, index) =>\n                `${parameterIdentifier(parameter, index)}: ${renderType(parameter.type, parameter.nullable)}`,\n        );\n\nconst foldOutParamShape = (primary: string | undefined, outTypes: string[]): string => {\n    if (primary !== undefined) {\n        return `[${primary}, ${outTypes.join(\", \")}]`;\n    }\n\n    const [single, ...rest] = outTypes;\n\n    if (single !== undefined && rest.length === 0) {\n        return single;\n    }\n\n    return `[${outTypes.join(\", \")}]`;\n};\n\nconst isHandlerOutParameter = (options: {\n    library: Library;\n    parameter: GirParameter;\n    shouldIncludeCallerAllocated: boolean;\n}): boolean => {\n    const { library, parameter, shouldIncludeCallerAllocated } = options;\n\n    if (parameter.isVarargs) {\n        return false;\n    }\n\n    if (isOutParameter(parameter)) {\n        return true;\n    }\n\n    if (isCellInout(library, parameter)) {\n        return true;\n    }\n\n    return shouldIncludeCallerAllocated && isCallerAllocatedOut(parameter);\n};\n\nconst scalarResultType = (primary: string | undefined, isOptOut: boolean): string => {\n    if (primary === undefined) {\n        return \"void\";\n    }\n\n    return isOptOut ? `${primary} | undefined` : primary;\n};\n\nconst renderHandlerResultType = (options: HandlerResultOptions): string => {\n    const { library, signal, renderType, shouldIncludeCallerAllocated, isOptOut } = options;\n\n    const primary = shouldOmitPrimaryReturn(library, signal.returnValue)\n        ? undefined\n        : renderType(signal.returnValue.type, signal.returnValue.nullable);\n\n    const outTypes = signal.parameters\n        .filter((parameter) => isHandlerOutParameter({ library, parameter, shouldIncludeCallerAllocated }))\n        .map((parameter) => renderType(parameter.type, parameter.nullable));\n\n    if (outTypes.length === 0) {\n        return scalarResultType(primary, isOptOut);\n    }\n\n    return foldOutParamShape(primary, outTypes);\n};\n\nexport {\n    emittedArgIndices,\n    inputParameters,\n    closureAndDestroyIndices,\n    arrayLengthSources,\n    hasCallerAllocatedArrayLength,\n    foldedLengthIndices,\n    parameterIdentifier,\n    renderHandlerParameters,\n    foldOutParamShape,\n    renderHandlerResultType,\n};\n"]}
+{"version":3,"file":"param-structure.js","sourceRoot":"","sources":["../../src/analysis/param-structure.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport type { JsDocParam } from \"../writer/doc-tags.js\";\nimport { type GirCallable, type GirParameter, isCallerAllocatedOut, isOutParameter } from \"../gir/parameter.js\";\nimport { isCellInout, shouldOmitPrimaryReturn } from \"./descriptor-render.js\";\n\ntype InputParameter = {\n    parameter: GirParameter;\n    index: number;\n};\n\ntype HandlerResultOptions = {\n    library: Library;\n    signal: GirCallable;\n    renderType: (ref: TypeId | undefined, isNullable: boolean) => string;\n    shouldIncludeCallerAllocated: boolean;\n    isOptOut: boolean;\n    shouldExcludeOut?: (parameter: GirParameter) => boolean;\n};\n\nconst isInputParameter = (options: {\n    parameter: GirParameter;\n    index: number;\n    lengthIndices: Set<number>;\n    closureIndices: Set<number>;\n}): boolean => {\n    const { parameter, index, lengthIndices, closureIndices } = options;\n\n    if (parameter.isVarargs) {\n        return false;\n    }\n\n    if (isOutParameter(parameter)) {\n        return false;\n    }\n\n    if (isCallerAllocatedOut(parameter)) {\n        return false;\n    }\n\n    if (lengthIndices.has(index)) {\n        return false;\n    }\n\n    return !closureIndices.has(index);\n};\n\nconst inputParameters = (library: Library, fn: GirFunction): InputParameter[] => {\n    const lengthIndices = arrayLengthIndices(library, fn);\n    const closureIndices = closureAndDestroyIndices(fn);\n    const result: InputParameter[] = [];\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        if (isInputParameter({ parameter, index, lengthIndices, closureIndices })) {\n            result.push({ parameter, index });\n        }\n    }\n\n    return result;\n};\n\nconst closureAndDestroyIndices = (fn: GirFunction): Set<number> => {\n    const indices: Set<number> = new Set();\n\n    for (const parameter of fn.parameters) {\n        if (parameter.closureIndex !== undefined) {\n            indices.add(parameter.closureIndex);\n        }\n\n        if (parameter.destroyIndex !== undefined) {\n            indices.add(parameter.destroyIndex);\n        }\n    }\n\n    return indices;\n};\n\nconst emittedArgIndices = (fn: GirFunction, instanceOffset: number): Map<number, number> => {\n    const closureIndices = closureAndDestroyIndices(fn);\n    const map: Map<number, number> = new Map();\n    let emitted = instanceOffset;\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        if (parameter.isVarargs || closureIndices.has(index)) {\n            continue;\n        }\n\n        map.set(index, emitted);\n        emitted += 1;\n    }\n\n    return map;\n};\n\nconst arrayLengthIndices = (library: Library, fn: GirFunction): Set<number> => {\n    const map = arrayLengthSources(library, fn);\n\n    return new Set(map.keys());\n};\n\nconst carrayLengthIndex = (library: Library, ref: TypeId | undefined): number | undefined => {\n    const type = ref === undefined ? undefined : library.typeFor(ref);\n\n    if (type?.kind !== \"carray\") {\n        return undefined;\n    }\n\n    return type.lengthParameterIndex;\n};\n\nconst arrayLengthSources = (library: Library, fn: GirCallable): Map<number, number> => {\n    const map: Map<number, number> = new Map();\n\n    for (const [index, parameter] of fn.parameters.entries()) {\n        const lengthIndex = carrayLengthIndex(library, parameter.type);\n\n        if (lengthIndex !== undefined) {\n            map.set(lengthIndex, index);\n        }\n    }\n\n    return map;\n};\n\nconst returnArrayLengthIndices = (library: Library, fn: GirCallable): Set<number> => {\n    const returnType = fn.returnValue.type === undefined ? undefined : library.typeFor(fn.returnValue.type);\n\n    if (returnType?.kind !== \"carray\") {\n        return new Set();\n    }\n\n    const lengthIndex = returnType.lengthParameterIndex;\n\n    if (lengthIndex === undefined) {\n        return new Set();\n    }\n\n    return new Set([lengthIndex]);\n};\n\nconst foldedLengthIndices = (library: Library, fn: GirCallable): Set<number> => {\n    const indices: Set<number> = new Set(arrayLengthSources(library, fn).keys());\n\n    for (const index of returnArrayLengthIndices(library, fn)) {\n        indices.add(index);\n    }\n\n    return indices;\n};\n\nconst foldedLengthParameters = (library: Library, fn: GirCallable): Set<GirParameter> => {\n    const folded: Set<GirParameter> = new Set();\n\n    for (const index of foldedLengthIndices(library, fn)) {\n        const parameter = fn.parameters[index];\n\n        if (parameter !== undefined) {\n            folded.add(parameter);\n        }\n    }\n\n    return folded;\n};\n\nconst parameterIdentifier = (parameter: GirParameter, index: number): string => {\n    if (parameter.name.length === 0) {\n        return `arg${String(index)}`;\n    }\n\n    return toCamelIdentifier(parameter.name);\n};\n\nconst handlerParameters = (\n    parameters: GirParameter[],\n    shouldExclude: (parameter: GirParameter) => boolean = () => false,\n): GirParameter[] =>\n    parameters.filter(\n        (parameter) => !parameter.isVarargs && !isOutParameter(parameter) && !shouldExclude(parameter),\n    );\n\nconst documentedParameters = (\n    library: Library,\n    fn: GirFunction,\n    shouldSkip: (parameter: GirParameter) => boolean = () => false,\n    renames?: Map<string, string>,\n): JsDocParam[] =>\n    inputParameters(library, fn)\n        .filter(({ parameter }) => !shouldSkip(parameter))\n        .map(({ parameter, index }) => ({\n            name: renames?.get(parameter.name) ?? parameterIdentifier(parameter, index),\n            doc: parameter.doc ?? \"\",\n        }))\n        .filter((entry) => entry.doc.length > 0);\n\nconst documentedHandlerParameters = (parameters: GirParameter[]): JsDocParam[] =>\n    handlerParameters(parameters)\n        .map((parameter, index) => ({ name: parameterIdentifier(parameter, index), doc: parameter.doc ?? \"\" }))\n        .filter((entry) => entry.doc.length > 0);\n\nconst handlerRenames = (parameters: GirParameter[]): Map<string, string> => {\n    const renames: Map<string, string> = new Map();\n\n    for (const [index, parameter] of parameters.entries()) {\n        renames.set(parameter.name, parameterIdentifier(parameter, index));\n    }\n\n    return renames;\n};\n\nconst renamesWithInstance = (parameters: GirParameter[], instance: GirParameter | undefined): Map<string, string> => {\n    const renames = handlerRenames(parameters);\n\n    if (instance !== undefined && instance.name.length > 0) {\n        renames.set(instance.name, \"this\");\n    }\n\n    return renames;\n};\n\nconst renderHandlerParameters = (\n    parameters: GirParameter[],\n    renderType: (ref: TypeId | undefined, isNullable: boolean) => string,\n    shouldExclude: (parameter: GirParameter) => boolean = () => false,\n): string[] =>\n    handlerParameters(parameters, shouldExclude).map(\n        (parameter, index) =>\n            `${parameterIdentifier(parameter, index)}: ${renderType(parameter.type, parameter.nullable)}`,\n    );\n\nconst foldOutParamShape = (primary: string | undefined, outTypes: string[]): string => {\n    if (primary !== undefined) {\n        return `[${primary}, ${outTypes.join(\", \")}]`;\n    }\n\n    const [single, ...rest] = outTypes;\n\n    if (single !== undefined && rest.length === 0) {\n        return single;\n    }\n\n    return `[${outTypes.join(\", \")}]`;\n};\n\nconst isHandlerOutParameter = (options: {\n    library: Library;\n    parameter: GirParameter;\n    shouldIncludeCallerAllocated: boolean;\n}): boolean => {\n    const { library, parameter, shouldIncludeCallerAllocated } = options;\n\n    if (parameter.isVarargs) {\n        return false;\n    }\n\n    if (isOutParameter(parameter)) {\n        return true;\n    }\n\n    if (isCellInout(library, parameter)) {\n        return true;\n    }\n\n    return shouldIncludeCallerAllocated && isCallerAllocatedOut(parameter);\n};\n\nconst scalarResultType = (primary: string | undefined, isOptOut: boolean): string => {\n    if (primary === undefined) {\n        return \"void\";\n    }\n\n    return isOptOut ? `${primary} | undefined` : primary;\n};\n\nconst renderHandlerResultType = (options: HandlerResultOptions): string => {\n    const { library, signal, renderType, shouldIncludeCallerAllocated, isOptOut } = options;\n    const shouldExcludeOut = options.shouldExcludeOut ?? (() => false);\n\n    const primary = shouldOmitPrimaryReturn(library, signal.returnValue)\n        ? undefined\n        : renderType(signal.returnValue.type, signal.returnValue.nullable);\n\n    const outTypes = signal.parameters\n        .filter(\n            (parameter) =>\n                isHandlerOutParameter({ library, parameter, shouldIncludeCallerAllocated }) &&\n                !shouldExcludeOut(parameter),\n        )\n        .map((parameter) => renderType(parameter.type, parameter.nullable));\n\n    if (outTypes.length === 0) {\n        return scalarResultType(primary, isOptOut);\n    }\n\n    return foldOutParamShape(primary, outTypes);\n};\n\nexport {\n    emittedArgIndices,\n    inputParameters,\n    closureAndDestroyIndices,\n    arrayLengthSources,\n    foldedLengthIndices,\n    foldedLengthParameters,\n    parameterIdentifier,\n    documentedParameters,\n    documentedHandlerParameters,\n    handlerRenames,\n    renamesWithInstance,\n    handlerParameters,\n    renderHandlerParameters,\n    foldOutParamShape,\n    renderHandlerResultType,\n    type InputParameter,\n};\n"]}