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