@scalar/workspace-store 0.54.3 → 0.54.4

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @scalar/workspace-store
 
+## 0.54.4
+
+### Patch Changes
+
+- [#9465](https://github.com/scalar/scalar/pull/9465): Resolve JSON Schema 2020-12 `$dynamicRef` against the active `$dynamicAnchor` when generating examples, so generic patterns like `PaginatedResponse<T>` and recursive trees produce concrete example data instead of empty placeholders
+- [#9494](https://github.com/scalar/scalar/pull/9494): Preserve document-level UI settings (watch mode, selected server, environments, sidebar order) and user-configured servers across `rebaseDocument` — previously every rebase (e.g. a watch mode pull) silently wiped them
+
 ## 0.54.3
 
 ### Patch Changes

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,YAAY,EAAU,MAAM,2BAA2B,CAAA;AAErE,OAAO,EAAE,KAAK,UAAU,EAAe,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAQ7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAI5C,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAA;AAS1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAY5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAIrE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EACV,sBAAsB,EACtB,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACd,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,oBAAoB,CAAA;AASpF;;;GAGG;AACH,KAAK,0BAA0B,GAAG;IAChC,wEAAwE;IACxE,IAAI,CAAC,EAAE,qBAAqB,CAAA;IAC5B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,SAAS,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;IACxC,wIAAwI;IACxI,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC5F,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,0BAA0B,CAAA;AAE9B;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,0BAA0B,CAAA;AAE9B,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG;IACtB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,GAAG,0BAA0B,CAAA;AAE9B;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAsEjE;;;GAGG;AACH,KAAK,cAAc,GAAG;IACpB,gFAAgF;IAChF,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAA;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,8FAA8F;IAC9F,UAAU,CAAC,EAAE,YAAY,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,aAAa,GAAG,MAAM,mBAAmB,EAC9D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAC9C,IAAI,CAAA;IACP;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,CAAC,SAAS,MAAM,sBAAsB,EACnD,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAC9B,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAA;IACV;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnG;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IACnG;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IACnF;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC5E;;;;;;;OAOG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACzE;;;;;;;;;;;;;;;OAeG;IACH,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC7E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD;;;;;OAKG;IACH,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/C;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5D;;;;;;;;;OASG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C;;;;;;;;;;OAUG;IACH,eAAe,IAAI,iBAAiB,CAAA;IACpC;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC7C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gCAAgC,CAAC,aAAa,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3F;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CACtD;QACE,EAAE,EAAE,KAAK,CAAA;QACT,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,qBAAqB,CAAA;QAChE,OAAO,EAAE,MAAM,CAAA;KAChB,GACD;QACE,EAAE,EAAE,IAAI,CAAA;QACR,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,CAAA;QAC1C,SAAS,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,CAAA;QAChD,YAAY,EAAE,CACZ,iBAAiB,EACb;YACE,iBAAiB,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAA;SACzC,GACD;YACE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAC1C,KACF,OAAO,CAAC,IAAI,CAAC,CAAA;KACnB,CACJ,CAAA;CACF,CAAA;AAuDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,iBAAiB,cAAc,KAAG,cA2+BtE,CAAA;AAGD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -952,6 +952,25 @@ export const createWorkspaceStore = (workspaceProps) => {
                     // the document type discriminator.
                     originalDocuments[name] = mergedDocument;
                     intermediateDocuments[name] = deepClone(mergedDocument);
+                    // Document-level UI settings never come from the upstream source and
+                    // would otherwise be wiped on every rebase. Carry over only the keys
+                    // that are actually set so we don't spread `undefined` into the
+                    // rebuilt document. The strict document type does not declare every
+                    // x-scalar-* UI extension, so read them through an untyped view.
+                    const isOpenApi = isOpenApiDocument(activeDocumentRaw);
+                    const environments = isOpenApi ? activeDocumentRaw['x-scalar-environments'] : undefined;
+                    const order = isOpenApi ? activeDocumentRaw['x-scalar-order'] : undefined;
+                    // Keep user-configured servers when the merged document has none
+                    // (build-time generated specs typically declare no servers). When the
+                    // merged result already carries servers — whether from upstream or
+                    // preserved local edits — those stay authoritative.
+                    const mergedServers = mergedDocument.servers;
+                    const activeServers = activeDocumentRaw.servers;
+                    const mergedHasServers = Array.isArray(mergedServers) && mergedServers.length > 0;
+                    const activeHasServers = Array.isArray(activeServers) && activeServers.length > 0;
+                    const preservedServers = !isAsyncApiDocument(mergedDocument) && !mergedHasServers && activeHasServers
+                        ? deepClone(activeServers)
+                        : undefined;
                     // add the new active document to the workspace but don't re-initialize
                     await addInMemoryDocument({
                         ...input,
@@ -969,6 +988,12 @@ export const createWorkspaceStore = (workspaceProps) => {
                             ...input.meta,
                             // Preserve the registry meta
                             'x-scalar-registry-meta': activeDocumentRaw['x-scalar-registry-meta'],
+                            // Preserve document-level UI settings (see note above).
+                            'x-scalar-watch-mode': activeDocumentRaw['x-scalar-watch-mode'],
+                            'x-scalar-selected-server': activeDocumentRaw['x-scalar-selected-server'],
+                            ...(environments !== undefined ? { 'x-scalar-environments': environments } : {}),
+                            ...(order !== undefined ? { 'x-scalar-order': order } : {}),
+                            ...(preservedServers !== undefined ? { servers: preservedServers } : {}),
                             // Flag local edits that need pushing - see note above.
                             'x-scalar-is-dirty': hasLocalChangesAgainstUpstream,
                         },

package/dist/helpers/dynamic-ref.d.ts

@@ -0,0 +1,24 @@
+import type { SchemaObject } from '../schemas/v3.1/strict/schema.js';
+/**
+ * The dynamic scope, ordered outermost-first.
+ *
+ * Each entry is a schema resource on the current evaluation path. When a `$dynamicRef` is resolved,
+ * the outermost entry that declares a matching `$dynamicAnchor` wins.
+ */
+export type DynamicScope = SchemaObject[];
+/** Narrow a schema to one that carries a `$dynamicRef`. */
+export declare const isDynamicRef: (schema: unknown) => schema is SchemaObject & {
+    $dynamicRef: string;
+};
+export declare const collectDynamicAnchors: (resource: SchemaObject) => Map<string, SchemaObject>;
+/** Append a schema to the dynamic scope when it could hold a `$dynamicAnchor`, otherwise return it unchanged. */
+export declare const pushDynamicScope: (scope: DynamicScope, schema: SchemaObject) => DynamicScope;
+/**
+ * Resolve a `$dynamicRef` fragment against the dynamic scope.
+ *
+ * Scans the scope outermost-first and returns the first resource that declares a `$dynamicAnchor` with
+ * the referenced name. Returns `undefined` when nothing matches, in which case callers should leave the
+ * reference unresolved (the schema renders as it did before, with no regression).
+ */
+export declare const resolveDynamicRef: (dynamicRef: string, scope: DynamicScope) => SchemaObject | undefined;
+//# sourceMappingURL=dynamic-ref.d.ts.map

package/dist/helpers/dynamic-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-ref.d.ts","sourceRoot":"","sources":["../../src/helpers/dynamic-ref.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAiBhE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,EAAE,CAAA;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,KAAG,MAAM,IAAI,YAAY,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAItB,CAAA;AAqBvE,eAAO,MAAM,qBAAqB,GAAI,UAAU,YAAY,KAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAgCtF,CAAA;AAED,iHAAiH;AACjH,eAAO,MAAM,gBAAgB,GAAI,OAAO,YAAY,EAAE,QAAQ,YAAY,KAAG,YAClB,CAAA;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,EAAE,OAAO,YAAY,KAAG,YAAY,GAAG,SAe1F,CAAA"}

package/dist/helpers/dynamic-ref.js

@@ -0,0 +1,74 @@
+import { getResolvedRef, mergeSiblingReferences } from '../helpers/get-resolved-ref.js';
+import { unpackProxyObject } from '../helpers/unpack-proxy.js';
+/** Narrow a schema to one that carries a `$dynamicRef`. */
+export const isDynamicRef = (schema) => typeof schema === 'object' &&
+    schema !== null &&
+    '$dynamicRef' in schema &&
+    typeof schema.$dynamicRef === 'string';
+/**
+ * Whether a schema introduces something a `$dynamicRef` could later bind to.
+ *
+ * We only grow the dynamic scope with schemas that could hold a `$dynamicAnchor`: those declaring one
+ * directly, or resource boundaries (`$id`) / definition containers (`$defs`) that may hold one. Plain
+ * subschemas are skipped to keep the scope small.
+ */
+const carriesDynamicAnchor = (schema) => '$dynamicAnchor' in schema || '$id' in schema || '$defs' in schema;
+/**
+ * Collect the `$dynamicAnchor` declarations of a single schema resource, keyed by anchor name.
+ *
+ * Anchors are looked for at the resource root and inside `$defs` — the two placements used by the
+ * common generic and recursive patterns. Anchors nested deeper are not collected (a documented v1
+ * limitation). Each target is dereferenced so callers receive the concrete schema the anchor points to.
+ */
+const anchorCache = new WeakMap();
+export const collectDynamicAnchors = (resource) => {
+    // Cache per raw schema object so repeated lookups during a walk stay cheap.
+    const cacheTarget = unpackProxyObject(resource, { depth: 1 });
+    const cached = anchorCache.get(cacheTarget);
+    if (cached) {
+        return cached;
+    }
+    const anchors = new Map();
+    const add = (node) => {
+        if (!node || typeof node !== 'object') {
+            return;
+        }
+        const anchor = node.$dynamicAnchor;
+        if (typeof anchor === 'string' && !anchors.has(anchor)) {
+            // Resolve any sibling `$ref` so the stored target is the concrete schema (e.g. `User`).
+            anchors.set(anchor, getResolvedRef(node, mergeSiblingReferences));
+        }
+    };
+    add(resource);
+    const defs = resource.$defs;
+    if (defs && typeof defs === 'object') {
+        for (const key of Object.keys(defs)) {
+            add(defs[key]);
+        }
+    }
+    anchorCache.set(cacheTarget, anchors);
+    return anchors;
+};
+/** Append a schema to the dynamic scope when it could hold a `$dynamicAnchor`, otherwise return it unchanged. */
+export const pushDynamicScope = (scope, schema) => carriesDynamicAnchor(schema) ? [...scope, schema] : scope;
+/**
+ * Resolve a `$dynamicRef` fragment against the dynamic scope.
+ *
+ * Scans the scope outermost-first and returns the first resource that declares a `$dynamicAnchor` with
+ * the referenced name. Returns `undefined` when nothing matches, in which case callers should leave the
+ * reference unresolved (the schema renders as it did before, with no regression).
+ */
+export const resolveDynamicRef = (dynamicRef, scope) => {
+    // Only plain-name fragments (`#itemType`) are supported; a non-fragment URI is not a dynamic anchor.
+    const name = dynamicRef.startsWith('#') ? dynamicRef.slice(1) : undefined;
+    if (!name || name.startsWith('/')) {
+        return undefined;
+    }
+    for (const resource of scope) {
+        const match = collectDynamicAnchors(resource).get(name);
+        if (match) {
+            return match;
+        }
+    }
+    return undefined;
+};

package/dist/request-example/builder/helpers/get-example-from-schema.d.ts

@@ -1,3 +1,4 @@
+import { type DynamicScope } from '../../../helpers/dynamic-ref.js';
 import type { SchemaObject } from '../../../schemas/v3.1/strict/openapi-document.js';
 type GetExampleFromSchemaOptions = {
     /** Fallback string for empty string values. */
@@ -28,13 +29,15 @@ type GetExampleFromSchemaOptions = {
  * @param name - The name of the property being processed.
  * @returns An example value for the given schema.
  */
-export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, { level, parentSchema, name, seen, schemaPath, }?: Partial<{
+export declare const getExampleFromSchema: (schema: SchemaObject, options?: GetExampleFromSchemaOptions, { level, parentSchema, name, seen, schemaPath, dynamicScope, }?: Partial<{
     level: number;
     parentSchema: SchemaObject;
     name: string;
     seen: WeakSet<object>;
     /** Internal traversal path used to resolve nested composition selections. */
     schemaPath: string[];
+    /** Chain of schema resources entered so far, used to resolve `$dynamicRef` (JSON Schema 2020-12). */
+    dynamicScope: DynamicScope;
 }>) => unknown;
 export {};
 //# sourceMappingURL=get-example-from-schema.d.ts.map

package/dist/request-example/builder/helpers/get-example-from-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-example-from-schema.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example-from-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAypB1E,KAAK,2BAA2B,GAAG;IACjC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,8BAA8B,CAAC,EAAE,OAAO,CAAA;IACxC,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C,CAAA;AAeD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,mDAMG,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB,CAAM,KACN,OAqKF,CAAA"}
+{"version":3,"file":"get-example-from-schema.d.ts","sourceRoot":"","sources":["../../../../src/request-example/builder/helpers/get-example-from-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAqD,MAAM,uBAAuB,CAAA;AAG5G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAisB1E,KAAK,2BAA2B,GAAG;IACjC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,8BAA8B,CAAC,EAAE,OAAO,CAAA;IACxC,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C,CAAA;AAeD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,2BAA2B,EACrC,iEAOG,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qGAAqG;IACrG,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAM,KACN,OAmMF,CAAA"}

package/dist/request-example/builder/helpers/get-example-from-schema.js

@@ -1,4 +1,5 @@
 import { isDefined } from '@scalar/helpers/array/is-defined';
+import { isDynamicRef, pushDynamicScope, resolveDynamicRef } from '../../../helpers/dynamic-ref.js';
 import { unpackProxyObject } from '../../../helpers/unpack-proxy.js';
 import { resolve } from '../../../resolve.js';
 /** Maximum recursion depth to prevent infinite loops in circular references */
@@ -108,9 +109,13 @@ const getRequiredNames = (parentSchema) => {
  * Cache the result for a schema if it is an object type.
  * Primitive values are not cached to avoid unnecessary WeakMap operations.
  * Stores a map of cacheKey strings which is made up of the options object.
+ *
+ * Skips the cache while a dynamic scope is active: the same shared schema node can resolve to
+ * different examples depending on the dynamic scope it was reached through, so caching it by object
+ * identity would leak one scope's result into another.
  */
-const cache = (schema, result, cacheKey) => {
-    if (typeof result !== 'object' || result === null) {
+const cache = (schema, result, cacheKey, skip = false) => {
+    if (skip || typeof result !== 'object' || result === null) {
         return result;
     }
     const rawSchema = getSchemaCacheTarget(schema);
@@ -313,8 +318,11 @@ const sortPropertyNamesByXOrder = (properties) => Object.keys(properties).sort((
  * Build an example for an object schema, including properties, patternProperties,
  * additionalProperties, and composition (allOf/oneOf/anyOf) merging.
  */
-const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath) => {
+const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath, dynamicScope) => {
     const response = {};
+    // Children are evaluated with this schema added to the dynamic scope so nested `$dynamicRef`s bind here.
+    const childScope = pushDynamicScope(dynamicScope, schema);
+    const skipCache = dynamicScope.length > 0;
     if ('properties' in schema && schema.properties) {
         const properties = schema.properties;
         const propertyNames = sortPropertyNamesByXOrder(properties);
@@ -332,6 +340,7 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
                 name: propertyName,
                 schemaPath: [...schemaPath, propertyName],
                 seen,
+                dynamicScope: childScope,
             });
             if (typeof value !== 'undefined') {
                 response[propertyXmlName ?? propertyName] = value;
@@ -350,6 +359,7 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
                 name: pattern,
                 schemaPath: [...schemaPath, pattern],
                 seen,
+                dynamicScope: childScope,
             });
         }
     }
@@ -376,6 +386,7 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
                     level: level + 1,
                     schemaPath: [...schemaPath, additionalName],
                     seen,
+                    dynamicScope: childScope,
                 })
                 : 'anything';
         if (propertyNamesEnum && propertyNamesEnum.length > 0) {
@@ -396,6 +407,7 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
                 level: level + 1,
                 schemaPath,
                 seen,
+                dynamicScope: childScope,
             }));
         }
     }
@@ -407,6 +419,7 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
                 level: level + 1,
                 parentSchema: schema,
                 seen,
+                dynamicScope: childScope,
             });
             merged = mergeExamples(merged, ex);
         }
@@ -417,18 +430,33 @@ const handleObjectSchema = (schema, options, level, seen, cacheKey, schemaPath)
     if (options?.xml && 'xml' in schema && schema.xml?.name && level === 0) {
         const wrapped = {};
         wrapped[schema.xml.name] = response;
-        return cache(schema, wrapped, cacheKey);
+        return cache(schema, wrapped, cacheKey, skipCache);
     }
-    return cache(schema, response, cacheKey);
+    return cache(schema, response, cacheKey, skipCache);
 };
 /** Build an example for an array schema, including items, allOf, oneOf/anyOf, and XML wrapping */
-const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath) => {
-    const items = 'items' in schema ? resolve.schema(schema.items) : undefined;
+const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath, dynamicScope) => {
+    const childScope = pushDynamicScope(dynamicScope, schema);
+    const skipCache = dynamicScope.length > 0;
+    let items = 'items' in schema ? resolve.schema(schema.items) : undefined;
+    // Bind a dynamic item type (e.g. the generic `PaginatedResponse<T>` pattern) before inspecting it.
+    // Crossing a `$dynamicRef` leaves the static schema graph, so the cycle guard built up by the outer
+    // walk no longer applies to the bound type. Restart `seen` for the item recursion so recursive trees
+    // (e.g. a category whose children reference the same anchor) render their nested levels instead of
+    // tripping the shared guard. Depth stays bounded by `MAX_LEVELS_DEEP`.
+    let itemsSeen = seen;
+    if (items && isDynamicRef(items)) {
+        const resolvedDynamic = resolveDynamicRef(items.$dynamicRef, childScope);
+        if (resolvedDynamic) {
+            items = resolvedDynamic;
+            itemsSeen = new WeakSet();
+        }
+    }
     const itemsSchemaPath = [...schemaPath, 'items'];
     const itemsXmlTagName = items && typeof items === 'object' && 'xml' in items ? items.xml?.name : undefined;
     const wrapItems = !!(options?.xml && 'xml' in schema && schema.xml?.wrapped && itemsXmlTagName);
     if (schema.example !== undefined) {
-        return cache(schema, wrapItems ? { [itemsXmlTagName]: schema.example } : schema.example, cacheKey);
+        return cache(schema, wrapItems ? { [itemsXmlTagName]: schema.example } : schema.example, cacheKey, skipCache);
     }
     if (items && typeof items === 'object') {
         if (Array.isArray(items.allOf) && items.allOf.length > 0) {
@@ -440,19 +468,21 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath) =
                     level: level + 1,
                     parentSchema: schema,
                     schemaPath: itemsSchemaPath,
-                    seen,
+                    seen: itemsSeen,
+                    dynamicScope: childScope,
                 });
