@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/surface/scope.js

@@ -0,0 +1,23 @@
+import { classes } from "../classes.js";
+import { createContext, useContext } from "react";
+//#region src/surface/scope.ts
+const ScopeContext = createContext({
+	active: false,
+	answered: void 0,
+	onAction: () => void 0,
+	components: void 0,
+	classNames: void 0,
+	files: void 0
+});
+function useScope() {
+	return useContext(ScopeContext);
+}
+/** The classes of the surface's own parts, with the host's own under each. */
+function useSurfaceParts() {
+	const { classNames } = useScope();
+	return (...parts) => classes(classNames, ...parts);
+}
+//#endregion
+export { ScopeContext, useScope, useSurfaceParts };
+
+//# sourceMappingURL=scope.js.map

package/dist/surface/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","names":[],"sources":["../../src/surface/scope.ts"],"sourcesContent":["import { createContext, useContext, type ComponentType, type ReactNode } from \"react\";\n\nimport type { Block } from \"../blocks\";\nimport { classes } from \"../classes\";\nimport type { KitPart } from \"../kit/context\";\nimport type { FileHost } from \"../kit/uploads\";\nimport type { SurfaceAction } from \"./values\";\n\n/**\n * The surface's own parts, by the class each carries: the blocks that are not a kit primitive,\n * and the form's layout. `classNames` takes these and the kit's (`KitPart`) under the same keys.\n */\nexport type SurfacePart =\n  | \"sc-surface\"\n  | \"sc-surface__stack\"\n  | \"sc-surface__stack--row\"\n  | \"sc-surface__divider\"\n  | \"sc-surface__text\"\n  | \"sc-surface__fields\"\n  | \"sc-surface__table\"\n  | \"sc-surface__image\"\n  | \"sc-surface__media\"\n  | \"sc-surface__choice\"\n  | \"sc-surface__choice--list\"\n  | \"sc-surface__option\"\n  | \"sc-surface__option--other\"\n  | \"sc-surface__other\"\n  | \"sc-surface__form\"\n  | \"sc-surface__submit\"\n  | \"sc-surface__foot\"\n  | \"sc-surface__sent\";\n\nexport type SurfaceClassNames = Partial<Record<SurfacePart | KitPart, string>> | undefined;\n\n/**\n * What a host's component for a block type receives: the block itself, whether the surface still\n * takes input, and `onAction` to send what the person did; a container's `children` come drawn.\n */\nexport type BlockProps<Type extends Block[\"type\"]> = Omit<\n  Extract<Block, { type: Type }>,\n  \"children\"\n> &\n  (Extract<Block, { type: Type }> extends { children: Block[] }\n    ? { children: ReactNode }\n    : unknown) & {\n    active: boolean;\n    onAction: (action: SurfaceAction) => void;\n  };\n\n/** The host's own drawing of a block type, in place of the package's: `{ table: TheirTable }`. */\nexport type SurfaceComponents = { [Type in Block[\"type\"]]?: ComponentType<BlockProps<Type>> };\n\n/** What every block of one surface shares: whether it takes input, what was done on it. */\nexport interface Scope {\n  active: boolean;\n  /** What the person already did on the surface. */\n  answered: SurfaceAction | undefined;\n  onAction: (action: SurfaceAction) => void;\n  components: SurfaceComponents | undefined;\n  classNames: SurfaceClassNames;\n  /** Where its file fields' files go and are found; none: they take none. */\n  files: FileHost | undefined;\n}\n\nexport const ScopeContext = createContext<Scope>({\n  active: false,\n  answered: undefined,\n  onAction: () => undefined,\n  components: undefined,\n  classNames: undefined,\n  files: undefined,\n});\n\nexport function useScope(): Scope {\n  return useContext(ScopeContext);\n}\n\n/** The classes of the surface's own parts, with the host's own under each. */\nexport function useSurfaceParts(): (...parts: SurfacePart[]) => string {\n  const { classNames } = useScope();\n  return (...parts) => classes(classNames, ...parts);\n}\n"],"mappings":";;;AAgEA,MAAa,eAAe,cAAqB;CAC/C,QAAQ;CACR,UAAU,KAAA;CACV,gBAAgB,KAAA;CAChB,YAAY,KAAA;CACZ,YAAY,KAAA;CACZ,OAAO,KAAA;AACT,CAAC;AAED,SAAgB,WAAkB;CAChC,OAAO,WAAW,YAAY;AAChC;;AAGA,SAAgB,kBAAuD;CACrE,MAAM,EAAE,eAAe,SAAS;CAChC,QAAQ,GAAG,UAAU,QAAQ,YAAY,GAAG,KAAK;AACnD"}

