fontisan 0.2.13 → 0.2.16

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

@@ -0,0 +1,30 @@
+<template>
+  <ClientOnly>
+    <Teleport to=".VPHero > .container">
+      <div class="within-hero__slot-container">
+        <slot />
+      </div>
+    </Teleport>
+  </ClientOnly>
+</template>
+
+<style>
+.within-hero__slot-container {
+  order: 2;
+}
+
+.VPHero > .container > .main {
+  width: unset;
+  flex-shrink: unset;
+}
+
+.VPHero > .container {
+  gap: 32px;
+}
+
+@media (min-width: 960px) {
+  .VPHero > .container {
+    gap: 64px;
+  }
+}
+</style>

data/docs/.vitepress/theme/index.ts

@@ -0,0 +1,22 @@
+import DefaultTheme from "vitepress/theme";
+import type { Theme } from "vitepress";
+import "./style.css";
+
+// Import custom components
+import FeatureComparison from "./components/FeatureComparison.vue";
+import Badge from "./components/Badge.vue";
+import ApiMethod from "./components/ApiMethod.vue";
+import HeroCodeBlock from "./components/HeroCodeBlock.vue";
+import WithinHero from "./components/WithinHero.vue";
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    // Register global components
+    app.component("FeatureComparison", FeatureComparison);
+    app.component("Badge", Badge);
+    app.component("ApiMethod", ApiMethod);
+    app.component("HeroCodeBlock", HeroCodeBlock);
+    app.component("WithinHero", WithinHero);
+  },
+} satisfies Theme;

data/docs/.vitepress/theme/style.css

