@scalar/api-reference 1.62.0 → 1.62.2

package/dist/components/Content/Schema/SchemaProperty.vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaProperty.vue.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaProperty.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { ScalarMarkdown } from '@scalar/components/markdown'\nimport { ScalarWrappingText } from '@scalar/components/wrapping-text'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type {\n  DiscriminatorObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, type Component } from 'vue'\n\nimport { WithBreadcrumb } from '@/components/Anchor'\nimport { isTypeObject } from '@/components/Content/Schema/helpers/is-type-object'\nimport { getCycleKey } from '@/components/Content/Schema/helpers/schema-cycle'\nimport type { SchemaOptions } from '@/components/Content/Schema/types'\nimport { SpecificationExtension } from '@/features/specification-extension'\n\nimport { getCompositionsToRender } from './helpers/get-compositions-to-render'\nimport { getEnumValues } from './helpers/get-enum-values'\nimport { getPropertyDescription } from './helpers/get-property-description'\nimport { hasComplexArrayItems } from './helpers/has-complex-array-items'\nimport { optimizeValueForDisplay } from './helpers/optimize-value-for-display'\nimport { shouldDisplayDescription } from './helpers/should-display-description'\nimport { shouldDisplayHeading } from './helpers/should-display-heading'\nimport Schema from './Schema.vue'\nimport SchemaComposition from './SchemaComposition.vue'\nimport SchemaEnums from './SchemaEnums.vue'\nimport SchemaPropertyHeading from './SchemaPropertyHeading.vue'\n\n/**\n * Note: We're taking in a prop called `value` which should be a JSON Schema.\n *\n * We're using `optimizeValueForDisplay` to merge null types in compositions (anyOf, allOf, oneOf, not).\n * So you should basically use the optimizedValue everywhere in the component.\n */\n\n/** Composition keywords that hold a list of schemas and can be flattened when they contain a single member. */\nconst SINGLE_ITEM_COMPOSITIONS = ['oneOf', 'anyOf', 'allOf'] as const\n\nconst props = withDefaults(\n  defineProps<{\n    is?: string | Component\n    schema: SchemaObject | undefined\n    noncollapsible?: boolean\n    level?: number\n    name?: string\n    required?: boolean\n    compact?: boolean\n    discriminator?: DiscriminatorObject\n    description?: string\n    hideModelNames?: boolean\n    hideHeading?: boolean\n    /** When the root schema was resolved from a $ref, pass the ref name for display (e.g. \"Data\"). */\n    modelName?: string | null\n    variant?: 'additionalProperties' | 'patternProperties'\n    breadcrumb?: string[]\n    eventBus: WorkspaceEventBus | null\n    options: SchemaOptions\n    /** Enum values for property names (from JSON Schema propertyNames keyword). */\n    propertyNamesEnum?: string[]\n    /** Resolved propertyNames schema, used to show key constraints like `format`. */\n    propertyNamesSchema?: SchemaObject\n    /** When \"requestBody\", composition selection is synced with the example snippet */\n    schemaContext?: string\n    /** Internal path used to sync nested request body compositions with the code sample */\n    compositionPath?: string[]\n    /** Internal path segment for this property when building nested composition keys */\n    compositionPathSegment?: string\n    /** Stable identity of this property's schema, used for cycle detection. */\n    cycleKey?: unknown\n  }>(),\n  {\n    level: 0,\n    required: false,\n    compact: false,\n    hideModelNames: false,\n  },\n)\n\n/** Simplified composition with `null` type. */\nconst optimizedValue = computed(() => optimizeValueForDisplay(props.schema))\n\nconst childBreadcrumb = computed<string[] | undefined>(() =>\n  props.breadcrumb && props.name\n    ? [...props.breadcrumb, props.name]\n    : undefined,\n)\n\nconst currentCompositionPath = computed<string[]>(() =>\n  props.compositionPathSegment\n    ? [...(props.compositionPath ?? []), props.compositionPathSegment]\n    : (props.compositionPath ?? []),\n)\n\nconst arrayItemsCompositionPath = computed<string[]>(() => [\n  ...currentCompositionPath.value,\n  'items',\n])\n\nconst shouldHaveLink = computed(() => props.level <= 2)\n\n/** Checks if array items have complex structure */\nconst hasComplexArrayItemsComputed = computed(() =>\n  hasComplexArrayItems(optimizedValue.value),\n)\n\n/** Check if enum should be displayed (from value schema or from propertyNames) */\nconst hasEnum = computed(() => enumValues.value.length > 0)\n\n/** Determine if object properties should be displayed */\nconst shouldRenderObjectProperties = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return false\n  }\n\n  if (!('properties' in value || 'additionalProperties' in value)) {\n    return false\n  }\n\n  // `allOf` already merges the factored-out sibling `properties` into its\n  // rendered result (see `mergeAllOfSchemas`), so rendering a separate object\n  // block here would show those properties twice. Let the composition handle it.\n  if ('allOf' in value) {\n    return false\n  }\n\n  // A schema may factor its common `properties` out to the top level alongside\n  // a composition keyword (anyOf/oneOf/not), as described in the JSON Schema\n  // \"factoring schemas\" guide. `isTypeObject` deliberately rejects such schemas\n  // so the composition is rendered, but the factored-out properties must still\n  // show. Unlike `allOf`, these compositions do not merge sibling properties.\n  // Render them unless the schema is an explicit non-object (scalar or array)\n  // type. See https://github.com/scalar/scalar/issues/8593\n  const type = (value as { type?: unknown }).type\n  const isExplicitNonObject = typeof type === 'string' && type !== 'object'\n\n  return isTypeObject(value) || !isExplicitNonObject\n})\n\n/** Determine if array of objects should be rendered */\nconst shouldRenderArrayOfObjects = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return false\n  }\n\n  return hasComplexArrayItemsComputed.value\n})\n\n/** Extract enum values from schema or array items */\nconst enumValues = computed(() => getEnumValues(optimizedValue.value))\n\n/** Generate property description from type/format */\nconst propertyDescription = computed(() =>\n  getPropertyDescription(optimizedValue.value),\n)\n\n/** Determine if description should be displayed */\nconst displayDescription = computed(() =>\n  shouldDisplayDescription(optimizedValue.value, props.description),\n)\n\n/**\n * The schema used to render the object's own properties.\n *\n * Composition keywords are stripped so the nested object renders only its\n * properties. The compositions are rendered separately below; leaving them here\n * would route the nested `Schema` back through `SchemaProperty` and recurse.\n *\n * When the property already renders the description, we also drop it to avoid\n * repeating it in the nested object schema card.\n */\nconst objectSchemaForChildren = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return value\n  }\n\n  const {\n    oneOf: _oneOf,\n    anyOf: _anyOf,\n    allOf: _allOf,\n    not: _not,\n    ...objectSchema\n  } = value as Record<string, unknown>\n\n  if (displayDescription.value && 'description' in objectSchema) {\n    const { description: _description, ...schemaWithoutDescription } =\n      objectSchema\n    return schemaWithoutDescription as SchemaObject\n  }\n\n  return objectSchema as SchemaObject\n})\n\n/** Determine if property heading should be displayed */\nconst shouldDisplayHeadingComputed = computed(() =>\n  shouldDisplayHeading(optimizedValue.value, props.name, props.required),\n)\n\n/** Computes which compositions should be rendered and with which values */\nconst compositionsToRender = computed(() =>\n  getCompositionsToRender(optimizedValue.value, props.options.document),\n)\n\n/**\n * Get resolved array items for rendering.\n *\n * When the items are wrapped in a single-item composition (e.g. `items: { allOf: [{ type: 'object', ... }] }`), we\n * flatten that wrapper into its plain form. A composition with a single member is equivalent to that member, so\n * keeping the composition keyword only makes the items render through an extra schema layer, which adds an\n * unnecessary level of nesting and duplicates the item description. See https://github.com/scalar/scalar/issues/5900\n */\nconst resolvedArrayItems = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return undefined\n  }\n\n  const items = resolve.schema(value.items)\n  const hasSingleItemComposition = SINGLE_ITEM_COMPOSITIONS.some(\n    (keyword) =>\n      Array.isArray(items?.[keyword]) && items[keyword]?.length === 1,\n  )\n\n  return hasSingleItemComposition ? optimizeValueForDisplay(items) : items\n})\n\n/**\n * Cycle key for the array items schema, derived from the raw (unresolved) items\n * so a self-referential array element is detected as a cycle.\n */\nconst arrayItemsCycleKey = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value)) {\n    return undefined\n  }\n  return getCycleKey(value.items)\n})\n\n/** Check if discriminator matches current property */\nconst isDiscriminatorProperty = computed(() =>\n  Boolean(props.name && props.discriminator?.propertyName === props.name),\n)\n</script>\n<template>\n  <component\n    :is=\"is ?? 'li'\"\n    class=\"property\"\n    :class=\"[\n      `property--level-${level}`,\n      {\n        'property--compact': compact,\n        'property--deprecated': optimizedValue?.deprecated,\n      },\n    ]\">\n    <SchemaPropertyHeading\n      v-if=\"shouldDisplayHeadingComputed\"\n      class=\"group\"\n      :enum=\"hasEnum\"\n      :eventBus=\"eventBus\"\n      :hideModelNames\n      :isDiscriminator=\"isDiscriminatorProperty\"\n      :modelName=\"modelName\"\n      :propertyNames=\"propertyNamesSchema\"\n      :required\n      :value=\"optimizedValue\">\n      <template\n        v-if=\"name\"\n        #name>\n        <WithBreadcrumb\n          :breadcrumb=\"shouldHaveLink ? childBreadcrumb : undefined\"\n          :eventBus=\"eventBus\">\n          <span\n            v-if=\"variant === 'patternProperties'\"\n            class=\"property-name-pattern-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <span\n            v-else-if=\"variant === 'additionalProperties'\"\n            class=\"property-name-additional-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <ScalarWrappingText\n            v-else\n            preset=\"property\"\n            :text=\"name\" />\n        </WithBreadcrumb>\n      </template>\n      <template\n        v-if=\"optimizedValue?.example !== undefined\"\n        #example>\n        Example:\n        {{ optimizedValue.example }}\n      </template>\n    </SchemaPropertyHeading>\n\n    <!-- Description -->\n    <div\n      v-if=\"displayDescription || propertyDescription\"\n      class=\"property-description\">\n      <ScalarMarkdown\n        :value=\"displayDescription || propertyDescription || ''\" />\n    </div>\n\n    <!-- Enum for property names -->\n    <SchemaEnums\n      v-if=\"propertyNamesEnum && propertyNamesEnum.length > 0\"\n      propertyNames\n      :value=\"{ enum: propertyNamesEnum } as SchemaObject\" />\n\n    <!-- Enum values -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0\"\n      :value=\"optimizedValue\" />\n\n    <!-- Object -->\n    <div\n      v-if=\"shouldRenderObjectProperties\"\n      class=\"children\">\n      <Schema\n        :breadcrumb=\"childBreadcrumb\"\n        :compact=\"compact\"\n        :compositionPath=\"currentCompositionPath\"\n        :cycleKey=\"cycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"objectSchemaForChildren\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Array of objects or nested arrays -->\n    <div\n      v-if=\"shouldRenderArrayOfObjects && resolvedArrayItems\"\n      class=\"children\">\n      <Schema\n        :compact=\"compact\"\n        :compositionPath=\"arrayItemsCompositionPath\"\n        :cycleKey=\"arrayItemsCycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"resolve.schema(resolvedArrayItems)\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Compositions -->\n    <SchemaComposition\n      v-for=\"compositionData in compositionsToRender\"\n      :key=\"compositionData.composition\"\n      :breadcrumb=\"breadcrumb\"\n      :compact=\"compact\"\n      :composition=\"compositionData.composition\"\n      :compositionPath=\"currentCompositionPath\"\n      :discriminator=\"schema?.discriminator\"\n      :eventBus=\"eventBus\"\n      :hideHeading=\"hideHeading\"\n      :hideModelNames\n      :level=\"level\"\n      :name=\"name\"\n      :noncollapsible=\"noncollapsible\"\n      :options=\"options\"\n      :schema=\"compositionData.value\"\n      :schemaContext=\"schemaContext\" />\n    <SpecificationExtension :value=\"optimizedValue\" />\n  </component>\n</template>\n\n<style scoped>\n.property {\n  color: var(--scalar-color-1);\n  display: flex;\n  flex-direction: column;\n  padding: 10px;\n  font-size: var(--scalar-small);\n  position: relative;\n}\n\n/** Remove top padding for top level schema card */\n.property.property--level-0:has(\n    > .property-rule\n      > .schema-card\n      > .schema-properties.schema-properties-open\n      > ul\n      > li.property\n  ) {\n  padding-top: 0;\n}\n\n.property--compact.property--level-0,\n.property--compact.property--level-1 {\n  padding: 10px 0;\n}\n\n.composition-panel .property.property.property.property--level-0 {\n  padding: 0px;\n}\n\n.property--compact.property--level-0\n  .composition-panel\n  .property--compact.property--level-1 {\n  padding: 8px;\n}\n\n/*  if a property doesn't have a heading, remove the top padding */\n.property:has(> .property-rule:nth-of-type(1)):not(.property--compact) {\n  padding-top: 8px;\n  padding-bottom: 8px;\n}\n\n.property--deprecated {\n  background: repeating-linear-gradient(\n    -45deg,\n    var(--scalar-background-2) 0,\n    var(--scalar-background-2) 2px,\n    transparent 2px,\n    transparent 5px\n  );\n  background-size: 100%;\n}\n\n.property--deprecated > * {\n  opacity: 0.75;\n}\n\n.property-description {\n  margin-top: 6px;\n  line-height: 1.4;\n  font-size: var(--scalar-small);\n}\n\n.property-description:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n:deep(.property-description) * {\n  color: var(--scalar-color-2) !important;\n}\n\n.property:not(:last-of-type) {\n  border-bottom: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-description + .children,\n.children + .property-rule {\n  margin-top: 9px;\n}\n\n.children {\n  display: flex;\n  flex-direction: column;\n}\n\n.children .property--compact.property--level-1 {\n  padding: 12px;\n}\n\n.property-example-value {\n  all: unset;\n  font-family: var(--scalar-font-code);\n  padding: 6px;\n  border-top: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-rule {\n  border-radius: var(--scalar-radius-lg);\n  display: flex;\n  flex-direction: column;\n}\n\n.property--level-2 :deep(.relative > button) {\n  left: -2rem;\n}\n\n.property-rule\n  :deep(\n    .composition-panel\n      .schema-card--level-1\n      > .schema-properties.schema-properties-open\n  ) {\n  border-radius: 0 0 var(--scalar-radius-lg) var(--scalar-radius-lg);\n}\n\n.property-rule\n  :deep(.composition-panel > .schema-card > .schema-card-description) {\n  padding: 10px;\n  border-left: var(--scalar-border-width) solid var(--scalar-border-color);\n  border-right: var(--scalar-border-width) solid var(--scalar-border-color);\n\n  & + .schema-properties {\n    margin-top: 0;\n  }\n}\n\n.property-example {\n  background: transparent;\n  border: none;\n  display: flex;\n  flex-direction: row;\n  gap: 8px;\n}\n\n.property-example-label,\n.property-example-value {\n  padding: 3px 0 0 0;\n}\n\n.property-example-value {\n  background: var(--scalar-background-2);\n  border-top: 0;\n  border-radius: var(--scalar-radius);\n  padding: 3px 4px;\n}\n\n.property-name {\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-semibold);\n}\n\n.property-name-additional-properties::before,\n.property-name-pattern-properties::before {\n  text-transform: uppercase;\n  font-size: var(--scalar-micro);\n  display: inline-block;\n  padding: 2px 4px;\n  border-radius: var(--scalar-radius);\n  color: var(--scalar-color-1);\n  border: var(--scalar-border-width) solid var(--scalar-border-color);\n  background-color: var(--scalar-background-2);\n  margin-right: 4px;\n}\n\n.property-name-pattern-properties::before {\n  content: 'regex';\n}\n\n.property-name-additional-properties,\n.property-name-pattern-properties {\n  border: 1px dashed var(--scalar-border-color);\n  color: var(--scalar-color-accent);\n  display: inline-block;\n  padding: 2px;\n  border-radius: var(--scalar-radius);\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"SchemaProperty.vue.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaProperty.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { ScalarMarkdown } from '@scalar/components/markdown'\nimport { ScalarWrappingText } from '@scalar/components/wrapping-text'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport {\n  isDynamicRef,\n  resolveDynamicRef,\n} from '@scalar/workspace-store/helpers/dynamic-ref'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type {\n  DiscriminatorObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, type Component } from 'vue'\n\nimport { WithBreadcrumb } from '@/components/Anchor'\nimport {\n  resolveDynamicSchema,\n  useDynamicScope,\n} from '@/components/Content/Schema/helpers/dynamic-scope'\nimport { isTypeObject } from '@/components/Content/Schema/helpers/is-type-object'\nimport { getCycleKey } from '@/components/Content/Schema/helpers/schema-cycle'\nimport type { SchemaOptions } from '@/components/Content/Schema/types'\nimport { SpecificationExtension } from '@/features/specification-extension'\n\nimport { getCompositionsToRender } from './helpers/get-compositions-to-render'\nimport { getEnumValues } from './helpers/get-enum-values'\nimport { getPropertyDescription } from './helpers/get-property-description'\nimport { hasComplexArrayItems } from './helpers/has-complex-array-items'\nimport { optimizeValueForDisplay } from './helpers/optimize-value-for-display'\nimport { shouldDisplayDescription } from './helpers/should-display-description'\nimport { shouldDisplayHeading } from './helpers/should-display-heading'\nimport Schema from './Schema.vue'\nimport SchemaComposition from './SchemaComposition.vue'\nimport SchemaEnums from './SchemaEnums.vue'\nimport SchemaPropertyHeading from './SchemaPropertyHeading.vue'\n\n/**\n * Note: We're taking in a prop called `value` which should be a JSON Schema.\n *\n * We're using `optimizeValueForDisplay` to merge null types in compositions (anyOf, allOf, oneOf, not).\n * So you should basically use the optimizedValue everywhere in the component.\n */\n\n/** Composition keywords that hold a list of schemas and can be flattened when they contain a single member. */\nconst SINGLE_ITEM_COMPOSITIONS = ['oneOf', 'anyOf', 'allOf'] as const\n\nconst props = withDefaults(\n  defineProps<{\n    is?: string | Component\n    schema: SchemaObject | undefined\n    noncollapsible?: boolean\n    level?: number\n    name?: string\n    required?: boolean\n    compact?: boolean\n    discriminator?: DiscriminatorObject\n    description?: string\n    hideModelNames?: boolean\n    hideHeading?: boolean\n    /** When the root schema was resolved from a $ref, pass the ref name for display (e.g. \"Data\"). */\n    modelName?: string | null\n    variant?: 'additionalProperties' | 'patternProperties'\n    breadcrumb?: string[]\n    eventBus: WorkspaceEventBus | null\n    options: SchemaOptions\n    /** Enum values for property names (from JSON Schema propertyNames keyword). */\n    propertyNamesEnum?: string[]\n    /** Resolved propertyNames schema, used to show key constraints like `format`. */\n    propertyNamesSchema?: SchemaObject\n    /** When \"requestBody\", composition selection is synced with the example snippet */\n    schemaContext?: string\n    /** Internal path used to sync nested request body compositions with the code sample */\n    compositionPath?: string[]\n    /** Internal path segment for this property when building nested composition keys */\n    compositionPathSegment?: string\n    /** Stable identity of this property's schema, used for cycle detection. */\n    cycleKey?: unknown\n  }>(),\n  {\n    level: 0,\n    required: false,\n    compact: false,\n    hideModelNames: false,\n  },\n)\n\n/** The dynamic scope inherited from the enclosing schema resources, used to bind `$dynamicRef`s. */\nconst dynamicScope = useDynamicScope()\n\n/**\n * Simplified composition with `null` type.\n *\n * A top-level `$dynamicRef` (e.g. a linked-list `next` node) is bound to its concrete type via the\n * dynamic scope first; for ordinary schemas this is a no-op.\n */\nconst optimizedValue = computed(() =>\n  optimizeValueForDisplay(resolveDynamicSchema(props.schema, dynamicScope)),\n)\n\nconst childBreadcrumb = computed<string[] | undefined>(() =>\n  props.breadcrumb && props.name\n    ? [...props.breadcrumb, props.name]\n    : undefined,\n)\n\nconst currentCompositionPath = computed<string[]>(() =>\n  props.compositionPathSegment\n    ? [...(props.compositionPath ?? []), props.compositionPathSegment]\n    : (props.compositionPath ?? []),\n)\n\nconst arrayItemsCompositionPath = computed<string[]>(() => [\n  ...currentCompositionPath.value,\n  'items',\n])\n\nconst shouldHaveLink = computed(() => props.level <= 2)\n\n/**\n * The array schema used for item inspection, with a `$dynamicRef` item bound to its concrete type.\n *\n * Returns the schema unchanged unless `items` is a `$dynamicRef` that resolves against the dynamic\n * scope, so ordinary arrays (including `$ref` items) keep their existing behavior exactly.\n */\nconst arrayValueWithBoundItems = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || !isDynamicRef(value.items)) {\n    return value\n  }\n\n  const bound = resolveDynamicRef(value.items.$dynamicRef, dynamicScope)\n  return bound ? ({ ...value, items: bound } as SchemaObject) : value\n})\n\n/** Checks if array items have complex structure */\nconst hasComplexArrayItemsComputed = computed(() =>\n  hasComplexArrayItems(arrayValueWithBoundItems.value),\n)\n\n/** Check if enum should be displayed (from value schema or from propertyNames) */\nconst hasEnum = computed(() => enumValues.value.length > 0)\n\n/** Determine if object properties should be displayed */\nconst shouldRenderObjectProperties = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return false\n  }\n\n  if (!('properties' in value || 'additionalProperties' in value)) {\n    return false\n  }\n\n  // `allOf` already merges the factored-out sibling `properties` into its\n  // rendered result (see `mergeAllOfSchemas`), so rendering a separate object\n  // block here would show those properties twice. Let the composition handle it.\n  if ('allOf' in value) {\n    return false\n  }\n\n  // A schema may factor its common `properties` out to the top level alongside\n  // a composition keyword (anyOf/oneOf/not), as described in the JSON Schema\n  // \"factoring schemas\" guide. `isTypeObject` deliberately rejects such schemas\n  // so the composition is rendered, but the factored-out properties must still\n  // show. Unlike `allOf`, these compositions do not merge sibling properties.\n  // Render them unless the schema is an explicit non-object (scalar or array)\n  // type. See https://github.com/scalar/scalar/issues/8593\n  const type = (value as { type?: unknown }).type\n  const isExplicitNonObject = typeof type === 'string' && type !== 'object'\n\n  return isTypeObject(value) || !isExplicitNonObject\n})\n\n/** Determine if array of objects should be rendered */\nconst shouldRenderArrayOfObjects = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return false\n  }\n\n  return hasComplexArrayItemsComputed.value\n})\n\n/** Extract enum values from schema or array items */\nconst enumValues = computed(() => getEnumValues(optimizedValue.value))\n\n/** Generate property description from type/format */\nconst propertyDescription = computed(() =>\n  getPropertyDescription(optimizedValue.value),\n)\n\n/** Determine if description should be displayed */\nconst displayDescription = computed(() =>\n  shouldDisplayDescription(optimizedValue.value, props.description),\n)\n\n/**\n * The schema used to render the object's own properties.\n *\n * Composition keywords are stripped so the nested object renders only its\n * properties. The compositions are rendered separately below; leaving them here\n * would route the nested `Schema` back through `SchemaProperty` and recurse.\n *\n * The `discriminator` is stripped too: its variant selector is part of the\n * composition rendered below (including the one inferred from a bare\n * `discriminator.mapping`), so keeping it here would make the nested `Schema`\n * infer and render a second, identical selector.\n *\n * When the property already renders the description, we also drop it to avoid\n * repeating it in the nested object schema card.\n */\nconst objectSchemaForChildren = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return value\n  }\n\n  const {\n    oneOf: _oneOf,\n    anyOf: _anyOf,\n    allOf: _allOf,\n    not: _not,\n    discriminator: _discriminator,\n    ...objectSchema\n  } = value as Record<string, unknown>\n\n  if (displayDescription.value && 'description' in objectSchema) {\n    const { description: _description, ...schemaWithoutDescription } =\n      objectSchema\n    return schemaWithoutDescription as SchemaObject\n  }\n\n  return objectSchema as SchemaObject\n})\n\n/** Determine if property heading should be displayed */\nconst shouldDisplayHeadingComputed = computed(() =>\n  shouldDisplayHeading(optimizedValue.value, props.name, props.required),\n)\n\n/** Computes which compositions should be rendered and with which values */\nconst compositionsToRender = computed(() =>\n  getCompositionsToRender(optimizedValue.value, props.options.document),\n)\n\n/**\n * Get resolved array items for rendering (with any `$dynamicRef` bound to the concrete type).\n *\n * When the items are wrapped in a single-item composition (e.g. `items: { allOf: [{ type: 'object', ... }] }`), we\n * flatten that wrapper into its plain form. A composition with a single member is equivalent to that member, so\n * keeping the composition keyword only makes the items render through an extra schema layer, which adds an\n * unnecessary level of nesting and duplicates the item description. See https://github.com/scalar/scalar/issues/5900\n */\nconst resolvedArrayItems = computed(() => {\n  const value = arrayValueWithBoundItems.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return undefined\n  }\n\n  const items = resolve.schema(value.items)\n  const hasSingleItemComposition = SINGLE_ITEM_COMPOSITIONS.some(\n    (keyword) =>\n      Array.isArray(items?.[keyword]) && items[keyword]?.length === 1,\n  )\n\n  return hasSingleItemComposition ? optimizeValueForDisplay(items) : items\n})\n\n/**\n * Cycle key for the array items schema, derived from the raw (unresolved) items\n * so a self-referential array element is detected as a cycle.\n */\nconst arrayItemsCycleKey = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value)) {\n    return undefined\n  }\n  return getCycleKey(value.items)\n})\n\n/** Check if discriminator matches current property */\nconst isDiscriminatorProperty = computed(() =>\n  Boolean(props.name && props.discriminator?.propertyName === props.name),\n)\n</script>\n<template>\n  <component\n    :is=\"is ?? 'li'\"\n    class=\"property\"\n    :class=\"[\n      `property--level-${level}`,\n      {\n        'property--compact': compact,\n        'property--deprecated': optimizedValue?.deprecated,\n      },\n    ]\">\n    <SchemaPropertyHeading\n      v-if=\"shouldDisplayHeadingComputed\"\n      class=\"group\"\n      :enum=\"hasEnum\"\n      :eventBus=\"eventBus\"\n      :hideModelNames\n      :isDiscriminator=\"isDiscriminatorProperty\"\n      :modelName=\"modelName\"\n      :propertyNames=\"propertyNamesSchema\"\n      :required\n      :value=\"optimizedValue\">\n      <template\n        v-if=\"name\"\n        #name>\n        <WithBreadcrumb\n          :breadcrumb=\"shouldHaveLink ? childBreadcrumb : undefined\"\n          :eventBus=\"eventBus\">\n          <span\n            v-if=\"variant === 'patternProperties'\"\n            class=\"property-name-pattern-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <span\n            v-else-if=\"variant === 'additionalProperties'\"\n            class=\"property-name-additional-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <ScalarWrappingText\n            v-else\n            preset=\"property\"\n            :text=\"name\" />\n        </WithBreadcrumb>\n      </template>\n      <template\n        v-if=\"optimizedValue?.example !== undefined\"\n        #example>\n        Example:\n        {{ optimizedValue.example }}\n      </template>\n    </SchemaPropertyHeading>\n\n    <!-- Description -->\n    <div\n      v-if=\"displayDescription || propertyDescription\"\n      class=\"property-description\">\n      <ScalarMarkdown\n        :value=\"displayDescription || propertyDescription || ''\" />\n    </div>\n\n    <!-- Enum for property names -->\n    <SchemaEnums\n      v-if=\"propertyNamesEnum && propertyNamesEnum.length > 0\"\n      propertyNames\n      :value=\"{ enum: propertyNamesEnum } as SchemaObject\" />\n\n    <!-- Enum values -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0\"\n      :value=\"optimizedValue\" />\n\n    <!-- Object -->\n    <div\n      v-if=\"shouldRenderObjectProperties\"\n      class=\"children\">\n      <Schema\n        :breadcrumb=\"childBreadcrumb\"\n        :compact=\"compact\"\n        :compositionPath=\"currentCompositionPath\"\n        :cycleKey=\"cycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"objectSchemaForChildren\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Array of objects or nested arrays -->\n    <div\n      v-if=\"shouldRenderArrayOfObjects && resolvedArrayItems\"\n      class=\"children\">\n      <Schema\n        :compact=\"compact\"\n        :compositionPath=\"arrayItemsCompositionPath\"\n        :cycleKey=\"arrayItemsCycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"resolve.schema(resolvedArrayItems)\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Compositions -->\n    <SchemaComposition\n      v-for=\"compositionData in compositionsToRender\"\n      :key=\"compositionData.composition\"\n      :breadcrumb=\"breadcrumb\"\n      :compact=\"compact\"\n      :composition=\"compositionData.composition\"\n      :compositionPath=\"currentCompositionPath\"\n      :discriminator=\"schema?.discriminator\"\n      :eventBus=\"eventBus\"\n      :hideHeading=\"hideHeading\"\n      :hideModelNames\n      :level=\"level\"\n      :name=\"name\"\n      :noncollapsible=\"noncollapsible\"\n      :options=\"options\"\n      :schema=\"compositionData.value\"\n      :schemaContext=\"schemaContext\" />\n    <SpecificationExtension :value=\"optimizedValue\" />\n  </component>\n</template>\n\n<style scoped>\n.property {\n  color: var(--scalar-color-1);\n  display: flex;\n  flex-direction: column;\n  padding: 10px;\n  font-size: var(--scalar-small);\n  position: relative;\n}\n\n/** Remove top padding for top level schema card */\n.property.property--level-0:has(\n    > .property-rule\n      > .schema-card\n      > .schema-properties.schema-properties-open\n      > ul\n      > li.property\n  ) {\n  padding-top: 0;\n}\n\n.property--compact.property--level-0,\n.property--compact.property--level-1 {\n  padding: 10px 0;\n}\n\n.composition-panel .property.property.property.property--level-0 {\n  padding: 0px;\n}\n\n.property--compact.property--level-0\n  .composition-panel\n  .property--compact.property--level-1 {\n  padding: 8px;\n}\n\n/*  if a property doesn't have a heading, remove the top padding */\n.property:has(> .property-rule:nth-of-type(1)):not(.property--compact) {\n  padding-top: 8px;\n  padding-bottom: 8px;\n}\n\n.property--deprecated {\n  background: repeating-linear-gradient(\n    -45deg,\n    var(--scalar-background-2) 0,\n    var(--scalar-background-2) 2px,\n    transparent 2px,\n    transparent 5px\n  );\n  background-size: 100%;\n}\n\n.property--deprecated > * {\n  opacity: 0.75;\n}\n\n.property-description {\n  margin-top: 6px;\n  line-height: 1.4;\n  font-size: var(--scalar-small);\n}\n\n.property-description:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n:deep(.property-description) * {\n  color: var(--scalar-color-2) !important;\n}\n\n.property:not(:last-of-type) {\n  border-bottom: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-description + .children,\n.children + .property-rule {\n  margin-top: 9px;\n}\n\n.children {\n  display: flex;\n  flex-direction: column;\n}\n\n.children .property--compact.property--level-1 {\n  padding: 12px;\n}\n\n.property-example-value {\n  all: unset;\n  font-family: var(--scalar-font-code);\n  padding: 6px;\n  border-top: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-rule {\n  border-radius: var(--scalar-radius-lg);\n  display: flex;\n  flex-direction: column;\n}\n\n.property--level-2 :deep(.relative > button) {\n  left: -2rem;\n}\n\n.property-rule\n  :deep(\n    .composition-panel\n      .schema-card--level-1\n      > .schema-properties.schema-properties-open\n  ) {\n  border-radius: 0 0 var(--scalar-radius-lg) var(--scalar-radius-lg);\n}\n\n.property-rule\n  :deep(.composition-panel > .schema-card > .schema-card-description) {\n  padding: 10px;\n  border-left: var(--scalar-border-width) solid var(--scalar-border-color);\n  border-right: var(--scalar-border-width) solid var(--scalar-border-color);\n\n  & + .schema-properties {\n    margin-top: 0;\n  }\n}\n\n.property-example {\n  background: transparent;\n  border: none;\n  display: flex;\n  flex-direction: row;\n  gap: 8px;\n}\n\n.property-example-label,\n.property-example-value {\n  padding: 3px 0 0 0;\n}\n\n.property-example-value {\n  background: var(--scalar-background-2);\n  border-top: 0;\n  border-radius: var(--scalar-radius);\n  padding: 3px 4px;\n}\n\n.property-name {\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-semibold);\n}\n\n.property-name-additional-properties::before,\n.property-name-pattern-properties::before {\n  text-transform: uppercase;\n  font-size: var(--scalar-micro);\n  display: inline-block;\n  padding: 2px 4px;\n  border-radius: var(--scalar-radius);\n  color: var(--scalar-color-1);\n  border: var(--scalar-border-width) solid var(--scalar-border-color);\n  background-color: var(--scalar-background-2);\n  margin-right: 4px;\n}\n\n.property-name-pattern-properties::before {\n  content: 'regex';\n}\n\n.property-name-additional-properties,\n.property-name-pattern-properties {\n  border: 1px dashed var(--scalar-border-color);\n  color: var(--scalar-color-accent);\n  display: inline-block;\n  padding: 2px;\n  border-radius: var(--scalar-radius);\n}\n</style>\n"],"mappings":""}

