@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.
- package/README.md +80 -80
- package/dist/cli.js +37 -37
- package/package.json +64 -64
- package/runtime/velu-ui/base.css +320 -320
- package/runtime/velu-ui/components/Accordion.jsx +64 -64
- package/runtime/velu-ui/components/ApiClient.jsx +207 -207
- package/runtime/velu-ui/components/ApiField.jsx +87 -87
- package/runtime/velu-ui/components/ApiPath.jsx +63 -63
- package/runtime/velu-ui/components/ApiReferencePage.jsx +384 -384
- package/runtime/velu-ui/components/ApiSamples.jsx +36 -36
- package/runtime/velu-ui/components/ApiSidebar.jsx +122 -122
- package/runtime/velu-ui/components/AskBar.jsx +71 -71
- package/runtime/velu-ui/components/Callout.jsx +114 -114
- package/runtime/velu-ui/components/Card.jsx +131 -131
- package/runtime/velu-ui/components/Chatbot.jsx +885 -885
- package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
- package/runtime/velu-ui/components/Columns.jsx +56 -56
- package/runtime/velu-ui/components/ContextMenu.jsx +298 -273
- package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
- package/runtime/velu-ui/components/Field.jsx +81 -81
- package/runtime/velu-ui/components/Image.jsx +163 -163
- package/runtime/velu-ui/components/Logo.jsx +31 -31
- package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
- package/runtime/velu-ui/components/NavSelect.jsx +108 -108
- package/runtime/velu-ui/components/NotFound.jsx +63 -63
- package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
- package/runtime/velu-ui/components/PageFooter.jsx +145 -145
- package/runtime/velu-ui/components/PageHeader.jsx +422 -422
- package/runtime/velu-ui/components/PageNav.jsx +77 -77
- package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
- package/runtime/velu-ui/components/Prompt.jsx +115 -115
- package/runtime/velu-ui/components/Search.jsx +460 -460
- package/runtime/velu-ui/components/Sidebar.jsx +254 -254
- package/runtime/velu-ui/components/SocialLinks.jsx +90 -90
- package/runtime/velu-ui/components/Steps.jsx +65 -65
- package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
- package/runtime/velu-ui/components/Toc.jsx +537 -537
- package/runtime/velu-ui/components/TocBar.jsx +195 -195
- package/runtime/velu-ui/components/Tree.jsx +87 -87
- package/runtime/velu-ui/components/TryItBar.jsx +102 -102
- package/runtime/velu-ui/components/accordion.css +92 -92
- package/runtime/velu-ui/components/api-page.css +208 -208
- package/runtime/velu-ui/components/api.css +635 -635
- package/runtime/velu-ui/components/ask-bar.css +94 -94
- package/runtime/velu-ui/components/card.css +105 -105
- package/runtime/velu-ui/components/chatbot.css +622 -622
- package/runtime/velu-ui/components/code-block.css +263 -263
- package/runtime/velu-ui/components/context-menu.css +173 -173
- package/runtime/velu-ui/components/docs-layout.css +822 -822
- package/runtime/velu-ui/components/field.css +82 -82
- package/runtime/velu-ui/components/image.css +237 -237
- package/runtime/velu-ui/components/nav-select.css +157 -157
- package/runtime/velu-ui/components/not-found.css +94 -94
- package/runtime/velu-ui/components/page-feedback.css +241 -241
- package/runtime/velu-ui/components/page-footer.css +130 -130
- package/runtime/velu-ui/components/page-header.css +558 -558
- package/runtime/velu-ui/components/page-nav.css +50 -50
- package/runtime/velu-ui/components/powered-by.css +92 -92
- package/runtime/velu-ui/components/prompt.css +99 -99
- package/runtime/velu-ui/components/search.css +307 -307
- package/runtime/velu-ui/components/sidebar.css +205 -205
- package/runtime/velu-ui/components/steps.css +77 -77
- package/runtime/velu-ui/components/theme-toggle.css +102 -102
- package/runtime/velu-ui/components/toc-bar.css +234 -234
- package/runtime/velu-ui/components/tree.css +49 -49
- package/runtime/velu-ui/index.js +54 -54
- package/runtime/velu-ui/lib/api-send.js +92 -92
- package/runtime/velu-ui/lib/brand-icons.jsx +103 -103
- package/runtime/velu-ui/lib/component-schemas.js +100 -100
- package/runtime/velu-ui/lib/copyText.js +64 -64
- package/runtime/velu-ui/lib/docs-assistant.js +250 -250
- package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
- package/runtime/velu-ui/lib/pagefind.js +113 -113
- package/runtime/velu-ui/lib/prism-langs.js +957 -957
- package/runtime/velu-ui/lib/prism-loader.js +74 -74
- package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
- package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
- package/runtime/velu-ui/mdx-components.jsx +105 -105
- package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
- package/runtime/velu-ui/primitives/Stack.jsx +63 -63
- package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
- package/runtime/velu-ui/primitives/stack.css +3 -3
- package/runtime/velu-ui/primitives/switcher.css +25 -25
- package/runtime/velu-ui/styles.css +46 -46
- package/runtime/velu-ui/tokens.css +4 -4
- package/schema/velu.schema.json +423 -423
- package/src/lib/extract-mdx-error.js +170 -170
- package/src/lib/issues.js +159 -159
- package/src/lib/known-components.js +34 -34
- package/src/navigation.js +443 -443
- package/src/runtime/App.jsx +1669 -1668
- package/src/runtime/ErrorBoundary.jsx +54 -54
- package/src/runtime/client-entry.jsx +22 -22
- package/src/runtime/server-entry.jsx +16 -16
- package/src/template.html +48 -48
- package/templates/starter/ai-tools/claude-code.mdx +26 -26
- package/templates/starter/ai-tools/cursor.mdx +17 -17
- package/templates/starter/api-reference/introduction.mdx +43 -43
- package/templates/starter/development.mdx +19 -19
- package/templates/starter/essentials/code.mdx +29 -29
- package/templates/starter/essentials/images.mdx +29 -29
- package/templates/starter/essentials/markdown.mdx +25 -25
- package/templates/starter/essentials/navigation.mdx +39 -39
- package/templates/starter/essentials/settings.mdx +30 -30
- package/templates/starter/favicon.svg +6 -6
- package/templates/starter/index.mdx +31 -31
- package/templates/starter/openapi.json +160 -160
- package/templates/starter/quickstart.mdx +31 -31
- package/templates/starter/velu.json +41 -41
|
@@ -1,102 +1,102 @@
|
|
|
1
|
-
/* ThemeToggle — circular button with a sun/moon glyph; click flips
|
|
2
|
-
the theme. Geometry is a 32 × 32 circle with an 18 × 18 glyph
|
|
3
|
-
centred inside. The pill-with-slider design was replaced earlier;
|
|
4
|
-
only the circle survives now.
|
|
5
|
-
|
|
6
|
-
In light mode: --page-bg circle, sun glyph.
|
|
7
|
-
In dark mode: --page-bg circle, moon glyph.
|
|
8
|
-
|
|
9
|
-
Visibility model: BOTH icons are always rendered, stacked at the
|
|
10
|
-
same `position: absolute` slot inside the button. Opacity controls
|
|
11
|
-
which one is visible. We use opacity (not display: none) because:
|
|
12
|
-
|
|
13
|
-
1. Stacked icons render at the exact same point — no layout
|
|
14
|
-
shift when the theme flips.
|
|
15
|
-
2. Opacity is not touched anywhere else for these elements, so
|
|
16
|
-
the cascade is trivial — no risk of a stray rule (preflight,
|
|
17
|
-
utility class, dev-time fallback) overriding `display: none`
|
|
18
|
-
and revealing the wrong icon.
|
|
19
|
-
3. Identical markup on server + client → SSR-safe, no hydration
|
|
20
|
-
mismatch and no icon flash.
|
|
21
|
-
|
|
22
|
-
All values are tokens. */
|
|
23
|
-
|
|
24
|
-
.velu-theme-toggle {
|
|
25
|
-
/* `relative` so the absolutely-positioned icons inside are
|
|
26
|
-
anchored to this button, not the page. */
|
|
27
|
-
position: relative;
|
|
28
|
-
display: inline-flex;
|
|
29
|
-
align-items: center;
|
|
30
|
-
justify-content: center;
|
|
31
|
-
inline-size: 2rem;
|
|
32
|
-
block-size: 2rem;
|
|
33
|
-
border: var(--border-width) solid var(--border-color);
|
|
34
|
-
border-radius: 999px;
|
|
35
|
-
padding: 0;
|
|
36
|
-
background: var(--page-bg);
|
|
37
|
-
cursor: pointer;
|
|
38
|
-
transition: border-color 0.12s ease, background 0.12s ease,
|
|
39
|
-
transform 0.18s cubic-bezier(0.34, 1.56, 0.64, 1);
|
|
40
|
-
}
|
|
41
|
-
.velu-theme-toggle:hover {
|
|
42
|
-
background: var(--surface-color);
|
|
43
|
-
border-color: var(--accent-color);
|
|
44
|
-
}
|
|
45
|
-
/* Tactile press feedback on click. */
|
|
46
|
-
.velu-theme-toggle:active {
|
|
47
|
-
transform: scale(0.9);
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
/* Both icons stack here, centred. Each animates in/out on a theme flip:
|
|
51
|
-
the hidden glyph is faded, shrunk, and rotated off its axis; the active
|
|
52
|
-
one springs to full size at 0deg. Centring is done with margins (above),
|
|
53
|
-
so `transform` is free to drive the rotate/scale animation. */
|
|
54
|
-
.velu-theme-toggle__icon {
|
|
55
|
-
position: absolute;
|
|
56
|
-
inset-block-start: 50%;
|
|
57
|
-
inset-inline-start: 50%;
|
|
58
|
-
inline-size: 1.125rem;
|
|
59
|
-
block-size: 1.125rem;
|
|
60
|
-
margin-block-start: -0.5625rem; /* half of block-size */
|
|
61
|
-
margin-inline-start: -0.5625rem; /* half of inline-size */
|
|
62
|
-
color: var(--text-color);
|
|
63
|
-
opacity: 0;
|
|
64
|
-
transition: opacity 0.28s ease,
|
|
65
|
-
transform 0.4s cubic-bezier(0.34, 1.56, 0.64, 1);
|
|
66
|
-
pointer-events: none;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
/* Hidden state per glyph — sun spins out clockwise, moon anti-clockwise,
|
|
70
|
-
so the swap reads as one rotating through the other. */
|
|
71
|
-
.velu-theme-toggle__icon--sun {
|
|
72
|
-
transform: rotate(90deg) scale(0.4);
|
|
73
|
-
}
|
|
74
|
-
.velu-theme-toggle__icon--moon {
|
|
75
|
-
transform: rotate(-90deg) scale(0.4);
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
/* Exactly one glyph is shown — the sun in light, the moon in dark — at full
|
|
79
|
-
size, upright. Higher specificity than the hidden defaults above, so it
|
|
80
|
-
wins for whichever glyph the active theme selects. */
|
|
81
|
-
:root:not([data-theme='dark']) .velu-theme-toggle__icon--sun,
|
|
82
|
-
[data-theme='dark'] .velu-theme-toggle__icon--moon {
|
|
83
|
-
opacity: 1;
|
|
84
|
-
transform: rotate(0deg) scale(1);
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
/* Honour reduced-motion: keep a plain crossfade — no spin, scale, or press. */
|
|
88
|
-
@media (prefers-reduced-motion: reduce) {
|
|
89
|
-
.velu-theme-toggle {
|
|
90
|
-
transition: border-color 0.12s ease, background 0.12s ease;
|
|
91
|
-
}
|
|
92
|
-
.velu-theme-toggle:active {
|
|
93
|
-
transform: none;
|
|
94
|
-
}
|
|
95
|
-
.velu-theme-toggle__icon {
|
|
96
|
-
transition: opacity 0.2s ease;
|
|
97
|
-
}
|
|
98
|
-
.velu-theme-toggle__icon--sun,
|
|
99
|
-
.velu-theme-toggle__icon--moon {
|
|
100
|
-
transform: none;
|
|
101
|
-
}
|
|
102
|
-
}
|
|
1
|
+
/* ThemeToggle — circular button with a sun/moon glyph; click flips
|
|
2
|
+
the theme. Geometry is a 32 × 32 circle with an 18 × 18 glyph
|
|
3
|
+
centred inside. The pill-with-slider design was replaced earlier;
|
|
4
|
+
only the circle survives now.
|
|
5
|
+
|
|
6
|
+
In light mode: --page-bg circle, sun glyph.
|
|
7
|
+
In dark mode: --page-bg circle, moon glyph.
|
|
8
|
+
|
|
9
|
+
Visibility model: BOTH icons are always rendered, stacked at the
|
|
10
|
+
same `position: absolute` slot inside the button. Opacity controls
|
|
11
|
+
which one is visible. We use opacity (not display: none) because:
|
|
12
|
+
|
|
13
|
+
1. Stacked icons render at the exact same point — no layout
|
|
14
|
+
shift when the theme flips.
|
|
15
|
+
2. Opacity is not touched anywhere else for these elements, so
|
|
16
|
+
the cascade is trivial — no risk of a stray rule (preflight,
|
|
17
|
+
utility class, dev-time fallback) overriding `display: none`
|
|
18
|
+
and revealing the wrong icon.
|
|
19
|
+
3. Identical markup on server + client → SSR-safe, no hydration
|
|
20
|
+
mismatch and no icon flash.
|
|
21
|
+
|
|
22
|
+
All values are tokens. */
|
|
23
|
+
|
|
24
|
+
.velu-theme-toggle {
|
|
25
|
+
/* `relative` so the absolutely-positioned icons inside are
|
|
26
|
+
anchored to this button, not the page. */
|
|
27
|
+
position: relative;
|
|
28
|
+
display: inline-flex;
|
|
29
|
+
align-items: center;
|
|
30
|
+
justify-content: center;
|
|
31
|
+
inline-size: 2rem;
|
|
32
|
+
block-size: 2rem;
|
|
33
|
+
border: var(--border-width) solid var(--border-color);
|
|
34
|
+
border-radius: 999px;
|
|
35
|
+
padding: 0;
|
|
36
|
+
background: var(--page-bg);
|
|
37
|
+
cursor: pointer;
|
|
38
|
+
transition: border-color 0.12s ease, background 0.12s ease,
|
|
39
|
+
transform 0.18s cubic-bezier(0.34, 1.56, 0.64, 1);
|
|
40
|
+
}
|
|
41
|
+
.velu-theme-toggle:hover {
|
|
42
|
+
background: var(--surface-color);
|
|
43
|
+
border-color: var(--accent-color);
|
|
44
|
+
}
|
|
45
|
+
/* Tactile press feedback on click. */
|
|
46
|
+
.velu-theme-toggle:active {
|
|
47
|
+
transform: scale(0.9);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/* Both icons stack here, centred. Each animates in/out on a theme flip:
|
|
51
|
+
the hidden glyph is faded, shrunk, and rotated off its axis; the active
|
|
52
|
+
one springs to full size at 0deg. Centring is done with margins (above),
|
|
53
|
+
so `transform` is free to drive the rotate/scale animation. */
|
|
54
|
+
.velu-theme-toggle__icon {
|
|
55
|
+
position: absolute;
|
|
56
|
+
inset-block-start: 50%;
|
|
57
|
+
inset-inline-start: 50%;
|
|
58
|
+
inline-size: 1.125rem;
|
|
59
|
+
block-size: 1.125rem;
|
|
60
|
+
margin-block-start: -0.5625rem; /* half of block-size */
|
|
61
|
+
margin-inline-start: -0.5625rem; /* half of inline-size */
|
|
62
|
+
color: var(--text-color);
|
|
63
|
+
opacity: 0;
|
|
64
|
+
transition: opacity 0.28s ease,
|
|
65
|
+
transform 0.4s cubic-bezier(0.34, 1.56, 0.64, 1);
|
|
66
|
+
pointer-events: none;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/* Hidden state per glyph — sun spins out clockwise, moon anti-clockwise,
|
|
70
|
+
so the swap reads as one rotating through the other. */
|
|
71
|
+
.velu-theme-toggle__icon--sun {
|
|
72
|
+
transform: rotate(90deg) scale(0.4);
|
|
73
|
+
}
|
|
74
|
+
.velu-theme-toggle__icon--moon {
|
|
75
|
+
transform: rotate(-90deg) scale(0.4);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/* Exactly one glyph is shown — the sun in light, the moon in dark — at full
|
|
79
|
+
size, upright. Higher specificity than the hidden defaults above, so it
|
|
80
|
+
wins for whichever glyph the active theme selects. */
|
|
81
|
+
:root:not([data-theme='dark']) .velu-theme-toggle__icon--sun,
|
|
82
|
+
[data-theme='dark'] .velu-theme-toggle__icon--moon {
|
|
83
|
+
opacity: 1;
|
|
84
|
+
transform: rotate(0deg) scale(1);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/* Honour reduced-motion: keep a plain crossfade — no spin, scale, or press. */
|
|
88
|
+
@media (prefers-reduced-motion: reduce) {
|
|
89
|
+
.velu-theme-toggle {
|
|
90
|
+
transition: border-color 0.12s ease, background 0.12s ease;
|
|
91
|
+
}
|
|
92
|
+
.velu-theme-toggle:active {
|
|
93
|
+
transform: none;
|
|
94
|
+
}
|
|
95
|
+
.velu-theme-toggle__icon {
|
|
96
|
+
transition: opacity 0.2s ease;
|
|
97
|
+
}
|
|
98
|
+
.velu-theme-toggle__icon--sun,
|
|
99
|
+
.velu-theme-toggle__icon--moon {
|
|
100
|
+
transform: none;
|
|
101
|
+
}
|
|
102
|
+
}
|