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

package/src/vite-plugins/font.ts

@@ -0,0 +1,147 @@
+import type { Plugin, Rollup } from "vite";
+import { readFileSync } from "node:fs";
+import { parseSync } from "vite";
+import type { AssetEmitter } from "./asset-emitter.js";
+import { prependBanner } from "../internal/banner.js";
+import { fontFileName, FONTS_DIR } from "../internal/font-path.js";
+import { sourceLanguage } from "../internal/source-imports.js";
+import { xdgDataDirsBanner } from "../internal/xdg-banner.js";
+import { parseFontSpecifier } from "./asset-specifier.js";
+import { fontFamilyNames } from "./font-name.js";
+import { stripQuery } from "./strip-query.js";
+import { createVirtualNamespace } from "./virtual-module.js";
+
+type PluginState = {
+    isBuild: boolean;
+    emitted: Set<string>;
+};
+
+type ResolveContext = Parameters<typeof resolveToVirtual>[0];
+type ResolveRequest = Parameters<typeof resolveToVirtual>[1];
+
+type RetainedFontModuleId = {
+    id: string;
+    moduleSideEffects: true;
+};
+
+type LoadContext = AssetEmitter & {
+    addWatchFile: (file: string) => void;
+    error: (message: string) => never;
+};
+
+const VIRTUAL_PREFIX = "\0gtkx-font:";
+const { isVirtual, fromVirtualId, resolveToVirtual } = createVirtualNamespace(VIRTUAL_PREFIX);
+
+const unreadableFontError = (filePath: string): string =>
+    `Cannot read a font family name from ${filePath}; ?font expects a TrueType, OpenType, ` +
+    "TrueType Collection, WOFF, or WOFF2 font";
+
+const resolveFontId = async (
+    ctx: ResolveContext,
+    request: ResolveRequest,
+): Promise<RetainedFontModuleId | undefined> => {
+    if (parseFontSpecifier(request.source) === null) {
+        return undefined;
+    }
+
+    const virtualId = await resolveToVirtual(ctx, request);
+
+    return virtualId === undefined ? undefined : { id: virtualId, moduleSideEffects: true };
+};
+
+const emitFont = (ctx: LoadContext, state: PluginState, filePath: string, content: Buffer): void => {
+    const fileName = `${FONTS_DIR}/${fontFileName(filePath, content)}`;
+
+    if (state.emitted.has(fileName)) {
+        return;
+    }
+
+    state.emitted.add(fileName);
+    ctx.emitFile({ type: "asset", fileName, source: content });
+};
+
+const loadFontModule = (ctx: LoadContext, state: PluginState, id: string): string | undefined => {
+    if (!isVirtual(id)) {
+        return undefined;
+    }
+
+    const filePath = stripQuery(fromVirtualId(id));
+    const content = readFileSync(filePath);
+    const [family] = fontFamilyNames(content);
+
+    if (family === undefined) {
+        return ctx.error(unreadableFontError(filePath));
+    }
+
+    ctx.addWatchFile(filePath);
+
+    if (state.isBuild) {
+        emitFont(ctx, state, filePath, content);
+    }
+
+    return `export default ${JSON.stringify(family)};`;
+};
+
+const hasSideEffectFontImport = (code: string, id: string): boolean => {
+    const lang = sourceLanguage(stripQuery(id));
+
+    if (lang === undefined || !code.includes("?font")) {
+        return false;
+    }
+
+    const parsed = parseSync(id, code, { lang });
+
+    if (parsed.errors.length > 0) {
+        return false;
+    }
+
+    return parsed.module.staticImports.some(
+        (statement) => statement.entries.length === 0 && parseFontSpecifier(statement.moduleRequest.value) !== null,
+    );
+};
+
+const retainSideEffectFontImport = (
+    code: string,
+    id: string,
+): { code: string; moduleSideEffects: true } | null =>
+    hasSideEffectFontImport(code, id)
+        ? { code, moduleSideEffects: true }
+        : null;
+
+const fontBanner = (state: PluginState) => (chunk: Rollup.RenderedChunk): string =>
+    state.emitted.size === 0 ? "" : xdgDataDirsBanner(chunk);
+
+function gtkxFont(): Plugin {
+    const state: PluginState = { isBuild: false, emitted: new Set() };
+
+    return {
+        name: "gtkx:font",
+        enforce: "pre",
+
+        configResolved(config) {
+            state.isBuild = config.command === "build";
+        },
+
+        resolveId(source, importer, options) {
+            return resolveFontId(this, { source, importer, options });
+        },
+
+        load(id) {
+            return loadFontModule(this, state, id);
+        },
+
+        transform(code, id) {
+            return retainSideEffectFontImport(code, id);
+        },
+
+        outputOptions(options) {
+            if (!state.isBuild) {
+                return;
+            }
+
+            return prependBanner(options, fontBanner(state));
+        },
+    };
+}
+
+export { gtkxFont };

