@gtkx/codegen 0.21.0 → 1.0.0-rc.1

package/dist/docs/render.js

@@ -0,0 +1,134 @@
+import { sortStringsBy, toPascalCase } from "@gtkx/utils";
+import { collectInheritedMethods, conflictRename } from "../analysis/inheritance.js";
+import { renderHandlerParameters, renderHandlerResultType } from "../analysis/param-structure.js";
+import { renderBaseTypeFor } from "../analysis/ts-type.js";
+import { dedupeCallables, indexMethodsByName, renderInstanceMethodSignature } from "../store/gi/callables.js";
+import { methodExportName } from "../store/gi/method.js";
+import { ModuleContext } from "../writer/context.js";
+import { gtkDocToMarkdown } from "../writer/gtk-doc.js";
+const docsTarget = (library) => ({
+    containerStyle: "record",
+    callbackType: "((...args: unknown[]) => unknown)",
+    byteArrayAsNumber: false,
+    renderNamed: (resolved, name) => {
+        if (resolved?.kind === "alias") {
+            return resolved.value.target === undefined
+                ? "number"
+                : renderBaseTypeFor(library, docsTarget(library), resolved.value.target);
+        }
+        return `${name.namespaceName}.${name.typeName}`;
+    },
+    renderGtype: () => "GObject.Type",
+});
+export const renderDocsType = (library, ref, isNullable) => {
+    const base = renderBaseTypeFor(library, docsTarget(library), ref);
+    return isNullable ? `${base} | null` : base;
+};
+const renderDocsHandlerResultType = (library, signal) => renderHandlerResultType({
+    library,
+    signal,
+    renderType: (ref, nullable) => renderDocsType(library, ref, nullable),
+    includeCallerAllocated: false,
+    optOut: true,
+});
+const renderDocsHandlerParameters = (library, signal) => renderHandlerParameters(signal.parameters, (ref, nullable) => renderDocsType(library, ref, nullable));
+export const renderDocsSignalSignature = (library, signal, selfType) => {
+    const params = [...renderDocsHandlerParameters(library, signal), `self: ${selfType}`];
+    return `(${params.join(", ")}) => ${renderDocsHandlerResultType(library, signal)}`;
+};
+export const renderDocsSignalHandlerType = (library, signal) => `(${renderDocsHandlerParameters(library, signal).join(", ")}) => ${renderDocsHandlerResultType(library, signal)}`;
+const DOCS_DEFAULT_VALUES = { TRUE: "true", FALSE: "false", NULL: "null" };
+export const docsDefaultValue = (value) => DOCS_DEFAULT_VALUES[value] ?? value;
+const stripDocMedia = (markdown) => markdown
+    .replace(/<picture[\s\S]*?<\/picture>/g, "")
+    .replace(/<video[\s\S]*?(?:<\/video>|\/>)/g, "")
+    .replace(/<img[^>]*>/g, "");
+const demoteHeadings = (markdown) => {
+    let inFence = false;
+    return markdown
+        .split("\n")
+        .map((line) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            return line;
+        }
+        if (inFence)
+            return line;
+        return /^#{1,5}\s/.test(line) ? `#${line}` : line;
+    })
+        .join("\n");
+};
+export const docMarkdown = (doc) => doc === undefined || doc.length === 0 ? "" : demoteHeadings(stripDocMedia(gtkDocToMarkdown(doc))).trim();
+const stripMarkdown = (markdown) => markdown
+    .replace(/```[\s\S]*?```/g, " ")
+    .replace(/`([^`]*)`/g, "$1")
+    .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
+    .replace(/[*_#>]/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+export const firstSentence = (doc) => {
+    const text = stripMarkdown(docMarkdown(doc));
+    if (text.length === 0)
+        return "";
+    const match = text.match(/^.*?[.!?](?=\s|$)/);
+    const sentence = match?.[0] ?? text;
+    return sentence.length > 220 ? `${sentence.slice(0, 217)}...` : sentence;
+};
+export const elementSlug = (className) => className
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+    .toLowerCase();
+export const joinSections = (sections) => `${sections.filter((section) => section.length > 0).join("\n\n")}\n`;
+export const metaBlock = (name, meta, doc) => {
+    const lines = [`### \`${name}\``, "", meta];
+    if (doc.length > 0)
+        lines.push("", doc);
+    return lines.join("\n");
+};
+export const signatureBlock = (name, signature, notes) => {
+    const lines = [`### \`${name}\``, "", `\`\`\`ts\n${signature}\n\`\`\``];
+    for (const note of notes) {
+        if (note.length > 0)
+            lines.push("", note);
+    }
+    return lines.join("\n");
+};
+const LEADING_NAMESPACES = ["Gtk", "Adw"];
+export const namespaceOrder = (name) => {
+    const index = LEADING_NAMESPACES.indexOf(name);
+    return index === -1 ? `1${name}` : `0${index}`;
+};
+const DOCS_SIGNATURE_NAMESPACE = "$docs";
+export const docsSignatureContext = (namespace, library) => new ModuleContext({ ...namespace, name: DOCS_SIGNATURE_NAMESPACE }, library);
+export const originSignatureBlocks = (entries) => sortStringsBy(entries, (item) => item.name).map((item) => signatureBlock(item.name, item.signature, [
+    item.origin === undefined ? "" : `From \`${item.origin}\`.`,
+    item.doc,
+]));
+export const classMethodEntries = (library, namespace, klass) => {
+    const realContext = new ModuleContext(namespace, library);
+    const signatureContext = docsSignatureContext(namespace, library);
+    const className = toPascalCase(klass.name);
+    const inherited = collectInheritedMethods(realContext, klass);
+    return instanceMethodEntries(signatureContext, klass.methods, (method) => conflictRename(realContext, method, inherited, className));
+};
+export const methodsSectionBlocks = (entries, intro) => entries.length === 0
+    ? []
+    : ["## Methods", intro, ...entries.map((item) => signatureBlock(item.name, item.signature, [item.doc]))];
+export const instanceMethodEntries = (signatureContext, methods, rename) => {
+    const deduped = dedupeCallables(methods);
+    const siblings = indexMethodsByName(deduped);
+    const entries = [];
+    for (const method of deduped) {
+        const nameOverride = rename(method);
+        const rendered = renderInstanceMethodSignature(signatureContext, { ...method, doc: undefined }, siblings, nameOverride);
+        if (rendered === undefined)
+            continue;
+        entries.push({
+            name: nameOverride ?? methodExportName(method),
+            signature: rendered.trim().replace(/;$/, ""),
+            doc: docMarkdown(method.doc),
+        });
+    }
+    return sortStringsBy(entries, (entry) => entry.name);
+};
+//# sourceMappingURL=render.js.map

