@veluai/velu 0.2.25 → 0.2.28

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,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
+ }