@gtkx/cli 2.0.0-beta.6 → 2.0.0-beta.7

package/dist/vite-plugins/undeclared-library.js.map

@@ -1 +1 @@
-{"version":3,"file":"undeclared-library.js","sourceRoot":"","sources":["../../src/vite-plugins/undeclared-library.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StoreOptions } from \"@gtkx/codegen\";\nimport type { ConfigLoader } from \"@gtkx/config\";\nimport type { Plugin, UserConfig } from \"vite\";\nimport { discoverGirNamespaces, resolveGirPath, resolveStore } from \"@gtkx/codegen\";\nimport { createConfigLoader } from \"@gtkx/config/internal\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\ntype PluginState = {\n    root: string;\n    loadConfig: ConfigLoader;\n    girPath: string[] | null;\n};\n\ntype GeneratedModule = {\n    source: string;\n    kind: string;\n    namespace: string;\n    importer: string;\n};\n\nconst GENERATED_MODULE_PATTERN = /^@gtkx\\/(gi|jsx)\\/([a-z0-9]+)$/;\nconst DEFAULT_LIBRARY_NAMESPACES: Set<string> = new Set([\"gtk\", \"adw\"]);\n\nconst girSearchPaths = async (state: PluginState): Promise<string[]> => {\n    if (state.girPath === null) {\n        const { config } = await state.loadConfig.load(state.root);\n        state.girPath = resolveGirPath(config.girPath);\n    }\n\n    return state.girPath;\n};\n\nconst getNamespace = (identifier: string): string => identifier.slice(0, identifier.indexOf(\"-\")).toLowerCase();\n\nconst findGirIdentifier = (girPath: string[], namespace: string): string | undefined =>\n    discoverGirNamespaces(girPath).find((identifier) => getNamespace(identifier) === namespace);\n\nconst parseGeneratedModule = (source: string, importer: string | undefined): GeneratedModule | null => {\n    const matched = GENERATED_MODULE_PATTERN.exec(source);\n    const kind = matched?.[1];\n    const namespace = matched?.[2];\n\n    if (kind === undefined || namespace === undefined) {\n        return null;\n    }\n\n    return { source, kind, namespace, importer: importer ?? \"the project's sources\" };\n};\n\nconst getStoreOptions = (root: string, kind: string): StoreOptions | null => {\n    try {\n        const store = resolveStore(root);\n\n        return kind === \"gi\" ? store.gi : store.jsx;\n    } catch {\n        return null;\n    }\n};\n\nconst hasStoreModule = (storeDir: string, exportKey: string): boolean => {\n    const manifest = join(storeDir, \"package.json\");\n\n    if (!existsSync(manifest)) {\n        return false;\n    }\n\n    const { exports } = JSON.parse(readFileSync(manifest, \"utf8\")) as { exports?: Record<string, unknown> };\n\n    return exports?.[exportKey] !== undefined;\n};\n\nconst unreachableStoreError = (generated: GeneratedModule, options: StoreOptions): Error => {\n    const provided = `\"${generated.namespace}\"`;\n\n    return new Error(\n        `Cannot resolve \"${generated.source}\": the generated store in ${options.storeDir} does provide ` +\n        `${provided}, but its link at ${options.linkDir} is not on the module resolution path of ` +\n        `${generated.importer}. Codegen writes the store into the node_modules the installed @gtkx packages ` +\n        \"resolve from; install them where the importing file reaches them, then run gtkx codegen again.\",\n    );\n};\n\nconst undeclaredLibraryError = (source: string, namespace: string, girPath: string[]): Error => {\n    const identifier = findGirIdentifier(girPath, namespace);\n\n    if (identifier === undefined) {\n        return new Error(\n            `Cannot resolve \"${source}\": the binding store has no \"${namespace}\" module, and no ` +\n            `GIR data for it was found in [${girPath.join(\", \")}]. If \"${namespace}\" is a library, install ` +\n            \"its gobject-introspection data package. Gtk-4.0 and Adw-1 are bound by default; add only other \" +\n            \"GIR identifiers to `libraries` in gtkx.config.ts. Otherwise run gtkx codegen to regenerate the store.\",\n        );\n    }\n\n    if (DEFAULT_LIBRARY_NAMESPACES.has(namespace)) {\n        return new Error(\n            `Cannot resolve \"${source}\": the \"${identifier}\" bindings have not been generated. ` +\n            \"The Gtk and Adwaita namespaces are bound by default; run gtkx dev or gtkx build again.\",\n        );\n    }\n\n    return new Error(\n        `Cannot resolve \"${source}\": the \"${identifier}\" bindings have not been generated. ` +\n        `Add \"${identifier}\" to \\`libraries\\` in gtkx.config.ts, then run gtkx dev or gtkx build again.`,\n    );\n};\n\nconst unresolvedModuleError = async (state: PluginState, generated: GeneratedModule): Promise<Error> => {\n    const options = getStoreOptions(state.root, generated.kind);\n    const exportKey = `./${generated.namespace}`;\n\n    if (options !== null && hasStoreModule(options.storeDir, exportKey)) {\n        return unreachableStoreError(generated, options);\n    }\n\n    return undeclaredLibraryError(generated.source, generated.namespace, await girSearchPaths(state));\n};\n\nfunction gtkxUndeclaredLibrary(loadConfig: ConfigLoader = createConfigLoader()): Plugin {\n    const state: PluginState = {\n        root: \"\",\n        loadConfig,\n        girPath: null,\n    };\n\n    return {\n        name: \"gtkx:undeclared-library\",\n        enforce: \"pre\",\n\n        config(config: UserConfig) {\n            state.root = config.root ?? process.cwd();\n        },\n\n        async resolveId(source, importer, options) {\n            const generated = parseGeneratedModule(source, importer);\n\n            if (generated === null) {\n                return;\n            }\n\n            const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });\n\n            if (resolved !== null) {\n                return;\n            }\n\n            throw await unresolvedModuleError(state, generated);\n        },\n    };\n}\n\nexport { gtkxUndeclaredLibrary };\n"]}
+{"version":3,"file":"undeclared-library.js","sourceRoot":"","sources":["../../src/vite-plugins/undeclared-library.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAejC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AAClE,MAAM,0BAA0B,GAAgB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAExE,MAAM,cAAc,GAAG,KAAK,EAAE,KAAkB,EAAqB,EAAE;IACnE,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEhH,MAAM,iBAAiB,GAAG,CAAC,OAAiB,EAAE,SAAiB,EAAsB,EAAE,CACnF,qBAAqB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC;AAEhG,MAAM,oBAAoB,GAAG,CAAC,MAAc,EAAE,QAA4B,EAA0B,EAAE;IAClG,MAAM,OAAO,GAAG,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/B,IAAI,IAAI,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,IAAI,uBAAuB,EAAE,CAAC;AACtF,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,IAAY,EAAuB,EAAE;IACxE,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAW,EAAE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA0C,CAAC;IAExG,OAAO,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,SAA0B,EAAE,OAAqB,EAAS,EAAE;IACvF,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,SAAS,GAAG,CAAC;IAE5C,OAAO,IAAI,KAAK,CACZ,mBAAmB,SAAS,CAAC,MAAM,6BAA6B,OAAO,CAAC,QAAQ,gBAAgB;QAChG,GAAG,QAAQ,qBAAqB,OAAO,CAAC,OAAO,2CAA2C;QAC1F,GAAG,SAAS,CAAC,QAAQ,gFAAgF;QACrG,gGAAgG,CACnG,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,OAAiB,EAAS,EAAE;IAC3F,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEzD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,KAAK,CACZ,mBAAmB,MAAM,gCAAgC,SAAS,mBAAmB;YACrF,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,SAAS,0BAA0B;YAChG,yGAAyG;YACzG,uGAAuG,CAC1G,CAAC;IACN,CAAC;IAED,IAAI,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,KAAK,CACZ,mBAAmB,MAAM,WAAW,UAAU,sCAAsC;YACpF,4FAA4F,CAC/F,CAAC;IACN,CAAC;IAED,OAAO,IAAI,KAAK,CACZ,mBAAmB,MAAM,WAAW,UAAU,sCAAsC;QACpF,QAAQ,UAAU,8EAA8E,CACnG,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,KAAK,EAAE,KAAkB,EAAE,SAA0B,EAAkB,EAAE;IACnG,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,SAAS,CAAC,SAAS,EAAE,CAAC;IAE7C,IAAI,OAAO,KAAK,IAAI,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QAClE,OAAO,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,sBAAsB,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC;AAEF,SAAS,qBAAqB,CAAC,aAA2B,kBAAkB,EAAE;IAC1E,MAAM,KAAK,GAAgB;QACvB,IAAI,EAAE,EAAE;QACR,UAAU;QACV,OAAO,EAAE,IAAI;KAChB,CAAC;IAEF,OAAO;QACH,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK;QAEd,MAAM,CAAC,MAAkB;YACrB,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO;YACrC,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEzD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO;YACX,CAAC;YAED,MAAM,MAAM,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC","sourcesContent":["import type { StoreOptions } from \"@gtkx/codegen\";\nimport type { ConfigLoader } from \"@gtkx/config\";\nimport type { Plugin, UserConfig } from \"vite\";\nimport { discoverGirNamespaces, resolveGirPath, resolveStore } from \"@gtkx/codegen\";\nimport { createConfigLoader } from \"@gtkx/config/internal\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\ntype PluginState = {\n    root: string;\n    loadConfig: ConfigLoader;\n    girPath: string[] | null;\n};\n\ntype GeneratedModule = {\n    source: string;\n    kind: string;\n    namespace: string;\n    importer: string;\n};\n\nconst GENERATED_MODULE_PATTERN = /^@gtkx\\/(gi|jsx)\\/([a-z0-9]+)$/;\nconst DEFAULT_LIBRARY_NAMESPACES: Set<string> = new Set([\"adw\", \"gtk\"]);\n\nconst girSearchPaths = async (state: PluginState): Promise<string[]> => {\n    if (state.girPath === null) {\n        const { config } = await state.loadConfig.load(state.root);\n        state.girPath = resolveGirPath(config.girPath);\n    }\n\n    return state.girPath;\n};\n\nconst getNamespace = (identifier: string): string => identifier.slice(0, identifier.indexOf(\"-\")).toLowerCase();\n\nconst findGirIdentifier = (girPath: string[], namespace: string): string | undefined =>\n    discoverGirNamespaces(girPath).find((identifier) => getNamespace(identifier) === namespace);\n\nconst parseGeneratedModule = (source: string, importer: string | undefined): GeneratedModule | null => {\n    const matched = GENERATED_MODULE_PATTERN.exec(source);\n    const kind = matched?.[1];\n    const namespace = matched?.[2];\n\n    if (kind === undefined || namespace === undefined) {\n        return null;\n    }\n\n    return { source, kind, namespace, importer: importer ?? \"the project's sources\" };\n};\n\nconst getStoreOptions = (root: string, kind: string): StoreOptions | null => {\n    try {\n        const store = resolveStore(root);\n\n        return kind === \"gi\" ? store.gi : store.jsx;\n    } catch {\n        return null;\n    }\n};\n\nconst hasStoreModule = (storeDir: string, exportKey: string): boolean => {\n    const manifest = join(storeDir, \"package.json\");\n\n    if (!existsSync(manifest)) {\n        return false;\n    }\n\n    const { exports } = JSON.parse(readFileSync(manifest, \"utf8\")) as { exports?: Record<string, unknown> };\n\n    return exports?.[exportKey] !== undefined;\n};\n\nconst unreachableStoreError = (generated: GeneratedModule, options: StoreOptions): Error => {\n    const provided = `\"${generated.namespace}\"`;\n\n    return new Error(\n        `Cannot resolve \"${generated.source}\": the generated store in ${options.storeDir} does provide ` +\n        `${provided}, but its link at ${options.linkDir} is not on the module resolution path of ` +\n        `${generated.importer}. Codegen writes the store into the node_modules the installed @gtkx packages ` +\n        \"resolve from; install them where the importing file reaches them, then run gtkx codegen again.\",\n    );\n};\n\nconst undeclaredLibraryError = (source: string, namespace: string, girPath: string[]): Error => {\n    const identifier = findGirIdentifier(girPath, namespace);\n\n    if (identifier === undefined) {\n        return new Error(\n            `Cannot resolve \"${source}\": the binding store has no \"${namespace}\" module, and no ` +\n            `GIR data for it was found in [${girPath.join(\", \")}]. If \"${namespace}\" is a library, install ` +\n            \"its gobject-introspection data package. Adw-1 is bound by default and pulls in Gtk-4.0; add only other \" +\n            \"GIR identifiers to `libraries` in gtkx.config.ts. Otherwise run gtkx codegen to regenerate the store.\",\n        );\n    }\n\n    if (DEFAULT_LIBRARY_NAMESPACES.has(namespace)) {\n        return new Error(\n            `Cannot resolve \"${source}\": the \"${identifier}\" bindings have not been generated. ` +\n            \"The Adwaita and GTK namespaces are generated implicitly; run gtkx dev or gtkx build again.\",\n        );\n    }\n\n    return new Error(\n        `Cannot resolve \"${source}\": the \"${identifier}\" bindings have not been generated. ` +\n        `Add \"${identifier}\" to \\`libraries\\` in gtkx.config.ts, then run gtkx dev or gtkx build again.`,\n    );\n};\n\nconst unresolvedModuleError = async (state: PluginState, generated: GeneratedModule): Promise<Error> => {\n    const options = getStoreOptions(state.root, generated.kind);\n    const exportKey = `./${generated.namespace}`;\n\n    if (options !== null && hasStoreModule(options.storeDir, exportKey)) {\n        return unreachableStoreError(generated, options);\n    }\n\n    return undeclaredLibraryError(generated.source, generated.namespace, await girSearchPaths(state));\n};\n\nfunction gtkxUndeclaredLibrary(loadConfig: ConfigLoader = createConfigLoader()): Plugin {\n    const state: PluginState = {\n        root: \"\",\n        loadConfig,\n        girPath: null,\n    };\n\n    return {\n        name: \"gtkx:undeclared-library\",\n        enforce: \"pre\",\n\n        config(config: UserConfig) {\n            state.root = config.root ?? process.cwd();\n        },\n\n        async resolveId(source, importer, options) {\n            const generated = parseGeneratedModule(source, importer);\n\n            if (generated === null) {\n                return;\n            }\n\n            const resolved = await this.resolve(source, importer, { ...options, skipSelf: true });\n\n            if (resolved !== null) {\n                return;\n            }\n\n            throw await unresolvedModuleError(state, generated);\n        },\n    };\n}\n\nexport { gtkxUndeclaredLibrary };\n"]}

package/dist/vitest-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-plugin.d.ts","sourceRoot":"","sources":["../src/vitest-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAK9D;;;;;;GAMG;AACH,QAAA,MAAM,IAAI,GAAI,UAAS,aAAkB,KAAG,MAAM,EAKjD,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"vitest-plugin.d.ts","sourceRoot":"","sources":["../src/vitest-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAM9D;;;;;;GAMG;AACH,QAAA,MAAM,IAAI,GAAI,UAAS,aAAkB,KAAG,MAAM,EAMjD,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/vitest-plugin.js

@@ -1,5 +1,6 @@
 import gtkxVitest, {} from "@gtkx/vitest";
 import { gtkxEnsureStore } from "./vite-plugins/ensure-store.js";
+import { gtkxFontWorkerEnv } from "./vite-plugins/font-worker-env.js";
 import { gtkxVitePlugins } from "./vite-plugins/index.js";
 import { gtkxSettingsWorkerEnv } from "./vite-plugins/settings-worker-env.js";
 /**
@@ -13,6 +14,7 @@ const gtkx = (options = {}) => [
     gtkxEnsureStore(options.configFile),
     ...gtkxVitePlugins({ configFile: options.configFile }),
     gtkxSettingsWorkerEnv(options.configFile),
+    gtkxFontWorkerEnv(options.configFile),
     gtkxVitest(options),
 ];
 export default gtkx;

package/dist/vitest-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-plugin.js","sourceRoot":"","sources":["../src/vitest-plugin.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,EAAE,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,CAAC,UAAyB,EAAE,EAAY,EAAE,CAAC;IACpD,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC;IACnC,GAAG,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IACtD,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC;CACtB,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import type { Plugin } from \"vite\";\nimport gtkxVitest, { type PluginOptions } from \"@gtkx/vitest\";\nimport { gtkxEnsureStore } from \"./vite-plugins/ensure-store.js\";\nimport { gtkxVitePlugins } from \"./vite-plugins/index.js\";\nimport { gtkxSettingsWorkerEnv } from \"./vite-plugins/settings-worker-env.js\";\n\n/**\n * Vite plugin stack for testing a GTKX application: the generated bindings the tests import,\n * the plugins the app is built with, the project's compiled GSettings schemas exposed to every\n * test worker, and a headless display per worker.\n *\n * @returns The plugins to spread into a Vitest config.\n */\nconst gtkx = (options: PluginOptions = {}): Plugin[] => [\n    gtkxEnsureStore(options.configFile),\n    ...gtkxVitePlugins({ configFile: options.configFile }),\n    gtkxSettingsWorkerEnv(options.configFile),\n    gtkxVitest(options),\n];\n\nexport default gtkx;\n"]}
+{"version":3,"file":"vitest-plugin.js","sourceRoot":"","sources":["../src/vitest-plugin.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,EAAE,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,CAAC,UAAyB,EAAE,EAAY,EAAE,CAAC;IACpD,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC;IACnC,GAAG,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IACtD,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC;IACzC,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC;IACrC,UAAU,CAAC,OAAO,CAAC;CACtB,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import type { Plugin } from \"vite\";\nimport gtkxVitest, { type PluginOptions } from \"@gtkx/vitest\";\nimport { gtkxEnsureStore } from \"./vite-plugins/ensure-store.js\";\nimport { gtkxFontWorkerEnv } from \"./vite-plugins/font-worker-env.js\";\nimport { gtkxVitePlugins } from \"./vite-plugins/index.js\";\nimport { gtkxSettingsWorkerEnv } from \"./vite-plugins/settings-worker-env.js\";\n\n/**\n * Vite plugin stack for testing a GTKX application: the generated bindings the tests import,\n * the plugins the app is built with, the project's compiled GSettings schemas exposed to every\n * test worker, and a headless display per worker.\n *\n * @returns The plugins to spread into a Vitest config.\n */\nconst gtkx = (options: PluginOptions = {}): Plugin[] => [\n    gtkxEnsureStore(options.configFile),\n    ...gtkxVitePlugins({ configFile: options.configFile }),\n    gtkxSettingsWorkerEnv(options.configFile),\n    gtkxFontWorkerEnv(options.configFile),\n    gtkxVitest(options),\n];\n\nexport default gtkx;\n"]}

package/env.d.ts

@@ -14,6 +14,15 @@ declare module "*?icon" {
     export default iconName;
 }
 
+declare module "*?font" {
+    /**
+     * Font family name of the bundled font. Importing the module bundles the font file with the application and
+     * puts it where fontconfig finds it, so the family is available to Pango without any runtime registration.
+     */
+    const fontFamily: string;
+    export default fontFamily;
+}
+
 declare module "*.css?url" {
     /**
      * Absolute filesystem path of the source stylesheet under `gtkx dev` or the emitted stylesheet once built,

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@gtkx/cli",
-  "version": "2.0.0-beta.6",
-  "description": "GTK app toolchain for React: scaffold, dev server, build, docs.",
+  "version": "2.0.0-beta.7",
+  "description": "Adwaita-first GNOME app toolchain for React and TypeScript.",
   "keywords": [
     "gtkx",
     "gtk",
     "gtk4",
+    "adwaita",
+    "gnome",
     "react",
     "typescript",
     "native",
@@ -70,18 +72,18 @@
   "dependencies": {
     "@babel/core": "^8.0.1",
     "@babel/preset-typescript": "^8.0.1",
-    "@gtkx/codegen": "2.0.0-beta.6",
-    "@gtkx/config": "2.0.0-beta.6",
-    "@gtkx/mcp": "2.0.0-beta.6",
-    "@gtkx/native": "2.0.0-beta.6",
-    "@gtkx/runtime": "2.0.0-beta.6",
-    "@gtkx/utils": "2.0.0-beta.6",
-    "@gtkx/vitest": "2.0.0-beta.6",
-    "@swc/core": "^1.16.1",
+    "@gtkx/codegen": "2.0.0-beta.7",
+    "@gtkx/config": "2.0.0-beta.7",
+    "@gtkx/mcp": "2.0.0-beta.7",
+    "@gtkx/native": "2.0.0-beta.7",
+    "@gtkx/runtime": "2.0.0-beta.7",
+    "@gtkx/utils": "2.0.0-beta.7",
+    "@gtkx/vitest": "2.0.0-beta.7",
+    "@swc/core": "^1.16.2",
     "babel-plugin-react-compiler": "^1.0.0",
     "citty": "^0.2.2",
     "confbox": "^0.2.4",
-    "create-gtkx": "2.0.0-beta.6",
+    "create-gtkx": "2.0.0-beta.7",
     "fast-xml-builder": "^1.3.1",
     "fast-xml-parser": "^5.11.1",
     "hosted-git-info": "^10.1.1",
@@ -92,7 +94,7 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@gtkx/testing": "2.0.0-beta.6",
+    "@gtkx/testing": "2.0.0-beta.7",
     "@types/babel__core": "^7.20.5",
     "@types/hosted-git-info": "^3.0.5",
     "@types/react-refresh": "^0.14.7",

package/src/cli.ts

@@ -18,7 +18,7 @@ const main = defineCommand({
     meta: {
         name: "gtkx",
         version,
-        description: "CLI for GTKX: create and develop GTK4 React applications",
+        description: "CLI for GTKX: create and develop Adwaita-first GNOME applications",
     },
     subCommands: {
         dev: async () => {

package/src/codegen/freshness.ts

@@ -1,5 +1,6 @@
 import type { Config } from "@gtkx/config";
 import { resolveGirPath, resolveLibraries } from "@gtkx/codegen";
+import { resolveBoundLibraries } from "@gtkx/codegen/internal";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { type CodegenStore, resolveCodegenStore } from "./store-resolver.js";
@@ -86,7 +87,10 @@ const hasStoreExports = (storeDir: string, required: string[], forbidden: string
 };
 
 const isGiStoreStale = (store: CodegenStore, libraries: string[]): boolean => {
-    const required = [PACKAGE_EXPORT, ...libraries.map((library) => namespaceExport(library))];
+    const required = [
+        PACKAGE_EXPORT,
+        ...resolveBoundLibraries(libraries).map((library) => namespaceExport(library)),
+    ];
 
     return !hasStoreExports(store.giStoreDir, required);
 };

package/src/deploy/settings/libraries.ts

@@ -5,6 +5,7 @@ import {
     readGeneratedLibraries,
     resolveStore,
 } from "@gtkx/codegen";
+import { resolveBoundLibraries } from "@gtkx/codegen/internal";
 
 type ResolvedLibraries = {
     libraries: string[];
@@ -21,7 +22,7 @@ const generatedLibraries = (root: string): GeneratedLibraries | null => {
 
 const resolveLibraries = (root: string, config: Config): ResolvedLibraries => {
     const generated = generatedLibraries(root);
-    const libraries = generated?.libraries ?? expandLibraries(config.libraries);
+    const libraries = resolveBoundLibraries(generated?.libraries ?? expandLibraries(config.libraries));
     const deploy = config.deploy ?? {};
 
     return {

package/src/deploy/targets/flatpak-source.ts

@@ -3,6 +3,7 @@ import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { posix, relative, resolve } from "node:path";
 import type { DeployPayload, DeploySettings } from "../types.js";
 import { LOCALE_DIRNAME } from "../../i18n/catalogs.js";
+import { FONTS_DIR } from "../../internal/font-path.js";
 import { listFilesRecursive } from "../../internal/list-files.js";
 import { BUNDLE_FILENAME } from "../../vite-plugins/esm-extension.js";
 import { renderDbusService } from "../freedesktop/dbus-service.js";
@@ -68,6 +69,7 @@ const runtimeInstallCommands = (settings: DeploySettings, nodeExtensionPath: str
         "test ! -f dist/gschemas.compiled || " +
         installCommand("dist/gschemas.compiled", `${lib}/gschemas.compiled`, "m644"),
         `test ! -d dist/assets || cp -a dist/assets ${lib}/assets`,
+        `test ! -d dist/${FONTS_DIR} || cp -a dist/${FONTS_DIR} ${lib}/${FONTS_DIR}`,
         `test ! -d dist/${LOCALE_DIRNAME} || { mkdir -p ${locale} && cp -a dist/${LOCALE_DIRNAME}/. ${locale}/; }`,
         installCommand(LAUNCHER_FILENAME, `${DESTINATION}/bin/${settings.binaryName}`, "m755"),
     ];

package/src/dev/font-dir.ts

@@ -0,0 +1,16 @@
+import { stageProjectFonts } from "../internal/font-staging.js";
+import { prependXdgDataDir } from "../internal/xdg-data-dirs.js";
+
+const prepareDevFontDir = (root: string): string | null => {
+    const shareDir = stageProjectFonts(root);
+
+    if (shareDir === null) {
+        return null;
+    }
+
+    process.env.XDG_DATA_DIRS = prependXdgDataDir(shareDir, process.env.XDG_DATA_DIRS);
+
+    return shareDir;
+};
+
+export { prepareDevFontDir };

package/src/dev/runner-main.ts

@@ -2,6 +2,7 @@ import { loadConfig } from "@gtkx/config";
 import { error } from "@gtkx/utils";
 import { resolve } from "node:path";
 import { DEV_CONFIG_ENV, DEV_ENTRY_ENV } from "./entry-env.js";
+import { prepareDevFontDir } from "./font-dir.js";
 import { prepareDevIconDir } from "./icon-dir.js";
 import { prepareDevLocaleDir } from "./locale-dir.js";
 import { createDevRunner } from "./runner.js";
@@ -33,6 +34,7 @@ const main = async (): Promise<void> => {
     prepareDevLocaleDir(root, config.applicationId);
     prepareDevSchemaDir(root);
     prepareDevIconDir(root, config.applicationId, config.applicationIcon);
+    prepareDevFontDir(root);
     const entryPath = resolve(cwd, entryArg);
     const { defaultDevRunnerDeps } = await import("./runner-deps.js");
     const runner = createDevRunner(defaultDevRunnerDeps(configFile));

package/src/internal/agent-rules.ts

@@ -18,9 +18,13 @@ const TOP_LEVEL_HEADING = /^# /m;
 const rulesBody = (heading: string): string[] => [
     `${heading} GTKX`,
     "",
-    "This is not the GTK you have seen before. Most GTK code in your training data is C, PyGObject, Vala or " +
-    "GJS, and almost none of it is valid here. Check the rules below against what you are about to write.",
+    "GTKX applications are Adwaita-first, with GTK4 underneath. Most GNOME UI code in your training data is C, " +
+    "PyGObject, Vala or GJS, and almost none of it is valid here. Check the rules below against what you are " +
+    "about to write.",
     "",
+    "- Start application shells with `AdwApplication` and `AdwApplicationWindow`. Freeform windows normally use " +
+    "`AdwToolbarView` and `AdwHeaderBar`; navigation containers own their Adwaita chrome. Prefer Adwaita for " +
+    "structure, navigation, dialogs, rows, and adaptive patterns; use GTK4 for lower-level primitives.",
     "- Children are JSX, never `.append()`, `pack_start()`, `set_child()` or `add()`.",
     '- Signals are props: `onClicked`, not `widget.connect("clicked", ...)`.',
     "- Props are camelCase: `marginTop`, not `margin-top` or `margin_top`.",

package/src/internal/banner.ts

@@ -15,6 +15,10 @@ const prependBanner = (options: Rollup.OutputOptions, banner: Banner): Rollup.Ou
             const prefix = await renderBanner(banner, chunk);
             const suffix = existing === undefined ? "" : await renderBanner(existing, chunk);
 
+            if (prefix.length === 0) {
+                return suffix;
+            }
+
             return suffix.length === 0 ? prefix : `${prefix}\n${suffix}`;
         },
     };

package/src/internal/font-path.ts

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+import { basename, extname } from "node:path";
+
+const FONTS_DIR = "fonts";
+const DIGEST_LENGTH = 8;
+
+const fontFileName = (sourcePath: string, content: Buffer): string => {
+    const extension = extname(sourcePath).toLowerCase();
+    const stem = basename(sourcePath, extname(sourcePath));
+    const digest = createHash("sha1").update(content).digest("hex").slice(0, DIGEST_LENGTH);
+
+    return `${stem}-${digest}${extension}`;
+};
+
+export { fontFileName, FONTS_DIR };

package/src/internal/font-staging.ts

@@ -0,0 +1,57 @@
+import { sortStrings } from "@gtkx/utils";
+import { mkdirSync, mkdtempSync, readFileSync, symlinkSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { parseFontSpecifier } from "../vite-plugins/asset-specifier.js";
+import { fontFileName, FONTS_DIR } from "./font-path.js";
+import { discoverSourceImports, sourceDirFor, type SourceImport } from "./source-imports.js";
+import { removeTempDir } from "./staging-dir.js";
+
+const FONT_STAGING_PREFIX = "gtkx-fonts-";
+
+const isRelativeImport = (source: string): boolean => source.startsWith("./") || source.startsWith("../");
+
+const fontFileFor = ({ importer, source }: SourceImport): string | null => {
+    const specifier = parseFontSpecifier(source);
+
+    return specifier === null || !isRelativeImport(source)
+        ? null
+        : resolve(dirname(importer), specifier.assetSource);
+};
+
+const findImportedFontFiles = (imports: SourceImport[]): string[] => {
+    const files = imports
+        .map((entry) => fontFileFor(entry))
+        .filter((path): path is string => path !== null);
+
+    return sortStrings(new Set(files));
+};
+
+const stageFont = (fontsDir: string, sourcePath: string): void => {
+    const fileName = fontFileName(sourcePath, readFileSync(sourcePath));
+
+    symlinkSync(sourcePath, join(fontsDir, fileName), "file");
+};
+
+const stageProjectFonts = (root: string): string | null => {
+    const fontFiles = findImportedFontFiles(discoverSourceImports(sourceDirFor(root)));
+
+    if (fontFiles.length === 0) {
+        return null;
+    }
+
+    const shareDir = mkdtempSync(join(tmpdir(), FONT_STAGING_PREFIX));
+    mkdirSync(join(shareDir, FONTS_DIR));
+
+    for (const sourcePath of fontFiles) {
+        stageFont(join(shareDir, FONTS_DIR), sourcePath);
+    }
+
+    process.once("exit", () => {
+        removeTempDir(shareDir);
+    });
+
+    return shareDir;
+};
+
+export { stageProjectFonts };

package/src/internal/source-imports.ts

@@ -1,6 +1,6 @@
 import type { ESTree, ParseResult, ParserOptions } from "vite";
 import { sortStringsBy } from "@gtkx/utils";
-import { globSync, readFileSync } from "node:fs";
+import { existsSync, globSync, readFileSync } from "node:fs";
 import { extname, join } from "node:path";
 import { parseSync, Visitor } from "vite";
 
@@ -29,6 +29,14 @@ const sourceLanguage = (path: string): SourceLanguage | undefined => {
     return SOURCE_LANGUAGES.get(extname(path).toLowerCase());
 };
 
+const SOURCE_DIR = "src";
+
+const sourceDirFor = (root: string): string => {
+    const sourceDir = join(root, SOURCE_DIR);
+
+    return existsSync(sourceDir) ? sourceDir : root;
+};
+
 const discoverSourceFiles = (dir: string): string[] =>
     sortStringsBy(
         globSync("**/{*,.*}", {
@@ -132,4 +140,11 @@ const discoverSourceImports = (dir: string): SourceImport[] => {
     return sortStringsBy(imports, importKey);
 };
 
-export { discoverSourceFiles, discoverSourceImports, parseRuntimeImportsIn, type SourceImport, sourceLanguage };
+export {
+    discoverSourceFiles,
+    discoverSourceImports,
+    parseRuntimeImportsIn,
+    sourceDirFor,
+    sourceLanguage,
+    type SourceImport,
+};

package/src/internal/xdg-banner.ts

@@ -0,0 +1,13 @@
+import type { Rollup } from "vite";
+import { outputRootUrlExpression } from "./banner.js";
+import { XDG_DATA_DIRS_DEFAULT } from "./xdg-data-dirs.js";
+
+const xdgDataDirsBanner = (chunk: Rollup.RenderedChunk): string => [
+    "globalThis.process.env.XDG_DATA_DIRS = (() => {",
+    `    const root = ${outputRootUrlExpression(chunk)};`,
+    `    const dirs = globalThis.process.env.XDG_DATA_DIRS || ${JSON.stringify(XDG_DATA_DIRS_DEFAULT)};`,
+    "    return dirs.split(\":\").includes(root) ? dirs : `${root}:${dirs}`;",
+    "})();",
+].join("\n");
+
+export { xdgDataDirsBanner };

package/src/internal/xdg-data-dirs.ts

@@ -10,4 +10,4 @@ const prependXdgDataDir = (dir: string, existing: string | undefined): string =>
     return `${dir}:${base}`;
 };
 
-export { prependXdgDataDir };
+export { prependXdgDataDir, XDG_DATA_DIRS_DEFAULT };

package/src/settings/schema.ts

@@ -12,7 +12,7 @@ import {
 import { tmpdir } from "node:os";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { I18N_TYPES_FILENAME, i18nTypesPath } from "../i18n/types.js";
-import { discoverSourceImports, type SourceImport } from "../internal/source-imports.js";
+import { discoverSourceImports, sourceDirFor, type SourceImport } from "../internal/source-imports.js";
 import { removeTempDir } from "../internal/staging-dir.js";
 import {
     isBareRelativeAsset,
@@ -30,7 +30,6 @@ type SchemaEnvResult = {
 
 const SCHEMA_SUFFIX = ".gschema.xml";
 const STAGED_NAME_LENGTH = 16;
-const SOURCE_DIR = "src";
 const RESOURCE_QUERY = "?resource=";
 const ICON_QUERY = "?icon=";
 
@@ -69,12 +68,6 @@ const projectRelativeSchemaPath = (root: string, filePath: string): string | nul
 
 const getRelativeModuleSpecifier = (filePath: string): string => `*/${basename(filePath)}`;
 
-const sourceDirFor = (root: string): string => {
-    const sourceDir = join(root, SOURCE_DIR);
-
-    return existsSync(sourceDir) ? sourceDir : root;
-};
-
 const isRelativeImport = (source: string): boolean => source.startsWith("./") || source.startsWith("../");
 
 const schemaFileFor = ({ importer, source }: SourceImport): string | null =>

package/src/vite-plugins/asset-extensions.ts

@@ -18,6 +18,8 @@ const ASSET_EXTENSIONS = [
     "eot",
     "ttf",
     "otf",
+    "ttc",
+    "otc",
     "ico",
     "avif",
     "data",

package/src/vite-plugins/asset-imports.ts

@@ -5,6 +5,7 @@ import { ASSET_MENTION_RE } from "./asset-extensions.js";
 import {
     isAssetSpecifier,
     isUrlSpecifier,
+    parseFontSpecifier,
     parseIconSpecifier,
     parseResourceSpecifier,
 } from "./asset-specifier.js";
@@ -31,8 +32,11 @@ const RESOURCE_ADVICE =
 
 const ICON_ADVICE = "An icon asset exports only its default icon-theme name, and nothing else.";
 
+const FONT_ADVICE = "A font asset exports only its default font family name, and nothing else.";
+
 const RELATIVE_ADVICE =
-    "Add ?resource for a GResource, ?icon for a themed icon, or ?url for an emitted file.";
+    "Add ?resource for a GResource, ?icon for a themed icon, ?font for a bundled font, or ?url for an " +
+    "emitted file.";
 
 const boundName = (entry: BindingEntry): string | null => {
     const { name } = entry.importName;
@@ -87,6 +91,10 @@ const adviceFor = (source: string): string => {
         return ICON_ADVICE;
     }
 
+    if (parseFontSpecifier(source) !== null) {
+        return FONT_ADVICE;
+    }
+
     if (isUrlSpecifier(source)) {
         return QUERY_ADVICE;
     }

package/src/vite-plugins/asset-specifier.ts

@@ -11,9 +11,14 @@ type IconSpecifier = {
     iconName: string | null;
 };
 
+type FontSpecifier = {
+    assetSource: string;
+};
+
 const RELATIVE_PREFIX_RE = /^\.\.?(?:\/|$)/;
 const RESOURCE_QUERY_RE = /^resource(?:=([^&#]+))?$/;
 const ICON_QUERY_RE = /^icon(?:=([^&#]+))?$/;
+const FONT_QUERY_RE = /^font$/;
 const URL_QUERY_RE = /(?:^|&)url(?:&|$)/;
 
 const getQuery = (source: string): string | null => {
@@ -61,6 +66,17 @@ const parseIconSpecifier = (source: string): IconSpecifier | null => {
     return { assetSource, iconName: match[1] ?? null };
 };
 
+const parseFontSpecifier = (source: string): FontSpecifier | null => {
+    const query = getQuery(source);
+    const assetSource = stripQuery(source);
+
+    if (query === null || !ASSET_RE.test(assetSource) || !FONT_QUERY_RE.test(query)) {
+        return null;
+    }
+
+    return { assetSource };
+};
+
 const isUrlSpecifier = (source: string): boolean => {
     const query = getQuery(source);
 
@@ -71,6 +87,7 @@ export {
     isAssetSpecifier,
     isBareRelativeAsset,
     isUrlSpecifier,
+    parseFontSpecifier,
     parseIconSpecifier,
     parseResourceSpecifier,
 };

package/src/vite-plugins/css.ts

@@ -4,6 +4,7 @@ import { createVirtualNamespace } from "./virtual-module.js";
 
 type CssResolveContext = Parameters<typeof resolveToVirtual>[0];
 type CssResolveRequest = Parameters<typeof resolveToVirtual>[1];
+type CssLoadContext = { addWatchFile: (file: string) => void };
 
 const CSS_RE = /\.css$/i;
 const INJECT_SUFFIX = "?inject";
@@ -24,13 +25,14 @@ const resolveCssId = async (ctx: CssResolveContext, request: CssResolveRequest):
     return virtualId + INJECT_SUFFIX;
 };
 
-const loadInjectedCss = (id: string): string | undefined => {
+const loadInjectedCss = (ctx: CssLoadContext, id: string): string | undefined => {
     if (!isVirtual(id) || !id.endsWith(INJECT_SUFFIX)) {
         return;
     }
 
     const filePath = fromVirtualId(id.slice(0, -INJECT_SUFFIX.length));
     const content = readFileSync(filePath, "utf8");
+    ctx.addWatchFile(filePath);
 
     return ["import { injectGlobal } from \"@gtkx/css\";", `injectGlobal(${JSON.stringify(content)});`].join("\n");
 };
@@ -45,7 +47,7 @@ function gtkxCss(): Plugin {
         },
 
         load(id) {
-            return loadInjectedCss(id);
+            return loadInjectedCss(this, id);
         },
     };
 }