package/dist/docs/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/docs/render.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStringsBy, toPascalCase } from \"@gtkx/utils\";\nimport { collectInheritedMethods, conflictRename } from \"../analysis/inheritance.js\";\nimport { renderHandlerParameters, renderHandlerResultType } from \"../analysis/param-structure.js\";\nimport { renderBaseTypeFor, type TsTypeTarget } from \"../analysis/ts-type.js\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { GirNamespace } from \"../gir/namespace.js\";\nimport type { GirSignal } from \"../gir/parameter.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport { dedupeCallables, indexMethodsByName, renderInstanceMethodSignature } from \"../store/gi/callables.js\";\nimport { methodExportName } from \"../store/gi/method.js\";\nimport { ModuleContext } from \"../writer/context.js\";\nimport { gtkDocToMarkdown } from \"../writer/gtk-doc.js\";\n\nconst docsTarget = (library: Library): TsTypeTarget => ({\n    containerStyle: \"record\",\n    callbackType: \"((...args: unknown[]) => unknown)\",\n    byteArrayAsNumber: false,\n    renderNamed: (resolved, name) => {\n        if (resolved?.kind === \"alias\") {\n            return resolved.value.target === undefined\n                ? \"number\"\n                : renderBaseTypeFor(library, docsTarget(library), resolved.value.target);\n        }\n        return `${name.namespaceName}.${name.typeName}`;\n    },\n    renderGtype: () => \"GObject.Type\",\n});\n\nexport const renderDocsType = (library: Library, ref: TypeId | undefined, isNullable: boolean): string => {\n    const base = renderBaseTypeFor(library, docsTarget(library), ref);\n    return isNullable ? `${base} | null` : base;\n};\n\nconst renderDocsHandlerResultType = (library: Library, signal: GirSignal): string =>\n    renderHandlerResultType({\n        library,\n        signal,\n        renderType: (ref, nullable) => renderDocsType(library, ref, nullable),\n        includeCallerAllocated: false,\n        optOut: true,\n    });\n\nconst renderDocsHandlerParameters = (library: Library, signal: GirSignal): string[] =>\n    renderHandlerParameters(signal.parameters, (ref, nullable) => renderDocsType(library, ref, nullable));\n\nexport const renderDocsSignalSignature = (library: Library, signal: GirSignal, selfType: string): string => {\n    const params = [...renderDocsHandlerParameters(library, signal), `self: ${selfType}`];\n    return `(${params.join(\", \")}) => ${renderDocsHandlerResultType(library, signal)}`;\n};\n\nexport const renderDocsSignalHandlerType = (library: Library, signal: GirSignal): string =>\n    `(${renderDocsHandlerParameters(library, signal).join(\", \")}) => ${renderDocsHandlerResultType(library, signal)}`;\n\nconst DOCS_DEFAULT_VALUES: Record<string, string> = { TRUE: \"true\", FALSE: \"false\", NULL: \"null\" };\n\nexport const docsDefaultValue = (value: string): string => DOCS_DEFAULT_VALUES[value] ?? value;\n\nconst stripDocMedia = (markdown: string): string =>\n    markdown\n        .replace(/<picture[\\s\\S]*?<\\/picture>/g, \"\")\n        .replace(/<video[\\s\\S]*?(?:<\\/video>|\\/>)/g, \"\")\n        .replace(/<img[^>]*>/g, \"\");\n\nconst demoteHeadings = (markdown: string): string => {\n    let inFence = false;\n    return markdown\n        .split(\"\\n\")\n        .map((line) => {\n            if (/^\\s*(```|~~~)/.test(line)) {\n                inFence = !inFence;\n                return line;\n            }\n            if (inFence) return line;\n            return /^#{1,5}\\s/.test(line) ? `#${line}` : line;\n        })\n        .join(\"\\n\");\n};\n\nexport const docMarkdown = (doc: string | undefined): string =>\n    doc === undefined || doc.length === 0 ? \"\" : demoteHeadings(stripDocMedia(gtkDocToMarkdown(doc))).trim();\n\nconst stripMarkdown = (markdown: string): string =>\n    markdown\n        .replace(/```[\\s\\S]*?```/g, \" \")\n        .replace(/`([^`]*)`/g, \"$1\")\n        .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n        .replace(/[*_#>]/g, \"\")\n        .replace(/\\s+/g, \" \")\n        .trim();\n\nexport const firstSentence = (doc: string | undefined): string => {\n    const text = stripMarkdown(docMarkdown(doc));\n    if (text.length === 0) return \"\";\n    const match = text.match(/^.*?[.!?](?=\\s|$)/);\n    const sentence = match?.[0] ?? text;\n    return sentence.length > 220 ? `${sentence.slice(0, 217)}...` : sentence;\n};\n\nexport const elementSlug = (className: string): string =>\n    className\n        .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n        .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1-$2\")\n        .toLowerCase();\n\nexport const joinSections = (sections: string[]): string =>\n    `${sections.filter((section) => section.length > 0).join(\"\\n\\n\")}\\n`;\n\nexport const metaBlock = (name: string, meta: string, doc: string): string => {\n    const lines = [`### \\`${name}\\``, \"\", meta];\n    if (doc.length > 0) lines.push(\"\", doc);\n    return lines.join(\"\\n\");\n};\n\nexport const signatureBlock = (name: string, signature: string, notes: string[]): string => {\n    const lines = [`### \\`${name}\\``, \"\", `\\`\\`\\`ts\\n${signature}\\n\\`\\`\\``];\n    for (const note of notes) {\n        if (note.length > 0) lines.push(\"\", note);\n    }\n    return lines.join(\"\\n\");\n};\n\nconst LEADING_NAMESPACES = [\"Gtk\", \"Adw\"];\n\nexport const namespaceOrder = (name: string): string => {\n    const index = LEADING_NAMESPACES.indexOf(name);\n    return index === -1 ? `1${name}` : `0${index}`;\n};\n\nconst DOCS_SIGNATURE_NAMESPACE = \"$docs\";\n\nexport const docsSignatureContext = (namespace: GirNamespace, library: Library): ModuleContext =>\n    new ModuleContext({ ...namespace, name: DOCS_SIGNATURE_NAMESPACE }, library);\n\nexport type SignatureEntry = {\n    name: string;\n    signature: string;\n    doc: string;\n};\n\nexport type OriginSignatureEntry = SignatureEntry & { origin: string | undefined };\n\nexport const originSignatureBlocks = (entries: OriginSignatureEntry[]): string[] =>\n    sortStringsBy(entries, (item) => item.name).map((item) =>\n        signatureBlock(item.name, item.signature, [\n            item.origin === undefined ? \"\" : `From \\`${item.origin}\\`.`,\n            item.doc,\n        ]),\n    );\n\nexport const classMethodEntries = (library: Library, namespace: GirNamespace, klass: GirClass): SignatureEntry[] => {\n    const realContext = new ModuleContext(namespace, library);\n    const signatureContext = docsSignatureContext(namespace, library);\n    const className = toPascalCase(klass.name);\n    const inherited = collectInheritedMethods(realContext, klass);\n    return instanceMethodEntries(signatureContext, klass.methods, (method) =>\n        conflictRename(realContext, method, inherited, className),\n    );\n};\n\nexport const methodsSectionBlocks = (entries: SignatureEntry[], intro: string): string[] =>\n    entries.length === 0\n        ? []\n        : [\"## Methods\", intro, ...entries.map((item) => signatureBlock(item.name, item.signature, [item.doc]))];\n\nexport const instanceMethodEntries = (\n    signatureContext: ModuleContext,\n    methods: GirFunction[],\n    rename: (fn: GirFunction) => string | undefined,\n): SignatureEntry[] => {\n    const deduped = dedupeCallables(methods);\n    const siblings = indexMethodsByName(deduped);\n    const entries: SignatureEntry[] = [];\n    for (const method of deduped) {\n        const nameOverride = rename(method);\n        const rendered = renderInstanceMethodSignature(\n            signatureContext,\n            { ...method, doc: undefined },\n            siblings,\n            nameOverride,\n        );\n        if (rendered === undefined) continue;\n        entries.push({\n            name: nameOverride ?? methodExportName(method),\n            signature: rendered.trim().replace(/;$/, \"\"),\n            doc: docMarkdown(method.doc),\n        });\n    }\n    return sortStringsBy(entries, (entry) => entry.name);\n};\n"]}

