eidotter 0.46.1 → 0.47.0

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.
Files changed (54) hide show
  1. package/README.md +8 -5
  2. package/dist/components/Brand/components/Wordmark.d.ts +2 -1
  3. package/dist/components/Brand/components/Wordmark.js +3 -2
  4. package/dist/components/CalendarHeatmap/components/CalendarHeatmap.d.ts +2 -2
  5. package/dist/components/CalendarHeatmap/components/CalendarHeatmap.js +2 -2
  6. package/dist/components/ChecklistRow/components/ChecklistRow.d.ts +1 -1
  7. package/dist/components/ChecklistRow/components/ChecklistRow.js +1 -1
  8. package/dist/components/CopyButton/components/CopyButton.d.ts +1 -1
  9. package/dist/components/CopyButton/components/CopyButton.js +1 -1
  10. package/dist/components/EmptyState/components/EmptyState.d.ts +1 -1
  11. package/dist/components/EmptyState/components/EmptyState.js +1 -1
  12. package/dist/components/Gauge/components/Gauge.js +1 -1
  13. package/dist/components/HoldToComplete/components/HoldToComplete.d.ts +1 -1
  14. package/dist/components/HoldToComplete/components/HoldToComplete.js +1 -1
  15. package/dist/components/LedgerRow/components/LedgerRow.d.ts +1 -1
  16. package/dist/components/LedgerRow/components/LedgerRow.js +1 -1
  17. package/dist/components/ProgressRing/components/ProgressRing.d.ts +1 -1
  18. package/dist/components/ProgressRing/components/ProgressRing.js +1 -1
  19. package/dist/components/RetroEffects/components/RetroEffects.d.ts +54 -0
  20. package/dist/components/RetroEffects/components/RetroEffects.js +124 -4
  21. package/dist/components/RetroEffects/components/index.d.ts +1 -1
  22. package/dist/components/RetroEffects/index.d.ts +1 -1
  23. package/dist/components/SectionHeading/components/SectionHeading.d.ts +1 -1
  24. package/dist/components/SectionHeading/components/SectionHeading.js +2 -2
  25. package/dist/components/Stat/components/Stat.js +1 -1
  26. package/dist/components/registry.d.ts +12 -1
  27. package/dist/components/registry.js +100 -98
  28. package/dist/eidotter.css +1 -1
  29. package/dist/index.d.ts +4 -3
  30. package/dist/index.es.js +689 -599
  31. package/dist/index.umd.js +1 -1
  32. package/dist/terminal/cga-amber.json +94 -0
  33. package/dist/terminal/cga-mode4-p0.json +94 -0
  34. package/dist/terminal/cga-mode4-p1.json +94 -0
  35. package/dist/terminal/cga-mode5.json +94 -0
  36. package/dist/terminal/dos-86.json +94 -0
  37. package/dist/utils/displayTheme.d.ts +32 -4
  38. package/dist/utils/displayTheme.js +33 -7
  39. package/guidelines/README.md +14 -2
  40. package/guidelines/components.md +9 -0
  41. package/guidelines/design-principles.md +1 -0
  42. package/guidelines/figma-architecture.md +1 -2
  43. package/guidelines/terminal-target.md +44 -0
  44. package/llms.txt +19 -19
  45. package/migrations/0.47.0.md +209 -0
  46. package/migrations/README.md +2 -0
  47. package/package.json +9 -3
  48. package/src/styles/dos-utilities.css +13 -3
  49. package/src/styles/shadcn.css +37 -2
  50. package/src/styles/theme.amber-paper.css +5 -1
  51. package/src/styles/theme.dos-86.css +79 -0
  52. package/src/styles/{theme.amber-mono.css → theme.pure-amber.css} +1 -1
  53. package/src/styles/tokens.css +44 -2
  54. package/tailwind.preset.cjs +4 -2
