@hjmds/design-contracts 1.30.0 → 1.31.0

package/dist/showcase.js.map

@@ -1 +1 @@
-{"version":3,"file":"showcase.js","sourceRoot":"","sources":["../src/showcase.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  componentCatalog,\n  getComponentSurfaceStatus,\n  type ComponentCatalogEntry,\n  type ComponentStatus,\n  type ComponentSurfaceMaturity,\n  type ComponentSurfaceStatus,\n} from \"./catalog.js\";\nimport type { BehaviorName } from \"./behaviors.js\";\nimport type { ResolvedTheme } from \"./colors.js\";\nimport type {\n  DesignSystemDirection,\n  DesignSystemEnvironmentInput,\n  DesignSystemTextScale,\n} from \"./design-system-provider.js\";\n\nexport type ShowcaseTheme = ResolvedTheme;\nexport type ShowcaseDirection = DesignSystemDirection;\n/** Closed fixture subset of the Provider's continuous text-scale signal. */\nexport type ShowcaseTextScale = 1 | 1.5 | 2;\nexport type ShowcaseMotionPreference = \"full\" | \"reduced\";\n\nexport type ShowcaseEnvironment = Readonly<{\n  id: \"default\" | \"dark\" | \"large-text\" | \"rtl\" | \"reduced-motion\";\n  label: string;\n  theme: ShowcaseTheme;\n  direction: ShowcaseDirection;\n  textScale: ShowcaseTextScale;\n  motion: ShowcaseMotionPreference;\n}>;\n\n/**\n * A small, deliberate environment matrix catches the high-risk differences\n * without multiplying every story into an unreadable Cartesian product.\n */\nexport const showcaseEnvironmentMatrix = [\n  {\n    id: \"default\",\n    label: \"밝게 · 왼쪽→오른쪽 · 100%\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"dark\",\n    label: \"어둡게 · 왼쪽→오른쪽 · 100%\",\n    theme: \"dark\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"large-text\",\n    label: \"밝게 · 왼쪽→오른쪽 · 200%\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 2,\n    motion: \"full\",\n  },\n  {\n    id: \"rtl\",\n    label: \"밝게 · 오른쪽→왼쪽 · 100%\",\n    theme: \"light\",\n    direction: \"rtl\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"reduced-motion\",\n    label: \"밝게 · 왼쪽→오른쪽 · 동작 줄이기\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"reduced\",\n  },\n] as const satisfies readonly ShowcaseEnvironment[];\n\n/** Bridges documentation fixtures to the same environment contract products consume. */\nexport function getShowcaseEnvironmentInput(\n  environment: ShowcaseEnvironment,\n): DesignSystemEnvironmentInput {\n  const textScale: DesignSystemTextScale = environment.textScale;\n  return {\n    theme: environment.theme,\n    direction: environment.direction,\n    textScale,\n    reducedMotion: environment.motion === \"reduced\",\n  };\n}\n\nexport type ShowcaseScenarioId =\n  | \"contract\"\n  | \"default\"\n  | \"dark\"\n  | \"long-copy\"\n  | \"large-text\"\n  | \"rtl\"\n  | \"reduced-motion\"\n  | \"accessibility\"\n  | \"keyboard\"\n  | \"native-actions\"\n  | \"platform-parity\";\n\nexport type ShowcaseSurface = \"contract\" | \"web\" | \"native\";\n\nexport type ShowcaseScenario = Readonly<{\n  id: ShowcaseScenarioId;\n  label: string;\n  description: string;\n}>;\n\nexport const showcaseScenarios = [\n  {\n    id: \"contract\",\n    label: \"계약\",\n    description: \"구조·기본값·지원 축·플랫폼과 성숙도가 보인다.\",\n  },\n  {\n    id: \"default\",\n    label: \"기본\",\n    description: \"제품 설정을 덮어쓰지 않고 recipe 기본값으로 보통 상태를 그린다.\",\n  },\n  {\n    id: \"dark\",\n    label: \"어두운 테마\",\n    description: \"어두운 테마에서도 의미 색이 읽힌다.\",\n  },\n  {\n    id: \"long-copy\",\n    label: \"긴 문구\",\n    description: \"긴 한국어·영어 문구가 잘리거나 의미를 숨기지 않고 줄바꿈된다.\",\n  },\n  {\n    id: \"large-text\",\n    label: \"200% 글자\",\n    description: \"글자를 200%까지 키워도 필요한 정보가 잘리지 않는다.\",\n  },\n  {\n    id: \"rtl\",\n    label: \"오른쪽→왼쪽\",\n    description: \"논리적 시작·끝 배치와 방향 아이콘이 올바르게 뒤집힌다.\",\n  },\n  {\n    id: \"reduced-motion\",\n    label: \"동작 줄이기\",\n    description: \"움직임이 recipe의 동작 줄이기 대체 표현을 따른다.\",\n  },\n  {\n    id: \"accessibility\",\n    label: \"접근성\",\n    description: \"이름·상태·관계·대비·터치 영역을 확인할 수 있다.\",\n  },\n  {\n    id: \"keyboard\",\n    label: \"키보드\",\n    description: \"포커스 순서와 문서화한 키보드 동작을 상호작용 테스트로 실행한다.\",\n  },\n  {\n    id: \"native-actions\",\n    label: \"앱 동작\",\n    description: \"접근성 동작과 그 상태 변화를 Native renderer에서 실행한다.\",\n  },\n  {\n    id: \"platform-parity\",\n    label: \"웹·앱 동등성\",\n    description: \"각 renderer가 플랫폼 고유 동작을 쓰면서 같은 의도를 유지한다.\",\n  },\n] as const satisfies readonly ShowcaseScenario[];\n\nconst plannedRequirements = [\"contract\"] as const satisfies readonly ShowcaseScenarioId[];\nconst rendererRequirements = [\n  \"default\",\n  \"dark\",\n  \"long-copy\",\n  \"large-text\",\n  \"rtl\",\n  \"reduced-motion\",\n  \"accessibility\",\n] as const satisfies readonly Exclude<ShowcaseScenarioId, \"contract\">[];\n\nexport type ShowcaseComponentEntry = Readonly<{\n  storyId: string;\n  component: ComponentCatalogEntry;\n  /** Resolved Web/Native renderer maturity, including legacy catalog inputs. */\n  surfaceMaturity: ComponentSurfaceMaturity;\n  requirements: readonly ShowcaseEvidenceRequirement[];\n  requiredScenarios: readonly ShowcaseScenarioId[];\n  requiredSurfaces: readonly ShowcaseSurface[];\n}>;\n\nexport type ShowcaseEvidenceRequirement = Readonly<{\n  surface: ShowcaseSurface;\n  scenarios: readonly ShowcaseScenarioId[];\n}>;\n\nexport type ShowcaseEvidenceEntry = Readonly<{\n  storyId: string;\n  surface: ShowcaseSurface;\n  scenarios: readonly ShowcaseScenarioId[];\n}>;\n\nexport type ShowcaseCoverageEntry = Readonly<{\n  storyId: string;\n  component: ComponentCatalogEntry;\n  missingEvidence: readonly Readonly<{\n    surface: ShowcaseSurface;\n    scenario: ShowcaseScenarioId;\n  }>[];\n  missingSurfaces: readonly ShowcaseSurface[];\n  missingScenarios: readonly ShowcaseScenarioId[];\n  complete: boolean;\n}>;\n\nexport function getShowcaseStoryId(entry: ComponentCatalogEntry): string {\n  const slug = entry.name\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .replace(/[^a-zA-Z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .toLowerCase();\n  return `${entry.category}/${slug}`;\n}\n\nexport function getRequiredShowcaseScenarios(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseScenarioId[] {\n  const activeSurfaces = ([\"web\", \"native\"] as const).filter((surface) =>\n    isRendererMaturity(getComponentSurfaceStatus(entry, surface)),\n  );\n  if (activeSurfaces.length === 0) return plannedRequirements;\n\n  const rendererScenarios = [...new Set(activeSurfaces.flatMap((surface) =>\n    getRendererShowcaseScenarios(entry, surface),\n  ))];\n  return [\n    \"contract\",\n    ...rendererScenarios,\n  ];\n}\n\nfunction isRendererMaturity(\n  status: ComponentSurfaceStatus,\n): status is Extract<ComponentStatus, \"stable\" | \"beta\"> {\n  return status === \"stable\" || status === \"beta\";\n}\n\n// These outputs expose no consumer-authored visible prose; default and accessibility proofs remain required.\nconst textlessComponentNames: ReadonlySet<string> = new Set([\n  \"Icon\", \"IconButton\", \"Skeleton\", \"Spinner\", \"ThinkingOrb\", \"Divider\",\n  \"Avatar\", \"Asset\", \"CounterBadge\", \"Image\", \"VisuallyHidden\", \"Pagination\",\n  // These own form/range behavior but no long-form text slot; their child fields\n  // and calendar cells own their copy, so duplicating that proof here misattributes it.\n  \"Form\", \"DateRangePicker\",\n  // 2026-10-18: Chart's category/series labels are short identifiers and its text alternative is a hidden\n  // description for assistive technology; ImageChoiceGroup tiles carry accessible names, not visible copy.\n  // Neither has a long-form text slot, so the long-copy proof would measure a product caption, not the component.\n  \"Chart\", \"ImageChoiceGroup\",\n]);\n\n// These behaviors expose no interaction on either rendered surface.\nconst semanticOnlyBehaviors: ReadonlySet<NonNullable<ComponentCatalogEntry[\"behavior\"]>> = new Set([\n  \"top\", \"authScreen\", \"heading\", \"bottomInfo\", \"nativePlatform\", \"textFormat\", \"asset\",\n]);\n\n// Keep surface capability lookup local: importing behaviorRegistry here would pull every\n// behavior contract into the lightweight showcase/evidence entry points. The alternative was\n// importing that registry; showcase.test.ts cross-checks these names against it to prevent drift.\nconst webKeyboardBehaviors: ReadonlySet<BehaviorName> = new Set([\n  \"agreement\", \"alertDialog\", \"anchor\", \"authProviderButton\", \"bottomNavigation\", \"breadcrumb\",\n  \"calendar\", \"carousel\", \"chart\", \"checkbox\", \"checkboxGroup\", \"chip\", \"collapsible\", \"combobox\",\n  \"commandPalette\", \"contextMenu\", \"dataTable\", \"datePicker\", \"dateRange\", \"dialog\",\n  \"disclosureGroup\", \"field\", \"filePicker\", \"floatingActionButton\", \"form\", \"layout\", \"link\",\n  \"loadMore\", \"menu\", \"menubar\", \"numberField\", \"otpField\", \"pagination\", \"passwordField\",\n  \"popover\", \"radioGroup\", \"searchField\", \"segmentedControl\", \"select\", \"sheet\", \"sidePanel\",\n  \"sidebar\", \"skipNav\", \"slider\", \"splitter\", \"switch\", \"tabs\", \"tagsInput\", \"toast\",\n  \"toggleGroup\", \"tooltip\", \"tour\", \"transferList\", \"tree\", \"uploadItem\",\n]);\nconst nativeActionBehaviors: ReadonlySet<BehaviorName> = new Set([\n  \"agreement\", \"alertDialog\", \"authProviderButton\", \"bottomNavigation\", \"calendar\", \"carousel\",\n  \"checkbox\", \"checkboxGroup\", \"chip\", \"collapsible\", \"combobox\", \"datePicker\", \"dateRange\",\n  \"dialog\", \"disclosureGroup\", \"field\", \"filePicker\", \"floatingActionButton\", \"form\", \"link\",\n  \"loadMore\", \"menu\", \"numberField\", \"otpField\", \"passwordField\", \"radioGroup\", \"searchField\",\n  \"segmentedControl\", \"select\", \"sheet\", \"slider\", \"switch\", \"tabs\", \"tagsInput\", \"toast\",\n  \"toggleGroup\", \"transferList\", \"uploadItem\",\n  // 2026-10-14: Native DataTable sort/row actions and chart adjustable stepping.\n  \"dataTable\", \"chart\",\n  // 2026-10-18: Pagination became shared with a Native beta renderer (1bae9c1a); its page buttons declare the\n  // activate action, so the Native surface owns a native-actions requirement like every other action behavior.\n  \"pagination\",\n]);\n\nfunction getRendererShowcaseScenarios(\n  entry: ComponentCatalogEntry,\n  surface?: \"web\" | \"native\",\n): readonly Exclude<ShowcaseScenarioId, \"contract\">[] {\n  const requirements: Exclude<ShowcaseScenarioId, \"contract\">[] = rendererRequirements.filter(\n    (scenario) => scenario !== \"long-copy\" || !textlessComponentNames.has(entry.name),\n  );\n  // ColorPicker composes native form controls; its text commit/escape behavior still needs real keyboard proof.\n  if (entry.name === \"ColorPicker\" && surface === \"web\") requirements.push(\"keyboard\");\n  if (entry.behavior && !semanticOnlyBehaviors.has(entry.behavior)) {\n    // Web owns DOM key bindings; Native declares host accessibility actions instead, so Pressable tests must not claim physical keyboard proof.\n    if (surface === \"web\" && webKeyboardBehaviors.has(entry.behavior)) requirements.push(\"keyboard\");\n    if (surface === \"native\" && nativeActionBehaviors.has(entry.behavior)) requirements.push(\"native-actions\");\n  }\n  return requirements;\n}\n\nexport function getRequiredShowcaseSurfaces(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseSurface[] {\n  return getRequiredShowcaseEvidence(entry).map(({ surface }) => surface);\n}\n\nexport function getRequiredShowcaseEvidence(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseEvidenceRequirement[] {\n  const requirements: ShowcaseEvidenceRequirement[] = [\n    { surface: \"contract\", scenarios: [\"contract\"] },\n  ];\n  const activeSurfaces = ([\"web\", \"native\"] as const).filter((surface) =>\n    isRendererMaturity(getComponentSurfaceStatus(entry, surface)),\n  );\n  for (const surface of activeSurfaces) {\n    requirements.push({ surface, scenarios: getRendererShowcaseScenarios(entry, surface) });\n  }\n  return requirements;\n}\n\nexport function createShowcaseManifest(\n  entries: readonly ComponentCatalogEntry[] = componentCatalog,\n): readonly ShowcaseComponentEntry[] {\n  return entries.map((component) => ({\n    storyId: getShowcaseStoryId(component),\n    component,\n    surfaceMaturity: {\n      web: getComponentSurfaceStatus(component, \"web\"),\n      native: getComponentSurfaceStatus(component, \"native\"),\n    },\n    requirements: getRequiredShowcaseEvidence(component),\n    requiredScenarios: getRequiredShowcaseScenarios(component),\n    requiredSurfaces: getRequiredShowcaseSurfaces(component),\n  }));\n}\n\nexport const showcaseManifest = createShowcaseManifest();\n\nexport function createShowcaseCoverage(\n  evidence: readonly ShowcaseEvidenceEntry[],\n  manifest: readonly ShowcaseComponentEntry[] = showcaseManifest,\n): readonly ShowcaseCoverageEntry[] {\n  return manifest.map(({ storyId, component, requirements }) => {\n    const componentEvidence = evidence.filter((entry) => entry.storyId === storyId);\n    const missingEvidence = requirements.flatMap(({ surface, scenarios }) =>\n      scenarios\n        .filter(\n          (scenario) =>\n            !componentEvidence.some(\n              (entry) => entry.surface === surface && entry.scenarios.includes(scenario),\n            ),\n        )\n        .map((scenario) => ({ surface, scenario })),\n    );\n    const missingSurfaces = [...new Set(missingEvidence.map(({ surface }) => surface))];\n    const missingScenarios = [...new Set(missingEvidence.map(({ scenario }) => scenario))];\n    return {\n      storyId,\n      component,\n      missingEvidence,\n      missingSurfaces,\n      missingScenarios,\n      complete: missingSurfaces.length === 0 && missingScenarios.length === 0,\n    };\n  });\n}\n\nexport function assertShowcaseCoverage(\n  evidence: readonly ShowcaseEvidenceEntry[],\n  manifest: readonly ShowcaseComponentEntry[] = showcaseManifest,\n): void {\n  const missing = createShowcaseCoverage(evidence, manifest).filter(({ complete }) => !complete);\n  if (missing.length === 0) return;\n  const details = missing\n    .map(({ storyId, missingEvidence }) =>\n      `${storyId} (${missingEvidence.map(({ surface, scenario }) => `${surface}/${scenario}`).join(\", \") || \"none\"})`,\n    )\n    .join(\"\\n\");\n  throw new Error(`Showcase evidence is incomplete:\\n${details}`);\n}\n\nexport function summarizeShowcaseMaturity(\n  entries: readonly ComponentCatalogEntry[] = componentCatalog,\n): Readonly<Record<ComponentStatus, number>> {\n  return entries.reduce<Record<ComponentStatus, number>>(\n    (summary, entry) => {\n      summary[entry.status] += 1;\n      return summary;\n    },\n    { stable: 0, beta: 0, planned: 0, deprecated: 0 },\n  );\n}\n"]}
+{"version":3,"file":"showcase.js","sourceRoot":"","sources":["../src/showcase.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  componentCatalog,\n  getComponentSurfaceStatus,\n  type ComponentCatalogEntry,\n  type ComponentStatus,\n  type ComponentSurfaceMaturity,\n  type ComponentSurfaceStatus,\n} from \"./catalog.js\";\nimport type { BehaviorName } from \"./behaviors.js\";\nimport type { ResolvedTheme } from \"./colors.js\";\nimport type {\n  DesignSystemDirection,\n  DesignSystemEnvironmentInput,\n  DesignSystemTextScale,\n} from \"./design-system-provider.js\";\n\nexport type ShowcaseTheme = ResolvedTheme;\nexport type ShowcaseDirection = DesignSystemDirection;\n/** Closed fixture subset of the Provider's continuous text-scale signal. */\nexport type ShowcaseTextScale = 1 | 1.5 | 2;\nexport type ShowcaseMotionPreference = \"full\" | \"reduced\";\n\nexport type ShowcaseEnvironment = Readonly<{\n  id: \"default\" | \"dark\" | \"large-text\" | \"rtl\" | \"reduced-motion\";\n  label: string;\n  theme: ShowcaseTheme;\n  direction: ShowcaseDirection;\n  textScale: ShowcaseTextScale;\n  motion: ShowcaseMotionPreference;\n}>;\n\n/**\n * A small, deliberate environment matrix catches the high-risk differences\n * without multiplying every story into an unreadable Cartesian product.\n */\nexport const showcaseEnvironmentMatrix = [\n  {\n    id: \"default\",\n    label: \"밝게 · 왼쪽→오른쪽 · 100%\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"dark\",\n    label: \"어둡게 · 왼쪽→오른쪽 · 100%\",\n    theme: \"dark\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"large-text\",\n    label: \"밝게 · 왼쪽→오른쪽 · 200%\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 2,\n    motion: \"full\",\n  },\n  {\n    id: \"rtl\",\n    label: \"밝게 · 오른쪽→왼쪽 · 100%\",\n    theme: \"light\",\n    direction: \"rtl\",\n    textScale: 1,\n    motion: \"full\",\n  },\n  {\n    id: \"reduced-motion\",\n    label: \"밝게 · 왼쪽→오른쪽 · 동작 줄이기\",\n    theme: \"light\",\n    direction: \"ltr\",\n    textScale: 1,\n    motion: \"reduced\",\n  },\n] as const satisfies readonly ShowcaseEnvironment[];\n\n/** Bridges documentation fixtures to the same environment contract products consume. */\nexport function getShowcaseEnvironmentInput(\n  environment: ShowcaseEnvironment,\n): DesignSystemEnvironmentInput {\n  const textScale: DesignSystemTextScale = environment.textScale;\n  return {\n    theme: environment.theme,\n    direction: environment.direction,\n    textScale,\n    reducedMotion: environment.motion === \"reduced\",\n  };\n}\n\nexport type ShowcaseScenarioId =\n  | \"contract\"\n  | \"default\"\n  | \"dark\"\n  | \"long-copy\"\n  | \"large-text\"\n  | \"rtl\"\n  | \"reduced-motion\"\n  | \"accessibility\"\n  | \"keyboard\"\n  | \"native-actions\"\n  | \"platform-parity\";\n\nexport type ShowcaseSurface = \"contract\" | \"web\" | \"native\";\n\nexport type ShowcaseScenario = Readonly<{\n  id: ShowcaseScenarioId;\n  label: string;\n  description: string;\n}>;\n\nexport const showcaseScenarios = [\n  {\n    id: \"contract\",\n    label: \"계약\",\n    description: \"구조·기본값·지원 축·플랫폼과 성숙도가 보인다.\",\n  },\n  {\n    id: \"default\",\n    label: \"기본\",\n    description: \"제품 설정을 덮어쓰지 않고 recipe 기본값으로 보통 상태를 그린다.\",\n  },\n  {\n    id: \"dark\",\n    label: \"어두운 테마\",\n    description: \"어두운 테마에서도 의미 색이 읽힌다.\",\n  },\n  {\n    id: \"long-copy\",\n    label: \"긴 문구\",\n    description: \"긴 한국어·영어 문구가 잘리거나 의미를 숨기지 않고 줄바꿈된다.\",\n  },\n  {\n    id: \"large-text\",\n    label: \"200% 글자\",\n    description: \"글자를 200%까지 키워도 필요한 정보가 잘리지 않는다.\",\n  },\n  {\n    id: \"rtl\",\n    label: \"오른쪽→왼쪽\",\n    description: \"논리적 시작·끝 배치와 방향 아이콘이 올바르게 뒤집힌다.\",\n  },\n  {\n    id: \"reduced-motion\",\n    label: \"동작 줄이기\",\n    description: \"움직임이 recipe의 동작 줄이기 대체 표현을 따른다.\",\n  },\n  {\n    id: \"accessibility\",\n    label: \"접근성\",\n    description: \"이름·상태·관계·대비·터치 영역을 확인할 수 있다.\",\n  },\n  {\n    id: \"keyboard\",\n    label: \"키보드\",\n    description: \"포커스 순서와 문서화한 키보드 동작을 상호작용 테스트로 실행한다.\",\n  },\n  {\n    id: \"native-actions\",\n    label: \"앱 동작\",\n    description: \"접근성 동작과 그 상태 변화를 Native renderer에서 실행한다.\",\n  },\n  {\n    id: \"platform-parity\",\n    label: \"웹·앱 동등성\",\n    description: \"각 renderer가 플랫폼 고유 동작을 쓰면서 같은 의도를 유지한다.\",\n  },\n] as const satisfies readonly ShowcaseScenario[];\n\nconst plannedRequirements = [\"contract\"] as const satisfies readonly ShowcaseScenarioId[];\nconst rendererRequirements = [\n  \"default\",\n  \"dark\",\n  \"long-copy\",\n  \"large-text\",\n  \"rtl\",\n  \"reduced-motion\",\n  \"accessibility\",\n] as const satisfies readonly Exclude<ShowcaseScenarioId, \"contract\">[];\n\nexport type ShowcaseComponentEntry = Readonly<{\n  storyId: string;\n  component: ComponentCatalogEntry;\n  /** Resolved Web/Native renderer maturity, including legacy catalog inputs. */\n  surfaceMaturity: ComponentSurfaceMaturity;\n  requirements: readonly ShowcaseEvidenceRequirement[];\n  requiredScenarios: readonly ShowcaseScenarioId[];\n  requiredSurfaces: readonly ShowcaseSurface[];\n}>;\n\nexport type ShowcaseEvidenceRequirement = Readonly<{\n  surface: ShowcaseSurface;\n  scenarios: readonly ShowcaseScenarioId[];\n}>;\n\nexport type ShowcaseEvidenceEntry = Readonly<{\n  storyId: string;\n  surface: ShowcaseSurface;\n  scenarios: readonly ShowcaseScenarioId[];\n}>;\n\nexport type ShowcaseCoverageEntry = Readonly<{\n  storyId: string;\n  component: ComponentCatalogEntry;\n  missingEvidence: readonly Readonly<{\n    surface: ShowcaseSurface;\n    scenario: ShowcaseScenarioId;\n  }>[];\n  missingSurfaces: readonly ShowcaseSurface[];\n  missingScenarios: readonly ShowcaseScenarioId[];\n  complete: boolean;\n}>;\n\nexport function getShowcaseStoryId(entry: ComponentCatalogEntry): string {\n  const slug = entry.name\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .replace(/[^a-zA-Z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .toLowerCase();\n  return `${entry.category}/${slug}`;\n}\n\nexport function getRequiredShowcaseScenarios(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseScenarioId[] {\n  const activeSurfaces = ([\"web\", \"native\"] as const).filter((surface) =>\n    isRendererMaturity(getComponentSurfaceStatus(entry, surface)),\n  );\n  if (activeSurfaces.length === 0) return plannedRequirements;\n\n  const rendererScenarios = [...new Set(activeSurfaces.flatMap((surface) =>\n    getRendererShowcaseScenarios(entry, surface),\n  ))];\n  return [\n    \"contract\",\n    ...rendererScenarios,\n  ];\n}\n\nfunction isRendererMaturity(\n  status: ComponentSurfaceStatus,\n): status is Extract<ComponentStatus, \"stable\" | \"beta\"> {\n  return status === \"stable\" || status === \"beta\";\n}\n\n// These outputs expose no consumer-authored visible prose; default and accessibility proofs remain required.\nconst textlessComponentNames: ReadonlySet<string> = new Set([\n  \"Icon\", \"IconButton\", \"Skeleton\", \"Spinner\", \"ThinkingOrb\", \"Divider\",\n  \"Avatar\", \"Asset\", \"CounterBadge\", \"Image\", \"VisuallyHidden\", \"Pagination\",\n  // These own form/range behavior but no long-form text slot; their child fields\n  // and calendar cells own their copy, so duplicating that proof here misattributes it.\n  \"Form\", \"DateRangePicker\",\n  // 2026-10-18: Chart's category/series labels are short identifiers and its text alternative is a hidden\n  // description for assistive technology; ImageChoiceGroup tiles carry accessible names, not visible copy.\n  // Neither has a long-form text slot, so the long-copy proof would measure a product caption, not the component.\n  \"Chart\", \"ImageChoiceGroup\",\n  // 1.31: TypingIndicator's label is announced only (the bubble shows dots) and PageIndicator's names are the\n  // group and dot accessible names, like Pagination; neither draws product prose to wrap.\n  \"TypingIndicator\", \"PageIndicator\",\n]);\n\n// These behaviors expose no interaction on either rendered surface.\nconst semanticOnlyBehaviors: ReadonlySet<NonNullable<ComponentCatalogEntry[\"behavior\"]>> = new Set([\n  \"top\", \"authScreen\", \"heading\", \"bottomInfo\", \"nativePlatform\", \"textFormat\", \"asset\",\n]);\n\n// Keep surface capability lookup local: importing behaviorRegistry here would pull every\n// behavior contract into the lightweight showcase/evidence entry points. The alternative was\n// importing that registry; showcase.test.ts cross-checks these names against it to prevent drift.\nconst webKeyboardBehaviors: ReadonlySet<BehaviorName> = new Set([\n  \"agreement\", \"alertDialog\", \"anchor\", \"authProviderButton\", \"bottomNavigation\", \"breadcrumb\",\n  \"calendar\", \"carousel\", \"chart\", \"checkbox\", \"checkboxGroup\", \"chip\", \"collapsible\", \"combobox\",\n  \"commandPalette\", \"contextMenu\", \"dataTable\", \"datePicker\", \"dateRange\", \"dialog\",\n  \"disclosureGroup\", \"field\", \"filePicker\", \"floatingActionButton\", \"form\", \"layout\", \"link\",\n  \"loadMore\", \"menu\", \"menubar\", \"numberField\", \"otpField\", \"pagination\", \"passwordField\",\n  \"popover\", \"radioGroup\", \"searchField\", \"segmentedControl\", \"select\", \"sheet\", \"sidePanel\",\n  \"sidebar\", \"skipNav\", \"slider\", \"splitter\", \"switch\", \"tabs\", \"tagsInput\", \"toast\",\n  \"toggleGroup\", \"tooltip\", \"tour\", \"transferList\", \"tree\", \"uploadItem\",\n]);\nconst nativeActionBehaviors: ReadonlySet<BehaviorName> = new Set([\n  \"agreement\", \"alertDialog\", \"authProviderButton\", \"bottomNavigation\", \"calendar\", \"carousel\",\n  \"checkbox\", \"checkboxGroup\", \"chip\", \"collapsible\", \"combobox\", \"datePicker\", \"dateRange\",\n  \"dialog\", \"disclosureGroup\", \"field\", \"filePicker\", \"floatingActionButton\", \"form\", \"link\",\n  \"loadMore\", \"menu\", \"numberField\", \"otpField\", \"passwordField\", \"radioGroup\", \"searchField\",\n  \"segmentedControl\", \"select\", \"sheet\", \"slider\", \"switch\", \"tabs\", \"tagsInput\", \"toast\",\n  \"toggleGroup\", \"transferList\", \"uploadItem\",\n  // 2026-10-14: Native DataTable sort/row actions and chart adjustable stepping.\n  \"dataTable\", \"chart\",\n  // 2026-10-18: Pagination became shared with a Native beta renderer (1bae9c1a); its page buttons declare the\n  // activate action, so the Native surface owns a native-actions requirement like every other action behavior.\n  \"pagination\",\n]);\n\nfunction getRendererShowcaseScenarios(\n  entry: ComponentCatalogEntry,\n  surface?: \"web\" | \"native\",\n): readonly Exclude<ShowcaseScenarioId, \"contract\">[] {\n  const requirements: Exclude<ShowcaseScenarioId, \"contract\">[] = rendererRequirements.filter(\n    (scenario) => scenario !== \"long-copy\" || !textlessComponentNames.has(entry.name),\n  );\n  // ColorPicker composes native form controls; its text commit/escape behavior still needs real keyboard proof.\n  if (entry.name === \"ColorPicker\" && surface === \"web\") requirements.push(\"keyboard\");\n  if (entry.behavior && !semanticOnlyBehaviors.has(entry.behavior)) {\n    // Web owns DOM key bindings; Native declares host accessibility actions instead, so Pressable tests must not claim physical keyboard proof.\n    if (surface === \"web\" && webKeyboardBehaviors.has(entry.behavior)) requirements.push(\"keyboard\");\n    if (surface === \"native\" && nativeActionBehaviors.has(entry.behavior)) requirements.push(\"native-actions\");\n  }\n  return requirements;\n}\n\nexport function getRequiredShowcaseSurfaces(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseSurface[] {\n  return getRequiredShowcaseEvidence(entry).map(({ surface }) => surface);\n}\n\nexport function getRequiredShowcaseEvidence(\n  entry: ComponentCatalogEntry,\n): readonly ShowcaseEvidenceRequirement[] {\n  const requirements: ShowcaseEvidenceRequirement[] = [\n    { surface: \"contract\", scenarios: [\"contract\"] },\n  ];\n  const activeSurfaces = ([\"web\", \"native\"] as const).filter((surface) =>\n    isRendererMaturity(getComponentSurfaceStatus(entry, surface)),\n  );\n  for (const surface of activeSurfaces) {\n    requirements.push({ surface, scenarios: getRendererShowcaseScenarios(entry, surface) });\n  }\n  return requirements;\n}\n\nexport function createShowcaseManifest(\n  entries: readonly ComponentCatalogEntry[] = componentCatalog,\n): readonly ShowcaseComponentEntry[] {\n  return entries.map((component) => ({\n    storyId: getShowcaseStoryId(component),\n    component,\n    surfaceMaturity: {\n      web: getComponentSurfaceStatus(component, \"web\"),\n      native: getComponentSurfaceStatus(component, \"native\"),\n    },\n    requirements: getRequiredShowcaseEvidence(component),\n    requiredScenarios: getRequiredShowcaseScenarios(component),\n    requiredSurfaces: getRequiredShowcaseSurfaces(component),\n  }));\n}\n\nexport const showcaseManifest = createShowcaseManifest();\n\nexport function createShowcaseCoverage(\n  evidence: readonly ShowcaseEvidenceEntry[],\n  manifest: readonly ShowcaseComponentEntry[] = showcaseManifest,\n): readonly ShowcaseCoverageEntry[] {\n  return manifest.map(({ storyId, component, requirements }) => {\n    const componentEvidence = evidence.filter((entry) => entry.storyId === storyId);\n    const missingEvidence = requirements.flatMap(({ surface, scenarios }) =>\n      scenarios\n        .filter(\n          (scenario) =>\n            !componentEvidence.some(\n              (entry) => entry.surface === surface && entry.scenarios.includes(scenario),\n            ),\n        )\n        .map((scenario) => ({ surface, scenario })),\n    );\n    const missingSurfaces = [...new Set(missingEvidence.map(({ surface }) => surface))];\n    const missingScenarios = [...new Set(missingEvidence.map(({ scenario }) => scenario))];\n    return {\n      storyId,\n      component,\n      missingEvidence,\n      missingSurfaces,\n      missingScenarios,\n      complete: missingSurfaces.length === 0 && missingScenarios.length === 0,\n    };\n  });\n}\n\nexport function assertShowcaseCoverage(\n  evidence: readonly ShowcaseEvidenceEntry[],\n  manifest: readonly ShowcaseComponentEntry[] = showcaseManifest,\n): void {\n  const missing = createShowcaseCoverage(evidence, manifest).filter(({ complete }) => !complete);\n  if (missing.length === 0) return;\n  const details = missing\n    .map(({ storyId, missingEvidence }) =>\n      `${storyId} (${missingEvidence.map(({ surface, scenario }) => `${surface}/${scenario}`).join(\", \") || \"none\"})`,\n    )\n    .join(\"\\n\");\n  throw new Error(`Showcase evidence is incomplete:\\n${details}`);\n}\n\nexport function summarizeShowcaseMaturity(\n  entries: readonly ComponentCatalogEntry[] = componentCatalog,\n): Readonly<Record<ComponentStatus, number>> {\n  return entries.reduce<Record<ComponentStatus, number>>(\n    (summary, entry) => {\n      summary[entry.status] += 1;\n      return summary;\n    },\n    { stable: 0, beta: 0, planned: 0, deprecated: 0 },\n  );\n}\n"]}

