@scalar/api-reference 1.34.1 → 1.34.4

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 (113) hide show
  1. package/CHANGELOG.md +99 -0
  2. package/README.md +1 -1
  3. package/dist/browser/standalone.js +13121 -12730
  4. package/dist/browser/webpack-stats.json +1 -1
  5. package/dist/components/Badge/Badge.vue.d.ts +4 -1
  6. package/dist/components/Badge/Badge.vue.d.ts.map +1 -1
  7. package/dist/components/Badge/Badge.vue.js +5 -11
  8. package/dist/components/Badge/Badge.vue2.js +22 -2
  9. package/dist/components/Badge/Badge.vue3.js +4 -0
  10. package/dist/components/Content/ClientLibraries/ClientLibraries.vue.d.ts +1 -1
  11. package/dist/components/Content/ClientLibraries/ClientLibraries.vue.d.ts.map +1 -1
  12. package/dist/components/Content/ClientLibraries/ClientLibraries.vue.js +1 -1
  13. package/dist/components/Content/Models/Models.vue.d.ts.map +1 -1
  14. package/dist/components/Content/Models/Models.vue.js +30 -31
  15. package/dist/components/Content/Models/ModernLayout.vue.d.ts +2 -0
  16. package/dist/components/Content/Models/ModernLayout.vue.d.ts.map +1 -1
  17. package/dist/components/Content/Models/ModernLayout.vue.js +2 -2
  18. package/dist/components/Content/Models/ModernLayout.vue2.js +39 -37
  19. package/dist/components/Content/Operations/TraversedEntry.vue.js +12 -12
  20. package/dist/components/Content/Tags/TagSection.vue.js +6 -6
  21. package/dist/components/GettingStarted.vue.js +3 -3
  22. package/dist/components/GettingStarted.vue2.js +21 -21
  23. package/dist/components/MobileHeader.vue.d.ts.map +1 -1
  24. package/dist/components/MobileHeader.vue.js +3 -3
  25. package/dist/components/Section/CompactSection.vue.d.ts +2 -0
  26. package/dist/components/Section/CompactSection.vue.d.ts.map +1 -1
  27. package/dist/components/Section/CompactSection.vue.js +1 -1
  28. package/dist/components/Section/CompactSection.vue2.js +30 -29
  29. package/dist/features/Operation/Operation.vue.d.ts +2 -1
  30. package/dist/features/Operation/Operation.vue.d.ts.map +1 -1
  31. package/dist/features/Operation/Operation.vue.js +53 -52
  32. package/dist/features/Operation/components/callbacks/Callback.vue.d.ts +1 -2
  33. package/dist/features/Operation/components/callbacks/Callback.vue.d.ts.map +1 -1
  34. package/dist/features/Operation/components/callbacks/Callback.vue.js +3 -3
  35. package/dist/features/Operation/components/callbacks/Callback.vue3.js +2 -2
  36. package/dist/features/Operation/components/callbacks/Callbacks.vue.d.ts.map +1 -1
  37. package/dist/features/Operation/components/callbacks/Callbacks.vue.js +16 -16
  38. package/dist/features/Operation/helpers/combine-params.d.ts +5 -0
  39. package/dist/features/Operation/helpers/combine-params.d.ts.map +1 -0
  40. package/dist/features/Operation/helpers/combine-params.js +13 -0
  41. package/dist/features/Operation/layouts/ClassicLayout.vue.d.ts +3 -4
  42. package/dist/features/Operation/layouts/ClassicLayout.vue.d.ts.map +1 -1
  43. package/dist/features/Operation/layouts/ClassicLayout.vue.js +2 -2
  44. package/dist/features/Operation/layouts/ClassicLayout.vue2.js +59 -50
  45. package/dist/features/Operation/layouts/ClassicLayout.vue3.js +2 -2
  46. package/dist/features/Operation/layouts/ModernLayout.vue.d.ts +3 -4
  47. package/dist/features/Operation/layouts/ModernLayout.vue.d.ts.map +1 -1
  48. package/dist/features/Operation/layouts/ModernLayout.vue.js +2 -2
  49. package/dist/features/Operation/layouts/ModernLayout.vue2.js +94 -78
  50. package/dist/features/Search/helpers/create-fuse-instance.d.ts.map +1 -1
  51. package/dist/features/Search/helpers/create-fuse-instance.js +0 -3
  52. package/dist/features/api-client-modal/ApiClientModal.vue.d.ts.map +1 -1
  53. package/dist/features/api-client-modal/ApiClientModal.vue.js +51 -48
  54. package/dist/features/api-client-modal/useApiClient.d.ts +100 -100
  55. package/dist/features/api-client-modal/useApiClient.d.ts.map +1 -1
  56. package/dist/features/document-source/hooks/useDocumentFetcher.d.ts.map +1 -1
  57. package/dist/features/document-source/hooks/useDocumentFetcher.js +16 -18
  58. package/dist/features/document-source/hooks/useDocumentSource.d.ts.map +1 -1
  59. package/dist/features/document-source/hooks/useDocumentSource.js +30 -33
  60. package/dist/features/example-responses/ExampleResponse.vue.d.ts +1 -1
  61. package/dist/features/example-responses/ExampleResponse.vue.d.ts.map +1 -1
  62. package/dist/features/example-responses/ExampleResponse.vue.js +2 -2
  63. package/dist/features/example-responses/ExampleResponse.vue2.js +15 -13
  64. package/dist/features/example-responses/ExampleResponses.vue.d.ts +2 -3
  65. package/dist/features/example-responses/ExampleResponses.vue.d.ts.map +1 -1
  66. package/dist/features/example-responses/ExampleResponses.vue.js +2 -2
  67. package/dist/features/example-responses/ExampleResponses.vue2.js +73 -69
  68. package/dist/features/example-responses/helpers/get-resolved-ref-deep.d.ts +26 -0
  69. package/dist/features/example-responses/helpers/get-resolved-ref-deep.d.ts.map +1 -0
  70. package/dist/features/example-responses/helpers/get-resolved-ref-deep.js +29 -0
  71. package/dist/features/sidebar/components/SidebarElement.vue.d.ts.map +1 -1
  72. package/dist/features/sidebar/components/SidebarElement.vue.js +1 -1
  73. package/dist/features/sidebar/components/SidebarElement.vue2.js +6 -6
  74. package/dist/features/sidebar/helpers/create-sidebar.d.ts.map +1 -1
  75. package/dist/features/sidebar/helpers/create-sidebar.js +13 -14
  76. package/dist/features/traverse-schema/helpers/traverse-paths.d.ts +1 -2
  77. package/dist/features/traverse-schema/helpers/traverse-paths.d.ts.map +1 -1
  78. package/dist/features/traverse-schema/helpers/traverse-schemas.d.ts.map +1 -1
  79. package/dist/features/traverse-schema/helpers/traverse-tags.d.ts.map +1 -1
  80. package/dist/features/traverse-schema/helpers/traverse-webhooks.d.ts.map +1 -1
  81. package/dist/features/traverse-schema/types.d.ts +11 -12
  82. package/dist/features/traverse-schema/types.d.ts.map +1 -1
  83. package/dist/features/x-badges/XBadges.vue.d.ts +8 -0
  84. package/dist/features/x-badges/XBadges.vue.d.ts.map +1 -0
  85. package/dist/features/x-badges/XBadges.vue.js +26 -0
  86. package/dist/features/x-badges/XBadges.vue2.js +4 -0
  87. package/dist/features/x-badges/index.d.ts +2 -0
  88. package/dist/features/x-badges/index.d.ts.map +1 -0
  89. package/dist/helpers/test-utils.d.ts +1 -1
  90. package/dist/helpers/test-utils.d.ts.map +1 -1
  91. package/dist/hooks/useNavState.d.ts +1 -2
  92. package/dist/hooks/useNavState.d.ts.map +1 -1
  93. package/dist/index.js +1 -1
  94. package/dist/libs/openapi.d.ts +4 -14
  95. package/dist/libs/openapi.d.ts.map +1 -1
  96. package/dist/libs/openapi.js +55 -36
  97. package/dist/style.css +1 -1
  98. package/dist/v2/ApiReferenceWorkspace.vue.d.ts.map +1 -1
  99. package/dist/v2/ApiReferenceWorkspace.vue.js +64 -64
  100. package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue.d.ts +1 -2
  101. package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue.d.ts.map +1 -1
  102. package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue.js +2 -2
  103. package/dist/v2/blocks/scalar-request-example-block/components/RequestExample.vue2.js +97 -100
  104. package/dist/v2/blocks/scalar-request-example-block/helpers/generate-code-snippet.d.ts +1 -2
  105. package/dist/v2/blocks/scalar-request-example-block/helpers/generate-code-snippet.d.ts.map +1 -1
  106. package/dist/v2/blocks/scalar-request-example-block/helpers/generate-code-snippet.js +17 -20
  107. package/dist/v2/blocks/scalar-request-example-block/helpers/get-secrets.d.ts.map +1 -1
  108. package/dist/v2/helpers/map-configuration.d.ts +66 -0
  109. package/dist/v2/helpers/map-configuration.d.ts.map +1 -0
  110. package/dist/v2/helpers/map-configuration.js +53 -0
  111. package/dist/vitest.setup.d.ts +2 -0
  112. package/dist/vitest.setup.d.ts.map +1 -0
  113. package/package.json +24 -20
