@skdx/vue 0.27.0 → 0.29.0

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

package/dist/progress/ProgressLabel.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{PROGRESS_CONTEXT as a,getProgressState as s}from"./context.js";import{computed as t,createElementBlock as o,defineComponent as r,onBeforeUnmount as l,onMounted as n,openBlock as d,renderSlot as u,unref as i}from"vue";var m=["id","data-state"],p=/* @__PURE__ */r({__name:"ProgressLabel",setup(r){const p=e(a,"<SkdxProgressLabel> must be used inside <SkdxProgress>.");n(()=>p.setHasLabel(!0)),l(()=>p.setHasLabel(!1));const c=t(()=>s(p.value.value,p.max.value));return(e,a)=>(d(),o("span",{id:i(p).labelId,class:"skdx-progress__label","data-part":"label","data-state":c.value},[u(e.$slots,"default")],8,m))}});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,14 @@
+/** Visible readout, aria-hidden so it doesn't double up with `aria-valuetext`. */
+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,14 @@
+/** Visible readout, aria-hidden so it doesn't double up with `aria-valuetext`. */
+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 o=require("../utils/injectRequired.cjs"),a=require("./context.cjs");let e=require("vue");var n=["data-state","data-range"],d=(0,e.defineComponent)({__name:"ProgressValue",setup(c){const t=o.injectRequired(a.PROGRESS_CONTEXT,"<SkdxProgressValue> must be used inside <SkdxProgress>."),r=(0,e.useSlots)(),s=(0,e.computed)(()=>t.role.value==="meter"?void 0:a.getProgressState(t.value.value,t.max.value)),u=(0,e.computed)(()=>r.default!=null);return(l,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("span",{class:"skdx-progress__value","data-part":"value","aria-hidden":"true","data-state":s.value,"data-range":(0,e.unref)(t).range.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=d;

package/dist/progress/ProgressValue.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{PROGRESS_CONTEXT as a,getProgressState as s}from"./context.js";import{Fragment as t,computed as r,createElementBlock as l,createTextVNode as u,defineComponent as o,openBlock as d,renderSlot as n,toDisplayString as i,unref as m,useSlots as v}from"vue";var p=["data-state","data-range"],g=/* @__PURE__ */o({__name:"ProgressValue",setup(o){const g=e(a,"<SkdxProgressValue> must be used inside <SkdxProgress>."),c=v(),f=r(()=>"meter"===g.role.value?void 0:s(g.value.value,g.max.value)),S=r(()=>null!=c.default);return(e,a)=>(d(),l("span",{class:"skdx-progress__value","data-part":"value","aria-hidden":"true","data-state":f.value,"data-range":m(g).range.value},[S.value?n(e.$slots,"default",{key:0}):(d(),l(t,{key:1},[u(i(m(g).valueLabel.value),1)],64))],8,p))}});export{g 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 m=Symbol("skdx-progress-context");function d(r,t){return r==null?"indeterminate":r>=t?"complete":"loading"}function l(r,t,e){const n=e-t;return n>0?(r-t)/n*100:0}function p(r,t,e){return r==null?null:Math.min(Math.max(r,t),e)}function f(r,t,e,n,s){return r!==void 0||t!==void 0||e!==void 0||n===0&&s===100}function h(r,t,e,n){const{low:s,high:a,optimum:c}=n;if(s==null&&a==null&&c==null)return;const o=Math.min(Math.max(s??t,t),e),i=Math.min(Math.max(a??e,o),e),g=Math.min(Math.max(c??(t+e)/2,t),e);return g<o?r<=o?"optimum":r<=i?"suboptimal":"poor":g>i?r>=i?"optimum":r>=o?"suboptimal":"poor":r>=o&&r<=i?"optimum":"suboptimal"}var P=Symbol("skdx-progress-circle-context");function u(r){return Math.round(r*1e4)/1e4}function R(r,t){return Math.max((r-t)/2,0)}function C(r,t,e,n){return{"--skdx-progress-circle-circumference":u(r),"--skdx-progress-dasharray":u(r),"--skdx-progress-circle-offset":t==null?void 0:u(r*(1-l(t,e,n)/100))}}exports.PROGRESS_CIRCLE_CONTEXT=P;exports.PROGRESS_CONTEXT=m;exports.announcesValueText=f;exports.clampProgressValue=p;exports.getCircleRadius=R;exports.getCircleVars=C;exports.getProgressPercent=l;exports.getProgressRange=h;exports.getProgressState=d;exports.roundGeometry=u;

package/dist/progress/context.d.cts

@@ -1,44 +1,64 @@
 import type { ComputedRef, CSSProperties, InjectionKey } from 'vue';
-/** @internal Injection key a Progress provides so its Indicator part can mirror value/max. */
+/** What the root reports: a task in flight, or a static scalar within a known range. */
+export type ProgressRole = 'progressbar' | 'meter';
+/** Which band of the range the current value falls in, once `low`/`high`/`optimum` are supplied. */
+export type ProgressRange = 'optimum' | 'suboptimal' | 'poor';
+/** @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>;
+    /** What the root reports, which decides whether the parts publish a band. */
+    role: ComputedRef<ProgressRole>;
+    /** The band the value falls in under `role="meter"`; undefined with no thresholds. */
+    range: ComputedRef<ProgressRange | undefined>;
+    /** 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 Whether aria-valuetext may emit under `role="meter"`; the default percentage is valid only on a 0..100 range. */
+export declare function announcesValueText(getValueLabel: ((value: number, min: number, max: number) => string) | undefined, formatOptions: Intl.NumberFormatOptions | undefined, locale: string | undefined, min: number, max: number): boolean;
+/** @internal Band the value falls in, per the `<meter>` rules; undefined if no thresholds are given. */
+export declare function getProgressRange(value: number, min: number, max: number, thresholds: {
+    low?: number | undefined;
+    high?: number | undefined;
+    optimum?: number | undefined;
+}): ProgressRange | undefined;
 /** @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,64 @@
 import type { ComputedRef, CSSProperties, InjectionKey } from 'vue';
-/** @internal Injection key a Progress provides so its Indicator part can mirror value/max. */
+/** What the root reports: a task in flight, or a static scalar within a known range. */
+export type ProgressRole = 'progressbar' | 'meter';
+/** Which band of the range the current value falls in, once `low`/`high`/`optimum` are supplied. */
+export type ProgressRange = 'optimum' | 'suboptimal' | 'poor';
+/** @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>;
+    /** What the root reports, which decides whether the parts publish a band. */
+    role: ComputedRef<ProgressRole>;
+    /** The band the value falls in under `role="meter"`; undefined with no thresholds. */
+    range: ComputedRef<ProgressRange | undefined>;
+    /** 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 Whether aria-valuetext may emit under `role="meter"`; the default percentage is valid only on a 0..100 range. */
+export declare function announcesValueText(getValueLabel: ((value: number, min: number, max: number) => string) | undefined, formatOptions: Intl.NumberFormatOptions | undefined, locale: string | undefined, min: number, max: number): boolean;
+/** @internal Band the value falls in, per the `<meter>` rules; undefined if no thresholds are given. */
+export declare function getProgressRange(value: number, min: number, max: number, thresholds: {
+    low?: number | undefined;
+    high?: number | undefined;
+    optimum?: number | undefined;
+}): ProgressRange | undefined;
 /** @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.js

@@ -1 +1 @@
-var r=/* @__PURE__ */Symbol("skdx-progress-context");function e(r,e){return null==r?"indeterminate":r>=e?"complete":"loading"}var s=/* @__PURE__ */Symbol("skdx-progress-circle-context");function t(r){return Math.round(1e4*r)/1e4}function n(r,e){return Math.max((r-e)/2,0)}function o(r,e,s){return{"--skdx-progress-circle-circumference":t(r),"--skdx-progress-dasharray":t(r),"--skdx-progress-circle-offset":null==e?void 0:t(r*(1-e/s))}}export{s as PROGRESS_CIRCLE_CONTEXT,r as PROGRESS_CONTEXT,n as getCircleRadius,o as getCircleVars,e as getProgressState,t as roundGeometry};
+var r=/* @__PURE__ */Symbol("skdx-progress-context");function t(r,t){return null==r?"indeterminate":r>=t?"complete":"loading"}function e(r,t,e){const n=e-t;return n>0?(r-t)/n*100:0}function n(r,t,e){return null==r?null:Math.min(Math.max(r,t),e)}function o(r,t,e,n,o){return void 0!==r||void 0!==t||void 0!==e||0===n&&100===o}function s(r,t,e,n){const{low:o,high:s,optimum:a}=n;if(null==o&&null==s&&null==a)return;const u=Math.min(Math.max(o??t,t),e),i=Math.min(Math.max(s??e,u),e),l=Math.min(Math.max(a??(t+e)/2,t),e);return l<u?r<=u?"optimum":r<=i?"suboptimal":"poor":l>i?r>=i?"optimum":r>=u?"suboptimal":"poor":r>=u&&r<=i?"optimum":"suboptimal"}var a=/* @__PURE__ */Symbol("skdx-progress-circle-context");function u(r){return Math.round(1e4*r)/1e4}function i(r,t){return Math.max((r-t)/2,0)}function l(r,t,n,o){return{"--skdx-progress-circle-circumference":u(r),"--skdx-progress-dasharray":u(r),"--skdx-progress-circle-offset":null==t?void 0:u(r*(1-e(t,n,o)/100))}}export{a as PROGRESS_CIRCLE_CONTEXT,r as PROGRESS_CONTEXT,o as announcesValueText,n as clampProgressValue,i as getCircleRadius,l as getCircleVars,e as getProgressPercent,s as getProgressRange,t as getProgressState,u as roundGeometry};

package/dist/progress/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./Progress.vue.cjs"),e=require("./ProgressIndicator.vue.cjs"),o=require("./ProgressCircle.vue.cjs"),s=require("./ProgressCircleIndicator.vue.cjs");exports.SkdxProgress=r.default;exports.SkdxProgressCircle=o.default;exports.SkdxProgressCircleIndicator=s.default;exports.SkdxProgressIndicator=e.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./Progress.vue.cjs");exports.SkdxProgress=e.default;

package/dist/progress/index.d.cts

@@ -1,4 +1,2 @@
 export { default as SkdxProgress } from './Progress.vue.cjs';
-export { default as SkdxProgressIndicator } from './ProgressIndicator.vue.cjs';
-export { default as SkdxProgressCircle } from './ProgressCircle.vue.cjs';
-export { default as SkdxProgressCircleIndicator } from './ProgressCircleIndicator.vue.cjs';
+export type { ProgressRange, ProgressRole } from './context.cjs';

package/dist/progress/index.d.ts

@@ -1,4 +1,2 @@
 export { default as SkdxProgress } from './Progress.vue.js';
-export { default as SkdxProgressIndicator } from './ProgressIndicator.vue.js';
-export { default as SkdxProgressCircle } from './ProgressCircle.vue.js';
-export { default as SkdxProgressCircleIndicator } from './ProgressCircleIndicator.vue.js';
+export type { ProgressRange, ProgressRole } from './context.js';

package/dist/progress/index.js

@@ -1 +1 @@
-import r from"./Progress.vue.js";import s from"./ProgressIndicator.vue.js";import o from"./ProgressCircle.vue.js";import e from"./ProgressCircleIndicator.vue.js";export{r as SkdxProgress,o as SkdxProgressCircle,e as SkdxProgressCircleIndicator,s as SkdxProgressIndicator};
+import r from"./Progress.vue.js";export{r as SkdxProgress};

package/dist/progress/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ProgressCircle.vue.cjs"),e=require("./ProgressCircleIndicator.vue.cjs"),s=require("./ProgressIndicator.vue.cjs"),o=require("./ProgressLabel.vue.cjs"),i=require("./ProgressValue.vue.cjs"),u=require("./Progress.vue.cjs");exports.SkdxProgress=u.default;exports.SkdxProgressCircle=r.default;exports.SkdxProgressCircleIndicator=e.default;exports.SkdxProgressIndicator=s.default;exports.SkdxProgressLabel=o.default;exports.SkdxProgressValue=i.default;

package/dist/progress/primitives.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Advanced primitives for `SkdxProgress`, for a different structure such as a custom label or SVG ring.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxProgress, SkdxProgressIndicator, SkdxProgressLabel, SkdxProgressValue } from '@skdx/vue/primitives/progress';
+ * </script>
+ *
+ * <template>
+ *   <SkdxProgress :value="66" aria-label="Uploading">
+ *     <SkdxProgressLabel>Uploading</SkdxProgressLabel>
+ *     <SkdxProgressIndicator />
+ *     <SkdxProgressValue />
+ *   </SkdxProgress>
+ * </template>
+ * ```
+ */
+export { default as SkdxProgress } from './Progress.vue.cjs';
+export { default as SkdxProgressLabel } from './ProgressLabel.vue.cjs';
+export { default as SkdxProgressValue } from './ProgressValue.vue.cjs';
+export { default as SkdxProgressIndicator } from './ProgressIndicator.vue.cjs';
+export { default as SkdxProgressCircle } from './ProgressCircle.vue.cjs';
+export { default as SkdxProgressCircleIndicator } from './ProgressCircleIndicator.vue.cjs';
+export type { ProgressRange, ProgressRole } from './context.cjs';

package/dist/progress/primitives.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Advanced primitives for `SkdxProgress`, for a different structure such as a custom label or SVG ring.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxProgress, SkdxProgressIndicator, SkdxProgressLabel, SkdxProgressValue } from '@skdx/vue/primitives/progress';
+ * </script>
+ *
+ * <template>
+ *   <SkdxProgress :value="66" aria-label="Uploading">
+ *     <SkdxProgressLabel>Uploading</SkdxProgressLabel>
+ *     <SkdxProgressIndicator />
+ *     <SkdxProgressValue />
+ *   </SkdxProgress>
+ * </template>
+ * ```
+ */
+export { default as SkdxProgress } from './Progress.vue.js';
+export { default as SkdxProgressLabel } from './ProgressLabel.vue.js';
+export { default as SkdxProgressValue } from './ProgressValue.vue.js';
+export { default as SkdxProgressIndicator } from './ProgressIndicator.vue.js';
+export { default as SkdxProgressCircle } from './ProgressCircle.vue.js';
+export { default as SkdxProgressCircleIndicator } from './ProgressCircleIndicator.vue.js';
+export type { ProgressRange, ProgressRole } from './context.js';

package/dist/progress/primitives.js

@@ -0,0 +1 @@
+import r from"./ProgressCircle.vue.js";import s from"./ProgressCircleIndicator.vue.js";import o from"./ProgressIndicator.vue.js";import e from"./ProgressLabel.vue.js";import a from"./ProgressValue.vue.js";import i from"./Progress.vue.js";export{i as SkdxProgress,r as SkdxProgressCircle,s as SkdxProgressCircleIndicator,o as SkdxProgressIndicator,e as SkdxProgressLabel,a as SkdxProgressValue};

package/dist/qr-code/QrCode.vue.d.cts

@@ -1,98 +1,47 @@
 import { type QrCodeErrorCorrection } from './context.cjs';
 /**
- * The Vue implementation of the shared QrCode contract (see `@skdx/shared`'s
- * `qrCodeContract`). Root of a QR code: encodes `value` once and hands the
- * resulting module matrix to `SkdxQrCodeFrame` / `SkdxQrCodePattern` /
- * `SkdxQrCodeOverlay` via `provide()`. Renders a `<div>` carrying
- * `--skdx-qr-code-size` — the module count, e.g. `29` — as an inline custom
- * property, so a consumer can size the symbol from CSS
- * (`width: calc(var(--skdx-qr-code-size) * 4px)`) without reading the version
- * back out in JavaScript.
+ * Root of a QR code: encodes `value` once and hands the resulting module matrix to `SkdxQrCodeFrame` / `SkdxQrCodePattern` / `SkdxQrCodeOverlay`.
  *
- * **The encode is a `computed` on `value` + `errorCorrection` + `version`.** A
- * QR encode is ~8 full passes over up to 177² modules for mask selection; doing
- * it on every render is the bug this component ships with everywhere.
- *
- * By default the root also renders `value` as visually hidden text: a QR code
- * is a dead end for anyone without a camera, and the payload is usually a URL
- * they would otherwise never reach.
- *
- * When `value` will not fit — over capacity, or a pinned `version` too small —
- * `encode-error` fires and the root renders **nothing**. A partial or clipped
- * symbol would scan to the wrong destination, which is worse than no symbol.
- *
- * @example
  * ```vue
- * <SkdxQrCode value="https://example.com" error-correction="H">
- *   <SkdxQrCodeFrame aria-label="Link to example.com">
- *     <SkdxQrCodePattern fill="currentColor" />
- *     <SkdxQrCodeOverlay :size="7">
- *       <image :href="logo" width="7" height="7" />
- *     </SkdxQrCodeOverlay>
- *   </SkdxQrCodeFrame>
+ * <SkdxQrCode value="https://example.com" error-correction="H" aria-label="Link to example.com">
+ *   <template #overlay><image :href="logo" width="7" height="7" /></template>
  * </SkdxQrCode>
  * ```
  */
 type __VLS_Props = {
-    /**
-     * The payload to encode — a URL, a phone number, a Wi-Fi credential string.
-     * Encoded as UTF-8 bytes, so any string is valid input; only its *length*
-     * can push the symbol past capacity.
-     */
+    /** The payload to encode — a URL, phone number, or Wi-Fi credential string — as UTF-8 bytes. */
     value: string;
     /**
-     * Error-correction level. Higher levels survive more damage, at the cost of
-     * a denser symbol for the same payload.
-     *
-     * **A logo overlay requires `'H'`, or the code stops scanning.** Anything
-     * painted over the centre destroys the modules underneath it, and only
-     * `'H'` carries enough redundancy (~30%) to reconstruct them.
-     * `SkdxQrCodeOverlay` does not raise the level for you — covering an `'M'`
-     * symbol produces a code that looks right and scans in your hand, then
-     * fails on a customer's older phone in poor light.
+     * Error-correction level; higher levels survive more damage at the cost of a denser symbol. A logo overlay requires `'H'`.
      * @default 'M'
      */
     errorCorrection?: QrCodeErrorCorrection;
     /**
-     * Force a symbol version (1–40), fixing the module count at
-     * `4 × version + 17`. Useful when a set of codes must all render at the
-     * same density.
-     *
-     * A version too small for `value` is an encode failure, not a silent
-     * upgrade — see the `encode-error` event.
+     * Forces a symbol version (1–40), fixing the module count at `4 × version + 17`.
      * @default undefined — the smallest version whose capacity fits `value`.
+     * @min 1
+     * @max 40
      */
     version?: number;
     /**
-     * Encoding mode. `'byte'` is the only value today; the prop exists so
-     * numeric, alphanumeric and Kanji modes can be added later without a
-     * breaking change.
-     * @default 'byte'
-     */
-    encoding?: 'byte';
-    /**
-     * Render `value` as visually hidden text inside the root, so a screen-reader
-     * user reaches the destination without a camera. A QR code is otherwise a
-     * dead end to anyone who cannot point a phone at it.
-     *
-     * Set to `false` only when you already render the value (or an equivalent
-     * link) yourself — otherwise it is announced twice.
+     * Visually hidden text inside the root, for screen-reader users without a camera; pass a string to override the rendered text.
      * @default true
      */
-    hiddenLabel?: boolean;
+    hiddenLabel?: boolean | string;
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Full manual composition — a Frame wrapping a Pattern and, optionally, an Overlay. */
+    default?(): unknown;
+    /** The derived Overlay's content — a logo drawn into its extent × extent box. */
+    overlay?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "encode-error": (error: Error) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onEncode-error"?: ((error: Error) => any) | undefined;
+    "onEncode-error"?: (error: Error) => any;
 }>, {
     errorCorrection: QrCodeErrorCorrection;
-    encoding: "byte";
-    hiddenLabel: boolean;
+    hiddenLabel: boolean | string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/qr-code/QrCode.vue.d.ts

@@ -1,98 +1,47 @@
 import { type QrCodeErrorCorrection } from './context.js';
 /**
- * The Vue implementation of the shared QrCode contract (see `@skdx/shared`'s
- * `qrCodeContract`). Root of a QR code: encodes `value` once and hands the
- * resulting module matrix to `SkdxQrCodeFrame` / `SkdxQrCodePattern` /
- * `SkdxQrCodeOverlay` via `provide()`. Renders a `<div>` carrying
- * `--skdx-qr-code-size` — the module count, e.g. `29` — as an inline custom
- * property, so a consumer can size the symbol from CSS
- * (`width: calc(var(--skdx-qr-code-size) * 4px)`) without reading the version
- * back out in JavaScript.
+ * Root of a QR code: encodes `value` once and hands the resulting module matrix to `SkdxQrCodeFrame` / `SkdxQrCodePattern` / `SkdxQrCodeOverlay`.
  *
- * **The encode is a `computed` on `value` + `errorCorrection` + `version`.** A
- * QR encode is ~8 full passes over up to 177² modules for mask selection; doing
- * it on every render is the bug this component ships with everywhere.
- *
- * By default the root also renders `value` as visually hidden text: a QR code
- * is a dead end for anyone without a camera, and the payload is usually a URL
- * they would otherwise never reach.
- *
- * When `value` will not fit — over capacity, or a pinned `version` too small —
- * `encode-error` fires and the root renders **nothing**. A partial or clipped
- * symbol would scan to the wrong destination, which is worse than no symbol.
- *
- * @example
  * ```vue
- * <SkdxQrCode value="https://example.com" error-correction="H">
- *   <SkdxQrCodeFrame aria-label="Link to example.com">
- *     <SkdxQrCodePattern fill="currentColor" />
- *     <SkdxQrCodeOverlay :size="7">
- *       <image :href="logo" width="7" height="7" />
- *     </SkdxQrCodeOverlay>
- *   </SkdxQrCodeFrame>
+ * <SkdxQrCode value="https://example.com" error-correction="H" aria-label="Link to example.com">
+ *   <template #overlay><image :href="logo" width="7" height="7" /></template>
  * </SkdxQrCode>
  * ```
  */
 type __VLS_Props = {
-    /**
-     * The payload to encode — a URL, a phone number, a Wi-Fi credential string.
-     * Encoded as UTF-8 bytes, so any string is valid input; only its *length*
-     * can push the symbol past capacity.
-     */
+    /** The payload to encode — a URL, phone number, or Wi-Fi credential string — as UTF-8 bytes. */
     value: string;
     /**
-     * Error-correction level. Higher levels survive more damage, at the cost of
-     * a denser symbol for the same payload.
-     *
-     * **A logo overlay requires `'H'`, or the code stops scanning.** Anything
-     * painted over the centre destroys the modules underneath it, and only
-     * `'H'` carries enough redundancy (~30%) to reconstruct them.
-     * `SkdxQrCodeOverlay` does not raise the level for you — covering an `'M'`
-     * symbol produces a code that looks right and scans in your hand, then
-     * fails on a customer's older phone in poor light.
+     * Error-correction level; higher levels survive more damage at the cost of a denser symbol. A logo overlay requires `'H'`.
      * @default 'M'
      */
     errorCorrection?: QrCodeErrorCorrection;
     /**
-     * Force a symbol version (1–40), fixing the module count at
-     * `4 × version + 17`. Useful when a set of codes must all render at the
-     * same density.
-     *
-     * A version too small for `value` is an encode failure, not a silent
-     * upgrade — see the `encode-error` event.
+     * Forces a symbol version (1–40), fixing the module count at `4 × version + 17`.
      * @default undefined — the smallest version whose capacity fits `value`.
+     * @min 1
+     * @max 40
      */
     version?: number;
     /**
-     * Encoding mode. `'byte'` is the only value today; the prop exists so
-     * numeric, alphanumeric and Kanji modes can be added later without a
-     * breaking change.
-     * @default 'byte'
-     */
-    encoding?: 'byte';
-    /**
-     * Render `value` as visually hidden text inside the root, so a screen-reader
-     * user reaches the destination without a camera. A QR code is otherwise a
-     * dead end to anyone who cannot point a phone at it.
-     *
-     * Set to `false` only when you already render the value (or an equivalent
-     * link) yourself — otherwise it is announced twice.
+     * Visually hidden text inside the root, for screen-reader users without a camera; pass a string to override the rendered text.
      * @default true
      */
-    hiddenLabel?: boolean;
+    hiddenLabel?: boolean | string;
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Full manual composition — a Frame wrapping a Pattern and, optionally, an Overlay. */
+    default?(): unknown;
+    /** The derived Overlay's content — a logo drawn into its extent × extent box. */
+    overlay?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "encode-error": (error: Error) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onEncode-error"?: ((error: Error) => any) | undefined;
+    "onEncode-error"?: (error: Error) => any;
 }>, {
     errorCorrection: QrCodeErrorCorrection;
-    encoding: "byte";
-    hiddenLabel: boolean;
+    hiddenLabel: boolean | string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/qr-code/QrCode.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const i=require("../utils/VisuallyHidden.vue.cjs"),s=require("./context.cjs"),v=require("./encoder.cjs");let e=require("vue");var m=(0,e.defineComponent)({__name:"QrCode",props:{value:{},errorCorrection:{default:"M"},version:{},encoding:{default:"byte"},hiddenLabel:{type:Boolean,default:!0}},emits:["encode-error"],setup(t,{emit:d}){const r=t,c=d,o=(0,e.computed)(()=>v.encodeQr(r.value,r.errorCorrection,r.version)),n=(0,e.computed)(()=>o.value?.length??0),u=(0,e.computed)(()=>({"--skdx-qr-code-size":n.value}));(0,e.provide)(s.QR_CODE_CONTEXT,{matrix:(0,e.computed)(()=>o.value??[]),size:n,value:(0,e.computed)(()=>r.value)});function a(){o.value===null&&c("encode-error",new Error(`[skandadx] QrCode cannot encode a ${r.value.length}-character value at error correction "${r.errorCorrection}"`+(r.version===void 0?" within version 40.":` at version ${r.version}.`)))}return(0,e.onMounted)(a),(0,e.watch)(()=>[r.value,r.errorCorrection,r.version],a),(l,p)=>o.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-qr-code","data-part":"root","data-skdx-component":"qr-code","data-skdx-qr-code":"",style:(0,e.normalizeStyle)(u.value)},[(0,e.renderSlot)(l.$slots,"default"),t.hiddenLabel?((0,e.openBlock)(),(0,e.createBlock)(i.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.value),1)]),_:1})):(0,e.createCommentVNode)("",!0)],4)):(0,e.createCommentVNode)("",!0)}});exports.default=m;
+const m=require("../utils/VisuallyHidden.vue.cjs"),y=require("../utils/qr-encoder.cjs"),p=require("./context.cjs"),C=require("./QrCodeAnatomy.vue.cjs");let e=require("vue");var b=(0,e.defineComponent)({__name:"QrCode",props:{value:{},errorCorrection:{default:"M"},version:{},hiddenLabel:{type:[Boolean,String],default:!0}},emits:["encode-error"],setup(o,{emit:i}){const r=o,u=i,l=(0,e.useAttrs)(),c=(0,e.computed)(()=>l["aria-label"]),s=(0,e.computed)(()=>l["aria-labelledby"]),t=(0,e.computed)(()=>y.encodeQr(r.value,r.errorCorrection,r.version)),n=(0,e.computed)(()=>t.value?.length??0),v=(0,e.computed)(()=>({"--skdx-qr-code-size":n.value}));(0,e.provide)(p.QR_CODE_CONTEXT,{matrix:(0,e.computed)(()=>t.value??[]),size:n,value:(0,e.computed)(()=>r.value),errorCorrection:(0,e.computed)(()=>r.errorCorrection)});function d(){t.value===null&&u("encode-error",new Error(`[skandadx] QrCode cannot encode a ${r.value.length}-character value at error correction "${r.errorCorrection}"`+(r.version===void 0?" within version 40.":` at version ${r.version}.`)))}return(0,e.onMounted)(d),(0,e.watch)(()=>[r.value,r.errorCorrection,r.version],d),(a,f)=>t.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-qr-code","data-part":"root","data-skdx-component":"qr-code",style:(0,e.normalizeStyle)(v.value)},[(0,e.renderSlot)(a.$slots,"default",{},()=>[(0,e.createVNode)(C.default,{"aria-label":c.value,"aria-labelledby":s.value},(0,e.createSlots)({_:2},[a.$slots.overlay?{name:"overlay",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"overlay")]),key:"0"}:void 0]),1032,["aria-label","aria-labelledby"])]),o.hiddenLabel!==!1?((0,e.openBlock)(),(0,e.createBlock)(m.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(o.hiddenLabel===!0?o.value:o.hiddenLabel),1)]),_:1})):(0,e.createCommentVNode)("",!0)],4)):(0,e.createCommentVNode)("",!0)}});exports.default=b;

package/dist/qr-code/QrCode.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import e from"../utils/VisuallyHidden.vue.js";import{QR_CODE_CONTEXT as r}from"./context.js";import{encodeQr as o}from"./encoder.js";import{computed as a,createBlock as t,createCommentVNode as n,createElementBlock as s,createTextVNode as d,defineComponent as l,normalizeStyle as i,onMounted as c,openBlock as u,provide as v,renderSlot as m,toDisplayString as p,watch as f,withCtx as C}from"vue";var k=/* @__PURE__ */l({__name:"QrCode",props:{value:{},errorCorrection:{default:"M"},version:{},encoding:{default:"byte"},hiddenLabel:{type:Boolean,default:!0}},emits:["encode-error"],setup(l,{emit:k}){const x=l,h=k,y=a(()=>o(x.value,x.errorCorrection,x.version)),_=a(()=>y.value?.length??0),g=a(()=>({"--skdx-qr-code-size":_.value}));function q(){null===y.value&&h("encode-error",/* @__PURE__ */new Error(`[skandadx] QrCode cannot encode a ${x.value.length}-character value at error correction "${x.errorCorrection}"`+(void 0===x.version?" within version 40.":` at version ${x.version}.`)))}return v(r,{matrix:a(()=>y.value??[]),size:_,value:a(()=>x.value)}),c(q),f(()=>[x.value,x.errorCorrection,x.version],q),(r,o)=>y.value?(u(),s("div",{key:0,class:"skdx-qr-code","data-part":"root","data-skdx-component":"qr-code","data-skdx-qr-code":"",style:i(g.value)},[m(r.$slots,"default"),l.hiddenLabel?(u(),t(e,{key:0},{default:C(()=>[d(p(l.value),1)]),_:1})):n("",!0)],4)):n("",!0)}});export{k as default};
+import e from"../utils/VisuallyHidden.vue.js";import{encodeQr as r}from"../utils/qr-encoder.js";import{QR_CODE_CONTEXT as a}from"./context.js";import o from"./QrCodeAnatomy.vue.js";import{computed as t,createBlock as l,createCommentVNode as s,createElementBlock as n,createSlots as i,createTextVNode as d,createVNode as c,defineComponent as u,normalizeStyle as v,onMounted as m,openBlock as p,provide as y,renderSlot as C,toDisplayString as b,useAttrs as f,watch as h,withCtx as k}from"vue";var x=/* @__PURE__ */u({__name:"QrCode",props:{value:{},errorCorrection:{default:"M"},version:{},hiddenLabel:{type:[Boolean,String],default:!0}},emits:["encode-error"],setup(u,{emit:x}){const $=u,_=x,Q=f(),S=t(()=>Q["aria-label"]),g=t(()=>Q["aria-labelledby"]),j=t(()=>r($.value,$.errorCorrection,$.version)),q=t(()=>j.value?.length??0),w=t(()=>({"--skdx-qr-code-size":q.value}));function B(){null===j.value&&_("encode-error",/* @__PURE__ */new Error(`[skandadx] QrCode cannot encode a ${$.value.length}-character value at error correction "${$.errorCorrection}"`+(void 0===$.version?" within version 40.":` at version ${$.version}.`)))}return y(a,{matrix:t(()=>j.value??[]),size:q,value:t(()=>$.value),errorCorrection:t(()=>$.errorCorrection)}),m(B),h(()=>[$.value,$.errorCorrection,$.version],B),(r,a)=>j.value?(p(),n("div",{key:0,class:"skdx-qr-code","data-part":"root","data-skdx-component":"qr-code",style:v(w.value)},[C(r.$slots,"default",{},()=>[c(o,{"aria-label":S.value,"aria-labelledby":g.value},i({_:2},[r.$slots.overlay?{name:"overlay",fn:k(()=>[C(r.$slots,"overlay")]),key:"0"}:void 0]),1032,["aria-label","aria-labelledby"])]),!1!==u.hiddenLabel?(p(),l(e,{key:0},{default:k(()=>[d(b(!0===u.hiddenLabel?u.value:u.hiddenLabel),1)]),_:1})):s("",!0)],4)):s("",!0)}});export{x as default};

package/dist/qr-code/QrCodeAnatomy.vue.cjs

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