fontisan 0.2.14 → 0.2.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8d495575ec4d2504df2181032e5ac8908f503772b1e82171e60e3ffbbd9039a
-  data.tar.gz: 80bb603d185b5a96ad53dad56fb2a2b2ab170175ccfb7f924ce8a216bd2eddf9
+  metadata.gz: 42bca448396aff910f6d3c92ac31bfa68afdbb85b6f9217d996d73cdbb62af5c
+  data.tar.gz: 8e3a5ad55f4c4ba9ac4430caa9447b07ef317840559b84b936cc57791470ee3b
 SHA512:
-  metadata.gz: 8c189ad3392f6acfc15a4bda354785d5310a859c9e282606cbbde57b3b187420f0739ad593f03e703f5f537dd8dcc148114e114b2e437cc5b77891d7fcf7a856
-  data.tar.gz: 67de3c882d2399a3118aa40d1f0d05c101c77c93ebe0005959fd9ed16fe2d6854a81085337d1b99d74f125771982fa8b340a106163d9e8e4e2e48956e2ff48ea
+  metadata.gz: de88ca7106b4934b37c0060f76f41b7972c0092a798c860cbc37795357ffdbce11089ae556f461c490c1fdd43ab48bc97ba3f1d90687abfb95fbea14d42259a7
+  data.tar.gz: 2aa4ccdca9901b1ce95eb442238530d86f24a52eae0e3eebfbd23470f3c614858b905adac85fa198fd6d3e8b66f3b6b762015575adff30bafbccd0c5c99115c7

data/.rubocop_todo.yml

@@ -1,16 +1,47 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-02-05 04:16:45 UTC using RuboCop version 1.82.1.
+# on 2026-05-02 04:07:39 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
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/fontisan/loading_modes.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
+  Exclude:
+    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
+    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
+
+# Offense count: 1
+# 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:
+  Exclude:
+    - 'docs/node_modules/speakingurl/speakingurl-rails.gemspec'
+
 # Offense count: 1585
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
@@ -18,6 +49,16 @@ Gemspec/RequiredRubyVersion:
 Layout/LineLength:
   Enabled: false
 
+# Offense count: 5
+# 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'
+
 # Offense count: 3
 Lint/CopDirectiveSyntax:
   Exclude:
@@ -73,6 +114,15 @@ 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:
@@ -126,7 +176,7 @@ Metrics/CollectionLiteralLength:
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 902
+# Offense count: 842
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 135
@@ -157,7 +207,7 @@ Naming/MethodParameterName:
 # Offense count: 13
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
 # AllowedMethods: call
-# WaywardPredicates: nonzero?
+# WaywardPredicates: infinite?, nonzero?
 Naming/PredicateMethod:
   Exclude:
     - 'lib/fontisan/collection/builder.rb'
@@ -180,7 +230,7 @@ Naming/PredicateMethod:
 # MethodDefinitionMacros: define_method, define_singleton_method
 Naming/PredicatePrefix:
   Exclude:
-    - '../../../.cache/rubocop_cache/spec/**/*'
+    - 'spec/**/*'
     - 'lib/fontisan/type1/afm_generator.rb'
 
 # Offense count: 21
@@ -392,6 +442,13 @@ 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.
@@ -409,9 +466,27 @@ Style/HashLikeCase:
     - 'lib/fontisan/commands/unpack_command.rb'
     - 'lib/fontisan/models/validation_report.rb'
 
+# Offense count: 1
+# 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:
+  Exclude:
+    - 'docs/node_modules/speakingurl/lib/speakingurl-rails.rb'
+
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: respond_to_missing?
 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/Gemfile

@@ -5,12 +5,12 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in fontisan.gemspec
 gemspec
 
-gem "canon", "~> 0.1.3"
-gem "get_process_mem", "~> 0.2"
+gem "benchmark"
 # bigdecimal is required by get_process_mem for Ruby 3.4+ compatibility
 gem "bigdecimal"
+gem "canon", "~> 0.1.3"
+gem "get_process_mem", "~> 0.2"
 gem "openssl", "~> 3.0"
-# sys-proctable is required by get_process_mem on Windows
 gem "rake"
 gem "rspec"
 gem "rubocop"
@@ -18,4 +18,7 @@ gem "rubocop-performance"
 gem "rubocop-rake"
 gem "rubocop-rspec"
 gem "rubyzip"
+# sys-proctable is required by get_process_mem on Windows
 gem "sys-proctable", platforms: %i[mswin mingw mswin64]
+# win32ole was a default gem until Ruby 4.0 — pin it for Windows runners
+gem "win32ole", platforms: %i[mswin mingw mswin64]

data/docs/.gitignore

