@skdx/vue 0.28.0 → 0.29.0

package/dist/utils/dateValue.d.ts

@@ -1,76 +0,0 @@
-/**
- * Date type-crossing layer for Calendar, DateField, DatePicker, TimeField.
- * Accepts native `Date` or ISO-8601 string, emits `Date` shape, treats ISO
- * string as canonical for persistence (required for HTML attributes and
- * eventual `Temporal` migration). Copied identically across all five packages.
- *
- * @see `@skdx/shared`'s `contracts/date-value.ts`
- */
-import { type Granularity } from './dateSegments.js';
-/** Anything a date-shaped member accepts: the native object, or its ISO-8601 wire form. */
-export type DateInput = Date | string;
-/** A date range, structurally identical to Calendar's own `DateRange`. */
-export interface DateRangeLike {
-    start: Date;
-    end: Date | null;
-}
-/** What {@link toCalendarValue} produces — the `Date`-shaped selection every framework emits. */
-export type DateValue = Date | Date[] | DateRangeLike | null;
-/** How many dates a selection holds, deciding how a wire string widens. */
-export type SelectionModeLike = 'single' | 'multiple' | 'range';
-/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". Only needed by tests. */
-export declare function resetMalformedDateWarning(): void;
-/**
- * Reads a consumer-supplied value into a local `Date` or `null`. `Date` passes
- * through untouched (`Invalid Date` → `null`). Strings are parsed field-by-field
- * in local time (never via `new Date(string)`, which reads `YYYY-MM-DD` as UTC
- * and shifts the date west of Greenwich). Invalid shapes → `null` + dev warning.
- *
- * @param input a `Date`, an ISO-8601 string, or `null`/`undefined`
- * @param source the property it arrived on, named in the warning
- * @returns the local calendar date, or `null` when unreadable
- */
-export declare function toDate(input: DateInput | null | undefined, source?: string): Date | null;
-/**
- * The canonical ISO-8601 string for a date — what to persist and what `<form>` submits.
- * Uses local wall-clock fields (not `toISOString`, which would shift dates
- * across the date line for half the planet).
- *
- * @param date the local date to render
- * @param granularity how much of the time of day to include
- * @returns `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm[:ss]` past `day`
- */
-export declare function toISODateValue(date: Date, granularity?: Granularity): string;
-/**
- * Reads any authored selection shape into the canonical `DateValue`. Wire
- * string is self-describing: `2026-08-10` (single), `2026-08-10,2026-08-14`
- * (set), `2026-08-10/2026-08-14` or `2026-08-10/` (range). Only exception:
- * single-date `multiple` selection, widened via `mode`. `undefined` preserved
- * to distinguish controlled from uncontrolled.
- *
- * @param input the authored selection, in any accepted form
- * @param mode how many dates the selection holds
- * @param source the property it arrived on, named in the warning
- */
-export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
-    start: DateInput;
-    end?: DateInput | null;
-} | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
-/**
- * The canonical wire string for a selection — what `value` takes as an
- * attribute and what consumers persist.
- *
- * @param value a selection in the `Date` shape
- * @returns the string, or `null` when nothing is selected
- */
-export declare function toCalendarString(value: DateValue | undefined): string | null;
-/**
- * Reads a time of day from a 24-hour string or a `Date`'s local wall-clock time.
- * `Date` part is discarded (time of day is not an instant). Accepts `Date` to
- * avoid conversion overhead in DatePicker compositions.
- *
- * @param input a `HH:mm[:ss]` string, a `Date`, or `null`/`undefined`
- * @param source the property it arrived on, named in the warning
- * @returns the 24-hour string, or `null` when unreadable
- */
-export declare function toTimeValue(input: Date | string | null | undefined, source?: string): string | null;

package/dist/utils/dateValue.js

