@gtkx/codegen 0.21.0 → 1.0.0-rc.1

package/dist/analysis/ts-type.js

@@ -0,0 +1,65 @@
+import { PRIMITIVE_TS_TYPE } from "../gir/primitives.js";
+import { isClassStructRecord } from "../store/gi/class-struct-record.js";
+import { gtypeTsType } from "../store/gi/gtype-binding.js";
+const willEmitEntity = (library, type) => {
+    switch (type.kind) {
+        case "callback":
+            return type.value.introspectable && type.value.name.length > 0;
+        case "record":
+            return (type.value.introspectable &&
+                !type.value.isVtable &&
+                type.value.name.length > 0 &&
+                !isClassStructRecord(library, type.namespace.name, type.value));
+        default:
+            return true;
+    }
+};
+export const renderBaseTypeFor = (library, target, ref) => {
+    if (ref === undefined)
+        return "void";
+    const type = library.typeOf(ref);
+    const name = library.nameOf(ref);
+    if (type === undefined)
+        return renderNamedType(target, undefined, name);
+    switch (type.kind) {
+        case "primitive":
+            return type.category === "gtype" ? target.renderGtype() : PRIMITIVE_TS_TYPE[type.category];
+        case "varargs":
+            return "unknown[]";
+        case "callback":
+        case "class":
+        case "interface":
+        case "record":
+        case "enum":
+        case "alias":
+            return renderNamedType(target, type, willEmitEntity(library, type) ? name : undefined);
+        case "carray":
+            return `${renderBaseTypeFor(library, target, type.element)}[]`;
+        case "list":
+            if (type.flavor === "gbytearray" && target.byteArrayAsNumber)
+                return "number[]";
+            return `${renderBaseTypeFor(library, target, type.element)}[]`;
+        case "hashtable": {
+            const key = renderBaseTypeFor(library, target, type.key);
+            const value = renderBaseTypeFor(library, target, type.value);
+            return target.containerStyle === "record" ? `Record<${key}, ${value}>` : `Map<${key}, ${value}>`;
+        }
+    }
+};
+const renderNamedType = (target, resolved, name) => {
+    if (name === undefined)
+        return resolved?.kind === "callback" ? target.callbackType : "unknown";
+    return target.renderNamed(resolved, name);
+};
+const moduleTarget = (context) => ({
+    containerStyle: "map",
+    callbackType: "((...args: any[]) => any)",
+    byteArrayAsNumber: true,
+    renderNamed: (_resolved, name) => context.qualify(name.namespaceName, name.typeName),
+    renderGtype: () => gtypeTsType(context),
+});
+export const renderTsType = (context, ref, isNullable = false) => {
+    const base = renderBaseTypeFor(context.library, moduleTarget(context), ref);
+    return isNullable ? `${base} | null` : base;
+};
+//# sourceMappingURL=ts-type.js.map

