@gtkx/codegen 1.0.0-rc.3 → 1.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"constructor-props.js","sourceRoot":"","sources":["../../../src/store/gi/constructor-props.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral, toCamelIdentifier, uniqBy } from \"@gtkx/utils\";\nimport type { GirClass } from \"../../gir/class.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { renderDescriptor } from \"../../analysis/descriptor-render.js\";\nimport { collectInterfaceProperties } from \"../../analysis/inheritance.js\";\nimport { renderTsType } from \"../../analysis/ts-type.js\";\nimport { ancestorChain } from \"../../gir/ancestry.js\";\nimport { type GirProperty, isConstructableProperty } from \"../../gir/property.js\";\nimport { renderBlock, renderBraced, renderBracedOrEmpty } from \"../../writer/emit.js\";\nimport { parentCompanionRef } from \"./companion.js\";\n\nconst PROPS_RECORD = \"Record<string, unknown>\";\n\nconst constructablePropNames = (klass: GirClass): string[] =>\n    klass.properties.filter(isConstructableProperty).map((property) => toCamelIdentifier(property.name));\n\nconst ancestorConstructablePropNames = (context: ModuleContext, klass: GirClass): Set<string> => {\n    const names: Set<string> = new Set();\n\n    for (const { klass: ancestor } of ancestorChain(context.library, klass, context.namespace.name)) {\n        if (ancestor === klass) {\n            continue;\n        }\n\n        for (const name of constructablePropNames(ancestor)) {\n            names.add(name);\n        }\n    }\n\n    return names;\n};\n\nconst collectConstructableProps = (context: ModuleContext, klass: GirClass): GirProperty[] => {\n    const inherited = ancestorConstructablePropNames(context, klass);\n\n    return uniqBy(\n        [...klass.properties, ...collectInterfaceProperties(context, klass).map((entry) => entry.property)]\n            .filter(isConstructableProperty)\n            .filter((property) => !inherited.has(toCamelIdentifier(property.name))),\n        (property) => toCamelIdentifier(property.name),\n    );\n};\n\nconst renderConstructorPropsInterface = (context: ModuleContext, klass: GirClass, className: string): string => {\n    const parentRef = parentCompanionRef(context, klass, \"ConstructorProps\");\n    const extendsClause = parentRef === undefined ? \"\" : ` extends ${parentRef}`;\n\n    const lines = collectConstructableProps(context, klass).map(\n        (property) =>\n            `${toCamelIdentifier(property.name)}?: ${renderTsType(context, property.type, true)} | undefined;`,\n    );\n\n    return renderBracedOrEmpty(`export interface ${className}ConstructorProps${extendsClause}`, lines.join(\"\\n\"));\n};\n\nconst renderClassConstructor = (\n    context: ModuleContext,\n    klass: GirClass,\n    className: string,\n    hasParent: boolean,\n): string | undefined => {\n    if (!hasParent) {\n        return renderRootConstructor(context);\n    }\n\n    const props = collectConstructableProps(context, klass);\n\n    if (props.length === 0) {\n        return undefined;\n    }\n\n    return renderTranslatingConstructor(context, props, className);\n};\n\nconst renderRootConstructor = (context: ModuleContext): string => {\n    context.addRuntimeImport(\"getInstanceType\");\n    context.addRuntimeImport(\"newObjectWithProperties\");\n    context.addRuntimeImport(\"setHandle\");\n    context.addRuntimeImport(\"setWrapper\");\n\n    const body = [\n        \"const handle = newObjectWithProperties(getInstanceType(this), props);\",\n        \"setHandle(this, handle);\",\n        \"setWrapper(handle, this);\",\n    ].join(\"\\n\");\n\n    return renderBlock(`constructor(props: ${PROPS_RECORD} = {})`, body);\n};\n\nconst renderTranslatingConstructor = (context: ModuleContext, props: GirProperty[], className: string): string => {\n    context.addRuntimeImport(\"t\");\n    const destructured = props.map((property) => toCamelIdentifier(property.name));\n    const pattern = `{ ${[...destructured, \"...rest\"].join(\", \")} }`;\n\n    const entries = props.map((property) => {\n        const descriptor = renderDescriptor(context, property.type, property.transferOwnership);\n\n        return `${sourceStringLiteral(property.name)}: [${descriptor}, ${toCamelIdentifier(property.name)}],`;\n    });\n\n    const recordLiteral = renderBraced(entries.join(\"\\n\"));\n    const lines = [`const props: ${PROPS_RECORD} = ${recordLiteral};`, \"super({ ...props, ...rest });\"];\n    const body = lines.join(\"\\n\");\n\n    return renderBlock(`constructor(${pattern}: ${className}ConstructorProps = {})`, body);\n};\n\nexport { renderConstructorPropsInterface, renderClassConstructor };\n"]}
+{"version":3,"file":"constructor-props.js","sourceRoot":"","sources":["../../../src/store/gi/constructor-props.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral, toCamelIdentifier, uniqBy } from \"@gtkx/utils\";\nimport type { GirClass } from \"../../gir/class.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { renderDescriptor } from \"../../analysis/descriptor-render.js\";\nimport { collectInterfaceProperties } from \"../../analysis/inheritance.js\";\nimport { renderTsType } from \"../../analysis/ts-type.js\";\nimport { ancestorChain } from \"../../gir/ancestry.js\";\nimport { type GirProperty, isConstructableProperty } from \"../../gir/property.js\";\nimport { renderBlock, renderBraced, renderBracedOrEmpty } from \"../../writer/emit.js\";\nimport { parentCompanionRef } from \"./companion.js\";\nimport { propertyDoc } from \"./property-accessor.js\";\n\nconst constructablePropNames = (klass: GirClass): string[] =>\n    klass.properties.filter(isConstructableProperty).map((property) => toCamelIdentifier(property.name));\n\nconst ancestorConstructablePropNames = (context: ModuleContext, klass: GirClass): Set<string> => {\n    const names: Set<string> = new Set();\n\n    for (const { klass: ancestor } of ancestorChain(context.library, klass, context.namespace.name)) {\n        if (ancestor === klass) {\n            continue;\n        }\n\n        for (const name of constructablePropNames(ancestor)) {\n            names.add(name);\n        }\n    }\n\n    return names;\n};\n\nconst collectConstructableProps = (context: ModuleContext, klass: GirClass): GirProperty[] => {\n    const inherited = ancestorConstructablePropNames(context, klass);\n\n    return uniqBy(\n        [...klass.properties, ...collectInterfaceProperties(context, klass).map((entry) => entry.property)]\n            .filter(isConstructableProperty)\n            .filter((property) => !inherited.has(toCamelIdentifier(property.name))),\n        (property) => toCamelIdentifier(property.name),\n    );\n};\n\nconst renderConstructorPropsInterface = (context: ModuleContext, klass: GirClass, className: string): string => {\n    const parentRef = parentCompanionRef(context, klass, \"ConstructorProps\");\n    const extendsClause = parentRef === undefined ? \"\" : ` extends ${parentRef}`;\n\n    const lines = collectConstructableProps(context, klass).map(\n        (property) =>\n            `${propertyDoc(property)}${toCamelIdentifier(property.name)}?: ` +\n            `${renderTsType(context, property.type, true)} | undefined;`,\n    );\n\n    return renderBracedOrEmpty(`export interface ${className}ConstructorProps${extendsClause}`, lines.join(\"\\n\"));\n};\n\nconst renderClassConstructor = (\n    context: ModuleContext,\n    klass: GirClass,\n    className: string,\n    hasParent: boolean,\n): string | undefined => {\n    if (!hasParent) {\n        return renderRootConstructor(context);\n    }\n\n    const props = collectConstructableProps(context, klass);\n\n    if (props.length === 0) {\n        return undefined;\n    }\n\n    return renderTranslatingConstructor(context, props, className);\n};\n\nconst renderRootConstructor = (context: ModuleContext): string => {\n    context.addRuntimeTypeImport(\"AnyClass\");\n    context.addRuntimeImport(\"getClassType\");\n    context.addRuntimeImport(\"newObjectWithProperties\");\n    const body = \"newObjectWithProperties(getClassType(this.constructor as AnyClass), props, this);\";\n\n    return renderBlock(\"constructor(props: object = {})\", body);\n};\n\nconst renderConstructBindings = (context: ModuleContext, props: GirProperty[]): string => {\n    const entries = props.map((property) => {\n        const descriptor = renderDescriptor(context, property.type, property.transferOwnership);\n        const key = sourceStringLiteral(toCamelIdentifier(property.name));\n\n        return `${key}: [${sourceStringLiteral(property.name)}, ${descriptor}],`;\n    });\n\n    return renderBraced(entries.join(\"\\n\"));\n};\n\nconst renderTranslatingConstructor = (context: ModuleContext, props: GirProperty[], className: string): string => {\n    context.addRuntimeImport(\"t\");\n    context.addRuntimeImport(\"registerConstructProperties\");\n    const bindings = renderConstructBindings(context, props);\n    context.module.appendRegistration(`registerConstructProperties(${className}, ${bindings});`);\n\n    return renderBlock(`constructor(props: ${className}ConstructorProps = {})`, \"super(props);\");\n};\n\nexport { renderConstructorPropsInterface, renderClassConstructor };\n"]}

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

