@lyeve-labs/ui-kit 0.11.2 → 0.13.0

package/dist/index.d.ts

@@ -7,32 +7,55 @@
  * is an implementation detail.
  */
 export { default as Card } from './components/Card.svelte';
+export { default as Panel } from './components/Panel.svelte';
+export { default as PageShell } from './components/PageShell.svelte';
 export { default as PageHeader } from './components/PageHeader.svelte';
+export { default as SectionHeading } from './components/SectionHeading.svelte';
 export { default as Divider } from './components/Divider.svelte';
 export { default as Accordion } from './components/Accordion.svelte';
 export { default as AccordionItem } from './components/AccordionItem.svelte';
+export { default as Collapsible } from './components/Collapsible.svelte';
 export { default as Table } from './components/Table.svelte';
+export { default as DescriptionList } from './components/DescriptionList.svelte';
+export { default as Toolbar } from './components/Toolbar.svelte';
+export { default as TreeView } from './components/TreeView.svelte';
+export type { PageWidth } from './internal/layout.js';
+export type { TreeNode, TriState } from './internal/tree.js';
 export { default as Button } from './components/Button.svelte';
 export { default as ButtonGroup } from './components/ButtonGroup.svelte';
 export { default as Input } from './components/Input.svelte';
+export { default as PasswordInput } from './components/PasswordInput.svelte';
 export { default as Textarea } from './components/Textarea.svelte';
 export { default as NumberInput } from './components/NumberInput.svelte';
 export { default as SearchInput } from './components/SearchInput.svelte';
 export { default as FileInput } from './components/FileInput.svelte';
 export { default as Label } from './components/Label.svelte';
+export { default as Field } from './components/Field.svelte';
+export { default as FormMessage } from './components/FormMessage.svelte';
+export { default as SegmentedControl } from './components/SegmentedControl.svelte';
 export { default as Select } from './components/Select.svelte';
 export { default as MultiSelect } from './components/MultiSelect.svelte';
 export { default as Autocomplete } from './components/Autocomplete.svelte';
 export { default as DatePicker } from './components/DatePicker.svelte';
+export { default as TimePicker } from './components/TimePicker.svelte';
+export { default as DateTimePicker } from './components/DateTimePicker.svelte';
 export { default as Checkbox } from './components/Checkbox.svelte';
+export { default as CheckboxGroup } from './components/CheckboxGroup.svelte';
 export { default as Radio } from './components/Radio.svelte';
 export { default as RadioGroup } from './components/RadioGroup.svelte';
 export { default as Toggle } from './components/Toggle.svelte';
+export type { ChoiceSize, ChoiceVariant, ChoiceOrientation } from './internal/choice.js';
+export type { ChoiceOption } from './components/CheckboxGroup.svelte';
+export type { SelectOption, SelectChangeEvent } from './components/Select.svelte';
+export type { ListOption } from './components/Autocomplete.svelte';
+export type { FilterFn, FilterInput, FilterContext } from './internal/filter.js';
 export { default as Breadcrumb } from './components/Breadcrumb.svelte';
 export { default as Tabs } from './components/Tabs.svelte';
 export { default as Pagination } from './components/Pagination.svelte';
 export { default as StepIndicator } from './components/StepIndicator.svelte';
 export { default as Dropdown } from './components/Dropdown.svelte';
+export { default as SidebarNav } from './components/SidebarNav.svelte';
+export type { NavNode, NavTree } from './internal/nav-tree.js';
 export { default as Modal } from './components/Modal.svelte';
 export { default as Drawer } from './components/Drawer.svelte';
 export { default as Tooltip } from './components/Tooltip.svelte';
@@ -47,6 +70,7 @@ export { default as Skeleton } from './components/Skeleton.svelte';
 export { default as EmptyState } from './components/EmptyState.svelte';
 export { default as Stat } from './components/Stat.svelte';
 export { default as Kbd } from './components/Kbd.svelte';
