haze-ui 1.29.0 → 1.30.0

package/dist/tokens/palette.js

@@ -56,6 +56,57 @@ var i = {
 		red: { 8: "#ef4444" }
 	}
 }, c = {
+	violet: {
+		light: {
+			9: "#7c3aed",
+			10: "#6d28d9"
+		},
+		dark: {
+			8: "#9b76fa",
+			9: "#a78bfa"
+		}
+	},
+	teal: {
+		light: {
+			9: "#0f766e",
+			10: "#134e4a"
+		},
+		dark: {
+			8: "#14b8a6",
+			9: "#2dd4bf"
+		}
+	},
+	cyan: {
+		light: {
+			9: "#0e7490",
+			10: "#155e75"
+		},
+		dark: {
+			8: "#06b6d4",
+			9: "#22d3ee"
+		}
+	},
+	orange: {
+		light: {
+			9: "#c2410c",
+			10: "#9a3412"
+		},
+		dark: {
+			8: "#f97316",
+			9: "#fb923c"
+		}
+	},
+	rose: {
+		light: {
+			9: "#dd1645",
+			10: "#be123c"
+		},
+		dark: {
+			8: "#f43f5e",
+			9: "#fb7185"
+		}
+	}
+}, l = {
 	light: {
 		l1: .982,
 		l12: .16,
@@ -69,7 +120,7 @@ var i = {
 		c12: .012
 	}
 };
-function l(e, t) {
+function u(e, t) {
 	let n = e[0];
 	if (t <= n.x) return n.y;
 	for (let n = 1; n < e.length; n++) {
@@ -81,7 +132,7 @@ function l(e, t) {
 	}
 	return e[e.length - 1].y;
 }
-function u(e, t, r) {
+function d(e, t, r) {
 	return Object.entries(e).map(([e, i]) => {
 		let a = n(i), s = r && Number(e) === 9 ? a.l + o[t] : a.l;
 		return {
@@ -94,92 +145,95 @@ function u(e, t, r) {
 		};
 	}).sort((e, t) => e.step - t.step);
 }
-function d(n, r, i) {
+function f(n, r, i) {
 	let a = [];
 	for (let o = 1; o <= 12; o++) a.push(t(e({
-		l: l(n, o),
+		l: u(n, o),
 		c: r(o),
 		h: i(o)
 	})));
 	return a;
 }
-function f(e, t) {
-	return d(u(e, t, !0).map((e) => ({
+function p(e, t) {
+	return f(d(e, t, !0).map((e) => ({
 		x: e.step,
 		y: e.color.l
 	})), () => 0, () => 0);
 }
-function p(e, t) {
-	let n = u(e, t, !1), r = c[t], i = [
+function m(e, t) {
+	return h(d(e, t, !1), t);
+}
+function h(e, t) {
+	let n = l[t], r = [
 		{
 			x: 1,
-			y: r.l1
+			y: n.l1
 		},
-		...n.map((e) => ({
+		...e.map((e) => ({
 			x: e.step,
 			y: e.color.l
 		})),
 		{
 			x: 12,
-			y: r.l12
+			y: n.l12
 		}
-	], a = [
+	], i = [
 		{
 			x: 1,
-			y: r.c1
+			y: n.c1
 		},
-		...n.map((e) => ({
+		...e.map((e) => ({
 			x: e.step,
 			y: e.color.c
 		})),
 		{
 			x: 12,
-			y: r.c12
+			y: n.c12
 		}
-	], o = [
+	], a = [
 		{
 			x: 1,
-			y: n[0].color.h
+			y: e[0].color.h
 		},
-		...n.map((e) => ({
+		...e.map((e) => ({
 			x: e.step,
 			y: e.color.h
 		})),
 		{
 			x: 12,
-			y: n[n.length - 1].color.h
+			y: e[e.length - 1].color.h
 		}
 	];
-	return d(i, (e) => l(a, e), (e) => l(o, e));
+	return f(r, (e) => u(i, e), (e) => u(a, e));
 }
-var m = {
+var g = {
 	light: {
-		gray: f(s.light.gray, "light"),
-		blue: p(s.light.blue, "light"),
-		green: p(s.light.green, "light"),
-		amber: p(s.light.amber, "light"),
-		red: p(s.light.red, "light")
+		gray: p(s.light.gray, "light"),
+		blue: m(s.light.blue, "light"),
+		green: m(s.light.green, "light"),
+		amber: m(s.light.amber, "light"),
+		red: m(s.light.red, "light")
 	},
 	dark: {
-		gray: f(s.dark.gray, "dark"),
-		blue: p(s.dark.blue, "dark"),
-		green: p(s.dark.green, "dark"),
-		amber: p(s.dark.amber, "dark"),
-		red: p(s.dark.red, "dark")
+		gray: p(s.dark.gray, "dark"),
+		blue: m(s.dark.blue, "dark"),
+		green: m(s.dark.green, "dark"),
+		amber: m(s.dark.amber, "dark"),
+		red: m(s.dark.red, "dark")
 	}
 };
-function h(e, t, n, r) {
+function _(e, t, n, r) {
 	let i = e[t][n]?.[r - 1];
 	if (i === void 0) throw Error(`Missing primitive ${n}-${r} in ${t} mode`);
 	return i;
 }
-var g = {
+var v = {
 	primary: "blue",
 	success: "green",
 	warning: "amber",
 	danger: "red",
 	info: "blue"
-}, _ = {
+}, y = {
 	light: {
 		primary: 9,
 		success: 9,
@@ -194,7 +248,7 @@ var g = {
 		danger: 8,
 		info: 8
 	}
-}, v = {
+}, b = {
 	bg: 1,
 	"bg-subtle": 2,
 	"bg-muted": 3,
@@ -202,18 +256,18 @@ var g = {
 	"text-secondary": 11,
 	"text-muted": 9,
 	border: 4
-}, y = (e, t) => `var(--haze-${e}-${t})`, b = (e) => `calc(l ${e < 0 ? "-" : "+"} ${Math.abs(e)})`;
-function x(e, t, n) {
+}, x = (e, t) => `var(--haze-${e}-${t})`, S = (e) => `calc(l ${e < 0 ? "-" : "+"} ${Math.abs(e)})`;
+function C(e, t, n) {
 	let r = i[e];
 	switch (n) {
-		case "hover": return `oklch(from ${t} ${b(r.hover)} c h)`;
-		case "active": return `oklch(from ${t} ${b(r.active)} c h)`;
+		case "hover": return `oklch(from ${t} ${S(r.hover)} c h)`;
+		case "active": return `oklch(from ${t} ${S(r.active)} c h)`;
 		case "subtle": return `oklch(from ${t} ${r.subtleL} calc(c * ${r.subtleC}) h)`;
-		case "border-hover": return `oklch(from ${t} ${b(r.borderHover)} c h)`;
+		case "border-hover": return `oklch(from ${t} ${S(r.borderHover)} c h)`;
 		case "focus-ring": return `oklch(from ${t} l c h / ${a})`;
 	}
 }
-function S(t, n, r) {
+function w(t, n, r) {
 	let o = i[t];
 	switch (r) {
 		case "hover": return e({
@@ -244,59 +298,59 @@ function S(t, n, r) {
 		};
 	}
 }
-function C(e, t, n, i, a) {
+function T(e, t, n, i, a) {
 	return {
 		name: t,
 		label: n,
 		css: {
-			light: y(i, a.light),
-			dark: y(i, a.dark)
+			light: x(i, a.light),
+			dark: x(i, a.dark)
 		},
 		resolved: {
-			light: r(h(e.scales, "light", i, a.light)),
-			dark: r(h(e.scales, "dark", i, a.dark))
+			light: r(_(e.scales, "light", i, a.light)),
+			dark: r(_(e.scales, "dark", i, a.dark))
 		}
 	};
 }
-function w(e, t, n, r, i) {
+function E(e, t, n, r, i) {
 	let a = `var(${n})`;
 	return {
 		name: e,
 		label: t,
 		css: {
-			light: x("light", a, i),
-			dark: x("dark", a, i)
+			light: C("light", a, i),
+			dark: C("dark", a, i)
 		},
 		resolved: {
-			light: S("light", r.light, i),
-			dark: S("dark", r.dark, i)
+			light: w("light", r.light, i),
+			dark: w("dark", r.dark, i)
 		}
 	};
 }
-function T(e, t) {
-	let n = C(e, `--haze-color-${t}`, t[0].toUpperCase() + t.slice(1), e.statusFamily[t], {
-		light: _.light[t],
-		dark: _.dark[t]
+function D(e, t) {
+	let n = T(e, `--haze-color-${t}`, t[0].toUpperCase() + t.slice(1), e.statusFamily[t], {
+		light: y.light[t],
+		dark: y.dark[t]
 	});
 	return [
 		n,
-		w(`${n.name}-hover`, `${n.label} Hover`, n.name, n.resolved, "hover"),
-		w(`${n.name}-active`, `${n.label} Active`, n.name, n.resolved, "active"),
-		w(`${n.name}-subtle`, `${n.label} Subtle`, n.name, n.resolved, "subtle")
+		E(`${n.name}-hover`, `${n.label} Hover`, n.name, n.resolved, "hover"),
+		E(`${n.name}-active`, `${n.label} Active`, n.name, n.resolved, "active"),
+		E(`${n.name}-subtle`, `${n.label} Subtle`, n.name, n.resolved, "subtle")
 	];
 }
-function E(e, t, n) {
-	return C(e, `--haze-color-${t}`, n, "gray", {
-		light: v[t],
-		dark: v[t]
+function O(e, t, n) {
+	return T(e, `--haze-color-${t}`, n, "gray", {
+		light: b[t],
+		dark: b[t]
 	});
 }
-var D = (e) => ({
+var k = (e) => ({
 	name: "--haze-color-text-inverse",
 	label: "Text Inverse",
 	css: {
 		light: "oklch(1 0 0)",
-		dark: h(e.scales, "light", "gray", 12)
+		dark: _(e.scales, "light", "gray", 12)
 	},
 	resolved: {
 		light: {
@@ -304,32 +358,138 @@ var D = (e) => ({
 			c: 0,
 			h: 0
 		},
-		dark: r(h(e.scales, "light", "gray", 12))
+		dark: r(_(e.scales, "light", "gray", 12))
 	}
 });
-function O(e) {
-	let t = T(e, "primary"), n = t[0], r = E(e, "border", "Border");
+function A(e) {
+	let t = D(e, "primary"), n = t[0], r = O(e, "border", "Border");
 	return [
 		...t,
-		E(e, "bg", "Background"),
-		E(e, "bg-subtle", "Background Subtle"),
-		E(e, "bg-muted", "Background Muted"),
-		E(e, "text", "Text"),
-		E(e, "text-secondary", "Text Secondary"),
-		E(e, "text-muted", "Text Muted"),
-		D(e),
+		O(e, "bg", "Background"),
+		O(e, "bg-subtle", "Background Subtle"),
+		O(e, "bg-muted", "Background Muted"),
+		O(e, "text", "Text"),
+		O(e, "text-secondary", "Text Secondary"),
+		O(e, "text-muted", "Text Muted"),
+		k(e),
 		r,
-		w("--haze-color-border-hover", "Border Hover", r.name, r.resolved, "border-hover"),
-		...T(e, "success"),
-		...T(e, "warning"),
-		...T(e, "danger"),
-		...T(e, "info"),
-		w("--haze-color-focus-ring", "Focus Ring", n.name, n.resolved, "focus-ring")
+		E("--haze-color-border-hover", "Border Hover", r.name, r.resolved, "border-hover"),
+		...D(e, "success"),
+		...D(e, "warning"),
+		...D(e, "danger"),
+		...D(e, "info"),
+		E("--haze-color-focus-ring", "Focus Ring", n.name, n.resolved, "focus-ring")
 	];
 }
-var k = O({
-	scales: m,
-	statusFamily: g
+var j = A({
+	scales: g,
+	statusFamily: v
+}), M = [
+	"violet",
+	"teal",
+	"cyan",
+	"orange",
+	"rose"
+];
+function N(e) {
+	let t = (t) => Object.fromEntries([
+		["gray", g[t].gray],
+		[e, m(c[e][t], t)],
+		["green", g[t].green],
+		["amber", g[t].amber],
+		["red", g[t].red]
+	]);
+	return {
+		light: t("light"),
+		dark: t("dark")
+	};
+}
+function P(e) {
+	let t = N(e), n = A({
+		scales: t,
+		statusFamily: {
+			...v,
+			primary: e,
+			info: e
+		}
+	});
+	return {
+		family: e,
+		primitives: t,
+		semanticTokens: n,
+		declarations: {
+			light: F("light", t, n),
+			dark: F("dark", t, n)
+		}
+	};
+}
+function F(e, t, n) {
+	return `${Object.entries(t[e]).flatMap(([e, t]) => t.map((t, n) => `--haze-${e}-${n + 1}: ${t};`)).join("\n")}\n\n${n.map((t) => `${t.name}: ${t.css[e]};`).join("\n")}`;
+}
+var I = /* @__PURE__ */ new Set([
+	"gray",
+	"green",
+	"amber",
+	"red"
+]), L = /^[a-z][a-z0-9-]*$/, R = {
+	infoStep: -.07,
+	darkPrimary: .2
+}, z = (e) => Math.min(1, Math.max(0, e)), B = (t, n) => e({
+	l: z(t.l + n),
+	c: t.c,
+	h: t.h
 });
+function V(e, t) {
+	let r = new Map(e.map((e) => [e.step, e.color]));
+	for (let [e, i] of Object.entries(t ?? {})) {
+		if (Number(e) < 1 || Number(e) > 12) throw Error(`Seed anchor step ${e} is outside the 1–12 scale`);
+		r.set(Number(e), n(i));
+	}
+	return [...r.entries()].map(([e, t]) => ({
+		step: e,
+		color: t
+	})).sort((e, t) => e.step - t.step);
+}
+function H({ name: e, light: t, dark: r, overrides: i }) {
+	if (!L.test(e)) throw Error(`Invalid brand name "${e}" — use a lowercase kebab identifier (letters, digits, hyphens)`);
+	if (I.has(e)) throw Error(`Brand name "${e}" collides with a fixed neutral family (gray/green/amber/red)`);
+	let a = n(t), o = r === void 0 ? B(a, R.darkPrimary) : n(r), s = {
+		light: V([{
+			step: 9,
+			color: a
+		}, {
+			step: 10,
+			color: B(a, R.infoStep)
+		}], i?.light),
+		dark: V([{
+			step: 9,
+			color: o
+		}, {
+			step: 8,
+			color: B(o, R.infoStep)
+		}], i?.dark)
+	}, c = (t) => Object.fromEntries([
+		["gray", g[t].gray],
+		[e, h(s[t], t)],
+		["green", g[t].green],
+		["amber", g[t].amber],
+		["red", g[t].red]
+	]), l = {
+		light: c("light"),
+		dark: c("dark")
+	}, u = A({
+		scales: l,
+		statusFamily: {
+			...v,
+			primary: e,
+			info: e
+		}
+	});
+	return {
+		name: e,
+		light: F("light", l, u),
+		dark: F("dark", l, u)
+	};
+}
 //#endregion
-export { m as PRIMITIVES, k as SEMANTIC_COLOR_TOKENS };
+export { M as BRAND_FAMILIES, c as BRAND_SEEDS, g as PRIMITIVES, j as SEMANTIC_COLOR_TOKENS, P as buildBrandTheme, H as createBrandTheme, F as themeDeclarations };

package/dist/tokens/registry.js

@@ -747,10 +747,25 @@ var n = [
 	slider: [
 		"--haze-color-bg",
 		"--haze-color-bg-muted",
-		"--haze-color-primary",
 		"--haze-color-focus-ring",
+		"--haze-color-primary",
+		"--haze-color-text",
+		"--haze-color-text-inverse",
+		"--haze-color-text-muted",
+		"--haze-color-text-secondary",
+		"--haze-duration-fast",
+		"--haze-ease",
+		"--haze-font-sans",
+		"--haze-leading-normal",
 		"--haze-radius-full",
-		"--haze-shadow-sm"
+		"--haze-radius-md",
+		"--haze-shadow-sm",
+		"--haze-space-1",
+		"--haze-space-12",
+		"--haze-space-16",
+		"--haze-space-2",
+		"--haze-space-6",
+		"--haze-text-xs"
 	],
 	steptimeline: [
 		"--haze-color-bg",
@@ -842,26 +857,7 @@ var n = [
 		"--haze-text-sm",
 		"--haze-text-base"
 	],
-	toast: [
-		"--haze-color-bg",
-		"--haze-color-border",
-		"--haze-color-text",
-		"--haze-color-success",
-		"--haze-color-success-subtle",
-		"--haze-color-warning",
-		"--haze-color-warning-subtle",
-		"--haze-color-danger",
-		"--haze-color-danger-subtle",
-		"--haze-font-sans",
-		"--haze-leading-normal",
-		"--haze-radius-md",
-		"--haze-shadow-lg",
-		"--haze-space-2",
-		"--haze-space-3",
-		"--haze-space-4",
-		"--haze-text-sm",
-		"--haze-text-lg"
-	],
+	toast: /* @__PURE__ */ "--haze-color-bg.--haze-color-border.--haze-color-danger.--haze-color-danger-subtle.--haze-color-focus-ring.--haze-color-primary.--haze-color-primary-active.--haze-color-primary-hover.--haze-color-success.--haze-color-success-subtle.--haze-color-text.--haze-color-text-secondary.--haze-color-warning.--haze-color-warning-subtle.--haze-font-sans.--haze-leading-normal.--haze-radius-md.--haze-shadow-lg.--haze-space-1.--haze-space-2.--haze-space-3.--haze-space-4.--haze-text-base.--haze-text-lg.--haze-text-sm.--haze-weight-medium".split("."),
 	tooltip: [
 		"--haze-color-text",
 		"--haze-color-text-inverse",

package/dist/types/components/Button/Button.d.ts

@@ -11,5 +11,5 @@ type ButtonProps = {
     size?: 'sm' | 'md' | 'lg';
     square?: boolean;
 } & Omit<ComponentPropsWithoutRef<'button'>, 'type'>;
-export default function Button({ variant, size, square, className, ...rest }: ButtonProps): import("react").JSX.Element;
+export default function Button({ variant, size: sizeProp, square, className, ...rest }: ButtonProps): import("react").JSX.Element;
 export type { ButtonProps };

package/dist/types/components/Calendar/Calendar.d.ts

@@ -1,14 +1,30 @@
-import type { ComponentPropsWithoutRef } from 'react';
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { ControlOrValue } from 'react-use-control';
 /** Granularity Calendar picks at. Each mode serializes its `value` and
- * `onSelect` payload to a plain string: `"YYYY-MM-DD"` (date),
- * `"YYYY-MM"` (month), `"YYYY-Qn"` with n 1–4 (quarter) or `"YYYY"`
- * (year). */
-type CalendarPickerMode = 'date' | 'month' | 'quarter' | 'year';
+ * `onSelect` payload to a plain string: `"YYYY-MM-DD"` (date), an ISO
+ * 8601 week `"YYYY-Www"` (week), `"YYYY-MM"` (month), `"YYYY-Qn"` with
+ * n 1–4 (quarter) or `"YYYY"` (year). */
+type CalendarPickerMode = 'date' | 'week' | 'month' | 'quarter' | 'year';
+/**
+ * Extra render position appended inside picker cells (day numbers, month
+ * / quarter / year labels) — schedule dots, badges, custom chrome. Called
+ * with the cell's representative civil date (`day` 1 for the
+ * month/quarter/year cells) and the picker mode the cell renders in, so
+ * one callback can decorate a date grid and the header drill-down grids
+ * differently.
+ */
+type CalendarCellRender = (date: {
+    year: number;
+    month: number;
+    day: number;
+}, mode: CalendarPickerMode) => ReactNode;
 type CalendarProps = {
     /**
      * Granularity the calendar picks at. `"date"` (default) renders the
-     * day grid; `"month"` a 3×4 month grid over one year; `"quarter"`
+     * day grid; `"week"` the same day grid with whole-ISO-week row
+     * selection (rows run Monday–Sunday, the week-number column is always
+     * shown and `weekStartsOn` is ignored — ISO weeks are Monday-first by
+     * definition); `"month"` a 3×4 month grid over one year; `"quarter"`
      * a 4-quarter grid over one year; `"year"` a 12-year grid stepped a
      * decade at a time. Values follow each mode's serialization (see
      * {@link CalendarPickerMode}); `months`, `showWeekNumbers`,
@@ -18,8 +34,9 @@ type CalendarProps = {
     picker?: CalendarPickerMode;
     /**
      * Selected value as a plain string whose format follows `picker`:
-     * "YYYY-MM-DD" (date, the default), "YYYY-MM" (month), "YYYY-Qn"
-     * (quarter) or "YYYY" (year). Empty string means nothing selected.
+     * "YYYY-MM-DD" (date, the default), an ISO week "YYYY-Www" (week),
+     * "YYYY-MM" (month), "YYYY-Qn" (quarter) or "YYYY" (year). Empty
+     * string means nothing selected.
      */
     value?: ControlOrValue<string>;
     /**
@@ -74,12 +91,20 @@ type CalendarProps = {
      */
     rangeEnd?: string;
     /**
-     * Called with the picked value — "YYYY-MM-DD" (date), "YYYY-MM"
-     * (month), "YYYY-Qn" (quarter) or "YYYY" (year), matching `picker`.
-     * Still fires alongside the controllable `value` for callers that
-     * prefer event-style wiring.
+     * Called with the picked value — "YYYY-MM-DD" (date), an ISO week
+     * "YYYY-Www" (week), "YYYY-MM" (month), "YYYY-Qn" (quarter) or "YYYY"
+     * (year), matching `picker`. Still fires alongside the controllable
+     * `value` for callers that prefer event-style wiring.
      */
     onSelect?: (date: string) => void;
+    /**
+     * Appends a custom render inside every picker cell — day numbers,
+     * month/quarter/year labels and the header drill-down grids alike
+     * (schedule dots, badges). Receives the cell's representative civil
+     * date (`day` 1 for month/quarter/year cells) and the mode the cell
+     * renders in. Opt-in: without it the cells render exactly as before.
+     */
+    cellRender?: CalendarCellRender;
 } & Omit<ComponentPropsWithoutRef<'div'>, 'onSelect'>;
-export default function Calendar({ picker, value: valueControl, min, max, disabledDate, locale, weekStartsOn, showWeekNumbers, months, rangeStart, rangeEnd, onSelect, className, ...rest }: CalendarProps): import("react").JSX.Element;
-export type { CalendarProps, CalendarPickerMode };
+export default function Calendar({ picker, value: valueControl, min, max, disabledDate, locale, weekStartsOn, showWeekNumbers, months, rangeStart, rangeEnd, onSelect, cellRender, className, ...rest }: CalendarProps): import("react").JSX.Element;
+export type { CalendarProps, CalendarPickerMode, CalendarCellRender };

package/dist/types/components/Calendar/date.d.ts

@@ -59,6 +59,15 @@ export declare function getLeadingDays(year: number, month: number, weekStart: n
  * added. The result length is always a multiple of 7.
  */
 export declare function buildMonthCells(year: number, month: number, weekStart: number): CalendarCell[];
+/** ISO 8601 week identity of a civil date: the week number together with
+ * the ISO week-numbering **year** it belongs to. Days at the calendar
+ * year's edges borrow the neighbor year's numbering, so `year` here is
+ * not necessarily the civil date's own year (2025-12-31 is week 1 of
+ * 2026; 2027-01-01 is week 53 of 2026). */
+export type ISOWeek = {
+    year: number;
+    week: number;
+};
 /**
  * ISO 8601 week number of a civil date. ISO weeks run Monday–Sunday and
  * week 1 is the week containing the year's first Thursday, so days at the
@@ -71,6 +80,30 @@ export declare function buildMonthCells(year: number, month: number, weekStart:
  * spans from that ISO year's January 1.
  */
 export declare function getISOWeekNumber(year: number, month: number, day: number): number;
+/**
+ * Full ISO 8601 week identity of a civil date (`{@link getISOWeekNumber}`
+ * plus the ISO week-numbering year the week belongs to). Same Thursday
+ * anchoring: the Thursday of a date's Monday–Sunday week carries the ISO
+ * year, which is what `"YYYY-Www"` values (see
+ * {@link formatWeekValue}) number weeks against.
+ */
+export declare function getISOWeek(year: number, month: number, day: number): ISOWeek;
+/**
+ * Monday of an ISO week as a civil date — the anchor
+ * `picker="week"` derives its month view and row highlight from. January
+ * 4 always sits in week 1 (the first-Thursday rule), so Monday of week 1
+ * is `Jan 4 − (Jan 4's ISO weekday − 1)`; every later week adds whole
+ * seven-day spans. All arithmetic rides UTC milliseconds (whole days, no
+ * DST drift); the result is read back as a civil triple. Weeks beyond the
+ * year's last (52 or 53 per the ISO calendar) resolve into the neighbor
+ * year — callers validate with a `getISOWeek` round-trip (see
+ * {@link parseWeekValue}).
+ */
+export declare function getISOWeekStartDate(isoYear: number, week: number): {
+    year: number;
+    month: number;
+    day: number;
+};
 /**
  * Format a civil date as the `"YYYY-MM-DD"` string Calendar uses as its
  * value. Value semantics: the string denotes the **local** civil date — it
@@ -119,6 +152,24 @@ export declare function formatYearValue(year: number): string;
 export declare function parseYearValue(value: string): {
     year: number;
 } | null;
+/**
+ * Format an ISO week as the `"YYYY-Www"` string Calendar's
+ * `picker="week"` mode uses as its value (`isoYear` is the ISO
+ * week-numbering year — not necessarily the civil year of every day in
+ * the week — and `week` is 1-based, zero-padded: 2026 week 37 →
+ * `"2026-W37"`). Pure string math; no Date construction.
+ */
+export declare function formatWeekValue(isoYear: number, week: number): string;
+/**
+ * Parse a `"YYYY-Www"` week-picker value (`{@link formatWeekValue}`'s
+ * inverse). Accepts weeks `01`…`53` shape-wise, then rejects the ones
+ * that do not exist in the given ISO year via a round-trip: 2025 is a
+ * 52-week year, so `"2025-W53"` resolves to a Monday that belongs to
+ * 2026 week 1 and is rejected. Anything with another shape
+ * (`"2026-W1"`, `"2026-w05"`, a date/month/quarter serialization) is
+ * rejected outright.
+ */
+export declare function parseWeekValue(value: string): ISOWeek | null;
 /**
  * Parse a `"YYYY-MM-DD"` value string into a local-midnight Date — the
  * inverse of {@link formatDate} and the only safe way to turn a value into