ropav 0.1.6 → 0.1.8

package/dist/utils/dom/nativeChoice.d.ts

@@ -0,0 +1,17 @@
+export interface NativeChoiceOption<Value> {
+    value: Value;
+}
+export interface NativeSelectChoiceAdapter<Value> {
+    commit: (select: HTMLSelectElement, value: Value, defaultValue: Value, applyValue: () => void) => void;
+    read: (select: HTMLSelectElement) => Value;
+    resolveResetValue: (select: HTMLSelectElement, initialValue: Value) => Value;
+    sync: (select: HTMLSelectElement, value: Value, defaultValue: Value) => void;
+}
+interface SingleNativeChoiceAdapterOptions<Value> {
+    emptyValue: Value;
+    options: () => readonly NativeChoiceOption<Value>[] | undefined;
+}
+export declare function createSingleNativeChoiceAdapter<Value>(options: SingleNativeChoiceAdapterOptions<Value>): NativeSelectChoiceAdapter<Value>;
+export declare function createMultipleNativeChoiceAdapter<Value>(options: () => readonly NativeChoiceOption<Value>[] | undefined): NativeSelectChoiceAdapter<Value[]>;
+export declare function createStringListNativeChoiceAdapter(): NativeSelectChoiceAdapter<string[]>;
+export {};

package/dist/utils/dom/pointerSession.d.ts

@@ -0,0 +1,20 @@
+type PointerSessionEndUpdate = 'event' | 'none' | 'pending-pointerup';
+type PointerSessionUpdateMode = 'animation-frame' | 'immediate';
+interface PointerSessionAdapter<TState> {
+    endUpdate?: PointerSessionEndUpdate;
+    onStart?: (event: PointerEvent, state: TState) => void;
+    onStop?: (state: TState) => void;
+    onUpdate: (event: PointerEvent, state: TState) => void;
+    refreshGeometry?: (state: TState) => boolean;
+    updateMode?: PointerSessionUpdateMode;
+}
+interface PointerSessionStart<TState> {
+    geometryDirty?: boolean;
+    state: TState;
+    target: HTMLElement;
+}
+export declare function createPointerSession<TState>(adapter: PointerSessionAdapter<TState>): {
+    start: (event: PointerEvent, initialize: () => PointerSessionStart<TState> | undefined) => boolean;
+    stop: () => void;
+};
+export {};

package/dist/utils/dom/query.d.ts

@@ -0,0 +1,4 @@
+export declare function isElement(value: unknown): value is Element;
+export declare function matchesSelectorSafe(element: Element, selector: string): boolean;
+export declare function querySelectorSafe<ElementType extends Element = Element>(selector: string, root?: ParentNode | null): ElementType | null;
+export declare function querySelectorAllSafe<ElementType extends Element = Element>(selector: string, root?: ParentNode | null): ElementType[];

package/dist/utils/dom/scroll.d.ts

@@ -0,0 +1,24 @@
+import { ElementDirection } from './direction.js';
+export type ScrollAxis = 'x' | 'y';
+export type ScrollDirection = ElementDirection;
+export interface KeyboardScrollPositionOptions {
+    axis: ScrollAxis;
+    key: string;
+    current: number;
+    pageSize: number;
+    maxPosition: number;
+    direction: ScrollDirection;
+    lineStep: number;
+}
+export declare function getScrollDirection(element: Element): ScrollDirection;
+export declare function getLogicalHorizontalScrollPosition(scrollLeft: number, maxPosition: number, direction: ScrollDirection): number;
+export declare function getRawHorizontalScrollPosition(position: number, maxPosition: number, direction: ScrollDirection): number;
+export declare function getScrollThumbGeometry(trackSize: number, viewportSize: number, scrollSize: number, minimumSize: number): {
+    size: number;
+    offsetRatio: number;
+};
+export declare function getScrollThumbOffset(position: number, maxPosition: number, sizeRatio: number): number;
+export declare function getKeyboardScrollPosition({ axis, key, current, pageSize, maxPosition, direction, lineStep, }: KeyboardScrollPositionOptions): number | undefined;
+export declare function getWheelScrollDelta(axis: ScrollAxis, event: Pick<WheelEvent, 'deltaX' | 'deltaY'>, direction: ScrollDirection): number;
+export declare function applyFallbackScrollPosition(element: Pick<HTMLElement, 'scrollLeft' | 'scrollTop'>, options: Pick<ScrollToOptions, 'left' | 'top'>, mode: 'absolute' | 'relative'): void;
+export declare function getPointerAxisCoordinate(axis: ScrollAxis, event: Pick<PointerEvent, 'clientX' | 'clientY'>): number;