@@ -0,0 +1,17 @@
+# Dependencies
+node_modules/
+
+# Build output
+.vitepress/dist/
+.vitepress/cache/
+
+# Logs
+*.log
+npm-debug.log*
+
+# Editor
+.vscode/
+.idea/
+
+# OS
+.DS_Store

data/docs/.vitepress/config.ts

@@ -0,0 +1,317 @@
+import { defineConfig } from "vitepress";
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  lang: "en-US",
+
+  // https://vitepress.dev/guide/routing#generating-clean-url
+  cleanUrls: true,
+
+  title: "Fontisan",
+  description:
+    "The most comprehensive font processing library for Ruby — 100% Pure Ruby, no Python, no C++, no C# dependencies.",
+
+  lastUpdated: true,
+
+  // Base path for deployment (e.g., /fontisan/ for fontist.org/fontisan/)
+  base: process.env.BASE_PATH || "/fontisan/",
+
+  head: [
+    [
+      "link",
+      { rel: "icon", type: "image/png", href: "/favicon-96x96.png", sizes: "96x96" },
+    ],
+    ["link", { rel: "icon", type: "image/svg+xml", href: "/favicon.svg" }],
+    ["link", { rel: "shortcut icon", href: "/favicon.ico" }],
+    [
+      "link",
+      { rel: "apple-touch-icon", sizes: "180x180", href: "/apple-touch-icon.png" },
+    ],
+    ["link", { rel: "manifest", href: "/site.webmanifest" }],
+    ["meta", { property: "og:type", content: "website" }],
+    ["meta", { property: "og:title", content: "Fontisan" }],
+    [
+      "meta",
+      {
+        property: "og:description",
+        content:
+          "The most comprehensive font processing library for Ruby — 100% Pure Ruby.",
+      },
+    ],
+    ["meta", { property: "og:image", content: "/logo-full.svg" }],
+    ["meta", { name: "twitter:card", content: "summary_large_image" }],
+  ],
+
+  // https://vitepress.dev/reference/default-theme-config
+  themeConfig: {
+    logo: "/logo-full.svg",
+    siteTitle: false,
+
+    // Local search with MiniSearch
+    search: {
+      provider: "local",
+      options: {
+        detailedView: true,
+        miniSearch: {
+          searchOptions: {
+            fuzzy: 0.2,
+            prefix: true,
+            boost: { title: 4, text: 2, titles: 1 },
+          },
+        },
+      },
+    },
+
+    // Top navigation (minimal: 4 items)
+    nav: [
+      { text: "← Fontist.org", link: "https://www.fontist.org" },
+      { text: "Guide", link: "/guide/" },
+      { text: "CLI", link: "/cli/" },
+      { text: "API", link: "/api/" },
+      { text: "Fontist", link: "https://www.fontist.org/fontist/", target: "_self" },
+      { text: "Formulas", link: "https://www.fontist.org/formulas/", target: "_self" },
+    ],
+
+    // Sidebar configuration
+    sidebar: {
+      "/guide/": [
+        {
+          text: "Getting Started",
+          items: [
+            { text: "Introduction", link: "/guide/" },
+            { text: "Installation", link: "/guide/installation" },
+            { text: "Quick Start", link: "/guide/quick-start" },
+          ],
+        },
+        {
+          text: "CLI Reference",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/cli/" },
+            { text: "convert", link: "/guide/cli/convert" },
+            { text: "info", link: "/guide/cli/info" },
+            { text: "validate", link: "/guide/cli/validate" },
+            { text: "subset", link: "/guide/cli/subset" },
+            { text: "pack/unpack", link: "/guide/cli/pack" },
+            { text: "export", link: "/guide/cli/export" },
+          ],
+        },
+        {
+          text: "Font Formats",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/formats/" },
+            { text: "TrueType (TTF)", link: "/guide/formats/ttf" },
+            { text: "OpenType (OTF)", link: "/guide/formats/otf" },
+            { text: "Type 1 (PFB/PFA)", link: "/guide/formats/type1" },
+            { text: "WOFF & WOFF2", link: "/guide/formats/woff" },
+            { text: "Collections (TTC/OTC)", link: "/guide/formats/collections" },
+            { text: "Apple dfont", link: "/guide/formats/dfont" },
+            { text: "SVG Fonts", link: "/guide/formats/svg" },
+          ],
+        },
+        {
+          text: "Conversion Guide",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/conversion/" },
+            { text: "TTF ↔ OTF", link: "/guide/conversion/ttf-otf" },
+            { text: "Type 1 → Modern", link: "/guide/conversion/type1" },
+            { text: "Web Formats", link: "/guide/conversion/web" },
+            { text: "Collections", link: "/guide/conversion/collections" },
+            { text: "Curve Conversion", link: "/guide/conversion/curves" },
+            { text: "Options Reference", link: "/guide/conversion/options" },
+          ],
+        },
+        {
+          text: "Validation",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/validation/" },
+            { text: "Validation Profiles", link: "/guide/validation/profiles" },
+            { text: "Validation Helpers", link: "/guide/validation/helpers" },
+            { text: "Custom Validators", link: "/guide/validation/custom" },
+          ],
+        },
+        {
+          text: "Variable Fonts",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/variable-fonts/" },
+            { text: "Axes & Instances", link: "/guide/variable-fonts/axes" },
+            { text: "Instance Generation", link: "/guide/variable-fonts/instances" },
+            { text: "Format Conversion", link: "/guide/variable-fonts/conversion" },
+            { text: "Named Instances", link: "/guide/variable-fonts/named-instances" },
+            { text: "Static Fonts", link: "/guide/variable-fonts/static" },
+            { text: "Advanced Topics", link: "/guide/variable-fonts/advanced" },
+          ],
+        },
+        {
+          text: "Font Hinting",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/hinting/" },
+            { text: "TrueType Hinting", link: "/guide/hinting/truetype" },
+            { text: "PostScript Hinting", link: "/guide/hinting/postscript" },
+            { text: "Hint Conversion", link: "/guide/hinting/conversion" },
+            { text: "Autohint", link: "/guide/hinting/autohint" },
+          ],
+        },
+        {
+          text: "Color Fonts",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/color-fonts/" },
+            { text: "COLR/CPAL", link: "/guide/color-fonts/colr-cpal" },
+            { text: "sbix & CBDT", link: "/guide/color-fonts/bitmaps" },
+            { text: "SVG Color", link: "/guide/color-fonts/svg" },
+          ],
+        },
+        {
+          text: "Migration Guides",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/migrations/" },
+            { text: "From fonttools (Python)", link: "/guide/migrations/fonttools" },
+            { text: "From extract_ttc", link: "/guide/migrations/extract-ttc" },
+            { text: "From otfinfo", link: "/guide/migrations/otfinfo" },
+            { text: "From Font-Validator", link: "/guide/migrations/font-validator" },
+          ],
+        },
+        {
+          text: "Feature Comparisons",
+          collapsed: true,
+          items: [
+            { text: "Overview", link: "/guide/comparisons/" },
+            { text: "vs fonttools", link: "/guide/comparisons/fonttools" },
+            { text: "vs lcdf-typetools", link: "/guide/comparisons/lcdf-typetools" },
+            { text: "vs Font-Validator", link: "/guide/comparisons/font-validator" },
+          ],
+        },
+        {
+          text: "Advanced Topics",
+          collapsed: true,
+          items: [
+            { text: "Universal Outline Model", link: "/guide/universal-outline" },
+          ],
+        },
+        {
+          text: "Contributing",
+          collapsed: true,
+          items: [
+            { text: "Contributing Guide", link: "/guide/contributing" },
+          ],
+        },
+      ],
+      "/cli/": [
+        {
+          text: "CLI Reference",
+          items: [
+            { text: "Overview", link: "/cli/" },
+          ],
+        },
+        {
+          text: "Font Information",
+          collapsed: true,
+          items: [
+            { text: "info", link: "/cli/info" },
+            { text: "ls", link: "/cli/ls" },
+            { text: "tables", link: "/cli/tables" },
+            { text: "glyphs", link: "/cli/glyphs" },
+            { text: "unicode", link: "/cli/unicode" },
+            { text: "scripts", link: "/cli/scripts" },
+            { text: "features", link: "/cli/features" },
+            { text: "variable", link: "/cli/variable" },
+            { text: "optical-size", link: "/cli/optical-size" },
+          ],
+        },
+        {
+          text: "Font Operations",
+          collapsed: true,
+          items: [
+            { text: "convert", link: "/cli/convert" },
+            { text: "subset", link: "/cli/subset" },
+            { text: "validate", link: "/cli/validate" },
+            { text: "instance", link: "/cli/instance" },
+            { text: "export", link: "/cli/export" },
+            { text: "dump-table", link: "/cli/dump-table" },
+          ],
+        },
+        {
+          text: "Collection Operations",
+          collapsed: true,
+          items: [
+            { text: "pack/unpack", link: "/cli/pack" },
+          ],
+        },
+        {
+          text: "Utilities",
+          collapsed: true,
+          items: [
+            { text: "version", link: "/cli/version" },
+          ],
+        },
+      ],
+      "/api/": [
+        {
+          text: "API Reference",
+          items: [
+            { text: "Overview", link: "/api/" },
+          ],
+        },
+        {
+          text: "Core Classes",
+          collapsed: true,
+          items: [
+            { text: "FontLoader", link: "/api/font-loader" },
+            { text: "FontWriter", link: "/api/font-writer" },
+            { text: "ConversionOptions", link: "/api/conversion-options" },
+            { text: "SfntFont", link: "/api/sfnt-font" },
+            { text: "Type1Font", link: "/api/type1-font" },
+          ],
+        },
+        {
+          text: "Converters",
+          collapsed: true,
+          items: [
+            { text: "OutlineConverter", link: "/api/converters/outline-converter" },
+            { text: "CurveConverter", link: "/api/converters/curve-converter" },
+            { text: "HintConverter", link: "/api/converters/hint-converter" },
+          ],
+        },
+        {
+          text: "Validators",
+          collapsed: true,
+          items: [
+            { text: "FontValidator", link: "/api/validators/font-validator" },
+            { text: "ValidationProfile", link: "/api/validators/profile" },
+            { text: "ValidationHelper", link: "/api/validators/helper" },
+          ],
+        },
+        {
+          text: "Models",
+          collapsed: true,
+          items: [
+            { text: "Glyph", link: "/api/models/glyph" },
+            { text: "GlyphAccessor", link: "/api/models/glyph-accessor" },
+            { text: "TableAnalyzer", link: "/api/models/table-analyzer" },
+          ],
+        },
+      ],
+    },
+
+    socialLinks: [
+      { icon: "github", link: "https://github.com/fontist/fontisan" },
+    ],
+
+    footer: {
+      message: 'Fontisan is a [Ribose](https://open.ribose.com/) project',
+      copyright: `Copyright © 2026 Ribose Group Inc. All rights reserved.`,
+    },
+
+    editLink: {
+      pattern: "https://github.com/fontist/fontisan/edit/main/docs/:path",
+      text: "Edit this page on GitHub",
+    },
+  },
+});

