@jfrader/storybook-docs 0.0.0-stage → 0.4.4

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 (48) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +138 -2
  3. package/dist/app.d.ts +1 -0
  4. package/dist/base.d.ts +3 -0
  5. package/dist/build/catalog.d.ts +20 -0
  6. package/dist/build/code.d.ts +2 -0
  7. package/dist/build/global-styles.d.ts +1 -0
  8. package/dist/build/guidance.d.ts +4 -0
  9. package/dist/build/module-ids.d.ts +2 -0
  10. package/dist/build/props.d.ts +10 -0
  11. package/dist/build/releases.d.ts +7 -0
  12. package/dist/build/site.d.ts +2 -0
  13. package/dist/build/storybook-test.d.ts +2 -0
  14. package/dist/build/tokens.d.ts +2 -0
  15. package/dist/code.d.ts +16 -0
  16. package/dist/component-demo.d.ts +23 -0
  17. package/dist/config.d.ts +98 -0
  18. package/dist/controls.d.ts +49 -0
  19. package/dist/css.d.ts +1 -0
  20. package/dist/guidance-model.d.ts +74 -0
  21. package/dist/guidance.d.ts +9 -0
  22. package/dist/index.css +420 -0
  23. package/dist/index.d.ts +5 -0
  24. package/dist/index.js +1971 -0
  25. package/dist/pages/component-page.d.ts +4 -0
  26. package/dist/pages/foundations-color.d.ts +3 -0
  27. package/dist/pages/foundations-effects.d.ts +3 -0
  28. package/dist/pages/foundations-spacing.d.ts +3 -0
  29. package/dist/pages/foundations-type.d.ts +3 -0
  30. package/dist/pages/overview.d.ts +3 -0
  31. package/dist/pages/releases.d.ts +3 -0
  32. package/dist/prop-docs.d.ts +20 -0
  33. package/dist/props.d.ts +4 -0
  34. package/dist/scan.d.ts +19 -0
  35. package/dist/search-match.d.ts +21 -0
  36. package/dist/search.d.ts +5 -0
  37. package/dist/sections.d.ts +52 -0
  38. package/dist/skeleton.d.ts +11 -0
  39. package/dist/start.d.ts +4 -0
  40. package/dist/story-view.d.ts +20 -0
  41. package/dist/styles.css +685 -0
  42. package/dist/toc.d.ts +19 -0
  43. package/dist/virtual.d.ts +42 -0
  44. package/dist/vite-plugin.d.ts +10 -0
  45. package/dist/vite-plugin.js +697 -0
  46. package/docs/CONFIG.md +287 -0
  47. package/docs/RELEASING.md +153 -0
  48. package/package.json +75 -3