package/dist/utils/floatingOffset.d.ts

@@ -0,0 +1,10 @@
+export interface FloatingOffsetAxes {
+    mainAxis?: number;
+    crossAxis?: number;
+}
+export type FloatingOffsetValue = number | FloatingOffsetAxes;
+export interface FloatingOffsetProperties {
+    mainAxis: `--${string}`;
+    crossAxis: `--${string}`;
+}
+export declare function getFloatingOffsetStyle(offset: FloatingOffsetValue | null | undefined, properties: FloatingOffsetProperties): Record<string, string> | undefined;

package/dist/utils/geometry.d.ts

@@ -0,0 +1,14 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+export type Triangle = [Point, Point, Point];
+type RectBounds = Pick<DOMRect, 'bottom' | 'height' | 'left' | 'right' | 'top' | 'width'>;
+export declare function getClientPoint(event: Pick<MouseEvent, 'clientX' | 'clientY'>): Point;
+export declare function hasMeasuredRect(rect: Pick<DOMRect, 'height' | 'width'>): boolean;
+export declare function isPointInRect(point: Point, rect: RectBounds, padding?: number): boolean;
+export declare function getTriangleArea(a: Point, b: Point, c: Point): number;
+export declare function isPointInTriangle(point: Point, triangle: Triangle, tolerance?: number): boolean;
+export declare function clampPointToRect(point: Point, rect: RectBounds): Point;
+export declare function createPointRect(point: Point): DOMRect;
+export {};

package/dist/utils/indexPath.d.ts

@@ -0,0 +1,6 @@
+export type IndexPath = number[];
+export declare function getPathKey(path: IndexPath): string;
+export declare function getParentPath(path: IndexPath): IndexPath;
+export declare function arePathsEqual(a: IndexPath, b: IndexPath): boolean;
+export declare function isPathPrefix(prefix: IndexPath, path: IndexPath): boolean;
+export declare function normalizePath(indexOrPath: number | IndexPath): IndexPath;

package/dist/utils/number.d.ts

@@ -0,0 +1,4 @@
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function getValuePercent(value: number, min: number, max: number): number;
+export declare function normalizeDelay(value: number | null | undefined, fallback?: number): number;
+export declare function roundTo(value: number, fractionDigits?: number): number;

package/dist/utils/optionFilter.d.ts

@@ -0,0 +1,5 @@
+export interface LabeledOption {
+    label: string;
+}
+export type OptionFilter<Option> = (option: Option, searchValue: string) => boolean;
+export declare function filterOptions<Option extends LabeledOption>(options: readonly Option[] | undefined, searchValue: string, filter: OptionFilter<Option> | false | undefined): Option[];

package/dist/utils/rafScheduler.d.ts

@@ -0,0 +1,4 @@
+export declare function createRafScheduler(callback: () => void, getView: () => Window | null | undefined): {
+    cancel: () => void;
+    schedule: () => void;
+};

package/dist/utils/text.d.ts

@@ -0,0 +1,2 @@
+export declare function getNameInitials(name: string | null | undefined): string;
+export declare function normalizeTypeaheadText(value: string, locales?: Intl.LocalesArgument): string;

package/docs/code-architecture.md

