@hjmds/design-contracts 1.34.0 → 1.35.1

package/dist/calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { BehaviorContract, WebKeyboardKey } from \"./behaviors.js\";\nimport type { DesignSystemDirection } from \"./design-system-provider.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { control, glyph, layout, opacity, spacing, stroke, typography, type FontWeightValue, type GlyphSize, type TextVariant } from \"./foundations.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nconst ISO_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/;\nconst ISO_MONTH_PATTERN = /^\\d{4}-(0[1-9]|1[0-2])$/;\nconst GRID_COLUMNS = 7;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Calendar ${field} must not be empty`);\n  }\n}\n\n/**\n * The grid never parses or computes dates — month/leap-year/timezone\n * arithmetic stays product-owned (see docs/calendar.md). This only checks the\n * \"YYYY-MM-DD\" shape products already use as their KBO schedule date key.\n */\nexport function isIsoCalendarDate(value: string): boolean {\n  return typeof value === \"string\" && ISO_DATE_PATTERN.test(value);\n}\n\nexport function assertIsoCalendarDate(value: string, field: string): void {\n  if (!isIsoCalendarDate(value)) {\n    throw new TypeError(`Calendar ${field} must be an ISO \"YYYY-MM-DD\" date string`);\n  }\n}\n\nexport function isIsoCalendarMonth(value: string): boolean {\n  return typeof value === \"string\" && ISO_MONTH_PATTERN.test(value);\n}\n\nexport function assertIsoCalendarMonth(value: string, field: string): void {\n  if (!isIsoCalendarMonth(value)) {\n    throw new TypeError(`Calendar ${field} must be an ISO \"YYYY-MM\" month string`);\n  }\n}\n\n/**\n * One visible cell. A cell with no `date` is a pure filler that keeps the\n * seven-column alignment (a leading/trailing blank before day 1 or after the\n * month's last day) — it is never focusable, selectable, or announced.\n * `content` is an opaque product payload (Yajalal's per-day game count, a\n * dot, anything) the renderer's cell-content slot receives untouched; the\n * grid never inspects it.\n */\nexport type CalendarDateCellDescriptor<Content = unknown> = Readonly<{\n  date?: string;\n  /** The date exists but falls outside the month currently in focus (a leading/trailing day from an adjacent month). Still selectable unless `disabled`. */\n  outsideFocusedMonth?: boolean;\n  disabled?: boolean;\n  content?: Content;\n}>;\n\nexport type CalendarWeekdayLabels = readonly [\n  string,\n  string,\n  string,\n  string,\n  string,\n  string,\n  string,\n];\n\n/**\n * Raw product data for one visible month page. HJM does not compute which\n * dates belong to a month or the leading/trailing blanks — the product\n * already owns that arithmetic (see `buildCalendarCells` in Yajalal's\n * schedule explorer). HJM only validates the row-major seven-column shape\n * and resolves per-cell semantic state on top of it.\n */\nexport type CalendarGridDescriptor<Content = unknown> = Readonly<{\n  /** Row-major, seven columns per row (one per weekday), so length must be a positive multiple of seven. */\n  cells: readonly CalendarDateCellDescriptor<Content>[];\n  /** Localized short weekday labels in the same column order as `cells`, e.g. [\"일\",\"월\",\"화\",\"수\",\"목\",\"금\",\"토\"]. */\n  weekdayLabels: CalendarWeekdayLabels;\n  /** ISO date of \"today\" per the product's clock. The grid never calls `Date.now()` itself. */\n  todayDate: string;\n}>;\n\nexport function validateCalendarGridDescriptor<Content>(\n  grid: CalendarGridDescriptor<Content>,\n): void {\n  if (grid.cells.length === 0 || grid.cells.length % GRID_COLUMNS !== 0) {\n    throw new RangeError(\"Calendar grid cells must be a non-empty multiple of seven\");\n  }\n  if (grid.weekdayLabels.length !== GRID_COLUMNS) {\n    throw new RangeError(\"Calendar weekdayLabels must have exactly seven entries\");\n  }\n  grid.weekdayLabels.forEach((label, index) => assertNonEmpty(label, `weekdayLabels[${index}]`));\n  assertIsoCalendarDate(grid.todayDate, \"todayDate\");\n  const seen = new Set<string>();\n  for (const cell of grid.cells) {\n    if (cell.date === undefined) continue;\n    assertIsoCalendarDate(cell.date, \"cell date\");\n    if (seen.has(cell.date)) {\n      throw new TypeError(`Duplicate Calendar cell date: ${cell.date}`);\n    }\n    seen.add(cell.date);\n  }\n}\n\n/**\n * A cursor's committed value and the one displayed month page are\n * independent controlled axes, mirroring `SelectSelection`/`SelectOpenState`\n * in spirit: paging the visible month never clears or moves the selection.\n */\nexport type CalendarMonthChangeReason = \"previous\" | \"next\" | \"jump\";\n\nexport type CalendarMonthNavigation =\n  | Readonly<{\n      focusedMonth: string;\n      defaultFocusedMonth?: never;\n      onFocusedMonthChange(month: string, reason: CalendarMonthChangeReason): void;\n    }>\n  | Readonly<{\n      focusedMonth?: never;\n      defaultFocusedMonth?: string;\n      onFocusedMonthChange?: (month: string, reason: CalendarMonthChangeReason) => void;\n    }>;\n\nexport function validateCalendarMonthNavigation(navigation: CalendarMonthNavigation): void {\n  const month = navigation.focusedMonth ?? navigation.defaultFocusedMonth;\n  if (month !== undefined) assertIsoCalendarMonth(month, \"focusedMonth\");\n}\n\n/**\n * Single committed date only. Range selection is deliberately excluded — no\n * Yajalal or BurnTok flow has measured demand for it (see docs/calendar.md).\n */\nexport type CalendarSelection =\n  | Readonly<{\n      selectedDate: string | null;\n      defaultSelectedDate?: never;\n      onSelectionChange(date: string | null): void;\n    }>\n  | Readonly<{\n      selectedDate?: never;\n      defaultSelectedDate?: string | null;\n      onSelectionChange?: (date: string | null) => void;\n    }>;\n\nexport function validateCalendarSelection(selection: CalendarSelection): void {\n  const selected = selection.selectedDate ?? selection.defaultSelectedDate;\n  if (selected != null) assertIsoCalendarDate(selected, \"selectedDate\");\n}\n\nexport type CalendarDescriptor<Content = unknown> = Readonly<{\n  grid: CalendarGridDescriptor<Content>;\n  /** Product-formatted heading copy (\"2026년 8월\"); the grid never formats a date itself. */\n  monthLabel: string;\n}> &\n  CalendarMonthNavigation &\n  CalendarSelection;\n\nexport function validateCalendarDescriptor<Content>(\n  descriptor: CalendarDescriptor<Content>,\n): void {\n  validateCalendarGridDescriptor(descriptor.grid);\n  assertNonEmpty(descriptor.monthLabel, \"monthLabel\");\n  validateCalendarMonthNavigation(descriptor);\n  validateCalendarSelection(descriptor);\n}\n\nexport type CalendarAccessibleNameInfo<Content = unknown> = Readonly<{\n  date: string;\n  isToday: boolean;\n  isSelected: boolean;\n  disabled: boolean;\n  content?: Content;\n}>;\n\n/**\n * \"8월 19일 수요일, 경기 2개, 선택됨\" is assembled by the product from its own\n * `content` payload and locale/grammar — the same reason Steps takes\n * `composeAccessibleName` instead of assembling copy itself.\n */\nexport type ComposeCalendarAccessibleName<Content = unknown> = (\n  info: CalendarAccessibleNameInfo<Content>,\n) => string;\n\nexport type ResolvedCalendarDateCell<Content = unknown> = CalendarDateCellDescriptor<Content> &\n  Readonly<{\n    date: string;\n    /** 1-indexed. */\n    row: number;\n    /** 1-indexed, 1..7. */\n    column: number;\n    isToday: boolean;\n    isSelected: boolean;\n    /** `false` when disabled — the cell stays focusable (see `getCalendarNavigationTarget`) but must never commit or close on activate. */\n    selectable: boolean;\n    accessibleName: string;\n  }>;\n\nexport type ResolvedCalendarFillerCell = Readonly<{\n  date?: never;\n  row: number;\n  column: number;\n  filler: true;\n}>;\n\nexport type ResolvedCalendarGridCell<Content = unknown> =\n  | ResolvedCalendarDateCell<Content>\n  | ResolvedCalendarFillerCell;\n\n/**\n * Resolves per-cell semantic state against a selection supplied separately\n * from the raw grid (mirroring `resolveSelectSelectedItem`'s separation of\n * source data from selection state) — the same grid page renders identically\n * whether it is hosted by Calendar or by DatePicker's popover/sheet.\n */\nexport function resolveCalendarGridDescriptor<Content>(\n  grid: CalendarGridDescriptor<Content>,\n  selectedDate: string | null,\n  options: Readonly<{ composeAccessibleName: ComposeCalendarAccessibleName<Content> }>,\n): readonly ResolvedCalendarGridCell<Content>[] {\n  validateCalendarGridDescriptor(grid);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Calendar composeAccessibleName must be a function\");\n  }\n\n  return grid.cells.map((cell, index) => {\n    const row = Math.floor(index / GRID_COLUMNS) + 1;\n    const column = (index % GRID_COLUMNS) + 1;\n    if (cell.date === undefined) {\n      return { row, column, filler: true as const };\n    }\n    const isToday = cell.date === grid.todayDate;\n    const isSelected = cell.date === selectedDate;\n    const disabled = cell.disabled ?? false;\n    const nameInfo: CalendarAccessibleNameInfo<Content> =\n      cell.content === undefined\n        ? { date: cell.date, isToday, isSelected, disabled }\n        : { date: cell.date, isToday, isSelected, disabled, content: cell.content };\n    const accessibleName = options.composeAccessibleName(nameInfo);\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\"Calendar composeAccessibleName must return a non-empty string\");\n    }\n    return {\n      ...cell,\n      date: cell.date,\n      row,\n      column,\n      isToday,\n      isSelected,\n      selectable: !disabled,\n      accessibleName,\n    };\n  });\n}\n\n/** Top-level entry point: validates the descriptor and resolves its grid page. */\nexport function resolveCalendarDescriptor<Content>(\n  descriptor: CalendarDescriptor<Content>,\n  options: Readonly<{ composeAccessibleName: ComposeCalendarAccessibleName<Content> }>,\n): readonly ResolvedCalendarGridCell<Content>[] {\n  validateCalendarDescriptor(descriptor);\n  const selectedDate = descriptor.selectedDate ?? descriptor.defaultSelectedDate ?? null;\n  return resolveCalendarGridDescriptor(descriptor.grid, selectedDate, options);\n}\n\nexport type CalendarNavigationIntent =\n  | \"next-day\"\n  | \"previous-day\"\n  | \"next-week\"\n  | \"previous-week\"\n  | \"first-of-week\"\n  | \"last-of-week\";\n\n/**\n * ArrowLeft/Right flip under RTL, matching `getSelectionNavigationIntent`'s\n * `direction` parameter.\n */\nexport function getCalendarNavigationIntent(\n  key: WebKeyboardKey,\n  direction: DesignSystemDirection = \"ltr\",\n): CalendarNavigationIntent | undefined {\n  if (key === \"Home\") return \"first-of-week\";\n  if (key === \"End\") return \"last-of-week\";\n  if (key === \"ArrowDown\") return \"next-week\";\n  if (key === \"ArrowUp\") return \"previous-week\";\n  if (key === \"ArrowRight\") return direction === \"rtl\" ? \"previous-day\" : \"next-day\";\n  if (key === \"ArrowLeft\") return direction === \"rtl\" ? \"next-day\" : \"previous-day\";\n  return undefined;\n}\n\nexport type CalendarNavigationResult =\n  | Readonly<{ date: string; overflow?: never }>\n  | Readonly<{ date?: never; overflow: \"before\" | \"after\" }>;\n\n/**\n * Pure index arithmetic over the fixed seven-column page. Unlike\n * `getCollectionNavigationTarget`, this does NOT skip disabled dates —\n * per the WAI-ARIA date picker dialog pattern, arrow-key focus must land\n * predictably (down always moves exactly one row) even on a disabled date;\n * only the *activate* action is expected to no-op there. Moving past the\n * edge of this page returns an `overflow` signal instead of wrapping, since\n * HJM does not know the adjacent month's shape — the product pages the\n * month and refocuses the corresponding day.\n */\nexport function getCalendarNavigationTarget<Content>(\n  grid: CalendarGridDescriptor<Content>,\n  currentDate: string,\n  intent: CalendarNavigationIntent,\n): CalendarNavigationResult {\n  validateCalendarGridDescriptor(grid);\n  const currentIndex = grid.cells.findIndex((cell) => cell.date === currentDate);\n  if (currentIndex < 0) {\n    throw new RangeError(`Calendar currentDate is not part of this grid page: ${currentDate}`);\n  }\n\n  const findDated = (from: number, step: number): number | undefined => {\n    for (let index = from; index >= 0 && index < grid.cells.length; index += step) {\n      if (grid.cells[index]?.date !== undefined) return index;\n    }\n    return undefined;\n  };\n\n  const rowStart = Math.floor(currentIndex / GRID_COLUMNS) * GRID_COLUMNS;\n  const rowEnd = rowStart + GRID_COLUMNS - 1;\n\n  if (intent === \"first-of-week\") {\n    const found = findDated(rowStart, 1);\n    return found !== undefined && found <= rowEnd\n      ? { date: grid.cells[found]!.date! }\n      : { overflow: \"before\" };\n  }\n  if (intent === \"last-of-week\") {\n    const found = findDated(rowEnd, -1);\n    return found !== undefined && found >= rowStart\n      ? { date: grid.cells[found]!.date! }\n      : { overflow: \"after\" };\n  }\n\n  const forward = intent === \"next-day\" || intent === \"next-week\";\n  const stride = intent === \"next-week\" || intent === \"previous-week\" ? GRID_COLUMNS : 1;\n  const step = forward ? 1 : -1;\n  const target = currentIndex + step * stride;\n  if (target < 0) return { overflow: \"before\" };\n  if (target >= grid.cells.length) return { overflow: \"after\" };\n  if (grid.cells[target]?.date !== undefined) return { date: grid.cells[target]!.date! };\n  // Landed on a filler (only reachable for a week-step into a partially\n  // filled edge row): keep scanning the same direction for the nearest real\n  // date rather than asking a renderer to interpret a blank cell.\n  const resolved = findDated(target, step);\n  return resolved !== undefined\n    ? { date: grid.cells[resolved]!.date! }\n    : { overflow: forward ? \"after\" : \"before\" };\n}\n\nexport type CalendarSize = \"compact\" | \"medium\" | \"large\";\n\n/**\n * `today` and `selected` are visually independent (a non-selected today and\n * a selected past day must both read clearly) and neither is color-only:\n * today gets a persistent border, selected gets a filled background, and\n * both remain in `accessibleName`/`isToday`/`isSelected` for assistive tech.\n */\nexport const calendarRecipe = {\n  slots: [\n    \"root\",\n    \"header\",\n    \"monthLabel\",\n    \"previousMonth\",\n    \"nextMonth\",\n    \"weekdayRow\",\n    \"weekdayLabel\",\n    \"grid\",\n    \"week\",\n    \"day\",\n    \"dayLabel\",\n    \"content\",\n  ] as const,\n  defaults: { size: \"medium\" },\n  // A week stays scannable: the 1280 Web host spread seven columns to ~135px each (2026-10-17 review). Same width as the\n  // DatePicker popover.\n  maxWidth: layout.readingMaxWidth / 2,\n  header: {\n    gap: spacing.xs,\n    monthLabel: {\n      textVariant: \"title\",\n      fontWeight: typography.title.fontWeight,\n      color: semanticColors.content.primary,\n    },\n    navButton: { diameter: control.buttonHeight.medium, color: semanticColors.content.secondary },\n    navIcon: { previous: \"chevronStart\", next: \"chevronEnd\" },\n  },\n  weekdayLabel: {\n    textVariant: \"label\",\n    color: semanticColors.content.secondary,\n  },\n  sizes: {\n    // Dense annotated calendars need a smaller visual marker without shrinking the hit target.\n    compact: { cellDiameter: control.minTouchTarget, indicatorDiameter: 28, textVariant: \"body\", glyph: \"sm\" },\n    medium: { cellDiameter: control.minTouchTarget, indicatorDiameter: control.minTouchTarget, textVariant: \"body\", glyph: \"sm\" },\n    large: { cellDiameter: glyph.xxl, indicatorDiameter: glyph.xxl, textVariant: \"bodyLarge\", glyph: \"md\" },\n  },\n  day: {\n    radius: \"full\" as const,\n    label: { color: semanticColors.content.body, numericVariant: \"tabular\" },\n    outsideFocusedMonthOpacity: opacity.muted,\n    disabledOpacity: opacity.disabled,\n    today: { border: semanticColors.border.focus, borderWidth: stroke.default },\n    selected: {\n      background: semanticColors.action.brand.background,\n      content: semanticColors.action.brand.content,\n    },\n    focus: focusIndicatorContract,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: CalendarSize };\n  maxWidth: number;\n  header: {\n    gap: number;\n    monthLabel: { textVariant: TextVariant; fontWeight: FontWeightValue; color: ColorReference };\n    navButton: { diameter: number; color: ColorReference };\n    navIcon: { previous: SemanticIconName; next: SemanticIconName };\n  };\n  weekdayLabel: { textVariant: TextVariant; color: ColorReference };\n  sizes: Record<CalendarSize, { cellDiameter: number; indicatorDiameter: number; textVariant: TextVariant; glyph: GlyphSize }>;\n  day: {\n    radius: \"full\";\n    label: { color: ColorReference; numericVariant: \"tabular\" };\n    outsideFocusedMonthOpacity: number;\n    disabledOpacity: number;\n    today: { border: ColorReference; borderWidth: number };\n    selected: { background: ColorReference; content: ColorReference };\n    focus: typeof focusIndicatorContract;\n  };\n};\n\n/**\n * Calendar is `shared`, not `adaptive`: the grid is always visible inline\n * (no popup/Sheet choice to make). Web gets `grid` role + roving-tabindex\n * arrow keys; Native has no composite-widget equivalent, so each date is\n * simply an independently focusable/tappable element and month paging goes\n * through the always-present previous/next buttons on both platforms — same\n * result (the user reaches and picks a date), different path, matching the\n * `beta → stable(adaptive)` gate's standard even though this component\n * itself is not adaptive.\n */\nexport const calendarBehavior = {\n  controlled: [\n    \"selectedDate\",\n    \"defaultSelectedDate\",\n    \"onSelectionChange\",\n    \"focusedMonth\",\n    \"defaultFocusedMonth\",\n    \"onFocusedMonthChange\",\n  ],\n  inputs: [\"grid\", \"monthLabel\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\"],\n    value: [\"selected\"],\n  },\n  web: {\n    roles: [\"grid\", \"row\", \"gridcell\", \"button\"],\n    keyboard: [\n      \"Tab\",\n      \"Enter\",\n      \"Space\",\n      \"ArrowUp\",\n      \"ArrowDown\",\n      \"ArrowLeft\",\n      \"ArrowRight\",\n      \"Home\",\n      \"End\",\n    ],\n    focus: \"roving\",\n  },\n  native: {\n    roles: [\"button\"],\n    states: [\"disabled\", \"selected\"],\n    actions: [\"activate\"],\n  },\n  scenarios: [\n    \"today-and-selected-are-independent-and-both-non-color-marked\",\n    \"disabled-dates-remain-focusable-but-never-activate\",\n    \"arrow-keys-move-by-day-and-week-inside-the-visible-month-page\",\n    \"home-and-end-move-to-the-first-and-last-dated-cell-of-the-focused-row\",\n    \"moving-past-the-visible-grid-edge-requests-a-month-change-instead-of-wrapping\",\n    \"filler-cells-carry-no-accessible-name-and-are-hidden-from-assistive-tech\",\n    \"every-dated-cell-accessible-name-is-composed-by-the-product\",\n    \"changing-the-focused-month-never-changes-or-clears-the-selection\",\n    \"range-selection-is-not-part-of-the-contract\",\n  ],\n} as const satisfies BehaviorContract;\n"]}
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { BehaviorContract, WebKeyboardKey } from \"./behaviors.js\";\nimport type { DesignSystemDirection } from \"./design-system-provider.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { control, glyph, layout, opacity, spacing, stroke, typography, type FontWeightValue, type GlyphSize, type TextVariant } from \"./foundations.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nconst ISO_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/;\nconst ISO_MONTH_PATTERN = /^\\d{4}-(0[1-9]|1[0-2])$/;\nconst GRID_COLUMNS = 7;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Calendar ${field} must not be empty`);\n  }\n}\n\n/**\n * The descriptor accepts product-owned calendar keys. This only checks the\n * \"YYYY-MM-DD\" shape products already use as their KBO schedule date key.\n */\nexport function isIsoCalendarDate(value: string): boolean {\n  return typeof value === \"string\" && ISO_DATE_PATTERN.test(value);\n}\n\nexport function assertIsoCalendarDate(value: string, field: string): void {\n  if (!isIsoCalendarDate(value)) {\n    throw new TypeError(`Calendar ${field} must be an ISO \"YYYY-MM-DD\" date string`);\n  }\n}\n\nexport function isIsoCalendarMonth(value: string): boolean {\n  return typeof value === \"string\" && ISO_MONTH_PATTERN.test(value);\n}\n\nexport function assertIsoCalendarMonth(value: string, field: string): void {\n  if (!isIsoCalendarMonth(value)) {\n    throw new TypeError(`Calendar ${field} must be an ISO \"YYYY-MM\" month string`);\n  }\n}\n\n/**\n * One visible cell. A cell with no `date` is a pure filler that keeps the\n * seven-column alignment (a leading/trailing blank before day 1 or after the\n * month's last day) — it is never focusable, selectable, or announced.\n * `content` is an opaque product payload (Yajalal's per-day game count, a\n * dot, anything) the renderer's cell-content slot receives untouched; the\n * grid never inspects it.\n */\nexport type CalendarDateCellDescriptor<Content = unknown> = Readonly<{\n  date?: string;\n  /** The date exists but falls outside the month currently in focus (a leading/trailing day from an adjacent month). Still selectable unless `disabled`. */\n  outsideFocusedMonth?: boolean;\n  disabled?: boolean;\n  content?: Content;\n}>;\n\n/** Civil Gregorian display cells only; business dates, time zones and the clock remain caller-owned. */\nexport function createCalendarMonthCells(\n  month: string,\n  { weekStartsOn = 0, outsideMonth = \"adjacent\" }: Readonly<{\n    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;\n    outsideMonth?: \"adjacent\" | \"blank\";\n  }> = {},\n): readonly CalendarDateCellDescriptor[] {\n  assertIsoCalendarMonth(month, \"month\");\n  if (!Number.isInteger(weekStartsOn) || weekStartsOn < 0 || weekStartsOn > 6) {\n    throw new RangeError(\"Calendar weekStartsOn must be an integer from zero to six\");\n  }\n  if (outsideMonth !== \"adjacent\" && outsideMonth !== \"blank\") {\n    throw new TypeError(\"Calendar outsideMonth must be adjacent or blank\");\n  }\n  // UTC is a coordinate system for civil-day layout, never a conversion of the\n  // traveller's/service's date. Local Date arithmetic skips/repeats hours at DST.\n  const first = new Date(`${month}-01T00:00:00Z`);\n  const next = new Date(first);\n  next.setUTCMonth(next.getUTCMonth() + 1);\n  const day = 86_400_000;\n  const leading = (first.getUTCDay() - weekStartsOn + 7) % 7;\n  const count = Math.ceil((leading + (next.getTime() - first.getTime()) / day) / 7) * 7;\n  return Array.from({ length: count }, (_, index) => {\n    const value = new Date(first.getTime() + (index - leading) * day);\n    // Four-digit descriptor keys cannot represent the adjacent year at the\n    // outer supported boundaries. Those cells stay non-interactive fillers.\n    if (value.getUTCFullYear() < 0 || value.getUTCFullYear() > 9999) return {};\n    const date = value.toISOString().slice(0, 10);\n    const outsideFocusedMonth = !date.startsWith(month);\n    return outsideFocusedMonth\n      ? outsideMonth === \"blank\" ? {} : { date, outsideFocusedMonth: true }\n      : { date };\n  });\n}\n\nexport type CalendarWeekdayLabels = readonly [\n  string,\n  string,\n  string,\n  string,\n  string,\n  string,\n  string,\n];\n\n/**\n * Raw product data for one visible month page. Use createCalendarMonthCells\n * for a plain Gregorian page or supply a product-specific grid with content.\n * The renderer validates shape and resolves semantic state, without reading a clock.\n */\nexport type CalendarGridDescriptor<Content = unknown> = Readonly<{\n  /** Row-major, seven columns per row (one per weekday), so length must be a positive multiple of seven. */\n  cells: readonly CalendarDateCellDescriptor<Content>[];\n  /** Localized short weekday labels in the same column order as `cells`, e.g. [\"일\",\"월\",\"화\",\"수\",\"목\",\"금\",\"토\"]. */\n  weekdayLabels: CalendarWeekdayLabels;\n  /** ISO date of \"today\" per the product's clock. The grid never calls `Date.now()` itself. */\n  todayDate: string;\n}>;\n\nexport function validateCalendarGridDescriptor<Content>(\n  grid: CalendarGridDescriptor<Content>,\n): void {\n  if (grid.cells.length === 0 || grid.cells.length % GRID_COLUMNS !== 0) {\n    throw new RangeError(\"Calendar grid cells must be a non-empty multiple of seven\");\n  }\n  if (grid.weekdayLabels.length !== GRID_COLUMNS) {\n    throw new RangeError(\"Calendar weekdayLabels must have exactly seven entries\");\n  }\n  grid.weekdayLabels.forEach((label, index) => assertNonEmpty(label, `weekdayLabels[${index}]`));\n  assertIsoCalendarDate(grid.todayDate, \"todayDate\");\n  const seen = new Set<string>();\n  for (const cell of grid.cells) {\n    if (cell.date === undefined) continue;\n    assertIsoCalendarDate(cell.date, \"cell date\");\n    if (seen.has(cell.date)) {\n      throw new TypeError(`Duplicate Calendar cell date: ${cell.date}`);\n    }\n    seen.add(cell.date);\n  }\n}\n\n/**\n * A cursor's committed value and the one displayed month page are\n * independent controlled axes, mirroring `SelectSelection`/`SelectOpenState`\n * in spirit: paging the visible month never clears or moves the selection.\n */\nexport type CalendarMonthChangeReason = \"previous\" | \"next\" | \"jump\";\n\nexport type CalendarMonthNavigation =\n  | Readonly<{\n      focusedMonth: string;\n      defaultFocusedMonth?: never;\n      onFocusedMonthChange(month: string, reason: CalendarMonthChangeReason): void;\n    }>\n  | Readonly<{\n      focusedMonth?: never;\n      defaultFocusedMonth?: string;\n      onFocusedMonthChange?: (month: string, reason: CalendarMonthChangeReason) => void;\n    }>;\n\nexport function validateCalendarMonthNavigation(navigation: CalendarMonthNavigation): void {\n  const month = navigation.focusedMonth ?? navigation.defaultFocusedMonth;\n  if (month !== undefined) assertIsoCalendarMonth(month, \"focusedMonth\");\n}\n\n/**\n * Single committed date only. Range selection is deliberately excluded — no\n * Yajalal or BurnTok flow has measured demand for it (see docs/calendar.md).\n */\nexport type CalendarSelection =\n  | Readonly<{\n      selectedDate: string | null;\n      defaultSelectedDate?: never;\n      onSelectionChange(date: string | null): void;\n    }>\n  | Readonly<{\n      selectedDate?: never;\n      defaultSelectedDate?: string | null;\n      onSelectionChange?: (date: string | null) => void;\n    }>;\n\nexport function validateCalendarSelection(selection: CalendarSelection): void {\n  const selected = selection.selectedDate ?? selection.defaultSelectedDate;\n  if (selected != null) assertIsoCalendarDate(selected, \"selectedDate\");\n}\n\nexport type CalendarDescriptor<Content = unknown> = Readonly<{\n  grid: CalendarGridDescriptor<Content>;\n  /** Product-formatted heading copy (\"2026년 8월\"); the grid never formats a date itself. */\n  monthLabel: string;\n}> &\n  CalendarMonthNavigation &\n  CalendarSelection;\n\nexport function validateCalendarDescriptor<Content>(\n  descriptor: CalendarDescriptor<Content>,\n): void {\n  validateCalendarGridDescriptor(descriptor.grid);\n  assertNonEmpty(descriptor.monthLabel, \"monthLabel\");\n  validateCalendarMonthNavigation(descriptor);\n  validateCalendarSelection(descriptor);\n}\n\nexport type CalendarAccessibleNameInfo<Content = unknown> = Readonly<{\n  date: string;\n  isToday: boolean;\n  isSelected: boolean;\n  disabled: boolean;\n  content?: Content;\n}>;\n\n/**\n * \"8월 19일 수요일, 경기 2개, 선택됨\" is assembled by the product from its own\n * `content` payload and locale/grammar — the same reason Steps takes\n * `composeAccessibleName` instead of assembling copy itself.\n */\nexport type ComposeCalendarAccessibleName<Content = unknown> = (\n  info: CalendarAccessibleNameInfo<Content>,\n) => string;\n\nexport type ResolvedCalendarDateCell<Content = unknown> = CalendarDateCellDescriptor<Content> &\n  Readonly<{\n    date: string;\n    /** 1-indexed. */\n    row: number;\n    /** 1-indexed, 1..7. */\n    column: number;\n    isToday: boolean;\n    isSelected: boolean;\n    /** `false` when disabled — the cell stays focusable (see `getCalendarNavigationTarget`) but must never commit or close on activate. */\n    selectable: boolean;\n    accessibleName: string;\n  }>;\n\nexport type ResolvedCalendarFillerCell = Readonly<{\n  date?: never;\n  row: number;\n  column: number;\n  filler: true;\n}>;\n\nexport type ResolvedCalendarGridCell<Content = unknown> =\n  | ResolvedCalendarDateCell<Content>\n  | ResolvedCalendarFillerCell;\n\n/**\n * Resolves per-cell semantic state against a selection supplied separately\n * from the raw grid (mirroring `resolveSelectSelectedItem`'s separation of\n * source data from selection state) — the same grid page renders identically\n * whether it is hosted by Calendar or by DatePicker's popover/sheet.\n */\nexport function resolveCalendarGridDescriptor<Content>(\n  grid: CalendarGridDescriptor<Content>,\n  selectedDate: string | null,\n  options: Readonly<{ composeAccessibleName: ComposeCalendarAccessibleName<Content> }>,\n): readonly ResolvedCalendarGridCell<Content>[] {\n  validateCalendarGridDescriptor(grid);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Calendar composeAccessibleName must be a function\");\n  }\n\n  return grid.cells.map((cell, index) => {\n    const row = Math.floor(index / GRID_COLUMNS) + 1;\n    const column = (index % GRID_COLUMNS) + 1;\n    if (cell.date === undefined) {\n      return { row, column, filler: true as const };\n    }\n    const isToday = cell.date === grid.todayDate;\n    const isSelected = cell.date === selectedDate;\n    const disabled = cell.disabled ?? false;\n    const nameInfo: CalendarAccessibleNameInfo<Content> =\n      cell.content === undefined\n        ? { date: cell.date, isToday, isSelected, disabled }\n        : { date: cell.date, isToday, isSelected, disabled, content: cell.content };\n    const accessibleName = options.composeAccessibleName(nameInfo);\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\"Calendar composeAccessibleName must return a non-empty string\");\n    }\n    return {\n      ...cell,\n      date: cell.date,\n      row,\n      column,\n      isToday,\n      isSelected,\n      selectable: !disabled,\n      accessibleName,\n    };\n  });\n}\n\n/** Top-level entry point: validates the descriptor and resolves its grid page. */\nexport function resolveCalendarDescriptor<Content>(\n  descriptor: CalendarDescriptor<Content>,\n  options: Readonly<{ composeAccessibleName: ComposeCalendarAccessibleName<Content> }>,\n): readonly ResolvedCalendarGridCell<Content>[] {\n  validateCalendarDescriptor(descriptor);\n  const selectedDate = descriptor.selectedDate ?? descriptor.defaultSelectedDate ?? null;\n  return resolveCalendarGridDescriptor(descriptor.grid, selectedDate, options);\n}\n\nexport type CalendarNavigationIntent =\n  | \"next-day\"\n  | \"previous-day\"\n  | \"next-week\"\n  | \"previous-week\"\n  | \"first-of-week\"\n  | \"last-of-week\";\n\n/**\n * ArrowLeft/Right flip under RTL, matching `getSelectionNavigationIntent`'s\n * `direction` parameter.\n */\nexport function getCalendarNavigationIntent(\n  key: WebKeyboardKey,\n  direction: DesignSystemDirection = \"ltr\",\n): CalendarNavigationIntent | undefined {\n  if (key === \"Home\") return \"first-of-week\";\n  if (key === \"End\") return \"last-of-week\";\n  if (key === \"ArrowDown\") return \"next-week\";\n  if (key === \"ArrowUp\") return \"previous-week\";\n  if (key === \"ArrowRight\") return direction === \"rtl\" ? \"previous-day\" : \"next-day\";\n  if (key === \"ArrowLeft\") return direction === \"rtl\" ? \"next-day\" : \"previous-day\";\n  return undefined;\n}\n\nexport type CalendarNavigationResult =\n  | Readonly<{ date: string; overflow?: never }>\n  | Readonly<{ date?: never; overflow: \"before\" | \"after\" }>;\n\n/**\n * Pure index arithmetic over the fixed seven-column page. Unlike\n * `getCollectionNavigationTarget`, this does NOT skip disabled dates —\n * per the WAI-ARIA date picker dialog pattern, arrow-key focus must land\n * predictably (down always moves exactly one row) even on a disabled date;\n * only the *activate* action is expected to no-op there. Moving past the\n * edge of this page returns an `overflow` signal instead of wrapping, since\n * HJM does not know the adjacent month's shape — the product pages the\n * month and refocuses the corresponding day.\n */\nexport function getCalendarNavigationTarget<Content>(\n  grid: CalendarGridDescriptor<Content>,\n  currentDate: string,\n  intent: CalendarNavigationIntent,\n): CalendarNavigationResult {\n  validateCalendarGridDescriptor(grid);\n  const currentIndex = grid.cells.findIndex((cell) => cell.date === currentDate);\n  if (currentIndex < 0) {\n    throw new RangeError(`Calendar currentDate is not part of this grid page: ${currentDate}`);\n  }\n\n  const findDated = (from: number, step: number): number | undefined => {\n    for (let index = from; index >= 0 && index < grid.cells.length; index += step) {\n      if (grid.cells[index]?.date !== undefined) return index;\n    }\n    return undefined;\n  };\n\n  const rowStart = Math.floor(currentIndex / GRID_COLUMNS) * GRID_COLUMNS;\n  const rowEnd = rowStart + GRID_COLUMNS - 1;\n\n  if (intent === \"first-of-week\") {\n    const found = findDated(rowStart, 1);\n    return found !== undefined && found <= rowEnd\n      ? { date: grid.cells[found]!.date! }\n      : { overflow: \"before\" };\n  }\n  if (intent === \"last-of-week\") {\n    const found = findDated(rowEnd, -1);\n    return found !== undefined && found >= rowStart\n      ? { date: grid.cells[found]!.date! }\n      : { overflow: \"after\" };\n  }\n\n  const forward = intent === \"next-day\" || intent === \"next-week\";\n  const stride = intent === \"next-week\" || intent === \"previous-week\" ? GRID_COLUMNS : 1;\n  const step = forward ? 1 : -1;\n  const target = currentIndex + step * stride;\n  if (target < 0) return { overflow: \"before\" };\n  if (target >= grid.cells.length) return { overflow: \"after\" };\n  if (grid.cells[target]?.date !== undefined) return { date: grid.cells[target]!.date! };\n  // Landed on a filler (only reachable for a week-step into a partially\n  // filled edge row): keep scanning the same direction for the nearest real\n  // date rather than asking a renderer to interpret a blank cell.\n  const resolved = findDated(target, step);\n  return resolved !== undefined\n    ? { date: grid.cells[resolved]!.date! }\n    : { overflow: forward ? \"after\" : \"before\" };\n}\n\nexport type CalendarSize = \"compact\" | \"medium\" | \"large\";\n\n/**\n * `today` and `selected` are visually independent (a non-selected today and\n * a selected past day must both read clearly) and neither is color-only:\n * today gets a persistent border, selected gets a filled background, and\n * both remain in `accessibleName`/`isToday`/`isSelected` for assistive tech.\n */\nexport const calendarRecipe = {\n  slots: [\n    \"root\",\n    \"header\",\n    \"monthLabel\",\n    \"previousMonth\",\n    \"nextMonth\",\n    \"weekdayRow\",\n    \"weekdayLabel\",\n    \"grid\",\n    \"week\",\n    \"day\",\n    \"dayLabel\",\n    \"content\",\n  ] as const,\n  defaults: { size: \"medium\" },\n  // A week stays scannable: the 1280 Web host spread seven columns to ~135px each (2026-10-17 review). Same width as the\n  // DatePicker popover.\n  maxWidth: layout.readingMaxWidth / 2,\n  header: {\n    gap: spacing.xs,\n    monthLabel: {\n      textVariant: \"title\",\n      fontWeight: typography.title.fontWeight,\n      color: semanticColors.content.primary,\n    },\n    navButton: { diameter: control.buttonHeight.medium, color: semanticColors.content.secondary },\n    navIcon: { previous: \"chevronStart\", next: \"chevronEnd\" },\n  },\n  weekdayLabel: {\n    textVariant: \"label\",\n    color: semanticColors.content.secondary,\n  },\n  sizes: {\n    // Dense annotated calendars need a smaller visual marker without shrinking the hit target.\n    compact: { cellDiameter: control.minTouchTarget, indicatorDiameter: 28, textVariant: \"body\", glyph: \"sm\" },\n    medium: { cellDiameter: control.minTouchTarget, indicatorDiameter: control.minTouchTarget, textVariant: \"body\", glyph: \"sm\" },\n    large: { cellDiameter: glyph.xxl, indicatorDiameter: glyph.xxl, textVariant: \"bodyLarge\", glyph: \"md\" },\n  },\n  day: {\n    radius: \"full\" as const,\n    label: { color: semanticColors.content.body, numericVariant: \"tabular\" },\n    outsideFocusedMonthOpacity: opacity.muted,\n    disabledOpacity: opacity.disabled,\n    today: { border: semanticColors.border.focus, borderWidth: stroke.default },\n    selected: {\n      background: semanticColors.action.brand.background,\n      content: semanticColors.action.brand.content,\n    },\n    focus: focusIndicatorContract,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: CalendarSize };\n  maxWidth: number;\n  header: {\n    gap: number;\n    monthLabel: { textVariant: TextVariant; fontWeight: FontWeightValue; color: ColorReference };\n    navButton: { diameter: number; color: ColorReference };\n    navIcon: { previous: SemanticIconName; next: SemanticIconName };\n  };\n  weekdayLabel: { textVariant: TextVariant; color: ColorReference };\n  sizes: Record<CalendarSize, { cellDiameter: number; indicatorDiameter: number; textVariant: TextVariant; glyph: GlyphSize }>;\n  day: {\n    radius: \"full\";\n    label: { color: ColorReference; numericVariant: \"tabular\" };\n    outsideFocusedMonthOpacity: number;\n    disabledOpacity: number;\n    today: { border: ColorReference; borderWidth: number };\n    selected: { background: ColorReference; content: ColorReference };\n    focus: typeof focusIndicatorContract;\n  };\n};\n\n/**\n * Calendar is `shared`, not `adaptive`: the grid is always visible inline\n * (no popup/Sheet choice to make). Web gets `grid` role + roving-tabindex\n * arrow keys; Native has no composite-widget equivalent, so each date is\n * simply an independently focusable/tappable element and month paging goes\n * through the always-present previous/next buttons on both platforms — same\n * result (the user reaches and picks a date), different path, matching the\n * `beta → stable(adaptive)` gate's standard even though this component\n * itself is not adaptive.\n */\nexport const calendarBehavior = {\n  controlled: [\n    \"selectedDate\",\n    \"defaultSelectedDate\",\n    \"onSelectionChange\",\n    \"focusedMonth\",\n    \"defaultFocusedMonth\",\n    \"onFocusedMonthChange\",\n  ],\n  inputs: [\"grid\", \"monthLabel\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\"],\n    value: [\"selected\"],\n  },\n  web: {\n    roles: [\"grid\", \"row\", \"gridcell\", \"button\"],\n    keyboard: [\n      \"Tab\",\n      \"Enter\",\n      \"Space\",\n      \"ArrowUp\",\n      \"ArrowDown\",\n      \"ArrowLeft\",\n      \"ArrowRight\",\n      \"Home\",\n      \"End\",\n    ],\n    focus: \"roving\",\n  },\n  native: {\n    roles: [\"button\"],\n    states: [\"disabled\", \"selected\"],\n    actions: [\"activate\"],\n  },\n  scenarios: [\n    \"today-and-selected-are-independent-and-both-non-color-marked\",\n    \"disabled-dates-remain-focusable-but-never-activate\",\n    \"arrow-keys-move-by-day-and-week-inside-the-visible-month-page\",\n    \"home-and-end-move-to-the-first-and-last-dated-cell-of-the-focused-row\",\n    \"moving-past-the-visible-grid-edge-requests-a-month-change-instead-of-wrapping\",\n    \"filler-cells-carry-no-accessible-name-and-are-hidden-from-assistive-tech\",\n    \"every-dated-cell-accessible-name-is-composed-by-the-product\",\n    \"changing-the-focused-month-never-changes-or-clears-the-selection\",\n    \"range-selection-is-not-part-of-the-contract\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/card.d.ts