@@ -0,0 +1,94 @@
1
+ {
2
+ "name": "eiDotter cga-amber",
3
+ "roles": {
4
+ "screen": "#050300",
5
+ "text": "#FFB000",
6
+ "textDim": "#ADAAA5",
7
+ "textStrong": "#FDCA9F",
8
+ "decoration": "#9A5700",
9
+ "cursor": "#FFB000",
10
+ "selection": "#9A5700",
11
+ "raised": "#1A1000",
12
+ "error": "#FF5555",
13
+ "success": "#55FF55",
14
+ "warning": "#FFFF55",
15
+ "prompt": "#9999FF",
16
+ "info": "#00AAAA",
17
+ "addedFill": "#122010",
18
+ "removedFill": "#430500"
19
+ },
20
+ "ansi": {
21
+ "black": "#050300",
22
+ "red": "#FF5555",
23
+ "green": "#00AA00",
24
+ "yellow": "#FFFF55",
25
+ "blue": "#5555FF",
26
+ "magenta": "#FF55FF",
27
+ "cyan": "#00AAAA",
28
+ "white": "#FDCA9F",
29
+ "brightBlack": "#ADAAA5",
30
+ "brightRed": "#FF8888",
31
+ "brightGreen": "#55FF55",
32
+ "brightYellow": "#FFFF99",
33
+ "brightBlue": "#9999FF",
34
+ "brightMagenta": "#FF9AFF",
35
+ "brightCyan": "#55FFFF",
36
+ "brightWhite": "#FFFCF7"
37
+ },
38
+ "effects": {
39
+ "phosphor": {
40
+ "intensity": 1,
41
+ "persistence": "200ms",
42
+ "glow-radius": "40px",
43
+ "bloom-radius": "80px",
44
+ "bloom-intensity": 0.5,
45
+ "focus-blur": "0px",
46
+ "sampled-tight-radius": "1.6px",
47
+ "sampled-tight-intensity": 0.35,
48
+ "sampled-halo-radius": "4.5px",
49
+ "sampled-halo-intensity": 0.22
50
+ },
51
+ "scanline": {
52
+ "intensity": 0.6,
53
+ "line-pitch": "4px",
54
+ "scroll-period": "9000ms"
55
+ },
56
+ "flicker": {
57
+ "intensity": 0.04,
58
+ "period": "500ms"
59
+ },
60
+ "vignette": {
61
+ "intensity": 1,
62
+ "spread": 0.2
63
+ },
64
+ "mask": {
65
+ "intensity": 0
66
+ },
67
+ "preset": {
68
+ "long-reading": {
69
+ "scanline": {
70
+ "intensity": 0.2,
71
+ "line-pitch": "3px",
72
+ "scroll-period": "0ms"
73
+ },
74
+ "flicker": {
75
+ "intensity": 0
76
+ },
77
+ "mask": {
78
+ "intensity": 0.06
79
+ },
80
+ "vignette": {
81
+ "intensity": 0.22,
82
+ "spread": 0.2
83
+ },
84
+ "phosphor": {
85
+ "bloom-intensity": 0.22,
86
+ "sampled-tight-radius": "1.6px",
87
+ "sampled-tight-intensity": 0.35,
88
+ "sampled-halo-radius": "4.5px",
89
+ "sampled-halo-intensity": 0.22
90
+ }
91
+ }
92
+ }
93
+ }
94
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "name": "eiDotter cga-mode4-p0",
3
+ "roles": {
4
+ "screen": "#050300",
5
+ "text": "#FFFF00",
6
+ "textDim": "#FFFF00",
7
+ "textStrong": "#FFFF00",
8
+ "decoration": "#00FF00",
9
+ "cursor": "#FFFF00",
10
+ "selection": "#00FF00",
11
+ "raised": "#1A1000",
12
+ "error": "#FF0000",
13
+ "success": "#00FF00",
14
+ "warning": "#FFFF00",
15
+ "prompt": "#9999FF",
16
+ "info": "#00FF00",
17
+ "addedFill": "#050300",
18
+ "removedFill": "#050300"
19
+ },
20
+ "ansi": {
21
+ "black": "#050300",
22
+ "red": "#FF0000",
23
+ "green": "#00FF00",
24
+ "yellow": "#FFFF00",
25
+ "blue": "#00FF00",
26
+ "magenta": "#FF0000",
27
+ "cyan": "#00FF00",
28
+ "white": "#FFFF00",
29
+ "brightBlack": "#FFFF00",
30
+ "brightRed": "#FF8888",
31
+ "brightGreen": "#00FF00",
32
+ "brightYellow": "#FFFF99",
33
+ "brightBlue": "#9999FF",
34
+ "brightMagenta": "#FF9AFF",
35
+ "brightCyan": "#00FF00",
36
+ "brightWhite": "#FFFF00"
37
+ },
38
+ "effects": {
39
+ "phosphor": {
40
+ "intensity": 1,
41
+ "persistence": "200ms",
42
+ "glow-radius": "40px",
43
+ "bloom-radius": "80px",
44
+ "bloom-intensity": 0.5,
45
+ "focus-blur": "0px",
46
+ "sampled-tight-radius": "1.6px",
47
+ "sampled-tight-intensity": 0.35,
48
+ "sampled-halo-radius": "4.5px",
49
+ "sampled-halo-intensity": 0.22
50
+ },
51
+ "scanline": {
52
+ "intensity": 0.6,
53
+ "line-pitch": "4px",
54
+ "scroll-period": "9000ms"
55
+ },
56
+ "flicker": {
57
+ "intensity": 0.04,
58
+ "period": "500ms"
59
+ },
60
+ "vignette": {
61
+ "intensity": 1,
62
+ "spread": 0.2
63
+ },
64
+ "mask": {
65
+ "intensity": 0
66
+ },
67
+ "preset": {
68
+ "long-reading": {
69
+ "scanline": {
70
+ "intensity": 0.2,
71
+ "line-pitch": "3px",
72
+ "scroll-period": "0ms"
73
+ },
74
+ "flicker": {
75
+ "intensity": 0
76
+ },
77
+ "mask": {
78
+ "intensity": 0.06
79
+ },
80
+ "vignette": {
81
+ "intensity": 0.22,
82
+ "spread": 0.2
83
+ },
84
+ "phosphor": {
85
+ "bloom-intensity": 0.22,
86
+ "sampled-tight-radius": "1.6px",
87
+ "sampled-tight-intensity": 0.35,
88
+ "sampled-halo-radius": "4.5px",
89
+ "sampled-halo-intensity": 0.22
90
+ }
91
+ }
92
+ }
93
+ }
94
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "name": "eiDotter cga-mode4-p1",
3
+ "roles": {
4
+ "screen": "#050300",
5
+ "text": "#00FFFF",
6
+ "textDim": "#FFFCF7",
7
+ "textStrong": "#FFFCF7",
8
+ "decoration": "#00FFFF",
9
+ "cursor": "#00FFFF",
10
+ "selection": "#00FFFF",
11
+ "raised": "#1A1000",
12
+ "error": "#FF00FF",
13
+ "success": "#00FFFF",
14
+ "warning": "#FFFCF7",
15
+ "prompt": "#9999FF",
16
+ "info": "#00FFFF",
17
+ "addedFill": "#050300",
18
+ "removedFill": "#050300"
19
+ },
20
+ "ansi": {
21
+ "black": "#050300",
22
+ "red": "#FF00FF",
23
+ "green": "#00FFFF",
24
+ "yellow": "#FFFCF7",
25
+ "blue": "#00FFFF",
26
+ "magenta": "#FF00FF",
27
+ "cyan": "#00FFFF",
28
+ "white": "#FFFCF7",
29
+ "brightBlack": "#FFFCF7",
30
+ "brightRed": "#FF8888",
31
+ "brightGreen": "#00FFFF",
32
+ "brightYellow": "#FFFF99",
33
+ "brightBlue": "#9999FF",
34
+ "brightMagenta": "#FF9AFF",
35
+ "brightCyan": "#00FFFF",
36
+ "brightWhite": "#FFFCF7"
37
+ },
38
+ "effects": {
39
+ "phosphor": {
40
+ "intensity": 1,
41
+ "persistence": "200ms",
42
+ "glow-radius": "40px",
43
+ "bloom-radius": "80px",
44
+ "bloom-intensity": 0.5,
45
+ "focus-blur": "0px",
46
+ "sampled-tight-radius": "1.6px",
47
+ "sampled-tight-intensity": 0.35,
48
+ "sampled-halo-radius": "4.5px",
49
+ "sampled-halo-intensity": 0.22
50
+ },
51
+ "scanline": {
52
+ "intensity": 0.6,
53
+ "line-pitch": "4px",
54
+ "scroll-period": "9000ms"
55
+ },
56
+ "flicker": {
57
+ "intensity": 0.04,
58
+ "period": "500ms"
59
+ },
60
+ "vignette": {
61
+ "intensity": 1,
62
+ "spread": 0.2
63
+ },
64
+ "mask": {
65
+ "intensity": 0
66
+ },
67
+ "preset": {
68
+ "long-reading": {
69
+ "scanline": {
70
+ "intensity": 0.2,
71
+ "line-pitch": "3px",
72
+ "scroll-period": "0ms"
73
+ },
74
+ "flicker": {
75
+ "intensity": 0
76
+ },
77
+ "mask": {
78
+ "intensity": 0.06
79
+ },
80
+ "vignette": {
81
+ "intensity": 0.22,
82
+ "spread": 0.2
83
+ },
84
+ "phosphor": {
85
+ "bloom-intensity": 0.22,
86
+ "sampled-tight-radius": "1.6px",
87
+ "sampled-tight-intensity": 0.35,
88
+ "sampled-halo-radius": "4.5px",
89
+ "sampled-halo-intensity": 0.22
90
+ }
91
+ }
92
+ }
93
+ }
94
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "name": "eiDotter cga-mode5",
3
+ "roles": {
4
+ "screen": "#050300",
5
+ "text": "#00FFFF",
6
+ "textDim": "#FFFCF7",
7
+ "textStrong": "#FFFCF7",
8
+ "decoration": "#00FFFF",
9
+ "cursor": "#00FFFF",
10
+ "selection": "#00FFFF",
11
+ "raised": "#1A1000",
12
+ "error": "#FF0000",
13
+ "success": "#00FFFF",
14
+ "warning": "#FFFCF7",
15
+ "prompt": "#9999FF",
16
+ "info": "#00FFFF",
17
+ "addedFill": "#050300",
18
+ "removedFill": "#050300"
19
+ },
20
+ "ansi": {
21
+ "black": "#050300",
22
+ "red": "#FF0000",
23
+ "green": "#00FFFF",
24
+ "yellow": "#FFFCF7",
25
+ "blue": "#00FFFF",
26
+ "magenta": "#FF0000",
27
+ "cyan": "#00FFFF",
28
+ "white": "#FFFCF7",
29
+ "brightBlack": "#FFFCF7",
30
+ "brightRed": "#FF8888",
31
+ "brightGreen": "#00FFFF",
32
+ "brightYellow": "#FFFF99",
33
+ "brightBlue": "#9999FF",
34
+ "brightMagenta": "#FF9AFF",
35
+ "brightCyan": "#00FFFF",
36
+ "brightWhite": "#FFFCF7"
37
+ },
38
+ "effects": {
39
+ "phosphor": {
40
+ "intensity": 1,
41
+ "persistence": "200ms",
42
+ "glow-radius": "40px",
43
+ "bloom-radius": "80px",
44
+ "bloom-intensity": 0.5,
45
+ "focus-blur": "0px",
46
+ "sampled-tight-radius": "1.6px",
47
+ "sampled-tight-intensity": 0.35,
48
+ "sampled-halo-radius": "4.5px",
49
+ "sampled-halo-intensity": 0.22
50
+ },
51
+ "scanline": {
52
+ "intensity": 0.6,
53
+ "line-pitch": "4px",
54
+ "scroll-period": "9000ms"
55
+ },
56
+ "flicker": {
57
+ "intensity": 0.04,
58
+ "period": "500ms"
59
+ },
60
+ "vignette": {
61
+ "intensity": 1,
62
+ "spread": 0.2
63
+ },
64
+ "mask": {
65
+ "intensity": 0
66
+ },
67
+ "preset": {
68
+ "long-reading": {
69
+ "scanline": {
70
+ "intensity": 0.2,
71
+ "line-pitch": "3px",
72
+ "scroll-period": "0ms"
73
+ },
74
+ "flicker": {
75
+ "intensity": 0
76
+ },
77
+ "mask": {
78
+ "intensity": 0.06
79
+ },
80
+ "vignette": {
81
+ "intensity": 0.22,
82
+ "spread": 0.2
83
+ },
84
+ "phosphor": {
85
+ "bloom-intensity": 0.22,
86
+ "sampled-tight-radius": "1.6px",
87
+ "sampled-tight-intensity": 0.35,
88
+ "sampled-halo-radius": "4.5px",
89
+ "sampled-halo-intensity": 0.22
90
+ }
91
+ }
92
+ }
93
+ }
94
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "name": "eiDotter dos-86",
3
+ "roles": {
4
+ "screen": "#050300",
5
+ "text": "#FFB000",
6
+ "textDim": "#B87C1A",
7
+ "textStrong": "#FDCA9F",
8
+ "decoration": "#9A5700",
9
+ "cursor": "#FFB000",
10
+ "selection": "#9A5700",
11
+ "raised": "#1A1000",
12
+ "error": "#FF5555",
13
+ "success": "#55FF55",
14
+ "warning": "#FFFF55",
15
+ "prompt": "#9999FF",
16
+ "info": "#00AAAA",
17
+ "addedFill": "#122010",
18
+ "removedFill": "#430500"
19
+ },
20
+ "ansi": {
21
+ "black": "#050300",
22
+ "red": "#FF5555",
23
+ "green": "#00AA00",
24
+ "yellow": "#FFFF55",
25
+ "blue": "#5555FF",
26
+ "magenta": "#FF55FF",
27
+ "cyan": "#00AAAA",
28
+ "white": "#FDCA9F",
29
+ "brightBlack": "#B87C1A",
30
+ "brightRed": "#FF8888",
31
+ "brightGreen": "#55FF55",
32
+ "brightYellow": "#FFFF99",
33
+ "brightBlue": "#9999FF",
34
+ "brightMagenta": "#FF9AFF",
35
+ "brightCyan": "#55FFFF",
36
+ "brightWhite": "#FFFCF7"
37
+ },
38
+ "effects": {
39
+ "phosphor": {
40
+ "intensity": 1,
41
+ "persistence": "200ms",
42
+ "glow-radius": "40px",
43
+ "bloom-radius": "80px",
44
+ "bloom-intensity": 0.5,
45
+ "focus-blur": "0px",
46
+ "sampled-tight-radius": "1.6px",
47
+ "sampled-tight-intensity": 0.35,
48
+ "sampled-halo-radius": "4.5px",
49
+ "sampled-halo-intensity": 0.22
50
+ },
51
+ "scanline": {
52
+ "intensity": 0.6,
53
+ "line-pitch": "4px",
54
+ "scroll-period": "9000ms"
55
+ },
56
+ "flicker": {
57
+ "intensity": 0.04,
58
+ "period": "500ms"
59
+ },
60
+ "vignette": {
61
+ "intensity": 1,
62
+ "spread": 0.2
63
+ },
64
+ "mask": {
65
+ "intensity": 0
66
+ },
67
+ "preset": {
68
+ "long-reading": {
69
+ "scanline": {
70
+ "intensity": 0.2,
71
+ "line-pitch": "3px",
72
+ "scroll-period": "0ms"
73
+ },
74
+ "flicker": {
75
+ "intensity": 0
76
+ },
77
+ "mask": {
78
+ "intensity": 0.06
79
+ },
80
+ "vignette": {
81
+ "intensity": 0.22,
82
+ "spread": 0.2
83
+ },
84
+ "phosphor": {
85
+ "bloom-intensity": 0.22,
86
+ "sampled-tight-radius": "1.6px",
87
+ "sampled-tight-intensity": 0.35,
88
+ "sampled-halo-radius": "4.5px",
89
+ "sampled-halo-intensity": 0.22
90
+ }
91
+ }
92
+ }
93
+ }
94
+ }
@@ -8,33 +8,61 @@ import type { DisplayMenuItem } from '../components/DisplayMenu/index.js';
8
8
  * plus LIGHT (brightness). When modern has only one brightness, the LIGHT
