@syware/jlib 0.0.0-stage → 0.1.3

package/dist/index.js

@@ -0,0 +1,72 @@
+import { TOKEN_STYLES } from "./styles/shared.js";
+import { adoptTokens } from "./lib/tokens.js";
+import { JlElement } from "./base/jl-element.js";
+import { JlFormControl } from "./base/jl-form-control.js";
+import { clampedNumber, jsonOf, oneOf } from "./lib/attributes.js";
+import { define } from "./lib/define.js";
+import { PLACEMENTS, computePosition, followAnchor, placeFloating } from "./lib/floating.js";
+import { COMMON_ICONS } from "./lib/icon-set.js";
+import { hasIcon, iconElement, iconNames, registerIcons } from "./lib/icons.js";
+import { CONTROL_SIZES, TONES, TONE_ICONS } from "./lib/options.js";
+import { JlIcon } from "./atoms/jl-icon.js";
+import { AVATAR_SHAPES, AVATAR_SIZES, AVATAR_STATUSES, JlAvatar } from "./atoms/jl-avatar.js";
+import { JlBadge } from "./atoms/jl-badge.js";
+import { JlSpinner } from "./atoms/jl-spinner.js";
+import { BUTTON_TYPES, BUTTON_VARIANTS, JlButton } from "./atoms/jl-button.js";
+import { JlCheckbox } from "./atoms/jl-checkbox.js";
+import { CHIP_SIZES, JlChip } from "./atoms/jl-chip.js";
+import { DIVIDER_ALIGNS, JlDivider } from "./atoms/jl-divider.js";
+import { INPUT_TYPES, JlInput } from "./atoms/jl-input.js";
+import { JlKbd } from "./atoms/jl-kbd.js";
+import { JlLink, LINK_VARIANTS } from "./atoms/jl-link.js";
+import { JlProgress, PROGRESS_SIZES, PROGRESS_TONES } from "./atoms/jl-progress.js";
+import { JlProgressRing } from "./atoms/jl-progress-ring.js";
+import { JlRating } from "./atoms/jl-rating.js";
+import { JlSelect } from "./atoms/jl-select.js";
+import { JlSkeleton, SKELETON_SHAPES } from "./atoms/jl-skeleton.js";
+import { JlSlider } from "./atoms/jl-slider.js";
+import { JlSwitch, SWITCH_SIZES } from "./atoms/jl-switch.js";
+import { JlTextarea } from "./atoms/jl-textarea.js";
+import { JlAccordionItem } from "./molecules/jl-accordion-item.js";
+import { ACCORDION_VARIANTS, JlAccordion } from "./molecules/jl-accordion.js";
+import { JlAlert } from "./molecules/jl-alert.js";
+import { JlAvatarGroup } from "./molecules/jl-avatar-group.js";
+import { JlBreadcrumb } from "./molecules/jl-breadcrumb.js";
+import { JlCalendar } from "./molecules/jl-calendar.js";
+import { CARD_PADDINGS, JlCard } from "./molecules/jl-card.js";
+import { JlCopyButton } from "./molecules/jl-copy-button.js";
+import { CODE_LANGUAGES, JlCodeBlock } from "./molecules/jl-code-block.js";
+import { JlCombobox } from "./molecules/jl-combobox.js";
+import { JlDatePicker } from "./molecules/jl-date-picker.js";
+import { EMPTY_SIZES, JlEmpty } from "./molecules/jl-empty.js";
+import { FIELD_ORIENTATIONS, JlField } from "./molecules/jl-field.js";
+import { JlFileDrop } from "./molecules/jl-file-drop.js";
+import { JlListItem } from "./molecules/jl-list-item.js";
+import { JlMenu } from "./molecules/jl-menu.js";
+import { JlNumberInput } from "./molecules/jl-number-input.js";
+import { JlPagination } from "./molecules/jl-pagination.js";
+import { JlPopover } from "./molecules/jl-popover.js";
+import { JlRadioGroup, RADIO_GROUP_ORIENTATIONS, RADIO_GROUP_VARIANTS } from "./molecules/jl-radio-group.js";
+import { JlSearch } from "./molecules/jl-search.js";
+import { JlSegmented } from "./molecules/jl-segmented.js";
+import { JlStat, STAT_TRENDS } from "./molecules/jl-stat.js";
+import { JlSteps, STEPS_ORIENTATIONS } from "./molecules/jl-steps.js";
+import { JlTabPanel } from "./molecules/jl-tab-panel.js";
+import { JlTabs, TAB_VARIANTS } from "./molecules/jl-tabs.js";
+import { JlTagInput } from "./molecules/jl-tag-input.js";
+import { JlTimeline } from "./molecules/jl-timeline.js";
+import { JlToast, TOAST_TONES } from "./molecules/jl-toast.js";
+import { JlTooltip } from "./molecules/jl-tooltip.js";
+import { JlCommandPalette } from "./organisms/jl-command-palette.js";
+import { DIALOG_SIZES, JlDialog } from "./organisms/jl-dialog.js";
+import { CONFIRM_TONES, JlConfirm, confirmDialog } from "./organisms/jl-confirm.js";
+import { DRAWER_PLACEMENTS, DRAWER_SIZES, JlDrawer } from "./organisms/jl-drawer.js";
+import { JlNavbar } from "./organisms/jl-navbar.js";
+import { JlPageHeader } from "./organisms/jl-page-header.js";
+import { JlSideNav } from "./organisms/jl-side-nav.js";
+import { JlTable, TABLE_SORT_DIRECTIONS } from "./organisms/jl-table.js";
+import { JlToaster, TOASTER_PLACEMENTS, toast } from "./organisms/jl-toaster.js";
+import { JlTree } from "./organisms/jl-tree.js";
+import { JlAppShell } from "./templates/jl-app-shell.js";
+import { JlSplitView, SPLIT_ORIENTATIONS } from "./templates/jl-split-view.js";
+export { ACCORDION_VARIANTS, AVATAR_SHAPES, AVATAR_SIZES, AVATAR_STATUSES, BUTTON_TYPES, BUTTON_VARIANTS, CARD_PADDINGS, CHIP_SIZES, CODE_LANGUAGES, COMMON_ICONS, CONFIRM_TONES, CONTROL_SIZES, DIALOG_SIZES, DIVIDER_ALIGNS, DRAWER_PLACEMENTS, DRAWER_SIZES, EMPTY_SIZES, FIELD_ORIENTATIONS, INPUT_TYPES, JlAccordion, JlAccordionItem, JlAlert, JlAppShell, JlAvatar, JlAvatarGroup, JlBadge, JlBreadcrumb, JlButton, JlCalendar, JlCard, JlCheckbox, JlChip, JlCodeBlock, JlCombobox, JlCommandPalette, JlConfirm, JlCopyButton, JlDatePicker, JlDialog, JlDivider, JlDrawer, JlElement, JlEmpty, JlField, JlFileDrop, JlFormControl, JlIcon, JlInput, JlKbd, JlLink, JlListItem, JlMenu, JlNavbar, JlNumberInput, JlPageHeader, JlPagination, JlPopover, JlProgress, JlProgressRing, JlRadioGroup, JlRating, JlSearch, JlSegmented, JlSelect, JlSideNav, JlSkeleton, JlSlider, JlSpinner, JlSplitView, JlStat, JlSteps, JlSwitch, JlTabPanel, JlTable, JlTabs, JlTagInput, JlTextarea, JlTimeline, JlToast, JlToaster, JlTooltip, JlTree, LINK_VARIANTS, PLACEMENTS, PROGRESS_SIZES, PROGRESS_TONES, RADIO_GROUP_ORIENTATIONS, RADIO_GROUP_VARIANTS, SKELETON_SHAPES, SPLIT_ORIENTATIONS, STAT_TRENDS, STEPS_ORIENTATIONS, SWITCH_SIZES, TABLE_SORT_DIRECTIONS, TAB_VARIANTS, TOASTER_PLACEMENTS, TOAST_TONES, TOKEN_STYLES, TONES, TONE_ICONS, adoptTokens, clampedNumber, computePosition, confirmDialog, define, followAnchor, hasIcon, iconElement, iconNames, jsonOf, oneOf, placeFloating, registerIcons, toast };

