@quartz-community/quartz-fonts 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial Quartz community plugin template.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quartz Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+# @quartz-community/fonts
+
+Fine-grained font control for Quartz sites. Supports per-heading fonts, automatic theme font discovery via [QuartzTheme](https://github.com/saberzero1/quartz-themes), and Obsidian-compatible defaults.
+
+## Installation
+
+```bash
+npx quartz plugin add github:quartz-community/fonts
+```
+
+## Usage
+
+```yaml title="quartz.config.yaml"
+plugins:
+  - source: github:quartz-community/fonts
+    enabled: true
+```
+
+With custom fonts:
+
+```yaml title="quartz.config.yaml"
+plugins:
+  - source: github:quartz-community/fonts
+    enabled: true
+    options:
+      body: '"Inter", sans-serif'
+      header: '"Playfair Display", serif'
+      code: '"JetBrains Mono", monospace'
+```
+
+## Configuration
+
+Font options accept either a CSS font-family string or an object with Google Fonts loading control:
+
+```yaml
+# String form
+body: '"Inter", sans-serif'
+
+# Object form (for Google Fonts weight/italic control)
+body:
+  name: Inter
+  weights: [400, 600, 700]
+  includeItalic: true
+```
+
+| Option          | Type                | Default          | Description                                                               |
+| --------------- | ------------------- | ---------------- | ------------------------------------------------------------------------- |
+| `title`         | `FontSpecification` | `header` value   | Font family for the site title.                                           |
+| `body`          | `FontSpecification` | Obsidian default | Font family for body text.                                                |
+| `header`        | `FontSpecification` | Obsidian default | Default font family for all headings (h1-h6).                             |
+| `code`          | `FontSpecification` | Obsidian default | Font family for code and monospace elements.                              |
+| `interface`     | `FontSpecification` | Obsidian default | Font family for UI elements.                                              |
+| `h1`            | `FontSpecification` | `header` value   | Font family for h1 headings.                                              |
+| `h2`            | `FontSpecification` | `header` value   | Font family for h2 headings.                                              |
+| `h3`            | `FontSpecification` | `header` value   | Font family for h3 headings.                                              |
+| `h4`            | `FontSpecification` | `header` value   | Font family for h4 headings.                                              |
+| `h5`            | `FontSpecification` | `header` value   | Font family for h5 headings.                                              |
+| `h6`            | `FontSpecification` | `header` value   | Font family for h6 headings.                                              |
+| `useThemeFonts` | `boolean`           | `true`           | Use fonts from QuartzTheme as defaults when it is installed.              |
+| `fontOrigin`    | `string`            | `"local"`        | `"googleFonts"` to auto-load from Google Fonts, `"local"` for no loading. |
+
+### Default options
+
+```yaml title="quartz.config.yaml"
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    useThemeFonts: true
+    fontOrigin: local
+```
+
+## How it works
+
+Fonts resolves fonts using a priority chain:
+
+```
+User config (plugin options)
+  -> Theme fonts (from QuartzTheme, if installed)
+    -> Obsidian defaults (system font stacks)
+```
+
+For individual headings, the resolution is:
+
+```
+h1 option -> header option -> theme --h1-font -> theme font -> Obsidian default
+```
+
+For the site title:
+
+```
+title option -> header option -> theme font -> Obsidian default
+```
+
+### With QuartzTheme
+
+When [QuartzTheme](https://github.com/saberzero1/quartz-themes) is installed and runs before Fonts, theme fonts are automatically discovered and used as defaults. Any options you set in Fonts will override the theme fonts.
+
+Fonts must run after QuartzTheme. This is handled automatically by `defaultOrder` (QuartzTheme = 50, Fonts = 60).
+
+### Without QuartzTheme
+
+Fonts works standalone. Without a theme, it falls back to Obsidian's default system font stacks.
+
+## Examples
+
+```yaml title="quartz.config.yaml"
+# Use theme fonts automatically (default behavior)
+- source: github:quartz-community/fonts
+  enabled: true
+
+# Override just the heading font
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    header: '"Playfair Display", serif'
+
+# Full control with per-heading fonts
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    body: '"Inter", sans-serif'
+    header: '"Playfair Display", serif'
+    code: '"JetBrains Mono", monospace'
+    h1: '"Playfair Display", serif'
+    h2: '"Lora", serif'
+
+# Load from Google Fonts automatically
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    fontOrigin: googleFonts
+    body: Inter
+    header: Playfair Display
+    code: JetBrains Mono
+
+# Google Fonts with weight/italic control
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    fontOrigin: googleFonts
+    body:
+      name: Inter
+      weights: [400, 600, 700]
+      includeItalic: true
+    header:
+      name: Playfair Display
+      weights: [400, 700]
+    code:
+      name: JetBrains Mono
+      weights: [400]
+
+# Custom title font (separate from header)
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    fontOrigin: googleFonts
+    title: Abril Fatface
+    header: Playfair Display
+    body: Inter
+    code: JetBrains Mono
+
+# Ignore theme fonts entirely
+- source: github:quartz-community/fonts
+  enabled: true
+  options:
+    useThemeFonts: false
+    body: '"Inter", sans-serif'
+```
+
+## Google Fonts Validation
+
+When `fontOrigin: googleFonts` is set and the optional [`google-font-metadata`](https://www.npmjs.com/package/google-font-metadata) package is installed, Fonts validates your font configuration at build time:
+
+- Checks that font family names exist in Google Fonts.
+- Warns if requested weights are not available for a font.
+- Warns if italic is requested but the font doesn't support it.
+
+Install it to enable validation:
+
+```bash
+npm install google-font-metadata
+```
+
+Validation warnings are logged to the console but do not block the build.
+
+## Documentation
+
+See the [Quartz documentation](https://quartz.jzhao.xyz/plugins/Fonts) for more information.
+
+## License
+
+MIT

package/dist/emitter.d.ts

@@ -0,0 +1,6 @@
+import { QuartzEmitterPlugin } from '@quartz-community/types';
+import { FontsOptions } from './types.js';
+
+declare const FontsEmitter: QuartzEmitterPlugin<Partial<FontsOptions>>;
+
+export { FontsEmitter };

package/dist/emitter.js

@@ -0,0 +1,147 @@
+import { createRequire } from 'module';
+import fs from 'fs';
+import path from 'path';
+
+createRequire(import.meta.url);
+
+// src/defaults.ts
+var DEFAULT_WEIGHTS = {
+  title: [400, 700],
+  header: [400, 700],
+  body: [400, 600],
+  code: [400, 600]
+};
+var DEFAULT_ITALIC = {
+  title: false,
+  header: false,
+  body: true,
+  code: false
+};
+
+// src/util/google-fonts.ts
+function normalizeFontSpec(spec) {
+  return typeof spec === "string" ? { name: spec } : spec;
+}
+function mergeInto(map, role, spec) {
+  const { name, weights, includeItalic } = normalizeFontSpec(spec);
+  const resolvedWeights = weights ?? DEFAULT_WEIGHTS[role];
+  const italic = includeItalic ?? DEFAULT_ITALIC[role];
+  const existing = map.get(name);
+  if (existing) {
+    for (const w of resolvedWeights) existing.weights.add(w);
+    if (italic) existing.italic = true;
+  } else {
+    map.set(name, { name, weights: new Set(resolvedWeights), italic });
+  }
+}
+function formatMergedEntry(entry) {
+  const sortedWeights = [...entry.weights].sort((a, b) => a - b);
+  const features = [];
+  if (entry.italic) {
+    features.push("ital");
+  }
+  if (sortedWeights.length > 1) {
+    const weightSpec = entry.italic ? sortedWeights.flatMap((w) => [`0,${w}`, `1,${w}`]).sort().join(";") : sortedWeights.join(";");
+    features.push(`wght@${weightSpec}`);
+  }
+  if (features.length > 0) {
+    return `${entry.name}:${features.join(",")}`;
+  }
+  return entry.name;
+}
+function googleFontHref(fonts) {
+  const merged = /* @__PURE__ */ new Map();
+  mergeInto(merged, "header", fonts.header);
+  mergeInto(merged, "body", fonts.body);
+  mergeInto(merged, "code", fonts.code);
+  if (fonts.title) {
+    mergeInto(merged, "title", fonts.title);
+  }
+  const families = [...merged.values()].map(formatMergedEntry);
+  const params = families.map((f) => `family=${encodeURIComponent(f)}`).join("&");
+  return `https://fonts.googleapis.com/css2?${params}&display=swap`;
+}
+
+// src/util/process-fonts.ts
+var fontMimeMap = {
+  truetype: "ttf",
+  woff: "woff",
+  woff2: "woff2",
+  opentype: "otf"
+};
+var fontUrlPattern = /url\((https:\/\/fonts.gstatic.com\/.+(?:\/|(?:kit=))(.+?)[.&].+?)\)\sformat\('(\w+?)'\);/g;
+function processGoogleFonts(stylesheet, baseUrl) {
+  const fontFiles = [];
+  const processedStylesheet = stylesheet.replace(
+    fontUrlPattern,
+    (match, url, filename, format) => {
+      const extension = fontMimeMap[format] ?? format;
+      const rewrittenUrl = `https://${baseUrl}/static/fonts/${filename}.${extension}`;
+      fontFiles.push({ url, filename, extension });
+      return match.replace(url, rewrittenUrl);
+    }
+  );
+  return { processedStylesheet, fontFiles };
+}
+
+// src/emitter.ts
+var QUARTZ_DEFAULT_HEADER = "Schibsted Grotesk";
+var QUARTZ_DEFAULT_BODY = "Source Sans Pro";
+var QUARTZ_DEFAULT_CODE = "IBM Plex Mono";
+var defaultOptions = {
+  useThemeFonts: true,
+  fontOrigin: "googleFonts"
+};
+var FontsEmitter = (userOptions) => {
+  const options = { ...defaultOptions, ...userOptions };
+  return {
+    name: "FontsEmitter",
+    async *emit(ctx, _content, _resources) {
+      if (options.fontOrigin !== "selfHosted") {
+        return;
+      }
+      const baseUrl = ctx.cfg.configuration.baseUrl;
+      if (!baseUrl) {
+        throw new Error("[FontsEmitter] baseUrl is required for selfHosted fonts.");
+      }
+      const headerSpec = options.header ?? QUARTZ_DEFAULT_HEADER;
+      const bodySpec = options.body ?? QUARTZ_DEFAULT_BODY;
+      const codeSpec = options.code ?? QUARTZ_DEFAULT_CODE;
+      const href = googleFontHref({
+        title: options.title,
+        header: headerSpec,
+        body: bodySpec,
+        code: codeSpec
+      });
+      const cssResponse = await fetch(href);
+      if (!cssResponse.ok) {
+        throw new Error(
+          `[FontsEmitter] Failed to fetch Google Fonts CSS: ${cssResponse.status} ${cssResponse.statusText}`
+        );
+      }
+      const cssText = await cssResponse.text();
+      const { processedStylesheet, fontFiles } = processGoogleFonts(cssText, baseUrl);
+      const fontsDir = path.join(ctx.argv.output, "static", "fonts");
+      await fs.promises.mkdir(fontsDir, { recursive: true });
+      for (const fontFile of fontFiles) {
+        const fontResponse = await fetch(fontFile.url);
+        if (!fontResponse.ok) {
+          throw new Error(
+            `[FontsEmitter] Failed to fetch font file: ${fontFile.url} (${fontResponse.status} ${fontResponse.statusText})`
+          );
+        }
+        const buf = await fontResponse.arrayBuffer();
+        const filePath = path.join(fontsDir, `${fontFile.filename}.${fontFile.extension}`);
+        await fs.promises.writeFile(filePath, Buffer.from(buf));
+        yield filePath;
+      }
+      const cssPath = path.join(fontsDir, "quartz-fonts.css");
+      await fs.promises.writeFile(cssPath, processedStylesheet);
+      yield cssPath;
+    }
+  };
+};
+
+export { FontsEmitter };
+//# sourceMappingURL=emitter.js.map
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/defaults.ts","../src/util/google-fonts.ts","../src/util/process-fonts.ts","../src/emitter.ts"],"names":[],"mappings":"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","file":"emitter.js","sourcesContent":["export const OBSIDIAN_SANS_STACK =\n  'ui-sans-serif, -apple-system, BlinkMacSystemFont, system-ui, \"Segoe UI\", Roboto, \"Inter\", \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", sans-serif';\n\nexport const OBSIDIAN_MONO_STACK =\n  'ui-monospace, SFMono-Regular, \"Cascadia Mono\", \"Roboto Mono\", \"DejaVu Sans Mono\", \"Liberation Mono\", Menlo, Monaco, \"Consolas\", \"Source Code Pro\", monospace';\n\nexport type FontRole = \"title\" | \"header\" | \"body\" | \"code\";\n\nexport const DEFAULT_WEIGHTS: Record<FontRole, number[]> = {\n  title: [400, 700],\n  header: [400, 700],\n  body: [400, 600],\n  code: [400, 600],\n};\n\nexport const DEFAULT_ITALIC: Record<FontRole, boolean> = {\n  title: false,\n  header: false,\n  body: true,\n  code: false,\n};\n","import type { FontSpecification } from \"../types\";\nimport type { FontRole } from \"../defaults\";\nimport { DEFAULT_WEIGHTS, DEFAULT_ITALIC } from \"../defaults\";\n\nfunction normalizeFontSpec(spec: FontSpecification): {\n  name: string;\n  weights?: number[];\n  includeItalic?: boolean;\n} {\n  return typeof spec === \"string\" ? { name: spec } : spec;\n}\n\nexport function getFontName(spec: FontSpecification): string {\n  return typeof spec === \"string\" ? spec : spec.name;\n}\n\nexport function formatFontSpecification(role: FontRole, spec: FontSpecification): string {\n  const { name, weights, includeItalic } = normalizeFontSpec(spec);\n\n  const resolvedWeights = weights ?? DEFAULT_WEIGHTS[role];\n  const italic = includeItalic ?? DEFAULT_ITALIC[role];\n\n  const features: string[] = [];\n  if (italic) {\n    features.push(\"ital\");\n  }\n\n  if (resolvedWeights.length > 1) {\n    const weightSpec = italic\n      ? resolvedWeights\n          .flatMap((w) => [`0,${w}`, `1,${w}`])\n          .sort()\n          .join(\";\")\n      : resolvedWeights.join(\";\");\n\n    features.push(`wght@${weightSpec}`);\n  }\n\n  if (features.length > 0) {\n    return `${name}:${features.join(\",\")}`;\n  }\n\n  return name;\n}\n\ninterface MergedFontEntry {\n  name: string;\n  weights: Set<number>;\n  italic: boolean;\n}\n\nfunction mergeInto(\n  map: Map<string, MergedFontEntry>,\n  role: FontRole,\n  spec: FontSpecification,\n): void {\n  const { name, weights, includeItalic } = normalizeFontSpec(spec);\n  const resolvedWeights = weights ?? DEFAULT_WEIGHTS[role];\n  const italic = includeItalic ?? DEFAULT_ITALIC[role];\n\n  const existing = map.get(name);\n  if (existing) {\n    for (const w of resolvedWeights) existing.weights.add(w);\n    if (italic) existing.italic = true;\n  } else {\n    map.set(name, { name, weights: new Set(resolvedWeights), italic });\n  }\n}\n\nfunction formatMergedEntry(entry: MergedFontEntry): string {\n  const sortedWeights = [...entry.weights].sort((a, b) => a - b);\n  const features: string[] = [];\n\n  if (entry.italic) {\n    features.push(\"ital\");\n  }\n\n  if (sortedWeights.length > 1) {\n    const weightSpec = entry.italic\n      ? sortedWeights\n          .flatMap((w) => [`0,${w}`, `1,${w}`])\n          .sort()\n          .join(\";\")\n      : sortedWeights.join(\";\");\n    features.push(`wght@${weightSpec}`);\n  }\n\n  if (features.length > 0) {\n    return `${entry.name}:${features.join(\",\")}`;\n  }\n  return entry.name;\n}\n\nexport function googleFontHref(fonts: {\n  title?: FontSpecification;\n  header: FontSpecification;\n  body: FontSpecification;\n  code: FontSpecification;\n}): string {\n  const merged = new Map<string, MergedFontEntry>();\n\n  mergeInto(merged, \"header\", fonts.header);\n  mergeInto(merged, \"body\", fonts.body);\n  mergeInto(merged, \"code\", fonts.code);\n\n  if (fonts.title) {\n    mergeInto(merged, \"title\", fonts.title);\n  }\n\n  const families = [...merged.values()].map(formatMergedEntry);\n  const params = families.map((f) => `family=${encodeURIComponent(f)}`).join(\"&\");\n  return `https://fonts.googleapis.com/css2?${params}&display=swap`;\n}\n","import type { ProcessedFontResult, GoogleFontFile } from \"../types\";\n\nconst fontMimeMap: Record<string, string> = {\n  truetype: \"ttf\",\n  woff: \"woff\",\n  woff2: \"woff2\",\n  opentype: \"otf\",\n};\n\nconst fontUrlPattern =\n  /url\\((https:\\/\\/fonts.gstatic.com\\/.+(?:\\/|(?:kit=))(.+?)[.&].+?)\\)\\sformat\\('(\\w+?)'\\);/g;\n\nexport function processGoogleFonts(stylesheet: string, baseUrl: string): ProcessedFontResult {\n  const fontFiles: GoogleFontFile[] = [];\n\n  const processedStylesheet = stylesheet.replace(\n    fontUrlPattern,\n    (match, url: string, filename: string, format: string) => {\n      const extension = fontMimeMap[format] ?? format;\n      const rewrittenUrl = `https://${baseUrl}/static/fonts/${filename}.${extension}`;\n      fontFiles.push({ url, filename, extension });\n      return match.replace(url, rewrittenUrl);\n    },\n  );\n\n  return { processedStylesheet, fontFiles };\n}\n","import fs from \"fs\";\nimport path from \"path\";\nimport type { QuartzEmitterPlugin, BuildCtx, FilePath } from \"@quartz-community/types\";\nimport type { FontsOptions } from \"./types\";\nimport { googleFontHref } from \"./util/google-fonts\";\nimport { processGoogleFonts } from \"./util/process-fonts\";\n\nconst QUARTZ_DEFAULT_HEADER = \"Schibsted Grotesk\";\nconst QUARTZ_DEFAULT_BODY = \"Source Sans Pro\";\nconst QUARTZ_DEFAULT_CODE = \"IBM Plex Mono\";\n\nconst defaultOptions: FontsOptions = {\n  useThemeFonts: true,\n  fontOrigin: \"googleFonts\",\n};\n\nexport const FontsEmitter: QuartzEmitterPlugin<Partial<FontsOptions>> = (\n  userOptions?: Partial<FontsOptions>,\n) => {\n  const options: FontsOptions = { ...defaultOptions, ...userOptions };\n\n  return {\n    name: \"FontsEmitter\",\n    async *emit(ctx: BuildCtx, _content: unknown[], _resources: unknown): AsyncGenerator<FilePath> {\n      if (options.fontOrigin !== \"selfHosted\") {\n        return;\n      }\n\n      const baseUrl = ctx.cfg.configuration.baseUrl;\n      if (!baseUrl) {\n        throw new Error(\"[FontsEmitter] baseUrl is required for selfHosted fonts.\");\n      }\n\n      const headerSpec = options.header ?? QUARTZ_DEFAULT_HEADER;\n      const bodySpec = options.body ?? QUARTZ_DEFAULT_BODY;\n      const codeSpec = options.code ?? QUARTZ_DEFAULT_CODE;\n\n      const href = googleFontHref({\n        title: options.title,\n        header: headerSpec,\n        body: bodySpec,\n        code: codeSpec,\n      });\n\n      const cssResponse = await fetch(href);\n      if (!cssResponse.ok) {\n        throw new Error(\n          `[FontsEmitter] Failed to fetch Google Fonts CSS: ${cssResponse.status} ${cssResponse.statusText}`,\n        );\n      }\n      const cssText = await cssResponse.text();\n\n      const { processedStylesheet, fontFiles } = processGoogleFonts(cssText, baseUrl);\n\n      const fontsDir = path.join(ctx.argv.output, \"static\", \"fonts\");\n      await fs.promises.mkdir(fontsDir, { recursive: true });\n\n      for (const fontFile of fontFiles) {\n        const fontResponse = await fetch(fontFile.url);\n        if (!fontResponse.ok) {\n          throw new Error(\n            `[FontsEmitter] Failed to fetch font file: ${fontFile.url} (${fontResponse.status} ${fontResponse.statusText})`,\n          );\n        }\n        const buf = await fontResponse.arrayBuffer();\n        const filePath = path.join(fontsDir, `${fontFile.filename}.${fontFile.extension}`);\n        await fs.promises.writeFile(filePath, Buffer.from(buf));\n        yield filePath as FilePath;\n      }\n\n      const cssPath = path.join(fontsDir, \"quartz-fonts.css\");\n      await fs.promises.writeFile(cssPath, processedStylesheet);\n      yield cssPath as FilePath;\n    },\n  };\n};\n"]}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { QuartzTransformerPlugin } from '@quartz-community/types';
+export { QuartzEmitterPlugin, QuartzTransformerPlugin } from '@quartz-community/types';
+import { FontsOptions } from './types.js';
+export { FontFileEntry, FontSpecification, GoogleFontFile, ProcessedFontResult, QuartzFontRegistry } from './types.js';
+export { FontsEmitter } from './emitter.js';
+
+declare const Fonts: QuartzTransformerPlugin<Partial<FontsOptions>>;
+
+export { Fonts, FontsOptions };