@@ -0,0 +1,118 @@
+# Code architecture
+
+This guide defines the source structure expected from contributors. The goal is a predictable
+codebase where UI files describe rendering, behavior is testable through small interfaces, and
+shared logic has one obvious home.
+
+## Module seams
+
+A module should hide a meaningful amount of behavior behind a small interface. Extract code around
+a responsibility, not merely to reduce a line count. A useful extraction makes callers simpler and
+lets tests exercise the same interface that production code uses.
+
+Use this dependency direction:
+
+```text
+Vue components and component-local modules
+    -> internal composables
+    -> public composables
+    -> utilities
+```
+
+A higher layer may also import a lower layer directly. Lower layers must not import higher layers:
+
+- `src/utils/` does not import components or composables.
+- `src/composables/` does not import components or internal modules.
+- `src/internal/` does not import components.
+- Components may compose other components when the dependency remains acyclic.
+
+## Where code belongs
+
+| Location                                  | Responsibility                                                        |
+| ----------------------------------------- | --------------------------------------------------------------------- |
+| `src/components/<name>/*.vue`             | Template, bindings, slots, and lightweight view-derived state         |
+| `src/components/<name>/useX.ts`           | Component-specific reactive state, lifecycle, and event orchestration |
+| `src/components/<name>/<concern>Model.ts` | Pure behavior that encodes only that component's contract             |
+| `src/internal/composables/`               | Shared reactive behavior that is not part of the package interface    |
+| `src/composables/`                        | Reusable public composables exported by the package                   |
+| `src/utils/`                              | Reusable runtime helpers without component state or lifecycle         |
+| `src/utils/dom/`                          | Reusable helpers that operate on browser and DOM primitives           |
+| `tests/`, `tooling/`, `scripts/`          | Test, build, and repository automation helpers                        |
+
+Do not add catch-all `utils`, `helpers`, or `core` modules beside a component. Keep a pure helper
+local when it expresses one component's contract, and give it a semantic name such as
+`sliderModel`. Move it to `src/utils/` once more than one feature needs the behavior.
+
+## Component shape
+
+Production SFCs use `<script setup lang="ts" vapor>` and remain zero-VDOM. Do not use `h`, `VNode`,
+`defineComponent`, `createVNode`, or related VDOM block helpers in production source.
+
+Keep SFC blocks in this order:
+
+1. `<template>`
+2. `<script setup lang="ts" vapor>`
+3. `<style>`
+
+Within the script block, use this order:
+
+1. Imports
+2. `defineOptions`, props defaults, emits, and slots
+3. Composable state and template refs
+4. View-derived computed attributes
+5. Small event adapters and `defineExpose`
+
+A short computed value used only to bind the template can stay in the SFC. Move state transitions,
+timers, document listeners, multi-step event handling, and reusable calculations behind a
+composable or pure model interface.
+
+## Function design
+
+Oxlint enforces a conservative baseline of cyclomatic complexity 20, nesting depth 4, at most 5
+parameters, and at most 250 non-blank, non-comment lines per function. These are upper bounds, not
+targets.
+
+- Give each function one reason to change.
+- Prefer guard clauses over deeply nested branches.
+- Use an options object when several parameters describe one concept.
+- Split orchestration into named steps, while keeping the external interface small.
+- Accept dependencies or callbacks at the module seam instead of constructing hard-to-test global
+  dependencies inside the implementation.
+- Return observable results where practical; isolate side effects in lifecycle or event adapters.
+
+Do not create shallow pass-through functions solely to satisfy a metric. A refactor should improve
+the caller, the module interface, or the test surface.
+
+## Imports and package interfaces
+
+- Import utilities directly from their module, for example `@/utils/number`; do not add a utils
+  barrel.
+- Component `index.ts` files define package-facing exports. Internal code should not import from the
+  root package barrel.
+- Keep imports acyclic. If two modules need each other, move the shared behavior to the lowest
+  layer that owns the concept.
+- Use `import type` for type-only dependencies.
+
+## Testing
+
+Test through the interface of the extracted module:
+
+- Pure models and utilities use deterministic unit tests.
+- Composables test returned state and commands, using the smallest host needed for lifecycle
+  behavior.
+- Component tests cover DOM integration, events, accessibility, and public rendering contracts.
+- Storybook tests cover visual and interaction scenarios that depend on real browser layout.
+
+Tests should assert observable behavior rather than private implementation details. Refactoring a
+module internally should not require rewriting its behavioral tests.
+
+## Contributor checklist
+
+Before opening a pull request:
+
+- The SFC primarily adapts props, slots, and composable results to the template.
+- New reusable helpers live in `src/utils/`; feature-only pure logic has a semantic local name.
+- Dependency direction remains downward and acyclic.
+- Functions stay below the enforced complexity, depth, length, and parameter limits.
+- New behavior is tested at the module interface.
+- `pnpm run verify` passes.

package/docs/public-floating-api.md

