vectis-ui 0.10.0 → 0.10.2

package/dist/components/VCalendar/timeGrid.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeGrid.js","names":[],"sources":["../../../src/components/VCalendar/timeGrid.ts"],"sourcesContent":["// @core\n/**\n * Where a timed event lands when a time grid's gesture lets go of it: moved, stretched, or drawn\n * out of an empty slot.\n *\n * It is `layout.ts`'s arithmetic, pure and tested over plain numbers the same way, and it sits in\n * a module of its own for the size gate alone. The month and year views import `layout.ts` too,\n * and a module is weighed whole in every closure that reaches it: kept there, these functions\n * were paid for by two views that never move an event by the minute (the `VTimePicker/limits.ts`\n * argument).\n */\nimport { addDays } from '../../utils/date'\nimport { clamp } from '../../utils/number'\n\nimport {\n  MINUTES_PER_DAY,\n  daySpan,\n  durationOf,\n  floorToSlot,\n  minutesAt,\n  timeOf,\n  type TimeWindow,\n} from './layout'\nimport type { CalendarEventTimes } from './types'\n\n/**\n * Rounds a moment to the nearest step WITHOUT holding it inside the day, for a start that a\n * move may push past either midnight.\n */\nexport function roundToSlot(minutes: number, step: number): number {\n  const size = step > 0 ? step : 1\n  return Math.round(minutes / size) * size\n}\n\n/**\n * Where an event lands when it is dragged or nudged along its day: it keeps its length and\n * moves by `minuteDelta`. Which DAY it lands on is the caller's to set, read from the days on\n * show rather than counted here, so a hidden weekday is never landed on.\n *\n * An event pushed past the end of the window is held against it rather than having its tail\n * cut off: moving something must never change how long it is, which is the other gesture's\n * job.\n */\nexport function moveEvent(\n  origin: CalendarEventTimes,\n  minuteDelta: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const startMinutes = minutesAt(origin.startTime, timeWindow.start)\n  const endMinutes = Math.max(minutesAt(origin.endTime, startMinutes), startMinutes + 1)\n  const duration = endMinutes - startMinutes\n\n  const nextStart = clamp(\n    startMinutes + minuteDelta,\n    timeWindow.start,\n    Math.max(timeWindow.start, timeWindow.end - duration),\n  )\n\n  return {\n    start: origin.start,\n    end: origin.start,\n    startTime: timeOf(nextStart),\n    endTime: timeOf(nextStart + duration),\n  }\n}\n\n/**\n * Where the end of an event lands when its bottom edge is dragged. It can never cross the\n * start: the shortest an event may become is one step.\n */\nexport function resizeEvent(\n  origin: CalendarEventTimes,\n  endMinutes: number,\n  minDuration: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const startMinutes = minutesAt(origin.startTime, timeWindow.start)\n  const floor = Math.max(minDuration, 1)\n  const end = clamp(endMinutes, startMinutes + floor, timeWindow.end)\n\n  return {\n    start: origin.start,\n    end: origin.start,\n    startTime: timeOf(startMinutes),\n    endTime: timeOf(end),\n  }\n}\n\n/**\n * Where a timed event lands when it is dragged or nudged: it starts at `startMinutes` counted\n * from the midnight that begins `day`, and keeps its length.\n *\n * `crossMidnight` says which of two rules applies, and it is read off the event as the gesture\n * FOUND it rather than off the times being written. An event that ran past midnight when it was\n * taken hold of may go on doing so, or come back inside one day, or cross again: its start may\n * be pushed into the day before or after `day`, and its end lands wherever its length takes it.\n * Any other event is `moveEvent`'s, held inside `day`, so a drag never turns an ordinary\n * appointment into an overnight one by accident.\n */\nexport function moveTimedEvent(\n  times: CalendarEventTimes,\n  day: string,\n  startMinutes: number,\n  timeWindow: TimeWindow,\n  crossMidnight: boolean,\n): CalendarEventTimes {\n  if (!crossMidnight) {\n    const from = minutesAt(times.startTime, timeWindow.start)\n    return { ...moveEvent(times, startMinutes - from, timeWindow), start: day, end: day }\n  }\n\n  const duration = clamp(durationOf(times), 1, MINUTES_PER_DAY - 1)\n  const dayShift = Math.floor(startMinutes / MINUTES_PER_DAY)\n  const wanted = startMinutes - dayShift * MINUTES_PER_DAY\n  /*\n   * The start is held inside the window only when it was taken from inside it. An overnight\n   * event may begin after the window closes (a 22:00 shift on a calendar showing 08:00 to\n   * 20:00, whose morning card alone is drawn): pulled into the window, its start jumped hours\n   * and left the slot grid at the first nudge. Left where it was asked to go, it cannot\n   * vanish either, since moving it later lengthens its morning and moving it earlier brings\n   * its evening into view.\n   */\n  const from = minutesAt(times.startTime, timeWindow.start)\n  const start =\n    from >= timeWindow.start && from < timeWindow.end\n      ? clamp(wanted, timeWindow.start, timeWindow.end - 1)\n      : wanted\n  const startDay = addDays(day, dayShift)\n  const end = start + duration\n  return {\n    start: startDay,\n    end: end >= MINUTES_PER_DAY ? addDays(startDay, 1) : startDay,\n    startTime: timeOf(start),\n    endTime: timeOf(end % MINUTES_PER_DAY),\n  }\n}\n\n/**\n * Where a timed event's end lands when it is dragged or nudged: `endMinutes` counted from the\n * midnight that begins `endDay`.\n *\n * With `crossMidnight` false this is `resizeEvent`, and `endDay` is ignored. With it true: an\n * event that ran past midnight when the gesture began: the end may sit on the event's first\n * day or on the next one, whichever `endDay` names (anything else is held to the nearer of the\n * two), and it stays at least `minDuration` after the start and short of a whole day after it,\n * so the event never turns into a bar under the pointer.\n */\nexport function resizeTimedEvent(\n  times: CalendarEventTimes,\n  endDay: string,\n  endMinutes: number,\n  minDuration: number,\n  timeWindow: TimeWindow,\n  crossMidnight: boolean,\n): CalendarEventTimes {\n  if (!crossMidnight) return resizeEvent(times, endMinutes, minDuration, timeWindow)\n\n  const startMinutes = minutesAt(times.startTime, timeWindow.start)\n  // `daySpan` already reads a day before the start as zero.\n  const dayOffset = Math.min(daySpan({ ...times, end: endDay }), 1)\n  const end = clamp(\n    dayOffset * MINUTES_PER_DAY + endMinutes,\n    startMinutes + Math.max(minDuration, 1),\n    startMinutes + MINUTES_PER_DAY - 1,\n  )\n\n  // Back inside the first day, the end obeys the window like any other; the `timeOf` clamp\n  // then writes midnight as 23:59 of that day rather than 00:00 of the next.\n  if (end <= MINUTES_PER_DAY) {\n    return {\n      start: times.start,\n      end: times.start,\n      startTime: timeOf(startMinutes),\n      // The window caps the end, never below the shortest length: a start after the window\n      // closes would otherwise be given an end before it.\n      endTime: timeOf(\n        Math.max(Math.min(end, timeWindow.end), startMinutes + Math.max(minDuration, 1)),\n      ),\n    }\n  }\n  return {\n    start: times.start,\n    end: addDays(times.start, 1),\n    startTime: timeOf(startMinutes),\n    endTime: timeOf(end - MINUTES_PER_DAY),\n  }\n}\n\n/**\n * The stretch of a day drawn out by a press at `anchor` and a pointer now at `pointer`, both in\n * minutes since midnight.\n *\n * It covers every slot from the one pressed to the one under the pointer, both included, so it\n * reads the same whichever way the pointer went: down from 10:00 to 11:10 is 10:00–11:15, up\n * from 10:00 to 9:10 is 9:00–10:15. The pressed slot is never given up, which is what keeps the\n * box from flipping over as the pointer crosses its own starting point.\n */\nexport function drawnSlot(\n  day: string,\n  anchor: number,\n  pointer: number,\n  step: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const size = step > 0 ? step : 1\n  const from = floorToSlot(anchor, size)\n  const at = floorToSlot(pointer, size)\n  const start = Math.max(timeWindow.start, Math.min(from, at))\n  const end = clamp(Math.max(from, at) + size, start + 1, timeWindow.end)\n  return { start: day, end: day, startTime: timeOf(start), endTime: timeOf(end) }\n}\n"],"mappings":"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"}
+{"version":3,"file":"timeGrid.js","names":[],"sources":["../../../src/components/VCalendar/timeGrid.ts"],"sourcesContent":["// @core\n/**\n * Keep minute-based placement separate from common layout so month and year views do not import\n * unused time-grid arithmetic.\n */\nimport { addDays } from '../../utils/date'\nimport { clamp } from '../../utils/number'\n\nimport {\n  MINUTES_PER_DAY,\n  daySpan,\n  durationOf,\n  floorToSlot,\n  minutesAt,\n  timeOf,\n  type TimeWindow,\n} from './layout'\nimport type { CalendarEventTimes } from './types'\n\n/**\n * Rounds a moment to the nearest step WITHOUT holding it inside the day, for a start that a\n * move may push past either midnight.\n */\nexport function roundToSlot(minutes: number, step: number): number {\n  const size = step > 0 ? step : 1\n  return Math.round(minutes / size) * size\n}\n\n/**\n * Where an event lands when it is dragged or nudged along its day: it keeps its length and\n * moves by `minuteDelta`.\n */\nexport function moveEvent(\n  origin: CalendarEventTimes,\n  minuteDelta: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const startMinutes = minutesAt(origin.startTime, timeWindow.start)\n  const endMinutes = Math.max(minutesAt(origin.endTime, startMinutes), startMinutes + 1)\n  const duration = endMinutes - startMinutes\n\n  const nextStart = clamp(\n    startMinutes + minuteDelta,\n    timeWindow.start,\n    Math.max(timeWindow.start, timeWindow.end - duration),\n  )\n\n  return {\n    start: origin.start,\n    end: origin.start,\n    startTime: timeOf(nextStart),\n    endTime: timeOf(nextStart + duration),\n  }\n}\n\n/**\n * Where the end of an event lands when its bottom edge is dragged. It can never cross the\n * start: the shortest an event may become is one step.\n */\nexport function resizeEvent(\n  origin: CalendarEventTimes,\n  endMinutes: number,\n  minDuration: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const startMinutes = minutesAt(origin.startTime, timeWindow.start)\n  const floor = Math.max(minDuration, 1)\n  const end = clamp(endMinutes, startMinutes + floor, timeWindow.end)\n\n  return {\n    start: origin.start,\n    end: origin.start,\n    startTime: timeOf(startMinutes),\n    endTime: timeOf(end),\n  }\n}\n\n/**\n * Where a timed event lands when it is dragged or nudged: it starts at `startMinutes` counted\n * from the midnight that begins `day`, and keeps its length.\n */\nexport function moveTimedEvent(\n  times: CalendarEventTimes,\n  day: string,\n  startMinutes: number,\n  timeWindow: TimeWindow,\n  crossMidnight: boolean,\n): CalendarEventTimes {\n  if (!crossMidnight) {\n    const from = minutesAt(times.startTime, timeWindow.start)\n    return { ...moveEvent(times, startMinutes - from, timeWindow), start: day, end: day }\n  }\n\n  const duration = clamp(durationOf(times), 1, MINUTES_PER_DAY - 1)\n  const dayShift = Math.floor(startMinutes / MINUTES_PER_DAY)\n  const wanted = startMinutes - dayShift * MINUTES_PER_DAY\n  /*\n   * Left where it was asked to go, it cannot vanish either, since moving it later lengthens its\n   * morning and moving it earlier brings its evening into view.\n   */\n  const from = minutesAt(times.startTime, timeWindow.start)\n  const start =\n    from >= timeWindow.start && from < timeWindow.end\n      ? clamp(wanted, timeWindow.start, timeWindow.end - 1)\n      : wanted\n  const startDay = addDays(day, dayShift)\n  const end = start + duration\n  return {\n    start: startDay,\n    end: end >= MINUTES_PER_DAY ? addDays(startDay, 1) : startDay,\n    startTime: timeOf(start),\n    endTime: timeOf(end % MINUTES_PER_DAY),\n  }\n}\n\n/**\n * Where a timed event's end lands when it is dragged or nudged: `endMinutes` counted from the\n * midnight that begins `endDay`. With `crossMidnight` false this is `resizeEvent`, and `endDay`\n * is ignored.\n */\nexport function resizeTimedEvent(\n  times: CalendarEventTimes,\n  endDay: string,\n  endMinutes: number,\n  minDuration: number,\n  timeWindow: TimeWindow,\n  crossMidnight: boolean,\n): CalendarEventTimes {\n  if (!crossMidnight) return resizeEvent(times, endMinutes, minDuration, timeWindow)\n\n  const startMinutes = minutesAt(times.startTime, timeWindow.start)\n  const dayOffset = Math.min(daySpan({ ...times, end: endDay }), 1)\n  const end = clamp(\n    dayOffset * MINUTES_PER_DAY + endMinutes,\n    startMinutes + Math.max(minDuration, 1),\n    startMinutes + MINUTES_PER_DAY - 1,\n  )\n\n  // Back inside the first day, the end obeys the window like any other; the `timeOf` clamp\n  // then writes midnight as 23:59 of that day rather than 00:00 of the next.\n  if (end <= MINUTES_PER_DAY) {\n    return {\n      start: times.start,\n      end: times.start,\n      startTime: timeOf(startMinutes),\n      // The window caps the end, never below the shortest length: a start after the window\n      // closes would otherwise be given an end before it.\n      endTime: timeOf(\n        Math.max(Math.min(end, timeWindow.end), startMinutes + Math.max(minDuration, 1)),\n      ),\n    }\n  }\n  return {\n    start: times.start,\n    end: addDays(times.start, 1),\n    startTime: timeOf(startMinutes),\n    endTime: timeOf(end - MINUTES_PER_DAY),\n  }\n}\n\n/**\n * The stretch of a day drawn out by a press at `anchor` and a pointer now at `pointer`, both in\n * minutes since midnight.\n */\nexport function drawnSlot(\n  day: string,\n  anchor: number,\n  pointer: number,\n  step: number,\n  timeWindow: TimeWindow,\n): CalendarEventTimes {\n  const size = step > 0 ? step : 1\n  const from = floorToSlot(anchor, size)\n  const at = floorToSlot(pointer, size)\n  const start = Math.max(timeWindow.start, Math.min(from, at))\n  const end = clamp(Math.max(from, at) + size, start + 1, timeWindow.end)\n  return { start: day, end: day, startTime: timeOf(start), endTime: timeOf(end) }\n}\n"],"mappings":"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"}

