@gtkx/codegen 0.21.0 → 1.0.0-rc.2

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 { pascalCase, sortStringsBy } from \"@gtkx/utils\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { Library } from \"../gir/library.js\";\nimport type { GirNamespace } from \"../gir/namespace.js\";\nimport type { GirCallable } from \"../gir/parameter.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport { collectInheritedMethods, conflictRename } from \"../analysis/inheritance.js\";\nimport { renderHandlerParameters, renderHandlerResultType } from \"../analysis/param-structure.js\";\nimport { recordTypeTarget, renderBaseType, type TsTypeTarget } from \"../analysis/ts-type.js\";\nimport { dedupeCallables, instanceScope, 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\ntype SignatureEntry = {\n    name: string;\n    signature: string;\n    doc: string;\n};\n\ntype OriginSignatureEntry = SignatureEntry & { origin: string | undefined };\n\nconst DOCS_DEFAULT_VALUES: Record<string, string> = { TRUE: \"true\", FALSE: \"false\", NULL: \"null\" };\nconst FENCE_LINE = /^\\s*(```|~~~)/;\nconst HEADING_LINE = /^#{1,5}\\s/;\nconst LEADING_NAMESPACES = [\"Gtk\", \"Adw\"];\nconst DOCS_SIGNATURE_NAMESPACE = \"$docs\";\n\nconst docsTarget = (library: Library): TsTypeTarget =>\n    recordTypeTarget(\n        library,\n        (name) => `${name.namespaceName}.${name.typeName}`,\n        () => \"GObject.Type\",\n    );\n\nconst renderDocsType = (library: Library, ref: TypeId | undefined, isNullable: boolean): string => {\n    const base = renderBaseType(library, docsTarget(library), ref);\n\n    return isNullable ? `${base} | null` : base;\n};\n\nconst renderDocsHandlerResultType = (library: Library, signal: GirCallable): 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: GirCallable): string[] =>\n    renderHandlerParameters(signal.parameters, (ref, nullable) => renderDocsType(library, ref, nullable));\n\nconst renderDocsSignalSignature = (library: Library, signal: GirCallable, selfType: string): string => {\n    const params = [...renderDocsHandlerParameters(library, signal), `self: ${selfType}`];\n\n    return `(${params.join(\", \")}) => ${renderDocsHandlerResultType(library, signal)}`;\n};\n\nconst renderDocsSignalHandlerType = (library: Library, signal: GirCallable): string =>\n    `(${renderDocsHandlerParameters(library, signal).join(\", \")}) => ${renderDocsHandlerResultType(library, signal)}`;\n\nconst docsDefaultValue = (value: string): string => DOCS_DEFAULT_VALUES[value] ?? value;\n\nconst stripDocMedia = (markdown: string): string =>\n    markdown\n        .replaceAll(/<picture[\\s\\S]*?<\\/picture>/g, \"\")\n        .replaceAll(/<video[\\s\\S]*?(?:<\\/video>|\\/>)/g, \"\")\n        .replaceAll(/<img[^>]*>/g, \"\");\n\nconst demoteLine = (line: string, isInFence: boolean): { text: string; inFence: boolean } => {\n    if (FENCE_LINE.test(line)) {\n        return { text: line, inFence: !isInFence };\n    }\n\n    if (isInFence) {\n        return { text: line, inFence: isInFence };\n    }\n\n    return { text: HEADING_LINE.test(line) ? `#${line}` : line, inFence: isInFence };\n};\n\nconst demoteHeadings = (markdown: string): string => {\n    let isInFence = false;\n    const lines: string[] = [];\n\n    for (const line of markdown.split(\"\\n\")) {\n        const result = demoteLine(line, isInFence);\n        isInFence = result.inFence;\n        lines.push(result.text);\n    }\n\n    return lines.join(\"\\n\");\n};\n\nconst 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        .replaceAll(/```[\\s\\S]*?```/g, \" \")\n        .replaceAll(/`([^`]*)`/g, \"$1\")\n        .replaceAll(/\\[([^[\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n        .replaceAll(/[*_#>]/g, \"\")\n        .replaceAll(/\\s+/g, \" \")\n        .trim();\n\nconst firstSentence = (doc: string | undefined): string => {\n    const text = stripMarkdown(docMarkdown(doc));\n\n    if (text.length === 0) {\n        return \"\";\n    }\n\n    const match = /^.*?[.!?](?=\\s|$)/.exec(text);\n    const sentence = match?.[0] ?? text;\n\n    return sentence.length > 220 ? `${sentence.slice(0, 217)}...` : sentence;\n};\n\nconst elementSlug = (className: string): string =>\n    className\n        .replaceAll(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n        .replaceAll(/([A-Z])(?=[A-Z][a-z])/g, \"$1-\")\n        .toLowerCase();\n\nconst implementsLine = (names: string[]): string[] => {\n    if (names.length === 0) {\n        return [];\n    }\n\n    const quotedNames = names.map((name) => `\\`${name}\\``).join(\", \");\n\n    return [`Implements ${quotedNames}.`];\n};\n\nconst joinSections = (sections: string[]): string =>\n    `${sections.filter((section) => section.length > 0).join(\"\\n\\n\")}\\n`;\n\nconst metaBlock = (name: string, meta: string, doc: string): string => {\n    const lines = [`### \\`${name}\\``, \"\", meta];\n\n    if (doc.length > 0) {\n        lines.push(\"\", doc);\n    }\n\n    return lines.join(\"\\n\");\n};\n\nconst signatureBlock = (name: string, signature: string, notes: string[]): string => {\n    const lines = [`### \\`${name}\\``, \"\", `\\`\\`\\`ts\\n${signature}\\n\\`\\`\\``];\n\n    for (const note of notes) {\n        if (note.length > 0) {\n            lines.push(\"\", note);\n        }\n    }\n\n    return lines.join(\"\\n\");\n};\n\nconst namespaceOrder = (name: string): string => {\n    const index = LEADING_NAMESPACES.indexOf(name);\n\n    return index === -1 ? `1${name}` : `0${String(index)}`;\n};\n\nconst docsSignatureContext = (namespace: GirNamespace, library: Library): ModuleContext =>\n    new ModuleContext({ ...namespace, name: DOCS_SIGNATURE_NAMESPACE }, library);\n\nconst 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\nconst classMethodEntries = (library: Library, namespace: GirNamespace, klass: GirClass): SignatureEntry[] => {\n    const realContext = new ModuleContext(namespace, library);\n    const signatureContext = docsSignatureContext(namespace, library);\n    const className = pascalCase(klass.name);\n    const inherited = collectInheritedMethods(realContext, klass);\n\n    return instanceMethodEntries(signatureContext, klass, (method) =>\n        conflictRename(realContext, method, inherited, className),\n    );\n};\n\nconst 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\nconst instanceMethodEntries = (\n    signatureContext: ModuleContext,\n    klass: GirClass,\n    rename: (fn: GirFunction) => string | undefined,\n): SignatureEntry[] => {\n    const deduped = dedupeCallables(klass.methods);\n\n    const scope = instanceScope(pascalCase(klass.name), {\n        constructors: dedupeCallables(klass.constructors),\n        functions: dedupeCallables(klass.functions),\n        methods: deduped,\n    });\n\n    const entries: SignatureEntry[] = [];\n\n    for (const method of deduped) {\n        const nameOverride = rename(method);\n\n        const rendered = renderInstanceMethodSignature(\n            signatureContext,\n            { ...method, doc: undefined },\n            scope,\n            nameOverride,\n        );\n\n        if (rendered === undefined) {\n            continue;\n        }\n\n        entries.push({\n            name: nameOverride ?? methodExportName(method),\n            signature: rendered.trim().replace(/;$/, \"\"),\n            doc: docMarkdown(method.doc),\n        });\n    }\n\n    return sortStringsBy(entries, (entry) => entry.name);\n};\n\nexport {\n    renderDocsType,\n    renderDocsSignalSignature,\n    renderDocsSignalHandlerType,\n    docsDefaultValue,\n    docMarkdown,\n    firstSentence,\n    elementSlug,\n    implementsLine,\n    joinSections,\n    metaBlock,\n    signatureBlock,\n    namespaceOrder,\n    docsSignatureContext,\n    originSignatureBlocks,\n    classMethodEntries,\n    methodsSectionBlocks,\n    instanceMethodEntries,\n    type SignatureEntry,\n    type OriginSignatureEntry,\n};\n"]}

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

