@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,94 +1,94 @@
1
- /* AskBar — "ask a question" input card. All values are tokens;
2
- light/dark via [data-theme]. The component itself only owns the
3
- card visuals — the CONSUMER places it (the docs page pins it to the
4
- bottom of the scrolling article so content scrolls behind it). */
5
-
6
- /* Hidden at mobile widths — too crowded on a 375px column, and the
7
- header's Ask AI icon already opens the same chatbot. */
8
- @container docs (max-width: 640px) {
9
- .velu-ask-bar {
10
- display: none;
11
- }
12
- }
13
-
14
- .velu-ask-bar {
15
- /* `relative` establishes the containing block for the absolute send
16
- button. Actual page placement (absolute / sticky / fixed) is set
17
- by the consumer. */
18
- position: relative;
19
- z-index: 20;
20
- background: var(--page-bg);
21
- border: var(--border-width) solid var(--border-color);
22
- border-radius: var(--radius-md);
23
- /* Soft lift so it reads as floating above the scrolling article. */
24
- box-shadow:
25
- 0 var(--s-1) var(--s1) color-mix(in srgb, #000 14%, transparent),
26
- 0 0 var(--s0) color-mix(in srgb, #000 6%, transparent);
27
- transition:
28
- border-color 0.15s ease,
29
- box-shadow 0.15s ease;
30
- }
31
-
32
- /* Cursor in the input → accent border + accent glow ring. */
33
- .velu-ask-bar:focus-within {
34
- border-color: var(--accent-color);
35
- box-shadow:
36
- 0 0 0 var(--border-width) var(--accent-color),
37
- 0 0 var(--s1) color-mix(in srgb, var(--accent-color) 40%, transparent);
38
- }
39
-
40
- /* Multi-line input. padding-inline-end clears the send button so typed
41
- text never runs under it. */
42
- .velu-ask-bar__input {
43
- display: block;
44
- inline-size: 100%;
45
- box-sizing: border-box;
46
- padding: var(--s0);
47
- padding-inline-end: calc(var(--s0) + 2.5em);
48
- border: 0;
49
- background: transparent;
50
- resize: none;
51
- font: inherit;
52
- font-size: var(--f-body);
53
- line-height: var(--lh-body);
54
- color: var(--text-color);
55
- }
56
- .velu-ask-bar__input:focus {
57
- outline: none;
58
- }
59
- .velu-ask-bar__input::placeholder {
60
- color: var(--muted-color);
61
- }
62
-
63
- /* Circular accent send button, pinned to the bottom-inline-end corner. */
64
- .velu-ask-bar__send {
65
- position: absolute;
66
- inset-block-end: var(--s-1);
67
- inset-inline-end: var(--s-1);
68
- display: inline-flex;
69
- align-items: center;
70
- justify-content: center;
71
- inline-size: 2.5em;
72
- block-size: 2.5em;
73
- padding: 0;
74
- border: 0;
75
- border-radius: 50%;
76
- background: var(--accent-color);
77
- color: #fff;
78
- cursor: pointer;
79
- }
80
- .velu-ask-bar__send:hover {
81
- background: color-mix(in srgb, var(--accent-color) 88%, #000);
82
- }
83
- .velu-ask-bar__send:focus-visible {
84
- outline: var(--border-width) solid var(--text-color);
85
- outline-offset: 2px;
86
- }
87
- /* Disabled (input empty) — a dimmed accent (still in the brand
88
- palette) so the button reads as "not yet ready" rather than a
89
- different control entirely. No pointer events / hover affordance. */
90
- .velu-ask-bar__send:disabled {
91
- background: color-mix(in srgb, var(--accent-color) 35%, transparent);
92
- cursor: not-allowed;
93
- pointer-events: none;
94
- }
1
+ /* AskBar — "ask a question" input card. All values are tokens;
2
+ light/dark via [data-theme]. The component itself only owns the
3
+ card visuals — the CONSUMER places it (the docs page pins it to the
4
+ bottom of the scrolling article so content scrolls behind it). */
5
+
6
+ /* Hidden at mobile widths — too crowded on a 375px column, and the
7
+ header's Ask AI icon already opens the same chatbot. */
8
+ @container docs (max-width: 640px) {
9
+ .velu-ask-bar {
10
+ display: none;
11
+ }
12
+ }
13
+
14
+ .velu-ask-bar {
15
+ /* `relative` establishes the containing block for the absolute send
16
+ button. Actual page placement (absolute / sticky / fixed) is set
17
+ by the consumer. */
18
+ position: relative;
19
+ z-index: 20;
20
+ background: var(--page-bg);
21
+ border: var(--border-width) solid var(--border-color);
22
+ border-radius: var(--radius-md);
23
+ /* Soft lift so it reads as floating above the scrolling article. */
24
+ box-shadow:
25
+ 0 var(--s-1) var(--s1) color-mix(in srgb, #000 14%, transparent),
26
+ 0 0 var(--s0) color-mix(in srgb, #000 6%, transparent);
27
+ transition:
28
+ border-color 0.15s ease,
29
+ box-shadow 0.15s ease;
30
+ }
31
+
32
+ /* Cursor in the input → accent border + accent glow ring. */
33
+ .velu-ask-bar:focus-within {
34
+ border-color: var(--accent-color);
35
+ box-shadow:
36
+ 0 0 0 var(--border-width) var(--accent-color),
37
+ 0 0 var(--s1) color-mix(in srgb, var(--accent-color) 40%, transparent);
38
+ }
39
+
40
+ /* Multi-line input. padding-inline-end clears the send button so typed
41
+ text never runs under it. */
42
+ .velu-ask-bar__input {
43
+ display: block;
44
+ inline-size: 100%;
45
+ box-sizing: border-box;
46
+ padding: var(--s0);
47
+ padding-inline-end: calc(var(--s0) + 2.5em);
48
+ border: 0;
49
+ background: transparent;
50
+ resize: none;
51
+ font: inherit;
52
+ font-size: var(--f-body);
53
+ line-height: var(--lh-body);
54
+ color: var(--text-color);
55
+ }
56
+ .velu-ask-bar__input:focus {
57
+ outline: none;
58
+ }
59
+ .velu-ask-bar__input::placeholder {
60
+ color: var(--muted-color);
61
+ }
62
+
63
+ /* Circular accent send button, pinned to the bottom-inline-end corner. */
64
+ .velu-ask-bar__send {
65
+ position: absolute;
66
+ inset-block-end: var(--s-1);
67
+ inset-inline-end: var(--s-1);
68
+ display: inline-flex;
69
+ align-items: center;
70
+ justify-content: center;
71
+ inline-size: 2.5em;
72
+ block-size: 2.5em;
73
+ padding: 0;
74
+ border: 0;
75
+ border-radius: 50%;
76
+ background: var(--accent-color);
77
+ color: #fff;
78
+ cursor: pointer;
79
+ }
80
+ .velu-ask-bar__send:hover {
81
+ background: color-mix(in srgb, var(--accent-color) 88%, #000);
82
+ }
83
+ .velu-ask-bar__send:focus-visible {
84
+ outline: var(--border-width) solid var(--text-color);
85
+ outline-offset: 2px;
86
+ }
87
+ /* Disabled (input empty) — a dimmed accent (still in the brand
88
+ palette) so the button reads as "not yet ready" rather than a
89
+ different control entirely. No pointer events / hover affordance. */
90
+ .velu-ask-bar__send:disabled {
91
+ background: color-mix(in srgb, var(--accent-color) 35%, transparent);
92
+ cursor: not-allowed;
93
+ pointer-events: none;
94
+ }
@@ -1,105 +1,105 @@
1
- /* Card — all values tokens; light/dark via [data-theme]. Selectors required
2
- (cta hover, image clip, group grid) so this has CSS. Namespaced. */
3
-
4
- .velu-card {
5
- display: flex;
6
- flex-direction: column;
7
- border: var(--border-width) solid var(--border-color);
8
- border-radius: var(--radius-md);
9
- overflow: hidden; /* clips the image to the rounded corners */
10
- background: var(--page-bg);
11
- color: var(--text-color);
12
- text-decoration: none;
13
- }
14
-
15
- /* CTA card: the whole card is the click target (stretched-link pattern —
16
- the CTA stays the single real <a>; a ::after overlay makes the entire
17
- card clickable, valid + accessible, no JS). Hover highlights border+CTA. */
18
- .velu-card--cta {
19
- position: relative;
20
- cursor: pointer;
21
- transition: border-color 0.15s ease;
22
- }
23
- .velu-card--cta .velu-card__cta::after {
24
- content: '';
25
- position: absolute;
26
- inset: 0;
27
- }
28
- .velu-card--cta:hover {
29
- border-color: var(--accent-color);
30
- }
31
- .velu-card--cta:hover .velu-card__cta {
32
- color: var(--accent-color);
33
- }
34
-
35
- .velu-card__body {
36
- display: flex;
37
- flex-direction: column;
38
- gap: var(--s-2);
39
- padding: var(--s0) var(--s3);
40
- }
41
- .velu-card--horizontal .velu-card__body {
42
- flex-direction: row;
43
- align-items: center; /* icon vertically centered against the content */
44
- gap: var(--s0);
45
- }
46
- .velu-card__content {
47
- display: flex;
48
- flex-direction: column;
49
- gap: var(--s-2);
50
- min-width: 0;
51
- }
52
-
53
- .velu-card__icon {
54
- display: inline-flex;
55
- flex: none;
56
- align-items: center;
57
- inline-size: var(--f-h2);
58
- block-size: var(--f-h2);
59
- color: var(--accent-color);
60
- font-size: var(--f-h2);
61
- }
62
- .velu-card__title {
63
- font-size: var(--f-h4);
64
- line-height: var(--lh-h4);
65
- font-weight: 500;
66
- }
67
- .velu-card__text {
68
- font-size: var(--f-body);
69
- line-height: var(--lh-body);
70
- }
71
- .velu-card__cta {
72
- display: inline-flex;
73
- align-items: center;
74
- gap: var(--s-3);
75
- margin-block-start: var(--s-2);
76
- font-weight: 500;
77
- color: var(--text-color);
78
- text-decoration: none;
79
- cursor: pointer;
80
- width: fit-content; /* only the link itself is the click target */
81
- transition: color 0.15s ease;
82
- }
83
- .velu-card__cta:hover {
84
- color: var(--accent-color);
85
- }
86
- .velu-card__cta-icon {
87
- display: inline-flex;
88
- flex: none;
89
- }
90
-
91
- .velu-card__media {
92
- display: block;
93
- }
94
- .velu-card__media img {
95
- display: block;
96
- inline-size: 100%;
97
- block-size: auto;
98
- object-fit: cover;
99
- }
100
-
101
- /* CardGroup layout is the Switcher primitive (composed in Card.jsx). Its
102
- threshold is computed count-aware in Card.jsx so the row flips to a full
103
- vertical stack the moment any one card would fall below --card-min — true
104
- Switcher behaviour (all-or-nothing), not multi-row wrap. No rule needed
105
- here; Switcher owns row↔column + gap via switcher.css. */
1
+ /* Card — all values tokens; light/dark via [data-theme]. Selectors required
2
+ (cta hover, image clip, group grid) so this has CSS. Namespaced. */
3
+
4
+ .velu-card {
5
+ display: flex;
6
+ flex-direction: column;
7
+ border: var(--border-width) solid var(--border-color);
8
+ border-radius: var(--radius-md);
9
+ overflow: hidden; /* clips the image to the rounded corners */
10
+ background: var(--page-bg);
11
+ color: var(--text-color);
12
+ text-decoration: none;
13
+ }
14
+
15
+ /* CTA card: the whole card is the click target (stretched-link pattern —
16
+ the CTA stays the single real <a>; a ::after overlay makes the entire
17
+ card clickable, valid + accessible, no JS). Hover highlights border+CTA. */
18
+ .velu-card--cta {
19
+ position: relative;
20
+ cursor: pointer;
21
+ transition: border-color 0.15s ease;
22
+ }
23
+ .velu-card--cta .velu-card__cta::after {
24
+ content: '';
25
+ position: absolute;
26
+ inset: 0;
27
+ }
28
+ .velu-card--cta:hover {
29
+ border-color: var(--accent-color);
30
+ }
31
+ .velu-card--cta:hover .velu-card__cta {
32
+ color: var(--accent-color);
33
+ }
34
+
35
+ .velu-card__body {
36
+ display: flex;
37
+ flex-direction: column;
38
+ gap: var(--s-2);
39
+ padding: var(--s0) var(--s3);
40
+ }
41
+ .velu-card--horizontal .velu-card__body {
42
+ flex-direction: row;
43
+ align-items: center; /* icon vertically centered against the content */
44
+ gap: var(--s0);
45
+ }
46
+ .velu-card__content {
47
+ display: flex;
48
+ flex-direction: column;
49
+ gap: var(--s-2);
50
+ min-width: 0;
51
+ }
52
+
53
+ .velu-card__icon {
54
+ display: inline-flex;
55
+ flex: none;
56
+ align-items: center;
57
+ inline-size: var(--f-h2);
58
+ block-size: var(--f-h2);
59
+ color: var(--accent-color);
60
+ font-size: var(--f-h2);
61
+ }
62
+ .velu-card__title {
63
+ font-size: var(--f-h4);
64
+ line-height: var(--lh-h4);
65
+ font-weight: 500;
66
+ }
67
+ .velu-card__text {
68
+ font-size: var(--f-body);
69
+ line-height: var(--lh-body);
70
+ }
71
+ .velu-card__cta {
72
+ display: inline-flex;
73
+ align-items: center;
74
+ gap: var(--s-3);
75
+ margin-block-start: var(--s-2);
76
+ font-weight: 500;
77
+ color: var(--text-color);
78
+ text-decoration: none;
79
+ cursor: pointer;
80
+ width: fit-content; /* only the link itself is the click target */
81
+ transition: color 0.15s ease;
82
+ }
83
+ .velu-card__cta:hover {
84
+ color: var(--accent-color);
85
+ }
86
+ .velu-card__cta-icon {
87
+ display: inline-flex;
88
+ flex: none;
89
+ }
90
+
91
+ .velu-card__media {
92
+ display: block;
93
+ }
94
+ .velu-card__media img {
95
+ display: block;
96
+ inline-size: 100%;
97
+ block-size: auto;
98
+ object-fit: cover;
99
+ }
100
+
101
+ /* CardGroup layout is the Switcher primitive (composed in Card.jsx). Its
102
+ threshold is computed count-aware in Card.jsx so the row flips to a full
103
+ vertical stack the moment any one card would fall below --card-min — true
104
+ Switcher behaviour (all-or-nothing), not multi-row wrap. No rule needed
105
+ here; Switcher owns row↔column + gap via switcher.css. */