fontisan 0.2.17 → 0.2.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42bca448396aff910f6d3c92ac31bfa68afdbb85b6f9217d996d73cdbb62af5c
-  data.tar.gz: 8e3a5ad55f4c4ba9ac4430caa9447b07ef317840559b84b936cc57791470ee3b
+  metadata.gz: f84b59fae400f9db9dd05b2ddebce11bedb865138026f7a3a6d1b7ce0b3d8f2a
+  data.tar.gz: 563b27ed9dc91412fb83d7769a72a0d618109e3a6394236c7648524a60ad4fb6
 SHA512:
-  metadata.gz: de88ca7106b4934b37c0060f76f41b7972c0092a798c860cbc37795357ffdbce11089ae556f461c490c1fdd43ab48bc97ba3f1d90687abfb95fbea14d42259a7
-  data.tar.gz: 2aa4ccdca9901b1ce95eb442238530d86f24a52eae0e3eebfbd23470f3c614858b905adac85fa198fd6d3e8b66f3b6b762015575adff30bafbccd0c5c99115c7
+  metadata.gz: 7f2d94e40b9444414113ebf842a4a84e2188199829b4caf8b9e707bea6bca89c07b5e11fa04ba2f4aff1ce7ea658004385a5e2ae2ae4b4d4094d5bb90c4d5345
+  data.tar.gz: becf5ccba115f938caeb23d29e3cc0685edc9e0cb8452f8b1ed8b7e76cc8e742adcf3f9d1f5c8b1f01c1631fcb28a4ff2305068ce6b9677ef339d8f5fb4765b9

data/.rubocop.yml

@@ -114,3 +114,9 @@ Layout/LineEndStringConcatenationIndentation:
 # Bitwise AND checks with != 0 are clearer for font bitmasks
 Style/BitwisePredicate:
   Enabled: false
+
+# Allow short math-conventional parameter names in font geometry code.
+# Point#x / Point#y are domain-standard coordinate names; renaming to
+# x_coord/y_coord adds noise without aiding readers.
+Naming/MethodParameterName:
+  AllowedNames: ["x", "y", "cp", "gid", "n"]

data/.rubocop_todo.yml

@@ -1,68 +1,91 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-02 04:07:39 UTC using RuboCop version 1.86.1.
+# on 2026-06-29 07:08:46 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Gemspec/RequireMFA:
-  Exclude:
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
-
 # Offense count: 2
 Gemspec/RequiredRubyVersion:
   Exclude:
     - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
     - 'fontisan.gemspec'
 
-# Offense count: 1
+# Offense count: 21
 # This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLines:
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'lib/fontisan/hints.rb'
+    - 'lib/fontisan/models.rb'
+    - 'lib/fontisan/pipeline.rb'
+    - 'lib/fontisan/pipeline/strategies.rb'
+    - 'lib/fontisan/tables.rb'
+    - 'lib/fontisan/tables/cff.rb'
+    - 'spec/fontisan/cldr/config_spec.rb'
+    - 'spec/fontisan/cldr/unicode_set_parser_spec.rb'
+    - 'spec/fontisan/cli/cldr_cli_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
   Exclude:
-    - 'lib/fontisan/loading_modes.rb'
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'spec/fontisan/cldr/index_spec.rb'
 
-# Offense count: 4
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
-Layout/ExtraSpacing:
+Layout/BlockEndNewline:
   Exclude:
-    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'spec/fontisan/cldr/index_spec.rb'
 
-# Offense count: 1
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
-# SupportedHashRocketStyles: key, separator, table
-# SupportedColonStyles: key, separator, table
-# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
-Layout/HashAlignment:
+Layout/EmptyLines:
   Exclude:
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
+    - 'lib/fontisan/cli.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'spec/fontisan/cldr/index_spec.rb'
 
