rei-kit 2.21.0 → 2.23.0

package/dist/{GoogleButton-mCqGbrXm.js → use-announce-qM0ZD9Ey.js}

@@ -1,5 +1,5 @@
-import { r as useBoundValue } from "./BaseSheet-B7401rS7.js";
-import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createStaticVNode, createTextVNode, defineComponent, isRef, mergeModels, mergeProps, normalizeClass, onMounted, onUnmounted, openBlock, readonly, ref, renderSlot, toDisplayString, unref, useId, useModel, vModelCheckbox, vModelDynamic, watch, withCtx, withDirectives } from "vue";
+import { c as useBoundValue } from "./focus-target-DRgd8UnQ.js";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createStaticVNode, createTextVNode, defineComponent, isRef, mergeProps, nextTick, normalizeClass, onMounted, onUnmounted, openBlock, readonly, ref, renderSlot, toDisplayString, unref, useId, vModelDynamic, watch, withCtx, withDirectives } from "vue";
 //#region src/utils/redirect.ts
 /**
 * Resolves a `?redirect=` query value into a safe in-app path.
@@ -324,7 +324,7 @@ function useToast() {
 }
 //#endregion
 //#region src/components/BaseAlert.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$4 = ["role", "aria-live"];
+var _hoisted_1$3 = ["role", "aria-live"];
 var _hoisted_2$1 = { class: "min-w-0 flex-1" };
 var _hoisted_3$1 = {
 	key: 0,
@@ -369,13 +369,15 @@ var BaseAlert_default = /* @__PURE__ */ defineComponent({
 				}, [renderSlot(_ctx.$slots, "mark")], 2)) : createCommentVNode("", true),
 				createElementVNode("div", _hoisted_2$1, [_ctx.$slots.title ? (openBlock(), createElementBlock("p", _hoisted_3$1, [renderSlot(_ctx.$slots, "title")])) : createCommentVNode("", true), createElementVNode("div", { class: normalizeClass(_ctx.$slots.title ? "mt-1" : "") }, [renderSlot(_ctx.$slots, "default")], 2)]),
 				renderSlot(_ctx.$slots, "action")
-			], 10, _hoisted_1$4);
+			], 10, _hoisted_1$3);
 		};
 	}
 });
 //#endregion
 //#region src/components/FormField.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$3 = ["for"];
+var _hoisted_1$2 = ["for"];
+var _hoisted_2 = ["id"];
+var _hoisted_3 = ["id"];
 //#endregion
 //#region src/components/FormField.vue
 var FormField_default = /* @__PURE__ */ defineComponent({
@@ -388,44 +390,46 @@ var FormField_default = /* @__PURE__ */ defineComponent({
 		labelHidden: {
 			type: Boolean,
 			default: false
-		}
+		},
+		fieldId: { default: () => void 0 }
 	},
 	setup(__props) {
-		const id = useId();
-		const errorId = `${id}-error`;
-		const hintId = `${id}-hint`;
+		const generated = useId();
+		const id = computed(() => __props.fieldId ?? generated);
+		const errorId = computed(() => `${id.value}-error`);
+		const hintId = computed(() => `${id.value}-hint`);
 		const describedBy = computed(() => {
-			if (__props.error) return errorId;
-			if (__props.hint) return hintId;
+			if (__props.error) return errorId.value;
+			if (__props.hint) return hintId.value;
 		});
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", { class: normalizeClass(["flex flex-col", __props.size === "sm" ? "gap-1" : "gap-1.5"]) }, [
 				createElementVNode("label", {
-					for: unref(id),
+					for: id.value,
 					class: normalizeClass(["font-medium", [__props.labelHidden ? "sr-only" : "", __props.size === "sm" ? "text-ink-soft text-xs" : "text-ink text-sm"]])
-				}, toDisplayString(__props.label), 11, _hoisted_1$3),
+				}, toDisplayString(__props.label), 11, _hoisted_1$2),
 				renderSlot(_ctx.$slots, "default", {
-					id: unref(id),
+					id: id.value,
 					describedBy: describedBy.value,
 					invalid: Boolean(__props.error),
 					size: __props.size
 				}),
 				__props.error ? (openBlock(), createElementBlock("p", {
 					key: 0,
-					id: errorId,
+					id: errorId.value,
 					class: "text-negative text-xs"
-				}, toDisplayString(__props.error), 1)) : __props.hint ? (openBlock(), createElementBlock("p", {
+				}, toDisplayString(__props.error), 9, _hoisted_2)) : __props.hint ? (openBlock(), createElementBlock("p", {
 					key: 1,
-					id: hintId,
+					id: hintId.value,
 					class: "text-ink-soft text-xs"
-				}, toDisplayString(__props.hint), 1)) : createCommentVNode("", true)
+				}, toDisplayString(__props.hint), 9, _hoisted_3)) : createCommentVNode("", true)
 			], 2);
 		};
 	}
 });
 //#endregion
 //#region src/components/BaseInput.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$2 = [
+var _hoisted_1$1 = [
 	"id",
 	"type",
 	"aria-invalid",
@@ -478,7 +482,7 @@ var BaseInput_default = /* @__PURE__ */ defineComponent({
 					__props.variant === "unstyled" ? "" : "control text-ink rounded-card focus-visible:outline-primary px-3 focus-visible:outline-2 focus-visible:outline-offset-1",
 					__props.variant === "unstyled" ? "text-base" : CONTROL_CLASS,
 					__props.variant !== "unstyled" && invalid ? "border-negative" : ""
-				] }), null, 16, _hoisted_1$2), [[vModelDynamic, unref(model)]])]),
+				] }), null, 16, _hoisted_1$1), [[vModelDynamic, unref(model)]])]),
 				_: 1
 			}, 8, [
 				"label",
@@ -491,70 +495,6 @@ var BaseInput_default = /* @__PURE__ */ defineComponent({
 	}
 });
 //#endregion
-//#region src/components/BaseCheckbox.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$1 = { class: "flex flex-col gap-1.5" };
-var _hoisted_2 = ["for"];
-var _hoisted_3 = [
-	"id",
-	"disabled",
-	"aria-invalid",
-	"aria-describedby"
-];
-//#endregion
-//#region src/components/BaseCheckbox.vue
-var BaseCheckbox_default = /* @__PURE__ */ defineComponent({
-	__name: "BaseCheckbox",
-	props: /*@__PURE__*/ mergeModels({
-		label: {},
-		error: { default: "" },
-		hint: { default: "" },
-		disabled: {
-			type: Boolean,
-			default: false
-		},
-		size: { default: "md" }
-	}, {
-		"modelValue": {
-			type: Boolean,
-			default: false
-		},
-		"modelModifiers": {}
-	}),
-	emits: ["update:modelValue"],
-	setup(__props) {
-		const model = useModel(__props, "modelValue");
-		const id = useId();
-		const errorId = `${id}-error`;
-		const hintId = `${id}-hint`;
-		const describedBy = computed(() => {
-			if (__props.error) return errorId;
-			if (__props.hint) return hintId;
-		});
-		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", _hoisted_1$1, [createElementVNode("label", {
-				for: unref(id),
-				class: normalizeClass(["flex items-center", [__props.size === "sm" ? "gap-2" : "gap-3", __props.disabled ? "opacity-50" : "cursor-pointer"]])
-			}, [withDirectives(createElementVNode("input", {
-				id: unref(id),
-				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => model.value = $event),
-				type: "checkbox",
-				disabled: __props.disabled,
-				"aria-invalid": Boolean(__props.error),
-				"aria-describedby": describedBy.value,
-				class: "accent-primary focus-visible:outline-primary size-4 shrink-0 focus-visible:outline-2 focus-visible:outline-offset-2"
-			}, null, 8, _hoisted_3), [[vModelCheckbox, model.value]]), createElementVNode("span", { class: normalizeClass(["text-sm", __props.size === "sm" ? "text-ink-soft" : "text-ink"]) }, toDisplayString(__props.label), 3)], 10, _hoisted_2), __props.error ? (openBlock(), createElementBlock("p", {
-				key: 0,
-				id: errorId,
-				class: "text-negative text-xs"
-			}, toDisplayString(__props.error), 1)) : __props.hint ? (openBlock(), createElementBlock("p", {
-				key: 1,
-				id: hintId,
-				class: "text-ink-soft text-xs"
-			}, toDisplayString(__props.hint), 1)) : createCommentVNode("", true)]);
-		};
-	}
-});
-//#endregion
 //#region src/components/GoogleButton.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = ["disabled"];
 //#endregion
