@scalar/schemas 0.13.2 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @scalar/schemas
 
+## 0.15.0
+
+### Minor Changes
+
+- [#10697](https://github.com/scalar/scalar/pull/10697): Add `urlRouting: false` to keep API reference navigation in internal state without reading or changing the host page URL.
+
+## 0.14.0
+
+### Minor Changes
+
+- [#10213](https://github.com/scalar/scalar/pull/10213): Add per-reference Markdown rendering hooks and an explicitly loaded Mermaid plugin with interactive diagrams, keyboard panning, and zoom controls.
+
+  Provide Markdown hooks before mounting the embedded client modal so its initial render receives the configured hooks. The Mermaid viewer uses customizable Scalar theme styles and an intentional light drawing surface.
+
+  Isolate Markdown plugin cleanup failures so other plugins still release their resources when content changes or unmounts.
+
+### Patch Changes
+
+- [#10597](https://github.com/scalar/scalar/pull/10597): Render AsyncAPI string discriminators with inherited schema variants and effective discriminator values.
+
 ## 0.13.2
 
 ### Patch Changes

package/dist/api-reference/api-reference-configuration.d.ts

@@ -84,6 +84,7 @@ export declare const apiReferenceConfigurationSchema: import("@scalar/validation
             onDestroy: import("@scalar/validation").OptionalSchema<import("@scalar/validation").FunctionSchema<() => void>>;
         }>>;
         apiClientPlugins: any[];
+        markdown?: import("@scalar/helpers/markdown/markdown-render-hook").MarkdownRenderHook;
     }>>>;
     pluginUrls: import("@scalar/validation").OptionalSchema<import("@scalar/validation").ArraySchema<import("@scalar/validation").StringSchema>>;
     isEditable: import("@scalar/validation").BooleanSchema;
@@ -133,6 +134,7 @@ export declare const apiReferenceConfigurationSchema: import("@scalar/validation
     }) => Response | void | Promise<Response | void>>>;
     onShowMore: import("@scalar/validation").OptionalSchema<import("@scalar/validation").FunctionSchema<(tagId: string) => Promise<void> | void>>;
     onSidebarClick: import("@scalar/validation").OptionalSchema<import("@scalar/validation").FunctionSchema<(href: string) => Promise<void> | void>>;
+    urlRouting: import("@scalar/validation").OptionalSchema<import("@scalar/validation").BooleanSchema>;
     pathRouting: import("@scalar/validation").OptionalSchema<import("@scalar/validation").ObjectSchema<{
         basePath: import("@scalar/validation").StringSchema;
     }>>;
@@ -288,6 +290,7 @@ export declare const apiReferenceConfigurationWithSourceSchema: (rawInput: unkno
             onDestroy: import("@scalar/validation").OptionalSchema<import("@scalar/validation").FunctionSchema<() => void>>;
         }>>;
         apiClientPlugins: any[];
+        markdown?: import("@scalar/helpers/markdown/markdown-render-hook").MarkdownRenderHook;
     })[] | undefined;
     pluginUrls?: string[] | undefined;
     modelsSectionLabel?: string | undefined;
@@ -329,6 +332,7 @@ export declare const apiReferenceConfigurationWithSourceSchema: (rawInput: unkno
     }) => Response | void | Promise<Response | void>) | undefined;
     onShowMore?: ((tagId: string) => Promise<void> | void) | undefined;
     onSidebarClick?: ((href: string) => Promise<void> | void) | undefined;
+    urlRouting?: boolean | undefined;
     pathRouting?: {
         basePath: string;
     } | undefined;
@@ -472,6 +476,7 @@ export declare const apiReferenceConfigurationWithSourceSchema: (rawInput: unkno
             onDestroy: import("@scalar/validation").OptionalSchema<import("@scalar/validation").FunctionSchema<() => void>>;
         }>>;
         apiClientPlugins: any[];
+        markdown?: import("@scalar/helpers/markdown/markdown-render-hook").MarkdownRenderHook;
     })[] | undefined;
     pluginUrls?: string[] | undefined;
     modelsSectionLabel?: string | undefined;
