@scalar/workspace-store 0.61.0 → 0.62.0

package/dist/schemas/v3.2/strict/operation.d.ts

@@ -36,7 +36,7 @@ export declare const OperationObjectSchemaDefinition: import("@scalar/typebox").
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"ParameterObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"ParameterObject">>;
     }>]>]>>>;
     /** The request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification RFC7231 has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible. */
     requestBody: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"RequestBodyObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -47,7 +47,7 @@ export declare const OperationObjectSchemaDefinition: import("@scalar/typebox").
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"RequestBodyObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"RequestBodyObject">>;
     }>]>]>>;
     /** The list of possible responses as they are returned from executing this operation. */
     responses: import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"ResponsesObject">>;
@@ -66,7 +66,7 @@ export declare const OperationObjectSchemaDefinition: import("@scalar/typebox").
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"CallbackObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"CallbackObject">>;
     }>]>]>>>;
 }>, import("@scalar/typebox").TObject<{
     'x-badges': import("@scalar/typebox").TOptional<import("@scalar/typebox").TArray<import("@scalar/typebox").TObject<{

package/dist/schemas/v3.2/strict/parameter.d.ts

@@ -88,7 +88,7 @@ export declare const ParameterObjectSchemaDefinition: import("@scalar/typebox").
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"SchemaObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"SchemaObject">>;
     }>]>]>>;
     /** Example of the header's potential value; see Working With Examples. https://swagger.io/specification/#working-with-examples */
     example: import("@scalar/typebox").TOptional<import("@scalar/typebox").TAny>;
@@ -101,7 +101,7 @@ export declare const ParameterObjectSchemaDefinition: import("@scalar/typebox").
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"ExampleObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"ExampleObject">>;
     }>]>]>>>;
 }>]>, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
     /** REQUIRED. The name of the parameter. Parameter names are case sensitive.

package/dist/schemas/v3.2/strict/path-item.d.ts

@@ -22,7 +22,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a PUT operation on this path. */
     put: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -33,7 +33,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a POST operation on this path. */
     post: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -44,7 +44,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a DELETE operation on this path. */
     delete: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -55,7 +55,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a PATCH operation on this path. */
     patch: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -66,7 +66,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a CONNECT operation on this path. */
     connect: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -77,7 +77,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a OPTIONS operation on this path. */
     options: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -88,7 +88,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a HEAD operation on this path. */
     head: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -99,7 +99,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a TRACE operation on this path. */
     trace: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -110,7 +110,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A definition of a QUERY operation, as defined in the most recent IETF draft or its RFC successor, on this path. Added in OpenAPI 3.2. */
     query: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -121,7 +121,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>;
     /** A map of additional operations on this path. The map key is the HTTP method with the same capitalization that is to be sent in the request. This map MUST NOT contain any entry for the methods that can be defined by other fixed fields with Operation Object values (e.g. no POST entry, as the post field is used for this method). Added in OpenAPI 3.2. */
     additionalOperations: import("@scalar/typebox").TOptional<import("@scalar/typebox").TRecord<import("@scalar/typebox").TString, import("@scalar/typebox").TUnion<[import("@scalar/typebox").TRef<"OperationObject">, import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
@@ -132,7 +132,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"OperationObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"OperationObject">>;
     }>]>]>>>;
     /** An alternative servers array to service all operations in this path. If a servers array is specified at the OpenAPI Object level, it will be overridden by this value. */
     servers: import("@scalar/typebox").TOptional<import("@scalar/typebox").TArray<import("@scalar/typebox").TRef<"ServerObject">>>;
@@ -145,7 +145,7 @@ export declare const PathItemObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"ParameterObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"ParameterObject">>;
     }>]>]>>>;
 }>;
 export type PathItemObject = {

package/dist/schemas/v3.2/strict/paths.d.ts

@@ -11,7 +11,7 @@ export declare const PathsObjectSchemaDefinition: import("@scalar/typebox").TRec
     $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
     $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
 }>]>, import("@scalar/typebox").TObject<{
-    '$ref-value': import("@scalar/typebox").TRef<"PathItemObject">;
+    '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"PathItemObject">>;
 }>]>]>>;
 /**
  * Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths Object MAY be empty, due to Access Control List (ACL) constraints.

package/dist/schemas/v3.2/strict/reference.d.ts

@@ -42,6 +42,18 @@ export type ReferenceObject = {
     /** Indicates whether this reference should be resolved globally across all documents, rather than just within the current document context. */
     '$global'?: boolean;
 };