package/dist/lib/arrow.d.ts

@@ -0,0 +1,6 @@
+import type { Rect, Side } from '../types/floating.types';
+/**
+ * Where a floating element's arrow goes along the edge that faces its anchor, in pixels from that edge's start: in
+ * front of the anchor's centre, kept `margin` pixels away from the corners.
+ */
+export declare function arrowOffset(anchor: Rect, floating: Rect, side: Side, margin: number): number;

package/dist/lib/arrow.js

@@ -0,0 +1,15 @@
+// src/lib/arrow.ts
+var isVertical = (side) => side === "top" || side === "bottom";
+/**
+* Where a floating element's arrow goes along the edge that faces its anchor, in pixels from that edge's start: in
+* front of the anchor's centre, kept `margin` pixels away from the corners.
+*/
+function arrowOffset(anchor, floating, side, margin) {
+	const vertical = isVertical(side);
+	const anchorCentre = vertical ? anchor.left + anchor.width / 2 : anchor.top + anchor.height / 2;
+	const start = vertical ? floating.left : floating.top;
+	const length = vertical ? floating.width : floating.height;
+	const offset = anchorCentre - start;
+	return Math.min(Math.max(offset, margin), Math.max(margin, length - margin));
+}
+export { arrowOffset };

package/dist/lib/attributes.d.ts

