@exsto/ds 0.0.1-rc.2 → 0.0.1-rc.22

package/dist/ui/src/components/edyn/date-range-picker/date-range-picker.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * DateRangePicker: the day arithmetic and the trigger's text.
+ *
+ * PATH TAKEN: converting a calendar day to a Date and back, and how the ends are
+ * written, are plain logic and run in happy-dom. Opening the calendar, picking two
+ * days and the one-month layout on a phone need a real browser and layout, so
+ * e2e/date-range-picker.spec.ts covers those.
+ */
+export {};

package/dist/ui/src/components/edyn/date-range-picker/index.d.ts

@@ -0,0 +1 @@
+export * from './date-range-picker';

package/dist/ui/src/components/edyn/file-input/file-input.d.ts

@@ -0,0 +1,90 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+export type TFileRejectReason = 'type' | 'size' | 'count';
+export interface IFileRejection {
+    file: File;
+    reason: TFileRejectReason;
+}
+/** The words a FileInput says and announces. Pass the ones to change. */
+export interface IFileInputLabels {
+    /** The prompt in the drop area when it takes one file, before the "browse" link. */
+    dropOne: string;
+    /** The same, when it takes several. */
+    dropMany: string;
+    browse: string;
+    /** The accessible name of the file chooser itself, when the caller gives it no name of its own. */
+    chooseOne: string;
+    chooseMany: string;
+    /** The accessible name of the list of chosen files. */
+    list: string;
+    remove: (name: string) => string;
+    /** Announced when files are added. */
+    added: (count: number) => string;
+    /** Announced when a file is taken out. */
+    removed: (name: string) => string;
+    /** Said, and shown, for a file that was refused. */
+    rejection: (name: string, reason: TFileRejectReason, limit: string) => string;
+}
+export declare const DEFAULT_FILE_INPUT_LABELS: IFileInputLabels;
+/** 1,536 bytes as "1.5 KB": the size a person reads next to a file's name. */
+export declare const formatBytes: (bytes: number) => string;
+/** Whether a file is one `accept` allows: an extension (`.pdf`), a type (`application/pdf`) or a family of types (`image/*`). No `accept` allows all. */
+export declare const matchesAccept: (file: {
+    name: string;
+    type: string;
+}, accept: string | undefined) => boolean;
+export interface ISortFilesInput {
+    incoming: readonly File[];
+    current: readonly File[];
+    multiple: boolean;
+    accept?: string;
+    maxSize?: number;
+    maxFiles?: number;
+}
+/**
+ * Which of the files just offered are taken, and which are refused and why. A file already chosen is skipped without a word. With one
+ * file allowed, the first acceptable one replaces what was chosen and the rest are refused as too many.
+ */
+export declare const sortFiles: ({ incoming, current, multiple, accept, maxSize, maxFiles, }: ISortFilesInput) => {
+    accepted: File[];
+    rejected: IFileRejection[];
+};
+export interface IFileInputProps extends Omit<ComponentPropsWithoutRef<'div'>, 'defaultValue' | 'onChange' | 'children' | 'id'> {
+    /** The chosen files. Leave it out and the field keeps them itself. */
+    value?: readonly File[];
+    defaultValue?: readonly File[];
+    onValueChange?: (files: File[]) => void;
+    /** What the picker offers, and what a drop is held to: extensions (`.pdf`), types (`application/pdf`) or families (`image/*`). */
+    accept?: string;
+    /** Several files, added to each other, instead of one that is replaced. */
+    multiple?: boolean;
+    /** The most a file may weigh, in bytes. */
+    maxSize?: number;
+    /** The most files that may be chosen. Several-file fields only. */
+    maxFiles?: number;
+    /** Called with the files that were refused, each with the reason. They are also listed under the field. */
+    onReject?: (rejections: IFileRejection[]) => void;
+    disabled?: boolean;
+    invalid?: boolean;
+    required?: boolean;
+    /** Submits the chosen files with a form, under this name. */
+    name?: string;
+    /** For a `<Label htmlFor>` to name the field. */
+    id?: string;
+    /** What the field accepts, in words ("PDF or PNG, up to 5 MB"), read with the field. */
+    hint?: ReactNode;
+    labels?: Partial<IFileInputLabels>;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+/**
+ * Chooses files by picking them or by dropping them on the field, in the kit's look. It exists so an app does not fall back to
+ * `<input type="file">`, which cannot be styled and has no list of what was chosen.
+ *
+ * The control is a real file input laid over the whole drop area, so Tab, Enter and Space, the system's file dialog, a drop and a
+ * screen reader's name for it all come from the browser. What the browser lacks is added around it: the list of chosen files with a
+ * button to take each out, the checks against `accept`, `maxSize` and `maxFiles` (a drop skips the dialog's own filter), and a
+ * live region that says what was added, removed or refused.
+ *
+ * Name the field with `aria-label`, `aria-labelledby` or a `<Label htmlFor={id}>`; with none of those it is named "Choose files".
+ */
+export declare const FileInput: ({ value, defaultValue, onValueChange, accept, multiple, maxSize, maxFiles, onReject, disabled, invalid, required, name, id, hint, labels: labelOverrides, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...rest }: IFileInputProps) => import('react').JSX.Element;

package/dist/ui/src/components/edyn/file-input/file-input.js

@@ -0,0 +1,261 @@
+import { cn } from "../../../lib/utils.js";
+import { Button } from "../../ui/button/button.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { IconFile, IconUpload, IconX } from "@tabler/icons-react";
+//#region ../ui/src/components/edyn/file-input/file-input.tsx
+var DEFAULT_FILE_INPUT_LABELS = {
+	dropOne: "Drag a file here or",
+	dropMany: "Drag files here or",
+	browse: "browse",
+	chooseOne: "Choose a file",
+	chooseMany: "Choose files",
+	list: "Chosen files",
+	remove: (name) => `Remove ${name}`,
+	added: (count) => count === 1 ? "1 file added" : `${count} files added`,
+	removed: (name) => `${name} removed`,
+	rejection: (name, reason, limit) => {
+		if (reason === "type") return `${name} was not added: this type is not accepted`;
+		if (reason === "size") return `${name} was not added: it is larger than ${limit}`;
+		return `${name} was not added: ${limit === "1" ? "1 file is" : `${limit} files are`} the most`;
+	}
+};
+var UNITS = [
+	"B",
+	"KB",
+	"MB",
+	"GB"
+];
+/** 1,536 bytes as "1.5 KB": the size a person reads next to a file's name. */
+var formatBytes = (bytes) => {
+	let size = bytes;
+	let unit = 0;
+	while (size >= 1024 && unit < UNITS.length - 1) {
+		size /= 1024;
+		unit += 1;
+	}
+	return `${unit === 0 || size >= 10 ? String(Math.round(size)) : size.toFixed(1).replace(/\.0$/, "")} ${UNITS[unit]}`;
+};
+/** Whether a file is one `accept` allows: an extension (`.pdf`), a type (`application/pdf`) or a family of types (`image/*`). No `accept` allows all. */
+var matchesAccept = (file, accept) => {
+	const tokens = (accept ?? "").split(",").map((token) => token.trim().toLowerCase()).filter((token) => token !== "");
+	if (tokens.length === 0) return true;
+	const name = file.name.toLowerCase();
+	const type = file.type.toLowerCase();
+	return tokens.some((token) => {
+		if (token.startsWith(".")) return name.endsWith(token);
+		if (token.endsWith("/*")) return type.startsWith(token.slice(0, -1));
+		return type === token;
+	});
+};
+var sameFile = (a, b) => a.name === b.name && a.size === b.size && a.lastModified === b.lastModified;
+/**
+* Which of the files just offered are taken, and which are refused and why. A file already chosen is skipped without a word. With one
+* file allowed, the first acceptable one replaces what was chosen and the rest are refused as too many.
+*/
+var sortFiles = ({ incoming, current, multiple, accept, maxSize, maxFiles }) => {
+	const accepted = [];
+	const rejected = [];
+	const limit = multiple ? maxFiles : 1;
+	for (const file of incoming) if (!matchesAccept(file, accept)) rejected.push({
+		file,
+		reason: "type"
+	});
+	else if (maxSize !== void 0 && file.size > maxSize) rejected.push({
+		file,
+		reason: "size"
+	});
+	else if (current.some((chosen) => sameFile(chosen, file)) || accepted.some((taken) => sameFile(taken, file))) {} else if (limit !== void 0 && (multiple ? current.length : 0) + accepted.length >= limit) rejected.push({
+		file,
+		reason: "count"
+	});
+	else accepted.push(file);
+	return {
+		accepted,
+		rejected
+	};
+};
+var limitText = (reason, maxSize, maxFiles, multiple) => {
+	if (reason === "size") return formatBytes(maxSize ?? 0);
+	return String(multiple ? maxFiles ?? 0 : 1);
+};
+/**
+* Chooses files by picking them or by dropping them on the field, in the kit's look. It exists so an app does not fall back to
+* `<input type="file">`, which cannot be styled and has no list of what was chosen.
+*
+* The control is a real file input laid over the whole drop area, so Tab, Enter and Space, the system's file dialog, a drop and a
+* screen reader's name for it all come from the browser. What the browser lacks is added around it: the list of chosen files with a
+* button to take each out, the checks against `accept`, `maxSize` and `maxFiles` (a drop skips the dialog's own filter), and a
+* live region that says what was added, removed or refused.
+*
+* Name the field with `aria-label`, `aria-labelledby` or a `<Label htmlFor={id}>`; with none of those it is named "Choose files".
+*/
+var FileInput = ({ value, defaultValue = [], onValueChange, accept, multiple = false, maxSize, maxFiles, onReject, disabled = false, invalid = false, required = false, name, id, hint, labels: labelOverrides, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...rest }) => {
+	const labels = useMemo(() => ({
+		...DEFAULT_FILE_INPUT_LABELS,
+		...labelOverrides
+	}), [labelOverrides]);
+	const [inner, setInner] = useState(defaultValue);
+	const files = value ?? inner;
+	const [dragging, setDragging] = useState(false);
+	const [rejections, setRejections] = useState([]);
+	const [announcement, setAnnouncement] = useState("");
+	const refInput = useRef(null);
+	const hintId = `${id ?? "file-input"}-hint`;
+	useEffect(() => {
+		const input = refInput.current;
+		if (input === null || typeof DataTransfer === "undefined") return;
+		const transfer = new DataTransfer();
+		for (const file of files) transfer.items.add(file);
+		input.files = transfer.files;
+	}, [files]);
+	const commit = (next) => {
+		setInner(next);
+		onValueChange?.(next);
+	};
+	const take = (incoming) => {
+		if (incoming.length === 0) return;
+		const { accepted, rejected } = sortFiles({
+			incoming,
+			current: files,
+			multiple,
+			accept,
+			maxSize,
+			maxFiles
+		});
+		setRejections(rejected);
+		if (rejected.length > 0) onReject?.(rejected);
+		if (accepted.length > 0) {
+			commit(multiple ? [...files, ...accepted] : accepted);
+			setAnnouncement(labels.added(accepted.length));
+		} else setAnnouncement("");
+	};
+	const remove = (index) => {
+		const gone = files[index];
+		if (gone === void 0) return;
+		setRejections([]);
+		commit(files.filter((_, at) => at !== index));
+		setAnnouncement(labels.removed(gone.name));
+		refInput.current?.focus();
+	};
+	const onChange = (event) => {
+		take([...event.target.files ?? []]);
+	};
+	const carriesFiles = (event) => event.dataTransfer.types.includes("Files");
+	const onDrag = (event) => {
+		if (disabled || !carriesFiles(event)) return;
+		event.preventDefault();
+		setDragging(true);
+	};
+	const onDrop = (event) => {
+		if (disabled || !carriesFiles(event)) return;
+		event.preventDefault();
+		setDragging(false);
+		take([...event.dataTransfer.files]);
+	};
+	const named = ariaLabel !== void 0 || ariaLabelledBy !== void 0 || id !== void 0;
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "file-input",
+		className: cn("flex w-full flex-col gap-2", className),
+		...rest,
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				"data-slot": "file-input-zone",
+				role: "presentation",
+				"data-dragging": dragging || void 0,
+				className: cn("relative flex flex-col items-center justify-center gap-1 rounded-lg border border-dashed border-control px-4 py-6 text-center text-sm transition-colors dark:bg-input/30", "hover:bg-foreground/4 has-[input:focus-visible]:outline-solid", "data-dragging:border-ring data-dragging:bg-foreground/6", invalid && "border-destructive ring-3 ring-destructive/20 dark:border-destructive/50 dark:ring-destructive/40", disabled && "pointer-events-none cursor-not-allowed border-border"),
+				onDragEnter: onDrag,
+				onDragOver: onDrag,
+				onDragLeave: (event) => {
+					if (!event.currentTarget.contains(event.relatedTarget)) setDragging(false);
+				},
+				onDrop,
+				children: [
+					/* @__PURE__ */ jsx(IconUpload, {
+						"aria-hidden": "true",
+						className: "size-5 text-muted-foreground"
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: disabled ? "text-muted-foreground" : "text-foreground",
+						children: [
+							multiple ? labels.dropMany : labels.dropOne,
+							" ",
+							/* @__PURE__ */ jsx("span", {
+								className: "font-medium underline underline-offset-3",
+								children: labels.browse
+							})
+						]
+					}),
+					hint !== void 0 && /* @__PURE__ */ jsx("p", {
+						id: hintId,
+						className: "text-xs text-muted-foreground",
+						children: hint
+					}),
+					/* @__PURE__ */ jsx("input", {
+						ref: refInput,
+						id,
+						type: "file",
+						name,
+						accept,
+						multiple,
+						disabled,
+						required: required && files.length === 0,
+						"aria-label": named ? ariaLabel : multiple ? labels.chooseMany : labels.chooseOne,
+						"aria-labelledby": ariaLabelledBy,
+						"aria-describedby": hint === void 0 ? void 0 : hintId,
+						"aria-invalid": invalid || void 0,
+						className: "absolute inset-0 size-full cursor-pointer opacity-0 disabled:cursor-not-allowed",
+						onChange
+					})
+				]
+			}),
+			files.length > 0 && /* @__PURE__ */ jsx("ul", {
+				"data-slot": "file-input-list",
+				"aria-label": labels.list,
+				className: "flex flex-col gap-1",
+				children: files.map((file, index) => /* @__PURE__ */ jsxs("li", {
+					className: "flex items-center gap-2 rounded-lg border border-control py-1 pr-1 pl-2 text-sm",
+					children: [
+						/* @__PURE__ */ jsx(IconFile, {
+							"aria-hidden": "true",
+							className: "size-4 shrink-0 text-muted-foreground"
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: "min-w-0 flex-1 truncate",
+							children: file.name
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: "shrink-0 text-xs text-muted-foreground tabular-nums",
+							children: formatBytes(file.size)
+						}),
+						/* @__PURE__ */ jsx(Button, {
+							type: "button",
+							variant: "ghost",
+							size: "icon-xs",
+							disabled,
+							"aria-label": labels.remove(file.name),
+							onClick: () => remove(index),
+							children: /* @__PURE__ */ jsx(IconX, { "aria-hidden": "true" })
+						})
+					]
+				}, `${file.name}-${file.size}-${file.lastModified}`))
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				role: "status",
+				"data-slot": "file-input-status",
+				className: "text-sm empty:hidden",
+				children: [rejections.map(({ file, reason }) => /* @__PURE__ */ jsx("p", {
+					className: "text-destructive",
+					children: labels.rejection(file.name, reason, limitText(reason, maxSize, maxFiles, multiple))
+				}, `${file.name}-${reason}`)), announcement !== "" && /* @__PURE__ */ jsx("span", {
+					className: "sr-only",
+					children: announcement
+				})]
+			})
+		]
+	});
+};
+//#endregion
+export { DEFAULT_FILE_INPUT_LABELS, FileInput, formatBytes, matchesAccept, sortFiles };
+
+//# sourceMappingURL=file-input.js.map

