@skdx/vue 0.26.0 → 0.28.0

package/dist/checkbox-group/CheckboxGroupItem.vue.d.ts

@@ -1,15 +1,7 @@
 /**
- * One checkbox in an `SkdxCheckboxGroup`. It *is* an `SkdxCheckbox` — the role,
- * `aria-checked`, `data-state`, the Space/Enter handling and the hidden
- * `<input type="checkbox">` all come from there — with `checked` driven by
- * whether its `value` is in the group's value, and `name` taken from the
- * group so every checked item submits under the same key.
- *
- * It also carries the group's `aria-required`, which the `role="group"` root
- * may not: it is not a global ARIA attribute, while `role="checkbox"` does
- * support it. Passed as the bare attribute rather than `SkdxCheckbox`'s
- * `required` prop, so the hidden input stays un-required — "at least one
- * checked" is not "every box checked".
+ * One checkbox in SkdxCheckboxGroup: role/aria-checked/data-state from SkdxCheckbox,
+ * checked driven by value in group's value. Carries group's aria-required (role=checkbox
+ * supports it, role=group doesn't). Delegates checkValidity/reportValidity/setCustomValidity.
  */
 type __VLS_Props = {
     /** Unique identifier added to or removed from the group's value. */
@@ -17,11 +9,26 @@ type __VLS_Props = {
     /** Disables this item alone, and excludes it from select-all. */
     disabled?: boolean;
 };
-declare var __VLS_9: {};
+declare var __VLS_10: {}, __VLS_12: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_9) => any;
+    default?: (props: typeof __VLS_10) => any;
+} & {
+    indicator?: (props: typeof __VLS_12) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /**
+     * Reports if hidden input satisfies constraints (browser's answer, delegated).
+     * true without name (no input rendered).
+     */
+    checkValidity: () => any;
+    /** Like `checkValidity()`, but also shows the browser's validation message. */
+    reportValidity: () => any;
+    /**
+     * Sets externally-computed error on hidden input like HTMLInputElement.setCustomValidity():
+     * non-empty = invalid, '' clears. Dropped without name.
+     */
+    setCustomValidity: (message: string) => any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/checkbox-group/CheckboxGroupItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const i=require("../checkbox/Checkbox.vue.cjs"),s=require("./context.cjs");let e=require("vue");var v=(0,e.defineComponent)({__name:"CheckboxGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(u){const t=u,a=(0,e.inject)(s.CHECKBOX_GROUP_CONTEXT);if(!a)throw new Error("SkdxCheckboxGroupItem must be used within an SkdxCheckboxGroup");const o=(0,e.computed)(()=>a.value.value.includes(t.value)),l=(0,e.computed)(()=>a.disabled.value||t.disabled),r=(0,e.reactive)({value:t.value,disabled:l.value});return(0,e.watchEffect)(()=>{r.value=t.value,r.disabled=l.value}),a.registerItem(r),(0,e.onUnmounted)(()=>a.unregisterItem(r)),(n,d)=>((0,e.openBlock)(),(0,e.createBlock)(i.default,{class:"skdx-checkbox-group__item","data-part":"item",checked:o.value,disabled:l.value,name:(0,e.unref)(a).name.value,value:u.value,"aria-required":(0,e.unref)(a).required.value||void 0,"data-value":u.value,"data-skdx-checkbox-group-item":"",onCheckedChange:d[0]||(d[0]=c=>(0,e.unref)(a).toggleItem(u.value,c===!0))},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(n.$slots,"default")]),_:3},8,["checked","disabled","name","value","aria-required","data-value"]))}});exports.default=v;
+const h=require("../checkbox/Checkbox.vue.cjs"),v=require("./context.cjs");let e=require("vue");var b=(0,e.defineComponent)({__name:"CheckboxGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(r,{expose:m}){const u=r,a=(0,e.inject)(v.CHECKBOX_GROUP_CONTEXT);if(!a)throw new Error("SkdxCheckboxGroupItem must be used within an SkdxCheckboxGroup");const c=(0,e.computed)(()=>a.value.value.includes(u.value)),o=(0,e.computed)(()=>a.disabled.value||u.disabled),n=(0,e.computed)(()=>a.maxReached.value&&!c.value),f=(0,e.useAttrs)(),i=(0,e.computed)(()=>f.id??v.checkboxGroupItemId(a.baseId,u.value)),d=(0,e.reactive)({value:u.value,disabled:o.value,id:i.value});(0,e.watchEffect)(()=>{d.value=u.value,d.disabled=o.value,d.id=i.value}),a.registerItem(d),(0,e.onUnmounted)(()=>a.unregisterItem(d));const l=(0,e.ref)();return m({checkValidity:()=>l.value?.checkValidity()??!0,reportValidity:()=>l.value?.reportValidity()??!0,setCustomValidity:t=>l.value?.setCustomValidity(t)}),(t,s)=>((0,e.openBlock)(),(0,e.createBlock)(h.default,{ref_key:"checkboxRef",ref:l,class:"skdx-checkbox-group__item","data-part":"item",id:i.value,checked:c.value,disabled:o.value,"read-only":(0,e.unref)(a).readOnly.value,name:(0,e.unref)(a).name.value,value:r.value,form:(0,e.unref)(a).form.value,"aria-required":(0,e.unref)(a).required.value||void 0,"aria-disabled":n.value||void 0,"data-value":r.value,"data-max-reached":n.value?"":void 0,"data-skdx-checkbox-group-item":"",onCheckedChange:s[0]||(s[0]=k=>(0,e.unref)(a).toggleItem(r.value,k===!0))},(0,e.createSlots)({_:2},[t.$slots.default?{name:"default",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"default")]),key:"0"}:void 0,t.$slots.indicator?{name:"indicator",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"indicator")]),key:"1"}:void 0]),1032,["id","checked","disabled","read-only","name","value","form","aria-required","aria-disabled","data-value","data-max-reached"]))}});exports.default=b;

package/dist/checkbox-group/CheckboxGroupItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import e from"../checkbox/Checkbox.vue.js";import{CHECKBOX_GROUP_CONTEXT as a}from"./context.js";import{computed as t,createBlock as u,defineComponent as l,inject as o,onUnmounted as d,openBlock as r,reactive as s,renderSlot as i,unref as c,watchEffect as v,withCtx as n}from"vue";var m=/* @__PURE__ */l({__name:"CheckboxGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(l){const m=l,p=o(a);if(!p)throw new Error("SkdxCheckboxGroupItem must be used within an SkdxCheckboxGroup");const k=t(()=>p.value.value.includes(m.value)),b=t(()=>p.disabled.value||m.disabled),h=s({value:m.value,disabled:b.value});return v(()=>{h.value=m.value,h.disabled=b.value}),p.registerItem(h),d(()=>p.unregisterItem(h)),(a,t)=>(r(),u(e,{class:"skdx-checkbox-group__item","data-part":"item",checked:k.value,disabled:b.value,name:c(p).name.value,value:l.value,"aria-required":c(p).required.value||void 0,"data-value":l.value,"data-skdx-checkbox-group-item":"",onCheckedChange:t[0]||(t[0]=e=>c(p).toggleItem(l.value,!0===e))},{default:n(()=>[i(a.$slots,"default")]),_:3},8,["checked","disabled","name","value","aria-required","data-value"]))}});export{m as default};
+import e from"../checkbox/Checkbox.vue.js";import{CHECKBOX_GROUP_CONTEXT as a,checkboxGroupItemId as t}from"./context.js";import{computed as d,createBlock as l,createSlots as o,defineComponent as u,inject as r,onUnmounted as i,openBlock as s,reactive as c,ref as v,renderSlot as n,unref as m,useAttrs as k,watchEffect as f,withCtx as h}from"vue";var p=/* @__PURE__ */u({__name:"CheckboxGroupItem",props:{value:{},disabled:{type:Boolean,default:!1}},setup(u,{expose:p}){const b=u,x=r(a);if(!x)throw new Error("SkdxCheckboxGroupItem must be used within an SkdxCheckboxGroup");const y=d(()=>x.value.value.includes(b.value)),C=d(()=>x.disabled.value||b.disabled),I=d(()=>x.maxReached.value&&!y.value),_=k(),g=d(()=>_.id??t(x.baseId,b.value)),V=c({value:b.value,disabled:C.value,id:g.value});f(()=>{V.value=b.value,V.disabled=C.value,V.id=g.value}),x.registerItem(V),i(()=>x.unregisterItem(V));const w=v();return p({checkValidity:()=>w.value?.checkValidity()??!0,reportValidity:()=>w.value?.reportValidity()??!0,setCustomValidity:e=>w.value?.setCustomValidity(e)}),(a,t)=>(s(),l(e,{ref_key:"checkboxRef",ref:w,class:"skdx-checkbox-group__item","data-part":"item",id:g.value,checked:y.value,disabled:C.value,"read-only":m(x).readOnly.value,name:m(x).name.value,value:u.value,form:m(x).form.value,"aria-required":m(x).required.value||void 0,"aria-disabled":I.value||void 0,"data-value":u.value,"data-max-reached":I.value?"":void 0,"data-skdx-checkbox-group-item":"",onCheckedChange:t[0]||(t[0]=e=>m(x).toggleItem(u.value,!0===e))},o({_:2},[a.$slots.default?{name:"default",fn:h(()=>[n(a.$slots,"default")]),key:"0"}:void 0,a.$slots.indicator?{name:"indicator",fn:h(()=>[n(a.$slots,"indicator")]),key:"1"}:void 0]),1032,["id","checked","disabled","read-only","name","value","form","aria-required","aria-disabled","data-value","data-max-reached"]))}});export{p as default};

package/dist/checkbox-group/CheckboxGroupSelectAll.vue.d.cts

@@ -1,23 +1,33 @@
 /**
- * The tri-state "select all" parent of an `SkdxCheckboxGroup`: checked when
- * every enabled item is checked, `aria-checked="mixed"` when only some are,
- * unchecked when none are. Clicking it checks every enabled item, or clears
- * them when they are already all checked.
- *
- * It lives *inside* the group — it reads the same item registry the items
- * feed, and inside the group is also where a screen reader announces it as
- * part of the set. It carries no `value` and no `name`, so it renders no
- * hidden input and is never submitted.
+ * Tri-state "select all" parent: checked when all enabled items checked, mixed when some,
+ * unchecked when none. Checks/clears all enabled items. aria-controls names every item.
+ * Needs accessible name from content or aria-label. Exposes checkValidity/reportValidity/
+ * setCustomValidity for consistency; no name means always valid.
  */
 type __VLS_Props = {
     /** Disables the parent alone; the group-level `disabled` also disables it. */
     disabled?: boolean;
 };
-declare var __VLS_9: {};
+declare var __VLS_10: {}, __VLS_12: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_9) => any;
+    default?: (props: typeof __VLS_10) => any;
+} & {
+    indicator?: (props: typeof __VLS_12) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /**
+     * Reports whether the underlying checkbox is valid. Always `true` without a
+     * `name`, since nothing is submitted.
+     */
+    checkValidity: () => any;
+    /** Like `checkValidity()`, but also shows the browser's validation message. */
+    reportValidity: () => any;
+    /**
+     * Sets a custom validity message on the underlying checkbox. Without a `name`
+     * this is a no-op, since there is no hidden input to write to.
+     */
+    setCustomValidity: (message: string) => any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/checkbox-group/CheckboxGroupSelectAll.vue.d.ts

@@ -1,23 +1,33 @@
 /**
- * The tri-state "select all" parent of an `SkdxCheckboxGroup`: checked when
- * every enabled item is checked, `aria-checked="mixed"` when only some are,
- * unchecked when none are. Clicking it checks every enabled item, or clears
- * them when they are already all checked.
- *
- * It lives *inside* the group — it reads the same item registry the items
- * feed, and inside the group is also where a screen reader announces it as
- * part of the set. It carries no `value` and no `name`, so it renders no
- * hidden input and is never submitted.
+ * Tri-state "select all" parent: checked when all enabled items checked, mixed when some,
+ * unchecked when none. Checks/clears all enabled items. aria-controls names every item.
+ * Needs accessible name from content or aria-label. Exposes checkValidity/reportValidity/
+ * setCustomValidity for consistency; no name means always valid.
  */
 type __VLS_Props = {
     /** Disables the parent alone; the group-level `disabled` also disables it. */
     disabled?: boolean;
 };
-declare var __VLS_9: {};
+declare var __VLS_10: {}, __VLS_12: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_9) => any;
+    default?: (props: typeof __VLS_10) => any;
+} & {
+    indicator?: (props: typeof __VLS_12) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /**
+     * Reports whether the underlying checkbox is valid. Always `true` without a
+     * `name`, since nothing is submitted.
+     */
+    checkValidity: () => any;
+    /** Like `checkValidity()`, but also shows the browser's validation message. */
+    reportValidity: () => any;
+    /**
+     * Sets a custom validity message on the underlying checkbox. Without a `name`
+     * this is a no-op, since there is no hidden input to write to.
+     */
+    setCustomValidity: (message: string) => any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/checkbox-group/CheckboxGroupSelectAll.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const d=require("../checkbox/Checkbox.vue.cjs"),a=require("./context.cjs");let e=require("vue");var s=(0,e.defineComponent)({__name:"CheckboxGroupSelectAll",props:{disabled:{type:Boolean,default:!1}},setup(r){const o=r,l=(0,e.inject)(a.CHECKBOX_GROUP_CONTEXT);if(!l)throw new Error("SkdxCheckboxGroupSelectAll must be used within an SkdxCheckboxGroup");const u=(0,e.computed)(()=>l.disabled.value||o.disabled);return(c,t)=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{class:"skdx-checkbox-group__select-all","data-part":"select-all",checked:(0,e.unref)(l).selectAllChecked.value,disabled:u.value,onCheckedChange:t[0]||(t[0]=n=>(0,e.unref)(l).toggleAll())},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(c.$slots,"default")]),_:3},8,["checked","disabled"]))}});exports.default=s;
+const s=require("../checkbox/Checkbox.vue.cjs"),c=require("./context.cjs");let e=require("vue");var n=(0,e.defineComponent)({__name:"CheckboxGroupSelectAll",props:{disabled:{type:Boolean,default:!1}},setup(a,{expose:d}){const u=a,t=(0,e.inject)(c.CHECKBOX_GROUP_CONTEXT);if(!t)throw new Error("SkdxCheckboxGroupSelectAll must be used within an SkdxCheckboxGroup");const i=(0,e.computed)(()=>t.disabled.value||u.disabled),o=(0,e.ref)();return d({checkValidity:()=>o.value?.checkValidity()??!0,reportValidity:()=>o.value?.reportValidity()??!0,setCustomValidity:l=>o.value?.setCustomValidity(l)}),(l,r)=>((0,e.openBlock)(),(0,e.createBlock)(s.default,{ref_key:"checkboxRef",ref:o,class:"skdx-checkbox-group__select-all","data-part":"select-all",checked:(0,e.unref)(t).selectAllChecked.value,disabled:i.value,"read-only":(0,e.unref)(t).readOnly.value,"aria-controls":(0,e.unref)(t).itemIds.value||void 0,onCheckedChange:r[0]||(r[0]=k=>(0,e.unref)(t).toggleAll())},(0,e.createSlots)({_:2},[l.$slots.default?{name:"default",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(l.$slots,"default")]),key:"0"}:void 0,l.$slots.indicator?{name:"indicator",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(l.$slots,"indicator")]),key:"1"}:void 0]),1032,["checked","disabled","read-only","aria-controls"]))}});exports.default=n;