@@ -0,0 +1,9 @@
+/** An attribute's value when it is one of the allowed ones, otherwise the fallback. */
+export declare const oneOf: <Value extends string>(allowed: readonly Value[], fallback: Value) => (value: string | null) => Value;
+/**
+ * An attribute holding JSON, for the lists and objects a page writes in HTML:
+ * `<jl-select options='[{"value":"a","label":"A"}]'>`. Unreadable JSON gives the fallback.
+ */
+export declare const jsonOf: <Value>(fallback: Value) => (value: string | null) => Value;
+/** A number attribute kept within bounds; a missing or unreadable one gives the fallback. */
+export declare const clampedNumber: (fallback: number, min: number, max: number) => (value: string | null) => number;

package/dist/lib/attributes.js

@@ -0,0 +1,22 @@
+// src/lib/attributes.ts
+/** An attribute's value when it is one of the allowed ones, otherwise the fallback. */
+var oneOf = (allowed, fallback) => (value) => allowed.find((candidate) => candidate === value) ?? fallback;
+/**
+* An attribute holding JSON, for the lists and objects a page writes in HTML:
+* `<jl-select options='[{"value":"a","label":"A"}]'>`. Unreadable JSON gives the fallback.
+*/
+var jsonOf = (fallback) => (value) => {
+	if (value === null || value.trim() === "") return fallback;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return fallback;
+	}
+};
+/** A number attribute kept within bounds; a missing or unreadable one gives the fallback. */
+var clampedNumber = (fallback, min, max) => (value) => {
+	const parsed = value === null || value.trim() === "" ? NaN : Number(value);
+	if (Number.isNaN(parsed)) return fallback;
+	return Math.min(max, Math.max(min, parsed));
+};
+export { clampedNumber, jsonOf, oneOf };

package/dist/lib/avatar.d.ts

@@ -0,0 +1,11 @@
+/** A name's initials, at most two: "Ada Lovelace" gives AL, "Grace" gives G, "Jean-Luc Picard" gives JP. */
+export declare function initialsOf(name: string): string;
+/** A number for a text, always the same for the same text. */
+export declare function stableHash(text: string): number;
+/** One of the options, chosen by the key: the same key always gets the same option. */
+export declare function pickStable<Option>(key: string, options: readonly [Option, ...Option[]]): Option;
+/** The items a group shows, and those it only counts ("+3"); a `max` of 0 or less shows them all. */
+export declare function splitVisible<Item>(items: readonly Item[], max: number): {
+    shown: Item[];
+    hidden: Item[];
+};

package/dist/lib/avatar.js

@@ -0,0 +1,37 @@
+// src/lib/avatar.ts
+var HASH_SEED = 2166136261;
+var HASH_PRIME = 16777619;
+var MAX_INITIALS = 2;
+var WORDS = /\s+/;
+var LETTER_OR_DIGIT = /[\p{L}\p{N}]/u;
+/** The first letter or digit of a word, whole even outside the basic plane; its first character otherwise. */
+var firstLetter = (word) => {
+	const characters = Array.from(word);
+	return characters.find((character) => LETTER_OR_DIGIT.test(character)) ?? characters[0] ?? "";
+};
+/** A name's initials, at most two: "Ada Lovelace" gives AL, "Grace" gives G, "Jean-Luc Picard" gives JP. */
+function initialsOf(name) {
+	const words = name.trim().split(WORDS).filter((word) => word !== "");
+	if (words.length === 0) return "";
+	return (words.length === 1 ? words : [words[0] ?? "", words.at(-1) ?? ""]).slice(0, MAX_INITIALS).map(firstLetter).join("").toLocaleUpperCase();
+}
+/** A number for a text, always the same for the same text. */
+function stableHash(text) {
+	return Array.from(text).reduce((hash, character) => Math.imul(hash ^ (character.codePointAt(0) ?? 0), HASH_PRIME) >>> 0, HASH_SEED);
+}
+/** One of the options, chosen by the key: the same key always gets the same option. */
+function pickStable(key, options) {
+	return options[stableHash(key) % options.length] ?? options[0];
+}
+/** The items a group shows, and those it only counts ("+3"); a `max` of 0 or less shows them all. */
+function splitVisible(items, max) {
+	if (max <= 0 || items.length <= max) return {
+		hidden: [],
+		shown: [...items]
+	};
+	return {
+		hidden: items.slice(max),
+		shown: items.slice(0, max)
+	};
+}
+export { initialsOf, pickStable, splitVisible, stableHash };

