@veluai/velu 0.2.25 → 0.2.27

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 (114) hide show
  1. package/README.md +80 -80
  2. package/dist/cli.js +44 -44
  3. package/package.json +64 -64
  4. package/runtime/velu-ui/base.css +320 -320
  5. package/runtime/velu-ui/components/Accordion.jsx +64 -64
  6. package/runtime/velu-ui/components/ApiClient.jsx +207 -207
  7. package/runtime/velu-ui/components/ApiField.jsx +87 -87
  8. package/runtime/velu-ui/components/ApiPath.jsx +63 -63
  9. package/runtime/velu-ui/components/ApiReferencePage.jsx +384 -384
  10. package/runtime/velu-ui/components/ApiSamples.jsx +36 -36
  11. package/runtime/velu-ui/components/ApiSidebar.jsx +125 -125
  12. package/runtime/velu-ui/components/AskBar.jsx +71 -71
  13. package/runtime/velu-ui/components/Callout.jsx +114 -114
  14. package/runtime/velu-ui/components/Card.jsx +131 -131
  15. package/runtime/velu-ui/components/ChangelogFilters.jsx +75 -75
  16. package/runtime/velu-ui/components/Chatbot.jsx +972 -972
  17. package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
  18. package/runtime/velu-ui/components/Columns.jsx +56 -56
  19. package/runtime/velu-ui/components/ContextMenu.jsx +327 -327
  20. package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
  21. package/runtime/velu-ui/components/Field.jsx +81 -81
  22. package/runtime/velu-ui/components/Image.jsx +163 -163
  23. package/runtime/velu-ui/components/Logo.jsx +31 -31
  24. package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
  25. package/runtime/velu-ui/components/NavSelect.jsx +108 -108
  26. package/runtime/velu-ui/components/NotFound.jsx +63 -63
  27. package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
  28. package/runtime/velu-ui/components/PageFooter.jsx +145 -145
  29. package/runtime/velu-ui/components/PageHeader.jsx +422 -422
  30. package/runtime/velu-ui/components/PageNav.jsx +77 -77
  31. package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
  32. package/runtime/velu-ui/components/Prompt.jsx +115 -115
  33. package/runtime/velu-ui/components/Search.jsx +460 -460
  34. package/runtime/velu-ui/components/Sidebar.jsx +246 -246
  35. package/runtime/velu-ui/components/SocialLinks.jsx +90 -90
  36. package/runtime/velu-ui/components/Steps.jsx +65 -65
  37. package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
  38. package/runtime/velu-ui/components/Toc.jsx +537 -537
  39. package/runtime/velu-ui/components/TocBar.jsx +195 -195
  40. package/runtime/velu-ui/components/Tree.jsx +87 -87
  41. package/runtime/velu-ui/components/TryItBar.jsx +102 -102
  42. package/runtime/velu-ui/components/Update.jsx +92 -92
  43. package/runtime/velu-ui/components/accordion.css +92 -92
  44. package/runtime/velu-ui/components/api-page.css +208 -208
  45. package/runtime/velu-ui/components/api.css +635 -635
  46. package/runtime/velu-ui/components/ask-bar.css +103 -103
  47. package/runtime/velu-ui/components/card.css +105 -105
  48. package/runtime/velu-ui/components/changelog-filters.css +43 -43
  49. package/runtime/velu-ui/components/chatbot.css +687 -687
  50. package/runtime/velu-ui/components/code-block.css +263 -263
  51. package/runtime/velu-ui/components/context-menu.css +199 -199
  52. package/runtime/velu-ui/components/docs-layout.css +822 -822
  53. package/runtime/velu-ui/components/field.css +82 -82
  54. package/runtime/velu-ui/components/image.css +237 -237
  55. package/runtime/velu-ui/components/nav-select.css +157 -157
  56. package/runtime/velu-ui/components/not-found.css +94 -94
  57. package/runtime/velu-ui/components/page-feedback.css +261 -261
  58. package/runtime/velu-ui/components/page-footer.css +130 -130
  59. package/runtime/velu-ui/components/page-header.css +558 -558
  60. package/runtime/velu-ui/components/page-nav.css +50 -50
  61. package/runtime/velu-ui/components/powered-by.css +92 -92
  62. package/runtime/velu-ui/components/prompt.css +99 -99
  63. package/runtime/velu-ui/components/search.css +307 -307
  64. package/runtime/velu-ui/components/sidebar.css +205 -205
  65. package/runtime/velu-ui/components/steps.css +77 -77
  66. package/runtime/velu-ui/components/theme-toggle.css +102 -102
  67. package/runtime/velu-ui/components/toc-bar.css +234 -234
  68. package/runtime/velu-ui/components/tree.css +49 -49
  69. package/runtime/velu-ui/components/update.css +111 -111
  70. package/runtime/velu-ui/index.js +58 -58
  71. package/runtime/velu-ui/lib/api-send.js +118 -118
  72. package/runtime/velu-ui/lib/brand-icons.jsx +103 -103
  73. package/runtime/velu-ui/lib/component-schemas.js +100 -100
  74. package/runtime/velu-ui/lib/copyText.js +64 -64
  75. package/runtime/velu-ui/lib/docs-assistant.js +273 -273
  76. package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
  77. package/runtime/velu-ui/lib/page-feedback.js +72 -72
  78. package/runtime/velu-ui/lib/pagefind.js +116 -116
  79. package/runtime/velu-ui/lib/prism-langs.js +957 -957
  80. package/runtime/velu-ui/lib/prism-loader.js +74 -74
  81. package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
  82. package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
  83. package/runtime/velu-ui/mdx-components.jsx +107 -107
  84. package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
  85. package/runtime/velu-ui/primitives/Stack.jsx +63 -63
  86. package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
  87. package/runtime/velu-ui/primitives/stack.css +3 -3
  88. package/runtime/velu-ui/primitives/switcher.css +25 -25
  89. package/runtime/velu-ui/styles.css +48 -48
  90. package/runtime/velu-ui/tokens.css +4 -4
  91. package/schema/velu.schema.json +419 -419
  92. package/src/lib/extract-mdx-error.js +170 -170
  93. package/src/lib/issues.js +159 -159
  94. package/src/lib/known-components.js +35 -35
  95. package/src/navigation.js +459 -459
  96. package/src/runtime/App.jsx +1754 -1754
  97. package/src/runtime/ErrorBoundary.jsx +54 -54
  98. package/src/runtime/client-entry.jsx +27 -27
  99. package/src/runtime/server-entry.jsx +24 -24
  100. package/src/template.html +48 -48
  101. package/templates/starter/ai-tools/claude-code.mdx +26 -26
  102. package/templates/starter/ai-tools/cursor.mdx +17 -17
  103. package/templates/starter/api-reference/introduction.mdx +43 -43
  104. package/templates/starter/development.mdx +19 -19
  105. package/templates/starter/essentials/code.mdx +29 -29
  106. package/templates/starter/essentials/images.mdx +29 -29
  107. package/templates/starter/essentials/markdown.mdx +25 -25
  108. package/templates/starter/essentials/navigation.mdx +39 -39
  109. package/templates/starter/essentials/settings.mdx +30 -30
  110. package/templates/starter/favicon.svg +6 -6
  111. package/templates/starter/index.mdx +31 -31
  112. package/templates/starter/openapi.json +160 -160
  113. package/templates/starter/quickstart.mdx +31 -31
  114. package/templates/starter/velu.json +40 -40
