@scalar/api-reference 1.15.6 → 1.16.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 (191) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +36 -0
  3. package/dist/browser/standalone.js +7 -7
  4. package/dist/components/Anchor/Anchor.vue.d.ts.map +1 -1
  5. package/dist/components/ApiClientModal.vue.d.ts.map +1 -1
  6. package/dist/components/ApiReferenceBase.vue.d.ts.map +1 -1
  7. package/dist/components/Content/Authentication/SecurityScheme.vue.d.ts.map +1 -1
  8. package/dist/components/Content/Authentication/SecuritySchemeSelector.vue.d.ts.map +1 -1
  9. package/dist/components/Content/{Introduction/ServerList.vue.d.ts → BaseUrl/BaseUrl.vue.d.ts} +1 -1
  10. package/dist/components/Content/BaseUrl/BaseUrl.vue.d.ts.map +1 -0
  11. package/dist/components/Content/BaseUrl/ServerItem.vue.d.ts.map +1 -0
  12. package/dist/components/Content/BaseUrl/ServerVariables.vue.d.ts.map +1 -0
  13. package/dist/components/Content/BaseUrl/index.d.ts +2 -0
  14. package/dist/components/Content/BaseUrl/index.d.ts.map +1 -0
  15. package/dist/components/Content/{Introduction/ClientList.vue.d.ts → ClientLibraries/ClientLibraries.vue.d.ts} +1 -1
  16. package/dist/components/Content/ClientLibraries/ClientLibraries.vue.d.ts.map +1 -0
  17. package/dist/components/Content/ClientLibraries/ClientSelector.vue.d.ts.map +1 -0
  18. package/dist/components/Content/ClientLibraries/index.d.ts +2 -0
  19. package/dist/components/Content/ClientLibraries/index.d.ts.map +1 -0
  20. package/dist/components/Content/Content.vue.d.ts.map +1 -1
  21. package/dist/components/Content/Introduction/Introduction.vue.d.ts.map +1 -1
  22. package/dist/components/Content/Introduction/index.d.ts +1 -1
  23. package/dist/components/Content/Introduction/index.d.ts.map +1 -1
  24. package/dist/components/Content/Models/Models.vue.d.ts.map +1 -0
  25. package/dist/components/Content/{Introduction/ServerItem.vue.d.ts.map → Models/ModelsAccordion.vue.d.ts.map} +1 -1
  26. package/dist/components/Content/Models/index.d.ts +3 -0
  27. package/dist/components/Content/Models/index.d.ts.map +1 -0
  28. package/dist/components/Content/Operation/CustomRequestExamples.vue.d.ts.map +1 -0
  29. package/dist/components/Content/Operation/EndpointDetails.vue.d.ts.map +1 -0
  30. package/dist/components/Content/{ReferenceEndpoint/EndpointDetails.vue.d.ts.map → Operation/EndpointDetailsCard.vue.d.ts.map} +1 -1
  31. package/dist/components/Content/Operation/EndpointPath.vue.d.ts.map +1 -0
  32. package/dist/components/Content/Operation/ExamplePicker.vue.d.ts.map +1 -0
  33. package/dist/components/Content/Operation/ExampleRequest.stories.d.ts.map +1 -0
  34. package/dist/components/Content/Operation/ExampleRequest.vue.d.ts.map +1 -0
  35. package/dist/components/Content/{ReferenceEndpoint/ReferenceEndpoint.vue.d.ts → Operation/Operation.vue.d.ts} +1 -1
  36. package/dist/components/Content/Operation/Operation.vue.d.ts.map +1 -0
  37. package/dist/components/Content/{ReferenceEndpoint/ReferenceEndpointAccordion.vue.d.ts → Operation/OperationAccordion.vue.d.ts} +1 -1
  38. package/dist/components/Content/Operation/OperationAccordion.vue.d.ts.map +1 -0
  39. package/dist/components/Content/Operation/ParameterItem.vue.d.ts.map +1 -0
  40. package/dist/components/Content/Operation/Parameters.vue.d.ts.map +1 -0
  41. package/dist/components/Content/Operation/PathResponses/ExampleResponse.vue.d.ts.map +1 -0
  42. package/dist/components/Content/Operation/PathResponses/Headers.vue.d.ts.map +1 -0
  43. package/dist/components/Content/Operation/PathResponses/PathResponses.vue.d.ts.map +1 -0
  44. package/dist/components/Content/Operation/PathResponses/RawSchema.vue.d.ts.map +1 -0
  45. package/dist/components/Content/Operation/PathResponses/index.d.ts.map +1 -0
  46. package/dist/components/Content/Operation/RequestBody.vue.d.ts.map +1 -0
  47. package/dist/components/Content/Operation/RequestBodyPropertiesChild.vue.d.ts.map +1 -0
  48. package/dist/components/Content/Operation/TextSelect.vue.d.ts.map +1 -0
  49. package/dist/components/Content/Operation/TryRequestButton.vue.d.ts.map +1 -0
  50. package/dist/components/Content/Operation/index.d.ts +3 -0
  51. package/dist/components/Content/Operation/index.d.ts.map +1 -0
  52. package/dist/components/Content/Schema/Schema.stories.d.ts.map +1 -0
  53. package/dist/components/Content/Schema/Schema.vue.d.ts.map +1 -0
  54. package/dist/components/Content/{Introduction/ServerList.vue.d.ts.map → Schema/SchemaHeading.vue.d.ts.map} +1 -1
  55. package/dist/components/Content/Schema/SchemaProperty.vue.d.ts.map +1 -0
  56. package/dist/components/Content/Schema/index.d.ts +4 -0
  57. package/dist/components/Content/Schema/index.d.ts.map +1 -0
  58. package/dist/components/Content/{EndpointsOverview.vue.d.ts → Tag/Endpoints.vue.d.ts} +2 -2
  59. package/dist/components/Content/Tag/Endpoints.vue.d.ts.map +1 -0
  60. package/dist/components/Content/{ReferenceTag.vue.d.ts → Tag/Tag.vue.d.ts} +2 -2
  61. package/dist/components/Content/Tag/Tag.vue.d.ts.map +1 -0
  62. package/dist/components/Content/{ReferenceTagAccordion.vue.d.ts → Tag/TagAccordion.vue.d.ts} +2 -2
  63. package/dist/components/Content/Tag/TagAccordion.vue.d.ts.map +1 -0
  64. package/dist/components/Content/Tag/index.d.ts +3 -0
  65. package/dist/components/Content/Tag/index.d.ts.map +1 -0
  66. package/dist/components/Content/{Webhook.vue.d.ts → Webhooks/Webhook.vue.d.ts} +1 -1
  67. package/dist/components/Content/Webhooks/Webhook.vue.d.ts.map +1 -0
  68. package/dist/components/Content/{Webhooks.vue.d.ts → Webhooks/Webhooks.vue.d.ts} +1 -1
  69. package/dist/components/Content/Webhooks/Webhooks.vue.d.ts.map +1 -0
  70. package/dist/components/Content/Webhooks/index.d.ts +2 -0
  71. package/dist/components/Content/Webhooks/index.d.ts.map +1 -0
  72. package/dist/components/DarkModeToggle/DarkModeIconToggle.vue.d.ts.map +1 -0
  73. package/dist/components/DarkModeToggle/DarkModeToggle.vue.d.ts.map +1 -0
  74. package/dist/components/DarkModeToggle/index.d.ts +3 -0
  75. package/dist/components/DarkModeToggle/index.d.ts.map +1 -0
  76. package/dist/components/{Content → MarkdownRenderer}/MarkdownRenderer.stories.d.ts +1 -1
  77. package/dist/components/MarkdownRenderer/MarkdownRenderer.stories.d.ts.map +1 -0
  78. package/dist/components/MarkdownRenderer/MarkdownRenderer.vue.d.ts.map +1 -0
  79. package/dist/components/MarkdownRenderer/index.d.ts +2 -0
  80. package/dist/components/MarkdownRenderer/index.d.ts.map +1 -0
  81. package/dist/components/{Content/EndpointsOverview.vue.d.ts.map → ShowMoreButton.vue.d.ts.map} +1 -1
  82. package/dist/components/{Sidebar.vue.d.ts → Sidebar/Sidebar.vue.d.ts} +1 -1
  83. package/dist/components/{Content/ReferenceEndpoint/TextSelect.vue.d.ts.map → Sidebar/Sidebar.vue.d.ts.map} +1 -1
  84. package/dist/components/Sidebar/SidebarElement.vue.d.ts.map +1 -0
  85. package/dist/components/Sidebar/SidebarGroup.vue.d.ts.map +1 -0
  86. package/dist/components/Sidebar/index.d.ts +2 -0
  87. package/dist/components/Sidebar/index.d.ts.map +1 -0
  88. package/dist/components/{Content → Spinner}/Spinner.stories.d.ts.map +1 -1
  89. package/dist/components/Spinner/Spinner.vue.d.ts.map +1 -0
  90. package/dist/components/Spinner/index.d.ts +2 -0
  91. package/dist/components/Spinner/index.d.ts.map +1 -0
  92. package/dist/helpers/getApiClientRequest.d.ts.map +1 -1
  93. package/dist/helpers/getExampleFromSchema.d.ts.map +1 -1
  94. package/dist/helpers/getParametersFromOperation.d.ts.map +1 -1
  95. package/dist/helpers/getRequestFromAuthentication.d.ts.map +1 -1
  96. package/dist/helpers/getRequestFromOperation.d.ts +1 -0
  97. package/dist/helpers/getRequestFromOperation.d.ts.map +1 -1
  98. package/dist/helpers/getUrlFromServerState.d.ts +3 -0
  99. package/dist/helpers/getUrlFromServerState.d.ts.map +1 -1
  100. package/dist/hooks/index.d.ts +3 -2
  101. package/dist/hooks/index.d.ts.map +1 -1
  102. package/dist/hooks/useClipboard.d.ts +4 -0
  103. package/dist/hooks/useClipboard.d.ts.map +1 -0
  104. package/dist/hooks/useSidebar.d.ts.map +1 -1
  105. package/dist/{index-fc7fc2e0.js → index-547cc214.js} +22436 -22416
  106. package/dist/{index-a8d9f352.js → index-b9de9a61.js} +9 -9
  107. package/dist/index.d.ts +2 -4
  108. package/dist/index.d.ts.map +1 -1
  109. package/dist/index.js +46 -47
  110. package/dist/types.d.ts +10 -8
  111. package/dist/types.d.ts.map +1 -1
  112. package/package.json +12 -14
  113. package/dist/components/Content/Introduction/ClientList.vue.d.ts.map +0 -1
  114. package/dist/components/Content/Introduction/ClientSelector.vue.d.ts.map +0 -1
  115. package/dist/components/Content/Introduction/ServerVariables.vue.d.ts.map +0 -1
  116. package/dist/components/Content/MarkdownRenderer.stories.d.ts.map +0 -1
  117. package/dist/components/Content/MarkdownRenderer.vue.d.ts.map +0 -1
  118. package/dist/components/Content/Models.vue.d.ts.map +0 -1
  119. package/dist/components/Content/ModelsAccordion.vue.d.ts.map +0 -1
  120. package/dist/components/Content/ReferenceEndpoint/CustomRequestExamples.vue.d.ts.map +0 -1
  121. package/dist/components/Content/ReferenceEndpoint/EndpointDetailsCard.vue.d.ts.map +0 -1
  122. package/dist/components/Content/ReferenceEndpoint/EndpointPath.vue.d.ts.map +0 -1
  123. package/dist/components/Content/ReferenceEndpoint/ExamplePicker.vue.d.ts.map +0 -1
  124. package/dist/components/Content/ReferenceEndpoint/ExampleRequest.stories.d.ts.map +0 -1
  125. package/dist/components/Content/ReferenceEndpoint/ExampleRequest.vue.d.ts.map +0 -1
  126. package/dist/components/Content/ReferenceEndpoint/ParameterItem.vue.d.ts.map +0 -1
  127. package/dist/components/Content/ReferenceEndpoint/Parameters.vue.d.ts.map +0 -1
  128. package/dist/components/Content/ReferenceEndpoint/PathResponses/ExampleResponse.vue.d.ts.map +0 -1
  129. package/dist/components/Content/ReferenceEndpoint/PathResponses/Headers.vue.d.ts.map +0 -1
  130. package/dist/components/Content/ReferenceEndpoint/PathResponses/PathResponses.vue.d.ts.map +0 -1
  131. package/dist/components/Content/ReferenceEndpoint/PathResponses/RawSchema.vue.d.ts.map +0 -1
  132. package/dist/components/Content/ReferenceEndpoint/PathResponses/index.d.ts.map +0 -1
  133. package/dist/components/Content/ReferenceEndpoint/ReferenceEndpoint.vue.d.ts.map +0 -1
  134. package/dist/components/Content/ReferenceEndpoint/ReferenceEndpointAccordion.vue.d.ts.map +0 -1
  135. package/dist/components/Content/ReferenceEndpoint/RequestBody.vue.d.ts.map +0 -1
  136. package/dist/components/Content/ReferenceEndpoint/RequestBodyPropertiesChild.vue.d.ts.map +0 -1
  137. package/dist/components/Content/ReferenceEndpoint/TryRequestButton.vue.d.ts.map +0 -1
  138. package/dist/components/Content/ReferenceEndpoint/index.d.ts +0 -2
  139. package/dist/components/Content/ReferenceEndpoint/index.d.ts.map +0 -1
  140. package/dist/components/Content/ReferenceTag.vue.d.ts.map +0 -1
  141. package/dist/components/Content/ReferenceTagAccordion.vue.d.ts.map +0 -1
  142. package/dist/components/Content/Schema.stories.d.ts.map +0 -1
  143. package/dist/components/Content/Schema.vue.d.ts.map +0 -1
  144. package/dist/components/Content/SchemaHeading.vue.d.ts.map +0 -1
  145. package/dist/components/Content/SchemaProperty.vue.d.ts.map +0 -1
  146. package/dist/components/Content/ShowMoreButton.vue.d.ts.map +0 -1
  147. package/dist/components/Content/SpecDownload.vue.d.ts +0 -16
  148. package/dist/components/Content/SpecDownload.vue.d.ts.map +0 -1
  149. package/dist/components/Content/Spinner.vue.d.ts.map +0 -1
  150. package/dist/components/Content/Webhook.vue.d.ts.map +0 -1
  151. package/dist/components/Content/Webhooks.vue.d.ts.map +0 -1
  152. package/dist/components/DarkModeIconToggle.vue.d.ts.map +0 -1
  153. package/dist/components/DarkModeToggle.vue.d.ts.map +0 -1
  154. package/dist/components/Sidebar.vue.d.ts.map +0 -1
  155. package/dist/components/SidebarElement.vue.d.ts.map +0 -1
  156. package/dist/components/SidebarGroup.vue.d.ts.map +0 -1
  157. /package/dist/components/Content/{Introduction → BaseUrl}/ServerItem.vue.d.ts +0 -0
  158. /package/dist/components/Content/{Introduction → BaseUrl}/ServerVariables.vue.d.ts +0 -0
  159. /package/dist/components/Content/{Introduction → ClientLibraries}/ClientSelector.vue.d.ts +0 -0
  160. /package/dist/components/Content/{Models.vue.d.ts → Models/Models.vue.d.ts} +0 -0
  161. /package/dist/components/Content/{ModelsAccordion.vue.d.ts → Models/ModelsAccordion.vue.d.ts} +0 -0
  162. /package/dist/components/Content/{ReferenceEndpoint → Operation}/CustomRequestExamples.vue.d.ts +0 -0
  163. /package/dist/components/Content/{ReferenceEndpoint → Operation}/EndpointDetails.vue.d.ts +0 -0
  164. /package/dist/components/Content/{ReferenceEndpoint → Operation}/EndpointDetailsCard.vue.d.ts +0 -0
  165. /package/dist/components/Content/{ReferenceEndpoint → Operation}/EndpointPath.vue.d.ts +0 -0
  166. /package/dist/components/Content/{ReferenceEndpoint → Operation}/ExamplePicker.vue.d.ts +0 -0
  167. /package/dist/components/Content/{ReferenceEndpoint → Operation}/ExampleRequest.stories.d.ts +0 -0
  168. /package/dist/components/Content/{ReferenceEndpoint → Operation}/ExampleRequest.vue.d.ts +0 -0
  169. /package/dist/components/Content/{ReferenceEndpoint → Operation}/ParameterItem.vue.d.ts +0 -0
  170. /package/dist/components/Content/{ReferenceEndpoint → Operation}/Parameters.vue.d.ts +0 -0
  171. /package/dist/components/Content/{ReferenceEndpoint → Operation}/PathResponses/ExampleResponse.vue.d.ts +0 -0
  172. /package/dist/components/Content/{ReferenceEndpoint → Operation}/PathResponses/Headers.vue.d.ts +0 -0
  173. /package/dist/components/Content/{ReferenceEndpoint → Operation}/PathResponses/PathResponses.vue.d.ts +0 -0
  174. /package/dist/components/Content/{ReferenceEndpoint → Operation}/PathResponses/RawSchema.vue.d.ts +0 -0
  175. /package/dist/components/Content/{ReferenceEndpoint → Operation}/PathResponses/index.d.ts +0 -0
  176. /package/dist/components/Content/{ReferenceEndpoint → Operation}/RequestBody.vue.d.ts +0 -0
  177. /package/dist/components/Content/{ReferenceEndpoint → Operation}/RequestBodyPropertiesChild.vue.d.ts +0 -0
  178. /package/dist/components/Content/{ReferenceEndpoint → Operation}/TextSelect.vue.d.ts +0 -0
  179. /package/dist/components/Content/{ReferenceEndpoint → Operation}/TryRequestButton.vue.d.ts +0 -0
  180. /package/dist/components/Content/{Schema.stories.d.ts → Schema/Schema.stories.d.ts} +0 -0
  181. /package/dist/components/Content/{Schema.vue.d.ts → Schema/Schema.vue.d.ts} +0 -0
  182. /package/dist/components/Content/{SchemaHeading.vue.d.ts → Schema/SchemaHeading.vue.d.ts} +0 -0
  183. /package/dist/components/Content/{SchemaProperty.vue.d.ts → Schema/SchemaProperty.vue.d.ts} +0 -0
  184. /package/dist/components/{DarkModeIconToggle.vue.d.ts → DarkModeToggle/DarkModeIconToggle.vue.d.ts} +0 -0
  185. /package/dist/components/{DarkModeToggle.vue.d.ts → DarkModeToggle/DarkModeToggle.vue.d.ts} +0 -0
  186. /package/dist/components/{Content → MarkdownRenderer}/MarkdownRenderer.vue.d.ts +0 -0
  187. /package/dist/components/{Content/ShowMoreButton.vue.d.ts → ShowMoreButton.vue.d.ts} +0 -0
  188. /package/dist/components/{SidebarElement.vue.d.ts → Sidebar/SidebarElement.vue.d.ts} +0 -0
  189. /package/dist/components/{SidebarGroup.vue.d.ts → Sidebar/SidebarGroup.vue.d.ts} +0 -0
  190. /package/dist/components/{Content → Spinner}/Spinner.stories.d.ts +0 -0
  191. /package/dist/components/{Content → Spinner}/Spinner.vue.d.ts +0 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,31 @@