package/dist/surface/values.d.ts

@@ -0,0 +1,44 @@
+import { ButtonBlock, ChoiceBlock, Entry, FieldValue, FormBlock, FormField, ListBlock, Option } from "../blocks.js";
+import { Action, Attachment } from "../types.js";
+import { KitMessages } from "../kit/messages.js";
+//#region src/surface/values.d.ts
+/**
+ * What a block sends when the person uses it: its action's name, what it carries, and the words
+ * the app shows for it (the option picked, the button, the form's answer).
+ */
+export type SurfaceAction = Omit<Action, "surface">;
+/** A form's values by field name, as its controls hold them. */
+export type Values = Record<string, FieldValue>;
+/** A button's action: its name, nothing more, under its label. */
+export declare function pressed(block: ButtonBlock & {
+  action: string;
+}): SurfaceAction;
+/** A choice's action: the option's id, under its label. */
+export declare function picked(block: ChoiceBlock, option: Option): SurfaceAction;
+/** A list's action: the entry's id, under its title. */
+export declare function chosen(block: ListBlock & {
+  action: string;
+}, entry: Entry): SurfaceAction;
+/**
+ * A form's action: its values by field name (an empty field as null), under the words of its
+ * one answer when it asks one thing (the day, the slot, the options picked, the files' names,
+ * read from `files`), its submit's when it asks more.
+ */
+export declare function filled(block: FormBlock, values: Values, code: string, messages: KitMessages, files?: ReadonlyMap<string, Attachment>): SurfaceAction;
+/**
+ * A value in words, as the person's answer reads in the chat: a day and a time in the host's
+ * language (against `today`), the options' labels joined, the files' names (from `files`), a
+ * number with its unit; "" when it is empty. A secret is never shown.
+ */
+export declare function labelOf(field: FormField, value: FieldValue, code: string, messages: KitMessages, { today, files }?: {
+  today?: Date | undefined;
+  files?: ReadonlyMap<string, Attachment> | undefined;
+}): string;
+/**
+ * What is wrong with a value, in words, or null: empty when it must be filled, a shape that is
+ * not an email, a phone or an address, a number out of its bounds, a day or a time the field
+ * does not offer.
+ */
+export declare function problemOf(field: FormField, value: FieldValue, code: string, messages: KitMessages): string | null;
+//#endregion
+//# sourceMappingURL=values.d.ts.map

package/dist/surface/values.js