-                return cache(schema, wrapItems ? [{ [itemsXmlTagName]: merged }] : [merged], cacheKey);
+                return cache(schema, wrapItems ? [{ [itemsXmlTagName]: merged }] : [merged], cacheKey, skipCache);
             }
             const examples = allOf
                 .map((s) => getExampleFromSchema(resolve.schema(s), options, {
                 level: level + 1,
                 parentSchema: schema,
                 schemaPath: itemsSchemaPath,
-                seen,
+                seen: itemsSeen,
+                dynamicScope: childScope,
             }))
                 .filter(isDefined);
-            return cache(schema, wrapItems ? examples.map((e) => ({ [itemsXmlTagName]: e })) : examples, cacheKey);
+            return cache(schema, wrapItems ? examples.map((e) => ({ [itemsXmlTagName]: e })) : examples, cacheKey, skipCache);
         }
         const compositionKeyword = items.oneOf ? 'oneOf' : items.anyOf ? 'anyOf' : undefined;
         const union = compositionKeyword ? items[compositionKeyword] : undefined;
@@ -463,9 +493,10 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath) =
                 level: level + 1,
                 parentSchema: schema,
                 schemaPath: itemsSchemaPath,
-                seen,
+                seen: itemsSeen,
+                dynamicScope: childScope,
             });