package/dist/steps.d.ts

@@ -1,9 +1,9 @@
 /**
- * Ant Design Steps' full surface (navigation/clickable jump, dot type, custom
- * per-item icon, vertical orientation) is intentionally not reproduced. Both
- * known consumers (Yajalal onboarding, BurnTok sign-up) are single-cursor,
- * horizontal, back-button-driven wizards; see docs/steps.md for the per-axis
- * rationale.
+ * Ant Design Steps' full surface (navigation jump, dot type, custom per-item
+ * icon, vertical orientation) is intentionally not reproduced. Steps stay a
+ * single-cursor, horizontal wizard; the only press is returning to a step
+ * before the cursor (2026-10-18, spint compose rebuilt its own rail for it).
+ * See docs/steps.md for the per-axis rationale.
  */
 export type StepStatus = "pending" | "current" | "complete" | "error";
 /** Only the cursor step can be "current" or "error"; every other step is derived. */
@@ -16,8 +16,8 @@ export type StepItemDescriptor<Id extends string = string> = Readonly<{
 /**
  * A single stable cursor (`currentStepId`) is the source of truth instead of a
  * per-item status array, so "two current steps" or "a completed step past an
- * unresolved error" cannot be represented. Clickable jump is out of scope, so
- * the flow is always linear relative to the cursor.
+ * unresolved error" cannot be represented. Pressing only returns to a step
+ * before the cursor, so the flow stays linear relative to the cursor.
  */
 export type StepsDescriptor<Id extends string = string> = Readonly<{
     steps: readonly StepItemDescriptor<Id>[];
@@ -53,6 +53,11 @@ export type ResolvedStepDescriptor<Id extends string = string> = StepItemDescrip
     accessibleName: string;
     /** Supplementary status announcement (Web aria-describedby text / RN accessibilityHint). */
     statusLabel: string;
+    /**
+     * Strictly before the cursor. Only these steps become buttons when the product supplies a step press handler:
+     * jumping forward would skip validation, and the cursor step is where the user already is (2026-10-18).
+     */
+    revisitable: boolean;
 }>;
 export type ResolveStepsOptions = Readonly<{
     statusLabels: StepsStatusLabels;
@@ -192,5 +197,9 @@ export declare const stepsRecipe: {
             alpha?: number;
         }>;
     };
+    /** A revisitable step is one button over its marker and label; the shared touch minimum applies to the whole cell. */
+    readonly press: {
+        readonly minTouchTarget: 44;
+    };
 };
 //# sourceMappingURL=steps.d.ts.map