package/dist/docs/symbol-page.d.ts

@@ -0,0 +1,41 @@
+import { type GirCallback } from "../gir/callback.js";
+import type { GirClass } from "../gir/class.js";
+import type { GirEnum } from "../gir/enum.js";
+import type { GirFunction } from "../gir/function.js";
+import type { Library } from "../gir/library.js";
+import { type GirAlias, type GirConstant, type GirNamespace } from "../gir/namespace.js";
+import type { GirRecord } from "../gir/record.js";
+type GiSymbolBase = {
+    namespace: GirNamespace;
+    name: string;
+    doc: string | undefined;
+};
+export type GiSymbolEntry = (GiSymbolBase & {
+    kind: "class" | "interface";
+    klass: GirClass;
+}) | (GiSymbolBase & {
+    kind: "record";
+    record: GirRecord;
+}) | (GiSymbolBase & {
+    kind: "enum";
+    enumeration: GirEnum;
+}) | (GiSymbolBase & {
+    kind: "callback";
+    callback: GirCallback;
+}) | (GiSymbolBase & {
+    kind: "alias";
+    alias: GirAlias;
+}) | (GiSymbolBase & {
+    kind: "function";
+    fn: GirFunction;
+}) | (GiSymbolBase & {
+    kind: "constant";
+    constant: GirConstant;
+});
+export type SymbolPageOptions = {
+    library: Library;
+    elementNameFor: (namespaceName: string, className: string) => string | undefined;
+};
+export declare const renderSymbolPage: (entry: GiSymbolEntry, options: SymbolPageOptions) => string;
+export {};
+//# sourceMappingURL=symbol-page.d.ts.map

package/dist/docs/symbol-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-page.d.ts","sourceRoot":"","sources":["../../src/docs/symbol-page.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAG7G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqClD,KAAK,YAAY,GAAG;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GACnB,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,GACjE,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,GACtD,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,GACvD,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC,GAC5D,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,GACnD,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,WAAW,CAAA;CAAE,CAAC,GACtD,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpF,CAAC;AAuPF,eAAO,MAAM,gBAAgB,UAAW,aAAa,WAAW,iBAAiB,KAAG,MAkBnF,CAAC"}

package/dist/docs/symbol-page.js