data/docs/.vitepress/theme/components/ApiMethod.vue

@@ -0,0 +1,127 @@
+<template>
+  <div class="api-method">
+    <div class="method-header">
+      <code class="method-signature">
+        <span class="method-name">{{ name }}</span
+        ><span class="method-params"
+          >({{ params.map((p) => p.name).join(", ") }})</span
+        >
+      </code>
+      <span v-if="returns" class="method-returns"> → {{ returns }}</span>
+    </div>
+    <p v-if="description" class="method-description">{{ description }}</p>
+    <div v-if="params.length" class="method-params-list">
+      <h4>Parameters</h4>
+      <ul>
+        <li v-for="param in params" :key="param.name">
+          <code>{{ param.name }}</code>
+          <span v-if="param.type" class="param-type">: {{ param.type }}</span>
+          <span v-if="param.required" class="param-required">*</span>
+          <span v-if="param.description" class="param-desc"
+            >— {{ param.description }}</span
+          >
+        </li>
+      </ul>
+    </div>
+    <div v-if="example" class="method-example">
+      <h4>Example</h4>
+      <pre><code :class="`language-${exampleLang}`">{{ example }}</code></pre>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+interface Param {
+  name: string;
+  type?: string;
+  required?: boolean;
+  description?: string;
+}
+
+defineProps<{
+  name: string;
+  params?: Param[];
+  returns?: string;
+  description?: string;
+  example?: string;
+  exampleLang?: string;
+}>();
+</script>
+
+<style scoped>
+.api-method {
+  margin: 1.5rem 0;
+  padding: 1rem;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  background: var(--vp-c-bg-soft);
+}
+
+.method-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
+.method-signature {
+  font-size: 1rem;
+  font-weight: 500;
+}
+
+.method-name {
+  color: var(--vp-c-brand-1);
+}
+
+.method-params {
+  color: var(--vp-c-text-2);
+}
+
+.method-returns {
+  color: var(--vp-c-text-2);
+  font-size: 0.9rem;
+}
+
+.method-description {
+  margin: 0.75rem 0 0;
+  color: var(--vp-c-text-2);
+}
+
+.method-params-list h4,
+.method-example h4 {
+  margin: 1rem 0 0.5rem;
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--vp-c-text-1);
+}
+
+.method-params-list ul {
+  margin: 0;
+  padding-left: 1.5rem;
+  list-style: disc;
+}
+
+.method-params-list li {
+  margin: 0.25rem 0;
+}
+
+.param-type {
+  color: var(--vp-c-text-3);
+}
+
+.param-required {
+  color: var(--vp-c-danger-1);
+}
+
+.param-desc {
+  color: var(--vp-c-text-2);
+}
+
+.method-example pre {
+  margin: 0.5rem 0;
+  padding: 1rem;
+  background: var(--vp-c-bg-alt);
+  border-radius: 6px;
+  overflow-x: auto;
+}
+</style>