package/dist/steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtE,qFAAqF;AAErF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;AAErF,MAAM,MAAM,kBAAkB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IACpE,EAAE,EAAE,EAAE,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IACjE,KAAK,EAAE,SAAS,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;IACzC,aAAa,EAAE,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC,CAAC,CAAC;AAEH,eAAO,MAAM,aAAa;;CAE4C,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,IAAI,EAAE,uBAAuB,KAC1B,MAAM,CAAC;AAEZ,MAAM,MAAM,sBAAsB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAC3D,kBAAkB,CAAC,EAAE,CAAC,GACpB,QAAQ,CAAC;IACP,MAAM,EAAE,UAAU,CAAC;IACnB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEP,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,YAAY,EAAE,iBAAiB,CAAC;IAChC,qBAAqB,EAAE,0BAA0B,CAAC;CACnD,CAAC,CAAC;AAQH,wBAAgB,0BAA0B,CAAC,EAAE,SAAS,MAAM,EAC1D,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,GAC3B,IAAI,CASN;AAED,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,MAAM,EACvD,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,GAC9B,IAAI,CA2BN;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAUzE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,SAAS,MAAM,EACtD,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,EAC/B,OAAO,EAAE,mBAAmB,GAC3B,SAAS,sBAAsB,CAAC,EAAE,CAAC,EAAE,CAyCvC;AAED,eAAO,MAAM,WAAW;;;;;;;QAepB,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE1F,CAAC"}
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"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"}

