@soybeanjs/headless 0.15.5 → 0.17.0

package/dist/components/time-range-picker/types.d.ts

@@ -0,0 +1,304 @@
+import { Direction, UiClass } from "../../types/common.js";
+import { FormFieldCommonProps } from "../../types/component.js";
+import { PropsToContext } from "../../types/vue.js";
+import { PrimitiveProps } from "../primitive/types.js";
+import { TimeValue } from "../../date/comparators.js";
+import { DateStep, HourCycle, TimeGranularity, TimeMatcher, TimeRange } from "../../date/types.js";
+import { Formatter } from "../../date/formatter.js";
+import { TimePickerOption } from "../../shared/time-picker.js";
+import { ComputedRef, HTMLAttributes, ShallowRef } from "vue";
+
+//#region src/components/time-range-picker/types.d.ts
+/**
+ * Props for the time range picker root component.
+ */
+interface TimeRangePickerRootProps extends PrimitiveProps, FormFieldCommonProps, /** @vue-ignore */Omit<HTMLAttributes, 'placeholder'> {
+  /**
+   * Default value.
+   */
+  defaultValue?: TimeRange;
+  /**
+   * Default placeholder.
+   */
+  defaultPlaceholder?: TimeValue;
+  /**
+   * Placeholder.
+   */
+  placeholder?: TimeValue;
+  /**
+   * Current model value.
+   */
+  modelValue?: TimeRange;
+  /**
+   * Hour cycle.
+   */
+  hourCycle?: HourCycle;
+  /**
+   * Step.
+   */
+  step?: DateStep;
+  /**
+   * Granularity.
+   */
+  granularity?: TimeGranularity;
+  /**
+   * Whether hide time zone.
+   */
+  hideTimeZone?: boolean;
+  /**
+   * Max value.
+   */
+  maxValue?: TimeValue;
+  /**
+   * Min value.
+   */
+  minValue?: TimeValue;
+  /**
+   * Locale.
+   */
+  locale?: string;
+  /**
+   * Whether the component is disabled.
+   */
+  disabled?: boolean;
+  /**
+   * Whether the component is readonly.
+   */
+  readonly?: boolean;
+  /**
+   * Whether the time is unavailable.
+   */
+  isTimeUnavailable?: TimeMatcher;
+  /**
+   * Id.
+   */
+  id?: string;
+  /**
+   * Reading direction of the component.
+   */
+  dir?: Direction;
+  /**
+   * Whether the component is open by default.
+   */
+  defaultOpen?: boolean;
+  /**
+   * Whether the component is open.
+   */
+  open?: boolean;
+  /**
+   * Whether the popup is modal.
+   */
+  modal?: boolean;
+}
+/**
+ * Emits for the time range picker root component.
+ */
+type TimeRangePickerRootEmits = {
+  /**
+   * Emitted when the model value changes.
+   */
+  'update:modelValue': [range: TimeRange];
+  /**
+   * Emitted when the placeholder value changes.
+   */
+  'update:placeholder': [time: TimeValue];
+  /**
+   * Emitted when the start value changes.
+   */
+  'update:startValue': [time: TimeValue | undefined];
+  /**
+   * Emitted when the end value changes.
+   */
+  'update:endValue': [time: TimeValue | undefined];
+  /**
+   * Emitted when the open state changes.
+   */
+  'update:open': [open: boolean];
+};
+/**
+ * Props for the time range picker trigger component.
+ */
+interface TimeRangePickerTriggerProps extends PrimitiveProps, /** @vue-ignore */HTMLAttributes {}
+/**
+ * Props for the time range picker popup component.
+ */
+interface TimeRangePickerPopupProps extends PrimitiveProps, /** @vue-ignore */HTMLAttributes {}
+/**
+ * Context for the time range picker root component.
+ */
+interface TimeRangePickerRootContext extends PropsToContext<TimeRangePickerRootProps, 'disabled' | 'readonly'> {
+  /**
+   * Locale used by the component context.
+   */
+  locale: ComputedRef<string>;
+  /**
+   * Reading direction of the component.
+   */
+  dir: ComputedRef<Direction>;
+  /**
+   * Current model value.
+   */
+  modelValue: ShallowRef<TimeRange>;
+  /**
+   * Placeholder used by the component context.
+   */
+  placeholder: ShallowRef<TimeValue>;
+  /**
+   * Whether the time is unavailable.
+   */
+  isTimeUnavailable?: TimeMatcher;
+  /**
+   * Whether the current value is invalid.
+   */
+  isInvalid: ComputedRef<boolean>;
+  /**
+   * Formatter used by the component context.
+   */
+  formatter: Formatter;
+  /**
+   * Granularity used by the component context.
+   */
+  granularity: ComputedRef<TimeGranularity>;
+  /**
+   * Hour cycle used by the component context.
+   */
+  hourCycle: HourCycle;
+  /**
+   * Whether hide time zone.
+   */
+  hideTimeZone: ComputedRef<boolean>;
+  /**
+   * Whether the component is open.
+   */
+  open: ShallowRef<boolean | undefined>;
+  /**
+   * Popup id used by the component context.
+   */
+  popupId: string;
+  /**
+   * Display value used by the component context.
+   */
+  displayValue: ComputedRef<string>;
+  /**
+   * Focused time used by the component context.
+   */
+  focusedTime: ShallowRef<TimeValue>;
+  /**
+   * Hovered time used by the component context.
+   */
+  hoveredTime: ShallowRef<TimeValue | undefined>;
+  /**
+   * Options used by the component context.
+   */
+  options: ComputedRef<TimePickerOption[]>;
+  /**
+   * Min value used by the component context.
+   */
+  minValue: ComputedRef<TimeValue | undefined>;
+  /**
+   * Max value used by the component context.
+   */
+  maxValue: ComputedRef<TimeValue | undefined>;
+  /**
+   * Callback invoked when the range changes.
+   */
+  onRangeChange: (time: TimeValue) => void;
+  /**
+   * Callback invoked when the placeholder changes.
+   */
+  onPlaceholderChange: (time: TimeValue) => void;
+  /**
+   * Whether the time is disabled.
+   */
+  isTimeDisabled: (time: TimeValue) => boolean;
+  /**
+   * Whether the time is selected.
+   */
+  isTimeSelected: (time: TimeValue) => boolean;
+  /**
+   * Whether the time is highlighted.
+   */
+  isTimeHighlighted: (time: TimeValue) => boolean;
+  /**
+   * Whether a range start.
+   */
+  isRangeStart: (time: TimeValue) => boolean;
+  /**
+   * Whether a range end.
+   */
+  isRangeEnd: (time: TimeValue) => boolean;
+  /**
+   * Set open used by the component context.
+   */
+  setOpen: (value: boolean) => void;
+  /**
+   * Set focused time used by the component context.
+   */
+  setFocusedTime: (time: TimeValue) => void;
+  /**
+   * Set hovered time used by the component context.
+   */
+  setHoveredTime: (time: TimeValue | undefined) => void;
+}
+/**
+ * Available UI slots for the time range picker component.
+ */
+type TimeRangePickerUiSlot = 'root' | 'trigger' | 'popup' | 'list' | 'cellTrigger';
+/**
+ * UI class overrides for the time range picker component.
+ */
+type TimeRangePickerUi = UiClass<TimeRangePickerUiSlot>;
+/**
+ * Props for the time range picker compact component.
+ */
+interface TimeRangePickerCompactProps extends TimeRangePickerRootProps {
+  /**
+   * Props forwarded to the trigger element.
+   */
+  triggerProps?: TimeRangePickerTriggerProps;
+  /**
+   * Props forwarded to the popup element.
+   */
+  popupProps?: TimeRangePickerPopupProps;
+}
+/**
+ * Emits for the time range picker compact component.
+ */
+type TimeRangePickerCompactEmits = TimeRangePickerRootEmits;
+/**
+ * Slots for the time range picker compact component.
+ */
+type TimeRangePickerCompactSlots = {
+  /**
+   * Custom content for the default slot.
+   */
+  default?: (props: {
+    modelValue: TimeRange;
+    placeholder: TimeValue;
+    displayValue: string;
+    open: boolean;
+  }) => any;
+  /**
+   * Custom content for the trigger slot.
+   */
+  trigger?: (props: {
+    displayValue: string;
+    modelValue: TimeRange;
+    open: boolean;
+  }) => any;
+  /**
+   * Custom content for the time slot.
+   */
+  time?: (props: {
+    label: string;
+    time: TimeValue;
+    disabled: boolean;
+    focused: boolean;
+    highlighted: boolean;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+  }) => any;
+};
+//#endregion
+export { TimeRangePickerCompactEmits, TimeRangePickerCompactProps, TimeRangePickerCompactSlots, TimeRangePickerPopupProps, TimeRangePickerRootContext, TimeRangePickerRootEmits, TimeRangePickerRootProps, TimeRangePickerTriggerProps, TimeRangePickerUi, TimeRangePickerUiSlot };

