@veluai/velu 0.2.25 → 0.2.28

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 (114) hide show
  1. package/README.md +80 -80
  2. package/dist/cli.js +44 -44
  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 +125 -125
  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/ChangelogFilters.jsx +75 -75
  16. package/runtime/velu-ui/components/Chatbot.jsx +972 -972
  17. package/runtime/velu-ui/components/CodeBlock.jsx +375 -375
  18. package/runtime/velu-ui/components/Columns.jsx +56 -56
  19. package/runtime/velu-ui/components/ContextMenu.jsx +327 -327
  20. package/runtime/velu-ui/components/ErrorCard.jsx +138 -138
  21. package/runtime/velu-ui/components/Field.jsx +81 -81
  22. package/runtime/velu-ui/components/Image.jsx +163 -163
  23. package/runtime/velu-ui/components/Logo.jsx +31 -31
  24. package/runtime/velu-ui/components/MethodBadge.jsx +31 -31
  25. package/runtime/velu-ui/components/NavSelect.jsx +108 -108
  26. package/runtime/velu-ui/components/NotFound.jsx +63 -63
  27. package/runtime/velu-ui/components/PageFeedback.jsx +219 -219
  28. package/runtime/velu-ui/components/PageFooter.jsx +145 -145
  29. package/runtime/velu-ui/components/PageHeader.jsx +422 -422
  30. package/runtime/velu-ui/components/PageNav.jsx +77 -77
  31. package/runtime/velu-ui/components/PoweredBy.jsx +51 -51
  32. package/runtime/velu-ui/components/Prompt.jsx +115 -115
  33. package/runtime/velu-ui/components/Search.jsx +460 -460
  34. package/runtime/velu-ui/components/Sidebar.jsx +246 -246
  35. package/runtime/velu-ui/components/SocialLinks.jsx +90 -90
  36. package/runtime/velu-ui/components/Steps.jsx +65 -65
  37. package/runtime/velu-ui/components/ThemeToggle.jsx +48 -48
  38. package/runtime/velu-ui/components/Toc.jsx +537 -537
  39. package/runtime/velu-ui/components/TocBar.jsx +195 -195
  40. package/runtime/velu-ui/components/Tree.jsx +87 -87
  41. package/runtime/velu-ui/components/TryItBar.jsx +102 -102
  42. package/runtime/velu-ui/components/Update.jsx +92 -92
  43. package/runtime/velu-ui/components/accordion.css +92 -92
  44. package/runtime/velu-ui/components/api-page.css +208 -208
  45. package/runtime/velu-ui/components/api.css +635 -635
  46. package/runtime/velu-ui/components/ask-bar.css +103 -103
  47. package/runtime/velu-ui/components/card.css +105 -105
  48. package/runtime/velu-ui/components/changelog-filters.css +43 -43
  49. package/runtime/velu-ui/components/chatbot.css +687 -687
  50. package/runtime/velu-ui/components/code-block.css +263 -263
  51. package/runtime/velu-ui/components/context-menu.css +199 -199
  52. package/runtime/velu-ui/components/docs-layout.css +822 -822
  53. package/runtime/velu-ui/components/field.css +82 -82
  54. package/runtime/velu-ui/components/image.css +237 -237
  55. package/runtime/velu-ui/components/nav-select.css +157 -157
  56. package/runtime/velu-ui/components/not-found.css +94 -94
  57. package/runtime/velu-ui/components/page-feedback.css +261 -261
  58. package/runtime/velu-ui/components/page-footer.css +130 -130
  59. package/runtime/velu-ui/components/page-header.css +558 -558
  60. package/runtime/velu-ui/components/page-nav.css +50 -50
  61. package/runtime/velu-ui/components/powered-by.css +92 -92
  62. package/runtime/velu-ui/components/prompt.css +99 -99
  63. package/runtime/velu-ui/components/search.css +307 -307
  64. package/runtime/velu-ui/components/sidebar.css +205 -205
  65. package/runtime/velu-ui/components/steps.css +77 -77
  66. package/runtime/velu-ui/components/theme-toggle.css +102 -102
  67. package/runtime/velu-ui/components/toc-bar.css +234 -234
  68. package/runtime/velu-ui/components/tree.css +49 -49
  69. package/runtime/velu-ui/components/update.css +111 -111
  70. package/runtime/velu-ui/index.js +58 -58
  71. package/runtime/velu-ui/lib/api-send.js +118 -118
  72. package/runtime/velu-ui/lib/brand-icons.jsx +103 -103
  73. package/runtime/velu-ui/lib/component-schemas.js +100 -100
  74. package/runtime/velu-ui/lib/copyText.js +64 -64
  75. package/runtime/velu-ui/lib/docs-assistant.js +273 -273
  76. package/runtime/velu-ui/lib/lang-icons.jsx +147 -147
  77. package/runtime/velu-ui/lib/page-feedback.js +72 -72
  78. package/runtime/velu-ui/lib/pagefind.js +116 -116
  79. package/runtime/velu-ui/lib/prism-langs.js +957 -957
  80. package/runtime/velu-ui/lib/prism-loader.js +74 -74
  81. package/runtime/velu-ui/lib/resolveIcon.jsx +29 -29
  82. package/runtime/velu-ui/lib/scrollIntoNearestView.js +66 -66
  83. package/runtime/velu-ui/mdx-components.jsx +107 -107
  84. package/runtime/velu-ui/primitives/Cluster.jsx +49 -49
  85. package/runtime/velu-ui/primitives/Stack.jsx +63 -63
  86. package/runtime/velu-ui/primitives/Switcher.jsx +57 -57
  87. package/runtime/velu-ui/primitives/stack.css +3 -3
  88. package/runtime/velu-ui/primitives/switcher.css +25 -25
  89. package/runtime/velu-ui/styles.css +48 -48
  90. package/runtime/velu-ui/tokens.css +4 -4
  91. package/schema/velu.schema.json +419 -419
  92. package/src/lib/extract-mdx-error.js +170 -170
  93. package/src/lib/issues.js +159 -159
  94. package/src/lib/known-components.js +35 -35
  95. package/src/navigation.js +459 -459
  96. package/src/runtime/App.jsx +1754 -1754
  97. package/src/runtime/ErrorBoundary.jsx +54 -54
  98. package/src/runtime/client-entry.jsx +27 -27
  99. package/src/runtime/server-entry.jsx +24 -24
  100. package/src/template.html +48 -48
  101. package/templates/starter/ai-tools/claude-code.mdx +26 -26
  102. package/templates/starter/ai-tools/cursor.mdx +17 -17
  103. package/templates/starter/api-reference/introduction.mdx +43 -43
  104. package/templates/starter/development.mdx +19 -19
  105. package/templates/starter/essentials/code.mdx +29 -29
  106. package/templates/starter/essentials/images.mdx +29 -29
  107. package/templates/starter/essentials/markdown.mdx +25 -25
  108. package/templates/starter/essentials/navigation.mdx +39 -39
  109. package/templates/starter/essentials/settings.mdx +30 -30
  110. package/templates/starter/favicon.svg +6 -6
  111. package/templates/starter/index.mdx +31 -31
  112. package/templates/starter/openapi.json +160 -160
  113. package/templates/starter/quickstart.mdx +31 -31
  114. package/templates/starter/velu.json +40 -40