@@ -0,0 +1,237 @@
+import { formatNumber, withUnit } from "../kit/numbers.js";
+import { DAY, MOMENT, TIME, dayAllowed, formatDay, formatMoment, formatTime, momentParts, slotAllowed } from "../kit/dates.js";
+//#region src/surface/values.ts
+/** The field kinds this renderer draws; a surface with another falls back to its text. */
+const FIELD_KINDS = /* @__PURE__ */ new Set([
+	"text",
+	"textarea",
+	"email",
+	"phone",
+	"url",
+	"number",
+	"date",
+	"time",
+	"datetime",
+	"select",
+	"multiselect",
+	"checkbox",
+	"range",
+	"rating",
+	"file",
+	"secret"
+]);
+/** What a secret reads as, anywhere it is shown. */
+const MASK = "••••••••";
+/** The longest answer label the API takes. */
+const LABEL_MAX = 2e3;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
+const PHONE = /^\+?[\d\s().-]+$/;
+const URL_SHAPE = /^(https?:\/\/)?[^\s/.]+(\.[^\s/.]+)+(\/\S*)?$/i;
+/** A button's action: its name, nothing more, under its label. */
+function pressed(block) {
+	return {
+		name: block.action,
+		data: {},
+		label: block.label
+	};
+}
+/** A choice's action: the option's id, under its label. */
+function picked(block, option) {
+	return {
+		name: block.action,
+		data: { option: option.id },
+		label: option.label
+	};
+}
+/** A choice answered in the person's own words, under them. */
+function answeredIn(block, text) {
+	return {
+		name: block.action,
+		data: { text },
+		label: text
+	};
+}
+/** A list's action: the entry's id, under its title. */
+function chosen(block, entry) {
+	return {
+		name: block.action,
+		data: { item: entry.id },
+		label: entry.title
+	};
+}
+/**
+* A form's action: its values by field name (an empty field as null), under the words of its
+* one answer when it asks one thing (the day, the slot, the options picked, the files' names,
+* read from `files`), its submit's when it asks more.
+*/
+function filled(block, values, code, messages, files) {
+	const data = {};
+	for (const field of block.fields) data[field.name] = sent(field, values[field.name] ?? null);
+	const only = block.fields.length === 1 ? block.fields[0] : void 0;
+	const answer = only ? labelOf(only, data[only.name] ?? null, code, messages, { files }) : "";
+	return {
+		name: block.action,
+		data,
+		label: clip(answer) || (block.submit ?? messages.send)
+	};
+}
+/** A value as it goes: words trimmed, an empty one as null, a moment only once whole. */
+function sent(field, value) {
+	if (typeof value === "string") {
+		const text = value.trim();
+		if (field.kind === "datetime") return MOMENT.test(text) ? text : null;
+		return text === "" ? null : text;
+	}
+	if (typeof value === "number") return Number.isFinite(value) ? value : null;
+	return value;
+}
+/**
+* Each field's first value: what the person already sent (`answered`, the form's own action's
+* data), else what the agent gave it, else empty; a value that does not fit its kind is left out.
+*/
+function startValues(fields, answered) {
+	const values = {};
+	for (const field of fields) {
+		const given = answered && field.name in answered ? answered[field.name] : field.value;
+		values[field.name] = fit(field, given) ?? emptyOf(field);
+	}
+	return values;
+}
+/** A field with nothing given: unticked, none picked, a slider at its least, else nothing. */
+function emptyOf(field) {
+	switch (field.kind) {
+		case "checkbox": return false;
+		case "multiselect":
+		case "file": return [];
+		case "range": return field.min ?? 0;
+		default: return null;
+	}
+}
+/** A value read as the field's kind holds it, or null when it does not fit. */
+function fit(field, raw) {
+	switch (field.kind) {
+		case "checkbox": return raw === true || raw === "true" ? true : raw === false || raw === "false" ? false : null;
+		case "number":
+		case "range":
+		case "rating": {
+			const number = typeof raw === "string" && raw.trim() !== "" ? Number(raw) : raw;
+			return typeof number === "number" && Number.isFinite(number) ? number : null;
+		}
+		case "multiselect": return (Array.isArray(raw) ? raw : typeof raw === "string" ? [raw] : []).filter((id) => typeof id === "string" && hasOption(field, id));
+		case "file": {
+			const strings = (Array.isArray(raw) ? raw : typeof raw === "string" ? [raw] : []).filter((id) => typeof id === "string" && id !== "");
+			return field.multiple ? strings : strings.slice(0, 1);
+		}
+		case "select": return typeof raw === "string" && hasOption(field, raw) ? raw : null;
+		case "date": return typeof raw === "string" && DAY.test(raw) ? raw : null;
+		case "time": return typeof raw === "string" && TIME.test(raw) ? raw : null;
+		case "datetime": return typeof raw === "string" && MOMENT.test(raw.slice(0, 16)) ? raw.slice(0, 16) : null;
+		default: return typeof raw === "string" || typeof raw === "number" ? String(raw) : null;
+	}
+}
+/**
+* A value in words, as the person's answer reads in the chat: a day and a time in the host's
+* language (against `today`), the options' labels joined, the files' names (from `files`), a
+* number with its unit; "" when it is empty. A secret is never shown.
+*/
+function labelOf(field, value, code, messages, { today = /* @__PURE__ */ new Date(), files } = {}) {
+	if (field.kind === "secret") return value === null || value === "" ? "" : MASK;
+	if (field.kind === "checkbox") return value === true ? messages.yes : messages.no;
+	if (value === null) return "";
+	if (Array.isArray(value)) {
+		const labels = value.map((id) => field.kind === "file" ? files?.get(id)?.name ?? messages.file : optionOf(field, id)?.label ?? id);
+		return labels.length === 0 ? "" : new Intl.ListFormat(code, { type: "conjunction" }).format(labels);
+	}
+	if (typeof value === "number") {
+		if (field.kind === "rating") return messages.rated(value, field.max ?? 5);
+		return withUnit(formatNumber(value, code), field.unit);
+	}
+	if (typeof value !== "string") return "";
+	switch (field.kind) {
+		case "select": return optionOf(field, value)?.label ?? value;
+		case "date": return formatDay(value, code, today);
+		case "time": return TIME.test(value) ? formatTime(value, code) : value;
+		case "datetime": return formatMoment(value, code, today);
+		default: return value.trim();
+	}
+}
+function clip(text) {
+	return text.length > LABEL_MAX ? `${text.slice(0, 1999)}…` : text;
+}
+/** What is wrong with each field's value, by name; a field with nothing wrong is not in it. */
+function problemsOf(fields, values, code, messages) {
+	const problems = {};
+	for (const field of fields) {
+		const problem = problemOf(field, values[field.name] ?? null, code, messages);
+		if (problem !== null) problems[field.name] = problem;
+	}
+	return problems;
+}
+/**
+* What is wrong with a value, in words, or null: empty when it must be filled, a shape that is
+* not an email, a phone or an address, a number out of its bounds, a day or a time the field
+* does not offer.
+*/
+function problemOf(field, value, code, messages) {
+	if (isEmpty(field, value)) return field.required ? emptyWords(field, messages) : null;
+	const text = typeof value === "string" ? value.trim() : "";
+	switch (field.kind) {
+		case "email": return EMAIL.test(text) ? null : messages.invalidEmail;
+		case "phone": return PHONE.test(text) && text.replace(/\D/g, "").length >= 6 ? null : messages.invalidPhone;
+		case "url": return URL_SHAPE.test(text) ? null : messages.invalidUrl;
+		case "number":
+		case "range":
+		case "rating": return typeof value === "number" && Number.isFinite(value) ? outOfBounds(field, value, code, messages) : messages.invalidNumber;
+		case "date": return dayAllowed(field, text) ? null : messages.unavailableDate;
+		case "time":
+			if (!TIME.test(text)) return messages.invalidTime;
+			return slotAllowed(field.times, text) ? null : messages.unavailableTime;
+		case "datetime": {
+			const [date, time] = momentParts(text);
+			if (date === "" || time === "") return messages.chooseMoment;
+			if (!dayAllowed(field, date)) return messages.unavailableDate;
+			if (!TIME.test(time)) return messages.invalidTime;
+			return slotAllowed(field.times, time) ? null : messages.unavailableTime;
+		}
+		case "select": return hasOption(field, text) ? null : messages.chooseOption;
+		case "multiselect": return Array.isArray(value) && value.every((id) => hasOption(field, id)) ? null : messages.chooseOption;
+		default: return null;
+	}
+}
+/** Whether nothing was given: no words, no pick, an unticked box, no stars. */
+function isEmpty(field, value) {
+	if (value === null) return true;
+	if (field.kind === "checkbox") return value !== true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.length === 0;
+	return false;
+}
+function emptyWords(field, messages) {
+	switch (field.kind) {
+		case "date": return messages.chooseDate;
+		case "time": return messages.chooseTime;
+		case "datetime": return messages.chooseMoment;
+		case "select":
+		case "multiselect": return messages.chooseOption;
+		case "rating": return messages.chooseRating;
+		case "checkbox": return messages.check;
+		case "file": return messages.chooseFile;
+		default: return messages.required;
+	}
+}
+function outOfBounds(field, value, code, messages) {
+	const { min, max } = field;
+	if (min !== void 0 && value < min) return messages.atLeast(formatNumber(min, code));
+	if (max !== void 0 && value > max) return messages.atMost(formatNumber(max, code));
+	return null;
+}
+function optionOf(field, id) {
+	return field.options?.find((option) => option.id === id);
+}
+function hasOption(field, id) {
+	return optionOf(field, id) !== void 0;
+}
+//#endregion
+export { FIELD_KINDS, MASK, answeredIn, chosen, emptyOf, filled, fit, isEmpty, labelOf, optionOf, picked, pressed, problemOf, problemsOf, sent, startValues };
+
+//# sourceMappingURL=values.js.map

