@gtkx/codegen 0.21.0 → 1.0.0-rc.2

package/dist/docs/api-reference.d.ts

@@ -0,0 +1,67 @@
+import { type GiSymbolEntry } from "./symbol-page.js";
+type ApiReferenceOptions = {
+    libraries: string[];
+    girPath: string[];
+};
+type ApiSymbolKind = GiSymbolEntry["kind"] | "element";
+type ApiSymbol = {
+    namespace: string;
+    name: string;
+    kind: ApiSymbolKind;
+    summary: string;
+};
+type ApiNamespaceSummary = {
+    name: string;
+    importPath: string;
+    symbols: number;
+    elements: number;
+};
+type ApiLookupResult = {
+    outcome: "page";
+    symbol: ApiSymbol;
+    markdown: string;
+} | {
+    outcome: "ambiguous";
+    candidates: ApiSymbol[];
+} | {
+    outcome: "notFound";
+};
+type ApiSearchOptions = {
+    query: string;
+    namespace?: string;
+    kinds?: ApiSymbolKind[];
+    limit?: number;
+};
+declare const API_SYMBOL_KINDS: ApiSymbolKind[];
+declare const loadApiReference: (options: ApiReferenceOptions) => ApiReference;
+declare class ApiReference {
+    private library;
+    private libraries;
+    private elementContext;
+    private entries;
+    private byQualified;
+    private byName;
+    private byNamespace;
+    private elementsByClass;
+    constructor(options: ApiReferenceOptions);
+    private add;
+    private buildIndex;
+    private indexNamespace;
+    private indexFunctions;
+    private toApiSymbol;
+    private symbolPageOptions;
+    private renderPage;
+    private findNamespace;
+    private lookupCandidates;
+    private scoreEntries;
+    get girFiles(): string[];
+    lookup(query: string, kind?: ApiSymbolKind): ApiLookupResult;
+    search(options: ApiSearchOptions): ApiSymbol[];
+    namespaces(): ApiNamespaceSummary[];
+    symbolNames(namespaceName: string): string[];
+    overview(): string;
+    namespaceOverview(name: string): string | undefined;
+}
+export type { ApiReference };
+export { API_SYMBOL_KINDS, loadApiReference, type ApiReferenceOptions, type ApiSymbolKind, type ApiSymbol, type ApiNamespaceSummary, type ApiLookupResult, type ApiSearchOptions, };
+//# sourceMappingURL=api-reference.d.ts.map

package/dist/docs/api-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-reference.d.ts","sourceRoot":"","sources":["../../src/docs/api-reference.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,aAAa,EAA4C,MAAM,kBAAkB,CAAC;AAEhG,KAAK,mBAAmB,GAAG;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAEvD,KAAK,SAAS,GAAG;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,eAAe,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAE5B,KAAK,gBAAgB,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,QAAA,MAAM,gBAAgB,EAAE,aAAa,EAUpC,CAAC;AAwBF,QAAA,MAAM,gBAAgB,GAAI,SAAS,mBAAmB,KAAG,YAAyC,CAAC;AAoLnG,cAAM,YAAY;IACd,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,eAAe,CAAkC;gBAE7C,OAAO,EAAE,mBAAmB;IAOxC,OAAO,CAAC,GAAG;IAcX,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,YAAY;IAkBpB,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,eAAe;IAqB5D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE;IAe9C,UAAU,IAAI,mBAAmB,EAAE;IAWnC,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE;IAY5C,QAAQ,IAAI,MAAM;IA2BlB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAqCtD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACxB,CAAC"}

package/dist/docs/api-reference.js