package/dist/components/Content/Schema/SchemaProperty.vue.script.js

@@ -1,21 +1,23 @@
 import WithBreadcrumb_default from "../../Anchor/WithBreadcrumb.vue.js";
 import SpecificationExtension_default from "../../../features/specification-extension/SpecificationExtension.vue.js";
-import { isTypeObject } from "./helpers/is-type-object.js";
-import { getCycleKey } from "./helpers/schema-cycle.js";
+import { resolveDynamicSchema, useDynamicScope } from "./helpers/dynamic-scope.js";
 import { hasComplexArrayItems } from "./helpers/has-complex-array-items.js";
 import { getCompositionsToRender } from "./helpers/get-compositions-to-render.js";
+import { isTypeObject } from "./helpers/is-type-object.js";
+import { getCycleKey } from "./helpers/schema-cycle.js";
+import SchemaComposition_default from "./SchemaComposition.vue.js";
 import { getEnumValues } from "./helpers/get-enum-values.js";
 import { getPropertyDescription } from "./helpers/get-property-description.js";
 import { optimizeValueForDisplay } from "./helpers/optimize-value-for-display.js";
 import { shouldDisplayDescription } from "./helpers/should-display-description.js";
 import { shouldDisplayHeading } from "./helpers/should-display-heading.js";