@@ -0,0 +1,41 @@
+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 { GirRecord } from "../gir/record.js";
+import { type GirCallback } from "../gir/callback.js";
+import { type GirAlias, type GirConstant, type GirNamespace } from "../gir/namespace.js";
+type GiSymbolBase = {
+    namespace: GirNamespace;
+    name: string;
+    doc: string | undefined;
+};
+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;
+});
+type SymbolPageOptions = {
+    library: Library;
+    elementNameFor: (namespaceName: string, className: string) => string | undefined;
+};
+declare const renderSymbolPage: (entry: GiSymbolEntry, options: SymbolPageOptions) => string;
+export { renderSymbolPage, type GiSymbolEntry, type SymbolPageOptions };
+//# 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":"AACA,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;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAuC7G,KAAK,YAAY,GAAG;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,KAAK,aAAa,GACZ,CAAC,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,GACnE,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;AAEjE,KAAK,iBAAiB,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpF,CAAC;AAiWF,QAAA,MAAM,gBAAgB,GAAI,OAAO,aAAa,EAAE,SAAS,iBAAiB,KAAG,MAyB5E,CAAC;AA6IF,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/docs/symbol-page.js

@@ -0,0 +1,380 @@
+import { pascalCase, sortStringsBy } 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, instanceScope, 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/jsx/intrinsic-elements.js";
+import { classMethodEntries, docMarkdown, docsDefaultValue, docsSignatureContext, firstSentence, implementsLine, 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}.${pascalCase(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).toReversed();
+    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(" → "));
+    }
+    lines.push(...implementsLine(interfaces));
+    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 = pascalCase(owner.klass.name);
+    const methods = dedupeCallables(owner.klass.methods);
+    const scope = instanceScope(className, {
+        constructors: dedupeCallables(owner.klass.constructors),
+        functions: dedupeCallables(owner.klass.functions),
+        methods,
+    });
+    const names = [];
+    for (const callable of methods) {
+        const rename = reservedSignalMemberRename(className, callable);
+        const rendered = renderInstanceMethodSignature(context, { ...callable, doc: undefined }, scope, rename);
+        if (rendered === undefined) {
+            continue;
+        }
+        names.push(rename ?? methodExportName(callable));
+    }
+    return names;
+};
+const propertyAccessorSetup = (owner, library, isUseClassRenames) => {
+    const claimedNames = new Set(isUseClassRenames
+        ? 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 sortedMetaBlocks = (entries) => sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));
+const ownerPropertyEntries = (owner, setup, seen) => {
+    const entries = [];
+    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),
+        });
+    }
+    return entries;
+};
+const propertiesSection = (entry, library) => {
+    const seen = new Set();
+    const entries = [];
+    for (const [index, owner] of memberOwners(entry, library).entries()) {
+        const isUseClassRenames = index === 0 && entry.kind === "class";
+        const setup = propertyAccessorSetup(owner, library, isUseClassRenames);
+        entries.push(...ownerPropertyEntries(owner, setup, seen));
+    }
+    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.";
+    return ["## Properties", intro, ...sortedMetaBlocks(entries)];
+};
+const ownerSignalEntries = (owner, library, seen) => {
+    const entries = [];
+    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,
+        });
+    }
+    return entries;
+};
+const signalsSection = (entry, library) => {
+    const seen = new Set();
+    const entries = [];
+    for (const owner of memberOwners(entry, library)) {
+        entries.push(...ownerSignalEntries(owner, library, seen));
+    }
+    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),
+    ]);
+};
+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 fieldMeta = (field) => [`\`${field.tsType}\``, ...(field.writable ? [] : ["read-only"])].join(" · ");
+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: fieldMeta(field), doc: docMarkdown(field.doc) });
+    }
+    if (entries.length === 0) {
+        return [];
+    }
+    return ["## Fields", ...sortedMetaBlocks(entries)];
+};
+const enumPage = (entry) => {
+    const { enumeration } = entry;
+    const kindLabel = enumeration.errorDomain === undefined ? enumeration.kind : "error domain";
+    const qualified = qualifiedName(entry);
+    const rows = enumeration.members.map((member) => {
+        const description = firstSentence(member.doc).replaceAll("|", String.raw `\|`);
+        return `| \`${enumMemberKey(member.name)}\` | \`${member.value}\` | ${description} |`;
+    });
+    const usage = enumeration.errorDomain === undefined
+        ? `Members are accessed as \`${qualified}.<member>\`.`
+        : `Members are error codes for the \`${enumeration.errorDomain}\` GError domain, ` +
+            `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 parameters = renderMethodSignature(docsContext, fn);
+    const signature = `type ${entry.name} = (${parameters}) => ${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\`\`\``,
+    ]);
+};
+export { renderSymbolPage };
+//# 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 { pascalCase, sortStringsBy } from \"@gtkx/utils\";\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 { GirProperty } from \"../gir/property.js\";\nimport type { GirRecord } from \"../gir/record.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\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 GirAlias, type GirConstant, type GirNamespace, namespaceDirectory } from \"../gir/namespace.js\";\nimport { PRIMITIVE_TS_TYPE, primitiveCategory } from \"../gir/primitives.js\";\nimport {\n    dedupeCallables,\n    indexMethodsByName,\n    instanceScope,\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 { resolveAccessor, type ResolvedAccessor } 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/jsx/intrinsic-elements.js\";\nimport {\n    classMethodEntries,\n    docMarkdown,\n    docsDefaultValue,\n    docsSignatureContext,\n    firstSentence,\n    implementsLine,\n    joinSections,\n    metaBlock,\n    methodsSectionBlocks,\n    originSignatureBlocks,\n    renderDocsSignalHandlerType,\n    renderDocsType,\n    signatureBlock,\n    type SignatureEntry,\n} from \"./render.js\";\n\ntype GiSymbolBase = {\n    namespace: GirNamespace;\n    name: string;\n    doc: string | undefined;\n};\n\ntype 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\ntype SymbolPageOptions = {\n    library: Library;\n    elementNameFor: (namespaceName: string, className: string) => string | undefined;\n};\n\ntype StaticSectionOptions = {\n    title: string;\n    intro: string;\n    context: ModuleContext;\n    callables: GirFunction[];\n    siblings: GirFunction[];\n    returnTypeOverride?: string;\n};\n\ntype MemberOwner = {\n    klass: GirClass;\n    namespace: GirNamespace;\n    origin: string | undefined;\n};\n\ntype PropertyAccessorSetup = {\n    context: ModuleContext;\n    claimedNames: Set<string>;\n    methodByName: Map<string, GirFunction>;\n};\n\ntype MetaDocEntry = { name: string; meta: string; doc: string };\ntype SignalDocEntry = { name: string; signature: string; doc: string; origin: string | undefined };\ntype ResolvedRecordField = NonNullable<ReturnType<typeof resolveRecordFieldEntry>>;\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\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}.${pascalCase(className)}`;\n\nconst elementNote = (entry: GiSymbolBase & { klass: GirClass }, options: SymbolPageOptions): string[] => {\n    const glibName = options.elementNameFor(entry.namespace.name, entry.klass.name);\n\n    if (glibName === undefined) {\n        return [];\n    }\n\n    return [\n        `Also available as the \\`${glibName}\\` JSX element from ` +\n        `\\`@gtkx/jsx/${namespaceDirectory(entry.namespace)}\\`; the \\`${glibName}\\` element page ` +\n        \"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).toReversed();\n\n    const interfaces = implementedInterfaces(entry.klass, entry.namespace, library).map((iface) =>\n        qualifiedClassName(iface.namespace.name, iface.klass.name),\n    );\n\n    if (ancestors.length === 0 && interfaces.length === 0) {\n        return [];\n    }\n\n    const lines = [\"## Hierarchy\"];\n\n    if (ancestors.length > 0) {\n        const parts = ancestors.map(\n            (ancestor) => `\\`${qualifiedClassName(ancestor.namespaceName, ancestor.klass.name)}\\``,\n        );\n\n        parts.push(`**${qualifiedName(entry)}**`);\n        lines.push(parts.join(\" → \"));\n    }\n\n    lines.push(...implementsLine(interfaces));\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\n        if (resolved === undefined || (resolved.kind !== \"class\" && resolved.kind !== \"interface\")) {\n            return `\\`${name}\\``;\n        }\n\n        return `\\`${qualifiedClassName(resolved.namespace.name, resolved.value.name)}\\``;\n    });\n\n    if (names.length === 0) {\n        return [];\n    }\n\n    return [`Requires ${names.join(\", \")}.`];\n};\n\nconst staticSection = (options: StaticSectionOptions): string[] => {\n    const rendered: { name: string; block: string }[] = [];\n\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\n        if (signature === undefined) {\n            continue;\n        }\n\n        rendered.push({\n            name: signature.name,\n            block: signatureBlock(signature.name, signature.signature, [docMarkdown(callable.doc)]),\n        });\n    }\n\n    if (rendered.length === 0) {\n        return [];\n    }\n\n    return [options.title, options.intro, ...sortStringsBy(rendered, (item) => item.name).map((item) => item.block)];\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 = pascalCase(owner.klass.name);\n    const methods = dedupeCallables(owner.klass.methods);\n\n    const scope = instanceScope(className, {\n        constructors: dedupeCallables(owner.klass.constructors),\n        functions: dedupeCallables(owner.klass.functions),\n        methods,\n    });\n\n    const names: string[] = [];\n\n    for (const callable of methods) {\n        const rename = reservedSignalMemberRename(className, callable);\n        const rendered = renderInstanceMethodSignature(context, { ...callable, doc: undefined }, scope, rename);\n\n        if (rendered === undefined) {\n            continue;\n        }\n\n        names.push(rename ?? methodExportName(callable));\n    }\n\n    return names;\n};\n\nconst propertyAccessorSetup = (\n    owner: MemberOwner,\n    library: Library,\n    isUseClassRenames: boolean,\n): PropertyAccessorSetup => {\n    const claimedNames = new Set(\n        isUseClassRenames\n            ? classMethodEntries(library, owner.namespace, owner.klass).map((item) => item.name)\n            : interfaceMethodNames(library, owner),\n    );\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\n    if (property.defaultValue !== undefined) {\n        meta.push(`default \\`${docsDefaultValue(property.defaultValue)}\\``);\n    }\n\n    if (property.constructOnly) {\n        meta.push(\"construct-only\");\n    }\n\n    if (!accessor.writable) {\n        meta.push(\"read-only\");\n    } else if (!accessor.hasGetter) {\n        meta.push(\"write-only\");\n    }\n\n    if (origin !== undefined) {\n        meta.push(`from \\`${origin}\\``);\n    }\n\n    return meta.join(\" · \");\n};\n\nconst sortedMetaBlocks = (entries: MetaDocEntry[]): string[] =>\n    sortStringsBy(entries, (item) => item.name).map((item) => metaBlock(item.name, item.meta, item.doc));\n\nconst ownerPropertyEntries = (owner: MemberOwner, setup: PropertyAccessorSetup, seen: Set<string>): MetaDocEntry[] => {\n    const entries: MetaDocEntry[] = [];\n\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\n        if (accessor === undefined || seen.has(accessor.jsName)) {\n            continue;\n        }\n\n        seen.add(accessor.jsName);\n\n        entries.push({\n            name: accessor.jsName,\n            meta: propertyMeta(property, accessor, owner.origin),\n            doc: docMarkdown(property.doc),\n        });\n    }\n\n    return entries;\n};\n\nconst propertiesSection = (\n    entry: GiSymbolBase & { kind: \"class\" | \"interface\"; klass: GirClass },\n    library: Library,\n): string[] => {\n    const seen: Set<string> = new Set();\n    const entries: MetaDocEntry[] = [];\n\n    for (const [index, owner] of memberOwners(entry, library).entries()) {\n        const isUseClassRenames = index === 0 && entry.kind === \"class\";\n        const setup = propertyAccessorSetup(owner, library, isUseClassRenames);\n        entries.push(...ownerPropertyEntries(owner, setup, seen));\n    }\n\n    if (entries.length === 0) {\n        return [];\n    }\n\n    const intro =\n        \"Properties are read and written as instance fields; changes can be observed with \" +\n        \"`connect(\\\"notify::<property-name>\\\", handler)`. Properties inherited from ancestors are \" +\n        \"documented on their own pages.\";\n\n    return [\"## Properties\", intro, ...sortedMetaBlocks(entries)];\n};\n\nconst ownerSignalEntries = (owner: MemberOwner, library: Library, seen: Set<string>): SignalDocEntry[] => {\n    const entries: SignalDocEntry[] = [];\n\n    for (const signal of owner.klass.signals) {\n        if (seen.has(signal.name)) {\n            continue;\n        }\n\n        seen.add(signal.name);\n\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    return entries;\n};\n\nconst signalsSection = (entry: GiSymbolBase & { klass: GirClass }, library: Library): string[] => {\n    const seen: Set<string> = new Set();\n    const entries: SignalDocEntry[] = [];\n\n    for (const owner of memberOwners(entry, library)) {\n        entries.push(...ownerSignalEntries(owner, library, seen));\n    }\n\n    if (entries.length === 0) {\n        return [];\n    }\n\n    const intro =\n        \"Connect with `instance.connect(\\\"<signal>\\\", handler)` or `instance.on(\\\"<signal>\\\", handler)`. \" +\n        \"Signals inherited from ancestors are documented on their own pages.\";\n\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\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\nconst renderSymbolPage = (entry: GiSymbolEntry, options: SymbolPageOptions): string => {\n    switch (entry.kind) {\n        case \"class\":\n        case \"interface\": {\n            return classPage(entry, options);\n        }\n        case \"record\": {\n            return recordPage(entry, options.library);\n        }\n        case \"enum\": {\n            return enumPage(entry);\n        }\n        case \"callback\": {\n            return callbackPage(entry, options.library);\n        }\n        case \"alias\": {\n            return aliasPage(entry, options.library);\n        }\n        case \"function\": {\n            return functionPage(entry, options.library);\n        }\n        case \"constant\": {\n            return constantPage(entry, options.library);\n        }\n    }\n};\n\nconst recordInstanceEntries = (context: ModuleContext, record: GirRecord): SignatureEntry[] => {\n    const entries: SignatureEntry[] = [];\n\n    for (const callable of dedupeCallables(record.methods)) {\n        const rendered = renderStaticSignature(context, callable);\n\n        if (rendered === undefined) {\n            continue;\n        }\n\n        entries.push({ name: rendered.name, signature: rendered.signature, doc: docMarkdown(callable.doc) });\n    }\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\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 fieldMeta = (field: ResolvedRecordField): string =>\n    [`\\`${field.tsType}\\``, ...(field.writable ? [] : [\"read-only\"])].join(\" · \");\n\nconst fieldsSection = (record: GirRecord, context: ModuleContext, claimedNames: Set<string>): string[] => {\n    const { slots } = computeRecordFieldSlots(context, record.fields, record.isUnion);\n    const entries: MetaDocEntry[] = [];\n\n    for (const slot of slots) {\n        const field = resolveRecordFieldEntry(context, slot, claimedNames);\n\n        if (field === undefined) {\n            continue;\n        }\n\n        entries.push({ name: field.jsName, meta: fieldMeta(field), doc: docMarkdown(field.doc) });\n    }\n\n    if (entries.length === 0) {\n        return [];\n    }\n\n    return [\"## Fields\", ...sortedMetaBlocks(entries)];\n};\n\nconst enumPage = (entry: GiSymbolBase & { kind: \"enum\"; enumeration: GirEnum }): string => {\n    const { enumeration } = entry;\n    const kindLabel = enumeration.errorDomain === undefined ? enumeration.kind : \"error domain\";\n    const qualified = qualifiedName(entry);\n\n    const rows = enumeration.members.map((member) => {\n        const description = firstSentence(member.doc).replaceAll(\"|\", String.raw`\\|`);\n\n        return `| \\`${enumMemberKey(member.name)}\\` | \\`${member.value}\\` | ${description} |`;\n    });\n\n    const usage =\n        enumeration.errorDomain === undefined\n            ? `Members are accessed as \\`${qualified}.<member>\\`.`\n            : `Members are error codes for the \\`${enumeration.errorDomain}\\` GError domain, ` +\n                `accessed as \\`${qualified}.<member>\\`.`;\n\n    const table = [\"| Member | Value | Description |\", \"| --- | --- | --- |\", ...rows].join(\"\\n\");\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 parameters = renderMethodSignature(docsContext, fn);\n    const signature = `type ${entry.name} = (${parameters}) => ${renderMethodReturnType(docsContext, fn)}`;\n\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\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\n    if (finishFn !== undefined) {\n        const { signature, returnType } = renderPromisifiedSignature(context, fn, finishFn);\n\n        return `function ${name}(${signature}): ${returnType}`;\n    }\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\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\n    return joinSections([\n        ...pageHeader(entry, \"constant\"),\n        `\\`\\`\\`ts\\nconst ${entry.name}: ${type} = ${constantLiteral(docsContext, entry.constant)}\\n\\`\\`\\``,\n    ]);\n};\n\nexport { renderSymbolPage, type GiSymbolEntry, type SymbolPageOptions };\n"]}

