eidotter 0.19.0 → 0.19.3

package/README.md

@@ -12,9 +12,7 @@ npm install eidotter
 
 ```tsx
 import { Terminal, Button, Alert } from 'eidotter';
-import 'eidotter/fonts.css';   // Flexi IBM VGA True @font-face (required)
-import 'eidotter/styles';      // Component CSS (includes Tailwind utilities)
-import 'eidotter/tokens.css';  // Design token CSS variables (required)
+import 'eidotter/styles';      // All styles: fonts, tokens, components
 
 function App() {
   return (
@@ -32,18 +30,29 @@ function App() {
 
 ### Basic (no Tailwind needed)
 
-Import the styles, tokens, and font. All component styling is pre-compiled — no build tools required.
+Import the styles. All component styling, fonts, and design tokens are pre-compiled — no build tools required.
 
 ```tsx
-import 'eidotter/fonts.css';   // Flexi IBM VGA True @font-face (required)
-import 'eidotter/styles';      // Component CSS (includes Tailwind utilities)
-import 'eidotter/tokens.css';  // CSS variable definitions
+import 'eidotter/styles';      // Fonts, tokens, components, Tailwind utilities
 
 // Optional: import a theme
 import 'eidotter/themes/amber-mono.css';
 ```
 
-**Font:** eiDotter uses [Flexi IBM VGA True v2](https://int10h.org/blog/2018/05/flexi-ibm-vga-scalable-truetype-font/) — an aspect-corrected vector remake of the IBM VGA BIOS font (CC BY-SA 4.0). The "True" variant matches authentic 4:3 VGA proportions with an extended character set (Greek, Cyrillic, Hebrew, Latin). The `fonts.css` import loads the bundled TTF via `@font-face`. No fallback fonts are configured so you'll immediately see if the font isn't loading.
+Individual imports are still available for granular control:
+
+```tsx
+import 'eidotter/fonts.css';   // Flexi IBM VGA True @font-face
+import 'eidotter/tokens.css';  // CSS variable definitions
+import 'eidotter/styles';      // Component CSS + Tailwind utilities
+```
+
+**Font:** eiDotter uses [Flexi IBM VGA True v2](https://int10h.org/blog/2018/05/flexi-ibm-vga-scalable-truetype-font/) — an aspect-corrected vector remake of the IBM VGA BIOS font (CC BY-SA 4.0). The "True" variant matches authentic 4:3 VGA proportions with an extended character set (Greek, Cyrillic, Hebrew, Latin). The `fonts.css` import loads the bundled TTF via `@font-face`.
+
+Two fontFamily tokens are exported, with distinct intent:
+
+- **`font-dos`** → `"Flexi IBM VGA True", monospace` — the default. Preserves the terminal aesthetic on degraded `@font-face` loads (strict CSP, web-fonts disabled, reader mode).
+- **`font-dos-fallback`** → `monospace` only — intentionally bare, as a **fail-loud diagnostic** utility for surfaces that want to surface font-loading failures explicitly. Compose `font-dos font-dos-fallback` when you want strict Flexi-or-nothing behavior.
 
 ### With Tailwind CSS
 
@@ -68,12 +77,19 @@ module.exports = {
 </div>
 ```
 
-For React Aria state variants and animations, use the enhanced preset:
+The preset auto-registers `tailwindcss-react-aria-components` and `tailwindcss-animate` via require-if-available. Consumers who already list either plugin in their own Tailwind config may see duplicate-variant warnings from Tailwind — either rely on the preset's registration alone, or pass those plugins explicitly in your config (they're idempotent, but the duplicate registration is noisy).
 
-```js
-presets: [require('eidotter/tailwind.preset.enhanced')],
+#### Migration from 0.19.1 and earlier
+
+In 0.19.2 the two older presets (`eidotter/tailwind.preset` and `eidotter/tailwind.preset.enhanced`) were merged into a single `eidotter/tailwind.preset` that includes all tokens plus the React Aria + animate plugins. The enhanced subpath is now a deprecated alias that logs a one-time `console.warn` on load and will be removed in 0.21.0:
+
+```diff
+- presets: [require('eidotter/tailwind.preset.enhanced')]
++ presets: [require('eidotter/tailwind.preset')]
 ```
 
+No behavior change — the merged preset already carries everything the enhanced preset used to add.
+
 ## Available Components (33)
 
 | Component | Description |