@thedatagrid/docs-kit 0.2.2 → 0.4.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 (204) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +206 -4
  3. package/dist/code/demoFiles.d.ts.map +1 -1
  4. package/dist/code/demoFiles.js +2 -2
  5. package/dist/code/demoFiles.js.map +1 -1
  6. package/dist/code/index.d.ts +1 -0
  7. package/dist/code/index.d.ts.map +1 -1
  8. package/dist/code/index.js +1 -0
  9. package/dist/code/index.js.map +1 -1
  10. package/dist/code/regions.d.ts +2 -1
  11. package/dist/code/regions.d.ts.map +1 -1
  12. package/dist/code/regions.js +12 -8
  13. package/dist/code/regions.js.map +1 -1
  14. package/dist/code/vueBlocks.d.ts +3 -0
  15. package/dist/code/vueBlocks.d.ts.map +1 -0
  16. package/dist/code/vueBlocks.js +29 -0
  17. package/dist/code/vueBlocks.js.map +1 -0
  18. package/dist/demos/build.d.ts +5 -2
  19. package/dist/demos/build.d.ts.map +1 -1
  20. package/dist/demos/build.js +244 -85
  21. package/dist/demos/build.js.map +1 -1
  22. package/dist/demos/compile/core.d.ts +9 -1
  23. package/dist/demos/compile/core.d.ts.map +1 -1
  24. package/dist/demos/compile/core.js +19 -8
  25. package/dist/demos/compile/core.js.map +1 -1
  26. package/dist/demos/compile/vue.d.ts +107 -0
  27. package/dist/demos/compile/vue.d.ts.map +1 -0
  28. package/dist/demos/compile/vue.js +187 -0
  29. package/dist/demos/compile/vue.js.map +1 -0
  30. package/dist/demos/config.d.ts +27 -7
  31. package/dist/demos/config.d.ts.map +1 -1
  32. package/dist/demos/config.js.map +1 -1
  33. package/dist/demos/index.d.ts +3 -2
  34. package/dist/demos/index.d.ts.map +1 -1
  35. package/dist/demos/index.js +1 -0
  36. package/dist/demos/index.js.map +1 -1
  37. package/dist/demos/pages.d.ts +1 -1
  38. package/dist/demos/pages.d.ts.map +1 -1
  39. package/dist/demos/pages.js +4 -1
  40. package/dist/demos/pages.js.map +1 -1
  41. package/dist/demos/runtime/vue.d.ts +3 -0
  42. package/dist/demos/runtime/vue.d.ts.map +1 -0
  43. package/dist/demos/runtime/vue.js +15 -0
  44. package/dist/demos/runtime/vue.js.map +1 -0
  45. package/dist/demos/worker/compile.worker.js +3 -22
  46. package/dist/demos/worker/compile.worker.js.map +1 -1
  47. package/dist/demos/worker/compileVue.worker.d.ts +2 -0
  48. package/dist/demos/worker/compileVue.worker.d.ts.map +1 -0
  49. package/dist/demos/worker/compileVue.worker.js +11 -0
  50. package/dist/demos/worker/compileVue.worker.js.map +1 -0
  51. package/dist/demos/worker/start.d.ts +7 -0
  52. package/dist/demos/worker/start.d.ts.map +1 -0
  53. package/dist/demos/worker/start.js +27 -0
  54. package/dist/demos/worker/start.js.map +1 -0
  55. package/dist/fork/codesandbox.d.ts +15 -1
  56. package/dist/fork/codesandbox.d.ts.map +1 -1
  57. package/dist/fork/codesandbox.js +30 -19
  58. package/dist/fork/codesandbox.js.map +1 -1
  59. package/dist/fork/index.d.ts +18 -0
  60. package/dist/fork/index.d.ts.map +1 -1
  61. package/dist/fork/index.js +18 -0
  62. package/dist/fork/index.js.map +1 -1
  63. package/dist/fork/stackblitz.d.ts +18 -0
  64. package/dist/fork/stackblitz.d.ts.map +1 -0
  65. package/dist/fork/stackblitz.js +98 -0
  66. package/dist/fork/stackblitz.js.map +1 -0
  67. package/dist/frameworks/index.d.ts +4 -0
  68. package/dist/frameworks/index.d.ts.map +1 -0
  69. package/dist/frameworks/index.js +4 -0
  70. package/dist/frameworks/index.js.map +1 -0
  71. package/dist/frameworks/preference.d.ts +10 -0
  72. package/dist/frameworks/preference.d.ts.map +1 -0
  73. package/dist/frameworks/preference.js +34 -0
  74. package/dist/frameworks/preference.js.map +1 -0
  75. package/dist/frameworks/react/FrameworkBanner.d.ts +34 -0
  76. package/dist/frameworks/react/FrameworkBanner.d.ts.map +1 -0
  77. package/dist/frameworks/react/FrameworkBanner.js +50 -0
  78. package/dist/frameworks/react/FrameworkBanner.js.map +1 -0
  79. package/dist/frameworks/react/FrameworkContent.d.ts +21 -0
  80. package/dist/frameworks/react/FrameworkContent.d.ts.map +1 -0
  81. package/dist/frameworks/react/FrameworkContent.js +25 -0
  82. package/dist/frameworks/react/FrameworkContent.js.map +1 -0
  83. package/dist/frameworks/react/FrameworkLinks.d.ts +16 -0
  84. package/dist/frameworks/react/FrameworkLinks.d.ts.map +1 -0
  85. package/dist/frameworks/react/FrameworkLinks.js +50 -0
  86. package/dist/frameworks/react/FrameworkLinks.js.map +1 -0
  87. package/dist/frameworks/react/FrameworkSwitcher.d.ts +27 -0
  88. package/dist/frameworks/react/FrameworkSwitcher.d.ts.map +1 -0
  89. package/dist/frameworks/react/FrameworkSwitcher.js +42 -0
  90. package/dist/frameworks/react/FrameworkSwitcher.js.map +1 -0
  91. package/dist/frameworks/react/index.d.ts +6 -0
  92. package/dist/frameworks/react/index.d.ts.map +1 -0
  93. package/dist/frameworks/react/index.js +6 -0
  94. package/dist/frameworks/react/index.js.map +1 -0
  95. package/dist/frameworks/react/useFrameworkPreference.d.ts +32 -0
  96. package/dist/frameworks/react/useFrameworkPreference.d.ts.map +1 -0
  97. package/dist/frameworks/react/useFrameworkPreference.js +45 -0
  98. package/dist/frameworks/react/useFrameworkPreference.js.map +1 -0
  99. package/dist/frameworks/routeTree.d.ts +24 -0
  100. package/dist/frameworks/routeTree.d.ts.map +1 -0
  101. package/dist/frameworks/routeTree.js +31 -0
  102. package/dist/frameworks/routeTree.js.map +1 -0
  103. package/dist/frameworks/routing.d.ts +105 -0
  104. package/dist/frameworks/routing.d.ts.map +1 -0
  105. package/dist/frameworks/routing.js +142 -0
  106. package/dist/frameworks/routing.js.map +1 -0
  107. package/dist/frameworks/styles.css +104 -0
  108. package/dist/react/Demo.d.ts +12 -0
  109. package/dist/react/Demo.d.ts.map +1 -1
  110. package/dist/react/Demo.js +10 -4
  111. package/dist/react/Demo.js.map +1 -1
  112. package/dist/react/DemoShell.d.ts +5 -1
  113. package/dist/react/DemoShell.d.ts.map +1 -1
  114. package/dist/react/DemoShell.js +9 -6
  115. package/dist/react/DemoShell.js.map +1 -1
  116. package/dist/react/editor.d.ts.map +1 -1
  117. package/dist/react/editor.js +3 -0
  118. package/dist/react/editor.js.map +1 -1
  119. package/dist/react/fork.d.ts +4 -3
  120. package/dist/react/fork.d.ts.map +1 -1
  121. package/dist/react/fork.js +6 -5
  122. package/dist/react/fork.js.map +1 -1
  123. package/dist/react/styles.css +10 -0
  124. package/dist/remark/index.d.ts +2 -0
  125. package/dist/remark/index.d.ts.map +1 -1
  126. package/dist/remark/index.js +2 -0
  127. package/dist/remark/index.js.map +1 -1
  128. package/dist/remark/remarkDemoFences.d.ts +13 -0
  129. package/dist/remark/remarkDemoFences.d.ts.map +1 -1
  130. package/dist/remark/remarkDemoFences.js +48 -4
  131. package/dist/remark/remarkDemoFences.js.map +1 -1
  132. package/dist/remark/remarkFrameworkLinks.d.ts +36 -0
  133. package/dist/remark/remarkFrameworkLinks.d.ts.map +1 -0
  134. package/dist/remark/remarkFrameworkLinks.js +77 -0
  135. package/dist/remark/remarkFrameworkLinks.js.map +1 -0
  136. package/dist/remark/remarkFrameworkText.d.ts +16 -0
  137. package/dist/remark/remarkFrameworkText.d.ts.map +1 -0
  138. package/dist/remark/remarkFrameworkText.js +39 -0
  139. package/dist/remark/remarkFrameworkText.js.map +1 -0
  140. package/dist/showcase/AutomatedDemo.d.ts +46 -0
  141. package/dist/showcase/AutomatedDemo.d.ts.map +1 -0
  142. package/dist/showcase/AutomatedDemo.js +169 -0
  143. package/dist/showcase/AutomatedDemo.js.map +1 -0
  144. package/dist/showcase/LazyShowcase.d.ts +31 -0
  145. package/dist/showcase/LazyShowcase.d.ts.map +1 -0
  146. package/dist/showcase/LazyShowcase.js +51 -0
  147. package/dist/showcase/LazyShowcase.js.map +1 -0
  148. package/dist/showcase/hooks.d.ts +19 -0
  149. package/dist/showcase/hooks.d.ts.map +1 -0
  150. package/dist/showcase/hooks.js +63 -0
  151. package/dist/showcase/hooks.js.map +1 -0
  152. package/dist/showcase/index.d.ts +17 -0
  153. package/dist/showcase/index.d.ts.map +1 -0
  154. package/dist/showcase/index.js +15 -0
  155. package/dist/showcase/index.js.map +1 -0
  156. package/dist/showcase/scripted.d.ts +100 -0
  157. package/dist/showcase/scripted.d.ts.map +1 -0
  158. package/dist/showcase/scripted.js +381 -0
  159. package/dist/showcase/scripted.js.map +1 -0
  160. package/dist/showcase/styles.css +174 -0
  161. package/package.json +34 -4
  162. package/src/code/demoFiles.ts +2 -2
  163. package/src/code/index.ts +1 -0
  164. package/src/code/regions.ts +14 -8
  165. package/src/code/vueBlocks.ts +25 -0
  166. package/src/demos/build.ts +293 -99
  167. package/src/demos/compile/core.ts +27 -7
  168. package/src/demos/compile/vue.ts +259 -0
  169. package/src/demos/config.ts +44 -7
  170. package/src/demos/index.ts +13 -0
  171. package/src/demos/pages.ts +4 -2
  172. package/src/demos/runtime/vue.ts +17 -0
  173. package/src/demos/worker/compile.worker.ts +3 -30
  174. package/src/demos/worker/compileVue.worker.ts +13 -0
  175. package/src/demos/worker/start.ts +35 -0
  176. package/src/fork/codesandbox.ts +43 -21
  177. package/src/fork/index.ts +25 -0
  178. package/src/fork/stackblitz.ts +107 -0
  179. package/src/frameworks/index.ts +21 -0
  180. package/src/frameworks/preference.ts +35 -0
  181. package/src/frameworks/react/FrameworkBanner.tsx +112 -0
  182. package/src/frameworks/react/FrameworkContent.tsx +33 -0
  183. package/src/frameworks/react/FrameworkLinks.tsx +52 -0
  184. package/src/frameworks/react/FrameworkSwitcher.tsx +78 -0
  185. package/src/frameworks/react/index.ts +10 -0
  186. package/src/frameworks/react/useFrameworkPreference.ts +91 -0
  187. package/src/frameworks/routeTree.ts +54 -0
  188. package/src/frameworks/routing.ts +194 -0
  189. package/src/frameworks/styles.css +104 -0
  190. package/src/react/Demo.tsx +21 -2
  191. package/src/react/DemoShell.tsx +15 -7
  192. package/src/react/editor.ts +2 -0
  193. package/src/react/fork.ts +12 -5
  194. package/src/react/styles.css +10 -0
  195. package/src/remark/index.ts +6 -0
  196. package/src/remark/remarkDemoFences.ts +58 -3
  197. package/src/remark/remarkFrameworkLinks.ts +96 -0
  198. package/src/remark/remarkFrameworkText.ts +44 -0
  199. package/src/showcase/AutomatedDemo.tsx +266 -0
  200. package/src/showcase/LazyShowcase.tsx +111 -0
  201. package/src/showcase/hooks.ts +84 -0
  202. package/src/showcase/index.ts +23 -0
  203. package/src/showcase/scripted.ts +533 -0
  204. package/src/showcase/styles.css +174 -0
