fontist 3.0.10 → 3.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0b0e99691434acdede0ea1ef18c07f326e07b0a62b57fd5cae59c218e3991e5
-  data.tar.gz: 23c928be6bf6344d49f2e9bc93b36c038b3d3ee0d9e388a62ef4427862ad739f
+  metadata.gz: 8be7d98f9f421275a9d89981c7519a92dc76da79c37f9a600b0ae7af89a2fe90
+  data.tar.gz: 7a83154879381549601dbe394abb263d1f6044e327570beece2879a00a023eb4
 SHA512:
-  metadata.gz: e28c80e58cef62db2b64280a1168e840a83849dd99e233f28b25b63f6b1719bfb368d3d72d6880a9c37026ed5d91cf96f0b74cf53188a3bb7ba52fe4894eb5ca
-  data.tar.gz: 25a14d68e16d69f3378480e55ab232f60fcae8b727633ba542944bfed4a2fbb6f192b9ac00f49baacbb937270db4ba1c67082c0e6e8402c16a6b88ae2d1f1030
+  metadata.gz: 9313ca1bfaac860c55067e71810715c40d2967d064900b3d9e26a8a5b84f32614eed57cfd4fb9c64d7c67ebb1ce7bf4fd05a06ba208fa35c6735dc903687927d
+  data.tar.gz: 76f717efb9f83ad90cea7286a47599ac90c423382909c8c503ed07b8e7e42252c28fefdb486f17ad6185b4dc5b8d3792e4c8e74914c31affeaae9b7012532be7

data/docs/.vitepress/config.ts