@@ -1,29 +1,26 @@
1
- import { operationToHar as u } from "@scalar/oas-utils/helpers/operation-to-har";
2
- import { isReference as d } from "@scalar/workspace-store/schemas/v3.1/type-guard";
1
+ import { operationToHar as f } from "@scalar/oas-utils/helpers/operation-to-har";
3
2
  import { getSnippet as l } from "@scalar/api-client/views/Components/CodeSnippet";
4
- const S = ({
5
- clientId: t,
6
- operation: e,
3
+ const K = ({
4
+ clientId: r,
5
+ operation: t,
7
6
  method: o,
8
7
  path: n,
9
- example: i,
10
- contentType: p,
11
- server: s,
12
- securitySchemes: a
8
+ example: p,
9
+ contentType: i,
10
+ server: a,
11
+ securitySchemes: s
13
12
  }) => {
14
- if (d(e))
15
- return "";
16
- const c = u({
17
- operation: e,
18
- contentType: p,
13
+ const c = f({
14
+ operation: t,
15
+ contentType: i,
19
16
  method: o,
20
17
  path: n,
21
- server: s,
22
- securitySchemes: a,
23
- example: i
24
- }), [m, f] = t.split("/"), [r, g] = l(m, f, c);
25
- return r ? r.message ?? "Error generating code snippet" : g;
18
+ server: a,
19
+ securitySchemes: s,
20
+ example: p
21
+ }), [g, m] = r.split("/"), [e, d] = l(g, m, c);
22
+ return e ? e.message ?? "Error generating code snippet" : d;
26
23
  };
27
24
  export {
28
- S as generateCodeSnippet
25
+ K as generateCodeSnippet
29
26
  };
@@ -1 +1 @@
1
- {"version":3,"file":"get-secrets.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/get-secrets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAA;AAEvG,4CAA4C;AAC5C,eAAO,MAAM,UAAU,oBAAqB,oBAAoB,EAAE,KAqBxC,MAAM,EAAE,CAAA"}
1
+ {"version":3,"file":"get-secrets.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-request-example-block/helpers/get-secrets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAA;AAEvG,4CAA4C;AAC5C,eAAO,MAAM,UAAU,oBAAqB,oBAAoB,EAAE,KAAG,MAAM,EAqBrD,CAAA"}
@@ -0,0 +1,66 @@
1
+ import type { ApiReferenceConfiguration } from '@scalar/types';
2
+ /**
3
+ * Maps a partial ApiReferenceConfigurationWithSources object to a DocumentConfiguration
4
+ * for use in the API Reference. This function transforms configuration options
5
+ * into the expected structure for the 'x-scalar-reference-config' property.
6
+ *
7
+ * @param config - Partial configuration object for the API Reference
8
+ * @returns DocumentConfiguration object with mapped settings
9
+ */
10
+ export declare const mapConfiguration: (config: Partial<ApiReferenceConfiguration>) => {
11
+ 'x-scalar-reference-config': {
12
+ title: string | undefined;
13
+ slug: string | undefined;
14
+ features: {
15
+ showModels: boolean;
16
+ expandAllTagSections: boolean | undefined;
17
+ persistAuthenticationState: boolean | undefined;
18
+ showDarkModeToggle: boolean;
19
+ showDownload: boolean;
20
+ showSearch: boolean;
21
+ showSidebar: boolean | undefined;
22
+ showTestRequestButton: boolean;
23
+ };
24
+ appearance: {
25
+ css: string | undefined;
26
+ favicon: string | undefined;
27
+ forceColorMode: "dark" | "light" | undefined;
28
+ initialColorMode: "dark" | undefined;
29
+ layout: "modern" | "classic" | undefined;
30
+ loadDefaultFonts: boolean | undefined;
31
+ theme: "alternate" | "default" | "moon" | "purple" | "solarized" | "bluePlanet" | "deepSpace" | "saturn" | "kepler" | "elysiajs" | "fastify" | "mars" | "laserwave" | "none" | undefined;
32
+ };
33
+ routing: {
34
+ basePath: string | undefined;
35
+ };
36
+ settings: {
37
+ proxyUrl: string | undefined;
38
+ searchKey: "a" | "b" | "i" | "p" | "q" | "s" | "u" | "g" | "c" | "r" | "d" | "e" | "f" | "h" | "j" | "k" | "l" | "m" | "n" | "o" | "t" | "v" | "w" | "x" | "y" | "z" | undefined;
39
+ baseServerUrl: string | undefined;
40
+ servers: any[] | undefined;
41
+ };
42
+ meta: any;
43
+ tagSort: "alpha" | ((args_0: any, args_1: any, ...args: unknown[]) => number) | undefined;
44
+ operationsSorter: "alpha" | "method" | ((args_0: any, args_1: any, ...args: unknown[]) => number) | undefined;
45
+ generateHeadingSlug: ((args_0: {
46
+ slug?: string | undefined;
47
+ }, ...args: unknown[]) => string) | undefined;
48
+ generateModelSlug: ((args_0: {
49
+ name?: string | undefined;
50
+ }, ...args: unknown[]) => string) | undefined;
51
+ generateOperationSlug: ((args_0: {
52
+ path: string;
53
+ method: string;
54
+ operationId?: string | undefined;
55
+ summary?: string | undefined;
56
+ }, ...args: unknown[]) => string) | undefined;
57
+ generateTagSlug: ((args_0: {
58
+ name?: string | undefined;
59
+ }, ...args: unknown[]) => string) | undefined;
60
+ generateWebhookSlug: ((args_0: {
61
+ name: string;
62
+ method?: string | undefined;
63
+ }, ...args: unknown[]) => string) | undefined;
64
+ };
65
+ };
66
+ //# sourceMappingURL=map-configuration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"map-configuration.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/map-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAG9D;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,WAAY,OAAO,CAAC,yBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAiD65yC,CAAC;;;gBAAyH,CAAC;;;;;uBAA0S,CAAC;mBAAqC,CAAC;;;gBAA1N,CAAC;;;;kBAA4W,CAAC;;;CADvk0C,CAAA"}
@@ -0,0 +1,53 @@
1
+ const a = (e) => {
2
+ var t;
3
+ return {
4
+ "x-scalar-reference-config": {
5
+ title: e.title,
6
+ slug: e.slug,
7
+ features: {
8
+ // Feature toggles for UI elements and behaviors
9
+ showModels: !e.hideModels,
10
+ expandAllTagSections: e.defaultOpenAllTags,
11
+ persistAuthenticationState: e.persistAuth,
12
+ showDarkModeToggle: !e.hideDarkModeToggle,
13
+ showDownload: !e.hideDownloadButton,
14
+ showSearch: !e.hideSearch,
15
+ showSidebar: e.showSidebar,
16
+ showTestRequestButton: !e.hideTestRequestButton
17
+ },
18
+ appearance: {
19
+ // Appearance-related configuration
20
+ css: e.customCss,
21
+ favicon: e.favicon,
22
+ forceColorMode: e.forceDarkModeState,
23
+ initialColorMode: e.darkMode ? "dark" : void 0,
24
+ layout: e.layout,
25
+ loadDefaultFonts: e.withDefaultFonts,
26
+ theme: e.theme
27
+ },
28
+ routing: {
29
+ // Routing configuration
30
+ basePath: (t = e.pathRouting) == null ? void 0 : t.basePath
31
+ },
32
+ settings: {
33
+ // Miscellaneous settings
34
+ proxyUrl: e.proxyUrl,
35
+ searchKey: e.searchHotKey,
36
+ baseServerUrl: e.baseServerURL,
37
+ servers: e.servers
38
+ },
39
+ meta: e.metaData,
40
+ // In memory configuration
41
+ tagSort: e.tagsSorter,
42
+ operationsSorter: e.operationsSorter,
43
+ generateHeadingSlug: e.generateHeadingSlug,
44
+ generateModelSlug: e.generateModelSlug,
45
+ generateOperationSlug: e.generateOperationSlug,
46
+ generateTagSlug: e.generateTagSlug,
47
+ generateWebhookSlug: e.generateWebhookSlug
48
+ }
49
+ };
50
+ };
51
+ export {
52
+ a as mapConfiguration
53
+ };
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=vitest.setup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vitest.setup.d.ts","sourceRoot":"","sources":["../src/vitest.setup.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -20,7 +20,7 @@
20
20
  "vue",
21
21
  "vue3"
22
22
  ],
23
- "version": "1.34.1",
23
+ "version": "1.34.4",
24
24
  "engines": {
25
25
  "node": ">=20"
26
26
  },
@@ -55,28 +55,32 @@
55
55
  "vue": "^3.5.17",
56
56
  "zod": "3.24.1",
57
57
  "@scalar/code-highlight": "0.1.9",
58
- "@scalar/helpers": "0.0.7",
59
- "@scalar/api-client": "2.5.22",
60
- "@scalar/icons": "0.4.6",
61
- "@scalar/components": "0.14.23",
62
- "@scalar/object-utils": "1.2.3",
63
- "@scalar/openapi-parser": "0.19.0",
58
+ "@scalar/components": "0.14.25",
59
+ "@scalar/api-client": "2.5.24",
60
+ "@scalar/helpers": "0.0.8",
61
+ "@scalar/icons": "0.4.7",
62
+ "@scalar/oas-utils": "0.4.20",
63
+ "@scalar/object-utils": "1.2.4",
64
+ "@scalar/json-magic": "0.3.0",
65
+ "@scalar/snippetz": "0.4.5",
66
+ "@scalar/openapi-parser": "0.20.0",
67
+ "@scalar/types": "0.2.12",
68
+ "@scalar/themes": "0.13.13",
69
+ "@scalar/use-hooks": "0.2.4",
64
70
  "@scalar/openapi-types": "0.3.7",
65
- "@scalar/oas-utils": "0.4.18",
66
- "@scalar/types": "0.2.11",
67
- "@scalar/snippetz": "0.4.4",
68
71
  "@scalar/use-toasts": "0.8.0",
69
- "@scalar/use-hooks": "0.2.4",
70
- "@scalar/workspace-store": "0.12.0",
71
- "@scalar/themes": "0.13.12"
72
+ "@scalar/workspace-store": "0.14.0"
72
73
  },