package/dist/steps.js

@@ -1,4 +1,4 @@
-import { fontWeight, glyph, spacing, stroke } from "./foundations.js";
+import { control, fontWeight, glyph, spacing, stroke } from "./foundations.js";
 import { semanticColors } from "./semantic-colors.js";
 export const stepsDefaults = {
     currentStepStatus: "current",
@@ -92,6 +92,7 @@ export function resolveStepsDescriptor(descriptor, options) {
             total,
             accessibleName,
             statusLabel: options.statusLabels[status],
+            revisitable: index < cursorIndex,
         };
     });
 }
@@ -157,5 +158,9 @@ export const stepsRecipe = {
         textVariant: "caption",
         color: semanticColors.content.secondary,
     },
+    /** A revisitable step is one button over its marker and label; the shared touch minimum applies to the whole cell. */
+    press: {
+        minTouchTarget: control.minTouchTarget,
+    },
 };
 //# sourceMappingURL=steps.js.map

package/dist/steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiCtD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,EAAE,SAAS;CACwC,CAAC;AA0CvE,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,oBAAoB,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAA4B;IAE5B,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC7E,CAAC;IACD,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAA+B;IAE/B,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAM,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,4BAA4B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,mDAAmD,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,IACE,UAAU,CAAC,iBAAiB,KAAK,SAAS;QAC1C,UAAU,CAAC,iBAAiB,KAAK,SAAS;QAC1C,UAAU,CAAC,iBAAiB,KAAK,OAAO;QACxC,UAAU,CAAC,iBAAiB,KAAK,UAAU,EAC3C,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,wCAAwC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CAAC,sBAAsB,GAAG,oBAAoB,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAA+B,EAC/B,OAA4B;IAE5B,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACpC,yBAAyB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,OAAO,OAAO,CAAC,qBAAqB,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,iBAAiB,GACrB,UAAU,CAAC,iBAAiB,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAClE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;IACtC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAC5C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,aAAa,CAC/C,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,MAAM,GACV,KAAK,GAAG,WAAW;YACjB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,KAAK,GAAG,WAAW;gBACnB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,iBAAiB,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC;QAC3B,MAAM,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;YACnD,QAAQ;YACR,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,SAAS,CACjB,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,IAAI;YACP,MAAM;YACN,QAAQ;YACR,KAAK;YACL,cAAc;YACd,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE;QACL,MAAM;QACN,MAAM;QACN,WAAW;QACX,QAAQ;QACR,WAAW;QACX,OAAO;QACP,aAAa;KACL;IACV,GAAG,EAAE,OAAO,CAAC,EAAE;IACf,SAAS,EAAE;QACT,IAAI,EAAE,KAAK,CAAC,EAAE;QACd,WAAW,EAAE,MAAM,CAAC,OAAO;QAC3B,iBAAiB,EAAE,MAAM,CAAC,MAAM;QAChC,uFAAuF;QACvF,KAAK,EAAE;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,OAAO;SACf;QACD,MAAM,EAAE;YACN,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO;YACtC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK;YACrC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM;YAChD,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM;SAC7C;QACD,UAAU,EAAE;YACV,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe;YACzD,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe;SACtD;QACD,OAAO,EAAE;YACP,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS;YACzC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK;YACrC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU;YACpD,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU;SACjD;KACF;IACD,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC,OAAO;QACtB,IAAI,EAAE;YACJ,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK;YACrC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO;SACzC;KACF;IACD,KAAK,EAAE;QACL,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,KAAK,EAAE;YACL,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS;YACzC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO;YACvC,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO;YACxC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU;SACjD;KACF;IACD,WAAW,EAAE;QACX,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS;KACxC;CA0BF,CAAC","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { FontWeightValue, TextVariant } from \"./foundations.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { fontWeight, glyph, spacing, stroke } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * Ant Design Steps' full surface (navigation/clickable jump, dot type, custom\n * per-item icon, vertical orientation) is intentionally not reproduced. Both\n * known consumers (Yajalal onboarding, BurnTok sign-up) are single-cursor,\n * horizontal, back-button-driven wizards; see docs/steps.md for the per-axis\n * rationale.\n */\nexport type StepStatus = \"pending\" | \"current\" | \"complete\" | \"error\";\n\n/** Only the cursor step can be \"current\" or \"error\"; every other step is derived. */\n// \"complete\" marks a finished flow; see docs/steps.md.\nexport type StepCursorStatus = Extract<StepStatus, \"current\" | \"error\" | \"complete\">;\n\nexport type StepItemDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  label: string;\n  description?: string;\n}>;\n\n/**\n * A single stable cursor (`currentStepId`) is the source of truth instead of a\n * per-item status array, so \"two current steps\" or \"a completed step past an\n * unresolved error\" cannot be represented. Clickable jump is out of scope, so\n * the flow is always linear relative to the cursor.\n */\nexport type StepsDescriptor<Id extends string = string> = Readonly<{\n  steps: readonly StepItemDescriptor<Id>[];\n  currentStepId: Id;\n  currentStepStatus?: StepCursorStatus;\n}>;\n\nexport const stepsDefaults = {\n  currentStepStatus: \"current\",\n} as const satisfies Readonly<{ currentStepStatus: StepCursorStatus }>;\n\nexport type StepsStatusLabels = Readonly<{\n  pending: string;\n  current: string;\n  complete: string;\n  error: string;\n}>;\n\nexport type StepsAccessibleNameInfo = Readonly<{\n  position: number;\n  total: number;\n  label: string;\n}>;\n\n/**\n * Products own the exact phrase order and counter-word grammar (Korean\n * \"3단계 중 2단계\" does not translate structurally to English \"step 2 of 3\"),\n * so the resolver invokes this composer instead of assembling copy itself.\n */\nexport type ComposeStepsAccessibleName = (\n  info: StepsAccessibleNameInfo,\n) => string;\n\nexport type ResolvedStepDescriptor<Id extends string = string> =\n  StepItemDescriptor<Id> &\n    Readonly<{\n      status: StepStatus;\n      /** 1-indexed so position and label both preserve reading order for renderers. */\n      position: number;\n      total: number;\n      /** Primary accessible name: order + label. Never says status by itself. */\n      accessibleName: string;\n      /** Supplementary status announcement (Web aria-describedby text / RN accessibilityHint). */\n      statusLabel: string;\n    }>;\n\nexport type ResolveStepsOptions = Readonly<{\n  statusLabels: StepsStatusLabels;\n  composeAccessibleName: ComposeStepsAccessibleName;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`Steps ${field} must not be empty`);\n  }\n}\n\nexport function validateStepItemDescriptor<Id extends string>(\n  step: StepItemDescriptor<Id>,\n): void {\n  assertNonEmpty(step.id, \"item id\");\n  if (step.id !== step.id.trim()) {\n    throw new TypeError(\"Steps item id must not start or end with whitespace\");\n  }\n  assertNonEmpty(step.label, \"item label\");\n  if (step.description !== undefined) {\n    assertNonEmpty(step.description, \"item description\");\n  }\n}\n\nexport function validateStepsDescriptor<Id extends string>(\n  descriptor: StepsDescriptor<Id>,\n): void {\n  if (descriptor.steps.length < 2) {\n    throw new RangeError(\"Steps must contain at least two steps\");\n  }\n  const ids = new Set<Id>();\n  for (const step of descriptor.steps) {\n    validateStepItemDescriptor(step);\n    if (ids.has(step.id)) {\n      throw new TypeError(`Duplicate Steps item id: ${step.id}`);\n    }\n    ids.add(step.id);\n  }\n  if (!ids.has(descriptor.currentStepId)) {\n    throw new RangeError(\n      `Steps currentStepId does not match any step id: ${String(descriptor.currentStepId)}`,\n    );\n  }\n  if (\n    descriptor.currentStepStatus !== undefined &&\n    descriptor.currentStepStatus !== \"current\" &&\n    descriptor.currentStepStatus !== \"error\" &&\n    descriptor.currentStepStatus !== \"complete\"\n  ) {\n    throw new TypeError(\n      `Unsupported Steps currentStepStatus: ${String(descriptor.currentStepStatus)}`,\n    );\n  }\n}\n\nexport function validateStepsStatusLabels(labels: StepsStatusLabels): void {\n  if (labels === null || typeof labels !== \"object\") {\n    throw new TypeError(\"Steps statusLabels must be an object\");\n  }\n  for (const key of [\"pending\", \"current\", \"complete\", \"error\"] as const) {\n    const value = labels[key];\n    if (typeof value !== \"string\" || value.trim().length === 0) {\n      throw new TypeError(`Steps statusLabels.${key} must not be empty`);\n    }\n  }\n}\n\n/** A step is visually and semantically \"reached\" once it is no longer waiting. */\nexport function isStepReached(status: StepStatus): boolean {\n  return status !== \"pending\";\n}\n\n/**\n * Derives every step's status from its position relative to the single\n * cursor, then attaches the order-preserving accessible name and the\n * supplementary status announcement. Throws on a malformed descriptor,\n * labels bag, or composer instead of silently rendering an inconsistent flow.\n */\nexport function resolveStepsDescriptor<Id extends string>(\n  descriptor: StepsDescriptor<Id>,\n  options: ResolveStepsOptions,\n): readonly ResolvedStepDescriptor<Id>[] {\n  validateStepsDescriptor(descriptor);\n  validateStepsStatusLabels(options.statusLabels);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Steps composeAccessibleName must be a function\");\n  }\n\n  const currentStepStatus =\n    descriptor.currentStepStatus ?? stepsDefaults.currentStepStatus;\n  const total = descriptor.steps.length;\n  const cursorIndex = descriptor.steps.findIndex(\n    (step) => step.id === descriptor.currentStepId,\n  );\n\n  return descriptor.steps.map((step, index) => {\n    const status: StepStatus =\n      index < cursorIndex\n        ? \"complete\"\n        : index > cursorIndex\n          ? \"pending\"\n          : currentStepStatus;\n    const position = index + 1;\n    const accessibleName = options.composeAccessibleName({\n      position,\n      total,\n      label: step.label,\n    });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\n        \"Steps composeAccessibleName must return a non-empty string\",\n      );\n    }\n    return {\n      ...step,\n      status,\n      position,\n      total,\n      accessibleName,\n      statusLabel: options.statusLabels[status],\n    };\n  });\n}\n\nexport const stepsRecipe = {\n  slots: [\n    \"root\",\n    \"step\",\n    \"indicator\",\n    \"marker\",\n    \"connector\",\n    \"label\",\n    \"description\",\n  ] as const,\n  gap: spacing.xs,\n  indicator: {\n    size: glyph.md,\n    borderWidth: stroke.default,\n    activeBorderWidth: stroke.strong,\n    /** null means the renderer shows the step's own position number instead of a glyph. */\n    marks: {\n      pending: null,\n      current: null,\n      complete: \"check\",\n      error: \"error\",\n    },\n    border: {\n      pending: semanticColors.border.default,\n      current: semanticColors.content.brand,\n      complete: semanticColors.feedback.success.border,\n      error: semanticColors.feedback.danger.border,\n    },\n    background: {\n      pending: null,\n      current: null,\n      complete: semanticColors.feedback.success.badgeBackground,\n      error: semanticColors.feedback.danger.badgeBackground,\n    },\n    content: {\n      pending: semanticColors.content.secondary,\n      current: semanticColors.content.brand,\n      complete: semanticColors.feedback.success.foreground,\n      error: semanticColors.feedback.danger.foreground,\n    },\n  },\n  connector: {\n    height: stroke.default,\n    tone: {\n      reached: semanticColors.content.brand,\n      unreached: semanticColors.border.default,\n    },\n  },\n  label: {\n    textVariant: \"label\",\n    fontWeight: fontWeight.medium,\n    color: {\n      pending: semanticColors.content.secondary,\n      current: semanticColors.content.primary,\n      complete: semanticColors.content.primary,\n      error: semanticColors.feedback.danger.foreground,\n    },\n  },\n  description: {\n    textVariant: \"caption\",\n    color: semanticColors.content.secondary,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  gap: number;\n  indicator: {\n    size: number;\n    borderWidth: number;\n    activeBorderWidth: number;\n    marks: Record<StepStatus, SemanticIconName | null>;\n    border: Record<StepStatus, ColorReference>;\n    background: Record<StepStatus, ColorReference | null>;\n    content: Record<StepStatus, ColorReference>;\n  };\n  connector: {\n    height: number;\n    tone: Record<\"reached\" | \"unreached\", ColorReference>;\n  };\n  label: {\n    textVariant: TextVariant;\n    fontWeight: FontWeightValue;\n    color: Record<StepStatus, ColorReference>;\n  };\n  description: {\n    textVariant: TextVariant;\n    color: ColorReference;\n  };\n};\n"]}
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../src/steps.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { FontWeightValue, TextVariant } from \"./foundations.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { control, fontWeight, glyph, spacing, stroke } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * Ant Design Steps' full surface (navigation jump, dot type, custom per-item\n * icon, vertical orientation) is intentionally not reproduced. Steps stay a\n * single-cursor, horizontal wizard; the only press is returning to a step\n * before the cursor (2026-10-18, spint compose rebuilt its own rail for it).\n * See docs/steps.md for the per-axis rationale.\n */\nexport type StepStatus = \"pending\" | \"current\" | \"complete\" | \"error\";\n\n/** Only the cursor step can be \"current\" or \"error\"; every other step is derived. */\n// \"complete\" marks a finished flow; see docs/steps.md.\nexport type StepCursorStatus = Extract<StepStatus, \"current\" | \"error\" | \"complete\">;\n\nexport type StepItemDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  label: string;\n  description?: string;\n}>;\n\n/**\n * A single stable cursor (`currentStepId`) is the source of truth instead of a\n * per-item status array, so \"two current steps\" or \"a completed step past an\n * unresolved error\" cannot be represented. Pressing only returns to a step\n * before the cursor, so the flow stays linear relative to the cursor.\n */\nexport type StepsDescriptor<Id extends string = string> = Readonly<{\n  steps: readonly StepItemDescriptor<Id>[];\n  currentStepId: Id;\n  currentStepStatus?: StepCursorStatus;\n}>;\n\nexport const stepsDefaults = {\n  currentStepStatus: \"current\",\n} as const satisfies Readonly<{ currentStepStatus: StepCursorStatus }>;\n\nexport type StepsStatusLabels = Readonly<{\n  pending: string;\n  current: string;\n  complete: string;\n  error: string;\n}>;\n\nexport type StepsAccessibleNameInfo = Readonly<{\n  position: number;\n  total: number;\n  label: string;\n}>;\n\n/**\n * Products own the exact phrase order and counter-word grammar (Korean\n * \"3단계 중 2단계\" does not translate structurally to English \"step 2 of 3\"),\n * so the resolver invokes this composer instead of assembling copy itself.\n */\nexport type ComposeStepsAccessibleName = (\n  info: StepsAccessibleNameInfo,\n) => string;\n\nexport type ResolvedStepDescriptor<Id extends string = string> =\n  StepItemDescriptor<Id> &\n    Readonly<{\n      status: StepStatus;\n      /** 1-indexed so position and label both preserve reading order for renderers. */\n      position: number;\n      total: number;\n      /** Primary accessible name: order + label. Never says status by itself. */\n      accessibleName: string;\n      /** Supplementary status announcement (Web aria-describedby text / RN accessibilityHint). */\n      statusLabel: string;\n      /**\n       * Strictly before the cursor. Only these steps become buttons when the product supplies a step press handler:\n       * jumping forward would skip validation, and the cursor step is where the user already is (2026-10-18).\n       */\n      revisitable: boolean;\n    }>;\n\nexport type ResolveStepsOptions = Readonly<{\n  statusLabels: StepsStatusLabels;\n  composeAccessibleName: ComposeStepsAccessibleName;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`Steps ${field} must not be empty`);\n  }\n}\n\nexport function validateStepItemDescriptor<Id extends string>(\n  step: StepItemDescriptor<Id>,\n): void {\n  assertNonEmpty(step.id, \"item id\");\n  if (step.id !== step.id.trim()) {\n    throw new TypeError(\"Steps item id must not start or end with whitespace\");\n  }\n  assertNonEmpty(step.label, \"item label\");\n  if (step.description !== undefined) {\n    assertNonEmpty(step.description, \"item description\");\n  }\n}\n\nexport function validateStepsDescriptor<Id extends string>(\n  descriptor: StepsDescriptor<Id>,\n): void {\n  if (descriptor.steps.length < 2) {\n    throw new RangeError(\"Steps must contain at least two steps\");\n  }\n  const ids = new Set<Id>();\n  for (const step of descriptor.steps) {\n    validateStepItemDescriptor(step);\n    if (ids.has(step.id)) {\n      throw new TypeError(`Duplicate Steps item id: ${step.id}`);\n    }\n    ids.add(step.id);\n  }\n  if (!ids.has(descriptor.currentStepId)) {\n    throw new RangeError(\n      `Steps currentStepId does not match any step id: ${String(descriptor.currentStepId)}`,\n    );\n  }\n  if (\n    descriptor.currentStepStatus !== undefined &&\n    descriptor.currentStepStatus !== \"current\" &&\n    descriptor.currentStepStatus !== \"error\" &&\n    descriptor.currentStepStatus !== \"complete\"\n  ) {\n    throw new TypeError(\n      `Unsupported Steps currentStepStatus: ${String(descriptor.currentStepStatus)}`,\n    );\n  }\n}\n\nexport function validateStepsStatusLabels(labels: StepsStatusLabels): void {\n  if (labels === null || typeof labels !== \"object\") {\n    throw new TypeError(\"Steps statusLabels must be an object\");\n  }\n  for (const key of [\"pending\", \"current\", \"complete\", \"error\"] as const) {\n    const value = labels[key];\n    if (typeof value !== \"string\" || value.trim().length === 0) {\n      throw new TypeError(`Steps statusLabels.${key} must not be empty`);\n    }\n  }\n}\n\n/** A step is visually and semantically \"reached\" once it is no longer waiting. */\nexport function isStepReached(status: StepStatus): boolean {\n  return status !== \"pending\";\n}\n\n/**\n * Derives every step's status from its position relative to the single\n * cursor, then attaches the order-preserving accessible name and the\n * supplementary status announcement. Throws on a malformed descriptor,\n * labels bag, or composer instead of silently rendering an inconsistent flow.\n */\nexport function resolveStepsDescriptor<Id extends string>(\n  descriptor: StepsDescriptor<Id>,\n  options: ResolveStepsOptions,\n): readonly ResolvedStepDescriptor<Id>[] {\n  validateStepsDescriptor(descriptor);\n  validateStepsStatusLabels(options.statusLabels);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Steps composeAccessibleName must be a function\");\n  }\n\n  const currentStepStatus =\n    descriptor.currentStepStatus ?? stepsDefaults.currentStepStatus;\n  const total = descriptor.steps.length;\n  const cursorIndex = descriptor.steps.findIndex(\n    (step) => step.id === descriptor.currentStepId,\n  );\n\n  return descriptor.steps.map((step, index) => {\n    const status: StepStatus =\n      index < cursorIndex\n        ? \"complete\"\n        : index > cursorIndex\n          ? \"pending\"\n          : currentStepStatus;\n    const position = index + 1;\n    const accessibleName = options.composeAccessibleName({\n      position,\n      total,\n      label: step.label,\n    });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\n        \"Steps composeAccessibleName must return a non-empty string\",\n      );\n    }\n    return {\n      ...step,\n      status,\n      position,\n      total,\n      accessibleName,\n      statusLabel: options.statusLabels[status],\n      revisitable: index < cursorIndex,\n    };\n  });\n}\n\nexport const stepsRecipe = {\n  slots: [\n    \"root\",\n    \"step\",\n    \"indicator\",\n    \"marker\",\n    \"connector\",\n    \"label\",\n    \"description\",\n  ] as const,\n  gap: spacing.xs,\n  indicator: {\n    size: glyph.md,\n    borderWidth: stroke.default,\n    activeBorderWidth: stroke.strong,\n    /** null means the renderer shows the step's own position number instead of a glyph. */\n    marks: {\n      pending: null,\n      current: null,\n      complete: \"check\",\n      error: \"error\",\n    },\n    border: {\n      pending: semanticColors.border.default,\n      current: semanticColors.content.brand,\n      complete: semanticColors.feedback.success.border,\n      error: semanticColors.feedback.danger.border,\n    },\n    background: {\n      pending: null,\n      current: null,\n      complete: semanticColors.feedback.success.badgeBackground,\n      error: semanticColors.feedback.danger.badgeBackground,\n    },\n    content: {\n      pending: semanticColors.content.secondary,\n      current: semanticColors.content.brand,\n      complete: semanticColors.feedback.success.foreground,\n      error: semanticColors.feedback.danger.foreground,\n    },\n  },\n  connector: {\n    height: stroke.default,\n    tone: {\n      reached: semanticColors.content.brand,\n      unreached: semanticColors.border.default,\n    },\n  },\n  label: {\n    textVariant: \"label\",\n    fontWeight: fontWeight.medium,\n    color: {\n      pending: semanticColors.content.secondary,\n      current: semanticColors.content.primary,\n      complete: semanticColors.content.primary,\n      error: semanticColors.feedback.danger.foreground,\n    },\n  },\n  description: {\n    textVariant: \"caption\",\n    color: semanticColors.content.secondary,\n  },\n  /** A revisitable step is one button over its marker and label; the shared touch minimum applies to the whole cell. */\n  press: {\n    minTouchTarget: control.minTouchTarget,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  gap: number;\n  indicator: {\n    size: number;\n    borderWidth: number;\n    activeBorderWidth: number;\n    marks: Record<StepStatus, SemanticIconName | null>;\n    border: Record<StepStatus, ColorReference>;\n    background: Record<StepStatus, ColorReference | null>;\n    content: Record<StepStatus, ColorReference>;\n  };\n  connector: {\n    height: number;\n    tone: Record<\"reached\" | \"unreached\", ColorReference>;\n  };\n  label: {\n    textVariant: TextVariant;\n    fontWeight: FontWeightValue;\n    color: Record<StepStatus, ColorReference>;\n  };\n  description: {\n    textVariant: TextVariant;\n    color: ColorReference;\n  };\n  press: {\n    minTouchTarget: number;\n  };\n};\n"]}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export declare const designSystemVersion: "1.30.0";
+export declare const designSystemVersion: "1.31.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export const designSystemVersion = "1.30.0";
+export const designSystemVersion = "1.31.0";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAiB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"1.30.0\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAiB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"1.31.0\" as const;\n"]}

