eidotter 0.41.3 → 0.42.0

package/guidelines/README.md

@@ -107,6 +107,43 @@ import 'eidotter/tokens.css';  // Design token CSS variables
 import 'eidotter/styles';      // Component CSS + Tailwind utilities
 ```
 
+### Fonts: what your build emits
+
+`eidotter/styles` declares two font families: the display tier (Perfect DOS
+VGA 437, one TTF, about 80 KB) and the body tier (JetBrains Mono Nerd Font,
+four woff2 files, about 1 MB each). Your bundler copies every file an
+`@font-face` rule points at into the build output, so the four woff2 files
+land in `dist/` even if no page uses the body tier.
+
+This is by design and costs no page weight: browsers download a font file
+only when text on the page uses that face. A page that never renders
+`font-dos-body`, `.dos-body`, `.dos-body-lg`, `.dos-caption`, `.dos-micro` or
+`var(--typography-font-family-body)` requests the TTF only. The cost is
+deploy size (about 4 MB of unused files).
+
+If deploy size matters and you never use the body tier, drop its four
+`@font-face` rules before your bundler resolves the CSS `url()`s. In Vite:
+
+```js
+// vite.config.js
+const dropEidotterBodyFonts = {
+  name: 'drop-eidotter-body-fonts',
+  enforce: 'pre',
+  transform(code, id) {
+    if (!/eidotter[\\/]dist[\\/]eidotter\.css/.test(id)) return null;
+    return code.replace(/@font-face\s*\{[^}]*JetBrains Mono Nerd Font[^}]*\}/g, '');
+  },
+};
+
+export default { plugins: [dropEidotterBodyFonts] };
+```
+
+Checked with Vite 8 on a page that imports only `eidotter/styles`: the build
+output drops from 4.2 MB to 268 KB, and only the TTF is emitted. Body-tier text
+then falls back to the system `monospace`. Other bundlers need the same step
+(remove the four rules from `node_modules/eidotter/dist/eidotter.css` before
+CSS `url()` resolution); eidotter has not tested a recipe for them.
+
 ### Tailwind Preset (optional)
 
 Use eidotter tokens as Tailwind classes in your own code:

package/guidelines/components.md

@@ -462,7 +462,7 @@ Navigation path showing location hierarchy.
 | currentLabel | `string` | - | **Required.** Current page label |
 | showBackArrow | `boolean` | `true` | Show < on last trail item |
 | separator | `string` | `'/'` | Custom separator |
-| linkComponent | `Component` | - | Custom link (e.g., Next.js Link) |
+| linkComponent | `NavLinkComponent` | - | Custom link (e.g., Next.js `Link`, passed directly with @types/react 18 or 19) |
 
 ### Examples
 
@@ -761,7 +761,7 @@ Sticky site header composing branding link + Nav. Supports retro/modern variants
 | activeHref | `string` | — | Currently active href (highlights matching nav link) |
 | variant | `'retro' \| 'modern'` | `'retro'` | Visual variant applied to both header and nav |
 | sticky | `boolean` | `true` | Whether the header sticks to viewport top |
-| linkComponent | `React.ElementType` | `'a'` | Custom link component for framework routing |
+| linkComponent | `NavLinkComponent` | `'a'` | Custom link component for framework routing (e.g., Next.js `Link`, no wrapper) |
 | children | `ReactNode` | — | Custom branding content (replaces brandName) |
 | className | `string` | — | Additional CSS class name |
 

package/llms.txt

@@ -28,7 +28,7 @@ Apps default to the amber theme and offer the light theme via a consistent setti
 ## Upgrading
 - Every minor with breaking/visible changes ships a guide at `node_modules/eidotter/migrations/<version>.md` (index: `migrations/README.md`).
 - Read every guide between the installed and the target version, oldest first, and follow its checklist. First guide: `migrations/0.41.0.md`.
-- 0.x caret gotcha: `^0.40.x` never resolves to 0.41.0; bump the range explicitly, to `^0.41.3` (0.41.0 shipped before its review fixes).
+- 0.x caret gotcha: `^0.40.x` never resolves to 0.41.0; bump the range explicitly, to `^0.42.0` (0.41.0 shipped before its review fixes).
 
 ## Token Categories
 - `--color-semantic-*`: USE THESE for components (background, text, border, status)
@@ -73,7 +73,7 @@ Apps default to the amber theme and offer the light theme via a consistent setti
 - Input: Text fields
 - DosDialog: The one overlay shell (CmdPalette chrome + dark title strip with yellow title); placement center/top, size sm/md/lg/full, head/footer slots
 - Modal: Dialog with title strip and close control, built on DosDialog
-- IconButton: The one icon-only control (pixel glyph in a thin square outline, hover inverts); size md 36 (all built-in controls) / window 28 (dense chrome), variant outline/bare, required label; used for every close, prev/next and window control
+- IconButton: The one icon-only control (pixel glyph in a thin square outline, hover inverts); size md 36 (all built-in controls) / window 28 (dense chrome) / touch 44 (stage-sized targets), variant outline/bare, tone accent (default) / inherit (currentColor, for coloured bars), required label; used for every close, prev/next and window control
 - DosWindow: In-page window chrome (DosDialog strip on a brand border + drop shadow), controls/footer slots, active/inactive; server-safe; DosFigure and Card are built on it
 - Progress: Loading/completion bars
 - RetroEffects: CRT scanlines, phosphor glow

package/migrations/0.41.0.md

@@ -61,7 +61,7 @@ cp node_modules/eidotter/dist/eidotter.css /tmp/eidotter-old.css
 Then change the range explicitly to the latest 0.41.x (0.41.3 or later):
 
 ```bash
