@gtkx/codegen 1.0.0 → 1.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"type-shape.js","sourceRoot":"","sources":["../../src/analysis/type-shape.ts"],"names":[],"mappings":"AAKA,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAuB,EAAE,CACvF,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEzD,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAA0B,EAAE;IACpF,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3C,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAiC,EAAE;IACtG,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3C,OAAO,IAAI,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAgB,EAAW,EAAE,CACnD,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;AAErG,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { PrimitiveCategory } from \"../gir/primitives.js\";\nimport type { CArrayType, TypeId } from \"../gir/type-id.js\";\nimport type { GirType } from \"../gir/type.js\";\n\nconst resolvedTypeFor = (library: Library, ref: TypeId | undefined): GirType | undefined =>\n    ref === undefined ? undefined : library.typeFor(ref);\n\nconst carrayFor = (library: Library, ref: TypeId | undefined): CArrayType | undefined => {\n    const type = resolvedTypeFor(library, ref);\n\n    return type?.kind === \"carray\" ? type : undefined;\n};\n\nconst primitiveCategoryFor = (library: Library, ref: TypeId | undefined): PrimitiveCategory | undefined => {\n    const type = resolvedTypeFor(library, ref);\n\n    return type?.kind === \"primitive\" ? type.category : undefined;\n};\n\nconst isUnboundedArray = (type: CArrayType): boolean =>\n    type.isZeroTerminated && type.lengthParameterIndex === undefined && type.fixedSize === undefined;\n\nexport { carrayFor, isUnboundedArray, primitiveCategoryFor };\n"]}
+{"version":3,"file":"type-shape.js","sourceRoot":"","sources":["../../src/analysis/type-shape.ts"],"names":[],"mappings":"AAKA,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAuB,EAAE,CACvF,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEzD,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAA0B,EAAE;IACpF,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3C,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAE,GAAuB,EAAiC,EAAE;IACtG,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3C,OAAO,IAAI,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAgB,EAAW,EAAE,CACnD,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;AAErG,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAE,IAA2B,EAAW,EAAE,CAC9E,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AAElH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["import type { Library } from \"../gir/library.js\";\nimport type { PrimitiveCategory } from \"../gir/primitives.js\";\nimport type { CArrayType, ListType, TypeId } from \"../gir/type-id.js\";\nimport type { GirType } from \"../gir/type.js\";\n\nconst resolvedTypeFor = (library: Library, ref: TypeId | undefined): GirType | undefined =>\n    ref === undefined ? undefined : library.typeFor(ref);\n\nconst carrayFor = (library: Library, ref: TypeId | undefined): CArrayType | undefined => {\n    const type = resolvedTypeFor(library, ref);\n\n    return type?.kind === \"carray\" ? type : undefined;\n};\n\nconst primitiveCategoryFor = (library: Library, ref: TypeId | undefined): PrimitiveCategory | undefined => {\n    const type = resolvedTypeFor(library, ref);\n\n    return type?.kind === \"primitive\" ? type.category : undefined;\n};\n\nconst isUnboundedArray = (type: CArrayType): boolean =>\n    type.isZeroTerminated && type.lengthParameterIndex === undefined && type.fixedSize === undefined;\n\nconst isByteSequence = (library: Library, type: CArrayType | ListType): boolean =>\n    type.kind === \"list\" ? type.flavor === \"gbytearray\" : primitiveCategoryFor(library, type.element) === \"uint8\";\n\nexport { carrayFor, isByteSequence, isUnboundedArray, primitiveCategoryFor };\n"]}

package/dist/compile.d.ts