package/dist/surface/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","names":[],"sources":["../../src/surface/values.ts"],"sourcesContent":["/**\n * What a surface sends, as pure functions: each block's action, a form's values from its fields,\n * the words the person's answer reads as, and what is wrong with a value. The controls hold\n * values in the shapes the contract sends (`blocks.ts`); nothing here touches the page.\n */\nimport type {\n  ButtonBlock,\n  ChoiceBlock,\n  Entry,\n  FieldValue,\n  FormBlock,\n  FormField,\n  ListBlock,\n  Option,\n} from \"../blocks\";\nimport {\n  DAY,\n  dayAllowed,\n  formatDay,\n  formatMoment,\n  formatTime,\n  MOMENT,\n  momentParts,\n  slotAllowed,\n  TIME,\n} from \"../kit/dates\";\nimport type { KitMessages } from \"../kit/messages\";\nimport { formatNumber, withUnit } from \"../kit/numbers\";\nimport { STARS } from \"../kit/RatingField\";\nimport type { Action, Attachment } from \"../types\";\n\n/**\n * What a block sends when the person uses it: its action's name, what it carries, and the words\n * the app shows for it (the option picked, the button, the form's answer).\n */\nexport type SurfaceAction = Omit<Action, \"surface\">;\n\n/** A form's values by field name, as its controls hold them. */\nexport type Values = Record<string, FieldValue>;\n\n/** The field kinds this renderer draws; a surface with another falls back to its text. */\nexport const FIELD_KINDS: ReadonlySet<string> = new Set([\n  \"text\",\n  \"textarea\",\n  \"email\",\n  \"phone\",\n  \"url\",\n  \"number\",\n  \"date\",\n  \"time\",\n  \"datetime\",\n  \"select\",\n  \"multiselect\",\n  \"checkbox\",\n  \"range\",\n  \"rating\",\n  \"file\",\n  \"secret\",\n]);\n\n/** Up to this many options, a select shows them all; more go in a list to search. */\nexport const FEW_OPTIONS = 5;\n/** Up to this many, a multiselect is chips; more go in a list to search. */\nexport const FEW_CHIPS = 8;\n/** What a secret reads as, anywhere it is shown. */\nexport const MASK = \"••••••••\";\n/** The longest answer label the API takes. */\nconst LABEL_MAX = 2000;\n\nconst EMAIL = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]{2,}$/;\nconst PHONE = /^\\+?[\\d\\s().-]+$/;\nconst URL_SHAPE = /^(https?:\\/\\/)?[^\\s/.]+(\\.[^\\s/.]+)+(\\/\\S*)?$/i;\n\n// --- The blocks' actions ------------------------------------------------------------------\n\n/** A button's action: its name, nothing more, under its label. */\nexport function pressed(block: ButtonBlock & { action: string }): SurfaceAction {\n  return { name: block.action, data: {}, label: block.label };\n}\n\n/** A choice's action: the option's id, under its label. */\nexport function picked(block: ChoiceBlock, option: Option): SurfaceAction {\n  return { name: block.action, data: { option: option.id }, label: option.label };\n}\n\n/** A choice answered in the person's own words, under them. */\nexport function answeredIn(block: ChoiceBlock, text: string): SurfaceAction {\n  return { name: block.action, data: { text }, label: text };\n}\n\n/** A list's action: the entry's id, under its title. */\nexport function chosen(block: ListBlock & { action: string }, entry: Entry): SurfaceAction {\n  return { name: block.action, data: { item: entry.id }, label: entry.title };\n}\n\n/**\n * A form's action: its values by field name (an empty field as null), under the words of its\n * one answer when it asks one thing (the day, the slot, the options picked, the files' names,\n * read from `files`), its submit's when it asks more.\n */\nexport function filled(\n  block: FormBlock,\n  values: Values,\n  code: string,\n  messages: KitMessages,\n  files?: ReadonlyMap<string, Attachment>,\n): SurfaceAction {\n  const data: Values = {};\n  for (const field of block.fields) data[field.name] = sent(field, values[field.name] ?? null);\n  const only = block.fields.length === 1 ? block.fields[0] : undefined;\n  const answer = only ? labelOf(only, data[only.name] ?? null, code, messages, { files }) : \"\";\n  return { name: block.action, data, label: clip(answer) || (block.submit ?? messages.send) };\n}\n\n/** A value as it goes: words trimmed, an empty one as null, a moment only once whole. */\nexport function sent(field: FormField, value: FieldValue): FieldValue {\n  if (typeof value === \"string\") {\n    const text = value.trim();\n    if (field.kind === \"datetime\") return MOMENT.test(text) ? text : null;\n    return text === \"\" ? null : text;\n  }\n  if (typeof value === \"number\") return Number.isFinite(value) ? value : null;\n  return value;\n}\n\n// --- Where a form starts ------------------------------------------------------------------\n\n/**\n * Each field's first value: what the person already sent (`answered`, the form's own action's\n * data), else what the agent gave it, else empty; a value that does not fit its kind is left out.\n */\nexport function startValues(fields: FormField[], answered?: Record<string, unknown>): Values {\n  const values: Values = {};\n  for (const field of fields) {\n    const given = answered && field.name in answered ? answered[field.name] : field.value;\n    values[field.name] = fit(field, given) ?? emptyOf(field);\n  }\n  return values;\n}\n\n/** A field with nothing given: unticked, none picked, a slider at its least, else nothing. */\nexport function emptyOf(field: FormField): FieldValue {\n  switch (field.kind) {\n    case \"checkbox\":\n      return false;\n    case \"multiselect\":\n    case \"file\":\n      return [];\n    case \"range\":\n      return field.min ?? 0;\n    default:\n      return null;\n  }\n}\n\n/** A value read as the field's kind holds it, or null when it does not fit. */\nexport function fit(field: FormField, raw: unknown): FieldValue {\n  switch (field.kind) {\n    case \"checkbox\":\n      return raw === true || raw === \"true\"\n        ? true\n        : raw === false || raw === \"false\"\n          ? false\n          : null;\n    case \"number\":\n    case \"range\":\n    case \"rating\": {\n      const number = typeof raw === \"string\" && raw.trim() !== \"\" ? Number(raw) : raw;\n      return typeof number === \"number\" && Number.isFinite(number) ? number : null;\n    }\n    case \"multiselect\": {\n      const ids = Array.isArray(raw) ? raw : typeof raw === \"string\" ? [raw] : [];\n      return ids.filter((id): id is string => typeof id === \"string\" && hasOption(field, id));\n    }\n    case \"file\": {\n      const ids = Array.isArray(raw) ? raw : typeof raw === \"string\" ? [raw] : [];\n      const strings = ids.filter((id): id is string => typeof id === \"string\" && id !== \"\");\n      return field.multiple ? strings : strings.slice(0, 1);\n    }\n    case \"select\":\n      return typeof raw === \"string\" && hasOption(field, raw) ? raw : null;\n    case \"date\":\n      return typeof raw === \"string\" && DAY.test(raw) ? raw : null;\n    case \"time\":\n      return typeof raw === \"string\" && TIME.test(raw) ? raw : null;\n    case \"datetime\":\n      return typeof raw === \"string\" && MOMENT.test(raw.slice(0, 16)) ? raw.slice(0, 16) : null;\n    default:\n      return typeof raw === \"string\" || typeof raw === \"number\" ? String(raw) : null;\n  }\n}\n\n// --- What a value reads as ----------------------------------------------------------------\n\n/**\n * A value in words, as the person's answer reads in the chat: a day and a time in the host's\n * language (against `today`), the options' labels joined, the files' names (from `files`), a\n * number with its unit; \"\" when it is empty. A secret is never shown.\n */\nexport function labelOf(\n  field: FormField,\n  value: FieldValue,\n  code: string,\n  messages: KitMessages,\n  {\n    today = new Date(),\n    files,\n  }: { today?: Date | undefined; files?: ReadonlyMap<string, Attachment> | undefined } = {},\n): string {\n  if (field.kind === \"secret\") return value === null || value === \"\" ? \"\" : MASK;\n  if (field.kind === \"checkbox\") return value === true ? messages.yes : messages.no;\n  if (value === null) return \"\";\n  if (Array.isArray(value)) {\n    const labels = value.map((id) =>\n      field.kind === \"file\"\n        ? (files?.get(id)?.name ?? messages.file)\n        : (optionOf(field, id)?.label ?? id),\n    );\n    return labels.length === 0\n      ? \"\"\n      : new Intl.ListFormat(code, { type: \"conjunction\" }).format(labels);\n  }\n  if (typeof value === \"number\") {\n    if (field.kind === \"rating\") return messages.rated(value, field.max ?? STARS);\n    return withUnit(formatNumber(value, code), field.unit);\n  }\n  if (typeof value !== \"string\") return \"\";\n  switch (field.kind) {\n    case \"select\":\n      return optionOf(field, value)?.label ?? value;\n    case \"date\":\n      return formatDay(value, code, today);\n    case \"time\":\n      return TIME.test(value) ? formatTime(value, code) : value;\n    case \"datetime\":\n      return formatMoment(value, code, today);\n    default:\n      return value.trim();\n  }\n}\n\nfunction clip(text: string): string {\n  return text.length > LABEL_MAX ? `${text.slice(0, LABEL_MAX - 1)}…` : text;\n}\n\n// --- What is wrong with a value -----------------------------------------------------------\n\n/** What is wrong with each field's value, by name; a field with nothing wrong is not in it. */\nexport function problemsOf(\n  fields: FormField[],\n  values: Values,\n  code: string,\n  messages: KitMessages,\n): Record<string, string> {\n  const problems: Record<string, string> = {};\n  for (const field of fields) {\n    const problem = problemOf(field, values[field.name] ?? null, code, messages);\n    if (problem !== null) problems[field.name] = problem;\n  }\n  return problems;\n}\n\n/**\n * What is wrong with a value, in words, or null: empty when it must be filled, a shape that is\n * not an email, a phone or an address, a number out of its bounds, a day or a time the field\n * does not offer.\n */\nexport function problemOf(\n  field: FormField,\n  value: FieldValue,\n  code: string,\n  messages: KitMessages,\n): string | null {\n  if (isEmpty(field, value)) return field.required ? emptyWords(field, messages) : null;\n  const text = typeof value === \"string\" ? value.trim() : \"\";\n  switch (field.kind) {\n    case \"email\":\n      return EMAIL.test(text) ? null : messages.invalidEmail;\n    case \"phone\":\n      return PHONE.test(text) && text.replace(/\\D/g, \"\").length >= 6 ? null : messages.invalidPhone;\n    case \"url\":\n      return URL_SHAPE.test(text) ? null : messages.invalidUrl;\n    case \"number\":\n    case \"range\":\n    case \"rating\":\n      return typeof value === \"number\" && Number.isFinite(value)\n        ? outOfBounds(field, value, code, messages)\n        : messages.invalidNumber;\n    case \"date\":\n      return dayAllowed(field, text) ? null : messages.unavailableDate;\n    case \"time\":\n      if (!TIME.test(text)) return messages.invalidTime;\n      return slotAllowed(field.times, text) ? null : messages.unavailableTime;\n    case \"datetime\": {\n      const [date, time] = momentParts(text);\n      if (date === \"\" || time === \"\") return messages.chooseMoment;\n      if (!dayAllowed(field, date)) return messages.unavailableDate;\n      if (!TIME.test(time)) return messages.invalidTime;\n      return slotAllowed(field.times, time) ? null : messages.unavailableTime;\n    }\n    case \"select\":\n      return hasOption(field, text) ? null : messages.chooseOption;\n    case \"multiselect\":\n      return Array.isArray(value) && value.every((id) => hasOption(field, id))\n        ? null\n        : messages.chooseOption;\n    default:\n      return null;\n  }\n}\n\n/** Whether nothing was given: no words, no pick, an unticked box, no stars. */\nexport function isEmpty(field: FormField, value: FieldValue): boolean {\n  if (value === null) return true;\n  if (field.kind === \"checkbox\") return value !== true;\n  if (typeof value === \"string\") return value.trim() === \"\";\n  if (Array.isArray(value)) return value.length === 0;\n  return false;\n}\n\nfunction emptyWords(field: FormField, messages: KitMessages): string {\n  switch (field.kind) {\n    case \"date\":\n      return messages.chooseDate;\n    case \"time\":\n      return messages.chooseTime;\n    case \"datetime\":\n      return messages.chooseMoment;\n    case \"select\":\n    case \"multiselect\":\n      return messages.chooseOption;\n    case \"rating\":\n      return messages.chooseRating;\n    case \"checkbox\":\n      return messages.check;\n    case \"file\":\n      return messages.chooseFile;\n    default:\n      return messages.required;\n  }\n}\n\nfunction outOfBounds(\n  field: FormField,\n  value: number,\n  code: string,\n  messages: KitMessages,\n): string | null {\n  const { min, max } = field;\n  if (min !== undefined && value < min) return messages.atLeast(formatNumber(min, code));\n  if (max !== undefined && value > max) return messages.atMost(formatNumber(max, code));\n  return null;\n}\n\nexport function optionOf(field: FormField, id: string): Option | undefined {\n  return field.options?.find((option) => option.id === id);\n}\n\nfunction hasOption(field: FormField, id: string): boolean {\n  return optionOf(field, id) !== undefined;\n}\n"],"mappings":"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"}