@@ -0,0 +1,338 @@
+import { sortStringsBy, toPascalCase } from "@gtkx/utils";
+import { reservedSignalMemberRename } from "../analysis/inheritance.js";
+import { renderTsType } from "../analysis/ts-type.js";
+import { ancestorChain } from "../gir/ancestry.js";
+import { callbackAsFunction } from "../gir/callback.js";
+import { namespaceDirectory } from "../gir/namespace.js";
+import { PRIMITIVE_TS_TYPE, primitiveCategory } from "../gir/primitives.js";
+import { dedupeCallables, indexMethodsByName, matchStaticFinishFunction, renderInstanceMethodSignature, renderStaticSignature, } from "../store/gi/callables.js";
+import { constantLiteral } from "../store/gi/constant.js";
+import { enumMemberKey } from "../store/gi/enum.js";
+import { methodExportName, renderMethodReturnType, renderMethodSignature, renderPromisifiedSignature, } from "../store/gi/method.js";
+import { resolveAccessor } from "../store/gi/property-accessor.js";
+import { resolveRecordFieldEntry } from "../store/gi/record-field-accessor.js";
+import { computeRecordFieldSlots } from "../store/gi/record-layout.js";
+import { implementedInterfaces, newlyImplementedInterfaces } from "../store/react/intrinsic-elements.js";
+import { classMethodEntries, docMarkdown, docsDefaultValue, docsSignatureContext, firstSentence, joinSections, metaBlock, methodsSectionBlocks, originSignatureBlocks, renderDocsSignalHandlerType, renderDocsType, signatureBlock, } from "./render.js";
+const qualifiedName = (entry) => `${entry.namespace.name}.${entry.name}`;
+const frontmatter = (entry, kindLabel) => {
+    const sentence = firstSentence(entry.doc);
+    const description = sentence.length > 0 ? sentence : `API reference for the ${qualifiedName(entry)} ${kindLabel}.`;
+    return `---\ndescription: ${JSON.stringify(description)}\n---`;
+};
+const kindLine = (kindLabel, namespace) => `\`${kindLabel}\` in \`@gtkx/gi/${namespaceDirectory(namespace)}\``;
+const importBlock = (entry) => `\`\`\`ts\nimport * as ${entry.namespace.name} from "@gtkx/gi/${namespaceDirectory(entry.namespace)}";\n\`\`\``;
+const pageHeader = (entry, kindLabel) => [
+    frontmatter(entry, kindLabel),
+    `# ${qualifiedName(entry)}`,
+    kindLine(kindLabel, entry.namespace),
+    docMarkdown(entry.doc),
+    importBlock(entry),
+];
+const qualifiedClassName = (namespaceName, className) => `${namespaceName}.${toPascalCase(className)}`;
+const elementNote = (entry, options) => {
+    const glibName = options.elementNameFor(entry.namespace.name, entry.klass.name);
+    if (glibName === undefined)
+        return [];
+    return [
+        `Also available as the \`${glibName}\` JSX element from \`@gtkx/jsx/${namespaceDirectory(entry.namespace)}\`; the \`${glibName}\` element page documents the JSX props.`,
+    ];
+};
+const hierarchySection = (entry, library) => {
+    const ancestors = [...ancestorChain(library, entry.klass, entry.namespace.name)].slice(1).reverse();
+    const interfaces = implementedInterfaces(entry.klass, entry.namespace, library).map((iface) => qualifiedClassName(iface.namespace.name, iface.klass.name));
+    if (ancestors.length === 0 && interfaces.length === 0)
+        return [];
+    const lines = ["## Hierarchy"];
+    if (ancestors.length > 0) {
+        const parts = ancestors.map((ancestor) => `\`${qualifiedClassName(ancestor.namespaceName, ancestor.klass.name)}\``);
+        parts.push(`**${qualifiedName(entry)}**`);
+        lines.push(parts.join(" → "));
+    }
+    if (interfaces.length > 0) {
+        lines.push(`Implements ${interfaces.map((name) => `\`${name}\``).join(", ")}.`);
+    }
+    return lines;
+};
+const prerequisitesLine = (entry, library) => {
+    const names = entry.klass.prerequisites.map((name) => {
+        const resolved = library.resolveType(entry.namespace.name, name);
+        if (resolved === undefined || (resolved.kind !== "class" && resolved.kind !== "interface")) {
+            return `\`${name}\``;
+        }
+        return `\`${qualifiedClassName(resolved.namespace.name, resolved.value.name)}\``;
+    });
+    if (names.length === 0)
+        return [];
+    return [`Requires ${names.join(", ")}.`];
+};
+const staticSection = (options) => {
+    const rendered = [];
+    for (const callable of dedupeCallables(options.callables)) {
+        const signature = renderStaticSignature(options.context, callable, {
+            returnTypeOverride: options.returnTypeOverride,
+            siblings: options.siblings,
+        });
+        if (signature === undefined)
+            continue;
+        rendered.push({
+            name: signature.name,
+            block: signatureBlock(signature.name, signature.signature, [docMarkdown(callable.doc)]),
+        });
+    }
+    if (rendered.length === 0)
+        return [];
+    return [options.title, options.intro, ...sortStringsBy(rendered, (item) => item.name).map((item) => item.block)];
+};
+const memberOwners = (entry, library) => [
+    { klass: entry.klass, namespace: entry.namespace, origin: undefined },
+    ...newlyImplementedInterfaces(entry.klass, entry.namespace, library).map((iface) => ({
+        klass: iface.klass,
+        namespace: iface.namespace,
+        origin: qualifiedClassName(iface.namespace.name, iface.klass.name),
+    })),
+];
+const interfaceMethodNames = (library, owner) => {
+    const context = docsSignatureContext(owner.namespace, library);
+    const className = toPascalCase(owner.klass.name);
+    const methods = dedupeCallables(owner.klass.methods);
+    const methodByName = indexMethodsByName(methods);
+    const names = [];
+    for (const callable of methods) {
+        const rename = reservedSignalMemberRename(className, callable);
+        const rendered = renderInstanceMethodSignature(context, { ...callable, doc: undefined }, methodByName, rename);
+        if (rendered === undefined)
+            continue;
+        names.push(rename ?? methodExportName(callable));
+    }
+    return names;
+};
+const propertyAccessorSetup = (owner, library, useClassRenames) => {
+    const claimedNames = new Set(useClassRenames
+        ? classMethodEntries(library, owner.namespace, owner.klass).map((item) => item.name)
+        : interfaceMethodNames(library, owner));
+    return {
+        context: docsSignatureContext(owner.namespace, library),
+        claimedNames,
+        methodByName: indexMethodsByName(dedupeCallables(owner.klass.methods)),
+    };
+};
+const propertyMeta = (property, accessor, origin) => {
+    const meta = [`\`${accessor.tsType}\``];
+    if (property.defaultValue !== undefined)
+        meta.push(`default \`${docsDefaultValue(property.defaultValue)}\``);
+    if (property.constructOnly)
+        meta.push("construct-only");
+    if (!accessor.writable)
+        meta.push("read-only");
+    else if (!accessor.hasGetter)
+        meta.push("write-only");
+    if (origin !== undefined)
+        meta.push(`from \`${origin}\``);
+    return meta.join(" · ");
+};
+const propertiesSection = (entry, library) => {
+    const seen = new Set();
+    const entries = [];
+    for (const [index, owner] of memberOwners(entry, library).entries()) {
+        const setup = propertyAccessorSetup(owner, library, index === 0 && entry.kind === "class");
+        for (const property of owner.klass.properties) {
+            const accessor = resolveAccessor({
+                context: setup.context,
+                property,
+                claimedNames: setup.claimedNames,
+                methodByName: setup.methodByName,
+            });
+            if (accessor === undefined || seen.has(accessor.jsName))
+                continue;
+            seen.add(accessor.jsName);
+            entries.push({
+                name: accessor.jsName,
+                meta: propertyMeta(property, accessor, owner.origin),
+                doc: docMarkdown(property.doc),
+            });
+        }
+    }
+    if (entries.length === 0)
+        return [];
+    const intro = `Properties are read and written as instance fields; changes can be observed with \`connect("notify::<property-name>", handler)\`. Properties inherited from ancestors are documented on their own pages.`;
+    const blocks = sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));
+    return ["## Properties", intro, ...blocks];
+};
+const signalsSection = (entry, library) => {
+    const seen = new Set();
+    const entries = [];
+    for (const owner of memberOwners(entry, library)) {
+        for (const signal of owner.klass.signals) {
+            if (seen.has(signal.name))
+                continue;
+            seen.add(signal.name);
+            entries.push({
+                name: signal.name,
+                signature: renderDocsSignalHandlerType(library, signal),
+                doc: docMarkdown(signal.doc),
+                origin: owner.origin,
+            });
+        }
+    }
+    if (entries.length === 0)
+        return [];
+    const intro = `Connect with \`instance.connect("<signal>", handler)\` or \`instance.on("<signal>", handler)\`. Signals inherited from ancestors are documented on their own pages.`;
+    return ["## Signals", intro, ...originSignatureBlocks(entries)];
+};
+const classMethodsSection = (entry, library) => methodsSectionBlocks(classMethodEntries(library, entry.namespace, entry.klass), "Methods are called on instances. Methods inherited from ancestors are documented on their own pages.");
+const classPage = (entry, options) => {
+    const { library } = options;
+    const qualified = qualifiedName(entry);
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const constructorsIntro = `Constructors are called on the class: \`${qualified}.new(...)\`.`;
+    const staticIntro = `Static methods are called on the class: \`${qualified}.<method>(...)\`.`;
+    const staticSiblings = [...entry.klass.constructors, ...entry.klass.functions];
+    return joinSections([
+        ...pageHeader(entry, entry.kind),
+        ...elementNote(entry, options),
+        ...(entry.kind === "interface" ? prerequisitesLine(entry, library) : hierarchySection(entry, library)),
+        ...staticSection({
+            title: "## Constructors",
+            intro: constructorsIntro,
+            context: docsContext,
+            callables: entry.klass.constructors,
+            siblings: staticSiblings,
+            returnTypeOverride: qualified,
+        }),
+        ...staticSection({
+            title: "## Static methods",
+            intro: staticIntro,
+            context: docsContext,
+            callables: entry.klass.functions,
+            siblings: staticSiblings,
+        }),
+        ...propertiesSection(entry, library),
+        ...signalsSection(entry, library),
+        ...classMethodsSection(entry, library),
+    ]);
+};
+export const renderSymbolPage = (entry, options) => {
+    switch (entry.kind) {
+        case "class":
+        case "interface":
+            return classPage(entry, options);
+        case "record":
+            return recordPage(entry, options.library);
+        case "enum":
+            return enumPage(entry);
+        case "callback":
+            return callbackPage(entry, options.library);
+        case "alias":
+            return aliasPage(entry, options.library);
+        case "function":
+            return functionPage(entry, options.library);
+        case "constant":
+            return constantPage(entry, options.library);
+    }
+};
+const recordInstanceEntries = (context, record) => {
+    const entries = [];
+    for (const callable of dedupeCallables(record.methods)) {
+        const rendered = renderStaticSignature(context, callable);
+        if (rendered === undefined)
+            continue;
+        entries.push({ name: rendered.name, signature: rendered.signature, doc: docMarkdown(callable.doc) });
+    }
+    return sortStringsBy(entries, (item) => item.name);
+};
+const recordPage = (entry, library) => {
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const qualified = qualifiedName(entry);
+    const constructorsIntro = `Constructors are called on the class: \`${qualified}.new(...)\`.`;
+    const staticIntro = `Static methods are called on the class: \`${qualified}.<method>(...)\`.`;
+    const methodEntries = recordInstanceEntries(docsContext, entry.record);
+    const claimedNames = new Set(methodEntries.map((item) => item.name));
+    const staticSiblings = [...entry.record.constructors, ...entry.record.functions];
+    return joinSections([
+        ...pageHeader(entry, entry.record.isUnion ? "union" : "record"),
+        ...staticSection({
+            title: "## Constructors",
+            intro: constructorsIntro,
+            context: docsContext,
+            callables: entry.record.constructors,
+            siblings: staticSiblings,
+            returnTypeOverride: qualified,
+        }),
+        ...staticSection({
+            title: "## Static methods",
+            intro: staticIntro,
+            context: docsContext,
+            callables: entry.record.functions,
+            siblings: staticSiblings,
+        }),
+        ...fieldsSection(entry.record, docsContext, claimedNames),
+        ...methodsSectionBlocks(methodEntries, "Methods are called on instances."),
+    ]);
+};
+const fieldsSection = (record, context, claimedNames) => {
+    const { slots } = computeRecordFieldSlots(context, record.fields, record.isUnion);
+    const entries = [];
+    for (const slot of slots) {
+        const field = resolveRecordFieldEntry(context, slot, claimedNames);
+        if (field === undefined)
+            continue;
+        entries.push({
+            name: field.jsName,
+            meta: [`\`${field.tsType}\``, ...(field.writable ? [] : ["read-only"])].join(" · "),
+            doc: docMarkdown(field.doc),
+        });
+    }
+    if (entries.length === 0)
+        return [];
+    const blocks = sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));
+    return ["## Fields", ...blocks];
+};
+const enumPage = (entry) => {
+    const { enumeration } = entry;
+    const kindLabel = enumeration.errorDomain !== undefined ? "error domain" : enumeration.kind;
+    const qualified = qualifiedName(entry);
+    const rows = enumeration.members.map((member) => {
+        const description = firstSentence(member.doc).replaceAll("|", "\\|");
+        return `| \`${enumMemberKey(member.name)}\` | \`${member.value}\` | ${description} |`;
+    });
+    const usage = enumeration.errorDomain !== undefined
+        ? `Members are error codes for the \`${enumeration.errorDomain}\` GError domain, accessed as \`${qualified}.<member>\`.`
+        : `Members are accessed as \`${qualified}.<member>\`.`;
+    const table = ["| Member | Value | Description |", "| --- | --- | --- |", ...rows].join("\n");
+    return joinSections([...pageHeader(entry, kindLabel), "## Members", usage, table]);
+};
+const callbackPage = (entry, library) => {
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const fn = callbackAsFunction(entry.callback);
+    const signature = `type ${entry.name} = (${renderMethodSignature(docsContext, fn)}) => ${renderMethodReturnType(docsContext, fn)}`;
+    return joinSections([...pageHeader(entry, "callback"), "## Signature", `\`\`\`ts\n${signature}\n\`\`\``]);
+};
+const aliasPage = (entry, library) => {
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const category = entry.alias.cType === undefined ? undefined : primitiveCategory(entry.alias.cType);
+    const target = category === "gtype" ? PRIMITIVE_TS_TYPE.gtype : renderTsType(docsContext, entry.alias.target);
+    return joinSections([...pageHeader(entry, "alias"), `\`\`\`ts\ntype ${entry.name} = ${target}\n\`\`\``]);
+};
+const functionSignature = (context, name, fn, siblings) => {
+    const finishFn = matchStaticFinishFunction(context, fn, siblings);
+    if (finishFn !== undefined) {
+        const { signature, returnType } = renderPromisifiedSignature(context, fn, finishFn);
+        return `function ${name}(${signature}): ${returnType}`;
+    }
+    return `function ${name}(${renderMethodSignature(context, fn)}): ${renderMethodReturnType(context, fn)}`;
+};
+const functionPage = (entry, library) => {
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const signature = functionSignature(docsContext, entry.name, entry.fn, entry.namespace.functions);
+    return joinSections([...pageHeader(entry, "function"), `\`\`\`ts\n${signature}\n\`\`\``]);
+};
+const constantPage = (entry, library) => {
+    const docsContext = docsSignatureContext(entry.namespace, library);
+    const type = renderDocsType(library, entry.constant.type, false);
+    return joinSections([
+        ...pageHeader(entry, "constant"),
+        `\`\`\`ts\nconst ${entry.name}: ${type} = ${constantLiteral(docsContext, entry.constant)}\n\`\`\``,
+    ]);
+};
+//# sourceMappingURL=symbol-page.js.map

