@syware/jlib 0.5.1 → 0.7.0

package/dist/lib/app-icon.js

@@ -0,0 +1,37 @@
+import { ICON_STROKE_WIDTH } from "./icons.js";
+// src/lib/app-icon.ts
+/** The glyph's share of the tile's side, at every size. */
+var GLYPH_SHARE = .62;
+/** The corner's share of the tile's side. */
+var CORNER_SHARE = .26;
+var FILE_SIDE = 64;
+var GLYPH_GRID = 24;
+var DECIMALS = 2;
+var ATTRIBUTE_ESCAPES = {
+	"\"": """,
+	"&": "&",
+	"<": "&lt;"
+};
+var NEEDS_ESCAPE = /["&<]/g;
+var round = (value) => Number(value.toFixed(DECIMALS));
+var escapeAttribute = (value) => String(value).replace(NEEDS_ESCAPE, (character) => ATTRIBUTE_ESCAPES[character] ?? character);
+var attributesOf = (attributes) => Object.entries(attributes).flatMap(([name, value]) => value === void 0 ? [] : [` ${name}="${escapeAttribute(value)}"`]).join("");
+/** An app's icon as the text of an SVG file: its glyph in `colors.glyph` on a rounded square of `colors.tile`. */
+function appIconSvg(glyph, colors) {
+	const glyphSide = FILE_SIDE * GLYPH_SHARE;
+	const offset = round(24.32 / 2);
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${FILE_SIDE} ${FILE_SIDE}"><rect${attributesOf({
+		fill: colors.tile,
+		height: FILE_SIDE,
+		rx: round(FILE_SIDE * CORNER_SHARE),
+		width: FILE_SIDE
+	})}/><g${attributesOf({
+		fill: "none",
+		stroke: colors.glyph,
+		"stroke-linecap": "round",
+		"stroke-linejoin": "round",
+		"stroke-width": ICON_STROKE_WIDTH,
+		transform: `translate(${offset} ${offset}) scale(${round(glyphSide / GLYPH_GRID)})`
+	})}>${glyph.map(([tag, attributes]) => `<${tag}${attributesOf(attributes)}/>`).join("")}</g></svg>`;
+}
+export { CORNER_SHARE, GLYPH_SHARE, appIconSvg };

package/dist/lib/dom.d.ts

@@ -4,3 +4,5 @@ export declare function setOrRemove(element: Element, name: string, value: strin
 export declare function uniqueId(prefix: string): string;
 /** An SVG element with its attributes: JSX makes HTML elements only. */
 export declare function svgElement<Tag extends keyof SVGElementTagNameMap>(tag: Tag, attributes: Record<string, string>): SVGElementTagNameMap[Tag];
+/** Whether a click asks the browser for something of its own: a new tab or window, a download. */
+export declare const isModifiedClick: (event: MouseEvent) => boolean;

package/dist/lib/dom.js

@@ -20,4 +20,6 @@ function svgElement(tag, attributes) {
 	for (const [name, value] of Object.entries(attributes)) element.setAttribute(name, value);
 	return element;
 }
-export { setOrRemove, svgElement, uniqueId };
+/** Whether a click asks the browser for something of its own: a new tab or window, a download. */
+var isModifiedClick = (event) => event.ctrlKey || event.metaKey || event.shiftKey || event.altKey || event.button !== 0;
+export { isModifiedClick, setOrRemove, svgElement, uniqueId };

package/dist/lib/download.d.ts

@@ -0,0 +1,10 @@
+/** The file name a Content-Disposition header gives (its UTF-8 form first), or none. */
+export declare function dispositionFileName(header: string | null): string | undefined;
+/** A file name for an address: its last path segment, or the fallback when it has none. */
+export declare function urlFileName(url: string, fallback: string): string;
+/** What a failed answer's body says: `{ error: { message } }`, `{ error: "…" }`, `{ message }`, or its status. */
+export declare function answerError(body: unknown, status: number): string;
+/** Reads an answer to its end, saying how many bytes came at most once per interval, and once more at the end. */
+export declare function readWithProgress(response: Response, onProgress: (received: number) => void, intervalMs: number, now?: () => number): Promise<Blob>;
+/** Hands a file to the browser, which saves it under that name. */
+export declare function saveBlob(blob: Blob, name: string): void;

package/dist/lib/download.js

@@ -0,0 +1,62 @@
+// src/lib/download.ts
+var FILE_NAME_UTF8 = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/;
+var FILE_NAME = /filename\s*=\s*"?([^";]+)"?/;
+var REVOKE_DELAY_MS = 1e3;
+var ADDRESS_BASE = "http://localhost/";
+/** The file name a Content-Disposition header gives (its UTF-8 form first), or none. */
+function dispositionFileName(header) {
+	const utf8 = FILE_NAME_UTF8.exec(header ?? "")?.[1];
+	if (utf8 !== void 0) return decodeURIComponent(utf8.trim());
+	return FILE_NAME.exec(header ?? "")?.[1]?.trim() || void 0;
+}
+/** A file name for an address: its last path segment, or the fallback when it has none. */
+function urlFileName(url, fallback) {
+	const segment = new URL(url, ADDRESS_BASE).pathname.split("/").at(-1) ?? "";
+	return segment === "" ? fallback : decodeURIComponent(segment);
+}
+/** What a failed answer's body says: `{ error: { message } }`, `{ error: "…" }`, `{ message }`, or its status. */
+function answerError(body, status) {
+	const record = typeof body === "object" && body !== null ? body : {};
+	const error = record.error;
+	return [
+		typeof error === "object" && error !== null ? error.message : void 0,
+		error,
+		record.message
+	].find((value) => typeof value === "string") ?? `HTTP ${status}`;
+}
+/** Reads an answer to its end, saying how many bytes came at most once per interval, and once more at the end. */
+async function readWithProgress(response, onProgress, intervalMs, now = () => performance.now()) {
+	const type = response.headers.get("content-type") ?? "";
+	if (response.body === null) return response.blob();
+	const reader = response.body.getReader();
+	const chunks = [];
+	const progress = {
+		received: 0,
+		reported: Number.NEGATIVE_INFINITY,
+		said: 0
+	};
+	for (;;) {
+		const chunk = await reader.read();
+		if (chunk.done) break;
+		chunks.push(chunk.value);
+		progress.received += chunk.value.byteLength;
+		if (now() - progress.reported >= intervalMs) {
+			progress.reported = now();
+			progress.said = progress.received;
+			onProgress(progress.received);
+		}
+	}
+	if (progress.said !== progress.received) onProgress(progress.received);
+	return new Blob(chunks, { type });
+}
+/** Hands a file to the browser, which saves it under that name. */
+function saveBlob(blob, name) {
+	const link = document.createElement("a");
+	link.download = name;
+	link.href = URL.createObjectURL(blob);
+	document.body.append(link);
+	link.click();
+	link.remove();
+	setTimeout(() => URL.revokeObjectURL(link.href), REVOKE_DELAY_MS);
+}
+export { answerError, dispositionFileName, readWithProgress, saveBlob, urlFileName };

package/dist/lib/icons.d.ts

@@ -1,4 +1,6 @@
 import type { IconNode } from 'lucide';
+/** The width of every glyph's strokes, on lucide's 24-unit grid. */
+export declare const ICON_STROKE_WIDTH = 1.9;
 /**
  * Adds icons to the ones `jl-icon` knows, by name. Any lucide icon works:
  * `registerIcons({ rocket: Rocket })` after `import { Rocket } from 'lucide'`, or all the usual ones at once with
@@ -8,5 +10,7 @@ export declare function registerIcons(icons: Record<string, IconNode>): void;
 /** The names `jl-icon` can draw now, in alphabetical order. */
 export declare const iconNames: () => string[];
 export declare const hasIcon: (name: string) => boolean;
+/** An icon's shapes, by its name; a name nobody registered gives a neutral mark instead of nothing. */
+export declare const iconNode: (name: string) => IconNode;
 /** An icon as an SVG element; a name nobody registered draws a neutral mark instead of nothing. */
 export declare function iconElement(name: string, size: number): SVGElement;

package/dist/lib/icons.js

@@ -1,7 +1,8 @@
 import { CircleAlert, createElement } from "lucide";
 // src/lib/icons.ts
 var FALLBACK = CircleAlert;
-var STROKE_WIDTH = 1.9;
+/** The width of every glyph's strokes, on lucide's 24-unit grid. */
+var ICON_STROKE_WIDTH = 1.9;
 /**
 * The icons `jl-icon` can draw, by name. It starts empty: each component registers the icons it draws itself, and
 * a page registers the names it writes, so a bundle holds only the icons in use.
@@ -27,13 +28,15 @@ function missing(name) {
 	}
 	return FALLBACK;
 }
+/** An icon's shapes, by its name; a name nobody registered gives a neutral mark instead of nothing. */
+var iconNode = (name) => registry.get(name) ?? missing(name);
 /** An icon as an SVG element; a name nobody registered draws a neutral mark instead of nothing. */
 function iconElement(name, size) {
-	return createElement(registry.get(name) ?? missing(name), {
+	return createElement(iconNode(name), {
 		"aria-hidden": "true",
 		height: size,
-		"stroke-width": STROKE_WIDTH,
+		"stroke-width": ICON_STROKE_WIDTH,
 		width: size
 	});
 }
-export { hasIcon, iconElement, iconNames, registerIcons };
+export { ICON_STROKE_WIDTH, hasIcon, iconElement, iconNames, iconNode, registerIcons };

package/dist/lib/input-list.d.ts

@@ -0,0 +1,12 @@
+/** The rows shown: the values, or one empty row to type the first one in. */
+export declare const rowsOf: (values: readonly string[]) => string[];
+/** The rows with the one at `index` changed. */
+export declare const withRowAt: (rows: readonly string[], index: number, value: string) => string[];
+/** The rows without the one at `index`; one empty row stays when it was the last. */
+export declare const withoutRowAt: (rows: readonly string[], index: number) => string[];
+/** The values kept: the rows people filled in. */
+export declare const filledValues: (rows: readonly string[]) => string[];
+/** Whether another row fits under `max`; none or zero means no limit. */
+export declare const canAddRow: (count: number, max: number) => boolean;
+/** Whether two lists hold the same values in the same order. */
+export declare const sameValues: (left: readonly string[], right: readonly string[]) => boolean;

package/dist/lib/input-list.js

@@ -0,0 +1,14 @@
+// src/lib/input-list.ts
+/** The rows shown: the values, or one empty row to type the first one in. */
+var rowsOf = (values) => values.length === 0 ? [""] : [...values];
+/** The rows with the one at `index` changed. */
+var withRowAt = (rows, index, value) => rows.map((row, at) => at === index ? value : row);
+/** The rows without the one at `index`; one empty row stays when it was the last. */
+var withoutRowAt = (rows, index) => rowsOf(rows.filter((_, at) => at !== index));
+/** The values kept: the rows people filled in. */
+var filledValues = (rows) => rows.filter((row) => row.trim() !== "");
+/** Whether another row fits under `max`; none or zero means no limit. */
+var canAddRow = (count, max) => max <= 0 || count < max;
+/** Whether two lists hold the same values in the same order. */
+var sameValues = (left, right) => left.length === right.length && left.every((value, index) => value === right[index]);
+export { canAddRow, filledValues, rowsOf, sameValues, withRowAt, withoutRowAt };

package/dist/lib/internals.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The internals of a form-associated element. Where the DOM gives them no form methods (jsdom), they get ones that
+ * keep nothing and find every value valid; a browser's are left as they are.
+ */
+export declare function formInternals(element: HTMLElement): ElementInternals;

package/dist/lib/internals.js

@@ -0,0 +1,18 @@
+// src/lib/internals.ts
+/** What a form control asks of its internals that jsdom's lack: with them, a page's unit tests can create it. */
+var FORM_METHODS = {
+	checkValidity: () => true,
+	reportValidity: () => true,
+	setFormValue: () => void 0,
+	setValidity: () => void 0
+};
+/**
+* The internals of a form-associated element. Where the DOM gives them no form methods (jsdom), they get ones that
+* keep nothing and find every value valid; a browser's are left as they are.
+*/
+function formInternals(element) {
+	const internals = element.attachInternals();
+	if (typeof internals.setFormValue === "function") return internals;
+	return Object.assign(internals, FORM_METHODS);
+}
+export { formInternals };

package/dist/lib/palette.js

@@ -3,12 +3,18 @@ import { fuzzyMatch } from "./fuzzy.js";
 /** A match on a keyword counts less than one on the label people read. */
 var KEYWORD_WEIGHT = .5;
 var NO_GROUP = "";
+var RESULT_SCORE = 0;
 function keywordScore(query, keywords) {
 	const scores = keywords.map((keyword) => fuzzyMatch(query, keyword)?.score).filter((score) => score !== void 0);
 	return scores.length === 0 ? null : Math.max(...scores) * KEYWORD_WEIGHT;
 }
 function matchCommand(query, command) {
 	const label = fuzzyMatch(query, command.label);
+	if (command.result === true) return {
+		command,
+		positions: label?.positions ?? [],
+		score: RESULT_SCORE
+	};
 	const keyword = keywordScore(query, command.keywords ?? []);
 	if (label === null && keyword === null) return null;
 	if (label === null) return {

package/dist/lib/resize.d.ts

@@ -0,0 +1,2 @@
+/** Watches elements' sizes; where the DOM has no ResizeObserver, nothing changes size and nothing is watched. */
+export declare const watchSizes: (callback: ResizeObserverCallback) => ResizeObserver;

package/dist/lib/resize.js

@@ -0,0 +1,10 @@
+// src/lib/resize.ts
+/** A stand-in that watches nothing, for a DOM without ResizeObserver (jsdom, which has no layout either). */
+var INERT_OBSERVER = {
+	disconnect: () => void 0,
+	observe: () => void 0,
+	unobserve: () => void 0
+};
+/** Watches elements' sizes; where the DOM has no ResizeObserver, nothing changes size and nothing is watched. */
+var watchSizes = (callback) => typeof ResizeObserver === "function" ? new ResizeObserver(callback) : INERT_OBSERVER;
+export { watchSizes };

package/dist/lib/table.d.ts

@@ -1,4 +1,4 @@
-import type { TableAlign, TableCellFormat, TableColumn, TableRow, TableRowKey, TableSelectionState, TableSortDirection } from '../types/jl-table.types';
+import type { TableAlign, TableCellFormat, TableCellRenderer, TableColumn, TableRow, TableRowKey, TableSelectionState, TableSortDirection } from '../types/jl-table.types';
 export declare const nextSortDirection: (direction: TableSortDirection) => TableSortDirection;
 /** A cell's value as a number, `NaN` when it is not one. */
 export declare function toNumber(value: unknown): number;
@@ -28,3 +28,8 @@ export declare function selectionState(keys: readonly TableRowKey[], selected: R
 export declare function toggleAll(keys: readonly TableRowKey[], selected: ReadonlySet<TableRowKey>): TableRowKey[];
 /** The selection with one row added or taken out. */
 export declare function toggleKey(selected: readonly TableRowKey[], key: TableRowKey, on: boolean): TableRowKey[];
+/**
+ * A renderer of `renderers` written for the page's own type of row: the table hands each renderer back a row the
+ * page gave it, so `cellOf<Order>((order) => <JlLink href={order.href} label={order.name} />)` reads it typed.
+ */
+export declare const cellOf: <Row>(draw: (row: Row) => Node) => TableCellRenderer;

package/dist/lib/table.js

@@ -11,6 +11,10 @@ var DIRECTION_SIGN = {
 	none: 0
 };
 var DATE_FORMAT = { dateStyle: "medium" };
+var DATE_TIME_FORMAT = {
+	dateStyle: "medium",
+	timeStyle: "short"
+};
 var nextSortDirection = (direction) => NEXT_DIRECTION[direction];
 var isEmpty = (value) => value === null || value === void 0 || value === "";
 /** A cell's value as a number, `NaN` when it is not one. */
@@ -31,6 +35,7 @@ var COMPARERS = {
 	badge: (a, b, locale) => String(a).localeCompare(String(b), locale),
 	code: (a, b, locale) => String(a).localeCompare(String(b), locale),
 	date: (a, b) => compareNumbers(toTime(a), toTime(b)),
+	datetime: (a, b) => compareNumbers(toTime(a), toTime(b)),
 	number: (a, b) => compareNumbers(toNumber(a), toNumber(b)),
 	text: (a, b, locale) => String(a).localeCompare(String(b), locale, { numeric: true })
 };
@@ -41,6 +46,7 @@ function isUnorderable(value, format) {
 		badge: () => false,
 		code: () => false,
 		date: () => Number.isNaN(toTime(value)),
+		datetime: () => Number.isNaN(toTime(value)),
 		number: () => Number.isNaN(toNumber(value)),
 		text: () => false
 	}[format]();
@@ -66,6 +72,10 @@ var FORMATTERS = {
 		const time = toTime(value);
 		return Number.isNaN(time) ? String(value) : new Intl.DateTimeFormat(locale, DATE_FORMAT).format(time);
 	},
+	datetime: (value, locale) => {
+		const time = toTime(value);
+		return Number.isNaN(time) ? String(value) : new Intl.DateTimeFormat(locale, DATE_TIME_FORMAT).format(time);
+	},
 	number: (value, locale) => {
 		const number = toNumber(value);
 		return Number.isNaN(number) ? String(value) : new Intl.NumberFormat(locale).format(number);
@@ -107,4 +117,9 @@ function toggleKey(selected, key, on) {
 	const without = selected.filter((candidate) => candidate !== key);
 	return on ? [...without, key] : without;
 }
-export { columnAlign, columnWidth, formatCell, nextSortDirection, rowKeyOf, selectionState, sortRows, toNumber, toTime, toggleAll, toggleKey };
+/**
+* A renderer of `renderers` written for the page's own type of row: the table hands each renderer back a row the
+* page gave it, so `cellOf<Order>((order) => <JlLink href={order.href} label={order.name} />)` reads it typed.
+*/
+var cellOf = (draw) => (row) => draw(row);
+export { cellOf, columnAlign, columnWidth, formatCell, nextSortDirection, rowKeyOf, selectionState, sortRows, toNumber, toTime, toggleAll, toggleKey };

package/dist/lib/text.d.ts

@@ -3,3 +3,15 @@
  * an HTML element reads as it was meant.
  */
 export declare function dedent(text: string): string;
+/** A run of a headline: plain, or `accent` for the words written between asterisks. */
+export type StarredPart = {
+    text: string;
+    accent: boolean;
+};
+/**
+ * A headline's runs: the words between asterisks are the accented ones, "Workflows that *ask* before they act."
+ * A lone asterisk stays as it is; empty runs are left out.
+ */
+export declare function starredParts(text: string): StarredPart[];
+/** A text with its `{placeholders}` filled; one without a value stays as it is. */
+export declare const fillText: (template: string, values: Readonly<Record<string, string>>) => string;

package/dist/lib/text.js

@@ -10,4 +10,19 @@ function dedent(text) {
 	const shared = indents.length === 0 ? 0 : Math.min(...indents);
 	return lines.map((line) => line.slice(shared)).join("\n");
 }
-export { dedent };
+var STAR = "*";
+/**
+* A headline's runs: the words between asterisks are the accented ones, "Workflows that *ask* before they act."
+* A lone asterisk stays as it is; empty runs are left out.
+*/
+function starredParts(text) {
+	const pieces = text.split(STAR);
+	return (pieces.length % 2 === 1 ? pieces : [...pieces.slice(0, -2), `${pieces.at(-2)}${STAR}${pieces.at(-1)}`]).map((piece, index) => ({
+		accent: index % 2 === 1,
+		text: piece
+	})).filter((part) => part.text !== "");
+}
+var PLACEHOLDER = /\{(\w+)\}/g;
+/** A text with its `{placeholders}` filled; one without a value stays as it is. */
+var fillText = (template, values) => template.replace(PLACEHOLDER, (whole, key) => values[key] ?? whole);
+export { dedent, fillText, starredParts };

package/dist/lib/texts.d.ts

@@ -0,0 +1,97 @@
+import type { JlTextKey, JlTexts } from '../types/texts.types';
+/**
+ * Every text jlib's components show or say on their own, in English: labels for screen readers, buttons, states,
+ * the defaults of their text inputs. `{placeholders}` are filled when the text is shown.
+ */
+export declare const DEFAULT_TEXTS: {
+    readonly addTag: 'Add at least one tag.';
+    readonly addValue: 'Add a value';
+    readonly back: 'Back';
+    readonly breadcrumb: 'Breadcrumb';
+    readonly browse: 'Browse';
+    readonly chooseDate: 'Choose a date';
+    readonly chooseDateMissing: 'Choose a date.';
+    readonly chooseFile: 'Choose a file.';
+    readonly chooseOption: 'Choose an option.';
+    readonly chooseRating: 'Choose a rating.';
+    readonly chosenFiles: 'Chosen files';
+    readonly clear: 'Clear';
+    readonly clearSearch: 'Clear the search';
+    readonly close: 'Close';
+    readonly closeMenu: 'Close the menu';
+    readonly collapseMenu: 'Collapse the menu';
+    readonly commandPalette: 'Command palette';
+    readonly commandPlaceholder: 'Type a command or search…';
+    readonly commands: 'Commands';
+    readonly copied: 'Copied';
+    readonly copy: 'Copy';
+    readonly decrease: 'Decrease';
+    readonly dismiss: 'Dismiss';
+    readonly downloadCancel: 'Cancel';
+    readonly downloadFailed: 'Not downloaded: {error}';
+    readonly downloadPreparing: 'Preparing the file… {time}';
+    readonly downloadReceived: '{received} received';
+    readonly downloadReceivedOf: '{received} of {total}';
+    readonly downloadSaved: 'Saved as {name}, {size}';
+    readonly dragToConnect: 'Drag to another node to connect';
+    readonly dropFile: 'Drop a file here';
+    readonly dropFiles: 'Drop files here';
+    readonly expandMenu: 'Expand the menu';
+    readonly failedStep: ', failed';
+    readonly fileTooLarge: 'is larger than {size}';
+    readonly fileTooMany: 'is one too many: the field takes a single file';
+    readonly fileUpTo: 'up to {size}';
+    readonly fileWrongType: 'is not an accepted type ({types})';
+    readonly fillField: 'Please fill in this field.';
+    readonly fitView: 'Show every node';
+    readonly flow: 'Flow';
+    readonly hidePassword: 'Hide the password';
+    readonly increase: 'Increase';
+    readonly leave: 'Leave';
+    readonly leaveText: 'Your changes are lost.';
+    readonly loadError: 'This could not be loaded.';
+    readonly loading: 'Loading';
+    readonly loadingMore: 'Loading…';
+    readonly loadStateError: 'Check the connection, then try again. Nothing was changed.';
+    readonly mainNavigation: 'Main';
+    readonly menu: 'Menu';
+    readonly navigation: 'Navigation';
+    readonly nextMonth: 'Next month';
+    readonly nextPage: 'Next page';
+    readonly noCommands: 'No matching commands';
+    readonly noData: 'No data';
+    readonly noResults: 'No results';
+    readonly notifications: 'Notifications';
+    readonly pagination: 'Pagination';
+    readonly previousMonth: 'Previous month';
+    readonly previousPage: 'Previous page';
+    readonly progress: 'Progress';
+    readonly rating: 'Rating';
+    readonly remove: 'Remove';
+    readonly removeEdge: 'Remove this edge';
+    readonly removeNamed: 'Remove {name}';
+    readonly removeValue: 'Remove this value';
+    readonly resizePanes: 'Resize the panes';
+    readonly retry: 'Try again';
+    readonly search: 'Search';
+    readonly selectOption: 'Please select one of these options.';
+    readonly shortcuts: 'Shortcuts';
+    readonly showMore: 'Show more';
+    readonly showMoreCount: 'Show {count} more';
+    readonly shownOfTotal: '{shown} of {total}';
+    readonly showOptions: 'Show the options';
+    readonly showPassword: 'Show the password';
+    readonly stay: 'Keep editing';
+    readonly stepCurrent: ', current step';
+    readonly stepDone: ', completed';
+    readonly tidyLayout: 'Tidy up the layout';
+    readonly zoomIn: 'Zoom in';
+    readonly zoomOut: 'Zoom out';
+};
+/**
+ * Gives jlib's components their texts in the page's language, before they are drawn: once at start, as a page
+ * reads its own messages. A text left out stays English.
+ */
+export declare function setTexts(texts: JlTexts): void;
+/** One of jlib's texts, in the language the page set, its `{placeholders}` filled. */
+export declare const jlText: (key: JlTextKey, values?: Readonly<Record<string, string>>) => string;

package/dist/lib/texts.js

@@ -0,0 +1,102 @@
+import { fillText } from "./text.js";
+// src/lib/texts.ts
+/**
+* Every text jlib's components show or say on their own, in English: labels for screen readers, buttons, states,
+* the defaults of their text inputs. `{placeholders}` are filled when the text is shown.
+*/
+var DEFAULT_TEXTS = {
+	addTag: "Add at least one tag.",
+	addValue: "Add a value",
+	back: "Back",
+	breadcrumb: "Breadcrumb",
+	browse: "Browse",
+	chooseDate: "Choose a date",
+	chooseDateMissing: "Choose a date.",
+	chooseFile: "Choose a file.",
+	chooseOption: "Choose an option.",
+	chooseRating: "Choose a rating.",
+	chosenFiles: "Chosen files",
+	clear: "Clear",
+	clearSearch: "Clear the search",
+	close: "Close",
+	closeMenu: "Close the menu",
+	collapseMenu: "Collapse the menu",
+	commandPalette: "Command palette",
+	commandPlaceholder: "Type a command or search…",
+	commands: "Commands",
+	copied: "Copied",
+	copy: "Copy",
+	decrease: "Decrease",
+	dismiss: "Dismiss",
+	downloadCancel: "Cancel",
+	downloadFailed: "Not downloaded: {error}",
+	downloadPreparing: "Preparing the file… {time}",
+	downloadReceived: "{received} received",
+	downloadReceivedOf: "{received} of {total}",
+	downloadSaved: "Saved as {name}, {size}",
+	dragToConnect: "Drag to another node to connect",
+	dropFile: "Drop a file here",
+	dropFiles: "Drop files here",
+	expandMenu: "Expand the menu",
+	failedStep: ", failed",
+	fileTooLarge: "is larger than {size}",
+	fileTooMany: "is one too many: the field takes a single file",
+	fileUpTo: "up to {size}",
+	fileWrongType: "is not an accepted type ({types})",
+	fillField: "Please fill in this field.",
+	fitView: "Show every node",
+	flow: "Flow",
+	hidePassword: "Hide the password",
+	increase: "Increase",
+	leave: "Leave",
+	leaveText: "Your changes are lost.",
+	loadError: "This could not be loaded.",
+	loading: "Loading",
+	loadingMore: "Loading…",
+	loadStateError: "Check the connection, then try again. Nothing was changed.",
+	mainNavigation: "Main",
+	menu: "Menu",
+	navigation: "Navigation",
+	nextMonth: "Next month",
+	nextPage: "Next page",
+	noCommands: "No matching commands",
+	noData: "No data",
+	noResults: "No results",
+	notifications: "Notifications",
+	pagination: "Pagination",
+	previousMonth: "Previous month",
+	previousPage: "Previous page",
+	progress: "Progress",
+	rating: "Rating",
+	remove: "Remove",
+	removeEdge: "Remove this edge",
+	removeNamed: "Remove {name}",
+	removeValue: "Remove this value",
+	resizePanes: "Resize the panes",
+	retry: "Try again",
+	search: "Search",
+	selectOption: "Please select one of these options.",
+	shortcuts: "Shortcuts",
+	showMore: "Show more",
+	showMoreCount: "Show {count} more",
+	shownOfTotal: "{shown} of {total}",
+	showOptions: "Show the options",
+	showPassword: "Show the password",
+	stay: "Keep editing",
+	stepCurrent: ", current step",
+	stepDone: ", completed",
+	tidyLayout: "Tidy up the layout",
+	zoomIn: "Zoom in",
+	zoomOut: "Zoom out"
+};
+var current = { ...DEFAULT_TEXTS };
+/**
+* Gives jlib's components their texts in the page's language, before they are drawn: once at start, as a page
+* reads its own messages. A text left out stays English.
+*/
+function setTexts(texts) {
+	Object.assign(current, texts);
+}
+/** One of jlib's texts, in the language the page set, its `{placeholders}` filled. */
+var jlText = (key, values = {}) => fillText(current[key], values);
+export { DEFAULT_TEXTS, jlText, setTexts };

package/dist/lib/time.d.ts

@@ -1,10 +1,12 @@
 /**
  * A duration in the units that read best: "< 1 sec" under a second (never "0.0 s"), then seconds, minutes, hours
- * and minutes, days and hours.
+ * and minutes, days and hours. The unit is chosen once rounded: 59.6 seconds is "1 min", not "60 secs". Not a
+ * number gives "".
  */
 export declare function formatDuration(milliseconds: number, locale?: string): string;
 /**
- * When something happened, from `now`: "now", "5 minutes ago", "3 hours ago", "yesterday" within a week, then the
- * date ("12 Mar", with the year when it is not this year's). Times to come read the same way: "in 5 minutes".
+ * When something happened, from `now`: "now", "5 minutes ago", "3 hours ago" the same day, "yesterday" or "3 days
+ * ago" by the calendar within a week, then the date ("12 Mar", with the year when it is not this year's). Times to
+ * come read the same way: "in 5 minutes". A date that is not one gives "".
  */
 export declare function formatRelativeTime(date: Date | number | string, now: Date | number, locale?: string): string;