package/dist/components/toast/shared.js

@@ -1 +1 @@
-import{e}from"../../node_modules/.pnpm/@soybeanjs_utils@0.1.0/node_modules/@soybeanjs/utils/dist/index.js";const t={gap:`--gap`,offsetTop:`--offset-top`,offsetRight:`--offset-right`,offsetBottom:`--offset-bottom`,offsetLeft:`--offset-left`,mobileOffsetTop:`--mobile-offset-top`,mobileOffsetRight:`--mobile-offset-right`,mobileOffsetBottom:`--mobile-offset-bottom`,mobileOffsetLeft:`--mobile-offset-left`,frontHeight:`--front-toast-height`},n={index:`--index`,offset:`--offset`,beforeIndex:`--toasts-before`,zIndex:`--z-index`,swipeAmountX:`--swipe-amount-x`,swipeAmountY:`--swipe-amount-y`,swipeDirection:`--swipe-direction`,swipeOut:`--swipe-out`,initialHeight:`--initial-height`},r=`top-right`,i=4e3,a={info:`lucide:info`,success:`lucide:circle-check`,warning:`lucide:circle-alert`,error:`lucide:circle-x`,close:`lucide:x`,loading:`svg-spinners:270-ring`},o=[`top-right`,`top-center`,`top-left`,`bottom-right`,`bottom-center`,`bottom-left`],s={left:`left`,right:`right`,top:`up`,bottom:`down`};function c(e){let[t,n]=e.split(`-`),r=[];return t&&r.push(s[t]),n&&r.push(s[n]),r}const l=n=>{let r={top:t.offsetTop,right:t.offsetRight,bottom:t.offsetBottom,left:t.offsetLeft},i={top:t.mobileOffsetTop,right:t.mobileOffsetRight,bottom:t.mobileOffsetBottom,left:t.mobileOffsetLeft},a={};return e(r).forEach(e=>{let t=(typeof n==`number`?n:n[e])??24;a[r[e]]=`${t}px`,a[i[e]]=`calc(${t}px * 0.67)`}),a},u=e=>{if(!e)return{x:0,y:0};let t=e.style.getPropertyValue(n.swipeAmountX),r=e.style.getPropertyValue(n.swipeAmountY);return{x:Number(t.replace(`px`,``))||0,y:Number(r.replace(`px`,``))||0}},d=(e,t)=>{e&&(e.style.setProperty(n.swipeAmountX,`${t.x}px`),e.style.setProperty(n.swipeAmountY,`${t.y}px`))},f=e=>{e&&d(e,{x:0,y:0})},p=e=>`dismiss`in e&&e.dismiss===!0,m=e=>[`altKey`,`ctrlKey`,`metaKey`,`shiftKey`].includes(e);export{o as ALL_TOAST_POSITIONS,r as DEFAULT_POSITION,a as ICONS,i as TOAST_LIFETIME,c as getDefaultSwipeDirections,u as getSwipeAmount,m as isModifierHotkey,p as isToastDismiss,f as resetSwipeAmount,l as resolveOffset,d as setSwipeAmount,n as toastCssVars,t as toasterCssVars};
+import{e}from"../../node_modules/.pnpm/@soybeanjs_utils@0.1.1/node_modules/@soybeanjs/utils/dist/index.js";const t={gap:`--gap`,offsetTop:`--offset-top`,offsetRight:`--offset-right`,offsetBottom:`--offset-bottom`,offsetLeft:`--offset-left`,mobileOffsetTop:`--mobile-offset-top`,mobileOffsetRight:`--mobile-offset-right`,mobileOffsetBottom:`--mobile-offset-bottom`,mobileOffsetLeft:`--mobile-offset-left`,frontHeight:`--front-toast-height`},n={index:`--index`,offset:`--offset`,beforeIndex:`--toasts-before`,zIndex:`--z-index`,swipeAmountX:`--swipe-amount-x`,swipeAmountY:`--swipe-amount-y`,swipeDirection:`--swipe-direction`,swipeOut:`--swipe-out`,initialHeight:`--initial-height`},r=`top-right`,i=4e3,a={info:`lucide:info`,success:`lucide:circle-check`,warning:`lucide:circle-alert`,error:`lucide:circle-x`,close:`lucide:x`,loading:`svg-spinners:270-ring`},o=[`top-right`,`top-center`,`top-left`,`bottom-right`,`bottom-center`,`bottom-left`],s={left:`left`,right:`right`,top:`up`,bottom:`down`};function c(e){let[t,n]=e.split(`-`),r=[];return t&&r.push(s[t]),n&&r.push(s[n]),r}const l=n=>{let r={top:t.offsetTop,right:t.offsetRight,bottom:t.offsetBottom,left:t.offsetLeft},i={top:t.mobileOffsetTop,right:t.mobileOffsetRight,bottom:t.mobileOffsetBottom,left:t.mobileOffsetLeft},a={};return e(r).forEach(e=>{let t=(typeof n==`number`?n:n[e])??24;a[r[e]]=`${t}px`,a[i[e]]=`calc(${t}px * 0.67)`}),a},u=e=>{if(!e)return{x:0,y:0};let t=e.style.getPropertyValue(n.swipeAmountX),r=e.style.getPropertyValue(n.swipeAmountY);return{x:Number(t.replace(`px`,``))||0,y:Number(r.replace(`px`,``))||0}},d=(e,t)=>{e&&(e.style.setProperty(n.swipeAmountX,`${t.x}px`),e.style.setProperty(n.swipeAmountY,`${t.y}px`))},f=e=>{e&&d(e,{x:0,y:0})},p=e=>`dismiss`in e&&e.dismiss===!0,m=e=>[`altKey`,`ctrlKey`,`metaKey`,`shiftKey`].includes(e);export{o as ALL_TOAST_POSITIONS,r as DEFAULT_POSITION,a as ICONS,i as TOAST_LIFETIME,c as getDefaultSwipeDirections,u as getSwipeAmount,m as isModifierHotkey,p as isToastDismiss,f as resetSwipeAmount,l as resolveOffset,d as setSwipeAmount,n as toastCssVars,t as toasterCssVars};