package/dist/tint.d.ts

@@ -0,0 +1,10 @@
+//#region src/tint.d.ts
+/** The tints an agent's tile can take: the soft ones, never a state or the accent. */
+export type AgentTint = "sky" | "rose" | "sand";
+/**
+ * The tint an agent keeps wherever it appears (a squad's map, its profile, its card): picked from
+ * its id, so a rename changes nothing, and spread evenly over the three.
+ */
+export declare function agentTint(id: string): AgentTint;
+//#endregion
+//# sourceMappingURL=tint.d.ts.map

package/dist/tint.js

@@ -0,0 +1,19 @@
+//#region src/tint.ts
+const TINTS = [
+	"sky",
+	"rose",
+	"sand"
+];
+/**
+* The tint an agent keeps wherever it appears (a squad's map, its profile, its card): picked from
+* its id, so a rename changes nothing, and spread evenly over the three.
+*/
+function agentTint(id) {
+	let hash = 0;
+	for (const char of id) hash = hash * 31 + (char.codePointAt(0) ?? 0) >>> 0;
+	return TINTS[hash % TINTS.length] ?? "sky";
+}
+//#endregion
+export { agentTint };
+
+//# sourceMappingURL=tint.js.map

package/dist/tint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tint.js","names":[],"sources":["../src/tint.ts"],"sourcesContent":["/** The tints an agent's tile can take: the soft ones, never a state or the accent. */\nexport type AgentTint = \"sky\" | \"rose\" | \"sand\";\n\nconst TINTS: readonly AgentTint[] = [\"sky\", \"rose\", \"sand\"];\n\n/**\n * The tint an agent keeps wherever it appears (a squad's map, its profile, its card): picked from\n * its id, so a rename changes nothing, and spread evenly over the three.\n */\nexport function agentTint(id: string): AgentTint {\n  let hash = 0;\n  for (const char of id) hash = (hash * 31 + (char.codePointAt(0) ?? 0)) >>> 0;\n  return TINTS[hash % TINTS.length] ?? \"sky\";\n}\n"],"mappings":";AAGA,MAAM,QAA8B;CAAC;CAAO;CAAQ;AAAM;;;;;AAM1D,SAAgB,UAAU,IAAuB;CAC/C,IAAI,OAAO;CACX,KAAK,MAAM,QAAQ,IAAI,OAAQ,OAAO,MAAM,KAAK,YAAY,CAAC,KAAK,OAAQ;CAC3E,OAAO,MAAM,OAAO,MAAM,WAAW;AACvC"}