+/**
+ * Object or Reference Object with a resolved `$ref-value`.
+ *
+ * `$ref-value` is kept optional on purpose (mirroring the schema position in `schema.ts`): an
+ * unresolved reference — for example a sparse chunk `$ref` produced by the server store — is just
+ * `{ $ref }` with no resolved value yet. If it were required, such a value would match neither
+ * union branch, so coercion would fall back to the plain-object branch and silently drop the
+ * `$ref`. With it optional the `{ $ref }` matches the reference branch and is preserved unchanged.
+ *
+ * The bundler/proxy still populates `$ref-value` for resolved documents, so `getResolvedRef` keeps
+ * returning the value in practice.
+ */
 export declare const reference: <T extends TSchema>(schema: T) => import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TIntersect<[import("@scalar/typebox").TObject<{
     /** REQUIRED. The reference identifier. This MUST be in the form of a URI. */
     $ref: import("@scalar/typebox").TString;
@@ -55,9 +67,9 @@ export declare const reference: <T extends TSchema>(schema: T) => import("@scala
     /** Indicates whether this reference should be resolved globally across all documents, rather than just within the current document context. */
     $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
 }>]>, import("@scalar/typebox").TObject<{
-    '$ref-value': T;
+    '$ref-value': T extends import("@scalar/typebox").TOptional<infer S extends TSchema> ? import("@scalar/typebox").TOptional<S> : import("@scalar/typebox").Ensure<import("@scalar/typebox").TOptional<T>>;
 }>]>;
 export type ReferenceType<Value> = Value | (ReferenceObject & {
-    '$ref-value': Value;
+    '$ref-value'?: Value;
 });
 //# sourceMappingURL=reference.d.ts.map

package/dist/schemas/v3.2/strict/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../../src/schemas/v3.2/strict/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAQ,MAAM,iBAAiB,CAAA;AAIpD,eAAO,MAAM,+BAA+B;IAC1C,0JAA0J;;IAE1J,+IAA+I;;EAE/I,CAAA;AAEF;;;;;sDAKsD;AACtD,eAAO,MAAM,qBAAqB;IAE9B,6EAA6E;;IAE7E,sLAAsL;;IAEtL,oPAAoP;;;IAlBtP,0JAA0J;;IAE1J,+IAA+I;;IAoBhJ,CAAA;AAED;;;;;sDAKsD;AACtD,MAAM,MAAM,eAAe,GAAG;IAC5B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,sLAAsL;IACtL,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oPAAoP;IACpP,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0JAA0J;IAC1J,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC/B,+IAA+I;IAC/I,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC;IA7BlD,6EAA6E;;IAE7E,sLAAsL;;IAEtL,oPAAoP;;;IAlBtP,0JAA0J;;IAE1J,+IAA+I;;;;IA0C1E,CAAA;AAEvE,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,eAAe,GAAG;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../../src/schemas/v3.2/strict/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAQ,MAAM,iBAAiB,CAAA;AAIpD,eAAO,MAAM,+BAA+B;IAC1C,0JAA0J;;IAE1J,+IAA+I;;EAE/I,CAAA;AAEF;;;;;sDAKsD;AACtD,eAAO,MAAM,qBAAqB;IAE9B,6EAA6E;;IAE7E,sLAAsL;;IAEtL,oPAAoP;;;IAlBtP,0JAA0J;;IAE1J,+IAA+I;;IAoBhJ,CAAA;AAED;;;;;sDAKsD;AACtD,MAAM,MAAM,eAAe,GAAG;IAC5B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,sLAAsL;IACtL,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oPAAoP;IACpP,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0JAA0J;IAC1J,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC/B,+IAA+I;IAC/I,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC;IAzClD,6EAA6E;;IAE7E,sLAAsL;;IAEtL,oPAAoP;;;IAlBtP,0JAA0J;;IAE1J,+IAA+I;;;;IAsD3D,CAAA;AAEtF,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,eAAe,GAAG;IAAE,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA"}

package/dist/schemas/v3.2/strict/reference.js

@@ -20,4 +20,16 @@ export const ReferenceObjectSchema = compose(Type.Object({
     /** A description which by default SHOULD override that of the referenced component. CommonMark syntax MAY be used for rich text representation. If the referenced object-type does not allow a description field, then this field has no effect. */
     description: Type.Optional(Type.String()),
 }), ReferenceObjectExtensionsSchema);
