@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/kit/context.js

@@ -0,0 +1,46 @@
+import { classes } from "../classes.js";
+import { KIT_MESSAGES } from "./messages.js";
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/kit/context.tsx
+const KitContext = createContext({
+	classNames: void 0,
+	messages: KIT_MESSAGES,
+	locale: void 0,
+	code: "en-US"
+});
+/**
+* Gives the primitives under it the host's classes, words and language; without it they are
+* the package's, in English.
+*/
+function KitProvider({ classNames, messages, locale, children }) {
+	const scope = {
+		classNames,
+		messages: {
+			...KIT_MESSAGES,
+			...messages
+		},
+		locale,
+		code: locale?.code ?? "en-US"
+	};
+	return /* @__PURE__ */ jsx(KitContext, {
+		value: scope,
+		children
+	});
+}
+function useKit() {
+	return useContext(KitContext);
+}
+/** The classes of the kit's parts, each with the host's own under it. */
+function useParts() {
+	const { classNames } = useKit();
+	return (...parts) => classes(classNames, ...parts);
+}
+/** A part's classes and the caller's own, as one `className`. */
+function joined(...names) {
+	return names.filter(Boolean).join(" ");
+}
+//#endregion
+export { KitProvider, joined, useKit, useParts };
+
+//# sourceMappingURL=context.js.map

package/dist/kit/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../src/kit/context.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\n\nimport { classes } from \"../classes\";\nimport { KIT_MESSAGES, type KitLocale, type KitMessages } from \"./messages\";\n\n/**\n * The kit's parts, by the class each carries: one BEM family per primitive. `classNames` adds a\n * host's own under the same keys, so a host styles every place a primitive appears at once.\n * (`sc-card` is the Ficha's; the kit's card is `sc-panel`.)\n */\nexport type KitPart =\n  | \"sc-panel\"\n  | \"sc-panel__head\"\n  | \"sc-panel__head--image\"\n  | \"sc-panel__heading\"\n  | \"sc-panel__title\"\n  | \"sc-panel__subtitle\"\n  | \"sc-list\"\n  | \"sc-row\"\n  | \"sc-row--quiet\"\n  | \"sc-row--pressed\"\n  | \"sc-row__main\"\n  | \"sc-row__text\"\n  | \"sc-row__title\"\n  | \"sc-row__subtitle\"\n  | \"sc-row__error\"\n  | \"sc-row__meta\"\n  | \"sc-row__trailing\"\n  | \"sc-mark\"\n  | \"sc-mark--logo\"\n  | \"sc-mark--photo\"\n  | \"sc-mark--round\"\n  | \"sc-tiles\"\n  | \"sc-tiles__grid\"\n  | \"sc-tile\"\n  | \"sc-tile--quiet\"\n  | \"sc-tile__main\"\n  | \"sc-tile__count\"\n  | \"sc-tile__title\"\n  | \"sc-stack\"\n  | \"sc-stack__item\"\n  | \"sc-stack__more\"\n  | \"sc-tag\"\n  | \"sc-tag--info\"\n  | \"sc-tag--success\"\n  | \"sc-tag--warning\"\n  | \"sc-tag--danger\"\n  | \"sc-stat\"\n  | \"sc-stat--info\"\n  | \"sc-stat--success\"\n  | \"sc-stat--warning\"\n  | \"sc-stat--danger\"\n  | \"sc-stat__label\"\n  | \"sc-stat__value\"\n  | \"sc-stat__hint\"\n  | \"sc-stats\"\n  | \"sc-stats__grid\"\n  | \"sc-chart\"\n  | \"sc-chart--bar\"\n  | \"sc-chart--line\"\n  | \"sc-chart__row\"\n  | \"sc-chart__label\"\n  | \"sc-chart__track\"\n  | \"sc-chart__bar\"\n  | \"sc-chart__value\"\n  | \"sc-chart__top\"\n  | \"sc-chart__plot\"\n  | \"sc-chart__wash\"\n  | \"sc-chart__axis\"\n  | \"sc-chart__line\"\n  | \"sc-chart__dot\"\n  | \"sc-chart__tip\"\n  | \"sc-chart__ends\"\n  | \"sc-chart__data\"\n  | \"sc-note\"\n  | \"sc-note--info\"\n  | \"sc-note--success\"\n  | \"sc-note--warning\"\n  | \"sc-note--danger\"\n  | \"sc-note__body\"\n  | \"sc-button\"\n  | \"sc-button--primary\"\n  | \"sc-button--neutral\"\n  | \"sc-button--danger\"\n  | \"sc-button--ghost\"\n  | \"sc-button--sm\"\n  | \"sc-button--icon\"\n  | \"sc-switch\"\n  | \"sc-audio\"\n  | \"sc-audio--compact\"\n  | \"sc-audio__play\"\n  | \"sc-audio__wave\"\n  | \"sc-audio__time\"\n  | \"sc-field\"\n  | \"sc-field__label\"\n  | \"sc-field__optional\"\n  | \"sc-field__help\"\n  | \"sc-field__error\"\n  | \"sc-control\"\n  | \"sc-control--trigger\"\n  | \"sc-control__input\"\n  | \"sc-control__unit\"\n  | \"sc-control__steppers\"\n  | \"sc-control__reveal\"\n  | \"sc-control__tag\"\n  | \"sc-check\"\n  | \"sc-popover\"\n  | \"sc-listbox\"\n  | \"sc-listbox__item\"\n  | \"sc-listbox__empty\"\n  | \"sc-calendar\"\n  | \"sc-picks\"\n  | \"sc-segments\"\n  | \"sc-pick\"\n  | \"sc-chips\"\n  | \"sc-chip\"\n  | \"sc-slots\"\n  | \"sc-moment\"\n  | \"sc-range\"\n  | \"sc-rating\"\n  | \"sc-upload\"\n  | \"sc-upload__zone\"\n  | \"sc-upload__icon\"\n  | \"sc-upload__text\"\n  | \"sc-attachments\"\n  | \"sc-attachment\"\n  | \"sc-attachment--failed\"\n  | \"sc-attachment__main\"\n  | \"sc-attachment__text\"\n  | \"sc-attachment__name\"\n  | \"sc-attachment__meta\"\n  | \"sc-attachment__action\"\n  | \"sc-attachment__bar\"\n  | \"sc-orb\"\n  | \"sc-orb--idle\"\n  | \"sc-orb--listening\"\n  | \"sc-orb--thinking\"\n  | \"sc-orb--speaking\"\n  | \"sc-orb--still\"\n  | \"sc-orb--loading\"\n  | \"sc-orb__ring\"\n  | \"sc-orb__core\"\n  | \"sc-automation\"\n  | \"sc-automation--gone\"\n  | \"sc-automation__head\"\n  | \"sc-automation__heading\"\n  | \"sc-automation__title\"\n  | \"sc-automation__when\"\n  | \"sc-automation__end\"\n  | \"sc-automation__dot\"\n  | \"sc-automation__summary\"\n  | \"sc-automation__section\"\n  | \"sc-automation__label\"\n  | \"sc-automation__steps\"\n  | \"sc-automation__step\"\n  | \"sc-automation__number\"\n  | \"sc-automation__name\"\n  | \"sc-automation__uses\"\n  | \"sc-automation__use\"\n  | \"sc-automation__board\"\n  | \"sc-automation__more\"\n  | \"sc-automation__runs\"\n  | \"sc-automation__run--open\"\n  | \"sc-automation__status\"\n  | \"sc-automation__empty\"\n  | \"sc-run\"\n  | \"sc-run__head\"\n  | \"sc-run__by\"\n  | \"sc-run__end\"\n  | \"sc-run__took\"\n  | \"sc-run__heading\"\n  | \"sc-run__title\"\n  | \"sc-run__meta\"\n  | \"sc-run__summary\"\n  | \"sc-run__section\"\n  | \"sc-run__label\"\n  | \"sc-run__steps\"\n  | \"sc-run__step\"\n  | \"sc-run__number\"\n  | \"sc-run__name\"\n  | \"sc-run__calls\"\n  | \"sc-run__call\"\n  | \"sc-run__call--would\"\n  | \"sc-run__call--failed\"\n  | \"sc-run__count\"\n  | \"sc-run__error\"\n  | \"sc-run__live\"\n  | \"sc-run__links\"\n  | \"sc-run__empty\";\n\nexport type KitClassNames = Partial<Record<KitPart, string>> | undefined;\n\n/** What every primitive under one host shares: its classes, its words, its language. */\ninterface KitScope {\n  classNames: KitClassNames;\n  messages: KitMessages;\n  locale: KitLocale | undefined;\n  /** The locale's code, for Intl: \"es\", \"en-US\". */\n  code: string;\n}\n\nconst KitContext = createContext<KitScope>({\n  classNames: undefined,\n  messages: KIT_MESSAGES,\n  locale: undefined,\n  code: \"en-US\",\n});\n\n/**\n * Gives the primitives under it the host's classes, words and language; without it they are\n * the package's, in English.\n */\nexport function KitProvider({\n  classNames,\n  messages,\n  locale,\n  children,\n}: {\n  classNames?: KitClassNames;\n  messages?: Partial<KitMessages> | undefined;\n  locale?: KitLocale | undefined;\n  children: ReactNode;\n}) {\n  const scope: KitScope = {\n    classNames,\n    messages: { ...KIT_MESSAGES, ...messages },\n    locale,\n    code: locale?.code ?? \"en-US\",\n  };\n  return <KitContext value={scope}>{children}</KitContext>;\n}\n\nexport function useKit(): KitScope {\n  return useContext(KitContext);\n}\n\n/** The classes of the kit's parts, each with the host's own under it. */\nexport function useParts(): (...parts: KitPart[]) => string {\n  const { classNames } = useKit();\n  return (...parts) => classes(classNames, ...parts);\n}\n\n/** A part's classes and the caller's own, as one `className`. */\nexport function joined(...names: (string | false | undefined)[]): string {\n  return names.filter(Boolean).join(\" \");\n}\n"],"mappings":";;;;;AAyMA,MAAM,aAAa,cAAwB;CACzC,YAAY,KAAA;CACZ,UAAU;CACV,QAAQ,KAAA;CACR,MAAM;AACR,CAAC;;;;;AAMD,SAAgB,YAAY,EAC1B,YACA,UACA,QACA,YAMC;CACD,MAAM,QAAkB;EACtB;EACA,UAAU;GAAE,GAAG;GAAc,GAAG;EAAS;EACzC;EACA,MAAM,QAAQ,QAAQ;CACxB;CACA,OAAO,oBAAC,YAAD;EAAY,OAAO;EAAQ;CAAqB,CAAA;AACzD;AAEA,SAAgB,SAAmB;CACjC,OAAO,WAAW,UAAU;AAC9B;;AAGA,SAAgB,WAA4C;CAC1D,MAAM,EAAE,eAAe,OAAO;CAC9B,QAAQ,GAAG,UAAU,QAAQ,YAAY,GAAG,KAAK;AACnD;;AAGA,SAAgB,OAAO,GAAG,OAA+C;CACvE,OAAO,MAAM,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;AACvC"}

