@veluai/velu 0.2.13 → 0.2.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 (109) hide show
  1. package/README.md +80 -80
  2. package/dist/cli.js +37 -37
  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 +122 -122
  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/Chatbot.jsx +885 -885
  16. package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
  17. package/runtime/velu-ui/components/Columns.jsx +56 -56
  18. package/runtime/velu-ui/components/ContextMenu.jsx +298 -273
  19. package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
  20. package/runtime/velu-ui/components/Field.jsx +81 -81
  21. package/runtime/velu-ui/components/Image.jsx +163 -163
  22. package/runtime/velu-ui/components/Logo.jsx +31 -31
  23. package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
  24. package/runtime/velu-ui/components/NavSelect.jsx +108 -108
  25. package/runtime/velu-ui/components/NotFound.jsx +63 -63
  26. package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
  27. package/runtime/velu-ui/components/PageFooter.jsx +145 -145
  28. package/runtime/velu-ui/components/PageHeader.jsx +422 -422
  29. package/runtime/velu-ui/components/PageNav.jsx +77 -77
  30. package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
  31. package/runtime/velu-ui/components/Prompt.jsx +115 -115
  32. package/runtime/velu-ui/components/Search.jsx +460 -460
  33. package/runtime/velu-ui/components/Sidebar.jsx +254 -254
  34. package/runtime/velu-ui/components/SocialLinks.jsx +90 -90
  35. package/runtime/velu-ui/components/Steps.jsx +65 -65
  36. package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
  37. package/runtime/velu-ui/components/Toc.jsx +537 -537
  38. package/runtime/velu-ui/components/TocBar.jsx +195 -195
  39. package/runtime/velu-ui/components/Tree.jsx +87 -87
  40. package/runtime/velu-ui/components/TryItBar.jsx +102 -102
  41. package/runtime/velu-ui/components/accordion.css +92 -92
  42. package/runtime/velu-ui/components/api-page.css +208 -208
  43. package/runtime/velu-ui/components/api.css +635 -635
  44. package/runtime/velu-ui/components/ask-bar.css +94 -94
  45. package/runtime/velu-ui/components/card.css +105 -105
  46. package/runtime/velu-ui/components/chatbot.css +622 -622
  47. package/runtime/velu-ui/components/code-block.css +263 -263
  48. package/runtime/velu-ui/components/context-menu.css +173 -173
  49. package/runtime/velu-ui/components/docs-layout.css +822 -822
  50. package/runtime/velu-ui/components/field.css +82 -82
  51. package/runtime/velu-ui/components/image.css +237 -237
  52. package/runtime/velu-ui/components/nav-select.css +157 -157
  53. package/runtime/velu-ui/components/not-found.css +94 -94
  54. package/runtime/velu-ui/components/page-feedback.css +241 -241
  55. package/runtime/velu-ui/components/page-footer.css +130 -130
  56. package/runtime/velu-ui/components/page-header.css +558 -558
  57. package/runtime/velu-ui/components/page-nav.css +50 -50
  58. package/runtime/velu-ui/components/powered-by.css +92 -92
  59. package/runtime/velu-ui/components/prompt.css +99 -99
  60. package/runtime/velu-ui/components/search.css +307 -307
  61. package/runtime/velu-ui/components/sidebar.css +205 -205
  62. package/runtime/velu-ui/components/steps.css +77 -77
  63. package/runtime/velu-ui/components/theme-toggle.css +102 -102
  64. package/runtime/velu-ui/components/toc-bar.css +234 -234
  65. package/runtime/velu-ui/components/tree.css +49 -49
  66. package/runtime/velu-ui/index.js +54 -54
  67. package/runtime/velu-ui/lib/api-send.js +92 -92
  68. package/runtime/velu-ui/lib/brand-icons.jsx +103 -103
  69. package/runtime/velu-ui/lib/component-schemas.js +100 -100
  70. package/runtime/velu-ui/lib/copyText.js +64 -64
  71. package/runtime/velu-ui/lib/docs-assistant.js +250 -250
  72. package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
  73. package/runtime/velu-ui/lib/pagefind.js +113 -113
  74. package/runtime/velu-ui/lib/prism-langs.js +957 -957
  75. package/runtime/velu-ui/lib/prism-loader.js +74 -74
  76. package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
  77. package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
  78. package/runtime/velu-ui/mdx-components.jsx +105 -105
  79. package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
  80. package/runtime/velu-ui/primitives/Stack.jsx +63 -63
  81. package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
  82. package/runtime/velu-ui/primitives/stack.css +3 -3
  83. package/runtime/velu-ui/primitives/switcher.css +25 -25
  84. package/runtime/velu-ui/styles.css +46 -46
  85. package/runtime/velu-ui/tokens.css +4 -4
  86. package/schema/velu.schema.json +423 -423
  87. package/src/lib/extract-mdx-error.js +170 -170
  88. package/src/lib/issues.js +159 -159
  89. package/src/lib/known-components.js +34 -34
  90. package/src/navigation.js +443 -443
  91. package/src/runtime/App.jsx +1669 -1668
  92. package/src/runtime/ErrorBoundary.jsx +54 -54
  93. package/src/runtime/client-entry.jsx +22 -22
  94. package/src/runtime/server-entry.jsx +16 -16
  95. package/src/template.html +48 -48
  96. package/templates/starter/ai-tools/claude-code.mdx +26 -26
  97. package/templates/starter/ai-tools/cursor.mdx +17 -17
  98. package/templates/starter/api-reference/introduction.mdx +43 -43
  99. package/templates/starter/development.mdx +19 -19
  100. package/templates/starter/essentials/code.mdx +29 -29
  101. package/templates/starter/essentials/images.mdx +29 -29
  102. package/templates/starter/essentials/markdown.mdx +25 -25
  103. package/templates/starter/essentials/navigation.mdx +39 -39
  104. package/templates/starter/essentials/settings.mdx +30 -30
  105. package/templates/starter/favicon.svg +6 -6
  106. package/templates/starter/index.mdx +31 -31
  107. package/templates/starter/openapi.json +160 -160
  108. package/templates/starter/quickstart.mdx +31 -31
  109. package/templates/starter/velu.json +41 -41