-export const reference = (schema) => compose(ReferenceObjectSchema, Type.Object({ '$ref-value': schema }));
+/**
+ * Object or Reference Object with a resolved `$ref-value`.
+ *
+ * `$ref-value` is kept optional on purpose (mirroring the schema position in `schema.ts`): an
+ * unresolved reference — for example a sparse chunk `$ref` produced by the server store — is just
+ * `{ $ref }` with no resolved value yet. If it were required, such a value would match neither
+ * union branch, so coercion would fall back to the plain-object branch and silently drop the
+ * `$ref`. With it optional the `{ $ref }` matches the reference branch and is preserved unchanged.
+ *
+ * The bundler/proxy still populates `$ref-value` for resolved documents, so `getResolvedRef` keeps
+ * returning the value in practice.
+ */
+export const reference = (schema) => compose(ReferenceObjectSchema, Type.Object({ '$ref-value': Type.Optional(schema) }));

package/dist/schemas/v3.2/strict/response.d.ts

@@ -16,7 +16,7 @@ export declare const ResponseObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"HeaderObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"HeaderObject">>;
     }>]>]>>>;
     /** A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. "text/plain" overrides "text/*"  */
     content: import("@scalar/typebox").TOptional<import("@scalar/typebox").TRecord<import("@scalar/typebox").TString, import("@scalar/typebox").TRef<"MediaTypeObject">>>;
@@ -29,7 +29,7 @@ export declare const ResponseObjectSchemaDefinition: import("@scalar/typebox").T
         $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
         $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
     }>]>, import("@scalar/typebox").TObject<{
-        '$ref-value': import("@scalar/typebox").TRef<"LinkObject">;
+        '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"LinkObject">>;
     }>]>]>>>;
 }>;
 /**

package/dist/schemas/v3.2/strict/responses.d.ts

@@ -17,7 +17,7 @@ export declare const ResponsesObjectSchemaDefinition: import("@scalar/typebox").
     $status: import("@scalar/typebox").TOptional<import("@scalar/typebox").TUnion<[import("@scalar/typebox").TLiteral<"loading">, import("@scalar/typebox").TLiteral<"error">]>>;
     $global: import("@scalar/typebox").TOptional<import("@scalar/typebox").TBoolean>;
 }>]>, import("@scalar/typebox").TObject<{
-    '$ref-value': import("@scalar/typebox").TRef<"ResponseObject">;
+    '$ref-value': import("@scalar/typebox").TOptional<import("@scalar/typebox").TRef<"ResponseObject">>;
 }>]>]>>;
 /**
  * A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

package/dist/schemas/v3.2/strict/security-scheme.d.ts

@@ -32,7 +32,7 @@ export type OAuth2Object = Description & {
     type: 'oauth2';
     /** REQUIRED. An object containing configuration information for the flow types supported. */
     flows: OAuthFlowsObject;