package/dist/components/toast/toaster.vue.d.ts

@@ -8,10 +8,10 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: _$vue.DefineComponent<ToasterProps, {}, {}, {}, {}, _$vue.ComponentOptionsMixin, _$vue.ComponentOptionsMixin, {}, string, _$vue.PublicProps, Readonly<ToasterProps> & Readonly<{}>, {
   offset: ToastOffset;
+  duration: number;
+  position: ToastPosition;
   hotkey: string[];
   containerAriaLabel: string;
-  position: ToastPosition;
-  duration: number;
   gap: number;
   visibleCounts: number;
 }, {}, {}, {}, string, _$vue.ComponentProvideOptions, false, {}, any>;

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

@@ -3,104 +3,324 @@ import { Direction, Side, SwipeDirection, UiClass } from "../../types/common.js"
 import { ComputedRef, HTMLAttributes, LiHTMLAttributes, OlHTMLAttributes, ShallowRef, VNode } from "vue";
 
 //#region src/components/toast/types.d.ts
+/**
+ * Supported toast values.
+ */
 type ToastType = 'default' | 'success' | 'info' | 'warning' | 'error' | 'loading';
+/**
+ * Supported toast icon values.
+ */
 type ToastIconType = Exclude<ToastType, 'default'> | 'close';