@@ -4,7 +4,7 @@ export type CardHeadingLevel = 2 | 3 | 4;
  * `View` on Native), while these slots and defaults stay identical.
  */
 export declare const cardRecipe: {
-    readonly slots: readonly ["root", "media", "body", "header", "leading", "title", "description", "content", "actions"];
+    readonly slots: readonly ["root", "media", "backgroundMedia", "backgroundInteraction", "mediaBadges", "badges", "mediaAction", "body", "header", "leading", "title", "description", "content", "actions"];
     readonly defaults: {
         readonly tone: "raised";
         readonly selected: false;
@@ -17,12 +17,26 @@ export declare const cardRecipe: {
         readonly disabledOpacity: 0.5;
         readonly pressedOpacity: 0.86;
     };
+    readonly mediaAction: {
+        readonly inset: 12;
+        readonly diameter: 44;
+        readonly iconSize: 20;
+    };
+    readonly backgroundMedia: {
+        readonly scrim: "rgba(0, 0, 0, 0.6)";
+        readonly foreground: "#ffffff";
+    };
+    readonly quotation: {
+        readonly gap: 8;
+        readonly markSize: 24;
+    };
     readonly body: {
         readonly padding: 16;
         readonly gap: 8;
     };
     readonly header: {
         readonly gap: 12;
+        readonly alignItems: "center";
     };
     readonly title: {
         readonly variant: "title";

package/dist/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFtB,CAAC"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGtB,CAAC"}

package/dist/card.js

@@ -1,4 +1,4 @@
-import { spacing } from "./foundations.js";
+import { control, glyph, spacing } from "./foundations.js";
 import { buttonRecipe, } from "./base-recipes.js";
 /**
  * Shared Card anatomy. Renderers own their host nodes (`article` on Web,
@@ -8,6 +8,11 @@ export const cardRecipe = {
     slots: [
         "root",
         "media",
+        "backgroundMedia",
+        "backgroundInteraction",
+        "mediaBadges",
+        "badges",
+        "mediaAction",
         "body",
         "header",
         "leading",
@@ -29,12 +34,20 @@ export const cardRecipe = {
     // BurnTok's compact 3-column picker (2026-10-10) needs the whole card to activate.
     // Reuse control state opacity instead of a product Pressable with a second visual contract.
     interaction: { disabledOpacity: buttonRecipe.opacity.disabled, pressedOpacity: buttonRecipe.opacity.pressed },
+    // A playable cover is one target beside independent creator/comment actions (BurnTok screen migration).
+    mediaAction: { inset: spacing.sm, diameter: control.minTouchTarget, iconSize: glyph.sm },
+    // Decorative artwork needs fixed contrast independent of brand onPrimary (which can be dark).
+    // A 60% black scrim keeps white card text readable even over a white source image.
+    backgroundMedia: { scrim: "rgba(0, 0, 0, 0.6)", foreground: "#ffffff" },
+    quotation: { gap: spacing.xs, markSize: glyph.md },
     body: {
         padding: spacing.md,
         gap: spacing.xs,
     },
     header: {
         gap: spacing.sm,
+        // Short copy and independent commands share one vertical center (BurnTok profile, 2026-10-20).
+        alignItems: "center",
     },
     title: {
         variant: "title",

package/dist/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAI3B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE;QACL,MAAM;QACN,OAAO;QACP,MAAM;QACN,QAAQ;QACR,SAAS;QACT,OAAO;QACP,aAAa;QACb,SAAS;QACT,SAAS;KACD;IACV,QAAQ,EAAE;QACR,8EAA8E;QAC9E,0EAA0E;QAC1E,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,IAAI;KACd;IACD,YAAY,EAAE,QAAQ;IACtB,mFAAmF;IACnF,4FAA4F;IAC5F,WAAW,EAAE,EAAE,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE;IAC7G,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC,EAAE;KAChB;IACD,MAAM,EAAE;QACN,GAAG,EAAE,OAAO,CAAC,EAAE;KAChB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,QAAQ;KACnB;IACD,WAAW,EAAE;QACX,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,OAAO,EAAE;QACP,GAAG,EAAE,OAAO,CAAC,EAAE;QACf,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAC7B,aAAa,EAAE,OAAO,CAAC,EAAE;KAC1B;CAmCF,CAAC","sourcesContent":["import { spacing } from \"./foundations.js\";\nimport {\n  buttonRecipe,\n  type SurfacePadding,\n  type SurfaceTone,\n} from \"./base-recipes.js\";\n\nexport type CardHeadingLevel = 2 | 3 | 4;\n\n/**\n * Shared Card anatomy. Renderers own their host nodes (`article` on Web,\n * `View` on Native), while these slots and defaults stay identical.\n */\nexport const cardRecipe = {\n  slots: [\n    \"root\",\n    \"media\",\n    \"body\",\n    \"header\",\n    \"leading\",\n    \"title\",\n    \"description\",\n    \"content\",\n    \"actions\",\n  ] as const,\n  defaults: {\n    // Today Baseball's schedule cards establish the shared raised card treatment.\n    // Keep plain Surface defaults independent so layout containers stay flat.\n    tone: \"raised\",\n    selected: false,\n    bordered: true,\n    headingLevel: 3,\n    padding: \"md\",\n  },\n  selectedTone: \"accent\",\n  // BurnTok's compact 3-column picker (2026-10-10) needs the whole card to activate.\n  // Reuse control state opacity instead of a product Pressable with a second visual contract.\n  interaction: { disabledOpacity: buttonRecipe.opacity.disabled, pressedOpacity: buttonRecipe.opacity.pressed },\n  body: {\n    padding: spacing.md,\n    gap: spacing.xs,\n  },\n  header: {\n    gap: spacing.sm,\n  },\n  title: {\n    variant: \"title\",\n    tone: \"primary\",\n    emphasis: \"strong\",\n  },\n  description: {\n    variant: \"body\",\n    tone: \"muted\",\n    emphasis: \"regular\",\n  },\n  actions: {\n    gap: spacing.sm,\n    paddingHorizontal: spacing.md,\n    paddingBottom: spacing.md,\n  },\n} as const satisfies {\n  slots: readonly [\n    \"root\",\n    \"media\",\n    \"body\",\n    \"header\",\n    \"leading\",\n    \"title\",\n    \"description\",\n    \"content\",\n    \"actions\",\n  ];\n  defaults: {\n    tone: SurfaceTone;\n    selected: boolean;\n    bordered: boolean;\n    headingLevel: CardHeadingLevel;\n    padding: SurfacePadding;\n  };\n  selectedTone: SurfaceTone;\n  interaction: { disabledOpacity: number; pressedOpacity: number };\n  body: { padding: number; gap: number };\n  header: { gap: number };\n  title: {\n    variant: \"title\";\n    tone: \"primary\";\n    emphasis: \"strong\";\n  };\n  description: {\n    variant: \"body\";\n    tone: \"muted\";\n    emphasis: \"regular\";\n  };\n  actions: { gap: number; paddingHorizontal: number; paddingBottom: number };\n};\n"]}
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAI3B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE;QACL,MAAM;QACN,OAAO;QACP,iBAAiB;QACjB,uBAAuB;QACvB,aAAa;QACb,QAAQ;QACR,aAAa;QACb,MAAM;QACN,QAAQ;QACR,SAAS;QACT,OAAO;QACP,aAAa;QACb,SAAS;QACT,SAAS;KACD;IACV,QAAQ,EAAE;QACR,8EAA8E;QAC9E,0EAA0E;QAC1E,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,IAAI;KACd;IACD,YAAY,EAAE,QAAQ;IACtB,mFAAmF;IACnF,4FAA4F;IAC5F,WAAW,EAAE,EAAE,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE;IAC7G,wGAAwG;IACxG,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;IACxF,8FAA8F;IAC9F,mFAAmF;IACnF,eAAe,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,EAAE;IACvE,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;IAClD,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC,EAAE;KAChB;IACD,MAAM,EAAE;QACN,GAAG,EAAE,OAAO,CAAC,EAAE;QACf,+FAA+F;QAC/F,UAAU,EAAE,QAAQ;KACrB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,QAAQ;KACnB;IACD,WAAW,EAAE;QACX,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,OAAO,EAAE;QACP,GAAG,EAAE,OAAO,CAAC,EAAE;QACf,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAC7B,aAAa,EAAE,OAAO,CAAC,EAAE;KAC1B;CA2CF,CAAC","sourcesContent":["import { control, glyph, spacing } from \"./foundations.js\";\nimport {\n  buttonRecipe,\n  type SurfacePadding,\n  type SurfaceTone,\n} from \"./base-recipes.js\";\n\nexport type CardHeadingLevel = 2 | 3 | 4;\n\n/**\n * Shared Card anatomy. Renderers own their host nodes (`article` on Web,\n * `View` on Native), while these slots and defaults stay identical.\n */\nexport const cardRecipe = {\n  slots: [\n    \"root\",\n    \"media\",\n    \"backgroundMedia\",\n    \"backgroundInteraction\",\n    \"mediaBadges\",\n    \"badges\",\n    \"mediaAction\",\n    \"body\",\n    \"header\",\n    \"leading\",\n    \"title\",\n    \"description\",\n    \"content\",\n    \"actions\",\n  ] as const,\n  defaults: {\n    // Today Baseball's schedule cards establish the shared raised card treatment.\n    // Keep plain Surface defaults independent so layout containers stay flat.\n    tone: \"raised\",\n    selected: false,\n    bordered: true,\n    headingLevel: 3,\n    padding: \"md\",\n  },\n  selectedTone: \"accent\",\n  // BurnTok's compact 3-column picker (2026-10-10) needs the whole card to activate.\n  // Reuse control state opacity instead of a product Pressable with a second visual contract.\n  interaction: { disabledOpacity: buttonRecipe.opacity.disabled, pressedOpacity: buttonRecipe.opacity.pressed },\n  // A playable cover is one target beside independent creator/comment actions (BurnTok screen migration).\n  mediaAction: { inset: spacing.sm, diameter: control.minTouchTarget, iconSize: glyph.sm },\n  // Decorative artwork needs fixed contrast independent of brand onPrimary (which can be dark).\n  // A 60% black scrim keeps white card text readable even over a white source image.\n  backgroundMedia: { scrim: \"rgba(0, 0, 0, 0.6)\", foreground: \"#ffffff\" },\n  quotation: { gap: spacing.xs, markSize: glyph.md },\n  body: {\n    padding: spacing.md,\n    gap: spacing.xs,\n  },\n  header: {\n    gap: spacing.sm,\n    // Short copy and independent commands share one vertical center (BurnTok profile, 2026-10-20).\n    alignItems: \"center\",\n  },\n  title: {\n    variant: \"title\",\n    tone: \"primary\",\n    emphasis: \"strong\",\n  },\n  description: {\n    variant: \"body\",\n    tone: \"muted\",\n    emphasis: \"regular\",\n  },\n  actions: {\n    gap: spacing.sm,\n    paddingHorizontal: spacing.md,\n    paddingBottom: spacing.md,\n  },\n} as const satisfies {\n  slots: readonly [\n    \"root\",\n    \"media\",\n    \"backgroundMedia\",\n    \"backgroundInteraction\",\n    \"mediaBadges\",\n    \"badges\",\n    \"mediaAction\",\n    \"body\",\n    \"header\",\n    \"leading\",\n    \"title\",\n    \"description\",\n    \"content\",\n    \"actions\",\n  ];\n  defaults: {\n    tone: SurfaceTone;\n    selected: boolean;\n    bordered: boolean;\n    headingLevel: CardHeadingLevel;\n    padding: SurfacePadding;\n  };\n  selectedTone: SurfaceTone;\n  interaction: { disabledOpacity: number; pressedOpacity: number };\n  mediaAction: { inset: number; diameter: number; iconSize: number };\n  backgroundMedia: { scrim: string; foreground: string };\n  quotation: { gap: number; markSize: number };\n  body: { padding: number; gap: number };\n  header: { gap: number; alignItems: \"center\" };\n  title: {\n    variant: \"title\";\n    tone: \"primary\";\n    emphasis: \"strong\";\n  };\n  description: {\n    variant: \"body\";\n    tone: \"muted\";\n    emphasis: \"regular\";\n  };\n  actions: { gap: number; paddingHorizontal: number; paddingBottom: number };\n};\n"]}