9
9
  * row is hidden in modern mode: options that do not apply are hidden, not
10
10
  * shown disabled.
11
+ * - A pure variant (`dosPure`, opt-in): a PURE switch under DOS while LIGHT
12
+ * is off, for the monochrome Pure Amber next to the DOS dark theme. Hidden,
13
+ * never disabled, in every other state (DMNC-1643).
11
14
  */
12
15
  export interface DisplayThemes {
13
- /** DOS, dark screen. Default `'amber-mono'`. */
16
+ /**
17
+ * DOS, dark screen. Default `'dos-86'` (since DMNC-1643 PR E; it was
18
+ * `'amber-mono'`, Pure Amber). A site that keeps Pure Amber as its default
19
+ * passes `'pure-amber'` (`'amber-mono'` is the same theme, a deprecated name).
20
+ */
14
21
  dosDark?: string;
15
- /** DOS, light screen ("Eggyolk"). Default `'amber-paper'`; `null` for none. */
22
+ /**
23
+ * DOS, light screen ("Eggyolk"). Default follows the dark theme: `'dos-86-light'`
24
+ * when the resolved `dosDark` is `'dos-86'` (amber-paper with the body face, so
25
+ * toggling LIGHT does not change the width of the header), otherwise
26
+ * `'amber-paper'` (the display face, which Pure Amber uses). An explicit value is
27
+ * always used as given; `null` for none.
28
+ */
16
29
  dosLight?: string | null;
30
+ /**
31
+ * DOS, dark screen, pure variant: the theme the PURE switch picks, e.g.
32
+ * `'pure-amber'` on a site whose `dosDark` is `'dos-86'`. Default `null`:
33
+ * a site opts in, so no existing menu changes. The PURE row only appears
34
+ * when this names a different theme from `dosDark` (`amber-mono` and
35
+ * `pure-amber` count as the same theme).
36
+ */
37
+ dosPure?: string | null;
17
38
  /** Modern style, light. e.g. `'light'`. Omit for a DOS-only site. */
18
39
  modernLight?: string | null;
19
40
  /** Modern style, dark. Omit while no modern dark theme exists. */
20
41
  modernDark?: string | null;
21
42
  }