package/dist/index.css ADDED
@@ -0,0 +1,420 @@
1
+ /* src/guidance.css */
2
+ .guidance p,
3
+ .guidance ul,
4
+ .guidance ol {
5
+ margin: 8px 0;
6
+ line-height: 1.6;
7
+ }
8
+ .guidance li + li {
9
+ margin-top: 4px;
10
+ }
11
+ .guidance a {
12
+ color: var(--sd-accent-text);
13
+ }
14
+ .guidance pre.code {
15
+ margin: 12px 0;
16
+ }
17
+ .guidance hr {
18
+ margin: 22px 0;
19
+ border: 0;
20
+ border-top: 1px solid var(--sd-border);
21
+ }
22
+ .guidance-table {
23
+ overflow-x: auto;
24
+ }
25
+ .guidance-callout {
26
+ --callout-tone: var(--sd-accent);
27
+ margin: 12px 0;
28
+ padding: 14px 18px;
29
+ border: 0;
30
+ border-left: 3px solid var(--callout-tone);
31
+ border-radius: 0 var(--sd-radius) var(--sd-radius) 0;
32
+ background: var(--sd-surface);
33
+ }
34
+ .guidance-callout > :first-child {
35
+ margin-top: 0;
36
+ }
37
+ .guidance-callout > :last-child {
38
+ margin-bottom: 0;
39
+ }
40
+ .guidance-callout-do {
41
+ --callout-tone: var(--sd-success);
42
+ background: color-mix(in srgb, var(--sd-success) 8%, var(--sd-surface));
43
+ }
44
+ .guidance-callout-dont {
45
+ --callout-tone: var(--sd-danger-text, var(--sd-danger));
46
+ background: color-mix(in srgb, var(--sd-danger) 8%, var(--sd-surface));
47
+ }
48
+ .guidance-callout-label {
49
+ font-size: 11px;
50
+ font-weight: 700;
51
+ letter-spacing: 0.07em;
52
+ text-transform: uppercase;
53
+ color: var(--callout-tone);
54
+ }
55
+
56
+ /* src/toc.css */
57
+ [data-toc] {
58
+ scroll-margin-top: 76px;
59
+ }
60
+ [data-toc-slot] {
61
+ margin-left: auto;
62
+ }
63
+ .toc-copy {
64
+ display: inline-flex;
65
+ align-items: center;
66
+ min-block-size: 24px;
67
+ font: inherit;
68
+ color: var(--sd-text-muted);
69
+ background: none;
70
+ border: 1px solid transparent;
71
+ border-radius: 6px;
72
+ padding: 2px 8px;
73
+ cursor: pointer;
74
+ }
75
+ .toc-copy:hover,
76
+ .toc-copy:focus-visible {
77
+ color: var(--sd-text);
78
+ border-color: var(--sd-border);
79
+ }
80
+ .toc-sr,
81
+ .toc-clipboard {
82
+ position: fixed;
83
+ width: 1px;
84
+ height: 1px;
85
+ overflow: hidden;
86
+ clip-path: inset(50%);
87
+ opacity: 0;
88
+ }
89
+ .toc-flash {
90
+ animation: toc-flash 2.4s ease-out;
91
+ }
92
+ @keyframes toc-flash {
93
+ 0%, 45% {
94
+ box-shadow: 0 0 0 3px var(--sd-accent, currentColor);
95
+ }
96
+ 100% {
97
+ box-shadow: 0 0 0 3px transparent;
98
+ }
99
+ }
100
+ @media (prefers-reduced-motion: reduce) {
101
+ .toc-flash {
102
+ animation: none;
103
+ outline: 2px solid var(--sd-accent, currentColor);
104
+ }
105
+ }
106
+ .toc {
107
+ display: none;
108
+ }
109
+ @media (min-width: 1180px) {
110
+ .app.has-toc {
111
+ grid-template-columns: 276px minmax(0, 1fr) 224px;
112
+ }
113
+ .toc {
114
+ display: block;
115
+ grid-column: 3;
116
+ grid-row: 2;
117
+ align-self: start;
118
+ transform: translateY(var(--sd-rail-follow, 0px));
119
+ padding: 34px 18px 40px 6px;
120
+ font-size: 12.5px;
121
+ }
122
+ .toc-title {
123
+ margin-bottom: 8px;
124
+ color: var(--sd-text-subtle);
125
+ font-size: 11px;
126
+ letter-spacing: 0.08em;
127
+ text-transform: uppercase;
128
+ }
129
+ .toc ul {
130
+ list-style: none;
131
+ margin: 0;
132
+ padding: 0;
133
+ }
134
+ .toc ul ul {
135
+ margin: 2px 0 6px 10px;
136
+ border-left: 1px solid var(--sd-border);
137
+ }
138
+ .toc-link {
139
+ display: flex;
140
+ align-items: center;
141
+ width: 100%;
142
+ min-block-size: 24px;
143
+ padding: 4px 8px;
144
+ font: inherit;
145
+ text-align: left;
146
+ color: var(--sd-text-muted);
147
+ background: none;
148
+ border: 0;
149
+ border-radius: 6px;
150
+ cursor: pointer;
151
+ }
152
+ .toc-link:hover {
153
+ color: var(--sd-text);
154
+ }
155
+ .toc-link[aria-current=location] {
156
+ color: var(--sd-text);
157
+ font-weight: 600;
158
+ }
159
+ .toc-story {
160
+ font-size: 12px;
161
+ }
162
+ .toc-sub {
163
+ font-size: 12.5px;
164
+ color: var(--sd-text-subtle);
165
+ }
166
+ }
167
+
168
+ /* src/controls.css */
169
+ .sd-controls {
170
+ margin: 0;
171
+ padding: 0 20px 18px;
172
+ min-width: 0;
173
+ background: none;
174
+ color: var(--sd-text-muted);
175
+ font-size: 13px;
176
+ }
177
+ .sd-controls-label {
178
+ margin: 16px 0 10px;
179
+ font-size: 11px;
180
+ font-weight: 600;
181
+ letter-spacing: 0.06em;
182
+ text-transform: uppercase;
183
+ }
184
+ .sd-controls-fields {
185
+ display: flex;
186
+ flex-wrap: wrap;
187
+ align-items: center;
188
+ gap: 16px 24px;
189
+ }
190
+ .sd-control {
191
+ display: flex;
192
+ flex-wrap: wrap;
193
+ align-items: center;
194
+ gap: 8px;
195
+ min-width: 0;
196
+ min-block-size: 32px;
197
+ }
198
+ .sd-control input:not([type=checkbox]),
199
+ .sd-control select,
200
+ .sd-control textarea,
201
+ .sd-controls-reset {
202
+ font: inherit;
203
+ color: var(--sd-text);
204
+ background: var(--sd-surface);
205
+ border: 1px solid var(--sd-text-subtle);
206
+ border-radius: 6px;
207
+ padding: 5px 8px;
208
+ max-width: 100%;
209
+ min-block-size: 32px;
210
+ box-sizing: border-box;
211
+ }
212
+ .sd-control input:not([type=checkbox]) {
213
+ width: 10rem;
214
+ }
215
+ .sd-control textarea {
216
+ width: 16rem;
217
+ min-height: 4rem;
218
+ resize: vertical;
219
+ }
220
+ .sd-control textarea[aria-invalid=true] {
221
+ border-color: var(--sd-danger);
222
+ }
223
+ .sd-control :is(input[type=checkbox], input[type=range]) {
224
+ accent-color: var(--sd-accent);
225
+ }
226
+ .sd-controls-reset {
227
+ margin-left: auto;
228
+ cursor: pointer;
229
+ }
230
+ .sd-controls-reset:disabled {
231
+ opacity: 0.5;
232
+ cursor: default;
233
+ }
234
+ .sd-controls :is(input, select, textarea, button):focus-visible {
235
+ outline: 2px solid var(--sd-focus-ring);
236
+ outline-offset: 2px;
237
+ }
238
+ .sd-controls-note {
239
+ margin: 12px 16px;
240
+ color: var(--sd-text-muted);
241
+ font-size: 13px;
242
+ }
243
+
244
+ /* src/component-demo.css */
245
+ .frame {
246
+ border: 1px solid var(--sd-border-subtle);
247
+ border-radius: var(--sd-radius);
248
+ background: var(--sd-bg);
249
+ margin: 20px 0;
250
+ }
251
+ .frame > .story-blurb {
252
+ margin: 0;
253
+ padding: 12px 20px 0;
254
+ color: var(--sd-text-muted);
255
+ font-size: 0.92em;
256
+ }
257
+ .frame > header {
258
+ display: flex;
259
+ align-items: center;
260
+ gap: 10px;
261
+ padding: 14px 20px;
262
+ background: var(--sd-surface);
263
+ border-radius: var(--sd-radius) var(--sd-radius) 0 0;
264
+ font-size: 13px;
265
+ color: var(--sd-text);
266
+ }
267
+ .frame .shot {
268
+ padding: 36px 24px;
269
+ display: block;
270
+ overflow-x: auto;
271
+ min-inline-size: 0;
272
+ }
273
+ .frame .shot[data-layout=fullscreen] {
274
+ padding: 0;
275
+ }
276
+ .frame .story-lane[data-layout=centered] {
277
+ display: grid;
278
+ place-items: center;
279
+ min-block-size: 96px;
280
+ }
281
+ .frame .story-lane[data-layout=inline] {
282
+ text-align: center;
283
+ }
284
+ .frame > details.code-toggle {
285
+ border-top: 1px solid var(--sd-border-subtle);
286
+ background: var(--sd-surface);
287
+ border-radius: 0 0 var(--sd-radius) var(--sd-radius);
288
+ }
289
+ .frame > details.code-toggle summary {
290
+ cursor: pointer;
291
+ padding: 8px 20px;
292
+ font-size: 12px;
293
+ color: var(--sd-text-muted);
294
+ min-block-size: 24px;
295
+ display: flex;
296
+ align-items: center;
297
+ }
298
+ .sd-demo-code {
299
+ overflow: hidden;
300
+ border-radius: 0 0 var(--sd-radius) var(--sd-radius);
301
+ }
302
+ .frame .sd-demo-code > *,
303
+ .frame .sd-demo-code > * > *,
304
+ .frame .sd-demo-code pre {
305
+ margin: 0;
306
+ border: 0;
307
+ border-radius: 0;
308
+ box-shadow: none;
309
+ background: transparent;
310
+ }
311
+ .sd-demo-code > p {
312
+ padding: 16px 20px;
313
+ font-size: 13px;
314
+ color: var(--sd-text-muted);
315
+ }
316
+ .sd-demo-code-actions {
317
+ display: flex;
318
+ align-items: center;
319
+ gap: 12px;
320
+ }
321
+
322
+ /* src/search.css */
323
+ .search-dropdown {
324
+ position: absolute;
325
+ top: calc(100% + 6px);
326
+ left: 0;
327
+ right: 0;
328
+ margin: 0;
329
+ padding: 0;
330
+ background: var(--sd-surface);
331
+ border: 1px solid var(--sd-border);
332
+ border-radius: var(--sd-radius);
333
+ box-shadow: 0 18px 40px color-mix(in srgb, var(--sd-bg) 70%, transparent);
334
+ z-index: 20;
335
+ display: flex;
336
+ flex-direction: column;
337
+ overflow: hidden;
338
+ }
339
+ .search-dropdown .search-results {
340
+ position: static;
341
+ margin: 0;
342
+ padding: 8px;
343
+ list-style: none;
344
+ background: transparent;
345
+ border: none;
346
+ border-radius: 0;
347
+ box-shadow: none;
348
+ max-height: 320px;
349
+ overflow-y: auto;
350
+ z-index: auto;
351
+ }
352
+ .search-dropdown .search-results li {
353
+ display: flex;
354
+ align-items: center;
355
+ justify-content: space-between;
356
+ gap: 8px;
357
+ padding: 10px 12px;
358
+ border-radius: 8px;
359
+ cursor: pointer;
360
+ }
361
+ .search-results li[aria-selected=true] {
362
+ background: var(--sd-accent-soft);
363
+ }
364
+ .search-result-main {
365
+ display: inline-flex;
366
+ align-items: baseline;
367
+ gap: 4px;
368
+ min-width: 0;
369
+ overflow: hidden;
370
+ text-overflow: ellipsis;
371
+ white-space: nowrap;
372
+ }
373
+ .search-result-name {
374
+ font-size: 13.5px;
375
+ color: var(--sd-text);
376
+ }
377
+ .search-result-sep {
378
+ color: var(--sd-text-subtle);
379
+ font-size: 12px;
380
+ user-select: none;
381
+ }
382
+ .search-result-story {
383
+ font-size: 13px;
384
+ color: var(--sd-text-muted);
385
+ }
386
+ .search-dropdown .search-results li span {
387
+ margin-left: 0;
388
+ }
389
+ .search-dropdown .search-results li span.search-result-meta {
390
+ margin-left: auto;
391
+ font-size: 12px;
392
+ color: var(--sd-text-muted);
393
+ white-space: nowrap;
394
+ flex-shrink: 0;
395
+ }
396
+ .search mark {
397
+ background: var(--sd-accent-soft);
398
+ color: var(--sd-accent-text);
399
+ border-radius: 2px;
400
+ padding: 0 1px;
401
+ font-weight: 700;
402
+ }
403
+ .search-empty {
404
+ padding: 18px 14px;
405
+ font-size: 13px;
406
+ color: var(--sd-text-muted);
407
+ text-align: center;
408
+ }
409
+ .search-footer {
410
+ display: flex;
411
+ align-items: center;
412
+ justify-content: flex-end;
413
+ gap: 8px;
414
+ padding: 10px 16px;
415
+ border-top: 1px solid var(--sd-border-subtle);
416
+ font-size: 11px;
417
+ color: var(--sd-text-muted);
418
+ background: var(--sd-surface-raised);
419
+ user-select: none;
420
+ }
@@ -0,0 +1,5 @@
1
+ /// <reference path="./virtual.d.ts" />
2
+ /// <reference path="./css.d.ts" />
3
+ export { start } from './start.js';
4
+ export { ComponentDemo, type ComponentDemoProps } from './component-demo.js';
5
+ export type { StorybookDocsConfig, CatalogEntry, ThemeRole } from './config.js';