@thedatagrid/docs-kit 0.0.0-stage → 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.
- package/CHANGELOG.md +20 -0
- package/README.md +224 -2
- package/dist/code/demoFiles.d.ts +14 -0
- package/dist/code/demoFiles.d.ts.map +1 -0
- package/dist/code/demoFiles.js +46 -0
- package/dist/code/demoFiles.js.map +1 -0
- package/dist/code/heights.d.ts +17 -0
- package/dist/code/heights.d.ts.map +1 -0
- package/dist/code/heights.js +40 -0
- package/dist/code/heights.js.map +1 -0
- package/dist/code/highlightSpec.d.ts +34 -0
- package/dist/code/highlightSpec.d.ts.map +1 -0
- package/dist/code/highlightSpec.js +119 -0
- package/dist/code/highlightSpec.js.map +1 -0
- package/dist/code/imports.d.ts +5 -0
- package/dist/code/imports.d.ts.map +1 -0
- package/dist/code/imports.js +17 -0
- package/dist/code/imports.js.map +1 -0
- package/dist/code/index.d.ts +8 -0
- package/dist/code/index.d.ts.map +1 -0
- package/dist/code/index.js +8 -0
- package/dist/code/index.js.map +1 -0
- package/dist/code/lineRanges.d.ts +5 -0
- package/dist/code/lineRanges.d.ts.map +1 -0
- package/dist/code/lineRanges.js +35 -0
- package/dist/code/lineRanges.js.map +1 -0
- package/dist/code/regions.d.ts +53 -0
- package/dist/code/regions.d.ts.map +1 -0
- package/dist/code/regions.js +237 -0
- package/dist/code/regions.js.map +1 -0
- package/dist/code/shiki.d.ts +58 -0
- package/dist/code/shiki.d.ts.map +1 -0
- package/dist/code/shiki.js +244 -0
- package/dist/code/shiki.js.map +1 -0
- package/dist/demos/build.d.ts +17 -0
- package/dist/demos/build.d.ts.map +1 -0
- package/dist/demos/build.js +426 -0
- package/dist/demos/build.js.map +1 -0
- package/dist/demos/cli.d.ts +3 -0
- package/dist/demos/cli.d.ts.map +1 -0
- package/dist/demos/cli.js +102 -0
- package/dist/demos/cli.js.map +1 -0
- package/dist/demos/client.d.ts +27 -0
- package/dist/demos/client.d.ts.map +1 -0
- package/dist/demos/client.js +61 -0
- package/dist/demos/client.js.map +1 -0
- package/dist/demos/compile/core.d.ts +64 -0
- package/dist/demos/compile/core.d.ts.map +1 -0
- package/dist/demos/compile/core.js +174 -0
- package/dist/demos/compile/core.js.map +1 -0
- package/dist/demos/config.d.ts +108 -0
- package/dist/demos/config.d.ts.map +1 -0
- package/dist/demos/config.js +4 -0
- package/dist/demos/config.js.map +1 -0
- package/dist/demos/devEvents.d.ts +13 -0
- package/dist/demos/devEvents.d.ts.map +1 -0
- package/dist/demos/devEvents.js +45 -0
- package/dist/demos/devEvents.js.map +1 -0
- package/dist/demos/html.d.ts +21 -0
- package/dist/demos/html.d.ts.map +1 -0
- package/dist/demos/html.js +57 -0
- package/dist/demos/html.js.map +1 -0
- package/dist/demos/index.d.ts +8 -0
- package/dist/demos/index.d.ts.map +1 -0
- package/dist/demos/index.js +6 -0
- package/dist/demos/index.js.map +1 -0
- package/dist/demos/pages.d.ts +15 -0
- package/dist/demos/pages.d.ts.map +1 -0
- package/dist/demos/pages.js +71 -0
- package/dist/demos/pages.js.map +1 -0
- package/dist/demos/runtime/iframe.d.ts +50 -0
- package/dist/demos/runtime/iframe.d.ts.map +1 -0
- package/dist/demos/runtime/iframe.js +245 -0
- package/dist/demos/runtime/iframe.js.map +1 -0
- package/dist/demos/runtime/react.d.ts +3 -0
- package/dist/demos/runtime/react.d.ts.map +1 -0
- package/dist/demos/runtime/react.js +17 -0
- package/dist/demos/runtime/react.js.map +1 -0
- package/dist/demos/slug.d.ts +3 -0
- package/dist/demos/slug.d.ts.map +1 -0
- package/dist/demos/slug.js +11 -0
- package/dist/demos/slug.js.map +1 -0
- package/dist/demos/vendor.d.ts +32 -0
- package/dist/demos/vendor.d.ts.map +1 -0
- package/dist/demos/vendor.js +127 -0
- package/dist/demos/vendor.js.map +1 -0
- package/dist/demos/worker/compile.worker.d.ts +2 -0
- package/dist/demos/worker/compile.worker.d.ts.map +1 -0
- package/dist/demos/worker/compile.worker.js +27 -0
- package/dist/demos/worker/compile.worker.js.map +1 -0
- package/dist/editor/install.d.ts +15 -0
- package/dist/editor/install.d.ts.map +1 -0
- package/dist/editor/install.js +71 -0
- package/dist/editor/install.js.map +1 -0
- package/dist/fork/codesandbox.d.ts +39 -0
- package/dist/fork/codesandbox.d.ts.map +1 -0
- package/dist/fork/codesandbox.js +156 -0
- package/dist/fork/codesandbox.js.map +1 -0
- package/dist/fork/index.d.ts +2 -0
- package/dist/fork/index.d.ts.map +1 -0
- package/dist/fork/index.js +2 -0
- package/dist/fork/index.js.map +1 -0
- package/dist/react/Demo.d.ts +80 -0
- package/dist/react/Demo.d.ts.map +1 -0
- package/dist/react/Demo.js +156 -0
- package/dist/react/Demo.js.map +1 -0
- package/dist/react/DemoIframe.d.ts +22 -0
- package/dist/react/DemoIframe.d.ts.map +1 -0
- package/dist/react/DemoIframe.js +123 -0
- package/dist/react/DemoIframe.js.map +1 -0
- package/dist/react/DemoShell.d.ts +47 -0
- package/dist/react/DemoShell.d.ts.map +1 -0
- package/dist/react/DemoShell.js +341 -0
- package/dist/react/DemoShell.js.map +1 -0
- package/dist/react/devEvents.d.ts +17 -0
- package/dist/react/devEvents.d.ts.map +1 -0
- package/dist/react/devEvents.js +30 -0
- package/dist/react/devEvents.js.map +1 -0
- package/dist/react/editor.d.ts +17 -0
- package/dist/react/editor.d.ts.map +1 -0
- package/dist/react/editor.js +158 -0
- package/dist/react/editor.js.map +1 -0
- package/dist/react/fork.d.ts +10 -0
- package/dist/react/fork.d.ts.map +1 -0
- package/dist/react/fork.js +30 -0
- package/dist/react/fork.js.map +1 -0
- package/dist/react/index.d.ts +4 -0
- package/dist/react/index.d.ts.map +1 -0
- package/dist/react/index.js +4 -0
- package/dist/react/index.js.map +1 -0
- package/dist/react/styles.css +471 -0
- package/dist/remark/index.d.ts +3 -0
- package/dist/remark/index.d.ts.map +1 -0
- package/dist/remark/index.js +3 -0
- package/dist/remark/index.js.map +1 -0
- package/dist/remark/meta.d.ts +7 -0
- package/dist/remark/meta.d.ts.map +1 -0
- package/dist/remark/meta.js +20 -0
- package/dist/remark/meta.js.map +1 -0
- package/dist/remark/remarkDemoFences.d.ts +77 -0
- package/dist/remark/remarkDemoFences.d.ts.map +1 -0
- package/dist/remark/remarkDemoFences.js +259 -0
- package/dist/remark/remarkDemoFences.js.map +1 -0
- package/editor-extension/README.md +23 -0
- package/editor-extension/extension.js +40 -0
- package/editor-extension/links.js +137 -0
- package/editor-extension/package.json +19 -0
- package/package.json +107 -4
- package/src/code/demoFiles.ts +54 -0
- package/src/code/heights.ts +47 -0
- package/src/code/highlightSpec.ts +139 -0
- package/src/code/imports.ts +18 -0
- package/src/code/index.ts +46 -0
- package/src/code/lineRanges.ts +31 -0
- package/src/code/regions.ts +270 -0
- package/src/code/shiki.ts +271 -0
- package/src/demos/build.ts +477 -0
- package/src/demos/cli.ts +97 -0
- package/src/demos/client.ts +82 -0
- package/src/demos/compile/core.ts +228 -0
- package/src/demos/config.ts +106 -0
- package/src/demos/devEvents.ts +45 -0
- package/src/demos/html.ts +74 -0
- package/src/demos/index.ts +25 -0
- package/src/demos/pages.ts +79 -0
- package/src/demos/runtime/iframe.ts +262 -0
- package/src/demos/runtime/react.ts +19 -0
- package/src/demos/slug.ts +10 -0
- package/src/demos/vendor.ts +142 -0
- package/src/demos/worker/compile.worker.ts +35 -0
- package/src/editor/install.ts +85 -0
- package/src/fork/codesandbox.ts +189 -0
- package/src/fork/index.ts +10 -0
- package/src/react/Demo.tsx +250 -0
- package/src/react/DemoIframe.tsx +165 -0
- package/src/react/DemoShell.tsx +592 -0
- package/src/react/devEvents.ts +34 -0
- package/src/react/editor.ts +178 -0
- package/src/react/fork.ts +31 -0
- package/src/react/index.ts +10 -0
- package/src/react/styles.css +471 -0
- package/src/remark/index.ts +2 -0
- package/src/remark/meta.ts +20 -0
- package/src/remark/remarkDemoFences.ts +330 -0
|
@@ -0,0 +1,471 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* docs-kit demo cards. Plain CSS on custom properties: sites restyle by
|
|
3
|
+
* overriding the --dk-* variables (light values on :root, dark ones under
|
|
4
|
+
* [data-theme='dark']), or any .dk-* rule.
|
|
5
|
+
*
|
|
6
|
+
* The code editor reads --dk-editor-* variables (README → Theming). Only the
|
|
7
|
+
* syntax colors have defaults here; every other --dk-editor-* variable falls
|
|
8
|
+
* back to a card variable:
|
|
9
|
+
* --dk-editor-bg --dk-code-bg
|
|
10
|
+
* --dk-editor-fg --dk-fg
|
|
11
|
+
* --dk-editor-font-family --dk-font-mono
|
|
12
|
+
* --dk-editor-font-size --dk-code-font-size
|
|
13
|
+
* --dk-editor-line-height --dk-code-line-height
|
|
14
|
+
* --dk-editor-cursor --dk-editor-fg
|
|
15
|
+
* --dk-editor-selection-bg (set below)
|
|
16
|
+
* --dk-editor-active-line-bg --dk-accent-soft
|
|
17
|
+
* --dk-editor-gutter-bg --dk-editor-bg
|
|
18
|
+
* --dk-editor-gutter-fg --dk-line-number
|
|
19
|
+
* --dk-editor-gutter-border transparent
|
|
20
|
+
* --dk-editor-active-line-gutter-bg / -fg active line bg / gutter fg
|
|
21
|
+
* --dk-editor-selection-match-bg --dk-accent-soft
|
|
22
|
+
* --dk-editor-bracket-match-bg / -outline --dk-accent-soft / --dk-accent
|
|
23
|
+
* --dk-editor-search-match-bg / -outline --dk-highlight-bg / -border
|
|
24
|
+
* --dk-editor-search-match-selected-bg --dk-accent-soft
|
|
25
|
+
* --dk-editor-tooltip-bg / -fg --dk-editor-panel-bg / -fg
|
|
26
|
+
* --dk-editor-tooltip-selected-bg / -fg --dk-accent-soft / -fg
|
|
27
|
+
* --dk-editor-panel-bg / -fg --dk-surface / -fg (search panel)
|
|
28
|
+
* --dk-editor-border --dk-border
|
|
29
|
+
*/
|
|
30
|
+
:root {
|
|
31
|
+
--dk-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
|
|
32
|
+
--dk-font-sans: system-ui, -apple-system, 'Segoe UI', sans-serif;
|
|
33
|
+
--dk-radius: 12px;
|
|
34
|
+
--dk-border: rgb(0 0 0 / 0.12);
|
|
35
|
+
--dk-surface: #ffffff;
|
|
36
|
+
--dk-code-bg: #f8f9fb;
|
|
37
|
+
--dk-preview-bg: #ffffff;
|
|
38
|
+
--dk-fg: #1f2328;
|
|
39
|
+
--dk-heading: #0d1117;
|
|
40
|
+
--dk-muted: #59636e;
|
|
41
|
+
--dk-faint: #818b98;
|
|
42
|
+
--dk-accent: #0969da;
|
|
43
|
+
--dk-accent-soft: rgb(9 105 218 / 0.1);
|
|
44
|
+
--dk-highlight-bg: rgb(9 105 218 / 0.1);
|
|
45
|
+
--dk-highlight-border: #0969da;
|
|
46
|
+
/* `#highlight label` pills, line numbers */
|
|
47
|
+
--dk-label-bg: rgb(9 105 218 / 0.12);
|
|
48
|
+
--dk-label-fg: #0550ae;
|
|
49
|
+
--dk-line-number: #818b98;
|
|
50
|
+
--dk-error: #cf222e;
|
|
51
|
+
--dk-ok: #1a7f37;
|
|
52
|
+
--dk-shadow: 0 20px 60px rgb(0 0 0 / 0.25);
|
|
53
|
+
--dk-code-max-height: 560px;
|
|
54
|
+
--dk-code-font-size: 13.5px;
|
|
55
|
+
--dk-code-line-height: 1.6;
|
|
56
|
+
/* editor syntax colors (github-light, like the static code) */
|
|
57
|
+
--dk-editor-keyword: #cf222e;
|
|
58
|
+
--dk-editor-constant: #0550ae;
|
|
59
|
+
--dk-editor-string: #0a3069;
|
|
60
|
+
--dk-editor-number: #0550ae;
|
|
61
|
+
--dk-editor-comment: #6e7781;
|
|
62
|
+
--dk-editor-type: #953800;
|
|
63
|
+
--dk-editor-function: #8250df;
|
|
64
|
+
--dk-editor-property: #0550ae;
|
|
65
|
+
--dk-editor-tag: #116329;
|
|
66
|
+
--dk-editor-attribute: #0550ae;
|
|
67
|
+
--dk-editor-operator: #cf222e;
|
|
68
|
+
--dk-editor-selection-bg: rgb(9 105 218 / 0.2);
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
[data-theme='dark'] {
|
|
72
|
+
--dk-border: rgb(255 255 255 / 0.12);
|
|
73
|
+
--dk-surface: #16181d;
|
|
74
|
+
--dk-code-bg: #1a1b26;
|
|
75
|
+
--dk-preview-bg: #111317;
|
|
76
|
+
--dk-fg: #d6dae0;
|
|
77
|
+
--dk-heading: #f3f5f7;
|
|
78
|
+
--dk-muted: #9aa3ad;
|
|
79
|
+
--dk-faint: #6e7681;
|
|
80
|
+
--dk-accent: #58a6ff;
|
|
81
|
+
--dk-accent-soft: rgb(88 166 255 / 0.14);
|
|
82
|
+
--dk-highlight-bg: rgb(122 162 247 / 0.14);
|
|
83
|
+
--dk-highlight-border: #7aa2f7;
|
|
84
|
+
--dk-label-bg: rgb(122 162 247 / 0.28);
|
|
85
|
+
--dk-label-fg: #e3eaff;
|
|
86
|
+
--dk-line-number: #6e7681;
|
|
87
|
+
--dk-error: #ff7b72;
|
|
88
|
+
--dk-ok: #3fb950;
|
|
89
|
+
/* editor syntax colors (tokyo-night, like the static code) */
|
|
90
|
+
--dk-editor-keyword: #bb9af7;
|
|
91
|
+
--dk-editor-constant: #ff9e64;
|
|
92
|
+
--dk-editor-string: #9ece6a;
|
|
93
|
+
--dk-editor-number: #ff9e64;
|
|
94
|
+
--dk-editor-comment: #565f89;
|
|
95
|
+
--dk-editor-type: #2ac3de;
|
|
96
|
+
--dk-editor-function: #7aa2f7;
|
|
97
|
+
--dk-editor-property: #73daca;
|
|
98
|
+
--dk-editor-tag: #f7768e;
|
|
99
|
+
--dk-editor-attribute: #e0af68;
|
|
100
|
+
--dk-editor-operator: #89ddff;
|
|
101
|
+
--dk-editor-punctuation: #9abdf5;
|
|
102
|
+
--dk-editor-selection-bg: rgb(122 162 247 / 0.25);
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/* shiki dual themes (defaultColor: false). Only the text color: the code
|
|
106
|
+
background is --dk-code-bg, and a background on the token spans would paint
|
|
107
|
+
boxes over highlighted lines. */
|
|
108
|
+
.dk-demo .shiki,
|
|
109
|
+
.dk-demo .shiki span {
|
|
110
|
+
color: var(--shiki-light);
|
|
111
|
+
}
|
|
112
|
+
[data-theme='dark'] .dk-demo .shiki,
|
|
113
|
+
[data-theme='dark'] .dk-demo .shiki span {
|
|
114
|
+
color: var(--shiki-dark);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
.dk-demo {
|
|
118
|
+
container: dk-demo / inline-size;
|
|
119
|
+
position: relative;
|
|
120
|
+
margin: 1.75rem 0;
|
|
121
|
+
overflow: hidden;
|
|
122
|
+
border: 1px solid var(--dk-border);
|
|
123
|
+
border-radius: var(--dk-radius);
|
|
124
|
+
background: var(--dk-surface);
|
|
125
|
+
color: var(--dk-fg);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
.dk-demo-header {
|
|
129
|
+
position: relative;
|
|
130
|
+
padding: 12px 40px 12px 16px;
|
|
131
|
+
border-bottom: 1px solid var(--dk-border);
|
|
132
|
+
}
|
|
133
|
+
.dk-demo-title {
|
|
134
|
+
font-size: 15px;
|
|
135
|
+
font-weight: 600;
|
|
136
|
+
color: var(--dk-heading);
|
|
137
|
+
}
|
|
138
|
+
.dk-demo-description {
|
|
139
|
+
margin-top: 4px;
|
|
140
|
+
font-size: 14px;
|
|
141
|
+
line-height: 1.55;
|
|
142
|
+
color: var(--dk-muted);
|
|
143
|
+
}
|
|
144
|
+
.dk-demo-description p {
|
|
145
|
+
margin: 0;
|
|
146
|
+
}
|
|
147
|
+
.dk-demo-permalink {
|
|
148
|
+
position: absolute;
|
|
149
|
+
top: 12px;
|
|
150
|
+
right: 12px;
|
|
151
|
+
padding: 0 4px;
|
|
152
|
+
border-radius: 6px;
|
|
153
|
+
font-weight: 600;
|
|
154
|
+
color: var(--dk-faint);
|
|
155
|
+
text-decoration: none;
|
|
156
|
+
opacity: 0;
|
|
157
|
+
transition: opacity 0.15s;
|
|
158
|
+
}
|
|
159
|
+
.dk-demo-header:hover .dk-demo-permalink,
|
|
160
|
+
.dk-demo-permalink:focus-visible {
|
|
161
|
+
opacity: 1;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
.dk-demo-toolbar {
|
|
165
|
+
display: flex;
|
|
166
|
+
align-items: center;
|
|
167
|
+
gap: 4px;
|
|
168
|
+
min-height: 40px;
|
|
169
|
+
padding: 4px 10px;
|
|
170
|
+
border-bottom: 1px solid var(--dk-border);
|
|
171
|
+
font-size: 13px;
|
|
172
|
+
}
|
|
173
|
+
.dk-demo-spacer {
|
|
174
|
+
flex: 1;
|
|
175
|
+
}
|
|
176
|
+
.dk-demo-tab,
|
|
177
|
+
.dk-demo-action,
|
|
178
|
+
.dk-demo-icon {
|
|
179
|
+
appearance: none;
|
|
180
|
+
border: 0;
|
|
181
|
+
background: none;
|
|
182
|
+
color: var(--dk-muted);
|
|
183
|
+
cursor: pointer;
|
|
184
|
+
border-radius: 6px;
|
|
185
|
+
font: inherit;
|
|
186
|
+
text-decoration: none;
|
|
187
|
+
transition:
|
|
188
|
+
background-color 0.15s,
|
|
189
|
+
color 0.15s;
|
|
190
|
+
}
|
|
191
|
+
.dk-demo-tab {
|
|
192
|
+
padding: 4px 10px;
|
|
193
|
+
}
|
|
194
|
+
.dk-demo-tab--active {
|
|
195
|
+
background: var(--dk-accent-soft);
|
|
196
|
+
color: var(--dk-heading);
|
|
197
|
+
font-weight: 500;
|
|
198
|
+
}
|
|
199
|
+
.dk-demo-action {
|
|
200
|
+
padding: 4px 8px;
|
|
201
|
+
font-family: var(--dk-font-mono);
|
|
202
|
+
font-size: 12.5px;
|
|
203
|
+
}
|
|
204
|
+
.dk-demo-icon {
|
|
205
|
+
display: inline-flex;
|
|
206
|
+
align-items: center;
|
|
207
|
+
justify-content: center;
|
|
208
|
+
width: 30px;
|
|
209
|
+
height: 30px;
|
|
210
|
+
}
|
|
211
|
+
.dk-demo-tab:hover,
|
|
212
|
+
.dk-demo-action:hover,
|
|
213
|
+
.dk-demo-icon:hover {
|
|
214
|
+
background: var(--dk-accent-soft);
|
|
215
|
+
color: var(--dk-fg);
|
|
216
|
+
}
|
|
217
|
+
.dk-demo-files {
|
|
218
|
+
display: flex;
|
|
219
|
+
flex-wrap: wrap;
|
|
220
|
+
gap: 2px;
|
|
221
|
+
margin-left: 8px;
|
|
222
|
+
}
|
|
223
|
+
.dk-demo-file,
|
|
224
|
+
.dk-demo-filename {
|
|
225
|
+
padding: 3px 8px;
|
|
226
|
+
border-radius: 6px;
|
|
227
|
+
font-family: var(--dk-font-mono);
|
|
228
|
+
font-size: 12px;
|
|
229
|
+
color: var(--dk-faint);
|
|
230
|
+
text-decoration: none;
|
|
231
|
+
}
|
|
232
|
+
.dk-demo-file:hover {
|
|
233
|
+
color: var(--dk-fg);
|
|
234
|
+
}
|
|
235
|
+
.dk-demo-file--active {
|
|
236
|
+
background: var(--dk-accent-soft);
|
|
237
|
+
color: var(--dk-heading);
|
|
238
|
+
}
|
|
239
|
+
.dk-demo-badge {
|
|
240
|
+
padding: 2px 8px;
|
|
241
|
+
border-radius: 999px;
|
|
242
|
+
background: var(--dk-accent-soft);
|
|
243
|
+
color: var(--dk-accent);
|
|
244
|
+
font-family: var(--dk-font-mono);
|
|
245
|
+
font-size: 11.5px;
|
|
246
|
+
}
|
|
247
|
+
.dk-demo-status {
|
|
248
|
+
padding: 0 6px;
|
|
249
|
+
font-family: var(--dk-font-mono);
|
|
250
|
+
font-size: 12px;
|
|
251
|
+
color: var(--dk-faint);
|
|
252
|
+
}
|
|
253
|
+
.dk-demo-status--error {
|
|
254
|
+
color: var(--dk-error);
|
|
255
|
+
}
|
|
256
|
+
.dk-demo-status--ok {
|
|
257
|
+
color: var(--dk-ok);
|
|
258
|
+
}
|
|
259
|
+
@container dk-demo (max-width: 560px) {
|
|
260
|
+
.dk-demo-files,
|
|
261
|
+
.dk-demo-filename,
|
|
262
|
+
.dk-demo-status {
|
|
263
|
+
display: none;
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
.dk-demo-body {
|
|
268
|
+
display: flex;
|
|
269
|
+
flex-direction: column;
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
.dk-demo-frame {
|
|
273
|
+
position: relative;
|
|
274
|
+
background: var(--dk-preview-bg);
|
|
275
|
+
}
|
|
276
|
+
.dk-demo-frame--fill {
|
|
277
|
+
flex: 1;
|
|
278
|
+
min-height: 0;
|
|
279
|
+
height: 100%;
|
|
280
|
+
}
|
|
281
|
+
.dk-demo-frame iframe {
|
|
282
|
+
display: block;
|
|
283
|
+
width: 100%;
|
|
284
|
+
height: 100%;
|
|
285
|
+
border: 0;
|
|
286
|
+
transition: opacity 0.3s;
|
|
287
|
+
}
|
|
288
|
+
.dk-demo-loading {
|
|
289
|
+
position: absolute;
|
|
290
|
+
inset: 0;
|
|
291
|
+
display: flex;
|
|
292
|
+
align-items: center;
|
|
293
|
+
justify-content: center;
|
|
294
|
+
pointer-events: none;
|
|
295
|
+
font-family: var(--dk-font-mono);
|
|
296
|
+
font-size: 13px;
|
|
297
|
+
color: var(--dk-faint);
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
.dk-demo-code {
|
|
301
|
+
display: flex;
|
|
302
|
+
flex-direction: column;
|
|
303
|
+
overflow: auto;
|
|
304
|
+
background: var(--dk-code-bg);
|
|
305
|
+
}
|
|
306
|
+
.dk-demo-code--capped {
|
|
307
|
+
max-height: var(--dk-code-max-height);
|
|
308
|
+
}
|
|
309
|
+
.dk-demo pre.shiki {
|
|
310
|
+
flex-grow: 1;
|
|
311
|
+
margin: 0;
|
|
312
|
+
padding: 14px 0;
|
|
313
|
+
border: 0;
|
|
314
|
+
border-radius: 0;
|
|
315
|
+
overflow: visible;
|
|
316
|
+
font-family: var(--dk-font-mono);
|
|
317
|
+
font-size: var(--dk-code-font-size);
|
|
318
|
+
line-height: var(--dk-code-line-height);
|
|
319
|
+
tab-size: 2;
|
|
320
|
+
background-color: var(--dk-code-bg) !important;
|
|
321
|
+
}
|
|
322
|
+
.dk-demo pre.shiki code {
|
|
323
|
+
display: grid;
|
|
324
|
+
min-width: max-content;
|
|
325
|
+
}
|
|
326
|
+
.dk-demo pre.shiki .line {
|
|
327
|
+
display: inline-block;
|
|
328
|
+
min-height: 1lh;
|
|
329
|
+
padding: 0 18px;
|
|
330
|
+
}
|
|
331
|
+
.dk-demo pre.shiki .line.highlighted {
|
|
332
|
+
background: var(--dk-highlight-bg);
|
|
333
|
+
box-shadow: inset 3px 0 0 var(--dk-highlight-border);
|
|
334
|
+
}
|
|
335
|
+
.dk-demo pre.shiki .line.has-label {
|
|
336
|
+
display: flex;
|
|
337
|
+
gap: 16px;
|
|
338
|
+
}
|
|
339
|
+
/* `#highlight label`: a pill at the end of the line, left out of text selections */
|
|
340
|
+
.dk-demo pre.shiki .line-label {
|
|
341
|
+
align-self: center;
|
|
342
|
+
margin-left: auto;
|
|
343
|
+
padding: 0 8px;
|
|
344
|
+
border-radius: 999px;
|
|
345
|
+
background: var(--dk-label-bg);
|
|
346
|
+
color: var(--dk-label-fg);
|
|
347
|
+
font-family: var(--dk-font-sans);
|
|
348
|
+
font-size: 12px;
|
|
349
|
+
font-weight: 500;
|
|
350
|
+
line-height: 1.6;
|
|
351
|
+
white-space: nowrap;
|
|
352
|
+
user-select: none;
|
|
353
|
+
}
|
|
354
|
+
/* a label on a line of its own (`// #highlight label` above the code) */
|
|
355
|
+
.dk-demo pre.shiki .line.label-only {
|
|
356
|
+
gap: 0;
|
|
357
|
+
user-select: none;
|
|
358
|
+
}
|
|
359
|
+
.dk-demo pre.shiki .line.label-only .line-label {
|
|
360
|
+
margin-left: 0;
|
|
361
|
+
}
|
|
362
|
+
.dk-demo pre.shiki.has-line-numbers .line::before {
|
|
363
|
+
content: attr(data-line);
|
|
364
|
+
display: inline-block;
|
|
365
|
+
width: 2.5em;
|
|
366
|
+
margin-right: 16px;
|
|
367
|
+
text-align: right;
|
|
368
|
+
color: var(--dk-line-number);
|
|
369
|
+
user-select: none;
|
|
370
|
+
}
|
|
371
|
+
.dk-demo .dk-file-link {
|
|
372
|
+
all: unset;
|
|
373
|
+
cursor: pointer;
|
|
374
|
+
text-decoration: underline dotted;
|
|
375
|
+
text-underline-offset: 3px;
|
|
376
|
+
}
|
|
377
|
+
.dk-demo .dk-file-link:hover {
|
|
378
|
+
text-decoration-style: solid;
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
/* plain snippets: the copy button floats over the code */
|
|
382
|
+
.dk-demo--bare .dk-demo-toolbar {
|
|
383
|
+
position: absolute;
|
|
384
|
+
top: 6px;
|
|
385
|
+
right: 6px;
|
|
386
|
+
z-index: 1;
|
|
387
|
+
min-height: 0;
|
|
388
|
+
padding: 0;
|
|
389
|
+
border: 0;
|
|
390
|
+
opacity: 0;
|
|
391
|
+
transition: opacity 0.15s;
|
|
392
|
+
}
|
|
393
|
+
.dk-demo--bare:hover .dk-demo-toolbar,
|
|
394
|
+
.dk-demo--bare .dk-demo-toolbar:focus-within {
|
|
395
|
+
opacity: 1;
|
|
396
|
+
}
|
|
397
|
+
.dk-demo--bare .dk-demo-action {
|
|
398
|
+
background: var(--dk-surface);
|
|
399
|
+
border: 1px solid var(--dk-border);
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/* edit mode: editor | preview side by side when wide enough */
|
|
403
|
+
.dk-demo--editing .dk-demo-body {
|
|
404
|
+
display: grid;
|
|
405
|
+
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
|
|
406
|
+
}
|
|
407
|
+
.dk-demo--editing .dk-demo-editor-pane {
|
|
408
|
+
order: -1;
|
|
409
|
+
min-height: 0;
|
|
410
|
+
overflow: hidden;
|
|
411
|
+
border-right: 1px solid var(--dk-border);
|
|
412
|
+
}
|
|
413
|
+
.dk-demo--editing .dk-demo-preview {
|
|
414
|
+
display: flex;
|
|
415
|
+
flex-direction: column;
|
|
416
|
+
min-height: 0;
|
|
417
|
+
}
|
|
418
|
+
@container dk-demo (max-width: 820px) {
|
|
419
|
+
.dk-demo--editing .dk-demo-body {
|
|
420
|
+
grid-template-columns: minmax(0, 1fr);
|
|
421
|
+
grid-template-rows: minmax(0, 1fr) minmax(0, 1fr);
|
|
422
|
+
}
|
|
423
|
+
.dk-demo--editing .dk-demo-editor-pane {
|
|
424
|
+
border-right: 0;
|
|
425
|
+
border-bottom: 1px solid var(--dk-border);
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
/* the editor's colors and font: --dk-editor-* (editor.ts) */
|
|
429
|
+
.dk-demo-editor {
|
|
430
|
+
height: 100%;
|
|
431
|
+
background: var(--dk-editor-bg, var(--dk-code-bg));
|
|
432
|
+
}
|
|
433
|
+
.dk-demo-editor-error {
|
|
434
|
+
margin: 0;
|
|
435
|
+
padding: 16px;
|
|
436
|
+
color: var(--dk-error);
|
|
437
|
+
font-family: var(--dk-font-mono);
|
|
438
|
+
font-size: 12px;
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
/* full screen */
|
|
442
|
+
.dk-demo-overlay {
|
|
443
|
+
position: fixed;
|
|
444
|
+
inset: 0;
|
|
445
|
+
z-index: 1000;
|
|
446
|
+
display: flex;
|
|
447
|
+
flex-direction: column;
|
|
448
|
+
padding: 20px;
|
|
449
|
+
background: rgb(0 0 0 / 0.45);
|
|
450
|
+
backdrop-filter: blur(4px);
|
|
451
|
+
}
|
|
452
|
+
.dk-demo-overlay-card {
|
|
453
|
+
display: flex;
|
|
454
|
+
flex: 1;
|
|
455
|
+
flex-direction: column;
|
|
456
|
+
min-height: 0;
|
|
457
|
+
overflow: hidden;
|
|
458
|
+
border: 1px solid var(--dk-border);
|
|
459
|
+
border-radius: var(--dk-radius);
|
|
460
|
+
background: var(--dk-surface);
|
|
461
|
+
color: var(--dk-fg);
|
|
462
|
+
box-shadow: var(--dk-shadow);
|
|
463
|
+
}
|
|
464
|
+
.dk-demo-overlay-title {
|
|
465
|
+
overflow: hidden;
|
|
466
|
+
font-size: 14px;
|
|
467
|
+
font-weight: 500;
|
|
468
|
+
color: var(--dk-heading);
|
|
469
|
+
white-space: nowrap;
|
|
470
|
+
text-overflow: ellipsis;
|
|
471
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/remark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgD,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export type FenceProps = Record<string, string | true>;
|
|
2
|
+
/**
|
|
3
|
+
* Parses a fence meta string like `file="basic.demo.tsx" live height="large"`
|
|
4
|
+
* into `{ file: 'basic.demo.tsx', live: true, height: 'large' }`.
|
|
5
|
+
*/
|
|
6
|
+
export declare function parseFenceMeta(meta: string): FenceProps;
|
|
7
|
+
//# sourceMappingURL=meta.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/remark/meta.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAavD"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Parses a fence meta string like `file="basic.demo.tsx" live height="large"`
|
|
3
|
+
* into `{ file: 'basic.demo.tsx', live: true, height: 'large' }`.
|
|
4
|
+
*/
|
|
5
|
+
export function parseFenceMeta(meta) {
|
|
6
|
+
const props = {};
|
|
7
|
+
for (const token of meta.match(/(?:[^\s"]+|"[^"]*")+/g) ?? []) {
|
|
8
|
+
const eq = token.indexOf('=');
|
|
9
|
+
if (eq === -1) {
|
|
10
|
+
props[token] = true;
|
|
11
|
+
continue;
|
|
12
|
+
}
|
|
13
|
+
let value = token.slice(eq + 1);
|
|
14
|
+
if (value.startsWith('"') && value.endsWith('"'))
|
|
15
|
+
value = value.slice(1, -1);
|
|
16
|
+
props[token.slice(0, eq)] = value;
|
|
17
|
+
}
|
|
18
|
+
return props;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=meta.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/remark/meta.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9D,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { type FenceProps } from './meta.ts';
|
|
2
|
+
export type FenceInfo = {
|
|
3
|
+
lang: string | null;
|
|
4
|
+
meta: string;
|
|
5
|
+
props: FenceProps;
|
|
6
|
+
/** The fence sits inside a `<Demo>` element. */
|
|
7
|
+
inDemo: boolean;
|
|
8
|
+
};
|
|
9
|
+
export type RemarkDemoFencesOptions = {
|
|
10
|
+
/** Absolute path of the content root. */
|
|
11
|
+
contentDir: string;
|
|
12
|
+
/** Content-relative folder of the page being compiled, e.g. `docs/learn/sorting` (slashes are trimmed). */
|
|
13
|
+
folder: string;
|
|
14
|
+
/**
|
|
15
|
+
* Collects the content-relative paths of every source file the page shows
|
|
16
|
+
* (snippets, live demos and their relative imports), for dev reloads.
|
|
17
|
+
*/
|
|
18
|
+
dependencies?: Set<string>;
|
|
19
|
+
/**
|
|
20
|
+
* Which fences this plugin owns. Unclaimed fences are left untouched for
|
|
21
|
+
* other plugins (e.g. a legacy pipeline running after this one). Fences
|
|
22
|
+
* inside `<Demo>` are always claimed. Default: every fence.
|
|
23
|
+
*/
|
|
24
|
+
claim?: (fence: FenceInfo) => boolean;
|
|
25
|
+
/**
|
|
26
|
+
* `ts`/`tsx`/`js`/`jsx` fences must use `file="..."` so every snippet is
|
|
27
|
+
* type-checked; inline code in those languages throws. Default `true`.
|
|
28
|
+
*/
|
|
29
|
+
banInlineCode?: boolean;
|
|
30
|
+
/**
|
|
31
|
+
* How a claimed, non-live, untitled `file=` fence renders:
|
|
32
|
+
* - `shiki-meta` (default): the file's source is inlined into the code node
|
|
33
|
+
* and the highlight/line-number meta is rewritten for `@shikijs/rehype`
|
|
34
|
+
* with `fenceTransformers()` from `/code`;
|
|
35
|
+
* - `card`: a code-only `<Demo>` card (no markdown-level shiki needed).
|
|
36
|
+
*/
|
|
37
|
+
staticFences?: 'shiki-meta' | 'card';
|
|
38
|
+
/** File suffixes of live demo entries. Default `['.demo.tsx']`. */
|
|
39
|
+
demoSuffixes?: string[];
|
|
40
|
+
/** MDX component the live/card fences become. Default `Demo`. */
|
|
41
|
+
componentName?: string;
|
|
42
|
+
/** Literal replacements applied to inlined source (see `applySourceReplacements`). */
|
|
43
|
+
sourceReplacements?: Record<string, string>;
|
|
44
|
+
/** `height` of a live fence that doesn't set one. Default `auto` (the card takes the code's height). */
|
|
45
|
+
liveHeight?: string;
|
|
46
|
+
};
|
|
47
|
+
/**
|
|
48
|
+
* Remark plugin for file-based fences.
|
|
49
|
+
*
|
|
50
|
+
* ```tsx file="basic.demo.tsx" live height="large" title="Basic grid"
|
|
51
|
+
* ```
|
|
52
|
+
*
|
|
53
|
+
* - `file="..."` is relative to the page's folder; `file="/docs/x.tsx"` to the
|
|
54
|
+
* content root. A missing file throws at compile time, so a bad reference
|
|
55
|
+
* fails the build.
|
|
56
|
+
* - `live` replaces the fence with `<Demo name="…">` (prebuilt iframe preview
|
|
57
|
+
* + code tabs). The file must be a demo entry (`*.demo.tsx`) inside the
|
|
58
|
+
* content folder. `live=off` shows the code tab first.
|
|
59
|
+
* - `region="name"` shows a `#region name` … `#endregion` slice (dedented).
|
|
60
|
+
* With `live`, the preview runs the whole demo and only the entry's code tab
|
|
61
|
+
* shows the region; editing and forking use full files.
|
|
62
|
+
* - Highlights live in the source as comments, stripped from the shown code:
|
|
63
|
+
* `// #highlight label` … `// #endhighlight`, or a trailing
|
|
64
|
+
* `code // #highlight label` (`{/* #highlight *\/}` in JSX children).
|
|
65
|
+
* `{1-3}` meta highlights are rejected.
|
|
66
|
+
* - `lines` adds a line-number gutter (original line numbers with `region`).
|
|
67
|
+
* - `files=off` hides the file names and tabs of the files the entry imports.
|
|
68
|
+
* - `title="..."` renders a card with the title as the snippet name.
|
|
69
|
+
* - `height="small|default|large|auto|<px>"`; a live fence defaults to
|
|
70
|
+
* `liveHeight` (`auto`).
|
|
71
|
+
*
|
|
72
|
+
* Fences can also live inside `<Demo>`, next to `<DemoTitle>` /
|
|
73
|
+
* `<DemoDescription>`, which render as the card header; the fence's props are
|
|
74
|
+
* hoisted onto the `<Demo>`. A fence without `live` there makes a code-only card.
|
|
75
|
+
*/
|
|
76
|
+
export declare function remarkDemoFences(options: RemarkDemoFencesOptions): () => (tree: any) => void;
|
|
77
|
+
//# sourceMappingURL=remarkDemoFences.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remarkDemoFences.d.ts","sourceRoot":"","sources":["../../src/remark/remarkDemoFences.ts"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;IACtC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACrC,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,UAqBjD,MAAM,GAAG,UAoKxB"}
|