@@ -590,6 +530,39 @@ var GoogleButton_default = /* @__PURE__ */ defineComponent({
 	}
 });
 //#endregion
-export { BaseAlert_default as a, applyTheme as c, setThemeStorageKey as d, useTheme as f, toRedirectPath as h, FormField_default as i, isThemePreference as l, safeRedirect as m, BaseCheckbox_default as n, useToast as o, tapFeedback as p, BaseInput_default as r, useOnline as s, GoogleButton_default as t, readStoredTheme as u };
+//#region src/composables/use-announce.ts
+var polite = ref("");
+var assertive = ref("");
+/** Long enough to be read, short enough that a reader landing in the region
+*  later does not find a sentence about something that has since changed. */
+var CLEAR_AFTER_MS = 7e3;
+var timer;
+/**
+* Says something once. Render one `AnnounceHost` in the app for it to reach a
+* reader at all.
+*/
+function announce(message, { assertive: urgent = false } = {}) {
+	const target = urgent ? assertive : polite;
+	if (timer !== void 0) clearTimeout(timer);
+	polite.value = "";
+	assertive.value = "";
+	nextTick(() => {
+		target.value = message;
+		timer = setTimeout(() => {
+			target.value = "";
+			timer = void 0;
+		}, CLEAR_AFTER_MS);
+	});
+}
+function useAnnounce() {
+	return {
+		announce,
+		/** What the regions are saying. `AnnounceHost` renders these; apps read them in tests. */
+		polite: readonly(polite),
+		assertive: readonly(assertive)
+	};
+}
+//#endregion
+export { FormField_default as a, useOnline as c, readStoredTheme as d, setThemeStorageKey as f, toRedirectPath as g, safeRedirect as h, BaseInput_default as i, applyTheme as l, tapFeedback as m, useAnnounce as n, BaseAlert_default as o, useTheme as p, GoogleButton_default as r, useToast as s, announce as t, isThemePreference as u };
 
-//# sourceMappingURL=GoogleButton-mCqGbrXm.js.map
+//# sourceMappingURL=use-announce-qM0ZD9Ey.js.map

