@vizejs/ui 0.387.0 → 0.389.0

package/dist/slider-CYBbxeNy.d.mts

@@ -0,0 +1,246 @@
+import { ComputedRef, StyleValue } from "vue";
+
+//#region src/families/form/slider/slider-types.d.ts
+/** Values accepted by the native `aria-invalid` attribute. */
+type SliderAriaInvalid = boolean | "grammar" | "spelling";
+/** Logical orientation published by the Slider primitive. */
+type SliderOrientation = "horizontal" | "vertical";
+/** Text direction used for native range directionality and styling hooks. */
+type SliderDirection = "ltr" | "rtl";
+/** Positive native range step or browser-owned arbitrary precision. */
+type SliderStep = number | "any";
+/** State exposed through the Slider Native CSS data contract. */
+type SliderState = "disabled" | "in-range" | "invalid" | "max" | "min" | "readonly";
+/** Headless CSS custom properties authored by the Slider root. */
+type SliderStyle = StyleValue & {
+  readonly "--vize-slider-value": string;
+  readonly "--vize-slider-min": string;
+  readonly "--vize-slider-max": string;
+  readonly "--vize-slider-step": string;
+  readonly "--vize-slider-percent": string;
+};
+/** Public props accepted by the Slider component. */
+interface SliderProps {
+  /**
+   * Consumer-owned control id. `null` and `undefined` select a deterministic fallback.
+   *
+   * @default undefined
+   */
+  readonly id?: string | null;
+  /**
+   * Native form field name submitted by the range input.
+   *
+   * @default undefined
+   */
+  readonly name?: string;
+  /**
+   * Controlled numeric value. `undefined` selects uncontrolled behavior.
+   *
+   * @default undefined
+   */
+  readonly modelValue?: number;
+  /**
+   * Initial value for uncontrolled use and the value restored by form reset.
+   *
+   * @default undefined
+   */
+  readonly defaultValue?: number;
+  /**
+   * Native lower bound.
+   *
+   * @default 0
+   */
+  readonly min?: number;
+  /**
+   * Native upper bound. Values less than or equal to `min` are repaired to `min + 1`.
+   *
+   * @default 100
+   */
+  readonly max?: number;
+  /**
+   * Native positive step, or `"any"` for browser-owned arbitrary precision.
+   *
+   * @default 1
+   */
+  readonly step?: SliderStep;
+  /**
+   * Disable editing, focus, and native form submission.
+   *
+   * @default false
+   */
+  readonly disabled?: boolean;
+  /**
+   * Keep the slider focusable while preventing user value changes.
+   *
+   * @default false
+   */
+  readonly readOnly?: boolean;
+  /**
+   * Mark the slider as required for native constraint validation.
+   *
+   * @default false
+   */
+  readonly required?: boolean;
+  /**
+   * Logical orientation exposed to ARIA and data attributes.
+   *
+   * @default "horizontal"
+   */
+  readonly orientation?: SliderOrientation;
+  /**
+   * Text direction applied to the native range input.
+   *
+   * @default "ltr"
+   */
+  readonly dir?: SliderDirection;
+  /**
+   * Accessible name when no label or `aria-labelledby` supplies one.
+   *
+   * @default undefined
+   */
+  readonly ariaLabel?: string;
+  /**
+   * Space-separated ids that label the slider.
+   *
+   * @default undefined
+   */
+  readonly ariaLabelledby?: string;
+  /**
+   * Space-separated ids that describe the slider.
+   *
+   * @default undefined
+   */
+  readonly ariaDescribedby?: string;
+  /**
+   * Id of the validation error message used while invalid.
+   *
+   * @default undefined
+   */
+  readonly ariaErrormessage?: string;
+  /**
+   * Human-readable value text for assistive technology.
+   *
+   * @default undefined
+   */
+  readonly ariaValueText?: string;
+  /**
+   * Invalid state announced to assistive technology.
+   *
+   * @default false
+   */
+  readonly ariaInvalid?: SliderAriaInvalid;
+}
+/** Emits published by the Slider component. */
+interface SliderEmits {
+  /** Fired when the value requests a new controlled number. */
+  "update:modelValue": [value: number];
+  /** Fired after a native input event with the next number and native `Event`. */
+  input: [value: number, nativeEvent: Event];
+  /** Fired after native change/commit with the current number and native `Event`. */
+  change: [value: number, nativeEvent: Event];
+}
+/** Slots exposed by the Slider component. */
+interface SliderSlots {
+  /** Renders optional marks or output with the normalized Slider state. */
+  default(props: SliderSlotState): unknown;
+}
+/** State exposed to the default Slider slot and component instance. */
+interface SliderSlotState {
+  /** Current normalized numeric value. */
+  readonly value: number;
+  /** Normalized lower bound. */
+  readonly min: number;
+  /** Normalized upper bound. */
+  readonly max: number;
+  /** Normalized positive step, or `"any"` for browser-owned precision. */
+  readonly step: SliderStep;
+  /** Current position from 0 to 100. */
+  readonly percent: number;
+  /** Logical orientation. */
+  readonly orientation: SliderOrientation;
+  /** Text direction used by the native range input. */
+  readonly direction: SliderDirection;
+  /** Whether native activation, focus, and form submission are disabled. */
+  readonly disabled: boolean;
+  /** Whether the slider remains focusable while user value changes are locked. */
+  readonly readOnly: boolean;
+  /** Whether native constraint validation marks the field required. */
+  readonly required: boolean;
+  /** Whether assistive technology should announce the slider as invalid. */
+  readonly invalid: boolean;
+  /** Stable state token for styling and tests. */
+  readonly state: SliderState;
+}
+/** Public component instance exposed by the Slider primitive. */
+interface SliderExpose extends SliderSlotState {
+  /** Rendered root element that owns the data and CSS custom property contract. */
+  readonly root: HTMLSpanElement | null;
+  /** Rendered native range input. */
+  readonly element: HTMLInputElement | null;
+  /** Move focus to the native range input. */
+  readonly focus: (options?: FocusOptions) => void;
+  /** Request a value update and report whether it differs. */
+  readonly setValue: (value: number) => boolean;
+  /** Increase the value by one or more normalized steps. */
+  readonly stepUp: (steps?: number) => boolean;
+  /** Decrease the value by one or more normalized steps. */
+  readonly stepDown: (steps?: number) => boolean;
+  /** Restore the current default value and report whether it changed. */
+  readonly reset: () => boolean;
+}
+//#endregion
+//#region src/families/form/slider/slider.vue.d.ts
+type __VLS_Slots = {
+  /** Renders optional marks or output with the normalized Slider state. */default(props: SliderSlotState): unknown;
+};
+/** Move focus to the native range input. */
+declare function focus(options?: FocusOptions): void;
+declare function setValue(next: number): boolean;
+declare function stepUp(steps?: number): boolean;
+declare function stepDown(steps?: number): boolean;
+declare const __VLS_base: import("vue").DefineComponent<SliderProps, {
+  direction: ComputedRef<SliderDirection>;
+  disabled: ComputedRef<boolean>;
+  element: Readonly<import("vue").ShallowRef<HTMLInputElement | null>>;
+  focus: typeof focus;
+  invalid: ComputedRef<boolean>;
+  max: ComputedRef<number>;
+  min: ComputedRef<number>;
+  orientation: ComputedRef<SliderOrientation>;
+  percent: ComputedRef<number>;
+  readOnly: ComputedRef<boolean>;
+  required: ComputedRef<boolean>;
+  reset: () => boolean;
+  root: Readonly<import("vue").ShallowRef<HTMLSpanElement | null>>;
+  setValue: typeof setValue;
+  state: ComputedRef<SliderState>;
+  step: ComputedRef<SliderStep>;
+  stepDown: typeof stepDown;
+  stepUp: typeof stepUp;
+  value: ComputedRef<number>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  input: (value: number, nativeEvent: Event) => any;
+  "update:modelValue": (value: number) => any;
+  change: (value: number, nativeEvent: Event) => any;
+}, string, import("vue").PublicProps, Readonly<SliderProps> & Readonly<{
+  onInput?: (value: number, nativeEvent: Event) => any;
+  "onUpdate:modelValue"?: (value: number) => any;
+  onChange?: (value: number, nativeEvent: Event) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/families/form/slider/slider-state.d.ts
+/** Native-friendly default minimum for Slider. */
+declare const SLIDER_DEFAULT_MIN = 0;
+/** Native-friendly default maximum for Slider. */
+declare const SLIDER_DEFAULT_MAX = 100;
+/** Native range default step. */
+declare const SLIDER_DEFAULT_STEP = 1;
+//#endregion
+export { SliderAriaInvalid as a, SliderExpose as c, SliderSlotState as d, SliderSlots as f, SliderStyle as h, _default as i, SliderOrientation as l, SliderStep as m, SLIDER_DEFAULT_MIN as n, SliderDirection as o, SliderState as p, SLIDER_DEFAULT_STEP as r, SliderEmits as s, SLIDER_DEFAULT_MAX as t, SliderProps as u };

package/dist/slider.d.mts

@@ -0,0 +1,2 @@
+import { a as SliderAriaInvalid, c as SliderExpose, d as SliderSlotState, f as SliderSlots, h as SliderStyle, i as _default, l as SliderOrientation, m as SliderStep, n as SLIDER_DEFAULT_MIN, o as SliderDirection, p as SliderState, r as SLIDER_DEFAULT_STEP, s as SliderEmits, t as SLIDER_DEFAULT_MAX, u as SliderProps } from "./slider-CYBbxeNy.mjs";
+export { SLIDER_DEFAULT_MAX, SLIDER_DEFAULT_MIN, SLIDER_DEFAULT_STEP, _default as Slider, type SliderAriaInvalid, type SliderDirection, type SliderEmits, type SliderExpose, type SliderOrientation, type SliderProps, type SliderSlotState, type SliderSlots, type SliderState, type SliderStep, type SliderStyle };

package/dist/slider.mjs

@@ -0,0 +1,2 @@
+import { i as SLIDER_DEFAULT_STEP, n as SLIDER_DEFAULT_MAX, r as SLIDER_DEFAULT_MIN, t as slider_default } from "./slider-BiZSZLDp.mjs";
+export { SLIDER_DEFAULT_MAX, SLIDER_DEFAULT_MIN, SLIDER_DEFAULT_STEP, slider_default as Slider };