@skdx/vue 0.28.0 → 0.29.0

package/dist/radio-group/RadioGroupItem.vue.d.cts

@@ -1,20 +1,16 @@
-/**
- * Radio button in a `SkdxRadioGroup`. Selects on click or sibling focus (arrow
- * navigation); Tab from outside doesn't select. Renders hidden form input if
- * group has a name.
- */
+/** Radio button in a `SkdxRadioGroup` that selects on click or arrow-key focus from a sibling. */
 type __VLS_Props = {
     /** Unique identifier compared against the group's selected value. */
     value: string;
     /** Excludes this item from selection and roving focus. */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    disabled: boolean;
+    disabled: boolean | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/radio-group/RadioGroupItem.vue.d.ts

@@ -1,20 +1,16 @@
-/**
- * Radio button in a `SkdxRadioGroup`. Selects on click or sibling focus (arrow
- * navigation); Tab from outside doesn't select. Renders hidden form input if
- * group has a name.
- */
+/** Radio button in a `SkdxRadioGroup` that selects on click or arrow-key focus from a sibling. */
 type __VLS_Props = {
     /** Unique identifier compared against the group's selected value. */
     value: string;
     /** Excludes this item from selection and roving focus. */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    disabled: boolean;
+    disabled: boolean | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/radio-group/RadioGroupItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const s=require("./context.cjs");let e=require("vue");var p=["aria-checked","data-state","data-disabled","data-value","disabled","tabindex"],m=["name","value","form","checked","required","disabled"],f=(0,e.defineComponent)({inheritAttrs:!1,__name:"RadioGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(d){const l=d,a=(0,e.inject)(s.RADIO_GROUP_CONTEXT);if(!a)throw new Error("<SkdxRadioGroupItem> must be used inside <SkdxRadioGroup>.");const o=(0,e.computed)(()=>a.value.value===l.value),u=(0,e.computed)(()=>a.disabled.value||l.disabled),c=(0,e.computed)(()=>a.firstEnabledValue.value===null?o.value&&!u.value:a.firstEnabledValue.value===l.value);(0,e.provide)(s.RADIO_ITEM_CONTEXT,{checked:o,disabled:u});function n(t){o.value||a.onValueChange(l.value,t)}function v(t){const r=t.relatedTarget,i=t.currentTarget;r?.getAttribute("role")==="radio"&&r.closest('[role="radiogroup"]')===i.closest('[role="radiogroup"]')&&n("keyboard")}return(t,r)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createElementVNode)("button",(0,e.mergeProps)({class:"skdx-radio-group__item","data-part":"item",type:"button",role:"radio","aria-checked":o.value,"data-state":o.value?"checked":"unchecked","data-disabled":u.value?"":void 0,"data-value":d.value,disabled:u.value,tabindex:c.value?0:-1,onClick:r[0]||(r[0]=i=>n("pointer")),onFocus:v,onKeydown:r[1]||(r[1]=(0,e.withKeys)((0,e.withModifiers)(()=>{},["prevent"]),["enter"]))},t.$attrs),[(0,e.renderSlot)(t.$slots,"default")],16,p),(0,e.unref)(a).name.value?((0,e.openBlock)(),(0,e.createElementBlock)("input",{key:0,type:"radio","aria-hidden":"true",tabindex:"-1",name:(0,e.unref)(a).name.value,value:d.value,form:(0,e.unref)(a).form.value,checked:o.value,required:(0,e.unref)(a).required.value,disabled:u.value,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,m)):(0,e.createCommentVNode)("",!0)],64))}});exports.default=f;
+const _=require("../utils/injectRequired.cjs"),k=require("../utils/roving-tab-stop.cjs"),s=require("./context.cjs");let e=require("vue");var h=["aria-checked","aria-disabled","data-state","data-disabled","data-value","disabled","tabindex"],g=["name","value","form","checked","required","disabled"],q=(0,e.defineComponent)({inheritAttrs:!1,__name:"RadioGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(d){const n=d,a=_.injectRequired(s.RADIO_GROUP_CONTEXT,"<SkdxRadioGroupItem> must be used inside <SkdxRadioGroup>."),r=(0,e.computed)(()=>a.value.value===n.value),o=(0,e.computed)(()=>a.disabled.value||n.disabled),c=(0,e.computed)(()=>k.rovingTabIndex(a.firstEnabledValue.value!==null,a.firstEnabledValue.value===n.value,o.value));(0,e.provide)(s.RADIO_ITEM_CONTEXT,{checked:r,disabled:o});let i=!1;function l(t){r.value||a.onValueChange(n.value,t)}function v(t){l(t.detail===0?"keyboard":"pointer")}function p(){i=!0}function f(){i=!1}function b(t){if(r.value)return;if(i){l("pointer");return}const u=t.relatedTarget,m=t.currentTarget;u?.getAttribute("role")==="radio"&&u.closest('[role="radiogroup"]')===m.closest('[role="radiogroup"]')&&l("keyboard")}return(t,u)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createElementVNode)("button",(0,e.mergeProps)({class:"skdx-radio-group__item","data-part":"item",type:"button",role:"radio","aria-checked":r.value,"aria-disabled":o.value||void 0,"data-state":r.value?"checked":"unchecked","data-disabled":o.value?"":void 0,"data-value":d.value,disabled:o.value,tabindex:c.value},t.$attrs,{onClick:v,onPointerdown:p,onBlur:f,onFocus:b,onKeydown:u[0]||(u[0]=(0,e.withKeys)((0,e.withModifiers)(()=>{},["prevent"]),["enter"]))}),[(0,e.renderSlot)(t.$slots,"default")],16,h),(0,e.unref)(a).name.value?((0,e.openBlock)(),(0,e.createElementBlock)("input",{key:0,type:"radio","aria-hidden":"true",tabindex:"-1",name:(0,e.unref)(a).name.value,value:d.value,form:(0,e.unref)(a).form.value,checked:r.value,required:(0,e.unref)(a).required.value,disabled:o.value,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,g)):(0,e.createCommentVNode)("",!0)],64))}});exports.default=q;

package/dist/radio-group/RadioGroupItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{RADIO_GROUP_CONTEXT as e,RADIO_ITEM_CONTEXT as a}from"./context.js";import{Fragment as t,computed as d,createCommentVNode as l,createElementBlock as o,createElementVNode as r,defineComponent as u,inject as i,mergeProps as s,openBlock as n,provide as v,renderSlot as c,unref as p,withKeys as m,withModifiers as b}from"vue";var f=["aria-checked","data-state","data-disabled","data-value","disabled","tabindex"],h=["name","value","form","checked","required","disabled"],k=/* @__PURE__ */u({inheritAttrs:!1,__name:"RadioGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(u){const k=u,g=i(e);if(!g)throw new Error("<SkdxRadioGroupItem> must be used inside <SkdxRadioGroup>.");const x=d(()=>g.value.value===k.value),y=d(()=>g.disabled.value||k.disabled),E=d(()=>null===g.firstEnabledValue.value?x.value&&!y.value:g.firstEnabledValue.value===k.value);function _(e){x.value||g.onValueChange(k.value,e)}function T(e){const a=e.relatedTarget,t=e.currentTarget;"radio"===a?.getAttribute("role")&&a.closest('[role="radiogroup"]')===t.closest('[role="radiogroup"]')&&_("keyboard")}return v(a,{checked:x,disabled:y}),(e,a)=>(n(),o(t,null,[r("button",s({class:"skdx-radio-group__item","data-part":"item",type:"button",role:"radio","aria-checked":x.value,"data-state":x.value?"checked":"unchecked","data-disabled":y.value?"":void 0,"data-value":u.value,disabled:y.value,tabindex:E.value?0:-1,onClick:a[0]||(a[0]=e=>_("pointer")),onFocus:T,onKeydown:a[1]||(a[1]=m(b(()=>{},["prevent"]),["enter"]))},e.$attrs),[c(e.$slots,"default")],16,f),p(g).name.value?(n(),o("input",{key:0,type:"radio","aria-hidden":"true",tabindex:"-1",name:p(g).name.value,value:u.value,form:p(g).form.value,checked:x.value,required:p(g).required.value,disabled:y.value,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,h)):l("",!0)],64))}});export{k as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{rovingTabIndex as a}from"../utils/roving-tab-stop.js";import{RADIO_GROUP_CONTEXT as t,RADIO_ITEM_CONTEXT as o}from"./context.js";import{Fragment as d,computed as r,createCommentVNode as i,createElementBlock as l,createElementVNode as u,defineComponent as n,mergeProps as s,openBlock as v,provide as c,renderSlot as p,unref as m,withKeys as b,withModifiers as f}from"vue";var k=["aria-checked","aria-disabled","data-state","data-disabled","data-value","disabled","tabindex"],h=["name","value","form","checked","required","disabled"],g=/* @__PURE__ */n({inheritAttrs:!1,__name:"RadioGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(n){const g=n,x=e(t,"<SkdxRadioGroupItem> must be used inside <SkdxRadioGroup>."),y=r(()=>x.value.value===g.value),R=r(()=>x.disabled.value||g.disabled),T=r(()=>a(null!==x.firstEnabledValue.value,x.firstEnabledValue.value===g.value,R.value));c(o,{checked:y,disabled:R});let _=!1;function E(e){y.value||x.onValueChange(g.value,e)}function C(e){E(0===e.detail?"keyboard":"pointer")}function I(){_=!0}function j(){_=!1}function q(e){if(y.value)return;if(_)return void E("pointer");const a=e.relatedTarget,t=e.currentTarget;"radio"===a?.getAttribute("role")&&a.closest('[role="radiogroup"]')===t.closest('[role="radiogroup"]')&&E("keyboard")}return(e,a)=>(v(),l(d,null,[u("button",s({class:"skdx-radio-group__item","data-part":"item",type:"button",role:"radio","aria-checked":y.value,"aria-disabled":R.value||void 0,"data-state":y.value?"checked":"unchecked","data-disabled":R.value?"":void 0,"data-value":n.value,disabled:R.value,tabindex:T.value},e.$attrs,{onClick:C,onPointerdown:I,onBlur:j,onFocus:q,onKeydown:a[0]||(a[0]=b(f(()=>{},["prevent"]),["enter"]))}),[p(e.$slots,"default")],16,k),m(x).name.value?(v(),l("input",{key:0,type:"radio","aria-hidden":"true",tabindex:"-1",name:m(x).name.value,value:n.value,form:m(x).form.value,checked:y.value,required:m(x).required.value,disabled:R.value,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,h)):i("",!0)],64))}});export{g as default};

package/dist/radio-group/context.d.cts

@@ -1,15 +1,7 @@
 import type { ComputedRef, InjectionKey } from 'vue';
-/**
- * Why the item changed. Vocabulary from `@skdx/shared`'s change-reason
- * contract; restated because frameworks carry no contracts dependency.
- */
+/** Why the item changed; restated from `@skdx/shared`'s change-reason vocabulary since frameworks carry no contracts dependency. */
 export type RadioGroupChangeReason = 'keyboard' | 'pointer' | 'programmatic';
-/**
- * The payload `value-change` carries. Both ends of change and what drove it.
- * `previousValue` needed in controlled mode (old value is gone on handler run).
- * `reason` disambiguates arrow/click/form-reset. `update:value` keeps bare
- * string for `v-model:value` round-tripping.
- */
+/** The payload `value-change` carries: both ends of the change and what drove it. */
 export interface RadioGroupValueChangeDetail {
     /** The item that is now selected. */
     value: string;

package/dist/radio-group/context.d.ts

@@ -1,15 +1,7 @@
 import type { ComputedRef, InjectionKey } from 'vue';
-/**
- * Why the item changed. Vocabulary from `@skdx/shared`'s change-reason
- * contract; restated because frameworks carry no contracts dependency.
- */
+/** Why the item changed; restated from `@skdx/shared`'s change-reason vocabulary since frameworks carry no contracts dependency. */
 export type RadioGroupChangeReason = 'keyboard' | 'pointer' | 'programmatic';
-/**
- * The payload `value-change` carries. Both ends of change and what drove it.
- * `previousValue` needed in controlled mode (old value is gone on handler run).
- * `reason` disambiguates arrow/click/form-reset. `update:value` keeps bare
- * string for `v-model:value` round-tripping.
- */
+/** The payload `value-change` carries: both ends of the change and what drove it. */
 export interface RadioGroupValueChangeDetail {
     /** The item that is now selected. */
     value: string;

package/dist/radio-group/primitives.d.cts

@@ -1,8 +1,5 @@
 /**
- * Advanced primitives for `SkdxRadioGroup` — the parts the recipe composes.
- * Use when you need a different structure (e.g., radio with markup, card variant).
- * RadioGroup here is the barrel export, derives items from `options` when given
- * no children.
+ * Advanced primitives for `SkdxRadioGroup`, for a different structure than the derived `options` items.
  *
  * @example
  * ```vue

package/dist/radio-group/primitives.d.ts

@@ -1,8 +1,5 @@
 /**
- * Advanced primitives for `SkdxRadioGroup` — the parts the recipe composes.
- * Use when you need a different structure (e.g., radio with markup, card variant).
- * RadioGroup here is the barrel export, derives items from `options` when given
- * no children.
+ * Advanced primitives for `SkdxRadioGroup`, for a different structure than the derived `options` items.
  *
  * @example
  * ```vue

package/dist/rating/Rating.vue.d.cts

@@ -1,66 +1,36 @@
 import { type SkdxRatingValueChangeDetail } from './context.cjs';
-/**
- * Rating control: role="radiogroup" with roving-tabindex (or slider with allowHalf).
- * Hover preview is separate from committed value; name with aria-label.
- * Supports form participation, validation, and controlled/uncontrolled usage.
- */
+/** Rating control: `role="radiogroup"` with roving-tabindex, or `role="slider"` with `allowHalf`. */
 type __VLS_Props = {
     /** Selected value, for controlled usage. Pair with `v-model:value` or `@value-change`. */
-    value?: number;
+    value?: number | undefined;
     /** Initial value, for uncontrolled usage, e.g. no items filled. */
     defaultValue?: number;
-    /** Number of items to render, e.g. stars. */
+    /**
+     * Number of items to render, e.g. stars.
+     * @min 1
+     */
     max?: number;
     /**
-     * Names each `SkdxRatingItem`, applied as that item's `aria-label`.
-     *
-     * An item is a `role="radio"`, which takes its name from its content — and
-     * the content is a star icon, which contributes no text. Without a name the
-     * whole widget announces as five unnamed radios, so this is not decoration:
-     * it is the only thing that tells a screen-reader user which star they are
-     * on. Receives `max` as well as the item's own value because the name has
-     * to say what the score is out of.
-     *
-     * An `aria-label` written on an individual `SkdxRatingItem` wins over this,
-     * for the scale whose points have real names ("Poor", "Excellent").
+     * Names each `SkdxRatingItem` as its `aria-label`, since a star icon contributes no accessible text on its own.
      * @default (value, max) => `${value} of ${max} stars`
      */
     itemLabel?: (value: number, max: number) => string;
     /**
-     * Lets the committed value be cleared back to `0` by picking it again —
-     * clicking the checked item, or pressing Space on it. Off by default,
-     * where re-picking the current value is swallowed and emits nothing. Only
-     * the exact committed value clears: with `allowHalf`, clicking the leading
-     * half of a 3-star item at a value of 2.5 clears, and its trailing half
-     * sets 3.
+     * Lets the committed value be cleared back to `0` by picking it again — clicking the checked item, or pressing Space on it.
      * @default false
      */
     allowClear?: boolean;
-    /**
-     * Allow half-item values (`0.5`, `1`, `1.5`, …). Pointer input picks a half
-     * from the leading half of an item's box (the trailing half under RTL);
-     * keyboard input steps by `0.5` per arrow key, so half values are reachable
-     * without a pointer.
-     *
-     * This changes the widget's ARIA, deliberately: a set of whole-star
-     * `role="radio"` items cannot say "2.5" truthfully, so the root becomes a
-     * `role="slider"` reporting `aria-valuenow`/`aria-valuetext`, takes the
-     * single tab stop, and the items become non-focusable
-     * `role="presentation"` visuals. Give the root an accessible name
-     * (`aria-label`) either way.
-     */
+    /** Allows half-item values (`0.5`, `1`, `1.5`, …); the root becomes a `role="slider"` since whole-star radios can't say "2.5" truthfully. */
     allowHalf?: boolean;
     /** Disables every item, blocking all interaction. */
     disabled?: boolean;
     /** Displays the current value but blocks interaction (still focusable, unlike disabled). */
     readOnly?: boolean;
     /**
-     * Name for native form participation via a hidden input, which submits the
-     * committed value as `String(value)`. A value of `0` — nothing rated —
-     * submits nothing, like an unchecked radio group.
+     * Name for native form participation via a hidden input that submits the committed value as `String(value)`; `0` submits nothing.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Marks the hidden form input required, so an unrated (`0`) rating reports
      * `valueMissing`. Only meaningful with `name`.
@@ -68,12 +38,15 @@ type __VLS_Props = {
      */
     required?: boolean;
     /**
-     * Id of the `<form>` that owns this rating, for a rating rendered outside
-     * it. Set on the hidden input, and used to resolve the form whose `reset`
-     * restores the initial rating.
+     * Id of the `<form>` that owns this rating, for a rating rendered outside it.
      * @default undefined — the rating belongs to its nearest ancestor `<form>`, if any.
      */
-    form?: string;
+    form?: string | undefined;
+    /**
+     * Size rung the skin renders the rating at, reflected as `data-size`.
+     * @default undefined — falls back to a `data-size` attribute.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 };
 type __VLS_Slots = {
     /** Full manual composition — one Item per position. */
@@ -86,31 +59,23 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     checkValidity: () => boolean;
     /** Like `checkValidity()`, but also shows the browser's validation message. */
     reportValidity: () => boolean;
-    /**
-     * Pushes an externally-computed error — a server response, a cross-field rule
-     * — onto the hidden input carrying the rating, exactly like
-     * `HTMLInputElement.setCustomValidity()`: a non-empty message makes it
-     * invalid (`customError`), `''` clears it. Dropped without a `name`, matching
-     * the reads above.
-     */
+    /** Pushes an externally-computed error onto the hidden input, like `HTMLInputElement.setCustomValidity()`; `''` clears it. */
     setCustomValidity: (message: string) => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:value": (value: number) => any;
     "value-change": (detail: SkdxRatingValueChangeDetail) => any;
     "hover-value-change": (value: number | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: number) => any) | undefined;
-    "onValue-change"?: ((detail: SkdxRatingValueChangeDetail) => any) | undefined;
-    "onHover-value-change"?: ((value: number | null) => any) | undefined;
+    "onUpdate:value"?: (value: number) => any;
+    "onValue-change"?: (detail: SkdxRatingValueChangeDetail) => any;
+    "onHover-value-change"?: (value: number | null) => any;
 }>, {
-    form: string;
     disabled: boolean;
-    value: number;
-    readOnly: boolean;
-    required: boolean;
-    name: string;
     defaultValue: number;
     max: number;
+    readOnly: boolean;
+    required: boolean;
+    value: number | undefined;
     allowHalf: boolean;
     itemLabel: (value: number, max: number) => string;
     allowClear: boolean;

package/dist/rating/Rating.vue.d.ts

@@ -1,66 +1,36 @@
 import { type SkdxRatingValueChangeDetail } from './context.js';
-/**
- * Rating control: role="radiogroup" with roving-tabindex (or slider with allowHalf).
- * Hover preview is separate from committed value; name with aria-label.
- * Supports form participation, validation, and controlled/uncontrolled usage.
- */
+/** Rating control: `role="radiogroup"` with roving-tabindex, or `role="slider"` with `allowHalf`. */
 type __VLS_Props = {
     /** Selected value, for controlled usage. Pair with `v-model:value` or `@value-change`. */
-    value?: number;
+    value?: number | undefined;
     /** Initial value, for uncontrolled usage, e.g. no items filled. */
     defaultValue?: number;
-    /** Number of items to render, e.g. stars. */
+    /**
+     * Number of items to render, e.g. stars.
+     * @min 1
+     */
     max?: number;
     /**
-     * Names each `SkdxRatingItem`, applied as that item's `aria-label`.
-     *
-     * An item is a `role="radio"`, which takes its name from its content — and
-     * the content is a star icon, which contributes no text. Without a name the
-     * whole widget announces as five unnamed radios, so this is not decoration:
-     * it is the only thing that tells a screen-reader user which star they are
-     * on. Receives `max` as well as the item's own value because the name has
-     * to say what the score is out of.
-     *
-     * An `aria-label` written on an individual `SkdxRatingItem` wins over this,
-     * for the scale whose points have real names ("Poor", "Excellent").
+     * Names each `SkdxRatingItem` as its `aria-label`, since a star icon contributes no accessible text on its own.
      * @default (value, max) => `${value} of ${max} stars`
      */
     itemLabel?: (value: number, max: number) => string;
     /**
-     * Lets the committed value be cleared back to `0` by picking it again —
-     * clicking the checked item, or pressing Space on it. Off by default,
-     * where re-picking the current value is swallowed and emits nothing. Only
-     * the exact committed value clears: with `allowHalf`, clicking the leading
-     * half of a 3-star item at a value of 2.5 clears, and its trailing half
-     * sets 3.
+     * Lets the committed value be cleared back to `0` by picking it again — clicking the checked item, or pressing Space on it.
      * @default false
      */
     allowClear?: boolean;
-    /**
-     * Allow half-item values (`0.5`, `1`, `1.5`, …). Pointer input picks a half
-     * from the leading half of an item's box (the trailing half under RTL);
-     * keyboard input steps by `0.5` per arrow key, so half values are reachable
-     * without a pointer.
-     *
-     * This changes the widget's ARIA, deliberately: a set of whole-star
-     * `role="radio"` items cannot say "2.5" truthfully, so the root becomes a
-     * `role="slider"` reporting `aria-valuenow`/`aria-valuetext`, takes the
-     * single tab stop, and the items become non-focusable
-     * `role="presentation"` visuals. Give the root an accessible name
-     * (`aria-label`) either way.
-     */
+    /** Allows half-item values (`0.5`, `1`, `1.5`, …); the root becomes a `role="slider"` since whole-star radios can't say "2.5" truthfully. */
     allowHalf?: boolean;
     /** Disables every item, blocking all interaction. */
     disabled?: boolean;
     /** Displays the current value but blocks interaction (still focusable, unlike disabled). */
     readOnly?: boolean;
     /**
-     * Name for native form participation via a hidden input, which submits the
-     * committed value as `String(value)`. A value of `0` — nothing rated —
-     * submits nothing, like an unchecked radio group.
+     * Name for native form participation via a hidden input that submits the committed value as `String(value)`; `0` submits nothing.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Marks the hidden form input required, so an unrated (`0`) rating reports
      * `valueMissing`. Only meaningful with `name`.
@@ -68,12 +38,15 @@ type __VLS_Props = {
      */
     required?: boolean;
     /**
-     * Id of the `<form>` that owns this rating, for a rating rendered outside
-     * it. Set on the hidden input, and used to resolve the form whose `reset`
-     * restores the initial rating.
+     * Id of the `<form>` that owns this rating, for a rating rendered outside it.
      * @default undefined — the rating belongs to its nearest ancestor `<form>`, if any.
      */
-    form?: string;
+    form?: string | undefined;
+    /**
+     * Size rung the skin renders the rating at, reflected as `data-size`.
+     * @default undefined — falls back to a `data-size` attribute.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 };
 type __VLS_Slots = {
     /** Full manual composition — one Item per position. */
@@ -86,31 +59,23 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     checkValidity: () => boolean;
     /** Like `checkValidity()`, but also shows the browser's validation message. */
     reportValidity: () => boolean;
-    /**
-     * Pushes an externally-computed error — a server response, a cross-field rule
-     * — onto the hidden input carrying the rating, exactly like
-     * `HTMLInputElement.setCustomValidity()`: a non-empty message makes it
-     * invalid (`customError`), `''` clears it. Dropped without a `name`, matching
-     * the reads above.
-     */
+    /** Pushes an externally-computed error onto the hidden input, like `HTMLInputElement.setCustomValidity()`; `''` clears it. */
     setCustomValidity: (message: string) => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:value": (value: number) => any;
     "value-change": (detail: SkdxRatingValueChangeDetail) => any;
     "hover-value-change": (value: number | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: number) => any) | undefined;
-    "onValue-change"?: ((detail: SkdxRatingValueChangeDetail) => any) | undefined;
-    "onHover-value-change"?: ((value: number | null) => any) | undefined;
+    "onUpdate:value"?: (value: number) => any;
+    "onValue-change"?: (detail: SkdxRatingValueChangeDetail) => any;
+    "onHover-value-change"?: (value: number | null) => any;
 }>, {
-    form: string;
     disabled: boolean;
-    value: number;
-    readOnly: boolean;
-    required: boolean;
-    name: string;
     defaultValue: number;
     max: number;
+    readOnly: boolean;
+    required: boolean;
+    value: number | undefined;
     allowHalf: boolean;
     itemLabel: (value: number, max: number) => string;
     allowClear: boolean;

package/dist/rating/Rating.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const C=require("../utils/useFormReset.cjs"),g=require("../utils/direction.cjs"),R=require("../utils/clamp.cjs"),B=require("./context.cjs"),H=require("./RatingAnatomy.vue.cjs");let a=require("vue");var E=["aria-disabled","aria-readonly","data-disabled","data-readonly"],O=["name","form","^value","required","disabled"],$=(0,a.defineComponent)({__name:"Rating",props:{value:{default:void 0},defaultValue:{default:0},max:{default:5},itemLabel:{type:Function,default:(r,s)=>`${r} of ${s} stars`},allowClear:{type:Boolean,default:!1},allowHalf:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},name:{default:void 0},required:{type:Boolean,default:!1},form:{default:void 0}},emits:["update:value","value-change","hover-value-change"],setup(r,{expose:s,emit:w}){const l=r,f=w,m=(0,a.ref)(l.defaultValue),i=(0,a.computed)(()=>l.value===void 0?m.value:l.value),c=(0,a.ref)(null),y=(0,a.ref)(null);function v(e,t){if(e===i.value)return;const o=i.value===0?null:i.value;l.value===void 0&&(m.value=e),f("update:value",e),f("value-change",{value:e,previousValue:o,reason:t})}function h(e){c.value!==e&&(c.value=e,f("hover-value-change",e))}(0,a.provide)(B.RATING_CONTEXT,{value:i,max:(0,a.computed)(()=>l.max),itemLabel:(0,a.computed)(()=>l.itemLabel),allowClear:(0,a.computed)(()=>l.allowClear),allowHalf:(0,a.computed)(()=>l.allowHalf),hoverValue:(0,a.computed)(()=>c.value),disabled:(0,a.computed)(()=>l.disabled),readOnly:(0,a.computed)(()=>l.readOnly),onValueChange:v,onHoverValueChange:h});const b=g.useDirection(),x=(0,a.computed)(()=>l.allowHalf?{role:"slider","aria-valuemin":0,"aria-valuemax":l.max,"aria-valuenow":i.value,"aria-valuetext":`${i.value} out of ${l.max}`,"aria-orientation":"horizontal",tabindex:l.disabled?-1:0}:{role:"radiogroup"});function V(e,t){let o=null;e==="ArrowRight"||e==="ArrowUp"?o=i.value+.5:e==="ArrowLeft"||e==="ArrowDown"?o=i.value-.5:e==="Home"?o=0:e==="End"&&(o=l.max),o!==null&&(t.preventDefault(),v(R.clamp(o,0,l.max),"keyboard"))}function q(e){if(l.disabled||l.readOnly)return;const t=g.directionalKey(e.key,e.currentTarget,b());if(l.allowHalf){V(t,e);return}const o=y.value;if(!o)return;const d=Array.from(o.querySelectorAll("[data-skdx-rating-item]")).filter(k=>!k.hasAttribute("disabled"));if(d.length===0)return;const p=d.indexOf(document.activeElement);let n;t==="ArrowRight"||t==="ArrowDown"?n=Math.min(p+1,d.length-1):t==="ArrowLeft"||t==="ArrowUp"?n=Math.max(p-1,0):t==="Home"?n=0:t==="End"&&(n=d.length-1),n!==void 0&&(e.preventDefault(),d[n]?.focus())}const u=(0,a.ref)(null),A=l.value??l.defaultValue;return C.useFormReset(()=>u.value,()=>v(A,"programmatic")),s({checkValidity:()=>u.value?.checkValidity()??!0,reportValidity:()=>u.value?.reportValidity()??!0,setCustomValidity:e=>u.value?.setCustomValidity(e)}),(e,t)=>((0,a.openBlock)(),(0,a.createElementBlock)("div",(0,a.mergeProps)({class:"skdx-rating","data-part":"root","data-skdx-component":"rating",ref_key:"rootRef",ref:y},x.value,{"aria-disabled":r.disabled||void 0,"aria-readonly":r.readOnly||void 0,"data-disabled":r.disabled?"":void 0,"data-readonly":r.readOnly?"":void 0,onKeydown:q,onPointerleave:t[0]||(t[0]=o=>h(null))}),[(0,a.renderSlot)(e.$slots,"default",{},()=>[(0,a.createVNode)(H.default,{max:r.max},(0,a.createSlots)({_:2},[e.$slots.icon?{name:"icon",fn:(0,a.withCtx)(()=>[(0,a.renderSlot)(e.$slots,"icon")]),key:"0"}:void 0]),1032,["max"])]),r.name?((0,a.openBlock)(),(0,a.createElementBlock)("input",{key:0,ref_key:"hiddenEl",ref:u,type:"text","aria-hidden":"true",tabindex:"-1",name:r.name,form:r.form,"^value":i.value>0?String(i.value):"",required:r.required,disabled:r.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,O)):(0,a.createCommentVNode)("",!0)],16,E))}});exports.default=$;
+const A=require("../utils/appearance.cjs"),C=require("../utils/useFormReset.cjs"),g=require("../utils/direction.cjs"),R=require("../utils/roving-tab-stop.cjs"),$=require("../utils/clamp.cjs"),B=require("./context.cjs"),H=require("./RatingAnatomy.vue.cjs");let a=require("vue");var O=["aria-disabled","aria-readonly","data-disabled","data-readonly"],D=["name","form","^value","required","disabled"],E=(0,a.defineComponent)({inheritAttrs:!1,__name:"Rating",props:{value:{default:void 0},defaultValue:{default:0},max:{default:5},itemLabel:{type:Function,default:(r,f)=>`${r} of ${f} stars`},allowClear:{type:Boolean,default:!1},allowHalf:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},name:{},required:{type:Boolean,default:!1},form:{},size:{}},emits:["update:value","value-change","hover-value-change"],setup(r,{expose:f,emit:b}){const t=r,c=b,m=(0,a.ref)(t.defaultValue),o=(0,a.computed)(()=>t.value===void 0?m.value:t.value),v=(0,a.ref)(null),y=(0,a.ref)(null);function u(e,l){if(e===o.value)return;const i=o.value===0?null:o.value;t.value===void 0&&(m.value=e),c("update:value",e),c("value-change",{value:e,previousValue:i,reason:l})}function p(e){v.value!==e&&(v.value=e,c("hover-value-change",e))}(0,a.provide)(B.RATING_CONTEXT,{value:o,max:(0,a.computed)(()=>t.max),itemLabel:(0,a.computed)(()=>t.itemLabel),allowClear:(0,a.computed)(()=>t.allowClear),allowHalf:(0,a.computed)(()=>t.allowHalf),hoverValue:(0,a.computed)(()=>v.value),disabled:(0,a.computed)(()=>t.disabled),readOnly:(0,a.computed)(()=>t.readOnly),onValueChange:u,onHoverValueChange:p});const w=g.useDirection(),x=(0,a.computed)(()=>t.allowHalf?{role:"slider","aria-valuemin":0,"aria-valuemax":t.max,"aria-valuenow":o.value,"aria-valuetext":`${o.value} out of ${t.max}`,"aria-orientation":"horizontal",tabindex:t.disabled?-1:0}:{role:"radiogroup"});function q(e,l){let i=null;e==="ArrowRight"||e==="ArrowUp"?i=o.value+.5:(e==="ArrowLeft"||e==="ArrowDown")&&(i=o.value-.5),i!==null&&(l.preventDefault(),u($.clamp(i,0,t.max),"keyboard"))}function V(e){if(t.disabled||t.readOnly)return;const l=g.directionalKey(e.key,e.currentTarget,w());if(l==="Home"||l==="End"){e.preventDefault(),u(l==="Home"?0:t.max,"keyboard");return}if(t.allowHalf){q(l,e);return}const i=y.value;if(!i)return;const d=R.enabledRovingItems(i,"[data-skdx-rating-item]");if(d.length===0)return;const h=d.indexOf(e.target);let s;l==="ArrowRight"||l==="ArrowDown"?s=Math.min(h+1,d.length-1):(l==="ArrowLeft"||l==="ArrowUp")&&(s=Math.max(h-1,0)),s!==void 0&&(e.preventDefault(),d[s]?.focus())}const n=(0,a.ref)(null),k=t.value??t.defaultValue;return C.useFormReset(()=>n.value,()=>u(k,"programmatic")),f({checkValidity:()=>n.value?.checkValidity()??!0,reportValidity:()=>n.value?.reportValidity()??!0,setCustomValidity:e=>n.value?.setCustomValidity(e)}),(e,l)=>((0,a.openBlock)(),(0,a.createElementBlock)("div",(0,a.mergeProps)({ref_key:"rootRef",ref:y,class:"skdx-rating","data-part":"root","data-skdx-component":"rating"},{...e.$attrs,...x.value,...(0,a.unref)(A.appearanceAttrs)({size:r.size},e.$attrs)},{"aria-disabled":r.disabled||void 0,"aria-readonly":r.readOnly||void 0,"data-disabled":r.disabled?"":void 0,"data-readonly":r.readOnly?"":void 0,onKeydown:V,onPointerleave:l[0]||(l[0]=i=>p(null))}),[(0,a.renderSlot)(e.$slots,"default",{},()=>[(0,a.createVNode)(H.default,{max:r.max},(0,a.createSlots)({_:2},[e.$slots.icon?{name:"icon",fn:(0,a.withCtx)(()=>[(0,a.renderSlot)(e.$slots,"icon")]),key:"0"}:void 0]),1032,["max"])]),r.name?((0,a.openBlock)(),(0,a.createElementBlock)("input",{key:0,ref_key:"hiddenEl",ref:n,type:"text","aria-hidden":"true",tabindex:"-1",name:r.name,form:r.form,"^value":o.value>0?String(o.value):"",required:r.required,disabled:r.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,D)):(0,a.createCommentVNode)("",!0)],16,O))}});exports.default=E;

package/dist/rating/Rating.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{useFormReset as e}from"../utils/useFormReset.js";import{directionalKey as a,useDirection as l}from"../utils/direction.js";import{clamp as t}from"../utils/clamp.js";import{RATING_CONTEXT as o}from"./context.js";import r from"./RatingAnatomy.vue.js";import{computed as i,createCommentVNode as n,createElementBlock as d,createSlots as u,createVNode as s,defineComponent as v,mergeProps as m,openBlock as f,provide as c,ref as p,renderSlot as y,withCtx as h}from"vue";var x=["aria-disabled","aria-readonly","data-disabled","data-readonly"],b=["name","form","^value","required","disabled"],g=/* @__PURE__ */v({__name:"Rating",props:{value:{default:void 0},defaultValue:{default:0},max:{default:5},itemLabel:{type:Function,default:(e,a)=>`${e} of ${a} stars`},allowClear:{type:Boolean,default:!1},allowHalf:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},name:{default:void 0},required:{type:Boolean,default:!1},form:{default:void 0}},emits:["update:value","value-change","hover-value-change"],setup(v,{expose:g,emit:w}){const V=v,k=w,A=p(V.defaultValue),C=i(()=>void 0===V.value?A.value:V.value),H=p(null),O=p(null);function R(e,a){if(e===C.value)return;const l=0===C.value?null:C.value;void 0===V.value&&(A.value=e),k("update:value",e),k("value-change",{value:e,previousValue:l,reason:a})}function B(e){H.value!==e&&(H.value=e,k("hover-value-change",e))}c(o,{value:C,max:i(()=>V.max),itemLabel:i(()=>V.itemLabel),allowClear:i(()=>V.allowClear),allowHalf:i(()=>V.allowHalf),hoverValue:i(()=>H.value),disabled:i(()=>V.disabled),readOnly:i(()=>V.readOnly),onValueChange:R,onHoverValueChange:B});const $=l(),E=i(()=>V.allowHalf?{role:"slider","aria-valuemin":0,"aria-valuemax":V.max,"aria-valuenow":C.value,"aria-valuetext":`${C.value} out of ${V.max}`,"aria-orientation":"horizontal",tabindex:V.disabled?-1:0}:{role:"radiogroup"});function _(e){if(V.disabled||V.readOnly)return;const l=a(e.key,e.currentTarget,$());if(V.allowHalf)return void function(e,a){let l=null;"ArrowRight"===e||"ArrowUp"===e?l=C.value+.5:"ArrowLeft"===e||"ArrowDown"===e?l=C.value-.5:"Home"===e?l=0:"End"===e&&(l=V.max),null!==l&&(a.preventDefault(),R(t(l,0,V.max),"keyboard"))}(l,e);const o=O.value;if(!o)return;const r=Array.from(o.querySelectorAll("[data-skdx-rating-item]")).filter(e=>!e.hasAttribute("disabled"));if(0===r.length)return;const i=r.indexOf(document.activeElement);let n;"ArrowRight"===l||"ArrowDown"===l?n=Math.min(i+1,r.length-1):"ArrowLeft"===l||"ArrowUp"===l?n=Math.max(i-1,0):"Home"===l?n=0:"End"===l&&(n=r.length-1),void 0!==n&&(e.preventDefault(),r[n]?.focus())}const j=p(null),q=V.value??V.defaultValue;return e(()=>j.value,()=>R(q,"programmatic")),g({checkValidity:()=>j.value?.checkValidity()??!0,reportValidity:()=>j.value?.reportValidity()??!0,setCustomValidity:e=>j.value?.setCustomValidity(e)}),(e,a)=>(f(),d("div",m({class:"skdx-rating","data-part":"root","data-skdx-component":"rating",ref_key:"rootRef",ref:O},E.value,{"aria-disabled":v.disabled||void 0,"aria-readonly":v.readOnly||void 0,"data-disabled":v.disabled?"":void 0,"data-readonly":v.readOnly?"":void 0,onKeydown:_,onPointerleave:a[0]||(a[0]=e=>B(null))}),[y(e.$slots,"default",{},()=>[s(r,{max:v.max},u({_:2},[e.$slots.icon?{name:"icon",fn:h(()=>[y(e.$slots,"icon")]),key:"0"}:void 0]),1032,["max"])]),v.name?(f(),d("input",{key:0,ref_key:"hiddenEl",ref:j,type:"text","aria-hidden":"true",tabindex:"-1",name:v.name,form:v.form,"^value":C.value>0?String(C.value):"",required:v.required,disabled:v.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,b)):n("",!0)],16,x))}});export{g as default};
+import{appearanceAttrs as e}from"../utils/appearance.js";import{useFormReset as a}from"../utils/useFormReset.js";import{directionalKey as l,useDirection as t}from"../utils/direction.js";import{enabledRovingItems as o}from"../utils/roving-tab-stop.js";import{clamp as r}from"../utils/clamp.js";import{RATING_CONTEXT as i}from"./context.js";import n from"./RatingAnatomy.vue.js";import{computed as u,createCommentVNode as d,createElementBlock as s,createSlots as m,createVNode as v,defineComponent as f,mergeProps as p,openBlock as c,provide as y,ref as x,renderSlot as g,unref as h,withCtx as b}from"vue";var w=["aria-disabled","aria-readonly","data-disabled","data-readonly"],V=["name","form","^value","required","disabled"],k=/* @__PURE__ */f({inheritAttrs:!1,__name:"Rating",props:{value:{default:void 0},defaultValue:{default:0},max:{default:5},itemLabel:{type:Function,default:(e,a)=>`${e} of ${a} stars`},allowClear:{type:Boolean,default:!1},allowHalf:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},name:{},required:{type:Boolean,default:!1},form:{},size:{}},emits:["update:value","value-change","hover-value-change"],setup(f,{expose:k,emit:A}){const C=f,R=A,$=x(C.defaultValue),H=u(()=>void 0===C.value?$.value:C.value),O=x(null),j=x(null);function B(e,a){if(e===H.value)return;const l=0===H.value?null:H.value;void 0===C.value&&($.value=e),R("update:value",e),R("value-change",{value:e,previousValue:l,reason:a})}function D(e){O.value!==e&&(O.value=e,R("hover-value-change",e))}y(i,{value:H,max:u(()=>C.max),itemLabel:u(()=>C.itemLabel),allowClear:u(()=>C.allowClear),allowHalf:u(()=>C.allowHalf),hoverValue:u(()=>O.value),disabled:u(()=>C.disabled),readOnly:u(()=>C.readOnly),onValueChange:B,onHoverValueChange:D});const _=t(),L=u(()=>C.allowHalf?{role:"slider","aria-valuemin":0,"aria-valuemax":C.max,"aria-valuenow":H.value,"aria-valuetext":`${H.value} out of ${C.max}`,"aria-orientation":"horizontal",tabindex:C.disabled?-1:0}:{role:"radiogroup"});function q(e){if(C.disabled||C.readOnly)return;const a=l(e.key,e.currentTarget,_());if("Home"===a||"End"===a)return e.preventDefault(),void B("Home"===a?0:C.max,"keyboard");if(C.allowHalf)return void function(e,a){let l=null;"ArrowRight"===e||"ArrowUp"===e?l=H.value+.5:("ArrowLeft"===e||"ArrowDown"===e)&&(l=H.value-.5),null!==l&&(a.preventDefault(),B(r(l,0,C.max),"keyboard"))}(a,e);const t=j.value;if(!t)return;const i=o(t,"[data-skdx-rating-item]");if(0===i.length)return;const n=i.indexOf(e.target);let u;"ArrowRight"===a||"ArrowDown"===a?u=Math.min(n+1,i.length-1):("ArrowLeft"===a||"ArrowUp"===a)&&(u=Math.max(n-1,0)),void 0!==u&&(e.preventDefault(),i[u]?.focus())}const z=x(null),E=C.value??C.defaultValue;return a(()=>z.value,()=>B(E,"programmatic")),k({checkValidity:()=>z.value?.checkValidity()??!0,reportValidity:()=>z.value?.reportValidity()??!0,setCustomValidity:e=>z.value?.setCustomValidity(e)}),(a,l)=>(c(),s("div",p({ref_key:"rootRef",ref:j,class:"skdx-rating","data-part":"root","data-skdx-component":"rating"},{...a.$attrs,...L.value,...h(e)({size:f.size},a.$attrs)},{"aria-disabled":f.disabled||void 0,"aria-readonly":f.readOnly||void 0,"data-disabled":f.disabled?"":void 0,"data-readonly":f.readOnly?"":void 0,onKeydown:q,onPointerleave:l[0]||(l[0]=e=>D(null))}),[g(a.$slots,"default",{},()=>[v(n,{max:f.max},m({_:2},[a.$slots.icon?{name:"icon",fn:b(()=>[g(a.$slots,"icon")]),key:"0"}:void 0]),1032,["max"])]),f.name?(c(),s("input",{key:0,ref_key:"hiddenEl",ref:z,type:"text","aria-hidden":"true",tabindex:"-1",name:f.name,form:f.form,"^value":H.value>0?String(H.value):"",required:f.required,disabled:f.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,V)):d("",!0)],16,w))}});export{k as default};

package/dist/rating/RatingAnatomy.vue.d.cts

@@ -1,17 +1,12 @@
-/**
- * The anatomy `SkdxRating` draws when its default slot is empty: `max` Items,
- * each with `icon` slot content or default star. Inlined SVG, not `@skdx/icons`,
- * since framework packages can't depend on icons. React `RatingAnatomy.tsx` must stay synchronized.
- * @internal
- */
+/** @internal Draws `max` Items, each with icon slot content or a default star. */
 type __VLS_Props = {
-    max?: number;
+    max?: number | undefined;
 };
 type __VLS_Slots = {
     icon?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    max: number;
+    max: number | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/rating/RatingAnatomy.vue.d.ts

@@ -1,17 +1,12 @@
-/**
- * The anatomy `SkdxRating` draws when its default slot is empty: `max` Items,
- * each with `icon` slot content or default star. Inlined SVG, not `@skdx/icons`,
- * since framework packages can't depend on icons. React `RatingAnatomy.tsx` must stay synchronized.
- * @internal
- */
+/** @internal Draws `max` Items, each with icon slot content or a default star. */
 type __VLS_Props = {
-    max?: number;
+    max?: number | undefined;
 };
 type __VLS_Slots = {
     icon?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    max: number;
+    max: number | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/rating/RatingAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const n=require("./RatingItem.vue.cjs");let e=require("vue");var u=(0,e.defineComponent)({__name:"RatingAnatomy",props:{max:{default:5}},setup(a){return(l,t)=>((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(a.max,r=>((0,e.openBlock)(),(0,e.createBlock)(n.default,{key:r,value:r},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(l.$slots,"icon",{},()=>[t[0]||(t[0]=(0,e.createElementVNode)("svg",{viewBox:"0 0 20 20",width:"1em",height:"1em",fill:"currentColor","aria-hidden":"true",focusable:"false"},[(0,e.createElementVNode)("path",{d:"M10 1.5l2.6 5.6 6.1.7-4.5 4.2 1.2 6-5.4-3-5.4 3 1.2-6-4.5-4.2 6.1-.7z"})],-1))])]),_:3},8,["value"]))),128))}});exports.default=u;
+const u=require("../utils/Glyph.vue.cjs"),n=require("./RatingItem.vue.cjs");let e=require("vue");var l=(0,e.defineComponent)({__name:"RatingAnatomy",props:{max:{default:5}},setup(r){return(a,o)=>((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(r.max,t=>((0,e.openBlock)(),(0,e.createBlock)(n.default,{key:t,value:t},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"icon",{},()=>[(0,e.createVNode)(u.default,{name:"star"})])]),_:3},8,["value"]))),128))}});exports.default=l;

package/dist/rating/RatingAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import e from"./RatingItem.vue.js";import{Fragment as a,createBlock as t,createElementBlock as o,createElementVNode as l,defineComponent as r,openBlock as s,renderList as n,renderSlot as m,withCtx as i}from"vue";var u=/* @__PURE__ */r({__name:"RatingAnatomy",props:{max:{default:5}},setup:r=>(u,d)=>(s(!0),o(a,null,n(r.max,a=>(s(),t(e,{key:a,value:a},{default:i(()=>[m(u.$slots,"icon",{},()=>[d[0]||(d[0]=l("svg",{viewBox:"0 0 20 20",width:"1em",height:"1em",fill:"currentColor","aria-hidden":"true",focusable:"false"},[l("path",{d:"M10 1.5l2.6 5.6 6.1.7-4.5 4.2 1.2 6-5.4-3-5.4 3 1.2-6-4.5-4.2 6.1-.7z"})],-1))])]),_:3},8,["value"]))),128))});export{u as default};
+import e from"../utils/Glyph.vue.js";import a from"./RatingItem.vue.js";import{Fragment as t,createBlock as o,createElementBlock as s,createVNode as r,defineComponent as l,openBlock as m,renderList as n,renderSlot as u,withCtx as i}from"vue";var p=/* @__PURE__ */l({__name:"RatingAnatomy",props:{max:{default:5}},setup:l=>(p,c)=>(m(!0),s(t,null,n(l.max,t=>(m(),o(a,{key:t,value:t},{default:i(()=>[u(p.$slots,"icon",{},()=>[r(e,{name:"star"})])]),_:3},8,["value"]))),128))});export{p as default};

package/dist/rating/RatingItem.vue.d.cts

@@ -1,7 +1,4 @@
-/**
- * Rating item (e.g. one star): role=radio with data-highlighted. Selects on
- * click/focus; hovering previews value. With allowHalf: visual only (role=slider).
- */
+/** Rating item (e.g. one star) that selects on click or focus, with hover previewing the value. */
 type __VLS_Props = {
     /** This item's 1-indexed position within the rating scale. */
     value: number;

package/dist/rating/RatingItem.vue.d.ts

@@ -1,7 +1,4 @@
-/**
- * Rating item (e.g. one star): role=radio with data-highlighted. Selects on
- * click/focus; hovering previews value. With allowHalf: visual only (role=slider).
- */
+/** Rating item (e.g. one star) that selects on click or focus, with hover previewing the value. */
 type __VLS_Props = {
     /** This item's 1-indexed position within the rating scale. */
     value: number;

package/dist/rating/RatingItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const C=require("../utils/direction.cjs"),x=require("./context.cjs");let e=require("vue");var R=["data-state","data-highlighted","data-half","data-disabled"],B=["data-state","data-highlighted","data-half","data-disabled","disabled"],V=(0,e.defineComponent)({__name:"RatingItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(b){const l=b,a=(0,e.inject)(x.RATING_CONTEXT);if(!a)throw new Error("<SkdxRatingItem> must be used inside <SkdxRating>.");const n=(0,e.computed)(()=>a.allowHalf.value),i=(0,e.computed)(()=>a.value.value===l.value||n.value&&a.value.value===l.value-.5),o=(0,e.computed)(()=>a.disabled.value||l.disabled),s=(0,e.computed)(()=>a.hoverValue.value??a.value.value),c=(0,e.computed)(()=>s.value>=(n.value?l.value-.5:l.value)),h=(0,e.computed)(()=>n.value&&s.value===l.value-.5),y=(0,e.computed)(()=>i.value||a.value.value===0&&l.value===1);let d=!1;const f=(0,e.computed)(()=>n.value?{role:"presentation"}:{role:"radio","aria-checked":i.value,"aria-label":a.itemLabel.value(l.value,a.max.value),tabindex:y.value?0:-1});function p(t,u){if(!(o.value||a.readOnly.value)){if(a.allowClear.value&&t===a.value.value){a.onValueChange(0,u);return}a.onValueChange(t,u)}}function r(t){if(!n.value)return l.value;const u=t.currentTarget,v=u.getBoundingClientRect();if(!v.width)return l.value;const _=(t.clientX-v.left)/v.width;return(C.resolveDirection(u)==="rtl"?1-_:_)<=.5?l.value-.5:l.value}function m(t){p(r(t),"pointer")}function w(){d=!0}function P(){const t=d?"pointer":"keyboard";d=!1,!n.value&&!i.value&&p(l.value,t)}function g(t){!o.value&&!a.readOnly.value&&a.onHoverValueChange(r(t))}function k(t){!n.value||o.value||a.readOnly.value||a.onHoverValueChange(r(t))}return(t,u)=>n.value?((0,e.openBlock)(),(0,e.createElementBlock)("span",(0,e.mergeProps)({key:0,class:"skdx-rating__item","data-part":"item"},f.value,{"data-skdx-rating-item":"","data-state":i.value?"checked":"unchecked","data-highlighted":c.value?"":void 0,"data-half":h.value?"":void 0,"data-disabled":o.value?"":void 0,onClick:m,onPointerenter:g,onPointermove:k}),[(0,e.renderSlot)(t.$slots,"default")],16,R)):((0,e.openBlock)(),(0,e.createElementBlock)("button",(0,e.mergeProps)({key:1,class:"skdx-rating__item","data-part":"item",type:"button"},f.value,{"data-skdx-rating-item":"","data-state":i.value?"checked":"unchecked","data-highlighted":c.value?"":void 0,"data-half":h.value?"":void 0,"data-disabled":o.value?"":void 0,disabled:o.value,onClick:m,onFocus:P,onPointerdown:w,onPointerenter:g,onPointermove:k,onKeydown:u[0]||(u[0]=(0,e.withKeys)((0,e.withModifiers)(()=>{},["prevent"]),["enter"]))}),[(0,e.renderSlot)(t.$slots,"default")],16,B))}});exports.default=V;
+const w=require("../utils/injectRequired.cjs"),C=require("../utils/direction.cjs"),R=require("./context.cjs");let e=require("vue");var x=["data-state","data-highlighted","data-half","data-disabled"],B=["data-state","data-highlighted","data-half","data-disabled","disabled"],V=(0,e.defineComponent)({__name:"RatingItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(b){const l=b,a=w.injectRequired(R.RATING_CONTEXT,"<SkdxRatingItem> must be used inside <SkdxRating>."),u=(0,e.computed)(()=>a.allowHalf.value),i=(0,e.computed)(()=>a.value.value===l.value||u.value&&a.value.value===l.value-.5),o=(0,e.computed)(()=>a.disabled.value||l.disabled),s=(0,e.computed)(()=>a.hoverValue.value??a.value.value),c=(0,e.computed)(()=>s.value>=(u.value?l.value-.5:l.value)),h=(0,e.computed)(()=>u.value&&s.value===l.value-.5),y=(0,e.computed)(()=>i.value||a.value.value===0&&l.value===1);let d=!1;const p=(0,e.computed)(()=>u.value?{role:"presentation"}:{role:"radio","aria-checked":i.value,"aria-label":a.itemLabel.value(l.value,a.max.value),tabindex:y.value?0:-1});function f(t,n){if(!(o.value||a.readOnly.value)){if(a.allowClear.value&&t===a.value.value){a.onValueChange(0,n);return}a.onValueChange(t,n)}}function r(t){if(!u.value)return l.value;const n=t.currentTarget,v=n.getBoundingClientRect();if(!v.width)return l.value;const _=(t.clientX-v.left)/v.width;return(C.resolveDirection(n)==="rtl"?1-_:_)<=.5?l.value-.5:l.value}function m(t){f(r(t),"pointer")}function P(){d=!0}function q(){const t=d?"pointer":"keyboard";d=!1,!u.value&&!i.value&&f(l.value,t)}function g(t){!o.value&&!a.readOnly.value&&a.onHoverValueChange(r(t))}function k(t){!u.value||o.value||a.readOnly.value||a.onHoverValueChange(r(t))}return(t,n)=>u.value?((0,e.openBlock)(),(0,e.createElementBlock)("span",(0,e.mergeProps)({key:0,class:"skdx-rating__item","data-part":"item"},p.value,{"data-skdx-rating-item":"","data-state":i.value?"checked":"unchecked","data-highlighted":c.value?"":void 0,"data-half":h.value?"":void 0,"data-disabled":o.value?"":void 0,onClick:m,onPointerenter:g,onPointermove:k}),[(0,e.renderSlot)(t.$slots,"default")],16,x)):((0,e.openBlock)(),(0,e.createElementBlock)("button",(0,e.mergeProps)({key:1,class:"skdx-rating__item","data-part":"item",type:"button"},p.value,{"data-skdx-rating-item":"","data-state":i.value?"checked":"unchecked","data-highlighted":c.value?"":void 0,"data-half":h.value?"":void 0,"data-disabled":o.value?"":void 0,disabled:o.value,onClick:m,onFocus:q,onPointerdown:P,onPointerenter:g,onPointermove:k,onKeydown:n[0]||(n[0]=(0,e.withKeys)((0,e.withModifiers)(()=>{},["prevent"]),["enter"]))}),[(0,e.renderSlot)(t.$slots,"default")],16,B))}});exports.default=V;

package/dist/rating/RatingItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{resolveDirection as e}from"../utils/direction.js";import{RATING_CONTEXT as a}from"./context.js";import{computed as t,createElementBlock as l,defineComponent as u,inject as n,mergeProps as i,openBlock as o,renderSlot as d,withKeys as v,withModifiers as r}from"vue";var s=["data-state","data-highlighted","data-half","data-disabled"],c=["data-state","data-highlighted","data-half","data-disabled","disabled"],h=/* @__PURE__ */u({__name:"RatingItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(u){const h=u,f=n(a);if(!f)throw new Error("<SkdxRatingItem> must be used inside <SkdxRating>.");const m=t(()=>f.allowHalf.value),g=t(()=>f.value.value===h.value||m.value&&f.value.value===h.value-.5),p=t(()=>f.disabled.value||h.disabled),k=t(()=>f.hoverValue.value??f.value.value),b=t(()=>k.value>=(m.value?h.value-.5:h.value)),w=t(()=>m.value&&k.value===h.value-.5),x=t(()=>g.value||0===f.value.value&&1===h.value);let y=!1;const C=t(()=>m.value?{role:"presentation"}:{role:"radio","aria-checked":g.value,"aria-label":f.itemLabel.value(h.value,f.max.value),tabindex:x.value?0:-1});function _(e,a){if(!p.value&&!f.readOnly.value){if(f.allowClear.value&&e===f.value.value)return void f.onValueChange(0,a);f.onValueChange(e,a)}}function P(a){if(!m.value)return h.value;const t=a.currentTarget,l=t.getBoundingClientRect();if(!l.width)return h.value;const u=(a.clientX-l.left)/l.width;return("rtl"===e(t)?1-u:u)<=.5?h.value-.5:h.value}function R(e){_(P(e),"pointer")}function V(){y=!0}function B(){const e=y?"pointer":"keyboard";y=!1,!m.value&&!g.value&&_(h.value,e)}function O(e){!p.value&&!f.readOnly.value&&f.onHoverValueChange(P(e))}function T(e){!m.value||p.value||f.readOnly.value||f.onHoverValueChange(P(e))}return(e,a)=>m.value?(o(),l("span",i({key:0,class:"skdx-rating__item","data-part":"item"},C.value,{"data-skdx-rating-item":"","data-state":g.value?"checked":"unchecked","data-highlighted":b.value?"":void 0,"data-half":w.value?"":void 0,"data-disabled":p.value?"":void 0,onClick:R,onPointerenter:O,onPointermove:T}),[d(e.$slots,"default")],16,s)):(o(),l("button",i({key:1,class:"skdx-rating__item","data-part":"item",type:"button"},C.value,{"data-skdx-rating-item":"","data-state":g.value?"checked":"unchecked","data-highlighted":b.value?"":void 0,"data-half":w.value?"":void 0,"data-disabled":p.value?"":void 0,disabled:p.value,onClick:R,onFocus:B,onPointerdown:V,onPointerenter:O,onPointermove:T,onKeydown:a[0]||(a[0]=v(r(()=>{},["prevent"]),["enter"]))}),[d(e.$slots,"default")],16,c))}});export{h as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{resolveDirection as a}from"../utils/direction.js";import{RATING_CONTEXT as t}from"./context.js";import{computed as l,createElementBlock as u,defineComponent as n,mergeProps as i,openBlock as d,renderSlot as o,withKeys as v,withModifiers as r}from"vue";var s=["data-state","data-highlighted","data-half","data-disabled"],c=["data-state","data-highlighted","data-half","data-disabled","disabled"],h=/* @__PURE__ */n({__name:"RatingItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(n){const h=n,f=e(t,"<SkdxRatingItem> must be used inside <SkdxRating>."),m=l(()=>f.allowHalf.value),g=l(()=>f.value.value===h.value||m.value&&f.value.value===h.value-.5),p=l(()=>f.disabled.value||h.disabled),k=l(()=>f.hoverValue.value??f.value.value),b=l(()=>k.value>=(m.value?h.value-.5:h.value)),x=l(()=>m.value&&k.value===h.value-.5),y=l(()=>g.value||0===f.value.value&&1===h.value);let C=!1;const w=l(()=>m.value?{role:"presentation"}:{role:"radio","aria-checked":g.value,"aria-label":f.itemLabel.value(h.value,f.max.value),tabindex:y.value?0:-1});function R(e,a){if(!p.value&&!f.readOnly.value){if(f.allowClear.value&&e===f.value.value)return void f.onValueChange(0,a);f.onValueChange(e,a)}}function _(e){if(!m.value)return h.value;const t=e.currentTarget,l=t.getBoundingClientRect();if(!l.width)return h.value;const u=(e.clientX-l.left)/l.width;return("rtl"===a(t)?1-u:u)<=.5?h.value-.5:h.value}function P(e){R(_(e),"pointer")}function j(){C=!0}function V(){const e=C?"pointer":"keyboard";C=!1,!m.value&&!g.value&&R(h.value,e)}function B(e){!p.value&&!f.readOnly.value&&f.onHoverValueChange(_(e))}function O(e){!m.value||p.value||f.readOnly.value||f.onHoverValueChange(_(e))}return(e,a)=>m.value?(d(),u("span",i({key:0,class:"skdx-rating__item","data-part":"item"},w.value,{"data-skdx-rating-item":"","data-state":g.value?"checked":"unchecked","data-highlighted":b.value?"":void 0,"data-half":x.value?"":void 0,"data-disabled":p.value?"":void 0,onClick:P,onPointerenter:B,onPointermove:O}),[o(e.$slots,"default")],16,s)):(d(),u("button",i({key:1,class:"skdx-rating__item","data-part":"item",type:"button"},w.value,{"data-skdx-rating-item":"","data-state":g.value?"checked":"unchecked","data-highlighted":b.value?"":void 0,"data-half":x.value?"":void 0,"data-disabled":p.value?"":void 0,disabled:p.value,onClick:P,onFocus:V,onPointerdown:j,onPointerenter:B,onPointermove:O,onKeydown:a[0]||(a[0]=v(r(()=>{},["prevent"]),["enter"]))}),[o(e.$slots,"default")],16,c))}});export{h as default};