@thedatagrid/docs-kit 0.2.1 → 0.3.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 (63) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +75 -1
  3. package/dist/demos/build.d.ts.map +1 -1
  4. package/dist/demos/build.js +1 -0
  5. package/dist/demos/build.js.map +1 -1
  6. package/dist/demos/config.d.ts +7 -0
  7. package/dist/demos/config.d.ts.map +1 -1
  8. package/dist/demos/config.js.map +1 -1
  9. package/dist/demos/pages.d.ts +2 -0
  10. package/dist/demos/pages.d.ts.map +1 -1
  11. package/dist/demos/pages.js +6 -2
  12. package/dist/demos/pages.js.map +1 -1
  13. package/dist/react/DemoShell.js +21 -5
  14. package/dist/react/DemoShell.js.map +1 -1
  15. package/dist/react/styles.css +8 -0
  16. package/dist/remark/index.d.ts +1 -1
  17. package/dist/remark/index.d.ts.map +1 -1
  18. package/dist/remark/index.js +1 -1
  19. package/dist/remark/index.js.map +1 -1
  20. package/dist/remark/meta.d.ts +13 -0
  21. package/dist/remark/meta.d.ts.map +1 -1
  22. package/dist/remark/meta.js +13 -0
  23. package/dist/remark/meta.js.map +1 -1
  24. package/dist/remark/remarkDemoFences.d.ts +10 -2
  25. package/dist/remark/remarkDemoFences.d.ts.map +1 -1
  26. package/dist/remark/remarkDemoFences.js +6 -4
  27. package/dist/remark/remarkDemoFences.js.map +1 -1
  28. package/dist/showcase/AutomatedDemo.d.ts +46 -0
  29. package/dist/showcase/AutomatedDemo.d.ts.map +1 -0
  30. package/dist/showcase/AutomatedDemo.js +169 -0
  31. package/dist/showcase/AutomatedDemo.js.map +1 -0
  32. package/dist/showcase/LazyShowcase.d.ts +31 -0
  33. package/dist/showcase/LazyShowcase.d.ts.map +1 -0
  34. package/dist/showcase/LazyShowcase.js +51 -0
  35. package/dist/showcase/LazyShowcase.js.map +1 -0
  36. package/dist/showcase/hooks.d.ts +19 -0
  37. package/dist/showcase/hooks.d.ts.map +1 -0
  38. package/dist/showcase/hooks.js +63 -0
  39. package/dist/showcase/hooks.js.map +1 -0
  40. package/dist/showcase/index.d.ts +17 -0
  41. package/dist/showcase/index.d.ts.map +1 -0
  42. package/dist/showcase/index.js +15 -0
  43. package/dist/showcase/index.js.map +1 -0
  44. package/dist/showcase/scripted.d.ts +100 -0
  45. package/dist/showcase/scripted.d.ts.map +1 -0
  46. package/dist/showcase/scripted.js +381 -0
  47. package/dist/showcase/scripted.js.map +1 -0
  48. package/dist/showcase/styles.css +174 -0
  49. package/package.json +7 -2
  50. package/src/demos/build.ts +1 -0
  51. package/src/demos/config.ts +7 -0
  52. package/src/demos/pages.ts +6 -2
  53. package/src/react/DemoShell.tsx +64 -8
  54. package/src/react/styles.css +8 -0
  55. package/src/remark/index.ts +1 -1
  56. package/src/remark/meta.ts +26 -0
  57. package/src/remark/remarkDemoFences.ts +15 -4
  58. package/src/showcase/AutomatedDemo.tsx +266 -0
  59. package/src/showcase/LazyShowcase.tsx +111 -0
  60. package/src/showcase/hooks.ts +84 -0
  61. package/src/showcase/index.ts +23 -0
  62. package/src/showcase/scripted.ts +533 -0
  63. package/src/showcase/styles.css +174 -0