package/src/vite-plugins/icons.ts

@@ -12,6 +12,7 @@ import {
     type ResolvedApplicationIcon,
 } from "../internal/icon-path.js";
 import { type ListedFile, listFilesRecursive } from "../internal/list-files.js";
+import { xdgDataDirsBanner } from "../internal/xdg-banner.js";
 
 type PluginState = {
     applicationId: string;
@@ -20,13 +21,6 @@ type PluginState = {
 
 const ICONS_DIR = "icons";
 
-const XDG_ENV_BANNER = [
-    "process.env.XDG_DATA_DIRS = [",
-    "    decodeURIComponent(new URL(\".\", import.meta.url).pathname),",
-    "    process.env.XDG_DATA_DIRS || \"/usr/local/share:/usr/share\",",
-    "].join(\":\");",
-].join("\n");
-
 const findIconFiles = (state: PluginState): ListedFile[] => {
     if (state.source.kind === "theme") {
         return listFilesRecursive(state.source.path);
@@ -78,7 +72,7 @@ function gtkxIcons(loadConfig: ConfigLoader = createConfigLoader()): Plugin {
                 return;
             }
 
-            return prependBanner(options, XDG_ENV_BANNER);
+            return prependBanner(options, xdgDataDirsBanner);
         },
 
         buildEnd() {

package/src/vite-plugins/index.ts

@@ -5,6 +5,7 @@ import type { BuildManifestCollector } from "../internal/build-manifest.js";
 import { gtkxAssetImports } from "./asset-imports.js";
 import { gtkxBuiltUrl } from "./built-url.js";
 import { gtkxCss } from "./css.js";
+import { gtkxFont } from "./font.js";
 import { type CatalogWriteListener, gtkxI18n } from "./i18n.js";
 import { gtkxIcons } from "./icons.js";
 import { gtkxReactCompiler } from "./react-compiler.js";
@@ -53,6 +54,7 @@ const gtkxVitePlugins = (options: GtkxVitePluginOptions = {}): Plugin[] => {
         gtkxIcons(loadConfig),
         gtkxAssetImports(),
         gtkxBuiltUrl(),
+        gtkxFont(),
         gtkxResources(loadConfig, entryPath),
         gtkxCss(),
         gtkxReactCompiler(loadConfig),

package/src/vite-plugins/resources.ts

@@ -1383,7 +1383,7 @@ const rejectInvalidSpecifier = (source: string): void => {
     if (isBareRelativeAsset(source)) {
         throw new Error(
             `${JSON.stringify(source)} must choose ?resource for a GResource, ?icon for a themed icon, ` +
-            "or ?url for an emitted file",
+            "?font for a bundled font, or ?url for an emitted file",
         );
     }
 };

package/src/vite-plugins/settings.ts

@@ -1,10 +1,10 @@
-import type { ModuleNode, Plugin, ResolvedConfig, ViteDevServer } from "vite";
+import type { ModuleNode, Plugin, ResolvedConfig, Rollup, ViteDevServer } from "vite";
 import { error, errorMessage, info, sortStrings } from "@gtkx/utils";
 import { readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import type { BuildManifestCollector } from "../internal/build-manifest.js";
 import type { AssetEmitter } from "./asset-emitter.js";
-import { prependBanner } from "../internal/banner.js";
+import { outputRootUrlExpression, prependBanner } from "../internal/banner.js";
 import { createRetainedStagingDir, type RetainedStagingDir, withStagingDir } from "../internal/staging-dir.js";
 import { compileSchemas } from "../settings/compile.js";
 import { parseSchemaXml, SchemaParseError } from "../settings/parser.js";
@@ -38,10 +38,10 @@ const SOURCE_MODULE_RE = /\.[cm]?[jt]sx?$/;
 const SCHEMA_ENV_DEBOUNCE_MS = 50;
 const { isVirtual, fromVirtualId, resolveToVirtual } = createVirtualNamespace(VIRTUAL_PREFIX);
 
-const SCHEMA_ENV_BANNER = [
-    "process.env.GSETTINGS_SCHEMA_DIR = [",
-    "    decodeURIComponent(new URL(\".\", import.meta.url).pathname),",
-    "    process.env.GSETTINGS_SCHEMA_DIR,",
+const schemaEnvBanner = (chunk: Rollup.RenderedChunk): string => [
+    "globalThis.process.env.GSETTINGS_SCHEMA_DIR = [",
+    `    ${outputRootUrlExpression(chunk)},`,
+    "    globalThis.process.env.GSETTINGS_SCHEMA_DIR,",
     "]",
     "    .filter(Boolean)",
     "    .join(\":\");",
@@ -284,7 +284,7 @@ function gtkxSettings(buildManifest?: BuildManifestCollector): Plugin {
                 return;
             }
 
-            return prependBanner(options, SCHEMA_ENV_BANNER);
+            return prependBanner(options, schemaEnvBanner);
         },
 
         async resolveId(source, importer, options) {

package/src/vite-plugins/undeclared-library.ts

@@ -20,7 +20,7 @@ type GeneratedModule = {
 };
 
 const GENERATED_MODULE_PATTERN = /^@gtkx\/(gi|jsx)\/([a-z0-9]+)$/;
-const DEFAULT_LIBRARY_NAMESPACES: Set<string> = new Set(["gtk", "adw"]);
+const DEFAULT_LIBRARY_NAMESPACES: Set<string> = new Set(["adw", "gtk"]);
 
 const girSearchPaths = async (state: PluginState): Promise<string[]> => {
     if (state.girPath === null) {
@@ -88,7 +88,7 @@ const undeclaredLibraryError = (source: string, namespace: string, girPath: stri
         return new Error(
             `Cannot resolve "${source}": the binding store has no "${namespace}" module, and no ` +
             `GIR data for it was found in [${girPath.join(", ")}]. If "${namespace}" is a library, install ` +
-            "its gobject-introspection data package. Gtk-4.0 and Adw-1 are bound by default; add only other " +
+            "its gobject-introspection data package. Adw-1 is bound by default and pulls in Gtk-4.0; add only other " +
             "GIR identifiers to `libraries` in gtkx.config.ts. Otherwise run gtkx codegen to regenerate the store.",
         );
     }
@@ -96,7 +96,7 @@ const undeclaredLibraryError = (source: string, namespace: string, girPath: stri
     if (DEFAULT_LIBRARY_NAMESPACES.has(namespace)) {
         return new Error(
             `Cannot resolve "${source}": the "${identifier}" bindings have not been generated. ` +
-            "The Gtk and Adwaita namespaces are bound by default; run gtkx dev or gtkx build again.",
+            "The Adwaita and GTK namespaces are generated implicitly; run gtkx dev or gtkx build again.",
         );
     }
 

package/src/vitest-plugin.ts

@@ -1,6 +1,7 @@
 import type { Plugin } from "vite";
 import gtkxVitest, { type PluginOptions } 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";
 
@@ -15,6 +16,7 @@ const gtkx = (options: PluginOptions = {}): Plugin[] => [
     gtkxEnsureStore(options.configFile),
     ...gtkxVitePlugins({ configFile: options.configFile }),
     gtkxSettingsWorkerEnv(options.configFile),
+    gtkxFontWorkerEnv(options.configFile),
     gtkxVitest(options),
 ];