package/dist/use-announce-qM0ZD9Ey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-announce-qM0ZD9Ey.js","names":["$slots","$attrs"],"sources":["../src/utils/redirect.ts","../src/utils/haptics.ts","../src/composables/use-theme.ts","../src/composables/use-online.ts","../src/composables/use-toast.ts","../src/components/BaseAlert.vue","../src/components/BaseAlert.vue","../src/components/FormField.vue","../src/components/FormField.vue","../src/components/BaseInput.vue","../src/components/BaseInput.vue","../src/components/GoogleButton.vue","../src/components/GoogleButton.vue","../src/composables/use-announce.ts"],"sourcesContent":["/**\n * What a router hands back for one query key.\n *\n * Inlined rather than imported from vue-router: the shape is `string | null`\n * either way, and a helper this small should not drag a router into the\n * package's dependencies.\n */\nexport type QueryValue = string | null\n\n/**\n * Resolves a `?redirect=` query value into a safe in-app path.\n *\n * Only same-origin paths are accepted. Anything else falls back to `/`,\n * so a crafted link cannot bounce a user from the real login page to a\n * phishing clone.\n *\n * Pure: takes the query value instead of reading the router, so it also\n * works inside navigation guards and can be unit tested.\n *\n * @param target - Raw `route.query.redirect` value. May be a string, an\n *   array (repeated query key), `null`, or `undefined`.\n * @returns A path starting with a single `/`. Defaults to `/`.\n *\n * @example\n * ```ts\n * // in a view\n * await router.push(safeRedirect(route.query.redirect))\n *\n * // in a guard\n * return safeRedirect(to.query.redirect)\n * ```\n *\n * @example\n * ```ts\n * safeRedirect('/week')              // '/week'\n * safeRedirect('https://evil.com')   // '/'\n * safeRedirect('//evil.com')         // '/'  (protocol-relative URL)\n * safeRedirect(['/a', '/b'])         // '/'\n * safeRedirect(undefined)            // '/'\n * ```\n */\nexport function safeRedirect(target: QueryValue | QueryValue[] | undefined): string {\n  if (typeof target === 'string' && target.startsWith('/') && !target.startsWith('//')) {\n    return target\n  }\n\n  return '/'\n}\n\n/**\n * Where to send somebody back to after signing in, without the fragment.\n *\n * Supabase's implicit OAuth flow hands the browser back with the access and\n * refresh tokens in the URL fragment. A fragment is client-side only — it is\n * never sent to a server. Copied into a query parameter it stops being one:\n * `/login?redirect=/%23access_token=…` is sent on the very next request and\n * lands in the host's access logs, in `Referer` headers and in browser history.\n *\n * So the redirect keeps the path and the query and drops everything from the\n * `#`. There is nothing after it worth returning to anyway.\n *\n * One of the two phone apps had this and the other was passing `fullPath`\n * straight through, which is the leak above with nothing in the way of it. That\n * is the shape of bug a shared kit exists to end: it was fixed once, in the app\n * whose author happened to think of it.\n *\n * @example\n * ```ts\n * toRedirectPath('/ledger?direction=out')  // '/ledger?direction=out'\n * toRedirectPath('/#access_token=abc')     // '/'\n * ```\n */\nexport function toRedirectPath(fullPath: string): string {\n  const [path] = fullPath.split('#')\n\n  return path === undefined || path === '' ? '/' : path\n}\n","/**\n * A short vibration for a confirmed tap.\n *\n * Optional chaining is not decoration: iOS Safari has no `vibrate` at all, and\n * calling it unguarded would throw on every marked day.\n *\n * @param duration - Milliseconds. Keep it under ~15ms; longer reads as an alert.\n */\nexport function tapFeedback(duration = 10): void {\n  navigator.vibrate?.(duration)\n}\n","import { ref, watch } from 'vue'\nimport type { Ref } from 'vue'\n\n/** What the user asked for; `system` follows the OS. */\nexport type ThemePreference = 'system' | 'light' | 'dark'\n\n/**\n * Namespaced by the app, not by this package.\n *\n * Two rei-kit apps served from the same origin would otherwise share one theme\n * setting — and during development on localhost, they will be.\n */\nlet storageKey = 'rei-theme'\n\nexport function isThemePreference(value: unknown): value is ThemePreference {\n  return value === 'system' || value === 'light' || value === 'dark'\n}\n\n/** Reads the stored preference, falling back to `system`. */\nexport function readStoredTheme(): ThemePreference {\n  try {\n    const stored = localStorage.getItem(storageKey)\n\n    return isThemePreference(stored) ? stored : 'system'\n  } catch {\n    return 'system'\n  }\n}\n\nfunction storeTheme(preference: ThemePreference): void {\n  try {\n    localStorage.setItem(storageKey, preference)\n  } catch {\n    // Private mode or blocked storage: the choice just will not persist.\n  }\n}\n\n/**\n * Does the environment prefer a dark scheme?\n *\n * `matchMedia` is checked for on its own rather than inferred from `document`.\n * Having one does not imply having the other: jsdom supplies a document and no\n * `matchMedia`, so a consumer's component test that so much as mounts something\n * calling `useTheme` threw — and some embedded webviews are the same. Where\n * there is nothing to ask, the answer is no rather than an exception.\n */\nfunction prefersDarkScheme(): boolean {\n  return typeof window !== 'undefined' && typeof window.matchMedia === 'function'\n    ? window.matchMedia('(prefers-color-scheme: dark)').matches\n    : false\n}\n\n/**\n * Adds or removes `.dark` on `<html>`, resolving `system` against the OS.\n *\n * A no-op without a document. There is no OS preference to read on a server and\n * no `<html>` to write to, so a prerender leaves the class off and the app\n * decides the theme before hydration — see the note in the README.\n */\nexport function applyTheme(preference: ThemePreference): void {\n  if (typeof document === 'undefined') return\n\n  const isDark = preference === 'dark' || (preference === 'system' && prefersDarkScheme())\n\n  document.documentElement.classList.toggle('dark', isDark)\n}\n\n/**\n * The shared preference, created on first use rather than at import.\n *\n * Lazy on purpose: reading storage at import time would lock in the default key\n * before an app had a chance to set its own, leaving the controller reading one\n * key and writing another.\n */\nlet preference: Ref<ThemePreference> | null = null\n\nfunction controller(): Ref<ThemePreference> {\n  if (preference) return preference\n\n  preference = ref<ThemePreference>(readStoredTheme())\n\n  watch(\n    preference,\n    (next) => {\n      storeTheme(next)\n      applyTheme(next)\n    },\n    { immediate: true },\n  )\n\n  // While on `system`, follow the OS if the user flips it at night. Only where\n  // there is something to listen to; see `prefersDarkScheme`.\n  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {\n    window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {\n      if (preference?.value === 'system') applyTheme('system')\n    })\n  }\n\n  return preference\n}\n\n/**\n * Sets where the preference is stored.\n *\n * Safe in either order: called before the first `useTheme()` it simply changes\n * the key, and called after it re-reads under the new one, so the controller\n * never reads from one key while writing to another.\n *\n * @example\n * ```ts\n * setThemeStorageKey('hibi-theme')   // once, at startup\n * ```\n */\nexport function setThemeStorageKey(key: string): void {\n  storageKey = key\n  if (preference) preference.value = readStoredTheme()\n}\n\n/** @returns The shared preference ref; assigning to it stores and applies it. */\nexport function useTheme(): Ref<ThemePreference> {\n  return controller()\n}\n","import { onMounted, onUnmounted, readonly, ref } from 'vue'\n\n/**\n * Tracks whether the browser thinks it has a network connection.\n *\n * Note the limit: `navigator.onLine` only reports whether a network interface\n * is up, not whether requests actually succeed. Treat it as a hint for the UI,\n * never as a reason to skip error handling.\n *\n * Listeners are removed on unmount, so the composable is safe to call per view.\n *\n * @returns A readonly ref that flips with the browser's online/offline events.\n *\n * @example\n * ```ts\n * const isOnline = useOnline()\n * // <p v-if=\"!isOnline\">You're offline.</p>\n * ```\n */\nexport function useOnline() {\n  const isOnline = ref(true)\n\n  function update() {\n    isOnline.value = navigator.onLine\n  }\n\n  onMounted(() => {\n    update()\n    window.addEventListener('online', update)\n    window.addEventListener('offline', update)\n  })\n\n  onUnmounted(() => {\n    window.removeEventListener('online', update)\n    window.removeEventListener('offline', update)\n  })\n\n  return readonly(isOnline)\n}\n","import { readonly, ref } from 'vue'\n\n/**\n * Saying that something happened.\n *\n * The reason this exists is a measurement rather than a preference: the word\n * \"toast\" appeared **zero times** across all three consuming apps. Not because\n * they had decided against it — because there was no mechanism, so every save,\n * every delete and every export finished in silence and the only way to know\n * it had worked was that nothing had visibly broken.\n *\n * ── What is deliberately not here ──\n *\n * **No text.** The kit never knows a sentence. Callers pass the message; a\n * component that called a translator would force one on the app.\n *\n * **Not for form errors.** A field that was rejected says so beside itself,\n * where the reader's eye already is and where it stays until fixed. A toast\n * that disappears after four seconds is the wrong place for something the\n * reader has to act on. Use `BaseAlert` and `FormField` for those; use this\n * for what has already happened.\n *\n * **A singleton, on purpose.** Two hosts would mean two stacks racing for the\n * same corner. The store lives at module scope and `ToastHost` renders it.\n */\nexport type ToastTone = 'info' | 'success' | 'warning' | 'danger'\n\n/**\n * One button on a toast — nearly always \"Undo\".\n *\n * The toast is dismissed when it is pressed, so the handler only has to do\n * the undoing.\n */\nexport interface ToastAction {\n  /** The button's text. Already translated. */\n  readonly label: string\n  readonly onClick: () => void\n}\n\nexport interface Toast {\n  readonly id: number\n  readonly message: string\n  readonly tone: ToastTone\n  /** Milliseconds on screen. `0` stays until dismissed. */\n  readonly duration: number\n  readonly action?: ToastAction | undefined\n}\n\nexport interface ToastOptions {\n  /** Milliseconds on screen; `0` stays until dismissed. */\n  duration?: number | undefined\n  /**\n   * A button on the toast. An undo is the kindest confirmation there is: act\n   * first, and let the reader take it back, instead of asking \"are you sure\"\n   * before every delete.\n   */\n  action?: ToastAction | undefined\n}\n\n/**\n * Four seconds: long enough to read a short sentence twice, short enough that\n * a second action does not queue behind it.\n */\nconst DEFAULT_DURATION = 4000\n\n/**\n * A failure is read more slowly than a confirmation, and more often twice.\n */\nconst DANGER_DURATION = 7000\n\n/**\n * A toast with a button stays longer: the reader has to read it, decide and\n * reach the button. Four seconds is enough to read \"Deleted\", not to undo it.\n */\nconst ACTION_DURATION = 8000\n\n/**\n * Three at once. A fourth pushes the oldest out rather than growing the stack\n * off the top of the screen — an action that produces ten toasts is a loop,\n * and a loop should not be able to cover the app it is running in.\n */\nconst MAX_VISIBLE = 3\n\nconst items = ref<Toast[]>([])\n\nlet nextId = 0\n\ninterface Countdown {\n  handle: ReturnType<typeof setTimeout>\n  remaining: number\n  startedAt: number\n}\n\nconst countdowns = new Map<number, Countdown>()\n\nfunction clearCountdown(id: number): void {\n  const countdown = countdowns.get(id)\n  if (countdown === undefined) return\n\n  clearTimeout(countdown.handle)\n  countdowns.delete(id)\n}\n\n/** Removes a toast, whether it timed out or was dismissed. */\nfunction dismiss(id: number): void {\n  clearCountdown(id)\n  items.value = items.value.filter((item) => item.id !== id)\n}\n\n/** Removes everything on screen. For a route change, or a sign-out. */\nfunction dismissAll(): void {\n  for (const id of countdowns.keys()) clearCountdown(id)\n  items.value = []\n}\n\nfunction arm(id: number, remaining: number): void {\n  // A timer is a browser thing. On a server there is nothing to time and\n  // nothing to see, and arming one would keep the process alive past the last\n  // page — which is how a prerender build hangs instead of finishing.\n  if (typeof window === 'undefined' || remaining <= 0) return\n\n  countdowns.set(id, {\n    handle: setTimeout(() => dismiss(id), remaining),\n    remaining,\n    startedAt: Date.now(),\n  })\n}\n\n/**\n * Stops the clock on a toast the reader is pointing at.\n *\n * Somebody who has moved the pointer onto it is reading it, and taking it away\n * mid-sentence is the one thing a notification must not do.\n */\nfunction pause(id: number): void {\n  const countdown = countdowns.get(id)\n  if (countdown === undefined) return\n\n  clearTimeout(countdown.handle)\n  countdowns.set(id, {\n    ...countdown,\n    remaining: Math.max(0, countdown.remaining - (Date.now() - countdown.startedAt)),\n  })\n}\n\n/** Starts it again, from where it stopped rather than from the beginning. */\nfunction resume(id: number): void {\n  const countdown = countdowns.get(id)\n  if (countdown === undefined) return\n\n  arm(id, countdown.remaining)\n}\n\nfunction push(tone: ToastTone, message: string, options: ToastOptions = {}): number {\n  const id = ++nextId\n  const duration =\n    options.duration ??\n    (options.action ? ACTION_DURATION : tone === 'danger' ? DANGER_DURATION : DEFAULT_DURATION)\n\n  const next = [...items.value, { id, message, tone, duration, action: options.action }]\n\n  while (next.length > MAX_VISIBLE) {\n    const oldest = next.shift()\n    if (oldest !== undefined) clearCountdown(oldest.id)\n  }\n\n  items.value = next\n  arm(id, duration)\n\n  return id\n}\n\n/**\n * The stack, and the four ways to add to it.\n *\n * @example\n * ```ts\n * const toast = useToast()\n *\n * toast.success(t('habit.saved'))\n * toast.danger(t('common.failed'), { duration: 0 })  // stays until dismissed\n *\n * const id = toast.info(t('export.preparing'), { duration: 0 })\n * toast.dismiss(id)\n *\n * toast.success(t('entry.deleted'), {\n *   action: { label: t('common.undo'), onClick: () => restore(entry) },\n * })\n * ```\n */\nexport function useToast() {\n  return {\n    /** Every toast on screen, oldest first. `ToastHost` renders this. */\n    toasts: readonly(items),\n    info: (message: string, options?: ToastOptions) => push('info', message, options),\n    success: (message: string, options?: ToastOptions) => push('success', message, options),\n    warning: (message: string, options?: ToastOptions) => push('warning', message, options),\n    danger: (message: string, options?: ToastOptions) => push('danger', message, options),\n    dismiss,\n    dismissAll,\n    pause,\n    resume,\n  }\n}\n","<script setup lang=\"ts\">\nimport { computed } from 'vue'\n\n/**\n * A message the reader has to take in before carrying on.\n *\n * Roles rather than colours, like everything else here: `info` is neutral,\n * `success` confirms, `warning` is a condition to know about, `danger` is\n * something that went wrong or is about to. A component that took a hex would\n * be a component that ignores the theme, and the theme is the whole reason the\n * kit exists.\n *\n * `assertive` decides how a screen reader treats it: a failed save interrupts,\n * a note about a form field waits its turn. Getting this wrong is invisible on\n * screen and rude in a screen reader, which is why it is a prop and not a\n * guess.\n */\nconst { tone = 'info', assertive = false } = defineProps<{\n  tone?: 'info' | 'success' | 'warning' | 'danger' | undefined\n  /** Announce immediately, interrupting. For failures the reader must act on. */\n  assertive?: boolean | undefined\n}>()\n\nconst TONES = {\n  info: 'border-hair bg-muted/40 text-ink',\n  success: 'border-positive/35 bg-positive/8 text-ink',\n  warning: 'border-warning/40 bg-warning/8 text-ink',\n  danger: 'border-negative/35 bg-negative/8 text-ink',\n} as const\n\nconst MARKS = {\n  info: 'bg-ink-soft/15 text-ink-soft',\n  success: 'bg-positive/15 text-positive',\n  warning: 'bg-warning/15 text-warning',\n  danger: 'bg-negative/15 text-negative',\n} as const\n\nconst skin = computed(() => TONES[tone])\nconst mark = computed(() => MARKS[tone])\n</script>\n\n<template>\n  <div\n    class=\"rounded-card flex items-start gap-3 border px-4 py-3.5 text-sm leading-relaxed\"\n    :class=\"skin\"\n    :role=\"assertive ? 'alert' : 'status'\"\n    :aria-live=\"assertive ? 'assertive' : 'polite'\"\n  >\n    <span\n      v-if=\"$slots.mark\"\n      class=\"mt-px grid size-6 shrink-0 place-items-center rounded-full text-xs font-semibold\"\n      :class=\"mark\"\n      aria-hidden=\"true\"\n    >\n      <slot name=\"mark\" />\n    </span>\n\n    <div class=\"min-w-0 flex-1\">\n      <p v-if=\"$slots.title\" class=\"text-ink font-semibold\">\n        <slot name=\"title\" />\n      </p>\n      <div :class=\"$slots.title ? 'mt-1' : ''\"><slot /></div>\n    </div>\n\n    <slot name=\"action\" />\n  </div>\n</template>\n","<script setup lang=\"ts\">\nimport { computed } from 'vue'\n\n/**\n * A message the reader has to take in before carrying on.\n *\n * Roles rather than colours, like everything else here: `info` is neutral,\n * `success` confirms, `warning` is a condition to know about, `danger` is\n * something that went wrong or is about to. A component that took a hex would\n * be a component that ignores the theme, and the theme is the whole reason the\n * kit exists.\n *\n * `assertive` decides how a screen reader treats it: a failed save interrupts,\n * a note about a form field waits its turn. Getting this wrong is invisible on\n * screen and rude in a screen reader, which is why it is a prop and not a\n * guess.\n */\nconst { tone = 'info', assertive = false } = defineProps<{\n  tone?: 'info' | 'success' | 'warning' | 'danger' | undefined\n  /** Announce immediately, interrupting. For failures the reader must act on. */\n  assertive?: boolean | undefined\n}>()\n\nconst TONES = {\n  info: 'border-hair bg-muted/40 text-ink',\n  success: 'border-positive/35 bg-positive/8 text-ink',\n  warning: 'border-warning/40 bg-warning/8 text-ink',\n  danger: 'border-negative/35 bg-negative/8 text-ink',\n} as const\n\nconst MARKS = {\n  info: 'bg-ink-soft/15 text-ink-soft',\n  success: 'bg-positive/15 text-positive',\n  warning: 'bg-warning/15 text-warning',\n  danger: 'bg-negative/15 text-negative',\n} as const\n\nconst skin = computed(() => TONES[tone])\nconst mark = computed(() => MARKS[tone])\n</script>\n\n<template>\n  <div\n    class=\"rounded-card flex items-start gap-3 border px-4 py-3.5 text-sm leading-relaxed\"\n    :class=\"skin\"\n    :role=\"assertive ? 'alert' : 'status'\"\n    :aria-live=\"assertive ? 'assertive' : 'polite'\"\n  >\n    <span\n      v-if=\"$slots.mark\"\n      class=\"mt-px grid size-6 shrink-0 place-items-center rounded-full text-xs font-semibold\"\n      :class=\"mark\"\n      aria-hidden=\"true\"\n    >\n      <slot name=\"mark\" />\n    </span>\n\n    <div class=\"min-w-0 flex-1\">\n      <p v-if=\"$slots.title\" class=\"text-ink font-semibold\">\n        <slot name=\"title\" />\n      </p>\n      <div :class=\"$slots.title ? 'mt-1' : ''\"><slot /></div>\n    </div>\n\n    <slot name=\"action\" />\n  </div>\n</template>\n","<script setup lang=\"ts\">\nimport { computed, useId } from 'vue'\n\n/**\n * A label, a hint, an error, and the wiring between them.\n *\n * This was inside `BaseInput`, which is why the kit had one form control\n * instead of five. The hard part of a field is not the `<input>` — it is\n * generating an id, pointing the label at it, deciding whether the description\n * is the hint or the error, and telling assistive tech which one to read. That\n * is identical for a select, a textarea and an input, and every app that\n * needed one of the other two wrote the whole thing again.\n *\n * The control comes in through the slot and is handed what it needs to be\n * described. It is a slot rather than a prop so the field never has to know\n * what it is wrapping.\n *\n * @example\n * ```vue\n * <FormField :label=\"t('profile.name')\" :error=\"errors.name\">\n *   <template #default=\"{ id, describedBy, invalid }\">\n *     <input :id=\"id\" :aria-describedby=\"describedBy\" :aria-invalid=\"invalid\" />\n *   </template>\n * </FormField>\n * ```\n */\nconst {\n  label,\n  error = '',\n  hint = '',\n  labelHidden = false,\n  fieldId = undefined,\n  size = 'md',\n} = defineProps<{\n  label: string\n  error?: string | undefined\n  hint?: string | undefined\n  /**\n   * `sm` for a control that sits inside something else — a toolbar, a filter\n   * row, a settings line — rather than in a form of its own.\n   *\n   * It exists because every hand-written select in all three apps was the\n   * small one, and the kit only had the large one. A part is not reusable if\n   * reaching for it costs a size somebody chose on purpose.\n   */\n  size?: 'sm' | 'md' | undefined\n  /**\n   * Hides the label visually but keeps it for assistive tech. For fields whose\n   * surrounding row already names them — dropping the label entirely would\n   * leave the control with no accessible name at all.\n   */\n  labelHidden?: boolean | undefined\n  /**\n   * The control's `id`, when the app needs to address it from outside —\n   * an `ErrorSummary` linking to the field it is about, a label elsewhere\n   * on the page. Generated when it is not given, which is almost always.\n   */\n  fieldId?: string | undefined\n}>()\n\nconst generated = useId()\nconst id = computed(() => fieldId ?? generated)\nconst errorId = computed(() => `${id.value}-error`)\nconst hintId = computed(() => `${id.value}-hint`)\n\n/* One description at a time, and the error wins. Announcing the hint as well\n   buries the reason the field was rejected under advice the reader has already\n   had. */\nconst describedBy = computed(() => {\n  if (error) return errorId.value\n  if (hint) return hintId.value\n  return undefined\n})\n</script>\n\n<template>\n  <div class=\"flex flex-col\" :class=\"size === 'sm' ? 'gap-1' : 'gap-1.5'\">\n    <label\n      :for=\"id\"\n      class=\"font-medium\"\n      :class=\"[\n        labelHidden ? 'sr-only' : '',\n        size === 'sm' ? 'text-ink-soft text-xs' : 'text-ink text-sm',\n      ]\"\n    >\n      {{ label }}\n    </label>\n\n    <slot :id=\"id\" :described-by=\"describedBy\" :invalid=\"Boolean(error)\" :size=\"size\" />\n\n    <p v-if=\"error\" :id=\"errorId\" class=\"text-negative text-xs\">{{ error }}</p>\n    <p v-else-if=\"hint\" :id=\"hintId\" class=\"text-ink-soft text-xs\">{{ hint }}</p>\n  </div>\n</template>\n","<script setup lang=\"ts\">\nimport { computed, useId } from 'vue'\n\n/**\n * A label, a hint, an error, and the wiring between them.\n *\n * This was inside `BaseInput`, which is why the kit had one form control\n * instead of five. The hard part of a field is not the `<input>` — it is\n * generating an id, pointing the label at it, deciding whether the description\n * is the hint or the error, and telling assistive tech which one to read. That\n * is identical for a select, a textarea and an input, and every app that\n * needed one of the other two wrote the whole thing again.\n *\n * The control comes in through the slot and is handed what it needs to be\n * described. It is a slot rather than a prop so the field never has to know\n * what it is wrapping.\n *\n * @example\n * ```vue\n * <FormField :label=\"t('profile.name')\" :error=\"errors.name\">\n *   <template #default=\"{ id, describedBy, invalid }\">\n *     <input :id=\"id\" :aria-describedby=\"describedBy\" :aria-invalid=\"invalid\" />\n *   </template>\n * </FormField>\n * ```\n */\nconst {\n  label,\n  error = '',\n  hint = '',\n  labelHidden = false,\n  fieldId = undefined,\n  size = 'md',\n} = defineProps<{\n  label: string\n  error?: string | undefined\n  hint?: string | undefined\n  /**\n   * `sm` for a control that sits inside something else — a toolbar, a filter\n   * row, a settings line — rather than in a form of its own.\n   *\n   * It exists because every hand-written select in all three apps was the\n   * small one, and the kit only had the large one. A part is not reusable if\n   * reaching for it costs a size somebody chose on purpose.\n   */\n  size?: 'sm' | 'md' | undefined\n  /**\n   * Hides the label visually but keeps it for assistive tech. For fields whose\n   * surrounding row already names them — dropping the label entirely would\n   * leave the control with no accessible name at all.\n   */\n  labelHidden?: boolean | undefined\n  /**\n   * The control's `id`, when the app needs to address it from outside —\n   * an `ErrorSummary` linking to the field it is about, a label elsewhere\n   * on the page. Generated when it is not given, which is almost always.\n   */\n  fieldId?: string | undefined\n}>()\n\nconst generated = useId()\nconst id = computed(() => fieldId ?? generated)\nconst errorId = computed(() => `${id.value}-error`)\nconst hintId = computed(() => `${id.value}-hint`)\n\n/* One description at a time, and the error wins. Announcing the hint as well\n   buries the reason the field was rejected under advice the reader has already\n   had. */\nconst describedBy = computed(() => {\n  if (error) return errorId.value\n  if (hint) return hintId.value\n  return undefined\n})\n</script>\n\n<template>\n  <div class=\"flex flex-col\" :class=\"size === 'sm' ? 'gap-1' : 'gap-1.5'\">\n    <label\n      :for=\"id\"\n      class=\"font-medium\"\n      :class=\"[\n        labelHidden ? 'sr-only' : '',\n        size === 'sm' ? 'text-ink-soft text-xs' : 'text-ink text-sm',\n      ]\"\n    >\n      {{ label }}\n    </label>\n\n    <slot :id=\"id\" :described-by=\"describedBy\" :invalid=\"Boolean(error)\" :size=\"size\" />\n\n    <p v-if=\"error\" :id=\"errorId\" class=\"text-negative text-xs\">{{ error }}</p>\n    <p v-else-if=\"hint\" :id=\"hintId\" class=\"text-ink-soft text-xs\">{{ hint }}</p>\n  </div>\n</template>\n","<script setup lang=\"ts\" generic=\"T extends string | number | undefined = string\">\nimport type { InputHTMLAttributes } from 'vue'\n\nimport FormField from './FormField.vue'\nimport { useBoundValue } from '../composables/use-bound-value'\n\ndefineOptions({ inheritAttrs: false })\n\n/**\n * A text field with its label, hint and error already wired to it.\n *\n * Every attribute of a native input — `placeholder`, `autocomplete`,\n * `inputmode` — goes to the input itself, not to the wrapper around it.\n */\nconst {\n  modelValue = undefined,\n  label,\n  error = '',\n  hint = '',\n  type = 'text',\n  labelHidden = false,\n  size = 'md',\n  variant = 'default',\n} = defineProps<\n  {\n    /** The value, with `v-model`. Its type is whatever you bind. */\n    modelValue?: T | undefined\n    label: string\n    error?: string | undefined\n    hint?: string | undefined\n    /**\n     * Hides the label visually but keeps it for assistive tech. For fields whose\n     * surrounding row already names them — dropping the label entirely would\n     * leave the input with no accessible name at all.\n     */\n    labelHidden?: boolean | undefined\n    /**\n     * Every type a text field can be, because the ones missing were the ones\n     * apps needed: `date` and `search` were hand-written three times each and\n     * `url` twice, in files that already imported this component.\n     */\n    type?:\n      | 'text'\n      | 'email'\n      | 'password'\n      | 'number'\n      | 'search'\n      | 'tel'\n      | 'url'\n      | 'date'\n      | 'time'\n      | 'datetime-local'\n      | undefined\n    /** `sm` for a field inside a row rather than in a form of its own. */\n    size?: 'sm' | 'md' | undefined\n    /**\n     * `unstyled` keeps the wiring and drops the surface.\n     *\n     * The label, the generated id, `aria-describedby` and the error are what a\n     * field is; the border and the height are what it looks like. A search box\n     * inside a bordered row, a url field in an editor popover — those places\n     * were hand-writing the whole thing to avoid the appearance, and losing the\n     * wiring with it.\n     *\n     * The same reasoning as `BaseButton`'s `unstyled`, and the same test: a\n     * primitive is finished when the app can take its behaviour without its\n     * paint.\n     */\n    variant?: 'default' | 'unstyled' | undefined\n    /* The input's own attributes — `placeholder`, `autocomplete`, `inputmode` —\n     typed for strictTemplates and passed to the input through `$attrs`. Not\n     `size` and `type`, which are this component's own. */\n  } & /* @vue-ignore */ Omit<InputHTMLAttributes, 'size' | 'type'>\n>()\n\n/* The control keeps 16px at every size, and that is not a rounding of the\n   scale — it is the rule. iOS zooms the viewport when a text field it is\n   focusing has a font-size under 16px, and the page never zooms back. Both\n   phone consumers had written `input { font-size: 16px }` into their base\n   layer to stop exactly this, and a `text-sm` utility from here would have\n   overridden it in every app at once.\n\n   So `size` reaches the label and the spacing, through FormField, and leaves\n   the typing target alone. `BaseSelect` is free to shrink: a select opens a\n   native picker rather than a caret, and does not trigger the zoom. */\nconst CONTROL_CLASS = 'h-11 text-base'\n\n/**\n * A number field's value is a number.\n *\n * Typed to `string` alone, `type=\"number\"` forced the caller to keep a string\n * ref and convert on both sides of it — and a component you have to wrap in\n * order to use is one you write yourself instead, which is exactly what the\n * first numeric field tried to reach for it did.\n *\n * Generic rather than `string | number`, so the value is whatever the app\n * bound: a `ref('')` gets strings back and a `ref(0)` numbers, and a\n * `string | undefined` from a form library is accepted as it is.\n */\nconst emit = defineEmits<{ 'update:modelValue': [value: T] }>()\n// The destructured prop is typed by T's constraint, not by T itself — a\n// limit of destructuring in a generic component — so it is narrowed here.\nconst model = useBoundValue<T>(\n  () => modelValue as T | undefined,\n  (value) => emit('update:modelValue', value),\n)\n</script>\n\n<template>\n  <FormField :label=\"label\" :error=\"error\" :hint=\"hint\" :label-hidden=\"labelHidden\" :size=\"size\">\n    <template #default=\"{ id, describedBy, invalid }\">\n      <input\n        :id=\"id\"\n        v-model=\"model\"\n        :type=\"type\"\n        :aria-invalid=\"invalid\"\n        :aria-describedby=\"describedBy\"\n        v-bind=\"$attrs\"\n        :class=\"[\n          variant === 'unstyled'\n            ? ''\n            : 'control text-ink rounded-card focus-visible:outline-primary px-3 focus-visible:outline-2 focus-visible:outline-offset-1',\n          variant === 'unstyled' ? 'text-base' : CONTROL_CLASS,\n          variant !== 'unstyled' && invalid ? 'border-negative' : '',\n        ]\"\n      />\n    </template>\n  </FormField>\n</template>\n","<script setup lang=\"ts\" generic=\"T extends string | number | undefined = string\">\nimport type { InputHTMLAttributes } from 'vue'\n\nimport FormField from './FormField.vue'\nimport { useBoundValue } from '../composables/use-bound-value'\n\ndefineOptions({ inheritAttrs: false })\n\n/**\n * A text field with its label, hint and error already wired to it.\n *\n * Every attribute of a native input — `placeholder`, `autocomplete`,\n * `inputmode` — goes to the input itself, not to the wrapper around it.\n */\nconst {\n  modelValue = undefined,\n  label,\n  error = '',\n  hint = '',\n  type = 'text',\n  labelHidden = false,\n  size = 'md',\n  variant = 'default',\n} = defineProps<\n  {\n    /** The value, with `v-model`. Its type is whatever you bind. */\n    modelValue?: T | undefined\n    label: string\n    error?: string | undefined\n    hint?: string | undefined\n    /**\n     * Hides the label visually but keeps it for assistive tech. For fields whose\n     * surrounding row already names them — dropping the label entirely would\n     * leave the input with no accessible name at all.\n     */\n    labelHidden?: boolean | undefined\n    /**\n     * Every type a text field can be, because the ones missing were the ones\n     * apps needed: `date` and `search` were hand-written three times each and\n     * `url` twice, in files that already imported this component.\n     */\n    type?:\n      | 'text'\n      | 'email'\n      | 'password'\n      | 'number'\n      | 'search'\n      | 'tel'\n      | 'url'\n      | 'date'\n      | 'time'\n      | 'datetime-local'\n      | undefined\n    /** `sm` for a field inside a row rather than in a form of its own. */\n    size?: 'sm' | 'md' | undefined\n    /**\n     * `unstyled` keeps the wiring and drops the surface.\n     *\n     * The label, the generated id, `aria-describedby` and the error are what a\n     * field is; the border and the height are what it looks like. A search box\n     * inside a bordered row, a url field in an editor popover — those places\n     * were hand-writing the whole thing to avoid the appearance, and losing the\n     * wiring with it.\n     *\n     * The same reasoning as `BaseButton`'s `unstyled`, and the same test: a\n     * primitive is finished when the app can take its behaviour without its\n     * paint.\n     */\n    variant?: 'default' | 'unstyled' | undefined\n    /* The input's own attributes — `placeholder`, `autocomplete`, `inputmode` —\n     typed for strictTemplates and passed to the input through `$attrs`. Not\n     `size` and `type`, which are this component's own. */\n  } & /* @vue-ignore */ Omit<InputHTMLAttributes, 'size' | 'type'>\n>()\n\n/* The control keeps 16px at every size, and that is not a rounding of the\n   scale — it is the rule. iOS zooms the viewport when a text field it is\n   focusing has a font-size under 16px, and the page never zooms back. Both\n   phone consumers had written `input { font-size: 16px }` into their base\n   layer to stop exactly this, and a `text-sm` utility from here would have\n   overridden it in every app at once.\n\n   So `size` reaches the label and the spacing, through FormField, and leaves\n   the typing target alone. `BaseSelect` is free to shrink: a select opens a\n   native picker rather than a caret, and does not trigger the zoom. */\nconst CONTROL_CLASS = 'h-11 text-base'\n\n/**\n * A number field's value is a number.\n *\n * Typed to `string` alone, `type=\"number\"` forced the caller to keep a string\n * ref and convert on both sides of it — and a component you have to wrap in\n * order to use is one you write yourself instead, which is exactly what the\n * first numeric field tried to reach for it did.\n *\n * Generic rather than `string | number`, so the value is whatever the app\n * bound: a `ref('')` gets strings back and a `ref(0)` numbers, and a\n * `string | undefined` from a form library is accepted as it is.\n */\nconst emit = defineEmits<{ 'update:modelValue': [value: T] }>()\n// The destructured prop is typed by T's constraint, not by T itself — a\n// limit of destructuring in a generic component — so it is narrowed here.\nconst model = useBoundValue<T>(\n  () => modelValue as T | undefined,\n  (value) => emit('update:modelValue', value),\n)\n</script>\n\n<template>\n  <FormField :label=\"label\" :error=\"error\" :hint=\"hint\" :label-hidden=\"labelHidden\" :size=\"size\">\n    <template #default=\"{ id, describedBy, invalid }\">\n      <input\n        :id=\"id\"\n        v-model=\"model\"\n        :type=\"type\"\n        :aria-invalid=\"invalid\"\n        :aria-describedby=\"describedBy\"\n        v-bind=\"$attrs\"\n        :class=\"[\n          variant === 'unstyled'\n            ? ''\n            : 'control text-ink rounded-card focus-visible:outline-primary px-3 focus-visible:outline-2 focus-visible:outline-offset-1',\n          variant === 'unstyled' ? 'text-base' : CONTROL_CLASS,\n          variant !== 'unstyled' && invalid ? 'border-negative' : '',\n        ]\"\n      />\n    </template>\n  </FormField>\n</template>\n","<script setup lang=\"ts\">\n/**\n * Sign in with Google, in Google's own clothes.\n *\n * The mark is inlined rather than themed, and that is not an oversight: Google's\n * brand guidelines require their colours, and a reader scanning for the button\n * they already know is scanning for those exact four. It is the one component\n * here that carries a colour value, and the reason is written on the path.\n */\nconst { label, disabled = false } = defineProps<{\n  label: string\n  /**\n   * Greyed out and unclickable while a sign-in is already in flight.\n   *\n   * A real prop rather than a fallthrough attribute: the button needs to look\n   * disabled as well as be it, and a bare `disabled` landing on the element by\n   * itself gets the second half only.\n   */\n  disabled?: boolean | undefined\n}>()\n\nconst emit = defineEmits<{ click: [] }>()\n</script>\n\n<template>\n  <button\n    type=\"button\"\n    :disabled=\"disabled\"\n    class=\"control text-ink rounded-card hover:bg-muted focus-ring flex h-11 w-full items-center justify-center gap-2 text-sm font-medium transition-colors duration-(--duration-fast) active:scale-(--press-scale) disabled:pointer-events-none disabled:opacity-50\"\n    @click=\"emit('click')\"\n  >\n    <!-- Google asks for its own mark, so it is inlined rather than themed. -->\n    <svg class=\"size-4\" viewBox=\"0 0 48 48\" aria-hidden=\"true\">\n      <path\n        fill=\"#EA4335\"\n        d=\"M24 9.5c3.5 0 6.6 1.2 9 3.6l6.7-6.7C35.6 2.7 30.2.5 24 .5 14.6.5 6.5 5.9 2.6 13.7l7.8 6.1C12.3 13.7 17.7 9.5 24 9.5z\"\n      />\n      <path\n        fill=\"#4285F4\"\n        d=\"M46.5 24.5c0-1.6-.1-3.1-.4-4.5H24v9h12.7c-.6 3-2.3 5.6-4.9 7.3l7.6 5.9c4.4-4.1 7.1-10.2 7.1-17.7z\"\n      />\n      <path\n        fill=\"#FBBC05\"\n        d=\"M10.4 28.2a14.6 14.6 0 0 1 0-8.4l-7.8-6.1a24 24 0 0 0 0 20.6l7.8-6.1z\"\n      />\n      <path\n        fill=\"#34A853\"\n        d=\"M24 47.5c6.2 0 11.5-2 15.4-5.6l-7.6-5.9c-2.1 1.4-4.8 2.3-7.8 2.3-6.3 0-11.7-4.2-13.6-10l-7.8 6.1C6.5 42.1 14.6 47.5 24 47.5z\"\n      />\n    </svg>\n    {{ label }}\n  </button>\n</template>\n","<script setup lang=\"ts\">\n/**\n * Sign in with Google, in Google's own clothes.\n *\n * The mark is inlined rather than themed, and that is not an oversight: Google's\n * brand guidelines require their colours, and a reader scanning for the button\n * they already know is scanning for those exact four. It is the one component\n * here that carries a colour value, and the reason is written on the path.\n */\nconst { label, disabled = false } = defineProps<{\n  label: string\n  /**\n   * Greyed out and unclickable while a sign-in is already in flight.\n   *\n   * A real prop rather than a fallthrough attribute: the button needs to look\n   * disabled as well as be it, and a bare `disabled` landing on the element by\n   * itself gets the second half only.\n   */\n  disabled?: boolean | undefined\n}>()\n\nconst emit = defineEmits<{ click: [] }>()\n</script>\n\n<template>\n  <button\n    type=\"button\"\n    :disabled=\"disabled\"\n    class=\"control text-ink rounded-card hover:bg-muted focus-ring flex h-11 w-full items-center justify-center gap-2 text-sm font-medium transition-colors duration-(--duration-fast) active:scale-(--press-scale) disabled:pointer-events-none disabled:opacity-50\"\n    @click=\"emit('click')\"\n  >\n    <!-- Google asks for its own mark, so it is inlined rather than themed. -->\n    <svg class=\"size-4\" viewBox=\"0 0 48 48\" aria-hidden=\"true\">\n      <path\n        fill=\"#EA4335\"\n        d=\"M24 9.5c3.5 0 6.6 1.2 9 3.6l6.7-6.7C35.6 2.7 30.2.5 24 .5 14.6.5 6.5 5.9 2.6 13.7l7.8 6.1C12.3 13.7 17.7 9.5 24 9.5z\"\n      />\n      <path\n        fill=\"#4285F4\"\n        d=\"M46.5 24.5c0-1.6-.1-3.1-.4-4.5H24v9h12.7c-.6 3-2.3 5.6-4.9 7.3l7.6 5.9c4.4-4.1 7.1-10.2 7.1-17.7z\"\n      />\n      <path\n        fill=\"#FBBC05\"\n        d=\"M10.4 28.2a14.6 14.6 0 0 1 0-8.4l-7.8-6.1a24 24 0 0 0 0 20.6l7.8-6.1z\"\n      />\n      <path\n        fill=\"#34A853\"\n        d=\"M24 47.5c6.2 0 11.5-2 15.4-5.6l-7.6-5.9c-2.1 1.4-4.8 2.3-7.8 2.3-6.3 0-11.7-4.2-13.6-10l-7.8 6.1C6.5 42.1 14.6 47.5 24 47.5z\"\n      />\n    </svg>\n    {{ label }}\n  </button>\n</template>\n","import { nextTick, readonly, ref } from 'vue'\n\n/**\n * Saying something to a screen reader when nothing on screen has changed\n * enough to say it.\n *\n * The kit already has a live region in a dozen places — `ToastHost`,\n * `BaseSpinner`, `OfflineBanner`, `CopyButton` — but every one of them\n * belongs to a component that happens to be on screen. What has no home is\n * everything else: a filter that narrows a list to three results, a route\n * that changed under a client-side navigation, a draft that saved itself.\n * On screen all of those are obvious. To a reader they are silence.\n *\n * ── Three things this gets right that a hand-written region does not ──\n *\n * **The region exists before the text does.** A live region inserted into\n * the page together with its first message is usually not announced at\n * all: the reader has nothing to notice a change *to*. So `AnnounceHost`\n * renders both regions empty, from mount, and only the text inside them\n * ever changes. This is the single most common reason a hand-rolled\n * announcement does nothing, and it fails silently on every platform.\n *\n * **The same sentence twice is still said twice.** \"3 results\" after\n * \"3 results\" is not a mutation, so a reader says nothing — and the reader\n * has no idea the filter did anything. The text is cleared and set again\n * on the next tick, which is a change either way.\n *\n * **Polite by default.** `assertive` interrupts whatever is being read,\n * mid-word. That is right for \"connection lost\" and rude for \"saved\", and\n * a region that is always assertive trains the reader to resent it.\n *\n * ── What is deliberately not here ──\n *\n * **No text of its own.** Like everything else in the kit, the sentence is\n * the app's.\n *\n * **Not for anything on screen.** If there is a visible message, it should\n * be the live region — `BaseAlert`, `FormField`, a toast. This is only for\n * what a sighted reader learns from the screen itself.\n *\n * **A singleton, on purpose.** Two hosts would be two regions, and a\n * message would be read twice.\n *\n * @example\n * ```ts\n * const { announce } = useAnnounce()\n * watch(results, (rows) => announce(t('search.found', { count: rows.length })))\n * ```\n */\nexport interface AnnounceOptions {\n  /**\n   * Interrupt whatever is being read. For something the reader has to know\n   * now — a connection lost, a session about to expire — and nothing else.\n   */\n  assertive?: boolean | undefined\n}\n\nconst polite = ref('')\nconst assertive = ref('')\n\n/** Long enough to be read, short enough that a reader landing in the region\n *  later does not find a sentence about something that has since changed. */\nconst CLEAR_AFTER_MS = 7000\n\nlet timer: ReturnType<typeof setTimeout> | undefined\n\n/**\n * Says something once. Render one `AnnounceHost` in the app for it to reach a\n * reader at all.\n */\nexport function announce(message: string, { assertive: urgent = false }: AnnounceOptions = {}) {\n  const target = urgent ? assertive : polite\n\n  if (timer !== undefined) clearTimeout(timer)\n\n  /* Cleared first, then set on the next tick. Setting the same string again\n     is not a change, and a reader announces changes — so without this, the\n     second \"3 results\" is silence. */\n  polite.value = ''\n  assertive.value = ''\n\n  void nextTick(() => {\n    target.value = message\n\n    timer = setTimeout(() => {\n      target.value = ''\n      timer = undefined\n    }, CLEAR_AFTER_MS)\n  })\n}\n\nexport function useAnnounce() {\n  return {\n    announce,\n    /** What the regions are saying. `AnnounceHost` renders these; apps read them in tests. */\n    polite: readonly(polite),\n    assertive: readonly(assertive),\n  }\n}\n"],"mappings":"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"}

package/dist/utils/direction.d.ts

@@ -0,0 +1,59 @@
+/** Which way a language is written. */
+export type TextDirection = 'ltr' | 'rtl';
+/**
+ * Which way a locale tag is written.
+ *
+ * The kit is built on logical properties and `start`/`end` props all the
+ * way through — `BaseDrawer`'s side, every inset, every margin — and none
+ * of that does anything at all until `dir` is set on the document. So the
+ * direction has to come from somewhere, and a locale tag is the only thing
+ * that knows it.
+ *
+ * Only the language subtag is read, so `ar-EG` and `ar` answer the same.
+ *
+ * @example
+ * ```ts
+ * textDirection('he-IL') // 'rtl'
+ * textDirection('tr') // 'ltr'
+ * ```
+ */
+export declare function textDirection(locale: string): TextDirection;
+/**
+ * Which way the text around an element runs.
+ *
+ * The companion to `textDirection`, and the other end of it: that one asks
+ * a locale, this one asks the page. An element inside a quoted passage may
+ * run the other way from the document it is in, so the nearest `dir`
+ * attribute wins and the document is the fallback.
+ *
+ * The attribute rather than `getComputedStyle().direction`: the computed
+ * value is the real answer, but it is inherited through the cascade, and
+ * jsdom does not inherit it — so the tests that exist to prove the
+ * right-to-left behaviour would all pass with the behaviour removed. What
+ * actually sets the direction in this kit is the attribute, in one place,
+ * on `<html>`, written by `createI18nRuntime`.
+ */
+export declare function elementDirection(from: Element | null | undefined): TextDirection;
+/**
+ * `ArrowLeft` and `ArrowRight` as a direction of travel: `-1` back through
+ * a list, `1` on through it, `0` for any other key.
+ *
+ * They are mirrored where the writing is, which is not a nicety — it is the
+ * whole of what the arrows mean. A row of tabs in Arabic runs right to
+ * left, so the tab to the *left* of the current one is the next one, and a
+ * handler that reads `ArrowRight` as "forward" walks backwards through
+ * every roving-tabindex control in the kit at once. WAI-ARIA says so
+ * explicitly, and it is invisible to every check: the code type-checks, the
+ * styles are all logical, and the keys are the same keys.
+ *
+ * @example
+ * ```ts
+ * function onKeydown(event: KeyboardEvent) {
+ *   const step = horizontalStep(event.key, event.currentTarget as Element)
+ *   if (step === 0) return
+ *   event.preventDefault()
+ *   moveTo(index + step)
+ * }
+ * ```
+ */
+export declare function horizontalStep(key: string, from: Element | null | undefined): -1 | 0 | 1;

package/dist/utils/focus-target.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Moves focus to an element that was never meant to take it.
+ *
+ * A `<main>`, a heading, the top of a view: none of them are focusable, and
+ * both places the kit needs this — `SkipLink` and `createRouteAnnouncer` —
+ * fail in the same invisible way without it. A skip link scrolls the page
+ * and leaves focus in the header; a route change swaps the content and
+ * leaves focus on the link that is no longer there.
+ *
+ * `tabindex="-1"` makes the element focusable by script and never by Tab,
+ * which is the whole trick. It is left behind rather than cleaned up: a
+ * reader that moves out and comes back would otherwise find an unfocusable
+ * target the second time.
+ *
+ * @param target - The element, or the `id` of one. A missing one is a no-op.
+ * @returns Whether focus moved, so a caller can fall back.
+ */
+export declare function focusTarget(target: Element | string | null): boolean;

package/dist/web/SkipLink.vue.d.ts

@@ -0,0 +1,43 @@
+/**
+ * "Skip to content" — the first thing in the tab order, hidden until it has
+ * focus.
+ *
+ * ## Why this is in the kit at all
+ *
+ * The kit ships `NavLinks` and `MegaMenu`, which is to say it ships the
+ * thing that creates the need: the same header on every page, and a
+ * keyboard going through all of it again after every navigation. Bypassing
+ * a repeated block is WCAG 2.4.1, Level A, and the answer is four lines
+ * nobody writes because nothing on screen is missing without them.
+ *
+ * ## The part that is usually broken
+ *
+ * `<a href="#main">` scrolls the page and, in most browsers, leaves focus
+ * exactly where it was — on the link, still inside the header. The next
+ * Tab goes to the second nav item and the link has done nothing at all,
+ * while looking like it worked. So this moves focus itself: it gives the
+ * target `tabindex="-1"` on the way, which makes it focusable by script
+ * and never by Tab, and focuses it.
+ *
+ * `-1` is left on the target afterwards rather than cleaned up. Removing
+ * it is the tidier-looking choice and the wrong one: a reader that moves
+ * back out and in again would find an unfocusable target the second time.
+ *
+ * ## Hidden, not absent
+ *
+ * It is clipped to a pixel rather than `display: none` or
+ * `visibility: hidden`, because both of those take it out of the tab order
+ * as well — a skip link that cannot be focused is a skip link that does not
+ * exist. It becomes visible on `:focus-visible`, which is what puts it on
+ * screen for the keyboard that needs it and keeps it off screen for
+ * everyone else.
+ */
+type __VLS_Props = {
+    /** The `id` of what to skip to, usually the page's `<main>`. Without the `#`. */
+    for: string;
+    /** What it says, e.g. "İçeriğe geç". Already translated. */
+    label: string;
+};
+declare const __VLS_export: 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: typeof __VLS_export;
+export default _default;

package/dist/web/index.d.ts

@@ -84,3 +84,9 @@ export { default as MegaMenu } from './MegaMenu.vue';
 export type { MegaMenuColumn, MegaMenuItem, MegaMenuLink } from './MegaMenu.vue';
 export { default as NavLinks } from './NavLinks.vue';
 export type { NavLinkItem } from './NavLinks.vue';
+/**
+ * `SkipLink`, the first thing in the tab order. The kit ships the header
+ * that creates the need for it — bypassing a repeated block is WCAG 2.4.1,
+ * Level A — and it moves focus itself rather than trusting the fragment.
+ */
+export { default as SkipLink } from './SkipLink.vue';