package/dist/lib/calendar.d.ts

@@ -0,0 +1,48 @@
+import type { CalendarDate, Weekday, WeekdayWidth } from '../types/calendar.types';
+/** A month grid always has six weeks, so the calendar keeps its height from one month to the next. */
+export declare const WEEKS_PER_GRID = 6;
+export declare const isLeapYear: (year: number) => boolean;
+export declare function daysInMonth(year: number, month: number): number;
+/** A date from its ISO text (`2026-10-25`); null for anything else, including days that do not exist. */
+export declare function parseIsoDate(text: string): CalendarDate | null;
+export declare const toIsoDate: (date: CalendarDate) => string;
+/** Today, or the day of any moment, as the person's clock shows it. */
+export declare const calendarDateOf: (moment: Date) => CalendarDate;
+export declare const addDays: (date: CalendarDate, days: number) => CalendarDate;
+/** The same day some months later or earlier; the 31st becomes the last day of a shorter month. */
+export declare function addMonths(date: CalendarDate, months: number): CalendarDate;
+export declare const addYears: (date: CalendarDate, years: number) => CalendarDate;
+export declare const dayOfWeek: (date: CalendarDate) => Weekday;
+/** Negative when a comes first, positive when b does, 0 for the same day. */
+export declare const compareDates: (a: CalendarDate, b: CalendarDate) => number;
+export declare const isSameDate: (a: CalendarDate | null, b: CalendarDate | null) => boolean;
+/** Whether the date is within the bounds, both included; a null bound does not limit. */
+export declare const isWithin: (date: CalendarDate, min: CalendarDate | null, max: CalendarDate | null) => boolean;
+/** The nearest date within the bounds. */
+export declare function clampDate(date: CalendarDate, min: CalendarDate | null, max: CalendarDate | null): CalendarDate;
+/** The weekdays in the order a week shows them, from its first day. */
+export declare const weekdayOrder: (firstDay: Weekday) => Weekday[];
+export declare const startOfWeek: (date: CalendarDate, firstDay: Weekday) => CalendarDate;
+export declare const endOfWeek: (date: CalendarDate, firstDay: Weekday) => CalendarDate;
+export declare const startOfMonth: (date: CalendarDate) => CalendarDate;
+export declare const isSameMonth: (a: CalendarDate, b: CalendarDate) => boolean;
+/** Six weeks of days around a month, starting on the week's first day: the days of a calendar page. */
+export declare function monthGrid(year: number, month: number, firstDay: Weekday): CalendarDate[][];
+/** Whether any day of the month is within the bounds: a month entirely outside them is not worth showing. */
+export declare function monthHasDaysWithin(year: number, month: number, min: CalendarDate | null, max: CalendarDate | null): boolean;
+/**
+ * Where a key moves the focus of a date grid: arrows by day and week, Home and End to the ends of the week,
+ * Page Up and Page Down by month (by year with Shift). Null for a key that does not move it.
+ */
+export declare function dateAfterKey(date: CalendarDate, key: string, firstDay: Weekday, shift?: boolean): CalendarDate | null;
+/**
+ * A function that writes dates for people, in a locale: `Oct 25, 2026` by default, any Intl date style with
+ * `options`. Made once and used for many dates, as a calendar page does.
+ */
+export declare function dateFormatter(locale: string | undefined, options?: Intl.DateTimeFormatOptions): (date: CalendarDate) => string;
+/** One date written for people, in a locale: `Oct 25, 2026` by default. */
+export declare const formatDate: (date: CalendarDate, locale: string | undefined, options?: Intl.DateTimeFormatOptions) => string;
+/** The title of a calendar page: `October 2026`. */
+export declare const formatMonthTitle: (year: number, month: number, locale: string | undefined) => string;
+/** The names of the weekdays, in the order a week shows them from its first day. */
+export declare const weekdayNames: (locale: string | undefined, firstDay: Weekday, width: WeekdayWidth) => string[];

