@korzun/design 0.0.6 → 0.2.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 (89) hide show
  1. package/AGENTS.md +11 -4
  2. package/dist/component/heading/index.d.ts +303 -0
  3. package/dist/component/heading/index.d.ts.map +1 -0
  4. package/dist/component/heading/index.js +21 -0
  5. package/dist/component/heading/index.js.map +1 -0
  6. package/dist/component/heading/style.d.ts +5 -0
  7. package/dist/component/heading/style.d.ts.map +1 -0
  8. package/dist/component/heading/style.js +5 -0
  9. package/dist/component/heading/style.js.map +1 -0
  10. package/dist/component/index.d.ts +4 -0
  11. package/dist/component/index.d.ts.map +1 -1
  12. package/dist/component/index.js +4 -0
  13. package/dist/component/index.js.map +1 -1
  14. package/dist/component/inline/index.d.ts +303 -0
  15. package/dist/component/inline/index.d.ts.map +1 -0
  16. package/dist/component/inline/index.js +13 -0
  17. package/dist/component/inline/index.js.map +1 -0
  18. package/dist/component/inline/style.d.ts +5 -0
  19. package/dist/component/inline/style.d.ts.map +1 -0
  20. package/dist/component/inline/style.js +18 -0
  21. package/dist/component/inline/style.js.map +1 -0
  22. package/dist/component/stack/gap.d.ts +4 -0
  23. package/dist/component/stack/gap.d.ts.map +1 -0
  24. package/dist/component/stack/gap.js +10 -0
  25. package/dist/component/stack/gap.js.map +1 -0
  26. package/dist/component/stack/index.d.ts +299 -0
  27. package/dist/component/stack/index.d.ts.map +1 -0
  28. package/dist/component/stack/index.js +13 -0
  29. package/dist/component/stack/index.js.map +1 -0
  30. package/dist/component/stack/style.d.ts +5 -0
  31. package/dist/component/stack/style.d.ts.map +1 -0
  32. package/dist/component/stack/style.js +12 -0
  33. package/dist/component/stack/style.js.map +1 -0
  34. package/dist/component/tag/index.d.ts +1 -1
  35. package/dist/component/tag/index.d.ts.map +1 -1
  36. package/dist/component/tag/index.js.map +1 -1
  37. package/dist/component/tag/style.d.ts +1 -1
  38. package/dist/component/tag/style.d.ts.map +1 -1
  39. package/dist/component/text/index.d.ts +307 -0
  40. package/dist/component/text/index.d.ts.map +1 -0
  41. package/dist/component/text/index.js +15 -0
  42. package/dist/component/text/index.js.map +1 -0
  43. package/dist/component/text/style.d.ts +11 -0
  44. package/dist/component/text/style.d.ts.map +1 -0
  45. package/dist/component/text/style.js +48 -0
  46. package/dist/component/text/style.js.map +1 -0
  47. package/dist/control/index.d.ts +1 -1
  48. package/dist/control/index.d.ts.map +1 -1
  49. package/dist/control/index.js +1 -1
  50. package/dist/control/index.js.map +1 -1
  51. package/dist/control/popover/index.d.ts +24 -8
  52. package/dist/control/popover/index.d.ts.map +1 -1
  53. package/dist/control/popover/index.js +60 -15
  54. package/dist/control/popover/index.js.map +1 -1
  55. package/dist/control/popover/position.d.ts +47 -0
  56. package/dist/control/popover/position.d.ts.map +1 -0
  57. package/dist/control/popover/position.js +29 -0
  58. package/dist/control/popover/position.js.map +1 -0
  59. package/dist/theme/theme.d.ts +25 -0
  60. package/dist/theme/theme.d.ts.map +1 -1
  61. package/dist/theme/theme.js +43 -1
  62. package/dist/theme/theme.js.map +1 -1
  63. package/docs/component/heading.md +85 -0
  64. package/docs/component/inline.md +64 -0
  65. package/docs/component/meta-line.md +13 -17
  66. package/docs/component/metadata-list.md +1 -1
  67. package/docs/component/stack.md +68 -0
  68. package/docs/component/tag.md +26 -6
  69. package/docs/component/text.md +94 -0
  70. package/docs/control/popover.md +41 -10
  71. package/docs/patterns.md +28 -9
  72. package/docs/theme.md +10 -9
  73. package/docs/tokens.md +4 -4
  74. package/package.json +1 -1
  75. package/src/component/heading/index.tsx +64 -0
  76. package/src/component/heading/style.ts +5 -0
  77. package/src/component/index.ts +4 -0
  78. package/src/component/inline/index.tsx +57 -0
  79. package/src/component/inline/style.ts +18 -0
  80. package/src/component/stack/gap.ts +16 -0
  81. package/src/component/stack/index.tsx +49 -0
  82. package/src/component/stack/style.ts +12 -0
  83. package/src/component/tag/index.tsx +1 -1
  84. package/src/component/text/index.tsx +61 -0
  85. package/src/component/text/style.ts +67 -0
  86. package/src/control/index.ts +6 -1
  87. package/src/control/popover/index.tsx +77 -19
  88. package/src/control/popover/position.ts +66 -0
  89. package/src/theme/theme.ts +59 -2
