@gtkx/codegen 1.3.0 → 1.4.0

package/dist/store/resolve-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-store.js","sourceRoot":"","sources":["../../src/store/resolve-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, realpathSync } from \"node:fs\";\nimport { dirname, join, parse, relative, sep } from \"node:path\";\nimport type { StoreOptions } from \"./store-fs.js\";\nimport { sweepStagingDirs } from \"../staging.js\";\n\n/**\n * Where a project's generated stores live, ready to spread into `runCodegen`. `jsx` is null when the\n * project has no `@gtkx/react` installed, in which case only the `@gtkx/gi` store can be generated.\n */\ntype ResolvedStore = {\n    /** Where the `@gtkx/gi` store goes, versioned by the installed `@gtkx/runtime`. */\n    gi: StoreOptions;\n    /** Where the `@gtkx/jsx` store goes, versioned by the installed `@gtkx/react`; null when it is absent. */\n    jsx: StoreOptions | null;\n    /** Subexport names of the installed `@gtkx/react`, empty when it is absent. */\n    reactSubexports: string[];\n};\n\ntype ResolvedPackage = { dir: string; nodeModules: string; version: string };\ntype StoreConsumer = { name: string; nodeModules: string };\n\nconst STORE_DIR = \".gtkx\";\nconst SCOPE = \"@gtkx\";\nconst STORE_NAMES: string[] = [\"gi\", \"jsx\"];\n\nconst STORE_CONSUMERS: string[] = [\n    \"@gtkx/animated\",\n    \"@gtkx/cli\",\n    \"@gtkx/components\",\n    \"@gtkx/css\",\n    \"@gtkx/react\",\n    \"@gtkx/runtime\",\n    \"@gtkx/testing\",\n];\n\nconst readManifest = (path: string): { version?: string; exports?: Record<string, unknown> } =>\n    JSON.parse(readFileSync(path, \"utf8\")) as { version?: string; exports?: Record<string, unknown> };\n\nconst subexportNames = (packageDir: string): string[] =>\n    Object.keys(readManifest(join(packageDir, \"package.json\")).exports ?? {})\n        .filter((key) => key.startsWith(\"./\") && key !== \"./package.json\")\n        .map((key) => key.slice(2));\n\nconst loadPackage = (manifest: string, nodeModules: string): ResolvedPackage | null => {\n    if (!existsSync(manifest)) {\n        return null;\n    }\n\n    const real = realpathSync(manifest);\n\n    return { dir: dirname(real), nodeModules, version: readManifest(real).version ?? \"0.0.0\" };\n};\n\nconst nodeModulesChain = function* (projectRoot: string): Generator<string> {\n    const { root } = parse(projectRoot);\n    let current = projectRoot;\n\n    while (current !== root) {\n        yield join(current, \"node_modules\");\n        current = dirname(current);\n    }\n\n    yield join(root, \"node_modules\");\n};\n\nconst resolvePackage = (projectRoot: string, packageName: string): ResolvedPackage | null => {\n    for (const nodeModules of nodeModulesChain(projectRoot)) {\n        const found = loadPackage(join(nodeModules, packageName, \"package.json\"), nodeModules);\n\n        if (found !== null) {\n            return found;\n        }\n    }\n\n    const unscoped = packageName.replace(/^@[^/]+\\//, \"\");\n\n    return loadPackage(join(projectRoot, \"packages\", unscoped, \"package.json\"), join(projectRoot, \"node_modules\"));\n};\n\nconst isWithin = (parent: string, child: string): boolean => {\n    const path = relative(parent, child);\n\n    return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`));\n};\n\nconst canImport = (fromNodeModules: string, targetNodeModules: string): boolean =>\n    isWithin(dirname(targetNodeModules), dirname(fromNodeModules));\n\nconst storeOptions = (nodeModules: string, name: string, version: string): StoreOptions => ({\n    storeDir: join(nodeModules, STORE_DIR, name),\n    linkDir: join(nodeModules, SCOPE, name),\n    version,\n});\n\nconst resolveRuntime = (projectRoot: string): ResolvedPackage => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        throw new Error(`Cannot resolve @gtkx/runtime from ${projectRoot}; is it installed?`);\n    }\n\n    return runtime;\n};\n\nconst storeNodeModules = (runtime: ResolvedPackage, react: ResolvedPackage | null): string => {\n    if (react !== null && canImport(react.nodeModules, runtime.nodeModules)) {\n        return react.nodeModules;\n    }\n\n    return runtime.nodeModules;\n};\n\nconst findUnreachableConsumer = (projectRoot: string, nodeModules: string): StoreConsumer | null => {\n    for (const name of STORE_CONSUMERS) {\n        const consumer = resolvePackage(projectRoot, name);\n\n        if (consumer !== null && !canImport(consumer.nodeModules, nodeModules)) {\n            return { name, nodeModules: consumer.nodeModules };\n        }\n    }\n\n    return null;\n};\n\nconst unreachableConsumerMessage = (consumer: StoreConsumer, nodeModules: string): string =>\n    `Cannot write the generated store to ${nodeModules}: ${consumer.name} is installed in ` +\n    `${consumer.nodeModules}, above it, so that copy can never import the generated @gtkx/gi. Install every ` +\n    \"@gtkx package in one node_modules, then run gtkx codegen again.\";\n\nconst checkConsumers = (projectRoot: string, nodeModules: string): void => {\n    const consumer = findUnreachableConsumer(projectRoot, nodeModules);\n\n    if (consumer !== null) {\n        throw new Error(unreachableConsumerMessage(consumer, nodeModules));\n    }\n};\n\nconst jsxOptions = (react: ResolvedPackage | null, nodeModules: string): StoreOptions | null =>\n    react === null ? null : storeOptions(nodeModules, \"jsx\", react.version);\n\nconst getReactSubexports = (react: ResolvedPackage | null): string[] =>\n    react === null ? [] : subexportNames(react.dir);\n\nconst storePaths = (nodeModules: string): string[] =>\n    STORE_NAMES.flatMap((name) => [join(nodeModules, STORE_DIR, name), join(nodeModules, SCOPE, name)]);\n\nconst findStoreNodeModules = (projectRoot: string): string | null => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        return null;\n    }\n\n    return storeNodeModules(runtime, resolvePackage(projectRoot, \"@gtkx/react\"));\n};\n\nconst getShadowingStorePaths = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    if (anchored === null || anchored === nodeModules) {\n        return [];\n    }\n\n    return storePaths(nodeModules);\n};\n\nconst stagingRoots = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    return anchored === null || anchored === nodeModules ? [nodeModules] : [nodeModules, anchored];\n};\n\nconst sweepProjectStaging = (projectRoot: string): void => {\n    for (const nodeModules of stagingRoots(projectRoot)) {\n        for (const name of STORE_NAMES) {\n            sweepStagingDirs(join(nodeModules, STORE_DIR, name));\n        }\n    }\n};\n\n/**\n * Resolves where a project's `@gtkx/gi` and `@gtkx/jsx` stores belong, from the project root alone. The\n * result supplies every `runCodegen` input except `libraries` and `girPath`, so a caller that has\n * already resolved those can spread it straight into the call.\n *\n * Both stores go in one `node_modules`, found by walking the project's `node_modules` chain upwards:\n * the one `@gtkx/react` resolves from, or `@gtkx/runtime`'s when no React is installed. That is the\n * project's own directory when it installs those packages itself, and the workspace root when npm or\n * yarn hoisted them there. Keeping the pair together is what lets the jsx store import the gi store, and\n * anchoring them where the `@gtkx` packages sit is what lets `@gtkx/react`, the CLI, and the project's\n * sources all reach the bindings. A package manager that hoists therefore gives every project sharing\n * that `node_modules` one shared store.\n *\n * Store versions come from the installed `@gtkx/runtime` and `@gtkx/react`, so a dependency upgrade\n * invalidates the stores. Pass explicit `gi` or `jsx` options to `runCodegen` to override any of it.\n *\n * @param projectRoot Directory holding the project's `package.json`, whose `node_modules` chain is walked.\n * @returns The store locations and the React subexports that shape the jsx store.\n * @throws If `@gtkx/runtime` cannot be resolved from the project, or a `@gtkx` package that imports the\n * bindings is installed above the `node_modules` the stores would go in, since it could not reach them.\n */\nconst resolveStore = (projectRoot: string): ResolvedStore => {\n    const runtime = resolveRuntime(projectRoot);\n    const react = resolvePackage(projectRoot, \"@gtkx/react\");\n    const nodeModules = storeNodeModules(runtime, react);\n    checkConsumers(projectRoot, nodeModules);\n\n    return {\n        gi: storeOptions(nodeModules, \"gi\", runtime.version),\n        jsx: jsxOptions(react, nodeModules),\n        reactSubexports: getReactSubexports(react),\n    };\n};\n\nexport { getShadowingStorePaths, nodeModulesChain, resolveStore, sweepProjectStaging, type ResolvedStore };\n"]}
+{"version":3,"file":"resolve-store.js","sourceRoot":"","sources":["../../src/store/resolve-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, realpathSync } from \"node:fs\";\nimport { dirname, join, parse, relative, sep } from \"node:path\";\nimport type { StoreOptions } from \"./store-fs.js\";\nimport { sweepStagingDirs } from \"../staging.js\";\n\n/**\n * Where a project's generated stores live, ready to spread into `runCodegen`. `jsx` is null when the\n * project has no `@gtkx/react` installed, in which case only the `@gtkx/gi` store can be generated.\n */\ntype ResolvedStore = {\n    /** Where the `@gtkx/gi` store goes, versioned by the installed `@gtkx/runtime`. */\n    gi: StoreOptions;\n    /** Where the `@gtkx/jsx` store goes, versioned by the installed `@gtkx/react`; null when it is absent. */\n    jsx: StoreOptions | null;\n    /** Subexport names of the installed `@gtkx/react`, empty when it is absent. */\n    reactSubexports: string[];\n};\n\ntype ResolvedPackage = { dir: string; nodeModules: string; version: string };\ntype StoreConsumer = { name: string; nodeModules: string };\n\nconst STORE_DIR = \".gtkx\";\nconst SCOPE = \"@gtkx\";\nconst STORE_NAMES: string[] = [\"gi\", \"jsx\"];\n\nconst STORE_CONSUMERS: string[] = [\n    \"@gtkx/animated\",\n    \"@gtkx/cli\",\n    \"@gtkx/components\",\n    \"@gtkx/css\",\n    \"@gtkx/navigation\",\n    \"@gtkx/react\",\n    \"@gtkx/runtime\",\n    \"@gtkx/testing\",\n];\n\nconst readManifest = (path: string): { version?: string; exports?: Record<string, unknown> } =>\n    JSON.parse(readFileSync(path, \"utf8\")) as { version?: string; exports?: Record<string, unknown> };\n\nconst subexportNames = (packageDir: string): string[] =>\n    Object.keys(readManifest(join(packageDir, \"package.json\")).exports ?? {})\n        .filter((key) => key.startsWith(\"./\") && key !== \"./package.json\")\n        .map((key) => key.slice(2));\n\nconst loadPackage = (manifest: string, nodeModules: string): ResolvedPackage | null => {\n    if (!existsSync(manifest)) {\n        return null;\n    }\n\n    const real = realpathSync(manifest);\n\n    return { dir: dirname(real), nodeModules, version: readManifest(real).version ?? \"0.0.0\" };\n};\n\nconst nodeModulesChain = function* (projectRoot: string): Generator<string> {\n    const { root } = parse(projectRoot);\n    let current = projectRoot;\n\n    while (current !== root) {\n        yield join(current, \"node_modules\");\n        current = dirname(current);\n    }\n\n    yield join(root, \"node_modules\");\n};\n\nconst resolvePackage = (projectRoot: string, packageName: string): ResolvedPackage | null => {\n    for (const nodeModules of nodeModulesChain(projectRoot)) {\n        const found = loadPackage(join(nodeModules, packageName, \"package.json\"), nodeModules);\n\n        if (found !== null) {\n            return found;\n        }\n    }\n\n    const unscoped = packageName.replace(/^@[^/]+\\//, \"\");\n\n    return loadPackage(join(projectRoot, \"packages\", unscoped, \"package.json\"), join(projectRoot, \"node_modules\"));\n};\n\nconst isWithin = (parent: string, child: string): boolean => {\n    const path = relative(parent, child);\n\n    return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`));\n};\n\nconst canImport = (fromNodeModules: string, targetNodeModules: string): boolean =>\n    isWithin(dirname(targetNodeModules), dirname(fromNodeModules));\n\nconst storeOptions = (nodeModules: string, name: string, version: string): StoreOptions => ({\n    storeDir: join(nodeModules, STORE_DIR, name),\n    linkDir: join(nodeModules, SCOPE, name),\n    version,\n});\n\nconst resolveRuntime = (projectRoot: string): ResolvedPackage => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        throw new Error(`Cannot resolve @gtkx/runtime from ${projectRoot}; is it installed?`);\n    }\n\n    return runtime;\n};\n\nconst storeNodeModules = (runtime: ResolvedPackage, react: ResolvedPackage | null): string => {\n    if (react !== null && canImport(react.nodeModules, runtime.nodeModules)) {\n        return react.nodeModules;\n    }\n\n    return runtime.nodeModules;\n};\n\nconst findUnreachableConsumer = (projectRoot: string, nodeModules: string): StoreConsumer | null => {\n    for (const name of STORE_CONSUMERS) {\n        const consumer = resolvePackage(projectRoot, name);\n\n        if (consumer !== null && !canImport(consumer.nodeModules, nodeModules)) {\n            return { name, nodeModules: consumer.nodeModules };\n        }\n    }\n\n    return null;\n};\n\nconst unreachableConsumerMessage = (consumer: StoreConsumer, nodeModules: string): string =>\n    `Cannot write the generated store to ${nodeModules}: ${consumer.name} is installed in ` +\n    `${consumer.nodeModules}, above it, so that copy can never import the generated @gtkx/gi. Install every ` +\n    \"@gtkx package in one node_modules, then run gtkx codegen again.\";\n\nconst checkConsumers = (projectRoot: string, nodeModules: string): void => {\n    const consumer = findUnreachableConsumer(projectRoot, nodeModules);\n\n    if (consumer !== null) {\n        throw new Error(unreachableConsumerMessage(consumer, nodeModules));\n    }\n};\n\nconst jsxOptions = (react: ResolvedPackage | null, nodeModules: string): StoreOptions | null =>\n    react === null ? null : storeOptions(nodeModules, \"jsx\", react.version);\n\nconst getReactSubexports = (react: ResolvedPackage | null): string[] =>\n    react === null ? [] : subexportNames(react.dir);\n\nconst storePaths = (nodeModules: string): string[] =>\n    STORE_NAMES.flatMap((name) => [join(nodeModules, STORE_DIR, name), join(nodeModules, SCOPE, name)]);\n\nconst findStoreNodeModules = (projectRoot: string): string | null => {\n    const runtime = resolvePackage(projectRoot, \"@gtkx/runtime\");\n\n    if (runtime === null) {\n        return null;\n    }\n\n    return storeNodeModules(runtime, resolvePackage(projectRoot, \"@gtkx/react\"));\n};\n\nconst getShadowingStorePaths = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    if (anchored === null || anchored === nodeModules) {\n        return [];\n    }\n\n    return storePaths(nodeModules);\n};\n\nconst stagingRoots = (projectRoot: string): string[] => {\n    const nodeModules = join(projectRoot, \"node_modules\");\n    const anchored = findStoreNodeModules(projectRoot);\n\n    return anchored === null || anchored === nodeModules ? [nodeModules] : [nodeModules, anchored];\n};\n\nconst sweepProjectStaging = (projectRoot: string): void => {\n    for (const nodeModules of stagingRoots(projectRoot)) {\n        for (const name of STORE_NAMES) {\n            sweepStagingDirs(join(nodeModules, STORE_DIR, name));\n        }\n    }\n};\n\n/**\n * Resolves where a project's `@gtkx/gi` and `@gtkx/jsx` stores belong, from the project root alone. The\n * result supplies every `runCodegen` input except `libraries` and `girPath`, so a caller that has\n * already resolved those can spread it straight into the call.\n *\n * Both stores go in one `node_modules`, found by walking the project's `node_modules` chain upwards:\n * the one `@gtkx/react` resolves from, or `@gtkx/runtime`'s when no React is installed. That is the\n * project's own directory when it installs those packages itself, and the workspace root when npm or\n * yarn hoisted them there. Keeping the pair together is what lets the jsx store import the gi store, and\n * anchoring them where the `@gtkx` packages sit is what lets `@gtkx/react`, the CLI, and the project's\n * sources all reach the bindings. A package manager that hoists therefore gives every project sharing\n * that `node_modules` one shared store.\n *\n * Store versions come from the installed `@gtkx/runtime` and `@gtkx/react`, so a dependency upgrade\n * invalidates the stores. Pass explicit `gi` or `jsx` options to `runCodegen` to override any of it.\n *\n * @param projectRoot Directory holding the project's `package.json`, whose `node_modules` chain is walked.\n * @returns The store locations and the React subexports that shape the jsx store.\n * @throws If `@gtkx/runtime` cannot be resolved from the project, or a `@gtkx` package that imports the\n * bindings is installed above the `node_modules` the stores would go in, since it could not reach them.\n */\nconst resolveStore = (projectRoot: string): ResolvedStore => {\n    const runtime = resolveRuntime(projectRoot);\n    const react = resolvePackage(projectRoot, \"@gtkx/react\");\n    const nodeModules = storeNodeModules(runtime, react);\n    checkConsumers(projectRoot, nodeModules);\n\n    return {\n        gi: storeOptions(nodeModules, \"gi\", runtime.version),\n        jsx: jsxOptions(react, nodeModules),\n        reactSubexports: getReactSubexports(react),\n    };\n};\n\nexport { getShadowingStorePaths, nodeModulesChain, resolveStore, sweepProjectStaging, type ResolvedStore };\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gtkx/codegen",
-  "version": "1.3.0",
-  "description": "Generates the typed GTKX bindings and API reference from GIR and OpenGL registry data",
+  "version": "1.4.0",
+  "description": "Generates typed GTK bindings and API docs from GIR and GL registries.",
   "keywords": [
     "gtkx",
     "gtk",
@@ -58,9 +58,9 @@
     "fast-xml-parser": "^5.11.0",
     "fast-xml-validator": "^1.4.2",
     "typescript": "^6.0.3",
-    "@gtkx/cairo": "1.3.0",
-    "@gtkx/react": "1.3.0",
-    "@gtkx/utils": "1.3.0"
+    "@gtkx/cairo": "1.4.0",
+    "@gtkx/utils": "1.4.0",
+    "@gtkx/react": "1.4.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/analysis/descriptor-render.ts

@@ -619,6 +619,7 @@ const boxedRecordExpression = (options: {
         ownership,
         sharedLibrary: resolved.namespace.sharedLibrary,
         getTypeFnName: typeFnName,
+        freeFnName: record.freeFunc,
         isCallerAllocated,
         isInline,
         size: size > 0 ? size : undefined,

package/src/analysis/descriptor.ts

@@ -66,6 +66,7 @@ type BoxedOptions = {
     ownership: Ownership;
     sharedLibrary: string | undefined;
     getTypeFnName: string;
+    freeFnName: string | undefined;
     isCallerAllocated: boolean;
     isInline?: boolean;
     size: number | undefined;
@@ -193,6 +194,7 @@ const tBoxed = (glibName: string, options: BoxedOptions): string =>
                 ? undefined
                 : `sharedLibrary: ${sourceStringLiteral(options.sharedLibrary)}`,
             `getTypeFnName: ${sourceStringLiteral(options.getTypeFnName)}`,
+            options.freeFnName === undefined ? undefined : `freeFnName: ${sourceStringLiteral(options.freeFnName)}`,
             options.isCallerAllocated ? "isCallerAllocated: true" : undefined,
             options.isInline === true ? "isInline: true" : undefined,
             options.size === undefined ? undefined : `size: ${String(options.size)}`,

package/src/fingerprint.ts

@@ -150,7 +150,14 @@ const dependencyVersions = (): string[] =>
     );
 
 const hashPackageCode = (hash: Hash, label: string, root: string): void => {
-    hashTree(hash, join(label, "src"), join(root, "src"));
+    const source = join(root, "src");
+
+    if (existsSync(source)) {
+        hashTree(hash, join(label, "src"), source);
+
+        return;
+    }
+
     hashTree(hash, join(label, "dist"), join(root, "dist"));
 };
 

package/src/gi.ts

@@ -4,6 +4,7 @@ import { computeGiFingerprint } from "./fingerprint.js";
 import { externalPackageFor } from "./gir/external-namespaces.js";
 import { namespaceDirectory } from "./gir/namespace.js";
 import { type GiExternalNamespaceInput, type GiNamespaceInput, writeGiStore } from "./store/gi-store.js";
+import { collectGeneratedLibraries } from "./store/gi/generated-libraries.js";
 import { generateNamespaceModule } from "./store/gi/pipeline.js";
 
 type GiCodegenOptions = {
@@ -63,7 +64,10 @@ const runGiCodegen = (library: Library, options: GiCodegenOptions): number => {
         isInoutInPlace,
     });
 
-    writeGiStore(gi, namespaces, externalNamespaces, fingerprint);
+    writeGiStore(gi, namespaces, externalNamespaces, {
+        fingerprint,
+        libraries: collectGeneratedLibraries(library.namespaces, libraries),
+    });
 
     return library.namespaces.size;
 };

package/src/guards.ts

@@ -12,6 +12,11 @@ const isString = (value: unknown): value is string => typeof value === "string";
 const arrayGuard = <T>(isEntry: Guard<T>): Guard<T[]> =>
     (value: unknown): value is T[] => Array.isArray(value) && value.every((entry: unknown) => isEntry(entry));
 
+const recordGuard = <T>(isEntry: Guard<T>): Guard<Record<string, T>> =>
+    (value: unknown): value is Record<string, T> =>
+        isRecord(value) && !Array.isArray(value) &&
+        Object.values(value).every((entry: unknown) => isEntry(entry));
+
 const optionalGuard = <T>(isPresent: Guard<T>): OptionalGuard<T> =>
     Object.assign((value: unknown): value is T | undefined => value === undefined || isPresent(value), {
         __optional__: true as const,
@@ -20,4 +25,4 @@ const optionalGuard = <T>(isPresent: Guard<T>): OptionalGuard<T> =>
 const hasFields = <T extends object>(value: unknown, guards: FieldGuards<T>): value is T =>
     isRecord(value) && Object.entries(guards).every(([name, guard]) => (guard as Guard<unknown>)(value[name]));
 
-export { arrayGuard, hasFields, isBoolean, isNumber, isString, optionalGuard };
+export { arrayGuard, hasFields, isBoolean, isNumber, isString, optionalGuard, recordGuard };

package/src/index.ts

@@ -20,6 +20,8 @@ export { type BuiltinElements, type ModuleExport, readBuiltinElements } from "./
 /** @public */
 export { type CodegenRunnerOptions, type CodegenRunnerResult, runCodegen } from "./runner.js";
 /** @public */
+export { type GeneratedLibraries, readGeneratedLibraries } from "./store/gi/generated-libraries.js";
+/** @public */
 export type { ElementProps } from "./store/jsx/element-prop-imports.js";
 /** @public */
 export { type GeneratedElement, readGeneratedElements } from "./store/jsx/generated-elements.js";

package/src/store/gi/generated-libraries.ts

@@ -0,0 +1,91 @@
+import { sortStrings } from "@gtkx/utils";
+import { join } from "node:path";
+import type { GirNamespace } from "../../gir/namespace.js";
+import { arrayGuard, hasFields, isString, recordGuard } from "../../guards.js";
+import { readJsonFile } from "../../json.js";
+
+/** What a generated `@gtkx/gi` store binds, and the library releases it was generated against. */
+type GeneratedLibraries = {
+    /** GIR identifiers the store binds, such as `Gtk-4.0`, expanded from the project's `libraries`. */
+    libraries: string[];
+    /**
+     * `MAJOR.MINOR` release, keyed by GIR identifier. A library whose GIR declares no `MAJOR_VERSION`
+     * and `MINOR_VERSION` is absent, so an entry is present only for those that name their release.
+     */
+    versions: Record<string, string>;
+};
+
+const LIBRARIES_FILENAME = "libraries.json";
+const MAJOR_CONSTANT = "MAJOR_VERSION";
+const MINOR_CONSTANT = "MINOR_VERSION";
+const DIGITS = /^\d+$/;
+
+const constantValue = (namespace: GirNamespace, name: string): string | undefined => {
+    const constant = namespace.constants.find((entry) => entry.name === name);
+
+    return constant !== undefined && DIGITS.test(constant.value) ? constant.value : undefined;
+};
+
+const namespaceVersion = (namespace: GirNamespace): string | undefined => {
+    const major = constantValue(namespace, MAJOR_CONSTANT);
+    const minor = constantValue(namespace, MINOR_CONSTANT);
+
+    return major === undefined || minor === undefined ? undefined : `${major}.${minor}`;
+};
+
+const getNamespaceName = (library: string): string => {
+    const separator = library.indexOf("-");
+
+    return separator === -1 ? library : library.slice(0, separator);
+};
+
+const collectGeneratedLibraries = (
+    namespaces: Map<string, GirNamespace>,
+    libraries: string[],
+): GeneratedLibraries => {
+    const sorted = sortStrings(libraries);
+    const versions: Record<string, string> = {};
+
+    for (const library of sorted) {
+        const namespace = namespaces.get(getNamespaceName(library));
+        const version = namespace === undefined ? undefined : namespaceVersion(namespace);
+
+        if (version !== undefined) {
+            versions[library] = version;
+        }
+    }
+
+    return { libraries: sorted, versions };
+};
+
+const renderGeneratedLibraries = (generated: GeneratedLibraries): string =>
+    `${JSON.stringify(generated, null, 2)}\n`;
+
+const isGeneratedLibraries = (value: unknown): value is GeneratedLibraries =>
+    hasFields<GeneratedLibraries>(value, {
+        libraries: arrayGuard(isString),
+        versions: recordGuard(isString),
+    });
+
+/**
+ * Reads which GIR libraries a generated `@gtkx/gi` store binds and which release of each its GIR declared,
+ * out of the inventory codegen writes into the store. Answers "what does this project bind, and how new does
+ * the installed library have to be" without parsing a `.gir` file or querying pkg-config.
+ *
+ * @param giStoreDir The gi store directory, as given by `resolveStore(projectRoot).gi.storeDir`.
+ * @returns What the store recorded, or null when it holds no inventory codegen wrote, which covers an absent,
+ * unreadable, unparseable and structurally foreign store file alike.
+ */
+const readGeneratedLibraries = (giStoreDir: string): GeneratedLibraries | null => {
+    const parsed = readJsonFile(join(giStoreDir, LIBRARIES_FILENAME));
+
+    return isGeneratedLibraries(parsed) ? parsed : null;
+};
+
+export {
+    LIBRARIES_FILENAME,
+    collectGeneratedLibraries,
+    type GeneratedLibraries,
+    readGeneratedLibraries,
+    renderGeneratedLibraries,
+};

package/src/store/gi-store.ts

@@ -4,6 +4,11 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import type { SourceModule } from "../compile.js";
 import { FINGERPRINT_FILENAME, type GiFingerprint } from "../fingerprint.js";
+import {
+    type GeneratedLibraries,
+    LIBRARIES_FILENAME,
+    renderGeneratedLibraries,
+} from "./gi/generated-libraries.js";
 import { buildManifest, namespaceBarrel, type StoreOptions, subpathExport, writeStore } from "./store-fs.js";
 
 type GiNamespaceInput = {
@@ -18,6 +23,11 @@ type GiExternalNamespaceInput = {
     girFile: string;
 };
 
+type GiStoreRecords = {
+    fingerprint: GiFingerprint;
+    libraries: GeneratedLibraries;
+};
+
 const OVERRIDES_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "overrides");
 
 const overrideFiles = (directory: string): SourceModule[] => {
@@ -94,7 +104,7 @@ const writeGiStore = (
     options: StoreOptions,
     namespaces: GiNamespaceInput[],
     externalNamespaces: GiExternalNamespaceInput[],
-    fingerprint: GiFingerprint,
+    records: GiStoreRecords,
 ): void => {
     const { collected, exportsMap } = collectStoreSources(namespaces, externalNamespaces);
 
@@ -108,7 +118,10 @@ const writeGiStore = (
             exports: exportsMap,
             peerDependencies: storePeerDependencies(externalNamespaces),
         }),
-        rawFiles: [{ relativePath: FINGERPRINT_FILENAME, content: `${JSON.stringify(fingerprint, null, 2)}\n` }],
+        rawFiles: [
+            { relativePath: FINGERPRINT_FILENAME, content: `${JSON.stringify(records.fingerprint, null, 2)}\n` },
+            { relativePath: LIBRARIES_FILENAME, content: renderGeneratedLibraries(records.libraries) },
+        ],
     });
 };
 

package/src/store/jsx/metadata.ts

@@ -17,22 +17,17 @@ import {
 type IntrinsicElementEntry = {
     glibName: string;
     signals: [string, string][];
-    constructOnly: string[];
-    constructable: string[];
-    defaults: [string, string][];
+    properties: [string, string][];
 };
 
-type PropNameCollector = {
-    shouldKeep: (property: GirProperty) => boolean;
-    seen: Set<string>;
-    names: string[];
-};
+const READABLE = 1;
+const WRITABLE = 2;
+const CONSTRUCT = 4;
+const CONSTRUCT_ONLY = 8;
 
-type DefaultPropsCollector = {
-    library: Library;
-    seen: Set<string>;
-    defaults: [string, string][];
-};
+const PROPERTY_ENTRY_TYPE =
+    "/** The GObject name of a property, what a write may do to it, and the value it resets to. */\n" +
+    "export type PropertyEntry = [name: string, flags: number, defaultValue?: unknown];";
 
 const INTEGER_PATTERN = /^-?\d+$/;
 const FLOAT_PATTERN = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
@@ -44,23 +39,15 @@ const generateMetadata = (library: Library): string => {
         ({ glibName, signals }) => `    "${glibName}": ${renderSignalsObject(signals)},`,
     );
 
-    const constructOnlyEntries = intrinsicElements
-        .filter(({ constructOnly }) => constructOnly.length > 0)
-        .map(({ glibName, constructOnly }) => `    "${glibName}": ${renderStringSet(constructOnly)},`);
-
-    const constructableEntries = intrinsicElements
-        .filter(({ constructable }) => constructable.length > 0)
-        .map(({ glibName, constructable }) => `    "${glibName}": ${renderStringSet(constructable)},`);
-
-    const defaultsEntries = intrinsicElements
-        .filter(({ defaults }) => defaults.length > 0)
-        .map(({ glibName, defaults }) => `    "${glibName}": ${renderDefaultsObject(defaults)},`);
+    const propertyEntries = intrinsicElements
+        .filter(({ properties }) => properties.length > 0)
+        .map(({ glibName, properties }) => `    "${glibName}": ${renderPropertiesObject(properties)},`);
 
     return `${[
+        PROPERTY_ENTRY_TYPE,
         `export const signals: Record<string, Record<string, string>> = {\n${signalsEntries.join("\n")}\n};`,
-        `export const constructOnlyProps: Record<string, Set<string>> = {\n${constructOnlyEntries.join("\n")}\n};`,
-        `export const constructProps: Record<string, Set<string>> = {\n${constructableEntries.join("\n")}\n};`,
-        `export const defaultProps: Record<string, Record<string, unknown>> = {\n${defaultsEntries.join("\n")}\n};`,
+        "export const properties: Record<string, Record<string, PropertyEntry>> = " +
+        `{\n${propertyEntries.join("\n")}\n};`,
     ].join("\n\n")}\n`;
 };
 
@@ -83,9 +70,7 @@ const collectIntrinsicElements = (library: Library): IntrinsicElementEntry[] =>
         entries.push({
             glibName,
             signals: collectSignals(sources),
-            constructOnly: collectConstructOnly(sources),
-            constructable: collectConstructable(sources),
-            defaults: collectDefaultProps(library, sources),
+            properties: collectProperties(library, sources),
         });
     }
 
@@ -116,41 +101,52 @@ const collectSignals = (sources: GirClass[]): [string, string][] => {
     return signals;
 };
 
-const collectPropNamesFromSource = (source: GirClass, collector: PropNameCollector): void => {
-    const { shouldKeep, seen, names } = collector;
+const propertyFlags = (property: GirProperty): number => {
+    const construct = isConstructableProperty(property) && !property.constructOnly ? CONSTRUCT : 0;
+    const constructOnly = property.constructOnly ? CONSTRUCT_ONLY : 0;
 
-    for (const property of source.properties) {
-        if (!shouldKeep(property)) {
-            continue;
-        }
+    return (property.readable ? READABLE : 0) |
+        (property.writable ? WRITABLE : 0) |
+        construct |
+        constructOnly;
+};
+
+const propertyEntryLiteral = (library: Library, klass: GirClass, property: GirProperty): string => {
+    const head = `${sourceStringLiteral(property.name)},${String(propertyFlags(property))}`;
+    const literal = isDefaultCandidate(property) ? renderDefaultLiteral(library, klass, property) : undefined;
+
+    return literal === undefined ? `[${head}]` : `[${head},${literal}]`;
+};
 
+const collectPropertiesFromSource = (
+    library: Library,
+    source: GirClass,
+    seen: Set<string>,
+    entries: [string, string][],
+): void => {
+    for (const property of source.properties) {
         const jsName = toCamelIdentifier(property.name);
 
-        if (seen.has(jsName)) {
+        if (!property.introspectable || seen.has(jsName)) {
             continue;
         }
 
         seen.add(jsName);
-        names.push(jsName);
+        entries.push([jsName, propertyEntryLiteral(library, source, property)]);
     }
 };
 
-const collectPropNames = (sources: GirClass[], shouldKeep: (property: GirProperty) => boolean): string[] => {
-    const collector: PropNameCollector = { shouldKeep, seen: new Set<string>(), names: [] };
+const collectProperties = (library: Library, sources: GirClass[]): [string, string][] => {
+    const seen: Set<string> = new Set();
+    const entries: [string, string][] = [];
 
     for (const source of sources) {
-        collectPropNamesFromSource(source, collector);
+        collectPropertiesFromSource(library, source, seen, entries);
     }
 
-    return collector.names;
+    return entries;
 };
 
-const collectConstructOnly = (sources: GirClass[]): string[] =>
-    collectPropNames(sources, (property) => property.constructOnly && property.introspectable);
-
-const collectConstructable = (sources: GirClass[]): string[] =>
-    collectPropNames(sources, (property) => isConstructableProperty(property) && property.introspectable);
-
 const renderObjectLiteral = (entries: [string, string][], renderValue: (value: string) => string): string => {
     if (entries.length === 0) {
         return "{}";
@@ -161,60 +157,14 @@ const renderObjectLiteral = (entries: [string, string][], renderValue: (value: s
     return `{\n${lines.join(",\n")}\n    }`;
 };
 
-const renderStringSet = (names: string[]): string =>
-    `new Set([${names.map((name) => sourceStringLiteral(name)).join(",")}])`;
+const renderPropertiesObject = (entries: [string, string][]): string =>
+    renderObjectLiteral(entries, (value) => value);
 
 const renderSignalsObject = (entries: [string, string][]): string => renderObjectLiteral(entries, sourceStringLiteral);
 
-const collectDefaultsFromClass = (klass: GirClass, collector: DefaultPropsCollector): void => {
-    for (const property of klass.properties) {
-        const entry = defaultPropEntry(collector.library, klass, property, collector.seen);
-
-        if (entry !== undefined) {
-            collector.defaults.push(entry);
-        }
-    }
-};
-
-const collectDefaultProps = (library: Library, sources: GirClass[]): [string, string][] => {
-    const collector: DefaultPropsCollector = { library, seen: new Set<string>(), defaults: [] };
-
-    for (const klass of sources) {
-        collectDefaultsFromClass(klass, collector);
-    }
-
-    return collector.defaults;
-};
-
 const isDefaultCandidate = (property: GirProperty): boolean =>
     (property.writable || property.construct) && !property.constructOnly && property.introspectable;
 
-const defaultPropEntry = (
-    library: Library,
-    klass: GirClass,
-    property: GirProperty,
-    seen: Set<string>,
-): [string, string] | undefined => {
-    if (!isDefaultCandidate(property)) {
-        return undefined;
-    }
-
-    const jsName = toCamelIdentifier(property.name);
-
-    if (seen.has(jsName)) {
-        return undefined;
-    }
-
-    seen.add(jsName);
-    const literal = renderDefaultLiteral(library, klass, property);
-
-    if (literal === undefined) {
-        return undefined;
-    }
-
-    return [jsName, literal];
-};
-
 const willSetterRejectNull = (library: Library, klass: GirClass, property: GirProperty): boolean => {
     if (property.setter === undefined) {
         return false;
@@ -382,7 +332,4 @@ const enumDefaultLiteral = (enumType: GirEnum, raw: string): string | undefined
     return member?.value;
 };
 
-const renderDefaultsObject = (entries: [string, string][]): string =>
-    renderObjectLiteral(entries, (literal) => literal);
-
 export { generateMetadata };

package/src/store/resolve-store.ts

@@ -28,6 +28,7 @@ const STORE_CONSUMERS: string[] = [
     "@gtkx/cli",
     "@gtkx/components",
     "@gtkx/css",
+    "@gtkx/navigation",
     "@gtkx/react",
     "@gtkx/runtime",
     "@gtkx/testing",