eidotter 0.44.0 → 0.45.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/llms.txt CHANGED
@@ -3,7 +3,7 @@
3
3
  > DOS-themed React component library with authentic CGA/amber phosphor aesthetics.
4
4
 
5
5
  ## Quick Facts
6
- - 61 components (Accordion, AIText, Alert, Badge, Bench, Brand (Logo, Mark, Wordmark, BrandLockup), Breadcrumb, Button, CalendarHeatmap, Card, Chat (ChatMessage, ChatHistory, ChatInput, ChatContainer), Checkbox, ChecklistRow, CmdPalette, CommandPrompt, Connector, CopyButton, DecayStrip, DosDialog, DosFigure, DosWindow, EmptyState, FilterBar, Footer, Gauge, Header, HoldToComplete, Icon, IconButton, InlineExpand, InlineLink, Input, LabeledProgress, LedgerRow, LegalPage, Lightbox, Meter (MeterGroup), Modal, Nav, Notification, PageShell (PageSection), Progress, ProgressRing, RangeBar, RetroEffects, SectionHeading, Select, Separator, SeriesBars, Skeleton, Stat, Switch, Tabs, Tag, Terminal, TextScramble, TimelineContainer, TimelineFeed, TimelineNode, TimelinePage, VitalsStrip)
6
+ - 62 components (Accordion, AIText, Alert, Badge, Bench, Brand (Logo, Mark, Wordmark, BrandLockup), Breadcrumb, Button, CalendarHeatmap, Card, Chat (ChatMessage, ChatHistory, ChatInput, ChatContainer), Checkbox, ChecklistRow, CmdPalette, CommandPrompt, Connector, CopyButton, DecayStrip, DisplayMenu, DosDialog, DosFigure, DosWindow, EmptyState, FilterBar, Footer, Gauge, Header, HoldToComplete, Icon, IconButton, InlineExpand, InlineLink, Input, LabeledProgress, LedgerRow, LegalPage, Lightbox, Meter (MeterGroup), Modal, Nav, Notification, PageShell (PageSection), Progress, ProgressRing, RangeBar, RetroEffects, SectionHeading, Select, Separator, SeriesBars, Skeleton, Stat, Switch, Tabs, Tag, Terminal, TextScramble, TimelineContainer, TimelineFeed, TimelineNode, TimelinePage, VitalsStrip)
7
7
  - Amber theme is the default (amber-on-black phosphor CRT); a light theme ("amber in daylight") is in progress (DMNC-1058). Components paint via semantic roles so they re-theme — do not hardcode dark-only assumptions.
8
8
  - CSS custom properties + Tailwind preset
9
9
  - React 18/19, Tailwind 3/4 compatible
@@ -27,8 +27,8 @@ Apps default to the amber theme and offer the light theme via a consistent setti
27
27
 
28
28
  ## Upgrading
29
29
  - Every minor with breaking/visible changes ships a guide at `node_modules/eidotter/migrations/<version>.md` (index: `migrations/README.md`).
30
- - Read every guide between the installed and the target version, oldest first, and follow its checklist. Guides: `migrations/0.41.0.md`, `migrations/0.43.0.md`, `migrations/0.44.0.md`.
31
- - 0.x caret gotcha: `^0.40.x` never resolves to 0.41.0; bump the range explicitly, to `^0.44.0`.
30
+ - Read every guide between the installed and the target version, oldest first, and follow its checklist. Guides: `migrations/0.41.0.md`, `migrations/0.43.0.md`, `migrations/0.44.0.md`, `migrations/0.45.0.md`.
31
+ - 0.x caret gotcha: `^0.40.x` never resolves to 0.41.0; bump the range explicitly, to `^0.45.0`.
32
32
 
33
33
  ## Token Categories
34
34
  - `--color-semantic-*`: USE THESE for components (background, text, border, status)