+/**
+ * Type information for the toast position component.
+ */
 type ToastPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center';
+/**
+ * Type information for the toast offset component.
+ */
 type ToastOffset = Partial<Record<Side, number>> | number;
+/**
+ * Type information for the toast promise component.
+ */
 type ToastPromise<Data = any> = Promise<Data> | (() => Promise<Data>);
+/**
+ * Type information for the toast t component.
+ */
 interface ToastT {
+  /**
+   * Id.
+   */
   id: number | string;
+  /**
+   * Toaster id.
+   */
   toasterId?: string;
+  /**
+   * Type.
+   */
   type?: ToastType;
+  /**
+   * Per-slot class overrides for the component.
+   */
   ui?: Partial<ToastUi>;
+  /**
+   * Whether rich color.
+   */
   richColor?: boolean;
+  /**
+   * Whether inverted.
+   */
   inverted?: boolean;
+  /**
+   * Position.
+   */
   position?: ToastPosition;
+  /**
+   * Duration.
+   */
   duration?: number;
+  /**
+   * Whether dismissible.
+   */
   dismissible?: boolean;
+  /**
+   * Title text rendered by the component.
+   */
   title?: VNode | string;
+  /**
+   * Description text rendered by the component.
+   */
   description?: VNode | string;
+  /**
+   * Icon rendered by the component.
+   */
   icon?: IconValue;
+  /**
+   * Content.
+   */
   content?: VNode;
+  /**
+   * Action.
+   */
   action?: VNode | string;
+  /**
+   * Whether the component can cel.
+   */
   cancel?: VNode | string;
+  /**
+   * Callback invoked when the action event fires.
+   */
   onAction?: (event: MouseEvent) => void;
+  /**
+   * Callback invoked when the cancel event fires.
+   */
   onCancel?: (event: MouseEvent) => void;
+  /**
+   * Whether to show a close.
+   */
   showClose?: boolean;
+  /**
+   * Whether delete.
+   */
   delete?: boolean;
+  /**
+   * Custom.
+   */
   custom?: VNode;
+  /**
+   * Promise.
+   */
   promise?: ToastPromise;
+  /**
+   * Callback invoked when the dismiss event fires.
+   */
   onDismiss?: (toast: ToastT) => void;
+  /**
+   * Callback invoked when the auto close event fires.
+   */
   onAutoClose?: (toast: ToastT) => void;
+  /**
+   * Test id.
+   */
   testId?: string;
 }