-            return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey);
+            return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey, skipCache);
         }
     }
     const isObject = items && typeof items === 'object' && (('type' in items && items.type === 'object') || 'properties' in items);
@@ -474,11 +505,12 @@ const handleArraySchema = (schema, options, level, seen, cacheKey, schemaPath) =
         const ex = getExampleFromSchema(items, options, {
             level: level + 1,
             schemaPath: itemsSchemaPath,
-            seen,
+            seen: itemsSeen,
+            dynamicScope: childScope,
         });
-        return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey);
+        return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey, skipCache);
     }
-    return cache(schema, [], cacheKey);
+    return cache(schema, [], cacheKey, skipCache);
 };
 /** Return primitive example value for single-type schemas, or undefined if not primitive */
 const getPrimitiveValue = (schema, makeUpRandomData, emptyString) => {
@@ -552,12 +584,35 @@ const createOptionsCacheKey = (options) => JSON.stringify({
  * @param name - The name of the property being processed.
  * @returns An example value for the given schema.
  */
-export const getExampleFromSchema = (schema, options, { level = 0, parentSchema, name, seen = new WeakSet(), schemaPath = [], } = {}) => {
+export const getExampleFromSchema = (schema, options, { level = 0, parentSchema, name, seen = new WeakSet(), schemaPath = [], dynamicScope = [], } = {}) => {
     // Resolve any $ref references to get the actual schema
     const _schema = resolve.schema(schema);
     if (!isDefined(_schema)) {
         return undefined;
     }
+    // Resolve a `$dynamicRef` against the active dynamic scope, then continue with the bound schema.
+    // When nothing matches, fall through and render the reference as before (no regression).
+    if (isDynamicRef(_schema)) {
+        const resolvedDynamic = resolveDynamicRef(_schema.$dynamicRef, dynamicScope);
+        if (resolvedDynamic) {
+            // The `seen` set guards against cycles in the static schema graph, but a `$dynamicRef` is resolved
+            // per evaluation path and intentionally points outside that graph. Re-entering the bound type with a
+            // fresh `seen` lets recursive examples (e.g. a category tree) render their nested levels instead of
+            // bailing out on the shared cycle guard. Depth stays bounded by `MAX_LEVELS_DEEP`.
+            return getExampleFromSchema(resolvedDynamic, options, {
+                level: level + 1,
+                parentSchema,
+                name,
+                seen: new WeakSet(),
+                schemaPath,
+                dynamicScope,
+            });
+        }
+    }
+    // Grow the scope with this schema so nested references can bind to its `$dynamicAnchor`s.
+    const childScope = pushDynamicScope(dynamicScope, _schema);
+    // The same shared node can resolve differently per scope, so skip the result cache under a scope.
+    const skipCache = dynamicScope.length > 0;
     // Unpack from all proxies to get the raw schema object for cycle detection
     const targetValue = getSchemaCacheTarget(_schema);
     if (seen.has(targetValue)) {
@@ -566,11 +621,13 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
     seen.add(targetValue);
     /** Make the cache key unique per options and schema path */
     const cacheKey = createOptionsCacheKey(options) + (schemaPath.length > 0 ? `:path:${schemaPath.join('.')}` : '');
-    // Check cache first for performance - avoid recomputing the same schema
-    const cached = resultCache.get(targetValue)?.get(cacheKey);
-    if (typeof cached !== 'undefined') {
-        seen.delete(targetValue);
-        return cached;
+    // Check cache first for performance - avoid recomputing the same schema (skipped under a dynamic scope)
+    if (!skipCache) {
+        const cached = resultCache.get(targetValue)?.get(cacheKey);
+        if (typeof cached !== 'undefined') {
+            seen.delete(targetValue);
+            return cached;
+        }
     }
     // Prevent infinite recursion in circular references
     if (level > MAX_LEVELS_DEEP) {
@@ -591,45 +648,45 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
             // Type coercion for numeric types
             if ('type' in _schema && (_schema.type === 'number' || _schema.type === 'integer')) {
                 seen.delete(targetValue);
-                return cache(_schema, Number(value), cacheKey);
+                return cache(_schema, Number(value), cacheKey, skipCache);
             }
             seen.delete(targetValue);
-            return cache(_schema, value, cacheKey);
+            return cache(_schema, value, cacheKey, skipCache);
         }
     }
     // Priority order: examples > example > default > const > enum
     if (Array.isArray(_schema.examples) && _schema.examples.length > 0) {
         seen.delete(targetValue);
-        return cache(_schema, _schema.examples[0], cacheKey);
+        return cache(_schema, _schema.examples[0], cacheKey, skipCache);
     }
     if (_schema.example !== undefined) {
         seen.delete(targetValue);
-        return cache(_schema, _schema.example, cacheKey);
+        return cache(_schema, _schema.example, cacheKey, skipCache);
     }
     if (_schema.default !== undefined) {
         const normalizedDefault = normalizeSchemaDefault(_schema);
         if (normalizedDefault !== INVALID_DEFAULT) {
             seen.delete(targetValue);
-            return cache(_schema, normalizedDefault, cacheKey);
+            return cache(_schema, normalizedDefault, cacheKey, skipCache);
         }
     }
     if (_schema.const !== undefined) {
         seen.delete(targetValue);
-        return cache(_schema, _schema.const, cacheKey);
+        return cache(_schema, _schema.const, cacheKey, skipCache);
     }
     if (Array.isArray(_schema.enum) && _schema.enum.length > 0) {
         seen.delete(targetValue);
-        return cache(_schema, _schema.enum[0], cacheKey);
+        return cache(_schema, _schema.enum[0], cacheKey, skipCache);
     }
     // Handle object types - check for properties to identify objects
     if ('properties' in _schema || ('type' in _schema && _schema.type === 'object')) {
-        const result = handleObjectSchema(_schema, options, level, seen, cacheKey, schemaPath);
+        const result = handleObjectSchema(_schema, options, level, seen, cacheKey, schemaPath, dynamicScope);
         seen.delete(targetValue);
         return result;
     }
     // Handle array types
     if (('type' in _schema && _schema.type === 'array') || 'items' in _schema) {
-        const result = handleArraySchema(_schema, options, level, seen, cacheKey, schemaPath);
+        const result = handleArraySchema(_schema, options, level, seen, cacheKey, schemaPath, dynamicScope);
         seen.delete(targetValue);
         return result;
     }
@@ -637,7 +694,7 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
     const primitive = getPrimitiveValue(_schema, makeUpRandomData, options?.emptyString);
     if (primitive !== undefined) {
         seen.delete(targetValue);
-        return cache(_schema, primitive, cacheKey);
+        return cache(_schema, primitive, cacheKey, skipCache);
     }
     // Handle composition schemas (oneOf, anyOf)
     const compositionKeyword = _schema.oneOf ? 'oneOf' : _schema.anyOf ? 'anyOf' : undefined;
@@ -658,11 +715,12 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
                     level: level + 1,
                     schemaPath,
                     seen,
-                }), cacheKey);
+                    dynamicScope: childScope,
+                }), cacheKey, skipCache);
             }
         }
         seen.delete(targetValue);
