fontist 3.0.1 → 3.0.2

data/docs/guide/platforms/windows.md

@@ -78,6 +78,73 @@ fontist install "Roboto" --location=system
 
 ---
 
+## Windows Features on Demand (FOD) Fonts
+
+Windows includes supplementary fonts that aren't pre-installed but can be enabled through **Features on Demand** (FOD). These include fonts for Japanese, Korean, Arabic, Pan-European, and other scripts.
+
+### What Are FOD Fonts?
+
+Windows FOD fonts are installed using `Add-WindowsCapability`, which downloads font packages from Windows Update. Fontist automates this process — when a formula specifies `source: windows_fod`, Fontist calls the appropriate PowerShell command to install the capability.
+
+### Installing FOD Fonts
+
+```powershell
+# Install a specific supplemental font
+fontist install "Meiryo"
+
+# Install Pan-European supplemental fonts
+fontist install "Arial Nova"
+```
+
+Fontist checks whether the capability is already installed. If not, it runs:
+
+```powershell
+Add-WindowsCapability -Online -Name 'Language.Fonts.Jpan~~~und-JPAN~0.0.1.0'
+```
+
+### Requirements
+
+| Requirement | Details |
+|-------------|---------|
+| Windows version | Windows 10 or later |
+| Internet connection | Required (fonts download from Windows Update) |
+| Administrator | Required on Windows 10 for system-wide installation |
+| WSUS/SCCM | Must not block Features on Demand |
+
+### Available FOD Fonts
+
+Fontist includes metadata for all Windows FOD font capabilities. Some common ones:
+
+| Capability | Fonts Included |
+|------------|---------------|
+| Japanese Supplemental Fonts | Meiryo, MS Gothic, MS Mincho |
+| Korean Supplemental Fonts | Batang, Dotum, Gulim |
+| Arabic Script Supplemental Fonts | Sakkal Majalla, Simplified Arabic |
+| Pan-European Supplemental Fonts | Arial Nova, Georgia Pro, Gill Sans Nova |
+| Traditional Chinese Supplemental Fonts | MingLiU, DFKai-SB |
+
+### FOD Font Installation Flow
+
+1. Fontist looks up the font in the formula index
+2. Checks if the Windows FOD capability is already installed via `Get-WindowsCapability`
+3. If not installed, runs `Add-WindowsCapability` to download and install it
+4. Returns paths to the installed font files in `C:\Windows\Fonts`
+
+### Troubleshooting FOD Installation
+
+If you see a `WindowsFodInstallError`:
+
+1. **No internet connection** — FOD fonts require Windows Update access
+2. **Insufficient permissions** — Run as Administrator on Windows 10
+3. **WSUS/SCCM policy** — Your organization may block FOD downloads; contact your IT administrator
+4. **Capability not found** — The capability name may differ on your Windows version; run `Get-WindowsCapability -Online -Name 'Language.Fonts.*'` to list available capabilities
+
+::: info Platform Restriction
+Windows FOD fonts are only installable on Windows. Fontist will raise a `PlatformMismatchError` if you attempt to install them on macOS or Linux.
+:::
+
+---
+
 ## Windows-Specific Considerations
 
 ### File Locking

data/lib/fontist/errors.rb

@@ -165,6 +165,27 @@ module Fontist
       end
     end
 
+    class WindowsFodInstallError < GeneralError
+      attr_reader :capability_name
+
+      def initialize(capability_name, stderr_output = nil)
+        @capability_name = capability_name
+        super(build_message(capability_name, stderr_output))
+      end
+
+      private
+
+      def build_message(cap_name, stderr)
+        msg = "Failed to install Windows font capability '#{cap_name}'."
+        msg += "\n#{stderr}" if stderr && !stderr.strip.empty?
+        msg += "\n\nPossible causes:" \
+               "\n  - No internet connection (Windows Update required)" \
+               "\n  - Insufficient permissions (admin required on Windows 10)" \
+               "\n  - WSUS/SCCM policy blocking Features on Demand"
+        msg
+      end
+    end
+
     class UnsupportedMacOSVersionError < GeneralError
       def initialize(detected_version, available_frameworks)
         super(build_message(detected_version, available_frameworks))

data/lib/fontist/font_installer.rb

@@ -90,6 +90,8 @@ module Fontist
                          Resources::GoogleResource
                        elsif @formula.source == "apple_cdn"
                          Resources::AppleCDNResource
+                       elsif @formula.source == "windows_fod"
+                         Resources::WindowsFodResource
                        else
                          Resources::ArchiveResource
                        end

data/lib/fontist/formula.rb

@@ -45,6 +45,7 @@ module Fontist
       "MacosImportSource",
       "GoogleImportSource",
       "SilImportSource",
+      "WindowsImportSource",
     ]
     attribute :font_version, :string
 
@@ -68,6 +69,7 @@ module Fontist
         files: :files,
         format: :format,
         variable_axes: :variable_axes,
+        capability_name: :capability_name,
       }
       map "digest", to: :digest
       map "instructions", to: :instructions
@@ -86,6 +88,7 @@ module Fontist
           "macos" => "Fontist::MacosImportSource",
           "google" => "Fontist::GoogleImportSource",
           "sil" => "Fontist::SilImportSource",
+          "windows" => "Fontist::WindowsImportSource",
         },
       }
       map "font_version", to: :font_version
@@ -233,10 +236,18 @@ module Fontist
       import_source.is_a?(SilImportSource)
     end
 
+    def windows_import?
+      import_source.is_a?(WindowsImportSource)
+    end
+
     def manual_formula?
       import_source.nil?
     end
 
+    def windows_fod?
+      source == "windows_fod" && platforms&.any? { |p| p == "windows" || p.start_with?("windows-") }
+    end
+
     def compatible_with_current_platform?
       return true unless macos_import?
 

data/lib/fontist/import/create_formula.rb

@@ -47,6 +47,11 @@ module Fontist
               version: @options[:import_source].version,
               release_date: @options[:import_source].release_date,
             )
+          when WindowsImportSource
+            builder.set_windows_import_source(
+              capability_name: @options[:import_source].capability_name,
+              min_windows_version: @options[:import_source].min_windows_version,
+            )
           end
         else
           # Legacy support for backward compatibility

data/lib/fontist/import/formula_builder.rb

@@ -85,6 +85,15 @@ family_id:)
         )
       end
 
+      # Convenience method to set Windows import source
+      def set_windows_import_source(capability_name:, min_windows_version: "10.0")
+        @import_source = WindowsImportSource.new(
+          type: "windows",
+          capability_name: capability_name,
+          min_windows_version: min_windows_version,
+        )
+      end
+
       private
 
       def formula_attributes