@@ -1,199 +1,199 @@
1
- /* ContextMenu — the per-page agent/IDE action bar (eyebrow + Copy Page
2
- split-button + dropdown). Mirrors NavSelect's dropdown recipe; all values are
3
- tokens, light/dark via [data-theme]. */
4
-
5
- .velu-context-bar {
6
- /* Tight to the page title below — the eyebrow reads as a kicker on the
7
- title, not a detached row. Negative pull cancels the h1's line-height
8
- leading so the cap-height of the title sits right under the eyebrow. */
9
- margin-block-end: calc(-1 * var(--s-5));
10
- }
11
-
12
- /* Section/group label, top-left — small, uppercase, accent (matches the
13
- crimson eyebrow in the reference). */
14
- .velu-context-bar__eyebrow {
15
- min-inline-size: 0;
16
- overflow: hidden;
17
- text-overflow: ellipsis;
18
- white-space: nowrap;
19
- font-size: var(--f-h6);
20
- font-weight: 600;
21
- letter-spacing: 0.06em;
22
- text-transform: uppercase;
23
- color: var(--accent-color);
24
- }
25
-
26
- .velu-context-bar__actions {
27
- display: inline-flex;
28
- align-items: center;
29
- gap: var(--s-2);
30
- flex: none;
31
- }
32
-
33
- .velu-context-menu {
34
- position: relative;
35
- flex: none;
36
- }
37
-
38
- /* RSS feed link — a round icon button next to "Copy Page" (changelog pages). */
39
- .velu-context-menu__rss {
40
- display: inline-flex;
41
- align-items: center;
42
- justify-content: center;
43
- inline-size: 2.1rem;
44
- block-size: 2.1rem;
45
- border: var(--border-width) solid var(--border-color);
46
- border-radius: 999px;
47
- color: var(--muted-color);
48
- background: var(--page-bg);
49
- transition: color 0.12s ease, border-color 0.12s ease, background 0.12s ease;
50
- }
51
- .velu-context-menu__rss:hover {
52
- color: var(--accent-color);
53
- border-color: var(--accent-color);
54
- background: color-mix(in srgb, var(--accent-color) 8%, transparent);
55
- }
56
-
57
- /* The split button: "Copy Page" + a divider + a chevron toggle, joined as one
58
- segmented control. */
59
- .velu-context-menu__split {
60
- display: inline-flex;
61
- align-items: stretch;
62
- border: var(--border-width) solid var(--border-color);
63
- border-radius: var(--radius-sm);
64
- background: var(--page-bg);
65
- overflow: hidden;
66
- transition: border-color 0.12s ease;
67
- }
68
- .velu-context-menu__split:hover {
69
- border-color: var(--accent-color);
70
- }
71
-
72
- .velu-context-menu__copy,
73
- .velu-context-menu__toggle {
74
- display: inline-flex;
75
- align-items: center;
76
- gap: var(--s-3);
77
- background: transparent;
78
- border: 0;
79
- font: inherit;
80
- font-size: var(--f-h6);
81
- color: var(--text-color);
82
- cursor: pointer;
83
- transition: background 0.12s ease, color 0.12s ease;
84
- }
85
- .velu-context-menu__copy {
86
- padding-block: var(--s-3);
87
- padding-inline: var(--s-1);
88
- font-weight: 500;
89
- }
90
- .velu-context-menu__toggle {
91
- padding-inline: var(--s-3);
92
- border-inline-start: var(--border-width) solid var(--border-color);
93
- }
94
- .velu-context-menu__copy:hover,
95
- .velu-context-menu__toggle:hover {
96
- background: var(--surface-color);
97
- color: var(--accent-color);
98
- }
99
- .velu-context-menu__copy-icon {
100
- display: inline-flex;
101
- flex: none;
102
- }
103
- .velu-context-menu__toggle svg {
104
- transition: transform 0.18s ease;
105
- }
106
- .velu-context-menu[data-open='true'] .velu-context-menu__toggle svg {
107
- transform: rotate(180deg);
108
- }
109
-
110
- /* Menu — anchored to the trailing edge below the button; fades + slides in.
111
- Always in DOM so the transition runs both ways; visibility delayed so the
112
- closed menu isn't focusable. */
113
- .velu-context-menu__menu {
114
- position: absolute;
115
- inset-block-start: calc(100% + var(--s-3));
116
- inset-inline-end: 0;
117
- min-inline-size: 17rem;
118
- margin: 0;
119
- padding-block: var(--s-3);
120
- padding-inline: 0.5rem; /* 8px */
121
- list-style: none;
122
- background: var(--page-bg);
123
- border: var(--border-width) solid var(--border-color);
124
- border-radius: 0.75rem; /* 12px */
125
- box-shadow: 0 var(--s-1) var(--s2) color-mix(in srgb, #000 14%, transparent);
126
- opacity: 0;
127
- visibility: hidden;
128
- transform: translateY(-0.25rem);
129
- pointer-events: none;
130
- transition:
131
- opacity 0.15s ease,
132
- transform 0.15s ease,
133
- visibility 0s linear 0.15s;
134
- z-index: 40;
135
- }
136
- .velu-context-menu[data-open='true'] .velu-context-menu__menu {
137
- opacity: 1;
138
- visibility: visible;
139
- transform: translateY(0);
140
- pointer-events: auto;
141
- transition:
142
- opacity 0.15s ease,
143
- transform 0.15s ease,
144
- visibility 0s;
145
- }
146
-
147
- .velu-context-menu__item {
148
- display: flex;
149
- align-items: flex-start;
150
- gap: var(--s-2);
151
- inline-size: 100%;
152
- padding-block: var(--s-3);
153
- padding-inline: var(--s-3);
154
- border-radius: var(--radius-sm);
155
- background: transparent;
156
- border: 0;
157
- font: inherit;
158
- text-align: start;
159
- color: var(--text-color);
160
- cursor: pointer;
161
- transition: background 0.12s ease;
162
- }
163
- .velu-context-menu__item:hover {
164
- background: var(--surface-color);
165
- }
166
-
167
- .velu-context-menu__item-icon {
168
- display: inline-flex;
169
- flex: none;
170
- margin-block-start: 0.1em;
171
- color: var(--muted-color);
172
- }
173
- .velu-context-menu__item:hover .velu-context-menu__item-icon {
174
- color: var(--accent-color);
175
- }
176
-
177
- .velu-context-menu__item-text {
178
- display: flex;
179
- flex-direction: column;
180
- gap: 0.1em;
181
- min-inline-size: 0;
182
- }
183
- .velu-context-menu__item-title {
184
- display: inline-flex;
185
- align-items: center;
186
- gap: var(--s-4);
187
- font-size: var(--f-h6);
188
- font-weight: 500;
189
- color: var(--text-color);
190
- }
191
- .velu-context-menu__item-ext {
192
- flex: none;
193
- color: var(--muted-color);
194
- }
195
- .velu-context-menu__item-desc {
196
- font-size: var(--f-h6);
197
- line-height: var(--lh-tight, 1.3);
198
- color: var(--muted-color);
199
- }
1
+ /* ContextMenu — the per-page agent/IDE action bar (eyebrow + Copy Page
2
+ split-button + dropdown). Mirrors NavSelect's dropdown recipe; all values are
3
+ tokens, light/dark via [data-theme]. */
4
+
5
+ .velu-context-bar {
6
+ /* Tight to the page title below — the eyebrow reads as a kicker on the
7
+ title, not a detached row. Negative pull cancels the h1's line-height
8
+ leading so the cap-height of the title sits right under the eyebrow. */
9
+ margin-block-end: calc(-1 * var(--s-5));
10
+ }
11
+
12
+ /* Section/group label, top-left — small, uppercase, accent (matches the
13
+ crimson eyebrow in the reference). */
14
+ .velu-context-bar__eyebrow {
15
+ min-inline-size: 0;
16
+ overflow: hidden;
17
+ text-overflow: ellipsis;
18
+ white-space: nowrap;
19
+ font-size: var(--f-h6);
20
+ font-weight: 600;
21
+ letter-spacing: 0.06em;
22
+ text-transform: uppercase;
23
+ color: var(--accent-color);
24
+ }
25
+
26
+ .velu-context-bar__actions {
27
+ display: inline-flex;
28
+ align-items: center;
29
+ gap: var(--s-2);
30
+ flex: none;
31
+ }
32
+
33
+ .velu-context-menu {
34
+ position: relative;
35
+ flex: none;
36
+ }
37
+
38
+ /* RSS feed link — a round icon button next to "Copy Page" (changelog pages). */
39
+ .velu-context-menu__rss {
40
+ display: inline-flex;
41
+ align-items: center;
42
+ justify-content: center;
43
+ inline-size: 2.1rem;
44
+ block-size: 2.1rem;
45
+ border: var(--border-width) solid var(--border-color);
46
+ border-radius: 999px;
47
+ color: var(--muted-color);
48
+ background: var(--page-bg);
49
+ transition: color 0.12s ease, border-color 0.12s ease, background 0.12s ease;
50
+ }
51
+ .velu-context-menu__rss:hover {
52
+ color: var(--accent-color);
53
+ border-color: var(--accent-color);
54
+ background: color-mix(in srgb, var(--accent-color) 8%, transparent);
55
+ }
56
+
57
+ /* The split button: "Copy Page" + a divider + a chevron toggle, joined as one
58
+ segmented control. */
59
+ .velu-context-menu__split {
60
+ display: inline-flex;
61
+ align-items: stretch;
62
+ border: var(--border-width) solid var(--border-color);
63
+ border-radius: var(--radius-sm);
64
+ background: var(--page-bg);
65
+ overflow: hidden;
66
+ transition: border-color 0.12s ease;
67
+ }
68
+ .velu-context-menu__split:hover {
69
+ border-color: var(--accent-color);
70
+ }
71
+
72
+ .velu-context-menu__copy,
73
+ .velu-context-menu__toggle {
74
+ display: inline-flex;
75
+ align-items: center;
76
+ gap: var(--s-3);
77
+ background: transparent;
78
+ border: 0;
79
+ font: inherit;
80
+ font-size: var(--f-h6);
81
+ color: var(--text-color);
82
+ cursor: pointer;
83
+ transition: background 0.12s ease, color 0.12s ease;
84
+ }
85
+ .velu-context-menu__copy {
86
+ padding-block: var(--s-3);
87
+ padding-inline: var(--s-1);
88
+ font-weight: 500;
89
+ }
90
+ .velu-context-menu__toggle {
91
+ padding-inline: var(--s-3);
92
+ border-inline-start: var(--border-width) solid var(--border-color);
93
+ }
94
+ .velu-context-menu__copy:hover,
95
+ .velu-context-menu__toggle:hover {
96
+ background: var(--surface-color);
97
+ color: var(--accent-color);
98
+ }
99
+ .velu-context-menu__copy-icon {
100
+ display: inline-flex;
101
+ flex: none;
102
+ }
103
+ .velu-context-menu__toggle svg {
104
+ transition: transform 0.18s ease;
105
+ }
106
+ .velu-context-menu[data-open='true'] .velu-context-menu__toggle svg {
107
+ transform: rotate(180deg);
108
+ }
109
+
110
+ /* Menu — anchored to the trailing edge below the button; fades + slides in.
111
+ Always in DOM so the transition runs both ways; visibility delayed so the
112
+ closed menu isn't focusable. */
113
+ .velu-context-menu__menu {
114
+ position: absolute;
115
+ inset-block-start: calc(100% + var(--s-3));
116
+ inset-inline-end: 0;
117
+ min-inline-size: 17rem;
118
+ margin: 0;
119
+ padding-block: var(--s-3);
120
+ padding-inline: 0.5rem; /* 8px */
121
+ list-style: none;
122
+ background: var(--page-bg);
123
+ border: var(--border-width) solid var(--border-color);
124
+ border-radius: 0.75rem; /* 12px */
125
+ box-shadow: 0 var(--s-1) var(--s2) color-mix(in srgb, #000 14%, transparent);
126
+ opacity: 0;
127
+ visibility: hidden;
128
+ transform: translateY(-0.25rem);
129
+ pointer-events: none;
130
+ transition:
131
+ opacity 0.15s ease,
132
+ transform 0.15s ease,
133
+ visibility 0s linear 0.15s;
134
+ z-index: 40;
135
+ }
136
+ .velu-context-menu[data-open='true'] .velu-context-menu__menu {
137
+ opacity: 1;
138
+ visibility: visible;
139
+ transform: translateY(0);
140
+ pointer-events: auto;
141
+ transition:
142
+ opacity 0.15s ease,
143
+ transform 0.15s ease,
144
+ visibility 0s;
145
+ }
146
+
147
+ .velu-context-menu__item {
148
+ display: flex;
149
+ align-items: flex-start;
150
+ gap: var(--s-2);
151
+ inline-size: 100%;
152
+ padding-block: var(--s-3);
153
+ padding-inline: var(--s-3);
154
+ border-radius: var(--radius-sm);
155
+ background: transparent;
156
+ border: 0;
157
+ font: inherit;
158
+ text-align: start;
159
+ color: var(--text-color);
160
+ cursor: pointer;
161
+ transition: background 0.12s ease;
162
+ }
163
+ .velu-context-menu__item:hover {
164
+ background: var(--surface-color);
165
+ }
166
+
167
+ .velu-context-menu__item-icon {
168
+ display: inline-flex;
169
+ flex: none;
170
+ margin-block-start: 0.1em;
171
+ color: var(--muted-color);
172
+ }
173
+ .velu-context-menu__item:hover .velu-context-menu__item-icon {
174
+ color: var(--accent-color);
175
+ }
176
+
177
+ .velu-context-menu__item-text {
178
+ display: flex;
179
+ flex-direction: column;
180
+ gap: 0.1em;
181
+ min-inline-size: 0;
182
+ }
183
+ .velu-context-menu__item-title {
184
+ display: inline-flex;
185
+ align-items: center;
186
+ gap: var(--s-4);
187
+ font-size: var(--f-h6);
188
+ font-weight: 500;
189
+ color: var(--text-color);
190
+ }
191
+ .velu-context-menu__item-ext {
192
+ flex: none;
193
+ color: var(--muted-color);
194
+ }
195
+ .velu-context-menu__item-desc {
196
+ font-size: var(--f-h6);
197
+ line-height: var(--lh-tight, 1.3);
198
+ color: var(--muted-color);
199
+ }