package/docs/bottom-navigation.md

@@ -180,3 +180,13 @@ floating 그림자는 그리지 않는다. 옆면이 높이를 표현하므로
 팔레트에 "눌린 브랜드" 역할이 없어서 새 역할을 추가하지 않고 기존 역할을 겹쳐 쓴다.
 선택하지 않은 카드도 같은 두께의 투명 테두리를 둔다. 그래서 선택이 바뀌어도 아이콘·라벨 줄이 움직이지 않는다.
 제품은 나무 같은 색을 surfaceAlt·borderControl 팔레트 역할로 공급한다. deprecated 시각 style로 덮지 않는다.
+
+### 덮인 높이·솟은 가운데 목적지·앱 아이콘 자리 (2026-10-18)
+
+세 제품이 막대를 우회한 원인을 계약으로 옮겼다. Spint는 떠 있는 막대의 높이를 몰라 탭 화면마다 112 빈칸을 두었다.
+`BottomNavigationInsetProvider`·`useBottomNavigationInset`이 겹친 막대(Web 고정, Native `placement="overlay"`)의
+측정 높이를 화면에 전달하고 ScreenLayout이 마지막 영역 여백으로 쓴다. Native 기본 `inline`은 자기 높이를 차지하므로 0이다.
+다에리는 가운데 "쓰기" 목적지를 그리려고 기본 탭바로 돌아갔다. 항목 `prominent`는 홀수 개의 정가운데 하나만 허용하고,
+`primaryAction`(행동)과 달리 선택·재선택이 있는 목적지다. 원은 `prominentDestination` recipe(지름 56, `action.brand`)를 쓰고
+라벨이 다른 라벨과 한 줄이 되도록 `지름 − 표시 자리 높이`만큼 올라간다. Utilverse는 큰 앱 아이콘 때문에 막대를 직접
+조립했다. `configuration.iconSize`(`large` 44 · `xlarge` 52)가 `renderIcon`의 `size`를 키운다. 세 축 모두 기본값에서 기존 외형이 그대로다.