@@ -0,0 +1,104 @@
1
+ # Upgrading to eidotter 0.45.0
2
+
3
+ From 0.44.x. Coming from older versions, read the earlier guides first
4
+ ([0.41.0](./0.41.0.md), [0.43.0](./0.43.0.md), [0.44.0](./0.44.0.md)).
5
+
6
+ 0.45.0 adds one shared theme control and changes how the Header brand behaves
7
+ on narrow screens.
8
+
9
+ ## Who must act
10
+
11
+ - Apps with a long `Header` brand on phones: check the header at 320px and 390px (section 2).
12
+ - Apps that put theme or display switches in the Header `end` slot: replace them with `DisplayMenu` (section 4).
13
+ - Everyone else: bump and glance at the Switch labels on the light theme (section 3).
14
+
15
+ ## 1. How to bump
16
+
17
+ ```bash
18
+ npm install eidotter@^0.45.0
19
+ npm ls eidotter # 0.45.0 or later
20
+ ```
21
+
22
+ Commit the lockfile.
23
+
24
+ ## 2. Visible: the brand title never wraps
25
+
26
+ **What changed.** 0.43 let a long brand wrap onto a second line. Now the
27
+ title always stays whole on one line, never wrapped and never cut short with
28
+ "…". When the row is too tight, a lockup or mark brand drops its logo icon
29
+ first, then the `end` slot clips. The MENU trigger never shrinks. Below 480px,
30
+ the gaps around the right-hand group are 8px instead of 16px.
31
+
32
+ **How to find it.** At 320px a title like "DMNC.TECH" or "EIDOTTER" next to
33
+ an end control and MENU now shows without its icon. A two-word title that
34
+ used to wrap is on one line.
35
+
36
+ **What to do.**
37
+
38
+ - Nothing, if the title fits on one line beside MENU.
39
+ - A title wider than the whole row (about 11 tracked characters plus MENU at
40
+ 320px) now overflows the page. Shorten `brandName`, or use
41
+ `brandCollapse="mark"` to show only the icon below 480px.
42
+ - CSS that relied on the icon coming first in the DOM: the name now comes
43
+ first (`.eidotter-header__brand-name`, then `.eidotter-header__brand-icon`);
44
+ the link lays them out in reverse, so it looks the same.
45
+
46
+ **How to verify.** At 320px and 390px the title is on one line, the page does
47
+ not scroll sideways, and controls in the `end` slot are whole.
48
+
49
+ ## 3. Visible: Switch labels follow the theme
50
+
51
+ The `Switch` label used the raw amber colour, which failed contrast on the
52
+ light theme. It now uses the brand text colour: unchanged on amber, dark
53
+ amber on light, ink on amber-paper. The label has a class,
54
+ `eidotter-switch__label`, if you need to style it.
55
+
56
+ ## 4. New: DisplayMenu, the one theme control
57
+
58
+ Put one `DisplayMenu` in the Header `end` slot instead of switches side by
59
+ side. It opens a small panel with one switch per option. Your app keeps the
60
+ state and applies it (for example `data-theme` on `<html>`).
61
+
62
+ ```tsx
63
+ import { Header, DisplayMenu } from 'eidotter';
64
+
65
+ const [dos, setDos] = useState(true);
66
+ const [paper, setPaper] = useState(false);
67
+
68
+ <Header
69
+ brandName="Example"
70
+ items={items}
71
+ end={
72
+ <DisplayMenu
73
+ items={[
74
+ { id: 'dos', label: 'DOS', checked: dos, onChange: setDos },
75
+ {
76
+ id: 'paper', label: 'Paper', checked: dos && paper, onChange: setPaper,
77
+ disabled: !dos, hint: dos ? undefined : 'Needs DOS on',
78
+ },
79
+ ]}
80
+ />
81
+ }
82
+ />
83
+ ```
84
+
85
+ - `label` (default `'Display'`) names the button and the panel.
86
+ - `labelDisplay`: `'responsive'` (default, icon only below 640px), `'icon'`, `'label'`.
87
+ - `placement`: `'bottom end'` (default), `'bottom start'`, `'bottom'`. `defaultOpen` for docs.
88
+ - Escape or a click outside closes the panel and returns focus to the button.
89
+ - It is a client component (`'use client'`); in a Next.js server component,
90
+ render it from a client wrapper.
91
+
92
+ ## 5. Fixed
93
+
94
+ - A heading inside a marked list item, paragraph or quote in `data-ai-block`
95
+ mode is no longer painted magenta.
96
+ - `LegalPage` body links wrap long URLs instead of widening the page.
97
+
98
+ ## Checklist
99
+
100
+ - [ ] `npm install eidotter@^0.45.0`; `npm ls eidotter` shows 0.45.0 or later. Commit the lockfile.
101
+ - [ ] Header at 320px and 390px: title on one line, no sideways scroll, end controls whole (section 2).
102
+ - [ ] Switch labels readable on every theme you offer (section 3).
103
+ - [ ] Replace side-by-side theme switches in the header with one `DisplayMenu` (section 4).
104
+ - [ ] Drop any site CSS that wrapped long LegalPage links or recoloured headings in AI-marked lists (section 5).
@@ -36,6 +36,7 @@ node_modules/eidotter/migrations/README.md
36
36
  node_modules/eidotter/migrations/0.41.0.md
37
37
  node_modules/eidotter/migrations/0.43.0.md
38
38
  node_modules/eidotter/migrations/0.44.0.md
39
+ node_modules/eidotter/migrations/0.45.0.md
39
40
  ```
40
41
 
41
42
  It is also exported, so tooling can resolve a guide by path:
@@ -48,3 +49,4 @@ It is also exported, so tooling can resolve a guide by path:
48
49
  | [0.41.0](./0.41.0.md) | 16px floor, CSS reset and unused utilities no longer leak, `text-secondary` meaning change, Header lockup default, overlays on `DosDialog` (removed classes), focus rings; adopt `IconButton`, `DosDialog`, `DosWindow`, the favicon export and the `amber-paper` theme |
49
50
  | [0.43.0](./0.43.0.md) | `Header` brand wraps instead of ellipsizing; adopt `PageShell`/`PageSection`, `Bench` and the opt-in `Header` `layout`/`rule`/`contained`/`brandCollapse` props |
50
51
  | [0.44.0](./0.44.0.md) | Headings never AI-marked; `PageShell` inherits background and font; one-word Header brand never splits; `CmdPalette` cursor removed; adopt `LegalPage` `embedded` |
52
+ | [0.45.0](./0.45.0.md) | Header brand title never wraps (the icon drops first); `Switch` label colour follows the theme; adopt `DisplayMenu` as the one theme control |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eidotter",
3
- "version": "0.44.0",
3
+ "version": "0.45.1",
4
4
  "type": "module",
5
5
  "description": "A DOS Themed Design System",
6
6
  "main": "./dist/index.umd.js",