@heyramzi/ui 2.8.0 → 2.9.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 (115) hide show
  1. package/COMPONENTS.md +1 -1
  2. package/README.md +1 -1
  3. package/package.json +58 -74
  4. package/src/agents/vendor/draw.ts +4 -4
  5. package/src/canvas/headless/canvas-cleanup.test.ts +1 -1
  6. package/src/canvas/ops/ops.ts +1 -1
  7. package/src/charts/area-chart.svelte +11 -1
  8. package/src/charts/bar-chart.svelte +18 -3
  9. package/src/charts/line-chart.svelte +11 -1
  10. package/src/components/data-table/data-table.ts +4 -5
  11. package/src/components/data-table/pagination.svelte +5 -3
  12. package/src/components/docs/on-this-page.svelte +82 -5
  13. package/src/components/docs/scroll-spy.svelte.ts +6 -1
  14. package/src/components/list-page/detail-header.svelte +7 -3
  15. package/src/components/list-page/empty-state.svelte +3 -1
  16. package/src/components/list-page/filter-popover.svelte +2 -2
  17. package/src/components/list-page/rail-row.svelte +5 -2
  18. package/src/components/mark/mark.svelte +2 -1
  19. package/src/components/section-card/section-card.svelte +3 -1
  20. package/src/components/section-header/section-header.svelte +5 -5
  21. package/src/components/segmented/segment.svelte +1 -1
  22. package/src/components/table-view/table-view.svelte +6 -1
  23. package/src/components/tags-input/tags-input.svelte +1 -1
  24. package/src/components/toolbar/toolbar.svelte +1 -1
  25. package/src/editor/anchors.ts +28 -0
  26. package/src/editor/doc-blocks.ts +168 -0
  27. package/src/editor/doc-page.css +389 -0
  28. package/src/editor/editor.svelte +47 -5
  29. package/src/editor/extensions.ts +26 -2
  30. package/src/editor/markdown.ts +27 -2
  31. package/src/editor/slash-items.ts +18 -0
  32. package/src/icons/trades.ts +1 -1
  33. package/src/inbox/README.md +6 -4
  34. package/src/inbox/inbox.test.ts +1 -1
  35. package/src/inbox/index.ts +2 -2
  36. package/src/inbox/logic.ts +29 -5
  37. package/src/inbox/thread-inbox.svelte +219 -92
  38. package/src/inbox/types.ts +27 -1
  39. package/src/lib/initials.test.ts +25 -0
  40. package/src/lib/initials.ts +29 -0
  41. package/src/modules.test.ts +4 -64
  42. package/src/panel/README.md +1 -1
  43. package/src/record/README.md +1 -1
  44. package/src/record/info-list.svelte +5 -4
  45. package/src/record/next-up.svelte +1 -1
  46. package/src/record/project-list.svelte +1 -1
  47. package/src/record/steps-rail.svelte +3 -3
  48. package/src/shadcn/badge/badge.svelte +1 -1
  49. package/src/shadcn/card/card-title.svelte +1 -5
  50. package/src/shadcn/empty/empty-description.svelte +1 -1
  51. package/src/shadcn/progress/progress.svelte +8 -1
  52. package/src/shadcn/table/table-cell.svelte +10 -2
  53. package/src/status/README.md +1 -1
  54. package/src/thread/README.md +2 -0
  55. package/src/thread/index.ts +9 -1
  56. package/src/thread/logic.ts +33 -3
  57. package/src/thread/thread-body.svelte +37 -0
  58. package/src/thread/thread-events.svelte +30 -0
  59. package/src/thread/thread.svelte +74 -59
  60. package/src/thread/types.ts +21 -0
  61. package/src/{tasks → work}/README.md +11 -8
  62. package/src/{tasks → work}/detail/task-thread.svelte +8 -15
  63. package/src/work/docs/doc-editor-page.svelte +194 -0
  64. package/src/work/docs/doc-menu.svelte +333 -0
  65. package/src/work/docs/docs-demo.svelte +227 -0
  66. package/src/work/docs/edited-chip.svelte +125 -0
  67. package/src/work/docs/edited.ts +54 -0
  68. package/src/work/docs/index.ts +38 -0
  69. package/src/work/docs/labels.ts +70 -0
  70. package/src/work/docs/menu.ts +127 -0
  71. package/src/work/docs/outline.ts +60 -0
  72. package/src/{tasks → work}/gantt/gantt-group-row.svelte +1 -1
  73. package/src/{tasks → work}/inbox/inbox-card.svelte +113 -50
  74. package/src/work/inbox/inbox-logic.ts +98 -0
  75. package/src/work/inbox/inbox-trace.svelte +58 -0
  76. package/src/{tasks → work}/inbox/inbox-types.ts +2 -0
  77. package/src/{tasks → work}/index.ts +0 -10
  78. package/src/{tasks → work}/kanban-board.svelte +1 -1
  79. package/src/{tasks → work}/task-list.svelte +1 -1
  80. package/src/{tasks → work}/time/time-tracker.svelte +2 -5
  81. package/src/tasks/inbox/inbox-logic.ts +0 -21
  82. package/src/tasks/inbox/inbox-trace.svelte +0 -51
  83. /package/src/{tasks → work}/ambient.d.ts +0 -0
  84. /package/src/{tasks → work}/board-order.ts +0 -0
  85. /package/src/{tasks → work}/dates.ts +0 -0
  86. /package/src/{tasks → work}/demo.svelte +0 -0
  87. /package/src/{tasks → work}/detail/detail-demo.svelte +0 -0
  88. /package/src/{tasks → work}/detail/detail-types.ts +0 -0
  89. /package/src/{tasks → work}/detail/task-chip.svelte +0 -0
  90. /package/src/{tasks → work}/detail/task-detail.svelte +0 -0
  91. /package/src/{tasks → work}/detail/task-property.svelte +0 -0
  92. /package/src/{tasks → work}/gantt/gantt-bar.svelte +0 -0
  93. /package/src/{tasks → work}/gantt/gantt-grid.svelte +0 -0
  94. /package/src/{tasks → work}/gantt/gantt-header.svelte +0 -0
  95. /package/src/{tasks → work}/gantt/gantt-task-row.svelte +0 -0
  96. /package/src/{tasks → work}/gantt/gantt.css +0 -0
  97. /package/src/{tasks → work}/gantt/gantt.test.ts +0 -0
  98. /package/src/{tasks → work}/gantt/logic.test.ts +0 -0
  99. /package/src/{tasks → work}/gantt/logic.ts +0 -0
  100. /package/src/{tasks → work}/inbox/inbox-draft.svelte +0 -0
  101. /package/src/{tasks → work}/inbox/inbox-statuses.ts +0 -0
  102. /package/src/{tasks → work}/inbox/index.ts +0 -0
  103. /package/src/{tasks → work}/kanban-column.svelte +0 -0
  104. /package/src/{tasks → work}/kanban-drag.ts +0 -0
  105. /package/src/{tasks → work}/kanban-types.ts +0 -0
  106. /package/src/{tasks → work}/presets/sales.ts +0 -0
  107. /package/src/{tasks → work}/reorder.ts +0 -0
  108. /package/src/{tasks → work}/task-gantt.svelte +0 -0
  109. /package/src/{tasks → work}/task-types.ts +0 -0
  110. /package/src/{tasks → work}/time/duration.ts +0 -0
  111. /package/src/{tasks → work}/time/time-chip.svelte +0 -0
  112. /package/src/{tasks → work}/time/time-dot.svelte +0 -0
  113. /package/src/{tasks → work}/time/time-ring.svelte +0 -0
  114. /package/src/{tasks → work}/time/time-types.ts +0 -0
  115. /package/src/{tasks → work}/use-kanban-dnd.svelte.ts +0 -0
