@skdx/vue 0.27.0 → 0.29.0

package/dist/color-picker/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ColorPicker.vue.cjs"),e=require("./ColorPickerArea.vue.cjs"),o=require("./ColorPickerAreaThumb.vue.cjs"),i=require("./ColorPickerHueSlider.vue.cjs"),l=require("./ColorPickerHueSliderThumb.vue.cjs"),u=require("./ColorPickerAlphaSlider.vue.cjs"),c=require("./ColorPickerAlphaSliderThumb.vue.cjs"),t=require("./ColorPickerSwatchGroup.vue.cjs"),k=require("./ColorPickerSwatch.vue.cjs"),d=require("./ColorPickerInput.vue.cjs"),a=require("./ColorPickerFormatSelect.vue.cjs"),S=require("./ColorPickerEyeDropper.vue.cjs");exports.SkdxColorPicker=r.default;exports.SkdxColorPickerAlphaSlider=u.default;exports.SkdxColorPickerAlphaSliderThumb=c.default;exports.SkdxColorPickerArea=e.default;exports.SkdxColorPickerAreaThumb=o.default;exports.SkdxColorPickerEyeDropper=S.default;exports.SkdxColorPickerFormatSelect=a.default;exports.SkdxColorPickerHueSlider=i.default;exports.SkdxColorPickerHueSliderThumb=l.default;exports.SkdxColorPickerInput=d.default;exports.SkdxColorPickerSwatch=k.default;exports.SkdxColorPickerSwatchGroup=t.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ColorPicker.vue.cjs");exports.SkdxColorPicker=e.default;

package/dist/color-picker/index.d.cts

@@ -1,13 +1 @@
 export { default as SkdxColorPicker } from './ColorPicker.vue.cjs';