@@ -0,0 +1,66 @@
1
+ /** Which side of the anchor the popover prefers. */
2
+ export type PopoverSide = 'bottom' | 'top';
3
+ /** Horizontal alignment of the popover against the anchor. */
4
+ export type PopoverAlign = 'start' | 'center' | 'end';
5
+ /** Viewport-relative rectangle, as from getBoundingClientRect. */
6
+ export type Rect = { top: number; bottom: number; left: number; right: number; width: number };
7
+ /**
8
+ * Resolved popover position; `side` is the side actually used after flipping.
9
+ * Exactly one of `top` / `bottom` is set: the bottom side is anchored by its
10
+ * top edge (CSS `top`), the top side by its bottom edge (CSS `bottom`, measured
11
+ * from the viewport's bottom), so content that grows or shrinks while open
12
+ * stays attached to the anchor.
13
+ */
14
+ export type Placement = {
15
+ top: number | undefined;
16
+ bottom: number | undefined;
17
+ left: number;
18
+ width: number | undefined;
19
+ side: PopoverSide;
20
+ };
21
+
22
+ /**
23
+ * Pure placement: picks the side (flipping when the preferred side does not
24
+ * fit and the other has more room), aligns horizontally, and clamps to the
25
+ * viewport horizontally unless `matchWidth` (then it lines up with the anchor).
26
+ */
27
+ export function computePosition({
28
+ anchor,
29
+ content,
30
+ viewport,
31
+ side,
32
+ align,
33
+ gap,
34
+ matchWidth,
35
+ }: {
36
+ anchor: Rect;
37
+ content: { width: number; height: number };
38
+ viewport: { width: number; height: number };
39
+ side: PopoverSide;
40
+ align: PopoverAlign;
41
+ gap: number;
42
+ matchWidth: boolean;
43
+ }): Placement {
44
+ const w = matchWidth ? anchor.width : content.width;
45
+ const h = content.height;
46
+
47
+ const roomBelow = viewport.height - anchor.bottom - gap;
48
+ const roomAbove = anchor.top - gap;
49
+ const room = (s: PopoverSide) => (s === 'bottom' ? roomBelow : roomAbove);
50
+ const other: PopoverSide = side === 'bottom' ? 'top' : 'bottom';
51
+ const used = room(side) >= h || room(other) <= room(side) ? side : other;
52
+ const top = used === 'bottom' ? anchor.bottom + gap : undefined;
53
+ const bottom = used === 'top' ? viewport.height - anchor.top + gap : undefined;
54
+
55
+ let left: number;
56
+ if (align === 'start') left = anchor.left;
57
+ else if (align === 'center') left = anchor.left + anchor.width / 2 - w / 2;
58
+ else left = anchor.right - w;
59
+
60
+ if (!matchWidth) {
61
+ left =
62
+ w > viewport.width - 2 * gap ? gap : Math.max(gap, Math.min(left, viewport.width - w - gap));
63
+ }
64
+
65
+ return { top, bottom, left, width: matchWidth ? anchor.width : undefined, side: used };
66
+ }
@@ -95,6 +95,10 @@ export interface Theme {
95
95
  section: string;
96
96
  };
97
97
  success: string;
98
+ /** Solid warning colour for icons and accents. */
99
+ warning: string;
100
+ /** Solid info colour for icons and accents. */
101
+ info: string;
98
102
  brand: {
99
103
  default: string;
100
104
  hover: string;
@@ -129,6 +133,11 @@ export interface Theme {
129
133
  // Quiet grey for states that carry no category (e.g. "no change"), built
130
134
  // from the mode's muted text colour.
131
135
  neutral: { text: string; bg: string; border: string };
136
+ // Status tones for state, as opposed to the label tones above.
137
+ success: { text: string; bg: string; border: string };
138
+ warning: { text: string; bg: string; border: string };
139
+ danger: { text: string; bg: string; border: string };
140
+ info: { text: string; bg: string; border: string };
132
141
  };
133
142
  };