1
1
  # @scalar/api-reference
2
2
 
3
+ ## 1.16.0
4
+
5
+ ### Minor Changes
6
+
7
+ - e0faebb: feat: add show more button to request variables and path params
8
+
9
+ ### Patch Changes
10
+
11
+ - 92a8b9f: chore: update dependencies
12
+ - 230f9fb: feat: prefill the authentication data
13
+ - 77c62d3: fix: path isn’t prefixed (https://github.com/scalar/scalar/issues/937)
14
+ - Updated dependencies [e0faebb]
15
+ - Updated dependencies [92a8b9f]
16
+ - Updated dependencies [abfb086]
17
+ - Updated dependencies [76f4041]
18
+ - @scalar/api-client@0.12.0
19
+ - @scalar/use-keyboard-event@0.5.9
20
+ - @scalar/swagger-editor@0.10.5
21
+ - @scalar/swagger-parser@0.5.16
22
+ - @scalar/use-codemirror@0.8.4
23
+ - @scalar/use-tooltip@0.5.9
24
+ - @scalar/components@0.2.3
25
+ - @scalar/use-toasts@0.5.14
26
+ - @scalar/use-modal@0.2.4
27
+ - @scalar/themes@0.5.5
28
+
3
29
  ## 1.15.6
4
30
 
5
31
  ### Patch Changes
package/README.md CHANGED
@@ -154,3 +154,39 @@ You can listen to spec changes with onSpecUpdate that runs on spec/swagger conte
154
154
  }