package/dist/kit/dates.d.ts

@@ -0,0 +1,14 @@
+//#region src/kit/dates.d.ts
+/**
+ * Days and times as the kit's controls hold them, "YYYY-MM-DD", "HH:MM" and
+ * "YYYY-MM-DDTHH:MM", as pure functions: reading them, writing them in a language, and which
+ * of them a control offers.
+ */
+/** What bounds a day: the only days to pick, and the first and last. */
+export interface DayBounds {
+  dates?: string[] | undefined;
+  earliest?: string | undefined;
+  latest?: string | undefined;
+}
+//#endregion
+//# sourceMappingURL=dates.d.ts.map

package/dist/kit/dates.js

@@ -0,0 +1,129 @@
+//#region src/kit/dates.ts
+const DAY = /^\d{4}-\d{2}-\d{2}$/;
+const TIME = /^([01]\d|2[0-3]):[0-5]\d$/;
+const MOMENT = /^\d{4}-\d{2}-\d{2}T([01]\d|2[0-3]):[0-5]\d$/;
+/** A day "YYYY-MM-DD" as a local date, or null. */
+function dayOf(iso) {
+	if (!DAY.test(iso)) return null;
+	const [year = 0, month = 1, day = 1] = iso.split("-").map(Number);
+	const date = new Date(year, month - 1, day);
+	return date.getMonth() === month - 1 ? date : null;
+}
+/** A local date as "YYYY-MM-DD". */
+function isoDay(date) {
+	const pad = (n) => String(n).padStart(2, "0");
+	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+/** A day in words: its weekday, day and month, and its year when not this one. */
+function formatDay(iso, code, today = /* @__PURE__ */ new Date()) {
+	const day = dayOf(iso);
+	if (!day) return iso;
+	return new Intl.DateTimeFormat(code, {
+		weekday: "long",
+		day: "numeric",
+		month: "long",
+		...day.getFullYear() !== today.getFullYear() && { year: "numeric" }
+	}).format(day);
+}
+/** A time "HH:MM" as the language writes it: "10:30", or "10:30 AM". */
+function formatTime(time, code) {
+	const [hours = 0, minutes = 0] = time.split(":").map(Number);
+	const at = new Date(2e3, 0, 1, hours, minutes);
+	const clock = new Intl.DateTimeFormat(code, {
+		hour: "numeric",
+		minute: "2-digit"
+	});
+	if (hours === 24 && clock.resolvedOptions().hourCycle === "h23") return new Intl.DateTimeFormat(code, {
+		hour: "numeric",
+		minute: "2-digit",
+		hourCycle: "h24"
+	}).format(at);
+	return clock.format(at);
+}
+/** A moment in words; a half-picked one reads as the half there is. */
+function formatMoment(moment, code, today = /* @__PURE__ */ new Date()) {
+	const [date, time] = momentParts(moment);
+	if (!date || !TIME.test(time)) return date ? formatDay(date, code, today) : time;
+	const day = dayOf(date);
+	if (!day) return moment;
+	const [hours = 0, minutes = 0] = time.split(":").map(Number);
+	day.setHours(hours, minutes);
+	return new Intl.DateTimeFormat(code, {
+		weekday: "long",
+		day: "numeric",
+		month: "long",
+		...day.getFullYear() !== today.getFullYear() && { year: "numeric" },
+		hour: "numeric",
+		minute: "2-digit"
+	}).format(day);
+}
+/** Whether a day is offered: one of the `dates` when there are, within the bounds. */
+function dayAllowed(bounds, iso) {
+	if (!DAY.test(iso)) return false;
+	if (bounds.dates && !bounds.dates.includes(iso)) return false;
+	if (bounds.earliest !== void 0 && iso < bounds.earliest) return false;
+	if (bounds.latest !== void 0 && iso > bounds.latest) return false;
+	return true;
+}
+/** Whether a time is offered: one of the `times` when there are. */
+function slotAllowed(times, time) {
+	return times === void 0 || times.includes(time);
+}
+/** The day a calendar opens on: the one picked, else the first offered, else today. */
+function openingDay(bounds, picked, today) {
+	if (picked && DAY.test(picked)) return picked;
+	const first = bounds.dates?.toSorted()[0] ?? bounds.earliest;
+	const now = isoDay(today);
+	if (first !== void 0 && (bounds.dates || first > now)) return first;
+	return bounds.latest !== void 0 && bounds.latest < now ? bounds.latest : now;
+}
+/** The first and last days a calendar can go to, when they are bounded. */
+function daySpan(bounds) {
+	const sorted = bounds.dates?.toSorted();
+	const first = sorted?.[0] ?? bounds.earliest;
+	const last = sorted?.at(-1) ?? bounds.latest;
+	return {
+		...first !== void 0 && { first },
+		...last !== void 0 && { last }
+	};
+}
+/** A moment's day and time, either "" while not picked: "2026-10-14T" is a day alone. */
+function momentParts(moment) {
+	if (!moment) return ["", ""];
+	const at = moment.indexOf("T");
+	return at < 0 ? [moment, ""] : [moment.slice(0, at), moment.slice(at + 1, at + 6)];
+}
+/** A moment from its parts, held while half picked; null when neither is. */
+function momentOf(date, time) {
+	return date === "" && time === "" ? null : `${date}T${time}`;
+}
+/** Every half hour of a day, "00:00" to "23:30": what a time offers without its own slots. */
+function halfHours() {
+	return Array.from({ length: 48 }, (_, index) => {
+		return `${String(Math.floor(index / 2)).padStart(2, "0")}:${index % 2 === 0 ? "00" : "30"}`;
+	});
+}
+/** The day's end, where a stretch of it can end: midnight at its close. */
+const DAY_END = "24:00";
+/** A time a stretch of the day ends at, as typed: any time, or the day's end ("24", "24:00"). */
+function parseEndTime(typed) {
+	return /^24(?:[:.h]?00)?$/i.test(typed.trim()) ? DAY_END : parseTime(typed);
+}
+/** A time as a person types it, as "HH:MM", or null: "9", "930", "9:30", "21.30", "9:30 pm". */
+function parseTime(typed) {
+	const match = /^(\d{1,2})(?:[:.h]?(\d{2}))?\s*([ap])?\.?\s*m?\.?$/i.exec(typed.trim());
+	if (!match) return null;
+	let hours = Number(match[1]);
+	const minutes = Number(match[2] ?? "0");
+	const half = match[3]?.toLowerCase();
+	if (half) {
+		if (hours < 1 || hours > 12) return null;
+		hours = hours % 12 + (half === "p" ? 12 : 0);
+	}
+	if (hours > 23 || minutes > 59) return null;
+	return `${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}`;
+}
+//#endregion
+export { DAY, DAY_END, MOMENT, TIME, dayAllowed, dayOf, daySpan, formatDay, formatMoment, formatTime, halfHours, isoDay, momentOf, momentParts, openingDay, parseEndTime, parseTime, slotAllowed };
+
+//# sourceMappingURL=dates.js.map

package/dist/kit/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","names":[],"sources":["../../src/kit/dates.ts"],"sourcesContent":["/**\n * Days and times as the kit's controls hold them, \"YYYY-MM-DD\", \"HH:MM\" and\n * \"YYYY-MM-DDTHH:MM\", as pure functions: reading them, writing them in a language, and which\n * of them a control offers.\n */\n\n/** What bounds a day: the only days to pick, and the first and last. */\nexport interface DayBounds {\n  dates?: string[] | undefined;\n  earliest?: string | undefined;\n  latest?: string | undefined;\n}\n\nexport const DAY = /^\\d{4}-\\d{2}-\\d{2}$/;\nexport const TIME = /^([01]\\d|2[0-3]):[0-5]\\d$/;\nexport const MOMENT = /^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d$/;\n\n/** A day \"YYYY-MM-DD\" as a local date, or null. */\nexport function dayOf(iso: string): Date | null {\n  if (!DAY.test(iso)) return null;\n  const [year = 0, month = 1, day = 1] = iso.split(\"-\").map(Number);\n  const date = new Date(year, month - 1, day);\n  return date.getMonth() === month - 1 ? date : null;\n}\n\n/** A local date as \"YYYY-MM-DD\". */\nexport function isoDay(date: Date): string {\n  const pad = (n: number) => String(n).padStart(2, \"0\");\n  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;\n}\n\n/** A day in words: its weekday, day and month, and its year when not this one. */\nexport function formatDay(iso: string, code: string, today: Date = new Date()): string {\n  const day = dayOf(iso);\n  if (!day) return iso;\n  return new Intl.DateTimeFormat(code, {\n    weekday: \"long\",\n    day: \"numeric\",\n    month: \"long\",\n    ...(day.getFullYear() !== today.getFullYear() && { year: \"numeric\" }),\n  }).format(day);\n}\n\n/** A time \"HH:MM\" as the language writes it: \"10:30\", or \"10:30 AM\". */\nexport function formatTime(time: string, code: string): string {\n  const [hours = 0, minutes = 0] = time.split(\":\").map(Number);\n  const at = new Date(2000, 0, 1, hours, minutes);\n  const clock = new Intl.DateTimeFormat(code, { hour: \"numeric\", minute: \"2-digit\" });\n  // The day's end, as a 24-hour clock writes it (\"24:00\"), not as the next day's start.\n  if (hours === 24 && clock.resolvedOptions().hourCycle === \"h23\") {\n    return new Intl.DateTimeFormat(code, {\n      hour: \"numeric\",\n      minute: \"2-digit\",\n      hourCycle: \"h24\",\n    }).format(at);\n  }\n  return clock.format(at);\n}\n\n/** A moment in words; a half-picked one reads as the half there is. */\nexport function formatMoment(moment: string, code: string, today: Date = new Date()): string {\n  const [date, time] = momentParts(moment);\n  if (!date || !TIME.test(time)) return date ? formatDay(date, code, today) : time;\n  const day = dayOf(date);\n  if (!day) return moment;\n  const [hours = 0, minutes = 0] = time.split(\":\").map(Number);\n  day.setHours(hours, minutes);\n  return new Intl.DateTimeFormat(code, {\n    weekday: \"long\",\n    day: \"numeric\",\n    month: \"long\",\n    ...(day.getFullYear() !== today.getFullYear() && { year: \"numeric\" }),\n    hour: \"numeric\",\n    minute: \"2-digit\",\n  }).format(day);\n}\n\n/** Whether a day is offered: one of the `dates` when there are, within the bounds. */\nexport function dayAllowed(bounds: DayBounds, iso: string): boolean {\n  if (!DAY.test(iso)) return false;\n  if (bounds.dates && !bounds.dates.includes(iso)) return false;\n  if (bounds.earliest !== undefined && iso < bounds.earliest) return false;\n  if (bounds.latest !== undefined && iso > bounds.latest) return false;\n  return true;\n}\n\n/** Whether a time is offered: one of the `times` when there are. */\nexport function slotAllowed(times: string[] | undefined, time: string): boolean {\n  return times === undefined || times.includes(time);\n}\n\n/** The day a calendar opens on: the one picked, else the first offered, else today. */\nexport function openingDay(bounds: DayBounds, picked: string | null, today: Date): string {\n  if (picked && DAY.test(picked)) return picked;\n  const first = bounds.dates?.toSorted()[0] ?? bounds.earliest;\n  const now = isoDay(today);\n  if (first !== undefined && (bounds.dates || first > now)) return first;\n  return bounds.latest !== undefined && bounds.latest < now ? bounds.latest : now;\n}\n\n/** The first and last days a calendar can go to, when they are bounded. */\nexport function daySpan(bounds: DayBounds): { first?: string; last?: string } {\n  const sorted = bounds.dates?.toSorted();\n  const first = sorted?.[0] ?? bounds.earliest;\n  const last = sorted?.at(-1) ?? bounds.latest;\n  return { ...(first !== undefined && { first }), ...(last !== undefined && { last }) };\n}\n\n/** A moment's day and time, either \"\" while not picked: \"2026-10-14T\" is a day alone. */\nexport function momentParts(moment: string | null): [date: string, time: string] {\n  if (!moment) return [\"\", \"\"];\n  const at = moment.indexOf(\"T\");\n  return at < 0 ? [moment, \"\"] : [moment.slice(0, at), moment.slice(at + 1, at + 6)];\n}\n\n/** A moment from its parts, held while half picked; null when neither is. */\nexport function momentOf(date: string, time: string): string | null {\n  return date === \"\" && time === \"\" ? null : `${date}T${time}`;\n}\n\n/** Every half hour of a day, \"00:00\" to \"23:30\": what a time offers without its own slots. */\nexport function halfHours(): string[] {\n  return Array.from({ length: 48 }, (_, index) => {\n    const hours = String(Math.floor(index / 2)).padStart(2, \"0\");\n    return `${hours}:${index % 2 === 0 ? \"00\" : \"30\"}`;\n  });\n}\n\n/** The day's end, where a stretch of it can end: midnight at its close. */\nexport const DAY_END = \"24:00\";\n\n/** A time a stretch of the day ends at, as typed: any time, or the day's end (\"24\", \"24:00\"). */\nexport function parseEndTime(typed: string): string | null {\n  return /^24(?:[:.h]?00)?$/i.test(typed.trim()) ? DAY_END : parseTime(typed);\n}\n\n/** A time as a person types it, as \"HH:MM\", or null: \"9\", \"930\", \"9:30\", \"21.30\", \"9:30 pm\". */\nexport function parseTime(typed: string): string | null {\n  const match = /^(\\d{1,2})(?:[:.h]?(\\d{2}))?\\s*([ap])?\\.?\\s*m?\\.?$/i.exec(typed.trim());\n  if (!match) return null;\n  let hours = Number(match[1]);\n  const minutes = Number(match[2] ?? \"0\");\n  const half = match[3]?.toLowerCase();\n  if (half) {\n    if (hours < 1 || hours > 12) return null;\n    hours = (hours % 12) + (half === \"p\" ? 12 : 0);\n  }\n  if (hours > 23 || minutes > 59) return null;\n  return `${String(hours).padStart(2, \"0\")}:${String(minutes).padStart(2, \"0\")}`;\n}\n"],"mappings":";AAaA,MAAa,MAAM;AACnB,MAAa,OAAO;AACpB,MAAa,SAAS;;AAGtB,SAAgB,MAAM,KAA0B;CAC9C,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG,OAAO;CAC3B,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,MAAM,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CAChE,MAAM,OAAO,IAAI,KAAK,MAAM,QAAQ,GAAG,GAAG;CAC1C,OAAO,KAAK,SAAS,MAAM,QAAQ,IAAI,OAAO;AAChD;;AAGA,SAAgB,OAAO,MAAoB;CACzC,MAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACpD,OAAO,GAAG,KAAK,YAAY,EAAE,GAAG,IAAI,KAAK,SAAS,IAAI,CAAC,EAAE,GAAG,IAAI,KAAK,QAAQ,CAAC;AAChF;;AAGA,SAAgB,UAAU,KAAa,MAAc,wBAAc,IAAI,KAAK,GAAW;CACrF,MAAM,MAAM,MAAM,GAAG;CACrB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO,IAAI,KAAK,eAAe,MAAM;EACnC,SAAS;EACT,KAAK;EACL,OAAO;EACP,GAAI,IAAI,YAAY,MAAM,MAAM,YAAY,KAAK,EAAE,MAAM,UAAU;CACrE,CAAC,CAAC,CAAC,OAAO,GAAG;AACf;;AAGA,SAAgB,WAAW,MAAc,MAAsB;CAC7D,MAAM,CAAC,QAAQ,GAAG,UAAU,KAAK,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CAC3D,MAAM,KAAK,IAAI,KAAK,KAAM,GAAG,GAAG,OAAO,OAAO;CAC9C,MAAM,QAAQ,IAAI,KAAK,eAAe,MAAM;EAAE,MAAM;EAAW,QAAQ;CAAU,CAAC;CAElF,IAAI,UAAU,MAAM,MAAM,gBAAgB,CAAC,CAAC,cAAc,OACxD,OAAO,IAAI,KAAK,eAAe,MAAM;EACnC,MAAM;EACN,QAAQ;EACR,WAAW;CACb,CAAC,CAAC,CAAC,OAAO,EAAE;CAEd,OAAO,MAAM,OAAO,EAAE;AACxB;;AAGA,SAAgB,aAAa,QAAgB,MAAc,wBAAc,IAAI,KAAK,GAAW;CAC3F,MAAM,CAAC,MAAM,QAAQ,YAAY,MAAM;CACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,GAAG,OAAO,OAAO,UAAU,MAAM,MAAM,KAAK,IAAI;CAC5E,MAAM,MAAM,MAAM,IAAI;CACtB,IAAI,CAAC,KAAK,OAAO;CACjB,MAAM,CAAC,QAAQ,GAAG,UAAU,KAAK,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CAC3D,IAAI,SAAS,OAAO,OAAO;CAC3B,OAAO,IAAI,KAAK,eAAe,MAAM;EACnC,SAAS;EACT,KAAK;EACL,OAAO;EACP,GAAI,IAAI,YAAY,MAAM,MAAM,YAAY,KAAK,EAAE,MAAM,UAAU;EACnE,MAAM;EACN,QAAQ;CACV,CAAC,CAAC,CAAC,OAAO,GAAG;AACf;;AAGA,SAAgB,WAAW,QAAmB,KAAsB;CAClE,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG,OAAO;CAC3B,IAAI,OAAO,SAAS,CAAC,OAAO,MAAM,SAAS,GAAG,GAAG,OAAO;CACxD,IAAI,OAAO,aAAa,KAAA,KAAa,MAAM,OAAO,UAAU,OAAO;CACnE,IAAI,OAAO,WAAW,KAAA,KAAa,MAAM,OAAO,QAAQ,OAAO;CAC/D,OAAO;AACT;;AAGA,SAAgB,YAAY,OAA6B,MAAuB;CAC9E,OAAO,UAAU,KAAA,KAAa,MAAM,SAAS,IAAI;AACnD;;AAGA,SAAgB,WAAW,QAAmB,QAAuB,OAAqB;CACxF,IAAI,UAAU,IAAI,KAAK,MAAM,GAAG,OAAO;CACvC,MAAM,QAAQ,OAAO,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO;CACpD,MAAM,MAAM,OAAO,KAAK;CACxB,IAAI,UAAU,KAAA,MAAc,OAAO,SAAS,QAAQ,MAAM,OAAO;CACjE,OAAO,OAAO,WAAW,KAAA,KAAa,OAAO,SAAS,MAAM,OAAO,SAAS;AAC9E;;AAGA,SAAgB,QAAQ,QAAsD;CAC5E,MAAM,SAAS,OAAO,OAAO,SAAS;CACtC,MAAM,QAAQ,SAAS,MAAM,OAAO;CACpC,MAAM,OAAO,QAAQ,GAAG,EAAE,KAAK,OAAO;CACtC,OAAO;EAAE,GAAI,UAAU,KAAA,KAAa,EAAE,MAAM;EAAI,GAAI,SAAS,KAAA,KAAa,EAAE,KAAK;CAAG;AACtF;;AAGA,SAAgB,YAAY,QAAqD;CAC/E,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE;CAC3B,MAAM,KAAK,OAAO,QAAQ,GAAG;CAC7B,OAAO,KAAK,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,MAAM,GAAG,EAAE,GAAG,OAAO,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC;AACnF;;AAGA,SAAgB,SAAS,MAAc,MAA6B;CAClE,OAAO,SAAS,MAAM,SAAS,KAAK,OAAO,GAAG,KAAK,GAAG;AACxD;;AAGA,SAAgB,YAAsB;CACpC,OAAO,MAAM,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU;EAE9C,OAAO,GADO,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,GAC1C,EAAE,GAAG,QAAQ,MAAM,IAAI,OAAO;CAC9C,CAAC;AACH;;AAGA,MAAa,UAAU;;AAGvB,SAAgB,aAAa,OAA8B;CACzD,OAAO,qBAAqB,KAAK,MAAM,KAAK,CAAC,IAAI,UAAU,UAAU,KAAK;AAC5E;;AAGA,SAAgB,UAAU,OAA8B;CACtD,MAAM,QAAQ,sDAAsD,KAAK,MAAM,KAAK,CAAC;CACrF,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,QAAQ,OAAO,MAAM,EAAE;CAC3B,MAAM,UAAU,OAAO,MAAM,MAAM,GAAG;CACtC,MAAM,OAAO,MAAM,EAAE,EAAE,YAAY;CACnC,IAAI,MAAM;EACR,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO;EACpC,QAAS,QAAQ,MAAO,SAAS,MAAM,KAAK;CAC9C;CACA,IAAI,QAAQ,MAAM,UAAU,IAAI,OAAO;CACvC,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC,SAAS,GAAG,GAAG;AAC7E"}

package/dist/kit/messages.d.ts

@@ -0,0 +1,99 @@
+import { AutomationMessages } from "../automation/messages.js";
+import { DayPickerLocale } from "react-day-picker";
+//#region src/kit/messages.d.ts
+/**
+ * The language the kit's dates are read in: a locale from `@signalcore/ui/locale` (the
+ * calendar's, with its words), whose `code` also formats days, times, numbers and lists.
+ */
+export type KitLocale = DayPickerLocale;
+/** The words the kit's controls say; a host gives its own, in its language. */
+export interface KitMessages {
+  /** A field left empty that must be filled. */
+  required: string;
+  /** A day, a time, both, an option, a rating still to pick; also an empty picker's invitation. */
+  chooseDate: string;
+  chooseTime: string;
+  chooseMoment: string;
+  chooseOption: string;
+  chooseRating: string;
+  /** A box that must be ticked to go on. */
+  check: string;
+  invalidEmail: string;
+  invalidPhone: string;
+  invalidUrl: string;
+  invalidNumber: string;
+  /** A time typed in a shape that is not one. */
+  invalidTime: string;
+  /** A number under its least, or over its most, given formatted. */
+  atLeast: (min: string) => string;
+  atMost: (max: string) => string;
+  /** A day or a time that is not offered. */
+  unavailableDate: string;
+  unavailableTime: string;
+  /** Beside the label of a field that may stay empty. */
+  optional: string;
+  /** In a long list's box while nothing is picked. */
+  pick: string;
+  /** In that box while the person types. */
+  search: string;
+  noResults: string;
+  /** The button that shows or hides a secret as it is typed. */
+  show: string;
+  hide: string;
+  /** A number's steppers, for screen readers. */
+  increase: string;
+  decrease: string;
+  /** A picked tag's remove button, for screen readers. */
+  remove: (label: string) => string;
+  /** A box ticked or not, as an answer reads. */
+  yes: string;
+  no: string;
+  /** A rating, as an answer reads. */
+  rated: (value: number, max: number) => string;
+  /** One star of a rating, for screen readers. */
+  stars: (count: number) => string;
+  /** A choice's last row, to answer in one's own words, and its box while empty. */
+  other: string;
+  otherPlaceholder: string;
+  /** A form's submit when the agent gave it no words. */
+  send: string;
+  /** Where a form's submit was, once it is sent. */
+  sent: string;
+  /** A file field left empty that must be filled. */
+  chooseFile: string;
+  /** A file field's drop zone: what it asks, and how. */
+  upload: (multiple: boolean) => string;
+  drop: string;
+  /**
+   * Under them, what it takes: the kinds (named and joined, "" when anything) and the most a
+   * file may weigh, formatted.
+   */
+  limits: (kinds: string, size: string) => string;
+  /** A family of kinds as the limits name it: "image" for any image, "video", "audio", "text". */
+  anyOf: (family: string) => string;
+  /** A file on its way, beside how much has gone. */
+  uploading: string;
+  /** A file that was not sent: heavier than the most (formatted), a kind not taken, one too many. */
+  tooBig: (size: string) => string;
+  wrongType: string;
+  tooMany: (max: number) => string;
+  /** A file whose upload failed, and the button that tries it again. */
+  uploadFailed: string;
+  retry: string;
+  /** A form sent while a file is still on its way, or one failed. */
+  stillUploading: string;
+  fixFiles: string;
+  /** A file's chip, opened on a click, for screen readers. */
+  open: (name: string) => string;
+  /** A file whose name is not known yet. */
+  file: string;
+  /** An audio player's button, and its way through, for screen readers. */
+  play: string;
+  pause: string;
+  position: string;
+  /** An automation and its runs: when it runs, how it stands, what each run did. */
+  automation: AutomationMessages;
+}
+export declare const KIT_MESSAGES: KitMessages;
+//#endregion
+//# sourceMappingURL=messages.d.ts.map

package/dist/kit/messages.js

@@ -0,0 +1,66 @@
+import { AUTOMATION_MESSAGES } from "../automation/messages.js";
+//#region src/kit/messages.ts
+const FAMILIES = {
+	image: "images",
+	video: "videos",
+	audio: "audio",
+	text: "text"
+};
+const KIT_MESSAGES = {
+	required: "This field is required",
+	chooseDate: "Choose a day",
+	chooseTime: "Choose a time",
+	chooseMoment: "Choose a day and a time",
+	chooseOption: "Choose an option",
+	other: "Another answer",
+	otherPlaceholder: "Write your answer",
+	chooseRating: "Choose a rating",
+	check: "Tick the box to go on",
+	invalidEmail: "Enter a valid email",
+	invalidPhone: "Enter a valid phone number",
+	invalidUrl: "Enter a valid address",
+	invalidNumber: "Enter a number",
+	invalidTime: "Write a time like 9:30",
+	atLeast: (min) => `At least ${min}`,
+	atMost: (max) => `At most ${max}`,
+	unavailableDate: "That day is not available",
+	unavailableTime: "That time is not available",
+	optional: "Optional",
+	pick: "Choose…",
+	search: "Search…",
+	noResults: "No results",
+	show: "Show",
+	hide: "Hide",
+	increase: "Increase",
+	decrease: "Decrease",
+	remove: (label) => `Remove ${label}`,
+	yes: "Yes",
+	no: "No",
+	rated: (value, max) => `${value} of ${max}`,
+	stars: (count) => count === 1 ? "1 star" : `${count} stars`,
+	send: "Send",
+	sent: "Sent",
+	chooseFile: "Add a file",
+	upload: (multiple) => multiple ? "Upload files" : "Upload a file",
+	drop: "Drop it here or choose",
+	limits: (kinds, size) => kinds ? `${kinds}, up to ${size}` : `Up to ${size}`,
+	anyOf: (family) => FAMILIES[family] ?? family,
+	uploading: "Uploading",
+	tooBig: (size) => `Over ${size}`,
+	wrongType: "This kind of file isn't taken here",
+	tooMany: (max) => `At most ${max} files`,
+	uploadFailed: "Couldn't upload it",
+	retry: "Retry",
+	stillUploading: "Wait for the upload to finish",
+	fixFiles: "Remove or retry the files that failed",
+	open: (name) => `Open ${name}`,
+	file: "File",
+	play: "Play",
+	pause: "Pause",
+	position: "Position",
+	automation: AUTOMATION_MESSAGES
+};
+//#endregion
+export { KIT_MESSAGES };
+
+//# sourceMappingURL=messages.js.map

package/dist/kit/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","names":[],"sources":["../../src/kit/messages.ts"],"sourcesContent":["import type { DayPickerLocale } from \"react-day-picker\";\n\nimport { AUTOMATION_MESSAGES, type AutomationMessages } from \"../automation/messages\";\n\n/**\n * The language the kit's dates are read in: a locale from `@signalcore/ui/locale` (the\n * calendar's, with its words), whose `code` also formats days, times, numbers and lists.\n */\nexport type KitLocale = DayPickerLocale;\n\n/** The words the kit's controls say; a host gives its own, in its language. */\nexport interface KitMessages {\n  /** A field left empty that must be filled. */\n  required: string;\n  /** A day, a time, both, an option, a rating still to pick; also an empty picker's invitation. */\n  chooseDate: string;\n  chooseTime: string;\n  chooseMoment: string;\n  chooseOption: string;\n  chooseRating: string;\n  /** A box that must be ticked to go on. */\n  check: string;\n  invalidEmail: string;\n  invalidPhone: string;\n  invalidUrl: string;\n  invalidNumber: string;\n  /** A time typed in a shape that is not one. */\n  invalidTime: string;\n  /** A number under its least, or over its most, given formatted. */\n  atLeast: (min: string) => string;\n  atMost: (max: string) => string;\n  /** A day or a time that is not offered. */\n  unavailableDate: string;\n  unavailableTime: string;\n  /** Beside the label of a field that may stay empty. */\n  optional: string;\n  /** In a long list's box while nothing is picked. */\n  pick: string;\n  /** In that box while the person types. */\n  search: string;\n  noResults: string;\n  /** The button that shows or hides a secret as it is typed. */\n  show: string;\n  hide: string;\n  /** A number's steppers, for screen readers. */\n  increase: string;\n  decrease: string;\n  /** A picked tag's remove button, for screen readers. */\n  remove: (label: string) => string;\n  /** A box ticked or not, as an answer reads. */\n  yes: string;\n  no: string;\n  /** A rating, as an answer reads. */\n  rated: (value: number, max: number) => string;\n  /** One star of a rating, for screen readers. */\n  stars: (count: number) => string;\n  /** A choice's last row, to answer in one's own words, and its box while empty. */\n  other: string;\n  otherPlaceholder: string;\n  /** A form's submit when the agent gave it no words. */\n  send: string;\n  /** Where a form's submit was, once it is sent. */\n  sent: string;\n  /** A file field left empty that must be filled. */\n  chooseFile: string;\n  /** A file field's drop zone: what it asks, and how. */\n  upload: (multiple: boolean) => string;\n  drop: string;\n  /**\n   * Under them, what it takes: the kinds (named and joined, \"\" when anything) and the most a\n   * file may weigh, formatted.\n   */\n  limits: (kinds: string, size: string) => string;\n  /** A family of kinds as the limits name it: \"image\" for any image, \"video\", \"audio\", \"text\". */\n  anyOf: (family: string) => string;\n  /** A file on its way, beside how much has gone. */\n  uploading: string;\n  /** A file that was not sent: heavier than the most (formatted), a kind not taken, one too many. */\n  tooBig: (size: string) => string;\n  wrongType: string;\n  tooMany: (max: number) => string;\n  /** A file whose upload failed, and the button that tries it again. */\n  uploadFailed: string;\n  retry: string;\n  /** A form sent while a file is still on its way, or one failed. */\n  stillUploading: string;\n  fixFiles: string;\n  /** A file's chip, opened on a click, for screen readers. */\n  open: (name: string) => string;\n  /** A file whose name is not known yet. */\n  file: string;\n  /** An audio player's button, and its way through, for screen readers. */\n  play: string;\n  pause: string;\n  position: string;\n  /** An automation and its runs: when it runs, how it stands, what each run did. */\n  automation: AutomationMessages;\n}\n\nconst FAMILIES: Readonly<Record<string, string>> = {\n  image: \"images\",\n  video: \"videos\",\n  audio: \"audio\",\n  text: \"text\",\n};\n\nexport const KIT_MESSAGES: KitMessages = {\n  required: \"This field is required\",\n  chooseDate: \"Choose a day\",\n  chooseTime: \"Choose a time\",\n  chooseMoment: \"Choose a day and a time\",\n  chooseOption: \"Choose an option\",\n  other: \"Another answer\",\n  otherPlaceholder: \"Write your answer\",\n  chooseRating: \"Choose a rating\",\n  check: \"Tick the box to go on\",\n  invalidEmail: \"Enter a valid email\",\n  invalidPhone: \"Enter a valid phone number\",\n  invalidUrl: \"Enter a valid address\",\n  invalidNumber: \"Enter a number\",\n  invalidTime: \"Write a time like 9:30\",\n  atLeast: (min) => `At least ${min}`,\n  atMost: (max) => `At most ${max}`,\n  unavailableDate: \"That day is not available\",\n  unavailableTime: \"That time is not available\",\n  optional: \"Optional\",\n  pick: \"Choose…\",\n  search: \"Search…\",\n  noResults: \"No results\",\n  show: \"Show\",\n  hide: \"Hide\",\n  increase: \"Increase\",\n  decrease: \"Decrease\",\n  remove: (label) => `Remove ${label}`,\n  yes: \"Yes\",\n  no: \"No\",\n  rated: (value, max) => `${value} of ${max}`,\n  stars: (count) => (count === 1 ? \"1 star\" : `${count} stars`),\n  send: \"Send\",\n  sent: \"Sent\",\n  chooseFile: \"Add a file\",\n  upload: (multiple) => (multiple ? \"Upload files\" : \"Upload a file\"),\n  drop: \"Drop it here or choose\",\n  limits: (kinds, size) => (kinds ? `${kinds}, up to ${size}` : `Up to ${size}`),\n  anyOf: (family) => FAMILIES[family] ?? family,\n  uploading: \"Uploading\",\n  tooBig: (size) => `Over ${size}`,\n  wrongType: \"This kind of file isn't taken here\",\n  tooMany: (max) => `At most ${max} files`,\n  uploadFailed: \"Couldn't upload it\",\n  retry: \"Retry\",\n  stillUploading: \"Wait for the upload to finish\",\n  fixFiles: \"Remove or retry the files that failed\",\n  open: (name) => `Open ${name}`,\n  file: \"File\",\n  play: \"Play\",\n  pause: \"Pause\",\n  position: \"Position\",\n  automation: AUTOMATION_MESSAGES,\n};\n"],"mappings":";;AAmGA,MAAM,WAA6C;CACjD,OAAO;CACP,OAAO;CACP,OAAO;CACP,MAAM;AACR;AAEA,MAAa,eAA4B;CACvC,UAAU;CACV,YAAY;CACZ,YAAY;CACZ,cAAc;CACd,cAAc;CACd,OAAO;CACP,kBAAkB;CAClB,cAAc;CACd,OAAO;CACP,cAAc;CACd,cAAc;CACd,YAAY;CACZ,eAAe;CACf,aAAa;CACb,UAAU,QAAQ,YAAY;CAC9B,SAAS,QAAQ,WAAW;CAC5B,iBAAiB;CACjB,iBAAiB;CACjB,UAAU;CACV,MAAM;CACN,QAAQ;CACR,WAAW;CACX,MAAM;CACN,MAAM;CACN,UAAU;CACV,UAAU;CACV,SAAS,UAAU,UAAU;CAC7B,KAAK;CACL,IAAI;CACJ,QAAQ,OAAO,QAAQ,GAAG,MAAM,MAAM;CACtC,QAAQ,UAAW,UAAU,IAAI,WAAW,GAAG,MAAM;CACrD,MAAM;CACN,MAAM;CACN,YAAY;CACZ,SAAS,aAAc,WAAW,iBAAiB;CACnD,MAAM;CACN,SAAS,OAAO,SAAU,QAAQ,GAAG,MAAM,UAAU,SAAS,SAAS;CACvE,QAAQ,WAAW,SAAS,WAAW;CACvC,WAAW;CACX,SAAS,SAAS,QAAQ;CAC1B,WAAW;CACX,UAAU,QAAQ,WAAW,IAAI;CACjC,cAAc;CACd,OAAO;CACP,gBAAgB;CAChB,UAAU;CACV,OAAO,SAAS,QAAQ;CACxB,MAAM;CACN,MAAM;CACN,OAAO;CACP,UAAU;CACV,YAAY;AACd"}

