@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,25 +1,25 @@
1
- ---
2
- title: Markdown
3
- description: Author with Markdown and components.
4
- ---
5
-
6
- Standard Markdown works everywhere: **bold**, _italic_, `inline code`,
7
- [links](https://veludocs.com), lists, and tables.
8
-
9
- ## Components
10
-
11
- Drop a component tag right into your Markdown:
12
-
13
- <Callout type="warning">
14
- Callouts come in `note`, `tip`, `warning`, and `danger` styles.
15
- </Callout>
16
-
17
- <Accordion title="How does MDX work?">
18
- Each page compiles to a component that renders identically on the
19
- server and the client, so there's no flash of unstyled content.
20
- </Accordion>
21
-
22
- ## Headings
23
-
24
- Use `##` and `###` for sections — they populate the on-page table of
25
- contents on the right automatically.
1
+ ---
2
+ title: Markdown
3
+ description: Author with Markdown and components.
4
+ ---
5
+
6
+ Standard Markdown works everywhere: **bold**, _italic_, `inline code`,
7
+ [links](https://veludocs.com), lists, and tables.
8
+
9
+ ## Components
10
+
11
+ Drop a component tag right into your Markdown:
12
+
13
+ <Callout type="warning">
14
+ Callouts come in `note`, `tip`, `warning`, and `danger` styles.
15
+ </Callout>
16
+
17
+ <Accordion title="How does MDX work?">
18
+ Each page compiles to a component that renders identically on the
19
+ server and the client, so there's no flash of unstyled content.
20
+ </Accordion>
21
+
22
+ ## Headings
23
+
24
+ Use `##` and `###` for sections — they populate the on-page table of
25
+ contents on the right automatically.
@@ -1,39 +1,39 @@
1
- ---
2
- title: Navigation
3
- description: Organize your docs with tabs, groups, and pages.
4
- ---
5
-
6
- `navigation` in `velu.json` is a tree. The pieces, outermost to
7
- innermost:
8
-
9
- - **tabs** — top-level sections in the header (e.g. Guides, API).
10
- - **groups** — sidebar sections within a tab.
11
- - **pages** — the page paths in a group; a page may also be a nested
12
- group.
13
- - **anchors** — pinned links (often external) shown above the groups.
14
-
15
- ```json
16
- {
17
- "navigation": {
18
- "tabs": [
19
- {
20
- "tab": "Guides",
21
- "groups": [
22
- { "group": "Getting Started", "pages": ["index", "quickstart"] }
23
- ]
24
- }
25
- ]
26
- }
27
- }
28
- ```
29
-
30
- <Callout type="note">
31
- Sidebar labels come from each page's frontmatter `title` — you don't
32
- repeat them in `navigation`.
33
- </Callout>
34
-
35
- ## Multiple products, versions, languages
36
-
37
- Wrap your tabs in `products`, `versions`, or `languages` to offer a
38
- switcher. The active non-default choice becomes a URL prefix
39
- (`/v2/...`, `/fr/...`).
1
+ ---
2
+ title: Navigation
3
+ description: Organize your docs with tabs, groups, and pages.
4
+ ---
5
+
6
+ `navigation` in `velu.json` is a tree. The pieces, outermost to
7
+ innermost:
8
+
9
+ - **tabs** — top-level sections in the header (e.g. Guides, API).
10
+ - **groups** — sidebar sections within a tab.
11
+ - **pages** — the page paths in a group; a page may also be a nested
12
+ group.
13
+ - **anchors** — pinned links (often external) shown above the groups.
14
+
15
+ ```json
16
+ {
17
+ "navigation": {
18
+ "tabs": [
19
+ {
20
+ "tab": "Guides",
21
+ "groups": [
22
+ { "group": "Getting Started", "pages": ["index", "quickstart"] }
23
+ ]
24
+ }
25
+ ]
26
+ }
27
+ }
28
+ ```
29
+
30
+ <Callout type="note">
31
+ Sidebar labels come from each page's frontmatter `title` — you don't
32
+ repeat them in `navigation`.
33
+ </Callout>
34
+
35
+ ## Multiple products, versions, languages
36
+
37
+ Wrap your tabs in `products`, `versions`, or `languages` to offer a
38
+ switcher. The active non-default choice becomes a URL prefix
39
+ (`/v2/...`, `/fr/...`).
@@ -1,30 +1,30 @@
1
- ---
2
- title: Settings
3
- description: Theme your site through velu.json.
4
- ---
5
-
6
- Your site's look comes from a few top-level keys in `velu.json`.
7
-
8
- ```json
9
- {
10
- "name": "Acme Docs",
11
- "colors": { "primary": "#16a34a", "light": "#07c983", "dark": "#15803d" },
12
- "favicon": "/favicon.svg",
13
- "font": { "family": "Inter" }
14
- }
15
- ```
16
-
17
- ## Colors
18
-
19
- `colors.primary` sets the accent used across the UI. `light` and
20
- `dark` override it per theme; both default to `primary`.
21
-
22
- ## Font
23
-
24
- `font.family` is any Google Font family — it's loaded automatically and
25
- applied as the body font.
26
-
27
- <Callout type="tip">
28
- `favicon` is a path relative to your project root, e.g.
29
- `/favicon.svg`.
30
- </Callout>
1
+ ---
2
+ title: Settings
3
+ description: Theme your site through velu.json.
4
+ ---
5
+
6
+ Your site's look comes from a few top-level keys in `velu.json`.
7
+
8
+ ```json
9
+ {
10
+ "name": "Acme Docs",
11
+ "colors": { "primary": "#16a34a", "light": "#07c983", "dark": "#15803d" },
12
+ "favicon": "/favicon.svg",
13
+ "font": { "family": "Inter" }
14
+ }
15
+ ```
16
+
17
+ ## Colors
18
+
19
+ `colors.primary` sets the accent used across the UI. `light` and
20
+ `dark` override it per theme; both default to `primary`.
21
+
22
+ ## Font
23
+
24
+ `font.family` is any Google Font family — it's loaded automatically and
25
+ applied as the body font.
26
+
27
+ <Callout type="tip">
28
+ `favicon` is a path relative to your project root, e.g.
29
+ `/favicon.svg`.
30
+ </Callout>
@@ -1,6 +1,6 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
2
- <rect width="32" height="32" rx="7" fill="#dc143c" />
3
- <g transform="translate(5.6 8.2) scale(0.65)" fill="#ffffff">
4
- <path fill-rule="evenodd" clip-rule="evenodd" d="M29.6564 14.1534C29.5739 14.5616 29.3507 14.9288 29.0248 15.1926C28.699 15.4565 28.2907 15.6007 27.8694 15.6006H21.3702C20.5341 15.6006 19.8051 16.1627 19.6031 16.9638L18.1671 22.6368C18.0685 23.0263 17.8409 23.372 17.5205 23.619C17.2002 23.866 16.8054 24.0001 16.399 24H10.4378C10.1609 24.0001 9.88759 23.9378 9.63868 23.8179C9.38976 23.6979 9.1718 23.5235 9.00135 23.3079C8.8309 23.0923 8.71245 22.8412 8.65499 22.5736C8.59754 22.306 8.6026 22.029 8.66978 21.7636L10.1888 15.7636C10.2874 15.3743 10.5148 15.0287 10.835 14.7817C11.1551 14.5347 11.5496 14.4005 11.9559 14.4004H18.3931C19.2621 14.4004 20.0101 13.7949 20.1801 12.9532L22.3882 2.04774C22.4705 1.63945 22.6936 1.27198 23.0195 1.00793C23.3453 0.74388 23.7538 0.599578 24.1752 0.599605H30.1774C30.4471 0.599529 30.7134 0.658587 30.9572 0.772515C31.201 0.886444 31.4161 1.0524 31.5871 1.25842C31.758 1.46443 31.8806 1.70537 31.9458 1.96383C32.0111 2.2223 32.0175 2.49185 31.9645 2.75305L29.6564 14.1534ZM9.61081 13.5538C9.52825 13.962 9.30507 14.3292 8.97924 14.593C8.65341 14.857 8.24508 15.0011 7.82375 15.001H1.82257C1.55289 15.0011 1.28656 14.942 1.04279 14.8281C0.79902 14.7141 0.583892 14.5482 0.412928 14.3422C0.241965 14.1362 0.11943 13.8952 0.0541639 13.6368C-0.0111017 13.3783 -0.0174699 13.1087 0.0355186 12.8475L2.34359 1.44715C2.42614 1.03904 2.64933 0.671798 2.97516 0.407944C3.30099 0.144089 3.70932 -0.00007 4.13064 0H10.1318C10.4015 -0.00008 10.6678 0.0589818 10.9116 0.172911C11.1554 0.286839 11.3705 0.453799 11.5415 0.659813C11.7124 0.864828 11.835 1.10576 11.9002 1.36423C11.9655 1.62269 11.9719 1.89225 11.9189 2.15344L9.61081 13.5538Z" />
5
- </g>
6
- </svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
2
+ <rect width="32" height="32" rx="7" fill="#dc143c" />
3
+ <g transform="translate(5.6 8.2) scale(0.65)" fill="#ffffff">
4
+ <path fill-rule="evenodd" clip-rule="evenodd" d="M29.6564 14.1534C29.5739 14.5616 29.3507 14.9288 29.0248 15.1926C28.699 15.4565 28.2907 15.6007 27.8694 15.6006H21.3702C20.5341 15.6006 19.8051 16.1627 19.6031 16.9638L18.1671 22.6368C18.0685 23.0263 17.8409 23.372 17.5205 23.619C17.2002 23.866 16.8054 24.0001 16.399 24H10.4378C10.1609 24.0001 9.88759 23.9378 9.63868 23.8179C9.38976 23.6979 9.1718 23.5235 9.00135 23.3079C8.8309 23.0923 8.71245 22.8412 8.65499 22.5736C8.59754 22.306 8.6026 22.029 8.66978 21.7636L10.1888 15.7636C10.2874 15.3743 10.5148 15.0287 10.835 14.7817C11.1551 14.5347 11.5496 14.4005 11.9559 14.4004H18.3931C19.2621 14.4004 20.0101 13.7949 20.1801 12.9532L22.3882 2.04774C22.4705 1.63945 22.6936 1.27198 23.0195 1.00793C23.3453 0.74388 23.7538 0.599578 24.1752 0.599605H30.1774C30.4471 0.599529 30.7134 0.658587 30.9572 0.772515C31.201 0.886444 31.4161 1.0524 31.5871 1.25842C31.758 1.46443 31.8806 1.70537 31.9458 1.96383C32.0111 2.2223 32.0175 2.49185 31.9645 2.75305L29.6564 14.1534ZM9.61081 13.5538C9.52825 13.962 9.30507 14.3292 8.97924 14.593C8.65341 14.857 8.24508 15.0011 7.82375 15.001H1.82257C1.55289 15.0011 1.28656 14.942 1.04279 14.8281C0.79902 14.7141 0.583892 14.5482 0.412928 14.3422C0.241965 14.1362 0.11943 13.8952 0.0541639 13.6368C-0.0111017 13.3783 -0.0174699 13.1087 0.0355186 12.8475L2.34359 1.44715C2.42614 1.03904 2.64933 0.671798 2.97516 0.407944C3.30099 0.144089 3.70932 -0.00007 4.13064 0H10.1318C10.4015 -0.00008 10.6678 0.0589818 10.9116 0.172911C11.1554 0.286839 11.3705 0.453799 11.5415 0.659813C11.7124 0.864828 11.835 1.10576 11.9002 1.36423C11.9655 1.62269 11.9719 1.89225 11.9189 2.15344L9.61081 13.5538Z" />
5
+ </g>
6
+ </svg>
@@ -1,31 +1,31 @@
1
- ---
2
- title: Introduction
3
- description: Welcome to your Velu documentation site.
4
- ---
5
-
6
- This is your new documentation site, rendered by **Velu** from plain
7
- Markdown and a `velu.json` config. The sidebar, tabs, and page order
8
- all come from the `navigation` block — edit it and the site updates on
9
- save.
10
-
11
- <Callout type="tip">
12
- Page paths in `navigation` are relative to the project root with no
13
- extension: `"essentials/markdown"` renders `essentials/markdown.mdx`.
14
- </Callout>
15
-
16
- ## Get going
17
-
18
- <CardGroup>
19
- <Card title="Quickstart" icon="rocket" cta={{ label: "Get started", href: "/quickstart" }}>
20
- Run the dev server and make your first edit.
21
- </Card>
22
- <Card title="Customize" icon="sliders-horizontal" cta={{ label: "Customize", href: "/essentials/settings" }}>
23
- Set your colors, font, and favicon.
24
- </Card>
25
- <Card title="Write content" icon="pen-line" cta={{ label: "Write content", href: "/essentials/markdown" }}>
26
- Markdown plus a library of components.
27
- </Card>
28
- <Card title="API reference" icon="terminal" cta={{ label: "View reference", href: "/api-reference/introduction" }}>
29
- Document your endpoints.
30
- </Card>
31
- </CardGroup>
1
+ ---
2
+ title: Introduction
3
+ description: Welcome to your Velu documentation site.
4
+ ---
5
+
6
+ This is your new documentation site, rendered by **Velu** from plain
7
+ Markdown and a `velu.json` config. The sidebar, tabs, and page order
8
+ all come from the `navigation` block — edit it and the site updates on
9
+ save.
10
+
11
+ <Callout type="tip">
12
+ Page paths in `navigation` are relative to the project root with no
13
+ extension: `"essentials/markdown"` renders `essentials/markdown.mdx`.
14
+ </Callout>
15
+
16
+ ## Get going
17
+
18
+ <CardGroup>
19
+ <Card title="Quickstart" icon="rocket" cta={{ label: "Get started", href: "/quickstart" }}>
20
+ Run the dev server and make your first edit.
21
+ </Card>
22
+ <Card title="Customize" icon="sliders-horizontal" cta={{ label: "Customize", href: "/essentials/settings" }}>
23
+ Set your colors, font, and favicon.
24
+ </Card>
25
+ <Card title="Write content" icon="pen-line" cta={{ label: "Write content", href: "/essentials/markdown" }}>
26
+ Markdown plus a library of components.
27
+ </Card>
28
+ <Card title="API reference" icon="terminal" cta={{ label: "View reference", href: "/api-reference/introduction" }}>
29
+ Document your endpoints.
30
+ </Card>
31
+ </CardGroup>
@@ -1,160 +1,160 @@
1
- {
2
- "openapi": "3.0.3",
3
- "info": {
4
- "title": "Product Catalog API",
5
- "version": "1.0.0",
6
- "description": "A friendly, fully-hosted example API — a product catalog backed by the live https://dummyjson.com service. Every operation hits the real API: list, search, fetch, create, update and delete products and see real responses."
7
- },
8
- "servers": [{ "url": "https://dummyjson.com" }],
9
- "tags": [{ "name": "Products", "description": "Browse and manage the product catalog." }],
10
- "paths": {
11
- "/products": {
12
- "get": {
13
- "operationId": "listProducts",
14
- "summary": "List products",
15
- "description": "List products, with optional pagination.",
16
- "tags": ["Products"],
17
- "parameters": [
18
- { "name": "limit", "in": "query", "schema": { "type": "integer" }, "description": "How many products to return (0 returns all)." },
19
- { "name": "skip", "in": "query", "schema": { "type": "integer" }, "description": "How many products to skip (for pagination)." }
20
- ],
21
- "responses": {
22
- "200": {
23
- "description": "A page of products.",
24
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductList" } } }
25
- }
26
- }
27
- }
28
- },
29
- "/products/search": {
30
- "get": {
31
- "operationId": "searchProducts",
32
- "summary": "Search products",
33
- "description": "Search the catalog by a free-text query.",
34
- "tags": ["Products"],
35
- "parameters": [
36
- { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The search query (try `phone`)." }
37
- ],
38
- "responses": {
39
- "200": {
40
- "description": "Matching products.",
41
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductList" } } }
42
- }
43
- }
44
- }
45
- },
46
- "/products/{id}": {
47
- "get": {
48
- "operationId": "getProduct",
49
- "summary": "Get a product",
50
- "description": "Retrieve a single product by its id.",
51
- "tags": ["Products"],
52
- "parameters": [
53
- { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id (try `1`)." }
54
- ],
55
- "responses": {
56
- "200": {
57
- "description": "The product.",
58
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
59
- }
60
- }
61
- },
62
- "put": {
63
- "operationId": "updateProduct",
64
- "summary": "Update a product",
65
- "description": "Update fields on an existing product. (Simulated by the upstream API — the response reflects the change but nothing is persisted.)",
66
- "tags": ["Products"],
67
- "parameters": [
68
- { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id." }
69
- ],
70
- "requestBody": {
71
- "required": true,
72
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductInput" } } }
73
- },
74
- "responses": {
75
- "200": {
76
- "description": "The updated product.",
77
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
78
- }
79
- }
80
- },
81
- "delete": {
82
- "operationId": "deleteProduct",
83
- "summary": "Delete a product",
84
- "description": "Delete a product by its id. (Simulated — the response includes `isDeleted` and `deletedOn`.)",
85
- "tags": ["Products"],
86
- "parameters": [
87
- { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id." }
88
- ],
89
- "responses": {
90
- "200": {
91
- "description": "The deleted product.",
92
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
93
- }
94
- }
95
- }
96
- },
97
- "/products/add": {
98
- "post": {
99
- "operationId": "addProduct",
100
- "summary": "Add a product",
101
- "description": "Create a new product. (Simulated — the response echoes the body with a fresh `id`.)",
102
- "tags": ["Products"],
103
- "requestBody": {
104
- "required": true,
105
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductInput" } } }
106
- },
107
- "responses": {
108
- "201": {
109
- "description": "The created product.",
110
- "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
111
- }
112
- }
113
- }
114
- }
115
- },
116
- "components": {
117
- "schemas": {
118
- "Product": {
119
- "type": "object",
120
- "properties": {
121
- "id": { "type": "integer", "description": "Unique identifier." },
122
- "title": { "type": "string", "description": "Product name." },
123
- "description": { "type": "string", "description": "Product description." },
124
- "category": { "type": "string", "description": "Category slug." },
125
- "price": { "type": "number", "description": "Price in USD." },
126
- "discountPercentage": { "type": "number", "description": "Discount, as a percentage." },
127
- "rating": { "type": "number", "description": "Average customer rating (0–5)." },
128
- "stock": { "type": "integer", "description": "Units in stock." },
129
- "brand": { "type": "string", "description": "Brand name." },
130
- "thumbnail": { "type": "string", "description": "Thumbnail image URL." }
131
- }
132
- },
133
- "ProductList": {
134
- "type": "object",
135
- "properties": {
136
- "products": { "type": "array", "description": "The products on this page.", "items": { "$ref": "#/components/schemas/Product" } },
137
- "total": { "type": "integer", "description": "Total number of matching products." },
138
- "skip": { "type": "integer", "description": "How many were skipped." },
139
- "limit": { "type": "integer", "description": "How many were returned." }
140
- }
141
- },
142
- "ProductInput": {
143
- "type": "object",
144
- "required": ["title"],
145
- "properties": {
146
- "title": { "type": "string", "description": "Product name." },
147
- "description": { "type": "string", "description": "Product description." },
148
- "category": { "type": "string", "description": "Category slug." },
149
- "price": { "type": "number", "description": "Price in USD." }
150
- },
151
- "example": {
152
- "title": "Velu Notebook",
153
- "description": "A dotted-grid notebook for docs notes.",
154
- "category": "stationery",
155
- "price": 19.99
156
- }
157
- }
158
- }
159
- }
160
- }
1
+ {
2
+ "openapi": "3.0.3",
3
+ "info": {
4
+ "title": "Product Catalog API",
5
+ "version": "1.0.0",
6
+ "description": "A friendly, fully-hosted example API — a product catalog backed by the live https://dummyjson.com service. Every operation hits the real API: list, search, fetch, create, update and delete products and see real responses."
7
+ },
8
+ "servers": [{ "url": "https://dummyjson.com" }],
9
+ "tags": [{ "name": "Products", "description": "Browse and manage the product catalog." }],
10
+ "paths": {
11
+ "/products": {
12
+ "get": {
13
+ "operationId": "listProducts",
14
+ "summary": "List products",
15
+ "description": "List products, with optional pagination.",
16
+ "tags": ["Products"],
17
+ "parameters": [
18
+ { "name": "limit", "in": "query", "schema": { "type": "integer" }, "description": "How many products to return (0 returns all)." },
19
+ { "name": "skip", "in": "query", "schema": { "type": "integer" }, "description": "How many products to skip (for pagination)." }
20
+ ],
21
+ "responses": {
22
+ "200": {
23
+ "description": "A page of products.",
24
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductList" } } }
25
+ }
26
+ }
27
+ }
28
+ },
29
+ "/products/search": {
30
+ "get": {
31
+ "operationId": "searchProducts",
32
+ "summary": "Search products",
33
+ "description": "Search the catalog by a free-text query.",
34
+ "tags": ["Products"],
35
+ "parameters": [
36
+ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The search query (try `phone`)." }
37
+ ],
38
+ "responses": {
39
+ "200": {
40
+ "description": "Matching products.",
41
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductList" } } }
42
+ }
43
+ }
44
+ }
45
+ },
46
+ "/products/{id}": {
47
+ "get": {
48
+ "operationId": "getProduct",
49
+ "summary": "Get a product",
50
+ "description": "Retrieve a single product by its id.",
51
+ "tags": ["Products"],
52
+ "parameters": [
53
+ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id (try `1`)." }
54
+ ],
55
+ "responses": {
56
+ "200": {
57
+ "description": "The product.",
58
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
59
+ }
60
+ }
61
+ },
62
+ "put": {
63
+ "operationId": "updateProduct",
64
+ "summary": "Update a product",
65
+ "description": "Update fields on an existing product. (Simulated by the upstream API — the response reflects the change but nothing is persisted.)",
66
+ "tags": ["Products"],
67
+ "parameters": [
68
+ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id." }
69
+ ],
70
+ "requestBody": {
71
+ "required": true,
72
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductInput" } } }
73
+ },
74
+ "responses": {
75
+ "200": {
76
+ "description": "The updated product.",
77
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
78
+ }
79
+ }
80
+ },
81
+ "delete": {
82
+ "operationId": "deleteProduct",
83
+ "summary": "Delete a product",
84
+ "description": "Delete a product by its id. (Simulated — the response includes `isDeleted` and `deletedOn`.)",
85
+ "tags": ["Products"],
86
+ "parameters": [
87
+ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "The product id." }
88
+ ],
89
+ "responses": {
90
+ "200": {
91
+ "description": "The deleted product.",
92
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
93
+ }
94
+ }
95
+ }
96
+ },
97
+ "/products/add": {
98
+ "post": {
99
+ "operationId": "addProduct",
100
+ "summary": "Add a product",
101
+ "description": "Create a new product. (Simulated — the response echoes the body with a fresh `id`.)",
102
+ "tags": ["Products"],
103
+ "requestBody": {
104
+ "required": true,
105
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductInput" } } }
106
+ },
107
+ "responses": {
108
+ "201": {
109
+ "description": "The created product.",
110
+ "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } }
111
+ }
112
+ }
113
+ }
114
+ }
115
+ },
116
+ "components": {
117
+ "schemas": {
118
+ "Product": {
119
+ "type": "object",
120
+ "properties": {
121
+ "id": { "type": "integer", "description": "Unique identifier." },
122
+ "title": { "type": "string", "description": "Product name." },
123
+ "description": { "type": "string", "description": "Product description." },
124
+ "category": { "type": "string", "description": "Category slug." },
125
+ "price": { "type": "number", "description": "Price in USD." },
126
+ "discountPercentage": { "type": "number", "description": "Discount, as a percentage." },
127
+ "rating": { "type": "number", "description": "Average customer rating (0–5)." },
128
+ "stock": { "type": "integer", "description": "Units in stock." },
129
+ "brand": { "type": "string", "description": "Brand name." },
130
+ "thumbnail": { "type": "string", "description": "Thumbnail image URL." }
131
+ }
132
+ },
133
+ "ProductList": {
134
+ "type": "object",
135
+ "properties": {
136
+ "products": { "type": "array", "description": "The products on this page.", "items": { "$ref": "#/components/schemas/Product" } },
137
+ "total": { "type": "integer", "description": "Total number of matching products." },
138
+ "skip": { "type": "integer", "description": "How many were skipped." },
139
+ "limit": { "type": "integer", "description": "How many were returned." }
140
+ }
141
+ },
142
+ "ProductInput": {
143
+ "type": "object",
144
+ "required": ["title"],
145
+ "properties": {
146
+ "title": { "type": "string", "description": "Product name." },
147
+ "description": { "type": "string", "description": "Product description." },
148
+ "category": { "type": "string", "description": "Category slug." },
149
+ "price": { "type": "number", "description": "Price in USD." }
150
+ },
151
+ "example": {
152
+ "title": "Velu Notebook",
153
+ "description": "A dotted-grid notebook for docs notes.",
154
+ "category": "stationery",
155
+ "price": 19.99
156
+ }
157
+ }
158
+ }
159
+ }
160
+ }