@@ -0,0 +1,372 @@
+import { pascalCase, sortStrings, sortStringsBy } from "@gtkx/utils";
+import { Library } from "../gir/library.js";
+import { namespaceDirectory } from "../gir/namespace.js";
+import { dedupeCallables, isEmittableCallable } from "../store/gi/callables.js";
+import { isClassStructRecord } from "../store/gi/class-struct-record.js";
+import { namespaceFunctionExportName } from "../store/gi/function.js";
+import { collectIntrinsicElementClasses } from "../store/jsx/intrinsic-elements.js";
+import { createElementPageContext, renderElementPage } from "./element-page.js";
+import { docsSignatureContext, firstSentence, namespaceOrder } from "./render.js";
+import { renderSymbolPage } from "./symbol-page.js";
+const API_SYMBOL_KINDS = [
+    "element",
+    "class",
+    "interface",
+    "record",
+    "enum",
+    "callback",
+    "alias",
+    "function",
+    "constant",
+];
+const KIND_SECTION_TITLES = {
+    element: "JSX elements",
+    class: "Classes",
+    interface: "Interfaces",
+    record: "Records",
+    enum: "Enums",
+    callback: "Callbacks",
+    alias: "Aliases",
+    function: "Functions",
+    constant: "Constants",
+};
+const DEFAULT_SEARCH_LIMIT = 20;
+const compareNames = (a, b) => {
+    if (a < b) {
+        return -1;
+    }
+    return a > b ? 1 : 0;
+};
+const loadApiReference = (options) => new ApiReference(options);
+const functionEntry = (namespace, docsContext, fn) => {
+    if (!isEmittableCallable(docsContext, fn)) {
+        return undefined;
+    }
+    const cIdentifier = fn.cIdentifier;
+    if (cIdentifier === undefined) {
+        return undefined;
+    }
+    const name = namespaceFunctionExportName(cIdentifier, fn.name, namespace.cSymbolPrefixes);
+    return { kind: "function", namespace, name, doc: fn.doc, fn };
+};
+const classEntry = (namespace, klass) => {
+    if (!klass.introspectable || klass.name.length === 0) {
+        return undefined;
+    }
+    const kind = klass.isInterface ? "interface" : "class";
+    return { kind, namespace, name: pascalCase(klass.name), doc: klass.doc, klass };
+};
+const classEntries = (namespace) => {
+    const entries = [];
+    for (const klass of [...namespace.classes, ...namespace.interfaces]) {
+        const entry = classEntry(namespace, klass);
+        if (entry !== undefined) {
+            entries.push(entry);
+        }
+    }
+    return entries;
+};
+const recordEntry = (library, namespace, record) => {
+    if (!record.introspectable || record.isVtable || record.name.length === 0) {
+        return undefined;
+    }
+    if (isClassStructRecord(library, namespace.name, record)) {
+        return undefined;
+    }
+    return { kind: "record", namespace, name: record.name, doc: record.doc, record };
+};
+const recordEntries = (library, namespace) => {
+    const entries = [];
+    for (const record of namespace.records) {
+        const entry = recordEntry(library, namespace, record);
+        if (entry !== undefined) {
+            entries.push(entry);
+        }
+    }
+    return entries;
+};
+const valueEntries = (namespace) => [
+    ...namespace.enums
+        .filter((enumeration) => enumeration.introspectable)
+        .map((enumeration) => ({
+        kind: "enum",
+        namespace,
+        name: enumeration.name,
+        doc: enumeration.doc,
+        enumeration,
+    })),
+    ...namespace.callbacks
+        .filter((callback) => callback.introspectable)
+        .map((callback) => ({
+        kind: "callback",
+        namespace,
+        name: callback.name,
+        doc: callback.doc,
+        callback,
+    })),
+    ...namespace.aliases.map((alias) => ({
+        kind: "alias",
+        namespace,
+        name: alias.name,
+        doc: alias.doc,
+        alias,
+    })),
+    ...namespace.constants.map((constant) => ({
+        kind: "constant",
+        namespace,
+        name: constant.name,
+        doc: constant.doc,
+        constant,
+    })),
+];
+const narrowToExactMatches = (candidates, trimmed, isQualified) => {
+    if (candidates.length <= 1) {
+        return candidates;
+    }
+    const exact = candidates.filter((entry) => (isQualified ? `${entry.namespace.name}.${entry.name}` : entry.name) === trimmed);
+    return exact.length > 0 ? exact : candidates;
+};
+const isSearchFilterMatch = (entry, namespaceFilter, kinds) => {
+    if (namespaceFilter !== undefined && entry.namespace.name.toLowerCase() !== namespaceFilter) {
+        return false;
+    }
+    if (kinds !== undefined && !kinds.includes(entry.kind)) {
+        return false;
+    }
+    return true;
+};
+const getScoredEntry = (entry, query, namespaceFilter, kinds) => {
+    if (!isSearchFilterMatch(entry, namespaceFilter, kinds)) {
+        return undefined;
+    }
+    const score = searchScore(entry, query);
+    if (score === 0) {
+        return undefined;
+    }
+    return { score, entry };
+};
+const compareScoredEntries = (a, b) => b.score - a.score ||
+    a.entry.name.length - b.entry.name.length ||
+    compareNames(a.entry.name, b.entry.name) ||
+    compareNames(namespaceOrder(a.entry.namespace.name), namespaceOrder(b.entry.namespace.name)) ||
+    compareNames(a.entry.kind, b.entry.kind);
+const searchScore = (entry, query) => {
+    const name = entry.name.toLowerCase();
+    const qualified = `${entry.namespace.name.toLowerCase()}.${name}`;
+    if (name === query || qualified === query) {
+        return 3;
+    }
+    if (name.startsWith(query)) {
+        return 2;
+    }
+    if (name.includes(query) || qualified.includes(query)) {
+        return 1;
+    }
+    return 0;
+};
+class ApiReference {
+    library;
+    libraries;
+    elementContext;
+    entries = [];
+    byQualified = new Map();
+    byName = new Map();
+    byNamespace = new Map();
+    elementsByClass = new Map();
+    constructor(options) {
+        this.libraries = options.libraries;
+        this.library = Library.load(options.libraries, options.girPath);
+        this.elementContext = createElementPageContext(this.library, () => undefined);
+        this.buildIndex();
+    }
+    add(entry) {
+        this.entries.push(entry);
+        const push = (map, key) => {
+            const list = map.get(key) ?? [];
+            list.push(entry);
+            map.set(key, list);
+        };
+        push(this.byQualified, `${entry.namespace.name}.${entry.name}`.toLowerCase());
+        push(this.byName, entry.name.toLowerCase());
+        push(this.byNamespace, entry.namespace.name);
+    }
+    buildIndex() {
+        for (const namespace of this.library.namespaces.values()) {
+            this.indexNamespace(namespace);
+        }
+        for (const element of collectIntrinsicElementClasses(this.library)) {
+            this.add({
+                kind: "element",
+                namespace: element.namespace,
+                name: element.glibName,
+                doc: element.klass.doc,
+                element,
+            });
+            this.elementsByClass.set(`${element.namespace.name}.${element.klass.name}`, element.glibName);
+        }
+    }
+    indexNamespace(namespace) {
+        const entries = [
+            ...classEntries(namespace),
+            ...recordEntries(this.library, namespace),
+            ...valueEntries(namespace),
+        ];
+        for (const entry of entries) {
+            this.add(entry);
+        }
+        this.indexFunctions(namespace);
+    }
+    indexFunctions(namespace) {
+        if (namespace.sharedLibrary === undefined) {
+            return;
+        }
+        const docsContext = docsSignatureContext(namespace, this.library);
+        for (const fn of dedupeCallables(namespace.functions)) {
+            const entry = functionEntry(namespace, docsContext, fn);
+            if (entry !== undefined) {
+                this.add(entry);
+            }
+        }
+    }
+    toApiSymbol(entry) {
+        return {
+            namespace: entry.namespace.name,
+            name: entry.name,
+            kind: entry.kind,
+            summary: firstSentence(entry.doc),
+        };
+    }
+    symbolPageOptions() {
+        return {
+            library: this.library,
+            elementNameFor: (namespaceName, className) => this.elementsByClass.get(`${namespaceName}.${className}`),
+        };
+    }
+    renderPage(entry) {
+        if (entry.kind === "element") {
+            return renderElementPage(entry.element, this.elementContext);
+        }
+        return renderSymbolPage(entry, this.symbolPageOptions());
+    }
+    findNamespace(name) {
+        const lower = name.toLowerCase();
+        for (const namespace of this.library.namespaces.values()) {
+            if (namespace.name.toLowerCase() === lower) {
+                return namespace;
+            }
+        }
+        return undefined;
+    }
+    lookupCandidates(trimmed, kind) {
+        const isQualified = trimmed.includes(".");
+        const map = isQualified ? this.byQualified : this.byName;
+        let candidates = map.get(trimmed.toLowerCase()) ?? [];
+        if (kind !== undefined) {
+            candidates = candidates.filter((entry) => entry.kind === kind);
+        }
+        return narrowToExactMatches(candidates, trimmed, isQualified);
+    }
+    scoreEntries(query, namespaceFilter, kinds) {
+        const scored = [];
+        for (const entry of this.entries) {
+            const item = getScoredEntry(entry, query, namespaceFilter, kinds);
+            if (item !== undefined) {
+                scored.push(item);
+            }
+        }
+        return scored;
+    }
+    get girFiles() {
+        return this.library.girFiles;
+    }
+    lookup(query, kind) {
+        const trimmed = query.trim();
+        if (trimmed.length === 0) {
+            return { outcome: "notFound" };
+        }
+        const candidates = this.lookupCandidates(trimmed, kind);
+        const entry = candidates[0];
+        if (entry === undefined) {
+            return { outcome: "notFound" };
+        }
+        if (candidates.length > 1) {
+            return { outcome: "ambiguous", candidates: candidates.map((candidate) => this.toApiSymbol(candidate)) };
+        }
+        return { outcome: "page", symbol: this.toApiSymbol(entry), markdown: this.renderPage(entry) };
+    }
+    search(options) {
+        const query = options.query.trim().toLowerCase();
+        if (query.length === 0) {
+            return [];
+        }
+        const limit = Math.max(1, Math.floor(options.limit ?? DEFAULT_SEARCH_LIMIT));
+        const namespaceFilter = options.namespace?.toLowerCase();
+        const scored = this.scoreEntries(query, namespaceFilter, options.kinds);
+        scored.sort(compareScoredEntries);
+        return scored.slice(0, limit).map((item) => this.toApiSymbol(item.entry));
+    }
+    namespaces() {
+        const summaries = [...this.byNamespace].map(([name, entries]) => ({
+            name,
+            importPath: `@gtkx/gi/${namespaceDirectory({ name })}`,
+            symbols: entries.filter((entry) => entry.kind !== "element").length,
+            elements: entries.filter((entry) => entry.kind === "element").length,
+        }));
+        return sortStringsBy(summaries, (summary) => namespaceOrder(summary.name));
+    }
+    symbolNames(namespaceName) {
+        const namespace = this.findNamespace(namespaceName);
+        if (namespace === undefined) {
+            return [];
+        }
+        const entries = this.byNamespace.get(namespace.name) ?? [];
+        return sortStrings(entries.map((entry) => entry.name));
+    }
+    overview() {
+        const rows = this.namespaces().map((summary) => `| ${summary.name} | \`${summary.importPath}\` | ${String(summary.symbols)} | ` +
+            `${String(summary.elements)} |`);
+        const librariesList = this.libraries.map((library) => `\`${library}\``).join(", ");
+        return [
+            "# API Reference",
+            "",
+            `Generated bindings for ${librariesList} and the namespaces they pull in. Classes, interfaces, ` +
+                "records, enums, callbacks, aliases, functions, and constants are imported from " +
+                "`@gtkx/gi/<namespace>`; JSX elements are imported from `@gtkx/jsx/<namespace>`.",
+            "",
+            "Every symbol has a reference page addressed by its qualified name (for example `Gtk.Button`, " +
+                "`Gtk.Orientation`, `GLib.idleAdd`) and every JSX element by its element name " +
+                "(for example `GtkButton`).",
+            "",
+            "| Namespace | Import | Symbols | JSX elements |",
+            "| --- | --- | --- | --- |",
+            ...rows,
+            "",
+        ].join("\n");
+    }
+    namespaceOverview(name) {
+        const namespace = this.findNamespace(name);
+        if (namespace === undefined) {
+            return undefined;
+        }
+        const entries = this.byNamespace.get(namespace.name) ?? [];
+        const directory = namespaceDirectory(namespace);
+        const lines = [
+            `# ${namespace.name}`,
+            "",
+            `\`\`\`ts\nimport * as ${namespace.name} from "@gtkx/gi/${directory}";\n\`\`\``,
+        ];
+        for (const kind of API_SYMBOL_KINDS) {
+            const names = entries.filter((entry) => entry.kind === kind).map((entry) => entry.name);
+            if (names.length === 0) {
+                continue;
+            }
+            lines.push("", `## ${KIND_SECTION_TITLES[kind]} (${String(names.length)})`, "", sortStrings(names)
+                .map((symbolName) => `\`${symbolName}\``)
+                .join(", "));
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+}
+export { API_SYMBOL_KINDS, loadApiReference, };
+//# sourceMappingURL=api-reference.js.map

package/dist/docs/api-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-reference.js","sourceRoot":"","sources":["../../src/docs/api-reference.ts"],"names":[],"mappings":"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","sourcesContent":["import { pascalCase, sortStrings, sortStringsBy } from \"@gtkx/utils\";\nimport type { GirClass } from \"../gir/class.js\";\nimport type { GirFunction } from \"../gir/function.js\";\nimport type { GirRecord } from \"../gir/record.js\";\nimport { Library } from \"../gir/library.js\";\nimport { type GirNamespace, namespaceDirectory } from \"../gir/namespace.js\";\nimport { dedupeCallables, isEmittableCallable } from \"../store/gi/callables.js\";\nimport { isClassStructRecord } from \"../store/gi/class-struct-record.js\";\nimport { namespaceFunctionExportName } from \"../store/gi/function.js\";\nimport { collectIntrinsicElementClasses, type GlibNamedClass } from \"../store/jsx/intrinsic-elements.js\";\nimport { createElementPageContext, type ElementPageContext, renderElementPage } from \"./element-page.js\";\nimport { docsSignatureContext, firstSentence, namespaceOrder } from \"./render.js\";\nimport { type GiSymbolEntry, renderSymbolPage, type SymbolPageOptions } from \"./symbol-page.js\";\n\ntype ApiReferenceOptions = {\n    libraries: string[];\n    girPath: string[];\n};\n\ntype ApiSymbolKind = GiSymbolEntry[\"kind\"] | \"element\";\n\ntype ApiSymbol = {\n    namespace: string;\n    name: string;\n    kind: ApiSymbolKind;\n    summary: string;\n};\n\ntype ApiNamespaceSummary = {\n    name: string;\n    importPath: string;\n    symbols: number;\n    elements: number;\n};\n\ntype ApiLookupResult =\n    | { outcome: \"page\"; symbol: ApiSymbol; markdown: string } |\n    { outcome: \"ambiguous\"; candidates: ApiSymbol[] } |\n    { outcome: \"notFound\" };\n\ntype ApiSearchOptions = {\n    query: string;\n    namespace?: string;\n    kinds?: ApiSymbolKind[];\n    limit?: number;\n};\n\ntype ElementEntry = {\n    kind: \"element\";\n    namespace: GirNamespace;\n    name: string;\n    doc: string | undefined;\n    element: GlibNamedClass;\n};\n\ntype SymbolEntry = GiSymbolEntry | ElementEntry;\ntype ScoredEntry = { score: number; entry: SymbolEntry };\n\nconst API_SYMBOL_KINDS: ApiSymbolKind[] = [\n    \"element\",\n    \"class\",\n    \"interface\",\n    \"record\",\n    \"enum\",\n    \"callback\",\n    \"alias\",\n    \"function\",\n    \"constant\",\n];\n\nconst KIND_SECTION_TITLES: Record<ApiSymbolKind, string> = {\n    element: \"JSX elements\",\n    class: \"Classes\",\n    interface: \"Interfaces\",\n    record: \"Records\",\n    enum: \"Enums\",\n    callback: \"Callbacks\",\n    alias: \"Aliases\",\n    function: \"Functions\",\n    constant: \"Constants\",\n};\n\nconst DEFAULT_SEARCH_LIMIT = 20;\n\nconst compareNames = (a: string, b: string): number => {\n    if (a < b) {\n        return -1;\n    }\n\n    return a > b ? 1 : 0;\n};\n\nconst loadApiReference = (options: ApiReferenceOptions): ApiReference => new ApiReference(options);\n\nconst functionEntry = (\n    namespace: GirNamespace,\n    docsContext: ReturnType<typeof docsSignatureContext>,\n    fn: GirFunction,\n): GiSymbolEntry | undefined => {\n    if (!isEmittableCallable(docsContext, fn)) {\n        return undefined;\n    }\n\n    const cIdentifier = fn.cIdentifier;\n\n    if (cIdentifier === undefined) {\n        return undefined;\n    }\n\n    const name = namespaceFunctionExportName(cIdentifier, fn.name, namespace.cSymbolPrefixes);\n\n    return { kind: \"function\", namespace, name, doc: fn.doc, fn };\n};\n\nconst classEntry = (namespace: GirNamespace, klass: GirClass): GiSymbolEntry | undefined => {\n    if (!klass.introspectable || klass.name.length === 0) {\n        return undefined;\n    }\n\n    const kind = klass.isInterface ? \"interface\" : \"class\";\n\n    return { kind, namespace, name: pascalCase(klass.name), doc: klass.doc, klass };\n};\n\nconst classEntries = (namespace: GirNamespace): GiSymbolEntry[] => {\n    const entries: GiSymbolEntry[] = [];\n\n    for (const klass of [...namespace.classes, ...namespace.interfaces]) {\n        const entry = classEntry(namespace, klass);\n\n        if (entry !== undefined) {\n            entries.push(entry);\n        }\n    }\n\n    return entries;\n};\n\nconst recordEntry = (library: Library, namespace: GirNamespace, record: GirRecord): GiSymbolEntry | undefined => {\n    if (!record.introspectable || record.isVtable || record.name.length === 0) {\n        return undefined;\n    }\n\n    if (isClassStructRecord(library, namespace.name, record)) {\n        return undefined;\n    }\n\n    return { kind: \"record\", namespace, name: record.name, doc: record.doc, record };\n};\n\nconst recordEntries = (library: Library, namespace: GirNamespace): GiSymbolEntry[] => {\n    const entries: GiSymbolEntry[] = [];\n\n    for (const record of namespace.records) {\n        const entry = recordEntry(library, namespace, record);\n\n        if (entry !== undefined) {\n            entries.push(entry);\n        }\n    }\n\n    return entries;\n};\n\nconst valueEntries = (namespace: GirNamespace): GiSymbolEntry[] => [\n    ...namespace.enums\n        .filter((enumeration) => enumeration.introspectable)\n        .map<GiSymbolEntry>((enumeration) => ({\n            kind: \"enum\",\n            namespace,\n            name: enumeration.name,\n            doc: enumeration.doc,\n            enumeration,\n        })),\n    ...namespace.callbacks\n        .filter((callback) => callback.introspectable)\n        .map<GiSymbolEntry>((callback) => ({\n            kind: \"callback\",\n            namespace,\n            name: callback.name,\n            doc: callback.doc,\n            callback,\n        })),\n    ...namespace.aliases.map<GiSymbolEntry>((alias) => ({\n        kind: \"alias\",\n        namespace,\n        name: alias.name,\n        doc: alias.doc,\n        alias,\n    })),\n    ...namespace.constants.map<GiSymbolEntry>((constant) => ({\n        kind: \"constant\",\n        namespace,\n        name: constant.name,\n        doc: constant.doc,\n        constant,\n    })),\n];\n\nconst narrowToExactMatches = (candidates: SymbolEntry[], trimmed: string, isQualified: boolean): SymbolEntry[] => {\n    if (candidates.length <= 1) {\n        return candidates;\n    }\n\n    const exact = candidates.filter(\n        (entry) => (isQualified ? `${entry.namespace.name}.${entry.name}` : entry.name) === trimmed,\n    );\n\n    return exact.length > 0 ? exact : candidates;\n};\n\nconst isSearchFilterMatch = (\n    entry: SymbolEntry,\n    namespaceFilter: string | undefined,\n    kinds: ApiSymbolKind[] | undefined,\n): boolean => {\n    if (namespaceFilter !== undefined && entry.namespace.name.toLowerCase() !== namespaceFilter) {\n        return false;\n    }\n\n    if (kinds !== undefined && !kinds.includes(entry.kind)) {\n        return false;\n    }\n\n    return true;\n};\n\nconst getScoredEntry = (\n    entry: SymbolEntry,\n    query: string,\n    namespaceFilter: string | undefined,\n    kinds: ApiSymbolKind[] | undefined,\n): ScoredEntry | undefined => {\n    if (!isSearchFilterMatch(entry, namespaceFilter, kinds)) {\n        return undefined;\n    }\n\n    const score = searchScore(entry, query);\n\n    if (score === 0) {\n        return undefined;\n    }\n\n    return { score, entry };\n};\n\nconst compareScoredEntries = (a: ScoredEntry, b: ScoredEntry): number =>\n    b.score - a.score ||\n    a.entry.name.length - b.entry.name.length ||\n    compareNames(a.entry.name, b.entry.name) ||\n    compareNames(namespaceOrder(a.entry.namespace.name), namespaceOrder(b.entry.namespace.name)) ||\n    compareNames(a.entry.kind, b.entry.kind);\n\nconst searchScore = (entry: SymbolEntry, query: string): number => {\n    const name = entry.name.toLowerCase();\n    const qualified = `${entry.namespace.name.toLowerCase()}.${name}`;\n\n    if (name === query || qualified === query) {\n        return 3;\n    }\n\n    if (name.startsWith(query)) {\n        return 2;\n    }\n\n    if (name.includes(query) || qualified.includes(query)) {\n        return 1;\n    }\n\n    return 0;\n};\n\nclass ApiReference {\n    private library: Library;\n    private libraries: string[];\n    private elementContext: ElementPageContext;\n    private entries: SymbolEntry[] = [];\n    private byQualified: Map<string, SymbolEntry[]> = new Map();\n    private byName: Map<string, SymbolEntry[]> = new Map();\n    private byNamespace: Map<string, SymbolEntry[]> = new Map();\n    private elementsByClass: Map<string, string> = new Map();\n\n    constructor(options: ApiReferenceOptions) {\n        this.libraries = options.libraries;\n        this.library = Library.load(options.libraries, options.girPath);\n        this.elementContext = createElementPageContext(this.library, (): string | undefined => undefined);\n        this.buildIndex();\n    }\n\n    private add(entry: SymbolEntry): void {\n        this.entries.push(entry);\n\n        const push = (map: Map<string, SymbolEntry[]>, key: string): void => {\n            const list = map.get(key) ?? [];\n            list.push(entry);\n            map.set(key, list);\n        };\n\n        push(this.byQualified, `${entry.namespace.name}.${entry.name}`.toLowerCase());\n        push(this.byName, entry.name.toLowerCase());\n        push(this.byNamespace, entry.namespace.name);\n    }\n\n    private buildIndex(): void {\n        for (const namespace of this.library.namespaces.values()) {\n            this.indexNamespace(namespace);\n        }\n\n        for (const element of collectIntrinsicElementClasses(this.library)) {\n            this.add({\n                kind: \"element\",\n                namespace: element.namespace,\n                name: element.glibName,\n                doc: element.klass.doc,\n                element,\n            });\n\n            this.elementsByClass.set(`${element.namespace.name}.${element.klass.name}`, element.glibName);\n        }\n    }\n\n    private indexNamespace(namespace: GirNamespace): void {\n        const entries = [\n            ...classEntries(namespace),\n            ...recordEntries(this.library, namespace),\n            ...valueEntries(namespace),\n        ];\n\n        for (const entry of entries) {\n            this.add(entry);\n        }\n\n        this.indexFunctions(namespace);\n    }\n\n    private indexFunctions(namespace: GirNamespace): void {\n        if (namespace.sharedLibrary === undefined) {\n            return;\n        }\n\n        const docsContext = docsSignatureContext(namespace, this.library);\n\n        for (const fn of dedupeCallables(namespace.functions)) {\n            const entry = functionEntry(namespace, docsContext, fn);\n\n            if (entry !== undefined) {\n                this.add(entry);\n            }\n        }\n    }\n\n    private toApiSymbol(entry: SymbolEntry): ApiSymbol {\n        return {\n            namespace: entry.namespace.name,\n            name: entry.name,\n            kind: entry.kind,\n            summary: firstSentence(entry.doc),\n        };\n    }\n\n    private symbolPageOptions(): SymbolPageOptions {\n        return {\n            library: this.library,\n            elementNameFor: (namespaceName, className) => this.elementsByClass.get(`${namespaceName}.${className}`),\n        };\n    }\n\n    private renderPage(entry: SymbolEntry): string {\n        if (entry.kind === \"element\") {\n            return renderElementPage(entry.element, this.elementContext);\n        }\n\n        return renderSymbolPage(entry, this.symbolPageOptions());\n    }\n\n    private findNamespace(name: string): GirNamespace | undefined {\n        const lower = name.toLowerCase();\n\n        for (const namespace of this.library.namespaces.values()) {\n            if (namespace.name.toLowerCase() === lower) {\n                return namespace;\n            }\n        }\n\n        return undefined;\n    }\n\n    private lookupCandidates(trimmed: string, kind: ApiSymbolKind | undefined): SymbolEntry[] {\n        const isQualified = trimmed.includes(\".\");\n        const map = isQualified ? this.byQualified : this.byName;\n        let candidates = map.get(trimmed.toLowerCase()) ?? [];\n\n        if (kind !== undefined) {\n            candidates = candidates.filter((entry) => entry.kind === kind);\n        }\n\n        return narrowToExactMatches(candidates, trimmed, isQualified);\n    }\n\n    private scoreEntries(\n        query: string,\n        namespaceFilter: string | undefined,\n        kinds: ApiSymbolKind[] | undefined,\n    ): ScoredEntry[] {\n        const scored: ScoredEntry[] = [];\n\n        for (const entry of this.entries) {\n            const item = getScoredEntry(entry, query, namespaceFilter, kinds);\n\n            if (item !== undefined) {\n                scored.push(item);\n            }\n        }\n\n        return scored;\n    }\n\n    get girFiles(): string[] {\n        return this.library.girFiles;\n    }\n\n    lookup(query: string, kind?: ApiSymbolKind): ApiLookupResult {\n        const trimmed = query.trim();\n\n        if (trimmed.length === 0) {\n            return { outcome: \"notFound\" };\n        }\n\n        const candidates = this.lookupCandidates(trimmed, kind);\n        const entry = candidates[0];\n\n        if (entry === undefined) {\n            return { outcome: \"notFound\" };\n        }\n\n        if (candidates.length > 1) {\n            return { outcome: \"ambiguous\", candidates: candidates.map((candidate) => this.toApiSymbol(candidate)) };\n        }\n\n        return { outcome: \"page\", symbol: this.toApiSymbol(entry), markdown: this.renderPage(entry) };\n    }\n\n    search(options: ApiSearchOptions): ApiSymbol[] {\n        const query = options.query.trim().toLowerCase();\n\n        if (query.length === 0) {\n            return [];\n        }\n\n        const limit = Math.max(1, Math.floor(options.limit ?? DEFAULT_SEARCH_LIMIT));\n        const namespaceFilter = options.namespace?.toLowerCase();\n        const scored = this.scoreEntries(query, namespaceFilter, options.kinds);\n        scored.sort(compareScoredEntries);\n\n        return scored.slice(0, limit).map((item) => this.toApiSymbol(item.entry));\n    }\n\n    namespaces(): ApiNamespaceSummary[] {\n        const summaries = [...this.byNamespace].map(([name, entries]) => ({\n            name,\n            importPath: `@gtkx/gi/${namespaceDirectory({ name })}`,\n            symbols: entries.filter((entry) => entry.kind !== \"element\").length,\n            elements: entries.filter((entry) => entry.kind === \"element\").length,\n        }));\n\n        return sortStringsBy(summaries, (summary) => namespaceOrder(summary.name));\n    }\n\n    symbolNames(namespaceName: string): string[] {\n        const namespace = this.findNamespace(namespaceName);\n\n        if (namespace === undefined) {\n            return [];\n        }\n\n        const entries = this.byNamespace.get(namespace.name) ?? [];\n\n        return sortStrings(entries.map((entry) => entry.name));\n    }\n\n    overview(): string {\n        const rows = this.namespaces().map(\n            (summary) =>\n                `| ${summary.name} | \\`${summary.importPath}\\` | ${String(summary.symbols)} | ` +\n                `${String(summary.elements)} |`,\n        );\n\n        const librariesList = this.libraries.map((library) => `\\`${library}\\``).join(\", \");\n\n        return [\n            \"# API Reference\",\n            \"\",\n            `Generated bindings for ${librariesList} and the namespaces they pull in. Classes, interfaces, ` +\n            \"records, enums, callbacks, aliases, functions, and constants are imported from \" +\n            \"`@gtkx/gi/<namespace>`; JSX elements are imported from `@gtkx/jsx/<namespace>`.\",\n            \"\",\n            \"Every symbol has a reference page addressed by its qualified name (for example `Gtk.Button`, \" +\n            \"`Gtk.Orientation`, `GLib.idleAdd`) and every JSX element by its element name \" +\n            \"(for example `GtkButton`).\",\n            \"\",\n            \"| Namespace | Import | Symbols | JSX elements |\",\n            \"| --- | --- | --- | --- |\",\n            ...rows,\n            \"\",\n        ].join(\"\\n\");\n    }\n\n    namespaceOverview(name: string): string | undefined {\n        const namespace = this.findNamespace(name);\n\n        if (namespace === undefined) {\n            return undefined;\n        }\n\n        const entries = this.byNamespace.get(namespace.name) ?? [];\n        const directory = namespaceDirectory(namespace);\n\n        const lines = [\n            `# ${namespace.name}`,\n            \"\",\n            `\\`\\`\\`ts\\nimport * as ${namespace.name} from \"@gtkx/gi/${directory}\";\\n\\`\\`\\``,\n        ];\n\n        for (const kind of API_SYMBOL_KINDS) {\n            const names = entries.filter((entry) => entry.kind === kind).map((entry) => entry.name);\n\n            if (names.length === 0) {\n                continue;\n            }\n\n            lines.push(\n                \"\",\n                `## ${KIND_SECTION_TITLES[kind]} (${String(names.length)})`,\n                \"\",\n                sortStrings(names)\n                    .map((symbolName) => `\\`${symbolName}\\``)\n                    .join(\", \"),\n            );\n        }\n\n        lines.push(\"\");\n\n        return lines.join(\"\\n\");\n    }\n}\n\nexport type { ApiReference };\nexport {\n    API_SYMBOL_KINDS,\n    loadApiReference,\n    type ApiReferenceOptions,\n    type ApiSymbolKind,\n    type ApiSymbol,\n    type ApiNamespaceSummary,\n    type ApiLookupResult,\n    type ApiSearchOptions,\n};\n"]}

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

