@scalar/api-reference 1.64.1 → 1.65.1

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 {\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 type { CompositionKeyword } from './helpers/schema-composition'\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\n    ? // A named property extends the breadcrumb with its own name. A nameless\n      // container (e.g. a response object, rendered without a name to avoid a\n      // duplicate heading) passes its breadcrumb straight through so its\n      // properties stay linkable.\n      props.name\n      ? [...props.breadcrumb, props.name]\n      : props.breadcrumb\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)\nconst getCompositionDiscriminator = (\n  composition: CompositionKeyword,\n): DiscriminatorObject | undefined =>\n  composition === 'allOf'\n    ? (props.schema?.discriminator ?? props.discriminator)\n    : props.schema?.discriminator\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    <!-- The array items card rendered below already lists these same values. -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0 && !shouldRenderArrayOfObjects\"\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=\"getCompositionDiscriminator(compositionData.composition)\"\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 type { CompositionKeyword } from './helpers/schema-composition'\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\n    ? // A named property extends the breadcrumb with its own name. A nameless\n      // container (e.g. a response object, rendered without a name to avoid a\n      // duplicate heading) passes its breadcrumb straight through so its\n      // properties stay linkable.\n      props.name\n      ? [...props.breadcrumb, props.name]\n      : props.breadcrumb\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)\nconst getCompositionDiscriminator = (\n  composition: CompositionKeyword,\n): DiscriminatorObject | undefined =>\n  composition === 'allOf'\n    ? (props.schema?.discriminator ?? props.discriminator)\n    : props.schema?.discriminator\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      :modelLinkOptions=\"{\n        hideModels: options.hideModels,\n        document: options.document,\n      }\"\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    <!-- The array items card rendered below already lists these same values. -->\n    <SchemaEnums\n      v-if=\"enumValues.length > 0 && !shouldRenderArrayOfObjects\"\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=\"getCompositionDiscriminator(compositionData.composition)\"\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.d.ts

@@ -1,5 +1,6 @@
 import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import { type ModelLinkOptions } from './helpers/is-model-linkable.js';
 type __VLS_Props = {
     value: SchemaObject | undefined;
     enum?: boolean;
@@ -8,6 +9,11 @@ type __VLS_Props = {
     additional?: boolean;
     withExamples?: boolean;
     hideModelNames?: boolean;
+    /**
+     * Config for deciding whether a model name links to the models section. When the section or
+     * the referenced model is hidden there is nothing to scroll to, so the name renders as plain text.
+     */
+    modelLinkOptions?: ModelLinkOptions;
     /** When the schema was resolved from a $ref, pass the ref name so it displays as e.g. "Data" instead of "object". */
     modelName?: string | null;
     /** Resolved propertyNames schema, used to surface key constraints like `format` for additional properties. */

package/dist/components/Content/Schema/SchemaPropertyHeading.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaPropertyHeading.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"names":[],"mappings":"AAugBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAoBhG,KAAK,WAAW,GAAG;IACf,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,8GAA8G;IAC9G,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACpC,CAAC;AAqnBJ,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK5C,QAAA,MAAM,UAAU;cAroBD,OAAO;cAQP,iBAAiB,GAAG,IAAI;oBALlB,OAAO;qBAJN,OAAO;kBAGV,OAAO;6EAsoBxB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"SchemaPropertyHeading.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"names":[],"mappings":"AAqhBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAchG,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAA;AAOpC,KAAK,WAAW,GAAG;IACf,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,8GAA8G;IAC9G,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACpC,CAAC;AA2nBJ,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK5C,QAAA,MAAM,UAAU;cAhpBD,OAAO;cAaP,iBAAiB,GAAG,IAAI;oBAVlB,OAAO;qBAJN,OAAO;kBAGV,OAAO;6EAipBxB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

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

@@ -2,7 +2,7 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default from "./SchemaPropertyHeading.vue.script.js";
 /* empty css                                    */
 //#region src/components/Content/Schema/SchemaPropertyHeading.vue
-var SchemaPropertyHeading_default = /*#__PURE__*/ _plugin_vue_export_helper_default(SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-74d321d3"]]);
+var SchemaPropertyHeading_default = /*#__PURE__*/ _plugin_vue_export_helper_default(SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-9f90ca8e"]]);
 //#endregion
 export { SchemaPropertyHeading_default as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaPropertyHeading.vue.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport {\n  isArraySchema,\n  isNumberSchema,\n  isStringSchema,\n} from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, toRef } from 'vue'\n\nimport { Badge } from '@/components/Badge'\nimport LinkButton from '@/components/Content/Schema/LinkButton.vue'\nimport ScreenReader from '@/components/ScreenReader.vue'\nimport { useLocalization } from '@/features/localization'\n\nimport { getSchemaType } from './helpers/get-schema-type'\nimport { getModelNameFromSchema } from './helpers/schema-name'\nimport RenderString from './RenderString.vue'\nimport SchemaPropertyDefault from './SchemaPropertyDefault.vue'\nimport SchemaPropertyDetail from './SchemaPropertyDetail.vue'\nimport SchemaPropertyExamples from './SchemaPropertyExamples.vue'\n\nconst props = withDefaults(\n  defineProps<{\n    value: SchemaObject | undefined\n    enum?: boolean\n    isDiscriminator?: boolean\n    required?: boolean\n    additional?: boolean\n    withExamples?: boolean\n    hideModelNames?: boolean\n    /** When the schema was resolved from a $ref, pass the ref name so it displays as e.g. \"Data\" instead of \"object\". */\n    modelName?: string | null\n    /** Resolved propertyNames schema, used to surface key constraints like `format` for additional properties. */\n    propertyNames?: SchemaObject\n    eventBus?: WorkspaceEventBus | null\n  }>(),\n  {\n    isDiscriminator: false,\n    required: false,\n    withExamples: true,\n    hideModelNames: false,\n    eventBus: null,\n  },\n)\nconst { translate } = useLocalization()\n\n// Convert to reactive refs for composables\nconst valueRef = toRef(props, 'value')\n\nconst constValue = computed(() => {\n  if (!valueRef.value) {\n    return undefined\n  }\n\n  const schema = valueRef.value\n\n  // Direct const value\n  if (schema.const !== undefined) {\n    return schema.const\n  }\n\n  // Single-item enum acts as const\n  if (schema.enum?.length === 1) {\n    return schema.enum[0]\n  }\n\n  // Check items for const values (for arrays)\n  if (isArraySchema(schema) && schema.items) {\n    const items = resolve.schema(schema.items)\n\n    if (isDefined(items.const)) {\n      return items.const\n    }\n\n    if (items.enum?.length === 1) {\n      return items.enum[0]\n    }\n  }\n\n  return undefined\n})\n\ntype ValidationProperty = {\n  key: string\n  value: string | number\n  prefix?: string\n  code?: boolean\n  truncate?: boolean\n}\n\n/**\n * Constraints that live on a leaf (string or number) schema: length, pattern,\n * format and numeric ranges. Extracted so they can be surfaced for a primitive\n * schema as well as for a primitive array's items, which are not rendered on\n * their own. See https://github.com/scalar/scalar/issues/9690\n */\nconst getLeafConstraints = (schema: SchemaObject) => {\n  const properties: ValidationProperty[] = []\n\n  if (isStringSchema(schema)) {\n    if (schema.minLength) {\n      properties.push({\n        key: 'min-length',\n        prefix: `${translate('common.minLength')}: `,\n        value: schema.minLength,\n      })\n    }\n\n    if (schema.maxLength) {\n      properties.push({\n        key: 'max-length',\n        prefix: `${translate('common.maxLength')}: `,\n        value: schema.maxLength,\n      })\n    }\n\n    if (schema.pattern) {\n      properties.push({\n        key: 'pattern',\n        value: schema.pattern,\n        code: true,\n        truncate: true,\n      })\n    }\n  }\n\n  if ((isStringSchema(schema) || isNumberSchema(schema)) && schema.format) {\n    properties.push({\n      key: 'format',\n      value: schema.format,\n      truncate: true,\n    })\n  }\n\n  if (isNumberSchema(schema)) {\n    if (isDefined(schema.exclusiveMinimum)) {\n      properties.push({\n        key: 'exclusive-minimum',\n        prefix: `${translate('common.greaterThan')}: `,\n        value: schema.exclusiveMinimum,\n      })\n    }\n\n    if (isDefined(schema.minimum)) {\n      properties.push({\n        key: 'minimum',\n        prefix: `${translate('common.min')}: `,\n        value: schema.minimum,\n      })\n    }\n\n    if (isDefined(schema.exclusiveMaximum)) {\n      properties.push({\n        key: 'exclusive-maximum',\n        prefix: `${translate('common.lessThan')}: `,\n        value: schema.exclusiveMaximum,\n      })\n    }\n\n    if (isDefined(schema.maximum)) {\n      properties.push({\n        key: 'maximum',\n        prefix: `${translate('common.max')}: `,\n        value: schema.maximum,\n      })\n    }\n\n    if (isDefined(schema.multipleOf)) {\n      properties.push({\n        key: 'multiple-of',\n        prefix: `${translate('common.multipleOf')}: `,\n        value: schema.multipleOf,\n      })\n    }\n  }\n\n  return properties\n}\n\nconst validationProperties = computed(() => {\n  if (!valueRef.value) {\n    return []\n  }\n\n  const schema = valueRef.value\n  const properties: ValidationProperty[] = []\n\n  // Array validation properties\n  if (isArraySchema(schema)) {\n    if (schema.minItems || schema.maxItems) {\n      properties.push({\n        key: 'array-range',\n        value: `${schema.minItems || ''}…${schema.maxItems || ''}`,\n      })\n    }\n\n    // Unique items\n    if (schema.uniqueItems) {\n      properties.push({\n        key: 'unique-items',\n        value: `${translate('common.unique')}!`,\n      })\n    }\n  }\n\n  properties.push(...getLeafConstraints(schema))\n\n  // Primitive array items carry their own constraints (e.g. an array of `uuid`\n  // strings) but are not rendered separately, so surface them here.\n  if (isArraySchema(schema) && schema.items) {\n    properties.push(...getLeafConstraints(resolve.schema(schema.items)))\n  }\n\n  return properties\n})\n\n/** Link data for navigating to the referenced model in the sidebar. */\nconst modelLink = computed(() => {\n  if (!props.value) {\n    return null\n  }\n\n  if (props.hideModelNames) {\n    return null\n  }\n\n  if (props.modelName) {\n    return { schemaKey: props.modelName, label: props.modelName }\n  }\n\n  const modelName = getModelNameFromSchema(props.value)\n  if (modelName) {\n    return { schemaKey: modelName.schemaKey, label: modelName.label }\n  }\n\n  if (isArraySchema(props.value) && props.value.items) {\n    const itemName = getModelNameFromSchema(props.value.items)\n    return itemName\n      ? { schemaKey: itemName.schemaKey, label: `${itemName.label}[]` }\n      : null\n  }\n\n  return null\n})\n\n/** Check if we should show the type information */\nconst shouldShowType = computed(() => {\n  if (!props.value || !('type' in props.value)) {\n    return false\n  }\n\n  // Always show type for arrays, even when items have const values\n  if (props.value.type === 'array') {\n    return true\n  }\n\n  // For non-arrays, only show if no const value at the schema level\n  return !constValue.value\n})\n\n/** Get the display type */\nconst displayType = computed(() => {\n  if (!props.value) {\n    return ''\n  }\n  return getSchemaType(props.value)\n})\n\n/**\n * Type and format of the property keys, derived from the propertyNames schema.\n *\n * For a map keyed by UUIDs this renders e.g. \"string · uuid\" so the key\n * constraints are not lost. Returns undefined when there is nothing to show.\n */\nconst propertyNamesDetail = computed(() => {\n  const schema = props.propertyNames\n  if (!schema) {\n    return undefined\n  }\n\n  const parts = [getSchemaType(schema)]\n  if ('format' in schema && typeof schema.format === 'string') {\n    parts.push(schema.format)\n  }\n\n  const detail = parts.filter(Boolean).join(' · ')\n  return detail.length > 0 ? detail : undefined\n})\n\nconst exampleValue = computed(() => {\n  // Treat only `undefined` as \"not set\" — `null` is a valid example value on a nullable schema.\n  if (\n    props.value &&\n    'example' in props.value &&\n    props.value.example !== undefined\n  ) {\n    return props.value.example\n  }\n\n  if (props.value && isArraySchema(props.value)) {\n    const itemsSchema = resolve.schema(props.value.items)\n    if (\n      itemsSchema &&\n      'example' in itemsSchema &&\n      itemsSchema.example !== undefined\n    ) {\n      return itemsSchema.example\n    }\n  }\n\n  return undefined\n})\n</script>\n<template>\n  <div class=\"property-heading\">\n    <div\n      v-if=\"$slots.name\"\n      class=\"property-name\"\n      :class=\"{ deprecated: props.value?.deprecated }\">\n      <slot name=\"name\" />\n    </div>\n    <div\n      v-if=\"props.isDiscriminator\"\n      class=\"property-discriminator\">\n      {{ translate('common.discriminator') }}\n    </div>\n    <template v-if=\"props.value\">\n      <!-- Type information -->\n      <SchemaPropertyDetail\n        v-if=\"shouldShowType\"\n        truncate>\n        <ScreenReader>{{ translate('common.type') }}:</ScreenReader>\n        {{ displayType }}\n        <template v-if=\"modelLink\">\n          ·\n          <LinkButton\n            v-if=\"props.eventBus && modelLink.schemaKey\"\n            @click=\"\n              props.eventBus.emit('scroll-to:model-by-name', {\n                name: modelLink.schemaKey,\n              })\n            \">\n            {{ modelLink.label }}\n          </LinkButton>\n          <template v-else>{{ modelLink.label }}</template>\n        </template>\n      </SchemaPropertyDetail>\n\n      <!-- Key constraints from propertyNames (e.g. \"keys: string · uuid\") -->\n      <SchemaPropertyDetail\n        v-if=\"propertyNamesDetail\"\n        truncate>\n        <template #prefix>{{ translate('common.keys') }}:</template>\n        {{ propertyNamesDetail }}\n      </SchemaPropertyDetail>\n\n      <!-- Dynamic validation properties from composable -->\n      <SchemaPropertyDetail\n        v-for=\"property in validationProperties\"\n        :key=\"property.key\"\n        :code=\"property.code\"\n        :truncate=\"property.truncate\">\n        <ScreenReader v-if=\"property.key === 'format'\">\n          {{ translate('common.format') }}:\n        </ScreenReader>\n        <ScreenReader v-else-if=\"property.key === 'pattern'\">\n          {{ translate('common.pattern') }}:\n        </ScreenReader>\n        <template\n          v-if=\"property.prefix\"\n          #prefix>\n          {{ property.prefix }}\n        </template>\n        {{ property.value }}\n      </SchemaPropertyDetail>\n\n      <!-- Enum indicator -->\n      <SchemaPropertyDetail v-if=\"props.enum\">\n        {{ translate('common.enum') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.additional\"\n      class=\"property-additional\">\n      <template v-if=\"props.value?.['x-additionalPropertiesName']\">\n        {{ props.value['x-additionalPropertiesName'] }}\n      </template>\n      <template v-else>{{ translate('common.additionalProperties') }}</template>\n    </div>\n    <div\n      v-if=\"props.value?.deprecated\"\n      class=\"property-deprecated\">\n      <Badge>{{ translate('common.deprecated') }}</Badge>\n    </div>\n    <!-- Don't use `isDefined` here, we want to show `const` when the value is `null` -->\n    <div\n      v-if=\"constValue !== undefined\"\n      class=\"property-const\">\n      <SchemaPropertyDetail truncate>\n        <template #prefix>{{ translate('common.const') }}: </template>\n        <RenderString :value=\"constValue\" />\n      </SchemaPropertyDetail>\n    </div>\n    <template v-else>\n      <!-- Shows only when a composition is used (so props.value?.type is undefined) -->\n      <SchemaPropertyDetail v-if=\"(props.value as any)?.nullable === true\">\n        {{ translate('common.nullable') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.value?.writeOnly\"\n      class=\"property-write-only\">\n      {{ translate('common.writeOnly') }}\n    </div>\n    <div\n      v-else-if=\"props.value?.readOnly\"\n      class=\"property-read-only\">\n      {{ translate('common.readOnly') }}\n    </div>\n    <div\n      v-if=\"props.required\"\n      class=\"property-required\">\n      {{ translate('common.required') }}\n    </div>\n    <SchemaPropertyDefault :value=\"props.value?.default\" />\n    <SchemaPropertyExamples\n      v-if=\"props.withExamples\"\n      :example=\"exampleValue\"\n      :examples=\"props.value?.examples\" />\n  </div>\n</template>\n<style scoped>\n.property-heading {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: baseline;\n  row-gap: 9px;\n  white-space: nowrap;\n}\n\n.property-heading:has(+ .children),\n.property-heading:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n.property-heading > * {\n  margin-right: 9px;\n}\n\n.property-heading:last-child {\n  margin-right: 0;\n}\n\n.property-heading > .property-detail:not(:last-of-type) {\n  margin-right: 0;\n}\n\n.property-name {\n  max-width: 100%;\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-bold);\n  font-size: var(--scalar-font-size-4);\n  white-space: normal;\n  overflow-wrap: break-word;\n}\n\n.property-additional {\n  font-family: var(--scalar-font-code);\n}\n\n.property-required,\n.property-optional {\n  color: var(--scalar-color-2);\n}\n\n.property-required {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-orange);\n}\n\n.property-read-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-blue);\n}\n\n.property-write-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-green);\n}\n\n.property-discriminator {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-purple);\n}\n\n.property-detail {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-2);\n  display: flex;\n  align-items: center;\n\n  min-width: 0;\n}\n\n.property-const {\n  color: var(--scalar-color-1);\n}\n\n.deprecated {\n  text-decoration: line-through;\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"SchemaPropertyHeading.vue.js","names":[],"sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport {\n  isArraySchema,\n  isNumberSchema,\n  isStringSchema,\n} from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, toRef } from 'vue'\n\nimport { Badge } from '@/components/Badge'\nimport LinkButton from '@/components/Content/Schema/LinkButton.vue'\nimport ScreenReader from '@/components/ScreenReader.vue'\nimport { useLocalization } from '@/features/localization'\n\nimport { getSchemaType } from './helpers/get-schema-type'\nimport {\n  isModelLinkable,\n  type ModelLinkOptions,\n} from './helpers/is-model-linkable'\nimport { getModelNameFromSchema } from './helpers/schema-name'\nimport RenderString from './RenderString.vue'\nimport SchemaPropertyDefault from './SchemaPropertyDefault.vue'\nimport SchemaPropertyDetail from './SchemaPropertyDetail.vue'\nimport SchemaPropertyExamples from './SchemaPropertyExamples.vue'\n\nconst props = withDefaults(\n  defineProps<{\n    value: SchemaObject | undefined\n    enum?: boolean\n    isDiscriminator?: boolean\n    required?: boolean\n    additional?: boolean\n    withExamples?: boolean\n    hideModelNames?: boolean\n    /**\n     * Config for deciding whether a model name links to the models section. When the section or\n     * the referenced model is hidden there is nothing to scroll to, so the name renders as plain text.\n     */\n    modelLinkOptions?: ModelLinkOptions\n    /** When the schema was resolved from a $ref, pass the ref name so it displays as e.g. \"Data\" instead of \"object\". */\n    modelName?: string | null\n    /** Resolved propertyNames schema, used to surface key constraints like `format` for additional properties. */\n    propertyNames?: SchemaObject\n    eventBus?: WorkspaceEventBus | null\n  }>(),\n  {\n    isDiscriminator: false,\n    required: false,\n    withExamples: true,\n    hideModelNames: false,\n    eventBus: null,\n  },\n)\nconst { translate } = useLocalization()\n\n// Convert to reactive refs for composables\nconst valueRef = toRef(props, 'value')\n\nconst constValue = computed(() => {\n  if (!valueRef.value) {\n    return undefined\n  }\n\n  const schema = valueRef.value\n\n  // Direct const value\n  if (schema.const !== undefined) {\n    return schema.const\n  }\n\n  // Single-item enum acts as const\n  if (schema.enum?.length === 1) {\n    return schema.enum[0]\n  }\n\n  // Check items for const values (for arrays)\n  if (isArraySchema(schema) && schema.items) {\n    const items = resolve.schema(schema.items)\n\n    if (isDefined(items.const)) {\n      return items.const\n    }\n\n    if (items.enum?.length === 1) {\n      return items.enum[0]\n    }\n  }\n\n  return undefined\n})\n\ntype ValidationProperty = {\n  key: string\n  value: string | number\n  prefix?: string\n  code?: boolean\n  truncate?: boolean\n}\n\n/**\n * Constraints that live on a leaf (string or number) schema: length, pattern,\n * format and numeric ranges. Extracted so they can be surfaced for a primitive\n * schema as well as for a primitive array's items, which are not rendered on\n * their own. See https://github.com/scalar/scalar/issues/9690\n */\nconst getLeafConstraints = (schema: SchemaObject) => {\n  const properties: ValidationProperty[] = []\n\n  if (isStringSchema(schema)) {\n    if (schema.minLength) {\n      properties.push({\n        key: 'min-length',\n        prefix: `${translate('common.minLength')}: `,\n        value: schema.minLength,\n      })\n    }\n\n    if (schema.maxLength) {\n      properties.push({\n        key: 'max-length',\n        prefix: `${translate('common.maxLength')}: `,\n        value: schema.maxLength,\n      })\n    }\n\n    if (schema.pattern) {\n      properties.push({\n        key: 'pattern',\n        value: schema.pattern,\n        code: true,\n        truncate: true,\n      })\n    }\n  }\n\n  if ((isStringSchema(schema) || isNumberSchema(schema)) && schema.format) {\n    properties.push({\n      key: 'format',\n      value: schema.format,\n      truncate: true,\n    })\n  }\n\n  if (isNumberSchema(schema)) {\n    if (isDefined(schema.exclusiveMinimum)) {\n      properties.push({\n        key: 'exclusive-minimum',\n        prefix: `${translate('common.greaterThan')}: `,\n        value: schema.exclusiveMinimum,\n      })\n    }\n\n    if (isDefined(schema.minimum)) {\n      properties.push({\n        key: 'minimum',\n        prefix: `${translate('common.min')}: `,\n        value: schema.minimum,\n      })\n    }\n\n    if (isDefined(schema.exclusiveMaximum)) {\n      properties.push({\n        key: 'exclusive-maximum',\n        prefix: `${translate('common.lessThan')}: `,\n        value: schema.exclusiveMaximum,\n      })\n    }\n\n    if (isDefined(schema.maximum)) {\n      properties.push({\n        key: 'maximum',\n        prefix: `${translate('common.max')}: `,\n        value: schema.maximum,\n      })\n    }\n\n    if (isDefined(schema.multipleOf)) {\n      properties.push({\n        key: 'multiple-of',\n        prefix: `${translate('common.multipleOf')}: `,\n        value: schema.multipleOf,\n      })\n    }\n  }\n\n  return properties\n}\n\nconst validationProperties = computed(() => {\n  if (!valueRef.value) {\n    return []\n  }\n\n  const schema = valueRef.value\n  const properties: ValidationProperty[] = []\n\n  // Array validation properties\n  if (isArraySchema(schema)) {\n    if (schema.minItems || schema.maxItems) {\n      properties.push({\n        key: 'array-range',\n        value: `${schema.minItems || ''}…${schema.maxItems || ''}`,\n      })\n    }\n\n    // Unique items\n    if (schema.uniqueItems) {\n      properties.push({\n        key: 'unique-items',\n        value: `${translate('common.unique')}!`,\n      })\n    }\n  }\n\n  properties.push(...getLeafConstraints(schema))\n\n  // Primitive array items carry their own constraints (e.g. an array of `uuid`\n  // strings) but are not rendered separately, so surface them here.\n  if (isArraySchema(schema) && schema.items) {\n    properties.push(...getLeafConstraints(resolve.schema(schema.items)))\n  }\n\n  return properties\n})\n\n/** Link data for navigating to the referenced model in the sidebar. */\nconst modelLink = computed(() => {\n  if (!props.value) {\n    return null\n  }\n\n  if (props.hideModelNames) {\n    return null\n  }\n\n  if (props.modelName) {\n    return { schemaKey: props.modelName, label: props.modelName }\n  }\n\n  const modelName = getModelNameFromSchema(props.value)\n  if (modelName) {\n    return { schemaKey: modelName.schemaKey, label: modelName.label }\n  }\n\n  if (isArraySchema(props.value) && props.value.items) {\n    const itemName = getModelNameFromSchema(props.value.items)\n    return itemName\n      ? { schemaKey: itemName.schemaKey, label: `${itemName.label}[]` }\n      : null\n  }\n\n  return null\n})\n\n/** Whether the model name links to the models section, or renders as plain text. */\nconst modelLinkable = computed(() =>\n  isModelLinkable(modelLink.value?.schemaKey, props.modelLinkOptions ?? {}),\n)\n\n/** Check if we should show the type information */\nconst shouldShowType = computed(() => {\n  if (!props.value || !('type' in props.value)) {\n    return false\n  }\n\n  // Always show type for arrays, even when items have const values\n  if (props.value.type === 'array') {\n    return true\n  }\n\n  // For non-arrays, only show if no const value at the schema level\n  return !constValue.value\n})\n\n/** Get the display type */\nconst displayType = computed(() => {\n  if (!props.value) {\n    return ''\n  }\n  return getSchemaType(props.value)\n})\n\n/**\n * Type and format of the property keys, derived from the propertyNames schema.\n *\n * For a map keyed by UUIDs this renders e.g. \"string · uuid\" so the key\n * constraints are not lost. Returns undefined when there is nothing to show.\n */\nconst propertyNamesDetail = computed(() => {\n  const schema = props.propertyNames\n  if (!schema) {\n    return undefined\n  }\n\n  const parts = [getSchemaType(schema)]\n  if ('format' in schema && typeof schema.format === 'string') {\n    parts.push(schema.format)\n  }\n\n  const detail = parts.filter(Boolean).join(' · ')\n  return detail.length > 0 ? detail : undefined\n})\n\nconst exampleValue = computed(() => {\n  // Treat only `undefined` as \"not set\" — `null` is a valid example value on a nullable schema.\n  if (\n    props.value &&\n    'example' in props.value &&\n    props.value.example !== undefined\n  ) {\n    return props.value.example\n  }\n\n  if (props.value && isArraySchema(props.value)) {\n    const itemsSchema = resolve.schema(props.value.items)\n    if (\n      itemsSchema &&\n      'example' in itemsSchema &&\n      itemsSchema.example !== undefined\n    ) {\n      return itemsSchema.example\n    }\n  }\n\n  return undefined\n})\n</script>\n<template>\n  <div class=\"property-heading\">\n    <div\n      v-if=\"$slots.name\"\n      class=\"property-name\"\n      :class=\"{ deprecated: props.value?.deprecated }\">\n      <slot name=\"name\" />\n    </div>\n    <div\n      v-if=\"props.isDiscriminator\"\n      class=\"property-discriminator\">\n      {{ translate('common.discriminator') }}\n    </div>\n    <template v-if=\"props.value\">\n      <!-- Type information -->\n      <SchemaPropertyDetail\n        v-if=\"shouldShowType\"\n        truncate>\n        <ScreenReader>{{ translate('common.type') }}:</ScreenReader>\n        {{ displayType }}\n        <template v-if=\"modelLink\">\n          ·\n          <LinkButton\n            v-if=\"props.eventBus && modelLink.schemaKey && modelLinkable\"\n            @click=\"\n              props.eventBus.emit('scroll-to:model-by-name', {\n                name: modelLink.schemaKey,\n              })\n            \">\n            {{ modelLink.label }}\n          </LinkButton>\n          <template v-else>{{ modelLink.label }}</template>\n        </template>\n      </SchemaPropertyDetail>\n\n      <!-- Key constraints from propertyNames (e.g. \"keys: string · uuid\") -->\n      <SchemaPropertyDetail\n        v-if=\"propertyNamesDetail\"\n        truncate>\n        <template #prefix>{{ translate('common.keys') }}:</template>\n        {{ propertyNamesDetail }}\n      </SchemaPropertyDetail>\n\n      <!-- Dynamic validation properties from composable -->\n      <SchemaPropertyDetail\n        v-for=\"property in validationProperties\"\n        :key=\"property.key\"\n        :code=\"property.code\"\n        :truncate=\"property.truncate\">\n        <ScreenReader v-if=\"property.key === 'format'\">\n          {{ translate('common.format') }}:\n        </ScreenReader>\n        <ScreenReader v-else-if=\"property.key === 'pattern'\">\n          {{ translate('common.pattern') }}:\n        </ScreenReader>\n        <template\n          v-if=\"property.prefix\"\n          #prefix>\n          {{ property.prefix }}\n        </template>\n        {{ property.value }}\n      </SchemaPropertyDetail>\n\n      <!-- Enum indicator -->\n      <SchemaPropertyDetail v-if=\"props.enum\">\n        {{ translate('common.enum') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.additional\"\n      class=\"property-additional\">\n      <template v-if=\"props.value?.['x-additionalPropertiesName']\">\n        {{ props.value['x-additionalPropertiesName'] }}\n      </template>\n      <template v-else>{{ translate('common.additionalProperties') }}</template>\n    </div>\n    <div\n      v-if=\"props.value?.deprecated\"\n      class=\"property-deprecated\">\n      <Badge>{{ translate('common.deprecated') }}</Badge>\n    </div>\n    <!-- Don't use `isDefined` here, we want to show `const` when the value is `null` -->\n    <div\n      v-if=\"constValue !== undefined\"\n      class=\"property-const\">\n      <SchemaPropertyDetail truncate>\n        <template #prefix>{{ translate('common.const') }}: </template>\n        <RenderString :value=\"constValue\" />\n      </SchemaPropertyDetail>\n    </div>\n    <template v-else>\n      <!-- Shows only when a composition is used (so props.value?.type is undefined) -->\n      <SchemaPropertyDetail v-if=\"(props.value as any)?.nullable === true\">\n        {{ translate('common.nullable') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.value?.writeOnly\"\n      class=\"property-write-only\">\n      {{ translate('common.writeOnly') }}\n    </div>\n    <div\n      v-else-if=\"props.value?.readOnly\"\n      class=\"property-read-only\">\n      {{ translate('common.readOnly') }}\n    </div>\n    <div\n      v-if=\"props.required\"\n      class=\"property-required\">\n      {{ translate('common.required') }}\n    </div>\n    <SchemaPropertyDefault :value=\"props.value?.default\" />\n    <SchemaPropertyExamples\n      v-if=\"props.withExamples\"\n      :example=\"exampleValue\"\n      :examples=\"props.value?.examples\" />\n  </div>\n</template>\n<style scoped>\n.property-heading {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: baseline;\n  row-gap: 9px;\n  white-space: nowrap;\n}\n\n.property-heading:has(+ .children),\n.property-heading:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n.property-heading > * {\n  margin-right: 9px;\n}\n\n.property-heading:last-child {\n  margin-right: 0;\n}\n\n.property-heading > .property-detail:not(:last-of-type) {\n  margin-right: 0;\n}\n\n.property-name {\n  max-width: 100%;\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-bold);\n  font-size: var(--scalar-font-size-4);\n  white-space: normal;\n  overflow-wrap: break-word;\n}\n\n.property-additional {\n  font-family: var(--scalar-font-code);\n}\n\n.property-required,\n.property-optional {\n  color: var(--scalar-color-2);\n}\n\n.property-required {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-orange);\n}\n\n.property-read-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-blue);\n}\n\n.property-write-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-green);\n}\n\n.property-discriminator {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-purple);\n}\n\n.property-detail {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-2);\n  display: flex;\n  align-items: center;\n\n  min-width: 0;\n}\n\n.property-const {\n  color: var(--scalar-color-1);\n}\n\n.deprecated {\n  text-decoration: line-through;\n}\n</style>\n"],"mappings":""}

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

@@ -4,6 +4,7 @@ import ScreenReader_default from "../../ScreenReader.vue.js";
 import { getSchemaType } from "./helpers/get-schema-type.js";
 import { getModelNameFromSchema } from "./helpers/schema-name.js";
 import LinkButton_default from "./LinkButton.vue.js";
+import { isModelLinkable } from "./helpers/is-model-linkable.js";
 import RenderString_default from "./RenderString.vue.js";
 import SchemaPropertyDefault_default from "./SchemaPropertyDefault.vue.js";
 import SchemaPropertyDetail_default from "./SchemaPropertyDetail.vue.js";
@@ -70,6 +71,7 @@ var SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default = /*@__PUR
 			type: Boolean,
 			default: false
 		},
+		modelLinkOptions: {},
 		modelName: {},
 		propertyNames: {},
 		eventBus: { default: null }
@@ -183,6 +185,8 @@ var SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default = /*@__PUR
 			}
 			return null;
 		});
+		/** Whether the model name links to the models section, or renders as plain text. */
+		const modelLinkable = computed(() => isModelLinkable(modelLink.value?.schemaKey, props.modelLinkOptions ?? {}));
 		/** Check if we should show the type information */
 		const shouldShowType = computed(() => {
 			if (!props.value || !("type" in props.value)) return false;
@@ -233,7 +237,7 @@ var SchemaPropertyHeading_vue_vue_type_script_setup_true_lang_default = /*@__PUR
 								_: 1
 							}),
 							createTextVNode(" " + toDisplayString(displayType.value) + " ", 1),
-							modelLink.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [_cache[1] || (_cache[1] = createTextVNode(" · ", -1)), props.eventBus && modelLink.value.schemaKey ? (openBlock(), createBlock(LinkButton_default, {
+							modelLink.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [_cache[1] || (_cache[1] = createTextVNode(" · ", -1)), props.eventBus && modelLink.value.schemaKey && modelLinkable.value ? (openBlock(), createBlock(LinkButton_default, {
 								key: 0,
 								onClick: _cache[0] || (_cache[0] = ($event) => props.eventBus.emit("scroll-to:model-by-name", { name: modelLink.value.schemaKey }))
 							}, {

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaPropertyHeading.vue.script.js","names":["$slots"],"sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport {\n  isArraySchema,\n  isNumberSchema,\n  isStringSchema,\n} from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, toRef } from 'vue'\n\nimport { Badge } from '@/components/Badge'\nimport LinkButton from '@/components/Content/Schema/LinkButton.vue'\nimport ScreenReader from '@/components/ScreenReader.vue'\nimport { useLocalization } from '@/features/localization'\n\nimport { getSchemaType } from './helpers/get-schema-type'\nimport { getModelNameFromSchema } from './helpers/schema-name'\nimport RenderString from './RenderString.vue'\nimport SchemaPropertyDefault from './SchemaPropertyDefault.vue'\nimport SchemaPropertyDetail from './SchemaPropertyDetail.vue'\nimport SchemaPropertyExamples from './SchemaPropertyExamples.vue'\n\nconst props = withDefaults(\n  defineProps<{\n    value: SchemaObject | undefined\n    enum?: boolean\n    isDiscriminator?: boolean\n    required?: boolean\n    additional?: boolean\n    withExamples?: boolean\n    hideModelNames?: boolean\n    /** When the schema was resolved from a $ref, pass the ref name so it displays as e.g. \"Data\" instead of \"object\". */\n    modelName?: string | null\n    /** Resolved propertyNames schema, used to surface key constraints like `format` for additional properties. */\n    propertyNames?: SchemaObject\n    eventBus?: WorkspaceEventBus | null\n  }>(),\n  {\n    isDiscriminator: false,\n    required: false,\n    withExamples: true,\n    hideModelNames: false,\n    eventBus: null,\n  },\n)\nconst { translate } = useLocalization()\n\n// Convert to reactive refs for composables\nconst valueRef = toRef(props, 'value')\n\nconst constValue = computed(() => {\n  if (!valueRef.value) {\n    return undefined\n  }\n\n  const schema = valueRef.value\n\n  // Direct const value\n  if (schema.const !== undefined) {\n    return schema.const\n  }\n\n  // Single-item enum acts as const\n  if (schema.enum?.length === 1) {\n    return schema.enum[0]\n  }\n\n  // Check items for const values (for arrays)\n  if (isArraySchema(schema) && schema.items) {\n    const items = resolve.schema(schema.items)\n\n    if (isDefined(items.const)) {\n      return items.const\n    }\n\n    if (items.enum?.length === 1) {\n      return items.enum[0]\n    }\n  }\n\n  return undefined\n})\n\ntype ValidationProperty = {\n  key: string\n  value: string | number\n  prefix?: string\n  code?: boolean\n  truncate?: boolean\n}\n\n/**\n * Constraints that live on a leaf (string or number) schema: length, pattern,\n * format and numeric ranges. Extracted so they can be surfaced for a primitive\n * schema as well as for a primitive array's items, which are not rendered on\n * their own. See https://github.com/scalar/scalar/issues/9690\n */\nconst getLeafConstraints = (schema: SchemaObject) => {\n  const properties: ValidationProperty[] = []\n\n  if (isStringSchema(schema)) {\n    if (schema.minLength) {\n      properties.push({\n        key: 'min-length',\n        prefix: `${translate('common.minLength')}: `,\n        value: schema.minLength,\n      })\n    }\n\n    if (schema.maxLength) {\n      properties.push({\n        key: 'max-length',\n        prefix: `${translate('common.maxLength')}: `,\n        value: schema.maxLength,\n      })\n    }\n\n    if (schema.pattern) {\n      properties.push({\n        key: 'pattern',\n        value: schema.pattern,\n        code: true,\n        truncate: true,\n      })\n    }\n  }\n\n  if ((isStringSchema(schema) || isNumberSchema(schema)) && schema.format) {\n    properties.push({\n      key: 'format',\n      value: schema.format,\n      truncate: true,\n    })\n  }\n\n  if (isNumberSchema(schema)) {\n    if (isDefined(schema.exclusiveMinimum)) {\n      properties.push({\n        key: 'exclusive-minimum',\n        prefix: `${translate('common.greaterThan')}: `,\n        value: schema.exclusiveMinimum,\n      })\n    }\n\n    if (isDefined(schema.minimum)) {\n      properties.push({\n        key: 'minimum',\n        prefix: `${translate('common.min')}: `,\n        value: schema.minimum,\n      })\n    }\n\n    if (isDefined(schema.exclusiveMaximum)) {\n      properties.push({\n        key: 'exclusive-maximum',\n        prefix: `${translate('common.lessThan')}: `,\n        value: schema.exclusiveMaximum,\n      })\n    }\n\n    if (isDefined(schema.maximum)) {\n      properties.push({\n        key: 'maximum',\n        prefix: `${translate('common.max')}: `,\n        value: schema.maximum,\n      })\n    }\n\n    if (isDefined(schema.multipleOf)) {\n      properties.push({\n        key: 'multiple-of',\n        prefix: `${translate('common.multipleOf')}: `,\n        value: schema.multipleOf,\n      })\n    }\n  }\n\n  return properties\n}\n\nconst validationProperties = computed(() => {\n  if (!valueRef.value) {\n    return []\n  }\n\n  const schema = valueRef.value\n  const properties: ValidationProperty[] = []\n\n  // Array validation properties\n  if (isArraySchema(schema)) {\n    if (schema.minItems || schema.maxItems) {\n      properties.push({\n        key: 'array-range',\n        value: `${schema.minItems || ''}…${schema.maxItems || ''}`,\n      })\n    }\n\n    // Unique items\n    if (schema.uniqueItems) {\n      properties.push({\n        key: 'unique-items',\n        value: `${translate('common.unique')}!`,\n      })\n    }\n  }\n\n  properties.push(...getLeafConstraints(schema))\n\n  // Primitive array items carry their own constraints (e.g. an array of `uuid`\n  // strings) but are not rendered separately, so surface them here.\n  if (isArraySchema(schema) && schema.items) {\n    properties.push(...getLeafConstraints(resolve.schema(schema.items)))\n  }\n\n  return properties\n})\n\n/** Link data for navigating to the referenced model in the sidebar. */\nconst modelLink = computed(() => {\n  if (!props.value) {\n    return null\n  }\n\n  if (props.hideModelNames) {\n    return null\n  }\n\n  if (props.modelName) {\n    return { schemaKey: props.modelName, label: props.modelName }\n  }\n\n  const modelName = getModelNameFromSchema(props.value)\n  if (modelName) {\n    return { schemaKey: modelName.schemaKey, label: modelName.label }\n  }\n\n  if (isArraySchema(props.value) && props.value.items) {\n    const itemName = getModelNameFromSchema(props.value.items)\n    return itemName\n      ? { schemaKey: itemName.schemaKey, label: `${itemName.label}[]` }\n      : null\n  }\n\n  return null\n})\n\n/** Check if we should show the type information */\nconst shouldShowType = computed(() => {\n  if (!props.value || !('type' in props.value)) {\n    return false\n  }\n\n  // Always show type for arrays, even when items have const values\n  if (props.value.type === 'array') {\n    return true\n  }\n\n  // For non-arrays, only show if no const value at the schema level\n  return !constValue.value\n})\n\n/** Get the display type */\nconst displayType = computed(() => {\n  if (!props.value) {\n    return ''\n  }\n  return getSchemaType(props.value)\n})\n\n/**\n * Type and format of the property keys, derived from the propertyNames schema.\n *\n * For a map keyed by UUIDs this renders e.g. \"string · uuid\" so the key\n * constraints are not lost. Returns undefined when there is nothing to show.\n */\nconst propertyNamesDetail = computed(() => {\n  const schema = props.propertyNames\n  if (!schema) {\n    return undefined\n  }\n\n  const parts = [getSchemaType(schema)]\n  if ('format' in schema && typeof schema.format === 'string') {\n    parts.push(schema.format)\n  }\n\n  const detail = parts.filter(Boolean).join(' · ')\n  return detail.length > 0 ? detail : undefined\n})\n\nconst exampleValue = computed(() => {\n  // Treat only `undefined` as \"not set\" — `null` is a valid example value on a nullable schema.\n  if (\n    props.value &&\n    'example' in props.value &&\n    props.value.example !== undefined\n  ) {\n    return props.value.example\n  }\n\n  if (props.value && isArraySchema(props.value)) {\n    const itemsSchema = resolve.schema(props.value.items)\n    if (\n      itemsSchema &&\n      'example' in itemsSchema &&\n      itemsSchema.example !== undefined\n    ) {\n      return itemsSchema.example\n    }\n  }\n\n  return undefined\n})\n</script>\n<template>\n  <div class=\"property-heading\">\n    <div\n      v-if=\"$slots.name\"\n      class=\"property-name\"\n      :class=\"{ deprecated: props.value?.deprecated }\">\n      <slot name=\"name\" />\n    </div>\n    <div\n      v-if=\"props.isDiscriminator\"\n      class=\"property-discriminator\">\n      {{ translate('common.discriminator') }}\n    </div>\n    <template v-if=\"props.value\">\n      <!-- Type information -->\n      <SchemaPropertyDetail\n        v-if=\"shouldShowType\"\n        truncate>\n        <ScreenReader>{{ translate('common.type') }}:</ScreenReader>\n        {{ displayType }}\n        <template v-if=\"modelLink\">\n          ·\n          <LinkButton\n            v-if=\"props.eventBus && modelLink.schemaKey\"\n            @click=\"\n              props.eventBus.emit('scroll-to:model-by-name', {\n                name: modelLink.schemaKey,\n              })\n            \">\n            {{ modelLink.label }}\n          </LinkButton>\n          <template v-else>{{ modelLink.label }}</template>\n        </template>\n      </SchemaPropertyDetail>\n\n      <!-- Key constraints from propertyNames (e.g. \"keys: string · uuid\") -->\n      <SchemaPropertyDetail\n        v-if=\"propertyNamesDetail\"\n        truncate>\n        <template #prefix>{{ translate('common.keys') }}:</template>\n        {{ propertyNamesDetail }}\n      </SchemaPropertyDetail>\n\n      <!-- Dynamic validation properties from composable -->\n      <SchemaPropertyDetail\n        v-for=\"property in validationProperties\"\n        :key=\"property.key\"\n        :code=\"property.code\"\n        :truncate=\"property.truncate\">\n        <ScreenReader v-if=\"property.key === 'format'\">\n          {{ translate('common.format') }}:\n        </ScreenReader>\n        <ScreenReader v-else-if=\"property.key === 'pattern'\">\n          {{ translate('common.pattern') }}:\n        </ScreenReader>\n        <template\n          v-if=\"property.prefix\"\n          #prefix>\n          {{ property.prefix }}\n        </template>\n        {{ property.value }}\n      </SchemaPropertyDetail>\n\n      <!-- Enum indicator -->\n      <SchemaPropertyDetail v-if=\"props.enum\">\n        {{ translate('common.enum') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.additional\"\n      class=\"property-additional\">\n      <template v-if=\"props.value?.['x-additionalPropertiesName']\">\n        {{ props.value['x-additionalPropertiesName'] }}\n      </template>\n      <template v-else>{{ translate('common.additionalProperties') }}</template>\n    </div>\n    <div\n      v-if=\"props.value?.deprecated\"\n      class=\"property-deprecated\">\n      <Badge>{{ translate('common.deprecated') }}</Badge>\n    </div>\n    <!-- Don't use `isDefined` here, we want to show `const` when the value is `null` -->\n    <div\n      v-if=\"constValue !== undefined\"\n      class=\"property-const\">\n      <SchemaPropertyDetail truncate>\n        <template #prefix>{{ translate('common.const') }}: </template>\n        <RenderString :value=\"constValue\" />\n      </SchemaPropertyDetail>\n    </div>\n    <template v-else>\n      <!-- Shows only when a composition is used (so props.value?.type is undefined) -->\n      <SchemaPropertyDetail v-if=\"(props.value as any)?.nullable === true\">\n        {{ translate('common.nullable') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.value?.writeOnly\"\n      class=\"property-write-only\">\n      {{ translate('common.writeOnly') }}\n    </div>\n    <div\n      v-else-if=\"props.value?.readOnly\"\n      class=\"property-read-only\">\n      {{ translate('common.readOnly') }}\n    </div>\n    <div\n      v-if=\"props.required\"\n      class=\"property-required\">\n      {{ translate('common.required') }}\n    </div>\n    <SchemaPropertyDefault :value=\"props.value?.default\" />\n    <SchemaPropertyExamples\n      v-if=\"props.withExamples\"\n      :example=\"exampleValue\"\n      :examples=\"props.value?.examples\" />\n  </div>\n</template>\n<style scoped>\n.property-heading {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: baseline;\n  row-gap: 9px;\n  white-space: nowrap;\n}\n\n.property-heading:has(+ .children),\n.property-heading:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n.property-heading > * {\n  margin-right: 9px;\n}\n\n.property-heading:last-child {\n  margin-right: 0;\n}\n\n.property-heading > .property-detail:not(:last-of-type) {\n  margin-right: 0;\n}\n\n.property-name {\n  max-width: 100%;\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-bold);\n  font-size: var(--scalar-font-size-4);\n  white-space: normal;\n  overflow-wrap: break-word;\n}\n\n.property-additional {\n  font-family: var(--scalar-font-code);\n}\n\n.property-required,\n.property-optional {\n  color: var(--scalar-color-2);\n}\n\n.property-required {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-orange);\n}\n\n.property-read-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-blue);\n}\n\n.property-write-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-green);\n}\n\n.property-discriminator {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-purple);\n}\n\n.property-detail {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-2);\n  display: flex;\n  align-items: center;\n\n  min-width: 0;\n}\n\n.property-const {\n  color: var(--scalar-color-1);\n}\n\n.deprecated {\n  text-decoration: line-through;\n}\n</style>\n"],"mappings":"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"}
+{"version":3,"file":"SchemaPropertyHeading.vue.script.js","names":["$slots"],"sources":["../../../../src/components/Content/Schema/SchemaPropertyHeading.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { isDefined } from '@scalar/helpers/array/is-defined'\nimport type { WorkspaceEventBus } from '@scalar/workspace-store/events'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport {\n  isArraySchema,\n  isNumberSchema,\n  isStringSchema,\n} from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\nimport { computed, toRef } from 'vue'\n\nimport { Badge } from '@/components/Badge'\nimport LinkButton from '@/components/Content/Schema/LinkButton.vue'\nimport ScreenReader from '@/components/ScreenReader.vue'\nimport { useLocalization } from '@/features/localization'\n\nimport { getSchemaType } from './helpers/get-schema-type'\nimport {\n  isModelLinkable,\n  type ModelLinkOptions,\n} from './helpers/is-model-linkable'\nimport { getModelNameFromSchema } from './helpers/schema-name'\nimport RenderString from './RenderString.vue'\nimport SchemaPropertyDefault from './SchemaPropertyDefault.vue'\nimport SchemaPropertyDetail from './SchemaPropertyDetail.vue'\nimport SchemaPropertyExamples from './SchemaPropertyExamples.vue'\n\nconst props = withDefaults(\n  defineProps<{\n    value: SchemaObject | undefined\n    enum?: boolean\n    isDiscriminator?: boolean\n    required?: boolean\n    additional?: boolean\n    withExamples?: boolean\n    hideModelNames?: boolean\n    /**\n     * Config for deciding whether a model name links to the models section. When the section or\n     * the referenced model is hidden there is nothing to scroll to, so the name renders as plain text.\n     */\n    modelLinkOptions?: ModelLinkOptions\n    /** When the schema was resolved from a $ref, pass the ref name so it displays as e.g. \"Data\" instead of \"object\". */\n    modelName?: string | null\n    /** Resolved propertyNames schema, used to surface key constraints like `format` for additional properties. */\n    propertyNames?: SchemaObject\n    eventBus?: WorkspaceEventBus | null\n  }>(),\n  {\n    isDiscriminator: false,\n    required: false,\n    withExamples: true,\n    hideModelNames: false,\n    eventBus: null,\n  },\n)\nconst { translate } = useLocalization()\n\n// Convert to reactive refs for composables\nconst valueRef = toRef(props, 'value')\n\nconst constValue = computed(() => {\n  if (!valueRef.value) {\n    return undefined\n  }\n\n  const schema = valueRef.value\n\n  // Direct const value\n  if (schema.const !== undefined) {\n    return schema.const\n  }\n\n  // Single-item enum acts as const\n  if (schema.enum?.length === 1) {\n    return schema.enum[0]\n  }\n\n  // Check items for const values (for arrays)\n  if (isArraySchema(schema) && schema.items) {\n    const items = resolve.schema(schema.items)\n\n    if (isDefined(items.const)) {\n      return items.const\n    }\n\n    if (items.enum?.length === 1) {\n      return items.enum[0]\n    }\n  }\n\n  return undefined\n})\n\ntype ValidationProperty = {\n  key: string\n  value: string | number\n  prefix?: string\n  code?: boolean\n  truncate?: boolean\n}\n\n/**\n * Constraints that live on a leaf (string or number) schema: length, pattern,\n * format and numeric ranges. Extracted so they can be surfaced for a primitive\n * schema as well as for a primitive array's items, which are not rendered on\n * their own. See https://github.com/scalar/scalar/issues/9690\n */\nconst getLeafConstraints = (schema: SchemaObject) => {\n  const properties: ValidationProperty[] = []\n\n  if (isStringSchema(schema)) {\n    if (schema.minLength) {\n      properties.push({\n        key: 'min-length',\n        prefix: `${translate('common.minLength')}: `,\n        value: schema.minLength,\n      })\n    }\n\n    if (schema.maxLength) {\n      properties.push({\n        key: 'max-length',\n        prefix: `${translate('common.maxLength')}: `,\n        value: schema.maxLength,\n      })\n    }\n\n    if (schema.pattern) {\n      properties.push({\n        key: 'pattern',\n        value: schema.pattern,\n        code: true,\n        truncate: true,\n      })\n    }\n  }\n\n  if ((isStringSchema(schema) || isNumberSchema(schema)) && schema.format) {\n    properties.push({\n      key: 'format',\n      value: schema.format,\n      truncate: true,\n    })\n  }\n\n  if (isNumberSchema(schema)) {\n    if (isDefined(schema.exclusiveMinimum)) {\n      properties.push({\n        key: 'exclusive-minimum',\n        prefix: `${translate('common.greaterThan')}: `,\n        value: schema.exclusiveMinimum,\n      })\n    }\n\n    if (isDefined(schema.minimum)) {\n      properties.push({\n        key: 'minimum',\n        prefix: `${translate('common.min')}: `,\n        value: schema.minimum,\n      })\n    }\n\n    if (isDefined(schema.exclusiveMaximum)) {\n      properties.push({\n        key: 'exclusive-maximum',\n        prefix: `${translate('common.lessThan')}: `,\n        value: schema.exclusiveMaximum,\n      })\n    }\n\n    if (isDefined(schema.maximum)) {\n      properties.push({\n        key: 'maximum',\n        prefix: `${translate('common.max')}: `,\n        value: schema.maximum,\n      })\n    }\n\n    if (isDefined(schema.multipleOf)) {\n      properties.push({\n        key: 'multiple-of',\n        prefix: `${translate('common.multipleOf')}: `,\n        value: schema.multipleOf,\n      })\n    }\n  }\n\n  return properties\n}\n\nconst validationProperties = computed(() => {\n  if (!valueRef.value) {\n    return []\n  }\n\n  const schema = valueRef.value\n  const properties: ValidationProperty[] = []\n\n  // Array validation properties\n  if (isArraySchema(schema)) {\n    if (schema.minItems || schema.maxItems) {\n      properties.push({\n        key: 'array-range',\n        value: `${schema.minItems || ''}…${schema.maxItems || ''}`,\n      })\n    }\n\n    // Unique items\n    if (schema.uniqueItems) {\n      properties.push({\n        key: 'unique-items',\n        value: `${translate('common.unique')}!`,\n      })\n    }\n  }\n\n  properties.push(...getLeafConstraints(schema))\n\n  // Primitive array items carry their own constraints (e.g. an array of `uuid`\n  // strings) but are not rendered separately, so surface them here.\n  if (isArraySchema(schema) && schema.items) {\n    properties.push(...getLeafConstraints(resolve.schema(schema.items)))\n  }\n\n  return properties\n})\n\n/** Link data for navigating to the referenced model in the sidebar. */\nconst modelLink = computed(() => {\n  if (!props.value) {\n    return null\n  }\n\n  if (props.hideModelNames) {\n    return null\n  }\n\n  if (props.modelName) {\n    return { schemaKey: props.modelName, label: props.modelName }\n  }\n\n  const modelName = getModelNameFromSchema(props.value)\n  if (modelName) {\n    return { schemaKey: modelName.schemaKey, label: modelName.label }\n  }\n\n  if (isArraySchema(props.value) && props.value.items) {\n    const itemName = getModelNameFromSchema(props.value.items)\n    return itemName\n      ? { schemaKey: itemName.schemaKey, label: `${itemName.label}[]` }\n      : null\n  }\n\n  return null\n})\n\n/** Whether the model name links to the models section, or renders as plain text. */\nconst modelLinkable = computed(() =>\n  isModelLinkable(modelLink.value?.schemaKey, props.modelLinkOptions ?? {}),\n)\n\n/** Check if we should show the type information */\nconst shouldShowType = computed(() => {\n  if (!props.value || !('type' in props.value)) {\n    return false\n  }\n\n  // Always show type for arrays, even when items have const values\n  if (props.value.type === 'array') {\n    return true\n  }\n\n  // For non-arrays, only show if no const value at the schema level\n  return !constValue.value\n})\n\n/** Get the display type */\nconst displayType = computed(() => {\n  if (!props.value) {\n    return ''\n  }\n  return getSchemaType(props.value)\n})\n\n/**\n * Type and format of the property keys, derived from the propertyNames schema.\n *\n * For a map keyed by UUIDs this renders e.g. \"string · uuid\" so the key\n * constraints are not lost. Returns undefined when there is nothing to show.\n */\nconst propertyNamesDetail = computed(() => {\n  const schema = props.propertyNames\n  if (!schema) {\n    return undefined\n  }\n\n  const parts = [getSchemaType(schema)]\n  if ('format' in schema && typeof schema.format === 'string') {\n    parts.push(schema.format)\n  }\n\n  const detail = parts.filter(Boolean).join(' · ')\n  return detail.length > 0 ? detail : undefined\n})\n\nconst exampleValue = computed(() => {\n  // Treat only `undefined` as \"not set\" — `null` is a valid example value on a nullable schema.\n  if (\n    props.value &&\n    'example' in props.value &&\n    props.value.example !== undefined\n  ) {\n    return props.value.example\n  }\n\n  if (props.value && isArraySchema(props.value)) {\n    const itemsSchema = resolve.schema(props.value.items)\n    if (\n      itemsSchema &&\n      'example' in itemsSchema &&\n      itemsSchema.example !== undefined\n    ) {\n      return itemsSchema.example\n    }\n  }\n\n  return undefined\n})\n</script>\n<template>\n  <div class=\"property-heading\">\n    <div\n      v-if=\"$slots.name\"\n      class=\"property-name\"\n      :class=\"{ deprecated: props.value?.deprecated }\">\n      <slot name=\"name\" />\n    </div>\n    <div\n      v-if=\"props.isDiscriminator\"\n      class=\"property-discriminator\">\n      {{ translate('common.discriminator') }}\n    </div>\n    <template v-if=\"props.value\">\n      <!-- Type information -->\n      <SchemaPropertyDetail\n        v-if=\"shouldShowType\"\n        truncate>\n        <ScreenReader>{{ translate('common.type') }}:</ScreenReader>\n        {{ displayType }}\n        <template v-if=\"modelLink\">\n          ·\n          <LinkButton\n            v-if=\"props.eventBus && modelLink.schemaKey && modelLinkable\"\n            @click=\"\n              props.eventBus.emit('scroll-to:model-by-name', {\n                name: modelLink.schemaKey,\n              })\n            \">\n            {{ modelLink.label }}\n          </LinkButton>\n          <template v-else>{{ modelLink.label }}</template>\n        </template>\n      </SchemaPropertyDetail>\n\n      <!-- Key constraints from propertyNames (e.g. \"keys: string · uuid\") -->\n      <SchemaPropertyDetail\n        v-if=\"propertyNamesDetail\"\n        truncate>\n        <template #prefix>{{ translate('common.keys') }}:</template>\n        {{ propertyNamesDetail }}\n      </SchemaPropertyDetail>\n\n      <!-- Dynamic validation properties from composable -->\n      <SchemaPropertyDetail\n        v-for=\"property in validationProperties\"\n        :key=\"property.key\"\n        :code=\"property.code\"\n        :truncate=\"property.truncate\">\n        <ScreenReader v-if=\"property.key === 'format'\">\n          {{ translate('common.format') }}:\n        </ScreenReader>\n        <ScreenReader v-else-if=\"property.key === 'pattern'\">\n          {{ translate('common.pattern') }}:\n        </ScreenReader>\n        <template\n          v-if=\"property.prefix\"\n          #prefix>\n          {{ property.prefix }}\n        </template>\n        {{ property.value }}\n      </SchemaPropertyDetail>\n\n      <!-- Enum indicator -->\n      <SchemaPropertyDetail v-if=\"props.enum\">\n        {{ translate('common.enum') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.additional\"\n      class=\"property-additional\">\n      <template v-if=\"props.value?.['x-additionalPropertiesName']\">\n        {{ props.value['x-additionalPropertiesName'] }}\n      </template>\n      <template v-else>{{ translate('common.additionalProperties') }}</template>\n    </div>\n    <div\n      v-if=\"props.value?.deprecated\"\n      class=\"property-deprecated\">\n      <Badge>{{ translate('common.deprecated') }}</Badge>\n    </div>\n    <!-- Don't use `isDefined` here, we want to show `const` when the value is `null` -->\n    <div\n      v-if=\"constValue !== undefined\"\n      class=\"property-const\">\n      <SchemaPropertyDetail truncate>\n        <template #prefix>{{ translate('common.const') }}: </template>\n        <RenderString :value=\"constValue\" />\n      </SchemaPropertyDetail>\n    </div>\n    <template v-else>\n      <!-- Shows only when a composition is used (so props.value?.type is undefined) -->\n      <SchemaPropertyDetail v-if=\"(props.value as any)?.nullable === true\">\n        {{ translate('common.nullable') }}\n      </SchemaPropertyDetail>\n    </template>\n    <div\n      v-if=\"props.value?.writeOnly\"\n      class=\"property-write-only\">\n      {{ translate('common.writeOnly') }}\n    </div>\n    <div\n      v-else-if=\"props.value?.readOnly\"\n      class=\"property-read-only\">\n      {{ translate('common.readOnly') }}\n    </div>\n    <div\n      v-if=\"props.required\"\n      class=\"property-required\">\n      {{ translate('common.required') }}\n    </div>\n    <SchemaPropertyDefault :value=\"props.value?.default\" />\n    <SchemaPropertyExamples\n      v-if=\"props.withExamples\"\n      :example=\"exampleValue\"\n      :examples=\"props.value?.examples\" />\n  </div>\n</template>\n<style scoped>\n.property-heading {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: baseline;\n  row-gap: 9px;\n  white-space: nowrap;\n}\n\n.property-heading:has(+ .children),\n.property-heading:has(+ .property-rule) {\n  margin-bottom: 9px;\n}\n\n.property-heading > * {\n  margin-right: 9px;\n}\n\n.property-heading:last-child {\n  margin-right: 0;\n}\n\n.property-heading > .property-detail:not(:last-of-type) {\n  margin-right: 0;\n}\n\n.property-name {\n  max-width: 100%;\n  font-family: var(--scalar-font-code);\n  font-weight: var(--scalar-bold);\n  font-size: var(--scalar-font-size-4);\n  white-space: normal;\n  overflow-wrap: break-word;\n}\n\n.property-additional {\n  font-family: var(--scalar-font-code);\n}\n\n.property-required,\n.property-optional {\n  color: var(--scalar-color-2);\n}\n\n.property-required {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-orange);\n}\n\n.property-read-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-blue);\n}\n\n.property-write-only {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-green);\n}\n\n.property-discriminator {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-purple);\n}\n\n.property-detail {\n  font-size: var(--scalar-mini);\n  color: var(--scalar-color-2);\n  display: flex;\n  align-items: center;\n\n  min-width: 0;\n}\n\n.property-const {\n  color: var(--scalar-color-1);\n}\n\n.deprecated {\n  text-decoration: line-through;\n}\n</style>\n"],"mappings":"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"}

package/dist/components/Content/Schema/helpers/get-ref-name.d.ts

@@ -6,4 +6,20 @@
  * @example SchemaName from #/components/schemas/SchemaName
  */
 export declare const getRefName: (ref: string) => string | null | undefined;
+/**
+ * Gets the models-section key for a `$ref`, but only when the ref actually
+ * targets `#/components/schemas/`.
+ *
+ * The models index used for navigation is built exclusively from
+ * `components.schemas`, so a ref into any other bucket (`parameters`,
+ * `responses`, ...) or an external file (`./other.yaml#/Foo`) has no navigable
+ * target. Returning `null` for those keeps the name visible as plain text while
+ * avoiding a dead link.
+ *
+ * @example
+ * getSchemaRefName('#/components/schemas/Planet') // 'Planet'
+ * getSchemaRefName('#/components/parameters/Planet') // null
+ * getSchemaRefName('./planets.yaml#/Planet') // null
+ */
+export declare const getSchemaRefName: (ref: string) => string | null;
 //# sourceMappingURL=get-ref-name.d.ts.map

package/dist/components/Content/Schema/helpers/get-ref-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-ref-name.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/get-ref-name.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,8BAWrC,CAAA"}
+{"version":3,"file":"get-ref-name.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/get-ref-name.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,8BAWrC,CAAA;AASD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAWvD,CAAA"}

package/dist/components/Content/Schema/helpers/get-ref-name.js

@@ -13,7 +13,34 @@ var getRefName = (ref) => {
 	if (match) return match[1];
 	return null;
 };
+/**
+* Matches a local reference that points at `#/components/schemas/<name>` and
+* captures the schema name. Intentionally strict: only refs that resolve to a
+* navigable model in `components.schemas` should be linkable.
+*/
+var COMPONENTS_SCHEMAS_REF = /^#\/components\/schemas\/([^/]+)$/;
+/**
+* Gets the models-section key for a `$ref`, but only when the ref actually
+* targets `#/components/schemas/`.
+*
+* The models index used for navigation is built exclusively from
+* `components.schemas`, so a ref into any other bucket (`parameters`,
+* `responses`, ...) or an external file (`./other.yaml#/Foo`) has no navigable
+* target. Returning `null` for those keeps the name visible as plain text while
+* avoiding a dead link.
+*
+* @example
+* getSchemaRefName('#/components/schemas/Planet') // 'Planet'
+* getSchemaRefName('#/components/parameters/Planet') // null
+* getSchemaRefName('./planets.yaml#/Planet') // null
+*/
+var getSchemaRefName = (ref) => {
+	if (!ref) return null;
+	const match = ref.match(COMPONENTS_SCHEMAS_REF);
+	if (match?.[1]) return decodeURIComponent(match[1]);
+	return null;
+};
 //#endregion
-export { getRefName };
+export { getRefName, getSchemaRefName };
 
 //# sourceMappingURL=get-ref-name.js.map

package/dist/components/Content/Schema/helpers/get-ref-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-ref-name.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/get-ref-name.ts"],"sourcesContent":["import { REGEX } from '@scalar/helpers/regex/regex-helpers'\n\n/**\n * Gets the \"name\" of the schema from the ref path\n * TODO: this will change so fix it when the new refs are out\n * Then add tests\n *\n * @example SchemaName from #/components/schemas/SchemaName\n */\nexport const getRefName = (ref: string) => {\n  if (!ref) {\n    return null\n  }\n\n  const match = ref.match(REGEX.REF_NAME)\n  if (match) {\n    return match[1]\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;;;AASA,IAAa,cAAc,QAAgB;CACzC,IAAI,CAAC,KACH,OAAO;CAGT,MAAM,QAAQ,IAAI,MAAM,MAAM,QAAQ;CACtC,IAAI,OACF,OAAO,MAAM;CAGf,OAAO;AACT"}
+{"version":3,"file":"get-ref-name.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/get-ref-name.ts"],"sourcesContent":["import { REGEX } from '@scalar/helpers/regex/regex-helpers'\n\n/**\n * Gets the \"name\" of the schema from the ref path\n * TODO: this will change so fix it when the new refs are out\n * Then add tests\n *\n * @example SchemaName from #/components/schemas/SchemaName\n */\nexport const getRefName = (ref: string) => {\n  if (!ref) {\n    return null\n  }\n\n  const match = ref.match(REGEX.REF_NAME)\n  if (match) {\n    return match[1]\n  }\n\n  return null\n}\n\n/**\n * Matches a local reference that points at `#/components/schemas/<name>` and\n * captures the schema name. Intentionally strict: only refs that resolve to a\n * navigable model in `components.schemas` should be linkable.\n */\nconst COMPONENTS_SCHEMAS_REF = /^#\\/components\\/schemas\\/([^/]+)$/\n\n/**\n * Gets the models-section key for a `$ref`, but only when the ref actually\n * targets `#/components/schemas/`.\n *\n * The models index used for navigation is built exclusively from\n * `components.schemas`, so a ref into any other bucket (`parameters`,\n * `responses`, ...) or an external file (`./other.yaml#/Foo`) has no navigable\n * target. Returning `null` for those keeps the name visible as plain text while\n * avoiding a dead link.\n *\n * @example\n * getSchemaRefName('#/components/schemas/Planet') // 'Planet'\n * getSchemaRefName('#/components/parameters/Planet') // null\n * getSchemaRefName('./planets.yaml#/Planet') // null\n */\nexport const getSchemaRefName = (ref: string): string | null => {\n  if (!ref) {\n    return null\n  }\n\n  const match = ref.match(COMPONENTS_SCHEMAS_REF)\n  if (match?.[1]) {\n    return decodeURIComponent(match[1])\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;;;AASA,IAAa,cAAc,QAAgB;CACzC,IAAI,CAAC,KACH,OAAO;CAGT,MAAM,QAAQ,IAAI,MAAM,MAAM,QAAQ;CACtC,IAAI,OACF,OAAO,MAAM;CAGf,OAAO;AACT;;;;;;AAOA,IAAM,yBAAyB;;;;;;;;;;;;;;;;AAiB/B,IAAa,oBAAoB,QAA+B;CAC9D,IAAI,CAAC,KACH,OAAO;CAGT,MAAM,QAAQ,IAAI,MAAM,sBAAsB;CAC9C,IAAI,QAAQ,IACV,OAAO,mBAAmB,MAAM,EAAE;CAGpC,OAAO;AACT"}

package/dist/components/Content/Schema/helpers/is-model-linkable.d.ts

@@ -0,0 +1,15 @@
+import type { SchemaOptions } from '../types';
+/** The slice of schema options needed to decide whether a model name renders as a link. */
+export type ModelLinkOptions = Pick<SchemaOptions, 'hideModels' | 'document'>;
+/**
+ * A model name normally links to its entry in the models section. It should render as plain
+ * text when there is nothing to scroll to:
+ *
+ * - the whole models section is hidden via `hideModels`, or
+ * - the referenced schema itself is hidden via `x-internal` / `x-scalar-ignore`.
+ *
+ * The hidden check mirrors how the sidebar decides which schemas to drop (see `traverseSchemas`),
+ * so the link only shows when the model actually exists in the models section.
+ */
+export declare const isModelLinkable: (schemaKey: string | null | undefined, { hideModels, document }: ModelLinkOptions) => boolean;
+//# sourceMappingURL=is-model-linkable.d.ts.map

package/dist/components/Content/Schema/helpers/is-model-linkable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-model-linkable.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/is-model-linkable.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,UAAU,CAAC,CAAA;AAE7E;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,0BAA0B,gBAAgB,KACzC,OAQF,CAAA"}

package/dist/components/Content/Schema/helpers/is-model-linkable.js

@@ -0,0 +1,22 @@
+import { getResolvedRef, mergeSiblingReferences } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { isHidden } from "@scalar/workspace-store/helpers/is-hidden";
+//#region src/components/Content/Schema/helpers/is-model-linkable.ts
+/**
+* A model name normally links to its entry in the models section. It should render as plain
+* text when there is nothing to scroll to:
+*
+* - the whole models section is hidden via `hideModels`, or
+* - the referenced schema itself is hidden via `x-internal` / `x-scalar-ignore`.
+*
+* The hidden check mirrors how the sidebar decides which schemas to drop (see `traverseSchemas`),
+* so the link only shows when the model actually exists in the models section.
+*/
+var isModelLinkable = (schemaKey, { hideModels, document }) => {
+	if (!schemaKey || hideModels) return false;
+	const schema = document?.components?.schemas?.[schemaKey];
+	return !isHidden(getResolvedRef(schema, mergeSiblingReferences));
+};
+//#endregion
+export { isModelLinkable };
+
+//# sourceMappingURL=is-model-linkable.js.map

package/dist/components/Content/Schema/helpers/is-model-linkable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-model-linkable.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/is-model-linkable.ts"],"sourcesContent":["import { getResolvedRef, mergeSiblingReferences } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { isHidden } from '@scalar/workspace-store/helpers/is-hidden'\n\nimport type { SchemaOptions } from '../types'\n\n/** The slice of schema options needed to decide whether a model name renders as a link. */\nexport type ModelLinkOptions = Pick<SchemaOptions, 'hideModels' | 'document'>\n\n/**\n * A model name normally links to its entry in the models section. It should render as plain\n * text when there is nothing to scroll to:\n *\n * - the whole models section is hidden via `hideModels`, or\n * - the referenced schema itself is hidden via `x-internal` / `x-scalar-ignore`.\n *\n * The hidden check mirrors how the sidebar decides which schemas to drop (see `traverseSchemas`),\n * so the link only shows when the model actually exists in the models section.\n */\nexport const isModelLinkable = (\n  schemaKey: string | null | undefined,\n  { hideModels, document }: ModelLinkOptions,\n): boolean => {\n  if (!schemaKey || hideModels) {\n    return false\n  }\n\n  const schema = document?.components?.schemas?.[schemaKey]\n\n  return !isHidden(getResolvedRef(schema, mergeSiblingReferences))\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,IAAa,mBACX,WACA,EAAE,YAAY,eACF;CACZ,IAAI,CAAC,aAAa,YAChB,OAAO;CAGT,MAAM,SAAS,UAAU,YAAY,UAAU;CAE/C,OAAO,CAAC,SAAS,eAAe,QAAQ,sBAAsB,CAAC;AACjE"}

package/dist/components/Content/Schema/helpers/schema-name.d.ts

@@ -5,7 +5,12 @@ import type { SchemaObject, SchemaReferenceType } from '@scalar/workspace-store/
  * Handles $ref, title, name, type, and schema dictionary lookup
  */
 export declare const getModelNameFromSchema: (schemaOrRef: SchemaObject | SchemaReferenceType<SchemaObject>) => {
-    /** The key in components.schemas (extracted from $ref), used for sidebar navigation. */
+    /**
+     * The key in `components.schemas` (extracted from `$ref`), used for sidebar
+     * navigation. Only set when the `$ref` actually targets
+     * `#/components/schemas/`; `null` for refs into other component buckets or
+     * external files, so those never render a dead link.
+     */
     schemaKey: string | null;
     /** The human-readable name to display (schema.title, schema.name, or ref key). */
     label: string;

package/dist/components/Content/Schema/helpers/schema-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-name.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/schema-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8DAA8D,CAAA;AAIrH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAC5D;IACD,wFAAwF;IACxF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,IAwBH,CAAA"}
+{"version":3,"file":"schema-name.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Schema/helpers/schema-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8DAA8D,CAAA;AAIrH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,KAC5D;IACD;;;;;OAKG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,IA4BH,CAAA"}

package/dist/components/Content/Schema/helpers/schema-name.js

@@ -1,4 +1,4 @@
-import { getRefName } from "./get-ref-name.js";
+import { getRefName, getSchemaRefName } from "./get-ref-name.js";
 import { resolve } from "@scalar/workspace-store/resolve";
 //#region src/components/Content/Schema/helpers/schema-name.ts
 /**
@@ -9,7 +9,7 @@ import { resolve } from "@scalar/workspace-store/resolve";
 var getModelNameFromSchema = (schemaOrRef) => {
 	if (!schemaOrRef) return null;
 	const schema = resolve.schema(schemaOrRef);
-	const schemaKey = "$ref" in schemaOrRef ? getRefName(schemaOrRef.$ref) ?? null : null;
+	const schemaKey = "$ref" in schemaOrRef ? getSchemaRefName(schemaOrRef.$ref) : null;
 	if (schema.title) return {
 		schemaKey,
 		label: schema.title
@@ -19,9 +19,10 @@ var getModelNameFromSchema = (schemaOrRef) => {
 		label: schema.name
 	};
 	if ("$ref" in schemaOrRef) {
-		if (schemaKey) return {
+		const label = getRefName(schemaOrRef.$ref);
+		if (label) return {
 			schemaKey,
-			label: schemaKey
+			label
 		};
 	}
 	return null;

package/dist/components/Content/Schema/helpers/schema-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-name.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/schema-name.ts"],"sourcesContent":["import { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject, SchemaReferenceType } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { getRefName } from './get-ref-name'\n\n/**\n * Extract schema name from various schema formats\n *\n * Handles $ref, title, name, type, and schema dictionary lookup\n */\nexport const getModelNameFromSchema = (\n  schemaOrRef: SchemaObject | SchemaReferenceType<SchemaObject>,\n): {\n  /** The key in components.schemas (extracted from $ref), used for sidebar navigation. */\n  schemaKey: string | null\n  /** The human-readable name to display (schema.title, schema.name, or ref key). */\n  label: string\n} | null => {\n  if (!schemaOrRef) {\n    return null\n  }\n\n  const schema = resolve.schema(schemaOrRef)\n\n  const schemaKey = '$ref' in schemaOrRef ? (getRefName(schemaOrRef.$ref) ?? null) : null\n\n  if (schema.title) {\n    return { schemaKey, label: schema.title }\n  }\n\n  if (schema.name) {\n    return { schemaKey, label: schema.name }\n  }\n\n  if ('$ref' in schemaOrRef) {\n    if (schemaKey) {\n      return { schemaKey, label: schemaKey }\n    }\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,0BACX,gBAMU;CACV,IAAI,CAAC,aACH,OAAO;CAGT,MAAM,SAAS,QAAQ,OAAO,WAAW;CAEzC,MAAM,YAAY,UAAU,cAAe,WAAW,YAAY,IAAI,KAAK,OAAQ;CAEnF,IAAI,OAAO,OACT,OAAO;EAAE;EAAW,OAAO,OAAO;CAAM;CAG1C,IAAI,OAAO,MACT,OAAO;EAAE;EAAW,OAAO,OAAO;CAAK;CAGzC,IAAI,UAAU;MACR,WACF,OAAO;GAAE;GAAW,OAAO;EAAU;CAAA;CAIzC,OAAO;AACT"}
+{"version":3,"file":"schema-name.js","names":[],"sources":["../../../../../src/components/Content/Schema/helpers/schema-name.ts"],"sourcesContent":["import { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject, SchemaReferenceType } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\nimport { getRefName, getSchemaRefName } from './get-ref-name'\n\n/**\n * Extract schema name from various schema formats\n *\n * Handles $ref, title, name, type, and schema dictionary lookup\n */\nexport const getModelNameFromSchema = (\n  schemaOrRef: SchemaObject | SchemaReferenceType<SchemaObject>,\n): {\n  /**\n   * The key in `components.schemas` (extracted from `$ref`), used for sidebar\n   * navigation. Only set when the `$ref` actually targets\n   * `#/components/schemas/`; `null` for refs into other component buckets or\n   * external files, so those never render a dead link.\n   */\n  schemaKey: string | null\n  /** The human-readable name to display (schema.title, schema.name, or ref key). */\n  label: string\n} | null => {\n  if (!schemaOrRef) {\n    return null\n  }\n\n  const schema = resolve.schema(schemaOrRef)\n\n  // Only refs into `#/components/schemas/` are navigable in the models section.\n  const schemaKey = '$ref' in schemaOrRef ? getSchemaRefName(schemaOrRef.$ref) : null\n\n  if (schema.title) {\n    return { schemaKey, label: schema.title }\n  }\n\n  if (schema.name) {\n    return { schemaKey, label: schema.name }\n  }\n\n  if ('$ref' in schemaOrRef) {\n    // Fall back to the last ref segment as a display label, even for\n    // non-schema refs. The name still shows, it just is not a link.\n    const label = getRefName(schemaOrRef.$ref)\n    if (label) {\n      return { schemaKey, label }\n    }\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,0BACX,gBAWU;CACV,IAAI,CAAC,aACH,OAAO;CAGT,MAAM,SAAS,QAAQ,OAAO,WAAW;CAGzC,MAAM,YAAY,UAAU,cAAc,iBAAiB,YAAY,IAAI,IAAI;CAE/E,IAAI,OAAO,OACT,OAAO;EAAE;EAAW,OAAO,OAAO;CAAM;CAG1C,IAAI,OAAO,MACT,OAAO;EAAE;EAAW,OAAO,OAAO;CAAK;CAGzC,IAAI,UAAU,aAAa;EAGzB,MAAM,QAAQ,WAAW,YAAY,IAAI;EACzC,IAAI,OACF,OAAO;GAAE;GAAW;EAAM;CAE9B;CAEA,OAAO;AACT"}

package/dist/components/Content/Schema/types.d.ts

@@ -16,6 +16,13 @@ export type SchemaOptions = {
     orderRequiredPropertiesFirst?: ApiReferenceConfiguration['orderRequiredPropertiesFirst'];
     /** Expand all nested schema properties by default while keeping the toggle available */
     expandAllSchemaProperties?: ApiReferenceConfiguration['expandAllSchemaProperties'];
+    /**
+     * Whether the models section is hidden.
+     *
+     * Model names stay visible, but there is no models section to scroll to, so they
+     * render as plain text instead of links.
+     */
+    hideModels?: ApiReferenceConfiguration['hideModels'];
     /**
      * The document the schema belongs to.
      *