package/docs/carousel.md

@@ -153,3 +153,11 @@ Native 위치 제어는 숫자 버튼으로 표현해 현재 위치를 눈으로
 자동재생은 선택 기능이며 기본 화면 예제는 수동이다. Web browser 및 Native renderer
 테스트는 숨김·key 유지·경계·controlled 요청·RTL·자동재생 중지와 swipe/접근성 action을
 검증한다. Native 기기 제스처·스크린 리더 실측은 별도이며 이 증거로 stable 승격하지 않는다.
+
+## PageIndicator (2026-10-18)
+
+Carousel의 위치 점 줄을 `PageIndicator`로 공개했다. 제품이 페이저와 페이지 내용을 직접 소유하는 자리(Utilverse 홈 런처의
+Native 페이징 목록)에서 같은 점·같은 끝 멈춤 이동을 쓰게 하려는 것이다. 계약은 `resolvePageIndicator`(점 이름은
+`composeAccessibleName`으로 제품이 짓는다)와 `getPageIndicatorTarget`(순환 없이 끝에서 멈춤)이고 recipe는 `carouselRecipe.dot`
+그대로다. Carousel도 같은 점 줄을 렌더한다(Web 내부 공유 컴포넌트, Native `PageIndicator`). Native는 줄 하나가 adjustable
+요소이고 Web은 group 안의 점 버튼이며 ←/→로 한 페이지씩 요청한다.