-export { default as SkdxColorPickerArea } from './ColorPickerArea.vue.cjs';
-export { default as SkdxColorPickerAreaThumb } from './ColorPickerAreaThumb.vue.cjs';
-export { default as SkdxColorPickerHueSlider } from './ColorPickerHueSlider.vue.cjs';
-export { default as SkdxColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.vue.cjs';
-export { default as SkdxColorPickerAlphaSlider } from './ColorPickerAlphaSlider.vue.cjs';
-export { default as SkdxColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.vue.cjs';
-export { default as SkdxColorPickerSwatchGroup } from './ColorPickerSwatchGroup.vue.cjs';
-export { default as SkdxColorPickerSwatch } from './ColorPickerSwatch.vue.cjs';
-export { default as SkdxColorPickerInput } from './ColorPickerInput.vue.cjs';
-export { default as SkdxColorPickerFormatSelect } from './ColorPickerFormatSelect.vue.cjs';
-export { default as SkdxColorPickerEyeDropper } from './ColorPickerEyeDropper.vue.cjs';
-export type { ColorChannel } from './context.cjs';

package/dist/color-picker/index.d.ts

@@ -1,13 +1 @@
 export { default as SkdxColorPicker } from './ColorPicker.vue.js';
-export { default as SkdxColorPickerArea } from './ColorPickerArea.vue.js';
-export { default as SkdxColorPickerAreaThumb } from './ColorPickerAreaThumb.vue.js';
-export { default as SkdxColorPickerHueSlider } from './ColorPickerHueSlider.vue.js';
-export { default as SkdxColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.vue.js';
-export { default as SkdxColorPickerAlphaSlider } from './ColorPickerAlphaSlider.vue.js';
-export { default as SkdxColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.vue.js';
-export { default as SkdxColorPickerSwatchGroup } from './ColorPickerSwatchGroup.vue.js';
-export { default as SkdxColorPickerSwatch } from './ColorPickerSwatch.vue.js';
-export { default as SkdxColorPickerInput } from './ColorPickerInput.vue.js';
-export { default as SkdxColorPickerFormatSelect } from './ColorPickerFormatSelect.vue.js';
-export { default as SkdxColorPickerEyeDropper } from './ColorPickerEyeDropper.vue.js';
-export type { ColorChannel } from './context.js';

package/dist/color-picker/index.js

@@ -1 +1 @@
-import r from"./ColorPicker.vue.js";import o from"./ColorPickerArea.vue.js";import e from"./ColorPickerAreaThumb.vue.js";import i from"./ColorPickerHueSlider.vue.js";import l from"./ColorPickerHueSliderThumb.vue.js";import k from"./ColorPickerAlphaSlider.vue.js";import m from"./ColorPickerAlphaSliderThumb.vue.js";import c from"./ColorPickerSwatchGroup.vue.js";import a from"./ColorPickerSwatch.vue.js";import u from"./ColorPickerInput.vue.js";import S from"./ColorPickerFormatSelect.vue.js";import p from"./ColorPickerEyeDropper.vue.js";export{r as SkdxColorPicker,k as SkdxColorPickerAlphaSlider,m as SkdxColorPickerAlphaSliderThumb,o as SkdxColorPickerArea,e as SkdxColorPickerAreaThumb,p as SkdxColorPickerEyeDropper,S as SkdxColorPickerFormatSelect,i as SkdxColorPickerHueSlider,l as SkdxColorPickerHueSliderThumb,u as SkdxColorPickerInput,a as SkdxColorPickerSwatch,c as SkdxColorPickerSwatchGroup};
+import o from"./ColorPicker.vue.js";export{o as SkdxColorPicker};

package/dist/color-picker/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ColorPickerAlphaSlider.vue.cjs"),e=require("./ColorPickerAlphaSliderThumb.vue.cjs"),o=require("./ColorPickerArea.vue.cjs"),i=require("./ColorPickerAreaThumb.vue.cjs"),l=require("./ColorPickerEyeDropper.vue.cjs"),u=require("./ColorPickerHueSlider.vue.cjs"),c=require("./ColorPickerHueSliderThumb.vue.cjs"),t=require("./ColorPickerInput.vue.cjs"),k=require("./ColorPickerSwatch.vue.cjs"),d=require("./ColorPickerSwatchGroup.vue.cjs"),a=require("./ColorPicker.vue.cjs"),S=require("./ColorPickerFormatSelect.vue.cjs");exports.SkdxColorPicker=a.default;exports.SkdxColorPickerAlphaSlider=r.default;exports.SkdxColorPickerAlphaSliderThumb=e.default;exports.SkdxColorPickerArea=o.default;exports.SkdxColorPickerAreaThumb=i.default;exports.SkdxColorPickerEyeDropper=l.default;exports.SkdxColorPickerFormatSelect=S.default;exports.SkdxColorPickerHueSlider=u.default;exports.SkdxColorPickerHueSliderThumb=c.default;exports.SkdxColorPickerInput=t.default;exports.SkdxColorPickerSwatch=k.default;exports.SkdxColorPickerSwatchGroup=d.default;

package/dist/color-picker/primitives.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Advanced primitives for `SkdxColorPicker`, the parts the recipe composes,
+ * for a different structure than the derived default anatomy.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxColorPicker, SkdxColorPickerArea, SkdxColorPickerAreaThumb, SkdxColorPickerHueSlider, SkdxColorPickerHueSliderThumb, SkdxColorPickerInput } from '@skdx/vue/primitives/color-picker';
+ * </script>
+ *
+ * <template>
+ *   <SkdxColorPicker default-value="#d94c4c">
+ *     <SkdxColorPickerArea><SkdxColorPickerAreaThumb /></SkdxColorPickerArea>
+ *     <SkdxColorPickerHueSlider><SkdxColorPickerHueSliderThumb /></SkdxColorPickerHueSlider>
+ *     <SkdxColorPickerInput />
+ *   </SkdxColorPicker>
+ * </template>
+ * ```
+ */
+export { default as SkdxColorPicker } from './ColorPicker.vue.cjs';
+export { default as SkdxColorPickerArea } from './ColorPickerArea.vue.cjs';
+export { default as SkdxColorPickerAreaThumb } from './ColorPickerAreaThumb.vue.cjs';
+export { default as SkdxColorPickerHueSlider } from './ColorPickerHueSlider.vue.cjs';
+export { default as SkdxColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.vue.cjs';
+export { default as SkdxColorPickerAlphaSlider } from './ColorPickerAlphaSlider.vue.cjs';
+export { default as SkdxColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.vue.cjs';
+export { default as SkdxColorPickerSwatchGroup } from './ColorPickerSwatchGroup.vue.cjs';
+export { default as SkdxColorPickerSwatch } from './ColorPickerSwatch.vue.cjs';
+export { default as SkdxColorPickerInput } from './ColorPickerInput.vue.cjs';
+export { default as SkdxColorPickerFormatSelect } from './ColorPickerFormatSelect.vue.cjs';
+export { default as SkdxColorPickerEyeDropper } from './ColorPickerEyeDropper.vue.cjs';
+export type { ColorChannel } from './context.cjs';

package/dist/color-picker/primitives.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Advanced primitives for `SkdxColorPicker`, the parts the recipe composes,
+ * for a different structure than the derived default anatomy.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxColorPicker, SkdxColorPickerArea, SkdxColorPickerAreaThumb, SkdxColorPickerHueSlider, SkdxColorPickerHueSliderThumb, SkdxColorPickerInput } from '@skdx/vue/primitives/color-picker';
+ * </script>
+ *
+ * <template>
+ *   <SkdxColorPicker default-value="#d94c4c">
+ *     <SkdxColorPickerArea><SkdxColorPickerAreaThumb /></SkdxColorPickerArea>
+ *     <SkdxColorPickerHueSlider><SkdxColorPickerHueSliderThumb /></SkdxColorPickerHueSlider>
+ *     <SkdxColorPickerInput />
+ *   </SkdxColorPicker>
+ * </template>
+ * ```
+ */
+export { default as SkdxColorPicker } from './ColorPicker.vue.js';
+export { default as SkdxColorPickerArea } from './ColorPickerArea.vue.js';
+export { default as SkdxColorPickerAreaThumb } from './ColorPickerAreaThumb.vue.js';
+export { default as SkdxColorPickerHueSlider } from './ColorPickerHueSlider.vue.js';
+export { default as SkdxColorPickerHueSliderThumb } from './ColorPickerHueSliderThumb.vue.js';
+export { default as SkdxColorPickerAlphaSlider } from './ColorPickerAlphaSlider.vue.js';
+export { default as SkdxColorPickerAlphaSliderThumb } from './ColorPickerAlphaSliderThumb.vue.js';
+export { default as SkdxColorPickerSwatchGroup } from './ColorPickerSwatchGroup.vue.js';
+export { default as SkdxColorPickerSwatch } from './ColorPickerSwatch.vue.js';
+export { default as SkdxColorPickerInput } from './ColorPickerInput.vue.js';
+export { default as SkdxColorPickerFormatSelect } from './ColorPickerFormatSelect.vue.js';
+export { default as SkdxColorPickerEyeDropper } from './ColorPickerEyeDropper.vue.js';
+export type { ColorChannel } from './context.js';

package/dist/color-picker/primitives.js

@@ -0,0 +1 @@
+import r from"./ColorPickerAlphaSlider.vue.js";import o from"./ColorPickerAlphaSliderThumb.vue.js";import e from"./ColorPickerArea.vue.js";import i from"./ColorPickerAreaThumb.vue.js";import l from"./ColorPickerEyeDropper.vue.js";import k from"./ColorPickerHueSlider.vue.js";import m from"./ColorPickerHueSliderThumb.vue.js";import c from"./ColorPickerInput.vue.js";import a from"./ColorPickerSwatch.vue.js";import u from"./ColorPickerSwatchGroup.vue.js";import S from"./ColorPicker.vue.js";import p from"./ColorPickerFormatSelect.vue.js";export{S as SkdxColorPicker,r as SkdxColorPickerAlphaSlider,o as SkdxColorPickerAlphaSliderThumb,e as SkdxColorPickerArea,i as SkdxColorPickerAreaThumb,l as SkdxColorPickerEyeDropper,p as SkdxColorPickerFormatSelect,k as SkdxColorPickerHueSlider,m as SkdxColorPickerHueSliderThumb,c as SkdxColorPickerInput,a as SkdxColorPickerSwatch,u as SkdxColorPickerSwatchGroup};

package/dist/color-picker/useChannelSlider.d.cts

@@ -1,26 +1,19 @@
-/**
- * The behaviour shared by `SkdxColorPickerHueSlider` and
- * `SkdxColorPickerAlphaSlider`. Mirrors
- * `packages/react/src/color-picker/useChannelSlider.ts`. @internal
- */
-import { type MaybeRefOrGetter, type Ref } from 'vue';
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
 /** @internal Options for {@link useChannelSlider}. */
 export interface UseChannelSliderOptions {
-    /** Published as `data-channel`. */
+    /** Published as the element's `data-channel` attribute. */
     channel: 'hue' | 'alpha';
     /** Name of the calling part, for the context error message. */
     consumerName: string;
     /** Top of the range as ARIA reports it; the bottom is always 0. */
     max: number;
     /**
-     * Highest value actually reachable, when that is not `max`. Hue needs it:
-     * the axis genuinely spans 360°, but 360 *is* 0, so the track stops at the
-     * last hue on the step grid below it rather than folding round and throwing
-     * the thumb back to the left edge mid-drag.
+     * Highest value actually reachable when not `max`, which hue needs so the
+     * track stops before wrapping 360° back to 0° mid-drag.
      * @default options.max
      */
     limit?: MaybeRefOrGetter<number>;
-    /** Current position on that range. A ref or getter, so the track follows the colour. */
+    /** Current position on that range, a ref or getter so the track follows the colour. */
     value: MaybeRefOrGetter<number>;
     orientation: MaybeRefOrGetter<'horizontal' | 'vertical'>;
     /** Accessible name used when the consumer supplies none. */
@@ -31,57 +24,14 @@ export interface UseChannelSliderOptions {
     onChange: (value: number) => void;
 }
 /**
- * A linear `role="slider"` track over `0…max` with pointer drag,
- * click-to-seek and a full keyboard path.
- *
- * The two parts that use it differ only in their range, their wording and
- * which field of the colour they write, so the alternative is one file copied
- * onto another with three identifiers changed — and a keyboard bug fixed in
- * one of them.
- *
- * **The track has ends; it does not wrap.** Hue is circular, but a linear
- * control reporting `aria-valuemin="0"`/`aria-valuemax="360"` that silently
- * teleported from one end to the other would be lying to assistive tech.
- * `SkdxAngleSlider` is the wrapping control.
- *
- * Pointer geometry is physical (left-to-right, bottom-to-top), matching
- * `SkdxSlider`; only the arrow **keys** are mirrored under `dir="rtl"`, via
- * `directionalKey`.
- *
- * Returns `attrs` (ARIA, `data-*` and `tabindex`, for `v-bind` on the track),
- * the two handlers to bind, and `dragging`. The return type is deliberately
- * *inferred* rather than declared as a `Record`: `v-bind` on a native element
- * is typechecked attribute by attribute, and an index signature widens
- * `aria-orientation` past the literal union Vue's `HTMLAttributes` wants — the
- * same trap `RatingItem.vue` documents.
- *
- * Vue's fallthrough attributes are merged *after* `attrs`, so every one of them
- * stays overridable by the consumer — the precedence React gets from spreading
- * `{...slider.props} {...props}`.
+ * @internal Linear `role="slider"` track over 0…max with pointer drag,
+ * click-to-seek, and keyboard support, with ends that don't wrap.
  *
- * @param trackRef Template ref for the track element, whose box the drag is measured against.
- * @internal
+ * @param trackRef Template ref for track element; drag measured against its box.
  */
 export declare function useChannelSlider(trackRef: Ref<HTMLElement | null>, options: UseChannelSliderOptions): {
-    attrs: import("vue").ComputedRef<{
-        role: string;
-        'aria-label': string;
-        'aria-valuemin': number;
-        'aria-valuemax': number;
-        'aria-valuenow': number;
-        'aria-valuetext': string;
-        'aria-orientation': "horizontal" | "vertical";
-        'aria-disabled': true | undefined;
-        'aria-readonly': true | undefined;
-        tabindex: number;
-        'data-channel': "hue" | "alpha";
-        'data-orientation': "horizontal" | "vertical";
-        'data-value': number;
-        'data-disabled': string | undefined;
-        'data-readonly': string | undefined;
-        'data-dragging': string | undefined;
-    }>;
+    attrs: ComputedRef<Record<string, string | number | boolean | undefined>>;
     onKeydown: (event: KeyboardEvent) => void;
     onPointerdown: (event: PointerEvent) => void;
-    dragging: Readonly<Ref<boolean, boolean>>;
+    dragging: Readonly<Ref<boolean>>;
 };

package/dist/color-picker/useChannelSlider.d.ts

@@ -1,26 +1,19 @@
-/**
- * The behaviour shared by `SkdxColorPickerHueSlider` and
- * `SkdxColorPickerAlphaSlider`. Mirrors
- * `packages/react/src/color-picker/useChannelSlider.ts`. @internal
- */
-import { type MaybeRefOrGetter, type Ref } from 'vue';
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
 /** @internal Options for {@link useChannelSlider}. */
 export interface UseChannelSliderOptions {
-    /** Published as `data-channel`. */
+    /** Published as the element's `data-channel` attribute. */
     channel: 'hue' | 'alpha';
     /** Name of the calling part, for the context error message. */
     consumerName: string;
     /** Top of the range as ARIA reports it; the bottom is always 0. */
     max: number;
     /**
-     * Highest value actually reachable, when that is not `max`. Hue needs it:
-     * the axis genuinely spans 360°, but 360 *is* 0, so the track stops at the
-     * last hue on the step grid below it rather than folding round and throwing
-     * the thumb back to the left edge mid-drag.
+     * Highest value actually reachable when not `max`, which hue needs so the
+     * track stops before wrapping 360° back to 0° mid-drag.
      * @default options.max
      */
     limit?: MaybeRefOrGetter<number>;
-    /** Current position on that range. A ref or getter, so the track follows the colour. */
+    /** Current position on that range, a ref or getter so the track follows the colour. */
     value: MaybeRefOrGetter<number>;
     orientation: MaybeRefOrGetter<'horizontal' | 'vertical'>;
     /** Accessible name used when the consumer supplies none. */
@@ -31,57 +24,14 @@ export interface UseChannelSliderOptions {
     onChange: (value: number) => void;
 }
 /**
- * A linear `role="slider"` track over `0…max` with pointer drag,
- * click-to-seek and a full keyboard path.
- *
- * The two parts that use it differ only in their range, their wording and
- * which field of the colour they write, so the alternative is one file copied
- * onto another with three identifiers changed — and a keyboard bug fixed in
- * one of them.
- *
- * **The track has ends; it does not wrap.** Hue is circular, but a linear
- * control reporting `aria-valuemin="0"`/`aria-valuemax="360"` that silently
- * teleported from one end to the other would be lying to assistive tech.
- * `SkdxAngleSlider` is the wrapping control.
- *
- * Pointer geometry is physical (left-to-right, bottom-to-top), matching
- * `SkdxSlider`; only the arrow **keys** are mirrored under `dir="rtl"`, via
- * `directionalKey`.
- *
- * Returns `attrs` (ARIA, `data-*` and `tabindex`, for `v-bind` on the track),
- * the two handlers to bind, and `dragging`. The return type is deliberately
- * *inferred* rather than declared as a `Record`: `v-bind` on a native element
- * is typechecked attribute by attribute, and an index signature widens
- * `aria-orientation` past the literal union Vue's `HTMLAttributes` wants — the
- * same trap `RatingItem.vue` documents.
- *
- * Vue's fallthrough attributes are merged *after* `attrs`, so every one of them
- * stays overridable by the consumer — the precedence React gets from spreading
- * `{...slider.props} {...props}`.
+ * @internal Linear `role="slider"` track over 0…max with pointer drag,
+ * click-to-seek, and keyboard support, with ends that don't wrap.
  *
- * @param trackRef Template ref for the track element, whose box the drag is measured against.
- * @internal
+ * @param trackRef Template ref for track element; drag measured against its box.
  */
 export declare function useChannelSlider(trackRef: Ref<HTMLElement | null>, options: UseChannelSliderOptions): {
-    attrs: import("vue").ComputedRef<{
-        role: string;
-        'aria-label': string;
-        'aria-valuemin': number;
-        'aria-valuemax': number;
-        'aria-valuenow': number;
-        'aria-valuetext': string;
-        'aria-orientation': "horizontal" | "vertical";
-        'aria-disabled': true | undefined;
-        'aria-readonly': true | undefined;
-        tabindex: number;
-        'data-channel': "hue" | "alpha";
-        'data-orientation': "horizontal" | "vertical";
-        'data-value': number;
-        'data-disabled': string | undefined;
-        'data-readonly': string | undefined;
-        'data-dragging': string | undefined;
-    }>;
+    attrs: ComputedRef<Record<string, string | number | boolean | undefined>>;
     onKeydown: (event: KeyboardEvent) => void;
     onPointerdown: (event: PointerEvent) => void;
-    dragging: Readonly<Ref<boolean, boolean>>;
+    dragging: Readonly<Ref<boolean>>;
 };

package/dist/color-picker/usePointerRatio.d.cts

@@ -1,9 +1,5 @@
-/**
- * Pointer-drag-to-position, the linear twin of `utils/usePointerAngle`.
- * Mirrors `packages/react/src/color-picker/usePointerRatio.ts`. @internal
- */
 import { type Ref } from 'vue';
-/** Position inside an element's border box, as fractions of its width and height. `{ x: 0, y: 0 }` is the top-left corner. */
+/** Position inside an element's border box, as fractions of its width and height, where `{ x: 0, y: 0 }` is the top-left corner. */
 export interface PointerRatio {
     x: number;
     y: number;
@@ -12,39 +8,21 @@ export interface PointerRatio {
 export interface UsePointerRatioOptions {
     /** Fires with the position on pointer down and on every subsequent move that changes it, plus the native event. */
     onRatioChange: (ratio: PointerRatio, event: PointerEvent) => void;
-    /** Fires once when the drag ends — `pointerup` or `pointercancel`. The final position was already reported by `onRatioChange`. */
+    /** Fires once when the drag ends (`pointerup` or `pointercancel`), after the final position was already reported by `onRatioChange`. */
     onRatioChangeEnd?: (event: PointerEvent) => void;
 }
 /** Return value of {@link usePointerRatio}. @internal */
 export interface UsePointerRatioResult {
-    /**
-     * Bind on the element whose box defines the coordinate space via
-     * `@pointerdown`. The measurement source is the element in the ref handed to
-     * the composable, and it is re-measured on every move.
-     */
+    /** Bind on the element defining coordinate space, re-measured on every move. */
     onPointerDown: (event: PointerEvent) => void;
-    /** `true` between pointer down and pointer up/cancel. Suitable for a `data-dragging` styling hook. */
+    /** `true` between pointer down and pointer up/cancel, suitable for a `data-dragging` styling hook. */
     dragging: Readonly<Ref<boolean>>;
 }
 /**
- * Turns a pointer position inside an element into normalized `x`/`y` fractions
- * in `[0, 1]`, for widgets whose input is a *position* rather than a direction
- * — the colour picker's 2D area and its hue and alpha tracks.
- *
- * It exists rather than three copies of `SkdxSlider`'s pointer block because
- * those three parts each need a genuine drag-end signal (`value-commit` fires
- * once per drag) and each needs `data-dragging`, and because document-level
- * listeners keep a drag alive when the pointer leaves the window — which
- * element-level `pointermove` does not.
- *
- * Deliberately knows nothing about value ranges, channels, ARIA, RTL, or
- * `disabled`/`readOnly`: `x` is always measured left-to-right from the border
- * box, exactly as `SkdxSlider` measures it, and a part that must ignore pointer
- * input simply does not call `onPointerDown`.
- *
- * Nothing is measured or subscribed during `setup`, so it is safe under SSR.
+ * Turns pointer position into normalized [0,1] fractions for position-input
+ * widgets like a colour picker area or track, safe under SSR.
  *
- * @param elementRef Template ref for the element whose border box is the coordinate space.
+ * @param elementRef Template ref for coordinate space element.
  * @internal
  */
 export declare function usePointerRatio(elementRef: Ref<HTMLElement | null>, options: UsePointerRatioOptions): UsePointerRatioResult;

package/dist/color-picker/usePointerRatio.d.ts

@@ -1,9 +1,5 @@
-/**
- * Pointer-drag-to-position, the linear twin of `utils/usePointerAngle`.
- * Mirrors `packages/react/src/color-picker/usePointerRatio.ts`. @internal
- */
 import { type Ref } from 'vue';
-/** Position inside an element's border box, as fractions of its width and height. `{ x: 0, y: 0 }` is the top-left corner. */
+/** Position inside an element's border box, as fractions of its width and height, where `{ x: 0, y: 0 }` is the top-left corner. */
 export interface PointerRatio {
     x: number;
     y: number;
@@ -12,39 +8,21 @@ export interface PointerRatio {
 export interface UsePointerRatioOptions {
     /** Fires with the position on pointer down and on every subsequent move that changes it, plus the native event. */
     onRatioChange: (ratio: PointerRatio, event: PointerEvent) => void;
-    /** Fires once when the drag ends — `pointerup` or `pointercancel`. The final position was already reported by `onRatioChange`. */
+    /** Fires once when the drag ends (`pointerup` or `pointercancel`), after the final position was already reported by `onRatioChange`. */
     onRatioChangeEnd?: (event: PointerEvent) => void;
 }
 /** Return value of {@link usePointerRatio}. @internal */
 export interface UsePointerRatioResult {
-    /**
-     * Bind on the element whose box defines the coordinate space via
-     * `@pointerdown`. The measurement source is the element in the ref handed to
-     * the composable, and it is re-measured on every move.
-     */
+    /** Bind on the element defining coordinate space, re-measured on every move. */
     onPointerDown: (event: PointerEvent) => void;
-    /** `true` between pointer down and pointer up/cancel. Suitable for a `data-dragging` styling hook. */
+    /** `true` between pointer down and pointer up/cancel, suitable for a `data-dragging` styling hook. */
     dragging: Readonly<Ref<boolean>>;
 }
 /**
- * Turns a pointer position inside an element into normalized `x`/`y` fractions
- * in `[0, 1]`, for widgets whose input is a *position* rather than a direction
- * — the colour picker's 2D area and its hue and alpha tracks.
- *
- * It exists rather than three copies of `SkdxSlider`'s pointer block because
- * those three parts each need a genuine drag-end signal (`value-commit` fires
- * once per drag) and each needs `data-dragging`, and because document-level
- * listeners keep a drag alive when the pointer leaves the window — which
- * element-level `pointermove` does not.
- *
- * Deliberately knows nothing about value ranges, channels, ARIA, RTL, or
- * `disabled`/`readOnly`: `x` is always measured left-to-right from the border
- * box, exactly as `SkdxSlider` measures it, and a part that must ignore pointer
- * input simply does not call `onPointerDown`.
- *
- * Nothing is measured or subscribed during `setup`, so it is safe under SSR.
+ * Turns pointer position into normalized [0,1] fractions for position-input
+ * widgets like a colour picker area or track, safe under SSR.
  *
- * @param elementRef Template ref for the element whose border box is the coordinate space.
+ * @param elementRef Template ref for coordinate space element.
  * @internal
  */
 export declare function usePointerRatio(elementRef: Ref<HTMLElement | null>, options: UsePointerRatioOptions): UsePointerRatioResult;