@veluai/velu 0.1.13 → 0.1.15

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 (98) hide show
  1. package/README.md +80 -80
  2. package/dist/cli.js +21 -21
  3. package/package.json +3 -2
  4. package/runtime/velu-ui/components/Accordion.jsx +64 -64
  5. package/runtime/velu-ui/components/ApiClient.jsx +121 -121
  6. package/runtime/velu-ui/components/ApiField.jsx +87 -87
  7. package/runtime/velu-ui/components/ApiPath.jsx +63 -63
  8. package/runtime/velu-ui/components/ApiSidebar.jsx +122 -122
  9. package/runtime/velu-ui/components/AskBar.jsx +71 -71
  10. package/runtime/velu-ui/components/Callout.jsx +114 -114
  11. package/runtime/velu-ui/components/Card.jsx +131 -131
  12. package/runtime/velu-ui/components/Chatbot.jsx +596 -596
  13. package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
  14. package/runtime/velu-ui/components/Columns.jsx +56 -56
  15. package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
  16. package/runtime/velu-ui/components/Field.jsx +81 -81
  17. package/runtime/velu-ui/components/Image.jsx +163 -163
  18. package/runtime/velu-ui/components/Logo.jsx +31 -0
  19. package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
  20. package/runtime/velu-ui/components/NavSelect.jsx +108 -108
  21. package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
  22. package/runtime/velu-ui/components/PageFooter.jsx +145 -213
  23. package/runtime/velu-ui/components/PageHeader.jsx +422 -414
  24. package/runtime/velu-ui/components/PageNav.jsx +77 -77
  25. package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
  26. package/runtime/velu-ui/components/Prompt.jsx +115 -115
  27. package/runtime/velu-ui/components/Search.jsx +411 -366
  28. package/runtime/velu-ui/components/Sidebar.jsx +191 -191
  29. package/runtime/velu-ui/components/SocialLinks.jsx +90 -0
  30. package/runtime/velu-ui/components/Steps.jsx +65 -65
  31. package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
  32. package/runtime/velu-ui/components/Toc.jsx +537 -537
  33. package/runtime/velu-ui/components/TocBar.jsx +195 -195
  34. package/runtime/velu-ui/components/Tree.jsx +87 -87
  35. package/runtime/velu-ui/components/TryItBar.jsx +90 -90
  36. package/runtime/velu-ui/components/accordion.css +92 -92
  37. package/runtime/velu-ui/components/api.css +479 -479
  38. package/runtime/velu-ui/components/ask-bar.css +94 -94
  39. package/runtime/velu-ui/components/card.css +105 -105
  40. package/runtime/velu-ui/components/chatbot.css +617 -617
  41. package/runtime/velu-ui/components/code-block.css +263 -263
  42. package/runtime/velu-ui/components/docs-layout.css +784 -775
  43. package/runtime/velu-ui/components/field.css +82 -82
  44. package/runtime/velu-ui/components/image.css +237 -237
  45. package/runtime/velu-ui/components/nav-select.css +157 -157
  46. package/runtime/velu-ui/components/page-feedback.css +241 -241
  47. package/runtime/velu-ui/components/page-footer.css +130 -130
  48. package/runtime/velu-ui/components/page-header.css +557 -520
  49. package/runtime/velu-ui/components/page-nav.css +50 -50
  50. package/runtime/velu-ui/components/powered-by.css +86 -66
  51. package/runtime/velu-ui/components/prompt.css +99 -99
  52. package/runtime/velu-ui/components/search.css +307 -307
  53. package/runtime/velu-ui/components/sidebar.css +144 -144
  54. package/runtime/velu-ui/components/steps.css +77 -77
  55. package/runtime/velu-ui/components/theme-toggle.css +101 -101
  56. package/runtime/velu-ui/components/toc-bar.css +234 -234
  57. package/runtime/velu-ui/components/tree.css +49 -49
  58. package/runtime/velu-ui/index.js +48 -46
  59. package/runtime/velu-ui/lib/component-schemas.js +100 -100
  60. package/runtime/velu-ui/lib/copyText.js +64 -64
  61. package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
  62. package/runtime/velu-ui/lib/prism-langs.js +957 -957
  63. package/runtime/velu-ui/lib/prism-loader.js +74 -74
  64. package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
  65. package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
  66. package/runtime/velu-ui/mdx-components.jsx +105 -105
  67. package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
  68. package/runtime/velu-ui/primitives/Stack.jsx +63 -63
  69. package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
  70. package/runtime/velu-ui/primitives/stack.css +3 -3
  71. package/runtime/velu-ui/primitives/switcher.css +25 -25
  72. package/runtime/velu-ui/styles.css +43 -43
  73. package/runtime/velu-ui/tokens.css +4 -4
  74. package/schema/velu.schema.json +281 -167
  75. package/src/lib/extract-mdx-error.js +170 -170
  76. package/src/lib/issues.js +159 -159
  77. package/src/lib/known-components.js +34 -34
  78. package/src/navigation.js +434 -434
  79. package/src/runtime/App.jsx +1506 -1476
  80. package/src/runtime/ErrorBoundary.jsx +54 -54
  81. package/src/runtime/client-entry.jsx +22 -22
  82. package/src/runtime/server-entry.jsx +16 -16
  83. package/src/template.html +48 -48
  84. package/templates/starter/ai-tools/claude-code.mdx +26 -26
  85. package/templates/starter/ai-tools/cursor.mdx +17 -17
  86. package/templates/starter/api-reference/endpoint/create.mdx +24 -24
  87. package/templates/starter/api-reference/endpoint/get.mdx +27 -27
  88. package/templates/starter/api-reference/introduction.mdx +28 -28
  89. package/templates/starter/development.mdx +19 -19
  90. package/templates/starter/essentials/code.mdx +29 -29
  91. package/templates/starter/essentials/images.mdx +29 -29
  92. package/templates/starter/essentials/markdown.mdx +25 -25
  93. package/templates/starter/essentials/navigation.mdx +39 -39
  94. package/templates/starter/essentials/settings.mdx +30 -30
  95. package/templates/starter/favicon.svg +6 -6
  96. package/templates/starter/index.mdx +31 -31
  97. package/templates/starter/quickstart.mdx +31 -31
  98. package/templates/starter/velu.json +33 -33