@@ -1,87 +1,87 @@
1
- import React, { useId } from 'react';
2
- import Cluster from '../primitives/Cluster.jsx';
3
-
4
- /**
5
- * ApiField — an input-bearing field for the ApiClient playground.
6
- *
7
- * Distinct from <Field> (which is doc-only — it documents a parameter
8
- * but has no control). ApiField renders a real <input> the user types
9
- * a value into when trying an endpoint.
10
- *
11
- * <ApiSection title="Path">
12
- * <ApiField name="projectId" type="string" required>
13
- * Your project ID. Copy it from the API keys page.
14
- * </ApiField>
15
- * </ApiSection>
16
- *
17
- * Layout — a flex-wrap pair:
18
- * [ name + type + required ] [ prefix? input ]
19
- * [ description … ]
20
- * The info column (label + description) and the control column wrap
21
- * onto separate lines on narrow widths; no media queries.
22
- *
23
- * - `name` parameter identifier (mono, accent)
24
- * - `type` schema type → grey chip ("string", "boolean", …)
25
- * - `required` boolean → red "required" pill
26
- * - `default` pre-fills the input's value
27
- * - `prefix` static text shown inside the input before the field
28
- * (e.g. "Bearer" for an Authorization header)
29
- * - `placeholder` input placeholder (defaults to `enter <name>`)
30
- * - `value`/`onChange` optional controlled-input wiring; uncontrolled
31
- * otherwise
32
- * - `children` description block
33
- */
34
-
35
- export default function ApiField({
36
- name,
37
- type,
38
- required = false,
39
- default: defaultValue,
40
- prefix,
41
- placeholder,
42
- value,
43
- onChange,
44
- children,
45
- className = '',
46
- ...rest
47
- }) {
48
- const inputId = useId();
49
- const controlled = value !== undefined;
50
- return (
51
- <div className={`velu-api-field ${className}`.trim()} {...rest}>
52
- <div className="velu-api-field__info">
53
- <Cluster space="var(--s-1)" align="baseline">
54
- <label className="velu-api-field__name" htmlFor={inputId}>
55
- {name}
56
- </label>
57
- {type != null && (
58
- <span className="velu-api-field__chip">{type}</span>
59
- )}
60
- {required && (
61
- <span className="velu-api-field__required">required</span>
62
- )}
63
- </Cluster>
64
- {children != null && children !== false && (
65
- <div className="velu-api-field__desc">{children}</div>
66
- )}
67
- </div>
68
- <div className="velu-api-field__control">
69
- {prefix != null && (
70
- <span className="velu-api-field__prefix">{prefix}</span>
71
- )}
72
- <input
73
- id={inputId}
74
- className="velu-api-field__input"
75
- type="text"
76
- placeholder={placeholder ?? `enter ${name}`}
77
- {...(controlled
78
- ? { value, onChange }
79
- : {
80
- defaultValue:
81
- defaultValue != null ? String(defaultValue) : undefined,
82
- })}
83
- />
84
- </div>
85
- </div>
86
- );
87
- }
1
+ import React, { useId } from 'react';
2
+ import Cluster from '../primitives/Cluster.jsx';
3
+
4
+ /**
5
+ * ApiField — an input-bearing field for the ApiClient playground.
6
+ *
7
+ * Distinct from <Field> (which is doc-only — it documents a parameter
8
+ * but has no control). ApiField renders a real <input> the user types
9
+ * a value into when trying an endpoint.
10
+ *
11
+ * <ApiSection title="Path">
12
+ * <ApiField name="projectId" type="string" required>
13
+ * Your project ID. Copy it from the API keys page.
14
+ * </ApiField>
15
+ * </ApiSection>
16
+ *
17
+ * Layout — a flex-wrap pair:
18
+ * [ name + type + required ] [ prefix? input ]
19
+ * [ description … ]
20
+ * The info column (label + description) and the control column wrap
21
+ * onto separate lines on narrow widths; no media queries.
22
+ *
23
+ * - `name` parameter identifier (mono, accent)
24
+ * - `type` schema type → grey chip ("string", "boolean", …)
25
+ * - `required` boolean → red "required" pill
26
+ * - `default` pre-fills the input's value
27
+ * - `prefix` static text shown inside the input before the field
28
+ * (e.g. "Bearer" for an Authorization header)
29
+ * - `placeholder` input placeholder (defaults to `enter <name>`)
30
+ * - `value`/`onChange` optional controlled-input wiring; uncontrolled
31
+ * otherwise
32
+ * - `children` description block
33
+ */
34
+
35
+ export default function ApiField({
36
+ name,
37
+ type,
38
+ required = false,
39
+ default: defaultValue,
40
+ prefix,
41
+ placeholder,
42
+ value,
43
+ onChange,
44
+ children,
45
+ className = '',
46
+ ...rest
47
+ }) {
48
+ const inputId = useId();
49
+ const controlled = value !== undefined;
50
+ return (
51
+ <div className={`velu-api-field ${className}`.trim()} {...rest}>
52
+ <div className="velu-api-field__info">
53
+ <Cluster space="var(--s-1)" align="baseline">
54
+ <label className="velu-api-field__name" htmlFor={inputId}>
55
+ {name}
56
+ </label>
57
+ {type != null && (
58
+ <span className="velu-api-field__chip">{type}</span>
59
+ )}
60
+ {required && (
61
+ <span className="velu-api-field__required">required</span>
62
+ )}
63
+ </Cluster>
64
+ {children != null && children !== false && (
65
+ <div className="velu-api-field__desc">{children}</div>
66
+ )}
67
+ </div>
68
+ <div className="velu-api-field__control">
69
+ {prefix != null && (
70
+ <span className="velu-api-field__prefix">{prefix}</span>
71
+ )}
72
+ <input
73
+ id={inputId}
74
+ className="velu-api-field__input"
75
+ type="text"
76
+ placeholder={placeholder ?? `enter ${name}`}
77
+ {...(controlled
78
+ ? { value, onChange }
79
+ : {
80
+ defaultValue:
81
+ defaultValue != null ? String(defaultValue) : undefined,
82
+ })}
83
+ />
84
+ </div>
85
+ </div>
86
+ );
87
+ }
@@ -1,63 +1,63 @@
1
- import React from 'react';
2
- import Cluster from '../primitives/Cluster.jsx';
3
-
4
- /**
5
- * ApiPath — monospace URL path renderer. The path is split into two
6
- * kinds of segments and laid out via <Cluster>:
7
- *
8
- * - hardcoded segment the static chunks ("/project/preview/")
9
- * - dynamic segment the {param} placeholders (rendered as
10
- * method-tinted pills)
11
- *
12
- * <ApiPath method="POST" path="/project/preview/{projectId}" />
13
- * → [ "/project/preview/" ] [ {projectId} ]
14
- *
15
- * Hardcoded chunks stay intact (never break mid-text), so narrow widths
16
- * wrap between segments rather than mid-word. Dynamic pills wrap to a
17
- * new line as a unit.
18
- */
19
-
20
- const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
21
-
22
- export default function ApiPath({
23
- method = 'GET',
24
- path = '',
25
- className = '',
26
- ...rest
27
- }) {
28
- const key = String(method).toLowerCase();
29
- const safe = METHODS.includes(key) ? key : 'get';
30
-
31
- // Split only on {param} groups — keep the hardcoded text between
32
- // params as single segments so narrow-width wrapping breaks at the
33
- // segment boundary, never mid-word.
34
- const tokens = String(path).split(/(\{[^}]+\})/).filter(Boolean);
35
-
36
- return (
37
- <Cluster
38
- as="span"
39
- space="var(--s-2)"
40
- align="center"
41
- className={`velu-api-path ${className}`.trim()}
42
- {...rest}
43
- >
44
- {tokens.map((tok, i) => {
45
- if (tok.startsWith('{') && tok.endsWith('}')) {
46
- return (
47
- <span
48
- key={i}
49
- className={`velu-api-path__param velu-api-path__param--${safe}`}
50
- >
51
- {tok}
52
- </span>
53
- );
54
- }
55
- return (
56
- <span key={i} className="velu-api-path__segment">
57
- {tok}
58
- </span>
59
- );
60
- })}
61
- </Cluster>
62
- );
63
- }
1
+ import React from 'react';
2
+ import Cluster from '../primitives/Cluster.jsx';
3
+
4
+ /**
5
+ * ApiPath — monospace URL path renderer. The path is split into two
6
+ * kinds of segments and laid out via <Cluster>:
7
+ *
8
+ * - hardcoded segment the static chunks ("/project/preview/")
9
+ * - dynamic segment the {param} placeholders (rendered as
10
+ * method-tinted pills)
11
+ *
12
+ * <ApiPath method="POST" path="/project/preview/{projectId}" />
13
+ * → [ "/project/preview/" ] [ {projectId} ]
14
+ *
15
+ * Hardcoded chunks stay intact (never break mid-text), so narrow widths
16
+ * wrap between segments rather than mid-word. Dynamic pills wrap to a
17
+ * new line as a unit.
18
+ */
19
+
20
+ const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
21
+
22
+ export default function ApiPath({
23
+ method = 'GET',
24
+ path = '',
25
+ className = '',
26
+ ...rest
27
+ }) {
28
+ const key = String(method).toLowerCase();
29
+ const safe = METHODS.includes(key) ? key : 'get';
30
+
31
+ // Split only on {param} groups — keep the hardcoded text between
32
+ // params as single segments so narrow-width wrapping breaks at the
33
+ // segment boundary, never mid-word.
34
+ const tokens = String(path).split(/(\{[^}]+\})/).filter(Boolean);
35
+
36
+ return (
37
+ <Cluster
38
+ as="span"
39
+ space="var(--s-2)"
40
+ align="center"
41
+ className={`velu-api-path ${className}`.trim()}
42
+ {...rest}
43
+ >
44
+ {tokens.map((tok, i) => {
45
+ if (tok.startsWith('{') && tok.endsWith('}')) {
46
+ return (
47
+ <span
48
+ key={i}
49
+ className={`velu-api-path__param velu-api-path__param--${safe}`}
50
+ >
51
+ {tok}
52
+ </span>
53
+ );
54
+ }
55
+ return (
56
+ <span key={i} className="velu-api-path__segment">
57
+ {tok}
58
+ </span>
59
+ );
60
+ })}
61
+ </Cluster>
62
+ );
63
+ }