package/dist/lib/calendar.js

@@ -0,0 +1,166 @@
+// src/lib/calendar.ts
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var MS_PER_DAY = 864e5;
+var MONTHS_PER_YEAR = 12;
+var DAYS_PER_WEEK = 7;
+var FEBRUARY = 2;
+var LEAP_FEBRUARY_DAYS = 29;
+var MONTH_LENGTHS = [
+	31,
+	28,
+	31,
+	30,
+	31,
+	30,
+	31,
+	31,
+	30,
+	31,
+	30,
+	31
+];
+var YEAR_DIGITS = 4;
+var MONTH_DIGITS = 2;
+var A_SUNDAY = {
+	day: 1,
+	month: 1,
+	year: 2023
+};
+var UTC = "UTC";
+var isLeapYear = (year) => year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+function daysInMonth(year, month) {
+	if (month === FEBRUARY && isLeapYear(year)) return LEAP_FEBRUARY_DAYS;
+	return MONTH_LENGTHS[month - 1] ?? 0;
+}
+/** A date from its ISO text (`2026-10-25`); null for anything else, including days that do not exist. */
+function parseIsoDate(text) {
+	const match = ISO_DATE.exec(text.trim());
+	if (match === null) return null;
+	const year = Number(match[1]);
+	const month = Number(match[2]);
+	const day = Number(match[3]);
+	if (month < 1 || month > MONTHS_PER_YEAR || day < 1 || day > daysInMonth(year, month)) return null;
+	return {
+		day,
+		month,
+		year
+	};
+}
+var pad = (value, digits) => String(value).padStart(digits, "0");
+var toIsoDate = (date) => `${pad(date.year, YEAR_DIGITS)}-${pad(date.month, MONTH_DIGITS)}-${pad(date.day, MONTH_DIGITS)}`;
+/** The date's midnight in UTC. `setUTCFullYear` keeps years under 100 as they are, where `Date.UTC` would not. */
+function utcTime(date) {
+	const time = /* @__PURE__ */ new Date(0);
+	time.setUTCFullYear(date.year, date.month - 1, date.day);
+	return time.getTime();
+}
+function fromUtcTime(time) {
+	const moment = new Date(time);
+	return {
+		day: moment.getUTCDate(),
+		month: moment.getUTCMonth() + 1,
+		year: moment.getUTCFullYear()
+	};
+}
+/** Today, or the day of any moment, as the person's clock shows it. */
+var calendarDateOf = (moment) => ({
+	day: moment.getDate(),
+	month: moment.getMonth() + 1,
+	year: moment.getFullYear()
+});
+var addDays = (date, days) => fromUtcTime(utcTime(date) + days * MS_PER_DAY);
+/** The same day some months later or earlier; the 31st becomes the last day of a shorter month. */
+function addMonths(date, months) {
+	const index = date.year * MONTHS_PER_YEAR + (date.month - 1) + months;
+	const year = Math.floor(index / MONTHS_PER_YEAR);
+	const month = index - year * MONTHS_PER_YEAR + 1;
+	return {
+		day: Math.min(date.day, daysInMonth(year, month)),
+		month,
+		year
+	};
+}
+var addYears = (date, years) => addMonths(date, years * MONTHS_PER_YEAR);
+var dayOfWeek = (date) => new Date(utcTime(date)).getUTCDay();
+/** Negative when a comes first, positive when b does, 0 for the same day. */
+var compareDates = (a, b) => a.year - b.year || a.month - b.month || a.day - b.day;
+var isSameDate = (a, b) => a !== null && b !== null && compareDates(a, b) === 0;
+/** Whether the date is within the bounds, both included; a null bound does not limit. */
+var isWithin = (date, min, max) => (min === null || compareDates(date, min) >= 0) && (max === null || compareDates(date, max) <= 0);
+/** The nearest date within the bounds. */
+function clampDate(date, min, max) {
+	if (min !== null && compareDates(date, min) < 0) return min;
+	if (max !== null && compareDates(date, max) > 0) return max;
+	return date;
+}
+/** The weekdays in the order a week shows them, from its first day. */
+var weekdayOrder = (firstDay) => Array.from({ length: DAYS_PER_WEEK }, (_, index) => (firstDay + index) % DAYS_PER_WEEK);
+var startOfWeek = (date, firstDay) => addDays(date, -((dayOfWeek(date) - firstDay + DAYS_PER_WEEK) % DAYS_PER_WEEK));
+var endOfWeek = (date, firstDay) => addDays(startOfWeek(date, firstDay), 6);
+var isSameMonth = (a, b) => a.year === b.year && a.month === b.month;
+/** Six weeks of days around a month, starting on the week's first day: the days of a calendar page. */
+function monthGrid(year, month, firstDay) {
+	const start = startOfWeek({
+		day: 1,
+		month,
+		year
+	}, firstDay);
+	return Array.from({ length: 6 }, (_, week) => Array.from({ length: DAYS_PER_WEEK }, (_, day) => addDays(start, week * DAYS_PER_WEEK + day)));
+}
+/** Whether any day of the month is within the bounds: a month entirely outside them is not worth showing. */
+function monthHasDaysWithin(year, month, min, max) {
+	const first = {
+		day: 1,
+		month,
+		year
+	};
+	const last = {
+		day: daysInMonth(year, month),
+		month,
+		year
+	};
+	return (max === null || compareDates(first, max) <= 0) && (min === null || compareDates(last, min) >= 0);
+}
+var DAY_MOVES = /* @__PURE__ */ new Map([
+	["ArrowDown", (date) => addDays(date, DAYS_PER_WEEK)],
+	["ArrowLeft", (date) => addDays(date, -1)],
+	["ArrowRight", (date) => addDays(date, 1)],
+	["ArrowUp", (date) => addDays(date, -7)],
+	["End", (date, firstDay) => endOfWeek(date, firstDay)],
+	["Home", (date, firstDay) => startOfWeek(date, firstDay)],
+	["PageDown", (date, _, shift) => shift ? addYears(date, 1) : addMonths(date, 1)],
+	["PageUp", (date, _, shift) => shift ? addYears(date, -1) : addMonths(date, -1)]
+]);
+/**
+* Where a key moves the focus of a date grid: arrows by day and week, Home and End to the ends of the week,
+* Page Up and Page Down by month (by year with Shift). Null for a key that does not move it.
+*/
+function dateAfterKey(date, key, firstDay, shift = false) {
+	const move = DAY_MOVES.get(key);
+	return move === void 0 ? null : move(date, firstDay, shift);
+}
+/**
+* A function that writes dates for people, in a locale: `Oct 25, 2026` by default, any Intl date style with
+* `options`. Made once and used for many dates, as a calendar page does.
+*/
+function dateFormatter(locale, options = { dateStyle: "medium" }) {
+	const format = new Intl.DateTimeFormat(locale, {
+		...options,
+		timeZone: UTC
+	});
+	return (date) => format.format(new Date(utcTime(date)));
+}
+/** One date written for people, in a locale: `Oct 25, 2026` by default. */
+var formatDate = (date, locale, options) => dateFormatter(locale, options)(date);
+/** The title of a calendar page: `October 2026`. */
+var formatMonthTitle = (year, month, locale) => formatDate({
+	day: 1,
+	month,
+	year
+}, locale, {
+	month: "long",
+	year: "numeric"
+});
+/** The names of the weekdays, in the order a week shows them from its first day. */
+var weekdayNames = (locale, firstDay, width) => weekdayOrder(firstDay).map((weekday) => formatDate(addDays(A_SUNDAY, weekday), locale, { weekday: width }));
+export { addDays, addMonths, addYears, calendarDateOf, clampDate, compareDates, dateAfterKey, dateFormatter, dayOfWeek, daysInMonth, endOfWeek, formatDate, formatMonthTitle, isLeapYear, isSameDate, isSameMonth, isWithin, monthGrid, monthHasDaysWithin, parseIsoDate, startOfWeek, toIsoDate, weekdayNames, weekdayOrder };