@@ -42,7 +42,6 @@ const { actualPlacement, arrowStyle, floatingStyle } = useFloatingPosition({
   open,
   placement: 'bottom-start',
   offset: 8,
-  restartKey: () => [teleport.value, teleportTo.value],
 });
 </script>
 ```
@@ -63,24 +62,26 @@ The composable accepts plain values, refs, computed refs or getters for reactive
 | `shift`                            | `true`     | Keeps the floating element inside the collision boundary.              |
 | `collisionPadding`                 | `8`        | Padding between the floating element and viewport boundary.            |
 | `autoUpdateOptions.animationFrame` | `false`    | Tracks transform animations and detached nested floating contexts.     |
-| `restartKey`                       | —          | Rebinds auto-update observers when its reactive value changes.         |
+| `restartKey`                       | —          | Forces a rebind for reactive changes unrelated to DOM ancestry.        |
 
 Use `autoUpdateOptions.animationFrame` sparingly. It checks the reference position every animation
 frame and is intended for references moving with CSS transforms or nested floating elements outside
 their ancestor's scrolling context. The animation-frame loop only runs while positioning is open.
 
-`Popover`, `Tooltip`, `DropdownMenu`, `DropdownMenuContent` and `DropdownMenuSubContent` accept the
-same `flipOptions` and `autoUpdateOptions` objects. On the data-driven `DropdownMenu`, the options
-also apply to its open submenus. Each open floating element using `animationFrame: true` runs its own
-animation-frame loop.
+`HoverCard`, `Popover`, `Tooltip`, `DropdownMenu`, `DropdownMenuContent` and
+`DropdownMenuSubContent` accept the same `flipOptions` and `autoUpdateOptions` objects. On the
+data-driven `DropdownMenu`, the options also apply to its open submenus. Each open floating element
+using `animationFrame: true` runs its own animation-frame loop.
 
 The return value contains readonly `actualPlacement`, `floatingStyle`, `arrowStyle` and
 `isPositioned` refs, plus an async `update()` method for content-driven layout changes.
 
 `useTeleportTarget()` resolves the nearest `TeleportProvider` target and falls back to `body`. Pass
-a target value, ref or getter to override the provider for one floating element. Include the
-resolved target and the Teleport enabled state in `restartKey` whenever either can change while the
-floating element is open.
+a target value, ref or getter to override the provider for one floating element. Positioning
+automatically rebinds when the reference or floating element moves through the composed DOM,
+including Teleport moves, temporary detachments and slot reassignment within an existing shadow
+tree. Use `restartKey` when a reactive change outside observable DOM ancestry must recreate the
+auto-update subscriptions, such as a host attaching a new shadow root after positioning starts.
 
 Positioning does not add interaction or accessibility behavior. Custom overlays remain responsible
 for keyboard handling, focus management, roles, labels, outside interaction and dismissal.
@@ -91,6 +92,9 @@ for keyboard handling, focus management, roles, labels, outside interaction and
 coordinates the trigger and floating content, so a close delay started when the pointer leaves the
 trigger is cancelled when the pointer enters the content.
 
+`HoverCard` composes this behavior with positioning, Teleport and styled content. Use the composable
+directly when custom markup or a different visual treatment is required.
+
 ```vue
 <template>
   <a ref="reference" href="/people/ada" v-bind="triggerProps">Ada Lovelace</a>

package/docs/public-styles-api.md

@@ -1,6 +1,6 @@
 # Public Styles API
 
-The Public Styles API is the supported way to restyle Ropav without depending on component DOM nesting or internal selectors. Its compatibility baseline is commit `5102a40`.
+The Public Styles API is the supported way to restyle Ropav without depending on component DOM nesting or internal selectors.
 
 ## Typed component API
 
@@ -46,28 +46,35 @@ Only independently useful semantic elements are public parts. Conditional parts
 | Button, ButtonLink                       | `root`, `loader`, `left`, `label`, `right`                                                                                                  |
 | IconButton                               | `root`, `loader`, `icon`                                                                                                                    |
 | ButtonGroup                              | `root`                                                                                                                                      |
+| Calendar                                 | `root`, `header`, `previousControl`, `monthLabel`, `nextControl`, `weekdays`, `weekday`, `grid`, `week`, `dayCell`, `day`                   |
 | Card                                     | `root`, `header`, `title`, `description`, `body`, `footer`                                                                                  |
 | Checkbox                                 | `root`, `input`, `indicator`, `label`                                                                                                       |
 | Collapse                                 | `root`, `trigger`, `content`                                                                                                                |
 | ColorInput                               | `root`, `control`, `input`, `preview`, `eyeDropper`, `content`, `picker`, `pickerControl`, `pickerHandle`, `pickerSwatches`, `pickerSwatch` |
 | ColorPicker                              | `root`, `label`, `control`, `handle`, `swatches`, `swatch`                                                                                  |
 | ColorSwatch                              | `root`                                                                                                                                      |
+| Combobox                                 | `root`, `input`, `indicator`, `clear`, `toggle`, `content`, `option`, `empty`                                                               |
 | DropdownMenu                             | `root`, `trigger`, `content`, `item`, `label`, `shortcut`, `submenu`, `submenuIndicator`, `empty`                                           |
