@veluai/velu 0.1.13 → 0.1.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 (98) hide show
  1. package/README.md +80 -80
  2. package/dist/cli.js +21 -21
  3. package/package.json +3 -2
  4. package/runtime/velu-ui/components/Accordion.jsx +64 -64
  5. package/runtime/velu-ui/components/ApiClient.jsx +121 -121
  6. package/runtime/velu-ui/components/ApiField.jsx +87 -87
  7. package/runtime/velu-ui/components/ApiPath.jsx +63 -63
  8. package/runtime/velu-ui/components/ApiSidebar.jsx +122 -122
  9. package/runtime/velu-ui/components/AskBar.jsx +71 -71
  10. package/runtime/velu-ui/components/Callout.jsx +114 -114
  11. package/runtime/velu-ui/components/Card.jsx +131 -131
  12. package/runtime/velu-ui/components/Chatbot.jsx +596 -596
  13. package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
  14. package/runtime/velu-ui/components/Columns.jsx +56 -56
  15. package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
  16. package/runtime/velu-ui/components/Field.jsx +81 -81
  17. package/runtime/velu-ui/components/Image.jsx +163 -163
  18. package/runtime/velu-ui/components/Logo.jsx +31 -0
  19. package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
  20. package/runtime/velu-ui/components/NavSelect.jsx +108 -108
  21. package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
  22. package/runtime/velu-ui/components/PageFooter.jsx +145 -213
  23. package/runtime/velu-ui/components/PageHeader.jsx +422 -414
  24. package/runtime/velu-ui/components/PageNav.jsx +77 -77
  25. package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
  26. package/runtime/velu-ui/components/Prompt.jsx +115 -115
  27. package/runtime/velu-ui/components/Search.jsx +411 -366
  28. package/runtime/velu-ui/components/Sidebar.jsx +191 -191
  29. package/runtime/velu-ui/components/SocialLinks.jsx +90 -0
  30. package/runtime/velu-ui/components/Steps.jsx +65 -65
  31. package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
  32. package/runtime/velu-ui/components/Toc.jsx +537 -537
  33. package/runtime/velu-ui/components/TocBar.jsx +195 -195
  34. package/runtime/velu-ui/components/Tree.jsx +87 -87
  35. package/runtime/velu-ui/components/TryItBar.jsx +90 -90
  36. package/runtime/velu-ui/components/accordion.css +92 -92
  37. package/runtime/velu-ui/components/api.css +479 -479
  38. package/runtime/velu-ui/components/ask-bar.css +94 -94
  39. package/runtime/velu-ui/components/card.css +105 -105
  40. package/runtime/velu-ui/components/chatbot.css +617 -617
  41. package/runtime/velu-ui/components/code-block.css +263 -263
  42. package/runtime/velu-ui/components/docs-layout.css +784 -775
  43. package/runtime/velu-ui/components/field.css +82 -82
  44. package/runtime/velu-ui/components/image.css +237 -237
  45. package/runtime/velu-ui/components/nav-select.css +157 -157
  46. package/runtime/velu-ui/components/page-feedback.css +241 -241
  47. package/runtime/velu-ui/components/page-footer.css +130 -130
  48. package/runtime/velu-ui/components/page-header.css +557 -520
  49. package/runtime/velu-ui/components/page-nav.css +50 -50
  50. package/runtime/velu-ui/components/powered-by.css +86 -66
  51. package/runtime/velu-ui/components/prompt.css +99 -99
  52. package/runtime/velu-ui/components/search.css +307 -307
  53. package/runtime/velu-ui/components/sidebar.css +144 -144
  54. package/runtime/velu-ui/components/steps.css +77 -77
  55. package/runtime/velu-ui/components/theme-toggle.css +101 -101
  56. package/runtime/velu-ui/components/toc-bar.css +234 -234
  57. package/runtime/velu-ui/components/tree.css +49 -49
  58. package/runtime/velu-ui/index.js +48 -46
  59. package/runtime/velu-ui/lib/component-schemas.js +100 -100
  60. package/runtime/velu-ui/lib/copyText.js +64 -64
  61. package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
  62. package/runtime/velu-ui/lib/prism-langs.js +957 -957
  63. package/runtime/velu-ui/lib/prism-loader.js +74 -74
  64. package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
  65. package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
  66. package/runtime/velu-ui/mdx-components.jsx +105 -105
  67. package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
  68. package/runtime/velu-ui/primitives/Stack.jsx +63 -63
  69. package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
  70. package/runtime/velu-ui/primitives/stack.css +3 -3
  71. package/runtime/velu-ui/primitives/switcher.css +25 -25
  72. package/runtime/velu-ui/styles.css +43 -43
  73. package/runtime/velu-ui/tokens.css +4 -4
  74. package/schema/velu.schema.json +281 -167
  75. package/src/lib/extract-mdx-error.js +170 -170
  76. package/src/lib/issues.js +159 -159
  77. package/src/lib/known-components.js +34 -34
  78. package/src/navigation.js +434 -434
  79. package/src/runtime/App.jsx +1506 -1476
  80. package/src/runtime/ErrorBoundary.jsx +54 -54
  81. package/src/runtime/client-entry.jsx +22 -22
  82. package/src/runtime/server-entry.jsx +16 -16
  83. package/src/template.html +48 -48
  84. package/templates/starter/ai-tools/claude-code.mdx +26 -26
  85. package/templates/starter/ai-tools/cursor.mdx +17 -17
  86. package/templates/starter/api-reference/endpoint/create.mdx +24 -24
  87. package/templates/starter/api-reference/endpoint/get.mdx +27 -27
  88. package/templates/starter/api-reference/introduction.mdx +28 -28
  89. package/templates/starter/development.mdx +19 -19
  90. package/templates/starter/essentials/code.mdx +29 -29
  91. package/templates/starter/essentials/images.mdx +29 -29
  92. package/templates/starter/essentials/markdown.mdx +25 -25
  93. package/templates/starter/essentials/navigation.mdx +39 -39
  94. package/templates/starter/essentials/settings.mdx +30 -30
  95. package/templates/starter/favicon.svg +6 -6
  96. package/templates/starter/index.mdx +31 -31
  97. package/templates/starter/quickstart.mdx +31 -31
  98. package/templates/starter/velu.json +33 -33
@@ -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. */