@@ -0,0 +1,169 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useCallback, useEffect, useRef, useState, } from 'react';
4
+ import { canRunScriptedShow } from "./hooks.js";
5
+ import { createScriptedCursor, ScriptCancelled, sleep, waitFor, } from "./scripted.js";
6
+ /**
7
+ * Wraps a live demo in an automated show: a scripted cursor drives the LIVE
8
+ * component while it's in view, and the first real interaction (click /
9
+ * wheel / touch / key) hands control to the user instantly, leaving the demo
10
+ * where the script left it. A broken script ends quietly — it must never
11
+ * break the page.
12
+ */
13
+ export function AutomatedDemo({ children, ready, run, reset, waitForSelector, loopPause = 2600, minViewportWidth = 768, threshold = 0.35, runningLabel = 'live demo — click anywhere to take over', userLabel = 'you’re in control — replay demo ↻', className, style, onStatusChange, }) {
14
+ const wrapperRef = useRef(null);
15
+ const overlayRef = useRef(null);
16
+ const cursorRef = useRef(null);
17
+ const abortRef = useRef(null);
18
+ const intersectingRef = useRef(false);
19
+ const readyRef = useRef(ready);
20
+ const statusRef = useRef('idle');
21
+ const [status, setStatusState] = useState('idle');
22
+ // latest callbacks without restarting the observers
23
+ const runRef = useRef(run);
24
+ const resetRef = useRef(reset);
25
+ const onStatusChangeRef = useRef(onStatusChange);
26
+ runRef.current = run;
27
+ resetRef.current = reset;
28
+ onStatusChangeRef.current = onStatusChange;
29
+ const setStatus = useCallback((next) => {
30
+ statusRef.current = next;
31
+ setStatusState(next);
32
+ onStatusChangeRef.current?.(next);
33
+ }, []);
34
+ const stop = useCallback((next) => {
35
+ abortRef.current?.abort();
36
+ abortRef.current = null;
37
+ cursorRef.current?.hide();
38
+ setStatus(next);
39
+ }, [setStatus]);
40
+ const tryStart = useCallback(() => {
41
+ if (statusRef.current !== 'idle')
42
+ return;
43
+ if (!intersectingRef.current || !readyRef.current)
44
+ return;
45
+ if (document.visibilityState === 'hidden')
46
+ return;
47
+ const root = wrapperRef.current;
48
+ const overlay = overlayRef.current;
49
+ if (!root || !overlay)
50
+ return;
51
+ // the show is pointless (and annoying) on touch / small / reduced-motion
52
+ if (!canRunScriptedShow(minViewportWidth))
53
+ return;
54
+ if (!cursorRef.current)
55
+ cursorRef.current = createScriptedCursor(overlay);
56
+ const cursor = cursorRef.current;
57
+ const controller = new AbortController();
58
+ abortRef.current = controller;
59
+ setStatus('running');
60
+ void (async () => {
61
+ const { signal } = controller;
62
+ const context = { root, cursor, signal };
63
+ try {
64
+ if (waitForSelector) {
65
+ const found = await waitFor(() => root.querySelector(waitForSelector), signal, {
66
+ timeout: 20000,
67
+ });
68
+ if (!found)
69
+ throw new ScriptCancelled();
70
+ }
71
+ for (;;) {
72
+ await resetRef.current?.(context);
73
+ await sleep(700, signal);
74
+ await runRef.current(context);
75
+ cursor.hide();
76
+ await sleep(loopPause, signal);
77
+ }
78
+ }
79
+ catch (error) {
80
+ cursor.hide();
81
+ if (!(error instanceof ScriptCancelled)) {
82
+ // a broken show must never break the page — just end it quietly
83
+ console.warn('[automated-demo]', error);
84
+ if (statusRef.current === 'running')
85
+ stop('user');
86
+ }
87
+ }
88
+ })();
89
+ }, [loopPause, minViewportWidth, setStatus, stop, waitForSelector]);
90
+ useEffect(() => {
91
+ readyRef.current = ready;
92
+ if (ready)
93
+ tryStart();
94
+ else if (statusRef.current === 'running')
95
+ stop('idle');
96
+ }, [ready, tryStart, stop]);
97
+ // start/pause with viewport visibility
98
+ useEffect(() => {
99
+ const root = wrapperRef.current;
100
+ if (!root)
101
+ return;
102
+ const observer = new IntersectionObserver((entries) => {
103
+ const isIntersecting = entries.some((entry) => entry.isIntersecting);
104
+ intersectingRef.current = isIntersecting;
105
+ if (isIntersecting)
106
+ tryStart();
107
+ else if (statusRef.current === 'running')
108
+ stop('idle');
109
+ }, { threshold });
110
+ observer.observe(root);
111
+ return () => observer.disconnect();
112
+ }, [threshold, tryStart, stop]);
113
+ // a hidden tab is as good as off-screen
114
+ useEffect(() => {
115
+ const onVisibility = () => {
116
+ if (document.visibilityState === 'hidden') {
117
+ if (statusRef.current === 'running')
118
+ stop('idle');
119
+ }
120
+ else {
121
+ tryStart();
122
+ }
123
+ };
124
+ document.addEventListener('visibilitychange', onVisibility);
125
+ return () => document.removeEventListener('visibilitychange', onVisibility);
126
+ }, [tryStart, stop]);
127
+ // first REAL interaction anywhere on the demo = takeover. The script's own
128
+ // dispatched events are untrusted, which is how we tell them apart.
129
+ useEffect(() => {
130
+ const root = wrapperRef.current;
131
+ if (!root)
132
+ return;
133
+ const onInteract = (event) => {
134
+ if (!event.isTrusted)
135
+ return;
136
+ if (statusRef.current === 'running')
137
+ stop('user');
138
+ // touched before the show got going: don't start it under the user
139
+ else if (statusRef.current === 'idle' &&
140
+ canRunScriptedShow(minViewportWidth)) {
141
+ stop('user');
142
+ }
143
+ };
144
+ const events = ['pointerdown', 'wheel', 'touchstart', 'keydown'];
145
+ for (const type of events) {
146
+ root.addEventListener(type, onInteract, { capture: true, passive: true });
147
+ }
148
+ return () => {
149
+ for (const type of events)
150
+ root.removeEventListener(type, onInteract, { capture: true });
151
+ };
152
+ }, [stop, minViewportWidth]);
153
+ useEffect(() => {
154
+ return () => {
155
+ abortRef.current?.abort();
156
+ cursorRef.current?.destroy();
157
+ cursorRef.current = null;
158
+ };
159
+ }, []);
160
+ const replay = useCallback(() => {
161
+ if (statusRef.current === 'running')
162
+ return;
163
+ setStatus('idle');
164
+ // let the status flip settle before the loop re-checks it
165
+ requestAnimationFrame(() => tryStart());
166
+ }, [setStatus, tryStart]);
167
+ return (_jsxs("div", { ref: wrapperRef, className: ['showcase-demo', className].filter(Boolean).join(' '), "data-showcase-status": status, style: style, children: [children, _jsx("div", { ref: overlayRef, "aria-hidden": true, className: "showcase-demo__overlay" }), status === 'running' ? (_jsxs("div", { className: "showcase-pill showcase-pill--running", role: "status", children: [_jsx("span", { className: "showcase-pill__dot" }), runningLabel] })) : null, status === 'user' ? (_jsx("button", { type: "button", onClick: replay, className: "showcase-pill showcase-pill--user", children: userLabel })) : null] }));
168
+ }
169
+ //# sourceMappingURL=AutomatedDemo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AutomatedDemo.js","sourceRoot":"","sources":["../../src/showcase/AutomatedDemo.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { type ComponentType, type CSSProperties, type ReactNode } from 'react';
2
+ export type LazyShowcaseLoadedProps = {
3
+ /** Call once the live demo has painted its real content. */
4
+ onReady?: () => void;
5
+ };
6
+ export type LazyShowcaseProps<P extends object> = {
7
+ /** Dynamic import of the live demo, e.g. `() => import('./HeroDemo')`. */
8
+ load: () => Promise<{
9
+ default: ComponentType<P & LazyShowcaseLoadedProps>;
10
+ }>;
11
+ props: P;
12
+ /** Static first paint (an <img> screenshot, a skeleton…). Fades out once live. */
13
+ poster: ReactNode;
14
+ /**
15
+ * Fixed height, so swapping poster → live never shifts layout. Omit it when
16
+ * `className` sets a (responsive) height instead.
17
+ */
18
+ height?: number | string;
19
+ /** Start loading this far before the container scrolls into view. */
20
+ rootMargin?: string;
21
+ className?: string;
22
+ style?: CSSProperties;
23
+ };
24
+ /**
25
+ * Poster first, live demo later: the import starts when the container is
26
+ * near the viewport AND the main thread is idle, and the live demo cross-fades
27
+ * in over the poster once it reports `onReady`. Height is fixed up front, so
28
+ * there is no layout shift.
29
+ */
30
+ export declare function LazyShowcase<P extends object>({ load, props, poster, height, rootMargin, className, style, }: LazyShowcaseProps<P>): import("react").JSX.Element;
31
+ //# sourceMappingURL=LazyShowcase.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LazyShowcase.d.ts","sourceRoot":"","sources":["../../src/showcase/LazyShowcase.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,MAAM,MAAM,uBAAuB,GAAG;IACpC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI;IAChD,0EAA0E;IAC1E,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAA;KAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC;IACT,kFAAkF;IAClF,MAAM,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,EAC7C,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAoB,EACpB,SAAS,EACT,KAAK,GACN,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BA6DtB"}
@@ -0,0 +1,51 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useRef, useState, } from 'react';
4
+ import { whenIdle } from "./hooks.js";
5
+ /**
6
+ * Poster first, live demo later: the import starts when the container is
7
+ * near the viewport AND the main thread is idle, and the live demo cross-fades
8
+ * in over the poster once it reports `onReady`. Height is fixed up front, so
9
+ * there is no layout shift.
10
+ */
11
+ export function LazyShowcase({ load, props, poster, height, rootMargin = '200px', className, style, }) {
12
+ const ref = useRef(null);
13
+ const loadRef = useRef(load);
14
+ loadRef.current = load;
15
+ const [Live, setLive] = useState(null);
16
+ const [ready, setReady] = useState(false);
17
+ const [failed, setFailed] = useState(false);
18
+ useEffect(() => {
19
+ const node = ref.current;
20
+ if (!node)
21
+ return;
22
+ let cancelIdle;
23
+ let disposed = false;
24
+ const observer = new IntersectionObserver((entries) => {
25
+ if (!entries.some((entry) => entry.isIntersecting))
26
+ return;
27
+ observer.disconnect();
28
+ cancelIdle = whenIdle(() => {
29
+ loadRef
30
+ .current()
31
+ .then((mod) => {
32
+ if (!disposed)
33
+ setLive(() => mod.default);
34
+ })
35
+ .catch((error) => {
36
+ console.warn('[lazy-showcase] failed to load the live demo', error);
37
+ if (!disposed)
38
+ setFailed(true);
39
+ });
40
+ });
41
+ }, { rootMargin });
42
+ observer.observe(node);
43
+ return () => {
44
+ disposed = true;
45
+ observer.disconnect();
46
+ cancelIdle?.();
47
+ };
48
+ }, [rootMargin]);
49
+ return (_jsxs("div", { ref: ref, className: ['showcase-lazy', className].filter(Boolean).join(' '), style: { height, ...style }, "data-showcase-ready": ready ? 'true' : 'false', children: [_jsx("div", { className: "showcase-lazy__poster", "aria-hidden": ready, children: poster }), Live && !failed ? (_jsx("div", { className: "showcase-lazy__live", children: _jsx(Live, { ...props, onReady: () => setReady(true) }) })) : null] }));
50
+ }
51
+ //# sourceMappingURL=LazyShowcase.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LazyShowcase.js","sourceRoot":"","sources":["../../src/showcase/LazyShowcase.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { type RefObject } from 'react';
2
+ /** Subscribes to a media query; `false` during SSR. */
3
+ export declare function useMediaQuery(query: string): boolean;
4
+ export declare function usePrefersReducedMotion(): boolean;
5
+ /** `true` while the document is visible (tab focused / not minimized). */
6
+ export declare function usePageVisible(): boolean;
7
+ /** `true` while any part of the element (by `threshold`) is in the viewport. */
8
+ export declare function useInView(ref: RefObject<Element | null>, { threshold, rootMargin, }?: {
9
+ threshold?: number;
10
+ rootMargin?: string;
11
+ }): boolean;
12
+ /**
13
+ * Should a scripted show run on this device at all? Not on touch-only
14
+ * devices, small viewports, or with reduced motion.
15
+ */
16
+ export declare function canRunScriptedShow(minViewportWidth?: number): boolean;
17
+ /** requestIdleCallback with a timeout fallback (Safari has no rIC). */
18
+ export declare function whenIdle(callback: () => void, timeout?: number): () => void;
19
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/showcase/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5D,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,WAU1C;AAED,wBAAgB,uBAAuB,YAEtC;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,YAS7B;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CACvB,GAAG,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAC9B,EACE,SAAa,EACb,UAAkB,GACnB,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,WAcpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,SAAM,WAOxD;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,SAAO,cAc5D"}
@@ -0,0 +1,63 @@
1
+ 'use client';
2
+ import { useEffect, useState } from 'react';
3
+ /** Subscribes to a media query; `false` during SSR. */
4
+ export function useMediaQuery(query) {
5
+ const [matches, setMatches] = useState(false);
6
+ useEffect(() => {
7
+ const mql = window.matchMedia(query);
8
+ const update = () => setMatches(mql.matches);
9
+ update();
10
+ mql.addEventListener('change', update);
11
+ return () => mql.removeEventListener('change', update);
12
+ }, [query]);
13
+ return matches;
14
+ }
15
+ export function usePrefersReducedMotion() {
16
+ return useMediaQuery('(prefers-reduced-motion: reduce)');
17
+ }
18
+ /** `true` while the document is visible (tab focused / not minimized). */
19
+ export function usePageVisible() {
20
+ const [visible, setVisible] = useState(true);
21
+ useEffect(() => {
22
+ const update = () => setVisible(document.visibilityState !== 'hidden');
23
+ update();
24
+ document.addEventListener('visibilitychange', update);
25
+ return () => document.removeEventListener('visibilitychange', update);
26
+ }, []);
27
+ return visible;
28
+ }
29
+ /** `true` while any part of the element (by `threshold`) is in the viewport. */
30
+ export function useInView(ref, { threshold = 0, rootMargin = '0px', } = {}) {
31
+ const [inView, setInView] = useState(false);
32
+ useEffect(() => {
33
+ const node = ref.current;
34
+ if (!node)
35
+ return;
36
+ const observer = new IntersectionObserver((entries) => setInView(entries.some((entry) => entry.isIntersecting)), { threshold, rootMargin });
37
+ observer.observe(node);
38
+ return () => observer.disconnect();
39
+ }, [ref, threshold, rootMargin]);
40
+ return inView;
41
+ }
42
+ /**
43
+ * Should a scripted show run on this device at all? Not on touch-only
44
+ * devices, small viewports, or with reduced motion.
45
+ */
46
+ export function canRunScriptedShow(minViewportWidth = 768) {
47
+ if (typeof window === 'undefined')
48
+ return false;
49
+ return (window.matchMedia('(pointer: fine)').matches &&
50
+ !window.matchMedia('(prefers-reduced-motion: reduce)').matches &&
51
+ window.innerWidth >= minViewportWidth);
52
+ }
53
+ /** requestIdleCallback with a timeout fallback (Safari has no rIC). */
54
+ export function whenIdle(callback, timeout = 1500) {
55
+ const w = window;
56
+ if (w.requestIdleCallback) {
57
+ const id = w.requestIdleCallback(callback, { timeout });
58
+ return () => w.cancelIdleCallback?.(id);
59
+ }
60
+ const id = window.setTimeout(callback, Math.min(timeout, 300));
61
+ return () => window.clearTimeout(id);
62
+ }
63
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/showcase/hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Showcase kit: product-agnostic building blocks for live, scripted
3
+ * marketing demos — a fake cursor toolkit, the automated "take over" shell,
4
+ * and a poster-first lazy loader.
5
+ *
6
+ * BOUNDARY RULE: nothing in this folder may import product code or the rest
7
+ * of the kit — only React and sibling files (test/showcase.test.ts checks it).
8
+ *
9
+ * Styles: import `@thedatagrid/docs-kit/showcase/styles.css` once.
10
+ */
11
+ export * from './scripted.ts';
12
+ export * from './hooks.ts';
13
+ export { AutomatedDemo } from './AutomatedDemo.tsx';
14
+ export type { AutomatedDemoProps, AutomatedDemoStatus, ShowcaseScriptContext, } from './AutomatedDemo.tsx';
15
+ export { LazyShowcase } from './LazyShowcase.tsx';
16
+ export type { LazyShowcaseProps, LazyShowcaseLoadedProps, } from './LazyShowcase.tsx';
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/showcase/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Showcase kit: product-agnostic building blocks for live, scripted
3
+ * marketing demos — a fake cursor toolkit, the automated "take over" shell,
4
+ * and a poster-first lazy loader.
5
+ *
6
+ * BOUNDARY RULE: nothing in this folder may import product code or the rest
7
+ * of the kit — only React and sibling files (test/showcase.test.ts checks it).
8
+ *
9
+ * Styles: import `@thedatagrid/docs-kit/showcase/styles.css` once.
10
+ */
11
+ export * from "./scripted.js";
12
+ export * from "./hooks.js";
13
+ export { AutomatedDemo } from "./AutomatedDemo.js";
14
+ export { LazyShowcase } from "./LazyShowcase.js";
15
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/showcase/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAMpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC"}
@@ -0,0 +1,100 @@
1
+ /**
2
+ * Tiny automation toolkit for a "scripted demo you can take over": a fake SVG
3
+ * cursor tweened over a LIVE component, with real state changes applied at
4
+ * each "click". Everything is cancellable through one AbortSignal, so a single
5
+ * real user interaction stops the show instantly and leaves the component
6
+ * exactly where the script brought it.
7
+ *
8
+ * Product-agnostic on purpose: no imports from any grid or app code.
9
+ */
10
+ /** Thrown by every helper when the script is aborted; callers swallow it. */
11
+ export declare class ScriptCancelled extends Error {
12
+ constructor();
13
+ }
14
+ export declare function assertActive(signal: AbortSignal): void;
15
+ export declare function sleep(ms: number, signal: AbortSignal): Promise<void>;
16
+ /** Poll until `get` returns a truthy value; null when it times out. */
17
+ export declare function waitFor<T>(get: () => T | null | undefined | false, signal: AbortSignal, { timeout, interval, }?: {
18
+ timeout?: number;
19
+ interval?: number;
20
+ }): Promise<T | null>;
21
+ export type Point = {
22
+ x: number;
23
+ y: number;
24
+ };
25
+ export declare const easeInOutCubic: (t: number) => number;
26
+ /** Run `onFrame(easedT)` on every animation frame for `duration` ms. */
27
+ export declare function tween(onFrame: (t: number) => void, duration: number, signal: AbortSignal, ease?: (t: number) => number): Promise<void>;
28
+ /**
29
+ * Inertial "fling": starts at `velocity` (px per ms) and decays exponentially,
30
+ * like a trackpad swipe released at speed. `apply` receives the delta for the
31
+ * frame and returns false to stop early (for example when an edge is hit).
32
+ * Resolves with the total distance travelled.
33
+ */
34
+ export declare function fling(apply: (delta: number) => boolean | void, { velocity,
35
+ /** Fraction of velocity kept per 16.7ms frame. 0.95 ≈ a long glide. */
36
+ friction, minVelocity, maxDuration, }: {
37
+ velocity: number;
38
+ friction?: number;
39
+ minVelocity?: number;
40
+ maxDuration?: number;
41
+ }, signal: AbortSignal): Promise<number>;
42
+ /**
43
+ * Dispatch a full pointer+mouse sequence so whatever the target listens to
44
+ * (pointerdown, mousedown, click…) fires. Coordinates are real client-space
45
+ * coords, so `elementFromPoint`-style logic in handlers also works.
46
+ *
47
+ * Note: synthetic events have `isTrusted === false`; the takeover logic in
48
+ * AutomatedDemo relies on that to tell the script apart from the user.
49
+ */
50
+ export declare function dispatchClickSequence(el: HTMLElement, clientX: number, clientY: number): void;
51
+ /** Fire hover events (pointerover/enter, mouseover/enter/move) on `el`. */
52
+ export declare function dispatchHover(el: HTMLElement, clientX: number, clientY: number): void;
53
+ export type ScriptedCursor = ReturnType<typeof createScriptedCursor>;
54
+ /**
55
+ * The fake mouse: a cursor element inside a pointer-events-none overlay that
56
+ * covers the demo. Positions are in overlay-local coordinates; the arrow tip
57
+ * is the hotspot.
58
+ */
59
+ export declare function createScriptedCursor(overlay: HTMLElement): {
60
+ element: HTMLDivElement;
61
+ show(): void;
62
+ hide(): void;
63
+ /** A small caption next to the cursor ("⇢ swipe", "1M rows"…); null hides it. */
64
+ setLabel(text: string | null): void;
65
+ /** Current hotspot position in client coordinates (for event dispatch). */
66
+ clientPoint(): Point;
67
+ localPoint(): Point;
68
+ moveTo(target: Point, signal: AbortSignal, { speed }?: {
69
+ speed?: number;
70
+ }): Promise<void>;
71
+ /**
72
+ * Move to an element's center (plus optional offset from center).
73
+ * Recomputes the rect at call time, so virtualized cells are fine as long
74
+ * as they exist when the move starts.
75
+ */
76
+ moveToElement(target: HTMLElement, signal: AbortSignal, offset?: Partial<Point>, options?: {
77
+ speed?: number;
78
+ }): Promise<void>;
79
+ /** Move onto `target` and fire hover events on it (opens hover menus). */
80
+ hover(target: HTMLElement, signal: AbortSignal, offset?: Partial<Point>): Promise<void>;
81
+ /**
82
+ * Play the click ripple; optionally dispatch a real event sequence on
83
+ * `target` at the current cursor position. Resolves after the press —
84
+ * the ripple keeps expanding while the script moves on.
85
+ */
86
+ click(signal: AbortSignal, target?: HTMLElement | null): Promise<void>;
87
+ /**
88
+ * Press on `source`, drag to `to` (overlay-local) dispatching pointermove
89
+ * along the way, release. Events go to `source` (handlers that track a
90
+ * drag usually listen on the pressed element with pointer capture).
91
+ */
92
+ drag(source: HTMLElement, to: Point, signal: AbortSignal, { duration, steps, }?: {
93
+ duration?: number;
94
+ steps?: number;
95
+ }): Promise<void>;
96
+ /** Convert an element's center to overlay-local coordinates. */
97
+ centerOf: (target: HTMLElement, offset?: Partial<Point>) => Point;
98
+ destroy(): void;
99
+ };
100
+ //# sourceMappingURL=scripted.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scripted.d.ts","sourceRoot":"","sources":["../../src/showcase/scripted.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,QAE/C;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAapE;AAED,uEAAuE;AACvE,wBAAsB,OAAO,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,EACvC,MAAM,EAAE,WAAW,EACnB,EACE,OAAe,EACf,QAAc,GACf,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CASnB;AAED,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,WACmB,CAAC;AAE5D,wEAAwE;AACxE,wBAAgB,KAAK,CACnB,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAuB,GAC3C,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,EACxC,EACE,QAAQ;AACR,uEAAuE;AACvE,QAAgB,EAChB,WAAkB,EAClB,WAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AA2CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,QAkChB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,QAiBhB;AAyCD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW;;;;IA4CrD,iFAAiF;mBAClE,MAAM,GAAG,IAAI;IAI5B,2EAA2E;mBAC5D,KAAK;kBAGN,KAAK;mBAKT,KAAK,UACL,WAAW,cACJ;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAiBnC;;;;OAIG;0BAEO,WAAW,UACX,WAAW,WACX,OAAO,CAAC,KAAK,CAAC,YACZ;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAK9B,0EAA0E;kBAEhE,WAAW,UACX,WAAW,WACX,OAAO,CAAC,KAAK,CAAC;IAOxB;;;;OAIG;kBACiB,WAAW,WAAW,WAAW,GAAG,IAAI;IAqB5D;;;;OAIG;iBAEO,WAAW,MACf,KAAK,UACD,WAAW,yBAIhB;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA+D1C,gEAAgE;uBAlLxD,WAAW,WACX,OAAO,CAAC,KAAK,CAAC,KACrB,KAAK;;EAyLT"}