package/dist/checkbox-group/CheckboxGroupSelectAll.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import e from"../checkbox/Checkbox.vue.js";import{CHECKBOX_GROUP_CONTEXT as l}from"./context.js";import{computed as o,createBlock as a,defineComponent as t,inject as s,openBlock as c,renderSlot as d,unref as r,withCtx as u}from"vue";var n=/* @__PURE__ */t({__name:"CheckboxGroupSelectAll",props:{disabled:{type:Boolean,default:!1}},setup(t){const n=t,p=s(l);if(!p)throw new Error("SkdxCheckboxGroupSelectAll must be used within an SkdxCheckboxGroup");const k=o(()=>p.disabled.value||n.disabled);return(l,o)=>(c(),a(e,{class:"skdx-checkbox-group__select-all","data-part":"select-all",checked:r(p).selectAllChecked.value,disabled:k.value,onCheckedChange:o[0]||(o[0]=e=>r(p).toggleAll())},{default:u(()=>[d(l.$slots,"default")]),_:3},8,["checked","disabled"]))}});export{n as default};
+import e from"../checkbox/Checkbox.vue.js";import{CHECKBOX_GROUP_CONTEXT as a}from"./context.js";import{computed as t,createBlock as l,createSlots as o,defineComponent as s,inject as d,openBlock as r,ref as c,renderSlot as i,unref as n,withCtx as u}from"vue";var k=/* @__PURE__ */s({__name:"CheckboxGroupSelectAll",props:{disabled:{type:Boolean,default:!1}},setup(s,{expose:k}){const p=s,f=d(a);if(!f)throw new Error("SkdxCheckboxGroupSelectAll must be used within an SkdxCheckboxGroup");const h=t(()=>f.disabled.value||p.disabled),m=c();return k({checkValidity:()=>m.value?.checkValidity()??!0,reportValidity:()=>m.value?.reportValidity()??!0,setCustomValidity:e=>m.value?.setCustomValidity(e)}),(a,t)=>(r(),l(e,{ref_key:"checkboxRef",ref:m,class:"skdx-checkbox-group__select-all","data-part":"select-all",checked:n(f).selectAllChecked.value,disabled:h.value,"read-only":n(f).readOnly.value,"aria-controls":n(f).itemIds.value||void 0,onCheckedChange:t[0]||(t[0]=e=>n(f).toggleAll())},o({_:2},[a.$slots.default?{name:"default",fn:u(()=>[i(a.$slots,"default")]),key:"0"}:void 0,a.$slots.indicator?{name:"indicator",fn:u(()=>[i(a.$slots,"indicator")]),key:"1"}:void 0]),1032,["checked","disabled","read-only","aria-controls"]))}});export{k as default};