-# Offense count: 1585
+# Offense count: 1641
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 5
+# Offense count: 21
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment, EnforcedStyleForExponentOperator, EnforcedStyleForRationalLiterals.
-# SupportedStylesForExponentOperator: space, no_space
-# SupportedStylesForRationalLiterals: space, no_space
-Layout/SpaceAroundOperators:
-  Exclude:
-    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'lib/fontisan/hints.rb'
+    - 'lib/fontisan/models.rb'
+    - 'lib/fontisan/pipeline.rb'
+    - 'lib/fontisan/pipeline/strategies.rb'
+    - 'lib/fontisan/tables.rb'
+    - 'lib/fontisan/tables/cff.rb'
+    - 'spec/fontisan/cldr/config_spec.rb'
+    - 'spec/fontisan/cldr/unicode_set_parser_spec.rb'
+    - 'spec/fontisan/cli/cldr_cli_spec.rb'
 
-# Offense count: 3
+# Offense count: 2
 Lint/CopDirectiveSyntax:
   Exclude:
-    - 'lib/fontisan/converters/woff_writer.rb'
     - 'lib/fontisan/woff2_font.rb'
     - 'spec/fontisan/variation/cache_spec.rb'
 
@@ -114,28 +137,18 @@ Lint/MissingSuper:
     - 'lib/fontisan/commands/validate_command.rb'
     - 'lib/fontisan/tables/cff2/table_builder.rb'
 
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-Lint/RedundantRequireStatement:
-  Exclude:
-    - 'lib/fontisan/commands/features_command.rb'
-    - 'lib/fontisan/commands/scripts_command.rb'
-    - 'lib/fontisan/loading_modes.rb'
-    - 'lib/fontisan/variation/optimizer.rb'
-
 # Offense count: 1
 Lint/StructNewOverride:
   Exclude:
     - 'lib/fontisan/optimizers/pattern_analyzer.rb'
 
-# Offense count: 8
+# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
 Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/fontisan.rb'
-    - 'lib/fontisan/font_loader.rb'
     - 'lib/fontisan/tables/cff2/private_dict_blend_handler.rb'
     - 'lib/fontisan/utilities/brotli_wrapper.rb'
     - 'lib/fontisan/variation/table_accessor.rb'
@@ -148,12 +161,12 @@ Lint/UselessConstantScoping:
     - 'lib/fontisan/conversion_options.rb'
     - 'lib/fontisan/type1/charstrings.rb'
 
-# Offense count: 549
+# Offense count: 557
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 33
+# Offense count: 31
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
@@ -171,38 +184,32 @@ Metrics/CollectionLiteralLength:
     - 'lib/fontisan/type1/agl.rb'
     - 'lib/fontisan/type1/encodings.rb'
 
-# Offense count: 301
+# Offense count: 308
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 842
+# Offense count: 849
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 135
 
-# Offense count: 22
+# Offense count: 24
 # Configuration parameters: CountKeywordArgs.
 Metrics/ParameterLists:
   Max: 39
   MaxOptionalParameters: 4
 
-# Offense count: 229
+# Offense count: 231
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
 
-# Offense count: 24
+# Offense count: 166
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
-  Exclude:
-    - 'lib/fontisan/optimizers/subroutine_optimizer.rb'
-    - 'lib/fontisan/tables/cff2/blend_operator.rb'
-    - 'lib/fontisan/tables/glyf/curve_converter.rb'
-    - 'lib/fontisan/type1/seac_expander.rb'
-    - 'lib/fontisan/type1/ttf_to_type1_converter.rb'
-    - 'lib/fontisan/variation/optimizer.rb'
+  Enabled: false
 
 # Offense count: 13
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
@@ -241,7 +248,7 @@ Naming/VariableName:
     - 'lib/fontisan/type1/pfm_generator.rb'
     - 'lib/fontisan/type1/pfm_parser.rb'
 
-# Offense count: 113
+# Offense count: 111
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
 # SupportedStyles: snake_case, normalcase, non_integer
 # AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
@@ -264,7 +271,7 @@ RSpec/AnyInstance:
 RSpec/ContextWording:
   Enabled: false
 
-# Offense count: 27
+# Offense count: 28
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
@@ -280,7 +287,7 @@ RSpec/DescribeMethod:
     - 'spec/fontisan/type1/seac_expander_spec.rb'
     - 'spec/fontisan/type1_real_fonts_spec.rb'
 