+/**
+ * Type information for the toast external component.
+ */
 interface ToastExternal extends Omit<ToastT, 'id' | 'type' | 'title' | 'content' | 'custom' | 'promise' | 'delete'> {
+  /**
+   * Id.
+   */
   id?: number | string;
 }
+/**
+ * Type information for the toast create options component.
+ */
 interface ToastCreateOptions extends Omit<ToastT, 'id' | 'delete' | 'title'> {
+  /**
+   * Id.
+   */
   id?: number | string;
+  /**
+   * Message.
+   */
   message?: VNode | string;
 }
+/**
+ * Props for the toaster component.
+ */
 interface ToasterProps extends /** @vue-ignore */OlHTMLAttributes {
+  /**
+   * Id.
+   */
   id?: string;
+  /**
+   * Reading direction of the component.
+   */
   dir?: Direction;
+  /**
+   * Hotkey.
+   */
   hotkey?: string[];
+  /**
+   * Custom aria label.
+   */
   customAriaLabel?: string;
+  /**
+   * Container aria label.
+   */
   containerAriaLabel?: string;
+  /**
+   * Position.
+   */
   position?: ToastPosition;
+  /**
+   * Whether default expanded.
+   */
   defaultExpanded?: boolean;
   /**
    * The duration (in milliseconds) before the toast automatically closes. Set to `0` or `Infinity` to disable auto-dismissal.
-   *
-   * [自动关闭前的持续时间（以毫秒为单位）。设置为 `0` 或 `Infinity` 可禁用自动关闭。]
    */
   duration?: number;
+  /**
+   * Gap.
+   */
   gap?: number;
   /**
-   *  The maximum number of visible toasts per position. [每个位置可见的最大吐司数量。]
+   *  The maximum number of visible toasts per position.
    *
    * @default 3
    */
   offset?: ToastOffset;
+  /**
+   * Visible counts.
+   */
   visibleCounts?: number;
+  /**
+   * Swipe directions.
+   */
   swipeDirections?: SwipeDirection[];
+  /**
+   * Whether to show an icon.
+   */
   showIcon?: boolean;
   /**
-   * Whether to show the close button on the toast. [是否在吐司上显示关闭图标。]
+   * Whether to show the close button on the toast.
    *
    * @default true
    */
   showClose?: boolean;
+  /**
+   * Icons.
+   */
   icons?: Partial<Record<ToastIconType, IconValue>>;
+  /**
+   * Props forwarded to the toast element.
+   */
   toastProps?: LiHTMLAttributes;
+  /**
+   * Props forwarded to the wrapper element.
+   */
   wrapperProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the content element.
+   */
   contentProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the title element.
+   */
   titleProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the description element.
+   */
   descriptionProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the icon component.
+   */
   iconProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the footer element.
+   */
   footerProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the action element.
+   */
   actionProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the cancel element.
+   */
   cancelProps?: HTMLAttributes;
+  /**
+   * Props forwarded to the close element.
+   */
   closeProps?: HTMLAttributes;
 }