package/dist/analysis/ts-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-type.js","sourceRoot":"","sources":["../../src/analysis/ts-type.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport { PRIMITIVE_TS_TYPE } from \"../gir/primitives.js\";\nimport type { EntityType, GirType } from \"../gir/type.js\";\nimport type { TypeId } from \"../gir/type-id.js\";\nimport { isClassStructRecord } from \"../store/gi/class-struct-record.js\";\nimport { gtypeTsType } from \"../store/gi/gtype-binding.js\";\nimport type { ModuleContext } from \"../writer/context.js\";\n\ntype ReferenceName = {\n    namespaceName: string;\n    typeName: string;\n};\n\nexport type TsTypeTarget = {\n    containerStyle: \"map\" | \"record\";\n    callbackType: string;\n    byteArrayAsNumber: boolean;\n    renderNamed: (resolved: GirType | undefined, name: ReferenceName) => string;\n    renderGtype: () => string;\n};\n\nconst willEmitEntity = (library: Library, type: EntityType): boolean => {\n    switch (type.kind) {\n        case \"callback\":\n            return type.value.introspectable && type.value.name.length > 0;\n        case \"record\":\n            return (\n                type.value.introspectable &&\n                !type.value.isVtable &&\n                type.value.name.length > 0 &&\n                !isClassStructRecord(library, type.namespace.name, type.value)\n            );\n        default:\n            return true;\n    }\n};\n\nexport const renderBaseTypeFor = (library: Library, target: TsTypeTarget, ref: TypeId | undefined): string => {\n    if (ref === undefined) return \"void\";\n    const type = library.typeOf(ref);\n    const name = library.nameOf(ref);\n    if (type === undefined) return renderNamedType(target, undefined, name);\n    switch (type.kind) {\n        case \"primitive\":\n            return type.category === \"gtype\" ? target.renderGtype() : PRIMITIVE_TS_TYPE[type.category];\n        case \"varargs\":\n            return \"unknown[]\";\n        case \"callback\":\n        case \"class\":\n        case \"interface\":\n        case \"record\":\n        case \"enum\":\n        case \"alias\":\n            return renderNamedType(target, type, willEmitEntity(library, type) ? name : undefined);\n        case \"carray\":\n            return `${renderBaseTypeFor(library, target, type.element)}[]`;\n        case \"list\":\n            if (type.flavor === \"gbytearray\" && target.byteArrayAsNumber) return \"number[]\";\n            return `${renderBaseTypeFor(library, target, type.element)}[]`;\n        case \"hashtable\": {\n            const key = renderBaseTypeFor(library, target, type.key);\n            const value = renderBaseTypeFor(library, target, type.value);\n            return target.containerStyle === \"record\" ? `Record<${key}, ${value}>` : `Map<${key}, ${value}>`;\n        }\n    }\n};\n\nconst renderNamedType = (\n    target: TsTypeTarget,\n    resolved: GirType | undefined,\n    name: ReferenceName | undefined,\n): string => {\n    if (name === undefined) return resolved?.kind === \"callback\" ? target.callbackType : \"unknown\";\n    return target.renderNamed(resolved, name);\n};\n\nconst moduleTarget = (context: ModuleContext): TsTypeTarget => ({\n    containerStyle: \"map\",\n    callbackType: \"((...args: any[]) => any)\",\n    byteArrayAsNumber: true,\n    renderNamed: (_resolved, name) => context.qualify(name.namespaceName, name.typeName),\n    renderGtype: () => gtypeTsType(context),\n});\n\nexport const renderTsType = (context: ModuleContext, ref: TypeId | undefined, isNullable = false): string => {\n    const base = renderBaseTypeFor(context.library, moduleTarget(context), ref);\n    return isNullable ? `${base} | null` : base;\n};\n"]}

package/dist/compile.d.ts

@@ -0,0 +1,18 @@
+export type SourceModule = {
+    fileName: string;
+    source: string;
+};
+export type CompileProjectParams = {
+    projectDir: string;
+    fileNames: string[];
+    compilerOptions: Record<string, unknown>;
+    label: string;
+    paths?: Record<string, string[]>;
+};
+export declare const compileProject: (params: CompileProjectParams) => void;
+export declare const checkModules: (params: {
+    modules: SourceModule[];
+    resolveFrom: string;
+    label: string;
+}) => void;
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC,CAAC;AA+EF,eAAO,MAAM,cAAc,WAAY,oBAAoB,KAAG,IA2B7D,CAAC;AAQF,eAAO,MAAM,YAAY,WAAY;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,IAmBtG,CAAC"}

package/dist/compile.js