-# Offense count: 1428
+# Offense count: 1458
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 66
@@ -357,11 +364,11 @@ RSpec/MultipleDescribes:
     - 'spec/fontisan/utils/thread_pool_spec.rb'
     - 'spec/fontisan/variation/cache_spec.rb'
 
-# Offense count: 1855
+# Offense count: 1902
 RSpec/MultipleExpectations:
   Max: 19
 
-# Offense count: 152
+# Offense count: 154
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 13
@@ -389,7 +396,7 @@ RSpec/RepeatedExample:
     - 'spec/fontisan/metrics_calculator_spec.rb'
     - 'spec/fontisan/tables/os2_spec.rb'
 
-# Offense count: 22
+# Offense count: 23
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
 # SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
@@ -425,6 +432,18 @@ Security/Open:
   Exclude:
     - 'Rakefile'
 
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
+    - 'spec/fontisan/cldr/index_spec.rb'
+
 # Offense count: 6
 # This cop supports safe autocorrection (--autocorrect).
 Style/ComparableClamp:
@@ -442,13 +461,6 @@ Style/EmptyElse:
   Exclude:
     - 'lib/fontisan/type1/seac_expander.rb'
 
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Style/ExpandPathArguments:
-  Exclude:
-    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
-
 # Offense count: 11
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, MaxUnannotatedPlaceholdersAllowed, Mode, AllowedMethods, AllowedPatterns.
@@ -466,14 +478,11 @@ Style/HashLikeCase:
     - 'lib/fontisan/commands/unpack_command.rb'
     - 'lib/fontisan/models/validation_report.rb'
 
-# Offense count: 1
+# Offense count: 9
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, EnforcedShorthandSyntax, UseHashRocketsWithSymbolValues, PreferHashRocketsForNonAlnumEndingSymbols.
-# SupportedStyles: ruby19, hash_rockets, no_mixed_keys, ruby19_no_mixed_keys
-# SupportedShorthandSyntax: always, never, either, consistent, either_consistent
-Style/HashSyntax:
+Style/MultilineIfModifier:
   Exclude:
-    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
+    - 'lib/fontisan/cldr/unicode_set_parser.rb'
 
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
@@ -481,12 +490,3 @@ Style/HashSyntax:
 Style/OptionalBooleanParameter:
   Exclude:
     - 'lib/fontisan/conversion_options.rb'
-
-# Offense count: 7
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiterals:
-  Exclude:
-    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
-    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'

data/CHANGELOG.md

@@ -7,7 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
+### Removed
+
+- Audit subsystem (`Fontisan::Audit`, `Fontisan::Commands::Audit*`,
+  `Formatters::AuditTextRenderer` / `AuditDiffTextRenderer` /
+  `LibrarySummaryTextRenderer`, `Models::Audit::*`) — moved to ucode.
+  Never had external consumers.
+- UCD/UCDXML subsystem (`Fontisan::Ucd`, `config/ucd.yml`) — moved to
+  ucode. Never released in a published gem version.
+- `fontisan audit` and `fontisan ucd` CLI subcommands.
+
+### Added (documentation)
 - Comprehensive documentation for WOFF/WOFF2 format support
 - Color fonts documentation (COLR/CPAL, sbix, SVG tables)
 - Font validation framework documentation
@@ -16,7 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated font hinting documentation
 - Enhanced README with all v0.2.1-v0.2.7 features
 
-### Changed
+### Changed (documentation)
 - Improved documentation organization with dedicated feature guides
 - Added more examples for command-line and Ruby API usage
 

data/README.adoc

@@ -61,6 +61,7 @@ Color fonts and collections::
 * Font collection validation with per-font reporting (see link:docs/COLLECTION_VALIDATION.adoc[Collection Validation Guide])
 
 Font analysis and information::