package/dist/lib/css-length.d.ts

@@ -0,0 +1,2 @@
+/** A size for CSS: a plain number is in pixels ("120" gives "120px"); anything else is kept ("50%", "8rem"). */
+export declare function cssLength(value: string): string;

package/dist/lib/css-length.js

@@ -0,0 +1,8 @@
+// src/lib/css-length.ts
+var PLAIN_NUMBER = /^-?\d+(\.\d+)?$/;
+/** A size for CSS: a plain number is in pixels ("120" gives "120px"); anything else is kept ("50%", "8rem"). */
+function cssLength(value) {
+	const trimmed = value.trim();
+	return PLAIN_NUMBER.test(trimmed) ? `${trimmed}px` : trimmed;
+}
+export { cssLength };

package/dist/lib/define.d.ts

@@ -0,0 +1,9 @@
+type Registrable = {
+    register(): void;
+};
+/**
+ * Defines components for use as HTML tags: `define(JlButton, JlDialog)`. A component also defines itself when its
+ * class is used; naming it here is what keeps it in the bundle when the page only writes its tag.
+ */
+export declare function define(...components: Registrable[]): void;
+export {};

package/dist/lib/define.js

@@ -0,0 +1,9 @@
+// src/lib/define.ts
+/**
+* Defines components for use as HTML tags: `define(JlButton, JlDialog)`. A component also defines itself when its
+* class is used; naming it here is what keeps it in the bundle when the page only writes its tag.
+*/
+function define(...components) {
+	for (const component of components) component.register();
+}
+export { define };