@@ -0,0 +1,123 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+const require = createRequire(import.meta.url);
+const BASE_COMPILER_OPTIONS = {
+    module: "esnext",
+    moduleResolution: "bundler",
+    target: "esnext",
+    lib: ["esnext"],
+    jsx: "react-jsx",
+    jsxImportSource: "react",
+    customConditions: ["source"],
+    strict: true,
+    exactOptionalPropertyTypes: true,
+    noUncheckedIndexedAccess: true,
+    noImplicitReturns: true,
+    noFallthroughCasesInSwitch: true,
+    allowUnreachableCode: false,
+    forceConsistentCasingInFileNames: true,
+    resolveJsonModule: true,
+    skipLibCheck: true,
+    types: ["node"],
+};
+const codegenModules = () => dirname(dirname(dirname(require.resolve("@types/node/package.json"))));
+const linkToolingModules = (projectDir) => {
+    const link = join(projectDir, "node_modules");
+    if (existsSync(link))
+        return () => { };
+    symlinkSync(codegenModules(), link, "junction");
+    return () => rmSync(link, { force: true });
+};
+const tscBin = () => join(dirname(require.resolve("typescript/package.json")), "bin", "tsc");
+const runTsc = (tsconfigPath, cwd) => {
+    try {
+        execFileSync(process.execPath, [tscBin(), "--pretty", "false", "-p", tsconfigPath], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        return { code: 0, output: "" };
+    }
+    catch (error) {
+        const { status, stdout = "", stderr = "", } = error;
+        return { code: typeof status === "number" ? status : 1, output: `${stdout}\n${stderr}` };
+    }
+};
+const DIAGNOSTIC_LINE = /^(.+?)\((\d+),(\d+)\): error TS(\d+): (.*)$/;
+const parseDiagnostics = (output, projectDir) => {
+    const diagnostics = [];
+    for (const raw of output.split(/\r?\n/)) {
+        const match = DIAGNOSTIC_LINE.exec(raw);
+        if (match === null)
+            continue;
+        const [, filePart, line, column, code, message] = match;
+        if (filePart === undefined || line === undefined || column === undefined || code === undefined)
+            continue;
+        const file = resolve(projectDir, filePart);
+        const rel = relative(projectDir, file);
+        if (rel.startsWith("..") || isAbsolute(rel) || rel.split(/[/\\]/).includes("node_modules"))
+            continue;
+        diagnostics.push({ file, line, column, code, message: (message ?? "").trim() });
+    }
+    return diagnostics;
+};
+const formatDiagnostics = (label, projectDir, diagnostics) => {
+    const messages = diagnostics.map((diagnostic) => `${relative(projectDir, diagnostic.file)}:${diagnostic.line}:${diagnostic.column} - ${diagnostic.message} (TS${diagnostic.code})`);
+    return `Type checking ${label} found ${diagnostics.length} error(s):\n${messages.join("\n")}`;
+};
+export const compileProject = (params) => {
+    const tsconfigPath = join(params.projectDir, "tsconfig.json");
+    const unlinkToolingModules = linkToolingModules(params.projectDir);
+    try {
+        writeFileSync(tsconfigPath, JSON.stringify({
+            compilerOptions: {
+                ...BASE_COMPILER_OPTIONS,
+                ...params.compilerOptions,
+                ...(params.paths === undefined ? {} : { paths: params.paths }),
+            },
+            files: params.fileNames.map((name) => `./${name}`),
+        }));
+        const { code, output } = runTsc(tsconfigPath, params.projectDir);
+        const diagnostics = parseDiagnostics(output, params.projectDir);
+        if (diagnostics.length > 0) {
+            throw new Error(formatDiagnostics(params.label, params.projectDir, diagnostics));
+        }
+        if (code !== 0) {
+            throw new Error(`Type checking ${params.label} failed:\n${output.trim()}`);
+        }
+    }
+    finally {
+        unlinkToolingModules();
+        rmSync(tsconfigPath, { force: true });
+    }
+};
+const CHECK_OPTIONS = {
+    declaration: true,
+    isolatedDeclarations: true,
+    noEmit: true,
+};
+export const checkModules = (params) => {
+    const checkRoot = join(params.resolveFrom, "node_modules");
+    mkdirSync(checkRoot, { recursive: true });
+    const projectDir = mkdtempSync(join(checkRoot, ".gtkx-check-"));
+    try {
+        for (const module of params.modules) {
+            const filePath = join(projectDir, module.fileName);
+            mkdirSync(dirname(filePath), { recursive: true });
+            writeFileSync(filePath, module.source);
+        }
+        compileProject({
+            projectDir,
+            fileNames: params.modules.map((module) => module.fileName),
+            compilerOptions: CHECK_OPTIONS,
+            label: params.label,
+        });
+    }
+    finally {
+        rmSync(projectDir, { recursive: true, force: true });
+    }
+};
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, isAbsolute, join, relative, resolve } from \"node:path\";\n\nconst require = createRequire(import.meta.url);\n\nexport type SourceModule = {\n    fileName: string;\n    source: string;\n};\n\nexport type CompileProjectParams = {\n    projectDir: string;\n    fileNames: string[];\n    compilerOptions: Record<string, unknown>;\n    label: string;\n    paths?: Record<string, string[]>;\n};\n\nconst BASE_COMPILER_OPTIONS = {\n    module: \"esnext\",\n    moduleResolution: \"bundler\",\n    target: \"esnext\",\n    lib: [\"esnext\"],\n    jsx: \"react-jsx\",\n    jsxImportSource: \"react\",\n    customConditions: [\"source\"],\n    strict: true,\n    exactOptionalPropertyTypes: true,\n    noUncheckedIndexedAccess: true,\n    noImplicitReturns: true,\n    noFallthroughCasesInSwitch: true,\n    allowUnreachableCode: false,\n    forceConsistentCasingInFileNames: true,\n    resolveJsonModule: true,\n    skipLibCheck: true,\n    types: [\"node\"],\n};\n\nconst codegenModules = (): string => dirname(dirname(dirname(require.resolve(\"@types/node/package.json\"))));\n\nconst linkToolingModules = (projectDir: string): (() => void) => {\n    const link = join(projectDir, \"node_modules\");\n    if (existsSync(link)) return () => {};\n    symlinkSync(codegenModules(), link, \"junction\");\n    return () => rmSync(link, { force: true });\n};\n\nconst tscBin = (): string => join(dirname(require.resolve(\"typescript/package.json\")), \"bin\", \"tsc\");\n\nconst runTsc = (tsconfigPath: string, cwd: string): { code: number; output: string } => {\n    try {\n        execFileSync(process.execPath, [tscBin(), \"--pretty\", \"false\", \"-p\", tsconfigPath], {\n            cwd,\n            encoding: \"utf8\",\n            stdio: [\"ignore\", \"pipe\", \"pipe\"],\n            maxBuffer: 64 * 1024 * 1024,\n        });\n        return { code: 0, output: \"\" };\n    } catch (error) {\n        const {\n            status,\n            stdout = \"\",\n            stderr = \"\",\n        } = error as { status?: number | null; stdout?: string; stderr?: string };\n        return { code: typeof status === \"number\" ? status : 1, output: `${stdout}\\n${stderr}` };\n    }\n};\n\nconst DIAGNOSTIC_LINE = /^(.+?)\\((\\d+),(\\d+)\\): error TS(\\d+): (.*)$/;\n\ntype ProjectDiagnostic = { file: string; line: string; column: string; code: string; message: string };\n\nconst parseDiagnostics = (output: string, projectDir: string): ProjectDiagnostic[] => {\n    const diagnostics: ProjectDiagnostic[] = [];\n    for (const raw of output.split(/\\r?\\n/)) {\n        const match = DIAGNOSTIC_LINE.exec(raw);\n        if (match === null) continue;\n        const [, filePart, line, column, code, message] = match;\n        if (filePart === undefined || line === undefined || column === undefined || code === undefined) continue;\n        const file = resolve(projectDir, filePart);\n        const rel = relative(projectDir, file);\n        if (rel.startsWith(\"..\") || isAbsolute(rel) || rel.split(/[/\\\\]/).includes(\"node_modules\")) continue;\n        diagnostics.push({ file, line, column, code, message: (message ?? \"\").trim() });\n    }\n    return diagnostics;\n};\n\nconst formatDiagnostics = (label: string, projectDir: string, diagnostics: ProjectDiagnostic[]): string => {\n    const messages = diagnostics.map(\n        (diagnostic) =>\n            `${relative(projectDir, diagnostic.file)}:${diagnostic.line}:${diagnostic.column} - ${diagnostic.message} (TS${diagnostic.code})`,\n    );\n    return `Type checking ${label} found ${diagnostics.length} error(s):\\n${messages.join(\"\\n\")}`;\n};\n\nexport const compileProject = (params: CompileProjectParams): void => {\n    const tsconfigPath = join(params.projectDir, \"tsconfig.json\");\n    const unlinkToolingModules = linkToolingModules(params.projectDir);\n    try {\n        writeFileSync(\n            tsconfigPath,\n            JSON.stringify({\n                compilerOptions: {\n                    ...BASE_COMPILER_OPTIONS,\n                    ...params.compilerOptions,\n                    ...(params.paths === undefined ? {} : { paths: params.paths }),\n                },\n                files: params.fileNames.map((name) => `./${name}`),\n            }),\n        );\n        const { code, output } = runTsc(tsconfigPath, params.projectDir);\n        const diagnostics = parseDiagnostics(output, params.projectDir);\n        if (diagnostics.length > 0) {\n            throw new Error(formatDiagnostics(params.label, params.projectDir, diagnostics));\n        }\n        if (code !== 0) {\n            throw new Error(`Type checking ${params.label} failed:\\n${output.trim()}`);\n        }\n    } finally {\n        unlinkToolingModules();\n        rmSync(tsconfigPath, { force: true });\n    }\n};\n\nconst CHECK_OPTIONS = {\n    declaration: true,\n    isolatedDeclarations: true,\n    noEmit: true,\n};\n\nexport const checkModules = (params: { modules: SourceModule[]; resolveFrom: string; label: string }): void => {\n    const checkRoot = join(params.resolveFrom, \"node_modules\");\n    mkdirSync(checkRoot, { recursive: true });\n    const projectDir = mkdtempSync(join(checkRoot, \".gtkx-check-\"));\n    try {\n        for (const module of params.modules) {\n            const filePath = join(projectDir, module.fileName);\n            mkdirSync(dirname(filePath), { recursive: true });\n            writeFileSync(filePath, module.source);\n        }\n        compileProject({\n            projectDir,\n            fileNames: params.modules.map((module) => module.fileName),\n            compilerOptions: CHECK_OPTIONS,\n            label: params.label,\n        });\n    } finally {\n        rmSync(projectDir, { recursive: true, force: true });\n    }\n};\n"]}

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

