@axerity/cli 0.1.0

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 (186) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1 -0
  3. package/axerity.default.json +135 -0
  4. package/axerity.schema.json +268 -0
  5. package/bin/axerity.js +305 -0
  6. package/mdsvex.config.js +261 -0
  7. package/package.json +103 -0
  8. package/scripts/prepare-engine.mjs +20 -0
  9. package/src/app.d.ts +17 -0
  10. package/src/app.html +39 -0
  11. package/src/content/demo/api/meta.json +5 -0
  12. package/src/content/demo/api/pet/add-pet.md +105 -0
  13. package/src/content/demo/api/pet/delete-pet.md +70 -0
  14. package/src/content/demo/api/pet/find-by-status.md +72 -0
  15. package/src/content/demo/api/pet/find-by-tags.md +64 -0
  16. package/src/content/demo/api/pet/get-pet.md +99 -0
  17. package/src/content/demo/api/pet/meta.json +15 -0
  18. package/src/content/demo/api/pet/pet-object.md +112 -0
  19. package/src/content/demo/api/pet/update-pet-with-form.md +69 -0
  20. package/src/content/demo/api/pet/update-pet.md +79 -0
  21. package/src/content/demo/api/pet/upload-image.md +79 -0
  22. package/src/content/demo/api/store/delete-order.md +62 -0
  23. package/src/content/demo/api/store/get-order.md +70 -0
  24. package/src/content/demo/api/store/inventory.md +54 -0
  25. package/src/content/demo/api/store/meta.json +5 -0
  26. package/src/content/demo/api/store/order-object.md +77 -0
  27. package/src/content/demo/api/store/place-order.md +83 -0
  28. package/src/content/demo/api/user/create-user.md +69 -0
  29. package/src/content/demo/api/user/create-with-list.md +57 -0
  30. package/src/content/demo/api/user/delete-user.md +61 -0
  31. package/src/content/demo/api/user/get-user.md +69 -0
  32. package/src/content/demo/api/user/login.md +80 -0
  33. package/src/content/demo/api/user/logout.md +45 -0
  34. package/src/content/demo/api/user/meta.json +14 -0
  35. package/src/content/demo/api/user/update-user.md +69 -0
  36. package/src/content/demo/api/user/user-object.md +85 -0
  37. package/src/content/demo/changelog.md +44 -0
  38. package/src/content/demo/components/accordion.md +70 -0
  39. package/src/content/demo/components/api.md +185 -0
  40. package/src/content/demo/components/badge.md +34 -0
  41. package/src/content/demo/components/callout.md +83 -0
  42. package/src/content/demo/components/cards.md +88 -0
  43. package/src/content/demo/components/code-group.md +55 -0
  44. package/src/content/demo/components/columns.md +42 -0
  45. package/src/content/demo/components/frame.md +51 -0
  46. package/src/content/demo/components/icon.md +54 -0
  47. package/src/content/demo/components/kbd.md +28 -0
  48. package/src/content/demo/components/meta.json +26 -0
  49. package/src/content/demo/components/roadmap.md +86 -0
  50. package/src/content/demo/components/steps.md +72 -0
  51. package/src/content/demo/components/tabs.md +146 -0
  52. package/src/content/demo/components/tooltip.md +44 -0
  53. package/src/content/demo/components/tree.md +83 -0
  54. package/src/content/demo/components/type-table.md +77 -0
  55. package/src/content/demo/components/update.md +48 -0
  56. package/src/content/demo/components/video.md +56 -0
  57. package/src/content/demo/components/webhooks.md +109 -0
  58. package/src/content/demo/components/websockets.md +101 -0
  59. package/src/content/demo/configuration/ai.md +40 -0
  60. package/src/content/demo/configuration/cli.md +46 -0
  61. package/src/content/demo/configuration/deployment.md +105 -0
  62. package/src/content/demo/configuration/index.md +92 -0
  63. package/src/content/demo/configuration/layouts.md +51 -0
  64. package/src/content/demo/configuration/meta.json +5 -0
  65. package/src/content/demo/configuration/navigation.md +167 -0
  66. package/src/content/demo/configuration/openapi.md +103 -0
  67. package/src/content/demo/configuration/search.md +36 -0
  68. package/src/content/demo/index.md +59 -0
  69. package/src/content/demo/installation.md +49 -0
  70. package/src/content/demo/meta.json +15 -0
  71. package/src/content/demo/quick-start.md +47 -0
  72. package/src/content/demo/theming/advanced.md +116 -0
  73. package/src/content/demo/theming/code.md +66 -0
  74. package/src/content/demo/theming/colors.md +103 -0
  75. package/src/content/demo/theming/index.md +88 -0
  76. package/src/content/demo/theming/layout.md +71 -0
  77. package/src/content/demo/theming/meta.json +5 -0
  78. package/src/content/demo/theming/themes.md +99 -0
  79. package/src/content/demo/theming/typography.md +83 -0
  80. package/src/content/demo/writing/code-blocks.md +154 -0
  81. package/src/content/demo/writing/diagrams.md +44 -0
  82. package/src/content/demo/writing/frontmatter.md +33 -0
  83. package/src/content/demo/writing/markdown.md +62 -0
  84. package/src/content/demo/writing/meta.json +5 -0
  85. package/src/hooks.server.ts +49 -0
  86. package/src/lib/assets/favicon.svg +1 -0
  87. package/src/lib/base.ts +12 -0
  88. package/src/lib/components/DynamicIcon.svelte +26 -0
  89. package/src/lib/components/docs/Analytics.svelte +38 -0
  90. package/src/lib/components/docs/Banner.svelte +44 -0
  91. package/src/lib/components/docs/Breadcrumbs.svelte +38 -0
  92. package/src/lib/components/docs/CopyPageMenu.svelte +119 -0
  93. package/src/lib/components/docs/DocsLayout.svelte +192 -0
  94. package/src/lib/components/docs/Footer.svelte +60 -0
  95. package/src/lib/components/docs/Mermaid.svelte +39 -0
  96. package/src/lib/components/docs/Navbar.svelte +144 -0
  97. package/src/lib/components/docs/PageMeta.svelte +35 -0
  98. package/src/lib/components/docs/PageNav.svelte +44 -0
  99. package/src/lib/components/docs/SearchDialog.svelte +182 -0
  100. package/src/lib/components/docs/Sidebar.svelte +85 -0
  101. package/src/lib/components/docs/SidebarDropdown.svelte +56 -0
  102. package/src/lib/components/docs/SidebarFooterLinks.svelte +19 -0
  103. package/src/lib/components/docs/SidebarGroup.svelte +54 -0
  104. package/src/lib/components/docs/SidebarLink.svelte +67 -0
  105. package/src/lib/components/docs/TableOfContents.svelte +77 -0
  106. package/src/lib/components/docs/ThemeToggle.svelte +19 -0
  107. package/src/lib/components/docs/VersionSwitcher.svelte +80 -0
  108. package/src/lib/components/kit/Accordion.svelte +60 -0
  109. package/src/lib/components/kit/AccordionGroup.svelte +13 -0
  110. package/src/lib/components/kit/Badge.svelte +32 -0
  111. package/src/lib/components/kit/Callout.svelte +51 -0
  112. package/src/lib/components/kit/Card.svelte +72 -0
  113. package/src/lib/components/kit/CardGroup.svelte +21 -0
  114. package/src/lib/components/kit/CodeGroup.svelte +65 -0
  115. package/src/lib/components/kit/Columns.svelte +26 -0
  116. package/src/lib/components/kit/Event.svelte +23 -0
  117. package/src/lib/components/kit/EventList.svelte +9 -0
  118. package/src/lib/components/kit/File.svelte +15 -0
  119. package/src/lib/components/kit/Folder.svelte +46 -0
  120. package/src/lib/components/kit/Frame.svelte +81 -0
  121. package/src/lib/components/kit/Icon.svelte +17 -0
  122. package/src/lib/components/kit/Kbd.svelte +11 -0
  123. package/src/lib/components/kit/Roadmap.svelte +15 -0
  124. package/src/lib/components/kit/RoadmapItem.svelte +109 -0
  125. package/src/lib/components/kit/Step.svelte +63 -0
  126. package/src/lib/components/kit/Steps.svelte +16 -0
  127. package/src/lib/components/kit/Tab.svelte +27 -0
  128. package/src/lib/components/kit/Tabs.svelte +75 -0
  129. package/src/lib/components/kit/Tooltip.svelte +33 -0
  130. package/src/lib/components/kit/Tree.svelte +11 -0
  131. package/src/lib/components/kit/TypeTable.svelte +187 -0
  132. package/src/lib/components/kit/Update.svelte +32 -0
  133. package/src/lib/components/kit/Video.svelte +64 -0
  134. package/src/lib/components/kit/accordion-context.ts +1 -0
  135. package/src/lib/components/kit/api/Api.svelte +80 -0
  136. package/src/lib/components/kit/api/ApiExamplePanel.svelte +100 -0
  137. package/src/lib/components/kit/api/ApiField.svelte +124 -0
  138. package/src/lib/components/kit/api/Channel.svelte +121 -0
  139. package/src/lib/components/kit/api/Endpoint.svelte +116 -0
  140. package/src/lib/components/kit/api/Enum.svelte +44 -0
  141. package/src/lib/components/kit/api/EnumValues.svelte +35 -0
  142. package/src/lib/components/kit/api/Expandable.svelte +70 -0
  143. package/src/lib/components/kit/api/Message.svelte +67 -0
  144. package/src/lib/components/kit/api/ObjectExample.svelte +11 -0
  145. package/src/lib/components/kit/api/RequestExample.svelte +11 -0
  146. package/src/lib/components/kit/api/ResponseExample.svelte +11 -0
  147. package/src/lib/components/kit/api/Webhook.svelte +115 -0
  148. package/src/lib/components/kit/api/api-context.ts +15 -0
  149. package/src/lib/components/kit/tabs-context.ts +8 -0
  150. package/src/lib/components/kit/tabs-store.svelte.ts +28 -0
  151. package/src/lib/config/site.ts +34 -0
  152. package/src/lib/content/index.ts +50 -0
  153. package/src/lib/content/raw.ts +21 -0
  154. package/src/lib/content/tree.ts +169 -0
  155. package/src/lib/index.ts +79 -0
  156. package/src/lib/nav-match.ts +23 -0
  157. package/src/lib/openapi/generate.ts +629 -0
  158. package/src/lib/server/og.ts +140 -0
  159. package/src/lib/state/search.svelte.ts +9 -0
  160. package/src/lib/state/theme.svelte.ts +58 -0
  161. package/src/lib/types.ts +216 -0
  162. package/src/params/docpage.ts +3 -0
  163. package/src/params/mdfile.ts +3 -0
  164. package/src/routes/+error.svelte +46 -0
  165. package/src/routes/+layout.svelte +25 -0
  166. package/src/routes/[...path=mdfile]/+server.ts +21 -0
  167. package/src/routes/[...slug=docpage]/+page.svelte +63 -0
  168. package/src/routes/[...slug=docpage]/+page.ts +44 -0
  169. package/src/routes/layout.css +897 -0
  170. package/src/routes/llms-full.txt/+server.ts +22 -0
  171. package/src/routes/llms.txt/+server.ts +20 -0
  172. package/src/routes/og/[...slug]/+server.ts +77 -0
  173. package/src/routes/rss.xml/+server.ts +65 -0
  174. package/src/routes/search.json/+server.ts +54 -0
  175. package/src/routes/sitemap.xml/+server.ts +21 -0
  176. package/static/favicon-dark.svg +6 -0
  177. package/static/favicon-light.svg +6 -0
  178. package/static/favicon.svg +14 -0
  179. package/static/fonts/geist-400.ttf +0 -0
  180. package/static/fonts/geist-600.ttf +0 -0
  181. package/static/fonts/geist-700.ttf +0 -0
  182. package/static/og-image.png +0 -0
  183. package/static/robots.txt +4 -0
  184. package/svelte.config.js +35 -0
  185. package/tsconfig.json +20 -0
  186. package/vite.config.ts +46 -0