package/dist/kit/numbers.d.ts

@@ -0,0 +1,12 @@
+//#region src/kit/numbers.d.ts
+/** Numbers as the kit's controls hold and write them, as pure functions. */
+/** What bounds a number: its least, its most, the step between values. */
+export interface NumberBounds {
+  min?: number | undefined;
+  max?: number | undefined;
+  step?: number | undefined;
+}
+/** A file's size as people read it: whole bytes, one decimal under ten of a larger unit. */
+export declare function formatSize(bytes: number, locale?: string): string;
+//#endregion
+//# sourceMappingURL=numbers.d.ts.map

package/dist/kit/numbers.js

@@ -0,0 +1,40 @@
+//#region src/kit/numbers.ts
+function formatNumber(value, code) {
+	return new Intl.NumberFormat(code, { maximumFractionDigits: 6 }).format(value);
+}
+/** A number with its unit after it: "3 personas", "25 €". */
+function withUnit(text, unit) {
+	return unit ? `${text} ${unit}` : text;
+}
+/**
+* A number one step up or down (`direction` 1 or -1), kept within its bounds and on its step's
+* decimals; from nothing, it starts at its least, or 0.
+*/
+function stepped(bounds, value, direction) {
+	const step = bounds.step ?? 1;
+	const next = value === null ? bounds.min ?? 0 : value + direction * step;
+	const decimals = (String(step).split(".")[1] ?? "").length;
+	const rounded = Number(next.toFixed(decimals));
+	return Math.min(bounds.max ?? Infinity, Math.max(bounds.min ?? -Infinity, rounded));
+}
+const UNITS = [
+	"B",
+	"KB",
+	"MB",
+	"GB"
+];
+/** A file's size as people read it: whole bytes, one decimal under ten of a larger unit. */
+function formatSize(bytes, locale) {
+	let size = Math.max(0, bytes);
+	let unit = 0;
+	while (size >= 1024 && unit < UNITS.length - 1) {
+		size /= 1024;
+		unit += 1;
+	}
+	const digits = unit === 0 || size >= 10 ? 0 : 1;
+	return `${new Intl.NumberFormat(locale, { maximumFractionDigits: digits }).format(size)} ${UNITS[unit]}`;
+}
+//#endregion
+export { formatNumber, formatSize, stepped, withUnit };
+
+//# sourceMappingURL=numbers.js.map