-import SchemaComposition_default from "./SchemaComposition.vue.js";
 import SchemaEnums_default from "./SchemaEnums.vue.js";
 import SchemaPropertyHeading_default from "./SchemaPropertyHeading.vue.js";
 import Schema_default from "./Schema.vue.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createSlots, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, renderList, resolveDynamicComponent, toDisplayString, unref, withCtx } from "vue";
 import { ScalarMarkdown } from "@scalar/components/markdown";
 import { resolve } from "@scalar/workspace-store/resolve";
+import { isDynamicRef, resolveDynamicRef } from "@scalar/workspace-store/helpers/dynamic-ref";
 import { isArraySchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
 import { ScalarWrappingText } from "@scalar/components/wrapping-text";
 //#region src/components/Content/Schema/SchemaProperty.vue?vue&type=script&setup=true&lang.ts
@@ -88,14 +90,36 @@ var SchemaProperty_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 			"allOf"
 		];
 		const props = __props;
-		/** Simplified composition with `null` type. */
-		const optimizedValue = computed(() => optimizeValueForDisplay(props.schema));
+		/** The dynamic scope inherited from the enclosing schema resources, used to bind `$dynamicRef`s. */
+		const dynamicScope = useDynamicScope();
+		/**
+		* Simplified composition with `null` type.
+		*
+		* A top-level `$dynamicRef` (e.g. a linked-list `next` node) is bound to its concrete type via the
+		* dynamic scope first; for ordinary schemas this is a no-op.
+		*/
+		const optimizedValue = computed(() => optimizeValueForDisplay(resolveDynamicSchema(props.schema, dynamicScope)));
 		const childBreadcrumb = computed(() => props.breadcrumb && props.name ? [...props.breadcrumb, props.name] : void 0);
 		const currentCompositionPath = computed(() => props.compositionPathSegment ? [...props.compositionPath ?? [], props.compositionPathSegment] : props.compositionPath ?? []);
 		const arrayItemsCompositionPath = computed(() => [...currentCompositionPath.value, "items"]);
 		const shouldHaveLink = computed(() => props.level <= 2);
