@veluai/velu 0.1.13 → 0.1.14

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