22
- /** The two switches: style (DOS or modern) and brightness. */
43
+ /** The switches: style (DOS or modern), brightness, and the pure variant. */
23
44
  export interface DisplayState {
24
45
  /** DOS style on (false = modern). Ignored on a DOS-only site. */
25
46
  dos: boolean;
26
47
  /** Light screen on. */
27
48
  light: boolean;
49
+ /**
50
+ * Pure variant on (DOS, dark screen only; needs `dosPure`). Optional so
51
+ * stored state from before DMNC-1643 keeps working: absent means off.
52
+ */
53
+ pure?: boolean;
28
54
  }
29
55
  /** Labels and hints for the rows; override to translate. */
30
56
  export interface DisplayLabels {
31
57
  dos?: string;
32
58
  light?: string;
59
+ pure?: string;
33
60
  }
34
61
  /**
35
62
  * The eidotter theme name for a display state. Set it as `data-theme` on
36
63
  * `<html>`. A state the site cannot show falls back to what it can (modern
37
- * with only a light theme is light whatever `light` says).
64
+ * with only a light theme is light whatever `light` says; `pure` without a
65
+ * `dosPure` theme is the DOS dark theme).
38
66
  */
39
67
  export declare function resolveDisplayTheme(state: DisplayState, themes?: DisplayThemes): string;
