@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,130 +1,130 @@
|
|
|
1
|
-
/* PageFooter β docs site footer. Vertical rhythm + columns / socials
|
|
2
|
-
are composed from Stack / Switcher / Cluster primitives in the JSX;
|
|
3
|
-
this file owns only chrome (typography, link colors, icon sizing).
|
|
4
|
-
Light / dark via [data-theme] via the velu-ui tokens. */
|
|
5
|
-
|
|
6
|
-
.velu-footer {
|
|
7
|
-
padding-block: var(--s2);
|
|
8
|
-
padding-inline: var(--s3);
|
|
9
|
-
/* Matches the header β same subtle hairline (--surface-color
|
|
10
|
-
resolves to #f2f3f4 in light / #323334 in dark). */
|
|
11
|
-
border-block-start: var(--border-width) solid var(--surface-color);
|
|
12
|
-
color: var(--text-color);
|
|
13
|
-
/* Opaque so the footer visually eclipses the fixed sidebar / TOC
|
|
14
|
-
when the page scrolls into it (DocsPage gives the footer a higher
|
|
15
|
-
z-index than the asides). */
|
|
16
|
-
background: var(--page-bg);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
/* ββ Container β wraps the brand row + columns row, centered in the
|
|
20
|
-
footer. fit-content sizes it to the wider of the two rows; margin
|
|
21
|
-
auto centers that block within the footer's padding box. */
|
|
22
|
-
.velu-footer__container {
|
|
23
|
-
inline-size: fit-content;
|
|
24
|
-
max-inline-size: 100%;
|
|
25
|
-
margin-inline: auto;
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
/* Columns row β flex-wrap with split gaps. column-gap is fluid via
|
|
29
|
-
clamp(): scales with viewport width between a floor (--s4) and a
|
|
30
|
-
ceiling (calc(var(--s5) * 7)) so it shrinks gracefully on narrow
|
|
31
|
-
screens. row-gap is small (used only when columns wrap onto a new
|
|
32
|
-
line). */
|
|
33
|
-
.velu-footer__row--columns {
|
|
34
|
-
display: flex;
|
|
35
|
-
flex-wrap: wrap;
|
|
36
|
-
align-items: flex-start;
|
|
37
|
-
column-gap: clamp(var(--s4), 12vw, calc(var(--s5) * 7));
|
|
38
|
-
row-gap: var(--s2);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/* ββ Brand row ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
42
|
-
/* Brand sits on its own row, hugged to the inline-start (align-self:
|
|
43
|
-
flex-start stops the outer column-Stack from stretching it across
|
|
44
|
-
the full row width). */
|
|
45
|
-
.velu-footer__brand,
|
|
46
|
-
.velu-footer__brand-link {
|
|
47
|
-
align-self: flex-start;
|
|
48
|
-
color: var(--text-color);
|
|
49
|
-
}
|
|
50
|
-
.velu-footer__brand-link {
|
|
51
|
-
text-decoration: none;
|
|
52
|
-
color: inherit;
|
|
53
|
-
}
|
|
54
|
-
.velu-footer__mark {
|
|
55
|
-
flex: none;
|
|
56
|
-
inline-size: calc(var(--icon-size-lg) * (32 / 24));
|
|
57
|
-
block-size: var(--icon-size-lg);
|
|
58
|
-
color: var(--accent-color);
|
|
59
|
-
}
|
|
60
|
-
/* Outfit Light, per the brand spec β falls back to --font-sans. */
|
|
61
|
-
.velu-footer__wordmark {
|
|
62
|
-
font-family: var(--font-brand);
|
|
63
|
-
font-weight: var(--weight-light);
|
|
64
|
-
font-size: var(--f-h4);
|
|
65
|
-
line-height: 1;
|
|
66
|
-
letter-spacing: -0.01em;
|
|
67
|
-
color: var(--text-color);
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
/* ββ Link columns βββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
71
|
-
.velu-footer__column-title {
|
|
72
|
-
font-size: var(--f-h6);
|
|
73
|
-
font-weight: var(--weight-medium);
|
|
74
|
-
color: var(--text-color);
|
|
75
|
-
}
|
|
76
|
-
.velu-footer__list {
|
|
77
|
-
list-style: none;
|
|
78
|
-
margin: 0;
|
|
79
|
-
padding: 0;
|
|
80
|
-
}
|
|
81
|
-
/* Footer text is always full-contrast (--text-color) β no muted greys.
|
|
82
|
-
Links shift to the accent color on hover; no underline.
|
|
83
|
-
line-height: 1.4 overrides the body's 1.75 so menu links don't sit
|
|
84
|
-
in a tall box (kept the columns from looking spread out). */
|
|
85
|
-
.velu-footer__link {
|
|
86
|
-
display: inline-block;
|
|
87
|
-
font-size: var(--f-h6);
|
|
88
|
-
font-weight: var(--weight-light);
|
|
89
|
-
line-height: 1.4;
|
|
90
|
-
color: var(--text-color);
|
|
91
|
-
text-decoration: none;
|
|
92
|
-
transition: color 0.12s ease;
|
|
93
|
-
}
|
|
94
|
-
.velu-footer__link:hover {
|
|
95
|
-
color: var(--accent-color);
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
/* ββ Social row βββββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
99
|
-
/* 2em Γ 2em (32Γ32 at 16px base) buttons; the glyph fills ~1.25em so a
|
|
100
|
-
little breathing room remains around it. Each kind gets its OWN
|
|
101
|
-
brand color (set via the data-kind attribute below). Monochrome
|
|
102
|
-
brands (github, x) inherit --text-color so they theme correctly. */
|
|
103
|
-
.velu-social {
|
|
104
|
-
display: inline-flex;
|
|
105
|
-
align-items: center;
|
|
106
|
-
justify-content: center;
|
|
107
|
-
flex: none;
|
|
108
|
-
inline-size: 2em;
|
|
109
|
-
block-size: 2em;
|
|
110
|
-
padding: 0;
|
|
111
|
-
color: var(--text-color);
|
|
112
|
-
text-decoration: none;
|
|
113
|
-
transition: opacity 0.12s ease;
|
|
114
|
-
}
|
|
115
|
-
.velu-social:hover {
|
|
116
|
-
opacity: 0.78;
|
|
117
|
-
}
|
|
118
|
-
.velu-social svg {
|
|
119
|
-
inline-size: var(--icon-size-lg);
|
|
120
|
-
block-size: var(--icon-size-lg);
|
|
121
|
-
}
|
|
122
|
-
/* Brand colors β YouTube red, LinkedIn blue. GitHub + X stay
|
|
123
|
-
--text-color (their canonical brand is monochrome and follows the
|
|
124
|
-
surrounding theme). */
|
|
125
|
-
.velu-social[data-kind='youtube'] {
|
|
126
|
-
color: #ff0000;
|
|
127
|
-
}
|
|
128
|
-
.velu-social[data-kind='linkedin'] {
|
|
129
|
-
color: #0a66c2;
|
|
130
|
-
}
|
|
1
|
+
/* PageFooter β docs site footer. Vertical rhythm + columns / socials
|
|
2
|
+
are composed from Stack / Switcher / Cluster primitives in the JSX;
|
|
3
|
+
this file owns only chrome (typography, link colors, icon sizing).
|
|
4
|
+
Light / dark via [data-theme] via the velu-ui tokens. */
|
|
5
|
+
|
|
6
|
+
.velu-footer {
|
|
7
|
+
padding-block: var(--s2);
|
|
8
|
+
padding-inline: var(--s3);
|
|
9
|
+
/* Matches the header β same subtle hairline (--surface-color
|
|
10
|
+
resolves to #f2f3f4 in light / #323334 in dark). */
|
|
11
|
+
border-block-start: var(--border-width) solid var(--surface-color);
|
|
12
|
+
color: var(--text-color);
|
|
13
|
+
/* Opaque so the footer visually eclipses the fixed sidebar / TOC
|
|
14
|
+
when the page scrolls into it (DocsPage gives the footer a higher
|
|
15
|
+
z-index than the asides). */
|
|
16
|
+
background: var(--page-bg);
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/* ββ Container β wraps the brand row + columns row, centered in the
|
|
20
|
+
footer. fit-content sizes it to the wider of the two rows; margin
|
|
21
|
+
auto centers that block within the footer's padding box. */
|
|
22
|
+
.velu-footer__container {
|
|
23
|
+
inline-size: fit-content;
|
|
24
|
+
max-inline-size: 100%;
|
|
25
|
+
margin-inline: auto;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/* Columns row β flex-wrap with split gaps. column-gap is fluid via
|
|
29
|
+
clamp(): scales with viewport width between a floor (--s4) and a
|
|
30
|
+
ceiling (calc(var(--s5) * 7)) so it shrinks gracefully on narrow
|
|
31
|
+
screens. row-gap is small (used only when columns wrap onto a new
|
|
32
|
+
line). */
|
|
33
|
+
.velu-footer__row--columns {
|
|
34
|
+
display: flex;
|
|
35
|
+
flex-wrap: wrap;
|
|
36
|
+
align-items: flex-start;
|
|
37
|
+
column-gap: clamp(var(--s4), 12vw, calc(var(--s5) * 7));
|
|
38
|
+
row-gap: var(--s2);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/* ββ Brand row ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
42
|
+
/* Brand sits on its own row, hugged to the inline-start (align-self:
|
|
43
|
+
flex-start stops the outer column-Stack from stretching it across
|
|
44
|
+
the full row width). */
|
|
45
|
+
.velu-footer__brand,
|
|
46
|
+
.velu-footer__brand-link {
|
|
47
|
+
align-self: flex-start;
|
|
48
|
+
color: var(--text-color);
|
|
49
|
+
}
|
|
50
|
+
.velu-footer__brand-link {
|
|
51
|
+
text-decoration: none;
|
|
52
|
+
color: inherit;
|
|
53
|
+
}
|
|
54
|
+
.velu-footer__mark {
|
|
55
|
+
flex: none;
|
|
56
|
+
inline-size: calc(var(--icon-size-lg) * (32 / 24));
|
|
57
|
+
block-size: var(--icon-size-lg);
|
|
58
|
+
color: var(--accent-color);
|
|
59
|
+
}
|
|
60
|
+
/* Outfit Light, per the brand spec β falls back to --font-sans. */
|
|
61
|
+
.velu-footer__wordmark {
|
|
62
|
+
font-family: var(--font-brand);
|
|
63
|
+
font-weight: var(--weight-light);
|
|
64
|
+
font-size: var(--f-h4);
|
|
65
|
+
line-height: 1;
|
|
66
|
+
letter-spacing: -0.01em;
|
|
67
|
+
color: var(--text-color);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/* ββ Link columns βββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
71
|
+
.velu-footer__column-title {
|
|
72
|
+
font-size: var(--f-h6);
|
|
73
|
+
font-weight: var(--weight-medium);
|
|
74
|
+
color: var(--text-color);
|
|
75
|
+
}
|
|
76
|
+
.velu-footer__list {
|
|
77
|
+
list-style: none;
|
|
78
|
+
margin: 0;
|
|
79
|
+
padding: 0;
|
|
80
|
+
}
|
|
81
|
+
/* Footer text is always full-contrast (--text-color) β no muted greys.
|
|
82
|
+
Links shift to the accent color on hover; no underline.
|
|
83
|
+
line-height: 1.4 overrides the body's 1.75 so menu links don't sit
|
|
84
|
+
in a tall box (kept the columns from looking spread out). */
|
|
85
|
+
.velu-footer__link {
|
|
86
|
+
display: inline-block;
|
|
87
|
+
font-size: var(--f-h6);
|
|
88
|
+
font-weight: var(--weight-light);
|
|
89
|
+
line-height: 1.4;
|
|
90
|
+
color: var(--text-color);
|
|
91
|
+
text-decoration: none;
|
|
92
|
+
transition: color 0.12s ease;
|
|
93
|
+
}
|
|
94
|
+
.velu-footer__link:hover {
|
|
95
|
+
color: var(--accent-color);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/* ββ Social row βββββββββββββββββββββββββββββββββββββββββββββββββββββββ */
|
|
99
|
+
/* 2em Γ 2em (32Γ32 at 16px base) buttons; the glyph fills ~1.25em so a
|
|
100
|
+
little breathing room remains around it. Each kind gets its OWN
|
|
101
|
+
brand color (set via the data-kind attribute below). Monochrome
|
|
102
|
+
brands (github, x) inherit --text-color so they theme correctly. */
|
|
103
|
+
.velu-social {
|
|
104
|
+
display: inline-flex;
|
|
105
|
+
align-items: center;
|
|
106
|
+
justify-content: center;
|
|
107
|
+
flex: none;
|
|
108
|
+
inline-size: 2em;
|
|
109
|
+
block-size: 2em;
|
|
110
|
+
padding: 0;
|
|
111
|
+
color: var(--text-color);
|
|
112
|
+
text-decoration: none;
|
|
113
|
+
transition: opacity 0.12s ease;
|
|
114
|
+
}
|
|
115
|
+
.velu-social:hover {
|
|
116
|
+
opacity: 0.78;
|
|
117
|
+
}
|
|
118
|
+
.velu-social svg {
|
|
119
|
+
inline-size: var(--icon-size-lg);
|
|
120
|
+
block-size: var(--icon-size-lg);
|
|
121
|
+
}
|
|
122
|
+
/* Brand colors β YouTube red, LinkedIn blue. GitHub + X stay
|
|
123
|
+
--text-color (their canonical brand is monochrome and follows the
|
|
124
|
+
surrounding theme). */
|
|
125
|
+
.velu-social[data-kind='youtube'] {
|
|
126
|
+
color: #ff0000;
|
|
127
|
+
}
|
|
128
|
+
.velu-social[data-kind='linkedin'] {
|
|
129
|
+
color: #0a66c2;
|
|
130
|
+
}
|