+* Comprehensive per-face font metadata extraction (replaces `otfinfo`) covering identity, style, metrics, codepoint coverage, licensing, hinting, color capabilities, variable-font detail, and OpenType layout features
 * Bidirectional font hint conversion (see link:docs/FONT_HINTING.adoc[Font Hinting Guide])
 * Extract comprehensive font metadata (name, version, designer, license, etc.)
 * Brief mode for fast font indexing (5x faster, metadata-only loading)
@@ -99,11 +100,20 @@ Font engineering::
 
 Export and interfaces::
 * TTX/YAML/JSON export (complete)
-* Command-line interface with 18 commands
+* Command-line interface with 19 commands
 * Ruby library API for programmatic access
 * Structured output in YAML, JSON, and text formats
 
 
+== Font audit
+
+[NOTE]
+====
+The `audit` and `ucd` subsystems have moved to the `ucode` gem. See
+the `ucode` documentation for the equivalent commands.
+====
+
+
 == Font information
 
 === General
@@ -2133,11 +2143,33 @@ Generating options (control how the output font is written):
 * `--optimize-tables` - Enable table optimization
 * `--decompose-on-output` - Decompose composites in output
 
+WOFF compression knobs (apply to `--to woff` only):
+
+* `--zlib-level=N` - zlib level (0–9, default 6)
+* `--uncompressed` - store tables uncompressed (legal per WOFF 1.0 §5.1)
+* `--compression-threshold=N` - skip compression for tables smaller than N bytes
+
+WOFF2 compression knobs (apply to `--to woff2` only):
+
+* `--brotli-quality=N` - Brotli quality (0–11, default 11)
+* `--transform-tables` / `--no-transform-tables` - apply glyf/loca + hmtx transformations
+
+The format selection (`--to woff` vs `--to woff2`) **is** the algorithm
+choice: WOFF mandates zlib, WOFF2 mandates Brotli. Passing a knob that
+doesn't apply to the requested target exits 1 with a clear error.
+
 [source,shell]
 ----
 # Convert with autohinting and optimization
 fontisan convert font.ttf --to otf --output font.otf \
   --autohint --hinting-mode auto --optimize-tables
+
+# Smallest WOFF2 (max Brotli + table transforms)
+fontisan convert font.ttf --to woff2 --output font.woff2 \
+  --brotli-quality 11 --transform-tables
+
+# WOFF for IE 9+ legacy reach (max zlib)
+fontisan convert font.ttf --to woff --output font.woff --zlib-level 9
 ----
 
 For detailed information on all available options and conversion scenarios,
@@ -2206,6 +2238,26 @@ tables = converter.convert(font, options: options)
 ====
 
 
+.One-shot conversion via Fontisan.convert
+[example]
+====
+[source,ruby]
+----
+require 'fontisan'
+
+# TTF → WOFF2 (modern browsers)
+Fontisan.convert('font.ttf', to: :woff2, output: 'font.woff2',
+                 brotli_quality: 11, transform_tables: true)
+
+# TTF → WOFF (IE 9+ legacy reach, max zlib)
+Fontisan.convert('font.ttf', to: :woff, output: 'font.woff', zlib_level: 9)
+
+# WOFF stored uncompressed (legal per WOFF 1.0 §5.1; useful for tooling)
+Fontisan.convert('font.ttf', to: :woff, output: 'font.woff', uncompressed: true)
+----
+====
+
+
 == Round-Trip validation
 
 === General

data/docs/.vitepress/config.ts