@@ -1 +0,0 @@
-import{isDevMode as t}from"./is-dev-mode.js";import{dateToFormValue as e,parseDateFormValue as n}from"./dateSegments.js";var r=/^(\d{4,})-(\d{2})$/,u=/^(\d{4,}-\d{2}-\d{2})/,l=!1;function i(e,n){l||(l=!0,t()&&console.warn(`[skdx] ${n?`\`${n}\``:"A date property"} was given ${JSON.stringify(e)}, which is not an ISO-8601 date. Expected \`YYYY-MM-DD\`, \`YYYY-MM-DDTHH:mm[:ss]\`, or a bare \`YYYY-MM\` for a month. The value is ignored — the property behaves as if it had not been supplied — rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function a(t,e){if(null==t)return null;if(t instanceof Date)return Number.isNaN(t.getTime())?null:t;if("string"!=typeof t)return null;const l=t.trim();if(""===l)return null;const a=n(l);if(null!==a){const t=u.exec(l)?.[1];return void 0!==t&&o(a)!==t?(i(l,e),null):a}const s=r.exec(l);if(s){const t=Number(s[2])-1;if(t>=0&&t<=11){const e=Number(s[1]),n=new Date(e,t,1);if(e<100&&n.setFullYear(e),!Number.isNaN(n.getTime()))return n}}return i(l,e),null}function o(t,n="day"){return e(t,n)}function s(t,e,n){if(void 0===t)return;if(null===t)return"multiple"===e?[]:null;if("string"==typeof t)return f(function(t,e){const n=t.trim();if(""===n)return null;if(n.includes("/")){const[t="",r=""]=n.split("/"),u=a(t,e);return null===u?null:{start:u,end:""===r?null:a(r,e)}}return n.includes(",")?n.split(",").map(t=>a(t,e)).filter(t=>null!==t):a(n,e)}(t,n),e);if(Array.isArray(t))return f(t.map(t=>a(t,n)).filter(t=>null!==t),e);if(t instanceof Date)return f(a(t,n),e);const r=t,u=a(r.start,n);return null===u?"multiple"===e?[]:null:{start:u,end:a(r.end,n)}}function f(t,e){return"multiple"!==e?t:null===t?[]:Array.isArray(t)?t:t instanceof Date?[t]:[]}function d(t){return null==t?null:Array.isArray(t)?0===t.length?null:t.map(t=>o(t)).join(","):t instanceof Date?o(t):`${o(t.start)}/${null===t.end?"":o(t.end)}`}var c=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function m(t,e){if(null==t)return null;if(t instanceof Date){if(Number.isNaN(t.getTime()))return null;const e=t=>String(t).padStart(2,"0"),n=t.getSeconds(),r=`${e(t.getHours())}:${e(t.getMinutes())}`;return 0===n?r:`${r}:${e(n)}`}if("string"!=typeof t)return null;const n=t.trim();if(""===n)return null;const r=c.exec(n);return!r||Number(r[1])>23||Number(r[2])>59||void 0!==r[3]&&Number(r[3])>59?(i(n,e),null):n}export{d as toCalendarString,s as toCalendarValue,a as toDate,o as toISODateValue,m as toTimeValue};

package/dist/utils/is-dev-mode.cjs

@@ -1 +0,0 @@
-function e(){return!1}exports.isDevMode=e;

package/dist/utils/is-dev-mode.d.cts

@@ -1,6 +0,0 @@
-/**
- * Development-mode guard. Detects via `import.meta.env.DEV`, a Vite built-in.
- * @returns `true` in development, `false` in production.
- * @internal
- */
-export declare function isDevMode(): boolean;

package/dist/utils/is-dev-mode.d.ts

@@ -1,6 +0,0 @@
-/**
- * Development-mode guard. Detects via `import.meta.env.DEV`, a Vite built-in.
- * @returns `true` in development, `false` in production.
- * @internal
- */
-export declare function isDevMode(): boolean;

package/dist/utils/is-dev-mode.js

@@ -1 +0,0 @@
-function e(){return!1}export{e as isDevMode};

package/dist/utils/useSelection.cjs

@@ -1 +0,0 @@
-const s=require("./is-dev-mode.cjs");function u(){try{const e=process.env.NODE_ENV;return e!==void 0&&e!=="production"}catch{return!1}}function i(e){if(u())throw new RangeError(e);s.isDevMode()&&console.error(e)}function c(e,{multiple:n,label:r}){const l=Array.isArray(e)?e:e==null?[]:[e],t=[];for(const o of l){if(typeof o!="string"){i(`[skdx] ${r}: a selection value must be a string, got ${o===null?"null":typeof o} (${JSON.stringify(o)}). If this is a change payload, read its \`value\` — the event carries { value, selectedValue } and only \`value\` goes back in.`);continue}o!==""&&t.push(o)}return n||t.length<=1?t:(i(`[skdx] ${r}: a single-selection control was given ${t.length} values (${t.join(", ")}). Only one can be held — pass a single value, or turn the control multiple. Set multiple (or type="multiple") to keep them all.`),[t[0]])}function a(e){return e.length>0?e[0]:null}function f(e,n,r,l=!1){return r?e.includes(n)?e.filter(t=>t!==n):[...e,n]:l&&e.length===1&&e[0]===n?[]:[n]}function g(e,n){return e.length===n.length&&e.every((r,l)=>r===n[l])}exports.nextSelection=f;exports.sameSelection=g;exports.selectedValueOf=a;exports.toSelectionValues=c;