package/dist/carousel.d.ts

@@ -132,6 +132,8 @@ export type PageIndicatorDescriptor = Readonly<{
     count: number;
     /** Zero-based current page. */
     currentIndex: number;
+    /** Limit the visible window around the current page; omitted shows every page. */
+    maxVisibleDots?: number;
 }>;
 export type PageIndicatorAccessibleNameInfo = Readonly<{
     position: number;
@@ -166,6 +168,7 @@ export declare const carouselRecipe: {
     };
     readonly dot: {
         readonly diameter: 8;
+        readonly compactGap: 8;
         readonly hitTarget: 44;
         readonly color: {
             readonly inactive: Readonly<{

package/dist/carousel.d.ts.map

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

package/dist/carousel.js

@@ -134,13 +134,21 @@ export function validatePageIndicatorDescriptor(descriptor) {
         descriptor.currentIndex >= descriptor.count) {
         throw new RangeError(`PageIndicator currentIndex is out of range: ${String(descriptor.currentIndex)}`);
     }
+    if (descriptor.maxVisibleDots !== undefined && (!Number.isSafeInteger(descriptor.maxVisibleDots) || descriptor.maxVisibleDots < 1)) {
+        throw new RangeError("PageIndicator maxVisibleDots must be a positive integer");
+    }
 }
 export function resolvePageIndicator(descriptor, composeAccessibleName) {
     validatePageIndicatorDescriptor(descriptor);
     if (typeof composeAccessibleName !== "function") {
         throw new TypeError("PageIndicator composeAccessibleName must be a function");
     }
-    return Array.from({ length: descriptor.count }, (_, index) => {
+    // Product-owned launchers can contain many pages. Keep the current page in a bounded window without
+    // renumbering it: accessibility names and navigation still address the complete pager.
+    const length = Math.min(descriptor.count, descriptor.maxVisibleDots ?? descriptor.count);
+    const start = Math.max(0, Math.min(descriptor.currentIndex - Math.floor(length / 2), descriptor.count - length));
+    return Array.from({ length }, (_, offset) => {
+        const index = start + offset;
         const accessibleName = composeAccessibleName({ position: index + 1, total: descriptor.count });
         if (typeof accessibleName !== "string" || accessibleName.trim().length === 0) {
             throw new TypeError("PageIndicator composeAccessibleName must return a non-empty string");
@@ -177,6 +185,7 @@ export const carouselRecipe = {
     },
     dot: {
         diameter: 8,
+        compactGap: spacing.xs,
         hitTarget: control.minTouchTarget,
         color: {
             inactive: semanticColors.border.strong,

package/dist/carousel.js.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../src/carousel.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BehaviorContract } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, motionPreset, opacity, spacing } from \"./foundations.js\";\nimport { assertFiniteNumber } from \"./number-field.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * Ant Design Carousel's default infinite loop is intentionally not reproduced;\n * autoplay remains opt-in in both libraries — automatic movement can obscure what this contract treats as\n * non-negotiable: a reliable answer to \"where am I, and where does it end\".\n * See docs/carousel.md for the accessibility rationale on every point below.\n */\nexport type CarouselSlideDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  /** Accessible name for the slide, e.g. \"8/19 두산 vs LG\". The slide's visual content is product-owned. */\n  label: string;\n}>;\n\nexport type CarouselAutoplayConfig = Readonly<{\n  /** Minimum time a slide stays current before an automatic advance. */\n  intervalMs: number;\n}>;\n\n/**\n * Renderer-facing prop shape only — mirrors SelectSelection's controlled/\n * uncontrolled duality, but the resolver below always takes a concrete,\n * already-resolved `currentKey` (see CarouselDescriptor) so validation and\n * position math never have to branch on which mode the product chose.\n */\nexport type ControlledCarouselSelection<Id extends string = string> = Readonly<{\n  currentKey: Id;\n  defaultCurrentKey?: never;\n  onCurrentKeyChange(key: Id): void;\n}>;\n\n/** After mount, removing the current slide selects the slide at its previous\n * position, clamped to the new last position, and emits onCurrentKeyChange once.\n * An invalid initial default and an empty collection still fail validation. */\nexport type UncontrolledCarouselSelection<Id extends string = string> = Readonly<{\n  currentKey?: never;\n  defaultCurrentKey?: Id;\n  onCurrentKeyChange?: (key: Id) => void;\n}>;\n\nexport type CarouselSelection<Id extends string = string> =\n  | ControlledCarouselSelection<Id>\n  | UncontrolledCarouselSelection<Id>;\n\nexport type CarouselDescriptor<Id extends string = string> = Readonly<{\n  slides: readonly CarouselSlideDescriptor<Id>[];\n  currentKey: Id;\n  /** Absent by default. Autoplay is opt-in — see docs/carousel.md. */\n  autoplay?: CarouselAutoplayConfig;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`Carousel ${field} must not be empty`);\n  }\n}\n\nexport function validateCarouselSlide<Id extends string>(\n  slide: CarouselSlideDescriptor<Id>,\n): void {\n  assertNonEmpty(slide.id, \"slide id\");\n  if (slide.id !== slide.id.trim()) {\n    throw new TypeError(\"Carousel slide id must not start or end with whitespace\");\n  }\n  assertNonEmpty(slide.label, \"slide label\");\n}\n\nexport function validateCarouselAutoplayConfig(\n  autoplay: CarouselAutoplayConfig,\n): void {\n  assertFiniteNumber(autoplay.intervalMs, \"autoplay.intervalMs\");\n  if (autoplay.intervalMs <= 0) {\n    throw new RangeError(\"Carousel autoplay.intervalMs must be greater than zero\");\n  }\n}\n\nexport function validateCarouselDescriptor<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n): void {\n  if (descriptor.slides.length === 0) {\n    throw new RangeError(\"Carousel must contain at least one slide\");\n  }\n  const ids = new Set<Id>();\n  for (const slide of descriptor.slides) {\n    validateCarouselSlide(slide);\n    if (ids.has(slide.id)) {\n      throw new TypeError(`Duplicate Carousel slide id: ${slide.id}`);\n    }\n    ids.add(slide.id);\n  }\n  if (!ids.has(descriptor.currentKey)) {\n    throw new RangeError(\n      `Carousel currentKey does not match any slide id: ${String(descriptor.currentKey)}`,\n    );\n  }\n  if (descriptor.autoplay) {\n    validateCarouselAutoplayConfig(descriptor.autoplay);\n  }\n}\n\nexport type CarouselAccessibleNameInfo = Readonly<{\n  position: number;\n  total: number;\n  label: string;\n}>;\n\n/**\n * Same reason Steps and Timeline do not assemble their own accessible name:\n * counter-word grammar and phrase order are product-owned copy decisions.\n */\nexport type ComposeCarouselAccessibleName = (\n  info: CarouselAccessibleNameInfo,\n) => string;\n\nexport type ResolvedCarouselSlideDescriptor<Id extends string = string> =\n  CarouselSlideDescriptor<Id> &\n    Readonly<{\n      /** 1-indexed so position and label both preserve reading order for renderers. */\n      position: number;\n      total: number;\n      current: boolean;\n      /**\n       * True for every slide but the current one. A renderer must exclude an\n       * inert slide's interactive content from both focus and the\n       * accessibility tree — a hidden slide whose link can still receive\n       * focus is worse than one that is simply unreachable until the user\n       * advances to it (see docs/carousel.md).\n       */\n      inert: boolean;\n      accessibleName: string;\n    }>;\n\nexport type ResolveCarouselOptions = Readonly<{\n  composeAccessibleName: ComposeCarouselAccessibleName;\n}>;\n\n/**\n * Attaches order, current/inert, and the composed accessible name used by\n * both the slide group and its indicator dot — one composer, reused for\n * every render target, the same way Steps reuses a single composer.\n */\nexport function resolveCarouselDescriptor<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n  options: ResolveCarouselOptions,\n): readonly ResolvedCarouselSlideDescriptor<Id>[] {\n  validateCarouselDescriptor(descriptor);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Carousel composeAccessibleName must be a function\");\n  }\n\n  const total = descriptor.slides.length;\n  return descriptor.slides.map((slide, index) => {\n    const position = index + 1;\n    const current = slide.id === descriptor.currentKey;\n    const accessibleName = options.composeAccessibleName({\n      position,\n      total,\n      label: slide.label,\n    });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\n        \"Carousel composeAccessibleName must return a non-empty string\",\n      );\n    }\n    return { ...slide, position, total, current, inert: !current, accessibleName };\n  });\n}\n\nexport type CarouselNavigationIntent = \"next\" | \"previous\" | \"first\" | \"last\";\n\n/**\n * Clamps at the first/last slide instead of wrapping — infinite loop is out\n * of scope (see docs/carousel.md), so there is no modulo here at all, unlike\n * getCollectionNavigationTarget's `loop` parameter elsewhere in this package.\n */\nexport function getCarouselNavigationTarget<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n  intent: CarouselNavigationIntent,\n): Id {\n  validateCarouselDescriptor(descriptor);\n  const { slides, currentKey } = descriptor;\n  if (intent === \"first\") return slides[0]!.id;\n  if (intent === \"last\") return slides.at(-1)!.id;\n  const currentIndex = slides.findIndex((slide) => slide.id === currentKey);\n  const delta = intent === \"next\" ? 1 : -1;\n  const clampedIndex = Math.min(\n    Math.max(currentIndex + delta, 0),\n    slides.length - 1,\n  );\n  return slides[clampedIndex]!.id;\n}\n\nexport type CarouselAutoplayInputs = Readonly<{\n  /** True whenever a platform reduce-motion preference is active. */\n  reducedMotion: boolean;\n  /** Renderer-combined pointer hover, focus-within, and drag signal. */\n  paused: boolean;\n}>;\n\n/**\n * Autoplay is never active without an explicit config, under reduce motion,\n * or while the user is hovering, focusing, or dragging the carousel — the\n * three guards the brief requires are one function so a renderer cannot wire\n * an autoplay timer that forgets one of them.\n */\nexport function isCarouselAutoplayActive(\n  autoplay: CarouselAutoplayConfig | undefined,\n  inputs: CarouselAutoplayInputs,\n): boolean {\n  if (!autoplay) return false;\n  validateCarouselAutoplayConfig(autoplay);\n  return !inputs.reducedMotion && !inputs.paused;\n}\n\nexport const carouselBehaviorDefaults = {\n  autoplay: false,\n} as const satisfies Readonly<{ autoplay: boolean }>;\n\nexport const carouselBehavior = {\n  controlled: [\"currentKey\", \"defaultCurrentKey\", \"onCurrentKeyChange\"],\n  inputs: [\"autoplay\", \"reducedMotion\", \"dragged\"],\n  defaults: carouselBehaviorDefaults,\n  stateAxes: {\n    interaction: [\"idle\", \"dragged\"],\n    value: [\"selected\"],\n  },\n  web: {\n    roles: [\"region\", \"group\"],\n    keyboard: [\"Tab\", \"Enter\", \"Space\", \"ArrowLeft\", \"ArrowRight\"],\n    focus: \"native\",\n  },\n  native: {\n    roles: [\"adjustable\"],\n    states: [\"selected\"],\n    actions: [\"increment\", \"decrement\"],\n  },\n  scenarios: [\n    \"current-position-is-announced-with-a-readable-name-not-dots-alone\",\n    \"inactive-slide-content-is-excluded-from-focus-and-the-accessibility-tree\",\n    \"previous-next-and-dot-controls-stay-in-tab-order-regardless-of-current-slide\",\n    \"arrow-keys-move-one-slide-on-web-swipe-moves-one-slide-on-native\",\n    \"boundary-slides-clamp-instead-of-wrapping-because-loop-is-out-of-scope\",\n    \"autoplay-is-opt-in-and-off-by-default\",\n    \"autoplay-never-runs-when-reduced-motion-is-active\",\n    \"autoplay-pauses-on-hover-focus-or-drag-and-does-not-announce-automatic-transitions\",\n  ],\n} as const satisfies BehaviorContract;\n\n/**\n * PageIndicator is Carousel's position dot row on its own, for a product-owned pager (a paging FlatList or\n * scroll-snap row) that Carousel cannot host because Carousel owns its slides. It reuses `carouselRecipe.dot`\n * and the same clamped navigation, so both rows look and behave the same. Added 2026-10-18 for the Utilverse\n * launcher, which drew its own dots under a native pager.\n */\nexport type PageIndicatorDescriptor = Readonly<{\n  /** Number of pages, at least 1. */\n  count: number;\n  /** Zero-based current page. */\n  currentIndex: number;\n}>;\n\nexport type PageIndicatorAccessibleNameInfo = Readonly<{ position: number; total: number }>;\n\n/** Product-owned copy for one page, e.g. \"Home page 2 of 5\" — counter grammar is not the renderer's. */\nexport type ComposePageIndicatorAccessibleName = (info: PageIndicatorAccessibleNameInfo) => string;\n\nexport type ResolvedPageIndicatorDot = Readonly<{\n  index: number;\n  /** 1-indexed reading position. */\n  position: number;\n  total: number;\n  current: boolean;\n  accessibleName: string;\n}>;\n\nexport function validatePageIndicatorDescriptor(descriptor: PageIndicatorDescriptor): void {\n  if (!Number.isSafeInteger(descriptor.count) || descriptor.count < 1) {\n    throw new RangeError(\"PageIndicator count must be a positive integer\");\n  }\n  if (\n    !Number.isSafeInteger(descriptor.currentIndex) ||\n    descriptor.currentIndex < 0 ||\n    descriptor.currentIndex >= descriptor.count\n  ) {\n    throw new RangeError(`PageIndicator currentIndex is out of range: ${String(descriptor.currentIndex)}`);\n  }\n}\n\nexport function resolvePageIndicator(\n  descriptor: PageIndicatorDescriptor,\n  composeAccessibleName: ComposePageIndicatorAccessibleName,\n): readonly ResolvedPageIndicatorDot[] {\n  validatePageIndicatorDescriptor(descriptor);\n  if (typeof composeAccessibleName !== \"function\") {\n    throw new TypeError(\"PageIndicator composeAccessibleName must be a function\");\n  }\n  return Array.from({ length: descriptor.count }, (_, index) => {\n    const accessibleName = composeAccessibleName({ position: index + 1, total: descriptor.count });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\"PageIndicator composeAccessibleName must return a non-empty string\");\n    }\n    return { index, position: index + 1, total: descriptor.count, current: index === descriptor.currentIndex, accessibleName };\n  });\n}\n\n/** Clamps like getCarouselNavigationTarget: a pager indicator has an end, it never wraps. */\nexport function getPageIndicatorTarget(\n  descriptor: PageIndicatorDescriptor,\n  intent: CarouselNavigationIntent,\n): number {\n  validatePageIndicatorDescriptor(descriptor);\n  if (intent === \"first\") return 0;\n  if (intent === \"last\") return descriptor.count - 1;\n  return Math.min(Math.max(descriptor.currentIndex + (intent === \"next\" ? 1 : -1), 0), descriptor.count - 1);\n}\n\nexport type CarouselSize = \"medium\";\n\nexport const carouselRecipe = {\n  slots: [\n    \"root\",\n    \"track\",\n    \"slide\",\n    \"dots\",\n    \"dot\",\n    \"previousControl\",\n    \"nextControl\",\n  ] as const,\n  defaults: { size: \"medium\" },\n  sizes: {\n    medium: {\n      gap: spacing.sm,\n      controlHitTarget: control.minTouchTarget,\n      controlIcon: \"sm\",\n    },\n  },\n  dot: {\n    diameter: 8,\n    hitTarget: control.minTouchTarget,\n    color: {\n      inactive: semanticColors.border.strong,\n      current: semanticColors.content.brand,\n    },\n  },\n  /** Previous/next chrome is composed from IconButton (ghost tone) rather than owning new button visuals. */\n  control: {\n    icons: {\n      previous: \"chevronStart\",\n      next: \"chevronEnd\",\n    } as const satisfies Readonly<{ previous: SemanticIconName; next: SemanticIconName }>,\n  },\n  states: {\n    focus: focusIndicatorContract,\n    draggedOpacity: opacity.dragged,\n  },\n  /**\n   * Manual slide-to-slide movement crossfades rather than snapping under\n   * Reduce Motion, reusing the existing \"context\" preset instead of a new\n   * token — autoplay itself simply does not run at all (isCarouselAutoplayActive).\n   */\n  transition: motionPreset.context,\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: CarouselSize };\n  sizes: Record<\n    CarouselSize,\n    { gap: number; controlHitTarget: number; controlIcon: string }\n  >;\n  dot: {\n    diameter: number;\n    hitTarget: number;\n    color: Record<\"inactive\" | \"current\", ColorReference>;\n  };\n  control: {\n    icons: Readonly<{ previous: SemanticIconName; next: SemanticIconName }>;\n  };\n  states: {\n    focus: typeof focusIndicatorContract;\n    draggedOpacity: number;\n  };\n  transition: typeof motionPreset.context;\n};\n"]}
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../src/carousel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmDtD,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,YAAY,KAAK,oBAAoB,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAkC;IAElC,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAgC;IAEhC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAkC;IAElC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAM,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,gCAAgC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,UAAU,CAClB,oDAAoD,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,8BAA8B,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAsCD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkC,EAClC,OAA+B;IAE/B,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,OAAO,OAAO,CAAC,qBAAqB,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,UAAU,CAAC;QACnD,MAAM,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;YACnD,QAAQ;YACR,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,SAAS,CACjB,+DAA+D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkC,EAClC,MAAgC;IAEhC,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IAC1C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC,CAAC,EACjC,MAAM,CAAC,MAAM,GAAG,CAAC,CAClB,CAAC;IACF,OAAO,MAAM,CAAC,YAAY,CAAE,CAAC,EAAE,CAAC;AAClC,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA4C,EAC5C,MAA8B;IAE9B,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ,EAAE,KAAK;CACmC,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,CAAC,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,CAAC;IACrE,MAAM,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC;IAChD,QAAQ,EAAE,wBAAwB;IAClC,SAAS,EAAE;QACT,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAChC,KAAK,EAAE,CAAC,UAAU,CAAC;KACpB;IACD,GAAG,EAAE;QACH,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC;QAC9D,KAAK,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,YAAY,CAAC;QACrB,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;KACpC;IACD,SAAS,EAAE;QACT,mEAAmE;QACnE,0EAA0E;QAC1E,8EAA8E;QAC9E,kEAAkE;QAClE,wEAAwE;QACxE,uCAAuC;QACvC,mDAAmD;QACnD,oFAAoF;KACrF;CACkC,CAAC;AA+BtC,MAAM,UAAU,+BAA+B,CAAC,UAAmC;IACjF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IACD,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC;QAC9C,UAAU,CAAC,YAAY,GAAG,CAAC;QAC3B,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,KAAK,EAC3C,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,+CAA+C,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;QACnI,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAmC,EACnC,qBAAyD;IAEzD,+BAA+B,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAChF,CAAC;IACD,oGAAoG;IACpG,uFAAuF;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IACjH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;QAC7B,MAAM,cAAc,GAAG,qBAAqB,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/F,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,KAAK,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,CAAC;IAC7H,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CACpC,UAAmC,EACnC,MAAgC;IAEhC,+BAA+B,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC7G,CAAC;AAID,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE;QACL,MAAM;QACN,OAAO;QACP,OAAO;QACP,MAAM;QACN,KAAK;QACL,iBAAiB;QACjB,aAAa;KACL;IACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,KAAK,EAAE;QACL,MAAM,EAAE;YACN,GAAG,EAAE,OAAO,CAAC,EAAE;YACf,gBAAgB,EAAE,OAAO,CAAC,cAAc;YACxC,WAAW,EAAE,IAAI;SAClB;KACF;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,OAAO,CAAC,EAAE;QACtB,SAAS,EAAE,OAAO,CAAC,cAAc;QACjC,KAAK,EAAE;YACL,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM;YACtC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK;SACtC;KACF;IACD,2GAA2G;IAC3G,OAAO,EAAE;QACP,KAAK,EAAE;YACL,QAAQ,EAAE,cAAc;YACxB,IAAI,EAAE,YAAY;SACiE;KACtF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,sBAAsB;QAC7B,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC;IACD;;;;OAIG;IACH,UAAU,EAAE,YAAY,CAAC,OAAO;CAsBjC,CAAC","sourcesContent":["import type { BehaviorContract } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, motionPreset, opacity, spacing } from \"./foundations.js\";\nimport { assertFiniteNumber } from \"./number-field.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * Ant Design Carousel's default infinite loop is intentionally not reproduced;\n * autoplay remains opt-in in both libraries — automatic movement can obscure what this contract treats as\n * non-negotiable: a reliable answer to \"where am I, and where does it end\".\n * See docs/carousel.md for the accessibility rationale on every point below.\n */\nexport type CarouselSlideDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  /** Accessible name for the slide, e.g. \"8/19 두산 vs LG\". The slide's visual content is product-owned. */\n  label: string;\n}>;\n\nexport type CarouselAutoplayConfig = Readonly<{\n  /** Minimum time a slide stays current before an automatic advance. */\n  intervalMs: number;\n}>;\n\n/**\n * Renderer-facing prop shape only — mirrors SelectSelection's controlled/\n * uncontrolled duality, but the resolver below always takes a concrete,\n * already-resolved `currentKey` (see CarouselDescriptor) so validation and\n * position math never have to branch on which mode the product chose.\n */\nexport type ControlledCarouselSelection<Id extends string = string> = Readonly<{\n  currentKey: Id;\n  defaultCurrentKey?: never;\n  onCurrentKeyChange(key: Id): void;\n}>;\n\n/** After mount, removing the current slide selects the slide at its previous\n * position, clamped to the new last position, and emits onCurrentKeyChange once.\n * An invalid initial default and an empty collection still fail validation. */\nexport type UncontrolledCarouselSelection<Id extends string = string> = Readonly<{\n  currentKey?: never;\n  defaultCurrentKey?: Id;\n  onCurrentKeyChange?: (key: Id) => void;\n}>;\n\nexport type CarouselSelection<Id extends string = string> =\n  | ControlledCarouselSelection<Id>\n  | UncontrolledCarouselSelection<Id>;\n\nexport type CarouselDescriptor<Id extends string = string> = Readonly<{\n  slides: readonly CarouselSlideDescriptor<Id>[];\n  currentKey: Id;\n  /** Absent by default. Autoplay is opt-in — see docs/carousel.md. */\n  autoplay?: CarouselAutoplayConfig;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`Carousel ${field} must not be empty`);\n  }\n}\n\nexport function validateCarouselSlide<Id extends string>(\n  slide: CarouselSlideDescriptor<Id>,\n): void {\n  assertNonEmpty(slide.id, \"slide id\");\n  if (slide.id !== slide.id.trim()) {\n    throw new TypeError(\"Carousel slide id must not start or end with whitespace\");\n  }\n  assertNonEmpty(slide.label, \"slide label\");\n}\n\nexport function validateCarouselAutoplayConfig(\n  autoplay: CarouselAutoplayConfig,\n): void {\n  assertFiniteNumber(autoplay.intervalMs, \"autoplay.intervalMs\");\n  if (autoplay.intervalMs <= 0) {\n    throw new RangeError(\"Carousel autoplay.intervalMs must be greater than zero\");\n  }\n}\n\nexport function validateCarouselDescriptor<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n): void {\n  if (descriptor.slides.length === 0) {\n    throw new RangeError(\"Carousel must contain at least one slide\");\n  }\n  const ids = new Set<Id>();\n  for (const slide of descriptor.slides) {\n    validateCarouselSlide(slide);\n    if (ids.has(slide.id)) {\n      throw new TypeError(`Duplicate Carousel slide id: ${slide.id}`);\n    }\n    ids.add(slide.id);\n  }\n  if (!ids.has(descriptor.currentKey)) {\n    throw new RangeError(\n      `Carousel currentKey does not match any slide id: ${String(descriptor.currentKey)}`,\n    );\n  }\n  if (descriptor.autoplay) {\n    validateCarouselAutoplayConfig(descriptor.autoplay);\n  }\n}\n\nexport type CarouselAccessibleNameInfo = Readonly<{\n  position: number;\n  total: number;\n  label: string;\n}>;\n\n/**\n * Same reason Steps and Timeline do not assemble their own accessible name:\n * counter-word grammar and phrase order are product-owned copy decisions.\n */\nexport type ComposeCarouselAccessibleName = (\n  info: CarouselAccessibleNameInfo,\n) => string;\n\nexport type ResolvedCarouselSlideDescriptor<Id extends string = string> =\n  CarouselSlideDescriptor<Id> &\n    Readonly<{\n      /** 1-indexed so position and label both preserve reading order for renderers. */\n      position: number;\n      total: number;\n      current: boolean;\n      /**\n       * True for every slide but the current one. A renderer must exclude an\n       * inert slide's interactive content from both focus and the\n       * accessibility tree — a hidden slide whose link can still receive\n       * focus is worse than one that is simply unreachable until the user\n       * advances to it (see docs/carousel.md).\n       */\n      inert: boolean;\n      accessibleName: string;\n    }>;\n\nexport type ResolveCarouselOptions = Readonly<{\n  composeAccessibleName: ComposeCarouselAccessibleName;\n}>;\n\n/**\n * Attaches order, current/inert, and the composed accessible name used by\n * both the slide group and its indicator dot — one composer, reused for\n * every render target, the same way Steps reuses a single composer.\n */\nexport function resolveCarouselDescriptor<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n  options: ResolveCarouselOptions,\n): readonly ResolvedCarouselSlideDescriptor<Id>[] {\n  validateCarouselDescriptor(descriptor);\n  if (typeof options.composeAccessibleName !== \"function\") {\n    throw new TypeError(\"Carousel composeAccessibleName must be a function\");\n  }\n\n  const total = descriptor.slides.length;\n  return descriptor.slides.map((slide, index) => {\n    const position = index + 1;\n    const current = slide.id === descriptor.currentKey;\n    const accessibleName = options.composeAccessibleName({\n      position,\n      total,\n      label: slide.label,\n    });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\n        \"Carousel composeAccessibleName must return a non-empty string\",\n      );\n    }\n    return { ...slide, position, total, current, inert: !current, accessibleName };\n  });\n}\n\nexport type CarouselNavigationIntent = \"next\" | \"previous\" | \"first\" | \"last\";\n\n/**\n * Clamps at the first/last slide instead of wrapping — infinite loop is out\n * of scope (see docs/carousel.md), so there is no modulo here at all, unlike\n * getCollectionNavigationTarget's `loop` parameter elsewhere in this package.\n */\nexport function getCarouselNavigationTarget<Id extends string>(\n  descriptor: CarouselDescriptor<Id>,\n  intent: CarouselNavigationIntent,\n): Id {\n  validateCarouselDescriptor(descriptor);\n  const { slides, currentKey } = descriptor;\n  if (intent === \"first\") return slides[0]!.id;\n  if (intent === \"last\") return slides.at(-1)!.id;\n  const currentIndex = slides.findIndex((slide) => slide.id === currentKey);\n  const delta = intent === \"next\" ? 1 : -1;\n  const clampedIndex = Math.min(\n    Math.max(currentIndex + delta, 0),\n    slides.length - 1,\n  );\n  return slides[clampedIndex]!.id;\n}\n\nexport type CarouselAutoplayInputs = Readonly<{\n  /** True whenever a platform reduce-motion preference is active. */\n  reducedMotion: boolean;\n  /** Renderer-combined pointer hover, focus-within, and drag signal. */\n  paused: boolean;\n}>;\n\n/**\n * Autoplay is never active without an explicit config, under reduce motion,\n * or while the user is hovering, focusing, or dragging the carousel — the\n * three guards the brief requires are one function so a renderer cannot wire\n * an autoplay timer that forgets one of them.\n */\nexport function isCarouselAutoplayActive(\n  autoplay: CarouselAutoplayConfig | undefined,\n  inputs: CarouselAutoplayInputs,\n): boolean {\n  if (!autoplay) return false;\n  validateCarouselAutoplayConfig(autoplay);\n  return !inputs.reducedMotion && !inputs.paused;\n}\n\nexport const carouselBehaviorDefaults = {\n  autoplay: false,\n} as const satisfies Readonly<{ autoplay: boolean }>;\n\nexport const carouselBehavior = {\n  controlled: [\"currentKey\", \"defaultCurrentKey\", \"onCurrentKeyChange\"],\n  inputs: [\"autoplay\", \"reducedMotion\", \"dragged\"],\n  defaults: carouselBehaviorDefaults,\n  stateAxes: {\n    interaction: [\"idle\", \"dragged\"],\n    value: [\"selected\"],\n  },\n  web: {\n    roles: [\"region\", \"group\"],\n    keyboard: [\"Tab\", \"Enter\", \"Space\", \"ArrowLeft\", \"ArrowRight\"],\n    focus: \"native\",\n  },\n  native: {\n    roles: [\"adjustable\"],\n    states: [\"selected\"],\n    actions: [\"increment\", \"decrement\"],\n  },\n  scenarios: [\n    \"current-position-is-announced-with-a-readable-name-not-dots-alone\",\n    \"inactive-slide-content-is-excluded-from-focus-and-the-accessibility-tree\",\n    \"previous-next-and-dot-controls-stay-in-tab-order-regardless-of-current-slide\",\n    \"arrow-keys-move-one-slide-on-web-swipe-moves-one-slide-on-native\",\n    \"boundary-slides-clamp-instead-of-wrapping-because-loop-is-out-of-scope\",\n    \"autoplay-is-opt-in-and-off-by-default\",\n    \"autoplay-never-runs-when-reduced-motion-is-active\",\n    \"autoplay-pauses-on-hover-focus-or-drag-and-does-not-announce-automatic-transitions\",\n  ],\n} as const satisfies BehaviorContract;\n\n/**\n * PageIndicator is Carousel's position dot row on its own, for a product-owned pager (a paging FlatList or\n * scroll-snap row) that Carousel cannot host because Carousel owns its slides. It reuses `carouselRecipe.dot`\n * and the same clamped navigation, so both rows look and behave the same. Added 2026-10-18 for the Utilverse\n * launcher, which drew its own dots under a native pager.\n */\nexport type PageIndicatorDescriptor = Readonly<{\n  /** Number of pages, at least 1. */\n  count: number;\n  /** Zero-based current page. */\n  currentIndex: number;\n  /** Limit the visible window around the current page; omitted shows every page. */\n  maxVisibleDots?: number;\n}>;\n\nexport type PageIndicatorAccessibleNameInfo = Readonly<{ position: number; total: number }>;\n\n/** Product-owned copy for one page, e.g. \"Home page 2 of 5\" — counter grammar is not the renderer's. */\nexport type ComposePageIndicatorAccessibleName = (info: PageIndicatorAccessibleNameInfo) => string;\n\nexport type ResolvedPageIndicatorDot = Readonly<{\n  index: number;\n  /** 1-indexed reading position. */\n  position: number;\n  total: number;\n  current: boolean;\n  accessibleName: string;\n}>;\n\nexport function validatePageIndicatorDescriptor(descriptor: PageIndicatorDescriptor): void {\n  if (!Number.isSafeInteger(descriptor.count) || descriptor.count < 1) {\n    throw new RangeError(\"PageIndicator count must be a positive integer\");\n  }\n  if (\n    !Number.isSafeInteger(descriptor.currentIndex) ||\n    descriptor.currentIndex < 0 ||\n    descriptor.currentIndex >= descriptor.count\n  ) {\n    throw new RangeError(`PageIndicator currentIndex is out of range: ${String(descriptor.currentIndex)}`);\n  }\n  if (descriptor.maxVisibleDots !== undefined && (!Number.isSafeInteger(descriptor.maxVisibleDots) || descriptor.maxVisibleDots < 1)) {\n    throw new RangeError(\"PageIndicator maxVisibleDots must be a positive integer\");\n  }\n}\n\nexport function resolvePageIndicator(\n  descriptor: PageIndicatorDescriptor,\n  composeAccessibleName: ComposePageIndicatorAccessibleName,\n): readonly ResolvedPageIndicatorDot[] {\n  validatePageIndicatorDescriptor(descriptor);\n  if (typeof composeAccessibleName !== \"function\") {\n    throw new TypeError(\"PageIndicator composeAccessibleName must be a function\");\n  }\n  // Product-owned launchers can contain many pages. Keep the current page in a bounded window without\n  // renumbering it: accessibility names and navigation still address the complete pager.\n  const length = Math.min(descriptor.count, descriptor.maxVisibleDots ?? descriptor.count);\n  const start = Math.max(0, Math.min(descriptor.currentIndex - Math.floor(length / 2), descriptor.count - length));\n  return Array.from({ length }, (_, offset) => {\n    const index = start + offset;\n    const accessibleName = composeAccessibleName({ position: index + 1, total: descriptor.count });\n    if (typeof accessibleName !== \"string\" || accessibleName.trim().length === 0) {\n      throw new TypeError(\"PageIndicator composeAccessibleName must return a non-empty string\");\n    }\n    return { index, position: index + 1, total: descriptor.count, current: index === descriptor.currentIndex, accessibleName };\n  });\n}\n\n/** Clamps like getCarouselNavigationTarget: a pager indicator has an end, it never wraps. */\nexport function getPageIndicatorTarget(\n  descriptor: PageIndicatorDescriptor,\n  intent: CarouselNavigationIntent,\n): number {\n  validatePageIndicatorDescriptor(descriptor);\n  if (intent === \"first\") return 0;\n  if (intent === \"last\") return descriptor.count - 1;\n  return Math.min(Math.max(descriptor.currentIndex + (intent === \"next\" ? 1 : -1), 0), descriptor.count - 1);\n}\n\nexport type CarouselSize = \"medium\";\n\nexport const carouselRecipe = {\n  slots: [\n    \"root\",\n    \"track\",\n    \"slide\",\n    \"dots\",\n    \"dot\",\n    \"previousControl\",\n    \"nextControl\",\n  ] as const,\n  defaults: { size: \"medium\" },\n  sizes: {\n    medium: {\n      gap: spacing.sm,\n      controlHitTarget: control.minTouchTarget,\n      controlIcon: \"sm\",\n    },\n  },\n  dot: {\n    diameter: 8,\n    compactGap: spacing.xs,\n    hitTarget: control.minTouchTarget,\n    color: {\n      inactive: semanticColors.border.strong,\n      current: semanticColors.content.brand,\n    },\n  },\n  /** Previous/next chrome is composed from IconButton (ghost tone) rather than owning new button visuals. */\n  control: {\n    icons: {\n      previous: \"chevronStart\",\n      next: \"chevronEnd\",\n    } as const satisfies Readonly<{ previous: SemanticIconName; next: SemanticIconName }>,\n  },\n  states: {\n    focus: focusIndicatorContract,\n    draggedOpacity: opacity.dragged,\n  },\n  /**\n   * Manual slide-to-slide movement crossfades rather than snapping under\n   * Reduce Motion, reusing the existing \"context\" preset instead of a new\n   * token — autoplay itself simply does not run at all (isCarouselAutoplayActive).\n   */\n  transition: motionPreset.context,\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: CarouselSize };\n  sizes: Record<\n    CarouselSize,\n    { gap: number; controlHitTarget: number; controlIcon: string }\n  >;\n  dot: {\n    diameter: number;\n    compactGap: number;\n    hitTarget: number;\n    color: Record<\"inactive\" | \"current\", ColorReference>;\n  };\n  control: {\n    icons: Readonly<{ previous: SemanticIconName; next: SemanticIconName }>;\n  };\n  states: {\n    focus: typeof focusIndicatorContract;\n    draggedOpacity: number;\n  };\n  transition: typeof motionPreset.context;\n};\n"]}