@@ -1,241 +1,241 @@
1
- /* PageFeedback — "Was this page helpful?" row. All values are tokens;
2
- light/dark via [data-theme]. Row layout (flex/gap/wrap) is the
3
- <Cluster> primitive; this file owns only typography + the buttons. */
4
-
5
- .velu-feedback__question {
6
- font-size: var(--f-h6);
7
- color: var(--text-color);
8
- }
9
-
10
- .velu-feedback__btn {
11
- position: relative; /* anchor for the heart burst */
12
- display: inline-flex;
13
- align-items: center;
14
- gap: var(--s-3);
15
- padding-block: var(--s-3);
16
- padding-inline: var(--s-1);
17
- background: transparent;
18
- border: var(--border-width) solid var(--border-color);
19
- border-radius: var(--radius-md);
20
- color: var(--text-color);
21
- font: inherit;
22
- font-size: var(--f-h6);
23
- font-weight: var(--weight-medium);
24
- line-height: var(--lh-h6);
25
- cursor: pointer;
26
- transition:
27
- border-color 0.12s ease,
28
- background 0.12s ease,
29
- color 0.12s ease;
30
- }
31
- .velu-feedback__btn svg {
32
- flex: none;
33
- /* Resting icon matches the label (full-contrast text color), not the
34
- muted grey — accent is reserved for hover / chosen. */
35
- color: var(--text-color);
36
- }
37
- .velu-feedback__btn:hover {
38
- border-color: var(--accent-color);
39
- }
40
- .velu-feedback__btn:hover svg {
41
- color: var(--accent-color);
42
- }
43
-
44
- /* The currently-picked button — accent border + tint, accent icon.
45
- The vote stays changeable: clicking the other button moves it here. */
46
- .velu-feedback__btn--chosen {
47
- border-color: var(--accent-color);
48
- background: color-mix(in srgb, var(--accent-color) 10%, transparent);
49
- color: var(--accent-color);
50
- }
51
- .velu-feedback__btn--chosen svg {
52
- color: var(--accent-color);
53
- }
54
-
55
- .velu-feedback__thanks {
56
- font-size: var(--f-h6);
57
- color: var(--muted-color);
58
- }
59
-
60
- /* ── "No" improvement form ──────────────────────────────────────────── */
61
- /* Vertical rhythm is the <Stack> primitive; this owns only the chrome. */
62
- .velu-feedback__form {
63
- padding-block-start: var(--s0);
64
- border-block-start: var(--border-width) solid var(--border-color);
65
- }
66
- .velu-feedback__form-title {
67
- margin: 0;
68
- font-size: var(--f-h4);
69
- line-height: var(--lh-h4);
70
- font-weight: var(--weight-medium);
71
- color: var(--text-color);
72
- }
73
-
74
- /* Reason radio rows — native <input> visually hidden, circle drawn by
75
- the adjacent mark span (so :checked can style it). */
76
- .velu-feedback__radio {
77
- position: relative;
78
- display: flex;
79
- align-items: center;
80
- gap: var(--s-1);
81
- cursor: pointer;
82
- }
83
- .velu-feedback__radio input {
84
- position: absolute;
85
- inset-block-start: 0;
86
- inset-inline-start: 0;
87
- inline-size: var(--icon-size-lg);
88
- block-size: var(--icon-size-lg);
89
- margin: 0;
90
- opacity: 0;
91
- cursor: pointer;
92
- }
93
- .velu-feedback__radio-mark {
94
- position: relative;
95
- flex: none;
96
- inline-size: var(--icon-size-lg);
97
- block-size: var(--icon-size-lg);
98
- border: var(--border-width) solid var(--border-color);
99
- border-radius: 50%;
100
- transition: border-color 0.12s ease;
101
- }
102
- .velu-feedback__radio input:checked + .velu-feedback__radio-mark {
103
- border-color: var(--accent-color);
104
- }
105
- .velu-feedback__radio input:checked + .velu-feedback__radio-mark::after {
106
- content: '';
107
- position: absolute;
108
- inset: 22%;
109
- background: var(--accent-color);
110
- border-radius: 50%;
111
- }
112
- .velu-feedback__radio input:focus-visible + .velu-feedback__radio-mark {
113
- outline: var(--border-width) solid var(--accent-color);
114
- outline-offset: 2px;
115
- }
116
- .velu-feedback__radio:hover .velu-feedback__radio-mark {
117
- border-color: var(--accent-color);
118
- }
119
- .velu-feedback__radio-label {
120
- font-size: var(--f-body);
121
- color: var(--text-color);
122
- }
123
-
124
- /* Optional free-text detail */
125
- .velu-feedback__detail {
126
- inline-size: 100%;
127
- box-sizing: border-box;
128
- padding: var(--s-1);
129
- background: var(--page-bg);
130
- border: var(--border-width) solid var(--border-color);
131
- border-radius: var(--radius-md);
132
- resize: vertical;
133
- font: inherit;
134
- font-size: var(--f-h6);
135
- line-height: var(--lh-body);
136
- color: var(--text-color);
137
- }
138
- .velu-feedback__detail::placeholder {
139
- color: var(--muted-color);
140
- }
141
- .velu-feedback__detail:focus-visible {
142
- outline: none;
143
- border-color: var(--accent-color);
144
- }
145
-
146
- /* Cancel / Submit actions */
147
- .velu-feedback__action {
148
- padding-block: var(--s-2);
149
- padding-inline: var(--s0);
150
- border-radius: var(--radius-md);
151
- font: inherit;
152
- font-size: var(--f-h6);
153
- font-weight: var(--weight-medium);
154
- cursor: pointer;
155
- transition: border-color 0.12s ease, background 0.12s ease;
156
- }
157
- .velu-feedback__action--cancel {
158
- background: transparent;
159
- border: var(--border-width) solid var(--border-color);
160
- color: var(--text-color);
161
- }
162
- .velu-feedback__action--cancel:hover {
163
- border-color: var(--accent-color);
164
- }
165
- .velu-feedback__action--submit {
166
- background: var(--accent-color);
167
- border: var(--border-width) solid var(--accent-color);
168
- color: #fff;
169
- }
170
- .velu-feedback__action--submit:hover {
171
- background: color-mix(in srgb, var(--accent-color) 88%, #000);
172
- }
173
-
174
- /* ── Submitted confirmation — sits below the divider line ───────────── */
175
- .velu-feedback__sent {
176
- padding-block-start: var(--s0);
177
- border-block-start: var(--border-width) solid var(--border-color);
178
- }
179
- .velu-feedback__sent-title {
180
- font-size: var(--f-body);
181
- font-weight: var(--weight-medium);
182
- color: var(--text-color);
183
- }
184
- .velu-feedback__sent-note {
185
- font-size: var(--f-h6);
186
- color: var(--muted-color);
187
- }
188
-
189
- /* ── Heart burst (on "Yes") ─────────────────────────────────────────── */
190
- /* Zero-size anchor pinned to the top-center of the Yes button; hearts
191
- are absolutely positioned relative to it and fan out from (0,0). */
192
- .velu-feedback__hearts {
193
- position: absolute;
194
- inset-block-start: 0;
195
- inset-inline-start: 50%;
196
- inline-size: 0;
197
- block-size: 0;
198
- pointer-events: none;
199
- }
200
- .velu-feedback__heart {
201
- position: absolute;
202
- inset-block-start: 0;
203
- inset-inline-start: 0;
204
- inline-size: var(--s-1);
205
- block-size: var(--s-1);
206
- /* --hb-tx / --hb-ty / --hb-rot are set per-heart inline. */
207
- animation: velu-feedback-hearts 0.8s ease-out forwards;
208
- }
209
- .velu-feedback__heart path {
210
- fill: currentColor;
211
- }
212
- /* Festive shades, all derived from the brand accent. */
213
- .velu-feedback__heart--0 {
214
- color: var(--accent-color);
215
- }
216
- .velu-feedback__heart--1 {
217
- color: color-mix(in srgb, var(--accent-color) 60%, #fff);
218
- }
219
- .velu-feedback__heart--2 {
220
- color: color-mix(in srgb, var(--accent-color) 55%, var(--text-color));
221
- }
222
- .velu-feedback__heart--3 {
223
- color: color-mix(in srgb, var(--accent-color) 82%, #fff);
224
- }
225
- @keyframes velu-feedback-hearts {
226
- 0% {
227
- transform: translate(-50%, 0) rotate(0deg) scale(0.6);
228
- opacity: 1;
229
- }
230
- 100% {
231
- transform: translate(calc(-50% + var(--hb-tx)), var(--hb-ty))
232
- rotate(var(--hb-rot)) scale(1);
233
- opacity: 0;
234
- }
235
- }
236
-
237
- @media (prefers-reduced-motion: reduce) {
238
- .velu-feedback__hearts {
239
- display: none;
240
- }
241
- }
1
+ /* PageFeedback — "Was this page helpful?" row. All values are tokens;
2
+ light/dark via [data-theme]. Row layout (flex/gap/wrap) is the
3
+ <Cluster> primitive; this file owns only typography + the buttons. */
4
+
5
+ .velu-feedback__question {
6
+ font-size: var(--f-h6);
7
+ color: var(--text-color);
8
+ }
9
+
10
+ .velu-feedback__btn {
11
+ position: relative; /* anchor for the heart burst */
12
+ display: inline-flex;
13
+ align-items: center;
14
+ gap: var(--s-3);
15
+ padding-block: var(--s-3);
16
+ padding-inline: var(--s-1);
17
+ background: transparent;
18
+ border: var(--border-width) solid var(--border-color);
19
+ border-radius: var(--radius-md);
20
+ color: var(--text-color);
21
+ font: inherit;
22
+ font-size: var(--f-h6);
23
+ font-weight: var(--weight-medium);
24
+ line-height: var(--lh-h6);
25
+ cursor: pointer;
26
+ transition:
27
+ border-color 0.12s ease,
28
+ background 0.12s ease,
29
+ color 0.12s ease;
30
+ }
31
+ .velu-feedback__btn svg {
32
+ flex: none;
33
+ /* Resting icon matches the label (full-contrast text color), not the
34
+ muted grey — accent is reserved for hover / chosen. */
35
+ color: var(--text-color);
36
+ }
37
+ .velu-feedback__btn:hover {
38
+ border-color: var(--accent-color);
39
+ }
40
+ .velu-feedback__btn:hover svg {
41
+ color: var(--accent-color);
42
+ }
43
+
44
+ /* The currently-picked button — accent border + tint, accent icon.
45
+ The vote stays changeable: clicking the other button moves it here. */
46
+ .velu-feedback__btn--chosen {
47
+ border-color: var(--accent-color);
48
+ background: color-mix(in srgb, var(--accent-color) 10%, transparent);
49
+ color: var(--accent-color);
50
+ }
51
+ .velu-feedback__btn--chosen svg {
52
+ color: var(--accent-color);
53
+ }
54
+
55
+ .velu-feedback__thanks {
56
+ font-size: var(--f-h6);
57
+ color: var(--muted-color);
58
+ }
59
+
60
+ /* ── "No" improvement form ──────────────────────────────────────────── */
61
+ /* Vertical rhythm is the <Stack> primitive; this owns only the chrome. */
62
+ .velu-feedback__form {
63
+ padding-block-start: var(--s0);
64
+ border-block-start: var(--border-width) solid var(--border-color);
65
+ }
66
+ .velu-feedback__form-title {
67
+ margin: 0;
68
+ font-size: var(--f-h4);
69
+ line-height: var(--lh-h4);
70
+ font-weight: var(--weight-medium);
71
+ color: var(--text-color);
72
+ }
73
+
74
+ /* Reason radio rows — native <input> visually hidden, circle drawn by
75
+ the adjacent mark span (so :checked can style it). */
76
+ .velu-feedback__radio {
77
+ position: relative;
78
+ display: flex;
79
+ align-items: center;
80
+ gap: var(--s-1);
81
+ cursor: pointer;
82
+ }
83
+ .velu-feedback__radio input {
84
+ position: absolute;
85
+ inset-block-start: 0;
86
+ inset-inline-start: 0;
87
+ inline-size: var(--icon-size-lg);
88
+ block-size: var(--icon-size-lg);
89
+ margin: 0;
90
+ opacity: 0;
91
+ cursor: pointer;
92
+ }
93
+ .velu-feedback__radio-mark {
94
+ position: relative;
95
+ flex: none;
96
+ inline-size: var(--icon-size-lg);
97
+ block-size: var(--icon-size-lg);
98
+ border: var(--border-width) solid var(--border-color);
99
+ border-radius: 50%;
100
+ transition: border-color 0.12s ease;
101
+ }
102
+ .velu-feedback__radio input:checked + .velu-feedback__radio-mark {
103
+ border-color: var(--accent-color);
104
+ }
105
+ .velu-feedback__radio input:checked + .velu-feedback__radio-mark::after {
106
+ content: '';
107
+ position: absolute;
108
+ inset: 22%;
109
+ background: var(--accent-color);
110
+ border-radius: 50%;
111
+ }
112
+ .velu-feedback__radio input:focus-visible + .velu-feedback__radio-mark {
113
+ outline: var(--border-width) solid var(--accent-color);
114
+ outline-offset: 2px;
115
+ }
116
+ .velu-feedback__radio:hover .velu-feedback__radio-mark {
117
+ border-color: var(--accent-color);
118
+ }
119
+ .velu-feedback__radio-label {
120
+ font-size: var(--f-body);
121
+ color: var(--text-color);
122
+ }
123
+
124
+ /* Optional free-text detail */
125
+ .velu-feedback__detail {
126
+ inline-size: 100%;
127
+ box-sizing: border-box;
128
+ padding: var(--s-1);
129
+ background: var(--page-bg);
130
+ border: var(--border-width) solid var(--border-color);
131
+ border-radius: var(--radius-md);
132
+ resize: vertical;
133
+ font: inherit;
134
+ font-size: var(--f-h6);
135
+ line-height: var(--lh-body);
136
+ color: var(--text-color);
137
+ }
138
+ .velu-feedback__detail::placeholder {
139
+ color: var(--muted-color);
140
+ }
141
+ .velu-feedback__detail:focus-visible {
142
+ outline: none;
143
+ border-color: var(--accent-color);
144
+ }
145
+
146
+ /* Cancel / Submit actions */
147
+ .velu-feedback__action {
148
+ padding-block: var(--s-2);
149
+ padding-inline: var(--s0);
150
+ border-radius: var(--radius-md);
151
+ font: inherit;
152
+ font-size: var(--f-h6);
153
+ font-weight: var(--weight-medium);
154
+ cursor: pointer;
155
+ transition: border-color 0.12s ease, background 0.12s ease;
156
+ }
157
+ .velu-feedback__action--cancel {
158
+ background: transparent;
159
+ border: var(--border-width) solid var(--border-color);
160
+ color: var(--text-color);
161
+ }
162
+ .velu-feedback__action--cancel:hover {
163
+ border-color: var(--accent-color);
164
+ }
165
+ .velu-feedback__action--submit {
166
+ background: var(--accent-color);
167
+ border: var(--border-width) solid var(--accent-color);
168
+ color: #fff;
169
+ }
170
+ .velu-feedback__action--submit:hover {
171
+ background: color-mix(in srgb, var(--accent-color) 88%, #000);
172
+ }
173
+
174
+ /* ── Submitted confirmation — sits below the divider line ───────────── */
175
+ .velu-feedback__sent {
176
+ padding-block-start: var(--s0);
177
+ border-block-start: var(--border-width) solid var(--border-color);
178
+ }
179
+ .velu-feedback__sent-title {
180
+ font-size: var(--f-body);
181
+ font-weight: var(--weight-medium);
182
+ color: var(--text-color);
183
+ }
184
+ .velu-feedback__sent-note {
185
+ font-size: var(--f-h6);
186
+ color: var(--muted-color);
187
+ }
188
+
189
+ /* ── Heart burst (on "Yes") ─────────────────────────────────────────── */
190
+ /* Zero-size anchor pinned to the top-center of the Yes button; hearts
191
+ are absolutely positioned relative to it and fan out from (0,0). */
192
+ .velu-feedback__hearts {
193
+ position: absolute;
194
+ inset-block-start: 0;
195
+ inset-inline-start: 50%;
196
+ inline-size: 0;
197
+ block-size: 0;
198
+ pointer-events: none;
199
+ }
200
+ .velu-feedback__heart {
201
+ position: absolute;
202
+ inset-block-start: 0;
203
+ inset-inline-start: 0;
204
+ inline-size: var(--s-1);
205
+ block-size: var(--s-1);
206
+ /* --hb-tx / --hb-ty / --hb-rot are set per-heart inline. */
207
+ animation: velu-feedback-hearts 0.8s ease-out forwards;
208
+ }
209
+ .velu-feedback__heart path {
210
+ fill: currentColor;
211
+ }
212
+ /* Festive shades, all derived from the brand accent. */
213
+ .velu-feedback__heart--0 {
214
+ color: var(--accent-color);
215
+ }
216
+ .velu-feedback__heart--1 {
217
+ color: color-mix(in srgb, var(--accent-color) 60%, #fff);
218
+ }
219
+ .velu-feedback__heart--2 {
220
+ color: color-mix(in srgb, var(--accent-color) 55%, var(--text-color));
221
+ }
222
+ .velu-feedback__heart--3 {
223
+ color: color-mix(in srgb, var(--accent-color) 82%, #fff);
224
+ }
225
+ @keyframes velu-feedback-hearts {
226
+ 0% {
227
+ transform: translate(-50%, 0) rotate(0deg) scale(0.6);
228
+ opacity: 1;
229
+ }
230
+ 100% {
231
+ transform: translate(calc(-50% + var(--hb-tx)), var(--hb-ty))
232
+ rotate(var(--hb-rot)) scale(1);
233
+ opacity: 0;
234
+ }
235
+ }
236
+
237
+ @media (prefers-reduced-motion: reduce) {
238
+ .velu-feedback__hearts {
239
+ display: none;
240
+ }
241
+ }