package/dist/utils/useSelection.d.cts

@@ -1,68 +0,0 @@
-/**
- * Normalizes every selected value to an array. Lenient in for backward compat
- * (Calendar and Transfer); superseded by {@link toSelectionValues} elsewhere.
- */
-export declare function toValues(value: string | string[] | undefined): string[];
-/** The payload every single-or-many control's change event carries — the strict-out shape. */
-export interface SelectionChangeDetail {
-    /** The whole selection, always an array, in single and multiple mode alike. */
-    value: string[];
-    /** The first selected value, or `null` when nothing is selected. */
-    selectedValue: string | null;
-}
-/** Options {@link toSelectionValues} needs to apply the single-selection rule. */
-export interface SelectionValueOptions {
-    /**
-     * Whether the control may hold more than one value at once — `multiple`, or
-     * `type === 'multiple'` on the families that spell it that way.
-     */
-    multiple: boolean;
-    /**
-     * The component and member named in the development error, for example
-     * `Select value` — the message has to say which of a page's selects is
-     * wrong, and a bare stack trace through a normalizer does not.
-     */
-    label: string;
-}
-/**
- * Normalizes every selection value to `string[]`, enforcing the single-selection
- * rule. Called once at the boundary (`value`/`defaultValue` arrival), never
- * again downstream. `undefined`, `null`, `''`, and `[]` all normalize to `[]`.
- * Empty array entries are dropped (silent data corruption otherwise). Rejects
- * non-string entries and multiple values on single-selection controls.
- *
- * @param input the value the consumer supplied, in any accepted shape
- * @param options cardinality and label for errors — see {@link SelectionValueOptions}
- * @returns the selection as an array; at most one element unless `multiple`
- * @throws RangeError in development when entry is not a string or single-select gets multiple values
- */
-export declare function toSelectionValues(input: string | readonly string[] | null | undefined, { multiple, label }: SelectionValueOptions): string[];
-/**
- * The `selectedValue` half of the rule's output: the first selected value,
- * or `null` (not `undefined` or `''`). Pinned here to prevent drift across five implementations.
- *
- * @param values the normalized selection, as {@link toSelectionValues} returns it
- * @returns the first selected value, or `null` when nothing is selected
- */
-export declare function selectedValueOf(values: readonly string[]): string | null;
-/**
- * The new selection after choosing `value`: replaces it, or toggles it within
- * the set when `multiple`. Always returns an array (strict-out rule).
- *
- * @param selected the current selection, already normalized
- * @param value the option value the user committed
- * @param multiple whether choosing toggles within a set rather than replacing
- * @param deselectable whether re-choosing the only selected value clears it (single-select only)
- * @returns the new selection as an array in both cardinalities
- */
-export declare function nextSelection(selected: readonly string[], value: string, multiple: boolean, deselectable?: boolean): string[];
-/**
- * Whether two selections hold the same values in order. Gates spurious changes:
- * normalized arrays are never `===` their previous value, so this prevents
- * false positives in "did this change?" guards without reference comparison.
- *
- * @param a one normalized selection
- * @param b the selection to compare it against
- * @returns whether the two selections are identical
- */
-export declare function sameSelection(a: readonly string[], b: readonly string[]): boolean;

package/dist/utils/useSelection.d.ts