@@ -0,0 +1,14 @@
+import type { GirAnnotations } from "../../gir/annotations.js";
+import type { GirCallable, GirParameter } from "../../gir/parameter.js";
+import type { JsDocSpec } from "../../writer/doc.js";
+type DocumentedNode = {
+    doc: string | undefined;
+    annotations: GirAnnotations;
+};
+declare const THROWS_TEXT = "A `GLib.Error` carrying the failing operation's domain, code, and message.";
+declare const annotationSpec: (annotations: GirAnnotations) => JsDocSpec;
+declare const getDoc: (node: DocumentedNode) => string;
+declare const handlerSpec: (callable: GirCallable, parameters: GirParameter[], identifiers?: Map<string, string>) => JsDocSpec;
+declare const selfHandlerSpec: (signal: GirCallable) => JsDocSpec;
+export { annotationSpec, getDoc, handlerSpec, selfHandlerSpec, THROWS_TEXT };
+//# sourceMappingURL=doc-spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-spec.d.ts","sourceRoot":"","sources":["../../../src/store/gi/doc-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,KAAK,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,cAAc,CAAA;CAAE,CAAC;AAG/E,QAAA,MAAM,WAAW,+EAA+E,CAAC;AAEjG,QAAA,MAAM,cAAc,GAAI,aAAa,cAAc,KAAG,SAKpD,CAAC;AAEH,QAAA,MAAM,MAAM,GAAI,MAAM,cAAc,KAAG,MAA4E,CAAC;AAEpH,QAAA,MAAM,WAAW,GACb,UAAU,WAAW,EACrB,YAAY,YAAY,EAAE,EAC1B,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAClC,SAKD,CAAC;AAEH,QAAA,MAAM,eAAe,GAAI,QAAQ,WAAW,KAAG,SAI9C,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC"}

package/dist/store/gi/doc-spec.js

@@ -0,0 +1,23 @@
+import { documentedHandlerParameters, handlerRenames } from "../../analysis/param-structure.js";
+import { renderJsDoc } from "../../writer/doc.js";
+const SELF_PARAM_DOC = "The instance the signal was emitted on.";
+const THROWS_TEXT = "A `GLib.Error` carrying the failing operation's domain, code, and message.";
+const annotationSpec = (annotations) => ({
+    deprecated: annotations.isDeprecated
+        ? { since: annotations.deprecatedSince, doc: annotations.deprecationDoc }
+        : undefined,
+    since: annotations.since,
+});
+const getDoc = (node) => renderJsDoc(node.doc, undefined, annotationSpec(node.annotations));
+const handlerSpec = (callable, parameters, identifiers) => ({
+    ...annotationSpec(callable.annotations),
+    identifiers: identifiers ?? handlerRenames(parameters),
+    params: documentedHandlerParameters(parameters),
+    returns: callable.returnValue.doc,
+});
+const selfHandlerSpec = (signal) => {
+    const spec = handlerSpec(signal, signal.parameters);
+    return { ...spec, params: [...(spec.params ?? []), { name: "self", doc: SELF_PARAM_DOC }] };
+};
+export { annotationSpec, getDoc, handlerSpec, selfHandlerSpec, THROWS_TEXT };
+//# sourceMappingURL=doc-spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-spec.js","sourceRoot":"","sources":["../../../src/store/gi/doc-spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,cAAc,GAAG,yCAAyC,CAAC;AACjE,MAAM,WAAW,GAAG,4EAA4E,CAAC;AAEjG,MAAM,cAAc,GAAG,CAAC,WAA2B,EAAa,EAAE,CAAC,CAAC;IAChE,UAAU,EAAE,WAAW,CAAC,YAAY;QAChC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,WAAW,CAAC,cAAc,EAAE;QACzE,CAAC,CAAC,SAAS;IACf,KAAK,EAAE,WAAW,CAAC,KAAK;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,IAAoB,EAAU,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;AAEpH,MAAM,WAAW,GAAG,CAChB,QAAqB,EACrB,UAA0B,EAC1B,WAAiC,EACxB,EAAE,CAAC,CAAC;IACb,GAAG,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC;IACvC,WAAW,EAAE,WAAW,IAAI,cAAc,CAAC,UAAU,CAAC;IACtD,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC;IAC/C,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG;CACpC,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,MAAmB,EAAa,EAAE;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAEpD,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;AAChG,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import type { GirAnnotations } from \"../../gir/annotations.js\";\nimport type { GirCallable, GirParameter } from \"../../gir/parameter.js\";\nimport type { JsDocSpec } from \"../../writer/doc.js\";\nimport { documentedHandlerParameters, handlerRenames } from \"../../analysis/param-structure.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\n\ntype DocumentedNode = { doc: string | undefined; annotations: GirAnnotations };\n\nconst SELF_PARAM_DOC = \"The instance the signal was emitted on.\";\nconst THROWS_TEXT = \"A `GLib.Error` carrying the failing operation's domain, code, and message.\";\n\nconst annotationSpec = (annotations: GirAnnotations): JsDocSpec => ({\n    deprecated: annotations.isDeprecated\n        ? { since: annotations.deprecatedSince, doc: annotations.deprecationDoc }\n        : undefined,\n    since: annotations.since,\n});\n\nconst getDoc = (node: DocumentedNode): string => renderJsDoc(node.doc, undefined, annotationSpec(node.annotations));\n\nconst handlerSpec = (\n    callable: GirCallable,\n    parameters: GirParameter[],\n    identifiers?: Map<string, string>,\n): JsDocSpec => ({\n    ...annotationSpec(callable.annotations),\n    identifiers: identifiers ?? handlerRenames(parameters),\n    params: documentedHandlerParameters(parameters),\n    returns: callable.returnValue.doc,\n});\n\nconst selfHandlerSpec = (signal: GirCallable): JsDocSpec => {\n    const spec = handlerSpec(signal, signal.parameters);\n\n    return { ...spec, params: [...(spec.params ?? []), { name: \"self\", doc: SELF_PARAM_DOC }] };\n};\n\nexport { annotationSpec, getDoc, handlerSpec, selfHandlerSpec, THROWS_TEXT };\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../../src/store/gi/enum.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,QAAA,MAAM,YAAY,GAAI,SAAS,aAAa,EAAE,aAAa,OAAO,KAAG,IAuCpE,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAIrC,CAAC;AAYF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../../src/store/gi/enum.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAa7D,QAAA,MAAM,YAAY,GAAI,SAAS,aAAa,EAAE,aAAa,OAAO,KAAG,IAepE,CAAC;AAoDF,QAAA,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAIrC,CAAC;AAYF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/store/gi/enum.js

