vectis-ui 0.8.1 → 0.9.1

package/dist/utils/time.js

@@ -1,44 +1,26 @@
-import { digitsOf as e, pad2 as t } from "./text.js";
-import { memo as n } from "./memo.js";
+import { pad2 as e } from "./text.js";
+import { memo as t } from "./memo.js";
 //#region src/utils/time.ts
-var r = /^([01]\d|2[0-3]):([0-5]\d)$/;
-function i(e) {
-	return typeof e == "string" && r.test(e);
+var n = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function r(e) {
+	return typeof e == "string" && n.test(e);
 }
-function a(e) {
-	if (!i(e)) return null;
+function i(e) {
+	if (!r(e)) return null;
 	let [t, n] = e.split(":");
 	return {
 		hour: Number(t),
 		minute: Number(n)
 	};
 }
-function o(e, n) {
-	return `${t(e)}:${t(n)}`;
+function a(t, n) {
+	return `${e(t)}:${e(n)}`;
 }
+var o = /* @__PURE__ */ new Map();
 function s(e) {
-	let t = e >= 12 ? "PM" : "AM";
-	return {
-		hour: e % 12 == 0 ? 12 : e % 12,
-		meridiem: t
-	};
-}
-function c(e, t) {
-	let n = e % 12;
-	return t === "PM" ? n + 12 : n;
-}
-function l(e, t) {
-	return c(s(e).hour, t);
+	return t(o, e, () => c(e));
 }
-function u(e, t) {
-	let n = a(e);
-	return n ? o(l(n.hour, t), n.minute) : null;
-}
-var d = /* @__PURE__ */ new Map();
-function f(e) {
-	return n(d, e, () => p(e));
-}
-function p(e) {
+function c(e) {
 	try {
 		let { hourCycle: t } = new Intl.DateTimeFormat(e, { hour: "numeric" }).resolvedOptions();
 		return t === "h11" || t === "h12" ? "12h" : "24h";
@@ -46,82 +28,24 @@ function p(e) {
 		return "24h";
 	}
 }
-var m = /* @__PURE__ */ new Map();
-function h(e, t) {
-	return n(m, `${e}|${t}`, () => new Intl.DateTimeFormat(e, {
+var l = /* @__PURE__ */ new Map();
+function u(e, n) {
+	return t(l, `${e}|${n}`, () => new Intl.DateTimeFormat(e, {
 		hour: "numeric",
 		minute: "2-digit",
-		hourCycle: t === "12h" ? "h12" : "h23",
+		...n === "12h" ? { hour12: !0 } : { hourCycle: "h23" },
 		timeZone: "UTC"
 	}));
 }
-function g(e, t, n) {
-	let r = a(e);
-	return r ? h(t, n).format(Date.UTC(2021, 0, 1, r.hour, r.minute)) : "";
-}
-function _(e, t) {
-	return ((t <= 1 ? Math.round(e) : Math.round(e / t) * t) % 60 + 60) % 60;
-}
-function v(e, t, n) {
-	let r = (Math.atan2(e, -t) / (2 * Math.PI) + 1) % 1;
-	return Math.round(r * n) % n;
+function d(e, t, n) {
+	let r = i(e);
+	return r ? u(t, n).format(Date.UTC(2021, 0, 1, r.hour, r.minute)) : "";
 }
-function y(e, t, n) {
-	return n > 0 ? Math.hypot(e, t) / n : 0;
-}
-var b = .625;
-function x(e, t) {
-	return t === "outer" ? e === 0 ? 12 : e : e === 0 ? 0 : e + 12;
-}
-function S(e) {
-	return e === 0 ? {
-		index: 0,
-		ring: "inner"
-	} : e === 12 ? {
-		index: 0,
-		ring: "outer"
-	} : e > 12 ? {
-		index: e - 12,
-		ring: "inner"
-	} : {
-		index: e,
-		ring: "outer"
-	};
-}
-function C(e) {
-	let t = a(e);
+function f(e) {
+	let t = i(e);
 	return t ? t.hour * 60 + t.minute : null;
 }
-function w(e, t, n) {
-	let r = Number.isInteger(e) && e >= 1 && e <= 60 ? e : 60, i = [];
-	for (let e = 0; e < 1440; e += r) {
-		let r = o(Math.floor(e / 60), e % 60);
-		i.push({
-			value: r,
-			label: g(r, t, n)
-		});
-	}
-	return i;
-}
-var T = ":";
-function E(t) {
-	let n = e(t).slice(0, 4);
-	return n.length >= 2 ? `${n.slice(0, 2)}${T}${n.slice(2)}` : n;
-}
-function D(e, t = !1) {
-	return e < 2 ? e : e === 2 ? t ? 3 : 2 : Math.min(e + 1, 5);
-}
-function O(e, n) {
-	let r = a(e);
-	return r ? E(t(n === "12h" ? s(r.hour).hour : r.hour) + t(r.minute)) : "";
-}
-function k(t, n, r = "AM") {
-	let i = e(t);
-	if (i.length !== 4) return null;
-	let a = Number(i.slice(0, 2)), s = Number(i.slice(2));
-	return s > 59 ? null : n === "12h" ? a >= 1 && a <= 12 ? o(c(a, r), s) : null : a <= 23 ? o(a, s) : null;
-}
 //#endregion
-export { b as DIAL_INNER_THRESHOLD, v as angleToIndex, x as dialIndexToHour24, y as distanceFraction, o as formatTime, g as formatTimeDisplay, E as formatTimeMask, S as hour24ToDial, f as hourCycleFor, l as hourWithMeridiem, i as isValidTime, C as minutesOf, a as parseTime, k as parseTimeMask, _ as snapMinute, D as timeCaret, w as timeList, O as timeToMask, s as to12h, c as to24h, u as withMeridiem };
+export { a as formatTime, d as formatTimeDisplay, s as hourCycleFor, r as isValidTime, f as minutesOf, i as parseTime };
 
 //# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -1 +1 @@
-{"version":3,"file":"time.js","names":[],"sources":["../../src/utils/time.ts"],"sourcesContent":["// @ssr @core — module-wide: every export below is @core unless tagged otherwise.\n/**\n * The TIME domain behind VTimePicker and VTimeInput. Pure: nothing here draws or touches\n * the page, and the same numbers always give the same answer.\n *\n * A time is always the canonical 24-hour string `'HH:mm'`, whatever is being SHOWN — a\n * picker displaying \"7:05 PM\" still holds `'19:05'`. That is what keeps the value a\n * consumer receives independent of the reader's locale.\n *\n * `Intl` is asked on UTC reference instants only, so nothing depends on the host clock and\n * the server render agrees with the browser's.\n *\n * The dial's geometry lives here too, and for a practical reason: jsdom lays nothing out and\n * measures every element at zero, so a calculation kept inside the component is untestable.\n */\nimport { memo } from './memo'\nimport { digitsOf, pad2 } from './text'\n\nexport type HourFormat = '12h' | '24h'\nexport type Meridiem = 'AM' | 'PM'\n\nexport interface TimeParts {\n  /** The hour on the 24-hour clock, from 0 to 23. */\n  hour: number\n  minute: number\n}\n\nconst TIME_RE = /^([01]\\d|2[0-3]):([0-5]\\d)$/\n\n/** Whether something is a time in the canonical form — two digits, a colon, two digits. */\nexport function isValidTime(value: unknown): value is string {\n  return typeof value === 'string' && TIME_RE.test(value)\n}\n\n/** Reads a canonical time into its two numbers, or nothing at all if it is not one. */\nexport function parseTime(value: string | null | undefined): TimeParts | null {\n  if (!isValidTime(value)) return null\n  const [h, m] = value.split(':')\n  return { hour: Number(h), minute: Number(m) }\n}\n\n/** Writes an hour and a minute back into the canonical form, both on two digits. */\nexport function formatTime(hour: number, minute: number): string {\n  return `${pad2(hour)}:${pad2(minute)}`\n}\n\n/**\n * Turns an hour of the 24-hour clock into the hour a 12-hour clock face shows, together\n * with which half of the day it belongs to: midnight is 12 AM, noon is 12 PM, and eleven\n * at night is 11 PM.\n */\nexport function to12h(hour24: number): { hour: number; meridiem: Meridiem } {\n  const meridiem: Meridiem = hour24 >= 12 ? 'PM' : 'AM'\n  const hour = hour24 % 12 === 0 ? 12 : hour24 % 12\n  return { hour, meridiem }\n}\n\n/**\n * The way back: an hour read off a 12-hour clock face, plus the half of the day it is in,\n * gives the hour on the 24-hour clock — 12 in the morning is 0, 12 in the afternoon is 12.\n */\nexport function to24h(hour12: number, meridiem: Meridiem): number {\n  const base = hour12 % 12 // Twelve is the zero of the cycle, not its top.\n  return meridiem === 'PM' ? base + 12 : base\n}\n\n/**\n * The same hour moved into the other half of the day, or left where it is: 9 with PM gives\n * 21, and 21 with PM stays 21. It is what an AM/PM control does to the hour it qualifies.\n */\nexport function hourWithMeridiem(hour24: number, meridiem: Meridiem): number {\n  return to24h(to12h(hour24).hour, meridiem)\n}\n\n/**\n * A canonical time moved into a half of the day, its minutes untouched, or `null` when it is\n * not a time at all: `'09:30'` with PM gives `'21:30'`.\n */\nexport function withMeridiem(time: string | null | undefined, meridiem: Meridiem): string | null {\n  const parts = parseTime(time)\n  return parts ? formatTime(hourWithMeridiem(parts.hour, meridiem), parts.minute) : null\n}\n\nconst hourCycleCache = new Map<string, HourFormat>()\n\n// @fallback\n/**\n * Whether a language counts the hours to twelve, with a morning and an afternoon, or\n * straight to twenty-four. It is the browser that knows, and it is asked.\n *\n * A language tag it cannot make sense of falls back to the 24-hour clock rather than\n * failing.\n */\nexport function hourCycleFor(locale: string): HourFormat {\n  return memo(hourCycleCache, locale, () => resolveHourCycle(locale))\n}\n\nfunction resolveHourCycle(locale: string): HourFormat {\n  try {\n    const { hourCycle } = new Intl.DateTimeFormat(locale, { hour: 'numeric' }).resolvedOptions()\n    return hourCycle === 'h11' || hourCycle === 'h12' ? '12h' : '24h'\n  } catch {\n    return '24h'\n  }\n}\n\n/**\n * One formatter per locale and clock, module-lived — the `formatterFor` idiom of `file.ts`.\n *\n * Construction costs one to two orders of magnitude more than use, and `timeList` formats\n * ONE VALUE AT A TIME: 1440 entries at one-minute steps, so 1440 constructions per rebuild.\n * Measured at ~82 ms against ~2 ms memoized. The clock is part of the key because it is\n * imposed below rather than following from the locale.\n */\nconst displayFormatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction displayFormatterFor(locale: string, format: HourFormat): Intl.DateTimeFormat {\n  return memo(\n    displayFormatters,\n    `${locale}|${format}`,\n    () =>\n      new Intl.DateTimeFormat(locale, {\n        hour: 'numeric',\n        minute: '2-digit',\n        hourCycle: format === '12h' ? 'h12' : 'h23',\n        timeZone: 'UTC',\n      }),\n  )\n}\n\n/**\n * A time written out for a reader: \"19:05\", or \"7:05 PM\".\n *\n * `hourCycle` is imposed rather than left to `Intl`, so the text follows what the component\n * settled on: a consumer asking for a 24-hour clock in a locale that would choose otherwise\n * must get theirs.\n */\nexport function formatTimeDisplay(time: string, locale: string, format: HourFormat): string {\n  const parts = parseTime(time)\n  if (!parts) return ''\n  return displayFormatterFor(locale, format).format(Date.UTC(2021, 0, 1, parts.hour, parts.minute))\n}\n\n/**\n * Snaps a minute to the nearest allowed step and wraps it back inside the hour.\n *\n * Both ends need the wrap: 58 snapped to five-minute steps lands on 60, which is 0, and\n * stepping back from 0 with the keyboard passes through -1, which is 59.\n */\nexport function snapMinute(minute: number, step: number): number {\n  const snapped = step <= 1 ? Math.round(minute) : Math.round(minute / step) * step\n  return ((snapped % 60) + 60) % 60\n}\n\n/**\n * Which mark a pointer offset from the dial's centre is aiming at. Marks are numbered\n * clockwise from twelve o'clock and the nearest wins. `dy` is negated because screen\n * coordinates grow DOWNWARD and the angle is measured from the top.\n */\nexport function angleToIndex(dx: number, dy: number, segments: number): number {\n  // The angle from twelve o'clock, clockwise-positive, as a fraction of a full turn.\n  const angle = Math.atan2(dx, -dy)\n  const turn = (angle / (2 * Math.PI) + 1) % 1\n  return Math.round(turn * segments) % segments\n}\n\n/** How far from the centre a finger landed, as a fraction: nothing at the centre, one at the edge. */\nexport function distanceFraction(dx: number, dy: number, radius: number): number {\n  return radius > 0 ? Math.hypot(dx, dy) / radius : 0\n}\n\n/**\n * How close to the centre a pointer must land to be aiming at the INNER ring, the one\n * holding the small hours of a 24-hour dial: the halfway mark between the two rings.\n *\n * TRAP — the number is DERIVED from the dial tokens. A 256px dial with 48px numerals puts\n * the rings' centres at 104px and 56px from the middle, whose midpoint is 0.625 of the\n * radius. Change either token without changing this and the threshold no longer separates\n * the two rings: a tap near the boundary quietly sets the wrong hour.\n */\nexport const DIAL_INNER_THRESHOLD = 0.625\n\n/**\n * Which hour a mark stands for on the two-ring dial: outer carries 12 then 1-11, inner\n * carries 00 then 13-23. Index 0 of each is the mark at twelve o'clock.\n */\nexport function dialIndexToHour24(index: number, ring: 'outer' | 'inner'): number {\n  if (ring === 'outer') return index === 0 ? 12 : index\n  return index === 0 ? 0 : index + 12\n}\n\n/** The way back, which is what tells the hand where to point. */\nexport function hour24ToDial(hour: number): { index: number; ring: 'outer' | 'inner' } {\n  if (hour === 0) return { index: 0, ring: 'inner' }\n  if (hour === 12) return { index: 0, ring: 'outer' }\n  if (hour > 12) return { index: hour - 12, ring: 'inner' }\n  return { index: hour, ring: 'outer' }\n}\n\nexport interface TimeOption {\n  /** The canonical time, which is what the component's value will be set to. */\n  value: string\n  /** The same time written out for the reader: \"07:30\", or \"7:30 AM\". */\n  label: string\n}\n\n/** A time as minutes since midnight, `null` if it is not one — its position in a list. */\nexport function minutesOf(time: string | null | undefined): number | null {\n  const parts = parseTime(time)\n  return parts ? parts.hour * 60 + parts.minute : null\n}\n\n/**\n * Every time of the day at a given interval, midnight to the last one before the next.\n *\n * There is deliberately no earliest or latest, VTimePicker having none: do not invent one.\n * A nonsensical step — zero, a fraction, more than an hour — falls back to hourly, so the\n * list stays FINITE even when the component's warning about it was ignored.\n */\nexport function timeList(step: number, locale: string, format: HourFormat): TimeOption[] {\n  const safe = Number.isInteger(step) && step >= 1 && step <= 60 ? step : 60\n  const out: TimeOption[] = []\n  for (let m = 0; m < 24 * 60; m += safe) {\n    const value = formatTime(Math.floor(m / 60), m % 60)\n    out.push({ value, label: formatTimeDisplay(value, locale, format) })\n  }\n  return out\n}\n\n/*\n * Unlike a date's separator this one is UNIVERSAL: every language writes a time with a\n * colon, and only the 12/24-hour cycle varies. It therefore stays out of the dictionary,\n * where the empty field's `hh:mm` placeholder does belong — that one is made of the\n * initials of words.\n */\nconst TIME_SEPARATOR = ':'\n\n/**\n * Lays a run of typed digits out as a time. The colon appears AS SOON AS the hour is\n * complete — typing \"09\" already gives \"09:\" — exactly as a date's separators do.\n */\nexport function formatTimeMask(digits: string): string {\n  const all = digitsOf(digits).slice(0, 4)\n  return all.length >= 2 ? `${all.slice(0, 2)}${TIME_SEPARATOR}${all.slice(2)}` : all\n}\n\n/**\n * Where the caret belongs to sit just after `n` digits. A closed formula rather than\n * `date.ts`'s scan, the colon always being in the same place.\n *\n * `skipSeparator` means something was INSERTED, and the caret then steps over the colon\n * into the minutes. On a DELETION it stays in front of it, or the next Backspace steps\n * over the colon instead of erasing a digit and the key appears to do nothing.\n */\nexport function timeCaret(n: number, skipSeparator = false): number {\n  if (n < 2) return n\n  if (n === 2) return skipSeparator ? 3 : 2\n  return Math.min(n + 1, 5)\n}\n\n/**\n * A canonical time written into the field in whichever form is SHOWN. On a 12-hour clock the\n * hour comes back into 1-12: the meridiem belongs to the toggle beside the field, never to\n * the text.\n */\nexport function timeToMask(time: string | null | undefined, format: HourFormat): string {\n  const parts = parseTime(time)\n  if (!parts) return ''\n  const hour = format === '12h' ? to12h(parts.hour).hour : parts.hour\n  return formatTimeMask(pad2(hour) + pad2(parts.minute))\n}\n\n/**\n * What was typed read back into a canonical time, or `null` when it is incomplete, too long\n * or not a real time. On a 12-hour clock this is the ONE place the typed digits and the\n * meridiem toggle meet.\n */\nexport function parseTimeMask(\n  text: string,\n  format: HourFormat,\n  meridiem: Meridiem = 'AM',\n): string | null {\n  const digits = digitsOf(text)\n  if (digits.length !== 4) return null\n  const hour = Number(digits.slice(0, 2))\n  const minute = Number(digits.slice(2))\n  if (minute > 59) return null\n  if (format === '12h')\n    return hour >= 1 && hour <= 12 ? formatTime(to24h(hour, meridiem), minute) : null\n  return hour <= 23 ? formatTime(hour, minute) : null\n}\n"],"mappings":"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"}
+{"version":3,"file":"time.js","names":[],"sources":["../../src/utils/time.ts"],"sourcesContent":["// @ssr @core — module-wide: every export below is @core unless tagged otherwise.\n/**\n * The TIME domain every component that shows a time shares: VTimePicker, VTimeInput and the\n * VCalendar views. Pure: nothing here draws or touches the page, and the same numbers always\n * give the same answer.\n *\n * TRAP — what only the clock and the field need lives in `./clock`, not here. This module\n * is in the import closure of every VCalendar component (`minutesOf`, `hourCycleFor`,\n * `formatTimeDisplay`), and anything added to it is paid by each of them: the dial, the\n * AM/PM arithmetic, the typing mask and the list of times weighed some 600 B gzip on\n * `VCalendarYear`, which shows no time at all.\n *\n * A time is always the canonical 24-hour string `'HH:mm'`, whatever is being SHOWN — a\n * picker displaying \"7:05 PM\" still holds `'19:05'`. That is what keeps the value a\n * consumer receives independent of the reader's locale.\n *\n * `Intl` is asked on UTC reference instants only, so nothing depends on the host clock and\n * the server render agrees with the browser's.\n */\nimport { memo } from './memo'\nimport { pad2 } from './text'\n\nexport type HourFormat = '12h' | '24h'\nexport type Meridiem = 'AM' | 'PM'\n\nexport interface TimeParts {\n  /** The hour on the 24-hour clock, from 0 to 23. */\n  hour: number\n  minute: number\n}\n\nconst TIME_RE = /^([01]\\d|2[0-3]):([0-5]\\d)$/\n\n/** Whether something is a time in the canonical form: two digits, a colon, two digits. */\nexport function isValidTime(value: unknown): value is string {\n  return typeof value === 'string' && TIME_RE.test(value)\n}\n\n/** Reads a canonical time into its two numbers, or nothing at all if it is not one. */\nexport function parseTime(value: string | null | undefined): TimeParts | null {\n  if (!isValidTime(value)) return null\n  const [h, m] = value.split(':')\n  return { hour: Number(h), minute: Number(m) }\n}\n\n/** Writes an hour and a minute back into the canonical form, both on two digits. */\nexport function formatTime(hour: number, minute: number): string {\n  return `${pad2(hour)}:${pad2(minute)}`\n}\n\nconst hourCycleCache = new Map<string, HourFormat>()\n\n// @fallback\n/**\n * Whether a language counts the hours to twelve, with a morning and an afternoon, or\n * straight to twenty-four. It is the browser that knows, and it is asked.\n *\n * A language tag it cannot make sense of falls back to the 24-hour clock rather than\n * failing.\n */\nexport function hourCycleFor(locale: string): HourFormat {\n  return memo(hourCycleCache, locale, () => resolveHourCycle(locale))\n}\n\nfunction resolveHourCycle(locale: string): HourFormat {\n  try {\n    const { hourCycle } = new Intl.DateTimeFormat(locale, { hour: 'numeric' }).resolvedOptions()\n    return hourCycle === 'h11' || hourCycle === 'h12' ? '12h' : '24h'\n  } catch {\n    return '24h'\n  }\n}\n\n/**\n * One formatter per locale and clock, module-lived — the `formatterFor` idiom of `file.ts`.\n *\n * Construction costs one to two orders of magnitude more than use, and `timeList` formats\n * ONE VALUE AT A TIME: 1440 entries at one-minute steps, so 1440 constructions per rebuild.\n * Measured at ~82 ms against ~2 ms memoized. The clock is part of the key because it is\n * imposed below rather than following from the locale.\n */\nconst displayFormatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction displayFormatterFor(locale: string, format: HourFormat): Intl.DateTimeFormat {\n  return memo(\n    displayFormatters,\n    `${locale}|${format}`,\n    () =>\n      new Intl.DateTimeFormat(locale, {\n        hour: 'numeric',\n        minute: '2-digit',\n        // A 12-hour clock takes the language's own: Japanese counts it from 0 (h11), English\n        // from 12 (h12). Imposing h12 wrote 午前12:05 where 午前0:05 is written.\n        ...(format === '12h' ? { hour12: true } : { hourCycle: 'h23' as const }),\n        timeZone: 'UTC',\n      }),\n  )\n}\n\n/**\n * A time written out for a reader: \"19:05\", or \"7:05 PM\".\n *\n * `hourCycle` is imposed rather than left to `Intl`, so the text follows what the component\n * settled on: a consumer asking for a 24-hour clock in a locale that would choose otherwise\n * must get theirs.\n */\nexport function formatTimeDisplay(time: string, locale: string, format: HourFormat): string {\n  const parts = parseTime(time)\n  if (!parts) return ''\n  return displayFormatterFor(locale, format).format(Date.UTC(2021, 0, 1, parts.hour, parts.minute))\n}\n\n/** A time as minutes since midnight, `null` if it is not one: its position in a list. */\nexport function minutesOf(time: string | null | undefined): number | null {\n  const parts = parseTime(time)\n  return parts ? parts.hour * 60 + parts.minute : null\n}\n"],"mappings":";;;AA+BA,IAAM,IAAU;AAGhB,SAAgB,EAAY,GAAiC;CAC3D,OAAO,OAAO,KAAU,YAAY,EAAQ,KAAK,CAAK;AACxD;AAGA,SAAgB,EAAU,GAAoD;CAC5E,IAAI,CAAC,EAAY,CAAK,GAAG,OAAO;CAChC,IAAM,CAAC,GAAG,KAAK,EAAM,MAAM,GAAG;CAC9B,OAAO;EAAE,MAAM,OAAO,CAAC;EAAG,QAAQ,OAAO,CAAC;CAAE;AAC9C;AAGA,SAAgB,EAAW,GAAc,GAAwB;CAC/D,OAAO,GAAG,EAAK,CAAI,EAAE,GAAG,EAAK,CAAM;AACrC;AAEA,IAAM,oBAAiB,IAAI,IAAwB;AAUnD,SAAgB,EAAa,GAA4B;CACvD,OAAO,EAAK,GAAgB,SAAc,EAAiB,CAAM,CAAC;AACpE;AAEA,SAAS,EAAiB,GAA4B;CACpD,IAAI;EACF,IAAM,EAAE,iBAAc,IAAI,KAAK,eAAe,GAAQ,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,gBAAgB;EAC3F,OAAO,MAAc,SAAS,MAAc,QAAQ,QAAQ;CAC9D,QAAQ;EACN,OAAO;CACT;AACF;AAUA,IAAM,oBAAoB,IAAI,IAAiC;AAE/D,SAAS,EAAoB,GAAgB,GAAyC;CACpF,OAAO,EACL,GACA,GAAG,EAAO,GAAG,WAEX,IAAI,KAAK,eAAe,GAAQ;EAC9B,MAAM;EACN,QAAQ;EAGR,GAAI,MAAW,QAAQ,EAAE,QAAQ,GAAK,IAAI,EAAE,WAAW,MAAe;EACtE,UAAU;CACZ,CAAC,CACL;AACF;AASA,SAAgB,EAAkB,GAAc,GAAgB,GAA4B;CAC1F,IAAM,IAAQ,EAAU,CAAI;CAE5B,OADK,IACE,EAAoB,GAAQ,CAAM,CAAC,CAAC,OAAO,KAAK,IAAI,MAAM,GAAG,GAAG,EAAM,MAAM,EAAM,MAAM,CAAC,IAD7E;AAErB;AAGA,SAAgB,EAAU,GAAgD;CACxE,IAAM,IAAQ,EAAU,CAAI;CAC5B,OAAO,IAAQ,EAAM,OAAO,KAAK,EAAM,SAAS;AAClD"}

package/dist/utils/vnode.d.ts

@@ -5,10 +5,12 @@ import { VNode } from 'vue';
  *
  * This is what lets a component count its children without a registry they feed at mount.
  * A registry fills up in the browser and stays empty on the server, so the two renders
- * disagree — VAvatarGroup would say "+0" in one and "+3" in the other. Reading the slot
+ * disagree: VAvatarGroup would say "+0" in one and "+3" in the other. Reading the slot
  * happens while the parent renders, which is the same on both sides.
  *
- * Used by VAvatarGroup for its "+N", by VCarousel for its slide count and the index each
- * slide is handed, and by VInputGroup for its dev warning on a segment carrying a label.
+ * Components never call it on a slot directly: they go through `composables/useSlotNodes`,
+ * which redoes the read whenever the parent hands down a new slot. Its consumers are
+ * VAvatarGroup for its "+N", VCarousel for its slide count and the index each slide is
+ * handed, and VInputGroup for its dev warning on a segment carrying a label.
  */
 export declare function flattenSlot(nodes: VNode[] | undefined): VNode[];

package/dist/utils/vnode.js.map

@@ -1 +1 @@
-{"version":3,"file":"vnode.js","names":[],"sources":["../../src/utils/vnode.ts"],"sourcesContent":["import { Comment, Fragment, Text } from 'vue'\nimport type { VNode } from 'vue'\n\n// @ssr @core\n/**\n * A slot's VNodes reduced to the elements that will actually render: `v-for` Fragments\n * unwrapped, a false `v-if`'s Comment and the source text's whitespace dropped.\n *\n * This is what lets a component count its children without a registry they feed at mount.\n * A registry fills up in the browser and stays empty on the server, so the two renders\n * disagree — VAvatarGroup would say \"+0\" in one and \"+3\" in the other. Reading the slot\n * happens while the parent renders, which is the same on both sides.\n *\n * Used by VAvatarGroup for its \"+N\", by VCarousel for its slide count and the index each\n * slide is handed, and by VInputGroup for its dev warning on a segment carrying a label.\n */\nexport function flattenSlot(nodes: VNode[] | undefined): VNode[] {\n  const out: VNode[] = []\n  for (const node of nodes ?? []) {\n    if (node.type === Fragment) out.push(...flattenSlot(node.children as VNode[]))\n    else if (node.type === Comment) continue\n    else if (node.type === Text && !String(node.children).trim()) continue\n    else out.push(node)\n  }\n  return out\n}\n"],"mappings":";;AAgBA,SAAgB,EAAY,GAAqC;CAC/D,IAAM,IAAe,CAAC;CACtB,KAAK,IAAM,KAAQ,KAAS,CAAC,GAC3B,IAAI,EAAK,SAAS,GAAU,EAAI,KAAK,GAAG,EAAY,EAAK,QAAmB,CAAC;MACxE,IAAI,EAAK,SAAS,GAAS;MAC3B,IAAI,EAAK,SAAS,KAAQ,CAAC,OAAO,EAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;MACzD,EAAI,KAAK,CAAI;CAEpB,OAAO;AACT"}
+{"version":3,"file":"vnode.js","names":[],"sources":["../../src/utils/vnode.ts"],"sourcesContent":["import { Comment, Fragment, Text } from 'vue'\nimport type { VNode } from 'vue'\n\n// @ssr @core\n/**\n * A slot's VNodes reduced to the elements that will actually render: `v-for` Fragments\n * unwrapped, a false `v-if`'s Comment and the source text's whitespace dropped.\n *\n * This is what lets a component count its children without a registry they feed at mount.\n * A registry fills up in the browser and stays empty on the server, so the two renders\n * disagree: VAvatarGroup would say \"+0\" in one and \"+3\" in the other. Reading the slot\n * happens while the parent renders, which is the same on both sides.\n *\n * Components never call it on a slot directly: they go through `composables/useSlotNodes`,\n * which redoes the read whenever the parent hands down a new slot. Its consumers are\n * VAvatarGroup for its \"+N\", VCarousel for its slide count and the index each slide is\n * handed, and VInputGroup for its dev warning on a segment carrying a label.\n */\nexport function flattenSlot(nodes: VNode[] | undefined): VNode[] {\n  const out: VNode[] = []\n  for (const node of nodes ?? []) {\n    if (node.type === Fragment) out.push(...flattenSlot(node.children as VNode[]))\n    else if (node.type === Comment) continue\n    else if (node.type === Text && !String(node.children).trim()) continue\n    else out.push(node)\n  }\n  return out\n}\n"],"mappings":";;AAkBA,SAAgB,EAAY,GAAqC;CAC/D,IAAM,IAAe,CAAC;CACtB,KAAK,IAAM,KAAQ,KAAS,CAAC,GAC3B,IAAI,EAAK,SAAS,GAAU,EAAI,KAAK,GAAG,EAAY,EAAK,QAAmB,CAAC;MACxE,IAAI,EAAK,SAAS,GAAS;MAC3B,IAAI,EAAK,SAAS,KAAQ,CAAC,OAAO,EAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;MACzD,EAAI,KAAK,CAAI;CAEpB,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectis-ui",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Vue 3 design system — HTML/CSS first, CSS tokens, Nuxt 3 (SSR) compatible",
   "type": "module",
   "license": "MIT",
@@ -93,7 +93,7 @@
     "icons": "tsx scripts/build-icons.ts",
     "prebuild": "pnpm run tokens",
     "build": "vite build",
-    "postbuild": "tsx scripts/check-css-split.ts && tsx scripts/bench-size.ts",
+    "postbuild": "tsx scripts/check-css-split.ts && tsx scripts/check-dev-warnings.ts && tsx scripts/bench-size.ts",
     "//bench": "Runtime timings, deliberately OUTSIDE the checkpoint and never gating: a benchmark on a shared runner measures the runner. The SIZE gate is the deterministic half and runs in postbuild.",
     "bench": "vitest bench --run",
     "bench:size": "tsx scripts/bench-size.ts",