+		/**
+		* The array schema used for item inspection, with a `$dynamicRef` item bound to its concrete type.
+		*
+		* Returns the schema unchanged unless `items` is a `$dynamicRef` that resolves against the dynamic
+		* scope, so ordinary arrays (including `$ref` items) keep their existing behavior exactly.
+		*/
+		const arrayValueWithBoundItems = computed(() => {
+			const value = optimizedValue.value;
+			if (!value || !isArraySchema(value) || !isDynamicRef(value.items)) return value;
+			const bound = resolveDynamicRef(value.items.$dynamicRef, dynamicScope);
+			return bound ? {
+				...value,
+				items: bound
+			} : value;
+		});
 		/** Checks if array items have complex structure */
-		const hasComplexArrayItemsComputed = computed(() => hasComplexArrayItems(optimizedValue.value));
+		const hasComplexArrayItemsComputed = computed(() => hasComplexArrayItems(arrayValueWithBoundItems.value));
 		/** Check if enum should be displayed (from value schema or from propertyNames) */
 		const hasEnum = computed(() => enumValues.value.length > 0);
 		/** Determine if object properties should be displayed */
@@ -127,13 +151,18 @@ var SchemaProperty_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 		* properties. The compositions are rendered separately below; leaving them here
 		* would route the nested `Schema` back through `SchemaProperty` and recurse.
 		*