@@ -0,0 +1,66 @@
+import type { ElementProp } from "@gtkx/config";
+import { type GiSymbolEntry } from "./symbol-page.js";
+export type ApiReferenceOptions = {
+    libraries: string[];
+    girPath: string[];
+    elementProps?: Record<string, ElementProp[]>;
+};
+export type ApiSymbolKind = GiSymbolEntry["kind"] | "element";
+export declare const API_SYMBOL_KINDS: ApiSymbolKind[];
+export type ApiSymbol = {
+    namespace: string;
+    name: string;
+    kind: ApiSymbolKind;
+    summary: string;
+};
+export type ApiNamespaceSummary = {
+    name: string;
+    importPath: string;
+    symbols: number;
+    elements: number;
+};
+export type ApiLookupResult = {
+    outcome: "page";
+    symbol: ApiSymbol;
+    markdown: string;
+} | {
+    outcome: "ambiguous";
+    candidates: ApiSymbol[];
+} | {
+    outcome: "notFound";
+};
+export type ApiSearchOptions = {
+    query: string;
+    namespace?: string;
+    kinds?: ApiSymbolKind[];
+    limit?: number;
+};
+declare class ApiReference {
+    private library;
+    private libraries;
+    private elementContext;
+    private entries;
+    private byQualified;
+    private byName;
+    private byNamespace;
+    private elementsByClass;
+    constructor(options: ApiReferenceOptions);
+    get girFiles(): string[];
+    private add;
+    private buildIndex;
+    private indexNamespace;
+    private indexFunctions;
+    private toApiSymbol;
+    private symbolPageOptions;
+    private renderPage;
+    private findNamespace;
+    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 declare const loadApiReference: (options: ApiReferenceOptions) => ApiReference;
+//# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,OAAO,EAAE,KAAK,aAAa,EAA4C,MAAM,kBAAkB,CAAC;AAEhG,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAE9D,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAU3C,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG;IAC3B,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;AA4BF,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,CAAoC;IACvD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,eAAe,CAA6B;IAEpD,YAAY,OAAO,EAAE,mBAAmB,EAKvC;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,OAAO,CAAC,GAAG;IAYX,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,aAAa;IAQrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,eAAe,CAmB3D;IAED,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,CAsB7C;IAED,UAAU,IAAI,mBAAmB,EAAE,CAQlC;IAED,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3C;IAED,QAAQ,IAAI,MAAM,CAiBjB;IAED,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwBlD;CACJ;AAED,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,eAAO,MAAM,gBAAgB,YAAa,mBAAmB,KAAG,YAAyC,CAAC"}

package/dist/docs/api-reference.js

@@ -0,0 +1,299 @@
+import { sortStrings, sortStringsBy, toPascalCase } 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/react/intrinsic-elements.js";
+import { createElementPageContext, renderElementPage } from "./element-page.js";
+import { docsSignatureContext, firstSentence, namespaceOrder } from "./render.js";
+import { renderSymbolPage } from "./symbol-page.js";
+export 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) => (a < b ? -1 : a > b ? 1 : 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, options.elementProps ?? {}, () => undefined);
+        this.buildIndex();
+    }
+    get girFiles() {
+        return this.library.girFiles;
+    }
+    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)) {
+            if (!isEmittableCallable(docsContext, fn))
+                continue;
+            const cIdentifier = fn.cIdentifier;
+            if (cIdentifier === undefined)
+                continue;
+            const name = namespaceFunctionExportName(cIdentifier, fn.name, namespace.cSymbolPrefixes);
+            this.add({ kind: "function", namespace, name, doc: fn.doc, fn });
+        }
+    }
+    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;
+    }
+    lookup(query, kind) {
+        const trimmed = query.trim();
+        if (trimmed.length === 0)
+            return { outcome: "notFound" };
+        const qualified = trimmed.includes(".");
+        const map = qualified ? this.byQualified : this.byName;
+        let candidates = map.get(trimmed.toLowerCase()) ?? [];
+        if (kind !== undefined)
+            candidates = candidates.filter((entry) => entry.kind === kind);
+        if (candidates.length > 1) {
+            const exact = candidates.filter((entry) => qualified ? `${entry.namespace.name}.${entry.name}` === trimmed : entry.name === trimmed);
+            if (exact.length > 0)
+                candidates = exact;
+        }
+        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 = [];
+        for (const entry of this.entries) {
+            if (namespaceFilter !== undefined && entry.namespace.name.toLowerCase() !== namespaceFilter)
+                continue;
+            if (options.kinds !== undefined && !options.kinds.includes(entry.kind))
+                continue;
+            const score = searchScore(entry, query);
+            if (score === 0)
+                continue;
+            scored.push({ score, entry });
+        }
+        scored.sort((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));
+        return scored.slice(0, limit).map((item) => this.toApiSymbol(item.entry));
+    }
+    namespaces() {
+        const summaries = [...this.byNamespace.entries()].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}\` | ${summary.symbols} | ${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]} (${names.length})`, "", sortStrings(names)
+                .map((symbolName) => `\`${symbolName}\``)
+                .join(", "));
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+}
+export const loadApiReference = (options) => new ApiReference(options);
+const classEntries = (namespace) => {
+    const entries = [];
+    for (const klass of [...namespace.classes, ...namespace.interfaces]) {
+        if (!klass.introspectable || klass.name.length === 0)
+            continue;
+        const kind = klass.isInterface ? "interface" : "class";
+        entries.push({ kind, namespace, name: toPascalCase(klass.name), doc: klass.doc, klass });
+    }
+    return entries;
+};
+const recordEntries = (library, namespace) => {
+    const entries = [];
+    for (const record of namespace.records) {
+        if (!record.introspectable || record.isVtable || record.name.length === 0)
+            continue;
+        if (isClassStructRecord(library, namespace.name, record))
+            continue;
+        entries.push({ kind: "record", namespace, name: record.name, doc: record.doc, record });
+    }
+    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 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;
+};
+//# sourceMappingURL=api-reference.js.map