@@ -0,0 +1,174 @@
1
+ /*
2
+ * Styles for the product-agnostic showcase kit (scripted cursor, automated
3
+ * demo shell, lazy poster). Hosts theme it through these custom properties:
4
+ *
5
+ * --showcase-accent cursor click ripple, pill dot
6
+ * --showcase-pill-bg pill background
7
+ * --showcase-pill-fg pill text
8
+ * --showcase-pill-border pill border
9
+ * --showcase-z base z-index of the overlay layer
10
+ */
11
+
12
+ .showcase-demo {
13
+ position: relative;
14
+ height: 100%;
15
+ }
16
+
17
+ .showcase-demo__overlay {
18
+ position: absolute;
19
+ inset: 0;
20
+ z-index: calc(var(--showcase-z, 2000));
21
+ overflow: hidden;
22
+ pointer-events: none;
23
+ }
24
+
25
+ /* ---- the fake cursor ---------------------------------------------------- */
26
+
27
+ .showcase-cursor {
28
+ position: absolute;
29
+ left: 0;
30
+ top: 0;
31
+ opacity: 0;
32
+ pointer-events: none;
33
+ will-change: transform;
34
+ transition: opacity 350ms ease;
35
+ }
36
+ .showcase-cursor.is-visible {
37
+ opacity: 1;
38
+ }
39
+ .showcase-cursor__arrow {
40
+ display: block;
41
+ filter: drop-shadow(0 2px 5px rgb(0 0 0 / 0.35));
42
+ transform-origin: 4px 3px; /* the arrow tip */
43
+ transition: transform 130ms ease;
44
+ }
45
+ .showcase-cursor.is-clicking .showcase-cursor__arrow,
46
+ .showcase-cursor.is-pressed .showcase-cursor__arrow {
47
+ transform: scale(0.82);
48
+ }
49
+ .showcase-cursor__ring {
50
+ position: absolute;
51
+ left: -15px;
52
+ top: -14px;
53
+ width: 34px;
54
+ height: 34px;
55
+ border-radius: 50%;
56
+ background: var(--showcase-accent, #3b82f6);
57
+ opacity: 0;
58
+ transform: scale(0.3);
59
+ }
60
+ .showcase-cursor.is-clicking .showcase-cursor__ring {
61
+ animation: showcase-ripple 500ms ease-out;
62
+ }
63
+ .showcase-cursor.is-pressed .showcase-cursor__ring {
64
+ opacity: 0.35;
65
+ transform: scale(0.75);
66
+ transition: opacity 120ms ease, transform 120ms ease;
67
+ }
68
+ .showcase-cursor__label {
69
+ position: absolute;
70
+ left: 24px;
71
+ top: 22px;
72
+ white-space: nowrap;
73
+ padding: 3px 8px;
74
+ border-radius: 999px;
75
+ font: 500 11px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace;
76
+ color: var(--showcase-pill-fg, #e5e7eb);
77
+ background: var(--showcase-pill-bg, rgb(17 19 24 / 0.92));
78
+ border: 1px solid var(--showcase-pill-border, rgb(255 255 255 / 0.14));
79
+ opacity: 0;
80
+ transform: translateY(4px);
81
+ transition: opacity 200ms ease, transform 200ms ease;
82
+ }
83
+ .showcase-cursor.has-label .showcase-cursor__label {
84
+ opacity: 1;
85
+ transform: none;
86
+ }
87
+ @keyframes showcase-ripple {
88
+ 0% {
89
+ opacity: 0.4;
90
+ transform: scale(0.3);
91
+ }
92
+ 100% {
93
+ opacity: 0;
94
+ transform: scale(1.9);
95
+ }
96
+ }
97
+
98
+ /* ---- status pills ------------------------------------------------------- */
99
+
100
+ .showcase-pill {
101
+ position: absolute;
102
+ bottom: 12px;
103
+ left: 50%;
104
+ z-index: calc(var(--showcase-z, 2000) + 1);
105
+ transform: translateX(-50%);
106
+ display: inline-flex;
107
+ align-items: center;
108
+ gap: 8px;
109
+ padding: 6px 14px;
110
+ border-radius: 999px;
111
+ font: 500 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace;
112
+ white-space: nowrap;
113
+ color: var(--showcase-pill-fg, #e5e7eb);
114
+ background: var(--showcase-pill-bg, rgb(17 19 24 / 0.9));
115
+ border: 1px solid var(--showcase-pill-border, rgb(255 255 255 / 0.14));
116
+ box-shadow: 0 6px 24px rgb(0 0 0 / 0.35);
117
+ backdrop-filter: blur(8px);
118
+ }
119
+ .showcase-pill--running {
120
+ pointer-events: none;
121
+ }
122
+ .showcase-pill--user {
123
+ cursor: pointer;
124
+ transition: border-color 150ms ease, color 150ms ease;
125
+ }
126
+ .showcase-pill--user:hover {
127
+ border-color: var(--showcase-accent, #3b82f6);
128
+ }
129
+ .showcase-pill__dot {
130
+ width: 6px;
131
+ height: 6px;
132
+ border-radius: 50%;
133
+ background: var(--showcase-accent, #3b82f6);
134
+ animation: showcase-pulse 1.4s ease-in-out infinite;
135
+ }
136
+ @keyframes showcase-pulse {
137
+ 50% {
138
+ opacity: 0.35;
139
+ }
140
+ }
141
+
142
+ /* ---- lazy poster → live ------------------------------------------------- */
143
+
144
+ .showcase-lazy {
145
+ position: relative;
146
+ overflow: hidden;
147
+ }
148
+ .showcase-lazy__poster,
149
+ .showcase-lazy__live {
150
+ position: absolute;
151
+ inset: 0;
152
+ }
153
+ .showcase-lazy__poster {
154
+ transition: opacity 500ms ease;
155
+ }
156
+ .showcase-lazy__live {
157
+ opacity: 0;
158
+ transition: opacity 500ms ease;
159
+ }
160
+ .showcase-lazy[data-showcase-ready='true'] .showcase-lazy__live {
161
+ opacity: 1;
162
+ }
163
+ .showcase-lazy[data-showcase-ready='true'] .showcase-lazy__poster {
164
+ opacity: 0;
165
+ pointer-events: none;
166
+ }
167
+
168
+ @media (prefers-reduced-motion: reduce) {
169
+ .showcase-lazy__poster,
170
+ .showcase-lazy__live,
171
+ .showcase-cursor {
172
+ transition: none;
173
+ }
174
+ }