@skdx/vue 0.26.0 → 0.28.0

package/dist/progress/Progress.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{PROGRESS_CONTEXT as a,getProgressState as e}from"./context.js";import{computed as t,createElementBlock as l,defineComponent as u,openBlock as r,provide as o,renderSlot as s}from"vue";var v=["aria-valuemax","aria-valuenow","aria-valuetext","data-state","data-value","data-max"],d=/* @__PURE__ */u({__name:"Progress",props:{value:{default:null},max:{default:100},getValueLabel:{type:Function,default:(a,e)=>`${Math.round(a/e*100)}%`}},setup(u){const d=u,n=t(()=>null==d.value?null:Math.min(Math.max(d.value,0),d.max)),m=t(()=>d.max),i=t(()=>e(n.value,d.max)),x=t(()=>null!=n.value?d.getValueLabel(n.value,d.max):void 0);return o(a,{value:n,max:m}),(a,e)=>(r(),l("div",{class:"skdx-progress","data-part":"root","data-skdx-component":"progress",role:"progressbar","aria-valuemin":0,"aria-valuemax":m.value,"aria-valuenow":n.value??void 0,"aria-valuetext":x.value,"data-state":i.value,"data-value":n.value??void 0,"data-max":m.value},[s(a.$slots,"default")],8,v))}});export{d as default};
+import{nextId as a}from"../utils/id.js";import{PROGRESS_CONTEXT as e,clampProgressValue as l,getProgressPercent as t,getProgressState as r}from"./context.js";import o from"./ProgressAnatomy.vue.js";import{computed as u,createElementBlock as s,createVNode as d,defineComponent as i,openBlock as n,provide as m,ref as v,renderSlot as f,unref as p}from"vue";var c=["aria-valuemin","aria-valuemax","aria-valuenow","aria-valuetext","aria-labelledby","data-state","data-value","data-min","data-max"],b=/* @__PURE__ */i({__name:"Progress",props:{value:{default:null},min:{default:0},max:{default:100},buffer:{default:null},getValueLabel:{type:Function,default:void 0},formatOptions:{default:void 0},locale:{default:void 0},circular:{type:Boolean,default:!1},label:{default:void 0},showValue:{type:Boolean,default:!1},indeterminate:{type:Boolean,default:!1},diameter:{default:48},strokeWidth:{default:4}},setup(i){const b=i,x=u(()=>b.indeterminate?null:b.value),g=u(()=>l(x.value,b.min,b.max)),h=u(()=>l(b.buffer,b.min,b.max)),w=u(()=>b.min),k=u(()=>b.max),y=u(()=>r(g.value,b.max)),P=u(()=>{return null!=g.value?(a=g.value,e=b.min,l=b.max,void 0!==b.getValueLabel?b.getValueLabel(a,e,l):void 0!==b.formatOptions||void 0!==b.locale?new Intl.NumberFormat(b.locale,b.formatOptions).format(a):`${Math.round(t(a,e,l))}%`):void 0;var a,e,l}),V=a("progress-label"),B=v(!1);return m(e,{value:g,min:w,max:k,buffer:h,labelId:V,setHasLabel:a=>{B.value=a},valueLabel:P}),(a,e)=>(n(),s("div",{class:"skdx-progress","data-part":"root","data-skdx-component":"progress",role:"progressbar","aria-valuemin":w.value,"aria-valuemax":k.value,"aria-valuenow":g.value??void 0,"aria-valuetext":P.value,"aria-labelledby":B.value?p(V):void 0,"data-state":y.value,"data-value":g.value??void 0,"data-min":w.value,"data-max":k.value},[f(a.$slots,"default",{},()=>[d(o,{circular:i.circular,label:i.label,"show-value":i.showValue,diameter:i.diameter,"stroke-width":i.strokeWidth},null,8,["circular","label","show-value","diameter","stroke-width"])])],8,c))}});export{b as default};

package/dist/progress/ProgressAnatomy.vue.cjs

@@ -0,0 +1 @@
+const e=require("./ProgressAnatomy.vue_vue_type_script_setup_true_lang.cjs");var r=e.default;exports.default=r;