package/COMPONENTS.md CHANGED
@@ -139,6 +139,6 @@ Generic pieces built on the primitives, imported from `@heyramzi/ui/components/<
139
139
 
140
140
  ---
141
141
 
142
- Skipped on purpose: brand assets (logos, marks, brand renderer), kanban, list, gantt and status (they live in `@heyramzi/ui/tasks`), and charts
142
+ Skipped on purpose: brand assets (logos, marks, brand renderer), kanban, list, gantt and status (they live in `@heyramzi/ui/work`), and charts
143
143
  (they live in `@heyramzi/ui/charts`). The bot avatars
144
144
  are in `src/agents`, imported from `@heyramzi/ui/agents`.
package/README.md CHANGED
@@ -65,7 +65,7 @@ One package, six larger parts, each imported from its own subpath:
65
65
 
66
66
  | Subpath | What it is |
67
67
  | --- | --- |
68
- | `@heyramzi/ui/tasks` | Board, list, gantt, status badges, task detail, record, time tracker, inbox |
68
+ | `@heyramzi/ui/work` | Board, list, gantt, status badges, task detail, record, time tracker, inbox |
69
69
  | `@heyramzi/ui/charts` | LayerChart charts, sparklines, stat cards, and `/charts/dashboard` |
70
70
  | `@heyramzi/ui/slides` | Decks on a fixed canvas, plus `/slides/model` and `/slides/export` |
71
71
  | `@heyramzi/ui/editor` | The Tiptap editor, its renderer, `/editor/markdown`, `/editor/block-ops` |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@heyramzi/ui",
3
- "version": "2.8.0",
4
- "description": "Svelte 5 UI for apps: primitives, effects and animations, plus tasks, charts, slides, an editor, onboarding and a canvas as subpaths.",
3
+ "version": "2.9.0",
4
+ "description": "Svelte 5 UI for apps: primitives, effects and animations, plus work (tasks and docs), charts, slides, an editor, onboarding and a canvas as subpaths.",
5
5
  "homepage": "https://ui.heyramzi.com",
6
6
  "license": "MIT",
7
7
  "repository": {
@@ -28,6 +28,7 @@
28
28
  "types": "./src/index.ts",
29
29
  "default": "./src/index.ts"
30
30
  },
31
+ "./package.json": "./package.json",
31
32
  "./tokens.css": "./src/tokens/index.css",
32
33
  "./brand": {
33
34
  "svelte": "./src/brand/index.ts",
@@ -187,6 +188,7 @@
187
188
  "types": "./src/record/index.ts",
188
189
  "default": "./src/record/index.ts"
189
190
  },
191
+ "./record/demo.svelte": "./src/record/record-demo.svelte",
190
192
  "./thread": {
191
193
  "svelte": "./src/thread/index.ts",
192
194
  "types": "./src/thread/index.ts",
@@ -197,78 +199,58 @@
197
199
  "types": "./src/inbox/index.ts",
198
200
  "default": "./src/inbox/index.ts"
199
201
  },
200
- "./tasks": {
201
- "svelte": "./src/tasks/index.ts",
202
- "types": "./src/tasks/index.ts",
203
- "default": "./src/tasks/index.ts"
204
- },
205
- "./tasks/kanban": {
206
- "svelte": "./src/tasks/kanban-board.svelte",
207
- "types": "./src/tasks/kanban-board.svelte",
208
- "default": "./src/tasks/kanban-board.svelte"
209
- },
210
- "./tasks/list": {
211
- "svelte": "./src/tasks/task-list.svelte",
212
- "types": "./src/tasks/task-list.svelte",
213
- "default": "./src/tasks/task-list.svelte"
214
- },
215
- "./tasks/gantt": {
216
- "svelte": "./src/tasks/task-gantt.svelte",
217
- "types": "./src/tasks/task-gantt.svelte",
218
- "default": "./src/tasks/task-gantt.svelte"
219
- },
220
- "./tasks/status": {
221
- "svelte": "./src/status/status-badge.svelte",
222
- "types": "./src/status/status-badge.svelte",
223
- "default": "./src/status/status-badge.svelte"
224
- },
225
- "./tasks/status-dot": {
226
- "svelte": "./src/status/status-dot.svelte",
227
- "types": "./src/status/status-dot.svelte",
228
- "default": "./src/status/status-dot.svelte"
229
- },
230
- "./tasks/statuses": {
231
- "svelte": "./src/status/define-statuses.ts",
232
- "types": "./src/status/define-statuses.ts",
233
- "default": "./src/status/define-statuses.ts"
234
- },
235
- "./tasks/time": {
236
- "svelte": "./src/tasks/time/time-tracker.svelte",
237
- "types": "./src/tasks/time/time-tracker.svelte",
238
- "default": "./src/tasks/time/time-tracker.svelte"
239
- },
240
- "./tasks/inbox": {
241
- "svelte": "./src/tasks/inbox/index.ts",
242
- "types": "./src/tasks/inbox/index.ts",
243
- "default": "./src/tasks/inbox/index.ts"
244
- },
245
- "./tasks/side-panel": {
246
- "svelte": "./src/panel/side-panel.svelte",
247
- "types": "./src/panel/side-panel.svelte",
248
- "default": "./src/panel/side-panel.svelte"
249
- },
250
- "./tasks/presets/sales": {
251
- "svelte": "./src/tasks/presets/sales.ts",
252
- "types": "./src/tasks/presets/sales.ts",
253
- "default": "./src/tasks/presets/sales.ts"
254
- },
255
- "./tasks/detail": {
256
- "svelte": "./src/tasks/detail/task-detail.svelte",
257
- "types": "./src/tasks/detail/task-detail.svelte",
258
- "default": "./src/tasks/detail/task-detail.svelte"
259
- },
260
- "./tasks/detail-demo.svelte": "./src/tasks/detail/detail-demo.svelte",
261
- "./tasks/record": {
262
- "svelte": "./src/record/index.ts",
263
- "types": "./src/record/index.ts",
264
- "default": "./src/record/index.ts"
265
- },
266
- "./tasks/record-demo.svelte": "./src/record/record-demo.svelte",
267
- "./tasks/demo": {
268
- "svelte": "./src/tasks/demo.svelte",
269
- "default": "./src/tasks/demo.svelte"
270
- },
271
- "./tasks/demo.svelte": "./src/tasks/demo.svelte",
202
+ "./work": {
203
+ "svelte": "./src/work/index.ts",
204
+ "types": "./src/work/index.ts",
205
+ "default": "./src/work/index.ts"
206
+ },
207
+ "./work/kanban": {
208
+ "svelte": "./src/work/kanban-board.svelte",
209
+ "types": "./src/work/kanban-board.svelte",
210
+ "default": "./src/work/kanban-board.svelte"
211
+ },
212
+ "./work/list": {
213
+ "svelte": "./src/work/task-list.svelte",
214
+ "types": "./src/work/task-list.svelte",
215
+ "default": "./src/work/task-list.svelte"
216
+ },
217
+ "./work/gantt": {
218
+ "svelte": "./src/work/task-gantt.svelte",
219
+ "types": "./src/work/task-gantt.svelte",
220
+ "default": "./src/work/task-gantt.svelte"
221
+ },
222
+ "./work/time": {
223
+ "svelte": "./src/work/time/time-tracker.svelte",
224
+ "types": "./src/work/time/time-tracker.svelte",
225
+ "default": "./src/work/time/time-tracker.svelte"
226
+ },
227
+ "./work/inbox": {
228
+ "svelte": "./src/work/inbox/index.ts",
229
+ "types": "./src/work/inbox/index.ts",
230
+ "default": "./src/work/inbox/index.ts"
231
+ },
232
+ "./work/presets/sales": {
233
+ "svelte": "./src/work/presets/sales.ts",
234
+ "types": "./src/work/presets/sales.ts",
235
+ "default": "./src/work/presets/sales.ts"
236
+ },
237
+ "./work/detail": {
238
+ "svelte": "./src/work/detail/task-detail.svelte",
239
+ "types": "./src/work/detail/task-detail.svelte",
240
+ "default": "./src/work/detail/task-detail.svelte"
241
+ },
242
+ "./work/docs": {
243
+ "svelte": "./src/work/docs/index.ts",
244
+ "types": "./src/work/docs/index.ts",
245
+ "default": "./src/work/docs/index.ts"
246
+ },
247
+ "./work/docs-demo.svelte": "./src/work/docs/docs-demo.svelte",
248
+ "./work/detail-demo.svelte": "./src/work/detail/detail-demo.svelte",
249
+ "./work/demo": {
250
+ "svelte": "./src/work/demo.svelte",
251
+ "default": "./src/work/demo.svelte"
252
+ },
253
+ "./work/demo.svelte": "./src/work/demo.svelte",
272
254
  "./charts": {
273
255
  "svelte": "./src/charts/index.ts",
274
256
  "types": "./src/charts/index.ts",
@@ -365,7 +347,9 @@
365
347
  "@tiptap/core": "^3.32.0",
366
348
  "@tiptap/extension-drag-handle": "^3.32.0",
367
349
  "@tiptap/extension-image": "^3.32.0",
350
+ "@tiptap/extension-list": "^3.32.0",
368
351
  "@tiptap/extension-placeholder": "^3.32.0",
352
+ "@tiptap/extension-table": "^3.32.0",
369
353
  "@tiptap/pm": "^3.32.0",
370
354
  "@tiptap/starter-kit": "^3.32.0",
371
355
  "@zag-js/svelte": "^1.46.0",
@@ -102,9 +102,9 @@ const HALF_DEPTH = 15;
102
102
  const CAP = 0.9;
103
103
  const profile = (z: number, cap: number) => cap + (1 - cap) * Math.sqrt(Math.max(0, 1 - z * z));
104
104
 
105
- /* Big, plain dark eyes: they carry the face at 24px. */
105
+ /* Big, plain eyes, a little taller than wide: a round dot reads as a button at 24px. */
106
106
  const EYE_GAP = 25;
107
- const EYE_RX = 6.3;
107
+ const EYE_RX = 5.6;
108
108
  const EYE_Y = { eyes: 1, mouth: -3.5 } as const;
109
109
 
110
110
  interface Palette {
@@ -781,9 +781,9 @@ function drawFace(ctx: CanvasRenderingContext2D, pose: Pose, cfg: DrawConfig): [
781
781
  kSleep = ws;
782
782
  const x0 = kOpen * 0.01 + kShut * 5.4 + kLaugh * 6.2 + kSleep * 6;
783
783
  const y0 =
784
- kOpen * 1.1 * tall + kShut * 0.6 + kLaugh * (2.2 - lift * 1.5) + kSleep * (-1.4 + sag);
784
+ kOpen * 2 * tall + kShut * 0.6 + kLaugh * (2.2 - lift * 1.5) + kSleep * (-1.4 + sag);
785
785
  const cy =
786
- kOpen * -3.3 * tall + kShut * 0.6 + kLaugh * (-11.4 - 4 * lift) + kSleep * (5.4 + 2 * sag);
786
+ kOpen * -6 * tall + kShut * 0.6 + kLaugh * (-11.4 - 4 * lift) + kSleep * (5.4 + 2 * sag);
787
787
  const w = kOpen * EYE_RX * 2 * wide + kShut * 2.8 + kLaugh * 4.4 + kSleep * 4;
788
788
  /* the eyes drift toward the look when open, less so when shut */
789
789
  const dx = lx * (kOpen + 0.5 * (kShut + kLaugh)),
@@ -3,7 +3,7 @@ import { sortParentsFirst, stripCallbacks } from "./canvas-cleanup.js";
3
3
  import { makeNode } from "../test-utils.js";
4
4
  import type { CanvasNode } from "../types.js";
5
5
 
6
- /** Read serialized data as a loose record: these tests exercise legacy fields
6
+ /** Read serialized data as a loose record: these tests exercise old fields
7
7
  * that are no longer part of any per-type shape but must survive the denylist. */
8
8
  function loose(node: { data: unknown }): Record<string, unknown> {
9
9
  return node.data as Record<string, unknown>;
@@ -36,7 +36,7 @@ export const patchNodeOp = z.object({
36
36
  kind: z.literal("patchNode"),
37
37
  nodeId: z.string().min(1),
38
38
  data: z.record(z.string(), z.unknown()).optional(),
39
- // Merged into the node's style object. A legacy CSS-string style is replaced
39
+ // Merged into the node's style object. A CSS-string style from an old save is replaced
40
40
  // wholesale (there is nothing sane to merge into).
41
41
  style: z.record(z.string(), z.unknown()).optional(),
42
42
  width: z.number().optional(),
@@ -114,6 +114,16 @@
114
114
  const fadeMask = $derived(fade > 0 ? `url(#${uid}-fade)` : undefined);
115
115
  const fallback = $derived(data.length > 0 ? data[data.length - 1] : null);
116
116
  const display = $derived(active ?? fallback);
117
+
118
+ // A long tick label ("1,000,000") falls back to "1M" so the left gutter holds it.
119
+ const compact = new Intl.NumberFormat(undefined, {
120
+ notation: "compact",
121
+ maximumFractionDigits: 1,
122
+ });
123
+ function valueTick(v: number): string {
124
+ const full = formatValue(v);
125
+ return full.length > 6 && Number.isFinite(v) ? compact.format(v) : full;
126
+ }
117
127
  const figureRows = $derived(
118
128
  display
119
129
  ? series.map((s) => ({ value: Number(display[s.key]), label: s.label, color: s.color }))
@@ -158,7 +168,7 @@
158
168
  motion={DOMAIN_MOTION}
159
169
  >
160
170
  <Svg>
161
- <Axis placement="left" format={(v) => formatValue(Number(v))} ticks={4} />
171
+ <Axis placement="left" format={(v) => valueTick(Number(v))} ticks={4} />
162
172
  <Axis placement="bottom" format={(v) => formatX(v)} ticks={xTicks} />
163
173
  <g class="hr-area-grid">
164
174
  <Axis placement="left" grid rule={false} ticks={4} format={() => ""} />
@@ -75,7 +75,11 @@
75
75
  // =========================
76
76
  let active = $state<TData | null>(null);
77
77
 
78
- // ========================= FUNCTIONS ========================= WHY: called from the tooltip header's value expression so it re-runs on every active-band change; an unread {@const} side effect only evaluates once.
78
+ // =========================
79
+ // FUNCTIONS
80
+ // =========================
81
+
82
+ // WHY: the tooltip header calls this so it re-runs per active band; an unread {@const} runs once.
79
83
 
80
84
  // The microtask defers the state write out of template evaluation.
81
85
  function trackActive(d: TData): string {
@@ -128,6 +132,17 @@
128
132
  return [...groups].map(([c, rows]) => ({ key: c, color: c, rows, at: undefined }));
129
133
  });
130
134
  const activeColor = $derived(active && colorOf ? colorOf(active) : color);
135
+
136
+ // WHY: "1,000,000" overflows the 48px gutter and the gap between ticks, so a long label
137
+ // falls back to "1M"; the tooltip keeps the full value.
138
+ const compact = new Intl.NumberFormat(undefined, {
139
+ notation: "compact",
140
+ maximumFractionDigits: 1,
141
+ });
142
+ function valueTick(v: number): string {
143
+ const full = formatValue(v);
144
+ return full.length > 6 && Number.isFinite(v) ? compact.format(v) : full;
145
+ }
131
146
  </script>
132
147
 
133
148
  <!-- =========================== -->
@@ -172,12 +187,12 @@
172
187
  <Svg>
173
188
  {#if horizontal}
174
189
  <Axis placement="left" format={(v) => (formatTick ?? formatX)(v)} />
175
- <Axis placement="bottom" format={(v) => formatValue(Number(v))} ticks={4} />
190
+ <Axis placement="bottom" format={(v) => valueTick(Number(v))} ticks={4} />
176
191
  <g class="hr-bar-grid">
177
192
  <Axis placement="bottom" grid rule={false} ticks={4} format={() => ""} />
178
193
  </g>
179
194
  {:else}
180
- <Axis placement="left" format={(v) => formatValue(Number(v))} ticks={4} />
195
+ <Axis placement="left" format={(v) => valueTick(Number(v))} ticks={4} />
181
196
  <Axis placement="bottom" format={(v) => (formatTick ?? formatX)(v)} />
182
197
  <g class="hr-bar-grid">
183
198
  <Axis placement="left" grid rule={false} ticks={4} format={() => ""} />
@@ -117,6 +117,16 @@
117
117
  const fadeMask = $derived(fade > 0 ? `url(#${uid}-fade)` : undefined);
118
118
  const fallback = $derived(data.length > 0 ? data[data.length - 1] : null);
119
119
  const display = $derived(active ?? fallback);
120
+
121
+ // A long tick label ("1,000,000") falls back to "1M" so the left gutter holds it.
122
+ const compact = new Intl.NumberFormat(undefined, {
123
+ notation: "compact",
124
+ maximumFractionDigits: 1,
125
+ });
126
+ function valueTick(v: number): string {
127
+ const full = formatValue(v);
128
+ return full.length > 6 && Number.isFinite(v) ? compact.format(v) : full;
129
+ }
120
130
  // WHY: a dashed tail is two splines sharing the boundary point so the solid
121
131
  // and dashed segments meet without a gap.
122
132
  const hasTail = $derived(
@@ -189,7 +199,7 @@
189
199
  motion={DOMAIN_MOTION}
190
200
  >
191
201
  <Svg>
192
- <Axis placement="left" format={(v) => formatValue(Number(v))} ticks={4} />
202
+ <Axis placement="left" format={(v) => valueTick(Number(v))} ticks={4} />
193
203
  <Axis placement="bottom" format={(v) => formatX(v)} />
194
204
  <g class="hr-line-grid">
195
205
  <Axis placement="left" grid rule={false} ticks={4} format={() => ""} />
@@ -69,9 +69,8 @@ export function totalPages(total: number, pageSize: number): number {
69
69
 
70
70
  export function formatCount(visible: number, total: number, label: string): string {
71
71
  const singular = label.endsWith("s") ? label.slice(0, -1) : label;
72
- if (visible === total) {
73
- const displayLabel = visible === 1 ? singular : label;
74
- return `${total} ${displayLabel}`;
75
- }
76
- return `${visible} of ${total} ${label}`;
72
+ // The noun agrees with the total: "0 of 1 item", not "0 of 1 items".
73
+ const noun = total === 1 ? singular : label;
74
+ if (visible === total) return `${total.toLocaleString()} ${noun}`;
75
+ return `${visible.toLocaleString()} of ${total.toLocaleString()} ${noun}`;
77
76
  }
@@ -26,7 +26,9 @@
26
26
 
27
27
  {#if pages > 1}
28
28
  <div class="flex items-center justify-between border-t px-4 py-3 text-sm text-muted-foreground">
29
- <span>{start}-{end} of {total}</span>
29
+ <span class="tabular-nums"
30
+ >{start.toLocaleString()}-{end.toLocaleString()} of {total.toLocaleString()}</span
31
+ >
30
32
  <div class="flex items-center gap-1">
31
33
  {#if buildHref}
32
34
  {#if hasPrev}
@@ -38,7 +40,7 @@
38
40
  <CaretLeft class="size-4" />
39
41
  </Button>
40
42
  {/if}
41
- <span class="mx-2 tabular-nums">{page} / {pages}</span>
43
+ <span class="mx-2 tabular-nums">{page.toLocaleString()} / {pages.toLocaleString()}</span>
42
44
  {#if hasNext}
43
45
  <Button variant="outline" size="sm" icon href={buildHref(page + 1)}>
44
46
  <CaretRight class="size-4" />
@@ -58,7 +60,7 @@
58
60
  >
59
61
  <CaretLeft class="size-4" />
60
62
  </Button>
61
- <span class="mx-2 tabular-nums">{page} / {pages}</span>
63
+ <span class="mx-2 tabular-nums">{page.toLocaleString()} / {pages.toLocaleString()}</span>
62
64
  <Button
63
65
  variant="outline"
64
66
  size="sm"
@@ -17,10 +17,10 @@
17
17
  label: string;
18
18
  onselect: (id: string) => void;
19
19
  /**
20
- * `rail` is the column beside the document. `bar` is the strip that takes
21
- * its place on a narrow pane: it names where you are and opens the list.
20
+ * `rail` sits beside the document, `bar` replaces it on a narrow pane, and `ticks` marks
21
+ * each heading in the gutter with a card of headings on hover or focus.
22
22
  */
23
- variant?: "rail" | "bar";
23
+ variant?: "rail" | "bar" | "ticks";
24
24
  }
25
25
 
26
26
  // =========================
@@ -28,6 +28,10 @@
28
28
  // =========================
29
29
  let { items, active, label, onselect, variant = "rail" }: Props = $props();
30
30
 
31
+ let hovering = $state(false);
32
+ let focusing = $state(false);
33
+ let showCard = $derived(hovering || focusing);
34
+
31
35
  // =========================
32
36
  // STATE
33
37
  // =========================
@@ -101,7 +105,63 @@
101
105
  <!-- =========================== -->
102
106
  <!-- MARKUP -->
103
107
  <!-- =========================== -->
104
- {#if variant === "rail"}
108
+ {#if variant === "ticks"}
109
+ <nav
110
+ aria-label={label}
111
+ class="otp-ticks relative"
112
+ onpointerenter={() => (hovering = true)}
113
+ onpointerleave={() => (hovering = false)}
114
+ onfocusin={() => (focusing = true)}
115
+ onfocusout={(event) => {
116
+ if (!event.currentTarget.contains(event.relatedTarget as Node | null)) focusing = false;
117
+ }}
118
+ >
119
+ <ul class="flex flex-col py-2">
120
+ {#each items as item (item.id)}
121
+ {@const current = item.id === active}
122
+ <li>
123
+ <button
124
+ type="button"
125
+ aria-label={item.label}
126
+ aria-current={current ? "location" : undefined}
127
+ onclick={() => pick(item.id)}
128
+ class="otp-tick group/tick flex h-3.5 w-7 items-center pl-2 any-pointer-coarse:h-6"
129
+ >
130
+ <span
131
+ class="block h-0.5 rounded-full transition-[width,background-color] duration-[var(--duration-fast)] ease-[var(--ease-smooth-out)] {current
132
+ ? 'w-3 bg-foreground'
133
+ : 'w-2 bg-foreground/25 group-hover/tick:bg-foreground/60'}"
134
+ ></span>
135
+ </button>
136
+ </li>
137
+ {/each}
138
+ </ul>
139
+ <!-- The card starts inside the nav's own box, so moving from a tick onto it never leaves
140
+ the hover. Rows are for the pointer; the ticks are the keyboard path. -->
141
+ <div
142
+ inert={!showCard}
143
+ data-open={showCard}
144
+ class="otp-card thin-scrollbar absolute left-full top-1/2 z-30 max-h-[min(70svh,28rem)] w-max min-w-44 max-w-64 overflow-y-auto rounded-xl bg-popover p-1.5 shadow-raised ring-1 ring-foreground/10"
145
+ >
146
+ {#each items as item (item.id)}
147
+ {@const current = item.id === active}
148
+ <button
149
+ type="button"
150
+ tabindex="-1"
151
+ onclick={() => pick(item.id)}
152
+ class="block w-full truncate rounded-md py-1 pr-3 text-left text-[13px] leading-5 transition-colors duration-[var(--duration-fast)] ease-[var(--ease-smooth-out)] hover:bg-foreground/6 {item.level ===
153
+ 3
154
+ ? 'pl-5'
155
+ : 'pl-2'} {current
156
+ ? 'font-medium text-foreground'
157
+ : 'text-muted-foreground hover:text-foreground'}"
158
+ >
159
+ {item.label}
160
+ </button>
161
+ {/each}
162
+ </div>
163
+ </nav>
164
+ {:else if variant === "rail"}
105
165
  <nav aria-label={label} class="flex max-h-[calc(100svh-8rem)] flex-col gap-3">
106
166
  <!-- Set like the map's own headings on the left, so the two rails read as one. -->
107
167
  <p class="font-heading text-xs font-semibold uppercase tracking-wider text-muted-foreground">
@@ -221,9 +281,26 @@
221
281
  );
222
282
  }
223
283
 
284
+ /* Opacity and a short slide, no scale: the card is anchored to a line of ticks. */
285
+ .otp-card {
286
+ opacity: 0;
287
+ translate: -4px -50%;
288
+ pointer-events: none;
289
+ transition:
290
+ opacity var(--duration-fast) var(--ease-smooth-out),
291
+ translate var(--duration-fast) var(--ease-smooth-out);
292
+ }
293
+
294
+ .otp-card[data-open="true"] {
295
+ opacity: 1;
296
+ translate: 0 -50%;
297
+ pointer-events: auto;
298
+ }
299
+
224
300
  @media (prefers-reduced-motion: reduce) {
225
301
  .otp-marker.is-ready,
226
- .otp-progress {
302
+ .otp-progress,
303
+ .otp-card {
227
304
  transition: none;
228
305
  }
229
306
  }
@@ -3,7 +3,12 @@
3
3
  * side rail and the compact bar, so the two can never disagree.
4
4
  */
5
5
 
6
- export type DocHeading = { id: string; label: string };
6
+ export type DocHeading = {
7
+ id: string;
8
+ label: string;
9
+ /** 2 or 3. A list with no levels is flat; the edge ticks indent a 3 under its 2. */
10
+ level?: 2 | 3;
11
+ };
7
12
 
8
13
  /**
9
14
  * A heading's offset in scroller coordinates. A framed document must supply its own, since
@@ -77,14 +77,18 @@
77
77
  flex sibling it wrapped to its own row on every two-line title. -->
78
78
  <!-- No text-balance: it evens the lines out, so a two-line title stopped
79
79
  short of the corner instead of running the full width. -->
80
- <h2 class="min-w-0 font-heading text-lg font-semibold leading-snug tracking-tight">
80
+ <h2
81
+ class="min-w-0 font-heading text-lg [overflow-wrap:anywhere] font-semibold leading-snug tracking-tight"
82
+ >
81
83
  {title}{#if badge}<span class="ms-2 inline-flex align-middle">{@render badge()}</span>{/if}
82
84
  </h2>
83
85
  {#if facts.length > 0}
84
86
  <!-- Each dot hangs off the fact it leads, so a wrapped line's dot stays
85
87
  in the gutter. A standalone flex-item dot dangled on the line above. -->
86
88
  <div class="mt-1 overflow-hidden">
87
- <p class="-ms-3 flex flex-wrap items-center text-sm text-muted-foreground">
89
+ <p
90
+ class="-ms-3 flex flex-wrap items-center text-sm text-muted-foreground [overflow-wrap:anywhere]"
91
+ >
88
92
  {#each facts as fact, i (i)}
89
93
  <span
90
94
  class="relative ps-3 before:absolute before:start-1 before:opacity-40 before:content-['·']"
@@ -95,7 +99,7 @@
95
99
  </div>
96
100
  {/if}
97
101
  {#if note}
98
- <p class="mt-1 text-sm text-muted-foreground">{note}</p>
102
+ <p class="mt-1 text-sm text-muted-foreground [overflow-wrap:anywhere]">{note}</p>
99
103
  {/if}
100
104
  <!-- With a picture or a corner, actions sit in this column. Pinned right
101
105
  they wrapped under the picture and read like its caption. -->
@@ -45,7 +45,9 @@
45
45
  <Icon weight={iconWeight} class="size-8" />
46
46
  </Empty.Media>
47
47
  {/if}
48
- <Empty.Title class="font-heading text-lg font-semibold">{title}</Empty.Title>
48
+ <Empty.Title class="font-heading text-lg font-semibold [overflow-wrap:anywhere]"
49
+ >{title}</Empty.Title
50
+ >
49
51
  {#if description}
50
52
  <Empty.Description>{description}</Empty.Description>
51
53
  {/if}
@@ -71,9 +71,9 @@
71
71
  {/if}
72
72
  {#if hasCount}
73
73
  <span
74
- class="ml-0.5 inline-flex size-4 items-center justify-center rounded-full bg-brand/15 text-[10px] font-semibold text-brand dark:text-brand-light"
74
+ class="ml-0.5 inline-flex h-4 min-w-4 items-center justify-center rounded-full bg-brand/15 px-1 text-[10px] tabular-nums font-semibold text-brand dark:text-brand-light"
75
75
  >
76
- {count}
76
+ {count.toLocaleString()}
77
77
  </span>
78
78
  {/if}
79
79
  </Popover.Trigger>
@@ -122,6 +122,7 @@
122
122
  titleLines === 2 ? "line-clamp-2" : "truncate",
123
123
  selected && "text-accent-foreground",
124
124
  )}
125
+ {title}
125
126
  >
126
127
  {title}
127
128
  </span>
@@ -130,7 +131,7 @@
130
131
  {#if preview || trailing}
131
132
  <span class="flex min-w-0 items-center text-xs text-muted-foreground">
132
133
  {#if preview}
133
- <span class="truncate">{preview}</span>
134
+ <span class="truncate" title={preview}>{preview}</span>
134
135
  {/if}
135
136
  {#if trailing}
136
137
  <span class="ml-auto flex shrink-0 items-center gap-1.5 pl-2">{@render trailing()}</span
@@ -146,7 +147,9 @@
146
147
  {/if}
147
148
  {@const flexible =
148
149
  facts.length > 1 && i === (metaTruncate === "last" ? facts.length - 1 : 0)}
149
- <span class={flexible ? "truncate" : "shrink-0"}>{fact}</span>
150
+ <span class={flexible ? "truncate" : "shrink-0"} title={flexible ? fact : undefined}
151
+ >{fact}</span
152
+ >
150
153
  {/each}
151
154
  {#if metaTrail}
152
155
  <span class="ml-1.5 flex shrink-0 items-center gap-1">{@render metaTrail()}</span>
@@ -3,6 +3,7 @@
3
3
  // IMPORTS
4
4
  // =========================
5
5
  import { cn } from "../../lib/utils.js";
6
+ import { initial } from "../../lib/initials.js";
6
7
 
7
8
  // =========================
8
9
  // TYPES
@@ -61,6 +62,6 @@
61
62
  className,
62
63
  )}
63
64
  >
64
- {label.charAt(0)}
65
+ {initial(label, "")}
65
66
  </span>
66
67
  {/if}
@@ -32,7 +32,9 @@
32
32
  <!-- =========================== -->
33
33
  <Card.Root class={cn("gap-0 py-0", className)}>
34
34
  <header class="flex min-h-14 items-center justify-between gap-3 border-b px-4 py-3 sm:px-6">
35
- <Card.Title as="h3" class="text-base font-medium">{title}</Card.Title>
35
+ <Card.Title as="h3" class="min-w-0 text-base font-medium [overflow-wrap:anywhere]"
36
+ >{title}</Card.Title
37
+ >
36
38
  {#if actions}
37
39
  <div class="flex shrink-0 items-center gap-2">{@render actions()}</div>
38
40
  {/if}
@@ -34,18 +34,18 @@
34
34
  <header class="flex items-end justify-between gap-3">
35
35
  <div class="min-w-0 space-y-1">
36
36
  <svelte:element this={`h${level}`} class="flex items-center gap-2">
37
- <SectionLabel>{title}</SectionLabel>
37
+ <SectionLabel class="min-w-0 [overflow-wrap:anywhere]">{title}</SectionLabel>
38
38
  {#if count !== undefined}
39
39
  <span
40
- class="rounded-md bg-muted px-1.5 py-0.5 text-xs leading-none font-medium tabular-nums text-muted-foreground"
41
- aria-label={`${count} ${countLabel}`}
40
+ class="shrink-0 rounded-md bg-muted px-1.5 py-0.5 text-xs leading-none font-medium tabular-nums text-muted-foreground"
41
+ aria-label={`${count.toLocaleString()} ${countLabel}`}
42
42
  >
43
- {count}
43
+ {count.toLocaleString()}
44
44
  </span>
45
45
  {/if}
46
46
  </svelte:element>
47
47
  {#if description}
48
- <p class="text-sm text-muted-foreground">{description}</p>
48
+ <p class="text-sm text-muted-foreground [overflow-wrap:anywhere]">{description}</p>
49
49
  {/if}
50
50
  </div>
51
51
  {#if actions}