package/dist/fingerprint.d.ts

@@ -1,30 +1,33 @@
-/** Filename of the staleness sentinel written into the `@gtkx/gi` store root. */
-export declare const FINGERPRINT_FILENAME = ".codegen-fingerprint.json";
-/**
- * The `@gtkx/codegen` package version, mixed into the store fingerprint so a
- * codegen upgrade invalidates a previously-generated store.
- */
-export declare const CODEGEN_VERSION: string;
-/**
- * The staleness sentinel written into the generated `@gtkx/gi` store: the
- * fingerprint value plus the inputs that produced it, so a consumer can
- * recompute and compare without reloading the GIR repository.
- */
-export type CodegenFingerprint = {
-    /** The fingerprint hash of {@link CODEGEN_VERSION}, libraries, and GIR contents. */
-    readonly value: string;
-    /** Absolute paths of every loaded `.gir` file, in load order. */
-    readonly girFiles: readonly string[];
-    /** The resolved `Name-Version` library identifiers the store was built for. */
-    readonly libraries: readonly string[];
+/** The freshness sentinel of the `@gtkx/gi` store, derived purely from the GIR inputs. */
+type GiFingerprint = {
+    value: string;
+    girFiles: string[];
+    libraries: string[];
+    girPath?: string[];
 };
-/**
- * Computes a content fingerprint over the codegen version, the resolved library
- * set, and the contents of every loaded GIR file. A change to any of these
- * means the generated bindings are stale and must be regenerated.
- *
- * @param girFiles - Absolute paths of the loaded `.gir` files
- * @param libraries - The resolved `Name-Version` library identifiers
- */
-export declare const computeFingerprint: (girFiles: readonly string[], libraries: readonly string[]) => string;
+type ModuleExport = {
+    module: string;
+    export: string;
+};
+/** The `@gtkx/react` element config that shapes the generated `@gtkx/jsx` store. */
+type JsxFingerprintInput = {
+    reactVersion: string;
+    components: Record<string, ModuleExport>;
+    lazyElements: string[];
+    props: Record<string, ModuleExport>;
+};
+/** The freshness sentinel of the `@gtkx/jsx` store, derived from the React element config. */
+type JsxFingerprint = {
+    value: string;
+    intrinsicElementCount: number;
+};
+declare const FINGERPRINT_FILENAME = ".codegen-fingerprint.json";
+declare const computeGiFingerprint: (girFiles: string[], libraries: string[], girPath: string[]) => GiFingerprint;
+declare const isGiStoreFresh: (giStoreDir: string, libraries: string[], girPath: string[]) => boolean;
+declare const computeJsxFingerprint: (input: JsxFingerprintInput, intrinsicElementCount: number) => JsxFingerprint;
+declare const jsxStoreFreshness: (jsxStoreDir: string, input: JsxFingerprintInput) => {
+    fresh: boolean;
+    intrinsicElementCount: number;
+};
+export { FINGERPRINT_FILENAME, computeGiFingerprint, isGiStoreFresh, computeJsxFingerprint, jsxStoreFreshness, type GiFingerprint, type JsxFingerprintInput, type JsxFingerprint, };
 //# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAoE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,WAAW,SAAS,MAAM,EAAE,KAAG,MAY9F,CAAC"}
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAOA,0FAA0F;AAC1F,KAAK,aAAa,GAAG;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,oFAAoF;AACpF,KAAK,mBAAmB,GAAG;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,8FAA8F;AAC9F,KAAK,cAAc,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;CACjC,CAAC;AAGF,QAAA,MAAM,oBAAoB,8BAA8B,CAAC;AAqCzD,QAAA,MAAM,oBAAoB,GAAI,UAAU,MAAM,EAAE,EAAE,WAAW,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,KAAG,aAKzF,CAAC;AAEH,QAAA,MAAM,cAAc,GAAI,YAAY,MAAM,EAAE,WAAW,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,KAAG,OAwBpF,CAAC;AAqBF,QAAA,MAAM,qBAAqB,GAAI,OAAO,mBAAmB,EAAE,uBAAuB,MAAM,KAAG,cAGzF,CAAC;AAEH,QAAA,MAAM,iBAAiB,GACnB,aAAa,MAAM,EACnB,OAAO,mBAAmB,KAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAA;CAkBjD,CAAC;AAEF,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACtB,CAAC"}