package/src/app.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ // See https://svelte.dev/docs/kit/types#app.d.ts
2
+ // for information about these interfaces
3
+ declare global {
4
+ namespace App {
5
+ // interface Error {}
6
+ // interface Locals {}
7
+ // interface PageData {}
8
+ // interface PageState {}
9
+ // interface Platform {}
10
+ }
11
+ }
12
+
13
+ // Fontsource ships CSS without type declarations; declare the side-effect imports.
14
+ declare module '@fontsource-variable/geist/*';
15
+ declare module '@fontsource-variable/geist-mono/*';
16
+
17
+ export {};
package/src/app.html ADDED
@@ -0,0 +1,39 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <meta name="text-scale" content="scale" />
7
+ <script>
8
+ (() => {
9
+ try {
10
+ const pref = localStorage.getItem('axerity-theme') ?? 'dark';
11
+ const dark =
12
+ pref === 'dark' ||
13
+ (pref === 'system' && window.matchMedia('(prefers-color-scheme: dark)').matches);
14
+ document.documentElement.classList.toggle('dark', dark);
15
+ } catch {}
16
+ })();
17
+ (() => {
18
+ try {
19
+ const hide = [];
20
+ for (let i = 0; i < localStorage.length; i++) {
21
+ const key = localStorage.key(i);
22
+ if (key && key.indexOf('axerity-banner:') === 0 && localStorage.getItem(key) === '1') {
23
+ hide.push('[data-banner-key="' + key.replace(/"/g, '\\"') + '"]');
24
+ }
25
+ }
26
+ if (hide.length) {
27
+ const style = document.createElement('style');
28
+ style.textContent = hide.join(',') + '{display:none!important}';
29
+ document.head.appendChild(style);
30
+ }
31
+ } catch {}
32
+ })();
33
+ </script>
34
+ %sveltekit.head%
35
+ </head>
36
+ <body data-sveltekit-preload-data="hover">
37
+ <div style="display: contents">%sveltekit.body%</div>
38
+ </body>
39
+ </html>
@@ -0,0 +1,5 @@
1
+ {
2
+ "title": "API Reference",
3
+ "icon": "code",
4
+ "pages": ["pet", "store", "user"]
5
+ }
@@ -0,0 +1,105 @@
1
+ ---
2
+ title: Add a new pet
3
+ description: Add a new pet to the store.
4
+ icon: paw-print
5
+ layout: api
6
+ method: POST
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample, ObjectExample } from '$lib';
11
+ </script>
12
+
13
+ # Add a new pet
14
+
15
+ Add a new pet to the store.
16
+
17
+ <Api>
18
+
19
+ <Endpoint method="POST" path="/pet" baseUrl="https://petstore3.swagger.io/api/v3" />
20
+
21
+ ## Body parameters
22
+
23
+ Create a new pet in the store.
24
+
25
+ <ParamField name="name" type="string" required>
26
+
27
+ The pet's name.
28
+
29
+ </ParamField>
30
+
31
+ <ParamField name="photoUrls" type="array of strings" required>
32
+
33
+ URLs of the pet's photos.
34
+
35
+ </ParamField>
36
+
37
+ <ParamField name="category" type="Category" typeLink="/api/pet/pet-object">
38
+
39
+ The category this pet belongs to.
40
+
41
+ </ParamField>
42
+
43
+ <ParamField name="status" type="enum">
44
+
45
+ Pet status in the store. One of `available`, `pending`, or `sold`.
46
+
47
+ </ParamField>
48
+
49
+ ## Returns
50
+
51
+ Returns the created [Pet](/api/pet/pet-object).
52
+
53
+ <ResponseField name="id" type="integer">
54
+
55
+ Unique id for the new pet.
56
+
57
+ </ResponseField>
58
+
59
+ <RequestExample title="cURL">
60
+
61
+ ```bash
62
+ curl https://petstore3.swagger.io/api/v3/pet \
63
+ -H "Content-Type: application/json" \
64
+ -d '{ "name": "doggie", "photoUrls": ["https://example.com/doggie.png"], "status": "available" }'
65
+ ```
66
+
67
+ </RequestExample>
68
+
69
+ <ResponseExample title="200 OK">
70
+
71
+ ```json
72
+ {
73
+ "id": 10,
74
+ "name": "doggie",
75
+ "photoUrls": ["https://example.com/doggie.png"],
76
+ "status": "available"
77
+ }
78
+ ```
79
+
80
+ </ResponseExample>
81
+
82
+ <ResponseExample title="400 Invalid input">
83
+
84
+ ```json
85
+ { "code": 400, "message": "Invalid input" }
86
+ ```
87
+
88
+ </ResponseExample>
89
+
90
+ <ObjectExample title="The Pet object">
91
+
92
+ ```json
93
+ {
94
+ "id": 10,
95
+ "name": "doggie",
96
+ "category": { "id": 1, "name": "Dogs" },
97
+ "photoUrls": ["https://example.com/doggie.png"],
98
+ "tags": [{ "id": 1, "name": "friendly" }],
99
+ "status": "available"
100
+ }
101
+ ```
102
+
103
+ </ObjectExample>
104
+
105
+ </Api>
@@ -0,0 +1,70 @@
1
+ ---
2
+ title: Delete a pet
3
+ description: Delete a pet from the store.
4
+ icon: paw-print
5
+ layout: api
6
+ method: DELETE
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample } from '$lib';
11
+ </script>
12
+
13
+ # Delete a pet
14
+
15
+ Delete a pet.
16
+
17
+ <Api>
18
+
19
+ <Endpoint method="DELETE" path={'/pet/{petId}'} baseUrl="https://petstore3.swagger.io/api/v3" />
20
+
21
+ ## Headers
22
+
23
+ <ParamField name="api_key" type="string">
24
+
25
+ Your store API key.
26
+
27
+ </ParamField>
28
+
29
+ ## Path parameters
30
+
31
+ <ParamField name="petId" type="integer" required>
32
+
33
+ The id of the pet to delete.
34
+
35
+ </ParamField>
36
+
37
+ ## Returns
38
+
39
+ <ResponseField name="code" type="integer">
40
+
41
+ The HTTP status code of the result.
42
+
43
+ </ResponseField>
44
+
45
+ <RequestExample title="cURL">
46
+
47
+ ```bash
48
+ curl -X DELETE https://petstore3.swagger.io/api/v3/pet/10 \
49
+ -H "api_key: special-key"
50
+ ```
51
+
52
+ </RequestExample>
53
+
54
+ <ResponseExample title="200 OK">
55
+
56
+ ```json
57
+ { "code": 200, "message": "Pet deleted" }
58
+ ```
59
+
60
+ </ResponseExample>
61
+
62
+ <ResponseExample title="400 Invalid value">
63
+
64
+ ```json
65
+ { "code": 400, "message": "Invalid pet value" }
66
+ ```
67
+
68
+ </ResponseExample>
69
+
70
+ </Api>
@@ -0,0 +1,72 @@
1
+ ---
2
+ title: Find pets by status
3
+ description: Find pets filtered by status.
4
+ icon: paw-print
5
+ layout: api
6
+ method: GET
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample, EnumValues, Enum } from '$lib';
11
+ </script>
12
+
13
+ # Find pets by status
14
+
15
+ Multiple status values can be provided as comma separated strings.
16
+
17
+ <Api>
18
+
19
+ <Endpoint method="GET" path="/pet/findByStatus" baseUrl="https://petstore3.swagger.io/api/v3" />
20
+
21
+ ## Query parameters
22
+
23
+ <ParamField name="status" type="enum" default="available">
24
+
25
+ The status to filter by.
26
+
27
+ <EnumValues>
28
+ <Enum value="available">Available for purchase.</Enum>
29
+ <Enum value="pending">Reserved, sale in progress.</Enum>
30
+ <Enum value="sold">Already sold.</Enum>
31
+ </EnumValues>
32
+
33
+ </ParamField>
34
+
35
+ ## Returns
36
+
37
+ Returns an array of [Pet](/api/pet/pet-object) objects.
38
+
39
+ <ResponseField name="data" type="Pet[]">
40
+
41
+ The pets that match the status.
42
+
43
+ </ResponseField>
44
+
45
+ <RequestExample title="cURL">
46
+
47
+ ```bash
48
+ curl "https://petstore3.swagger.io/api/v3/pet/findByStatus?status=available"
49
+ ```
50
+
51
+ </RequestExample>
52
+
53
+ <ResponseExample title="200 OK">
54
+
55
+ ```json
56
+ [
57
+ { "id": 10, "name": "doggie", "status": "available" },
58
+ { "id": 11, "name": "kitty", "status": "available" }
59
+ ]
60
+ ```
61
+
62
+ </ResponseExample>
63
+
64
+ <ResponseExample title="400 Invalid status">
65
+
66
+ ```json
67
+ { "code": 400, "message": "Invalid status value" }
68
+ ```
69
+
70
+ </ResponseExample>
71
+
72
+ </Api>
@@ -0,0 +1,64 @@
1
+ ---
2
+ title: Find pets by tags
3
+ description: Find pets filtered by tags.
4
+ icon: paw-print
5
+ layout: api
6
+ method: GET
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample } from '$lib';
11
+ </script>
12
+
13
+ # Find pets by tags
14
+
15
+ Multiple tags can be provided as comma separated strings. Use `tag1`, `tag2`,
16
+ `tag3` for testing.
17
+
18
+ <Api>
19
+
20
+ <Endpoint method="GET" path="/pet/findByTags" baseUrl="https://petstore3.swagger.io/api/v3" />
21
+
22
+ ## Query parameters
23
+
24
+ <ParamField name="tags" type="array of strings">
25
+
26
+ Tags to filter by.
27
+
28
+ </ParamField>
29
+
30
+ ## Returns
31
+
32
+ Returns an array of [Pet](/api/pet/pet-object) objects.
33
+
34
+ <ResponseField name="data" type="Pet[]">
35
+
36
+ The pets that match the tags.
37
+
38
+ </ResponseField>
39
+
40
+ <RequestExample title="cURL">
41
+
42
+ ```bash
43
+ curl "https://petstore3.swagger.io/api/v3/pet/findByTags?tags=friendly"
44
+ ```
45
+
46
+ </RequestExample>
47
+
48
+ <ResponseExample title="200 OK">
49
+
50
+ ```json
51
+ [{ "id": 10, "name": "doggie", "tags": [{ "id": 1, "name": "friendly" }] }]
52
+ ```
53
+
54
+ </ResponseExample>
55
+
56
+ <ResponseExample title="400 Invalid tag">
57
+
58
+ ```json
59
+ { "code": 400, "message": "Invalid tag value" }
60
+ ```
61
+
62
+ </ResponseExample>
63
+
64
+ </Api>
@@ -0,0 +1,99 @@
1
+ ---
2
+ title: Find pet by ID
3
+ description: Return a single pet.
4
+ icon: paw-print
5
+ layout: api
6
+ method: GET
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample, ObjectExample } from '$lib';
11
+ </script>
12
+
13
+ # Find pet by ID
14
+
15
+ Returns a single pet.
16
+
17
+ <Api>
18
+
19
+ <Endpoint method="GET" path={'/pet/{petId}'} baseUrl="https://petstore3.swagger.io/api/v3" />
20
+
21
+ ## Headers
22
+
23
+ <ParamField name="api_key" type="string">
24
+
25
+ Your store API key.
26
+
27
+ </ParamField>
28
+
29
+ ## Path parameters
30
+
31
+ <ParamField name="petId" type="integer" required>
32
+
33
+ The id of the pet to return.
34
+
35
+ </ParamField>
36
+
37
+ ## Returns
38
+
39
+ Returns the [Pet](/api/pet/pet-object).
40
+
41
+ <ResponseField name="id" type="integer">
42
+
43
+ Unique id for the pet.
44
+
45
+ </ResponseField>
46
+
47
+ <ResponseField name="name" type="string">
48
+
49
+ The pet's name.
50
+
51
+ </ResponseField>
52
+
53
+ <ResponseField name="status" type="enum">
54
+
55
+ Pet status in the store.
56
+
57
+ </ResponseField>
58
+
59
+ <RequestExample title="cURL">
60
+
61
+ ```bash
62
+ curl https://petstore3.swagger.io/api/v3/pet/10 \
63
+ -H "api_key: special-key"
64
+ ```
65
+
66
+ </RequestExample>
67
+
68
+ <ResponseExample title="200 OK">
69
+
70
+ ```json
71
+ { "id": 10, "name": "doggie", "status": "available" }
72
+ ```
73
+
74
+ </ResponseExample>
75
+
76
+ <ResponseExample title="404 Not Found">
77
+
78
+ ```json
79
+ { "code": 404, "message": "Pet not found" }
80
+ ```
81
+
82
+ </ResponseExample>
83
+
84
+ <ObjectExample title="The Pet object">
85
+
86
+ ```json
87
+ {
88
+ "id": 10,
89
+ "name": "doggie",
90
+ "category": { "id": 1, "name": "Dogs" },
91
+ "photoUrls": ["https://example.com/photos/doggie.png"],
92
+ "tags": [{ "id": 1, "name": "friendly" }],
93
+ "status": "available"
94
+ }
95
+ ```
96
+
97
+ </ObjectExample>
98
+
99
+ </Api>
@@ -0,0 +1,15 @@
1
+ {
2
+ "title": "Pet",
3
+ "icon": "paw-print",
4
+ "pages": [
5
+ "pet-object",
6
+ "add-pet",
7
+ "update-pet",
8
+ "find-by-status",
9
+ "find-by-tags",
10
+ "get-pet",
11
+ "update-pet-with-form",
12
+ "upload-image",
13
+ "delete-pet"
14
+ ]
15
+ }
@@ -0,0 +1,112 @@
1
+ ---
2
+ title: The Pet object
3
+ description: The shape of a Pet resource.
4
+ icon: paw-print
5
+ layout: api
6
+ ---
7
+
8
+ <script>
9
+ import { Api, ResponseField, ObjectExample, Expandable, EnumValues, Enum, Callout } from '$lib';
10
+ </script>
11
+
12
+ # The Pet object
13
+
14
+ A Pet is an animal listed in the store.
15
+
16
+ <Api>
17
+
18
+ <Callout type="info">
19
+
20
+ Pet endpoints are protected by `petstore_auth` (OAuth2) with the `read:pets` and
21
+ `write:pets` scopes. Reads also accept an `api_key` header.
22
+
23
+ </Callout>
24
+
25
+ ## Attributes
26
+
27
+ <ResponseField name="id" type="integer">
28
+
29
+ Unique id for the pet. Read only.
30
+
31
+ </ResponseField>
32
+
33
+ <ResponseField name="name" type="string" required>
34
+
35
+ The pet's name, such as `doggie`.
36
+
37
+ </ResponseField>
38
+
39
+ <ResponseField name="category" type="Category">
40
+
41
+ The category this pet belongs to.
42
+
43
+ <Expandable title="properties">
44
+ <ResponseField name="id" type="integer">
45
+
46
+ Category id.
47
+
48
+ </ResponseField>
49
+ <ResponseField name="name" type="string">
50
+
51
+ Category name, such as `Dogs`.
52
+
53
+ </ResponseField>
54
+
55
+ </Expandable>
56
+
57
+ </ResponseField>
58
+
59
+ <ResponseField name="photoUrls" type="array of strings" required>
60
+
61
+ URLs of the pet's photos.
62
+
63
+ </ResponseField>
64
+
65
+ <ResponseField name="tags" type="array of Tag">
66
+
67
+ Tags attached to the pet.
68
+
69
+ <Expandable title="properties">
70
+ <ResponseField name="id" type="integer">
71
+
72
+ Tag id.
73
+
74
+ </ResponseField>
75
+ <ResponseField name="name" type="string">
76
+
77
+ Tag name.
78
+
79
+ </ResponseField>
80
+
81
+ </Expandable>
82
+
83
+ </ResponseField>
84
+
85
+ <ResponseField name="status" type="enum">
86
+
87
+ Pet status in the store.
88
+
89
+ <EnumValues>
90
+ <Enum value="available">Available for purchase.</Enum>
91
+ <Enum value="pending">Reserved, sale in progress.</Enum>
92
+ <Enum value="sold">Already sold.</Enum>
93
+ </EnumValues>
94
+
95
+ </ResponseField>
96
+
97
+ <ObjectExample title="The Pet object">
98
+
99
+ ```json
100
+ {
101
+ "id": 10,
102
+ "name": "doggie",
103
+ "category": { "id": 1, "name": "Dogs" },
104
+ "photoUrls": ["https://example.com/photos/doggie.png"],
105
+ "tags": [{ "id": 1, "name": "friendly" }],
106
+ "status": "available"
107
+ }
108
+ ```
109
+
110
+ </ObjectExample>
111
+
112
+ </Api>
@@ -0,0 +1,69 @@
1
+ ---
2
+ title: Update a pet with form data
3
+ description: Update a pet using query parameters.
4
+ icon: paw-print
5
+ layout: api
6
+ method: POST
7
+ ---
8
+
9
+ <script>
10
+ import { Api, Endpoint, ParamField, ResponseField, RequestExample, ResponseExample } from '$lib';
11
+ </script>
12
+
13
+ # Update a pet with form data
14
+
15
+ Updates a pet resource based on the form data.
16
+
17
+ <Api>
18
+
19
+ <Endpoint method="POST" path={'/pet/{petId}'} baseUrl="https://petstore3.swagger.io/api/v3" />
20
+
21
+ ## Path parameters
22
+
23
+ <ParamField name="petId" type="integer" required>
24
+
25
+ The id of the pet that needs to be updated.
26
+
27
+ </ParamField>
28
+
29
+ ## Query parameters
30
+
31
+ <ParamField name="name" type="string">
32
+
33
+ The new name of the pet.
34
+
35
+ </ParamField>
36
+
37
+ <ParamField name="status" type="string">
38
+
39
+ The new status of the pet.
40
+
41
+ </ParamField>
42
+
43
+ ## Returns
44
+
45
+ Returns the updated [Pet](/api/pet/pet-object).
46
+
47
+ <ResponseField name="id" type="integer">
48
+
49
+ Unique id for the pet.
50
+
51
+ </ResponseField>
52
+
53
+ <RequestExample title="cURL">
54
+
55
+ ```bash
56
+ curl -X POST "https://petstore3.swagger.io/api/v3/pet/10?name=doggie&status=sold"
57
+ ```
58
+
59
+ </RequestExample>
60
+
61
+ <ResponseExample title="200 OK">
62
+
63
+ ```json
64
+ { "id": 10, "name": "doggie", "status": "sold" }
65
+ ```
66
+
67
+ </ResponseExample>
68
+
69
+ </Api>