@@ -1,173 +1,173 @@
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-menu {
27
- position: relative;
28
- flex: none;
29
- }
30
-
31
- /* The split button: "Copy Page" + a divider + a chevron toggle, joined as one
32
- segmented control. */
33
- .velu-context-menu__split {
34
- display: inline-flex;
35
- align-items: stretch;
36
- border: var(--border-width) solid var(--border-color);
37
- border-radius: var(--radius-sm);
38
- background: var(--page-bg);
39
- overflow: hidden;
40
- transition: border-color 0.12s ease;
41
- }
42
- .velu-context-menu__split:hover {
43
- border-color: var(--accent-color);
44
- }
45
-
46
- .velu-context-menu__copy,
47
- .velu-context-menu__toggle {
48
- display: inline-flex;
49
- align-items: center;
50
- gap: var(--s-3);
51
- background: transparent;
52
- border: 0;
53
- font: inherit;
54
- font-size: var(--f-h6);
55
- color: var(--text-color);
56
- cursor: pointer;
57
- transition: background 0.12s ease, color 0.12s ease;
58
- }
59
- .velu-context-menu__copy {
60
- padding-block: var(--s-3);
61
- padding-inline: var(--s-1);
62
- font-weight: 500;
63
- }
64
- .velu-context-menu__toggle {
65
- padding-inline: var(--s-3);
66
- border-inline-start: var(--border-width) solid var(--border-color);
67
- }
68
- .velu-context-menu__copy:hover,
69
- .velu-context-menu__toggle:hover {
70
- background: var(--surface-color);
71
- color: var(--accent-color);
72
- }
73
- .velu-context-menu__copy-icon {
74
- display: inline-flex;
75
- flex: none;
76
- }
77
- .velu-context-menu__toggle svg {
78
- transition: transform 0.18s ease;
79
- }
80
- .velu-context-menu[data-open='true'] .velu-context-menu__toggle svg {
81
- transform: rotate(180deg);
82
- }
83
-
84
- /* Menu — anchored to the trailing edge below the button; fades + slides in.
85
- Always in DOM so the transition runs both ways; visibility delayed so the
86
- closed menu isn't focusable. */
87
- .velu-context-menu__menu {
88
- position: absolute;
89
- inset-block-start: calc(100% + var(--s-3));
90
- inset-inline-end: 0;
91
- min-inline-size: 17rem;
92
- margin: 0;
93
- padding-block: var(--s-3);
94
- padding-inline: 0.5rem; /* 8px */
95
- list-style: none;
96
- background: var(--page-bg);
97
- border: var(--border-width) solid var(--border-color);
98
- border-radius: 0.75rem; /* 12px */
99
- box-shadow: 0 var(--s-1) var(--s2) color-mix(in srgb, #000 14%, transparent);
100
- opacity: 0;
101
- visibility: hidden;
102
- transform: translateY(-0.25rem);
103
- pointer-events: none;
104
- transition:
105
- opacity 0.15s ease,
106
- transform 0.15s ease,
107
- visibility 0s linear 0.15s;
108
- z-index: 40;
109
- }
110
- .velu-context-menu[data-open='true'] .velu-context-menu__menu {
111
- opacity: 1;
112
- visibility: visible;
113
- transform: translateY(0);
114
- pointer-events: auto;
115
- transition:
116
- opacity 0.15s ease,
117
- transform 0.15s ease,
118
- visibility 0s;
119
- }
120
-
121
- .velu-context-menu__item {
122
- display: flex;
123
- align-items: flex-start;
124
- gap: var(--s-2);
125
- inline-size: 100%;
126
- padding-block: var(--s-3);
127
- padding-inline: var(--s-3);
128
- border-radius: var(--radius-sm);
129
- background: transparent;
130
- border: 0;
131
- font: inherit;
132
- text-align: start;
133
- color: var(--text-color);
134
- cursor: pointer;
135
- transition: background 0.12s ease;
136
- }
137
- .velu-context-menu__item:hover {
138
- background: var(--surface-color);
139
- }
140
-
141
- .velu-context-menu__item-icon {
142
- display: inline-flex;
143
- flex: none;
144
- margin-block-start: 0.1em;
145
- color: var(--muted-color);
146
- }
147
- .velu-context-menu__item:hover .velu-context-menu__item-icon {
148
- color: var(--accent-color);
149
- }
150
-
151
- .velu-context-menu__item-text {
152
- display: flex;
153
- flex-direction: column;
154
- gap: 0.1em;
155
- min-inline-size: 0;
156
- }
157
- .velu-context-menu__item-title {
158
- display: inline-flex;
159
- align-items: center;
160
- gap: var(--s-4);
161
- font-size: var(--f-h6);
162
- font-weight: 500;
163
- color: var(--text-color);
164
- }
165
- .velu-context-menu__item-ext {
166
- flex: none;
167
- color: var(--muted-color);
168
- }
169
- .velu-context-menu__item-desc {
170
- font-size: var(--f-h6);
171
- line-height: var(--lh-tight, 1.3);
172
- color: var(--muted-color);
173
- }
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-menu {
27
+ position: relative;
28
+ flex: none;
29
+ }
30
+
31
+ /* The split button: "Copy Page" + a divider + a chevron toggle, joined as one
32
+ segmented control. */
33
+ .velu-context-menu__split {
34
+ display: inline-flex;
35
+ align-items: stretch;
36
+ border: var(--border-width) solid var(--border-color);
37
+ border-radius: var(--radius-sm);
38
+ background: var(--page-bg);
39
+ overflow: hidden;
40
+ transition: border-color 0.12s ease;
41
+ }
42
+ .velu-context-menu__split:hover {
43
+ border-color: var(--accent-color);
44
+ }
45
+
46
+ .velu-context-menu__copy,
47
+ .velu-context-menu__toggle {
48
+ display: inline-flex;
49
+ align-items: center;
50
+ gap: var(--s-3);
51
+ background: transparent;
52
+ border: 0;
53
+ font: inherit;
54
+ font-size: var(--f-h6);
55
+ color: var(--text-color);
56
+ cursor: pointer;
57
+ transition: background 0.12s ease, color 0.12s ease;
58
+ }
59
+ .velu-context-menu__copy {
60
+ padding-block: var(--s-3);
61
+ padding-inline: var(--s-1);
62
+ font-weight: 500;
63
+ }
64
+ .velu-context-menu__toggle {
65
+ padding-inline: var(--s-3);
66
+ border-inline-start: var(--border-width) solid var(--border-color);
67
+ }
68
+ .velu-context-menu__copy:hover,
69
+ .velu-context-menu__toggle:hover {
70
+ background: var(--surface-color);
71
+ color: var(--accent-color);
72
+ }
73
+ .velu-context-menu__copy-icon {
74
+ display: inline-flex;
75
+ flex: none;
76
+ }
77
+ .velu-context-menu__toggle svg {
78
+ transition: transform 0.18s ease;
79
+ }
80
+ .velu-context-menu[data-open='true'] .velu-context-menu__toggle svg {
81
+ transform: rotate(180deg);
82
+ }
83
+
84
+ /* Menu — anchored to the trailing edge below the button; fades + slides in.
85
+ Always in DOM so the transition runs both ways; visibility delayed so the
86
+ closed menu isn't focusable. */
87
+ .velu-context-menu__menu {
88
+ position: absolute;
89
+ inset-block-start: calc(100% + var(--s-3));
90
+ inset-inline-end: 0;
91
+ min-inline-size: 17rem;
92
+ margin: 0;
93
+ padding-block: var(--s-3);
94
+ padding-inline: 0.5rem; /* 8px */
95
+ list-style: none;
96
+ background: var(--page-bg);
97
+ border: var(--border-width) solid var(--border-color);
98
+ border-radius: 0.75rem; /* 12px */
99
+ box-shadow: 0 var(--s-1) var(--s2) color-mix(in srgb, #000 14%, transparent);
100
+ opacity: 0;
101
+ visibility: hidden;
102
+ transform: translateY(-0.25rem);
103
+ pointer-events: none;
104
+ transition:
105
+ opacity 0.15s ease,
106
+ transform 0.15s ease,
107
+ visibility 0s linear 0.15s;
108
+ z-index: 40;
109
+ }
110
+ .velu-context-menu[data-open='true'] .velu-context-menu__menu {
111
+ opacity: 1;
112
+ visibility: visible;
113
+ transform: translateY(0);
114
+ pointer-events: auto;
115
+ transition:
116
+ opacity 0.15s ease,
117
+ transform 0.15s ease,
118
+ visibility 0s;
119
+ }
120
+
121
+ .velu-context-menu__item {
122
+ display: flex;
123
+ align-items: flex-start;
124
+ gap: var(--s-2);
125
+ inline-size: 100%;
126
+ padding-block: var(--s-3);
127
+ padding-inline: var(--s-3);
128
+ border-radius: var(--radius-sm);
129
+ background: transparent;
130
+ border: 0;
131
+ font: inherit;
132
+ text-align: start;
133
+ color: var(--text-color);
134
+ cursor: pointer;
135
+ transition: background 0.12s ease;
136
+ }
137
+ .velu-context-menu__item:hover {
138
+ background: var(--surface-color);
139
+ }
140
+
141
+ .velu-context-menu__item-icon {
142
+ display: inline-flex;
143
+ flex: none;
144
+ margin-block-start: 0.1em;
145
+ color: var(--muted-color);
146
+ }
147
+ .velu-context-menu__item:hover .velu-context-menu__item-icon {
148
+ color: var(--accent-color);
149
+ }
150
+
151
+ .velu-context-menu__item-text {
152
+ display: flex;
153
+ flex-direction: column;
154
+ gap: 0.1em;
155
+ min-inline-size: 0;
156
+ }
157
+ .velu-context-menu__item-title {
158
+ display: inline-flex;
159
+ align-items: center;
160
+ gap: var(--s-4);
161
+ font-size: var(--f-h6);
162
+ font-weight: 500;
163
+ color: var(--text-color);
164
+ }
165
+ .velu-context-menu__item-ext {
166
+ flex: none;
167
+ color: var(--muted-color);
168
+ }
169
+ .velu-context-menu__item-desc {
170
+ font-size: var(--f-h6);
171
+ line-height: var(--lh-tight, 1.3);
172
+ color: var(--muted-color);
173
+ }