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/README.md +4 -4
- package/dist/components/DisplayMenu/components/DisplayMenu.d.ts +51 -0
- package/dist/components/DisplayMenu/components/DisplayMenu.js +33 -0
- package/dist/components/DisplayMenu/components/index.d.ts +2 -0
- package/dist/components/DisplayMenu/components/index.js +1 -0
- package/dist/components/DisplayMenu/index.d.ts +2 -0
- package/dist/components/DisplayMenu/index.js +1 -0
- package/dist/components/Header/components/Header.js +5 -2
- package/dist/components/Switch/components/Switch.d.ts +4 -0
- package/dist/components/Switch/components/Switch.js +1 -1
- package/dist/components/registry.js +18 -0
- package/dist/eidotter.css +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.es.js +1481 -1261
- package/dist/index.umd.js +1 -1
- package/llms.txt +3 -3
- package/migrations/0.45.0.md +104 -0
- package/migrations/README.md +2 -0
- package/package.json +1 -1
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
|
-
-
|
|
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.
|
|
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).
|
package/migrations/README.md
CHANGED
|
@@ -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 |
|