+| Dropzone                                 | `root`, `input`, `content`, `label`, `description`                                                                                          |
 | Field                                    | `root`, `label`, `required`, `control`, `description`                                                                                       |
+| FileInput                                | `root`, `input`, `trigger`, `value`                                                                                                         |
 | FocusTrap                                | `root`                                                                                                                                      |
 | Input                                    | `root`, `input`, `left`, `right`                                                                                                            |
 | Modal                                    | `root`, `overlay`, `panel`, `header`, `title`, `description`, `body`, `footer`, `close`                                                     |
+| MultiSelect                              | `root`, `pills`, `pill`, `pillLabel`, `pillRemove`, `input`, `indicator`, `clear`, `toggle`, `content`, `option`, `empty`                   |
 | NumberInput                              | `root`, `input`, `control`                                                                                                                  |
 | Overlay                                  | `root`                                                                                                                                      |
-| Popover, Tooltip                         | `root`, `trigger`, `content`                                                                                                                |
+| HoverCard, Popover, Tooltip              | `root`, `trigger`, `content`                                                                                                                |
 | Progress                                 | `root`, `label`, `value`, `track`, `indicator`                                                                                              |
 | Radio                                    | `root`, `input`, `indicator`, `label`                                                                                                       |
 | RadioGroup                               | `root`                                                                                                                                      |
+| SegmentedControl                         | `root`, `control`, `input`, `indicator`, `label`                                                                                            |
 | Select                                   | `root`, `trigger`, `value`, `indicator`, `clear`, `content`, `option`, `empty`                                                              |
 | Slider                                   | `root`, `label`, `value`, `track`, `range`, `input`, `thumb`, `mark`, `markLabel`, `tooltip`                                                |
 | RangeSlider                              | `root`, `label`, `value`, `track`, `range`, `input`, `thumb`, `mark`, `markLabel`, `tooltip`                                                |
 | Switch                                   | `root`, `input`, `track`, `thumb`, `label`                                                                                                  |
 | Tabs, TabsList, TabsTrigger, TabsContent | `root` on each component                                                                                                                    |
+| TagsInput                                | `root`, `tags`, `tag`, `tagLabel`, `tagRemove`, `input`, `clear`                                                                            |
 | Textarea                                 | `root`, `input`                                                                                                                             |
 | Toast                                    | `root`, `icon`, `title`, `description`, `body`, `action`, `close`                                                                           |
 | ToastViewport                            | `root`, `item`, `toast`, `toastIcon`, `toastTitle`, `toastDescription`, `toastBody`, `toastAction`, `toastClose`                            |
@@ -78,25 +85,29 @@ Only independently useful semantic elements are public parts. Conditional parts
 
 Boolean states use presence semantics: the attribute value is empty when true and the attribute is absent when false or unknown. Enum values are lowercase kebab-case.
 
-- `data-state="open|closed"`: AccordionItem, Collapse, DropdownMenu and submenus, Modal, Popover, Select and Tooltip.
+- `data-state="open|closed"`: AccordionItem, Collapse, Combobox, DropdownMenu and submenus, HoverCard, Modal, MultiSelect, Popover, Select and Tooltip.
 - `data-state="checked|unchecked|indeterminate"`: Checkbox.
-- `data-state="checked|unchecked"`: Radio and Switch.
+- `data-state="checked|unchecked"`: Radio, SegmentedControl controls and inputs, and Switch.
 - `data-state="active|inactive"`: TabsTrigger and TabsContent.
 - `data-state="determinate|indeterminate"`: Progress.
+- `data-state="idle|accept|reject"`: Dropzone.
 - `data-disabled`: the effective disabled state on each applicable control, trigger, item or option.
-- `data-readonly`: Input, Textarea, ColorInput and ColorPicker controls.
+- `data-readonly`: Calendar, Input, Textarea, TagsInput, ColorInput and ColorPicker controls.
 - `data-invalid`: form-control roots and their public input parts.
 - `data-loading`: Button, ButtonLink and IconButton.
 - `data-active` and `data-paused`: FocusTrap.
-- `data-selected`: Select options and ColorPicker swatches.
-- `data-highlighted`: Select options and DropdownMenu items.
+- `data-selected`: Calendar days, Combobox, MultiSelect and Select options, and ColorPicker swatches.
+- `data-outside` and `data-today`: Calendar days.
+- `data-month="YYYY-MM-DD"`: Calendar roots.
+- `data-highlighted`: Combobox, MultiSelect and Select options, and DropdownMenu items.
 - `data-filled`: Slider and RangeSlider marks.