+		* The `discriminator` is stripped too: its variant selector is part of the
+		* composition rendered below (including the one inferred from a bare
+		* `discriminator.mapping`), so keeping it here would make the nested `Schema`
+		* infer and render a second, identical selector.
+		*
 		* When the property already renders the description, we also drop it to avoid
 		* repeating it in the nested object schema card.
 		*/
 		const objectSchemaForChildren = computed(() => {
 			const value = optimizedValue.value;
 			if (!value) return value;
-			const { oneOf: _oneOf, anyOf: _anyOf, allOf: _allOf, not: _not, ...objectSchema } = value;
+			const { oneOf: _oneOf, anyOf: _anyOf, allOf: _allOf, not: _not, discriminator: _discriminator, ...objectSchema } = value;
 			if (displayDescription.value && "description" in objectSchema) {
 				const { description: _description, ...schemaWithoutDescription } = objectSchema;
 				return schemaWithoutDescription;
@@ -145,7 +174,7 @@ var SchemaProperty_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 		/** Computes which compositions should be rendered and with which values */
 		const compositionsToRender = computed(() => getCompositionsToRender(optimizedValue.value, props.options.document));
 		/**
-		* Get resolved array items for rendering.
+		* Get resolved array items for rendering (with any `$dynamicRef` bound to the concrete type).
 		*
 		* When the items are wrapped in a single-item composition (e.g. `items: { allOf: [{ type: 'object', ... }] }`), we
 		* flatten that wrapper into its plain form. A composition with a single member is equivalent to that member, so
@@ -153,7 +182,7 @@ var SchemaProperty_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 		* unnecessary level of nesting and duplicates the item description. See https://github.com/scalar/scalar/issues/5900
 		*/
 		const resolvedArrayItems = computed(() => {
-			const value = optimizedValue.value;
+			const value = arrayValueWithBoundItems.value;
 			if (!value || !isArraySchema(value) || typeof value.items !== "object") return;
 			const items = resolve.schema(value.items);
 			return SINGLE_ITEM_COMPOSITIONS.some((keyword) => Array.isArray(items?.[keyword]) && items[keyword]?.length === 1) ? optimizeValueForDisplay(items) : items;

package/dist/components/Content/Schema/SchemaProperty.vue.script.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaProperty.vue.script.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaProperty.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { ScalarMarkdown } from '@scalar/components/markdown'\nimport { ScalarWrappingText } from '@scalar/components/wrapping-text'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type {\n  DiscriminatorObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, type Component } from 'vue'\n\nimport { WithBreadcrumb } from '@/components/Anchor'\nimport { isTypeObject } from '@/components/Content/Schema/helpers/is-type-object'\nimport { getCycleKey } from '@/components/Content/Schema/helpers/schema-cycle'\nimport type { SchemaOptions } from '@/components/Content/Schema/types'\nimport { SpecificationExtension } from '@/features/specification-extension'\n\nimport { getCompositionsToRender } from './helpers/get-compositions-to-render'\nimport { getEnumValues } from './helpers/get-enum-values'\nimport { getPropertyDescription } from './helpers/get-property-description'\nimport { hasComplexArrayItems } from './helpers/has-complex-array-items'\nimport { optimizeValueForDisplay } from './helpers/optimize-value-for-display'\nimport { shouldDisplayDescription } from './helpers/should-display-description'\nimport { shouldDisplayHeading } from './helpers/should-display-heading'\nimport Schema from './Schema.vue'\nimport SchemaComposition from './SchemaComposition.vue'\nimport SchemaEnums from './SchemaEnums.vue'\nimport SchemaPropertyHeading from './SchemaPropertyHeading.vue'\n\n/**\n * Note: We're taking in a prop called `value` which should be a JSON Schema.\n *\n * We're using `optimizeValueForDisplay` to merge null types in compositions (anyOf, allOf, oneOf, not).\n * So you should basically use the optimizedValue everywhere in the component.\n */\n\n/** Composition keywords that hold a list of schemas and can be flattened when they contain a single member. */\nconst SINGLE_ITEM_COMPOSITIONS = ['oneOf', 'anyOf', 'allOf'] as const\n\nconst props = withDefaults(\n  defineProps<{\n    is?: string | Component\n    schema: SchemaObject | undefined\n    noncollapsible?: boolean\n    level?: number\n    name?: string\n    required?: boolean\n    compact?: boolean\n    discriminator?: DiscriminatorObject\n    description?: string\n    hideModelNames?: boolean\n    hideHeading?: boolean\n    /** When the root schema was resolved from a $ref, pass the ref name for display (e.g. \"Data\"). */\n    modelName?: string | null\n    variant?: 'additionalProperties' | 'patternProperties'\n    breadcrumb?: string[]\n    eventBus: WorkspaceEventBus | null\n    options: SchemaOptions\n    /** Enum values for property names (from JSON Schema propertyNames keyword). */\n    propertyNamesEnum?: string[]\n    /** Resolved propertyNames schema, used to show key constraints like `format`. */\n    propertyNamesSchema?: SchemaObject\n    /** When \"requestBody\", composition selection is synced with the example snippet */\n    schemaContext?: string\n    /** Internal path used to sync nested request body compositions with the code sample */\n    compositionPath?: string[]\n    /** Internal path segment for this property when building nested composition keys */\n    compositionPathSegment?: string\n    /** Stable identity of this property's schema, used for cycle detection. */\n    cycleKey?: unknown\n  }>(),\n  {\n    level: 0,\n    required: false,\n    compact: false,\n    hideModelNames: false,\n  },\n)\n\n/** Simplified composition with `null` type. */\nconst optimizedValue = computed(() => optimizeValueForDisplay(props.schema))\n\nconst childBreadcrumb = computed<string[] | undefined>(() =>\n  props.breadcrumb && props.name\n    ? [...props.breadcrumb, props.name]\n    : undefined,\n)\n\nconst currentCompositionPath = computed<string[]>(() =>\n  props.compositionPathSegment\n    ? [...(props.compositionPath ?? []), props.compositionPathSegment]\n    : (props.compositionPath ?? []),\n)\n\nconst arrayItemsCompositionPath = computed<string[]>(() => [\n  ...currentCompositionPath.value,\n  'items',\n])\n\nconst shouldHaveLink = computed(() => props.level <= 2)\n\n/** Checks if array items have complex structure */\nconst hasComplexArrayItemsComputed = computed(() =>\n  hasComplexArrayItems(optimizedValue.value),\n)\n\n/** Check if enum should be displayed (from value schema or from propertyNames) */\nconst hasEnum = computed(() => enumValues.value.length > 0)\n\n/** Determine if object properties should be displayed */\nconst shouldRenderObjectProperties = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return false\n  }\n\n  if (!('properties' in value || 'additionalProperties' in value)) {\n    return false\n  }\n\n  // `allOf` already merges the factored-out sibling `properties` into its\n  // rendered result (see `mergeAllOfSchemas`), so rendering a separate object\n  // block here would show those properties twice. Let the composition handle it.\n  if ('allOf' in value) {\n    return false\n  }\n\n  // A schema may factor its common `properties` out to the top level alongside\n  // a composition keyword (anyOf/oneOf/not), as described in the JSON Schema\n  // \"factoring schemas\" guide. `isTypeObject` deliberately rejects such schemas\n  // so the composition is rendered, but the factored-out properties must still\n  // show. Unlike `allOf`, these compositions do not merge sibling properties.\n  // Render them unless the schema is an explicit non-object (scalar or array)\n  // type. See https://github.com/scalar/scalar/issues/8593\n  const type = (value as { type?: unknown }).type\n  const isExplicitNonObject = typeof type === 'string' && type !== 'object'\n\n  return isTypeObject(value) || !isExplicitNonObject\n})\n\n/** Determine if array of objects should be rendered */\nconst shouldRenderArrayOfObjects = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return false\n  }\n\n  return hasComplexArrayItemsComputed.value\n})\n\n/** Extract enum values from schema or array items */\nconst enumValues = computed(() => getEnumValues(optimizedValue.value))\n\n/** Generate property description from type/format */\nconst propertyDescription = computed(() =>\n  getPropertyDescription(optimizedValue.value),\n)\n\n/** Determine if description should be displayed */\nconst displayDescription = computed(() =>\n  shouldDisplayDescription(optimizedValue.value, props.description),\n)\n\n/**\n * The schema used to render the object's own properties.\n *\n * Composition keywords are stripped so the nested object renders only its\n * properties. The compositions are rendered separately below; leaving them here\n * would route the nested `Schema` back through `SchemaProperty` and recurse.\n *\n * When the property already renders the description, we also drop it to avoid\n * repeating it in the nested object schema card.\n */\nconst objectSchemaForChildren = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return value\n  }\n\n  const {\n    oneOf: _oneOf,\n    anyOf: _anyOf,\n    allOf: _allOf,\n    not: _not,\n    ...objectSchema\n  } = value as Record<string, unknown>\n\n  if (displayDescription.value && 'description' in objectSchema) {\n    const { description: _description, ...schemaWithoutDescription } =\n      objectSchema\n    return schemaWithoutDescription as SchemaObject\n  }\n\n  return objectSchema as SchemaObject\n})\n\n/** Determine if property heading should be displayed */\nconst shouldDisplayHeadingComputed = computed(() =>\n  shouldDisplayHeading(optimizedValue.value, props.name, props.required),\n)\n\n/** Computes which compositions should be rendered and with which values */\nconst compositionsToRender = computed(() =>\n  getCompositionsToRender(optimizedValue.value, props.options.document),\n)\n\n/**\n * Get resolved array items for rendering.\n *\n * When the items are wrapped in a single-item composition (e.g. `items: { allOf: [{ type: 'object', ... }] }`), we\n * flatten that wrapper into its plain form. A composition with a single member is equivalent to that member, so\n * keeping the composition keyword only makes the items render through an extra schema layer, which adds an\n * unnecessary level of nesting and duplicates the item description. See https://github.com/scalar/scalar/issues/5900\n */\nconst resolvedArrayItems = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return undefined\n  }\n\n  const items = resolve.schema(value.items)\n  const hasSingleItemComposition = SINGLE_ITEM_COMPOSITIONS.some(\n    (keyword) =>\n      Array.isArray(items?.[keyword]) && items[keyword]?.length === 1,\n  )\n\n  return hasSingleItemComposition ? optimizeValueForDisplay(items) : items\n})\n\n/**\n * Cycle key for the array items schema, derived from the raw (unresolved) items\n * so a self-referential array element is detected as a cycle.\n */\nconst arrayItemsCycleKey = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value)) {\n    return undefined\n  }\n  return getCycleKey(value.items)\n})\n\n/** Check if discriminator matches current property */\nconst isDiscriminatorProperty = computed(() =>\n  Boolean(props.name && props.discriminator?.propertyName === props.name),\n)\n</script>\n<template>\n  <component\n    :is=\"is ?? 'li'\"\n    class=\"property\"\n    :class=\"[\n      `property--level-${level}`,\n      {\n        'property--compact': compact,\n        'property--deprecated': optimizedValue?.deprecated,\n      },\n    ]\">\n    <SchemaPropertyHeading\n      v-if=\"shouldDisplayHeadingComputed\"\n      class=\"group\"\n      :enum=\"hasEnum\"\n      :eventBus=\"eventBus\"\n      :hideModelNames\n      :isDiscriminator=\"isDiscriminatorProperty\"\n      :modelName=\"modelName\"\n      :propertyNames=\"propertyNamesSchema\"\n      :required\n      :value=\"optimizedValue\">\n      <template\n        v-if=\"name\"\n        #name>\n        <WithBreadcrumb\n          :breadcrumb=\"shouldHaveLink ? childBreadcrumb : undefined\"\n          :eventBus=\"eventBus\">\n          <span\n            v-if=\"variant === 'patternProperties'\"\n            class=\"property-name-pattern-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <span\n            v-else-if=\"variant === 'additionalProperties'\"\n            class=\"property-name-additional-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <ScalarWrappingText\n            v-else\n            preset=\"property\"\n            :text=\"name\" />\n        </WithBreadcrumb>\n      </template>\n      <template\n        v-if=\"optimizedValue?.example !== undefined\"\n        #example>\n        Example:\n        {{ optimizedValue.example }}\n      </template>\n    </SchemaPropertyHeading>\n\n    <!-- Description -->\n    <div\n      v-if=\"displayDescription || propertyDescription\"\n      class=\"property-description\">\n      <ScalarMarkdown\n        :value=\"displayDescription || propertyDescription || ''\" />\n    </div>\n\n    <!-- Enum for property names -->\n    <SchemaEnums\n      v-if=\"propertyNamesEnum && propertyNamesEnum.length > 0\"\n      propertyNames\n      :value=\"{ enum: propertyNamesEnum } as SchemaObject\" />\n\n    <!-- Enum values -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0\"\n      :value=\"optimizedValue\" />\n\n    <!-- Object -->\n    <div\n      v-if=\"shouldRenderObjectProperties\"\n      class=\"children\">\n      <Schema\n        :breadcrumb=\"childBreadcrumb\"\n        :compact=\"compact\"\n        :compositionPath=\"currentCompositionPath\"\n        :cycleKey=\"cycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"objectSchemaForChildren\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Array of objects or nested arrays -->\n    <div\n      v-if=\"shouldRenderArrayOfObjects && resolvedArrayItems\"\n      class=\"children\">\n      <Schema\n        :compact=\"compact\"\n        :compositionPath=\"arrayItemsCompositionPath\"\n        :cycleKey=\"arrayItemsCycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"resolve.schema(resolvedArrayItems)\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Compositions -->\n    <SchemaComposition\n      v-for=\"compositionData in compositionsToRender\"\n      :key=\"compositionData.composition\"\n      :breadcrumb=\"breadcrumb\"\n      :compact=\"compact\"\n      :composition=\"compositionData.composition\"\n      :compositionPath=\"currentCompositionPath\"\n      :discriminator=\"schema?.discriminator\"\n      :eventBus=\"eventBus\"\n      :hideHeading=\"hideHeading\"\n      :hideModelNames\n      :level=\"level\"\n      :name=\"name\"\n      :noncollapsible=\"noncollapsible\"\n      :options=\"options\"\n      :schema=\"compositionData.value\"\n      :schemaContext=\"schemaContext\" />\n    <SpecificationExtension :value=\"optimizedValue\" />\n  </component>\n</template>\n\n<style scoped>\n.property {\n  color: var(--scalar-color-1);\n  display: flex;\n  flex-direction: column;\n  padding: 10px;\n  font-size: var(--scalar-small);\n  position: relative;\n}\n\n/** Remove top padding for top level schema card */\n.property.property--level-0:has(\n    > .property-rule\n      > .schema-card\n      > .schema-properties.schema-properties-open\n      > ul\n      > li.property\n  ) {\n  padding-top: 0;\n}\n\n.property--compact.property--level-0,\n.property--compact.property--level-1 {\n  padding: 10px 0;\n}\n\n.composition-panel .property.property.property.property--level-0 {\n  padding: 0px;\n}\n\n.property--compact.property--level-0\n  .composition-panel\n  .property--compact.property--level-1 {\n  padding: 8px;\n}\n\n/*  if a property doesn't have a heading, remove the top padding */\n.property:has(> .property-rule:nth-of-type(1)):not(.property--compact) {\n  padding-top: 8px;\n  padding-bottom: 8px;\n}\n\n.property--deprecated {\n  background: repeating-linear-gradient(\n    -45deg,\n    var(--scalar-background-2) 0,\n    var(--scalar-background-2) 2px,\n    transparent 2px,\n    transparent 5px\n  );\n  background-size: 100%;\n}\n\n.property--deprecated > * {\n  opacity: 0.75;\n}\n\n.property-description {\n  margin-top: 6px;\n  line-height: 1.4;\n  font-size: var(--scalar-small);\n}\n\n.property-description:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n:deep(.property-description) * {\n  color: var(--scalar-color-2) !important;\n}\n\n.property:not(:last-of-type) {\n  border-bottom: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-description + .children,\n.children + .property-rule {\n  margin-top: 9px;\n}\n\n.children {\n  display: flex;\n  flex-direction: column;\n}\n\n.children .property--compact.property--level-1 {\n  padding: 12px;\n}\n\n.property-example-value {\n  all: unset;\n  font-family: var(--scalar-font-code);\n  padding: 6px;\n  border-top: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-rule {\n  border-radius: var(--scalar-radius-lg);\n  display: flex;\n  flex-direction: column;\n}\n\n.property--level-2 :deep(.relative > button) {\n  left: -2rem;\n}\n\n.property-rule\n  :deep(\n    .composition-panel\n      .schema-card--level-1\n      > .schema-properties.schema-properties-open\n  ) {\n  border-radius: 0 0 var(--scalar-radius-lg) var(--scalar-radius-lg);\n}\n\n.property-rule\n  :deep(.composition-panel > .schema-card > .schema-card-description) {\n  padding: 10px;\n  border-left: var(--scalar-border-width) solid var(--scalar-border-color);\n  border-right: var(--scalar-border-width) solid var(--scalar-border-color);\n\n  & + .schema-properties {\n    margin-top: 0;\n  }\n}\n\n.property-example {\n  background: transparent;\n  border: none;\n  display: flex;\n  flex-direction: row;\n  gap: 8px;\n}\n\n.property-example-label,\n.property-example-value {\n  padding: 3px 0 0 0;\n}\n\n.property-example-value {\n  background: var(--scalar-background-2);\n  border-top: 0;\n  border-radius: var(--scalar-radius);\n  padding: 3px 4px;\n}\n\n.property-name {\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-semibold);\n}\n\n.property-name-additional-properties::before,\n.property-name-pattern-properties::before {\n  text-transform: uppercase;\n  font-size: var(--scalar-micro);\n  display: inline-block;\n  padding: 2px 4px;\n  border-radius: var(--scalar-radius);\n  color: var(--scalar-color-1);\n  border: var(--scalar-border-width) solid var(--scalar-border-color);\n  background-color: var(--scalar-background-2);\n  margin-right: 4px;\n}\n\n.property-name-pattern-properties::before {\n  content: 'regex';\n}\n\n.property-name-additional-properties,\n.property-name-pattern-properties {\n  border: 1px dashed var(--scalar-border-color);\n  color: var(--scalar-color-accent);\n  display: inline-block;\n  padding: 2px;\n  border-radius: var(--scalar-radius);\n}\n</style>\n"],"mappings":"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"}
+{"version":3,"file":"SchemaProperty.vue.script.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaProperty.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { ScalarMarkdown } from '@scalar/components/markdown'\nimport { ScalarWrappingText } from '@scalar/components/wrapping-text'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport {\n  isDynamicRef,\n  resolveDynamicRef,\n} from '@scalar/workspace-store/helpers/dynamic-ref'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type {\n  DiscriminatorObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, type Component } from 'vue'\n\nimport { WithBreadcrumb } from '@/components/Anchor'\nimport {\n  resolveDynamicSchema,\n  useDynamicScope,\n} from '@/components/Content/Schema/helpers/dynamic-scope'\nimport { isTypeObject } from '@/components/Content/Schema/helpers/is-type-object'\nimport { getCycleKey } from '@/components/Content/Schema/helpers/schema-cycle'\nimport type { SchemaOptions } from '@/components/Content/Schema/types'\nimport { SpecificationExtension } from '@/features/specification-extension'\n\nimport { getCompositionsToRender } from './helpers/get-compositions-to-render'\nimport { getEnumValues } from './helpers/get-enum-values'\nimport { getPropertyDescription } from './helpers/get-property-description'\nimport { hasComplexArrayItems } from './helpers/has-complex-array-items'\nimport { optimizeValueForDisplay } from './helpers/optimize-value-for-display'\nimport { shouldDisplayDescription } from './helpers/should-display-description'\nimport { shouldDisplayHeading } from './helpers/should-display-heading'\nimport Schema from './Schema.vue'\nimport SchemaComposition from './SchemaComposition.vue'\nimport SchemaEnums from './SchemaEnums.vue'\nimport SchemaPropertyHeading from './SchemaPropertyHeading.vue'\n\n/**\n * Note: We're taking in a prop called `value` which should be a JSON Schema.\n *\n * We're using `optimizeValueForDisplay` to merge null types in compositions (anyOf, allOf, oneOf, not).\n * So you should basically use the optimizedValue everywhere in the component.\n */\n\n/** Composition keywords that hold a list of schemas and can be flattened when they contain a single member. */\nconst SINGLE_ITEM_COMPOSITIONS = ['oneOf', 'anyOf', 'allOf'] as const\n\nconst props = withDefaults(\n  defineProps<{\n    is?: string | Component\n    schema: SchemaObject | undefined\n    noncollapsible?: boolean\n    level?: number\n    name?: string\n    required?: boolean\n    compact?: boolean\n    discriminator?: DiscriminatorObject\n    description?: string\n    hideModelNames?: boolean\n    hideHeading?: boolean\n    /** When the root schema was resolved from a $ref, pass the ref name for display (e.g. \"Data\"). */\n    modelName?: string | null\n    variant?: 'additionalProperties' | 'patternProperties'\n    breadcrumb?: string[]\n    eventBus: WorkspaceEventBus | null\n    options: SchemaOptions\n    /** Enum values for property names (from JSON Schema propertyNames keyword). */\n    propertyNamesEnum?: string[]\n    /** Resolved propertyNames schema, used to show key constraints like `format`. */\n    propertyNamesSchema?: SchemaObject\n    /** When \"requestBody\", composition selection is synced with the example snippet */\n    schemaContext?: string\n    /** Internal path used to sync nested request body compositions with the code sample */\n    compositionPath?: string[]\n    /** Internal path segment for this property when building nested composition keys */\n    compositionPathSegment?: string\n    /** Stable identity of this property's schema, used for cycle detection. */\n    cycleKey?: unknown\n  }>(),\n  {\n    level: 0,\n    required: false,\n    compact: false,\n    hideModelNames: false,\n  },\n)\n\n/** The dynamic scope inherited from the enclosing schema resources, used to bind `$dynamicRef`s. */\nconst dynamicScope = useDynamicScope()\n\n/**\n * Simplified composition with `null` type.\n *\n * A top-level `$dynamicRef` (e.g. a linked-list `next` node) is bound to its concrete type via the\n * dynamic scope first; for ordinary schemas this is a no-op.\n */\nconst optimizedValue = computed(() =>\n  optimizeValueForDisplay(resolveDynamicSchema(props.schema, dynamicScope)),\n)\n\nconst childBreadcrumb = computed<string[] | undefined>(() =>\n  props.breadcrumb && props.name\n    ? [...props.breadcrumb, props.name]\n    : undefined,\n)\n\nconst currentCompositionPath = computed<string[]>(() =>\n  props.compositionPathSegment\n    ? [...(props.compositionPath ?? []), props.compositionPathSegment]\n    : (props.compositionPath ?? []),\n)\n\nconst arrayItemsCompositionPath = computed<string[]>(() => [\n  ...currentCompositionPath.value,\n  'items',\n])\n\nconst shouldHaveLink = computed(() => props.level <= 2)\n\n/**\n * The array schema used for item inspection, with a `$dynamicRef` item bound to its concrete type.\n *\n * Returns the schema unchanged unless `items` is a `$dynamicRef` that resolves against the dynamic\n * scope, so ordinary arrays (including `$ref` items) keep their existing behavior exactly.\n */\nconst arrayValueWithBoundItems = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || !isDynamicRef(value.items)) {\n    return value\n  }\n\n  const bound = resolveDynamicRef(value.items.$dynamicRef, dynamicScope)\n  return bound ? ({ ...value, items: bound } as SchemaObject) : value\n})\n\n/** Checks if array items have complex structure */\nconst hasComplexArrayItemsComputed = computed(() =>\n  hasComplexArrayItems(arrayValueWithBoundItems.value),\n)\n\n/** Check if enum should be displayed (from value schema or from propertyNames) */\nconst hasEnum = computed(() => enumValues.value.length > 0)\n\n/** Determine if object properties should be displayed */\nconst shouldRenderObjectProperties = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return false\n  }\n\n  if (!('properties' in value || 'additionalProperties' in value)) {\n    return false\n  }\n\n  // `allOf` already merges the factored-out sibling `properties` into its\n  // rendered result (see `mergeAllOfSchemas`), so rendering a separate object\n  // block here would show those properties twice. Let the composition handle it.\n  if ('allOf' in value) {\n    return false\n  }\n\n  // A schema may factor its common `properties` out to the top level alongside\n  // a composition keyword (anyOf/oneOf/not), as described in the JSON Schema\n  // \"factoring schemas\" guide. `isTypeObject` deliberately rejects such schemas\n  // so the composition is rendered, but the factored-out properties must still\n  // show. Unlike `allOf`, these compositions do not merge sibling properties.\n  // Render them unless the schema is an explicit non-object (scalar or array)\n  // type. See https://github.com/scalar/scalar/issues/8593\n  const type = (value as { type?: unknown }).type\n  const isExplicitNonObject = typeof type === 'string' && type !== 'object'\n\n  return isTypeObject(value) || !isExplicitNonObject\n})\n\n/** Determine if array of objects should be rendered */\nconst shouldRenderArrayOfObjects = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return false\n  }\n\n  return hasComplexArrayItemsComputed.value\n})\n\n/** Extract enum values from schema or array items */\nconst enumValues = computed(() => getEnumValues(optimizedValue.value))\n\n/** Generate property description from type/format */\nconst propertyDescription = computed(() =>\n  getPropertyDescription(optimizedValue.value),\n)\n\n/** Determine if description should be displayed */\nconst displayDescription = computed(() =>\n  shouldDisplayDescription(optimizedValue.value, props.description),\n)\n\n/**\n * The schema used to render the object's own properties.\n *\n * Composition keywords are stripped so the nested object renders only its\n * properties. The compositions are rendered separately below; leaving them here\n * would route the nested `Schema` back through `SchemaProperty` and recurse.\n *\n * The `discriminator` is stripped too: its variant selector is part of the\n * composition rendered below (including the one inferred from a bare\n * `discriminator.mapping`), so keeping it here would make the nested `Schema`\n * infer and render a second, identical selector.\n *\n * When the property already renders the description, we also drop it to avoid\n * repeating it in the nested object schema card.\n */\nconst objectSchemaForChildren = computed(() => {\n  const value = optimizedValue.value\n  if (!value) {\n    return value\n  }\n\n  const {\n    oneOf: _oneOf,\n    anyOf: _anyOf,\n    allOf: _allOf,\n    not: _not,\n    discriminator: _discriminator,\n    ...objectSchema\n  } = value as Record<string, unknown>\n\n  if (displayDescription.value && 'description' in objectSchema) {\n    const { description: _description, ...schemaWithoutDescription } =\n      objectSchema\n    return schemaWithoutDescription as SchemaObject\n  }\n\n  return objectSchema as SchemaObject\n})\n\n/** Determine if property heading should be displayed */\nconst shouldDisplayHeadingComputed = computed(() =>\n  shouldDisplayHeading(optimizedValue.value, props.name, props.required),\n)\n\n/** Computes which compositions should be rendered and with which values */\nconst compositionsToRender = computed(() =>\n  getCompositionsToRender(optimizedValue.value, props.options.document),\n)\n\n/**\n * Get resolved array items for rendering (with any `$dynamicRef` bound to the concrete type).\n *\n * When the items are wrapped in a single-item composition (e.g. `items: { allOf: [{ type: 'object', ... }] }`), we\n * flatten that wrapper into its plain form. A composition with a single member is equivalent to that member, so\n * keeping the composition keyword only makes the items render through an extra schema layer, which adds an\n * unnecessary level of nesting and duplicates the item description. See https://github.com/scalar/scalar/issues/5900\n */\nconst resolvedArrayItems = computed(() => {\n  const value = arrayValueWithBoundItems.value\n  if (!value || !isArraySchema(value) || typeof value.items !== 'object') {\n    return undefined\n  }\n\n  const items = resolve.schema(value.items)\n  const hasSingleItemComposition = SINGLE_ITEM_COMPOSITIONS.some(\n    (keyword) =>\n      Array.isArray(items?.[keyword]) && items[keyword]?.length === 1,\n  )\n\n  return hasSingleItemComposition ? optimizeValueForDisplay(items) : items\n})\n\n/**\n * Cycle key for the array items schema, derived from the raw (unresolved) items\n * so a self-referential array element is detected as a cycle.\n */\nconst arrayItemsCycleKey = computed(() => {\n  const value = optimizedValue.value\n  if (!value || !isArraySchema(value)) {\n    return undefined\n  }\n  return getCycleKey(value.items)\n})\n\n/** Check if discriminator matches current property */\nconst isDiscriminatorProperty = computed(() =>\n  Boolean(props.name && props.discriminator?.propertyName === props.name),\n)\n</script>\n<template>\n  <component\n    :is=\"is ?? 'li'\"\n    class=\"property\"\n    :class=\"[\n      `property--level-${level}`,\n      {\n        'property--compact': compact,\n        'property--deprecated': optimizedValue?.deprecated,\n      },\n    ]\">\n    <SchemaPropertyHeading\n      v-if=\"shouldDisplayHeadingComputed\"\n      class=\"group\"\n      :enum=\"hasEnum\"\n      :eventBus=\"eventBus\"\n      :hideModelNames\n      :isDiscriminator=\"isDiscriminatorProperty\"\n      :modelName=\"modelName\"\n      :propertyNames=\"propertyNamesSchema\"\n      :required\n      :value=\"optimizedValue\">\n      <template\n        v-if=\"name\"\n        #name>\n        <WithBreadcrumb\n          :breadcrumb=\"shouldHaveLink ? childBreadcrumb : undefined\"\n          :eventBus=\"eventBus\">\n          <span\n            v-if=\"variant === 'patternProperties'\"\n            class=\"property-name-pattern-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <span\n            v-else-if=\"variant === 'additionalProperties'\"\n            class=\"property-name-additional-properties\">\n            <ScalarWrappingText\n              preset=\"property\"\n              :text=\"name\" />\n          </span>\n          <ScalarWrappingText\n            v-else\n            preset=\"property\"\n            :text=\"name\" />\n        </WithBreadcrumb>\n      </template>\n      <template\n        v-if=\"optimizedValue?.example !== undefined\"\n        #example>\n        Example:\n        {{ optimizedValue.example }}\n      </template>\n    </SchemaPropertyHeading>\n\n    <!-- Description -->\n    <div\n      v-if=\"displayDescription || propertyDescription\"\n      class=\"property-description\">\n      <ScalarMarkdown\n        :value=\"displayDescription || propertyDescription || ''\" />\n    </div>\n\n    <!-- Enum for property names -->\n    <SchemaEnums\n      v-if=\"propertyNamesEnum && propertyNamesEnum.length > 0\"\n      propertyNames\n      :value=\"{ enum: propertyNamesEnum } as SchemaObject\" />\n\n    <!-- Enum values -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0\"\n      :value=\"optimizedValue\" />\n\n    <!-- Object -->\n    <div\n      v-if=\"shouldRenderObjectProperties\"\n      class=\"children\">\n      <Schema\n        :breadcrumb=\"childBreadcrumb\"\n        :compact=\"compact\"\n        :compositionPath=\"currentCompositionPath\"\n        :cycleKey=\"cycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"objectSchemaForChildren\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Array of objects or nested arrays -->\n    <div\n      v-if=\"shouldRenderArrayOfObjects && resolvedArrayItems\"\n      class=\"children\">\n      <Schema\n        :compact=\"compact\"\n        :compositionPath=\"arrayItemsCompositionPath\"\n        :cycleKey=\"arrayItemsCycleKey\"\n        :eventBus=\"eventBus\"\n        :hideModelNames\n        :level=\"level + 1\"\n        :name=\"name\"\n        :noncollapsible=\"noncollapsible\"\n        :options=\"options\"\n        :schema=\"resolve.schema(resolvedArrayItems)\"\n        :schemaContext=\"schemaContext\" />\n    </div>\n\n    <!-- Compositions -->\n    <SchemaComposition\n      v-for=\"compositionData in compositionsToRender\"\n      :key=\"compositionData.composition\"\n      :breadcrumb=\"breadcrumb\"\n      :compact=\"compact\"\n      :composition=\"compositionData.composition\"\n      :compositionPath=\"currentCompositionPath\"\n      :discriminator=\"schema?.discriminator\"\n      :eventBus=\"eventBus\"\n      :hideHeading=\"hideHeading\"\n      :hideModelNames\n      :level=\"level\"\n      :name=\"name\"\n      :noncollapsible=\"noncollapsible\"\n      :options=\"options\"\n      :schema=\"compositionData.value\"\n      :schemaContext=\"schemaContext\" />\n    <SpecificationExtension :value=\"optimizedValue\" />\n  </component>\n</template>\n\n<style scoped>\n.property {\n  color: var(--scalar-color-1);\n  display: flex;\n  flex-direction: column;\n  padding: 10px;\n  font-size: var(--scalar-small);\n  position: relative;\n}\n\n/** Remove top padding for top level schema card */\n.property.property--level-0:has(\n    > .property-rule\n      > .schema-card\n      > .schema-properties.schema-properties-open\n      > ul\n      > li.property\n  ) {\n  padding-top: 0;\n}\n\n.property--compact.property--level-0,\n.property--compact.property--level-1 {\n  padding: 10px 0;\n}\n\n.composition-panel .property.property.property.property--level-0 {\n  padding: 0px;\n}\n\n.property--compact.property--level-0\n  .composition-panel\n  .property--compact.property--level-1 {\n  padding: 8px;\n}\n\n/*  if a property doesn't have a heading, remove the top padding */\n.property:has(> .property-rule:nth-of-type(1)):not(.property--compact) {\n  padding-top: 8px;\n  padding-bottom: 8px;\n}\n\n.property--deprecated {\n  background: repeating-linear-gradient(\n    -45deg,\n    var(--scalar-background-2) 0,\n    var(--scalar-background-2) 2px,\n    transparent 2px,\n    transparent 5px\n  );\n  background-size: 100%;\n}\n\n.property--deprecated > * {\n  opacity: 0.75;\n}\n\n.property-description {\n  margin-top: 6px;\n  line-height: 1.4;\n  font-size: var(--scalar-small);\n}\n\n.property-description:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n:deep(.property-description) * {\n  color: var(--scalar-color-2) !important;\n}\n\n.property:not(:last-of-type) {\n  border-bottom: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-description + .children,\n.children + .property-rule {\n  margin-top: 9px;\n}\n\n.children {\n  display: flex;\n  flex-direction: column;\n}\n\n.children .property--compact.property--level-1 {\n  padding: 12px;\n}\n\n.property-example-value {\n  all: unset;\n  font-family: var(--scalar-font-code);\n  padding: 6px;\n  border-top: var(--scalar-border-width) solid var(--scalar-border-color);\n}\n\n.property-rule {\n  border-radius: var(--scalar-radius-lg);\n  display: flex;\n  flex-direction: column;\n}\n\n.property--level-2 :deep(.relative > button) {\n  left: -2rem;\n}\n\n.property-rule\n  :deep(\n    .composition-panel\n      .schema-card--level-1\n      > .schema-properties.schema-properties-open\n  ) {\n  border-radius: 0 0 var(--scalar-radius-lg) var(--scalar-radius-lg);\n}\n\n.property-rule\n  :deep(.composition-panel > .schema-card > .schema-card-description) {\n  padding: 10px;\n  border-left: var(--scalar-border-width) solid var(--scalar-border-color);\n  border-right: var(--scalar-border-width) solid var(--scalar-border-color);\n\n  & + .schema-properties {\n    margin-top: 0;\n  }\n}\n\n.property-example {\n  background: transparent;\n  border: none;\n  display: flex;\n  flex-direction: row;\n  gap: 8px;\n}\n\n.property-example-label,\n.property-example-value {\n  padding: 3px 0 0 0;\n}\n\n.property-example-value {\n  background: var(--scalar-background-2);\n  border-top: 0;\n  border-radius: var(--scalar-radius);\n  padding: 3px 4px;\n}\n\n.property-name {\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-semibold);\n}\n\n.property-name-additional-properties::before,\n.property-name-pattern-properties::before {\n  text-transform: uppercase;\n  font-size: var(--scalar-micro);\n  display: inline-block;\n  padding: 2px 4px;\n  border-radius: var(--scalar-radius);\n  color: var(--scalar-color-1);\n  border: var(--scalar-border-width) solid var(--scalar-border-color);\n  background-color: var(--scalar-background-2);\n  margin-right: 4px;\n}\n\n.property-name-pattern-properties::before {\n  content: 'regex';\n}\n\n.property-name-additional-properties,\n.property-name-pattern-properties {\n  border: 1px dashed var(--scalar-border-color);\n  color: var(--scalar-color-accent);\n  display: inline-block;\n  padding: 2px;\n  border-radius: var(--scalar-radius);\n}\n</style>\n"],"mappings":"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"}

package/dist/components/Content/Schema/SchemaPropertyHeading.vue.script.js

@@ -10,8 +10,8 @@ import SchemaPropertyDetail_default from "./SchemaPropertyDetail.vue.js";
 import SchemaPropertyExamples_default from "./SchemaPropertyExamples.vue.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createSlots, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, renderList, renderSlot, toDisplayString, toRef, unref, withCtx } from "vue";
 import { resolve } from "@scalar/workspace-store/resolve";
-import { isArraySchema, isNumberSchema, isStringSchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
 import { isDefined } from "@scalar/helpers/array/is-defined";
+import { isArraySchema, isNumberSchema, isStringSchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
 //#region src/components/Content/Schema/SchemaPropertyHeading.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { class: "property-heading" };
 var _hoisted_2 = {

package/dist/components/Content/Schema/helpers/dynamic-scope.d.ts

@@ -0,0 +1,27 @@
+import { type DynamicScope } from '@scalar/workspace-store/helpers/dynamic-ref';
+import type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import { type InjectionKey } from 'vue';
+/**
+ * The dynamic scope — the outermost-first chain of schema resources on the current render path.
+ *
+ * JSON Schema 2020-12 `$dynamicRef` does not resolve to a fixed location. It binds to the active
+ * `$dynamicAnchor` in the chain of resources entered to reach it, so the same
+ * `{ "$dynamicRef": "#itemType" }` inside a shared generic template resolves to a different concrete
+ * type depending on the path taken (e.g. `User` via a user page, `Group` via a group page).
+ *
+ * Each object `Schema` node injects this scope, appends its own resource, and re-provides it to its
+ * descendants. `SchemaProperty` reads it to bind a `$dynamicRef` property or array item to the
+ * concrete schema while walking the tree. See https://github.com/scalar/scalar/issues/9414.
+ */
+export declare const SCHEMA_DYNAMIC_SCOPE_SYMBOL: InjectionKey<DynamicScope>;
+/** Read the dynamic scope provided by ancestor schema nodes (empty at the root of the tree). */
+export declare const useDynamicScope: () => DynamicScope;
+/**
+ * Resolve a schema that may be a `$dynamicRef` against the active dynamic scope.
+ *
+ * Returns the bound concrete schema when the reference matches a `$dynamicAnchor` in scope. When
+ * nothing matches (or the schema is not a `$dynamicRef`) the input is returned unchanged, so
+ * rendering falls back to its prior behavior with no regression.
+ */
+export declare const resolveDynamicSchema: <T extends SchemaObject | undefined>(schema: T, scope: DynamicScope) => T;
+//# sourceMappingURL=dynamic-scope.d.ts.map

package/dist/components/Content/Schema/helpers/dynamic-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-scope.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/dynamic-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAmC,MAAM,6CAA6C,CAAA;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAChG,OAAO,EAAE,KAAK,YAAY,EAAU,MAAM,KAAK,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,EAAE,YAAY,CAAC,YAAY,CAAkC,CAAA;AAKrG,gGAAgG;AAChG,eAAO,MAAM,eAAe,QAAO,YAAgE,CAAA;AAEnG;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,YAAY,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,YAAY,KAAG,CAMzG,CAAA"}

package/dist/components/Content/Schema/helpers/dynamic-scope.js

@@ -0,0 +1,35 @@
+import { inject } from "vue";
+import { isDynamicRef, resolveDynamicRef } from "@scalar/workspace-store/helpers/dynamic-ref";
+//#region src/components/Content/Schema/helpers/dynamic-scope.ts
+/**
+* The dynamic scope — the outermost-first chain of schema resources on the current render path.
+*
+* JSON Schema 2020-12 `$dynamicRef` does not resolve to a fixed location. It binds to the active
+* `$dynamicAnchor` in the chain of resources entered to reach it, so the same
+* `{ "$dynamicRef": "#itemType" }` inside a shared generic template resolves to a different concrete
+* type depending on the path taken (e.g. `User` via a user page, `Group` via a group page).
+*
+* Each object `Schema` node injects this scope, appends its own resource, and re-provides it to its
+* descendants. `SchemaProperty` reads it to bind a `$dynamicRef` property or array item to the
+* concrete schema while walking the tree. See https://github.com/scalar/scalar/issues/9414.
+*/
+var SCHEMA_DYNAMIC_SCOPE_SYMBOL = Symbol("schema-dynamic-scope");
+/** Shared empty scope used as the inject default at the root, where nothing has been entered yet. */
+var EMPTY_SCOPE = [];
+/** Read the dynamic scope provided by ancestor schema nodes (empty at the root of the tree). */
+var useDynamicScope = () => inject(SCHEMA_DYNAMIC_SCOPE_SYMBOL, EMPTY_SCOPE);
+/**
+* Resolve a schema that may be a `$dynamicRef` against the active dynamic scope.
+*
+* Returns the bound concrete schema when the reference matches a `$dynamicAnchor` in scope. When
+* nothing matches (or the schema is not a `$dynamicRef`) the input is returned unchanged, so
+* rendering falls back to its prior behavior with no regression.
+*/
+var resolveDynamicSchema = (schema, scope) => {
+	if (isDynamicRef(schema)) return resolveDynamicRef(schema.$dynamicRef, scope) ?? schema;
+	return schema;
+};
+//#endregion
+export { SCHEMA_DYNAMIC_SCOPE_SYMBOL, resolveDynamicSchema, useDynamicScope };
+
+//# sourceMappingURL=dynamic-scope.js.map

package/dist/components/Content/Schema/helpers/dynamic-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-scope.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/dynamic-scope.ts"],"sourcesContent":["import { type DynamicScope, isDynamicRef, resolveDynamicRef } from '@scalar/workspace-store/helpers/dynamic-ref'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { type InjectionKey, inject } from 'vue'\n\n/**\n * The dynamic scope — the outermost-first chain of schema resources on the current render path.\n *\n * JSON Schema 2020-12 `$dynamicRef` does not resolve to a fixed location. It binds to the active\n * `$dynamicAnchor` in the chain of resources entered to reach it, so the same\n * `{ \"$dynamicRef\": \"#itemType\" }` inside a shared generic template resolves to a different concrete\n * type depending on the path taken (e.g. `User` via a user page, `Group` via a group page).\n *\n * Each object `Schema` node injects this scope, appends its own resource, and re-provides it to its\n * descendants. `SchemaProperty` reads it to bind a `$dynamicRef` property or array item to the\n * concrete schema while walking the tree. See https://github.com/scalar/scalar/issues/9414.\n */\nexport const SCHEMA_DYNAMIC_SCOPE_SYMBOL: InjectionKey<DynamicScope> = Symbol('schema-dynamic-scope')\n\n/** Shared empty scope used as the inject default at the root, where nothing has been entered yet. */\nconst EMPTY_SCOPE: DynamicScope = []\n\n/** Read the dynamic scope provided by ancestor schema nodes (empty at the root of the tree). */\nexport const useDynamicScope = (): DynamicScope => inject(SCHEMA_DYNAMIC_SCOPE_SYMBOL, EMPTY_SCOPE)\n\n/**\n * Resolve a schema that may be a `$dynamicRef` against the active dynamic scope.\n *\n * Returns the bound concrete schema when the reference matches a `$dynamicAnchor` in scope. When\n * nothing matches (or the schema is not a `$dynamicRef`) the input is returned unchanged, so\n * rendering falls back to its prior behavior with no regression.\n */\nexport const resolveDynamicSchema = <T extends SchemaObject | undefined>(schema: T, scope: DynamicScope): T => {\n  if (isDynamicRef(schema)) {\n    return (resolveDynamicRef(schema.$dynamicRef, scope) as T) ?? schema\n  }\n\n  return schema\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,IAAa,8BAA0D,OAAO,uBAAuB;;AAGrG,IAAM,cAA4B,EAAE;;AAGpC,IAAa,wBAAsC,OAAO,6BAA6B,YAAY;;;;;;;;AASnG,IAAa,wBAA4D,QAAW,UAA2B;AAC7G,KAAI,aAAa,OAAO,CACtB,QAAQ,kBAAkB,OAAO,aAAa,MAAM,IAAU;AAGhE,QAAO"}

package/dist/components/Content/Schema/helpers/get-compositions-to-render.d.ts

@@ -5,6 +5,16 @@ type CompositionToRender = {
     value: SchemaObject;
 };
 type DocumentSchemaLookup = Pick<OpenApiDocument, 'components'>;
+/**
+ * Builds a synthetic `oneOf` composition from a `discriminator.mapping` when the
+ * schema declares a mapping but no explicit `oneOf`/`anyOf`. This is the shape
+ * NSwag emits for polymorphic types, where the base type is a plain object with
+ * a discriminator mapping pointing at the concrete variants.
+ *
+ * Returns `null` when there is nothing to infer (an explicit composition is
+ * already present, no document to resolve refs against, or no resolvable refs).
+ */
+export declare const inferDiscriminatorMappingComposition: (value: SchemaObject, document?: DocumentSchemaLookup) => SchemaObject | null;
 /**
  * Computes which compositions should be rendered and with which values
  *

package/dist/components/Content/Schema/helpers/get-compositions-to-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-compositions-to-render.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/get-compositions-to-render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAIjH,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,sBAAsB,CAAA;AAG5E,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,KAAK,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,KAAK,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;AAyC/D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,YAAY,GAAG,SAAS,EAC/B,WAAW,oBAAoB,KAC9B,mBAAmB,EAyCrB,CAAA"}
+{"version":3,"file":"get-compositions-to-render.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/get-compositions-to-render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAIjH,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,sBAAsB,CAAA;AAG5E,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,KAAK,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,KAAK,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;AAK/D;;;;;;;;GAQG;AACH,eAAO,MAAM,oCAAoC,GAC/C,OAAO,YAAY,EACnB,WAAW,oBAAoB,KAC9B,YAAY,GAAG,IA+BjB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,YAAY,GAAG,SAAS,EAC/B,WAAW,oBAAoB,KAC9B,mBAAmB,EAyCrB,CAAA"}

package/dist/components/Content/Schema/helpers/get-compositions-to-render.js

@@ -2,10 +2,19 @@ import { getRefName } from "./get-ref-name.js";
 import { compositions } from "./schema-composition.js";
 import { shouldRenderArrayItemComposition } from "./should-render-array-item-composition.js";
 import { resolve } from "@scalar/workspace-store/resolve";
-import { isArraySchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
 import { isDefined } from "@scalar/helpers/array/is-defined";
+import { isArraySchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
 //#region src/components/Content/Schema/helpers/get-compositions-to-render.ts
 var normalizeDiscriminatorMappingRef = (value) => value.startsWith("#/") || value.includes("/") ? value : `#/components/schemas/${value}`;
+/**
+* Builds a synthetic `oneOf` composition from a `discriminator.mapping` when the
+* schema declares a mapping but no explicit `oneOf`/`anyOf`. This is the shape
+* NSwag emits for polymorphic types, where the base type is a plain object with
+* a discriminator mapping pointing at the concrete variants.
+*
+* Returns `null` when there is nothing to infer (an explicit composition is
+* already present, no document to resolve refs against, or no resolvable refs).
+*/
 var inferDiscriminatorMappingComposition = (value, document) => {
 	if (value.oneOf || value.anyOf || !document?.components?.schemas) return null;
 	const refs = Object.values(value.discriminator?.mapping ?? {}).filter((mappingValue) => typeof mappingValue === "string").map((mappingValue) => {
@@ -52,6 +61,6 @@ var getCompositionsToRender = (value, document) => {
 	}).filter(isDefined);
 };
 //#endregion
-export { getCompositionsToRender };
+export { getCompositionsToRender, inferDiscriminatorMappingComposition };
 
 //# sourceMappingURL=get-compositions-to-render.js.map

package/dist/components/Content/Schema/helpers/get-compositions-to-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-compositions-to-render.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/get-compositions-to-render.ts"],"sourcesContent":["import { isDefined } from '@scalar/helpers/array/is-defined'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { OpenApiDocument, SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\nimport { getRefName } from './get-ref-name'\nimport { type CompositionKeyword, compositions } from './schema-composition'\nimport { shouldRenderArrayItemComposition } from './should-render-array-item-composition'\n\ntype CompositionToRender = {\n  composition: CompositionKeyword\n  value: SchemaObject\n}\n\ntype DocumentSchemaLookup = Pick<OpenApiDocument, 'components'>\n\nconst normalizeDiscriminatorMappingRef = (value: string) =>\n  value.startsWith('#/') || value.includes('/') ? value : `#/components/schemas/${value}`\n\nconst inferDiscriminatorMappingComposition = (\n  value: SchemaObject,\n  document?: DocumentSchemaLookup,\n): SchemaObject | null => {\n  if (value.oneOf || value.anyOf || !document?.components?.schemas) {\n    return null\n  }\n\n  const refs = Object.values(value.discriminator?.mapping ?? {})\n    .filter((mappingValue): mappingValue is string => typeof mappingValue === 'string')\n    .map((mappingValue) => {\n      const ref = normalizeDiscriminatorMappingRef(mappingValue)\n      const refName = getRefName(ref)\n      const refValue = refName ? resolve.schema(document.components?.schemas?.[refName]) : undefined\n\n      if (!refValue) {\n        return undefined\n      }\n\n      return {\n        $ref: ref,\n        '$ref-value': refValue,\n      }\n    })\n    .filter(isDefined)\n\n  if (refs.length === 0) {\n    return null\n  }\n\n  return {\n    ...resolve.schema(value),\n    oneOf: refs as NonNullable<SchemaObject['oneOf']>,\n  }\n}\n\n/**\n * Computes which compositions should be rendered and with which values\n *\n * @param value - The schema object to check for compositions\n * @returns Array of compositions to render with their values\n */\nexport const getCompositionsToRender = (\n  value: SchemaObject | undefined,\n  document?: DocumentSchemaLookup,\n): CompositionToRender[] => {\n  if (!value) {\n    return []\n  }\n\n  const inferredDiscriminatorComposition = inferDiscriminatorMappingComposition(value, document)\n\n  return compositions\n    .map((composition) => {\n      if (composition === 'oneOf' && inferredDiscriminatorComposition) {\n        return {\n          composition,\n          value: inferredDiscriminatorComposition,\n        }\n      }\n\n      // Check for array item-level composition first (more specific case)\n      if (shouldRenderArrayItemComposition(value, composition) && isArraySchema(value) && value.items) {\n        return {\n          composition,\n          value: resolve.schema(value.items),\n        }\n      }\n\n      // Check for property-level composition\n      if (value[composition]) {\n        // Skip if array items have this composition (even if complex/not rendered)\n        const hasArrayItemComposition =\n          isArraySchema(value) && value.items && typeof value.items === 'object' && composition in value.items\n\n        if (!hasArrayItemComposition) {\n          return {\n            composition,\n            value: resolve.schema(value),\n          }\n        }\n      }\n\n      return null\n    })\n    .filter(isDefined)\n}\n"],"mappings":";;;;;;;AAgBA,IAAM,oCAAoC,UACxC,MAAM,WAAW,KAAK,IAAI,MAAM,SAAS,IAAI,GAAG,QAAQ,wBAAwB;AAElF,IAAM,wCACJ,OACA,aACwB;AACxB,KAAI,MAAM,SAAS,MAAM,SAAS,CAAC,UAAU,YAAY,QACvD,QAAO;CAGT,MAAM,OAAO,OAAO,OAAO,MAAM,eAAe,WAAW,EAAE,CAAC,CAC3D,QAAQ,iBAAyC,OAAO,iBAAiB,SAAS,CAClF,KAAK,iBAAiB;EACrB,MAAM,MAAM,iCAAiC,aAAa;EAC1D,MAAM,UAAU,WAAW,IAAI;EAC/B,MAAM,WAAW,UAAU,QAAQ,OAAO,SAAS,YAAY,UAAU,SAAS,GAAG,KAAA;AAErF,MAAI,CAAC,SACH;AAGF,SAAO;GACL,MAAM;GACN,cAAc;GACf;GACD,CACD,OAAO,UAAU;AAEpB,KAAI,KAAK,WAAW,EAClB,QAAO;AAGT,QAAO;EACL,GAAG,QAAQ,OAAO,MAAM;EACxB,OAAO;EACR;;;;;;;;AASH,IAAa,2BACX,OACA,aAC0B;AAC1B,KAAI,CAAC,MACH,QAAO,EAAE;CAGX,MAAM,mCAAmC,qCAAqC,OAAO,SAAS;AAE9F,QAAO,aACJ,KAAK,gBAAgB;AACpB,MAAI,gBAAgB,WAAW,iCAC7B,QAAO;GACL;GACA,OAAO;GACR;AAIH,MAAI,iCAAiC,OAAO,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MACxF,QAAO;GACL;GACA,OAAO,QAAQ,OAAO,MAAM,MAAM;GACnC;AAIH,MAAI,MAAM;OAKJ,EAFF,cAAc,MAAM,IAAI,MAAM,SAAS,OAAO,MAAM,UAAU,YAAY,eAAe,MAAM,OAG/F,QAAO;IACL;IACA,OAAO,QAAQ,OAAO,MAAM;IAC7B;;AAIL,SAAO;GACP,CACD,OAAO,UAAU"}
+{"version":3,"file":"get-compositions-to-render.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/get-compositions-to-render.ts"],"sourcesContent":["import { isDefined } from '@scalar/helpers/array/is-defined'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { OpenApiDocument, SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isArraySchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\nimport { getRefName } from './get-ref-name'\nimport { type CompositionKeyword, compositions } from './schema-composition'\nimport { shouldRenderArrayItemComposition } from './should-render-array-item-composition'\n\ntype CompositionToRender = {\n  composition: CompositionKeyword\n  value: SchemaObject\n}\n\ntype DocumentSchemaLookup = Pick<OpenApiDocument, 'components'>\n\nconst normalizeDiscriminatorMappingRef = (value: string) =>\n  value.startsWith('#/') || value.includes('/') ? value : `#/components/schemas/${value}`\n\n/**\n * Builds a synthetic `oneOf` composition from a `discriminator.mapping` when the\n * schema declares a mapping but no explicit `oneOf`/`anyOf`. This is the shape\n * NSwag emits for polymorphic types, where the base type is a plain object with\n * a discriminator mapping pointing at the concrete variants.\n *\n * Returns `null` when there is nothing to infer (an explicit composition is\n * already present, no document to resolve refs against, or no resolvable refs).\n */\nexport const inferDiscriminatorMappingComposition = (\n  value: SchemaObject,\n  document?: DocumentSchemaLookup,\n): SchemaObject | null => {\n  if (value.oneOf || value.anyOf || !document?.components?.schemas) {\n    return null\n  }\n\n  const refs = Object.values(value.discriminator?.mapping ?? {})\n    .filter((mappingValue): mappingValue is string => typeof mappingValue === 'string')\n    .map((mappingValue) => {\n      const ref = normalizeDiscriminatorMappingRef(mappingValue)\n      const refName = getRefName(ref)\n      const refValue = refName ? resolve.schema(document.components?.schemas?.[refName]) : undefined\n\n      if (!refValue) {\n        return undefined\n      }\n\n      return {\n        $ref: ref,\n        '$ref-value': refValue,\n      }\n    })\n    .filter(isDefined)\n\n  if (refs.length === 0) {\n    return null\n  }\n\n  return {\n    ...resolve.schema(value),\n    oneOf: refs as NonNullable<SchemaObject['oneOf']>,\n  }\n}\n\n/**\n * Computes which compositions should be rendered and with which values\n *\n * @param value - The schema object to check for compositions\n * @returns Array of compositions to render with their values\n */\nexport const getCompositionsToRender = (\n  value: SchemaObject | undefined,\n  document?: DocumentSchemaLookup,\n): CompositionToRender[] => {\n  if (!value) {\n    return []\n  }\n\n  const inferredDiscriminatorComposition = inferDiscriminatorMappingComposition(value, document)\n\n  return compositions\n    .map((composition) => {\n      if (composition === 'oneOf' && inferredDiscriminatorComposition) {\n        return {\n          composition,\n          value: inferredDiscriminatorComposition,\n        }\n      }\n\n      // Check for array item-level composition first (more specific case)\n      if (shouldRenderArrayItemComposition(value, composition) && isArraySchema(value) && value.items) {\n        return {\n          composition,\n          value: resolve.schema(value.items),\n        }\n      }\n\n      // Check for property-level composition\n      if (value[composition]) {\n        // Skip if array items have this composition (even if complex/not rendered)\n        const hasArrayItemComposition =\n          isArraySchema(value) && value.items && typeof value.items === 'object' && composition in value.items\n\n        if (!hasArrayItemComposition) {\n          return {\n            composition,\n            value: resolve.schema(value),\n          }\n        }\n      }\n\n      return null\n    })\n    .filter(isDefined)\n}\n"],"mappings":";;;;;;;AAgBA,IAAM,oCAAoC,UACxC,MAAM,WAAW,KAAK,IAAI,MAAM,SAAS,IAAI,GAAG,QAAQ,wBAAwB;;;;;;;;;;AAWlF,IAAa,wCACX,OACA,aACwB;AACxB,KAAI,MAAM,SAAS,MAAM,SAAS,CAAC,UAAU,YAAY,QACvD,QAAO;CAGT,MAAM,OAAO,OAAO,OAAO,MAAM,eAAe,WAAW,EAAE,CAAC,CAC3D,QAAQ,iBAAyC,OAAO,iBAAiB,SAAS,CAClF,KAAK,iBAAiB;EACrB,MAAM,MAAM,iCAAiC,aAAa;EAC1D,MAAM,UAAU,WAAW,IAAI;EAC/B,MAAM,WAAW,UAAU,QAAQ,OAAO,SAAS,YAAY,UAAU,SAAS,GAAG,KAAA;AAErF,MAAI,CAAC,SACH;AAGF,SAAO;GACL,MAAM;GACN,cAAc;GACf;GACD,CACD,OAAO,UAAU;AAEpB,KAAI,KAAK,WAAW,EAClB,QAAO;AAGT,QAAO;EACL,GAAG,QAAQ,OAAO,MAAM;EACxB,OAAO;EACR;;;;;;;;AASH,IAAa,2BACX,OACA,aAC0B;AAC1B,KAAI,CAAC,MACH,QAAO,EAAE;CAGX,MAAM,mCAAmC,qCAAqC,OAAO,SAAS;AAE9F,QAAO,aACJ,KAAK,gBAAgB;AACpB,MAAI,gBAAgB,WAAW,iCAC7B,QAAO;GACL;GACA,OAAO;GACR;AAIH,MAAI,iCAAiC,OAAO,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MACxF,QAAO;GACL;GACA,OAAO,QAAQ,OAAO,MAAM,MAAM;GACnC;AAIH,MAAI,MAAM;OAKJ,EAFF,cAAc,MAAM,IAAI,MAAM,SAAS,OAAO,MAAM,UAAU,YAAY,eAAe,MAAM,OAG/F,QAAO;IACL;IACA,OAAO,QAAQ,OAAO,MAAM;IAC7B;;AAIL,SAAO;GACP,CACD,OAAO,UAAU"}

package/dist/components/Content/Schema/helpers/merge-all-of-schemas.js

@@ -1,7 +1,7 @@
 import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
 import { resolve } from "@scalar/workspace-store/resolve";
-import { objectKeys } from "@scalar/helpers/object/object-keys";
 import { isArraySchema } from "@scalar/workspace-store/schemas/v3.1/strict/type-guards";
+import { objectKeys } from "@scalar/helpers/object/object-keys";
 //#region src/components/Content/Schema/helpers/merge-all-of-schemas.ts
 /**
 * Schema keywords whose value should reflect the *last* occurrence when merging
@@ -101,7 +101,14 @@ var mergePropertiesIntoResult = (result, properties, seenRefs = /* @__PURE__ */
 			continue;
 		}
 		if (!result[key]) {
-			if (schema.allOf) result[key] = mergeAllOfSchemas(schema, void 0, seenRefs);
+			const rawProperty = properties[key];
+			const newSchemaRef = rawProperty?.$ref;
+			if (rawProperty && typeof newSchemaRef === "string" && seenRefs.has(newSchemaRef)) {
+				result[key] = rawProperty;
+				continue;
+			}
+			const nextNewSeenRefs = typeof newSchemaRef === "string" ? new Set(seenRefs).add(newSchemaRef) : seenRefs;
+			if (schema.allOf) result[key] = mergeAllOfSchemas(schema, void 0, nextNewSeenRefs);
 			else if (isArraySchema(schema) && resolve.schema(schema.items)?.allOf) result[key] = {
 				...schema,
 				items: mergeAllOfSchemas(resolve.schema(schema.items), void 0, seenRefs)