package/docs/dialog.md

@@ -64,3 +64,26 @@ enter duration, falling back to ordinary presentation if the host fails to reply
 spatial interpolation. Device geometry, resizing/keyboard behavior, themes and performance remain
 experimental until the QA report verifies them. See the usage guide and
 [origin transition QA](../../../docs/qa/2026-10-07-overlay-origin-transition.md).
+
+## Decorative layer and immersive presentation (1.31.0)
+
+2026-10-18 product gaps: BurnTok kept a raw RN Modal for a folder popup because its drag ghost had to be drawn
+in window coordinates outside the card, and utilverse kept one for a display board because every HJM overlay
+drew a card or a framed sheet. Both reused nothing of the modal stack, focus return or dismissal contract.
+
+- `overlayLayer` is a viewport/window-sized sibling of the card inside the same modal. It is decorative by
+  contract: no pointer input, hidden from assistive technology (Web `inert` + `aria-hidden`, Native
+  `pointerEvents="none"` + `no-hide-descendants`). Interactive content stays in `children`, inside the focus trap.
+- `scrollEnabled` (default `true`) temporarily locks user scrolling of the dialog while a gesture in the body
+  owns pointer movement (the same folder drag): Web sets the card to `overflow: hidden` and keeps its offset, Native
+  disables the bounded body ScrollView. It is a temporary lock, not a way to clip content.
+- `ImmersiveOverlay` is a Dialog companion with no card, scrim, header or gutter: a product stage edge to edge
+  and a control bar (status, tools, a localized exit action). It keeps the shared modal stack, focus trap,
+  background isolation, focus return and the entry-focus wait of screens below. Web reports `escape` or
+  `exit-action`; Native reports `back` or `exit-action`. Native presents full screen with the status bar hidden
+  and rotation allowed (`dialogRecipe.immersive`). Web does not request the Fullscreen API (user activation,
+  Escape consumed by the browser, no element fullscreen on iOS Safari).
+
+Renderer proof: `immersive-overlay.browser.test.tsx` (geometry, exit focus, Escape, focus return, inert layer)
+and `immersive-overlay.test.tsx` (Modal presentation, status bar, orientations, reasons, overlay-stack wait,
+layer placement). Device rotation and status bar behavior are unverified on hardware.