@@ -0,0 +1,12 @@
+import type { Library } from "../gir/library.js";
+import { type GirIndex } from "../store/jsx/gir-index.js";
+import { type GlibNamedClass } from "../store/jsx/intrinsic-elements.js";
+type ElementPageContext = {
+    library: Library;
+    girIndex: GirIndex;
+    linkFor: (glibName: string) => string | undefined;
+};
+declare const createElementPageContext: (library: Library, linkFor: (glibName: string) => string | undefined) => ElementPageContext;
+declare const renderElementPage: (entry: GlibNamedClass, context: ElementPageContext) => string;
+export { createElementPageContext, renderElementPage, type ElementPageContext };
+//# sourceMappingURL=element-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"element-page.d.ts","sourceRoot":"","sources":["../../src/docs/element-page.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAEH,KAAK,cAAc,EAItB,MAAM,oCAAoC,CAAC;AAgB5C,KAAK,kBAAkB,GAAG;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACrD,CAAC;AAsBF,QAAA,MAAM,wBAAwB,GAC1B,SAAS,OAAO,EAChB,SAAS,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,KAClD,kBAA8E,CAAC;AA8MlF,QAAA,MAAM,iBAAiB,GAAI,OAAO,cAAc,EAAE,SAAS,kBAAkB,KAAG,MAa/E,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,CAAC"}