package/dist/lib/dom.d.ts

@@ -0,0 +1,4 @@
+/** Sets an attribute, or removes it when the value is empty. */
+export declare function setOrRemove(element: Element, name: string, value: string): void;
+/** A unique id within the page, for wiring `aria-controls`, `aria-labelledby` and the like inside a shadow root. */
+export declare function uniqueId(prefix: string): string;

package/dist/lib/dom.js

@@ -0,0 +1,16 @@
+// src/lib/dom.ts
+/** Sets an attribute, or removes it when the value is empty. */
+function setOrRemove(element, name, value) {
+	if (value === "") {
+		element.removeAttribute(name);
+		return;
+	}
+	element.setAttribute(name, value);
+}
+var sequence = { next: 0 };
+/** A unique id within the page, for wiring `aria-controls`, `aria-labelledby` and the like inside a shadow root. */
+function uniqueId(prefix) {
+	sequence.next += 1;
+	return `${prefix}-${sequence.next}`;
+}
+export { setOrRemove, uniqueId };

package/dist/lib/files.d.ts

@@ -0,0 +1,18 @@
+import type { FileCheck, FileLike, FileRules } from '../types/files.types';
+/** A size in bytes as people read it: `512 B`, `1.5 KB`, `12 MB`, in powers of 1024. */
+export declare function formatFileSize(bytes: number, locale?: string): string;
+/** Whether a file is of a type the `accept` list allows, as `<input type="file" accept>` reads it. Empty allows all. */
+export declare function matchesAccept(file: Pick<FileLike, 'name' | 'type'>, accept: string): boolean;
+/**
+ * Sorts files into those a field takes and those it refuses, with the reason. A single-file field takes the first
+ * good file and refuses the other good ones as one too many.
+ */
+export declare function checkFiles<Item extends FileLike>(files: readonly Item[], rules: FileRules): FileCheck<Item>;
+/** An `accept` list as people read it, without repeats: `.png,.jpg,image/png` gives `PNG, JPG`. */
+export declare const describeAccept: (accept: string) => string;
+/** Whether two files are the same one picked twice: same name, size and modification time. */
+export declare const isSameFile: (a: FileLike & {
+    lastModified?: number;
+}, b: FileLike & {
+    lastModified?: number;
+}) => boolean;

package/dist/lib/files.js