+- `data-filled` and `data-dragging`: Dropzone.
 - `data-track-hovered` and `data-dragging`: Slider track pointer interaction.
 - `data-thumb-visibility="always|interaction|hidden"`: Slider thumb visibility behavior.
 - `data-submenu`: DropdownMenu items that own children.
-- `data-orientation="horizontal|vertical"`: ButtonGroup, RadioGroup, Slider, RangeSlider, Tabs and TabsList.
-- `data-placement`: the final placement after collision handling; twelve placements for Popover and DropdownMenu, and a side (`top`, `right`, `bottom`, `left`) for Tooltip.
-- `data-side="top|right|bottom|left"`: the side component of the final placement for Popover, DropdownMenu and Tooltip.
+- `data-orientation="horizontal|vertical"`: ButtonGroup, RadioGroup, SegmentedControl, Slider, RangeSlider, Tabs and TabsList.
+- `data-placement`: the final placement after collision handling; twelve placements for HoverCard, Popover and DropdownMenu, `top-start|bottom-start` for Combobox, MultiSelect and Select, and a side (`top`, `right`, `bottom`, `left`) for Tooltip.
+- `data-side="top|right|bottom|left"`: the side component of the final placement for Combobox, MultiSelect, HoverCard, Popover, DropdownMenu, Select and Tooltip.
 - `data-control="increment|decrement"`: NumberInput controls.
 - `data-control="saturation|hue|opacity"`: ColorPicker controls and handles.
 - `data-thumb="lower|upper|merged"`: RangeSlider inputs, thumbs and tooltips; `data-active-thumb="lower|upper"` is present on its root only while a thumb is active.
