@atom63/mdx 0.4.0-beta.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 (88) hide show
  1. package/API.md +47 -0
  2. package/CONTRIBUTING.md +58 -0
  3. package/LICENSE +21 -0
  4. package/README.md +190 -0
  5. package/dist/article/index.d.ts +32 -0
  6. package/dist/article/index.js +38 -0
  7. package/dist/article/index.js.map +1 -0
  8. package/dist/blocks/credits-block-entry.d.ts +14 -0
  9. package/dist/blocks/credits-block-entry.js +4 -0
  10. package/dist/blocks/credits-block-entry.js.map +1 -0
  11. package/dist/blocks/index.d.ts +175 -0
  12. package/dist/blocks/index.js +9 -0
  13. package/dist/blocks/index.js.map +1 -0
  14. package/dist/blocks/media-caption-entry.d.ts +11 -0
  15. package/dist/blocks/media-caption-entry.js +4 -0
  16. package/dist/blocks/media-caption-entry.js.map +1 -0
  17. package/dist/chunk-2RCEDZBB.js +11 -0
  18. package/dist/chunk-2RCEDZBB.js.map +1 -0
  19. package/dist/chunk-34B2U2Y2.js +59 -0
  20. package/dist/chunk-34B2U2Y2.js.map +1 -0
  21. package/dist/chunk-A3NG5VKX.js +169 -0
  22. package/dist/chunk-A3NG5VKX.js.map +1 -0
  23. package/dist/chunk-CSXZ2XEN.js +479 -0
  24. package/dist/chunk-CSXZ2XEN.js.map +1 -0
  25. package/dist/chunk-DJSENA7Q.js +63 -0
  26. package/dist/chunk-DJSENA7Q.js.map +1 -0
  27. package/dist/chunk-EIY6ZR6T.js +2471 -0
  28. package/dist/chunk-EIY6ZR6T.js.map +1 -0
  29. package/dist/chunk-EPSRYU5X.js +61 -0
  30. package/dist/chunk-EPSRYU5X.js.map +1 -0
  31. package/dist/chunk-FVCE4FER.js +132 -0
  32. package/dist/chunk-FVCE4FER.js.map +1 -0
  33. package/dist/chunk-IART7J2U.js +101 -0
  34. package/dist/chunk-IART7J2U.js.map +1 -0
  35. package/dist/chunk-OUEW54AC.js +144 -0
  36. package/dist/chunk-OUEW54AC.js.map +1 -0
  37. package/dist/chunk-WZ6US342.js +231 -0
  38. package/dist/chunk-WZ6US342.js.map +1 -0
  39. package/dist/constants-CuaBcwMe.d.ts +4 -0
  40. package/dist/editor/index.d.ts +47 -0
  41. package/dist/editor/index.js +118 -0
  42. package/dist/editor/index.js.map +1 -0
  43. package/dist/framed-block-DM5LLxO7.d.ts +87 -0
  44. package/dist/index.d.ts +45 -0
  45. package/dist/index.js +20 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/lightbox/index.d.ts +44 -0
  48. package/dist/lightbox/index.js +5 -0
  49. package/dist/lightbox/index.js.map +1 -0
  50. package/dist/mdx-provider-6gOypsy5.d.ts +185 -0
  51. package/dist/photo-swipe-CwzAHpP-.d.ts +66 -0
  52. package/dist/primitives/index.d.ts +130 -0
  53. package/dist/primitives/index.js +132 -0
  54. package/dist/primitives/index.js.map +1 -0
  55. package/dist/runtime/index.d.ts +39 -0
  56. package/dist/runtime/index.js +4 -0
  57. package/dist/runtime/index.js.map +1 -0
  58. package/dist/slots-BvPdUMdY.d.ts +23 -0
  59. package/dist/video-block-C0a5Yx9x.d.ts +468 -0
  60. package/package.json +139 -0
  61. package/src/blocks/callout/callout.css +37 -0
  62. package/src/blocks/code-block/code-block.css +40 -0
  63. package/src/blocks/color-swatch-item/color-swatch-item.css +36 -0
  64. package/src/blocks/compare/compare.css +14 -0
  65. package/src/blocks/comparison-pair/comparison-pair.css +27 -0
  66. package/src/blocks/credits-block/credits-block.css +16 -0
  67. package/src/blocks/demo-stage/demo-stage.css +50 -0
  68. package/src/blocks/doc-example/doc-example.css +44 -0
  69. package/src/blocks/image-compare/image-compare.css +45 -0
  70. package/src/blocks/layer-stack/layer-stack.css +28 -0
  71. package/src/blocks/media-placeholder/media-placeholder.css +11 -0
  72. package/src/blocks/mermaid-diagram/mermaid-diagram.css +52 -0
  73. package/src/blocks/page-meta/page-meta.css +7 -0
  74. package/src/blocks/page-table-of-contents/page-table-of-contents.css +73 -0
  75. package/src/blocks/resource-list/resource-list.css +138 -0
  76. package/src/blocks/scroll-stage/scroll-stage.css +12 -0
  77. package/src/blocks/stat-card/stat-card.css +18 -0
  78. package/src/blocks/steps/steps.css +20 -0
  79. package/src/blocks/timeline/timeline.css +12 -0
  80. package/src/blocks/video-block/video-block.css +11 -0
  81. package/src/primitives/motion-tokens.css +16 -0
  82. package/src/styles/a63.css +13 -0
  83. package/src/styles/base.css +362 -0
  84. package/src/styles/block-recipes.css +21 -0
  85. package/src/styles/consumer.css +7 -0
  86. package/src/styles/index.css +12 -0
  87. package/src/styles/mdx-blocks.css +9 -0
  88. package/src/styles/shadcn.css +12 -0
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Atom63 MDX adapter entry.
3
+ *
4
+ * Use in Atom63 apps after loading:
5
+ * @import "@atom63/styles";
6
+ * @import "@atom63/styles/tailwind";
7
+ * @import "@atom63/styles/compat/shadcn";
8
+ *
9
+ * This maps MDX motion aliases onto the shared Atom63 motion ramp, then loads
10
+ * the full MDX stylesheet.
11
+ */
12
+ @import '@atom63/styles/compat/mdx';
13
+ @import './index.css';
@@ -0,0 +1,362 @@
1
+ /* ---------------------------------------------------------------------------
2
+ * Shared MDX recipes.
3
+ *
4
+ * These are Tailwind-independent colors, surfaces, borders, shadows, and radii
5
+ * for prose elements, raw JSX media, and the private MDX frame foundation.
6
+ * Component layout/geometry still lives in TSX className strings.
7
+ *
8
+ * Class hooks relied upon by components/consumers/tests:
9
+ * .mdx .mdx-block .not-mdx .callout .mdx-table-wrapper
10
+ * ------------------------------------------------------------------------- */
11
+ @layer components {
12
+ /* Raw JSX (<figure><video/></figure>) bypasses the component map, so it is
13
+ styled here via descendant selectors on the .mdx root. Mirrors the
14
+ mdxStyles.content.* rules so markdown syntax and raw JSX stay consistent. */
15
+ .mdx {
16
+ --mdx-measure: 42rem;
17
+ --mdx-measure-wide: 72rem;
18
+ color: var(--a63-text-primary);
19
+ }
20
+
21
+ /* --- MDX frame chrome --------------------------------------------------- */
22
+ .mdx-frame-header {
23
+ padding: var(--a63-space-2) var(--a63-space-3);
24
+ }
25
+
26
+ .mdx-frame-footer {
27
+ border-top: 1px solid color-mix(in oklab, var(--a63-border-subtle) 8%, transparent);
28
+ }
29
+
30
+ .mdx-frame-item {
31
+ border-color: color-mix(in oklab, var(--a63-border-subtle) 10%, transparent);
32
+ background-color: color-mix(in oklab, var(--a63-surface-page) 76%, transparent);
33
+ color: var(--a63-text-secondary);
34
+ }
35
+
36
+ .mdx-frame-item-negative {
37
+ border-color: color-mix(in oklab, var(--a63-action-danger) 12%, var(--a63-border-subtle));
38
+ background-color: color-mix(in oklab, var(--a63-action-danger) 3%, var(--a63-surface-page));
39
+ color: var(--a63-action-danger);
40
+ }
41
+
42
+ .mdx-frame-item-positive {
43
+ border-color: color-mix(in oklab, var(--a63-status-success) 12%, var(--a63-border-subtle));
44
+ background-color: color-mix(in oklab, var(--a63-status-success) 3%, var(--a63-surface-page));
45
+ color: var(--a63-status-success);
46
+ }
47
+
48
+ .mdx-frame-item-warning {
49
+ border-color: color-mix(in oklab, var(--a63-status-warning) 12%, var(--a63-border-subtle));
50
+ background-color: color-mix(in oklab, var(--a63-status-warning) 3%, var(--a63-surface-page));
51
+ color: var(--a63-status-warning);
52
+ }
53
+
54
+ .mdx-frame-item-neutral .mdx-frame-item-marker {
55
+ background-color: color-mix(in oklab, var(--a63-text-secondary) 60%, transparent);
56
+ }
57
+
58
+ .mdx-frame-item-negative .mdx-frame-item-marker {
59
+ background-color: color-mix(in oklab, var(--a63-action-danger) 70%, transparent);
60
+ }
61
+
62
+ .mdx-frame-item-positive .mdx-frame-item-marker {
63
+ background-color: color-mix(in oklab, var(--a63-status-success) 70%, transparent);
64
+ }
65
+
66
+ .mdx-frame-item-warning .mdx-frame-item-marker {
67
+ background-color: color-mix(in oklab, var(--a63-status-warning) 70%, transparent);
68
+ }
69
+
70
+ .mdx-frame-item-eyebrow {
71
+ color: color-mix(in oklab, currentColor 70%, transparent);
72
+ }
73
+
74
+ .mdx-frame-item-title {
75
+ color: var(--a63-text-primary);
76
+ }
77
+
78
+ .mdx-frame-item-body {
79
+ color: var(--a63-text-secondary);
80
+ }
81
+
82
+ .mdx-frame-item-body .code-block-embedded {
83
+ margin: var(--a63-space-3) calc(var(--a63-space-3_5, var(--a63-space-3)) * -1) 0;
84
+ border-top: 1px solid color-mix(in oklab, var(--a63-border-subtle) 8%, transparent);
85
+ background-color: color-mix(in oklab, var(--a63-surface-page) 70%, transparent);
86
+ }
87
+
88
+ .mdx-frame-item-body .code-block-embedded .code-block-body .a63-ScrollArea-viewport {
89
+ padding: var(--a63-space-3) 3.75rem var(--a63-space-3) var(--a63-space-3_5, var(--a63-space-3));
90
+ }
91
+
92
+ .mdx-frame-item-body .code-block-embedded:last-child {
93
+ margin-bottom: calc(var(--a63-space-3) * -1);
94
+ }
95
+
96
+ @media (min-width: 40rem) {
97
+ .mdx-frame-item-body .code-block-embedded {
98
+ margin-inline: calc(var(--a63-space-4) * -1);
99
+ }
100
+
101
+ .mdx-frame-item-body .code-block-embedded .code-block-body .a63-ScrollArea-viewport {
102
+ padding-left: var(--a63-space-4); /* craft-allow: physical-properties — code is always LTR */
103
+ }
104
+ }
105
+
106
+ .mdx-frame-item-body .code-block-embedded .code-block-copy {
107
+ top: calc(var(--a63-space-2) + 0.125rem);
108
+ right: var(--a63-space-2);
109
+ opacity: 0.7;
110
+ background-color: color-mix(in oklab, var(--a63-surface-panel) 88%, transparent);
111
+ box-shadow: inset 0 0 0 1px color-mix(in oklab, var(--a63-border-subtle) 12%, transparent);
112
+ }
113
+
114
+ @media (hover: hover) {
115
+ .mdx-frame-item-body .code-block-embedded .code-block-copy:hover {
116
+ opacity: 1;
117
+ }
118
+ }
119
+
120
+ .mdx-frame-item-body p code {
121
+ border-radius: var(--radius-sm);
122
+ background-color: color-mix(in oklab, var(--a63-surface-page) 75%, transparent);
123
+ }
124
+
125
+ .mdx-frame-item-body pre:not(.code-block-pre):not(.shiki) {
126
+ border-radius: var(--radius-md);
127
+ border: 1px solid var(--a63-border-subtle);
128
+ background-color: color-mix(in oklab, var(--a63-surface-page) 90%, transparent);
129
+ }
130
+
131
+ /* --- MDX insight notice ------------------------------------------------ */
132
+ .mdx-insight-frame {
133
+ background: linear-gradient(
134
+ 180deg,
135
+ color-mix(in oklab, var(--a63-action-primary) 7%, transparent),
136
+ color-mix(in oklab, var(--a63-surface-muted) 30%, transparent)
137
+ );
138
+ }
139
+
140
+ .mdx-insight-eyebrow {
141
+ color: var(--a63-action-primary);
142
+ }
143
+
144
+ .mdx-insight-title {
145
+ color: var(--a63-text-primary);
146
+ }
147
+
148
+ .mdx-insight-panel {
149
+ background-color: color-mix(in oklab, var(--a63-surface-page) 72%, transparent);
150
+ }
151
+
152
+ .mdx-insight-body {
153
+ color: var(--a63-text-secondary);
154
+ }
155
+
156
+ .mdx-insight-body strong {
157
+ color: var(--a63-text-primary);
158
+ }
159
+
160
+ .mdx figure > video {
161
+ margin-top: 0;
162
+ width: 100%;
163
+ border-radius: var(--radius-xl);
164
+ border: 1px solid var(--a63-border-subtle);
165
+ }
166
+
167
+ .mdx figure > img {
168
+ margin-top: 0;
169
+ width: 100%;
170
+ border-radius: var(--radius-xl);
171
+ }
172
+
173
+ .mdx figure > iframe {
174
+ width: 100%;
175
+ border-radius: var(--radius-xl);
176
+ border: 1px solid var(--a63-border-subtle);
177
+ }
178
+
179
+ .mdx figure > figcaption {
180
+ margin-top: 0.75rem;
181
+ text-align: center;
182
+ color: var(--a63-text-secondary);
183
+ }
184
+
185
+ /* --- Body typography color (component-mapped elements) ------------------- */
186
+ .mdx :where(p, li):not(.not-mdx *) {
187
+ color: var(--a63-text-secondary);
188
+ }
189
+
190
+ .mdx :where(strong):not(.not-mdx *) {
191
+ color: var(--a63-text-primary);
192
+ }
193
+
194
+ .mdx-h6 {
195
+ color: var(--a63-text-secondary);
196
+ }
197
+
198
+ .mdx-text-secondary {
199
+ color: var(--a63-text-secondary);
200
+ }
201
+
202
+ .mdx :where(del):not(.not-mdx *) {
203
+ color: var(--a63-text-secondary);
204
+ }
205
+
206
+ /* --- inline code -------------------------------------------------------- */
207
+ .mdx-inline-code {
208
+ border-radius: var(--radius-sm);
209
+ background-color: color-mix(in oklab, var(--a63-surface-muted) 50%, transparent);
210
+ color: var(--a63-text-primary);
211
+ box-shadow: inset 0 0 0 0.5px var(--a63-surface-control-hover);
212
+ /* The chip is an inline box, so a code span that wraps is split across
213
+ lines. Without `clone` the radius, padding and inset hairline are drawn
214
+ once around the whole fragment set, leaving the first line sheared off
215
+ flat on the right and the second missing its left edge. `clone` redraws
216
+ the full box on each line instead. */
217
+ -webkit-box-decoration-break: clone;
218
+ box-decoration-break: clone;
219
+ }
220
+
221
+ /* --- code blocks (pre) -------------------------------------------------- */
222
+ .mdx-pre {
223
+ border-radius: var(--radius-lg);
224
+ border: 1px solid var(--a63-border-subtle);
225
+ background-color: var(--a63-surface-panel);
226
+ }
227
+
228
+ /* --- blockquote --------------------------------------------------------- */
229
+ .mdx-blockquote {
230
+ border-inline-start: 4px solid var(--a63-border-subtle);
231
+ background-color: color-mix(in oklab, var(--a63-surface-muted) 50%, transparent);
232
+ color: var(--a63-text-secondary);
233
+ }
234
+
235
+ /* --- hr ----------------------------------------------------------------- */
236
+ .mdx-hr {
237
+ border-top: 1px solid var(--a63-border-subtle);
238
+ }
239
+
240
+ /* --- kbd ---------------------------------------------------------------- */
241
+ .mdx-kbd {
242
+ border-radius: var(--radius-lg);
243
+ border: 1px solid var(--a63-border-subtle);
244
+ background-color: var(--a63-surface-muted);
245
+ color: var(--a63-text-secondary);
246
+ }
247
+
248
+ /* --- tables ------------------------------------------------------------- */
249
+ .mdx-table-wrapper {
250
+ border-radius: var(--radius-lg);
251
+ border: 1px solid var(--a63-border-subtle);
252
+ background-color: var(--a63-surface-page);
253
+ }
254
+
255
+ /* Scrolling shadows on the DS Table's own scroll container (the wrapper above
256
+ only clips to its radius). A table wider than the column scrolls, but macOS
257
+ overlay scrollbars are invisible at rest, so the last column just looks cut
258
+ off. The two `local` layers ride the content and cover the two `scroll`
259
+ layers whenever that edge is flush — so the cue appears only on the side
260
+ that actually has more table, and nothing shows when the table fits. */
261
+ .mdx-table-wrapper [data-slot='table-container'] {
262
+ background-image:
263
+ linear-gradient(to right, var(--a63-surface-page), transparent 2rem),
264
+ linear-gradient(to left, var(--a63-surface-page), transparent 2rem),
265
+ linear-gradient(
266
+ to right,
267
+ color-mix(in oklab, var(--a63-text-primary) 22%, transparent),
268
+ transparent 1rem
269
+ ),
270
+ linear-gradient(
271
+ to left,
272
+ color-mix(in oklab, var(--a63-text-primary) 22%, transparent),
273
+ transparent 1rem
274
+ );
275
+ background-repeat: no-repeat;
276
+ background-size:
277
+ 2.5rem 100%,
278
+ 2.5rem 100%,
279
+ 1rem 100%,
280
+ 1rem 100%;
281
+ background-position:
282
+ left center,
283
+ right center,
284
+ left center,
285
+ right center;
286
+ background-attachment: local, local, scroll, scroll;
287
+ }
288
+
289
+ .mdx-thead {
290
+ background-color: var(--a63-surface-muted);
291
+ }
292
+
293
+ .mdx-tr {
294
+ border-bottom: 1px solid var(--a63-border-subtle);
295
+ }
296
+
297
+ .mdx-tr:hover {
298
+ background-color: color-mix(in oklab, var(--a63-surface-muted) 40%, transparent);
299
+ }
300
+
301
+ .mdx-th {
302
+ color: var(--a63-text-primary);
303
+ }
304
+
305
+ .mdx-td {
306
+ color: var(--a63-text-secondary);
307
+ }
308
+
309
+ .mdx-caption {
310
+ color: var(--a63-text-secondary);
311
+ }
312
+
313
+ /* --- media caption (component-mapped) ----------------------------------- */
314
+ .mdx-figcaption {
315
+ color: var(--a63-text-secondary);
316
+ }
317
+
318
+ .mdx-media-framed {
319
+ border: 1px solid var(--a63-border-subtle);
320
+ }
321
+
322
+ /* --- details / summary -------------------------------------------------- */
323
+ .mdx-details {
324
+ border-radius: var(--radius-lg);
325
+ border: 1px solid var(--a63-border-subtle);
326
+ background-color: var(--a63-surface-panel);
327
+ }
328
+
329
+ .mdx-summary {
330
+ color: var(--a63-text-primary);
331
+ }
332
+
333
+ /* --- misc semantics ----------------------------------------------------- */
334
+ .mdx-mark {
335
+ color: var(--a63-text-primary);
336
+ background-color: color-mix(in oklch, var(--a63-status-warning) 24%, transparent);
337
+ }
338
+
339
+ .mdx-ins {
340
+ text-decoration-color: color-mix(in oklch, var(--a63-status-success) 70%, transparent);
341
+ }
342
+
343
+ .mdx-abbr {
344
+ border-bottom: 1px dotted var(--a63-text-secondary);
345
+ }
346
+
347
+ .mdx-cite,
348
+ .mdx-time {
349
+ color: var(--a63-text-secondary);
350
+ }
351
+
352
+ .mdx-samp {
353
+ border-radius: var(--radius-lg);
354
+ background-color: var(--a63-surface-muted);
355
+ }
356
+
357
+ .mdx-output {
358
+ border-radius: var(--radius-lg);
359
+ border: 1px solid var(--a63-border-subtle);
360
+ background-color: var(--a63-surface-muted);
361
+ }
362
+ }
@@ -0,0 +1,21 @@
1
+ /* Colocated MDX block recipes. Keep this import-only file ordered by block name. */
2
+ @import '../blocks/callout/callout.css';
3
+ @import '../blocks/code-block/code-block.css';
4
+ @import '../blocks/color-swatch-item/color-swatch-item.css';
5
+ @import '../blocks/compare/compare.css';
6
+ @import '../blocks/comparison-pair/comparison-pair.css';
7
+ @import '../blocks/credits-block/credits-block.css';
8
+ @import '../blocks/demo-stage/demo-stage.css';
9
+ @import '../blocks/doc-example/doc-example.css';
10
+ @import '../blocks/image-compare/image-compare.css';
11
+ @import '../blocks/layer-stack/layer-stack.css';
12
+ @import '../blocks/media-placeholder/media-placeholder.css';
13
+ @import '../blocks/mermaid-diagram/mermaid-diagram.css';
14
+ @import '../blocks/page-meta/page-meta.css';
15
+ @import '../blocks/page-table-of-contents/page-table-of-contents.css';
16
+ @import '../blocks/resource-list/resource-list.css';
17
+ @import '../blocks/scroll-stage/scroll-stage.css';
18
+ @import '../blocks/stat-card/stat-card.css';
19
+ @import '../blocks/steps/steps.css';
20
+ @import '../blocks/timeline/timeline.css';
21
+ @import '../blocks/video-block/video-block.css';
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Compatibility alias for the full MDX stylesheet entry.
3
+ *
4
+ * Prefer @atom63/mdx/styles/index.css for new raw-style consumers, or use
5
+ * a63.css / shadcn.css when the host needs a token adapter.
6
+ */
7
+ @import './index.css';
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Full MDX stylesheet entry.
3
+ *
4
+ * Use when the host already provides canonical --a63-* variables and wants the
5
+ * shared MDX recipes plus the package Tailwind v4 source scan.
6
+ */
7
+ @import './mdx-blocks.css';
8
+
9
+ /* The stylesheets ship from src/, the components from dist/. Scan the TS
10
+ source in the workspace and the emitted JS in the published tarball. */
11
+ @source '../**/*.{ts,tsx}';
12
+ @source '../../dist/**/*.js';
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Public no-scan stylesheet entry.
3
+ *
4
+ * Use when a host already scans @atom63/mdx with Tailwind and only needs the
5
+ * Tailwind-independent MDX recipes. Most apps should import a63.css,
6
+ * shadcn.css, or index.css instead.
7
+ */
8
+ @import './block-recipes.css';
9
+ @import './base.css';
@@ -0,0 +1,12 @@
1
+ /**
2
+ * shadcn-token MDX adapter entry.
3
+ *
4
+ * Use in external shadcn apps that do not load @atom63/styles, but already
5
+ * define shadcn variables such as --background, --foreground, --card, --border,
6
+ * --primary, and --ring.
7
+ *
8
+ * This derives canonical --a63-* variables from shadcn tokens, then loads the
9
+ * full MDX stylesheet.
10
+ */
11
+ @import '@atom63/styles/compat/a63-from-shadcn';
12
+ @import './index.css';