@@ -0,0 +1,89 @@
+// src/lib/files.ts
+var SIZE_UNITS = [
+	"B",
+	"KB",
+	"MB",
+	"GB",
+	"TB"
+];
+var SIZE_STEP = 1024;
+var DECIMALS_BELOW = 10;
+var WILDCARD = "/*";
+var EXTENSION_MARK = ".";
+/** A size in bytes as people read it: `512 B`, `1.5 KB`, `12 MB`, in powers of 1024. */
+function formatFileSize(bytes, locale) {
+	const safe = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;
+	const exponent = unitExponent(safe);
+	const value = safe / SIZE_STEP ** exponent;
+	const decimals = exponent === 0 || value >= DECIMALS_BELOW ? 0 : 1;
+	return `${new Intl.NumberFormat(locale, {
+		maximumFractionDigits: decimals,
+		useGrouping: false
+	}).format(value)} ${SIZE_UNITS[exponent]}`;
+}
+/** The unit a size is written in; a value that would round up to 1024 of a unit moves to the next one. */
+function unitExponent(bytes) {
+	const last = SIZE_UNITS.length - 1;
+	const exponent = bytes < 1 ? 0 : Math.min(last, Math.floor(Math.log(bytes) / Math.log(SIZE_STEP)));
+	return Math.round(bytes / SIZE_STEP ** exponent) >= SIZE_STEP && exponent < last ? exponent + 1 : exponent;
+}
+var acceptTokens = (accept) => accept.split(",").map((token) => token.trim().toLowerCase()).filter((token) => token !== "");
+/** Whether one entry of an `accept` list takes the file: an extension, a MIME type, or a family such as `image/*`. */
+function acceptsToken(token, name, type) {
+	if (token.startsWith(EXTENSION_MARK)) return name.endsWith(token);
+	if (token.endsWith(WILDCARD)) return type.startsWith(token.slice(0, -1));
+	return type === token;
+}
+/** Whether a file is of a type the `accept` list allows, as `<input type="file" accept>` reads it. Empty allows all. */
+function matchesAccept(file, accept) {
+	const tokens = acceptTokens(accept);
+	const name = file.name.toLowerCase();
+	const type = file.type.toLowerCase();
+	return tokens.length === 0 || tokens.some((token) => acceptsToken(token, name, type));
+}
+/** Why a file is refused on its own, before counting: its type, then its size; null when it is fine. */
+function refusalOf(file, rules) {
+	if (!matchesAccept(file, rules.accept)) return "type";
+	if (rules.maxSize > 0 && file.size > rules.maxSize) return "size";
+	return null;
+}
+/**
+* Sorts files into those a field takes and those it refuses, with the reason. A single-file field takes the first
+* good file and refuses the other good ones as one too many.
+*/
+function checkFiles(files, rules) {
+	const result = {
+		accepted: [],
+		refused: []
+	};
+	for (const file of files) {
+		const reason = refusalOf(file, rules);
+		if (reason !== null) {
+			result.refused.push({
+				file,
+				reason
+			});
+			continue;
+		}
+		if (!rules.multiple && result.accepted.length > 0) {
+			result.refused.push({
+				file,
+				reason: "count"
+			});
+			continue;
+		}
+		result.accepted.push(file);
+	}
+	return result;
+}
+/** One entry of an `accept` list as people read it: `.png` and `image/png` give `PNG`, `image/*` gives `images`. */
+function describeToken(token) {
+	if (token.startsWith(EXTENSION_MARK)) return token.slice(1).toUpperCase();
+	if (token.endsWith(WILDCARD)) return `${token.slice(0, -2)}s`;
+	return (token.split("/").at(-1) ?? token).toUpperCase();
+}
+/** An `accept` list as people read it, without repeats: `.png,.jpg,image/png` gives `PNG, JPG`. */
+var describeAccept = (accept) => [...new Set(acceptTokens(accept).map(describeToken))].join(", ");
+/** Whether two files are the same one picked twice: same name, size and modification time. */
+var isSameFile = (a, b) => a.name === b.name && a.size === b.size && a.lastModified === b.lastModified;
+export { checkFiles, describeAccept, formatFileSize, isSameFile, matchesAccept };

package/dist/lib/floating.d.ts

@@ -0,0 +1,13 @@
+import type { Placement, Point, Rect, Size } from '../types/floating.types';
+export declare const PLACEMENTS: readonly Placement[];
+/**
+ * Where to put a floating element next to its anchor, in window coordinates: on the asked side when it fits,
+ * otherwise on the opposite side if that leaves more of it visible; then kept inside the window.
+ */
+export declare function computePosition(anchor: Rect, floating: Size, viewport: Size, placement: Placement, gap?: number): Point & {
+    placement: Placement;
+};
+/** Puts a fixed-position element next to its anchor; returns the placement it got after flipping. */
+export declare function placeFloating(anchor: Element, floating: HTMLElement, placement: Placement, gap?: number): Placement;
+/** Keeps a floating element by its anchor while the page scrolls or resizes, until the signal aborts. */
+export declare function followAnchor(anchor: Element, floating: HTMLElement, placement: Placement, signal: AbortSignal, gap?: number): void;