155
155
  } />
156
156
  ```
157
+
158
+ #### authentication?: Partial<AuthenticationState>
159
+
160
+ To make authentication easier you can prefill the credentials for your users:
161
+
162
+ ````vue
163
+ <ApiReference :configuration="{
164
+ authentication: {
165
+ // The OpenAPI file has keys for all security schemes
166
+ // Which one should be used by default?
167
+ securitySchemeKey: 'api_key',
168
+ // Okay, the `api_key` security scheme is of type `apiKey`, so prefill the token:
169
+ apiKey: {
170
+ token: 'super-secret-token',
171
+ },
172
+ },
173
+ } />
174
+ ``
175
+
176
+ For OpenAuth2 it’s more looking like this:
177
+
178
+ ```vue
179
+ <ApiReference :configuration="{
180
+ authentication: {
181
+ // The OpenAPI file has keys for all security schemes
182
+ // Which one should be used by default?
183
+ securitySchemeKey: 'petstore_auth',
184
+ // Okay, the `api_key` security scheme is of type `oAuth2`, so prefill the client id and the scopes:
185
+ oAuth2: {
186
+ clientId: 'foobar123',
187
+ // optional:
188
+ scopes: ['read:pets', 'write:pets'],
189
+ },
190
+ },
191
+ } />
192
+ ````