package/dist/checkbox-group/context.cjs

@@ -1 +1 @@
-var r=Symbol("skdx-checkbox-group-context");function n(e,c){return e.length>0&&e.every(t=>c.includes(t))?!0:e.some(t=>c.includes(t))?"indeterminate":!1}exports.CHECKBOX_GROUP_CONTEXT=r;exports.getSelectAllChecked=n;
+function r(e,t){return`${e}-${t.replace(/\s+/g,"-")}`}var n=Symbol("skdx-checkbox-group-context");function o(e,t){return e.length>0&&e.every(c=>t.includes(c))?!0:e.some(c=>t.includes(c))?"indeterminate":!1}exports.CHECKBOX_GROUP_CONTEXT=n;exports.checkboxGroupItemId=r;exports.getSelectAllChecked=o;

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

@@ -5,14 +5,33 @@ export type CheckedState = boolean | 'indeterminate';
 export interface CheckboxGroupItemEntry {
     value: string;
     disabled: boolean;
+    /** The item's DOM id — the consumer's own when they set one — for the select-all's `aria-controls`. */
+    id: string;
 }
+/**
+ * Item id for select-all's aria-controls. Derived from group id + value
+ * (parent computes without registration, needed for SSR). Whitespace collapsed
+ * since aria-controls is space-separated.
+ * @internal
+ */
+export declare function checkboxGroupItemId(baseId: string, value: string): string;
 /** @internal Shape a CheckboxGroup provides so its items and select-all parent share state. */
 export interface CheckboxGroupContext {
     name: ComputedRef<string | undefined>;
+    /** The `<form>` id every item's hidden input submits to, for a group rendered outside that form. */
+    form: ComputedRef<string | undefined>;
     value: ComputedRef<string[]>;
     disabled: ComputedRef<boolean>;
+    /** Group-level `readOnly`, carried by each item as `aria-readonly`. */
+    readOnly: ComputedRef<boolean>;
     /** Group-level `required`, carried by each item as `aria-required`. */
     required: ComputedRef<boolean>;
+    /** Whether the `max` cap is reached, so unchecked items announce `aria-disabled` without leaving the tab order. */
+    maxReached: ComputedRef<boolean>;
+    /** The group's generated id, from which an item with no id of its own derives one. */
+    baseId: string;
+    /** Space-separated ids of every item, for the select-all's `aria-controls`. */
+    itemIds: ComputedRef<string>;
     /** Tri-state of the select-all parent, derived from the enabled items. */
     selectAllChecked: ComputedRef<CheckedState>;
     /** Adds or removes one item's value. */
@@ -25,10 +44,8 @@ export interface CheckboxGroupContext {
 /** @internal Injection key a CheckboxGroup provides so its parts share the value, name and select-all state. */
 export declare const CHECKBOX_GROUP_CONTEXT: InjectionKey<CheckboxGroupContext>;
 /**
- * The select-all parent's tri-state, derived from the *enabled* items only:
- * a disabled item can neither be checked nor cleared by the parent, so
- * counting it would leave the parent permanently indeterminate. An empty
- * group reads as unchecked rather than "all of nothing is checked".
+ * Select-all tri-state from enabled items only (disabled can't be cleared by
+ * parent). Empty = unchecked, not indeterminate.
  * @internal
  */
 export declare function getSelectAllChecked(enabledValues: string[], value: string[]): CheckedState;

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

@@ -5,14 +5,33 @@ export type CheckedState = boolean | 'indeterminate';
 export interface CheckboxGroupItemEntry {
     value: string;
     disabled: boolean;
+    /** The item's DOM id — the consumer's own when they set one — for the select-all's `aria-controls`. */
+    id: string;
 }
+/**
+ * Item id for select-all's aria-controls. Derived from group id + value
+ * (parent computes without registration, needed for SSR). Whitespace collapsed
+ * since aria-controls is space-separated.
+ * @internal
+ */
+export declare function checkboxGroupItemId(baseId: string, value: string): string;
 /** @internal Shape a CheckboxGroup provides so its items and select-all parent share state. */
 export interface CheckboxGroupContext {
     name: ComputedRef<string | undefined>;
+    /** The `<form>` id every item's hidden input submits to, for a group rendered outside that form. */
+    form: ComputedRef<string | undefined>;
     value: ComputedRef<string[]>;
     disabled: ComputedRef<boolean>;
+    /** Group-level `readOnly`, carried by each item as `aria-readonly`. */
+    readOnly: ComputedRef<boolean>;
     /** Group-level `required`, carried by each item as `aria-required`. */
     required: ComputedRef<boolean>;
+    /** Whether the `max` cap is reached, so unchecked items announce `aria-disabled` without leaving the tab order. */
+    maxReached: ComputedRef<boolean>;
+    /** The group's generated id, from which an item with no id of its own derives one. */
+    baseId: string;
+    /** Space-separated ids of every item, for the select-all's `aria-controls`. */
+    itemIds: ComputedRef<string>;
     /** Tri-state of the select-all parent, derived from the enabled items. */
     selectAllChecked: ComputedRef<CheckedState>;
     /** Adds or removes one item's value. */
@@ -25,10 +44,8 @@ export interface CheckboxGroupContext {
 /** @internal Injection key a CheckboxGroup provides so its parts share the value, name and select-all state. */
 export declare const CHECKBOX_GROUP_CONTEXT: InjectionKey<CheckboxGroupContext>;
 /**
- * The select-all parent's tri-state, derived from the *enabled* items only:
- * a disabled item can neither be checked nor cleared by the parent, so
- * counting it would leave the parent permanently indeterminate. An empty
- * group reads as unchecked rather than "all of nothing is checked".
+ * Select-all tri-state from enabled items only (disabled can't be cleared by
+ * parent). Empty = unchecked, not indeterminate.
  * @internal
  */
 export declare function getSelectAllChecked(enabledValues: string[], value: string[]): CheckedState;

package/dist/checkbox-group/context.js

@@ -1 +1 @@
-var e=/* @__PURE__ */Symbol("skdx-checkbox-group-context");function t(e,t){return!!(e.length>0&&e.every(e=>t.includes(e)))||!!e.some(e=>t.includes(e))&&"indeterminate"}export{e as CHECKBOX_GROUP_CONTEXT,t as getSelectAllChecked};
+function e(e,t){return`${e}-${t.replace(/\s+/g,"-")}`}var t=/* @__PURE__ */Symbol("skdx-checkbox-group-context");function c(e,t){return!!(e.length>0&&e.every(e=>t.includes(e)))||!!e.some(e=>t.includes(e))&&"indeterminate"}export{t as CHECKBOX_GROUP_CONTEXT,e as checkboxGroupItemId,c as getSelectAllChecked};

package/dist/checkbox-group/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./CheckboxGroup.vue.cjs"),r=require("./CheckboxGroupItem.vue.cjs"),o=require("./CheckboxGroupSelectAll.vue.cjs");exports.SkdxCheckboxGroup=e.default;exports.SkdxCheckboxGroupItem=r.default;exports.SkdxCheckboxGroupSelectAll=o.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./CheckboxGroup.vue.cjs");exports.SkdxCheckboxGroup=e.default;

package/dist/checkbox-group/index.d.cts

@@ -1,3 +1,2 @@
 export { default as SkdxCheckboxGroup } from './CheckboxGroup.vue.cjs';
-export { default as SkdxCheckboxGroupItem } from './CheckboxGroupItem.vue.cjs';
-export { default as SkdxCheckboxGroupSelectAll } from './CheckboxGroupSelectAll.vue.cjs';
+export type { CheckboxGroupOption } from './types.cjs';

package/dist/checkbox-group/index.d.ts

@@ -1,3 +1,2 @@
 export { default as SkdxCheckboxGroup } from './CheckboxGroup.vue.js';
-export { default as SkdxCheckboxGroupItem } from './CheckboxGroupItem.vue.js';
-export { default as SkdxCheckboxGroupSelectAll } from './CheckboxGroupSelectAll.vue.js';
+export type { CheckboxGroupOption } from './types.js';

package/dist/checkbox-group/index.js

@@ -1 +1 @@
-import o from"./CheckboxGroup.vue.js";import e from"./CheckboxGroupItem.vue.js";import r from"./CheckboxGroupSelectAll.vue.js";export{o as SkdxCheckboxGroup,e as SkdxCheckboxGroupItem,r as SkdxCheckboxGroupSelectAll};
+import o from"./CheckboxGroup.vue.js";export{o as SkdxCheckboxGroup};

package/dist/checkbox-group/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./CheckboxGroupItem.vue.cjs"),r=require("./CheckboxGroup.vue.cjs"),o=require("./CheckboxGroupSelectAll.vue.cjs");exports.SkdxCheckboxGroup=r.default;exports.SkdxCheckboxGroupItem=e.default;exports.SkdxCheckboxGroupSelectAll=o.default;

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

@@ -0,0 +1,25 @@
+/**
+ * Advanced primitives for `SkdxCheckboxGroup` — the parts the recipe
+ * composes. Use when the derived anatomy is not the structure you need — a
+ * select-all parent, an item with markup beside its label. `SkdxCheckboxGroupSelectAll`
+ * is here only; the derived anatomy never draws one.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCheckboxGroup, SkdxCheckboxGroupItem, SkdxCheckboxGroupSelectAll } from '@skdx/vue/primitives/checkbox-group';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCheckboxGroup v-model:value="channels">
+ *     <SkdxCheckboxGroupSelectAll>All channels</SkdxCheckboxGroupSelectAll>
+ *     <SkdxCheckboxGroupItem value="email">Email</SkdxCheckboxGroupItem>
+ *     <SkdxCheckboxGroupItem value="sms">SMS</SkdxCheckboxGroupItem>
+ *   </SkdxCheckboxGroup>
+ * </template>
+ * ```
+ */
+export { default as SkdxCheckboxGroup } from './CheckboxGroup.vue.cjs';
+export { default as SkdxCheckboxGroupItem } from './CheckboxGroupItem.vue.cjs';
+export { default as SkdxCheckboxGroupSelectAll } from './CheckboxGroupSelectAll.vue.cjs';
+export type { CheckboxGroupOption } from './types.cjs';

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

@@ -0,0 +1,25 @@
+/**
+ * Advanced primitives for `SkdxCheckboxGroup` — the parts the recipe
+ * composes. Use when the derived anatomy is not the structure you need — a
+ * select-all parent, an item with markup beside its label. `SkdxCheckboxGroupSelectAll`
+ * is here only; the derived anatomy never draws one.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCheckboxGroup, SkdxCheckboxGroupItem, SkdxCheckboxGroupSelectAll } from '@skdx/vue/primitives/checkbox-group';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCheckboxGroup v-model:value="channels">
+ *     <SkdxCheckboxGroupSelectAll>All channels</SkdxCheckboxGroupSelectAll>
+ *     <SkdxCheckboxGroupItem value="email">Email</SkdxCheckboxGroupItem>
+ *     <SkdxCheckboxGroupItem value="sms">SMS</SkdxCheckboxGroupItem>
+ *   </SkdxCheckboxGroup>
+ * </template>
+ * ```
+ */
+export { default as SkdxCheckboxGroup } from './CheckboxGroup.vue.js';
+export { default as SkdxCheckboxGroupItem } from './CheckboxGroupItem.vue.js';
+export { default as SkdxCheckboxGroupSelectAll } from './CheckboxGroupSelectAll.vue.js';
+export type { CheckboxGroupOption } from './types.js';

package/dist/checkbox-group/primitives.js

@@ -0,0 +1 @@
+import o from"./CheckboxGroupItem.vue.js";import e from"./CheckboxGroup.vue.js";import r from"./CheckboxGroupSelectAll.vue.js";export{e as SkdxCheckboxGroup,o as SkdxCheckboxGroupItem,r as SkdxCheckboxGroupSelectAll};

package/dist/checkbox-group/types.d.cts

@@ -0,0 +1,12 @@
+/** One checkbox in a `SkdxCheckboxGroup`'s `options`. */
+export interface CheckboxGroupOption {
+    /** Unique identifier added to or removed from the group's value. */
+    value: string;
+    /** Text rendered beside the derived checkbox, and its accessible name. */
+    label: string;
+    /**
+     * Disables this item alone, and excludes it from select-all.
+     * @default false
+     */
+    disabled?: boolean;
+}

package/dist/checkbox-group/types.d.ts

@@ -0,0 +1,12 @@
+/** One checkbox in a `SkdxCheckboxGroup`'s `options`. */
+export interface CheckboxGroupOption {
+    /** Unique identifier added to or removed from the group's value. */
+    value: string;
+    /** Text rendered beside the derived checkbox, and its accessible name. */
+    label: string;
+    /**
+     * Disables this item alone, and excludes it from select-all.
+     * @default false
+     */
+    disabled?: boolean;
+}

package/dist/clipboard/Clipboard.vue.d.cts

@@ -1,10 +1,18 @@
 /**
  * The Vue implementation of the shared Clipboard contract (see
  * `@skdx/shared`'s `clipboardContract`). Root of a copy-to-clipboard widget:
- * owns the text to copy and the transient `copied` state, and hands both to
+ * owns the text to copy and the transient copy state, and hands both to
  * `SkdxClipboardTrigger`, `SkdxClipboardIndicator` and `SkdxClipboardInput`
  * through provide/inject. Renders a `<div>` with
- * `data-state="copied" | "idle"` and `data-disabled`.
+ * `data-state="copied" | "idle" | "error"` and `data-disabled`.
+ *
+ * A **failed** copy is the mirror image of a successful one: `data-state="error"`
+ * for the same window, `errorLabel` announced *assertively*, and the
+ * `copy-error` emit.
+ *
+ * The copy state belongs to the **root**, so two triggers under one root both
+ * confirm when either is pressed. `copy()` is exposed through `defineExpose`,
+ * so the write is reachable without a trigger.
  *
  * **The confirmation is the component.** Writing to the clipboard is two lines
  * of platform API; what needs owning is the `copied` flag that has to expire,
@@ -21,13 +29,30 @@
  * inside the click handler, never at setup scope, so the component
  * server-renders on a runtime with no `document` at all.
  *
- * @example
+ * The Trigger carries the accessible name and the Indicators are `aria-hidden`
+ * glyphs. Swapping the button's *text* instead — "Copy" to "Copied!" — renames
+ * the control mid-copy, which moves the target the user was about to click
+ * again and re-announces the whole button on focus; see
+ * `<SkdxClipboardTrigger>`.
+ *
+ * Given no default slot content it derives the body from `label` and
+ * `showInput` — an optional Input, and a Trigger named by `label` wrapping an
+ * idle/copied pair of Indicators. Given one, that content is the body and
+ * nothing is derived. Only presence is inspected, never what the slot holds.
+ * The parts are advanced primitives — `@skdx/vue/primitives/clipboard`.
+ *
+ * ```vue
+ * <SkdxClipboard value="npm i @skdx/vue" label="Copy install command" show-input />
+ * ```
+ *
+ * @example Manual composition, for icons the derived Indicators don't provide —
+ * `import * as Clipboard from '@skdx/vue/primitives/clipboard'`:
  * ```vue
  * <SkdxClipboard value="npm i @skdx/vue">
  *   <SkdxClipboardInput aria-label="Install command" />
  *   <SkdxClipboardTrigger aria-label="Copy install command">
- *     <SkdxClipboardIndicator match="idle">Copy</SkdxClipboardIndicator>
- *     <SkdxClipboardIndicator>Copied!</SkdxClipboardIndicator>
+ *     <SkdxClipboardIndicator match="idle"><CopyIcon /></SkdxClipboardIndicator>
+ *     <SkdxClipboardIndicator><CheckIcon /></SkdxClipboardIndicator>
  *   </SkdxClipboardTrigger>
  * </SkdxClipboard>
  * ```
@@ -55,19 +80,65 @@ type __VLS_Props = {
      * @default 'Copied to clipboard'
      */
     copiedLabel?: string;
+    /**
+     * The live-region message announced when the copy *fails* — when both the
+     * async Clipboard API and the `execCommand` fallback are refused.
+     *
+     * Announced **assertively**, unlike `copiedLabel`, and the difference is
+     * deliberate: the user is on their way to paste, and a polite message
+     * queues behind whatever is being read and arrives after they have already
+     * pasted the *previous* clipboard contents. Politely-announced failure is
+     * unannounced failure.
+     *
+     * Pass `''` to announce nothing — `data-state="error"` and the
+     * `copy-error` emit still happen.
+     * @default 'Copy failed'
+     */
+    errorLabel?: string;
+    /**
+     * The trigger's accessible label, and the derived Trigger's `aria-label`.
+     * @default 'Copy'
+     */
+    label?: string;
+    /**
+     * Renders a derived read-only Input showing `value` beside the Trigger.
+     * @default false
+     */
+    showInput?: boolean;
+    /**
+     * The derived Input's accessible label. Separate from `label`, which
+     * names the Trigger — reusing it would name the field "Copy" rather than
+     * describe what it holds.
+     * @default 'Value to copy'
+     */
+    inputLabel?: string;
 };
+/**
+ * Performs the copy a Trigger would; exposed for shortcuts and retries.
+ * A no-op while the root is disabled.
+ */
+declare function copy(): void;
 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, {
-    copy: (value: string) => any;
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /**
+     * Writes value to clipboard; no-op while disabled.
+     */
+    copy: typeof copy;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "copy-success": (value: string) => any;
     "copy-error": (error: unknown) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onCopy?: ((value: string) => any) | undefined;
+    "onCopy-success"?: ((value: string) => any) | undefined;
     "onCopy-error"?: ((error: unknown) => any) | undefined;
 }>, {
+    label: string;
     disabled: boolean;
+    inputLabel: string;
+    errorLabel: string;
+    showInput: boolean;
     timeout: number | null;
     copiedLabel: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;