@@ -111,6 +122,8 @@ The exact entries in [`styles-manifest.json`](../src/styles/styles-manifest.json
 
 The manifest contains design tokens plus a deliberately small component-geometry allowlist. Slider and RangeSlider share the `--rp-slider-*` namespace. Size presets provide fallbacks, while a consumer value wins for the individual dimension. See the generated [token table](./public-tokens.md).
 
+The schema-v2 manifest does not pin a Git commit. `tokens:check` resolves compatibility from release tags, so the baseline advances with releases instead of remaining hard-coded.
+
 Palette shades and their normal and active `*-contrast` companions are required override groups because `autoContrast` consumes state-specific companions selected at build time. The [color override contract](./public-tokens.md#color-override-contract) documents the state pairings and preset-role requirements.
 
 ## Cascade layers and migration
@@ -128,6 +141,6 @@ Place global resets in `reset` and application overrides in `app`. Import order
 - Typed parts, state attributes, manifest entries, geometry variables and cascade layers form the current Public Styles API.
 - Renaming or removing a documented part, state attribute or variable changes the public contract.
 - Adding a public part, state attribute or variable extends the public contract.
-- `tokens:check` compares the current manifest with the latest reachable `v*` release tag that contains one. Until the first such release, it uses the immutable manifest from the initial Public Styles API commit (`f16e826`). Released variables cannot be removed, renamed or changed semantically; adding a variable requires incrementing the manifest's `contractVersion`.
-- Release tags must be available in the Git checkout that runs the check. `PUBLIC_STYLES_BASELINE_REF` can explicitly pin a commit or tag that contains a manifest.
+- `tokens:check` compares the current manifest with the latest reachable `v*` release tag that contains one. Released variables cannot be removed, renamed or changed semantically; adding a variable requires incrementing the manifest's `contractVersion`.
+- Release tags must be available in the Git checkout that runs the check. `PUBLIC_STYLES_BASELINE_REF` can explicitly select another Git ref that contains a manifest.
 - Internal DOM, selectors and undocumented variables are outside the public contract.

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "ropav",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
-  "packageManager": "pnpm@11.15.1",
+  "packageManager": "pnpm@11.17.0",
   "engines": {
     "node": "^20.19.0 || ^22.13.0 || >=24.0.0"
   },
@@ -65,6 +65,10 @@
       "types": "./dist/components/button-link/index.d.ts",
       "import": "./dist/components/button-link/index.js"
     },
+    "./calendar": {
+      "types": "./dist/components/calendar/index.d.ts",
+      "import": "./dist/components/calendar/index.js"
+    },
     "./card": {
       "types": "./dist/components/card/index.d.ts",
       "import": "./dist/components/card/index.js"
@@ -89,6 +93,14 @@
       "types": "./dist/components/color-swatch/index.d.ts",
       "import": "./dist/components/color-swatch/index.js"
     },
+    "./combobox": {
+      "types": "./dist/components/combobox/index.d.ts",
+      "import": "./dist/components/combobox/index.js"
+    },
+    "./date-picker": {
+      "types": "./dist/components/date-picker/index.d.ts",
+      "import": "./dist/components/date-picker/index.js"
+    },
     "./dialog": {
       "types": "./dist/components/dialog/index.d.ts",
       "import": "./dist/components/dialog/index.js"
@@ -97,10 +109,18 @@
       "types": "./dist/components/dropdown-menu/index.d.ts",
       "import": "./dist/components/dropdown-menu/index.js"
     },
+    "./dropzone": {
+      "types": "./dist/components/dropzone/index.d.ts",
+      "import": "./dist/components/dropzone/index.js"
+    },
     "./field": {
       "types": "./dist/components/field/index.d.ts",
       "import": "./dist/components/field/index.js"
     },
+    "./file-input": {
+      "types": "./dist/components/file-input/index.d.ts",
+      "import": "./dist/components/file-input/index.js"
+    },
     "./floating": {
       "types": "./dist/components/floating/index.d.ts",
       "import": "./dist/components/floating/index.js"
@@ -109,6 +129,10 @@
       "types": "./dist/components/focus-trap/index.d.ts",
       "import": "./dist/components/focus-trap/index.js"
     },
+    "./hover-card": {
+      "types": "./dist/components/hover-card/index.d.ts",
+      "import": "./dist/components/hover-card/index.js"
+    },
     "./icon-button": {
       "types": "./dist/components/icon-button/index.d.ts",
       "import": "./dist/components/icon-button/index.js"
@@ -121,6 +145,10 @@
       "types": "./dist/components/modal/index.d.ts",
       "import": "./dist/components/modal/index.js"
     },
+    "./multi-select": {
+      "types": "./dist/components/multi-select/index.d.ts",
+      "import": "./dist/components/multi-select/index.js"
+    },
     "./number-input": {
       "types": "./dist/components/number-input/index.d.ts",
       "import": "./dist/components/number-input/index.js"
@@ -149,6 +177,10 @@
       "types": "./dist/components/scroll-area/index.d.ts",
       "import": "./dist/components/scroll-area/index.js"
     },
+    "./segmented-control": {
+      "types": "./dist/components/segmented-control/index.d.ts",
+      "import": "./dist/components/segmented-control/index.js"
+    },
     "./select": {
       "types": "./dist/components/select/index.d.ts",
       "import": "./dist/components/select/index.js"
@@ -165,6 +197,10 @@
       "types": "./dist/components/tabs/index.d.ts",
       "import": "./dist/components/tabs/index.js"
     },
+    "./tags-input": {
+      "types": "./dist/components/tags-input/index.d.ts",
+      "import": "./dist/components/tags-input/index.js"
+    },
     "./teleport-provider": {
       "types": "./dist/components/teleport-provider/index.d.ts",
       "import": "./dist/components/teleport-provider/index.js"
@@ -192,8 +228,9 @@
   },
   "scripts": {
     "dev": "pnpm run storybook",
-    "public-api:sync": "node scripts/sync-public-api.mjs --write",
-    "public-api:check": "node scripts/sync-public-api.mjs --check",
+    "publication:sync": "node scripts/sync-package-publication.mjs --write",
+    "publication:check": "node scripts/sync-package-publication.mjs --check",
+    "publication:verify": "node scripts/verify-package-publication.mjs",
     "tokens:build": "style-dictionary build --config scripts/tokens.config.mjs --silent",
     "tokens:check": "node scripts/check-tokens.mjs",
     "typecheck": "vue-tsc -b tsconfig.app.json tsconfig.node.json tsconfig.test.json",
@@ -204,13 +241,13 @@
     "format:check": "oxfmt --check",
     "test": "vitest run --project=unit --project=tooling",
     "test:consumer-types:built": "tsc -p tests/fixtures/consumer-types/tsconfig.bundler.json && tsc -p tests/fixtures/consumer-types/tsconfig.nodenext.json",
-    "test:exports:built": "node scripts/check-exports.mjs",
+    "test:bundle:built": "node scripts/check-package-bundle.mjs",
     "test:consumer-fixture:built": "node tests/fixtures/consumer-app/check.mjs && vue-tsc -p tests/fixtures/consumer-app/tsconfig.json --noEmit && vite build --config tests/fixtures/consumer-app/vite.config.ts && node tests/fixtures/consumer-app/assertions.mjs",
-    "test:package": "pnpm run build && pnpm run test:exports:built && pnpm run test:consumer-types:built && pnpm run test:consumer-fixture:built",
+    "test:package": "pnpm run build && pnpm run publication:verify && pnpm run test:bundle:built && pnpm run test:consumer-types:built && pnpm run test:consumer-fixture:built",
     "test:watch": "vitest --project=unit --project=tooling",
     "test:typecheck": "vitest run --project=unit --project=tooling --typecheck",
     "test:storybook": "vitest run --project=storybook-light --project=storybook-dark",
-    "build": "pnpm run public-api:check && pnpm run tokens:build && pnpm run tokens:check && pnpm run typecheck && vite build",
+    "build": "pnpm run publication:check && pnpm run tokens:build && pnpm run tokens:check && pnpm run typecheck && vite build",
     "verify": "pnpm run lint && pnpm run format:check && pnpm run typecheck:storybook && pnpm run test && pnpm run test:storybook && pnpm run test:package",
     "prepublishOnly": "pnpm run verify",
     "preview": "vite preview",
@@ -220,9 +257,9 @@
     "release": "pnpm run verify && bumpp --git-check --all --commit \"chore(release): v%s\" --tag \"v%s\" --execute \"pnpm run changelog\""
   },
   "peerDependencies": {
-    "@vue/compiler-vapor": "3.6.0-rc.1",
+    "@vue/compiler-vapor": "3.6.0-rc.2",
     "unplugin-icons": "^23.0.1",
-    "vue": "^3.6.0-rc.1"
+    "vue": "^3.6.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@vue/compiler-vapor": {
@@ -245,13 +282,13 @@
     "@types/node": "^26.1.1",
     "@vitejs/plugin-vue": "^6.0.8",
     "@vitest/browser-playwright": "^4.1.10",
-    "@vue/compiler-vapor": "3.6.0-rc.1",
+    "@vue/compiler-vapor": "3.6.0-rc.2",
     "@vue/tsconfig": "^0.9.1",
-    "bumpp": "^11.1.0",
+    "bumpp": "^12.0.0",
     "conventional-changelog": "^8.1.0",
     "conventional-changelog-conventionalcommits": "^10.2.1",
     "jsdom": "^29.1.1",
-    "oxfmt": "^0.59.0",
+    "oxfmt": "^0.60.0",
     "oxlint": "^1.75.0",
     "playwright": "^1.61.1",
     "sass-embedded": "^1.100.0",
@@ -263,8 +300,8 @@
     "vite": "^8.1.5",
     "vite-plugin-dts": "^5.0.3",
     "vitest": "^4.1.10",
-    "vue": "3.6.0-rc.1",
-    "vue-tsc": "^3.3.7"
+    "vue": "3.6.0-rc.2",
+    "vue-tsc": "^3.3.8"
   },
   "repository": {
     "type": "git",

package/src/styles/_mixins.scss

@@ -108,6 +108,32 @@ $rp-component-colors:
     padding: var(--rp-spacing-1) 0;
 }
 
+@mixin bordered-floating-arrow {
+    background-color: inherit;
+    border: inherit;
+    rotate: 45deg;
+
+    &[data-side='top'] {
+        border-top-color: transparent;
+        border-left-color: transparent;
+    }
+
+    &[data-side='right'] {
+        border-top-color: transparent;
+        border-right-color: transparent;
+    }
+
+    &[data-side='bottom'] {
+        border-right-color: transparent;
+        border-bottom-color: transparent;
+    }
+
+    &[data-side='left'] {
+        border-bottom-color: transparent;
+        border-left-color: transparent;
+    }
+}
+
 @mixin inline-icon($size: 1em) {
     display: inline-flex;
     align-items: center;

package/src/styles/styles-manifest.json

@@ -1,7 +1,6 @@
 {
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "contractVersion": 2,
-  "baseline": "5102a40",
   "tokens": [
     {
       "name": "--rp-border-width-medium",

package/dist/components/dropdown-menu/dropdown-menu-outside.d.ts

@@ -1,3 +0,0 @@
-import { DropdownMenuInteractOutsideTarget } from './types.js';
-export declare function isEventWithinElement(event: Event, element: Element): boolean;
-export declare function isEventWithinTargets(event: Event, targets: readonly DropdownMenuInteractOutsideTarget[]): boolean;