@@ -1,68 +0,0 @@
-/**
- * Normalizes every selected value to an array. Lenient in for backward compat
- * (Calendar and Transfer); superseded by {@link toSelectionValues} elsewhere.
- */
-export declare function toValues(value: string | string[] | undefined): string[];
-/** The payload every single-or-many control's change event carries — the strict-out shape. */
-export interface SelectionChangeDetail {
-    /** The whole selection, always an array, in single and multiple mode alike. */
-    value: string[];
-    /** The first selected value, or `null` when nothing is selected. */
-    selectedValue: string | null;
-}
-/** Options {@link toSelectionValues} needs to apply the single-selection rule. */
-export interface SelectionValueOptions {
-    /**
-     * Whether the control may hold more than one value at once — `multiple`, or
-     * `type === 'multiple'` on the families that spell it that way.
-     */
-    multiple: boolean;
-    /**
-     * The component and member named in the development error, for example
-     * `Select value` — the message has to say which of a page's selects is
-     * wrong, and a bare stack trace through a normalizer does not.
-     */
-    label: string;
-}
-/**
- * Normalizes every selection value to `string[]`, enforcing the single-selection
- * rule. Called once at the boundary (`value`/`defaultValue` arrival), never
- * again downstream. `undefined`, `null`, `''`, and `[]` all normalize to `[]`.
- * Empty array entries are dropped (silent data corruption otherwise). Rejects
- * non-string entries and multiple values on single-selection controls.
- *
- * @param input the value the consumer supplied, in any accepted shape
- * @param options cardinality and label for errors — see {@link SelectionValueOptions}
- * @returns the selection as an array; at most one element unless `multiple`
- * @throws RangeError in development when entry is not a string or single-select gets multiple values
- */
-export declare function toSelectionValues(input: string | readonly string[] | null | undefined, { multiple, label }: SelectionValueOptions): string[];
-/**
- * The `selectedValue` half of the rule's output: the first selected value,
- * or `null` (not `undefined` or `''`). Pinned here to prevent drift across five implementations.
- *
- * @param values the normalized selection, as {@link toSelectionValues} returns it
- * @returns the first selected value, or `null` when nothing is selected
- */
-export declare function selectedValueOf(values: readonly string[]): string | null;
-/**
- * The new selection after choosing `value`: replaces it, or toggles it within
- * the set when `multiple`. Always returns an array (strict-out rule).
- *
- * @param selected the current selection, already normalized
- * @param value the option value the user committed
- * @param multiple whether choosing toggles within a set rather than replacing
- * @param deselectable whether re-choosing the only selected value clears it (single-select only)
- * @returns the new selection as an array in both cardinalities
- */
-export declare function nextSelection(selected: readonly string[], value: string, multiple: boolean, deselectable?: boolean): string[];
-/**
- * Whether two selections hold the same values in order. Gates spurious changes:
- * normalized arrays are never `===` their previous value, so this prevents
- * false positives in "did this change?" guards without reference comparison.
- *
- * @param a one normalized selection
- * @param b the selection to compare it against
- * @returns whether the two selections are identical
- */
-export declare function sameSelection(a: readonly string[], b: readonly string[]): boolean;

package/dist/utils/useSelection.js

@@ -1 +0,0 @@
-import{isDevMode as e}from"./is-dev-mode.js";function n(n){if(function(){try{const e=process.env.NODE_ENV;return void 0!==e&&"production"!==e}catch{return!1}}())throw new RangeError(n);e()&&console.error(n)}function t(e,{multiple:t,label:l}){const o=Array.isArray(e)?e:null==e?[]:[e],r=[];for(const e of o)"string"==typeof e?""!==e&&r.push(e):n(`[skdx] ${l}: a selection value must be a string, got ${null===e?"null":typeof e} (${JSON.stringify(e)}). If this is a change payload, read its \`value\` — the event carries { value, selectedValue } and only \`value\` goes back in.`);return t||r.length<=1?r:(n(`[skdx] ${l}: a single-selection control was given ${r.length} values (${r.join(", ")}). Only one can be held — pass a single value, or turn the control multiple. Set multiple (or type="multiple") to keep them all.`),[r[0]])}function l(e){return e.length>0?e[0]:null}function o(e,n,t,l=!1){return t?e.includes(n)?e.filter(e=>e!==n):[...e,n]:l&&1===e.length&&e[0]===n?[]:[n]}function r(e,n){return e.length===n.length&&e.every((e,t)=>e===n[t])}export{o as nextSelection,r as sameSelection,l as selectedValueOf,t as toSelectionValues};