package/dist/docs/symbol-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-page.js","sourceRoot":"","sources":["../../src/docs/symbol-page.ts"],"names":[],"mappings":"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","sourcesContent":["import { sortStringsBy, toPascalCase } from \"@gtkx/utils\";\nimport { reservedSignalMemberRename } from \"../analysis/inheritance.js\";\nimport { renderTsType } from \"../analysis/ts-type.js\";\nimport { ancestorChain } from \"../gir/ancestry.js\";\nimport { callbackAsFunction, type GirCallback } from \"../gir/callback.js\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirEnum } from \"../gir/enum.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport { type GirAlias, type GirConstant, type GirNamespace, namespaceDirectory } from \"../gir/namespace.js\";\nimport { PRIMITIVE_TS_TYPE, primitiveCategory } from \"../gir/primitives.js\";\nimport type { GirProperty } from \"../gir/property.js\";\nimport type { GirRecord } from \"../gir/record.js\";\nimport {\n    dedupeCallables,\n    indexMethodsByName,\n    matchStaticFinishFunction,\n    renderInstanceMethodSignature,\n    renderStaticSignature,\n} from \"../store/gi/callables.js\";\nimport { constantLiteral } from \"../store/gi/constant.js\";\nimport { enumMemberKey } from \"../store/gi/enum.js\";\nimport {\n    methodExportName,\n    renderMethodReturnType,\n    renderMethodSignature,\n    renderPromisifiedSignature,\n} from \"../store/gi/method.js\";\nimport { type ResolvedAccessor, resolveAccessor } from \"../store/gi/property-accessor.js\";\nimport { resolveRecordFieldEntry } from \"../store/gi/record-field-accessor.js\";\nimport { computeRecordFieldSlots } from \"../store/gi/record-layout.js\";\nimport { implementedInterfaces, newlyImplementedInterfaces } from \"../store/react/intrinsic-elements.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\nimport {\n    classMethodEntries,\n    docMarkdown,\n    docsDefaultValue,\n    docsSignatureContext,\n    firstSentence,\n    joinSections,\n    metaBlock,\n    methodsSectionBlocks,\n    originSignatureBlocks,\n    renderDocsSignalHandlerType,\n    renderDocsType,\n    type SignatureEntry,\n    signatureBlock,\n} from \"./render.js\";\n\ntype GiSymbolBase = {\n    namespace: GirNamespace;\n    name: string;\n    doc: string | undefined;\n};\n\nexport type GiSymbolEntry =\n    | (GiSymbolBase & { kind: \"class\" | \"interface\"; klass: GirClass })\n    | (GiSymbolBase & { kind: \"record\"; record: GirRecord })\n    | (GiSymbolBase & { kind: \"enum\"; enumeration: GirEnum })\n    | (GiSymbolBase & { kind: \"callback\"; callback: GirCallback })\n    | (GiSymbolBase & { kind: \"alias\"; alias: GirAlias })\n    | (GiSymbolBase & { kind: \"function\"; fn: GirFunction })\n    | (GiSymbolBase & { kind: \"constant\"; constant: GirConstant });\n\nexport type SymbolPageOptions = {\n    library: Library;\n    elementNameFor: (namespaceName: string, className: string) => string | undefined;\n};\n\nconst qualifiedName = (entry: GiSymbolBase): string => `${entry.namespace.name}.${entry.name}`;\n\nconst frontmatter = (entry: GiSymbolBase, kindLabel: string): string => {\n    const sentence = firstSentence(entry.doc);\n    const description = sentence.length > 0 ? sentence : `API reference for the ${qualifiedName(entry)} ${kindLabel}.`;\n    return `---\\ndescription: ${JSON.stringify(description)}\\n---`;\n};\n\nconst kindLine = (kindLabel: string, namespace: GirNamespace): string =>\n    `\\`${kindLabel}\\` in \\`@gtkx/gi/${namespaceDirectory(namespace)}\\``;\n\nconst importBlock = (entry: GiSymbolBase): string =>\n    `\\`\\`\\`ts\\nimport * as ${entry.namespace.name} from \"@gtkx/gi/${namespaceDirectory(entry.namespace)}\";\\n\\`\\`\\``;\n\nconst pageHeader = (entry: GiSymbolEntry, kindLabel: string): string[] => [\n    frontmatter(entry, kindLabel),\n    `# ${qualifiedName(entry)}`,\n    kindLine(kindLabel, entry.namespace),\n    docMarkdown(entry.doc),\n    importBlock(entry),\n];\n\nconst qualifiedClassName = (namespaceName: string, className: string): string =>\n    `${namespaceName}.${toPascalCase(className)}`;\n\nconst elementNote = (entry: GiSymbolBase & { klass: GirClass }, options: SymbolPageOptions): string[] => {\n    const glibName = options.elementNameFor(entry.namespace.name, entry.klass.name);\n    if (glibName === undefined) return [];\n    return [\n        `Also available as the \\`${glibName}\\` JSX element from \\`@gtkx/jsx/${namespaceDirectory(entry.namespace)}\\`; the \\`${glibName}\\` element page documents the JSX props.`,\n    ];\n};\n\nconst hierarchySection = (entry: GiSymbolBase & { klass: GirClass }, library: Library): string[] => {\n    const ancestors = [...ancestorChain(library, entry.klass, entry.namespace.name)].slice(1).reverse();\n    const interfaces = implementedInterfaces(entry.klass, entry.namespace, library).map((iface) =>\n        qualifiedClassName(iface.namespace.name, iface.klass.name),\n    );\n    if (ancestors.length === 0 && interfaces.length === 0) return [];\n    const lines = [\"## Hierarchy\"];\n    if (ancestors.length > 0) {\n        const parts = ancestors.map(\n            (ancestor) => `\\`${qualifiedClassName(ancestor.namespaceName, ancestor.klass.name)}\\``,\n        );\n        parts.push(`**${qualifiedName(entry)}**`);\n        lines.push(parts.join(\" → \"));\n    }\n    if (interfaces.length > 0) {\n        lines.push(`Implements ${interfaces.map((name) => `\\`${name}\\``).join(\", \")}.`);\n    }\n    return lines;\n};\n\nconst prerequisitesLine = (entry: GiSymbolBase & { klass: GirClass }, library: Library): string[] => {\n    const names = entry.klass.prerequisites.map((name) => {\n        const resolved = library.resolveType(entry.namespace.name, name);\n        if (resolved === undefined || (resolved.kind !== \"class\" && resolved.kind !== \"interface\")) {\n            return `\\`${name}\\``;\n        }\n        return `\\`${qualifiedClassName(resolved.namespace.name, resolved.value.name)}\\``;\n    });\n    if (names.length === 0) return [];\n    return [`Requires ${names.join(\", \")}.`];\n};\n\ntype StaticSectionOptions = {\n    title: string;\n    intro: string;\n    context: ModuleContext;\n    callables: GirFunction[];\n    siblings: GirFunction[];\n    returnTypeOverride?: string;\n};\n\nconst staticSection = (options: StaticSectionOptions): string[] => {\n    const rendered: { name: string; block: string }[] = [];\n    for (const callable of dedupeCallables(options.callables)) {\n        const signature = renderStaticSignature(options.context, callable, {\n            returnTypeOverride: options.returnTypeOverride,\n            siblings: options.siblings,\n        });\n        if (signature === undefined) continue;\n        rendered.push({\n            name: signature.name,\n            block: signatureBlock(signature.name, signature.signature, [docMarkdown(callable.doc)]),\n        });\n    }\n    if (rendered.length === 0) return [];\n    return [options.title, options.intro, ...sortStringsBy(rendered, (item) => item.name).map((item) => item.block)];\n};\n\ntype MemberOwner = {\n    klass: GirClass;\n    namespace: GirNamespace;\n    origin: string | undefined;\n};\n\nconst memberOwners = (entry: GiSymbolBase & { klass: GirClass }, library: Library): MemberOwner[] => [\n    { klass: entry.klass, namespace: entry.namespace, origin: undefined },\n    ...newlyImplementedInterfaces(entry.klass, entry.namespace, library).map((iface) => ({\n        klass: iface.klass,\n        namespace: iface.namespace,\n        origin: qualifiedClassName(iface.namespace.name, iface.klass.name),\n    })),\n];\n\nconst interfaceMethodNames = (library: Library, owner: MemberOwner): string[] => {\n    const context = docsSignatureContext(owner.namespace, library);\n    const className = toPascalCase(owner.klass.name);\n    const methods = dedupeCallables(owner.klass.methods);\n    const methodByName = indexMethodsByName(methods);\n    const names: string[] = [];\n    for (const callable of methods) {\n        const rename = reservedSignalMemberRename(className, callable);\n        const rendered = renderInstanceMethodSignature(context, { ...callable, doc: undefined }, methodByName, rename);\n        if (rendered === undefined) continue;\n        names.push(rename ?? methodExportName(callable));\n    }\n    return names;\n};\n\ntype PropertyAccessorSetup = {\n    context: ModuleContext;\n    claimedNames: Set<string>;\n    methodByName: Map<string, GirFunction>;\n};\n\nconst propertyAccessorSetup = (\n    owner: MemberOwner,\n    library: Library,\n    useClassRenames: boolean,\n): PropertyAccessorSetup => {\n    const claimedNames = new Set(\n        useClassRenames\n            ? classMethodEntries(library, owner.namespace, owner.klass).map((item) => item.name)\n            : interfaceMethodNames(library, owner),\n    );\n    return {\n        context: docsSignatureContext(owner.namespace, library),\n        claimedNames,\n        methodByName: indexMethodsByName(dedupeCallables(owner.klass.methods)),\n    };\n};\n\nconst propertyMeta = (property: GirProperty, accessor: ResolvedAccessor, origin: string | undefined): string => {\n    const meta: string[] = [`\\`${accessor.tsType}\\``];\n    if (property.defaultValue !== undefined) meta.push(`default \\`${docsDefaultValue(property.defaultValue)}\\``);\n    if (property.constructOnly) meta.push(\"construct-only\");\n    if (!accessor.writable) meta.push(\"read-only\");\n    else if (!accessor.hasGetter) meta.push(\"write-only\");\n    if (origin !== undefined) meta.push(`from \\`${origin}\\``);\n    return meta.join(\" · \");\n};\n\nconst propertiesSection = (\n    entry: GiSymbolBase & { kind: \"class\" | \"interface\"; klass: GirClass },\n    library: Library,\n): string[] => {\n    const seen = new Set<string>();\n    const entries: { name: string; meta: string; doc: string }[] = [];\n    for (const [index, owner] of memberOwners(entry, library).entries()) {\n        const setup = propertyAccessorSetup(owner, library, index === 0 && entry.kind === \"class\");\n        for (const property of owner.klass.properties) {\n            const accessor = resolveAccessor({\n                context: setup.context,\n                property,\n                claimedNames: setup.claimedNames,\n                methodByName: setup.methodByName,\n            });\n            if (accessor === undefined || seen.has(accessor.jsName)) continue;\n            seen.add(accessor.jsName);\n            entries.push({\n                name: accessor.jsName,\n                meta: propertyMeta(property, accessor, owner.origin),\n                doc: docMarkdown(property.doc),\n            });\n        }\n    }\n    if (entries.length === 0) return [];\n    const intro = `Properties are read and written as instance fields; changes can be observed with \\`connect(\"notify::<property-name>\", handler)\\`. Properties inherited from ancestors are documented on their own pages.`;\n    const blocks = sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));\n    return [\"## Properties\", intro, ...blocks];\n};\n\nconst signalsSection = (entry: GiSymbolBase & { klass: GirClass }, library: Library): string[] => {\n    const seen = new Set<string>();\n    const entries: { name: string; signature: string; doc: string; origin: string | undefined }[] = [];\n    for (const owner of memberOwners(entry, library)) {\n        for (const signal of owner.klass.signals) {\n            if (seen.has(signal.name)) continue;\n            seen.add(signal.name);\n            entries.push({\n                name: signal.name,\n                signature: renderDocsSignalHandlerType(library, signal),\n                doc: docMarkdown(signal.doc),\n                origin: owner.origin,\n            });\n        }\n    }\n    if (entries.length === 0) return [];\n    const intro = `Connect with \\`instance.connect(\"<signal>\", handler)\\` or \\`instance.on(\"<signal>\", handler)\\`. Signals inherited from ancestors are documented on their own pages.`;\n    return [\"## Signals\", intro, ...originSignatureBlocks(entries)];\n};\n\nconst classMethodsSection = (entry: GiSymbolBase & { klass: GirClass }, library: Library): string[] =>\n    methodsSectionBlocks(\n        classMethodEntries(library, entry.namespace, entry.klass),\n        \"Methods are called on instances. Methods inherited from ancestors are documented on their own pages.\",\n    );\n\nconst classPage = (\n    entry: GiSymbolBase & { kind: \"class\" | \"interface\"; klass: GirClass },\n    options: SymbolPageOptions,\n): string => {\n    const { library } = options;\n    const qualified = qualifiedName(entry);\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const constructorsIntro = `Constructors are called on the class: \\`${qualified}.new(...)\\`.`;\n    const staticIntro = `Static methods are called on the class: \\`${qualified}.<method>(...)\\`.`;\n    const staticSiblings = [...entry.klass.constructors, ...entry.klass.functions];\n    return joinSections([\n        ...pageHeader(entry, entry.kind),\n        ...elementNote(entry, options),\n        ...(entry.kind === \"interface\" ? prerequisitesLine(entry, library) : hierarchySection(entry, library)),\n        ...staticSection({\n            title: \"## Constructors\",\n            intro: constructorsIntro,\n            context: docsContext,\n            callables: entry.klass.constructors,\n            siblings: staticSiblings,\n            returnTypeOverride: qualified,\n        }),\n        ...staticSection({\n            title: \"## Static methods\",\n            intro: staticIntro,\n            context: docsContext,\n            callables: entry.klass.functions,\n            siblings: staticSiblings,\n        }),\n        ...propertiesSection(entry, library),\n        ...signalsSection(entry, library),\n        ...classMethodsSection(entry, library),\n    ]);\n};\n\nexport const renderSymbolPage = (entry: GiSymbolEntry, options: SymbolPageOptions): string => {\n    switch (entry.kind) {\n        case \"class\":\n        case \"interface\":\n            return classPage(entry, options);\n        case \"record\":\n            return recordPage(entry, options.library);\n        case \"enum\":\n            return enumPage(entry);\n        case \"callback\":\n            return callbackPage(entry, options.library);\n        case \"alias\":\n            return aliasPage(entry, options.library);\n        case \"function\":\n            return functionPage(entry, options.library);\n        case \"constant\":\n            return constantPage(entry, options.library);\n    }\n};\n\nconst recordInstanceEntries = (context: ModuleContext, record: GirRecord): SignatureEntry[] => {\n    const entries: SignatureEntry[] = [];\n    for (const callable of dedupeCallables(record.methods)) {\n        const rendered = renderStaticSignature(context, callable);\n        if (rendered === undefined) continue;\n        entries.push({ name: rendered.name, signature: rendered.signature, doc: docMarkdown(callable.doc) });\n    }\n    return sortStringsBy(entries, (item) => item.name);\n};\n\nconst recordPage = (entry: GiSymbolBase & { kind: \"record\"; record: GirRecord }, library: Library): string => {\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const qualified = qualifiedName(entry);\n    const constructorsIntro = `Constructors are called on the class: \\`${qualified}.new(...)\\`.`;\n    const staticIntro = `Static methods are called on the class: \\`${qualified}.<method>(...)\\`.`;\n    const methodEntries = recordInstanceEntries(docsContext, entry.record);\n    const claimedNames = new Set(methodEntries.map((item) => item.name));\n    const staticSiblings = [...entry.record.constructors, ...entry.record.functions];\n    return joinSections([\n        ...pageHeader(entry, entry.record.isUnion ? \"union\" : \"record\"),\n        ...staticSection({\n            title: \"## Constructors\",\n            intro: constructorsIntro,\n            context: docsContext,\n            callables: entry.record.constructors,\n            siblings: staticSiblings,\n            returnTypeOverride: qualified,\n        }),\n        ...staticSection({\n            title: \"## Static methods\",\n            intro: staticIntro,\n            context: docsContext,\n            callables: entry.record.functions,\n            siblings: staticSiblings,\n        }),\n        ...fieldsSection(entry.record, docsContext, claimedNames),\n        ...methodsSectionBlocks(methodEntries, \"Methods are called on instances.\"),\n    ]);\n};\n\nconst fieldsSection = (record: GirRecord, context: ModuleContext, claimedNames: Set<string>): string[] => {\n    const { slots } = computeRecordFieldSlots(context, record.fields, record.isUnion);\n    const entries: { name: string; meta: string; doc: string }[] = [];\n    for (const slot of slots) {\n        const field = resolveRecordFieldEntry(context, slot, claimedNames);\n        if (field === undefined) continue;\n        entries.push({\n            name: field.jsName,\n            meta: [`\\`${field.tsType}\\``, ...(field.writable ? [] : [\"read-only\"])].join(\" · \"),\n            doc: docMarkdown(field.doc),\n        });\n    }\n    if (entries.length === 0) return [];\n    const blocks = sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));\n    return [\"## Fields\", ...blocks];\n};\n\nconst enumPage = (entry: GiSymbolBase & { kind: \"enum\"; enumeration: GirEnum }): string => {\n    const { enumeration } = entry;\n    const kindLabel = enumeration.errorDomain !== undefined ? \"error domain\" : enumeration.kind;\n    const qualified = qualifiedName(entry);\n    const rows = enumeration.members.map((member) => {\n        const description = firstSentence(member.doc).replaceAll(\"|\", \"\\\\|\");\n        return `| \\`${enumMemberKey(member.name)}\\` | \\`${member.value}\\` | ${description} |`;\n    });\n    const usage =\n        enumeration.errorDomain !== undefined\n            ? `Members are error codes for the \\`${enumeration.errorDomain}\\` GError domain, accessed as \\`${qualified}.<member>\\`.`\n            : `Members are accessed as \\`${qualified}.<member>\\`.`;\n    const table = [\"| Member | Value | Description |\", \"| --- | --- | --- |\", ...rows].join(\"\\n\");\n    return joinSections([...pageHeader(entry, kindLabel), \"## Members\", usage, table]);\n};\n\nconst callbackPage = (entry: GiSymbolBase & { kind: \"callback\"; callback: GirCallback }, library: Library): string => {\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const fn = callbackAsFunction(entry.callback);\n    const signature = `type ${entry.name} = (${renderMethodSignature(docsContext, fn)}) => ${renderMethodReturnType(docsContext, fn)}`;\n    return joinSections([...pageHeader(entry, \"callback\"), \"## Signature\", `\\`\\`\\`ts\\n${signature}\\n\\`\\`\\``]);\n};\n\nconst aliasPage = (entry: GiSymbolBase & { kind: \"alias\"; alias: GirAlias }, library: Library): string => {\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const category = entry.alias.cType === undefined ? undefined : primitiveCategory(entry.alias.cType);\n    const target = category === \"gtype\" ? PRIMITIVE_TS_TYPE.gtype : renderTsType(docsContext, entry.alias.target);\n    return joinSections([...pageHeader(entry, \"alias\"), `\\`\\`\\`ts\\ntype ${entry.name} = ${target}\\n\\`\\`\\``]);\n};\n\nconst functionSignature = (context: ModuleContext, name: string, fn: GirFunction, siblings: GirFunction[]): string => {\n    const finishFn = matchStaticFinishFunction(context, fn, siblings);\n    if (finishFn !== undefined) {\n        const { signature, returnType } = renderPromisifiedSignature(context, fn, finishFn);\n        return `function ${name}(${signature}): ${returnType}`;\n    }\n    return `function ${name}(${renderMethodSignature(context, fn)}): ${renderMethodReturnType(context, fn)}`;\n};\n\nconst functionPage = (entry: GiSymbolBase & { kind: \"function\"; fn: GirFunction }, library: Library): string => {\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const signature = functionSignature(docsContext, entry.name, entry.fn, entry.namespace.functions);\n    return joinSections([...pageHeader(entry, \"function\"), `\\`\\`\\`ts\\n${signature}\\n\\`\\`\\``]);\n};\n\nconst constantPage = (entry: GiSymbolBase & { kind: \"constant\"; constant: GirConstant }, library: Library): string => {\n    const docsContext = docsSignatureContext(entry.namespace, library);\n    const type = renderDocsType(library, entry.constant.type, false);\n    return joinSections([\n        ...pageHeader(entry, \"constant\"),\n        `\\`\\`\\`ts\\nconst ${entry.name}: ${type} = ${constantLiteral(docsContext, entry.constant)}\\n\\`\\`\\``,\n    ]);\n};\n"]}