fontisan 0.2.14 → 0.2.16

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

@@ -0,0 +1,87 @@
+<template>
+  <table class="feature-comparison">
+    <thead>
+      <tr>
+        <th>Feature</th>
+        <th v-for="tool in tools" :key="tool">{{ tool }}</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr v-for="feature in features" :key="feature.name">
+        <td class="feature-name">{{ feature.name }}</td>
+        <td
+          v-for="(tool, index) in tools"
+          :key="tool"
+          :class="getSupportClass(feature.support[index])"
+        >
+          <span class="support-icon">{{ getSupportIcon(feature.support[index]) }}</span>
+          <span v-if="feature.notes?.[index]" class="note">{{ feature.notes[index] }}</span>
+        </td>
+      </tr>
+    </tbody>
+  </table>
+</template>
+
+<script setup lang="ts">
+interface Feature {
+  name: string;
+  support: boolean[];
+  notes?: string[];
+}
+
+defineProps<{
+  tools: string[];
+  features: Feature[];
+}>();
+
+function getSupportIcon(supported: boolean): string {
+  return supported ? "✓" : "✗";
+}
+
+function getSupportClass(supported: boolean): string {
+  return supported ? "supported" : "not-supported";
+}
+</script>
+
+<style scoped>
+.feature-comparison {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1rem 0;
+}
+
+.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;
+}
+
+.feature-name {
+  font-weight: 500;
+}
+
+.supported {
+  color: var(--vp-c-green-1);
+}
+
+.not-supported {
+  color: var(--vp-c-red-1);
+}
+
+.support-icon {
+  font-weight: bold;
+}
+
+.note {
+  display: block;
+  font-size: 0.85rem;
+  color: var(--vp-c-text-2);
+  margin-top: 0.25rem;
+}
+</style>

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

@@ -0,0 +1,98 @@
+<script setup>
+defineProps({
+  title: {
+    type: String,
+    default: 'Terminal'
+  }
+})
+</script>
+
+<template>
+  <div class="hero-code-block">
+    <div class="code-header">
+      <span class="dot"></span>
+      <span class="dot"></span>
+      <span class="dot"></span>
+      <span class="code-title">{{ title }}</span>
+    </div>
+    <div class="code-content"><slot /></div>
+  </div>
+</template>
+
+<style scoped>
+.hero-code-block {
+  background: var(--vp-c-bg-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  overflow: hidden;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+  max-width: 550px;
+  width: 100%;
+  font-size: 0.85rem;
+}
+
+@media (max-width: 768px) {
+  .hero-code-block {
+    max-width: 100%;
+    font-size: 0.8rem;
+  }
+}
+
+.code-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.75rem 1rem;
+  background: var(--vp-c-bg-alt);
+  border-bottom: 1px solid var(--vp-c-divider);
+}
+
+.dot {
+  width: 12px;
+  height: 12px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.dot:nth-child(1) { background: #ff5f56; }
+.dot:nth-child(2) { background: #ffbd2e; }
+.dot:nth-child(3) { background: #28c840; }
+
+.code-title {
+  margin-left: auto;
+  font-size: 0.8rem;
+  color: var(--vp-c-text-3);
+}
+
+.code-content {
+  margin: 0;
+  padding: 1.25rem;
+  font-family: var(--vp-font-family-mono);
+  font-size: inherit;
+  line-height: 1.7;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+}
+
+.code-content :deep(.line) {
+  display: block;
+}
+
+.code-content :deep(.prompt) {
+  color: var(--vp-c-brand-1);
+  font-weight: 500;
+}
+
+.code-content :deep(.success) {
+  color: #28c840;
+}
+
+.code-content :deep(.comment) {
+  color: var(--vp-c-text-3);
+  font-style: italic;
+}
+
+.code-content :deep(.cmd) {
+  font-weight: 600;
+}
+</style>

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'
+  }
+)
+```