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