package/dist/progress/ProgressAnatomy.vue.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Anatomy when default slot empty: optional Label, linear/circular Indicator (by `circular`),
+ * optional Value. React port's `ProgressAnatomy.tsx` must stay synchronized.
+ * @internal
+ */
+type __VLS_Props = {
+    circular?: boolean;
+    label?: string;
+    showValue?: boolean;
+    diameter?: number;
+    strokeWidth?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    label: string;
+    diameter: number;
+    strokeWidth: number;
+    circular: boolean;
+    showValue: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/progress/ProgressAnatomy.vue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Anatomy when default slot empty: optional Label, linear/circular Indicator (by `circular`),
+ * optional Value. React port's `ProgressAnatomy.tsx` must stay synchronized.
+ * @internal
+ */
+type __VLS_Props = {
+    circular?: boolean;
+    label?: string;
+    showValue?: boolean;
+    diameter?: number;
+    strokeWidth?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    label: string;
+    diameter: number;
+    strokeWidth: number;
+    circular: boolean;
+    showValue: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/progress/ProgressAnatomy.vue.js

@@ -0,0 +1 @@
+import e from"./ProgressAnatomy.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/progress/ProgressAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const r=require("./ProgressCircle.vue.cjs"),a=require("./ProgressCircleIndicator.vue.cjs"),l=require("./ProgressIndicator.vue.cjs"),o=require("./ProgressLabel.vue.cjs"),u=require("./ProgressValue.vue.cjs");let e=require("vue");var c=(0,e.defineComponent)({__name:"ProgressAnatomy",props:{circular:{type:Boolean,default:!1},label:{default:void 0},showValue:{type:Boolean,default:!1},diameter:{default:48},strokeWidth:{default:4}},setup(t){return(i,d)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[t.label?((0,e.openBlock)(),(0,e.createBlock)(o.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)]),_:1})):(0,e.createCommentVNode)("",!0),t.circular?((0,e.openBlock)(),(0,e.createBlock)(r.default,{key:1,diameter:t.diameter,"stroke-width":t.strokeWidth},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(a.default)]),_:1},8,["diameter","stroke-width"])):((0,e.openBlock)(),(0,e.createBlock)(l.default,{key:2})),t.showValue?((0,e.openBlock)(),(0,e.createBlock)(u.default,{key:3})):(0,e.createCommentVNode)("",!0)],64))}});exports.default=c;

package/dist/progress/ProgressAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import e from"./ProgressCircle.vue.js";import r from"./ProgressCircleIndicator.vue.js";import t from"./ProgressIndicator.vue.js";import a from"./ProgressLabel.vue.js";import o from"./ProgressValue.vue.js";import{Fragment as s,createBlock as l,createCommentVNode as i,createElementBlock as d,createTextVNode as m,createVNode as u,defineComponent as c,openBlock as f,toDisplayString as n,withCtx as p}from"vue";var k=/* @__PURE__ */c({__name:"ProgressAnatomy",props:{circular:{type:Boolean,default:!1},label:{default:void 0},showValue:{type:Boolean,default:!1},diameter:{default:48},strokeWidth:{default:4}},setup:c=>(k,g)=>(f(),d(s,null,[c.label?(f(),l(a,{key:0},{default:p(()=>[m(n(c.label),1)]),_:1})):i("",!0),c.circular?(f(),l(e,{key:1,diameter:c.diameter,"stroke-width":c.strokeWidth},{default:p(()=>[u(r)]),_:1},8,["diameter","stroke-width"])):(f(),l(t,{key:2})),c.showValue?(f(),l(o,{key:3})):i("",!0)],64))});export{k as default};

package/dist/progress/ProgressCircle.vue.d.cts

@@ -1,42 +1,35 @@
 /**
- * Circular geometry host for a `<SkdxProgress>`. Renders **no SVG of its own**
- * — it is a plain element that publishes the ring's arithmetic as CSS custom
- * properties, so the consumer brings their own `<svg>` markup and drives
- * `stroke-dasharray` / `stroke-dashoffset` from CSS alone:
- *
- * - `--skdx-progress-circle-size` / `--skdx-progress-circle-thickness` — the props, echoed back.
- * - `--skdx-progress-circle-radius` — `(size - thickness) / 2`, the `r` of the ring's centre line.
- * - `--skdx-progress-circle-circumference` — `2πr`.
- * - `--skdx-progress-dasharray` — the value for `stroke-dasharray`.
- * - `--skdx-progress-circle-offset` — the value for `stroke-dashoffset`; **absent when indeterminate**.
- *
- * Carries the same `data-state` / `data-value` / `data-max` as the linear
- * parts. ARIA lives on the `<SkdxProgress>` root, which this must be used
- * inside — this part adds no second `role="progressbar"`.
+ * Circular geometry host, no SVG of its own. Publishes ring arithmetic as CSS
+ * custom properties: size/thickness (echoed props), radius, circumference,
+ * dasharray/offset for consumer's SVG. Carries same data-state/data-value/
+ * data-min/data-max as linear parts. ARIA on parent `<SkdxProgress>`.
  */
 type __VLS_Props = {
     /**
      * Outer diameter of the ring, in unitless SVG user units — the number you
-     * also put in your own `viewBox="0 0 size size"`. Unitless rather than a
+     * also put in your own `viewBox="0 0 diameter diameter"`. Named `diameter`,
+     * not `size`, so it stops colliding with the appearance rung the system
+     * reserves that word for. Unitless rather than a
      * CSS length because it feeds `stroke-dasharray`/`stroke-dashoffset`,
      * which are path lengths, not lengths CSS can convert.
      * @default 48 — a ring that reads at body-text scale, so the default renders visibly with no config.
      */
-    size?: number;
+    diameter?: number;
     /**
-     * Stroke width of the ring, in the same unitless units as `size`. Insets
-     * the radius by half its value so the stroke stays inside the `size` box.
-     * @default 4 — about a twelfth of the default `size`, thick enough to see and thin enough not to close the hole.
+     * Stroke width of the ring, in the same unitless units as `diameter`.
+     * Insets the radius by half its value so the stroke stays inside the
+     * `diameter` box.
+     * @default 4 — about a twelfth of the default `diameter`, thick enough to see and thin enough not to close the hole.
      */
-    thickness?: number;
+    strokeWidth?: number;
 };
 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<{}>, {
-    size: number;
-    thickness: number;
+    diameter: number;
+    strokeWidth: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/progress/ProgressCircle.vue.d.ts

@@ -1,42 +1,35 @@
 /**
- * Circular geometry host for a `<SkdxProgress>`. Renders **no SVG of its own**
- * — it is a plain element that publishes the ring's arithmetic as CSS custom
- * properties, so the consumer brings their own `<svg>` markup and drives
- * `stroke-dasharray` / `stroke-dashoffset` from CSS alone:
- *
- * - `--skdx-progress-circle-size` / `--skdx-progress-circle-thickness` — the props, echoed back.
- * - `--skdx-progress-circle-radius` — `(size - thickness) / 2`, the `r` of the ring's centre line.
- * - `--skdx-progress-circle-circumference` — `2πr`.
- * - `--skdx-progress-dasharray` — the value for `stroke-dasharray`.
- * - `--skdx-progress-circle-offset` — the value for `stroke-dashoffset`; **absent when indeterminate**.
- *
- * Carries the same `data-state` / `data-value` / `data-max` as the linear
- * parts. ARIA lives on the `<SkdxProgress>` root, which this must be used
- * inside — this part adds no second `role="progressbar"`.
+ * Circular geometry host, no SVG of its own. Publishes ring arithmetic as CSS
+ * custom properties: size/thickness (echoed props), radius, circumference,
+ * dasharray/offset for consumer's SVG. Carries same data-state/data-value/
+ * data-min/data-max as linear parts. ARIA on parent `<SkdxProgress>`.
  */
 type __VLS_Props = {
     /**
      * Outer diameter of the ring, in unitless SVG user units — the number you
-     * also put in your own `viewBox="0 0 size size"`. Unitless rather than a
+     * also put in your own `viewBox="0 0 diameter diameter"`. Named `diameter`,
+     * not `size`, so it stops colliding with the appearance rung the system
+     * reserves that word for. Unitless rather than a
      * CSS length because it feeds `stroke-dasharray`/`stroke-dashoffset`,
      * which are path lengths, not lengths CSS can convert.
      * @default 48 — a ring that reads at body-text scale, so the default renders visibly with no config.
      */
-    size?: number;
+    diameter?: number;
     /**
-     * Stroke width of the ring, in the same unitless units as `size`. Insets
-     * the radius by half its value so the stroke stays inside the `size` box.
-     * @default 4 — about a twelfth of the default `size`, thick enough to see and thin enough not to close the hole.
+     * Stroke width of the ring, in the same unitless units as `diameter`.
+     * Insets the radius by half its value so the stroke stays inside the
+     * `diameter` box.
+     * @default 4 — about a twelfth of the default `diameter`, thick enough to see and thin enough not to close the hole.
      */
-    thickness?: number;
+    strokeWidth?: number;
 };
 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<{}>, {
-    size: number;
-    thickness: number;
+    diameter: number;
+    strokeWidth: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/progress/ProgressCircle.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("./context.cjs");let e=require("vue");var p=["data-state","data-value","data-max"],_=(0,e.defineComponent)({__name:"ProgressCircle",props:{size:{default:48},thickness:{default:4}},setup(o){const s=o,c=(0,e.inject)(r.PROGRESS_CONTEXT);if(!c)throw new Error("<SkdxProgressCircle> must be used inside <SkdxProgress>.");const t=c,l=(0,e.computed)(()=>s.size),i=(0,e.computed)(()=>s.thickness),a=(0,e.computed)(()=>r.getCircleRadius(s.size,s.thickness)),u=(0,e.computed)(()=>2*Math.PI*a.value),n=(0,e.computed)(()=>r.getProgressState(t.value.value,t.max.value)),d=(0,e.computed)(()=>({"--skdx-progress-circle-size":s.size,"--skdx-progress-circle-thickness":s.thickness,"--skdx-progress-circle-radius":r.roundGeometry(a.value),...r.getCircleVars(u.value,t.value.value,t.max.value)}));return(0,e.provide)(r.PROGRESS_CIRCLE_CONTEXT,{size:l,thickness:i,radius:a,circumference:u}),(v,m)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-progress__circle","data-part":"circle","data-state":n.value,"data-value":(0,e.unref)(t).value.value??void 0,"data-max":(0,e.unref)(t).max.value,style:(0,e.normalizeStyle)(d.value)},[(0,e.renderSlot)(v.$slots,"default")],12,p))}});exports.default=_;
+const a=require("./context.cjs");let e=require("vue");var v=["data-state","data-value","data-min","data-max"],p=(0,e.defineComponent)({__name:"ProgressCircle",props:{diameter:{default:48},strokeWidth:{default:4}},setup(d){const r=d,o=(0,e.inject)(a.PROGRESS_CONTEXT);if(!o)throw new Error("<SkdxProgressCircle> must be used inside <SkdxProgress>.");const t=o,c=(0,e.computed)(()=>r.diameter),l=(0,e.computed)(()=>r.strokeWidth),s=(0,e.computed)(()=>a.getCircleRadius(r.diameter,r.strokeWidth)),u=(0,e.computed)(()=>2*Math.PI*s.value),i=(0,e.computed)(()=>a.getProgressState(t.value.value,t.max.value)),n=(0,e.computed)(()=>({"--skdx-progress-circle-size":r.diameter,"--skdx-progress-circle-thickness":r.strokeWidth,"--skdx-progress-circle-radius":a.roundGeometry(s.value),...a.getCircleVars(u.value,t.value.value,t.min.value,t.max.value)}));return(0,e.provide)(a.PROGRESS_CIRCLE_CONTEXT,{diameter:c,strokeWidth:l,radius:s,circumference:u}),(m,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-progress__circle","data-part":"circle","data-state":i.value,"data-value":(0,e.unref)(t).value.value??void 0,"data-min":(0,e.unref)(t).min.value,"data-max":(0,e.unref)(t).max.value,style:(0,e.normalizeStyle)(n.value)},[(0,e.renderSlot)(m.$slots,"default")],12,v))}});exports.default=p;

package/dist/progress/ProgressCircle.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{PROGRESS_CIRCLE_CONTEXT as e,PROGRESS_CONTEXT as s,getCircleRadius as a,getCircleVars as r,getProgressState as t,roundGeometry as l}from"./context.js";import{computed as i,createElementBlock as c,defineComponent as o,inject as u,normalizeStyle as d,openBlock as n,provide as v,renderSlot as m,unref as p}from"vue";var k=["data-state","data-value","data-max"],x=/* @__PURE__ */o({__name:"ProgressCircle",props:{size:{default:48},thickness:{default:4}},setup(o){const x=o,g=u(s);if(!g)throw new Error("<SkdxProgressCircle> must be used inside <SkdxProgress>.");const f=g,C=i(()=>x.size),S=i(()=>x.thickness),h=i(()=>a(x.size,x.thickness)),z=i(()=>2*Math.PI*h.value),E=i(()=>t(f.value.value,f.max.value)),P=i(()=>({"--skdx-progress-circle-size":x.size,"--skdx-progress-circle-thickness":x.thickness,"--skdx-progress-circle-radius":l(h.value),...r(z.value,f.value.value,f.max.value)}));return v(e,{size:C,thickness:S,radius:h,circumference:z}),(e,s)=>(n(),c("div",{class:"skdx-progress__circle","data-part":"circle","data-state":E.value,"data-value":p(f).value.value??void 0,"data-max":p(f).max.value,style:d(P.value)},[m(e.$slots,"default")],12,k))}});export{x as default};
+import{PROGRESS_CIRCLE_CONTEXT as e,PROGRESS_CONTEXT as a,getCircleRadius as s,getCircleVars as r,getProgressState as t,roundGeometry as d}from"./context.js";import{computed as i,createElementBlock as l,defineComponent as o,inject as u,normalizeStyle as c,openBlock as m,provide as n,renderSlot as v,unref as p}from"vue";var k=["data-state","data-value","data-min","data-max"],x=/* @__PURE__ */o({__name:"ProgressCircle",props:{diameter:{default:48},strokeWidth:{default:4}},setup(o){const x=o,g=u(a);if(!g)throw new Error("<SkdxProgressCircle> must be used inside <SkdxProgress>.");const f=g,C=i(()=>x.diameter),S=i(()=>x.strokeWidth),h=i(()=>s(x.diameter,x.strokeWidth)),E=i(()=>2*Math.PI*h.value),P=i(()=>t(f.value.value,f.max.value)),_=i(()=>({"--skdx-progress-circle-size":x.diameter,"--skdx-progress-circle-thickness":x.strokeWidth,"--skdx-progress-circle-radius":d(h.value),...r(E.value,f.value.value,f.min.value,f.max.value)}));return n(e,{diameter:C,strokeWidth:S,radius:h,circumference:E}),(e,a)=>(m(),l("div",{class:"skdx-progress__circle","data-part":"circle","data-state":P.value,"data-value":p(f).value.value??void 0,"data-min":p(f).min.value,"data-max":p(f).max.value,style:c(_.value)},[v(e.$slots,"default")],12,k))}});export{x as default};

package/dist/progress/ProgressCircleIndicator.vue.d.cts

@@ -1,14 +1,6 @@
 /**
- * The swept arc of a `<SkdxProgressCircle>` — the circular counterpart of
- * `<SkdxProgressIndicator>`. Mirrors the root's `data-state` / `data-value` /
- * `data-max`, and repeats the value-dependent ring properties
- * (`--skdx-progress-circle-circumference`, `--skdx-progress-dasharray`,
- * `--skdx-progress-circle-offset`) on itself so this element can be styled
- * directly, plus `--skdx-progress` as a percentage for anything measured in
- * percent rather than path length.
- *
- * Usually rendered as the `<circle>` (or `<path>`) it drives via `as`, since a
- * `div` has no stroke. Must be used inside `<SkdxProgressCircle>`.
+ * Swept arc for `<SkdxProgressCircle>`. Mirrors data-state/value/max and
+ * exposes CSS properties. Render as circle/path via `as` prop.
  *
  * @example
  * ```vue
@@ -21,9 +13,8 @@
  */
 type __VLS_Props = {
     /**
-     * Tag name to render. Vue has no `asChild`, so this is how the arc becomes
-     * the SVG element it drives — `as="circle"` inside your own `<svg>`.
-     * @default 'div' — a plain block element, matching every other part in this package; useless inside an `<svg>`, so pass `"circle"` or `"path"` there.
+     * Tag name to render (e.g., 'circle', 'path' for SVG).
+     * @default 'div'
      */
     as?: string;
 };

package/dist/progress/ProgressCircleIndicator.vue.d.ts

@@ -1,14 +1,6 @@
 /**
- * The swept arc of a `<SkdxProgressCircle>` — the circular counterpart of
- * `<SkdxProgressIndicator>`. Mirrors the root's `data-state` / `data-value` /
- * `data-max`, and repeats the value-dependent ring properties
- * (`--skdx-progress-circle-circumference`, `--skdx-progress-dasharray`,
- * `--skdx-progress-circle-offset`) on itself so this element can be styled
- * directly, plus `--skdx-progress` as a percentage for anything measured in
- * percent rather than path length.
- *
- * Usually rendered as the `<circle>` (or `<path>`) it drives via `as`, since a
- * `div` has no stroke. Must be used inside `<SkdxProgressCircle>`.
+ * Swept arc for `<SkdxProgressCircle>`. Mirrors data-state/value/max and
+ * exposes CSS properties. Render as circle/path via `as` prop.
  *
  * @example
  * ```vue
@@ -21,9 +13,8 @@
  */
 type __VLS_Props = {
     /**
-     * Tag name to render. Vue has no `asChild`, so this is how the arc becomes
-     * the SVG element it drives — `as="circle"` inside your own `<svg>`.
-     * @default 'div' — a plain block element, matching every other part in this package; useless inside an `<svg>`, so pass `"circle"` or `"path"` there.
+     * Tag name to render (e.g., 'circle', 'path' for SVG).
+     * @default 'div'
      */
     as?: string;
 };

package/dist/progress/ProgressCircleIndicator.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("./context.cjs");let e=require("vue");var n=(0,e.defineComponent)({__name:"ProgressCircleIndicator",props:{as:{default:"div"}},setup(l){const a=(0,e.inject)(r.PROGRESS_CONTEXT);if(!a)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgress>.");const s=(0,e.inject)(r.PROGRESS_CIRCLE_CONTEXT);if(!s)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgressCircle>.");const t=a,o=s,u=(0,e.computed)(()=>r.getProgressState(t.value.value,t.max.value)),c=(0,e.computed)(()=>({"--skdx-progress":t.value.value!=null?`${t.value.value/t.max.value*100}%`:void 0,...r.getCircleVars(o.circumference.value,t.value.value,t.max.value)}));return(i,d)=>((0,e.openBlock)(),(0,e.createBlock)((0,e.resolveDynamicComponent)(l.as),{class:"skdx-progress__circle-indicator","data-part":"circle-indicator","data-state":u.value,"data-value":(0,e.unref)(t).value.value??void 0,"data-max":(0,e.unref)(t).max.value,style:(0,e.normalizeStyle)(c.value)},null,8,["data-state","data-value","data-max","style"]))}});exports.default=n;
+const a=require("./context.cjs");let t=require("vue");var c=(0,t.defineComponent)({__name:"ProgressCircleIndicator",props:{as:{default:"div"}},setup(l){const r=(0,t.inject)(a.PROGRESS_CONTEXT);if(!r)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgress>.");const s=(0,t.inject)(a.PROGRESS_CIRCLE_CONTEXT);if(!s)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgressCircle>.");const e=r,n=s,u=(0,t.computed)(()=>a.getProgressState(e.value.value,e.max.value)),o=(0,t.computed)(()=>({"--skdx-progress":e.value.value!=null?`${a.getProgressPercent(e.value.value,e.min.value,e.max.value)}%`:void 0,...a.getCircleVars(n.circumference.value,e.value.value,e.min.value,e.max.value)}));return(i,d)=>((0,t.openBlock)(),(0,t.createBlock)((0,t.resolveDynamicComponent)(l.as),{class:"skdx-progress__circle-indicator","data-part":"circle-indicator","data-state":u.value,"data-value":(0,t.unref)(e).value.value??void 0,"data-min":(0,t.unref)(e).min.value,"data-max":(0,t.unref)(e).max.value,style:(0,t.normalizeStyle)(o.value)},null,8,["data-state","data-value","data-min","data-max","style"]))}});exports.default=c;

package/dist/progress/ProgressCircleIndicator.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{PROGRESS_CIRCLE_CONTEXT as e,PROGRESS_CONTEXT as a,getCircleVars as r,getProgressState as s}from"./context.js";import{computed as t,createBlock as l,defineComponent as o,inject as u,normalizeStyle as i,openBlock as d,resolveDynamicComponent as c,unref as n}from"vue";var v=/* @__PURE__ */o({__name:"ProgressCircleIndicator",props:{as:{default:"div"}},setup(o){const v=u(a);if(!v)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgress>.");const m=u(e);if(!m)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgressCircle>.");const x=v,p=m,C=t(()=>s(x.value.value,x.max.value)),g=t(()=>({"--skdx-progress":null!=x.value.value?x.value.value/x.max.value*100+"%":void 0,...r(p.circumference.value,x.value.value,x.max.value)}));return(e,a)=>(d(),l(c(o.as),{class:"skdx-progress__circle-indicator","data-part":"circle-indicator","data-state":C.value,"data-value":n(x).value.value??void 0,"data-max":n(x).max.value,style:i(g.value)},null,8,["data-state","data-value","data-max","style"]))}});export{v as default};
+import{PROGRESS_CIRCLE_CONTEXT as e,PROGRESS_CONTEXT as a,getCircleVars as r,getProgressPercent as s,getProgressState as t}from"./context.js";import{computed as l,createBlock as o,defineComponent as u,inject as i,normalizeStyle as n,openBlock as d,resolveDynamicComponent as c,unref as v}from"vue";var m=/* @__PURE__ */u({__name:"ProgressCircleIndicator",props:{as:{default:"div"}},setup(u){const m=i(a);if(!m)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgress>.");const x=i(e);if(!x)throw new Error("<SkdxProgressCircleIndicator> must be used inside <SkdxProgressCircle>.");const p=m,g=x,C=l(()=>t(p.value.value,p.max.value)),P=l(()=>({"--skdx-progress":null!=p.value.value?`${s(p.value.value,p.min.value,p.max.value)}%`:void 0,...r(g.circumference.value,p.value.value,p.min.value,p.max.value)}));return(e,a)=>(d(),o(c(u.as),{class:"skdx-progress__circle-indicator","data-part":"circle-indicator","data-state":C.value,"data-value":v(p).value.value??void 0,"data-min":v(p).min.value,"data-max":v(p).max.value,style:n(P.value)},null,8,["data-state","data-value","data-min","data-max","style"]))}});export{m as default};

package/dist/progress/ProgressIndicator.vue.d.cts

@@ -1,8 +1,7 @@
 /**
- * The visual fill of a `<SkdxProgress>` bar. Mirrors the root's `data-state`
- * / `data-value` / `data-max` and sets a `--skdx-progress` CSS custom
- * property (a percentage) so width/transform can be driven purely from CSS.
- * Must be used inside `<SkdxProgress>`.
+ * Visual fill of a progress bar. Sets `--skdx-progress` (percentage) and
+ * `--skdx-progress-buffer` (if provided) as CSS custom properties. Must be
+ * used inside `<SkdxProgress>`.
  */
 type __VLS_Props = {};
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/progress/ProgressIndicator.vue.d.ts

@@ -1,8 +1,7 @@
 /**
- * The visual fill of a `<SkdxProgress>` bar. Mirrors the root's `data-state`
- * / `data-value` / `data-max` and sets a `--skdx-progress` CSS custom
- * property (a percentage) so width/transform can be driven purely from CSS.
- * Must be used inside `<SkdxProgress>`.
+ * Visual fill of a progress bar. Sets `--skdx-progress` (percentage) and
+ * `--skdx-progress-buffer` (if provided) as CSS custom properties. Must be
+ * used inside `<SkdxProgress>`.
  */
 type __VLS_Props = {};
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/progress/ProgressIndicator.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("./context.cjs");let e=require("vue");var u=["data-state","data-value","data-max"],l=(0,e.defineComponent)({__name:"ProgressIndicator",setup(n){const a=(0,e.inject)(r.PROGRESS_CONTEXT);if(!a)throw new Error("<SkdxProgressIndicator> must be used inside <SkdxProgress>.");const t=a,s=(0,e.computed)(()=>r.getProgressState(t.value.value,t.max.value)),o=(0,e.computed)(()=>t.value.value!=null?`${t.value.value/t.max.value*100}%`:void 0);return(d,c)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-progress__indicator","data-part":"indicator","data-state":s.value,"data-value":(0,e.unref)(t).value.value??void 0,"data-max":(0,e.unref)(t).max.value,style:(0,e.normalizeStyle)({"--skdx-progress":o.value})},null,12,u))}});exports.default=l;
+const t=require("./context.cjs");let a=require("vue");var n=["data-state","data-value","data-min","data-max"],l=(0,a.defineComponent)({__name:"ProgressIndicator",setup(d){const r=(0,a.inject)(t.PROGRESS_CONTEXT);if(!r)throw new Error("<SkdxProgressIndicator> must be used inside <SkdxProgress>.");const e=r,s=(0,a.computed)(()=>t.getProgressState(e.value.value,e.max.value)),u=(0,a.computed)(()=>e.value.value!=null?`${t.getProgressPercent(e.value.value,e.min.value,e.max.value)}%`:void 0),o=(0,a.computed)(()=>e.buffer.value!=null?`${t.getProgressPercent(e.buffer.value,e.min.value,e.max.value)}%`:void 0);return(v,c)=>((0,a.openBlock)(),(0,a.createElementBlock)("div",{class:"skdx-progress__indicator","data-part":"indicator","data-state":s.value,"data-value":(0,a.unref)(e).value.value??void 0,"data-min":(0,a.unref)(e).min.value,"data-max":(0,a.unref)(e).max.value,style:(0,a.normalizeStyle)({"--skdx-progress":u.value,"--skdx-progress-buffer":o.value})},null,12,n))}});exports.default=l;

package/dist/progress/ProgressIndicator.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{PROGRESS_CONTEXT as a,getProgressState as e}from"./context.js";import{computed as t,createElementBlock as s,defineComponent as r,inject as o,normalizeStyle as l,openBlock as u,unref as d}from"vue";var n=["data-state","data-value","data-max"],v=/* @__PURE__ */r({__name:"ProgressIndicator",setup(r){const v=o(a);if(!v)throw new Error("<SkdxProgressIndicator> must be used inside <SkdxProgress>.");const i=v,m=t(()=>e(i.value.value,i.max.value)),c=t(()=>null!=i.value.value?i.value.value/i.max.value*100+"%":void 0);return(a,e)=>(u(),s("div",{class:"skdx-progress__indicator","data-part":"indicator","data-state":m.value,"data-value":d(i).value.value??void 0,"data-max":d(i).max.value,style:l({"--skdx-progress":c.value})},null,12,n))}});export{v as default};
+import{PROGRESS_CONTEXT as a,getProgressPercent as e,getProgressState as s}from"./context.js";import{computed as t,createElementBlock as r,defineComponent as l,inject as u,normalizeStyle as o,openBlock as n,unref as v}from"vue";var d=["data-state","data-value","data-min","data-max"],i=/* @__PURE__ */l({__name:"ProgressIndicator",setup(l){const i=u(a);if(!i)throw new Error("<SkdxProgressIndicator> must be used inside <SkdxProgress>.");const m=i,c=t(()=>s(m.value.value,m.max.value)),x=t(()=>null!=m.value.value?`${e(m.value.value,m.min.value,m.max.value)}%`:void 0),f=t(()=>null!=m.buffer.value?`${e(m.buffer.value,m.min.value,m.max.value)}%`:void 0);return(a,e)=>(n(),r("div",{class:"skdx-progress__indicator","data-part":"indicator","data-state":c.value,"data-value":v(m).value.value??void 0,"data-min":v(m).min.value,"data-max":v(m).max.value,style:o({"--skdx-progress":x.value,"--skdx-progress-buffer":f.value})},null,12,d))}});export{i as default};

package/dist/progress/ProgressLabel.vue.cjs

@@ -0,0 +1 @@
+const e=require("./ProgressLabel.vue_vue_type_script_setup_true_lang.cjs");var r=e.default;exports.default=r;

package/dist/progress/ProgressLabel.vue.d.cts

@@ -0,0 +1,18 @@
+/**
+ * The bar's visible name. A `<span>`, not a `<label>`:
+ * `role="progressbar"` is not labelable, so `<label for>` would name nothing.
+ * Must be inside `<SkdxProgress>`.
+ */
+type __VLS_Props = {};
+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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/progress/ProgressLabel.vue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The bar's visible name. A `<span>`, not a `<label>`:
+ * `role="progressbar"` is not labelable, so `<label for>` would name nothing.
+ * Must be inside `<SkdxProgress>`.
+ */
+type __VLS_Props = {};
+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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/progress/ProgressLabel.vue.js

@@ -0,0 +1 @@
+import e from"./ProgressLabel.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/progress/ProgressLabel.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const s=require("./context.cjs");let e=require("vue");var l=["id","data-state"],n=(0,e.defineComponent)({__name:"ProgressLabel",setup(u){const r=(0,e.inject)(s.PROGRESS_CONTEXT);if(!r)throw new Error("<SkdxProgressLabel> must be used inside <SkdxProgress>.");const t=r;(0,e.onMounted)(()=>t.setHasLabel(!0)),(0,e.onBeforeUnmount)(()=>t.setHasLabel(!1));const a=(0,e.computed)(()=>s.getProgressState(t.value.value,t.max.value));return(o,d)=>((0,e.openBlock)(),(0,e.createElementBlock)("span",{class:"skdx-progress__label","data-part":"label",id:(0,e.unref)(t).labelId,"data-state":a.value},[(0,e.renderSlot)(o.$slots,"default")],8,l))}});exports.default=n;

package/dist/progress/ProgressLabel.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{PROGRESS_CONTEXT as e,getProgressState as a}from"./context.js";import{computed as s,createElementBlock as t,defineComponent as o,inject as r,onBeforeUnmount as l,onMounted as n,openBlock as d,renderSlot as u,unref as m}from"vue";var c=["id","data-state"],p=/* @__PURE__ */o({__name:"ProgressLabel",setup(o){const p=r(e);if(!p)throw new Error("<SkdxProgressLabel> must be used inside <SkdxProgress>.");const i=p;n(()=>i.setHasLabel(!0)),l(()=>i.setHasLabel(!1));const b=s(()=>a(i.value.value,i.max.value));return(e,a)=>(d(),t("span",{class:"skdx-progress__label","data-part":"label",id:m(i).labelId,"data-state":b.value},[u(e.$slots,"default")],8,c))}});export{p as default};

package/dist/progress/ProgressValue.vue.cjs

@@ -0,0 +1 @@
+const e=require("./ProgressValue.vue_vue_type_script_setup_true_lang.cjs");var r=e.default;exports.default=r;

package/dist/progress/ProgressValue.vue.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Visible readout, aria-hidden (same as `aria-valuetext` to prevent double-reading).
+ * Shows slot content or default label, nothing while indeterminate. Must be used in `SkdxProgress`.
+ */
+type __VLS_Props = {};
+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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/progress/ProgressValue.vue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Visible readout, aria-hidden (same as `aria-valuetext` to prevent double-reading).
+ * Shows slot content or default label, nothing while indeterminate. Must be used in `SkdxProgress`.
+ */
+type __VLS_Props = {};
+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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/progress/ProgressValue.vue.js

@@ -0,0 +1 @@
+import e from"./ProgressValue.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/progress/ProgressValue.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const r=require("./context.cjs");let e=require("vue");var n=["data-state"],c=(0,e.defineComponent)({__name:"ProgressValue",setup(d){const a=(0,e.inject)(r.PROGRESS_CONTEXT);if(!a)throw new Error("<SkdxProgressValue> must be used inside <SkdxProgress>.");const t=a,s=(0,e.useSlots)(),o=(0,e.computed)(()=>r.getProgressState(t.value.value,t.max.value)),u=(0,e.computed)(()=>s.default!=null);return(l,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("span",{class:"skdx-progress__value","data-part":"value","aria-hidden":"true","data-state":o.value},[u.value?(0,e.renderSlot)(l.$slots,"default",{key:0}):((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,{key:1},[(0,e.createTextVNode)((0,e.toDisplayString)((0,e.unref)(t).valueLabel.value),1)],64))],8,n))}});exports.default=c;

package/dist/progress/ProgressValue.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{PROGRESS_CONTEXT as e,getProgressState as a}from"./context.js";import{Fragment as s,computed as t,createElementBlock as r,createTextVNode as o,defineComponent as l,inject as u,openBlock as n,renderSlot as d,toDisplayString as i,unref as m,useSlots as p}from"vue";var v=["data-state"],c=/* @__PURE__ */l({__name:"ProgressValue",setup(l){const c=u(e);if(!c)throw new Error("<SkdxProgressValue> must be used inside <SkdxProgress>.");const f=c,g=p(),S=t(()=>a(f.value.value,f.max.value)),k=t(()=>null!=g.default);return(e,a)=>(n(),r("span",{class:"skdx-progress__value","data-part":"value","aria-hidden":"true","data-state":S.value},[k.value?d(e.$slots,"default",{key:0}):(n(),r(s,{key:1},[o(i(m(f).valueLabel.value),1)],64))],8,v))}});export{c as default};

package/dist/progress/context.cjs

@@ -1 +1 @@
-var o=Symbol("skdx-progress-context");function n(r,e){return r==null?"indeterminate":r>=e?"complete":"loading"}var i=Symbol("skdx-progress-circle-context");function t(r){return Math.round(r*1e4)/1e4}function a(r,e){return Math.max((r-e)/2,0)}function c(r,e,s){return{"--skdx-progress-circle-circumference":t(r),"--skdx-progress-dasharray":t(r),"--skdx-progress-circle-offset":e==null?void 0:t(r*(1-e/s))}}exports.PROGRESS_CIRCLE_CONTEXT=i;exports.PROGRESS_CONTEXT=o;exports.getCircleRadius=a;exports.getCircleVars=c;exports.getProgressState=n;exports.roundGeometry=t;
+var a=Symbol("skdx-progress-context");function c(r,e){return r==null?"indeterminate":r>=e?"complete":"loading"}function o(r,e,t){const s=t-e;return s>0?(r-e)/s*100:0}function g(r,e,t){return r==null?null:Math.min(Math.max(r,e),t)}var l=Symbol("skdx-progress-circle-context");function n(r){return Math.round(r*1e4)/1e4}function u(r,e){return Math.max((r-e)/2,0)}function i(r,e,t,s){return{"--skdx-progress-circle-circumference":n(r),"--skdx-progress-dasharray":n(r),"--skdx-progress-circle-offset":e==null?void 0:n(r*(1-o(e,t,s)/100))}}exports.PROGRESS_CIRCLE_CONTEXT=l;exports.PROGRESS_CONTEXT=a;exports.clampProgressValue=g;exports.getCircleRadius=u;exports.getCircleVars=i;exports.getProgressPercent=o;exports.getProgressState=c;exports.roundGeometry=n;

package/dist/progress/context.d.cts

@@ -1,44 +1,48 @@
 import type { ComputedRef, CSSProperties, InjectionKey } from 'vue';
-/** @internal Injection key a Progress provides so its Indicator part can mirror value/max. */
+/** @internal Injection key a Progress provides so its parts can mirror the range. */
 export interface ProgressContext {
     value: ComputedRef<number | null>;
+    min: ComputedRef<number>;
     max: ComputedRef<number>;
+    buffer: ComputedRef<number | null>;
+    /** The id `<SkdxProgressLabel>` takes, and the root points `aria-labelledby` at while one is mounted. */
+    labelId: string;
+    /** Registers the presence of a Label part, so the root only wires `aria-labelledby` when one exists. */
+    setHasLabel: (hasLabel: boolean) => void;
+    /** The formatted readout, shared with `<SkdxProgressValue>` so the visible string and `aria-valuetext` cannot drift. */
+    valueLabel: ComputedRef<string | undefined>;
 }
 /** @internal Injection key a Progress provides so its indicator mirrors the current value and max. */
 export declare const PROGRESS_CONTEXT: InjectionKey<ProgressContext>;
 /** @internal Maps a value/max pair to a Progress state: indeterminate when value is null, complete when value >= max, else loading. */
 export declare function getProgressState(value: number | null, max: number): 'indeterminate' | 'loading' | 'complete';
+/**
+ * @internal Position of `value` in `[min, max]` as percentage; `0` for degenerate
+ * range (NaN illegible in CSS).
+ */
+export declare function getProgressPercent(value: number, min: number, max: number): number;
+/** @internal Clamps a value into `[min, max]`, leaving `null` (indeterminate, or no buffer) alone. */
+export declare function clampProgressValue(value: number | null, min: number, max: number): number | null;
 /** @internal Ring geometry a ProgressCircle provides so its Indicator part can reuse the same arithmetic. */
 export interface ProgressCircleContext {
-    size: ComputedRef<number>;
-    thickness: ComputedRef<number>;
+    diameter: ComputedRef<number>;
+    strokeWidth: ComputedRef<number>;
     radius: ComputedRef<number>;
     circumference: ComputedRef<number>;
 }
 /** @internal Injection key a ProgressCircle provides so its arc mirrors the ring's geometry. */
 export declare const PROGRESS_CIRCLE_CONTEXT: InjectionKey<ProgressCircleContext>;
 /**
- * @internal Trims float noise off a geometry value. These land in the DOM as
- * CSS custom properties a human reads while debugging, and `138.2301` is as
- * exact as any stroke can be drawn.
+ * @internal Trims float noise; values land in CSS custom properties for debugging.
  */
 export declare function roundGeometry(n: number): number;
 /**
- * @internal Radius of the ring's *centre line*. A stroke straddles its path,
- * so half of `thickness` sits outside the radius — insetting by `thickness / 2`
- * is what keeps the ring inside the `size` box instead of clipping at the
- * viewBox edge. Floored at `0` so a `thickness` wider than `size` degenerates
- * to a dot rather than a negative circumference.
+ * @internal Ring's centre-line radius: insetting by `strokeWidth / 2` keeps it inside
+ * `diameter`, floored at `0` to avoid negative circumference.
  */
-export declare function getCircleRadius(size: number, thickness: number): number;
+export declare function getCircleRadius(diameter: number, strokeWidth: number): number;
 /**
- * @internal The value-dependent half of the ring geometry, shared by
- * `SkdxProgressCircle` and `SkdxProgressCircleIndicator` so both elements can be
- * the one a consumer writes `stroke-dashoffset` on.
- *
- * `--skdx-progress-circle-offset` is omitted when indeterminate, exactly as
- * `SkdxProgressIndicator` omits `--skdx-progress`: an unset custom property falls
- * through to whatever the consumer's own animation sets, instead of pinning the
- * ring at a value it does not have.
+ * @internal Value-dependent ring geometry, shared so either part can take `stroke-dashoffset`.
+ * Omits `--skdx-progress-circle-offset` when indeterminate so custom animations work.
  */
-export declare function getCircleVars(circumference: number, value: number | null, max: number): CSSProperties;
+export declare function getCircleVars(circumference: number, value: number | null, min: number, max: number): CSSProperties;

package/dist/progress/context.d.ts

@@ -1,44 +1,48 @@
 import type { ComputedRef, CSSProperties, InjectionKey } from 'vue';
-/** @internal Injection key a Progress provides so its Indicator part can mirror value/max. */
+/** @internal Injection key a Progress provides so its parts can mirror the range. */
 export interface ProgressContext {
     value: ComputedRef<number | null>;
+    min: ComputedRef<number>;
     max: ComputedRef<number>;
+    buffer: ComputedRef<number | null>;
+    /** The id `<SkdxProgressLabel>` takes, and the root points `aria-labelledby` at while one is mounted. */
+    labelId: string;
+    /** Registers the presence of a Label part, so the root only wires `aria-labelledby` when one exists. */
+    setHasLabel: (hasLabel: boolean) => void;
+    /** The formatted readout, shared with `<SkdxProgressValue>` so the visible string and `aria-valuetext` cannot drift. */
+    valueLabel: ComputedRef<string | undefined>;
 }
 /** @internal Injection key a Progress provides so its indicator mirrors the current value and max. */
 export declare const PROGRESS_CONTEXT: InjectionKey<ProgressContext>;
 /** @internal Maps a value/max pair to a Progress state: indeterminate when value is null, complete when value >= max, else loading. */
 export declare function getProgressState(value: number | null, max: number): 'indeterminate' | 'loading' | 'complete';
+/**
+ * @internal Position of `value` in `[min, max]` as percentage; `0` for degenerate
+ * range (NaN illegible in CSS).
+ */
+export declare function getProgressPercent(value: number, min: number, max: number): number;
+/** @internal Clamps a value into `[min, max]`, leaving `null` (indeterminate, or no buffer) alone. */
+export declare function clampProgressValue(value: number | null, min: number, max: number): number | null;
 /** @internal Ring geometry a ProgressCircle provides so its Indicator part can reuse the same arithmetic. */
 export interface ProgressCircleContext {
-    size: ComputedRef<number>;
-    thickness: ComputedRef<number>;
+    diameter: ComputedRef<number>;
+    strokeWidth: ComputedRef<number>;
     radius: ComputedRef<number>;
     circumference: ComputedRef<number>;
 }
 /** @internal Injection key a ProgressCircle provides so its arc mirrors the ring's geometry. */
 export declare const PROGRESS_CIRCLE_CONTEXT: InjectionKey<ProgressCircleContext>;
 /**
- * @internal Trims float noise off a geometry value. These land in the DOM as
- * CSS custom properties a human reads while debugging, and `138.2301` is as
- * exact as any stroke can be drawn.
+ * @internal Trims float noise; values land in CSS custom properties for debugging.
  */
 export declare function roundGeometry(n: number): number;
 /**
- * @internal Radius of the ring's *centre line*. A stroke straddles its path,
- * so half of `thickness` sits outside the radius — insetting by `thickness / 2`
- * is what keeps the ring inside the `size` box instead of clipping at the
- * viewBox edge. Floored at `0` so a `thickness` wider than `size` degenerates
- * to a dot rather than a negative circumference.
+ * @internal Ring's centre-line radius: insetting by `strokeWidth / 2` keeps it inside
+ * `diameter`, floored at `0` to avoid negative circumference.
  */
-export declare function getCircleRadius(size: number, thickness: number): number;
+export declare function getCircleRadius(diameter: number, strokeWidth: number): number;
 /**
- * @internal The value-dependent half of the ring geometry, shared by
- * `SkdxProgressCircle` and `SkdxProgressCircleIndicator` so both elements can be
- * the one a consumer writes `stroke-dashoffset` on.
- *
- * `--skdx-progress-circle-offset` is omitted when indeterminate, exactly as
- * `SkdxProgressIndicator` omits `--skdx-progress`: an unset custom property falls
- * through to whatever the consumer's own animation sets, instead of pinning the
- * ring at a value it does not have.
+ * @internal Value-dependent ring geometry, shared so either part can take `stroke-dashoffset`.
+ * Omits `--skdx-progress-circle-offset` when indeterminate so custom animations work.
  */
-export declare function getCircleVars(circumference: number, value: number | null, max: number): CSSProperties;
+export declare function getCircleVars(circumference: number, value: number | null, min: number, max: number): CSSProperties;