+/**
+ * Props for the toast provider component.
+ */
 interface ToastProviderProps extends ToasterProps {}
+/**
+ * Type information for the toast dismiss component.
+ */
 interface ToastDismiss {
+  /**
+   * Id.
+   */
   id: number | string;
+  /**
+   * Whether dismiss.
+   */
   dismiss: boolean;
 }
+/**
+ * Type information for the toast or dismiss component.
+ */
 type ToastOrDismiss = ToastT | ToastDismiss;
+/**
+ * Type information for the toast promise result component.
+ */
 interface ToastPromiseResult extends ToastExternal {
+  /**
+   * Message.
+   */
   message: VNode | string;
 }
+/**
+ * Type information for the toast promise resolver component.
+ */
 type ToastPromiseResolver<Result, Data = any> = Result | ((data: Data) => Result | Promise<Result>);
+/**
+ * Type information for the toast promise data component.
+ */
 type ToastPromiseData<ToastData = any> = Omit<ToastExternal, 'description'> & {
+  /**
+   * Whether the component is loading.
+   */
   loading?: VNode | string;
+  /**
+   * Success.
+   */
   success?: ToastPromiseResolver<ToastPromiseResult | VNode | string, ToastData>;
+  /**
+   * Error.
+   */
   error?: ToastPromiseResolver<ToastPromiseResult | VNode | string>;
+  /**
+   * Description text rendered by the component.
+   */
   description?: ToastPromiseResolver<VNode | string>;
+  /**
+   * Finally.
+   */
   finally?: () => void | Promise<void>;
 };
+/**
+ * Available UI slots for the toast component.
+ */
 type ToastUiSlot = 'toaster' | 'toast' | 'wrapper' | 'content' | 'title' | 'description' | 'icon' | 'footer' | 'action' | 'cancel' | 'close';
+/**
+ * UI class overrides for the toast component.
+ */
 type ToastUi = UiClass<ToastUiSlot>;
 //#endregion
 export { ToastCreateOptions, ToastExternal, ToastIconType, ToastOffset, ToastOrDismiss, ToastPosition, ToastPromise, ToastPromiseData, ToastProviderProps, ToastT, ToastType, ToastUi, ToastUiSlot, ToasterProps };

package/dist/components/toggle/toggle.vue.d.ts

@@ -19,8 +19,8 @@ declare const __VLS_base: _$vue.DefineComponent<ToggleProps, {}, {}, {}, {}, _$v
 }>, {
   type: "button" | "submit" | "reset";
   disabled: boolean;
-  modelValue: boolean;
   as: AsTag | _$vue.Component;
+  modelValue: boolean;
 }, {}, {}, {}, string, _$vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

@@ -2,7 +2,13 @@ import { PrimitiveProps } from "../primitive/types.js";
 import { ButtonHTMLAttributes } from "vue";
 
 //#region src/components/toggle/types.d.ts
+/**
+ * State values for the toggle component.
+ */
 type ToggleState = 'on' | 'off';
+/**
+ * Props for the toggle component.
+ */
 interface ToggleProps extends PrimitiveProps, /** @vue-ignore */Omit<ButtonHTMLAttributes, 'onClick'> {
   /**
    * The pressed state of the toggle when it is initially rendered.
@@ -17,6 +23,9 @@ interface ToggleProps extends PrimitiveProps, /** @vue-ignore */Omit<ButtonHTMLA
    */
   disabled?: boolean;
 }
+/**
+ * Emits for the toggle component.
+ */
 type ToggleEmits = {
   /**
    * Event handler called when the pressed state changes.