@@ -1,4 +1,19 @@
-import { defineConfig } from "vitepress";
+import { defineConfig, type HeadConfig } from "vitepress";
+
+const SITE_ORIGIN = "https://www.fontist.org";
+const BASE_PATH = "/fontisan/";
+const DEFAULT_DESCRIPTION =
+  "The most comprehensive font processing library for Ruby — 100% Pure Ruby, no Python, no C++, no C# dependencies.";
+const DEFAULT_OG_IMAGE = `${SITE_ORIGIN}/og-image.png`;
+
+// Map a page's source path to its canonical public URL (origin + base + clean path).
+function pathToUrl(relativePath: string): string {
+  const bare = relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
+  if (bare === "index") return `${SITE_ORIGIN}${BASE_PATH}`;
+  if (bare.endsWith("/index"))
+    return `${SITE_ORIGIN}${BASE_PATH}${bare.slice(0, -6)}/`;
+  return `${SITE_ORIGIN}${BASE_PATH}${bare}`;
+}
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
@@ -7,12 +22,29 @@ export default defineConfig({
   // https://vitepress.dev/guide/routing#generating-clean-url
   cleanUrls: true,
 
+  // Exclude standalone guide stubs that collide with directory routes.
+  // Both guide/<name>.md and guide/<name>/index.md exist for these three
+  // (hinting, validation, conversion); the directory version is the canonical
+  // one (sidebar-linked, richer content). Excluding the standalone stub from
+  // the build resolves the duplicate-route collision while keeping the source
+  // files in the repo.
+  srcExclude: [
+    "guide/hinting.md",
+    "guide/validation.md",
+    "guide/conversion.md",
+  ],
+
   title: "Fontisan",
   description:
     "The most comprehensive font processing library for Ruby — 100% Pure Ruby, no Python, no C++, no C# dependencies.",
 
   lastUpdated: true,
 
+  // https://vitepress.dev/reference/site-config#sitemap
+  sitemap: {
+    hostname: SITE_ORIGIN,
+  },
+
   // Base path for deployment (e.g., /fontisan/ for fontist.org/fontisan/)
   base: process.env.BASE_PATH || "/fontisan/",
 
@@ -29,19 +61,40 @@ export default defineConfig({
     ],
     ["link", { rel: "manifest", href: "/site.webmanifest" }],
     ["meta", { property: "og:type", content: "website" }],
-    ["meta", { property: "og:title", content: "Fontisan" }],
+    ["link", { rel: "preconnect", href: "https://fonts.googleapis.com" }],
+    ["link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossorigin: "" }],
     [
-      "meta",
+      "link",
       {
-        property: "og:description",
-        content:
-          "The most comprehensive font processing library for Ruby — 100% Pure Ruby.",
+        rel: "stylesheet",
+        href: "https://fonts.googleapis.com/css2?family=Spectral:ital,opsz,wght@0,7..72,200..800;1,7..72,200..800&family=IBM+Plex+Mono:wght@400;500&family=IBM+Plex+Sans:wght@300;400;500;600&display=swap",
       },
     ],
-    ["meta", { property: "og:image", content: "/logo-full.svg" }],
-    ["meta", { name: "twitter:card", content: "summary_large_image" }],
   ],
 
+  // Per-page og:* and twitter:* tags are derived from each page's frontmatter.
+  // https://vitepress.dev/reference/site-config#transformhead
+  transformHead(ctx) {
+    const { pageData } = ctx;
+    const url = pathToUrl(pageData.relativePath);
+    const title = pageData.title || "Fontisan";
+    const description = pageData.description || DEFAULT_DESCRIPTION;
+    const image = pageData.frontmatter.image || DEFAULT_OG_IMAGE;
+
+    const tags: HeadConfig[] = [
+      ["meta", { property: "og:title", content: title }],
+      ["meta", { property: "og:description", content: description }],
+      ["meta", { property: "og:url", content: url }],
+      ["meta", { property: "og:image", content: image }],
+      ["meta", { name: "twitter:card", content: "summary_large_image" }],
+      ["meta", { name: "twitter:title", content: title }],
+      ["meta", { name: "twitter:description", content: description }],
+      ["meta", { name: "twitter:image", content: image }],
+    ];
+
+    return tags;
+  },
+
   // https://vitepress.dev/reference/default-theme-config
   themeConfig: {
     logo: "/logo-full.svg",
@@ -210,6 +263,13 @@ export default defineConfig({
             { text: "Overview", link: "/cli/" },
           ],
         },
+        {
+          text: "Font Audit",
+          collapsed: true,
+          items: [
+            { text: "audit", link: "/cli/audit" },
+          ],
+        },
         {
           text: "Font Information",
           collapsed: true,