134
143
  space: {
@@ -167,7 +176,13 @@ export interface Theme {
167
176
  xxl: string;
168
177
  };
169
178
  fontFamily: { body: string; mono: string };
170
- fontWeight: { medium: number; semibold: number; bold: number; extrabold: number };
179
+ fontWeight: {
180
+ regular: number;
181
+ medium: number;
182
+ semibold: number;
183
+ bold: number;
184
+ extrabold: number;
185
+ };
171
186
  lineHeight: { tight: number; body: number };
172
187
  shadow: {
173
188
  card: string;
@@ -267,6 +282,8 @@ function buildTheme(mode: ThemeMode): Theme {
267
282
  section: '#E6E6E9',
268
283
  },
269
284
  success: '#16a34a',
285
+ warning: '#ca8a04',
286
+ info: blue[500],
270
287
  brand: {
271
288
  default: blue[500],
272
289
  hover: blue[400],
@@ -307,6 +324,22 @@ function buildTheme(mode: ThemeMode): Theme {
307
324
  bg: applyTransparency(gray[600], 0.08),
308
325
  border: applyTransparency(gray[600], 0.22),
309
326
  },
327
+ success: {
328
+ text: '#15803d',
329
+ bg: applyTransparency('#16a34a', 0.08),
330
+ border: applyTransparency('#16a34a', 0.22),
331
+ },
332
+ warning: { text: '#854d0e', bg: 'rgba(234,179,8,0.16)', border: 'rgba(202,138,4,0.40)' },
333
+ danger: {
334
+ text: red[700],
335
+ bg: applyTransparency(red[500], 0.08),
336
+ border: applyTransparency(red[500], 0.22),
337
+ },
338
+ info: {
339
+ text: blue[700],
340
+ bg: applyTransparency(blue[500], 0.08),
341
+ border: applyTransparency(blue[500], 0.24),
342
+ },
310
343
  },
311
344
  };
312
345
 
@@ -359,6 +392,8 @@ function buildTheme(mode: ThemeMode): Theme {
359
392
  section: '#2B2C30',
360
393
  },
361
394
  success: '#22C55E',
395
+ warning: '#EAB308',
396
+ info: blue[400],
362
397
  brand: {
363
398
  default: blue[400],
364
399
  hover: blue[300],
@@ -400,6 +435,22 @@ function buildTheme(mode: ThemeMode): Theme {
400
435
  bg: applyTransparency(darkMuted, 0.16),
401
436
  border: applyTransparency(darkMuted, 0.3),
402
437
  },
438
+ success: {
439
+ text: '#86EFAC',
440
+ bg: applyTransparency('#22C55E', 0.16),
441
+ border: applyTransparency('#22C55E', 0.3),
442
+ },
443
+ warning: { text: '#FDE047', bg: 'rgba(234,179,8,0.20)', border: 'rgba(234,179,8,0.42)' },
444
+ danger: {
445
+ text: red[400],
446
+ bg: applyTransparency(red[500], 0.16),
447
+ border: applyTransparency(red[500], 0.3),
448
+ },
449
+ info: {
450
+ text: blue[300],
451
+ bg: applyTransparency(blue[400], 0.18),
452
+ border: applyTransparency(blue[400], 0.36),
453
+ },
403
454
  },
404
455
  };
405
456
 
@@ -463,7 +514,13 @@ function buildTheme(mode: ThemeMode): Theme {
463
514
  body: 'system-ui, sans-serif',
464
515
  mono: "'Cascadia Code', 'Fira Code', monospace",
465
516
  };
466
- const fontWeight: Theme['fontWeight'] = { medium: 500, semibold: 600, bold: 700, extrabold: 800 };
517
+ const fontWeight: Theme['fontWeight'] = {
518
+ regular: 400,
519
+ medium: 500,
520
+ semibold: 600,
521
+ bold: 700,
522
+ extrabold: 800,
523
+ };
467
524
  const lineHeight: Theme['lineHeight'] = { tight: 1, body: 1.3 };
468
525
 
469
526
  const lightShadow: Theme['shadow'] = {