@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
package/README.md CHANGED
@@ -1,80 +1,80 @@
1
- # Velu
2
-
3
- A documentation-site generator with live preview. Scaffold a docs project
4
- and run it locally with two commands — author your pages in Markdown +
5
- components, configure the site with a single `velu.json`.
6
-
7
- ```bash
8
- npm install -g @veluai/velu
9
- velu init my-docs
10
- velu dev my-docs
11
- ```
12
-
13
- Then open <http://localhost:8358>. Editing any `.mdx` page or `velu.json`
14
- reloads the browser automatically.
15
-
16
- > Requires **Node.js 18+**. Prefer not to install globally? Use
17
- > `npx @veluai/velu init my-docs` and `npx @veluai/velu dev my-docs`.
18
-
19
- ## Commands
20
-
21
- | Command | What it does |
22
- | --- | --- |
23
- | `velu init <dir>` | Scaffold a new docs project into `<dir>` (creates `velu.json`, a favicon, and a set of starter `.mdx` pages). |
24
- | `velu dev [dir]` | Start the live-preview dev server for the project in `<dir>` (defaults to the current directory). |
25
-
26
- Set a custom port with the `PORT` env var:
27
-
28
- ```bash
29
- PORT=5180 velu dev my-docs
30
- ```
31
-
32
- ## Project layout
33
-
34
- `velu init` produces a project shaped like this:
35
-
36
- ```
37
- my-docs/
38
- ├─ velu.json # site config: name, colors, font, favicon, navigation
39
- ├─ favicon.svg
40
- ├─ index.mdx # pages, organized however your navigation references them
41
- ├─ quickstart.mdx
42
- └─ …
43
- ```
44
-
45
- ## `velu.json`
46
-
47
- `velu.json` drives the whole site — branding and navigation:
48
-
49
- ```json
50
- {
51
- "$schema": "https://veluai.com/velu.schema.json",
52
- "name": "My Docs",
53
- "colors": { "primary": "#dc143c" },
54
- "favicon": "/favicon.svg",
55
- "font": { "family": "Inter" },
56
- "navigation": {
57
- "tabs": [
58
- {
59
- "tab": "Guides",
60
- "groups": [
61
- { "group": "Getting started", "pages": ["index", "quickstart"] }
62
- ]
63
- }
64
- ]
65
- }
66
- }
67
- ```
68
-
69
- - **`colors`** — `primary` is required; `light` and `dark` default to `primary`.
70
- - **`navigation`** — Mintlify-compatible: `products → versions → languages →
71
- tabs → anchors → groups → pages`. Switchable axes (products, versions,
72
- languages) become URL path prefixes; the default value of each axis is
73
- unprefixed. Languages are stored as ISO 639-1 codes and shown with their
74
- native name.
75
-
76
- Page labels come from each page's frontmatter `title`.
77
-
78
- ## License
79
-
80
- Proprietary. © Velu.
1
+ # Velu
2
+
3
+ A documentation-site generator with live preview. Scaffold a docs project
4
+ and run it locally with two commands — author your pages in Markdown +
5
+ components, configure the site with a single `velu.json`.
6
+
7
+ ```bash
8
+ npm install -g @veluai/velu
9
+ velu init my-docs
10
+ velu dev my-docs
11
+ ```
12
+
13
+ Then open <http://localhost:8358>. Editing any `.mdx` page or `velu.json`
14
+ reloads the browser automatically.
15
+
16
+ > Requires **Node.js 18+**. Prefer not to install globally? Use
17
+ > `npx @veluai/velu init my-docs` and `npx @veluai/velu dev my-docs`.
18
+
19
+ ## Commands
20
+
21
+ | Command | What it does |
22
+ | --- | --- |
23
+ | `velu init <dir>` | Scaffold a new docs project into `<dir>` (creates `velu.json`, a favicon, and a set of starter `.mdx` pages). |
24
+ | `velu dev [dir]` | Start the live-preview dev server for the project in `<dir>` (defaults to the current directory). |
25
+
26
+ Set a custom port with the `PORT` env var:
27
+
28
+ ```bash
29
+ PORT=5180 velu dev my-docs
30
+ ```
31
+
32
+ ## Project layout
33
+
34
+ `velu init` produces a project shaped like this:
35
+
36
+ ```
37
+ my-docs/
38
+ ├─ velu.json # site config: name, colors, font, favicon, navigation
39
+ ├─ favicon.svg
40
+ ├─ index.mdx # pages, organized however your navigation references them
41
+ ├─ quickstart.mdx
42
+ └─ …
43
+ ```
44
+
45
+ ## `velu.json`
46
+
47
+ `velu.json` drives the whole site — branding and navigation:
48
+
49
+ ```json
50
+ {
51
+ "$schema": "https://veluai.com/velu.schema.json",
52
+ "name": "My Docs",
53
+ "colors": { "primary": "#dc143c" },
54
+ "favicon": "/favicon.svg",
55
+ "font": { "family": "Inter" },
56
+ "navigation": {
57
+ "tabs": [
58
+ {
59
+ "tab": "Guides",
60
+ "groups": [
61
+ { "group": "Getting started", "pages": ["index", "quickstart"] }
62
+ ]
63
+ }
64
+ ]
65
+ }
66
+ }
67
+ ```
68
+
69
+ - **`colors`** — `primary` is required; `light` and `dark` default to `primary`.
70
+ - **`navigation`** — Mintlify-compatible: `products → versions → languages →
71
+ tabs → anchors → groups → pages`. Switchable axes (products, versions,
72
+ languages) become URL path prefixes; the default value of each axis is
73
+ unprefixed. Languages are stored as ISO 639-1 codes and shown with their
74
+ native name.
75
+
76
+ Page labels come from each page's frontmatter `title`.
77
+
78
+ ## License
79
+
80
+ Proprietary. © Velu.