package/dist/kit/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","names":[],"sources":["../../src/kit/numbers.ts"],"sourcesContent":["/** Numbers as the kit's controls hold and write them, as pure functions. */\n\n/** What bounds a number: its least, its most, the step between values. */\nexport interface NumberBounds {\n  min?: number | undefined;\n  max?: number | undefined;\n  step?: number | undefined;\n}\n\nexport function formatNumber(value: number, code: string): string {\n  return new Intl.NumberFormat(code, { maximumFractionDigits: 6 }).format(value);\n}\n\n/** A number with its unit after it: \"3 personas\", \"25 €\". */\nexport function withUnit(text: string, unit: string | undefined): string {\n  return unit ? `${text} ${unit}` : text;\n}\n\n/**\n * A number one step up or down (`direction` 1 or -1), kept within its bounds and on its step's\n * decimals; from nothing, it starts at its least, or 0.\n */\nexport function stepped(bounds: NumberBounds, value: number | null, direction: 1 | -1): number {\n  const step = bounds.step ?? 1;\n  const next = value === null ? (bounds.min ?? 0) : value + direction * step;\n  const decimals = (String(step).split(\".\")[1] ?? \"\").length;\n  const rounded = Number(next.toFixed(decimals));\n  return Math.min(bounds.max ?? Infinity, Math.max(bounds.min ?? -Infinity, rounded));\n}\n\nconst UNITS = [\"B\", \"KB\", \"MB\", \"GB\"] as const;\n\n/** A file's size as people read it: whole bytes, one decimal under ten of a larger unit. */\nexport function formatSize(bytes: number, locale?: string): string {\n  let size = Math.max(0, bytes);\n  let unit = 0;\n  while (size >= 1024 && unit < UNITS.length - 1) {\n    size /= 1024;\n    unit += 1;\n  }\n  const digits = unit === 0 || size >= 10 ? 0 : 1;\n  const number = new Intl.NumberFormat(locale, { maximumFractionDigits: digits }).format(size);\n  return `${number} ${UNITS[unit]}`;\n}\n"],"mappings":";AASA,SAAgB,aAAa,OAAe,MAAsB;CAChE,OAAO,IAAI,KAAK,aAAa,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK;AAC/E;;AAGA,SAAgB,SAAS,MAAc,MAAkC;CACvE,OAAO,OAAO,GAAG,KAAK,GAAG,SAAS;AACpC;;;;;AAMA,SAAgB,QAAQ,QAAsB,OAAsB,WAA2B;CAC7F,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,OAAO,UAAU,OAAQ,OAAO,OAAO,IAAK,QAAQ,YAAY;CACtE,MAAM,YAAY,OAAO,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAA,CAAI;CACpD,MAAM,UAAU,OAAO,KAAK,QAAQ,QAAQ,CAAC;CAC7C,OAAO,KAAK,IAAI,OAAO,OAAO,UAAU,KAAK,IAAI,OAAO,OAAO,WAAW,OAAO,CAAC;AACpF;AAEA,MAAM,QAAQ;CAAC;CAAK;CAAM;CAAM;AAAI;;AAGpC,SAAgB,WAAW,OAAe,QAAyB;CACjE,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK;CAC5B,IAAI,OAAO;CACX,OAAO,QAAQ,QAAQ,OAAO,MAAM,SAAS,GAAG;EAC9C,QAAQ;EACR,QAAQ;CACV;CACA,MAAM,SAAS,SAAS,KAAK,QAAQ,KAAK,IAAI;CAE9C,OAAO,GADQ,IAAI,KAAK,aAAa,QAAQ,EAAE,uBAAuB,OAAO,CAAC,CAAC,CAAC,OAAO,IACxE,EAAE,GAAG,MAAM;AAC5B"}

package/dist/kit/options.d.ts

@@ -0,0 +1,10 @@
+//#region src/kit/options.d.ts
+/** The options a control offers, as pure functions: finding one, ticking one on and off. */
+/** One thing to pick: its id (what comes back), its label, and a quiet line under it. */
+export interface Option {
+  id: string;
+  label: string;
+  hint?: string | undefined;
+}
+//#endregion
+//# sourceMappingURL=options.d.ts.map

package/dist/kit/options.js

@@ -0,0 +1,23 @@
+//#region src/kit/options.ts
+/** Whether an option is what the person is looking for: in its label, hint or id, any case or accent. */
+function matches(option, query) {
+	const wanted = fold(query.trim());
+	if (wanted === "") return true;
+	return [
+		option.label,
+		option.hint ?? "",
+		option.id
+	].some((text) => fold(text).includes(wanted));
+}
+function fold(text) {
+	return text.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLowerCase();
+}
+/** The ids picked once the person ticks one on or off, in the options' order. */
+function toggled(options, picked, id) {
+	const on = !picked.includes(id);
+	return options.filter((option) => option.id === id ? on : picked.includes(option.id)).map((option) => option.id);
+}
+//#endregion
+export { matches, toggled };
+
+//# sourceMappingURL=options.js.map

package/dist/kit/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","names":[],"sources":["../../src/kit/options.ts"],"sourcesContent":["/** The options a control offers, as pure functions: finding one, ticking one on and off. */\n\n/** One thing to pick: its id (what comes back), its label, and a quiet line under it. */\nexport interface Option {\n  id: string;\n  label: string;\n  hint?: string | undefined;\n}\n\n/** Whether an option is what the person is looking for: in its label, hint or id, any case or accent. */\nexport function matches(option: Option, query: string): boolean {\n  const wanted = fold(query.trim());\n  if (wanted === \"\") return true;\n  return [option.label, option.hint ?? \"\", option.id].some((text) => fold(text).includes(wanted));\n}\n\nfunction fold(text: string): string {\n  return text\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .toLowerCase();\n}\n\n/** The ids picked once the person ticks one on or off, in the options' order. */\nexport function toggled(options: Option[], picked: readonly string[], id: string): string[] {\n  const on = !picked.includes(id);\n  return options\n    .filter((option) => (option.id === id ? on : picked.includes(option.id)))\n    .map((option) => option.id);\n}\n"],"mappings":";;AAUA,SAAgB,QAAQ,QAAgB,OAAwB;CAC9D,MAAM,SAAS,KAAK,MAAM,KAAK,CAAC;CAChC,IAAI,WAAW,IAAI,OAAO;CAC1B,OAAO;EAAC,OAAO;EAAO,OAAO,QAAQ;EAAI,OAAO;CAAE,CAAC,CAAC,MAAM,SAAS,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC;AAChG;AAEA,SAAS,KAAK,MAAsB;CAClC,OAAO,KACJ,UAAU,KAAK,CAAC,CAChB,QAAQ,mBAAmB,EAAE,CAAC,CAC9B,YAAY;AACjB;;AAGA,SAAgB,QAAQ,SAAmB,QAA2B,IAAsB;CAC1F,MAAM,KAAK,CAAC,OAAO,SAAS,EAAE;CAC9B,OAAO,QACJ,QAAQ,WAAY,OAAO,OAAO,KAAK,KAAK,OAAO,SAAS,OAAO,EAAE,CAAE,CAAC,CACxE,KAAK,WAAW,OAAO,EAAE;AAC9B"}

package/dist/kit/uploads.d.ts

@@ -0,0 +1,42 @@
+import { Attachment } from "../types.js";
+import "./messages.js";
+//#region src/kit/uploads.d.ts
+/** The most a file may weigh anywhere, in MB: the API's ceiling. */
+export declare const MAX_MB = 50;
+/**
+ * Sends one file where it belongs, telling how much of it has gone (0 to 1) as it goes; aborting
+ * `signal` lets it go. Resolves to the file as stored.
+ */
+export type Uploader = (file: File, progress: (share: number) => void, signal: AbortSignal) => Promise<Attachment>;
+/** Where a field's files go and how the ones already sent are found: the conversation's. */
+export interface FileHost {
+  upload: Uploader;
+  /** The files known by id: said in the conversation, uploaded to it. */
+  known: ReadonlyMap<string, Attachment>;
+  /** Asks for files it does not know yet, by id: read back from the conversation. */
+  find?: ((ids: readonly string[]) => void) | undefined;
+  /** Opens one, when the host shows files. */
+  open?: ((file: Attachment) => void) | undefined;
+  /**
+   * Where a picture, a video or a sound plays from in the page's own player: an address the
+   * player streams with no credential, for a while.
+   */
+  play?: ((file: Attachment) => Promise<string>) | undefined;
+}
+/** A file as picked: its name, its type as the browser gave it ("" when none), its weight. */
+export interface Picked {
+  name: string;
+  type: string;
+  size: number;
+}
+/**
+ * Whether a file is of a kind `accept` lists, read as an <input accept> reads it: a type
+ * ("application/pdf"), a family ("image/*") or an extension (".xlsx"); none takes anything.
+ */
+export declare function accepts(accept: readonly string[] | undefined, file: Pick<Picked, "name" | "type">): boolean;
+/** The families a file's glyph tells apart. */
+export type FileFamily = "image" | "pdf" | "sheet" | "doc" | "slides" | "text" | "archive" | "audio" | "video" | "other";
+/** A file's family, by its name's extension first, then by its type. */
+export declare function familyOf(name: string, type: string): FileFamily;
+//#endregion
+//# sourceMappingURL=uploads.d.ts.map