@@ -1,30 +1,43 @@
 import { sourceStringLiteral } from "@gtkx/utils";
-import { renderJsDoc } from "../../writer/doc.js";
+import { hasAnnotations } from "../../gir/annotations.js";
 import { indent } from "../../writer/emit.js";
+import { getDoc } from "./doc-spec.js";
+const memberDoc = (member) => getDoc(member);
+const enumDoc = (enumeration) => getDoc(enumeration);
 const generateEnum = (context, enumeration) => {
     if (!enumeration.introspectable) {
         return;
     }
-    const name = enumeration.name;
     const members = enumeration.members.map((member) => ({ ...member, key: enumMemberKey(member.name) }));
-    if (enumeration.errorDomain !== undefined) {
-        const memberEntries = members.map((member) => `${member.key}: ${member.value}`);
-        const typeFields = members.map((member) => `${member.key}: number`).join("; ");
-        context.addRuntimeImport("createErrorDomain");
-        context.addRuntimeImport("ErrorDomain");
-        const quarkExpression = renderQuarkExpression(context, enumeration.errorDomain);
-        context.module.appendDeclaration(`${renderJsDoc(enumeration.doc)}export type ${name} = number;`);
-        context.module.appendDeclaration(`export const ${name}: ErrorDomain<{ ${typeFields} }> = ` +
-            `createErrorDomain(${quarkExpression}, { ${memberEntries.join(", ")} });`);
+    const errorDomain = enumeration.errorDomain;
+    if (errorDomain !== undefined) {
+        appendErrorDomain(context, enumeration, members, errorDomain);
         return;
     }
-    if (members.some((member) => member.doc !== undefined)) {
-        const memberBlocks = members.map((member) => `${renderJsDoc(member.doc)}${member.key} = ${member.value},`);
-        context.module.appendDeclaration(`${renderJsDoc(enumeration.doc)}export enum ${name} {\n${indent(memberBlocks.join("\n"), 1)}\n}`);
+    appendEnumDeclaration(context, enumeration, members);
+};
+const appendErrorDomain = (context, enumeration, members, errorDomain) => {
+    const memberEntries = members.map((member) => `${member.key}: ${member.value}`);
+    const typeFields = members.map((member) => `${memberDoc(member)}${member.key}: number;`);
+    context.addRuntimeImport("createErrorDomain");
+    context.addRuntimeImport("ErrorDomain");
+    const quarkExpression = renderQuarkExpression(context, errorDomain);
+    const doc = enumDoc(enumeration);
+    const shape = typeFields.length === 0 ? "{}" : `{\n${indent(typeFields.join("\n"), 1)}\n}`;
+    context.module.appendDeclaration(`${doc}export type ${enumeration.name} = number;`, context.declaredType(enumeration.name));
+    context.module.appendDeclaration(`${doc}export const ${enumeration.name}: ErrorDomain<${shape}> = ` +
+        `createErrorDomain(${quarkExpression}, { ${memberEntries.join(", ")} });`);
+};
+const isMemberDocumented = (member) => member.doc !== undefined || hasAnnotations(member.annotations);
+const appendEnumDeclaration = (context, enumeration, members) => {
+    const doc = enumDoc(enumeration);
+    if (members.some((member) => isMemberDocumented(member))) {
+        const blocks = members.map((member) => `${memberDoc(member)}${member.key} = ${member.value},`);
+        context.module.appendDeclaration(`${doc}export enum ${enumeration.name} {\n${indent(blocks.join("\n"), 1)}\n}`, context.declaredType(enumeration.name));
         return;
     }
-    const memberDeclarations = members.map((member) => `${member.key} = ${member.value}`);
-    context.module.appendDeclaration(`${renderJsDoc(enumeration.doc)}export enum ${name} { ${memberDeclarations.join(", ")} }`);
+    const declarations = members.map((member) => `${member.key} = ${member.value}`);
+    context.module.appendDeclaration(`${doc}export enum ${enumeration.name} { ${declarations.join(", ")} }`, context.declaredType(enumeration.name));
 };
 const enumMemberKey = (name) => {
     const upper = name.toUpperCase().replaceAll("-", "_");

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

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/store/gi/enum.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral } from \"@gtkx/utils\";\nimport type { GirEnum } from \"../../gir/enum.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { indent } from \"../../writer/emit.js\";\n\nconst generateEnum = (context: ModuleContext, enumeration: GirEnum): void => {\n    if (!enumeration.introspectable) {\n        return;\n    }\n\n    const name = enumeration.name;\n    const members = enumeration.members.map((member) => ({ ...member, key: enumMemberKey(member.name) }));\n\n    if (enumeration.errorDomain !== undefined) {\n        const memberEntries = members.map((member) => `${member.key}: ${member.value}`);\n        const typeFields = members.map((member) => `${member.key}: number`).join(\"; \");\n        context.addRuntimeImport(\"createErrorDomain\");\n        context.addRuntimeImport(\"ErrorDomain\");\n        const quarkExpression = renderQuarkExpression(context, enumeration.errorDomain);\n        context.module.appendDeclaration(`${renderJsDoc(enumeration.doc)}export type ${name} = number;`);\n\n        context.module.appendDeclaration(\n            `export const ${name}: ErrorDomain<{ ${typeFields} }> = ` +\n            `createErrorDomain(${quarkExpression}, { ${memberEntries.join(\", \")} });`,\n        );\n\n        return;\n    }\n\n    if (members.some((member) => member.doc !== undefined)) {\n        const memberBlocks = members.map((member) => `${renderJsDoc(member.doc)}${member.key} = ${member.value},`);\n\n        context.module.appendDeclaration(\n            `${renderJsDoc(enumeration.doc)}export enum ${name} {\\n${indent(memberBlocks.join(\"\\n\"), 1)}\\n}`,\n        );\n\n        return;\n    }\n\n    const memberDeclarations = members.map((member) => `${member.key} = ${member.value}`);\n\n    context.module.appendDeclaration(\n        `${renderJsDoc(enumeration.doc)}export enum ${name} { ${memberDeclarations.join(\", \")} }`,\n    );\n};\n\nconst enumMemberKey = (name: string): string => {\n    const upper = name.toUpperCase().replaceAll(\"-\", \"_\");\n\n    return /^\\d/.test(upper) ? `_${upper}` : upper;\n};\n\nconst renderQuarkExpression = (context: ModuleContext, errorDomain: string): string => {\n    if (context.namespace.name === \"GLib\") {\n        return `() => quarkFromString(${sourceStringLiteral(errorDomain)})`;\n    }\n\n    const alias = context.addCrossNamespaceImport(\"GLib\");\n\n    return `() => ${alias}.quarkFromString(${sourceStringLiteral(errorDomain)})`;\n};\n\nexport { generateEnum, enumMemberKey };\n"]}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/store/gi/enum.ts"],"names":[],"mappings":"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","sourcesContent":["import { sourceStringLiteral } from \"@gtkx/utils\";\nimport type { EnumMember, GirEnum } from \"../../gir/enum.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { hasAnnotations } from \"../../gir/annotations.js\";\nimport { indent } from \"../../writer/emit.js\";\nimport { getDoc } from \"./doc-spec.js\";\n\ntype KeyedMember = EnumMember & { key: string };\n\nconst memberDoc = (member: KeyedMember): string =>\n    getDoc(member);\n\nconst enumDoc = (enumeration: GirEnum): string =>\n    getDoc(enumeration);\n\nconst generateEnum = (context: ModuleContext, enumeration: GirEnum): void => {\n    if (!enumeration.introspectable) {\n        return;\n    }\n\n    const members = enumeration.members.map((member) => ({ ...member, key: enumMemberKey(member.name) }));\n    const errorDomain = enumeration.errorDomain;\n\n    if (errorDomain !== undefined) {\n        appendErrorDomain(context, enumeration, members, errorDomain);\n\n        return;\n    }\n\n    appendEnumDeclaration(context, enumeration, members);\n};\n\nconst appendErrorDomain = (\n    context: ModuleContext,\n    enumeration: GirEnum,\n    members: KeyedMember[],\n    errorDomain: string,\n): void => {\n    const memberEntries = members.map((member) => `${member.key}: ${member.value}`);\n    const typeFields = members.map((member) => `${memberDoc(member)}${member.key}: number;`);\n    context.addRuntimeImport(\"createErrorDomain\");\n    context.addRuntimeImport(\"ErrorDomain\");\n    const quarkExpression = renderQuarkExpression(context, errorDomain);\n    const doc = enumDoc(enumeration);\n    const shape = typeFields.length === 0 ? \"{}\" : `{\\n${indent(typeFields.join(\"\\n\"), 1)}\\n}`;\n\n    context.module.appendDeclaration(\n        `${doc}export type ${enumeration.name} = number;`,\n        context.declaredType(enumeration.name),\n    );\n\n    context.module.appendDeclaration(\n        `${doc}export const ${enumeration.name}: ErrorDomain<${shape}> = ` +\n        `createErrorDomain(${quarkExpression}, { ${memberEntries.join(\", \")} });`,\n    );\n};\n\nconst isMemberDocumented = (member: KeyedMember): boolean =>\n    member.doc !== undefined || hasAnnotations(member.annotations);\n\nconst appendEnumDeclaration = (context: ModuleContext, enumeration: GirEnum, members: KeyedMember[]): void => {\n    const doc = enumDoc(enumeration);\n\n    if (members.some((member) => isMemberDocumented(member))) {\n        const blocks = members.map((member) => `${memberDoc(member)}${member.key} = ${member.value},`);\n\n        context.module.appendDeclaration(\n            `${doc}export enum ${enumeration.name} {\\n${indent(blocks.join(\"\\n\"), 1)}\\n}`,\n            context.declaredType(enumeration.name),\n        );\n\n        return;\n    }\n\n    const declarations = members.map((member) => `${member.key} = ${member.value}`);\n\n    context.module.appendDeclaration(\n        `${doc}export enum ${enumeration.name} { ${declarations.join(\", \")} }`,\n        context.declaredType(enumeration.name),\n    );\n};\n\nconst enumMemberKey = (name: string): string => {\n    const upper = name.toUpperCase().replaceAll(\"-\", \"_\");\n\n    return /^\\d/.test(upper) ? `_${upper}` : upper;\n};\n\nconst renderQuarkExpression = (context: ModuleContext, errorDomain: string): string => {\n    if (context.namespace.name === \"GLib\") {\n        return `() => quarkFromString(${sourceStringLiteral(errorDomain)})`;\n    }\n\n    const alias = context.addCrossNamespaceImport(\"GLib\");\n\n    return `() => ${alias}.quarkFromString(${sourceStringLiteral(errorDomain)})`;\n};\n\nexport { generateEnum, enumMemberKey };\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/store/gi/function.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgB7D,QAAA,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,MAAM,GAAG,SAgB9E,CAAC;AA+BF,QAAA,MAAM,yBAAyB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,IAsB5E,CAAC;AA+BF,QAAA,MAAM,2BAA2B,GAAI,aAAa,MAAM,EAAE,SAAS,MAAM,EAAE,gBAAgB,MAAM,EAAE,KAAG,MAQrG,CAAC;AAgCF,QAAA,MAAM,0BAA0B,GAAI,SAAS,aAAa,EAAE,WAAW,YAAY,KAAG,IASrF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/store/gi/function.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA6B7D,QAAA,MAAM,kBAAkB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,MAAM,GAAG,SAgB9E,CAAC;AA2BF,QAAA,MAAM,yBAAyB,GAAI,SAAS,aAAa,EAAE,IAAI,WAAW,KAAG,IAwB5E,CAAC;AAsCF,QAAA,MAAM,2BAA2B,GAAI,aAAa,MAAM,EAAE,SAAS,MAAM,EAAE,gBAAgB,MAAM,EAAE,KAAG,MAQrG,CAAC;AAgCF,QAAA,MAAM,0BAA0B,GAAI,SAAS,aAAa,EAAE,WAAW,YAAY,KAAG,IASrF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/store/gi/function.js