73
74
  "devDependencies": {
75
+ "@hono/node-server": "^1.11.0",
76
+ "@playwright/test": "1.54.0",
74
77
  "@tailwindcss/vite": "^4.1.7",
75
78
  "@types/react": "^19.1.8",
76
79
  "@types/react-dom": "^19.1.6",
77
80
  "@vitejs/plugin-vue": "^5.2.4",
78
81
  "@vue/server-renderer": "^3.5.17",
79
82
  "@vue/test-utils": "^2.4.1",
83
+ "hono": "^4.6.5",
80
84
  "react": "^19.1.0",
81
85
  "react-dom": "^19.1.0",
82
86
  "rollup-plugin-webpack-stats": "^0.2.5",
@@ -85,13 +89,10 @@
85
89
  "vite-plugin-banner": "^0.7.1",
86
90
  "vite-plugin-css-injected-by-js": "^3.4.0",
87
91
  "vitest": "^3.2.4",
88
- "@hono/node-server": "^1.11.0",
89
- "@playwright/test": "^1.49.1",
90
- "hono": "^4.6.5",
91
- "@scalar/build-tooling": "0.2.4",
92
- "@scalar/react-renderer": "0.2.1",
93
- "@scalar/galaxy": "0.5.5",
94
- "@scalar/core": "0.3.11"
92
+ "@scalar/build-tooling": "0.2.6",
93
+ "@scalar/core": "0.3.13",
94
+ "@scalar/galaxy": "0.5.7",
95
+ "@scalar/react-renderer": "0.2.1"
95
96
  },
96
97
  "scripts": {
97
98
  "build": "pnpm build:default && pnpm build:standalone && pnpm types:build && tsc-alias -p tsconfig.build.json",
@@ -109,6 +110,9 @@
109
110
  "test": "vitest",
110
111
  "test:e2e": "playwright test",
111
112
  "test:e2e:ui": "playwright test --ui",
113
+ "test:e2e:snapshots": "PW_TEST_CONNECT_WS_ENDPOINT=ws://127.0.0.1:5001/ playwright test -c playwright.snapshots.config.ts",
114
+ "test:e2e:playwright": "docker-compose -f test-snapshots/compose.yml up",
115
+ "test:e2e:report": "playwright show-report",
112
116
  "types:build": "scalar-types-build-vue",
113
117
  "types:check": "scalar-types-check-vue"
114
118
  }