-npm install eidotter@^0.41.3
+npm install eidotter@^0.42.0
 # check what actually resolved: 0.41.3 or later
 npm ls eidotter
 ```
@@ -917,7 +917,7 @@ Work top to bottom. Each step points at the section above that explains it.
 - [ ] Read every guide in `node_modules/eidotter/migrations/` between your old
       version and 0.41.0, oldest first (see `README.md` in that folder).
 - [ ] `cp node_modules/eidotter/dist/eidotter.css /tmp/eidotter-old.css` (before `npm install`).
-- [ ] Install the latest 0.41.x (0.41.3 or later): `npm install eidotter@^0.41.3`, then `npm ls eidotter` shows 0.41.3 or later. Commit the lockfile.
+- [ ] Install the latest 0.41.x (0.41.3 or later): `npm install eidotter@^0.42.0`, then `npm ls eidotter` shows 0.41.3 or later. Commit the lockfile.
 - [ ] Tailwind v4 apps: load eidotter in a cascade layer (`@layer theme, base, components, eidotter, utilities;` then `@import "eidotter/styles" layer(eidotter);`), drop the JS `import 'eidotter/styles'`, keep your own resets layered ("Tailwind v4 apps" after "How to bump").
 - [ ] No-Tailwind apps: run the class diff from section 2 and fix every real hit.
 - [ ] No-preflight apps: set `html` font, colours and `a` colour yourself (section 4).
@@ -945,9 +945,11 @@ additive or automatic unless noted. Details are in the eidotter
 [CHANGELOG](https://github.com/CinimoDY/eiDotter/blob/main/CHANGELOG.md). It is
 not shipped in the npm package; read it on GitHub.
 
-- **0.37.2:** two-tier typography. Display text stays Perfect DOS VGA
-  437 and body text (`.dos-body`, `font-dos-body`) is JetBrains Mono Nerd Font.
-  It shipped in 0.37.2; the CHANGELOG describes it under 0.38.0.
+- **0.37.2:** two-tier typography (DMNC-885). Display text stays Perfect DOS
+  VGA 437 and body text (`.dos-body`, `font-dos-body`) is JetBrains Mono Nerd
+  Font. The four body-tier woff2 files land in your build output from this
+  version on; see "Fonts: what your build emits" in `guidelines/README.md` if
+  you never use the body tier.
 - **0.38.0:** `article` entry kind for `TimelineContainer` (thumbnail strip and
   summary when collapsed; gallery, body and read-more when expanded). Additive.
 - **0.38.0:** `RetroEffects` `boot` no longer flashes content before the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eidotter",
-  "version": "0.41.3",
+  "version": "0.42.0",
   "type": "module",
   "description": "A DOS Themed Design System",
   "main": "./dist/index.umd.js",
@@ -149,12 +149,12 @@
     "@figma/plugin-typings": "^1.107.0-beta.2",
     "@figma/rest-api-spec": "^0.41.0",
     "@storybook/addon-a11y": "^10.2.7",
-    "@storybook/addon-designs": "^11.1.2",
+    "@storybook/addon-designs": "^12.0.0",
     "@storybook/addon-docs": "^10.2.7",
     "@storybook/addon-links": "^10.2.7",
     "@storybook/react": "^10.2.7",
     "@storybook/react-vite": "^10.2.7",
-    "@storybook/test-runner": "^0.24.3",
+    "@storybook/test-runner": "^0.26.0",
     "@tailwindcss/postcss": "^4.3.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.6.3",
@@ -167,7 +167,7 @@
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^6.0.2",
     "axe-playwright": "^2.2.2",
-    "chromatic": "^17.4.0",
+    "chromatic": "^18.13.0",
     "cross-env": "^10.1.0",
     "dotenv": "^17.3.1",
     "eslint": "^10.0.3",