package/dist/components/VCalendar/types.d.ts

@@ -1,20 +1,9 @@
 import { HourFormat } from '../../utils/time.js';
 /** What identifies one event, and what the move and resize events refer back to. */
 export type CalendarEventId = string | number;
-/**
- * One entry in the calendar.
- *
- * The seven fields below are the contract. A consumer needing more of their own writes an
- * interface extending this one and hands it to the component, which carries the type
- * through to the `#event` slot, so extra fields arrive typed rather than as `unknown`.
- */
+/** One entry in the calendar. */
 export interface CalendarEvent {
-    /**
-     * What identifies this event. It must be unique among the events given and stable
-     * across renders: it is what the drag writes back to, what gives a card its key, and
-     * what decides the colour of an event that names none, so an event keeps its colour
-     * as the list is filtered or re-sorted.
-     */
+    /** What identifies this event. */
     id: CalendarEventId;
     /** What the event is called. It is the accessible name of its card. */
     title: string;
@@ -29,22 +18,16 @@ export interface CalendarEvent {
     /** A second line under the title, shown where the card is tall enough to hold one. */
     description?: string;
     /**
-     * Any CSS colour. Left out, one is derived from the id, so the same event is always
-     * drawn the same way. It tints the card and paints its leading edge; the title is never
-     * set on top of it, which is what keeps an arbitrary colour readable.
+     * Any CSS colour. Left out, one is derived from the id, so the same event is always drawn the
+     * same way.
      */
     color?: string;
     /**
      * The name of a time zone, shown beside the times as an annotation: "09:00 – 10:00
-     * (Europe/Paris)". It is DISPLAY ONLY: it never moves the card, which is always placed
-     * from the dates and times above, read as local time.
+     * (Europe/Paris)".
      */
     timezone?: string;
-    /**
-     * Keeps the event in the band above the grid rather than in a day's column. An event
-     * lasting twenty-four hours or more is already shown there without this. One running past
-     * midnight for less than that stays in the grid, as a card in each of its two days.
-     */
+    /** Keeps the event in the band above the grid rather than in a day's column. */
     allDay?: boolean;
 }
 /**

package/dist/components/VCarousel/VCarousel.d.ts

@@ -46,102 +46,53 @@ export interface CarouselIndicatorSlotProps {
 export type CarouselIndicators = false | 'inside' | 'outside';
 /** Where the previous and next buttons go: nowhere, over the slides, or beside them. */
 export type CarouselControls = false | 'inside' | 'outside';
-/**
- * When those buttons are visible. It is a named choice rather than a yes-or-no, because
- * "on hover" would misname what actually happens: they also appear on keyboard focus, and
- * they stay permanently visible where there is no pointer to hover with.
- */
+/** When those buttons are visible. */
 export type CarouselControlsVisibility = 'always' | 'hover';
 interface CarouselProps {
     /**
-     * How many slides may be visible at once. It is a MAXIMUM and not a target: the floor
-     * below decides how many actually fit, which is what makes the whole thing responsive
-     * without a single breakpoint.
+     * How many slides may be visible at once. It is a MAXIMUM and not a target: the floor below
+     * decides how many actually fit, which makes the whole thing responsive without a single
+     * breakpoint.
      */
     itemsPerView?: number;
     /**
      * How small a slide is allowed to get. Once an equal share would fall below this, fewer
-     * slides fit and the carousel simply scrolls further instead. A number is read as
-     * pixels; anything else is used as given, so `'20vw'` works.
+     * slides fit and the carousel simply scrolls further instead.
      */
     itemMinSize?: number | string;
-    /**
-     * How much of the NEXT slide is left showing, as a hint that there is more. It includes
-     * the gap before it, which is what keeps the sizing formula free of special cases.
-     *
-     * It cannot be combined with the fade transition: fading assumes a slide exactly fills
-     * the view.
-     */
+    /** How much of the NEXT slide is left showing, as a hint that there is more. */
     peek?: number | string;
     /** The space between two slides. */
     gap?: number | string;
     /** Whether the carousel scrolls across the page or down it. */
     orientation?: CarouselOrientation;
     /**
-     * How one slide gives way to the next, driven by the scroll itself. Sliding means no
-     * animation at all.
-     *
-     * Fading requires ONE slide at a time and no peek: it works by holding each slide in
-     * place while the scroll moves under it, which only lands correctly when a slide fills
-     * the view exactly. Asked for otherwise, it falls back to sliding rather than degrading.
+     * How one slide gives way to the next, driven by the scroll itself. Asked for otherwise, it
+     * falls back to sliding rather than degrading.
      */
     effect?: CarouselEffect;
-    /**
-     * The height of the visible area.
-     *
-     * GIVE ONE when the carousel scrolls downwards: a slide sized as a share of the height
-     * needs a height to take a share OF, and without it every slide collapses onto its own
-     * content. Scrolling across the page, the height comes from the slides themselves.
-     */
+    /** The height of the visible area. */
     height?: number | string;
     /**
-     * Whether the carousel comes back round: past the last position it returns to the first,
-     * and before the first it goes to the last. Off by default, which stops it at both ends.
-     *
-     * Nothing is cloned to achieve it: the real track goes back to the beginning. Being a
-     * move of more than one page, it goes there at once and plays the transition on
-     * arrival, rather than rewinding past every slide in between, unless `noJump` puts
-     * that rewind back.
-     *
-     * It has no effect where there is only one position to rest on, and the buttons stay
-     * disabled there rather than becoming two controls that do nothing. The dots always go
-     * straight to the position they name, and so do the Home and End keys.
+     * Whether the carousel comes back round: past the last position it returns to the first, and
+     * before the first it goes to the last. Off by default, which stops it at both ends.
      */
     loop?: boolean;
     /**
      * Whether a move of more than one page keeps the whole scroll instead of going straight
-     * there. Off by default: a dot five pages away lands at once and plays the transition
-     * once, on arrival.
-     *
-     * Turn it on when the travel is the point: a short carousel where watching the track
-     * run past says something about how far the reader has moved. Every route is covered,
-     * the dots, the Home and End keys and a `loop` carousel coming back round, so the
-     * component moves the way it did before there was a shortcut at all.
-     *
-     * It changes nothing for a reader who has asked for less motion: that preference makes
-     * every scroll instant on its own.
+     * there. Off by default: a dot five pages away lands at once and plays the transition once,
+     * on arrival.
      */
     noJump?: boolean;
     /**
-     * How long each slide is shown before the next one, in milliseconds; zero means it does
-     * not advance by itself. It stops at the last page unless the carousel loops (in which
-     * case it goes round for as long as the page is open), pauses while the pointer rests on
-     * it or the KEYBOARD focus is inside it, and never runs at all for a reader who has asked
-     * for less motion.
-     *
-     * The component deliberately renders NO pause button. This prop is reactive and setting
-     * it to zero cancels the timer at once, so a stop control is a one-line binding on your
-     * side, and it is worth adding: the guideline asks for a way to stop content that moves
-     * on its own, and hover and focus leave a touch user with none. Looping makes that
-     * binding MANDATORY rather than advisable, the movement no longer ending on its own.
+     * How long each slide is shown before the next one, in milliseconds; zero means it does not
+     * advance by itself.
      */
     autoplay?: number;
     /**
-     * Where the previous and next buttons go: over the slides, beside them, or nowhere.
-     *
-     * Placed beside, they sit at the ends of the scrolling axis and their room is reserved
-     * as padding, so the component's footprint is unchanged and the slides narrow instead.
-     * Either way they are centred on the SLIDES and never on the slides plus the dots.
+     * Where the previous and next buttons go: over the slides, beside them, or nowhere. Placed
+     * beside, they sit at the ends of the scrolling axis and their room is reserved as padding,
+     * so the component's footprint is unchanged and the slides narrow instead.
      */
     controls?: CarouselControls;
     /**
@@ -150,9 +101,8 @@ interface CarouselProps {
      */
     indicators?: CarouselIndicators;
     /**
-     * Whether those buttons are always visible, or appear when the pointer is over the
-     * carousel or the keyboard focus is inside it. Where there is no pointer to hover with,
-     * they stay visible whatever this says. The dots are never hidden.
+     * Whether those buttons are always visible, or appear when the pointer is over the carousel
+     * or the keyboard focus is inside it.
      */
     controlsVisibility?: CarouselControlsVisibility;
     /** The icon of the previous button. It follows the orientation by default. */
@@ -163,35 +113,15 @@ interface CarouselProps {
     prevLabel?: string;
     /** What the next button does, in words. It falls back to the dictionary. */
     nextLabel?: string;
-    /**
-     * What screen readers announce for the carousel as a whole.
-     *
-     * Give a DISTINCT one to every carousel on a page: this is a landmark of the page, and
-     * two landmarks bearing the same name cannot be told apart by someone navigating between
-     * them.
-     */
+    /** What screen readers announce for the carousel as a whole. */
     label?: string;
 }
 type __VLS_Props = CarouselProps;
 type __VLS_Slots = {
-    /**
-     * The slides. How many there are is read from what this slot RENDERS, so a `v-for` is
-     * perfectly fine, but the slot must not depend on something only true in a browser, or
-     * the server and the client would count differently.
-     */
+    /** The slides. */
     default(): unknown;
-    /**
-     * Replaces the previous and next buttons entirely, their placement included: custom
-     * content positions itself, and the visibility setting no longer applies to it.
-     */
     controls?(props: CarouselControlsSlotProps): unknown;
-    /**
-     * Replaces the whole bar of dots.
-     *
-     * Render one control per POSITION (`pageCount`) and not per slide. A position past the
-     * last one cannot be reached, so a bar built on the number of slides offers dots that
-     * scroll nowhere. The slide count is passed as well, for wording such as "3 of 8".
-     */
+    /** Replaces the whole bar of dots. */
     indicators?(props: CarouselIndicatorsSlotProps): unknown;
     /**
      * Replaces what is drawn INSIDE one dot. The button itself, and everything that makes it
@@ -201,9 +131,8 @@ type __VLS_Slots = {
 };
 type __VLS_ModelProps = {
     /**
-     * Which slide is current: the first one fully visible when several fit at once, which is
-     * also the position the carousel has come to rest on. A value outside the positions the
-     * carousel can rest on is brought back into range.
+     * Which slide is current: the first one fully visible when several fit at once, which is also
+     * the position the carousel has come to rest on.
      */
     modelValue?: number;
 };