@@ -1,18 +1,26 @@
-type SourceModule = {
+type ProjectFile = {
     fileName: string;
+    origin?: string | undefined;
+};
+type SourceModule = ProjectFile & {
     source: string;
 };
-type CompileProjectParams = {
+type EmitModulesParams = {
     projectDir: string;
-    fileNames: string[];
-    compilerOptions: Record<string, unknown>;
+    files: SourceModule[];
     label: string;
 };
-declare const compileProject: (params: CompileProjectParams) => void;
+type FailedProjectInput = {
+    projectDir: string;
+    keepAt: string;
+    error: unknown;
+};
+declare const keepFailedProject: (input: FailedProjectInput) => Error;
+declare const emitModules: (params: EmitModulesParams) => void;
 declare const checkModules: (params: {
     modules: SourceModule[];
     resolveFrom: string;
     label: string;
 }) => void;
-export { compileProject, checkModules, type SourceModule };
+export { checkModules, emitModules, keepFailedProject, type SourceModule };
 //# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,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;CACjB,CAAC;AA+HF,QAAA,MAAM,cAAc,GAAI,QAAQ,oBAAoB,KAAG,IAYtD,CAAC;AAEF,QAAA,MAAM,YAAY,GAAI,QAAQ;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,IAqB/F,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAOA,KAAK,WAAW,GAAG;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,KAAK,YAAY,GAAG,WAAW,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,KAAK,iBAAiB,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAOF,KAAK,kBAAkB,GAAG;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAiLF,QAAA,MAAM,iBAAiB,GAAI,OAAO,kBAAkB,KAAG,KActD,CAAC;AAoDF,QAAA,MAAM,WAAW,GAAI,QAAQ,iBAAiB,KAAG,IAUhD,CAAC;AAwBF,QAAA,MAAM,YAAY,GAAI,QAAQ;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,IAwB/F,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/compile.js

@@ -1,7 +1,9 @@
-import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { errorCode, errorMessage, normalizeError } from "@gtkx/utils";
+import { existsSync, mkdirSync, renameSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import ts from "typescript";
+import { createStagingDir, sweepStrandedDirs } from "./staging.js";
 const BASE_COMPILER_OPTIONS = {
     module: "esnext",
     moduleResolution: "bundler",
@@ -28,6 +30,23 @@ const CHECK_OPTIONS = {
     isolatedDeclarations: true,
     noEmit: true,
 };
+const DECLARATION_EMIT = {
+    declaration: true,
+    isolatedDeclarations: true,
+    removeComments: false,
+};
+const MODULE_EMIT = {
+    removeComments: false,
+};
+const DECLARATION_OPTIONS = ts.convertCompilerOptionsFromJson({ ...BASE_COMPILER_OPTIONS, ...DECLARATION_EMIT }, ".").options;
+const MODULE_OPTIONS = ts.convertCompilerOptionsFromJson({ ...BASE_COMPILER_OPTIONS, ...MODULE_EMIT }, ".").options;
+const TS_EXTENSION_PATTERN = /\.tsx?$/;
+const DECLARATION_EXTENSION = ".d.ts";
+const JAVASCRIPT_EXTENSION = ".js";
+const CHECK_DIR = ".gtkx-check";
+const FAILED_CHECK_DIR = `${CHECK_DIR}.failed`;
+const LEGACY_CHECK_PREFIX = `${CHECK_DIR}-`;
+const ESM_SCOPE_MANIFEST = `${JSON.stringify({ type: "module" }, null, 4)}\n`;
 const FORMAT_HOST = {
     getCanonicalFileName: (fileName) => fileName,
     getCurrentDirectory: () => ts.sys.getCurrentDirectory(),
@@ -47,41 +66,88 @@ const linkToolingModules = (projectDir) => {
         rmSync(link, { force: true });
     };
 };
+const ensureModuleScope = (projectDir) => {
+    try {
+        writeFileSync(join(projectDir, "package.json"), ESM_SCOPE_MANIFEST, { flag: "wx" });
+    }
+    catch (error) {
+        if (errorCode(error) !== "EEXIST") {
+            throw error;
+        }
+    }
+};
 const isProjectFile = (rel) => !rel.startsWith("..") && !isAbsolute(rel) && !rel.split(/[/\\]/).includes("node_modules");
-const projectDiagnosticLine = (diagnostic, projectDir) => {
+const projectDiagnosticFile = (diagnostic, projectDir) => {
     const { file, start } = diagnostic;
     if (file === undefined || start === undefined) {
         return undefined;
     }
-    const filePath = relative(projectDir, file.fileName);
-    if (!isProjectFile(filePath)) {
+    const fileName = relative(projectDir, file.fileName);
+    if (!isProjectFile(fileName)) {
         return undefined;
     }
     const { line, character } = file.getLineAndCharacterOfPosition(start);
     const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
-    return `${filePath}:${String(line + 1)}:${String(character + 1)} - ${message} (TS${String(diagnostic.code)})`;
+    return {
+        fileName,
+        text: `${fileName}:${String(line + 1)}:${String(character + 1)} - ${message} (TS${String(diagnostic.code)})`,
+    };
 };
-const projectDiagnosticLines = (diagnostics, projectDir) => {
-    const lines = [];
+const projectDiagnosticFiles = (diagnostics, projectDir) => {
+    const diagnosed = [];
     for (const diagnostic of diagnostics) {
-        const line = projectDiagnosticLine(diagnostic, projectDir);
-        if (line !== undefined) {
-            lines.push(line);
+        const entry = projectDiagnosticFile(diagnostic, projectDir);
+        if (entry !== undefined) {
+            diagnosed.push(entry);
+        }
+    }
+    return diagnosed;
+};
+const collectOrigins = (files) => {
+    const origins = new Map();
+    for (const { fileName, origin } of files) {
+        if (origin !== undefined) {
+            origins.set(fileName, origin);
+        }
+    }
+    return origins;
+};
+const groupByOrigin = (diagnosed, origins) => {
+    const grouped = new Map();
+    for (const { fileName } of diagnosed) {
+        const origin = origins.get(fileName);
+        if (origin !== undefined) {
+            grouped.set(origin, (grouped.get(origin) ?? new Set()).add(fileName));
         }
     }
-    return lines;
+    return grouped;
 };
-const diagnosticError = (label, projectDir, diagnostics) => {
-    const lines = projectDiagnosticLines(diagnostics, projectDir);
-    if (lines.length > 0) {
-        return new Error(`Type checking ${label} found ${String(lines.length)} error(s):\n${lines.join("\n")}`);
+const originLines = (diagnosed, files) => [...groupByOrigin(diagnosed, collectOrigins(files))].map(([origin, generated]) => `Generated from ${origin}: ${[...generated].join(", ")}`);
+const diagnosticError = (params, diagnostics) => {
+    const diagnosed = projectDiagnosticFiles(diagnostics, params.projectDir);
+    const { label } = params;
+    if (diagnosed.length === 0) {
+        return new Error(`Compiling ${label} failed:\n${ts.formatDiagnostics(diagnostics, FORMAT_HOST).trim()}`);
     }
-    return new Error(`Type checking ${label} failed:\n${ts.formatDiagnostics(diagnostics, FORMAT_HOST).trim()}`);
+    const lines = [...diagnosed.map((entry) => entry.text), ...originLines(diagnosed, params.files)];
+    return new Error(`Compiling ${label} found ${String(diagnosed.length)} error(s):\n${lines.join("\n")}`);
+};
+const keepFailedProject = (input) => {
+    const { projectDir, keepAt, error } = input;
+    if (!existsSync(projectDir)) {
+        return normalizeError(error);
+    }
+    rmSync(keepAt, { recursive: true, force: true });
+    renameSync(projectDir, keepAt);
+    const rebased = errorMessage(error).split(projectDir).join(keepAt);
+    return new Error(`${rebased}\nThe generated sources are kept at ${keepAt}, where every path above resolves.`, {
+        cause: error,
+    });
 };
 const runProgram = (params) => {
     const parsed = ts.parseJsonConfigFileContent({
         compilerOptions: { ...BASE_COMPILER_OPTIONS, ...params.compilerOptions },
-        files: params.fileNames.map((name) => `./${name}`),
+        files: params.files.map((file) => `./${file.fileName}`),
     }, ts.sys, params.projectDir);
     const program = ts.createProgram({
         rootNames: parsed.fileNames,
@@ -94,22 +160,55 @@ const runProgram = (params) => {
     }
     return [...program.emit().diagnostics];
 };
+const replaceExtension = (fileName, extension) => `${fileName.replace(TS_EXTENSION_PATTERN, "")}${extension}`;
+const transpileOptions = (compilerOptions, fileName) => ({
+    compilerOptions,
+    fileName,
+    reportDiagnostics: true,
+});
+const emitModule = (module, projectDir) => {
+    const fileName = join(projectDir, module.fileName);
+    const declaration = ts.transpileDeclaration(module.source, transpileOptions(DECLARATION_OPTIONS, fileName));
+    const javascript = ts.transpileModule(module.source, transpileOptions(MODULE_OPTIONS, fileName));
+    const diagnostics = [...declaration.diagnostics ?? [], ...javascript.diagnostics ?? []];
+    if (diagnostics.length > 0) {
+        return diagnostics;
+    }
+    writeFileSync(replaceExtension(fileName, DECLARATION_EXTENSION), declaration.outputText);
+    writeFileSync(replaceExtension(fileName, JAVASCRIPT_EXTENSION), javascript.outputText);
+    return [];
+};
+const emitModules = (params) => {
+    const diagnostics = [];
+    for (const module of params.files) {
+        diagnostics.push(...emitModule(module, params.projectDir));
+    }
+    if (diagnostics.length > 0) {
+        throw diagnosticError(params, diagnostics);
+    }
+};
 const compileProject = (params) => {
+    ensureModuleScope(params.projectDir);
     const unlinkToolingModules = linkToolingModules(params.projectDir);
     try {
         const diagnostics = runProgram(params);
         if (diagnostics.length > 0) {
-            throw diagnosticError(params.label, params.projectDir, diagnostics);
+            throw diagnosticError(params, diagnostics);
         }
     }
     finally {
         unlinkToolingModules();
     }
 };
+const stageCheckProject = (checkRoot) => {
+    const projectDir = createStagingDir(join(checkRoot, CHECK_DIR));
+    sweepStrandedDirs(checkRoot, LEGACY_CHECK_PREFIX);
+    return projectDir;
+};
 const checkModules = (params) => {
     const checkRoot = join(params.resolveFrom, "node_modules");
-    mkdirSync(checkRoot, { recursive: true });
-    const projectDir = mkdtempSync(join(checkRoot, ".gtkx-check-"));
+    const projectDir = stageCheckProject(checkRoot);
+    const keepAt = join(checkRoot, FAILED_CHECK_DIR);
     try {
         for (const module of params.modules) {
             const filePath = join(projectDir, module.fileName);
@@ -118,14 +217,16 @@ const checkModules = (params) => {
         }
         compileProject({
             projectDir,
-            fileNames: params.modules.map((module) => module.fileName),
+            files: params.modules,
             compilerOptions: CHECK_OPTIONS,
             label: params.label,
         });
     }
-    finally {
-        rmSync(projectDir, { recursive: true, force: true });
+    catch (error) {
+        throw keepFailedProject({ projectDir, keepAt, error });
     }
+    rmSync(projectDir, { recursive: true, force: true });
+    rmSync(keepAt, { recursive: true, force: true });
 };
-export { compileProject, checkModules };
+export { checkModules, emitModules, keepFailedProject };
 //# sourceMappingURL=compile.js.map

package/dist/compile.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport ts from \"typescript\";\n\ntype SourceModule = {\n    fileName: string;\n    source: string;\n};\n\ntype CompileProjectParams = {\n    projectDir: string;\n    fileNames: string[];\n    compilerOptions: Record<string, unknown>;\n    label: 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    allowImportingTsExtensions: true,\n    forceConsistentCasingInFileNames: true,\n    resolveJsonModule: true,\n    rewriteRelativeImportExtensions: true,\n    skipLibCheck: true,\n    types: [\"node\"],\n};\n\nconst CHECK_OPTIONS = {\n    declaration: true,\n    isolatedDeclarations: true,\n    noEmit: true,\n};\n\nconst FORMAT_HOST: ts.FormatDiagnosticsHost = {\n    getCanonicalFileName: (fileName) => fileName,\n    getCurrentDirectory: () => ts.sys.getCurrentDirectory(),\n    getNewLine: () => \"\\n\",\n};\n\nconst codegenModules = (): string => {\n    const sourceDir = dirname(fileURLToPath(import.meta.url));\n\n    return join(dirname(sourceDir), \"node_modules\");\n};\n\nconst linkToolingModules = (projectDir: string): (() => void) => {\n    const link = join(projectDir, \"node_modules\");\n\n    if (existsSync(link)) {\n        return (): void => undefined;\n    }\n\n    symlinkSync(codegenModules(), link, \"junction\");\n\n    return () => {\n        rmSync(link, { force: true });\n    };\n};\n\nconst isProjectFile = (rel: string): boolean =>\n    !rel.startsWith(\"..\") && !isAbsolute(rel) && !rel.split(/[/\\\\]/).includes(\"node_modules\");\n\nconst projectDiagnosticLine = (diagnostic: ts.Diagnostic, projectDir: string): string | undefined => {\n    const { file, start } = diagnostic;\n\n    if (file === undefined || start === undefined) {\n        return undefined;\n    }\n\n    const filePath = relative(projectDir, file.fileName);\n\n    if (!isProjectFile(filePath)) {\n        return undefined;\n    }\n\n    const { line, character } = file.getLineAndCharacterOfPosition(start);\n    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, \"\\n\");\n\n    return `${filePath}:${String(line + 1)}:${String(character + 1)} - ${message} (TS${String(diagnostic.code)})`;\n};\n\nconst projectDiagnosticLines = (diagnostics: ts.Diagnostic[], projectDir: string): string[] => {\n    const lines: string[] = [];\n\n    for (const diagnostic of diagnostics) {\n        const line = projectDiagnosticLine(diagnostic, projectDir);\n\n        if (line !== undefined) {\n            lines.push(line);\n        }\n    }\n\n    return lines;\n};\n\nconst diagnosticError = (label: string, projectDir: string, diagnostics: ts.Diagnostic[]): Error => {\n    const lines = projectDiagnosticLines(diagnostics, projectDir);\n\n    if (lines.length > 0) {\n        return new Error(`Type checking ${label} found ${String(lines.length)} error(s):\\n${lines.join(\"\\n\")}`);\n    }\n\n    return new Error(`Type checking ${label} failed:\\n${ts.formatDiagnostics(diagnostics, FORMAT_HOST).trim()}`);\n};\n\nconst runProgram = (params: CompileProjectParams): ts.Diagnostic[] => {\n    const parsed = ts.parseJsonConfigFileContent(\n        {\n            compilerOptions: { ...BASE_COMPILER_OPTIONS, ...params.compilerOptions },\n            files: params.fileNames.map((name) => `./${name}`),\n        },\n        ts.sys,\n        params.projectDir,\n    );\n\n    const program = ts.createProgram({\n        rootNames: parsed.fileNames,\n        options: parsed.options,\n        configFileParsingDiagnostics: parsed.errors,\n    });\n\n    const diagnostics = ts.getPreEmitDiagnostics(program);\n\n    if (diagnostics.length > 0) {\n        return [...diagnostics];\n    }\n\n    return [...program.emit().diagnostics];\n};\n\nconst compileProject = (params: CompileProjectParams): void => {\n    const unlinkToolingModules = linkToolingModules(params.projectDir);\n\n    try {\n        const diagnostics = runProgram(params);\n\n        if (diagnostics.length > 0) {\n            throw diagnosticError(params.label, params.projectDir, diagnostics);\n        }\n    } finally {\n        unlinkToolingModules();\n    }\n};\n\nconst 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\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\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\nexport { compileProject, checkModules, type SourceModule };\n"]}
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorCode, errorMessage, normalizeError } from \"@gtkx/utils\";\nimport { existsSync, mkdirSync, renameSync, rmSync, symlinkSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport ts from \"typescript\";\nimport { createStagingDir, sweepStrandedDirs } from \"./staging.js\";\n\ntype ProjectFile = {\n    fileName: string;\n    origin?: string | undefined;\n};\n\ntype SourceModule = ProjectFile & {\n    source: string;\n};\n\ntype ProjectContext = {\n    projectDir: string;\n    files: ProjectFile[];\n    label: string;\n};\n\ntype CompileProjectParams = ProjectContext & {\n    compilerOptions: Record<string, unknown>;\n};\n\ntype EmitModulesParams = {\n    projectDir: string;\n    files: SourceModule[];\n    label: string;\n};\n\ntype DiagnosedFile = {\n    fileName: string;\n    text: string;\n};\n\ntype FailedProjectInput = {\n    projectDir: string;\n    keepAt: string;\n    error: unknown;\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    allowImportingTsExtensions: true,\n    forceConsistentCasingInFileNames: true,\n    resolveJsonModule: true,\n    rewriteRelativeImportExtensions: true,\n    skipLibCheck: true,\n    types: [\"node\"],\n};\n\nconst CHECK_OPTIONS = {\n    declaration: true,\n    isolatedDeclarations: true,\n    noEmit: true,\n};\n\nconst DECLARATION_EMIT = {\n    declaration: true,\n    isolatedDeclarations: true,\n    removeComments: false,\n};\n\nconst MODULE_EMIT = {\n    removeComments: false,\n};\n\nconst DECLARATION_OPTIONS = ts.convertCompilerOptionsFromJson(\n    { ...BASE_COMPILER_OPTIONS, ...DECLARATION_EMIT },\n    \".\",\n).options;\n\nconst MODULE_OPTIONS = ts.convertCompilerOptionsFromJson(\n    { ...BASE_COMPILER_OPTIONS, ...MODULE_EMIT },\n    \".\",\n).options;\n\nconst TS_EXTENSION_PATTERN = /\\.tsx?$/;\nconst DECLARATION_EXTENSION = \".d.ts\";\nconst JAVASCRIPT_EXTENSION = \".js\";\nconst CHECK_DIR = \".gtkx-check\";\nconst FAILED_CHECK_DIR = `${CHECK_DIR}.failed`;\nconst LEGACY_CHECK_PREFIX = `${CHECK_DIR}-`;\nconst ESM_SCOPE_MANIFEST = `${JSON.stringify({ type: \"module\" }, null, 4)}\\n`;\n\nconst FORMAT_HOST: ts.FormatDiagnosticsHost = {\n    getCanonicalFileName: (fileName) => fileName,\n    getCurrentDirectory: () => ts.sys.getCurrentDirectory(),\n    getNewLine: () => \"\\n\",\n};\n\nconst codegenModules = (): string => {\n    const sourceDir = dirname(fileURLToPath(import.meta.url));\n\n    return join(dirname(sourceDir), \"node_modules\");\n};\n\nconst linkToolingModules = (projectDir: string): (() => void) => {\n    const link = join(projectDir, \"node_modules\");\n\n    if (existsSync(link)) {\n        return (): void => undefined;\n    }\n\n    symlinkSync(codegenModules(), link, \"junction\");\n\n    return () => {\n        rmSync(link, { force: true });\n    };\n};\n\nconst ensureModuleScope = (projectDir: string): void => {\n    try {\n        writeFileSync(join(projectDir, \"package.json\"), ESM_SCOPE_MANIFEST, { flag: \"wx\" });\n    } catch (error) {\n        if (errorCode(error) !== \"EEXIST\") {\n            throw error;\n        }\n    }\n};\n\nconst isProjectFile = (rel: string): boolean =>\n    !rel.startsWith(\"..\") && !isAbsolute(rel) && !rel.split(/[/\\\\]/).includes(\"node_modules\");\n\nconst projectDiagnosticFile = (diagnostic: ts.Diagnostic, projectDir: string): DiagnosedFile | undefined => {\n    const { file, start } = diagnostic;\n\n    if (file === undefined || start === undefined) {\n        return undefined;\n    }\n\n    const fileName = relative(projectDir, file.fileName);\n\n    if (!isProjectFile(fileName)) {\n        return undefined;\n    }\n\n    const { line, character } = file.getLineAndCharacterOfPosition(start);\n    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, \"\\n\");\n\n    return {\n        fileName,\n        text: `${fileName}:${String(line + 1)}:${String(character + 1)} - ${message} (TS${String(diagnostic.code)})`,\n    };\n};\n\nconst projectDiagnosticFiles = (diagnostics: ts.Diagnostic[], projectDir: string): DiagnosedFile[] => {\n    const diagnosed: DiagnosedFile[] = [];\n\n    for (const diagnostic of diagnostics) {\n        const entry = projectDiagnosticFile(diagnostic, projectDir);\n\n        if (entry !== undefined) {\n            diagnosed.push(entry);\n        }\n    }\n\n    return diagnosed;\n};\n\nconst collectOrigins = (files: ProjectFile[]): Map<string, string> => {\n    const origins: Map<string, string> = new Map();\n\n    for (const { fileName, origin } of files) {\n        if (origin !== undefined) {\n            origins.set(fileName, origin);\n        }\n    }\n\n    return origins;\n};\n\nconst groupByOrigin = (diagnosed: DiagnosedFile[], origins: Map<string, string>): Map<string, Set<string>> => {\n    const grouped: Map<string, Set<string>> = new Map();\n\n    for (const { fileName } of diagnosed) {\n        const origin = origins.get(fileName);\n\n        if (origin !== undefined) {\n            grouped.set(origin, (grouped.get(origin) ?? new Set<string>()).add(fileName));\n        }\n    }\n\n    return grouped;\n};\n\nconst originLines = (diagnosed: DiagnosedFile[], files: ProjectFile[]): string[] =>\n    [...groupByOrigin(diagnosed, collectOrigins(files))].map(\n        ([origin, generated]) => `Generated from ${origin}: ${[...generated].join(\", \")}`,\n    );\n\nconst diagnosticError = (params: ProjectContext, diagnostics: ts.Diagnostic[]): Error => {\n    const diagnosed = projectDiagnosticFiles(diagnostics, params.projectDir);\n    const { label } = params;\n\n    if (diagnosed.length === 0) {\n        return new Error(`Compiling ${label} failed:\\n${ts.formatDiagnostics(diagnostics, FORMAT_HOST).trim()}`);\n    }\n\n    const lines = [...diagnosed.map((entry) => entry.text), ...originLines(diagnosed, params.files)];\n\n    return new Error(`Compiling ${label} found ${String(diagnosed.length)} error(s):\\n${lines.join(\"\\n\")}`);\n};\n\nconst keepFailedProject = (input: FailedProjectInput): Error => {\n    const { projectDir, keepAt, error } = input;\n\n    if (!existsSync(projectDir)) {\n        return normalizeError(error);\n    }\n\n    rmSync(keepAt, { recursive: true, force: true });\n    renameSync(projectDir, keepAt);\n    const rebased = errorMessage(error).split(projectDir).join(keepAt);\n\n    return new Error(`${rebased}\\nThe generated sources are kept at ${keepAt}, where every path above resolves.`, {\n        cause: error,\n    });\n};\n\nconst runProgram = (params: CompileProjectParams): ts.Diagnostic[] => {\n    const parsed = ts.parseJsonConfigFileContent(\n        {\n            compilerOptions: { ...BASE_COMPILER_OPTIONS, ...params.compilerOptions },\n            files: params.files.map((file) => `./${file.fileName}`),\n        },\n        ts.sys,\n        params.projectDir,\n    );\n\n    const program = ts.createProgram({\n        rootNames: parsed.fileNames,\n        options: parsed.options,\n        configFileParsingDiagnostics: parsed.errors,\n    });\n\n    const diagnostics = ts.getPreEmitDiagnostics(program);\n\n    if (diagnostics.length > 0) {\n        return [...diagnostics];\n    }\n\n    return [...program.emit().diagnostics];\n};\n\nconst replaceExtension = (fileName: string, extension: string): string =>\n    `${fileName.replace(TS_EXTENSION_PATTERN, \"\")}${extension}`;\n\nconst transpileOptions = (compilerOptions: ts.CompilerOptions, fileName: string): ts.TranspileOptions => ({\n    compilerOptions,\n    fileName,\n    reportDiagnostics: true,\n});\n\nconst emitModule = (module: SourceModule, projectDir: string): ts.Diagnostic[] => {\n    const fileName = join(projectDir, module.fileName);\n    const declaration = ts.transpileDeclaration(module.source, transpileOptions(DECLARATION_OPTIONS, fileName));\n    const javascript = ts.transpileModule(module.source, transpileOptions(MODULE_OPTIONS, fileName));\n    const diagnostics = [...declaration.diagnostics ?? [], ...javascript.diagnostics ?? []];\n\n    if (diagnostics.length > 0) {\n        return diagnostics;\n    }\n\n    writeFileSync(replaceExtension(fileName, DECLARATION_EXTENSION), declaration.outputText);\n    writeFileSync(replaceExtension(fileName, JAVASCRIPT_EXTENSION), javascript.outputText);\n\n    return [];\n};\n\nconst emitModules = (params: EmitModulesParams): void => {\n    const diagnostics: ts.Diagnostic[] = [];\n\n    for (const module of params.files) {\n        diagnostics.push(...emitModule(module, params.projectDir));\n    }\n\n    if (diagnostics.length > 0) {\n        throw diagnosticError(params, diagnostics);\n    }\n};\n\nconst compileProject = (params: CompileProjectParams): void => {\n    ensureModuleScope(params.projectDir);\n    const unlinkToolingModules = linkToolingModules(params.projectDir);\n\n    try {\n        const diagnostics = runProgram(params);\n\n        if (diagnostics.length > 0) {\n            throw diagnosticError(params, diagnostics);\n        }\n    } finally {\n        unlinkToolingModules();\n    }\n};\n\nconst stageCheckProject = (checkRoot: string): string => {\n    const projectDir = createStagingDir(join(checkRoot, CHECK_DIR));\n    sweepStrandedDirs(checkRoot, LEGACY_CHECK_PREFIX);\n\n    return projectDir;\n};\n\nconst checkModules = (params: { modules: SourceModule[]; resolveFrom: string; label: string }): void => {\n    const checkRoot = join(params.resolveFrom, \"node_modules\");\n    const projectDir = stageCheckProject(checkRoot);\n    const keepAt = join(checkRoot, FAILED_CHECK_DIR);\n\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\n        compileProject({\n            projectDir,\n            files: params.modules,\n            compilerOptions: CHECK_OPTIONS,\n            label: params.label,\n        });\n    } catch (error) {\n        throw keepFailedProject({ projectDir, keepAt, error });\n    }\n\n    rmSync(projectDir, { recursive: true, force: true });\n    rmSync(keepAt, { recursive: true, force: true });\n};\n\nexport { checkModules, emitModules, keepFailedProject, type SourceModule };\n"]}

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

@@ -10,6 +10,8 @@ type ApiReferenceOptions = {
     props?: ElementProps;
     /** GObject properties the project omits from generated props; without it pages show props that do not exist. */
     omittedProps?: OmittedProps;
+    /** Describes GIR byte sequences as `Uint8Array` rather than `number[]`; defaults to false. */
+    isByteArrayTyped?: boolean;
 };
 /** Narrows an `ApiReference.symbols` enumeration. */
 type ApiSymbolQuery = {

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

@@ -1 +1 @@
-{"version":3,"file":"api-reference.d.ts","sourceRoot":"","sources":["../../src/docs/api-reference.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-reference.d.ts","sourceRoot":"","sources":["../../src/docs/api-reference.ts"],"names":[],"mappings":"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"}

package/dist/docs/api-reference.js

@@ -1,4 +1,5 @@
-import { pascalCase, sortStrings, sortStringsBy } from "@gtkx/utils";
+import { sanitizeIdentifier, sanitizeTypeIdentifier, sortStrings, sortStringsBy } from "@gtkx/utils";
+import { isEmittableEntity } from "../gir/emittable.js";
 import { Library } from "../gir/library.js";
 import { namespaceDirectory } from "../gir/namespace.js";
 import { dedupeCallables, isEmittableCallable } from "../store/gi/callables.js";
@@ -71,11 +72,11 @@ const functionEntry = (namespace, docsContext, fn) => {
     return { kind: "function", namespace, name, doc: fn.doc, fn };
 };
 const classEntry = (namespace, klass) => {
-    if (!klass.introspectable || klass.name.length === 0) {
+    if (!isEmittableEntity(klass)) {
         return undefined;
     }
     const kind = klass.isInterface ? "interface" : "class";
-    return { kind, namespace, name: pascalCase(klass.name), doc: klass.doc, klass };
+    return { kind, namespace, name: sanitizeTypeIdentifier(klass.name), doc: klass.doc, klass };
 };
 const classEntries = (namespace) => {
     const entries = [];
@@ -88,10 +89,10 @@ const classEntries = (namespace) => {
     return entries;
 };
 const recordEntry = (namespace, record) => {
-    if (!record.introspectable || record.isVtable || record.name.length === 0) {
+    if (record.isVtable || !isEmittableEntity(record)) {
         return undefined;
     }
-    return { kind: "record", namespace, name: record.name, doc: record.doc, record };
+    return { kind: "record", namespace, name: sanitizeTypeIdentifier(record.name), doc: record.doc, record };
 };
 const recordEntries = (namespace) => {
     const entries = [];
@@ -109,7 +110,7 @@ const valueEntries = (namespace) => [
         .map((enumeration) => ({
         kind: "enum",
         namespace,
-        name: enumeration.name,
+        name: sanitizeTypeIdentifier(enumeration.name),
         doc: enumeration.doc,
         enumeration,
     })),
@@ -118,21 +119,21 @@ const valueEntries = (namespace) => [
         .map((callback) => ({
         kind: "callback",
         namespace,
-        name: callback.name,
+        name: sanitizeTypeIdentifier(callback.name),
         doc: callback.doc,
         callback,
     })),
     ...namespace.aliases.map((alias) => ({
         kind: "alias",
         namespace,
-        name: alias.name,
+        name: sanitizeTypeIdentifier(alias.name),
         doc: alias.doc,
         alias,
     })),
     ...namespace.constants.map((constant) => ({
         kind: "constant",
         namespace,
-        name: constant.name,
+        name: sanitizeIdentifier(constant.name),
         doc: constant.doc,
         constant,
     })),
@@ -190,7 +191,7 @@ class ApiReference {
         this.libraries = options.libraries;
         this.props = options.props ?? {};
         this.omittedProps = options.omittedProps ?? {};
-        this.library = Library.load(options.libraries, options.girPath);
+        this.library = Library.load(options.libraries, options.girPath, options.isByteArrayTyped === true);
         this.elementContext = { library: this.library, linkFor: () => undefined };
         this.buildIndex();
     }