@@ -18,14 +18,6 @@ function pathToUrl(relativePath: string): string {
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
-  // Register custom components
-  vite: {
-    resolve: {
-      alias: {
-        "@components": fileURLToPath(new URL("../components", import.meta.url)),
-      },
-    },
-  },
   lang: "en-US",
 
   // https://vitepress.dev/guide/routing#generating-clean-url

data/docs/cli/create-formula.md

@@ -23,6 +23,7 @@ fontist create-formula URL [options]
 | `--subdir` | string | Subdirectory to extract fonts from |
 | `--file-pattern` | string | File pattern to match (e.g., "*.otf") |
 | `--name-prefix` | string | Prefix for font family names |
+| `--schema-version N | numeric | Formula schema version (default: 5) |
 
 ## Examples
 

data/docs/cli/index.md

@@ -18,12 +18,12 @@ Complete command-line interface reference for Fontist.
 | Command | Description |
 |---------|-------------|
 | [`fontist manifest`](/cli/manifest) | Manifest management |
-| [`fontist index`](/cli/index-cmd) | System font index |
 | [`fontist cache`](/cli/cache) | Cache management |
 | [`fontist config`](/cli/config) | Configuration |
 | [`fontist repo`](/cli/repo) | Custom repositories |
 | [`fontist fontconfig`](/cli/fontconfig) | Fontconfig integration |
 | [`fontist import`](/cli/import) | Import fonts |
+| [`fontist index`](/cli/index-cmd) | System font index |
 | [`fontist create-formula`](/cli/create-formula) | Create formulas |
 
 ## Global Options
@@ -32,11 +32,12 @@ These options work with all commands:
 
 | Option | Description |
 |--------|-------------|
-| `--quiet` | Suppress output |
-| `--verbose` | Enable verbose output |
-| `--debug` | Enable debug output |
-| `--color` | Force colored output |
-| `--no-color` | Disable colored output |
+| `--preferred-family` | Use preferred family when available |
+| `--quiet` `-q` | Suppress output |
+| `--verbose` `-v` | Enable verbose output |
+| `--no-cache` `-c` | Avoid using cache during download
+| `--[no-]interactive` `-i` | Interactive mode (default: true) |
+| `--formulas-path PATH` | Path to formulas |
 
 ## Environment Variables
 

data/docs/cli/install.md

@@ -16,13 +16,58 @@ fontist install FONT... [options]
 
 ## Options
 
-<CliOptions command="install" />
+| Option | Alias | Type | Description |
+|--------|-------|------|-------------|
+| `--force` | `-f` | boolean | Install even if already installed in system |
+| `--formula` | `-F` | boolean | Install whole formula instead of a font |
+| `--accept-all-licenses` | `-a` | boolean | Accept all license agreements |
+| `--hide-licenses` | `-h` | boolean | Hide license texts |
+| `--no-progress` | `-p` | boolean | Hide download progress |
+| `--version` | `-V` | string | Specify particular version of a font |
+| `--smallest` | `-s` | boolean | Install the smallest font by file size if several |
+| `--newest` | `-n` | boolean | Install the newest version of a font if several |
+| `--size-limit` | `-S` | numeric | Specify upper limit for file size of a formula to be installed (default: 500 MB) |
+| `--update-fontconfig` | `-u` | boolean | Update fontconfig |
+| `--location` | `-l` | string | Install location: `fontist` (default), `user`, `system` |
+| `--format FORMAT` | | string | Font format to install (ttf, otf, woff, woff2, ttc, otc). If format not available, will transcode from available formats
+| `--variable-axes` | | string | Variable axes to match (comma-separated, e.g., 'wght,wdth') |
+| `--prefer-variable` | | boolean | Prefer variable fonts over static fonts |
+| `--prefer-format FORMAT` | | string | Preferred format when multiple available
+| `--transcode-path PATH` | | string | Directory to save transcoded fonts (default: same as install location)
+| `--keep-original` | | boolean | Keep original font after transcoding. (default: true)
+| `--collection-index N` | | numeric | Extract specific font from TTC/OTC collection (0-indexed)
+
+
 
 ## Examples
 
-<CliExamples command="install" />
+### Common uses
+
+```sh
+# Install a single font
+fontist install "Roboto"
+
+# Install multiple fonts
+fontist install "Fira Code" "Open Sans"
+
+# Force reinstall
+fontist install "Roboto" --force
+
+# Install to user directory
+fontist install "Roboto" --location user
+
+# Accept licenses automatically (for CI)
+fontist install "Roboto" --accept-all-licenses --hide-licenses
+
+# Install a specific version
+fontist install "Roboto" --version 2.0
+
+# Install whole formula
+fontist install "Roboto" --formula
+```
+
 
-## Multi-font Installation
+### Multi-font Installation
 
 You can install multiple fonts at once:
 
@@ -35,7 +80,7 @@ When installing multiple fonts, Fontist will:
 - Report successes and failures separately
 - Return appropriate exit code based on results
 
-## Install Locations
+### Install Locations
 
 The `--location` option controls where fonts are installed:
 

data/docs/package-lock.json

@@ -7,7 +7,7 @@
       "devDependencies": {
         "@types/node": "^22.15.0",
         "prettier": "^3.8.1",
-        "typescript": "^5.9.3",
+        "typescript": "^5.9.0",
         "vitepress": "^1.6.4"
       }
     },
@@ -2050,9 +2050,9 @@
       "license": "ISC"
     },
     "node_modules/postcss": {
-      "version": "8.5.8",
-      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz",
-      "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==",
+      "version": "8.5.13",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.13.tgz",
+      "integrity": "sha512-qif0+jGGZoLWdHey3UFHHWP0H7Gbmsk8T5VEqyYFbWqPr1XqvLGBbk/sl8V5exGmcYJklJOhOQq1pV9IcsiFag==",
       "dev": true,
       "funding": [
         {

data/lib/fontist/cli.rb

@@ -23,7 +23,7 @@ module Fontist
     STATUS_FORMULA_NOT_FOUND = 13
     STATUS_FONTCONFIG_NOT_FOUND = 14
     STATUS_FONTCONFIG_FILE_NOT_FOUND = 15
-    STATUS_FONTIST_VERSION_ERROR = 15
+    STATUS_FONTIST_VERSION_ERROR = 17
     STATUS_INVALID_CONFIG_ATTRIBUTE = 16
 
     ERROR_TO_STATUS = {

data/lib/fontist/import_cli.rb

@@ -125,7 +125,7 @@ module Fontist
     desc "sil", "Import formulas from SIL International"
     option :output_path,
            type: :string,
-           desc: "Output directory for generated formulas (default: ~/.fontist/versions/v4/formulas/Formulas/sil)"
+           desc: "Output directory for generated formulas (default: ~/.fontist/versions/v5/formulas/Formulas/sil)"
     option :font_name,
            type: :string, aliases: :f,
            desc: "Import specific font by name (optional)"

data/lib/fontist/utils/downloader.rb

@@ -1,6 +1,16 @@
+require "time"
+
 module Fontist
   module Utils
     class Downloader
+      RATE_LIMITED_HTTP_STATUS = 429
+      BACKOFF = {
+        rate_limited: [10, 20, 40, 60, 90].freeze,
+        transient: [2, 4].freeze,
+      }.freeze
+      MAX_RETRY_AFTER = 120
+      JITTER_RATIO = 0.25
+
       class << self
         def download(*args)
           new(*args).download
@@ -22,6 +32,7 @@ module Fontist
         @verbose = progress_bar == :verbose
         @use_content_length = use_content_length
         @cache = Cache.new(cache_path: cache_path)
+        @tries = Hash.new(0)
       end
 
       def download
@@ -91,32 +102,85 @@ module Fontist
       end
 
       def download_file
-        @tries ||= 0
-        @tries += 1
         print_download_start if @verbose
         do_download_file
       rescue Down::Error => e
-        retry if retry_download?
+        retry if retry_download?(e)
 
         raise Fontist::Errors::InvalidResourceError,
               "Invalid URL: #{@file}. Error: #{e.inspect}."
       end
 
-      def retry_download?
-        return false unless @tries < max_retries
+      def retry_download?(error)
+        response = http_response(error)
+        requested = retry_after(response)
+        backing_off = requested || rate_limited?(response)
+        kind = backing_off ? :rate_limited : :transient
+        delays = BACKOFF.fetch(kind)
+        attempt = (@tries[kind] += 1)
+        return false if attempt > delays.length
 
-        sleep(backoff_time(@tries))
+        wait(kind, requested || jitter(delays[attempt - 1]))
         true
       end
 
-      def max_retries
-        @max_retries ||= 3
+      def wait(kind, seconds)
+        reason = if kind == :rate_limited
+                   "Server asked us to slow down"
+                 else
+                   "Download failed"
+                 end
+
+        Fontist.ui.say("#{reason}. Retrying in #{seconds}s...")
+        sleep(seconds)
+      end
+
+      # Spread retrying clients apart so they do not all return at once.
+      # Rounding the bound rather than the draw keeps the smallest delays
+      # spread too. Drawing first and rounding after loses them: a two second
+      # delay scales to half a second, and any fraction of that rounds to
+      # nothing, so every client would return at exactly two seconds.
+      def jitter(seconds)
+        seconds + rand(0..(seconds * JITTER_RATIO).round)
+      end
+
+      # down attaches the response to status errors, but its redirect errors
+      # pass `response:` as a keyword to a keyword-less initializer (5.4.2), so
+      # those carry a Hash instead. Requiring both methods we go on to use drops
+      # the Hash, and drops any backend we could not read a status or header
+      # from, which then falls back to the transient policy.
+      def http_response(error)
+        return unless error.is_a?(Down::ResponseError)
+
+        response = error.response
+        response if response.respond_to?(:code) && response.respond_to?(:[])
+      end
+
+      def rate_limited?(response)
+        response && response.code.to_i == RATE_LIMITED_HTTP_STATUS
       end
 
-      def backoff_time(attempt)
-        # Exponential backoff: 2^attempt seconds, max 30 seconds
-        # 1st retry: 2s, 2nd: 4s, 3rd: 8s
-        [2**attempt, 30].min
+      # nil unless the server asked for a wait we can use.
+      def retry_after(response)
+        return unless response
+
+        seconds = retry_after_seconds(response["Retry-After"])
+        [seconds, MAX_RETRY_AFTER].min if seconds&.positive?
+      end
+
+      # RFC 7231 allows delta-seconds or an HTTP date. Most responses carry no
+      # header at all and most that do use digits, so both leave before the
+      # date parse, which is the only branch that needs a rescue. A date
+      # already past gives a negative delay, which the caller drops the same
+      # way it drops a zero.
+      def retry_after_seconds(value)
+        header = value.to_s.strip
+        return if header.empty?
+        return header.to_i if header.match?(/\A\d+\z/)
+
+        (Time.httpdate(header) - Time.now).round
+      rescue ArgumentError
+        nil
       end
 
       def print_download_start

data/lib/fontist/version.rb

@@ -1,3 +1,3 @@
 module Fontist
-  VERSION = "3.0.10".freeze
+  VERSION = "3.0.11".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontist
 version: !ruby/object:Gem::Version
-  version: 3.0.10
+  version: 3.0.11
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-03 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: down
@@ -279,9 +279,6 @@ files:
 - TODO.upgrade-excavate.md
 - docs/.gitignore
 - docs/.vitepress/config.ts
-- docs/.vitepress/data/cli-commands.json
-- docs/.vitepress/data/exit-codes.json
-- docs/.vitepress/data/features.json
 - docs/.vitepress/theme/components/HeroCodeBlock.vue
 - docs/.vitepress/theme/components/WithinHero.vue
 - docs/.vitepress/theme/index.ts
@@ -308,10 +305,6 @@ files:
 - docs/cli/uninstall.md
 - docs/cli/update.md
 - docs/cli/version.md
-- docs/components/CliCommand.vue
-- docs/components/CliExamples.vue
-- docs/components/CliOptions.vue
-- docs/components/ExitCodes.vue
 - docs/guide/ci.md
 - docs/guide/concepts/fonts.md
 - docs/guide/concepts/formats.md

data/docs/.vitepress/data/cli-commands.json

@@ -1,461 +0,0 @@
-{
-  "install": {
-    "description": "Install one or more fonts",
-    "syntax": "fontist install FONT... [options]",
-    "arguments": [
-      { "name": "FONT", "description": "One or more font names to install", "required": true, "variadic": true }
-    ],
-    "options": [
-      { "name": "force", "alias": "f", "type": "boolean", "description": "Install even if already installed in system" },
-      { "name": "formula", "alias": "F", "type": "boolean", "description": "Install whole formula instead of a font" },
-      { "name": "accept-all-licenses", "alias": "a", "type": "boolean", "description": "Accept all license agreements" },
-      { "name": "hide-licenses", "alias": "h", "type": "boolean", "description": "Hide license texts" },
-      { "name": "no-progress", "alias": "p", "type": "boolean", "description": "Hide download progress" },
-      { "name": "version", "alias": "V", "type": "string", "description": "Specify particular version of a font" },
-      { "name": "smallest", "alias": "s", "type": "boolean", "description": "Install the smallest font by file size if several" },
-      { "name": "newest", "alias": "n", "type": "boolean", "description": "Install the newest version of a font if several" },
-      { "name": "size-limit", "alias": "S", "type": "numeric", "description": "Specify upper limit for file size of a formula to be installed (default is 500 MB)" },
-      { "name": "update-fontconfig", "alias": "u", "type": "boolean", "description": "Update fontconfig" },
-      { "name": "location", "alias": "l", "type": "string", "enum": ["fontist", "user", "system"], "description": "Install location: fontist (default), user, system" }
-    ],
-    "examples": [
-      { "description": "Install a single font", "command": "fontist install \"Roboto\"" },
-      { "description": "Install multiple fonts", "command": "fontist install \"Fira Code\" \"Open Sans\"" },
-      { "description": "Force reinstall", "command": "fontist install \"Roboto\" --force" },
-      { "description": "Install to user directory", "command": "fontist install \"Roboto\" --location user" },
-      { "description": "Accept licenses automatically (for CI)", "command": "fontist install \"Roboto\" --accept-all-licenses --hide-licenses" },
-      { "description": "Install a specific version", "command": "fontist install \"Roboto\" --version 2.0" },
-      { "description": "Install whole formula", "command": "fontist install \"Roboto\" --formula" }
-    ],
-    "related": ["uninstall", "list", "status"]
-  },
-  "uninstall": {
-    "description": "Uninstall font by font or formula name",
-    "syntax": "fontist uninstall FONT",
-    "aliases": ["remove"],
-    "arguments": [
-      { "name": "FONT", "description": "Font or formula name to uninstall", "required": true }
-    ],
-    "options": [],
-    "examples": [
-      { "description": "Uninstall a font", "command": "fontist uninstall \"Roboto\"" },
-      { "description": "Using the remove alias", "command": "fontist remove \"Roboto\"" }
-    ],
-    "related": ["install", "status"]
-  },
-  "status": {
-    "description": "Show paths of installed fonts",
-    "syntax": "fontist status [FONT]",
-    "arguments": [
-      { "name": "FONT", "description": "Optional font name to filter results", "required": false }
-    ],
-    "options": [],
-    "examples": [
-      { "description": "Show all installed fonts", "command": "fontist status" },
-      { "description": "Show paths for a specific font", "command": "fontist status \"Open Sans\"" }
-    ],
-    "related": ["list", "install"]
-  },
-  "list": {
-    "description": "List installation status of fonts in fontist",
-    "syntax": "fontist list [FONT]",
-    "arguments": [
-      { "name": "FONT", "description": "Optional font name to filter results", "required": false }
-    ],
-    "options": [],
-    "examples": [
-      { "description": "List all fonts and their status", "command": "fontist list" },
-      { "description": "Check status of a specific font", "command": "fontist list \"Fira Mono\"" }
-    ],
-    "related": ["status", "install"]
-  },
-  "update": {
-    "description": "Update formulas from the repository",
-    "syntax": "fontist update",
-    "arguments": [],
-    "options": [],
-    "examples": [
-      { "description": "Update all formulas", "command": "fontist update" }
-    ],
-    "related": ["version"]
-  },
-  "version": {
-    "description": "Show fontist version and formulas repository information",
-    "syntax": "fontist version",
-    "arguments": [],
-    "options": [],
-    "examples": [
-      { "description": "Show version information", "command": "fontist version" }
-    ],
-    "related": ["update"]
-  },
-  "create-formula": {
-    "description": "Create a new formula with fonts from a URL",
-    "syntax": "fontist create-formula URL [options]",
-    "arguments": [
-      { "name": "URL", "description": "URL to download fonts from", "required": true }
-    ],
-    "options": [
-      { "name": "name", "alias": null, "type": "string", "description": "Font name, e.g., 'Times New Roman'" },
-      { "name": "mirror", "alias": null, "type": "array", "description": "Mirror URLs (can be repeated)" },
-      { "name": "subdir", "alias": null, "type": "string", "description": "Subdirectory to take fonts from, e.g., 'fonts/static_otf'" },
-      { "name": "file-pattern", "alias": null, "type": "string", "description": "File pattern to match, e.g., '*.otf'" },
-      { "name": "name-prefix", "alias": null, "type": "string", "description": "Prefix to add to all font family names" }
-    ],
-    "examples": [
-      { "description": "Create a formula from a font archive", "command": "fontist create-formula https://example.com/fonts.zip --name \"Custom Font\"" },
-      { "description": "Create formula with subdirectory filter", "command": "fontist create-formula https://example.com/fonts.zip --subdir \"fonts/otf\"" }
-    ],
-    "related": []
-  },
-  "rebuild-index": {
-    "description": "Rebuild formula index (used by formulas maintainers)",
-    "syntax": "fontist rebuild-index",
-    "arguments": [],
-    "options": [],
-    "examples": [
-      { "description": "Rebuild the formula index", "command": "fontist rebuild-index" }
-    ],
-    "related": []
-  },
-  "macos-catalogs": {
-    "description": "List available macOS font catalogs",
-    "syntax": "fontist macos-catalogs",
-    "arguments": [],
-    "options": [],
-    "examples": [
-      { "description": "List available macOS font catalogs", "command": "fontist macos-catalogs" }
-    ],
-    "related": ["import macos"]
-  },
-  "manifest": {
-    "description": "Manage font manifests",
-    "syntax": "fontist manifest SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "install": {
-        "description": "Install fonts from a manifest file (YAML)",
-        "syntax": "fontist manifest install MANIFEST [options]",
-        "arguments": [
-          { "name": "MANIFEST", "description": "Path to manifest YAML file", "required": true }
-        ],
-        "options": [
-          { "name": "accept-all-licenses", "alias": "a", "type": "boolean", "description": "Accept all license agreements" },
-          { "name": "hide-licenses", "alias": "h", "type": "boolean", "description": "Hide license texts" },
-          { "name": "location", "alias": "l", "type": "string", "enum": ["fontist", "user", "system"], "description": "Install location: fontist (default), user, system" }
-        ],
-        "examples": [
-          { "description": "Install fonts from manifest", "command": "fontist manifest install fonts.yml" },
-          { "description": "Install with auto-accept licenses", "command": "fontist manifest install fonts.yml --accept-all-licenses --hide-licenses" }
-        ]
-      },
-      "locations": {
-        "description": "Get locations of fonts from a manifest file",
-        "syntax": "fontist manifest locations MANIFEST [options]",
-        "arguments": [
-          { "name": "MANIFEST", "description": "Path to manifest YAML file", "required": true }
-        ],
-        "options": [
-          { "name": "show-timing", "alias": "t", "type": "boolean", "description": "Show timing information for manifest resolution" }
-        ],
-        "examples": [
-          { "description": "Get font locations from manifest", "command": "fontist manifest locations fonts.yml" }
-        ]
-      }
-    }
-  },
-  "repo": {
-    "description": "Manage custom font repositories",
-    "syntax": "fontist repo SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "setup": {
-        "description": "Setup a custom fontist repo and fetch its formulas",
-        "syntax": "fontist repo setup NAME URL",
-        "arguments": [
-          { "name": "NAME", "description": "Name for the repository", "required": true },
-          { "name": "URL", "description": "Git repository URL", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Setup a custom repository", "command": "fontist repo setup my-fonts https://github.com/user/font-formulas" }
-        ]
-      },
-      "update": {
-        "description": "Update formulas in a fontist repo",
-        "syntax": "fontist repo update NAME",
-        "arguments": [
-          { "name": "NAME", "description": "Name of the repository", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Update a custom repository", "command": "fontist repo update my-fonts" }
-        ]
-      },
-      "remove": {
-        "description": "Remove a fontist repo",
-        "syntax": "fontist repo remove NAME",
-        "arguments": [
-          { "name": "NAME", "description": "Name of the repository", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Remove a custom repository", "command": "fontist repo remove my-fonts" }
-        ]
-      },
-      "list": {
-        "description": "List all fontist repos",
-        "syntax": "fontist repo list",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "List all repositories", "command": "fontist repo list" }
-        ]
-      },
-      "info": {
-        "description": "Show information about a repo",
-        "syntax": "fontist repo info NAME",
-        "arguments": [
-          { "name": "NAME", "description": "Name of the repository", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Get info about a repository", "command": "fontist repo info my-fonts" }
-        ]
-      }
-    }
-  },
-  "import": {
-    "description": "Import fonts from external sources",
-    "syntax": "fontist import SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "google": {
-        "description": "Import Google fonts",
-        "syntax": "fontist import google [options]",
-        "arguments": [],
-        "options": [
-          { "name": "source-path", "alias": null, "type": "string", "description": "Path to checked-out google/fonts repository" },
-          { "name": "output-path", "alias": null, "type": "string", "description": "Output path for generated formulas (default: ./Formulas/google)" },
-          { "name": "font-name", "alias": "f", "type": "string", "description": "Import specific font family by name" },
-          { "name": "force", "alias": null, "type": "boolean", "description": "Overwrite existing formulas" },
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Enable verbose output" },
-          { "name": "import-cache", "alias": null, "type": "string", "description": "Directory for import cache (default: ~/.fontist/import_cache)" }
-        ],
-        "examples": [
-          { "description": "Import all Google fonts", "command": "fontist import google" },
-          { "description": "Import specific font", "command": "fontist import google --font-name \"Roboto\"" }
-        ]
-      },
-      "macos": {
-        "description": "Import macOS supplementary fonts",
-        "syntax": "fontist import macos [options]",
-        "arguments": [],
-        "options": [
-          { "name": "plist", "alias": null, "type": "string", "description": "Path to macOS font catalog XML" },
-          { "name": "output-path", "alias": null, "type": "string", "description": "Output directory for generated formulas (default: formulas/macos)" },
-          { "name": "font-name", "alias": "f", "type": "string", "description": "Import specific font by name" },
-          { "name": "force", "alias": null, "type": "boolean", "description": "Overwrite existing formulas" },
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Enable verbose output" }
-        ],
-        "examples": [
-          { "description": "Import macOS fonts", "command": "fontist import macos --plist /path/to/catalog.xml" }
-        ]
-      },
-      "sil": {
-        "description": "Import formulas from SIL International",
-        "syntax": "fontist import sil [options]",
-        "arguments": [],
-        "options": [
-          { "name": "output-path", "alias": null, "type": "string", "description": "Output directory for generated formulas" },
-          { "name": "font-name", "alias": "f", "type": "string", "description": "Import specific font by name" },
-          { "name": "force", "alias": null, "type": "boolean", "description": "Overwrite existing formulas" },
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Enable verbose output" }
-        ],
-        "examples": [
-          { "description": "Import SIL fonts", "command": "fontist import sil" }
-        ]
-      }
-    }
-  },
-  "fontconfig": {
-    "description": "Manage fontconfig configuration",
-    "syntax": "fontist fontconfig SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "update": {
-        "description": "Update fontconfig configuration to use fontist fonts",
-        "syntax": "fontist fontconfig update",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Update fontconfig", "command": "fontist fontconfig update" }
-        ]
-      },
-      "remove": {
-        "description": "Remove fontist file from fontconfig configuration",
-        "syntax": "fontist fontconfig remove [options]",
-        "arguments": [],
-        "options": [
-          { "name": "force", "alias": "f", "type": "boolean", "description": "Proceed even if file does not exist" }
-        ],
-        "examples": [
-          { "description": "Remove fontconfig integration", "command": "fontist fontconfig remove" }
-        ]
-      }
-    }
-  },
-  "config": {
-    "description": "Manage fontist configuration",
-    "syntax": "fontist config SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "show": {
-        "description": "Show values of the current config",
-        "syntax": "fontist config show",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Show current config", "command": "fontist config show" }
-        ]
-      },
-      "set": {
-        "description": "Set a config attribute to a value",
-        "syntax": "fontist config set KEY VALUE",
-        "arguments": [
-          { "name": "KEY", "description": "Config key to set", "required": true },
-          { "name": "VALUE", "description": "Value to set", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Set fonts path", "command": "fontist config set fonts_path /var/myfonts" }
-        ]
-      },
-      "delete": {
-        "description": "Delete a config attribute (reset to default)",
-        "syntax": "fontist config delete KEY",
-        "arguments": [
-          { "name": "KEY", "description": "Config key to delete", "required": true }
-        ],
-        "options": [],
-        "examples": [
-          { "description": "Reset fonts path to default", "command": "fontist config delete fonts_path" }
-        ]
-      },
-      "keys": {
-        "description": "Print all available config attributes",
-        "syntax": "fontist config keys",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "List available config keys", "command": "fontist config keys" }
-        ]
-      }
-    },
-    "config_keys": [
-      { "key": "fonts_path", "default": "~/.fontist/fonts", "description": "Where to put font files" },
-      { "key": "open_timeout", "default": "60", "description": "HTTP open timeout in seconds" },
-      { "key": "read_timeout", "default": "60", "description": "HTTP read timeout in seconds" }
-    ]
-  },
-  "cache": {
-    "description": "Manage fontist cache",
-    "syntax": "fontist cache SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "clear": {
-        "description": "Clear fontist download cache",
-        "syntax": "fontist cache clear",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Clear download cache", "command": "fontist cache clear" }
-        ]
-      },
-      "clear-import": {
-        "description": "Clear import cache",
-        "syntax": "fontist cache clear-import [options]",
-        "arguments": [],
-        "options": [
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Show detailed output" }
-        ],
-        "examples": [
-          { "description": "Clear import cache", "command": "fontist cache clear-import" }
-        ]
-      },
-      "info": {
-        "description": "Show cache information",
-        "syntax": "fontist cache info",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Show cache size and location", "command": "fontist cache info" }
-        ]
-      }
-    }
-  },
-  "index": {
-    "description": "Manage system font index",
-    "syntax": "fontist index SUBCOMMAND ...ARGS",
-    "subcommands": {
-      "rebuild": {
-        "description": "Rebuild system font index from scratch (cold build)",
-        "syntax": "fontist index rebuild [options]",
-        "arguments": [],
-        "options": [
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Show detailed progress and statistics" },
-          { "name": "output", "alias": "o", "type": "string", "description": "Save index to specified path (for inspection)" }
-        ],
-        "examples": [
-          { "description": "Rebuild system font index", "command": "fontist index rebuild" },
-          { "description": "Rebuild with verbose output", "command": "fontist index rebuild --verbose" }
-        ]
-      },
-      "update": {
-        "description": "Update system font index incrementally",
-        "syntax": "fontist index update [options]",
-        "arguments": [],
-        "options": [
-          { "name": "verbose", "alias": "v", "type": "boolean", "description": "Show detailed progress and statistics" }
-        ],
-        "examples": [
-          { "description": "Update system font index", "command": "fontist index update" }
-        ]
-      },
-      "info": {
-        "description": "Show system font index information",
-        "syntax": "fontist index info",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Show index info", "command": "fontist index info" }
-        ]
-      },
-      "path": {
-        "description": "Show the system font index file path",
-        "syntax": "fontist index path",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Show index file path", "command": "fontist index path" }
-        ]
-      },
-      "list": {
-        "description": "List all system fonts from the index",
-        "syntax": "fontist index list [options]",
-        "arguments": [],
-        "options": [
-          { "name": "format", "alias": null, "type": "string", "default": "yaml", "description": "Output format: yaml or json" },
-          { "name": "limit", "alias": null, "type": "numeric", "description": "Limit number of fonts to display" }
-        ],
-        "examples": [
-          { "description": "List all system fonts", "command": "fontist index list" },
-          { "description": "List as JSON", "command": "fontist index list --format json" }
-        ]
-      },
-      "clear": {
-        "description": "Delete system font index (will be rebuilt on next use)",
-        "syntax": "fontist index clear",
-        "arguments": [],
-        "options": [],
-        "examples": [
-          { "description": "Clear system font index", "command": "fontist index clear" }
-        ]
-      }
-    }
-  }
-}

data/docs/.vitepress/data/exit-codes.json

@@ -1,21 +0,0 @@
-{
-  "codes": [
-    { "code": 0, "name": "SUCCESS", "description": "Command completed successfully" },
-    { "code": 1, "name": "UNKNOWN_ERROR", "description": "Unknown or unexpected error" },
-    { "code": 2, "name": "NON_SUPPORTED_FONT_ERROR", "description": "Font is not supported by fontist" },
-    { "code": 3, "name": "MISSING_FONT_ERROR", "description": "Font could not be found on the system or in formulas" },
-    { "code": 4, "name": "LICENSING_ERROR", "description": "License agreement required but not accepted" },
-    { "code": 5, "name": "MANIFEST_COULD_NOT_BE_FOUND_ERROR", "description": "Manifest file not found at specified path" },
-    { "code": 6, "name": "MANIFEST_COULD_NOT_BE_READ_ERROR", "description": "Manifest file could not be read (invalid YAML or permissions)" },
-    { "code": 7, "name": "FONT_INDEX_CORRUPTED", "description": "Font index file is corrupted and needs to be rebuilt" },
-    { "code": 8, "name": "REPO_NOT_FOUND", "description": "Repository not found" },
-    { "code": 9, "name": "MAIN_REPO_NOT_FOUND", "description": "Main formulas repository not found" },
-    { "code": 10, "name": "REPO_COULD_NOT_BE_UPDATED", "description": "Repository could not be updated (network or git error)" },
-    { "code": 11, "name": "MANUAL_FONT_ERROR", "description": "Manual font installation required (font cannot be downloaded)" },
-    { "code": 12, "name": "SIZE_LIMIT_ERROR", "description": "Formula exceeds size limit. Use --size-limit, --newest, or --smallest options" },
-    { "code": 13, "name": "FORMULA_NOT_FOUND", "description": "Formula not found for the requested font" },
-    { "code": 14, "name": "FONTCONFIG_NOT_FOUND", "description": "Fontconfig is not installed or not found" },
-    { "code": 15, "name": "FONTCONFIG_FILE_NOT_FOUND", "description": "Fontconfig configuration file not found" },
-    { "code": 16, "name": "INVALID_CONFIG_ATTRIBUTE", "description": "Invalid configuration attribute specified" }
-  ]
-}

data/docs/.vitepress/data/features.json

@@ -1,44 +0,0 @@
-{
-  "features": [
-    {
-      "title": "Cross-Platform",
-      "icon": "🌐",
-      "description": "Same commands work identically on Windows, macOS, and Linux. No platform-specific paths to remember."
-    },
-    {
-      "title": "Formula-Based",
-      "icon": "📦",
-      "description": "3000+ fonts available through community-maintained formulas with automatic download and license handling."
-    },
-    {
-      "title": "Manifest Support",
-      "icon": "📋",
-      "description": "Define font requirements in YAML for reproducible installations across environments."
-    },
-    {
-      "title": "CI/CD Ready",
-      "icon": "🔄",
-      "description": "Perfect for automated environments with non-interactive installation and GitHub Action available."
-    },
-    {
-      "title": "System Font Detection",
-      "icon": "🔍",
-      "description": "Detects and indexes fonts already installed on your system. No redundant downloads."
-    },
-    {
-      "title": "Multiple Locations",
-      "icon": "📁",
-      "description": "Install to fontist directory, user fonts, or system fonts. Flexible for different use cases."
-    },
-    {
-      "title": "Fontconfig Integration",
-      "icon": "⚡",
-      "description": "Optional fontconfig integration for seamless font discovery in Linux environments."
-    },
-    {
-      "title": "Custom Repositories",
-      "icon": "🔗",
-      "description": "Add private formula repositories for internal or custom fonts."
-    }
-  ]
-}

data/docs/components/CliCommand.vue

@@ -1,77 +0,0 @@
-<script setup>
-import { computed } from 'vue'
-const props = defineProps({
-  command: { type: String, required: true }
-})
-import commands from '../.vitepress/data/cli-commands.json'
-const cmd = computed(() => commands[props.command])
-</script>
-
-<template>
-  <div v-if="cmd" class="cli-command">
-    <p class="description">{{ cmd.description }}</p>
-    <pre class="syntax"><code>{{ cmd.syntax }}</code></pre>
-
-    <h3 v-if="cmd.arguments && cmd.arguments.length">Arguments</h3>
-    <table v-if="cmd.arguments && cmd.arguments.length">
-      <thead><tr><th>Name</th><th>Required</th><th>Description</th></tr></thead>
-      <tbody>
-        <tr v-for="arg in cmd.arguments" :key="arg.name">
-          <td><code>{{ arg.name }}</code></td>
-          <td>{{ arg.required ? 'Yes' : 'No' }}</td>
-          <td>{{ arg.description }}</td>
-        </tr>
-      </tbody>
-    </table>
-
-    <h3 v-if="cmd.options && cmd.options.length">Options</h3>
-    <table v-if="cmd.options && cmd.options.length">
-      <thead><tr><th>Option</th><th>Alias</th><th>Type</th><th>Description</th></tr></thead>
-      <tbody>
-        <tr v-for="opt in cmd.options" :key="opt.name">
-          <td><code>--{{ opt.name }}</code></td>
-          <td><code v-if="opt.alias">-{{ opt.alias }}</code></td>
-          <td>{{ opt.type }}</td>
-          <td>{{ opt.description }}</td>
-        </tr>
-      </tbody>
-    </table>
-
-    <h3 v-if="cmd.examples && cmd.examples.length">Examples</h3>
-    <div v-if="cmd.examples && cmd.examples.length" class="examples">
-      <div v-for="example in cmd.examples" :key="example.command" class="example">
-        <p>{{ example.description }}</p>
-        <pre><code>{{ example.command }}</code></pre>
-      </div>
-    </div>
-
-    <p v-if="cmd.related && cmd.related.length" class="related">
-      <strong>Related:</strong>
-      <span v-for="rel in cmd.related" :key="rel">
-        <a :href="`/cli/${rel}`">{{ rel }}</a>{{ rel !== cmd.related[cmd.related.length-1] ? ', ' : '' }}
-      </span>
-    </p>
-  </div>
-</template>
-
-<style scoped>
-.cli-command .syntax {
-  margin: 1rem 0;
-}
-.example {
-  margin: 0.5rem 0;
-}
-.example p {
-  margin: 0;
-  font-weight: 500;
-}
-.example pre {
-  margin: 0.25rem 0;
-  padding: 0.75rem;
-  background: var(--vp-code-block-bg);
-  border-radius: 4px;
-}
-.related {
-  margin-top: 1.5rem;
-}
-</style>

data/docs/components/CliExamples.vue

@@ -1,17 +0,0 @@
-<script setup>
-import { computed } from 'vue'
-const props = defineProps({
-  command: { type: String, required: true }
-})
-import commands from '../.vitepress/data/cli-commands.json'
-const cmd = computed(() => commands[props.command])
-</script>
-
-<template>
-  <div v-if="cmd && cmd.examples">
-    <div v-for="example in cmd.examples" :key="example.command" class="example">
-      <p>{{ example.description }}</p>
-      <pre><code>{{ example.command }}</code></pre>
-    </div>
-  </div>
-</template>

data/docs/components/CliOptions.vue

@@ -1,26 +0,0 @@
-<script setup>
-import { computed } from 'vue'
-const props = defineProps({
-  command: { type: String, required: true }
-})
-import commands from '../.vitepress/data/cli-commands.json'
-const cmd = computed(() => commands[props.command])
-</script>
-
-<template>
-  <div v-if="cmd">
-    <table>
-      <thead>
-        <tr><th>Option</th><th>Alias</th><th>Type</th><th>Description</th></tr>
-      </thead>
-      <tbody>
-        <tr v-for="opt in cmd.options" :key="opt.name">
-          <td><code>--{{ opt.name }}</code></td>
-          <td><code v-if="opt.alias">-{{ opt.alias }}</code></td>
-          <td>{{ opt.type }}</td>
-          <td>{{ opt.description }}</td>
-        </tr>
-      </tbody>
-    </table>
-  </div>
-</template>

data/docs/components/ExitCodes.vue

@@ -1,18 +0,0 @@
-<script setup>
-import exitCodes from '../.vitepress/data/exit-codes.json'
-</script>
-
-<template>
-  <table>
-    <thead>
-      <tr><th>Code</th><th>Name</th><th>Description</th></tr>
-    </thead>
-    <tbody>
-      <tr v-for="code in exitCodes.codes" :key="code.code">
-        <td><code>{{ code.code }}</code></td>
-        <td>{{ code.name }}</td>
-        <td>{{ code.description }}</td>
-      </tr>
-    </tbody>
-  </table>
-</template>