40
68
  /**
@@ -1,12 +1,23 @@
1
- const DEFAULT_THEMES = { dosDark: 'amber-mono', dosLight: 'amber-paper' };
1
+ const DEFAULT_THEMES = { dosDark: 'dos-86' };
2
+ /** The light theme a dark theme gets when `dosLight` is not given (DMNC-1643). */
3
+ const defaultDosLight = (dosDark) => (dosDark === 'dos-86' ? 'dos-86-light' : 'amber-paper');
2
4
  const DEFAULT_LABELS = {
3
5
  dos: 'DOS',
4
6
  light: 'Light',
7
+ pure: 'Pure',
5
8
  };
9
+ // Deprecated theme names and the theme they stand for (DMNC-1643). Mirrors
10
+ // scripts/lib/theme-aliases.mjs, which writes both names into one CSS rule.
11
+ const THEME_ALIASES = { 'amber-mono': 'pure-amber' };
12
+ const sameTheme = (a, b) => (THEME_ALIASES[a] ?? a) === (THEME_ALIASES[b] ?? b);
6
13
  function normalize(themes) {
14
+ const dosDark = themes.dosDark ?? DEFAULT_THEMES.dosDark;
15
+ const dosPure = themes.dosPure ?? null;
7
16
  return {
8
- dosDark: themes.dosDark ?? DEFAULT_THEMES.dosDark,
9
- dosLight: themes.dosLight === undefined ? DEFAULT_THEMES.dosLight : themes.dosLight,
17
+ dosDark,
18
+ dosLight: themes.dosLight === undefined ? defaultDosLight(dosDark) : themes.dosLight,
19
+ // A pure variant that is the dark theme itself offers nothing to switch.
20
+ dosPure: dosPure && !sameTheme(dosPure, dosDark) ? dosPure : null,
10
21
  modernLight: themes.modernLight ?? null,
11
22
  modernDark: themes.modernDark ?? null,
12
23
  };
@@ -14,13 +25,16 @@ function normalize(themes) {
14
25
  /**
15
26
  * The eidotter theme name for a display state. Set it as `data-theme` on
16
27
  * `<html>`. A state the site cannot show falls back to what it can (modern
17
- * with only a light theme is light whatever `light` says).
28
+ * with only a light theme is light whatever `light` says; `pure` without a
29
+ * `dosPure` theme is the DOS dark theme).
18
30
  */
19
31
  export function resolveDisplayTheme(state, themes = {}) {
20
32
  const t = normalize(themes);
21
33
  const hasModern = !!(t.modernLight || t.modernDark);
22
34
  if (!hasModern || state.dos) {
23
- return state.light && t.dosLight ? t.dosLight : t.dosDark;
35
+ if (state.light && t.dosLight)
36
+ return t.dosLight;
37
+ return state.pure && t.dosPure ? t.dosPure : t.dosDark;
24
38
  }
25
39
  if (t.modernLight && t.modernDark)
26
40
  return state.light ? t.modernLight : t.modernDark;
@@ -43,12 +57,24 @@ export function displayMenuItems(state, onChange, themes = {}, labels = {}) {
43
57
  if (inDos) {
44
58
  if (t.dosLight)
45
59
  items.push({ id: 'light', label: l.light, checked: state.light, onChange: setLight });
60
+ // PURE applies to the dark DOS screen only: shown while LIGHT is off (or
61
+ // the site has no DOS light theme), hidden otherwise (DMNC-1643).
62
+ const lightOn = state.light && !!t.dosLight;
63
+ if (t.dosPure && !lightOn) {
64
+ items.push({
65
+ id: 'pure',
66
+ label: l.pure,
67
+ checked: !!state.pure,
68
+ onChange: (pure) => onChange({ ...state, pure }),
69
+ });
70
+ }
46
71
  }
47
72
  else if (t.modernLight && t.modernDark) {
48
73
  items.push({ id: 'light', label: l.light, checked: state.light, onChange: setLight });
49
74
  }
50
- // Modern with one brightness: no LIGHT row. Options that do not apply in
51
- // the current mode are hidden, not shown disabled (eidotter rule, 0.46).
75
+ // Modern with one brightness: no LIGHT row; modern mode: no PURE row.
76
+ // Options that do not apply in the current mode are hidden, not shown
77
+ // disabled (eidotter rule, 0.46).
52
78
  return items;
53
79
  }
54
80
  /**
@@ -6,7 +6,7 @@ A DOS-themed React component library with authentic CGA/amber phosphor aesthetic
6
6
 
7
7
  eidotter provides 40 ready-to-use components with consistent DOS terminal styling:
8
8
 
9
- - **Dark theme only** - Amber-on-black phosphor CRT aesthetic
9
+ - **Amber phosphor first** - Amber-on-black phosphor CRT aesthetic; the default `dos-86` keeps functional colours honest, Pure Amber keeps everything amber, and `light` / `amber-paper` are the light screens
10
10
  - **CGA color palette** - 16 authentic CGA colors + amber extensions
11
11
  - **Monospace typography** - Perfect DOS VGA 437 (pixel-perfect-vector VGA font)
12
12
  - **Minimal rounded corners** - 2-4px max (DOS aesthetic)
@@ -104,9 +104,21 @@ Under the DOS themes, keep it that way. eidotter cannot stop you overriding font
104
104
  import 'eidotter/styles'; // All styles: fonts, tokens, components, Tailwind utilities
105
105
 
106
106
  // Optional: import a theme
107
- import 'eidotter/themes/amber-mono.css';
107
+ import 'eidotter/themes/cga-amber.css'; // dos-86 (the default) and Pure Amber (pure-amber, formerly amber-mono) are already bundled
108
108
  ```
109
109
 
110
+ **The default theme is `dos-86` (0.47).** Amber text with honest functional
111
+ colours (error red, success green, warning yellow, info cyan), component text
112
+ in the body face (JetBrains Mono Nerd Font; headings keep the display face)
113
+ and the calm long-reading CRT effects when a site mounts `RetroEffects`. The theme helpers
114
+ (`resolveDisplayTheme`, `displayMenuItems`) return it unless a site passes
115
+ another `dosDark`. To keep Pure Amber as a site's default, pass
116
+ `themes={{ dosDark: 'pure-amber' }}` and set `data-theme="pure-amber"` on
117
+ `<html>` at first paint (`migrations/0.47.0.md`). A page that sets no
118
+ `data-theme` gets the bare `:root` token defaults, unchanged since 0.46.
119
+ LIGHT on a `dos-86` site is `dos-86-light` (`amber-paper` with the body face, so
120
+ the header keeps its width); on any other dark theme it is `amber-paper`.
121
+
110
122
  Individual imports are still available if you need granular control (e.g., providing your own font or overriding tokens):
111
123
 
112
124
  ```tsx
@@ -675,6 +675,9 @@ CRT monitor visual effects overlay.
675
675
  | flicker | `boolean` | `true` | Subtle CRT flicker animation |
676
676
  | boot | `boolean` | `false` | Play the ~650ms CGA monitor turn-on once on mount (ignition line → raster opens → warm glow). Skipped under reduced motion |
677
677
  | intensity | `number` | `1` | Effect intensity (0-1) |
678
+ | preset | `'default' \| 'long-reading'` | `'default'` | Effect value set. `long-reading` is the DOS-86 monitor for long reading: still, faint scanlines, no flicker, faint aperture grille |
679
+ | mask | `boolean` | on under `long-reading` | Aperture grille layer; strength from `--effect-mask-intensity` (0 by default) |
680
+ | glowMode | `'element' \| 'sampled'` | `'element'` | `sampled` (opt-in) takes the glow from the rendered page with an SVG filter on the html element; falls back to the element path under reduced transparency, high contrast, the light grounds and without SVG filter support. Costly on long pages without GPU rasterisation |
678
681
 
679
682
  ### Examples
680
683
 
@@ -693,6 +696,12 @@ CRT monitor visual effects overlay.
693
696
 
694
697
  // Site launch: the monitor turns on (portfolio-wide pattern)
695
698
  <RetroEffects boot onBootComplete={() => startBootText()} />
699
+
700
+ // Text read for hours: the long-reading preset (or data-effects="long-reading" on an ancestor)
701
+ <RetroEffects preset="long-reading" />
702
+
703
+ // Glow sampled from the picture (opt-in; one per page)
704
+ <RetroEffects preset="long-reading" glowMode="sampled" />
696
705
  ```
697
706
 
698
707
  ---
@@ -38,6 +38,7 @@ eidotter's distinctive DOS aesthetic — principles for *this theme*:
38
38
  - **16-colour CGA palette** — "a historical fact, not a starting point" (via tokens).
39
39
  - **Single-weight typography** — no bold; emphasis via colour, uppercase, underline.
40
40
  - **Phosphor as physics, not decoration** — wired into state & lifecycle.
41
+ - **Glow is sampled from the picture wherever the platform allows** — light spills from every lit pixel in its own colour, as on a real tube: a pass over the rendered picture (the DOS-86 terminal shader, SwiftUI `layerEffect`, an SVG filter on a web page). Per-element glow (`text-shadow`, `box-shadow`) is the fallback where the platform cannot sample or the user asks for less (reduced transparency, high contrast), never the first choice. On the web it is opt-in today (`RetroEffects glowMode="sampled"`). (DMNC-1643)
41
42
  - **Square corners (≤4px), dark-only, monospace** — the constraints are the DOS identity.
42
43
 
43
44
  ### Modern theme (planned)