-    /** URL to the OAuth2 authorization server metadata (RFC8414). TLS is required. Added in OpenAPI 3.2. */
+    /** URL to the OAuth2 authorization server metadata (RFC8414). Use HTTPS, or HTTP for local development URLs. Added in OpenAPI 3.2. */
     oauth2MetadataUrl?: string;
 } & XDefaultScopes;
 export type OpenIdConnectObject = Description & {
@@ -96,7 +96,7 @@ export declare const SecuritySchemeObjectSchemaDefinition: import("@scalar/typeb
     type: import("@scalar/typebox").TLiteral<"oauth2">;
     /** REQUIRED. An object containing configuration information for the flow types supported. */
     flows: import("@scalar/typebox").TRef<"OAuthFlowsObject">;
-    /** URL to the OAuth2 authorization server metadata (RFC8414). TLS is required. Added in OpenAPI 3.2. */
+    /** URL to the OAuth2 authorization server metadata (RFC8414). Use HTTPS, or HTTP for local development URLs. Added in OpenAPI 3.2. */
     oauth2MetadataUrl: import("@scalar/typebox").TOptional<import("@scalar/typebox").TString>;
 }>, import("@scalar/typebox").TObject<{
     'x-default-scopes': import("@scalar/typebox").TOptional<import("@scalar/typebox").TArray<import("@scalar/typebox").TString>>;

package/dist/schemas/v3.2/strict/security-scheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-scheme.d.ts","sourceRoot":"","sources":["../../../../src/schemas/v3.2/strict/security-scheme.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,+CAA+C,CAAA;AACvG,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,gDAAgD,CAAA;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAexE,KAAK,WAAW,GAAG;IACjB,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wIAAwI;IACxI,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,aAAa,CAAA;AAcjB,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,4HAA4H;IAC5H,IAAI,EAAE,QAAQ,CAAA;IACd,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,8FAA8F;IAC9F,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAClC,CAAA;AAcD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,4HAA4H;IAC5H,IAAI,EAAE,MAAM,CAAA;IACZ,gQAAgQ;IAChQ,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC1B,uMAAuM;IACvM,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAUD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,4HAA4H;IAC5H,IAAI,EAAE,WAAW,CAAA;CAClB,CAAA;AAeD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,4HAA4H;IAC5H,IAAI,EAAE,QAAQ,CAAA;IACd,6FAA6F;IAC7F,KAAK,EAAE,gBAAgB,CAAA;IACvB,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG,cAAc,CAAA;AAYlB,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,4HAA4H;IAC5H,IAAI,EAAE,eAAe,CAAA;IACrB,+FAA+F;IAC/F,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oCAAoC;IAlH7C,qGAAqG;;IAErG,wIAAwI;;;;;IAgBxI,4HAA4H;;IAE5H,8EAA8E;;IAE9E,8FAA8F;;;IAtB9F,qGAAqG;;IAErG,wIAAwI;;;;;IAqCxI,4HAA4H;;IAE5H,gQAAgQ;;IAEhQ,uMAAuM;;;IA3CvM,qGAAqG;;IAErG,wIAAwI;;;;;IA0DxI,4HAA4H;;;IA5D5H,qGAAqG;;IAErG,wIAAwI;;;;;IAuExI,4HAA4H;;IAE5H,6FAA6F;;IAE7F,wGAAwG;;;;;IA7ExG,qGAAqG;;IAErG,wIAAwI;;;;;IA6FxI,4HAA4H;;IAE5H,+FAA+F;;MAuBjG,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"security-scheme.d.ts","sourceRoot":"","sources":["../../../../src/schemas/v3.2/strict/security-scheme.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,+CAA+C,CAAA;AACvG,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,gDAAgD,CAAA;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAexE,KAAK,WAAW,GAAG;IACjB,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wIAAwI;IACxI,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,aAAa,CAAA;AAcjB,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,4HAA4H;IAC5H,IAAI,EAAE,QAAQ,CAAA;IACd,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,8FAA8F;IAC9F,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAClC,CAAA;AAcD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,4HAA4H;IAC5H,IAAI,EAAE,MAAM,CAAA;IACZ,gQAAgQ;IAChQ,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC1B,uMAAuM;IACvM,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAUD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,4HAA4H;IAC5H,IAAI,EAAE,WAAW,CAAA;CAClB,CAAA;AAeD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,4HAA4H;IAC5H,IAAI,EAAE,QAAQ,CAAA;IACd,6FAA6F;IAC7F,KAAK,EAAE,gBAAgB,CAAA;IACvB,sIAAsI;IACtI,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG,cAAc,CAAA;AAYlB,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,4HAA4H;IAC5H,IAAI,EAAE,eAAe,CAAA;IACrB,+FAA+F;IAC/F,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oCAAoC;IAlH7C,qGAAqG;;IAErG,wIAAwI;;;;;IAgBxI,4HAA4H;;IAE5H,8EAA8E;;IAE9E,8FAA8F;;;IAtB9F,qGAAqG;;IAErG,wIAAwI;;;;;IAqCxI,4HAA4H;;IAE5H,gQAAgQ;;IAEhQ,uMAAuM;;;IA3CvM,qGAAqG;;IAErG,wIAAwI;;;;;IA0DxI,4HAA4H;;;IA5D5H,qGAAqG;;IAErG,wIAAwI;;;;;IAuExI,4HAA4H;;IAE5H,6FAA6F;;IAE7F,sIAAsI;;;;;IA7EtI,qGAAqG;;IAErG,wIAAwI;;;;;IA6FxI,4HAA4H;;IAE5H,+FAA+F;;MAuBjG,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,mBAAmB,CAAA"}

package/dist/schemas/v3.2/strict/security-scheme.js

@@ -36,7 +36,7 @@ const OAuth2 = compose(DescriptionSchema, Type.Object({
     type: Type.Literal('oauth2'),
     /** REQUIRED. An object containing configuration information for the flow types supported. */
     flows: OAuthFlowsObjectRef,
-    /** URL to the OAuth2 authorization server metadata (RFC8414). TLS is required. Added in OpenAPI 3.2. */
+    /** URL to the OAuth2 authorization server metadata (RFC8414). Use HTTPS, or HTTP for local development URLs. Added in OpenAPI 3.2. */
     oauth2MetadataUrl: Type.Optional(Type.String()),
 }), XDefaultScopesSchema);
 const OpenIdConnect = compose(DescriptionSchema, Type.Object({

package/dist/server.d.ts

@@ -178,6 +178,33 @@ export type ServerWorkspaceStore = {
      * @returns The resolved chunk, or `undefined` when not found
      */
     get: (pointer: string) => unknown;
+    /**
+     * Returns a document whole, with local references resolving, for rendering on the server.
+     *
+     * `getWorkspace()` hands back the sparse document: every component and operation is a reference
+     * to a chunk, which is what the browser wants so it can load only what a page needs. A server
+     * render wants the opposite — the complete document, read through one reference, with `$ref-value`
+     * resolving locally and nothing fetched. That is the document the store built its navigation and
+     * chunks from, so this is that object rather than a second copy: it shares the components and
+     * operations the chunks are written from, and carries the same metadata and navigation as the
+     * sparse document.
+     *
+     * It is a magic proxy, never reactive, so reading it costs a property lookup and a pointer
+     * resolution. Use `getRaw` to serialize it: `$ref-value` is enumerable on the proxy and would
+     * inline every referenced value beside its `$ref`.
+     *
+     * @example
+     * ```ts
+     * const document = store.getResolvedDocument('petstore')
+     *
+     * // A real operation, not a chunk reference
+     * document?.paths?.['/pets']?.get
+     * ```
+     *
+     * @param name - The document name it was added under
+     * @returns The resolved document, or `undefined` when no document has that name
+     */
+    getResolvedDocument: (name: string) => ServerWorkspace['documents'][string] | undefined;
 };
 /**
  * Create server state workspace store

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -258,6 +258,13 @@ export async function createServerWorkspaceStore(workspaceProps) {
      * for that document.
      */
     const assets = {};
+    /**
+     * Each document whole, for `getResolvedDocument`.
+     *
+     * Written at the same point as `workspace.documents`, after everything that can throw, so a failed
+     * add leaves neither map with a half-processed entry.
+     */
+    const resolvedDocuments = {};
     /**
      * Adds an AsyncAPI document to the workspace.
      *
@@ -306,6 +313,9 @@ export async function createServerWorkspaceStore(workspaceProps) {
         // checks OpenAPI first — so leaving `openapi` in place would hand an OpenAPI renderer a
         // navigation tree of channel entries. The document is stored as the type it was read as.
         delete workspace.documents[name]['openapi'];
+        // Nothing was externalized, so the stored document already is the whole document; it only needs
+        // its references resolving to be rendered from.
+        resolvedDocuments[name] = resolveLocalReferences(workspace.documents[name]);
     };
     /**
      * Adds a new document to the workspace.
@@ -364,6 +374,13 @@ export async function createServerWorkspaceStore(workspaceProps) {
             paths,
             [extensions.document.navigation]: navigation,
         };
+        // The same document without the externalization, for server rendering. A shallow spread, so the
+        // components and operations are the objects the chunks are written from rather than copies.
+        resolvedDocuments[meta.name] = resolveLocalReferences({
+            ...documentMeta,
+            ...documentV3,
+            [extensions.document.navigation]: navigation,
+        });
     };
     /**
      * Adds a new document to the workspace asynchronously.
@@ -445,6 +462,7 @@ export async function createServerWorkspaceStore(workspaceProps) {
         getWorkspace: () => {
             return workspace;
         },
+        getResolvedDocument: (name) => resolvedDocuments[name],
         get: (pointer) => {
             const pointerPath = (() => {
                 if (pointer.startsWith('#')) {

package/package.json

@@ -16,7 +16,7 @@
     "openapi",
     "scalar"
   ],
-  "version": "0.61.0",
+  "version": "0.62.0",
   "engines": {
     "node": ">=22"
   },
@@ -143,19 +143,19 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@scalar/typebox": "0.1.3",
-    "js-base64": "^3.9.2",
-    "type-fest": "^5.8.0",
-    "vue": "^3.5.40",
-    "yaml": "^2.9.0",
-    "@scalar/helpers": "0.12.0",
     "@scalar/asyncapi-upgrader": "0.1.10",
-    "@scalar/openapi-upgrader": "0.2.16",
+    "@scalar/helpers": "0.12.0",
+    "@scalar/json-magic": "0.14.0",
+    "@scalar/openapi-upgrader": "0.2.17",
     "@scalar/schemas": "0.10.0",
     "@scalar/snippetz": "0.9.31",
+    "@scalar/typebox": "0.1.3",
     "@scalar/types": "0.20.0",
     "@scalar/validation": "0.6.3",
-    "@scalar/json-magic": "0.13.5"
+    "js-base64": "^3.9.2",
+    "type-fest": "^5.8.0",
+    "vue": "^3.5.40",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@google-cloud/storage": "7.21.0",