@@ -1,9 +1,9 @@
 import { toCamelIdentifier } from "@gtkx/utils";
 import { tFn } from "../../analysis/descriptor.js";
-import { hasCallerAllocatedArrayLength } from "../../analysis/param-structure.js";
-import { renderJsDoc } from "../../writer/doc.js";
+import { hasUnmarshalableParam } from "../../analysis/param-capability.js";
 import { arrayLiteral, renderBlock } from "../../writer/emit.js";
 import { matchAsyncFinish } from "./async.js";
+import { callableDoc } from "./callable-doc.js";
 import { planCallArgs, renderMethodBody, renderMethodReturnType, renderMethodSignature, renderPromisifiedBody, renderPromisifiedSignature, renderReturnDescriptor, } from "./method.js";
 const renderFnExpression = (context, fn) => {
     if (fn.cIdentifier === undefined) {
@@ -16,12 +16,8 @@ const renderFnExpression = (context, fn) => {
     context.addRuntimeImport("t");
     const params = planCallArgs(context, fn).map((arg) => arg.paramLiteral);
     const ret = renderReturnDescriptor(context, fn);
-    return tFn(library, fn.cIdentifier, { args: arrayLiteral(params), returns: ret, throws: fn.throws });
+    return tFn(library, fn.cIdentifier, { args: arrayLiteral(params), returns: ret, canThrow: fn.throws });
 };
-// `moved-to` names the type member this function is also reachable as, so the namespace-level copy
-// is a second export of one binding. Suppressing it is only right when that member is really
-// emitted: 15 of Gtk-4.0's 28 `moved-to` targets are enum or error-domain members codegen emits no
-// static for, and dropping those would delete API with nothing to replace it.
 const isMovedOntoEmittedMember = (context, fn) => {
     const [typeName, memberName] = fn.movedTo?.split(".") ?? [];
     if (typeName === undefined || memberName === undefined) {
@@ -38,7 +34,7 @@ const canEmitNamespaceFunction = (context, fn) => fn.introspectable &&
     !isMovedOntoEmittedMember(context, fn) &&
     fn.shadowedBy === undefined &&
     fn.cIdentifier !== undefined &&
-    !hasCallerAllocatedArrayLength(context.library, fn);
+    !hasUnmarshalableParam(context, fn);
 const generateNamespaceFunction = (context, fn) => {
     if (!canEmitNamespaceFunction(context, fn)) {
         return;
@@ -54,17 +50,32 @@ const generateNamespaceFunction = (context, fn) => {
     const bindingName = toCamelIdentifier(cIdentifier);
     context.module.appendBinding(`const ${bindingName} = ${expression};`, cIdentifier);
     const exportName = namespaceFunctionExportName(cIdentifier, fn.name, context.namespace.cSymbolPrefixes);
-    const declaration = renderNamespaceFunctionDeclaration(context, fn, exportName, bindingName);
-    context.module.appendDeclaration(`${renderJsDoc(fn.doc)}${declaration}`);
+    const finish = matchNamespaceFinish(context, fn);
+    const declaration = renderNamespaceFunctionDeclaration({ context, fn, finish, exportName, bindingName });
+    const doc = callableDoc(context, fn, { finishFn: finish?.fn });
+    context.module.appendDeclaration(`${doc}${declaration}`);
 };
-const renderNamespaceFunctionDeclaration = (context, fn, exportName, bindingName) => {
+const matchNamespaceFinish = (context, fn) => {
     const finishFn = matchAsyncFinish(context.library, fn, context.namespace.functions);
-    const finishCIdentifier = finishFn?.cIdentifier;
-    if (finishFn !== undefined && finishCIdentifier !== undefined && canEmitNamespaceFunction(context, finishFn)) {
-        const finishExport = namespaceFunctionExportName(finishCIdentifier, finishFn.name, context.namespace.cSymbolPrefixes);
-        const { signature, returnType } = renderPromisifiedSignature(context, fn, finishFn);
-        const body = renderPromisifiedBody(context, fn, finishExport, bindingName);
-        return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);
+    const cIdentifier = finishFn?.cIdentifier;
+    if (finishFn === undefined || cIdentifier === undefined || !canEmitNamespaceFunction(context, finishFn)) {
+        return undefined;
+    }
+    return {
+        fn: finishFn,
+        exportName: namespaceFunctionExportName(cIdentifier, finishFn.name, context.namespace.cSymbolPrefixes),
+    };
+};
+const renderPromisifiedNamespaceFunction = (options, finish) => {
+    const { context, fn, exportName, bindingName } = options;
+    const { signature, returnType } = renderPromisifiedSignature(context, fn, finish.fn);
+    const body = renderPromisifiedBody(context, fn, finish.exportName, bindingName);
+    return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);
+};
+const renderNamespaceFunctionDeclaration = (options) => {
+    const { context, fn, finish, exportName, bindingName } = options;
+    if (finish !== undefined) {
+        return renderPromisifiedNamespaceFunction(options, finish);
     }
     const signature = renderMethodSignature(context, fn);
     const returnType = renderMethodReturnType(context, fn);

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

@@ -1 +1 @@
-{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../src/store/gi/function.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirFunction } from \"../../gir/function.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { tFn } from \"../../analysis/descriptor.js\";\nimport { hasCallerAllocatedArrayLength } from \"../../analysis/param-structure.js\";\nimport { renderJsDoc } from \"../../writer/doc.js\";\nimport { arrayLiteral, renderBlock } from \"../../writer/emit.js\";\nimport { matchAsyncFinish } from \"./async.js\";\nimport {\n    planCallArgs,\n    renderMethodBody,\n    renderMethodReturnType,\n    renderMethodSignature,\n    renderPromisifiedBody,\n    renderPromisifiedSignature,\n    renderReturnDescriptor,\n} from \"./method.js\";\n\nconst renderFnExpression = (context: ModuleContext, fn: GirFunction): string | undefined => {\n    if (fn.cIdentifier === undefined) {\n        return undefined;\n    }\n\n    const library = context.namespace.sharedLibrary;\n\n    if (library === undefined) {\n        return undefined;\n    }\n\n    context.addRuntimeImport(\"t\");\n    const params = planCallArgs(context, fn).map((arg) => arg.paramLiteral);\n    const ret = renderReturnDescriptor(context, fn);\n\n    return tFn(library, fn.cIdentifier, { args: arrayLiteral(params), returns: ret, throws: fn.throws });\n};\n\n// `moved-to` names the type member this function is also reachable as, so the namespace-level copy\n// is a second export of one binding. Suppressing it is only right when that member is really\n// emitted: 15 of Gtk-4.0's 28 `moved-to` targets are enum or error-domain members codegen emits no\n// static for, and dropping those would delete API with nothing to replace it.\nconst isMovedOntoEmittedMember = (context: ModuleContext, fn: GirFunction): boolean => {\n    const [typeName, memberName] = fn.movedTo?.split(\".\") ?? [];\n\n    if (typeName === undefined || memberName === undefined) {\n        return false;\n    }\n\n    const resolved = context.library.resolveType(context.namespace.name, typeName);\n\n    if (resolved?.kind !== \"class\" && resolved?.kind !== \"interface\" && resolved?.kind !== \"record\") {\n        return false;\n    }\n\n    const members = [...resolved.value.methods, ...resolved.value.functions, ...resolved.value.constructors];\n\n    return members.some((member) => member.name === memberName);\n};\n\nconst canEmitNamespaceFunction = (context: ModuleContext, fn: GirFunction): boolean =>\n    fn.introspectable &&\n    !isMovedOntoEmittedMember(context, fn) &&\n    fn.shadowedBy === undefined &&\n    fn.cIdentifier !== undefined &&\n    !hasCallerAllocatedArrayLength(context.library, fn);\n\nconst generateNamespaceFunction = (context: ModuleContext, fn: GirFunction): void => {\n    if (!canEmitNamespaceFunction(context, fn)) {\n        return;\n    }\n\n    const expression = renderFnExpression(context, fn);\n\n    if (expression === undefined) {\n        return;\n    }\n\n    const cIdentifier = fn.cIdentifier;\n\n    if (cIdentifier === undefined) {\n        return;\n    }\n\n    const bindingName = toCamelIdentifier(cIdentifier);\n    context.module.appendBinding(`const ${bindingName} = ${expression};`, cIdentifier);\n    const exportName = namespaceFunctionExportName(cIdentifier, fn.name, context.namespace.cSymbolPrefixes);\n    const declaration = renderNamespaceFunctionDeclaration(context, fn, exportName, bindingName);\n    context.module.appendDeclaration(`${renderJsDoc(fn.doc)}${declaration}`);\n};\n\nconst renderNamespaceFunctionDeclaration = (\n    context: ModuleContext,\n    fn: GirFunction,\n    exportName: string,\n    bindingName: string,\n): string => {\n    const finishFn = matchAsyncFinish(context.library, fn, context.namespace.functions);\n    const finishCIdentifier = finishFn?.cIdentifier;\n\n    if (finishFn !== undefined && finishCIdentifier !== undefined && canEmitNamespaceFunction(context, finishFn)) {\n        const finishExport = namespaceFunctionExportName(\n            finishCIdentifier,\n            finishFn.name,\n            context.namespace.cSymbolPrefixes,\n        );\n\n        const { signature, returnType } = renderPromisifiedSignature(context, fn, finishFn);\n        const body = renderPromisifiedBody(context, fn, finishExport, bindingName);\n\n        return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);\n    }\n\n    const signature = renderMethodSignature(context, fn);\n    const returnType = renderMethodReturnType(context, fn);\n    const body = renderMethodBody(context, fn, { bindingExpression: bindingName });\n\n    return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);\n};\n\nconst namespaceFunctionExportName = (cIdentifier: string, girName: string, symbolPrefixes: string[]): string => {\n    if (girName.length > 0) {\n        return toCamelIdentifier(girName);\n    }\n\n    const stripped = stripLongestPrefix(cIdentifier, symbolPrefixes);\n\n    return toCamelIdentifier(stripped);\n};\n\nconst stripLongestPrefix = (input: string, prefixes: string[]): string => {\n    let best = \"\";\n\n    for (const prefix of prefixes) {\n        const candidate = `${prefix}_`;\n\n        if (input.startsWith(candidate) && candidate.length > best.length) {\n            best = candidate;\n        }\n    }\n\n    return best.length === 0 ? input : input.slice(best.length);\n};\n\nconst isBootstrapFunction = (fn: GirFunction): boolean =>\n    fn.parameters.length === 0 && fn.introspectable && fn.shadowedBy === undefined && fn.cIdentifier !== undefined;\n\nconst appendBootstrapRegistration = (context: ModuleContext, fn: GirFunction, exportName: string): void => {\n    if (fn.name === \"init\") {\n        context.module.appendRegistration(`${exportName}();`);\n\n        return;\n    }\n\n    if (fn.name === \"finalize\") {\n        context.addRuntimeImport(\"onExit\");\n        context.module.appendRegistration(`onExit(${exportName});`);\n    }\n};\n\nconst generateNamespaceBootstrap = (context: ModuleContext, namespace: GirNamespace): void => {\n    for (const fn of namespace.functions) {\n        if (!isBootstrapFunction(fn) || fn.cIdentifier === undefined) {\n            continue;\n        }\n\n        const exportName = namespaceFunctionExportName(fn.cIdentifier, fn.name, context.namespace.cSymbolPrefixes);\n        appendBootstrapRegistration(context, fn, exportName);\n    }\n};\n\nexport { renderFnExpression, generateNamespaceFunction, namespaceFunctionExportName, generateNamespaceBootstrap };\n"]}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../src/store/gi/function.ts"],"names":[],"mappings":"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","sourcesContent":["import { toCamelIdentifier } from \"@gtkx/utils\";\nimport type { GirFunction } from \"../../gir/function.js\";\nimport type { GirNamespace } from \"../../gir/namespace.js\";\nimport type { ModuleContext } from \"../../writer/context.js\";\nimport { tFn } from \"../../analysis/descriptor.js\";\nimport { hasUnmarshalableParam } from \"../../analysis/param-capability.js\";\nimport { arrayLiteral, renderBlock } from \"../../writer/emit.js\";\nimport { matchAsyncFinish } from \"./async.js\";\nimport { callableDoc } from \"./callable-doc.js\";\nimport {\n    planCallArgs,\n    renderMethodBody,\n    renderMethodReturnType,\n    renderMethodSignature,\n    renderPromisifiedBody,\n    renderPromisifiedSignature,\n    renderReturnDescriptor,\n} from \"./method.js\";\n\ntype NamespaceFinish = {\n    fn: GirFunction;\n    exportName: string;\n};\n\ntype NamespaceFunctionOptions = {\n    context: ModuleContext;\n    fn: GirFunction;\n    finish: NamespaceFinish | undefined;\n    exportName: string;\n    bindingName: string;\n};\n\nconst renderFnExpression = (context: ModuleContext, fn: GirFunction): string | undefined => {\n    if (fn.cIdentifier === undefined) {\n        return undefined;\n    }\n\n    const library = context.namespace.sharedLibrary;\n\n    if (library === undefined) {\n        return undefined;\n    }\n\n    context.addRuntimeImport(\"t\");\n    const params = planCallArgs(context, fn).map((arg) => arg.paramLiteral);\n    const ret = renderReturnDescriptor(context, fn);\n\n    return tFn(library, fn.cIdentifier, { args: arrayLiteral(params), returns: ret, canThrow: fn.throws });\n};\n\nconst isMovedOntoEmittedMember = (context: ModuleContext, fn: GirFunction): boolean => {\n    const [typeName, memberName] = fn.movedTo?.split(\".\") ?? [];\n\n    if (typeName === undefined || memberName === undefined) {\n        return false;\n    }\n\n    const resolved = context.library.resolveType(context.namespace.name, typeName);\n\n    if (resolved?.kind !== \"class\" && resolved?.kind !== \"interface\" && resolved?.kind !== \"record\") {\n        return false;\n    }\n\n    const members = [...resolved.value.methods, ...resolved.value.functions, ...resolved.value.constructors];\n\n    return members.some((member) => member.name === memberName);\n};\n\nconst canEmitNamespaceFunction = (context: ModuleContext, fn: GirFunction): boolean =>\n    fn.introspectable &&\n    !isMovedOntoEmittedMember(context, fn) &&\n    fn.shadowedBy === undefined &&\n    fn.cIdentifier !== undefined &&\n    !hasUnmarshalableParam(context, fn);\n\nconst generateNamespaceFunction = (context: ModuleContext, fn: GirFunction): void => {\n    if (!canEmitNamespaceFunction(context, fn)) {\n        return;\n    }\n\n    const expression = renderFnExpression(context, fn);\n\n    if (expression === undefined) {\n        return;\n    }\n\n    const cIdentifier = fn.cIdentifier;\n\n    if (cIdentifier === undefined) {\n        return;\n    }\n\n    const bindingName = toCamelIdentifier(cIdentifier);\n    context.module.appendBinding(`const ${bindingName} = ${expression};`, cIdentifier);\n    const exportName = namespaceFunctionExportName(cIdentifier, fn.name, context.namespace.cSymbolPrefixes);\n    const finish = matchNamespaceFinish(context, fn);\n    const declaration = renderNamespaceFunctionDeclaration({ context, fn, finish, exportName, bindingName });\n    const doc = callableDoc(context, fn, { finishFn: finish?.fn });\n    context.module.appendDeclaration(`${doc}${declaration}`);\n};\n\nconst matchNamespaceFinish = (context: ModuleContext, fn: GirFunction): NamespaceFinish | undefined => {\n    const finishFn = matchAsyncFinish(context.library, fn, context.namespace.functions);\n    const cIdentifier = finishFn?.cIdentifier;\n\n    if (finishFn === undefined || cIdentifier === undefined || !canEmitNamespaceFunction(context, finishFn)) {\n        return undefined;\n    }\n\n    return {\n        fn: finishFn,\n        exportName: namespaceFunctionExportName(cIdentifier, finishFn.name, context.namespace.cSymbolPrefixes),\n    };\n};\n\nconst renderPromisifiedNamespaceFunction = (options: NamespaceFunctionOptions, finish: NamespaceFinish): string => {\n    const { context, fn, exportName, bindingName } = options;\n    const { signature, returnType } = renderPromisifiedSignature(context, fn, finish.fn);\n    const body = renderPromisifiedBody(context, fn, finish.exportName, bindingName);\n\n    return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);\n};\n\nconst renderNamespaceFunctionDeclaration = (options: NamespaceFunctionOptions): string => {\n    const { context, fn, finish, exportName, bindingName } = options;\n\n    if (finish !== undefined) {\n        return renderPromisifiedNamespaceFunction(options, finish);\n    }\n\n    const signature = renderMethodSignature(context, fn);\n    const returnType = renderMethodReturnType(context, fn);\n    const body = renderMethodBody(context, fn, { bindingExpression: bindingName });\n\n    return renderBlock(`export function ${exportName}(${signature}): ${returnType}`, body);\n};\n\nconst namespaceFunctionExportName = (cIdentifier: string, girName: string, symbolPrefixes: string[]): string => {\n    if (girName.length > 0) {\n        return toCamelIdentifier(girName);\n    }\n\n    const stripped = stripLongestPrefix(cIdentifier, symbolPrefixes);\n\n    return toCamelIdentifier(stripped);\n};\n\nconst stripLongestPrefix = (input: string, prefixes: string[]): string => {\n    let best = \"\";\n\n    for (const prefix of prefixes) {\n        const candidate = `${prefix}_`;\n\n        if (input.startsWith(candidate) && candidate.length > best.length) {\n            best = candidate;\n        }\n    }\n\n    return best.length === 0 ? input : input.slice(best.length);\n};\n\nconst isBootstrapFunction = (fn: GirFunction): boolean =>\n    fn.parameters.length === 0 && fn.introspectable && fn.shadowedBy === undefined && fn.cIdentifier !== undefined;\n\nconst appendBootstrapRegistration = (context: ModuleContext, fn: GirFunction, exportName: string): void => {\n    if (fn.name === \"init\") {\n        context.module.appendRegistration(`${exportName}();`);\n\n        return;\n    }\n\n    if (fn.name === \"finalize\") {\n        context.addRuntimeImport(\"onExit\");\n        context.module.appendRegistration(`onExit(${exportName});`);\n    }\n};\n\nconst generateNamespaceBootstrap = (context: ModuleContext, namespace: GirNamespace): void => {\n    for (const fn of namespace.functions) {\n        if (!isBootstrapFunction(fn) || fn.cIdentifier === undefined) {\n            continue;\n        }\n\n        const exportName = namespaceFunctionExportName(fn.cIdentifier, fn.name, context.namespace.cSymbolPrefixes);\n        appendBootstrapRegistration(context, fn, exportName);\n    }\n};\n\nexport { renderFnExpression, generateNamespaceFunction, namespaceFunctionExportName, generateNamespaceBootstrap };\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/store/gi/interface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAoD7D,QAAA,MAAM,iBAAiB,GAAI,SAAS,aAAa,EAAE,OAAO,QAAQ,KAAG,IAkCpE,CAAC;AAoIF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/store/gi/interface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAsE7D,QAAA,MAAM,iBAAiB,GAAI,SAAS,aAAa,EAAE,OAAO,QAAQ,KAAG,IAmCpE,CAAC;AA6SF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/store/gi/interface.js

@@ -1,14 +1,21 @@
-import { pascalCase } from "@gtkx/utils";
+import { pascalCase, sourceStringLiteral } from "@gtkx/utils";
 import { reservedSignalMemberRename, resolvePrerequisiteReference } from "../../analysis/inheritance.js";
+import { resolveInterfaces } from "../../gir/ancestry.js";
 import { renderJsDoc } from "../../writer/doc.js";
-import { renderBlock, renderBracedOrEmpty } from "../../writer/emit.js";
-import { dedupeCallables, generateBindings, instanceScope, renderClassInstanceMember, renderInstanceMethodSignature, renderStaticHead, } from "./callables.js";
+import { renderBlock, renderBraced, renderBracedOrEmpty } from "../../writer/emit.js";
+import { dedupeCallables, generateBindings, instanceScope, isEmittableCallable, renderClassInstanceMember, renderInstanceMethodSignature, renderStaticHead, } from "./callables.js";
+import { annotationSpec, getDoc } from "./doc-spec.js";
 import { renderSourceGtype } from "./gtype-binding.js";
 import { methodExportName } from "./method.js";
 import { renderPropertyAccessor, renderPropertyAccessorSignature, } from "./property-accessor.js";
 import { appendInterfaceRegistration } from "./registration.js";
 import { renderSignalDeclarations, renderSignalMembers } from "./signal.js";
-import { renderVfuncMetadata } from "./vtable.js";
+import { hasCallableVfuncSlots, renderVfuncMembers, renderVfuncMetadata, } from "./vtable.js";
+const BRAND_NOTE = [
+    "Phantom link to the type a class fills to adopt the interface, which `registerClass` reads",
+    "through its `implements` option. It holds no value at runtime. `unknown` asks nothing of the",
+    "class, which is what an interface with no slot to fill carries.",
+].join("\n");
 const generateInterface = (context, iface) => {
     if (!iface.introspectable) {
         return;
@@ -24,8 +31,9 @@ const generateInterface = (context, iface) => {
     };
     generateBindings(context, callables);
     const gtypeExpr = renderSourceGtype(context, iface);
-    context.module.appendDeclaration(renderInterfaceType(context, iface, className, callables));
-    context.module.appendDeclaration(renderInterfaceClass(context, className, callables, gtypeExpr));
+    const implRef = appendInterfaceTypes(context, iface, className, callables) ?? "unknown";
+    const classCode = renderInterfaceClass(context, { iface, className, callables, gtypeExpr, implRef });
+    context.module.appendDeclaration(classCode, context.declaredType(className));
     for (const declaration of renderSignalDeclarations(context, iface, className, true)) {
         context.module.appendDeclaration(declaration);
     }
@@ -34,10 +42,71 @@ const generateInterface = (context, iface) => {
         className,
         makerName: makerName(className),
         gtypeExpr,
-        vfuncs: renderVfuncMetadata(context, iface),
+        layout: renderInterfaceLayout(context, iface, callables),
     });
 };
 const makerName = (className) => `make${className}`;
+const renderInterfaceLayout = (context, iface, callables) => {
+    const vfuncs = renderVfuncMetadata(context, iface);
+    const properties = renderSlotBackedProperties(context, iface, callables);
+    if (vfuncs === undefined && properties === undefined) {
+        return undefined;
+    }
+    const entries = [];
+    if (vfuncs !== undefined) {
+        entries.push(`vfuncs: ${vfuncs},`);
+    }
+    if (properties !== undefined) {
+        entries.push(`properties: ${properties},`);
+    }
+    return renderBraced(entries.join("\n"));
+};
+const invokerMembers = (context, iface, callables) => {
+    const className = pascalCase(iface.name);
+    const invokers = new Set(iface.vfuncs.map((vfunc) => vfunc.invoker).filter((invoker) => invoker !== undefined));
+    const members = new Map();
+    for (const callable of callables.methods) {
+        if (invokers.has(callable.name) && isEmittableCallable(context, callable)) {
+            members.set(callable.name, reservedSignalMemberRename(className, callable) ?? methodExportName(callable));
+        }
+    }
+    return members;
+};
+const renderSlotAccessor = (key, method, members) => {
+    const member = method === undefined ? undefined : members.get(method);
+    return member === undefined ? undefined : `${key}: ${sourceStringLiteral(member)},`;
+};
+const renderSlotBackedProperty = (property, members) => {
+    if (!property.introspectable) {
+        return undefined;
+    }
+    const fields = [
+        renderSlotAccessor("getter", property.getter, members),
+        renderSlotAccessor("setter", property.setter, members),
+    ].filter((field) => field !== undefined);
+    if (fields.length === 0) {
+        return undefined;
+    }
+    return `${sourceStringLiteral(property.name)}: ${renderBraced(fields.join("\n"))},`;
+};
+const renderSlotBackedProperties = (context, iface, callables) => {
+    const members = invokerMembers(context, iface, callables);
+    const entries = iface.properties
+        .map((property) => renderSlotBackedProperty(property, members))
+        .filter((entry) => entry !== undefined);
+    return entries.length === 0 ? undefined : renderBraced(entries.join("\n"));
+};
+const appendInterfaceTypes = (context, iface, className, callables) => {
+    const typeCode = renderInterfaceType(context, iface, className, callables);
+    context.module.appendDeclaration(typeCode, context.declaredType(className));
+    const implType = renderInterfaceImplType(context, iface, className);
+    if (implType === undefined) {
+        return undefined;
+    }
+    const implName = implTypeName(className);
+    context.module.appendDeclaration(implType, context.declaredType(className, implName));
+    return implName;
+};
 const interfaceTypeExtends = (context, iface) => {
     const refs = iface.prerequisites
         .map((name) => resolvePrerequisiteReference(context, name))
@@ -49,7 +118,43 @@ const interfaceTypeExtends = (context, iface) => {
 };
 const renderInterfaceType = (context, iface, className, callables) => {
     const members = renderInterfaceTypeMembers(context, iface, callables);
-    return `${renderJsDoc(iface.doc)}${renderBracedOrEmpty(`export interface ${className} extends ${interfaceTypeExtends(context, iface)}`, members.join("\n"))}`;
+    return `${getDoc(iface)}${renderBracedOrEmpty(`export interface ${className} extends ${interfaceTypeExtends(context, iface)}`, members.join("\n"))}`;
+};
+const implTypeName = (className) => `${className}Impl`;
+const implTypeNote = (className) => [
+    `Implementer side of \`${className}\`: the vtable slots a class fills to adopt the interface.`,
+    "",
+    `Declare it with \`implements ${implTypeName(className)}\` on a class passed to \`registerClass\``,
+    `with \`${className}\` in \`implements\`. The interface's methods, properties, and signals come from`,
+    "GLib dispatch, so they are not part of this type.",
+    "",
+    "Every slot is optional: an unfilled one keeps whatever the interface installs by default, and a",
+    "GIR update can add one. Declaring a slot pins its signature; declaring it as a class field rather",
+    "than a method satisfies this type but never reaches the vtable.",
+].join("\n");
+const implPrerequisiteRefs = (context, iface) => {
+    const prerequisites = resolveInterfaces(context.library, context.namespace.name, iface.prerequisites);
+    const refs = [];
+    for (const prerequisite of prerequisites) {
+        if (!hasCallableVfuncSlots(context, prerequisite.namespaceName, prerequisite.klass)) {
+            continue;
+        }
+        const name = implTypeName(pascalCase(prerequisite.klass.name));
+        refs.push(context.qualify(prerequisite.namespaceName, name));
+    }
+    return refs;
+};
+const implTypeExtends = (context, iface) => {
+    const refs = implPrerequisiteRefs(context, iface);
+    return refs.length > 0 ? ` extends ${refs.join(", ")}` : "";
+};
+const interfaceVfuncMembers = (context, iface, mode) => renderVfuncMembers({ context, klass: iface, mode });
+const renderInterfaceImplType = (context, iface, className) => {
+    const members = interfaceVfuncMembers(context, iface, "requirement");
+    if (members.length === 0) {
+        return undefined;
+    }
+    return `${renderJsDoc(iface.doc, implTypeNote(className), annotationSpec(iface.annotations))}${renderBracedOrEmpty(`export interface ${implTypeName(className)}${implTypeExtends(context, iface)}`, members.join("\n"))}`;
 };
 const collectMethodMembers = (options) => {
     const { context, className, scope, callables, renderers, claimedNames } = options;
@@ -84,17 +189,25 @@ const renderInterfaceMembers = (context, iface, callables, renderers) => {
     const propertyMembers = collectPropertyMembers({ context, iface, scope, renderers, claimedNames });
     return [...methodMembers, ...propertyMembers];
 };
-const renderInterfaceTypeMembers = (context, iface, callables) => renderInterfaceMembers(context, iface, callables, {
-    renderMethod: renderInstanceMethodSignature,
-    renderProperty: renderPropertyAccessorSignature,
-});
-const renderInterfaceClass = (context, className, callables, gtypeExpr) => {
+const renderInterfaceTypeMembers = (context, iface, callables) => [
+    ...renderInterfaceMembers(context, iface, callables, {
+        renderMethod: renderInstanceMethodSignature,
+        renderProperty: renderPropertyAccessorSignature,
+    }),
+    ...interfaceVfuncMembers(context, iface, "signature"),
+];
+const renderInterfaceClass = (context, options) => {
+    const { iface, className, callables, gtypeExpr, implRef } = options;
     const members = [];
     if (gtypeExpr !== undefined) {
         members.push(renderInterfaceHasInstance(context, className, gtypeExpr));
     }
-    members.push(...renderStaticHead(context, callables, className));
-    return renderBracedOrEmpty(`export abstract class ${className}`, members.join("\n\n"));
+    members.push(...renderStaticHead(context, callables, className), renderInterfaceBrand(context, implRef));
+    return `${getDoc(iface)}${renderBracedOrEmpty(`export abstract class ${className}`, members.join("\n\n"))}`;
+};
+const renderInterfaceBrand = (context, implRef) => {
+    context.addRuntimeTypeImport("Interface");
+    return `${renderJsDoc(undefined, BRAND_NOTE)}declare static __impl__: Interface<${implRef}>["__impl__"];`;
 };
 const renderInterfaceHasInstance = (context, className, gtypeExpr) => {
     context.addRuntimeImport("valueIsA");
@@ -104,13 +217,14 @@ const renderInterfaceMaker = (context, iface, className, callables) => {
     context.addRuntimeTypeImport("Mixin");
     const members = renderInterfaceInstanceMembers(context, iface, callables);
     const classExpression = renderBracedOrEmpty("class extends Base", members.join("\n\n"));
-    return `export const ${makerName(className)}: Mixin = (Base) =>\n${classExpression};`;
+    return `${getDoc(iface)}export const ${makerName(className)}: Mixin = (Base) =>\n${classExpression};`;
 };
 const renderInterfaceInstanceMembers = (context, iface, callables) => [
     ...renderInterfaceMembers(context, iface, callables, {
         renderMethod: renderClassInstanceMember,
         renderProperty: renderPropertyAccessor,
     }),
+    ...interfaceVfuncMembers(context, iface, "implementation"),
     ...renderSignalMembers(context, iface),
 ];
 export { generateInterface };