package/docs/generated/component-maturity.md

@@ -1,12 +1,12 @@
 # Component maturity and evidence manifest
 
-> Generated from `@hjmds/design-contracts` 1.30.0. Do not edit this file directly; run `pnpm contracts:sync`.
+> Generated from `@hjmds/design-contracts` 1.31.0. Do not edit this file directly; run `pnpm contracts:sync`.
 
 This document is the human-readable projection of the same catalog and Showcase manifest consumed by product CI.
 
-- Contract: stable 125 · beta 2
-- Web renderer: stable 125 · beta 2
-- Native renderer: stable 105 · beta 4 · unsupported 18
+- Contract: stable 125 · beta 5
+- Web renderer: stable 125 · beta 5
+- Native renderer: stable 105 · beta 7 · unsupported 18
 
 | Component | Canonical story ID | Contract | Web | Native | Documentation | Required evidence |
 | --- | --- | --- | --- | --- | --- | --- |
@@ -65,6 +65,7 @@ This document is the human-readable projection of the same catalog and Showcase
 | Sidebar | `navigation/sidebar` | stable | stable | unsupported | [authored](../sidebar.md) | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, keyboard |
 | BottomNavigation | `navigation/bottom-navigation` | stable | stable | stable | [authored](../bottom-navigation.md) | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, keyboard; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, native-actions |
 | Breadcrumb | `navigation/breadcrumb` | stable | stable | unsupported | [authored](../breadcrumb.md) | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, keyboard |
+| PageIndicator | `navigation/page-indicator` | beta | beta | beta | generated only | contract: contract; web: default, dark, large-text, rtl, reduced-motion, accessibility; native: default, dark, large-text, rtl, reduced-motion, accessibility |
 | Pagination | `navigation/pagination` | stable | stable | beta | [authored](../pagination.md) | contract: contract; web: default, dark, large-text, rtl, reduced-motion, accessibility, keyboard; native: default, dark, large-text, rtl, reduced-motion, accessibility, native-actions |
 | LoadMore | `navigation/load-more` | stable | stable | stable | [authored](../load-more.md) | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, keyboard; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility, native-actions |
 | Steps | `navigation/steps` | stable | stable | stable | [authored](../steps.md) | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
@@ -130,6 +131,8 @@ This document is the human-readable projection of the same catalog and Showcase
 | MediaSelectionScreen | `layout/media-selection-screen` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
 | ProfileScreen | `layout/profile-screen` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
 | ChatMessage | `data-display/chat-message` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
+| TypingIndicator | `feedback/typing-indicator` | beta | beta | beta | generated only | contract: contract; web: default, dark, large-text, rtl, reduced-motion, accessibility; native: default, dark, large-text, rtl, reduced-motion, accessibility |
+| ChatDateSeparator | `data-display/chat-date-separator` | beta | beta | beta | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
 | NotificationRow | `data-display/notification-row` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
 | NotificationItem | `data-display/notification-item` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |
 | CommentThreadRow | `data-display/comment-thread-row` | stable | stable | stable | generated only | contract: contract; web: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility; native: default, dark, long-copy, large-text, rtl, reduced-motion, accessibility |