@@ -0,0 +1,330 @@
+:root {
+  /* Brand Colors from Logo */
+  --fontist-rose: #bf4e6a;
+  --fontist-rose-light: #d4718a;
+  --fontist-dark: #4d4b54;
+  --fontist-gray: #676565;
+  --fontist-cream: #e1dfd2;
+  --fontist-beige: #bebbac;
+  --fontist-pale: #dddac8;
+
+  /* VitePress Theme Overrides - Light Mode */
+  --vp-c-brand-1: var(--fontist-rose);
+  --vp-c-brand-2: #a3435a;
+  --vp-c-brand-3: var(--fontist-dark);
+  --vp-c-brand-soft: rgba(191, 78, 106, 0.14);
+
+  /* Text Colors */
+  --vp-c-text-1: var(--fontist-dark);
+  --vp-c-text-2: var(--fontist-gray);
+  --vp-c-text-3: #8a8888;
+
+  /* Background Colors */
+  --vp-c-bg-soft: #f8f7f4;
+  --vp-c-bg-alt: #f2f1ed;
+  --vp-c-bg: #ffffff;
+
+  /* Hero */
+  --vp-home-hero-name-color: var(--fontist-rose);
+  --vp-home-hero-name-background: linear-gradient(
+    120deg,
+    var(--fontist-rose) 30%,
+    #d4718a
+  );
+
+  /* Buttons */
+  --vp-button-brand-border: var(--fontist-rose);
+  --vp-button-brand-text: #ffffff;
+  --vp-button-brand-bg: var(--fontist-rose);
+  --vp-button-brand-hover-border: #a3435a;
+  --vp-button-brand-hover-text: #ffffff;
+  --vp-button-brand-hover-bg: #a3435a;
+  --vp-button-brand-active-border: #8a3849;
+  --vp-button-brand-active-text: #ffffff;
+  --vp-button-brand-active-bg: #8a3849;
+
+  /* Sidebar */
+  --vp-sidebar-bg-color: var(--vp-c-bg-soft);
+
+  /* Nav */
+  --vp-nav-bg-color: var(--vp-c-bg);
+}
+
+/* Dark Mode */
+html.dark {
+  --vp-c-brand-1: var(--fontist-rose-light);
+  --vp-c-brand-2: var(--fontist-rose);
+  --vp-c-brand-3: #e1dfd2;
+  --vp-c-brand-soft: rgba(212, 113, 138, 0.14);
+
+  /* Text Colors - Dark Mode */
+  --vp-c-text-1: #e1dfd2;
+  --vp-c-text-2: #bebbac;
+  --vp-c-text-3: #8a8888;
+
+  /* Background Colors - Dark Mode */
+  --vp-c-bg: #1a1918;
+  --vp-c-bg-soft: #222120;
+  --vp-c-bg-alt: #2a2826;
+  --vp-c-bg-elv: #2a2826;
+
+  /* Hero - Dark Mode */
+  --vp-home-hero-name-background: linear-gradient(
+    120deg,
+    var(--fontist-rose-light) 30%,
+    #e08a9e
+  );
+
+  /* Buttons - Dark Mode */
+  --vp-button-brand-border: var(--fontist-rose-light);
+  --vp-button-brand-text: #1a1918;
+  --vp-button-brand-bg: var(--fontist-rose-light);
+  --vp-button-brand-hover-border: var(--fontist-rose);
+  --vp-button-brand-hover-text: #1a1918;
+  --vp-button-brand-hover-bg: var(--fontist-rose);
+  --vp-button-brand-active-border: #a3435a;
+  --vp-button-brand-active-text: #1a1918;
+  --vp-button-brand-active-bg: #a3435a;
+}
+
+/* Feature cards on home page - Light */
+.VPFeature .title {
+  color: var(--fontist-dark);
+}
+
+.VPFeature .details {
+  color: var(--fontist-gray);
+}
+
+.VPFeature:hover {
+  border-color: var(--fontist-rose);
+}
+
+/* Feature cards - Dark */
+html.dark .VPFeature .title {
+  color: var(--fontist-cream);
+}
+
+html.dark .VPFeature .details {
+  color: var(--fontist-beige);
+}
+
+/* Links */
+.vp-doc a {
+  color: var(--fontist-rose);
+}
+
+.vp-doc a:hover {
+  color: #a3435a;
+}
+
+html.dark .vp-doc a {
+  color: var(--fontist-rose-light);
+}
+
+html.dark .vp-doc a:hover {
+  color: var(--fontist-rose);
+}
+
+/* Footer */
+.VPFooter {
+  background-color: var(--vp-c-bg-soft);
+  border-top: 1px solid var(--fontist-pale);
+}
+
+html.dark .VPFooter {
+  border-top-color: #3a3836;
+}
+
+/* Code blocks - Light */
+.vp-doc [class*="language-"] {
+  background-color: var(--fontist-dark);
+}
+
+/* Code blocks - Dark */
+html.dark .vp-doc [class*="language-"] {
+  background-color: #0d0c0c;
+}
+
+/* Logo sizing */
+.VPNav .VPImage {
+  height: 39px;
+}
+
+/* Search */
+.VPLocalSearchBox {
+  --vp-c-brand-1: var(--fontist-rose);
+}
+
+/* Feature Comparison Tables */
+.feature-comparison {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1.5rem 0;
+  font-size: 0.9rem;
+}
+
+.feature-comparison th,
+.feature-comparison td {
+  padding: 0.75rem 1rem;
+  text-align: left;
+  border-bottom: 1px solid var(--vp-c-divider);
+}
+
+.feature-comparison th {
+  background: var(--vp-c-bg-soft);
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.feature-comparison .feature-name {
+  font-weight: 500;
+}
+
+.feature-comparison .supported {
+  color: var(--vp-c-green-1);
+}
+
+.feature-comparison .not-supported {
+  color: var(--vp-c-red-1);
+}
+
+.feature-comparison .advantage {
+  background: linear-gradient(
+    135deg,
+    rgba(191, 78, 106, 0.1) 0%,
+    rgba(212, 113, 138, 0.05) 100%
+  );
+}
+
+/* Badge styles */
+.badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.125rem 0.625rem;
+  border-radius: 9999px;
+  font-size: 0.75rem;
+  font-weight: 600;
+  line-height: 1.25rem;
+  vertical-align: middle;
+}
+
+.badge.pure-ruby {
+  background: linear-gradient(135deg, var(--fontist-rose), #d4718a);
+  color: white;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.badge.tip {
+  background-color: var(--vp-c-brand-soft);
+  color: var(--vp-c-brand-1);
+}
+
+.badge.preview {
+  background-color: rgba(255, 197, 61, 0.14);
+  color: #c4a226;
+}
+
+.badge.planned {
+  background-color: rgba(96, 165, 250, 0.14);
+  color: #60a5fa;
+}
+
+/* Home page enhancements */
+.my-index-page .VPHero .name {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.my-index-page .VPHero .tagline {
+  font-size: 1.25rem !important;
+  opacity: 0.9;
+}
+
+/* Pure Ruby badge on hero */
+.pure-ruby-hero {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.25rem 0.75rem;
+  background: linear-gradient(135deg, var(--fontist-rose), #d4718a);
+  color: white;
+  border-radius: 9999px;
+  font-size: 0.85rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  margin-top: 1rem;
+}
+
+/* Code comparison blocks */
+.code-comparison {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+  margin: 1.5rem 0;
+}
+
+@media (max-width: 768px) {
+  .code-comparison {
+    grid-template-columns: 1fr;
+  }
+}
+
+.code-comparison > div {
+  background: var(--vp-c-bg-soft);
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+.code-comparison h4 {
+  margin: 0;
+  padding: 0.75rem 1rem;
+  background: var(--vp-c-bg-alt);
+  font-size: 0.85rem;
+  font-weight: 600;
+  border-bottom: 1px solid var(--vp-c-divider);
+}
+
+/* CLI command reference */
+.cli-command {
+  padding: 1rem;
+  margin: 1rem 0;
+  background: var(--vp-c-bg-soft);
+  border-radius: 8px;
+  border-left: 3px solid var(--fontist-rose);
+}
+
+.cli-command code {
+  font-weight: 500;
+}
+
+/* Info boxes */
+.custom-block {
+  margin: 1.5rem 0;
+  padding: 1rem 1.25rem;
+  border-radius: 8px;
+}
+
+.custom-block.tip {
+  border-left: 4px solid var(--fontist-rose);
+  background: rgba(191, 78, 106, 0.08);
+}
+
+.custom-block.warning {
+  border-left: 4px solid #ffc53d;
+  background: rgba(255, 197, 61, 0.08);
+}
+
+.custom-block.danger {
+  border-left: 4px solid #f43f5e;
+  background: rgba(244, 63, 94, 0.08);
+}
+
+.custom-block.info {
+  border-left: 4px solid #60a5fa;
+  background: rgba(96, 165, 250, 0.08);
+}

data/docs/api/conversion-options.md

@@ -0,0 +1,141 @@
+---
+title: ConversionOptions
+---
+
+# ConversionOptions
+
+Type-safe conversion configuration.
+
+## Overview
+
+`Fontisan::ConversionOptions` provides a type-safe way to configure font conversions.
+
+## Class Methods
+
+### recommended(from:, to:)
+
+Get recommended options for a conversion type.
+
+```ruby
+options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
+# => #<Fontisan::ConversionOptions ...>
+
+# Access settings
+options.opening   # => { convert_curves: true, ... }
+options.generating # => { hinting_mode: "auto", ... }
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| from | Symbol | Source format |
+| to | Symbol | Target format |
+
+### from_preset(name)
+
+Load options from a named preset.
+
+```ruby
+# Web optimization preset
+options = Fontisan::ConversionOptions.from_preset(:web_optimized)
+
+# Type 1 to modern
+options = Fontisan::ConversionOptions.from_preset(:type1_to_modern)
+```
+
+**Available Presets:**
+
+| Preset | From | To |
+|--------|------|-----|
+| `type1_to_modern` | Type 1 | OTF |
+| `modern_to_type1` | OTF | Type 1 |
+| `web_optimized` | OTF | WOFF2 |
+| `archive_to_modern` | TTC | OTF |
+
+### new(**kwargs)
+
+Create custom options.
+
+```ruby
+options = Fontisan::ConversionOptions.new(
+  from: :ttf,
+  to: :otf,
+  opening: {
+    convert_curves: true,
+    autohint: true
+  },
+  generating: {
+    hinting_mode: 'auto',
+    optimize_tables: true
+  }
+)
+```
+
+## Instance Attributes
+
+### opening
+
+Opening options control source font processing.
+
+| Option | Type | Default |
+|--------|------|---------|
+| `decompose_composites` | Boolean | false |
+| `convert_curves` | Boolean | true |
+| `scale_to_1000` | Boolean | false |
+| `scale_from_1000` | Boolean | false |
+| `autohint` | Boolean | false |
+| `generate_unicode` | Boolean | false |
+| `store_custom_tables` | Boolean | true |
+| `store_native_hinting` | Boolean | false |
+| `interpret_ot` | Boolean | false |
+| `read_all_records` | Boolean | false |
+| `preserve_encoding` | String | nil |
+
+### generating
+
+Generating options control output font writing.
+
+| Option | Type | Default |
+|--------|------|---------|
+| `write_pfm` | Boolean | false |
+| `write_afm` | Boolean | false |
+| `write_inf` | Boolean | false |
+| `select_encoding_automatically` | Boolean | false |
+| `hinting_mode` | String | 'preserve' |
+| `decompose_on_output` | Boolean | false |
+| `write_custom_tables` | Boolean | true |
+| `optimize_tables` | Boolean | false |
+| `compression` | String | nil |
+| `transform_tables` | Boolean | false |
+| `preserve_metadata` | Boolean | true |
+
+## Examples
+
+### Basic Conversion
+
+```ruby
+options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
+converter = Fontisan::Converters::OutlineConverter.new
+result = converter.convert(font, options: options)
+```
+
+### Web Optimization
+
+```ruby
+options = Fontisan::ConversionOptions.from_preset(:web_optimized)
+Fontisan::FontWriter.write(font, 'output.woff2', options: options)
+```
+
+### Custom Options
+
+```ruby
+options = Fontisan::ConversionOptions.new(
+  opening: { autohint: true },
+  generating: {
+    hinting_mode: 'auto',
+    optimize_tables: true,
+    compression: 'brotli'
+  }
+)
+```

data/docs/api/converters/curve-converter.md

@@ -0,0 +1,34 @@
+---
+title: CurveConverter
+---
+
+# CurveConverter
+
+Convert between quadratic and cubic curves.
+
+## Overview
+
+`Fontisan::Converters::CurveConverter` handles Bézier curve conversion.
+
+## Methods
+
+### quadratic_to_cubic(points)
+
+Convert quadratic points to cubic.
+
+```ruby
+converter = Fontisan::Converters::CurveConverter.new
+cubic = converter.quadratic_to_cubic(quadratic_points)
+```
+
+### cubic_to_quadratic(points, tolerance: 0.5)
+
+Convert cubic points to quadratic.
+
+```ruby
+quadratic = converter.cubic_to_quadratic(cubic_points, tolerance: 0.5)
+```
+
+## See Also
+
+- [OutlineConverter](/api/converters/outline-converter)

data/docs/api/converters/hint-converter.md

@@ -0,0 +1,34 @@
+---
+title: HintConverter
+---
+
+# HintConverter
+
+Convert hints between TrueType and PostScript formats.
+
+## Overview
+
+`Fontisan::Converters::HintConverter` handles bidirectional hint conversion.
+
+## Methods
+
+### truetype_to_postscript(font)
+
+Convert TrueType instructions to PostScript hints.
+
+```ruby
+converter = Fontisan::Converters::HintConverter.new
+ps_hints = converter.truetype_to_postscript(font)
+```
+
+### postscript_to_truetype(font)
+
+Convert PostScript hints to TrueType instructions.
+
+```ruby
+ttf_tables = converter.postscript_to_truetype(font)
+```
+
+## See Also
+
+- [Font Hinting Guide](/guide/hinting/)

data/docs/api/converters/outline-converter.md

@@ -0,0 +1,27 @@
+---
+title: OutlineConverter
+---
+
+# OutlineConverter
+
+Convert font outlines between formats.
+
+## Overview
+
+`Fontisan::Converters::OutlineConverter` handles TTF ↔ OTF conversion.
+
+## Methods
+
+### convert(font, options: nil)
+
+Convert a font to a different format.
+
+```ruby
+converter = Fontisan::Converters::OutlineConverter.new
+options = Fontisan::ConversionOptions.recommended(from: :ttf, to: :otf)
+result = converter.convert(font, options: options)
+```
+
+## See Also
+
+- [ConversionOptions](/api/conversion-options)