@@ -513,6 +518,7 @@ export declare const apiReferenceConfigurationWithSourceSchema: (rawInput: unkno
     }) => Response | void | Promise<Response | void>) | undefined;
     onShowMore?: ((tagId: string) => Promise<void> | void) | undefined;
     onSidebarClick?: ((href: string) => Promise<void> | void) | undefined;
+    urlRouting?: boolean | undefined;
     pathRouting?: {
         basePath: string;
     } | undefined;

package/dist/api-reference/api-reference-configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-reference-configuration.d.ts","sourceRoot":"","sources":["../../src/api-reference/api-reference-configuration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-reference-configuration.d.ts","sourceRoot":"","sources":["../../src/api-reference/api-reference-configuration.ts"],"names":[],"mappings":"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"}

package/dist/api-reference/api-reference-configuration.js

@@ -1,6 +1,6 @@
 import { DEFAULT_MODELS_SECTION_LABEL } from '@scalar/types/api-reference';
 import { any, array, boolean, coerce, evaluate, fn, intersection, literal, number, object, optional, record, string, union, } from '@scalar/validation';
-import { apiReferencePluginSchema } from '../api-reference/api-reference-plugin.js';
+import { apiReferencePluginSchema } from './api-reference-plugin.js';
 import { baseConfigurationSchema } from './base-configuration.js';
 import { sourceConfigurationSchema } from './source-configuration.js';
 export const apiReferenceConfigurationSchema = intersection([
@@ -141,6 +141,9 @@ export const apiReferenceConfigurationSchema = intersection([
         onSidebarClick: optional(fn(), {
             typeComment: 'onSidebarClick is fired when the user clicks on a sidebar item',
         }),
+        urlRouting: optional(boolean(), {
+            typeComment: 'Sync navigation with the browser URL. Set to false for embedded references that must leave the host URL and history alone. Defaults to true.',
+        }),
         pathRouting: optional(object({
             basePath: string(),
         }), {

package/dist/api-reference/api-reference-plugin.d.ts

@@ -1,3 +1,4 @@
+import type { MarkdownRenderHook } from '@scalar/helpers/markdown/markdown-render-hook';
 import { type Static } from '@scalar/validation';
 declare const openApiExtensionSchema: import("@scalar/validation").ObjectSchema<{
     name: import("@scalar/validation").StringSchema;
@@ -41,6 +42,7 @@ export declare const apiReferencePluginSchema: import("@scalar/validation").Func
     views: Static<typeof viewsSchema>;
     hooks: Static<typeof lifecycleHooksSchema>;
     apiClientPlugins: any[];
+    markdown?: MarkdownRenderHook;
 }>;
 export {};
 //# sourceMappingURL=api-reference-plugin.d.ts.map

package/dist/api-reference/api-reference-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-reference-plugin.d.ts","sourceRoot":"","sources":["../../src/api-reference/api-reference-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAsE,MAAM,oBAAoB,CAAA;AAEpH,QAAA,MAAM,sBAAsB;;;;EAY1B,CAAA;AAyBF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;EAOf,CAAA;AAEF,QAAA,MAAM,oBAAoB;uHACe;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI;+HAC3B;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI;6GACrD,IAAI;EACjC,CAAA;AAEF,eAAO,MAAM,wBAAwB,oDAE3B;IACJ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAC,OAAO,sBAAsB,CAAC,EAAE,CAAA;IACnD,KAAK,EAAE,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA;IACjC,KAAK,EAAE,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAA;IAC1C,gBAAgB,EAAE,GAAG,EAAE,CAAA;CACxB,CACA,CAAA"}
+{"version":3,"file":"api-reference-plugin.d.ts","sourceRoot":"","sources":["../../src/api-reference/api-reference-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AACvF,OAAO,EAAE,KAAK,MAAM,EAAsE,MAAM,oBAAoB,CAAA;AAEpH,QAAA,MAAM,sBAAsB;;;;EAY1B,CAAA;AAyBF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;EAOf,CAAA;AAEF,QAAA,MAAM,oBAAoB;uHACe;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI;+HAC3B;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI;6GACrD,IAAI;EACjC,CAAA;AAEF,eAAO,MAAM,wBAAwB,oDAE3B;IACJ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAC,OAAO,sBAAsB,CAAC,EAAE,CAAA;IACnD,KAAK,EAAE,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA;IACjC,KAAK,EAAE,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAA;IAC1C,gBAAgB,EAAE,GAAG,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B,CACA,CAAA"}

package/dist/asyncapi/3.1/schema-payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-payload.d.ts","sourceRoot":"","sources":["../../../src/asyncapi/3.1/schema-payload.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,+BAA+B;;;EAa3C,CAAA;AAQD,uCAAuC;AACvC,eAAO,MAAM,+BAA+B,qCAAwC,CAAA;AAEpF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,qCAIjC,CAAA"}
+{"version":3,"file":"schema-payload.d.ts","sourceRoot":"","sources":["../../../src/asyncapi/3.1/schema-payload.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,+BAA+B;;;EAa3C,CAAA;AAOD,uCAAuC;AACvC,eAAO,MAAM,+BAA+B,qCAAwC,CAAA;AAEpF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,qCAIjC,CAAA"}

package/dist/asyncapi/3.1/schema-payload.js

@@ -9,9 +9,8 @@ export const asyncApiMultiFormatSchemaObject = object({
         typeComment: 'REQUIRED. Schema definition in the format given by schemaFormat.',
     }),
 }, { typeName: 'AsyncApiMultiFormatSchemaObject' });
-// AsyncAPI's default schema format is JSON Schema, the same dialect OpenAPI 3.1 uses, so we reuse the
-// OpenAPI Schema Object here instead of an opaque `unknown`. A schema may also be a boolean per JSON Schema.
-const asyncApiSchemaJsonShape = union([literal(true), literal(false), createSchema(true)], {
+// Share the recursive JSON Schema fields while retaining AsyncAPI's property-name discriminator.
+const asyncApiSchemaJsonShape = union([literal(true), literal(false), createSchema(true, string())], {
     typeName: 'AsyncApiSchemaJsonShape',
 });
 /** Schema Object | Reference Object */

package/dist/openapi/3.1/callback.js

@@ -1,6 +1,6 @@
 import { lazy, record, string } from '@scalar/validation';
-import { pathItem } from '../../openapi/3.1/path-item.js';
-import { recursiveRef } from '../../openapi/3.1/reference.js';
+import { pathItem } from './path-item.js';
+import { recursiveRef } from './reference.js';
 export const callback = record(string(), recursiveRef(lazy(() => pathItem)), {
     typeName: 'CallbackObject',
 });

package/dist/openapi/3.1/components.js

@@ -1,15 +1,15 @@
 import { lazy, object, optional, record, string } from '@scalar/validation';
-import { callback } from '../../openapi/3.1/callback.js';
-import { example } from '../../openapi/3.1/example.js';
-import { link } from '../../openapi/3.1/link.js';
-import { header } from '../../openapi/3.1/media-type.js';
-import { parameter } from '../../openapi/3.1/parameter.js';
-import { pathItem } from '../../openapi/3.1/path-item.js';
-import { normalRef, recursiveRef } from '../../openapi/3.1/reference.js';
-import { requestBody } from '../../openapi/3.1/request-body.js';
-import { response } from '../../openapi/3.1/response.js';
-import { schema } from '../../openapi/3.1/schema.js';
-import { securityScheme } from '../../openapi/3.1/security-schemes.js';
+import { callback } from './callback.js';
+import { example } from './example.js';
+import { link } from './link.js';
+import { header } from './media-type.js';
+import { parameter } from './parameter.js';
+import { pathItem } from './path-item.js';
+import { normalRef, recursiveRef } from './reference.js';
+import { requestBody } from './request-body.js';
+import { response } from './response.js';
+import { schema } from './schema.js';
+import { securityScheme } from './security-schemes.js';
 export const components = lazy(() => object({
     schemas: optional(record(string(), normalRef(schema), { typeName: 'ComponentsSchemas' })),
     responses: optional(record(string(), recursiveRef(lazy(() => response)), { typeName: 'ComponentsResponses' })),

package/dist/openapi/3.1/document.js

@@ -3,14 +3,14 @@ import { XOriginalOasVersion, XScalarEnvironments, XScalarIcon, XScalarIsDirty,
 import { XPostResponse, XPreRequest, XScalarActiveEnvironment, XScalarCookies, XScalarOrder, } from '../../extensions/general/index.js';
 import { XScalarSelectedServer } from '../../extensions/server/index.js';
 import { XTagGroups } from '../../extensions/tag/index.js';
-import { components } from '../../openapi/3.1/components.js';
-import { externalDocs } from '../../openapi/3.1/external-docs.js';
-import { info } from '../../openapi/3.1/info.js';
-import { pathItem } from '../../openapi/3.1/path-item.js';
-import { recursiveRef } from '../../openapi/3.1/reference.js';
-import { securityRequirement } from '../../openapi/3.1/security-requirement.js';
-import { server } from '../../openapi/3.1/server.js';
-import { tag } from '../../openapi/3.1/tag.js';
+import { components } from './components.js';
+import { externalDocs } from './external-docs.js';
+import { info } from './info.js';
+import { pathItem } from './path-item.js';
+import { recursiveRef } from './reference.js';
+import { securityRequirement } from './security-requirement.js';
+import { server } from './server.js';
+import { tag } from './tag.js';
 const openapiExtensions = intersection([
     XOriginalOasVersion,
     XScalarNavigation,

package/dist/openapi/3.1/info.js

@@ -1,7 +1,7 @@
 import { intersection, object, optional, string } from '@scalar/validation';
 import { XScalarLinks, XScalarSdkInstallation } from '../../extensions/document/index.js';
-import { contact } from '../../openapi/3.1/contact.js';
-import { license } from '../../openapi/3.1/license.js';
+import { contact } from './contact.js';
+import { license } from './license.js';
 export const info = intersection([
     object({
         title: string({ typeComment: 'REQUIRED. The title of the API.' }),

package/dist/openapi/3.1/link.js

@@ -1,5 +1,5 @@
 import { any, object, optional, record, string } from '@scalar/validation';
-import { server } from '../../openapi/3.1/server.js';
+import { server } from './server.js';
 export const link = object({
     operationRef: optional(string({
         typeComment: 'A URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object.',

package/dist/openapi/3.1/media-type.js

@@ -1,7 +1,7 @@
 import { any, boolean, intersection, lazy, object, optional, record, string, union, } from '@scalar/validation';
-import { example } from '../../openapi/3.1/example.js';
-import { normalRef, recursiveRef } from '../../openapi/3.1/reference.js';
-import { schema } from '../../openapi/3.1/schema.js';
+import { example } from './example.js';
+import { normalRef, recursiveRef } from './reference.js';
+import { schema } from './schema.js';
 const headerBase = object({
     description: optional(string({
         typeComment: 'A brief description of the header. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.',

package/dist/openapi/3.1/operation.js

@@ -3,14 +3,14 @@ import { XInternal, XScalarIgnore } from '../../extensions/document/index.js';
 import { XPostResponse, XPreRequest } from '../../extensions/general/index.js';
 import { XBadges, XCodeSamples, XDraftExamples, XScalarDisableParameters, XScalarStability, } from '../../extensions/operation/index.js';
 import { XScalarSelectedServer } from '../../extensions/server/index.js';
-import { callback } from '../../openapi/3.1/callback.js';
-import { externalDocs } from '../../openapi/3.1/external-docs.js';
-import { parameter } from '../../openapi/3.1/parameter.js';
-import { recursiveRef } from '../../openapi/3.1/reference.js';
-import { requestBody } from '../../openapi/3.1/request-body.js';
-import { responsesObject } from '../../openapi/3.1/response.js';
-import { securityRequirement } from '../../openapi/3.1/security-requirement.js';
-import { server } from '../../openapi/3.1/server.js';
+import { callback } from './callback.js';
+import { externalDocs } from './external-docs.js';
+import { parameter } from './parameter.js';
+import { recursiveRef } from './reference.js';
+import { requestBody } from './request-body.js';
+import { responsesObject } from './response.js';
+import { securityRequirement } from './security-requirement.js';
+import { server } from './server.js';
 export const operation = intersection([
     object({
         tags: optional(array(string(), {

package/dist/openapi/3.1/parameter.js

@@ -1,10 +1,10 @@
 import { any, boolean, intersection, lazy, literal, object, optional, record, string, union } from '@scalar/validation';
 import { XInternal, XScalarIgnore } from '../../extensions/document/index.js';
 import { XGlobal } from '../../extensions/parameter/index.js';
-import { example } from '../../openapi/3.1/example.js';
-import { mediaType } from '../../openapi/3.1/media-type.js';
-import { normalRef, recursiveRef } from '../../openapi/3.1/reference.js';
-import { schema } from '../../openapi/3.1/schema.js';
+import { example } from './example.js';
+import { mediaType } from './media-type.js';
+import { normalRef, recursiveRef } from './reference.js';
+import { schema } from './schema.js';
 const parameterWithSchema = intersection([
     object({
         name: string({

package/dist/openapi/3.1/path-item.js

@@ -1,8 +1,8 @@
 import { array, lazy, object, optional, string } from '@scalar/validation';
-import { operation } from '../../openapi/3.1/operation.js';
-import { parameter } from '../../openapi/3.1/parameter.js';
-import { recursiveRef } from '../../openapi/3.1/reference.js';
-import { server } from '../../openapi/3.1/server.js';
+import { operation } from './operation.js';
+import { parameter } from './parameter.js';
+import { recursiveRef } from './reference.js';
+import { server } from './server.js';
 export const pathItem = object({
     $ref: optional(string({
         typeComment: 'Allows for a referenced definition of this path item. The value MUST be in the form of a URI, and the referenced structure MUST be in the form of a Path Item Object.',

package/dist/openapi/3.1/request-body.js

@@ -1,6 +1,6 @@
 import { boolean, intersection, lazy, object, optional, record, string } from '@scalar/validation';
 import { XScalarSelectedContentType } from '../../extensions/operation/index.js';
-import { mediaType } from '../../openapi/3.1/media-type.js';
+import { mediaType } from './media-type.js';
 export const requestBody = intersection([
     object({
         description: optional(string({

package/dist/openapi/3.1/response.js

@@ -1,7 +1,7 @@
 import { lazy, object, optional, record, string } from '@scalar/validation';
-import { link } from '../../openapi/3.1/link.js';
-import { header, mediaType } from '../../openapi/3.1/media-type.js';
-import { recursiveRef } from '../../openapi/3.1/reference.js';
+import { link } from './link.js';
+import { header, mediaType } from './media-type.js';
+import { recursiveRef } from './reference.js';
 export const response = object({
     description: string({
         typeComment: 'REQUIRED. A description of the response. CommonMark syntax MAY be used for rich text representation.',

package/dist/openapi/3.1/schema.d.ts

@@ -3,6 +3,6 @@ import { type Schema } from '@scalar/validation';
  * Build the shared Schema Object shape, optionally accepting boolean child schemas.
  * AsyncAPI uses JSON Schema booleans recursively; the OpenAPI ingestion pipeline normalizes them first.
  */
-export declare const createSchema: (booleanSchemas?: boolean) => Schema;
+export declare const createSchema: (booleanSchemas?: boolean, discriminator?: Schema) => Schema;
 export declare const schema: Schema;
 //# sourceMappingURL=schema.d.ts.map

package/dist/openapi/3.1/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/openapi/3.1/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAaZ,MAAM,oBAAoB,CAAA;AAS3B;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,wBAAsB,KAAG,MA6KrD,CAAA;AAED,eAAO,MAAM,MAAM,QAAiB,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/openapi/3.1/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAaZ,MAAM,oBAAoB,CAAA;AAS3B;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,wBAAsB,EAAE,gBAAe,MAA4B,KAAG,MA6KlG,CAAA;AAED,eAAO,MAAM,MAAM,QAAiB,CAAA"}

package/dist/openapi/3.1/schema.js

@@ -1,15 +1,15 @@
 import { any, array, boolean, intersection, lazy, literal, number, object, optional, record, string, union, } from '@scalar/validation';
 import { XInternal, XScalarIgnore, XTags } from '../../extensions/document/index.js';
 import { XAdditionalPropertiesName, XEnumDescriptions, XEnumVarNames, XExamples, XVariable } from '../../extensions/schema/index.js';
-import { discriminatorObject } from '../../openapi/3.1/discriminator.js';
-import { externalDocs } from '../../openapi/3.1/external-docs.js';
-import { normalRef } from '../../openapi/3.1/reference.js';
-import { xml } from '../../openapi/3.1/xml.js';
+import { discriminatorObject } from './discriminator.js';
+import { externalDocs } from './external-docs.js';
+import { normalRef } from './reference.js';
+import { xml } from './xml.js';
 /**
  * Build the shared Schema Object shape, optionally accepting boolean child schemas.
  * AsyncAPI uses JSON Schema booleans recursively; the OpenAPI ingestion pipeline normalizes them first.
  */
-export const createSchema = (booleanSchemas = false) => {
+export const createSchema = (booleanSchemas = false, discriminator = discriminatorObject) => {
     const schemaExtensionObjects = [
         XScalarIgnore,
         XInternal,
@@ -31,7 +31,7 @@ export const createSchema = (booleanSchemas = false) => {
         contentEncoding: optional(string({ typeComment: 'Content encoding.' })),
         contentSchema: optional(normalRef(lazy(() => nestedSchema))),
         deprecated: optional(boolean({ typeComment: 'Whether the schema is deprecated.' })),
-        discriminator: optional(discriminatorObject),
+        discriminator: optional(discriminator),
         readOnly: optional(boolean({ typeComment: 'Whether the schema is read-only.' })),
         writeOnly: optional(boolean({ typeComment: 'Whether the schema is write-only.' })),
         xml: optional(xml),

package/dist/openapi/3.1/server.js

@@ -1,5 +1,5 @@
 import { object, optional, record, string } from '@scalar/validation';
-import { serverVariable } from '../../openapi/3.1/server-variable.js';
+import { serverVariable } from './server-variable.js';
 export const server = object({
     url: string({
         typeComment: 'REQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the document containing the Server Object is being served. Variable substitutions will be made when a variable is named in {braces}.',

package/dist/openapi/3.1/tag.js

@@ -2,7 +2,7 @@ import { intersection, object, optional, string } from '@scalar/validation';
 import { XInternal, XScalarIgnore } from '../../extensions/document/index.js';
 import { XScalarOrder } from '../../extensions/general/index.js';
 import { XDisplayName } from '../../extensions/tag/index.js';
-import { externalDocs } from '../../openapi/3.1/external-docs.js';
+import { externalDocs } from './external-docs.js';
 export const tag = intersection([
     object({
         name: string({ typeComment: 'REQUIRED. The name of the tag.' }),

package/package.json

@@ -14,7 +14,7 @@
     "schemas",
     "scalar"
   ],
-  "version": "0.13.2",
+  "version": "0.15.0",
   "engines": {
     "node": ">=22"
   },
@@ -41,12 +41,12 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@scalar/helpers": "0.16.3",
+    "@scalar/helpers": "0.16.4",
     "@scalar/validation": "0.6.7"
   },
   "devDependencies": {
-    "@scalar/types": "0.23.2",
-    "vitest": "4.1.10"
+    "@scalar/types": "0.25.0",
+    "vitest": "4.1.12"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",