-        return cache(_schema, null, cacheKey);
+        return cache(_schema, null, cacheKey, skipCache);
     }
     // Handle allOf at root level (non-object/array schemas)
     if (Array.isArray(_schema.allOf) && _schema.allOf.length > 0) {
@@ -674,6 +732,7 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
                 parentSchema: _schema,
                 schemaPath,
                 seen,
+                dynamicScope: childScope,
             });
             if (merged === undefined) {
                 merged = ex;
@@ -687,15 +746,15 @@ export const getExampleFromSchema = (schema, options, { level = 0, parentSchema,
             }
         }
         seen.delete(targetValue);
-        return cache(_schema, merged ?? null, cacheKey);
+        return cache(_schema, merged ?? null, cacheKey, skipCache);
     }
     // Handle union types (array of types)
     const unionPrimitive = getUnionPrimitiveValue(_schema, makeUpRandomData, options?.emptyString);
     if (unionPrimitive !== undefined) {
         seen.delete(targetValue);
-        return cache(_schema, unionPrimitive, cacheKey);
+        return cache(_schema, unionPrimitive, cacheKey, skipCache);
     }
     // Default fallback
     seen.delete(targetValue);
-    return cache(_schema, null, cacheKey);
+    return cache(_schema, null, cacheKey, skipCache);
 };

package/package.json

@@ -16,7 +16,7 @@
     "openapi",
     "scalar"
   ],
-  "version": "0.54.3",
+  "version": "0.54.4",
   "engines": {
     "node": ">=22"
   },
@@ -150,11 +150,11 @@
     "yaml": "^2.8.3",
     "@scalar/helpers": "0.8.2",
     "@scalar/json-magic": "0.12.16",
-    "@scalar/schemas": "0.4.3",
     "@scalar/openapi-upgrader": "0.2.9",
-    "@scalar/snippetz": "0.9.16",
-    "@scalar/types": "0.13.3",
-    "@scalar/validation": "0.6.0"
+    "@scalar/schemas": "0.5.0",
+    "@scalar/types": "0.14.0",
+    "@scalar/validation": "0.6.0",
+    "@scalar/snippetz": "0.9.17"
   },
   "devDependencies": {
     "@google-cloud/storage": "7.16.0",