+export { default as CopyButton } from './components/CopyButton.svelte';
 export { default as Avatar } from './components/Avatar.svelte';
 export { default as AvatarGroup } from './components/AvatarGroup.svelte';
 export { default as ThemeToggle } from './components/ThemeToggle.svelte';
@@ -60,4 +84,4 @@ export { openDialog, closeDialog, dismissDialog, dismissAllDialogs, confirm, set
 export type { DialogOptions, DialogEntry, DialogSize } from './components/dialog/types.js';
 export { cn, type ClassValue } from './utils/cn.js';
 export { getTheme, setTheme, toggleTheme, themeBootScript, type Theme } from './utils/theme.js';
-export declare const VERSION = "0.11.2";
+export declare const VERSION = "0.13.0";

package/dist/index.js

@@ -8,25 +8,42 @@
  */
 // ── Layout & structure ─────────────────────────────────────────────────────
 export { default as Card } from './components/Card.svelte';
+export { default as Panel } from './components/Panel.svelte';
+export { default as PageShell } from './components/PageShell.svelte';
 export { default as PageHeader } from './components/PageHeader.svelte';
+export { default as SectionHeading } from './components/SectionHeading.svelte';
 export { default as Divider } from './components/Divider.svelte';
 export { default as Accordion } from './components/Accordion.svelte';
 export { default as AccordionItem } from './components/AccordionItem.svelte';
+export { default as Collapsible } from './components/Collapsible.svelte';
 export { default as Table } from './components/Table.svelte';
+export { default as DescriptionList } from './components/DescriptionList.svelte';
+export { default as Toolbar } from './components/Toolbar.svelte';
+export { default as TreeView } from './components/TreeView.svelte';
 // ── Forms & inputs ─────────────────────────────────────────────────────────
 export { default as Button } from './components/Button.svelte';
 export { default as ButtonGroup } from './components/ButtonGroup.svelte';
 export { default as Input } from './components/Input.svelte';
+export { default as PasswordInput } from './components/PasswordInput.svelte';
 export { default as Textarea } from './components/Textarea.svelte';
 export { default as NumberInput } from './components/NumberInput.svelte';
 export { default as SearchInput } from './components/SearchInput.svelte';
 export { default as FileInput } from './components/FileInput.svelte';
 export { default as Label } from './components/Label.svelte';
+// The field furniture as a component, for a consumer composing a control the
+// kit does not ship. internal/field.ts stays private, and a page that could
+// not reach it hand-copied the class strings instead.
+export { default as Field } from './components/Field.svelte';
+export { default as FormMessage } from './components/FormMessage.svelte';
+export { default as SegmentedControl } from './components/SegmentedControl.svelte';
 export { default as Select } from './components/Select.svelte';
 export { default as MultiSelect } from './components/MultiSelect.svelte';
 export { default as Autocomplete } from './components/Autocomplete.svelte';
 export { default as DatePicker } from './components/DatePicker.svelte';
+export { default as TimePicker } from './components/TimePicker.svelte';
+export { default as DateTimePicker } from './components/DateTimePicker.svelte';
 export { default as Checkbox } from './components/Checkbox.svelte';
+export { default as CheckboxGroup } from './components/CheckboxGroup.svelte';
 export { default as Radio } from './components/Radio.svelte';
 export { default as RadioGroup } from './components/RadioGroup.svelte';
 export { default as Toggle } from './components/Toggle.svelte';
@@ -36,6 +53,7 @@ export { default as Tabs } from './components/Tabs.svelte';
 export { default as Pagination } from './components/Pagination.svelte';
 export { default as StepIndicator } from './components/StepIndicator.svelte';
 export { default as Dropdown } from './components/Dropdown.svelte';
+export { default as SidebarNav } from './components/SidebarNav.svelte';
 // ── Overlays ───────────────────────────────────────────────────────────────
 export { default as Modal } from './components/Modal.svelte';
 export { default as Drawer } from './components/Drawer.svelte';
@@ -52,6 +70,7 @@ export { default as Skeleton } from './components/Skeleton.svelte';
 export { default as EmptyState } from './components/EmptyState.svelte';
 export { default as Stat } from './components/Stat.svelte';
 export { default as Kbd } from './components/Kbd.svelte';
+export { default as CopyButton } from './components/CopyButton.svelte';
 // ── Media ──────────────────────────────────────────────────────────────────
 export { default as Avatar } from './components/Avatar.svelte';
 export { default as AvatarGroup } from './components/AvatarGroup.svelte';
@@ -71,4 +90,4 @@ export { getTheme, setTheme, toggleTheme, themeBootScript } from './utils/theme.
 // ── Version ────────────────────────────────────────────────────────────────
 // Generated from package.json by `pnpm version:sync`. Bump package.json, never
 // this line; the build and the test suite fail when the two disagree.
-export const VERSION = '0.11.2';
+export const VERSION = '0.13.0';

package/dist/internal/calendar.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Month arithmetic for the date controls, done without the Date parser.
+ *
+ * The rule this module exists to enforce: no string is ever handed to the Date
+ * parser. `new Date('2026-01-02')` is UTC midnight by specification and
+ * `new Date('2026-01-02T00:00')` is local midnight, so one helper applied to a
+ * date field and to a datetime field lands in two different zones. Read the
+ * first form back through the local getters west of UTC and it is 1 January.
+ * That is the off by one day, and it appears only for the part of the world
+ * that is not on UTC, which is why it survives a developer's own testing.
+ *
+ * DatePicker binds `value` to an ISO calendar date spelled `YYYY-MM-DD`: four
+ * digit year, two digit zero padded month, two digit zero padded day, with the
+ * empty string standing for no date. Its `min` and `max` props take the same
+ * spelling and are compared as plain strings, which works only because that
+ * spelling sorts lexicographically. DateRangePicker and DateTimePicker will
+ * carry the same value and need the same arithmetic, and each of the three is a
+ * place the zone bug enters, so the arithmetic is stated once here.
+ *
+ * The numeric Date constructor is avoided as well. `new Date(24, 0, 1)` is
+ * 1924, because the constructor remaps years 0 through 99 into the twentieth
+ * century, and the year in a date field comes from a user. Everything below is
+ * integer arithmetic on the proleptic Gregorian calendar. The one Date in the
+ * file is the no argument one inside todayLocal, which is the only place a real
+ * clock is needed.
+ *
+ * Not exported from the package entry point - this is an implementation detail.
+ */
+/** A calendar date with no zone and no time. m is 1-12, the month a human says, not the 0-11 the Date constructor takes. */
+export interface CalendarDate {
+    y: number;
+    m: number;
+    d: number;
+}
+/**
+ * Reads the `YYYY-MM-DD` DatePicker binds, or null when the string is not one.
+ *
+ * Shape checks and round trips. `2024-13-45` returns null rather than silently
+ * becoming the 2025-02-14 those three numbers normalize to in a Date: a picker
+ * that accepted it would open on a month the user never typed and report a
+ * value they never chose. A day is rejected when its month does not have it, so
+ * `2024-02-30` and `2023-02-29` are both null while `2024-02-29` is a date.
+ * Undefined and the empty string are null too, because an unset field is the
+ * ordinary state of a date input and not an error.
+ */
+export declare function parseISODate(s: string | undefined | null): CalendarDate | null;
+/**
+ * Writes the `YYYY-MM-DD` DatePicker binds.
+ *
+ * Every part is zero padded, including the year, because the min and max
+ * comparison in the control is a string comparison: an unpadded `2024-1-5`
+ * sorts after `2024-12-01` and the bound then rejects dates inside it.
+ */
+export declare function toISODate(date: CalendarDate): string;
+/**
+ * Today in the viewer's own zone, read from the Date's local getters and never
+ * from its ISO string.
+ *
+ * `new Date().toISOString().slice(0, 10)` is the tempting one line version and
+ * it is wrong: it converts to UTC first, so a viewer in Jakarta gets yesterday
+ * until 7am and a viewer in New York gets tomorrow from the evening on. The
+ * date the calendar marks as today has to be the date on the wall behind the
+ * viewer.
+ */
+export declare function todayLocal(): CalendarDate;
+/**
+ * Days in a month, leap years included.
+ *
+ * A month outside 1 to 12 has no days and returns 0, so a caller bounding a day
+ * against it rejects the month rather than accepting a day in a month that does
+ * not exist.
+ */
+export declare function daysInMonth(y: number, m: number): number;
+/** Weekday of the first of the month, 0 for Sunday. */
+export declare function firstWeekday(y: number, m: number): number;
+/**
+ * Adds months, clamping the day rather than rolling into the next month.
+ *
+ * 31 January plus one month is 28 or 29 February, never 2 or 3 March. A Date
+ * rolls, so paging a picker forward from the 31st and back again lands the user
+ * on a different day than the one they were looking at, and a range whose start
+ * was the 31st can end up after its own end.
+ */
+export declare function addMonths(date: CalendarDate, delta: number): CalendarDate;
+/** Adds days across month and year boundaries, leap days included. */
+export declare function addDays(date: CalendarDate, delta: number): CalendarDate;
+/**
+ * Orders two dates as -1, 0 or 1.
+ *
+ * A total order, so a caller can sort and bound without constructing a Date.
+ * Returning the field difference would sort just as well and would report 2 for
+ * two years apart, which quietly breaks the caller that tests for 1.
+ */
+export declare function compareDates(a: CalendarDate, b: CalendarDate): number;
+/**
+ * Inclusive on both ends. Either bound may be null, meaning unbounded.
+ *
+ * Inclusive because a picker given min and max for a single allowed day has to
+ * offer that day. DatePicker compares its bounds as strings today, which agrees
+ * with this only while every bound is zero padded.
+ */
+export declare function withinRange(date: CalendarDate, min: CalendarDate | null, max: CalendarDate | null): boolean;
+/**
+ * The six week grid a month renders, always 42 cells so the calendar does not
+ * change height between months. Cells outside the viewed month carry
+ * `outside: true`.
+ *
+ * DatePicker pads its lead with empty spans and stops at the last day, so
+ * February in a year where it starts on a Sunday draws four rows and a 31 day
+ * month starting on a Saturday draws six. The popover resizes as the user pages
+ * through the year and the day under the pointer moves out from under it. Fixed
+ * at 42 because six weeks is the most any month can touch.
+ *
+ * `weekStartsOn` is 0 for Sunday and 1 for Monday.
+ */
+export declare function monthGrid(y: number, m: number, weekStartsOn?: 0 | 1): {
+    date: CalendarDate;
+    outside: boolean;
+}[];

package/dist/internal/calendar.js

@@ -0,0 +1,225 @@
+/**
+ * Month arithmetic for the date controls, done without the Date parser.
+ *
+ * The rule this module exists to enforce: no string is ever handed to the Date
+ * parser. `new Date('2026-01-02')` is UTC midnight by specification and
+ * `new Date('2026-01-02T00:00')` is local midnight, so one helper applied to a
+ * date field and to a datetime field lands in two different zones. Read the
+ * first form back through the local getters west of UTC and it is 1 January.
+ * That is the off by one day, and it appears only for the part of the world
+ * that is not on UTC, which is why it survives a developer's own testing.
+ *
+ * DatePicker binds `value` to an ISO calendar date spelled `YYYY-MM-DD`: four
+ * digit year, two digit zero padded month, two digit zero padded day, with the
+ * empty string standing for no date. Its `min` and `max` props take the same
+ * spelling and are compared as plain strings, which works only because that
+ * spelling sorts lexicographically. DateRangePicker and DateTimePicker will
+ * carry the same value and need the same arithmetic, and each of the three is a
+ * place the zone bug enters, so the arithmetic is stated once here.
+ *
+ * The numeric Date constructor is avoided as well. `new Date(24, 0, 1)` is
+ * 1924, because the constructor remaps years 0 through 99 into the twentieth
+ * century, and the year in a date field comes from a user. Everything below is
+ * integer arithmetic on the proleptic Gregorian calendar. The one Date in the
+ * file is the no argument one inside todayLocal, which is the only place a real
+ * clock is needed.
+ *
+ * Not exported from the package entry point - this is an implementation detail.
+ */
+/** Month lengths in a common year. February is corrected for leap years in daysInMonth. */
+const MONTH_LENGTHS = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+/** The only spelling DatePicker reads or writes. Anything else is not a date. */
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+/**
+ * The full Gregorian rule, not the every fourth year shorthand.
+ *
+ * A century is a common year unless it divides by 400. Dropping that clause
+ * makes 2000 a common year and puts 29 February 2000 out of reach of the
+ * control; keeping only the century clause makes 1900 a leap year and invents a
+ * day nobody lived through.
+ */
+function isLeapYear(y) {
+    return (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;
+}
+/** The remainder operator keeps the sign of its left operand, so a negative weekday offset needs the extra turn. */
+function mod7(n) {
+    return ((n % 7) + 7) % 7;
+}
+/**
+ * Days from 1970-01-01, negative before it.
+ *
+ * Howard Hinnant's days_from_civil, which is exact for every year the
+ * arithmetic can express and never touches a Date. Counting days is what makes
+ * addDays a single addition rather than a carry the caller has to write across
+ * three fields, and it is what gives firstWeekday an answer for a year under
+ * 100, where the Date constructor gives the wrong century.
+ */
+function toDayNumber(date) {
+    const shiftedYear = date.y - (date.m <= 2 ? 1 : 0);
+    const era = Math.floor(shiftedYear / 400);
+    const yearOfEra = shiftedYear - era * 400;
+    const dayOfYear = Math.floor((153 * (date.m + (date.m > 2 ? -3 : 9)) + 2) / 5) + date.d - 1;
+    const dayOfEra = yearOfEra * 365 + Math.floor(yearOfEra / 4) - Math.floor(yearOfEra / 100) + dayOfYear;
+    return era * 146097 + dayOfEra - 719468;
+}
+/** The inverse of toDayNumber, so a day count can go back to a date the grid can render. */
+function fromDayNumber(dayNumber) {
+    const shifted = dayNumber + 719468;
+    const era = Math.floor(shifted / 146097);
+    const dayOfEra = shifted - era * 146097;
+    const yearOfEra = Math.floor((dayOfEra -
+        Math.floor(dayOfEra / 1460) +
+        Math.floor(dayOfEra / 36524) -
+        Math.floor(dayOfEra / 146096)) /
+        365);
+    const dayOfYear = dayOfEra - (365 * yearOfEra + Math.floor(yearOfEra / 4) - Math.floor(yearOfEra / 100));
+    const monthIndex = Math.floor((5 * dayOfYear + 2) / 153);
+    const d = dayOfYear - Math.floor((153 * monthIndex + 2) / 5) + 1;
+    const m = monthIndex + (monthIndex < 10 ? 3 : -9);
+    return { y: yearOfEra + era * 400 + (m <= 2 ? 1 : 0), m, d };
+}
+/**
+ * Reads the `YYYY-MM-DD` DatePicker binds, or null when the string is not one.
+ *
+ * Shape checks and round trips. `2024-13-45` returns null rather than silently
+ * becoming the 2025-02-14 those three numbers normalize to in a Date: a picker
+ * that accepted it would open on a month the user never typed and report a
+ * value they never chose. A day is rejected when its month does not have it, so
+ * `2024-02-30` and `2023-02-29` are both null while `2024-02-29` is a date.
+ * Undefined and the empty string are null too, because an unset field is the
+ * ordinary state of a date input and not an error.
+ */
+export function parseISODate(s) {
+    if (!s)
+        return null;
+    const parts = ISO_DATE.exec(s);
+    if (!parts)
+        return null;
+    const y = Number(parts[1]);
+    const m = Number(parts[2]);
+    const d = Number(parts[3]);
+    if (m < 1 || m > 12)
+        return null;
+    if (d < 1 || d > daysInMonth(y, m))
+        return null;
+    return { y, m, d };
+}
+/** Pads a number to a fixed width so the result sorts as text. */
+function pad(n, width) {
+    return String(n).padStart(width, '0');
+}
+/**
+ * Writes the `YYYY-MM-DD` DatePicker binds.
+ *
+ * Every part is zero padded, including the year, because the min and max
+ * comparison in the control is a string comparison: an unpadded `2024-1-5`
+ * sorts after `2024-12-01` and the bound then rejects dates inside it.
+ */
+export function toISODate(date) {
+    return `${pad(date.y, 4)}-${pad(date.m, 2)}-${pad(date.d, 2)}`;
+}
+/**
+ * Today in the viewer's own zone, read from the Date's local getters and never
+ * from its ISO string.
+ *
+ * `new Date().toISOString().slice(0, 10)` is the tempting one line version and
+ * it is wrong: it converts to UTC first, so a viewer in Jakarta gets yesterday
+ * until 7am and a viewer in New York gets tomorrow from the evening on. The
+ * date the calendar marks as today has to be the date on the wall behind the
+ * viewer.
+ */
+export function todayLocal() {
+    const now = new Date();
+    return { y: now.getFullYear(), m: now.getMonth() + 1, d: now.getDate() };
+}
+/**
+ * Days in a month, leap years included.
+ *
+ * A month outside 1 to 12 has no days and returns 0, so a caller bounding a day
+ * against it rejects the month rather than accepting a day in a month that does
+ * not exist.
+ */
+export function daysInMonth(y, m) {
+    if (!Number.isInteger(m) || m < 1 || m > 12)
+        return 0;
+    if (m === 2)
+        return isLeapYear(y) ? 29 : 28;
+    return MONTH_LENGTHS[m - 1];
+}
+/** Weekday of the first of the month, 0 for Sunday. */
+export function firstWeekday(y, m) {
+    // Day number 0 is 1970-01-01, which was a Thursday, so the count starts four
+    // weekdays into the week.
+    return mod7(toDayNumber({ y, m, d: 1 }) + 4);
+}
+/**
+ * Adds months, clamping the day rather than rolling into the next month.
+ *
+ * 31 January plus one month is 28 or 29 February, never 2 or 3 March. A Date
+ * rolls, so paging a picker forward from the 31st and back again lands the user
+ * on a different day than the one they were looking at, and a range whose start
+ * was the 31st can end up after its own end.
+ */
+export function addMonths(date, delta) {
+    const totalMonths = date.y * 12 + (date.m - 1) + delta;
+    const y = Math.floor(totalMonths / 12);
+    const m = totalMonths - y * 12 + 1;
+    return { y, m, d: Math.min(date.d, daysInMonth(y, m)) };
+}
+/** Adds days across month and year boundaries, leap days included. */
+export function addDays(date, delta) {
+    return fromDayNumber(toDayNumber(date) + delta);
+}
+/**
+ * Orders two dates as -1, 0 or 1.
+ *
+ * A total order, so a caller can sort and bound without constructing a Date.
+ * Returning the field difference would sort just as well and would report 2 for
+ * two years apart, which quietly breaks the caller that tests for 1.
+ */
+export function compareDates(a, b) {
+    if (a.y !== b.y)
+        return a.y < b.y ? -1 : 1;
+    if (a.m !== b.m)
+        return a.m < b.m ? -1 : 1;
+    if (a.d !== b.d)
+        return a.d < b.d ? -1 : 1;
+    return 0;
+}
+/**
+ * Inclusive on both ends. Either bound may be null, meaning unbounded.
+ *
+ * Inclusive because a picker given min and max for a single allowed day has to
+ * offer that day. DatePicker compares its bounds as strings today, which agrees
+ * with this only while every bound is zero padded.
+ */
+export function withinRange(date, min, max) {
+    if (min !== null && compareDates(date, min) < 0)
+        return false;
+    if (max !== null && compareDates(date, max) > 0)
+        return false;
+    return true;
+}
+/**
+ * The six week grid a month renders, always 42 cells so the calendar does not
+ * change height between months. Cells outside the viewed month carry
+ * `outside: true`.
+ *
+ * DatePicker pads its lead with empty spans and stops at the last day, so
+ * February in a year where it starts on a Sunday draws four rows and a 31 day
+ * month starting on a Saturday draws six. The popover resizes as the user pages
+ * through the year and the day under the pointer moves out from under it. Fixed
+ * at 42 because six weeks is the most any month can touch.
+ *
+ * `weekStartsOn` is 0 for Sunday and 1 for Monday.
+ */
+export function monthGrid(y, m, weekStartsOn = 0) {
+    const lead = mod7(firstWeekday(y, m) - weekStartsOn);
+    const start = toDayNumber({ y, m, d: 1 }) - lead;
+    const cells = [];
+    for (let i = 0; i < 42; i++) {
+        const date = fromDayNumber(start + i);
+        cells.push({ date, outside: date.y !== y || date.m !== m });
+    }
+    return cells;
+}

package/dist/internal/choice.d.ts

@@ -0,0 +1,136 @@
+/**
+ * The single source of truth for how a checkbox or a radio looks and announces
+ * itself.
+ *
+ * Checkbox, Radio and RadioGroup paint one control three ways. The two label
+ * wrappers hold the same utilities in two orders, Checkbox marks a required
+ * option and Radio marks nothing, RadioGroup rests its box on `border-line`
+ * where the other two use `border-line-strong`, and RadioGroup still keeps its
+ * focus ring inside the selected ternary. That last one is the defect Checkbox
+ * and Radio were already fixed for: selecting an option deleted the only
+ * indicator a keyboard user had, and in a list of a hundred options that loses
+ * your place entirely. Composing from here means a fourth choice control cannot
+ * reintroduce any of it.
+ *
+ * Not exported from the package entry point - this is an implementation detail.
+ */
+/** The scale of the painted box: sm 14px, md 16px, lg 20px. */
+export type ChoiceSize = 'sm' | 'md' | 'lg';
+/** Inline is a box beside a label. Card is a bordered option surface. */
+export type ChoiceVariant = 'inline' | 'card';
+/** How a group lays its options out. */
+export type ChoiceOrientation = 'vertical' | 'horizontal';
+/**
+ * The clickable wrapper. Card is a bordered option the whole surface of which
+ * is the target.
+ *
+ * The cursor is a ternary rather than a `cursor-pointer` that a disabled state
+ * appends `cursor-not-allowed` to. Both set the same property, so a class list
+ * carrying both resolves by stylesheet order and not by the order written here,
+ * which is how a disabled option kept offering a pointer.
+ */
+export declare function choiceWrap(variant: ChoiceVariant, checked: boolean, disabled: boolean): string;
+/**
+ * The transparent input that sits over the painted box and carries every native
+ * semantic.
+ *
+ * `sr-only` leaves the input 1x1 and buried under the box that replaces it, so
+ * a click aimed at what the user sees lands on nothing. It covers the box
+ * instead, and `peer` is what lets the box below read its focus state.
+ */
+export declare const CHOICE_INPUT = "peer absolute inset-0 m-0 h-full w-full cursor-pointer opacity-0 disabled:cursor-not-allowed";
+/**
+ * The painted box or circle. Square for a checkbox, round for a radio, sized by
+ * ChoiceSize.
+ *
+ * The resting border is `border-line-strong`. `border-line` reads 1.25:1
+ * against the page, and the border is the only thing identifying an empty
+ * checkbox as a control, so at that contrast the control is invisible until it
+ * is used. A radio keeps a 2px ring because its selected state is a dot inside
+ * the ring rather than a fill, and a 1px ring reads as a smudge beside the dot
+ * at 14px.
+ *
+ * `mixed` paints exactly what `checked` paints. A part-selected parent is on,
+ * not a third state with a colour of its own; only the mark it holds differs.
+ */
+export declare function choiceBox(kind: 'checkbox' | 'radio', size: ChoiceSize, checked: boolean, mixed: boolean): string;
+/**
+ * The focus ring, stated ONCE and outside every checked branch.
+ *
+ * The ring lived inside the checked ternary in three components, so choosing an
+ * option removed the only indicator a keyboard user had. It is a ring and not a
+ * border colour because a selected box already carries a brand border, which
+ * leaves a border-only focus state with nothing to say.
+ */
+export declare const CHOICE_FOCUS = "peer-focus-visible:outline peer-focus-visible:outline-2 peer-focus-visible:outline-brand peer-focus-visible:outline-offset-2";
+/**
+ * The label stack beside or under the box.
+ *
+ * Checkbox and Radio both build this, in different word orders, which is how
+ * two controls in one form ended up with different gaps between a label and its
+ * description.
+ */
+export declare const CHOICE_LABEL_STACK = "flex flex-col gap-0.5";
+/**
+ * The label text, sized with the control.
+ *
+ * An option label is not a field label: it names one choice rather than the
+ * group, so it stays regular weight and FIELD_LABEL keeps the medium.
+ */
+export declare function choiceLabel(size: ChoiceSize): string;
+/**
+ * Secondary line under the label.
+ *
+ * The same class the hint under a text field uses, taken from field.ts rather
+ * than respelled, because a checkbox hint and an input hint sitting in one form
+ * have no reason to differ and had already drifted apart once.
+ */
+export declare const CHOICE_DESCRIPTION = "text-xs text-faint";
+/**
+ * The icon slot ahead of the label.
+ *
+ * Fixed to the box size so the label starts at the same x in every row of a
+ * list, and given no colour of its own so it inherits the label and dims with
+ * the wrapper when the option is disabled.
+ */
+export declare function choiceIcon(size: ChoiceSize): string;
+/**
+ * Pixel size for a lucide icon at each ChoiceSize, so a consumer does not
+ * guess.
+ *
+ * A lucide icon takes a number, not a class, so the slot above cannot size it.
+ * These are the same 14, 16 and 20 the slot reserves; an icon rendered at any
+ * other size overflows the slot or floats inside it.
+ */
+export declare const CHOICE_ICON_PX: Record<ChoiceSize, number>;
+/**
+ * The fieldset a group renders, so the set is announced as a group rather than
+ * as loose controls.
+ *
+ * `min-w-0` is load bearing: a fieldset defaults to `min-width: min-content`,
+ * so one long option label widened the whole group past its column instead of
+ * wrapping.
+ */
+export declare const CHOICE_GROUP = "flex min-w-0 flex-col gap-2";
+/**
+ * The row or column the options sit in.
+ *
+ * A horizontal group gets a wider inline gap than block gap: options read as
+ * separate choices across a row and as one list down a column, and an equal gap
+ * in both axes makes a wrapped row look like a grid.
+ */
+export declare function choiceGroupList(orientation: ChoiceOrientation): string;
+/**
+ * The check and the mixed marks, as SVG path data on the box's own grid.
+ *
+ * Drawn as paths because the consistency suite rejects a Unicode check outright,
+ * and because a font glyph lands at a different optical weight from every other
+ * icon in the library. Both sit in a 10 by 8 viewBox centred in the box, at
+ * stroke width 1.5 with round caps, so the two marks swap without the box
+ * shifting. The mixed bar stops short of the edges so its round caps do not
+ * touch the border.
+ */
+export declare const CHOICE_MARK: {
+    check: string;
+    mixed: string;
+};