package/dist/ui/src/components/edyn/file-input/file-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-input.js","names":[],"sources":["../../../../../../../ui/src/components/edyn/file-input/file-input.tsx"],"sourcesContent":["import { Button } from '@edyn/ui/components/ui/button';\nimport { cn } from '@edyn/ui/lib/utils';\nimport { IconFile, IconUpload, IconX } from '@tabler/icons-react';\nimport { type ChangeEvent, type ComponentPropsWithoutRef, type DragEvent, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\n\nexport type TFileRejectReason = 'type' | 'size' | 'count';\n\nexport interface IFileRejection {\n  file: File;\n  reason: TFileRejectReason;\n}\n\n/** The words a FileInput says and announces. Pass the ones to change. */\nexport interface IFileInputLabels {\n  /** The prompt in the drop area when it takes one file, before the \"browse\" link. */\n  dropOne: string;\n  /** The same, when it takes several. */\n  dropMany: string;\n  browse: string;\n  /** The accessible name of the file chooser itself, when the caller gives it no name of its own. */\n  chooseOne: string;\n  chooseMany: string;\n  /** The accessible name of the list of chosen files. */\n  list: string;\n  remove: (name: string) => string;\n  /** Announced when files are added. */\n  added: (count: number) => string;\n  /** Announced when a file is taken out. */\n  removed: (name: string) => string;\n  /** Said, and shown, for a file that was refused. */\n  rejection: (name: string, reason: TFileRejectReason, limit: string) => string;\n}\n\nexport const DEFAULT_FILE_INPUT_LABELS: IFileInputLabels = {\n  dropOne: 'Drag a file here or',\n  dropMany: 'Drag files here or',\n  browse: 'browse',\n  chooseOne: 'Choose a file',\n  chooseMany: 'Choose files',\n  list: 'Chosen files',\n  remove: (name) => `Remove ${name}`,\n  added: (count) => (count === 1 ? '1 file added' : `${count} files added`),\n  removed: (name) => `${name} removed`,\n  rejection: (name, reason, limit) => {\n    if (reason === 'type') {\n      return `${name} was not added: this type is not accepted`;\n    }\n    if (reason === 'size') {\n      return `${name} was not added: it is larger than ${limit}`;\n    }\n    return `${name} was not added: ${limit === '1' ? '1 file is' : `${limit} files are`} the most`;\n  },\n};\n\nconst UNITS = ['B', 'KB', 'MB', 'GB'] as const;\n\n/** 1,536 bytes as \"1.5 KB\": the size a person reads next to a file's name. */\nexport const formatBytes = (bytes: number): string => {\n  let size = bytes;\n  let unit = 0;\n  while (size >= 1024 && unit < UNITS.length - 1) {\n    size /= 1024;\n    unit += 1;\n  }\n  const text = unit === 0 || size >= 10 ? String(Math.round(size)) : size.toFixed(1).replace(/\\.0$/, '');\n  return `${text} ${UNITS[unit]}`;\n};\n\n/** Whether a file is one `accept` allows: an extension (`.pdf`), a type (`application/pdf`) or a family of types (`image/*`). No `accept` allows all. */\nexport const matchesAccept = (file: { name: string; type: string }, accept: string | undefined): boolean => {\n  const tokens = (accept ?? '')\n    .split(',')\n    .map((token) => token.trim().toLowerCase())\n    .filter((token) => token !== '');\n  if (tokens.length === 0) {\n    return true;\n  }\n  const name = file.name.toLowerCase();\n  const type = file.type.toLowerCase();\n  return tokens.some((token) => {\n    if (token.startsWith('.')) {\n      return name.endsWith(token);\n    }\n    if (token.endsWith('/*')) {\n      return type.startsWith(token.slice(0, -1));\n    }\n    return type === token;\n  });\n};\n\nconst sameFile = (a: File, b: File): boolean => a.name === b.name && a.size === b.size && a.lastModified === b.lastModified;\n\nexport interface ISortFilesInput {\n  incoming: readonly File[];\n  current: readonly File[];\n  multiple: boolean;\n  accept?: string;\n  maxSize?: number;\n  maxFiles?: number;\n}\n\n/**\n * Which of the files just offered are taken, and which are refused and why. A file already chosen is skipped without a word. With one\n * file allowed, the first acceptable one replaces what was chosen and the rest are refused as too many.\n */\nexport const sortFiles = ({\n  incoming,\n  current,\n  multiple,\n  accept,\n  maxSize,\n  maxFiles,\n}: ISortFilesInput): { accepted: File[]; rejected: IFileRejection[] } => {\n  const accepted: File[] = [];\n  const rejected: IFileRejection[] = [];\n  const limit = multiple ? maxFiles : 1;\n  for (const file of incoming) {\n    if (!matchesAccept(file, accept)) {\n      rejected.push({ file, reason: 'type' });\n    } else if (maxSize !== undefined && file.size > maxSize) {\n      rejected.push({ file, reason: 'size' });\n    } else if (current.some((chosen) => sameFile(chosen, file)) || accepted.some((taken) => sameFile(taken, file))) {\n    } else if (limit !== undefined && (multiple ? current.length : 0) + accepted.length >= limit) {\n      rejected.push({ file, reason: 'count' });\n    } else {\n      accepted.push(file);\n    }\n  }\n  return { accepted, rejected };\n};\n\nexport interface IFileInputProps extends Omit<ComponentPropsWithoutRef<'div'>, 'defaultValue' | 'onChange' | 'children' | 'id'> {\n  /** The chosen files. Leave it out and the field keeps them itself. */\n  value?: readonly File[];\n  defaultValue?: readonly File[];\n  onValueChange?: (files: File[]) => void;\n  /** What the picker offers, and what a drop is held to: extensions (`.pdf`), types (`application/pdf`) or families (`image/*`). */\n  accept?: string;\n  /** Several files, added to each other, instead of one that is replaced. */\n  multiple?: boolean;\n  /** The most a file may weigh, in bytes. */\n  maxSize?: number;\n  /** The most files that may be chosen. Several-file fields only. */\n  maxFiles?: number;\n  /** Called with the files that were refused, each with the reason. They are also listed under the field. */\n  onReject?: (rejections: IFileRejection[]) => void;\n  disabled?: boolean;\n  invalid?: boolean;\n  required?: boolean;\n  /** Submits the chosen files with a form, under this name. */\n  name?: string;\n  /** For a `<Label htmlFor>` to name the field. */\n  id?: string;\n  /** What the field accepts, in words (\"PDF or PNG, up to 5 MB\"), read with the field. */\n  hint?: ReactNode;\n  labels?: Partial<IFileInputLabels>;\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n}\n\nconst limitText = (reason: TFileRejectReason, maxSize: number | undefined, maxFiles: number | undefined, multiple: boolean): string => {\n  if (reason === 'size') {\n    return formatBytes(maxSize ?? 0);\n  }\n  return String(multiple ? (maxFiles ?? 0) : 1);\n};\n\n/**\n * Chooses files by picking them or by dropping them on the field, in the kit's look. It exists so an app does not fall back to\n * `<input type=\"file\">`, which cannot be styled and has no list of what was chosen.\n *\n * The control is a real file input laid over the whole drop area, so Tab, Enter and Space, the system's file dialog, a drop and a\n * screen reader's name for it all come from the browser. What the browser lacks is added around it: the list of chosen files with a\n * button to take each out, the checks against `accept`, `maxSize` and `maxFiles` (a drop skips the dialog's own filter), and a\n * live region that says what was added, removed or refused.\n *\n * Name the field with `aria-label`, `aria-labelledby` or a `<Label htmlFor={id}>`; with none of those it is named \"Choose files\".\n */\nexport const FileInput = ({\n  value,\n  defaultValue = [],\n  onValueChange,\n  accept,\n  multiple = false,\n  maxSize,\n  maxFiles,\n  onReject,\n  disabled = false,\n  invalid = false,\n  required = false,\n  name,\n  id,\n  hint,\n  labels: labelOverrides,\n  className,\n  'aria-label': ariaLabel,\n  'aria-labelledby': ariaLabelledBy,\n  ...rest\n}: IFileInputProps) => {\n  const labels = useMemo(() => ({ ...DEFAULT_FILE_INPUT_LABELS, ...labelOverrides }), [labelOverrides]);\n  const [inner, setInner] = useState<readonly File[]>(defaultValue);\n  const files = value ?? inner;\n  const [dragging, setDragging] = useState(false);\n  const [rejections, setRejections] = useState<IFileRejection[]>([]);\n  const [announcement, setAnnouncement] = useState('');\n  const refInput = useRef<HTMLInputElement | null>(null);\n  const hintId = `${id ?? 'file-input'}-hint`;\n\n  // The input's own list follows the chosen files, so a form submits exactly what the list shows.\n  useEffect(() => {\n    const input = refInput.current;\n    if (input === null || typeof DataTransfer === 'undefined') {\n      return;\n    }\n    const transfer = new DataTransfer();\n    for (const file of files) {\n      transfer.items.add(file);\n    }\n    input.files = transfer.files;\n  }, [files]);\n\n  const commit = (next: File[]): void => {\n    setInner(next);\n    onValueChange?.(next);\n  };\n\n  const take = (incoming: File[]): void => {\n    if (incoming.length === 0) {\n      return;\n    }\n    const { accepted, rejected } = sortFiles({ incoming, current: files, multiple, accept, maxSize, maxFiles });\n    setRejections(rejected);\n    if (rejected.length > 0) {\n      onReject?.(rejected);\n    }\n    if (accepted.length > 0) {\n      commit(multiple ? [...files, ...accepted] : accepted);\n      setAnnouncement(labels.added(accepted.length));\n    } else {\n      setAnnouncement('');\n    }\n  };\n\n  const remove = (index: number): void => {\n    const gone = files[index];\n    if (gone === undefined) {\n      return;\n    }\n    setRejections([]);\n    commit(files.filter((_, at) => at !== index));\n    setAnnouncement(labels.removed(gone.name));\n    refInput.current?.focus();\n  };\n\n  const onChange = (event: ChangeEvent<HTMLInputElement>): void => {\n    take([...(event.target.files ?? [])]);\n  };\n\n  const carriesFiles = (event: DragEvent): boolean => event.dataTransfer.types.includes('Files');\n\n  const onDrag = (event: DragEvent<HTMLDivElement>): void => {\n    if (disabled || !carriesFiles(event)) {\n      return;\n    }\n    event.preventDefault();\n    setDragging(true);\n  };\n\n  const onDrop = (event: DragEvent<HTMLDivElement>): void => {\n    if (disabled || !carriesFiles(event)) {\n      return;\n    }\n    // The drop is handled here, once, and not again by the input underneath.\n    event.preventDefault();\n    setDragging(false);\n    take([...event.dataTransfer.files]);\n  };\n\n  const named = ariaLabel !== undefined || ariaLabelledBy !== undefined || id !== undefined;\n\n  return (\n    <div data-slot=\"file-input\" className={cn('flex w-full flex-col gap-2', className)} {...rest}>\n      {/* biome-ignore lint/a11y/noStaticElementInteractions: a drop is only the pointer's way onto the file input laid over this area, which stays the keyboard and screen-reader way. */}\n      <div\n        data-slot=\"file-input-zone\"\n        role=\"presentation\"\n        data-dragging={dragging || undefined}\n        className={cn(\n          'relative flex flex-col items-center justify-center gap-1 rounded-lg border border-dashed border-control px-4 py-6 text-center text-sm transition-colors dark:bg-input/30',\n          'hover:bg-foreground/4 has-[input:focus-visible]:outline-solid',\n          'data-dragging:border-ring data-dragging:bg-foreground/6',\n          invalid && 'border-destructive ring-3 ring-destructive/20 dark:border-destructive/50 dark:ring-destructive/40',\n          // The prompt stays readable (4.5:1) the way a disabled Button's text does: no opacity on the text, a muted colour instead.\n          disabled && 'pointer-events-none cursor-not-allowed border-border',\n        )}\n        onDragEnter={onDrag}\n        onDragOver={onDrag}\n        onDragLeave={(event) => {\n          if (!event.currentTarget.contains(event.relatedTarget as Node | null)) {\n            setDragging(false);\n          }\n        }}\n        onDrop={onDrop}\n      >\n        <IconUpload aria-hidden=\"true\" className=\"size-5 text-muted-foreground\" />\n        <p className={disabled ? 'text-muted-foreground' : 'text-foreground'}>\n          {multiple ? labels.dropMany : labels.dropOne} <span className=\"font-medium underline underline-offset-3\">{labels.browse}</span>\n        </p>\n        {hint !== undefined && (\n          <p id={hintId} className=\"text-xs text-muted-foreground\">\n            {hint}\n          </p>\n        )}\n        <input\n          ref={refInput}\n          id={id}\n          type=\"file\"\n          name={name}\n          accept={accept}\n          multiple={multiple}\n          disabled={disabled}\n          required={required && files.length === 0}\n          aria-label={named ? ariaLabel : multiple ? labels.chooseMany : labels.chooseOne}\n          aria-labelledby={ariaLabelledBy}\n          aria-describedby={hint === undefined ? undefined : hintId}\n          aria-invalid={invalid || undefined}\n          className=\"absolute inset-0 size-full cursor-pointer opacity-0 disabled:cursor-not-allowed\"\n          onChange={onChange}\n        />\n      </div>\n      {files.length > 0 && (\n        <ul data-slot=\"file-input-list\" aria-label={labels.list} className=\"flex flex-col gap-1\">\n          {files.map((file, index) => (\n            <li\n              key={`${file.name}-${file.size}-${file.lastModified}`}\n              className=\"flex items-center gap-2 rounded-lg border border-control py-1 pr-1 pl-2 text-sm\"\n            >\n              <IconFile aria-hidden=\"true\" className=\"size-4 shrink-0 text-muted-foreground\" />\n              <span className=\"min-w-0 flex-1 truncate\">{file.name}</span>\n              <span className=\"shrink-0 text-xs text-muted-foreground tabular-nums\">{formatBytes(file.size)}</span>\n              <Button\n                type=\"button\"\n                variant=\"ghost\"\n                size=\"icon-xs\"\n                disabled={disabled}\n                aria-label={labels.remove(file.name)}\n                onClick={() => remove(index)}\n              >\n                <IconX aria-hidden=\"true\" />\n              </Button>\n            </li>\n          ))}\n        </ul>\n      )}\n      {/* One live region: it stays mounted and only its words change, which is what makes a screen reader say them. The refused files are\n          the visible part; what was added or removed is for the ear. */}\n      <div role=\"status\" data-slot=\"file-input-status\" className=\"text-sm empty:hidden\">\n        {rejections.map(({ file, reason }) => (\n          <p key={`${file.name}-${reason}`} className=\"text-destructive\">\n            {labels.rejection(file.name, reason, limitText(reason, maxSize, maxFiles, multiple))}\n          </p>\n        ))}\n        {announcement !== '' && <span className=\"sr-only\">{announcement}</span>}\n      </div>\n    </div>\n  );\n};\n"],"mappings":"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"}

package/dist/ui/src/components/edyn/file-input/file-input.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * FileInput: which files are taken, what they weigh in words, and the list on a mounted field.
+ *
+ * PATH TAKEN: the rules (accept, size, count, duplicates) and the labels are plain functions and run in happy-dom, and so does the list
+ * of chosen files with its remove buttons. The system's file dialog, a real drop and the focus ring are a browser's, covered by
+ * e2e/file-input.spec.ts.
+ */
+export {};

package/dist/ui/src/components/edyn/file-input/index.d.ts

@@ -0,0 +1 @@
+export * from './file-input';

package/dist/ui/src/components/edyn/initials-avatar/index.d.ts

@@ -0,0 +1 @@
+export * from './initials-avatar';

package/dist/ui/src/components/edyn/initials-avatar/initials-avatar.d.ts

@@ -0,0 +1,54 @@
+import { ComponentPropsWithoutRef } from 'react';
+/** How many colour pairs the theme defines (--avatar-1-bg, --avatar-1-fg ... in @edyn/theme tokens.css). */
+export declare const AVATAR_TONES = 12;
+/**
+ * The palette entry the text gets, from 1: the same text always gets the same one.
+ * FNV-1a, because a plain multiply-and-add hash puts two letters on a few entries
+ * only (it reduces to 7 x first + second, modulo 12).
+ */
+export declare const avatarTone: (text: string) => number;
+/** Up to two initials, upper-cased: the first letter of the first two words. */
+export declare const initialsOf: (name: string) => string;
+/**
+ * The circle and its letters together, so the initials always fit. The font size
+ * is inline rather than a class on purpose: 9px and 15px are not on Tailwind's
+ * type scale, a custom `text-*` token would be read by tailwind-merge as a colour
+ * and could drop the wrong class, and an inline size cannot be fought by the
+ * fallback's own `text-sm`.
+ */
+declare const SIZES: {
+    readonly xs: {
+        readonly box: "size-5";
+        readonly fontSize: 9;
+    };
+    readonly sm: {
+        readonly box: "size-6";
+        readonly fontSize: 10;
+    };
+    readonly md: {
+        readonly box: "size-8";
+        readonly fontSize: 12;
+    };
+    readonly lg: {
+        readonly box: "size-10";
+        readonly fontSize: 15;
+    };
+};
+export type TInitialsAvatarSize = keyof typeof SIZES;
+export interface IInitialsAvatarProps extends Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'className' | 'role'> {
+    name: string;
+    photoUrl?: string | null;
+    /** xs 20px, sm 24px in table rows, md 32px in a sidebar, lg 40px in a menu's header. */
+    size?: TInitialsAvatarSize;
+    className?: string;
+    /** Colour the initials from the palette (on by default); off, they take the muted look. */
+    autoColor?: boolean;
+    /**
+     * An accessible name. Left out, the avatar is decoration, which is right beside
+     * the person's name; give one when it stands alone.
+     */
+    label?: string;
+}
+/** A person's photo, or their initials on a circle in the palette colour they pick; both themes switch by themselves. */
+export declare const InitialsAvatar: ({ name, photoUrl, size, className, autoColor, label, "aria-label": ariaLabel, ...props }: IInitialsAvatarProps) => import('react').JSX.Element;
+export {};

package/dist/ui/src/components/edyn/initials-avatar/initials-avatar.js

@@ -0,0 +1,86 @@
+import { cn } from "../../../lib/utils.js";
+import { Avatar, AvatarFallback, AvatarImage } from "../../ui/avatar/avatar.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region ../ui/src/components/edyn/initials-avatar/initials-avatar.tsx
+/** How many colour pairs the theme defines (--avatar-1-bg, --avatar-1-fg ... in @edyn/theme tokens.css). */
+var AVATAR_TONES = 12;
+/**
+* The palette entry the text gets, from 1: the same text always gets the same one.
+* FNV-1a, because a plain multiply-and-add hash puts two letters on a few entries
+* only (it reduces to 7 x first + second, modulo 12).
+*/
+var avatarTone = (text) => {
+	let hash = 2166136261;
+	for (const character of text) {
+		hash ^= character.codePointAt(0) ?? 0;
+		hash = Math.imul(hash, 16777619);
+	}
+	hash ^= hash >>> 16;
+	hash = Math.imul(hash, 2246822507);
+	hash ^= hash >>> 13;
+	hash = Math.imul(hash, 3266489909);
+	hash ^= hash >>> 16;
+	return (hash >>> 0) % 12 + 1;
+};
+/** Up to two initials, upper-cased: the first letter of the first two words. */
+var initialsOf = (name) => name.split(/\s+/).filter((part) => part !== "").slice(0, 2).map((part) => Array.from(part)[0]?.toUpperCase() ?? "").join("");
+/**
+* The circle and its letters together, so the initials always fit. The font size
+* is inline rather than a class on purpose: 9px and 15px are not on Tailwind's
+* type scale, a custom `text-*` token would be read by tailwind-merge as a colour
+* and could drop the wrong class, and an inline size cannot be fought by the
+* fallback's own `text-sm`.
+*/
+var SIZES = {
+	xs: {
+		box: "size-5",
+		fontSize: 9
+	},
+	sm: {
+		box: "size-6",
+		fontSize: 10
+	},
+	md: {
+		box: "size-8",
+		fontSize: 12
+	},
+	lg: {
+		box: "size-10",
+		fontSize: 15
+	}
+};
+/** A person's photo, or their initials on a circle in the palette colour they pick; both themes switch by themselves. */
+var InitialsAvatar = ({ name, photoUrl, size = "md", className, autoColor = true, label, "aria-label": ariaLabel, ...props }) => {
+	const initials = initialsOf(name);
+	const tone = avatarTone(initials);
+	const { box, fontSize } = SIZES[size];
+	const style = autoColor ? {
+		fontSize,
+		backgroundColor: `var(--avatar-${tone}-bg)`,
+		color: `var(--avatar-${tone}-fg)`
+	} : { fontSize };
+	const accessibleName = label ?? ariaLabel;
+	const a11y = accessibleName === void 0 ? { "aria-hidden": true } : {
+		role: "img",
+		"aria-label": accessibleName
+	};
+	return /* @__PURE__ */ jsxs(Avatar, {
+		"data-slot": "initials-avatar",
+		...props,
+		"data-tone": autoColor ? tone : void 0,
+		className: cn(box, className),
+		...a11y,
+		children: [photoUrl != null && /* @__PURE__ */ jsx(AvatarImage, {
+			src: photoUrl,
+			alt: ""
+		}), /* @__PURE__ */ jsx(AvatarFallback, {
+			style,
+			className: "leading-none font-semibold tracking-tight",
+			children: initials
+		})]
+	});
+};
+//#endregion
+export { AVATAR_TONES, InitialsAvatar, avatarTone, initialsOf };
+
+//# sourceMappingURL=initials-avatar.js.map

package/dist/ui/src/components/edyn/initials-avatar/initials-avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials-avatar.js","names":[],"sources":["../../../../../../../ui/src/components/edyn/initials-avatar/initials-avatar.tsx"],"sourcesContent":["import { Avatar, AvatarFallback, AvatarImage } from '@edyn/ui/components/ui/avatar';\nimport { cn } from '@edyn/ui/lib/utils';\nimport type { ComponentPropsWithoutRef, CSSProperties } from 'react';\n\n/** How many colour pairs the theme defines (--avatar-1-bg, --avatar-1-fg ... in @edyn/theme tokens.css). */\nexport const AVATAR_TONES = 12;\n\n/**\n * The palette entry the text gets, from 1: the same text always gets the same one.\n * FNV-1a, because a plain multiply-and-add hash puts two letters on a few entries\n * only (it reduces to 7 x first + second, modulo 12).\n */\nexport const avatarTone = (text: string): number => {\n  let hash = 2166136261;\n  for (const character of text) {\n    hash ^= character.codePointAt(0) ?? 0;\n    hash = Math.imul(hash, 16777619);\n  }\n  // murmur3's finaliser mixes every bit into the low ones the modulo keeps; without\n  // it AB, CD, EF share an entry.\n  hash ^= hash >>> 16;\n  hash = Math.imul(hash, 0x85ebca6b);\n  hash ^= hash >>> 13;\n  hash = Math.imul(hash, 0xc2b2ae35);\n  hash ^= hash >>> 16;\n  return ((hash >>> 0) % AVATAR_TONES) + 1;\n};\n\n/** Up to two initials, upper-cased: the first letter of the first two words. */\nexport const initialsOf = (name: string): string =>\n  name\n    .split(/\\s+/)\n    .filter((part) => part !== '')\n    .slice(0, 2)\n    .map((part) => Array.from(part)[0]?.toUpperCase() ?? '')\n    .join('');\n\n/**\n * The circle and its letters together, so the initials always fit. The font size\n * is inline rather than a class on purpose: 9px and 15px are not on Tailwind's\n * type scale, a custom `text-*` token would be read by tailwind-merge as a colour\n * and could drop the wrong class, and an inline size cannot be fought by the\n * fallback's own `text-sm`.\n */\nconst SIZES = {\n  xs: { box: 'size-5', fontSize: 9 },\n  sm: { box: 'size-6', fontSize: 10 },\n  md: { box: 'size-8', fontSize: 12 },\n  lg: { box: 'size-10', fontSize: 15 },\n} as const;\n\nexport type TInitialsAvatarSize = keyof typeof SIZES;\n\nexport interface IInitialsAvatarProps extends Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'className' | 'role'> {\n  name: string;\n  photoUrl?: string | null;\n  /** xs 20px, sm 24px in table rows, md 32px in a sidebar, lg 40px in a menu's header. */\n  size?: TInitialsAvatarSize;\n  className?: string;\n  /** Colour the initials from the palette (on by default); off, they take the muted look. */\n  autoColor?: boolean;\n  /**\n   * An accessible name. Left out, the avatar is decoration, which is right beside\n   * the person's name; give one when it stands alone.\n   */\n  label?: string;\n}\n\n/** A person's photo, or their initials on a circle in the palette colour they pick; both themes switch by themselves. */\nexport const InitialsAvatar = ({\n  name,\n  photoUrl,\n  size = 'md',\n  className,\n  autoColor = true,\n  label,\n  'aria-label': ariaLabel,\n  ...props\n}: IInitialsAvatarProps) => {\n  const initials = initialsOf(name);\n  const tone = avatarTone(initials);\n  const { box, fontSize } = SIZES[size];\n  const style: CSSProperties = autoColor\n    ? { fontSize, backgroundColor: `var(--avatar-${tone}-bg)`, color: `var(--avatar-${tone}-fg)` }\n    : { fontSize };\n  const accessibleName = label ?? ariaLabel;\n  const a11y = accessibleName === undefined ? ({ 'aria-hidden': true } as const) : ({ role: 'img', 'aria-label': accessibleName } as const);\n  return (\n    <Avatar data-slot=\"initials-avatar\" {...props} data-tone={autoColor ? tone : undefined} className={cn(box, className)} {...a11y}>\n      {photoUrl != null && <AvatarImage src={photoUrl} alt=\"\" />}\n      <AvatarFallback style={style} className=\"leading-none font-semibold tracking-tight\">\n        {initials}\n      </AvatarFallback>\n    </Avatar>\n  );\n};\n"],"mappings":";;;;;AAKA,IAAa,eAAe;;;;;;AAO5B,IAAa,cAAc,SAAyB;CAClD,IAAI,OAAO;CACX,KAAK,MAAM,aAAa,MAAM;EAC5B,QAAQ,UAAU,YAAY,CAAC,KAAK;EACpC,OAAO,KAAK,KAAK,MAAM,QAAQ;CACjC;CAGA,QAAQ,SAAS;CACjB,OAAO,KAAK,KAAK,MAAM,UAAU;CACjC,QAAQ,SAAS;CACjB,OAAO,KAAK,KAAK,MAAM,UAAU;CACjC,QAAQ,SAAS;CACjB,QAAS,SAAS,KAAA,KAAqB;AACzC;;AAGA,IAAa,cAAc,SACzB,KACG,MAAM,KAAK,CAAC,CACZ,QAAQ,SAAS,SAAS,EAAE,CAAC,CAC7B,MAAM,GAAG,CAAC,CAAC,CACX,KAAK,SAAS,MAAM,KAAK,IAAI,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,EAAE,CAAC,CACvD,KAAK,EAAE;;;;;;;;AASZ,IAAM,QAAQ;CACZ,IAAI;EAAE,KAAK;EAAU,UAAU;CAAE;CACjC,IAAI;EAAE,KAAK;EAAU,UAAU;CAAG;CAClC,IAAI;EAAE,KAAK;EAAU,UAAU;CAAG;CAClC,IAAI;EAAE,KAAK;EAAW,UAAU;CAAG;AACrC;;AAoBA,IAAa,kBAAkB,EAC7B,MACA,UACA,OAAO,MACP,WACA,YAAY,MACZ,OACA,cAAc,WACd,GAAG,YACuB;CAC1B,MAAM,WAAW,WAAW,IAAI;CAChC,MAAM,OAAO,WAAW,QAAQ;CAChC,MAAM,EAAE,KAAK,aAAa,MAAM;CAChC,MAAM,QAAuB,YACzB;EAAE;EAAU,iBAAiB,gBAAgB,KAAK;EAAO,OAAO,gBAAgB,KAAK;CAAM,IAC3F,EAAE,SAAS;CACf,MAAM,iBAAiB,SAAS;CAChC,MAAM,OAAO,mBAAmB,KAAA,IAAa,EAAE,eAAe,KAAK,IAAe;EAAE,MAAM;EAAO,cAAc;CAAe;CAC9H,OACE,qBAAC,QAAD;EAAQ,aAAU;EAAkB,GAAI;EAAO,aAAW,YAAY,OAAO,KAAA;EAAW,WAAW,GAAG,KAAK,SAAS;EAAG,GAAI;EAA3H,UAAA,CACG,YAAY,QAAQ,oBAAC,aAAD;GAAa,KAAK;GAAU,KAAI;EAAI,CAAA,GACzD,oBAAC,gBAAD;GAAuB;GAAO,WAAU;GACrC,UAAA;EACa,CAAA,CACV;;AAEZ"}

package/dist/ui/src/components/edyn/initials-avatar/initials-avatar.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * InitialsAvatar: a stable colour per person, initials that fit, and a palette
+ * that stays readable.
+ *
+ * PATH TAKEN: the hash, the initials and the markup are plain logic, so happy-dom
+ * covers them. The palette claim ("every pair is readable") is checked against
+ * the real tokens.css, converting OKLCH to sRGB and measuring WCAG contrast, so
+ * the numbers cannot drift from the file.
+ */
+export {};

package/dist/ui/src/components/edyn/multi-select/index.d.ts

@@ -0,0 +1 @@
+export * from './multi-select';