@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,50 +1,50 @@
1
- /* PageNav — previous/next page cards. The two-column / stacked layout
2
- is the <Switcher> primitive; this file owns only the card chrome.
3
- All values are tokens; light/dark via [data-theme]. */
4
-
5
- .velu-pagenav__card {
6
- display: flex;
7
- flex-direction: column;
8
- gap: var(--s-3);
9
- min-inline-size: 0;
10
- padding: var(--s0);
11
- background: var(--page-bg);
12
- border: var(--border-width) solid var(--border-color);
13
- border-radius: var(--radius-md);
14
- color: var(--text-color);
15
- text-decoration: none;
16
- transition: border-color 0.12s ease;
17
- }
18
- .velu-pagenav__card:hover {
19
- border-color: var(--accent-color);
20
- }
21
-
22
- /* Previous hugs the inline start, Next the inline end. */
23
- .velu-pagenav__card--prev {
24
- align-items: flex-start;
25
- text-align: start;
26
- }
27
- .velu-pagenav__card--next {
28
- align-items: flex-end;
29
- text-align: end;
30
- }
31
-
32
- .velu-pagenav__title {
33
- font-size: var(--f-h5);
34
- line-height: var(--lh-h5);
35
- font-weight: var(--weight-medium);
36
- color: var(--text-color);
37
- }
38
-
39
- /* "‹ Previous" / "Next ›" — muted, turns accent on card hover. */
40
- .velu-pagenav__dir {
41
- font-size: var(--f-h6);
42
- color: var(--muted-color);
43
- transition: color 0.12s ease;
44
- }
45
- .velu-pagenav__dir svg {
46
- flex: none;
47
- }
48
- .velu-pagenav__card:hover .velu-pagenav__dir {
49
- color: var(--accent-color);
50
- }
1
+ /* PageNav — previous/next page cards. The two-column / stacked layout
2
+ is the <Switcher> primitive; this file owns only the card chrome.
3
+ All values are tokens; light/dark via [data-theme]. */
4
+
5
+ .velu-pagenav__card {
6
+ display: flex;
7
+ flex-direction: column;
8
+ gap: var(--s-3);
9
+ min-inline-size: 0;
10
+ padding: var(--s0);
11
+ background: var(--page-bg);
12
+ border: var(--border-width) solid var(--border-color);
13
+ border-radius: var(--radius-md);
14
+ color: var(--text-color);
15
+ text-decoration: none;
16
+ transition: border-color 0.12s ease;
17
+ }
18
+ .velu-pagenav__card:hover {
19
+ border-color: var(--accent-color);
20
+ }
21
+
22
+ /* Previous hugs the inline start, Next the inline end. */
23
+ .velu-pagenav__card--prev {
24
+ align-items: flex-start;
25
+ text-align: start;
26
+ }
27
+ .velu-pagenav__card--next {
28
+ align-items: flex-end;
29
+ text-align: end;
30
+ }
31
+
32
+ .velu-pagenav__title {
33
+ font-size: var(--f-h5);
34
+ line-height: var(--lh-h5);
35
+ font-weight: var(--weight-medium);
36
+ color: var(--text-color);
37
+ }
38
+
39
+ /* "‹ Previous" / "Next ›" — muted, turns accent on card hover. */
40
+ .velu-pagenav__dir {
41
+ font-size: var(--f-h6);
42
+ color: var(--muted-color);
43
+ transition: color 0.12s ease;
44
+ }
45
+ .velu-pagenav__dir svg {
46
+ flex: none;
47
+ }
48
+ .velu-pagenav__card:hover .velu-pagenav__dir {
49
+ color: var(--accent-color);
50
+ }
@@ -1,66 +1,86 @@
1
- /* PoweredBy — "Powered by Velu" badge, right-aligned. Sits above the
2
- site footer. All values are tokens; light/dark via [data-theme]. */
3
-
4
- .velu-powered-by {
5
- display: flex;
6
- justify-content: flex-end;
7
- /* 32px gap above (to the previous element usually the AskBar) and
8
- 32px gap below (to the site footer). Margins, not padding, so the
9
- gap is OUTSIDE the badge — i.e. it's the actual whitespace the
10
- reader sees rather than a tap-target buffer. */
11
- margin-block-start: 2rem;
12
- margin-block-end: 2rem;
13
- padding-block: 0;
14
- padding-inline: var(--s3);
15
- }
16
-
17
- .velu-powered-by__link {
18
- display: inline-flex;
19
- align-items: center;
20
- /* Gap here is only between the "Powered by" label and the brand
21
- sub-cluster — the mark↔wordmark spacing is set tighter inside
22
- .velu-powered-by__brand. */
23
- gap: var(--s-3);
24
- text-decoration: none;
25
- color: var(--text-color);
26
- font-size: var(--f-h6);
27
- transition: opacity 0.12s ease;
28
- }
29
- .velu-powered-by__link:hover {
30
- opacity: 0.78;
31
- }
32
-
33
- .velu-powered-by__label {
34
- color: var(--muted-color);
35
- font-weight: var(--weight-normal);
36
- }
37
-
38
- /* Mark + wordmark form one visual unit ("Velu" the brand) — tighter
39
- gap than the label↔brand spacing above. */
40
- .velu-powered-by__brand {
41
- display: inline-flex;
42
- align-items: center;
43
- gap: var(--s-5);
44
- }
45
-
46
- /* Mark: same 32×24 ratio as the brand mark, sized one modular step up
47
- from body text so it reads at the same scale as the wordmark beside
48
- it. Muted (not accent) here so the badge sits quietly as an
49
- attribution rather than a brand statement. */
50
- .velu-powered-by__mark {
51
- flex: none;
52
- inline-size: calc(var(--icon-size-lg) * (32 / 24));
53
- block-size: var(--icon-size-lg);
54
- color: var(--muted-color);
55
- }
56
-
57
- .velu-powered-by__wordmark {
58
- font-family: var(--font-brand);
59
- font-weight: var(--weight-light);
60
- font-size: var(--f-h4);
61
- line-height: 1;
62
- letter-spacing: -0.01em;
63
- /* Muted to match the mark — the whole badge is a single tonal
64
- attribution. */
65
- color: var(--muted-color);
66
- }
1
+ /* PoweredBy — "Powered by Velu" badge, right-aligned. Sits above the
2
+ site footer. All values are tokens; light/dark via [data-theme]. */
3
+
4
+ /* Content foot — social icons (left) + the "Powered by" badge (right) in one
5
+ row. Shown at the base of the article column when the footer has no link
6
+ columns (so there's no full footer section). The row owns the vertical
7
+ rhythm; the nested badge drops its own standalone margins. */
8
+ .velu-content-foot {
9
+ display: flex;
10
+ align-items: center;
11
+ justify-content: space-between;
12
+ gap: var(--s2);
13
+ margin-block: 2rem;
14
+ padding-inline: var(--s3);
15
+ }
16
+ .velu-content-foot .velu-powered-by {
17
+ margin: 0;
18
+ padding: 0;
19
+ }
20
+ .velu-content-foot .velu-social {
21
+ color: var(--muted-color);
22
+ }
23
+
24
+ .velu-powered-by {
25
+ display: flex;
26
+ justify-content: flex-end;
27
+ /* 32px gap above (to the previous element — usually the AskBar) and
28
+ 32px gap below (to the site footer). Margins, not padding, so the
29
+ gap is OUTSIDE the badge — i.e. it's the actual whitespace the
30
+ reader sees rather than a tap-target buffer. */
31
+ margin-block-start: 2rem;
32
+ margin-block-end: 2rem;
33
+ padding-block: 0;
34
+ padding-inline: var(--s3);
35
+ }
36
+
37
+ .velu-powered-by__link {
38
+ display: inline-flex;
39
+ align-items: center;
40
+ /* Gap here is only between the "Powered by" label and the brand
41
+ sub-cluster — the mark↔wordmark spacing is set tighter inside
42
+ .velu-powered-by__brand. */
43
+ gap: var(--s-3);
44
+ text-decoration: none;
45
+ color: var(--text-color);
46
+ font-size: var(--f-h6);
47
+ transition: opacity 0.12s ease;
48
+ }
49
+ .velu-powered-by__link:hover {
50
+ opacity: 0.78;
51
+ }
52
+
53
+ .velu-powered-by__label {
54
+ color: var(--muted-color);
55
+ font-weight: var(--weight-normal);
56
+ }
57
+
58
+ /* Mark + wordmark form one visual unit ("Velu" the brand) — tighter
59
+ gap than the label↔brand spacing above. */
60
+ .velu-powered-by__brand {
61
+ display: inline-flex;
62
+ align-items: center;
63
+ gap: var(--s-5);
64
+ }
65
+
66
+ /* Mark: same 32×24 ratio as the brand mark, sized one modular step up
67
+ from body text so it reads at the same scale as the wordmark beside
68
+ it. Muted (not accent) here so the badge sits quietly as an
69
+ attribution rather than a brand statement. */
70
+ .velu-powered-by__mark {
71
+ flex: none;
72
+ inline-size: calc(var(--icon-size-lg) * (32 / 24));
73
+ block-size: var(--icon-size-lg);
74
+ color: var(--muted-color);
75
+ }
76
+
77
+ .velu-powered-by__wordmark {
78
+ font-family: var(--font-brand);
79
+ font-weight: var(--weight-light);
80
+ font-size: var(--f-h4);
81
+ line-height: 1;
82
+ letter-spacing: -0.01em;
83
+ /* Muted to match the mark — the whole badge is a single tonal
84
+ attribution. */
85
+ color: var(--muted-color);
86
+ }
@@ -1,99 +1,99 @@
1
- /* Prompt — surface card with title, monospace truncated body, and a
2
- solid accent "Copy Prompt" button. All values are tokens; light /
3
- dark auto via [data-theme] since the surface, text, and accent vars
4
- all switch. */
5
-
6
- .velu-prompt {
7
- background: var(--surface-color);
8
- border: var(--border-width) solid var(--border-color);
9
- border-radius: var(--radius-md);
10
- padding: var(--s2);
11
- color: var(--text-color);
12
- }
13
-
14
- .velu-prompt__title {
15
- font-size: var(--f-h4);
16
- line-height: var(--lh-h4);
17
- font-weight: var(--weight-medium);
18
- margin-block-end: var(--s1);
19
- }
20
-
21
- /* Truncated multi-line body. white-space:pre-wrap preserves the
22
- newlines / leading whitespace of the source prompt; -webkit-box +
23
- -webkit-line-clamp adds the auto ellipsis on the Nth line. The
24
- `lines` prop sets -webkit-line-clamp inline via React. */
25
- .velu-prompt__body {
26
- margin: 0;
27
- font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
28
- font-size: var(--f-h6);
29
- line-height: var(--lh-h6);
30
- white-space: pre-wrap;
31
- overflow-wrap: anywhere;
32
- display: -webkit-box;
33
- -webkit-box-orient: vertical;
34
- overflow: hidden;
35
- }
36
-
37
- /* Layout (flex + gap + justify-end) is provided by <Cluster>; this
38
- rule only owns the spacing FROM the body above. */
39
- .velu-prompt__actions {
40
- margin-block-start: var(--s1);
41
- }
42
-
43
- /* Accent-filled copy button — same visual weight as the CTA on Card,
44
- sized to read as the row's primary action. Hover dims the accent
45
- slightly via color-mix. */
46
- .velu-prompt__copy {
47
- display: inline-flex;
48
- align-items: center;
49
- gap: var(--s-2);
50
- padding-block: var(--s-6);
51
- padding-inline: var(--s-3);
52
- background: var(--accent-color);
53
- border: 0;
54
- border-radius: var(--radius-sm);
55
- color: #fff;
56
- font: inherit;
57
- font-size: var(--f-h6);
58
- line-height: var(--lh-h6);
59
- font-weight: var(--weight-medium);
60
- cursor: pointer;
61
- }
62
- .velu-prompt__copy:hover {
63
- background: color-mix(in srgb, var(--accent-color) 88%, #000);
64
- }
65
- .velu-prompt__copy:focus-visible {
66
- outline: var(--border-width) solid var(--text-color);
67
- outline-offset: 2px;
68
- }
69
-
70
- .velu-prompt__copy-icon {
71
- display: inline-flex;
72
- align-items: center;
73
- }
74
-
75
- /* Open in Cursor — same shape as copy, inverted neutral palette so it
76
- reads as the secondary action sitting next to the accent primary.
77
- Inherits the cursor brand glyph color via `currentColor`. */
78
- .velu-prompt__open-cursor {
79
- display: inline-flex;
80
- align-items: center;
81
- gap: var(--s-2);
82
- padding-block: var(--s-6);
83
- padding-inline: var(--s-3);
84
- background: var(--text-color);
85
- color: var(--page-bg);
86
- border-radius: var(--radius-sm);
87
- font: inherit;
88
- font-size: var(--f-h6);
89
- line-height: var(--lh-h6);
90
- font-weight: var(--weight-medium);
91
- text-decoration: none;
92
- }
93
- .velu-prompt__open-cursor:hover {
94
- background: color-mix(in srgb, var(--text-color) 88%, var(--accent-color));
95
- }
96
- .velu-prompt__open-cursor:focus-visible {
97
- outline: var(--border-width) solid var(--accent-color);
98
- outline-offset: 2px;
99
- }
1
+ /* Prompt — surface card with title, monospace truncated body, and a
2
+ solid accent "Copy Prompt" button. All values are tokens; light /
3
+ dark auto via [data-theme] since the surface, text, and accent vars
4
+ all switch. */
5
+
6
+ .velu-prompt {
7
+ background: var(--surface-color);
8
+ border: var(--border-width) solid var(--border-color);
9
+ border-radius: var(--radius-md);
10
+ padding: var(--s2);
11
+ color: var(--text-color);
12
+ }
13
+
14
+ .velu-prompt__title {
15
+ font-size: var(--f-h4);
16
+ line-height: var(--lh-h4);
17
+ font-weight: var(--weight-medium);
18
+ margin-block-end: var(--s1);
19
+ }
20
+
21
+ /* Truncated multi-line body. white-space:pre-wrap preserves the
22
+ newlines / leading whitespace of the source prompt; -webkit-box +
23
+ -webkit-line-clamp adds the auto ellipsis on the Nth line. The
24
+ `lines` prop sets -webkit-line-clamp inline via React. */
25
+ .velu-prompt__body {
26
+ margin: 0;
27
+ font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
28
+ font-size: var(--f-h6);
29
+ line-height: var(--lh-h6);
30
+ white-space: pre-wrap;
31
+ overflow-wrap: anywhere;
32
+ display: -webkit-box;
33
+ -webkit-box-orient: vertical;
34
+ overflow: hidden;
35
+ }
36
+
37
+ /* Layout (flex + gap + justify-end) is provided by <Cluster>; this
38
+ rule only owns the spacing FROM the body above. */
39
+ .velu-prompt__actions {
40
+ margin-block-start: var(--s1);
41
+ }
42
+
43
+ /* Accent-filled copy button — same visual weight as the CTA on Card,
44
+ sized to read as the row's primary action. Hover dims the accent
45
+ slightly via color-mix. */
46
+ .velu-prompt__copy {
47
+ display: inline-flex;
48
+ align-items: center;
49
+ gap: var(--s-2);
50
+ padding-block: var(--s-6);
51
+ padding-inline: var(--s-3);
52
+ background: var(--accent-color);
53
+ border: 0;
54
+ border-radius: var(--radius-sm);
55
+ color: #fff;
56
+ font: inherit;
57
+ font-size: var(--f-h6);
58
+ line-height: var(--lh-h6);
59
+ font-weight: var(--weight-medium);
60
+ cursor: pointer;
61
+ }
62
+ .velu-prompt__copy:hover {
63
+ background: color-mix(in srgb, var(--accent-color) 88%, #000);
64
+ }
65
+ .velu-prompt__copy:focus-visible {
66
+ outline: var(--border-width) solid var(--text-color);
67
+ outline-offset: 2px;
68
+ }
69
+
70
+ .velu-prompt__copy-icon {
71
+ display: inline-flex;
72
+ align-items: center;
73
+ }
74
+
75
+ /* Open in Cursor — same shape as copy, inverted neutral palette so it
76
+ reads as the secondary action sitting next to the accent primary.
77
+ Inherits the cursor brand glyph color via `currentColor`. */
78
+ .velu-prompt__open-cursor {
79
+ display: inline-flex;
80
+ align-items: center;
81
+ gap: var(--s-2);
82
+ padding-block: var(--s-6);
83
+ padding-inline: var(--s-3);
84
+ background: var(--text-color);
85
+ color: var(--page-bg);
86
+ border-radius: var(--radius-sm);
87
+ font: inherit;
88
+ font-size: var(--f-h6);
89
+ line-height: var(--lh-h6);
90
+ font-weight: var(--weight-medium);
91
+ text-decoration: none;
92
+ }
93
+ .velu-prompt__open-cursor:hover {
94
+ background: color-mix(in srgb, var(--text-color) 88%, var(--accent-color));
95
+ }
96
+ .velu-prompt__open-cursor:focus-visible {
97
+ outline: var(--border-width) solid var(--accent-color);
98
+ outline-offset: 2px;
99
+ }