plass-ui 1.4.0 → 1.5.0

package/dist/internal/date.js

@@ -1 +1 @@
-import{dateFormatter as t}from"./format.js";export const YEAR_PAGE_SIZE=12;export function makeDate(t,e,r){const n=new Date(0);return n.setFullYear(t,e,r),n.setHours(0,0,0,0),n}export function isValidDate(t){return t instanceof Date&&!Number.isNaN(t.getTime())}export function startOfDay(t){const e=new Date(t.getTime());return e.setHours(0,0,0,0),e}export function startOfMonth(t){return makeDate(t.getFullYear(),t.getMonth(),1)}export function startOfYear(t){return makeDate(t.getFullYear(),0,1)}export function daysInMonth(t,e){return makeDate(t,e+1,0).getDate()}export function today(){return startOfDay(new Date)}export function addDays(t,e){const r=new Date(t.getTime());return r.setDate(r.getDate()+e),r}export function addMonths(t,e){const r=new Date(t.getTime()),n=makeDate(t.getFullYear(),t.getMonth()+e,1);return r.setFullYear(n.getFullYear(),n.getMonth(),Math.min(t.getDate(),daysInMonth(n.getFullYear(),n.getMonth()))),r}export function addYears(t,e){return addMonths(t,12*e)}export function compareDay(t,e){return startOfDay(t).getTime()-startOfDay(e).getTime()}export function isSameDay(t,e){return isValidDate(t)&&isValidDate(e)&&0===compareDay(t,e)}export function isSameMonth(t,e){return isValidDate(t)&&isValidDate(e)&&t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()}export function clampDate(t,e,r){return isValidDate(e)&&t.getTime()<e.getTime()?new Date(e.getTime()):isValidDate(r)&&t.getTime()>r.getTime()?new Date(r.getTime()):t}export function isDayOutside(t,e,r){return!!(isValidDate(e)&&compareDay(t,e)<0)||isValidDate(r)&&compareDay(t,r)>0}export function isMonthOutside(t,e,r){const n=t.getFullYear(),o=t.getMonth();return isDayOutside(makeDate(n,o,daysInMonth(n,o)),e,null)||isDayOutside(makeDate(n,o,1),null,r)}export function isYearOutside(t,e,r){const n=t.getFullYear();return isValidDate(e)&&n<e.getFullYear()||isValidDate(r)&&n>r.getFullYear()}export function secondsOfDay(t){return 3600*t.getHours()+60*t.getMinutes()+t.getSeconds()}export function timeUnitSpan(t,e){const r=secondsOfDay(e);if("hour"===t){const t=3600*Math.floor(r/3600);return[t,t+3599]}if("minute"===t){const t=60*Math.floor(r/60);return[t,t+59]}if("second"===t)return[r,r];const n=e.getHours()<12?0:43200;return[n,n+43200-1]}export function withTime(t,e){const r=new Date(t.getTime());return r.setHours(e.hours??r.getHours(),e.minutes??r.getMinutes(),e.seconds??r.getSeconds(),0),r}export function mergeDateAndTime(t,e){return withTime(startOfDay(t),{hours:e.getHours(),minutes:e.getMinutes(),seconds:e.getSeconds()})}export function calendarWeeks(t,e){const r=startOfMonth(t),n=(r.getDay()-e+7)%7,o=addDays(r,-n);return Array.from({length:6},(t,e)=>Array.from({length:7},(t,r)=>addDays(o,7*e+r)))}export function yearPageStart(t){return t-(t%12+12)%12}export function formatDate(e,r,n){return isValidDate(e)?t(r,n).format(e):""}const e=/* @__PURE__ */Array.from({length:24},(t,e)=>new Date(2027,e%12,21+e%7,e,58,58));export function displaySamples(r,n){const o=t(r,n);return[...new Set(e.map(t=>o.format(t)))]}export function withPlaceholder(t,e){return"string"==typeof e&&""!==e?[...t,e]:t}export function toISODate(t){const pad=t=>String(t).padStart(2,"0");return`${String(t.getFullYear()).padStart(4,"0")}-${pad(t.getMonth()+1)}-${pad(t.getDate())}`}export function toISOMonth(t){return`${String(t.getFullYear()).padStart(4,"0")}-${String(t.getMonth()+1).padStart(2,"0")}`}export function toISOYear(t){return String(t.getFullYear()).padStart(4,"0")}export function toISOTime(t,e=!1){const pad=t=>String(t).padStart(2,"0"),r=`${pad(t.getHours())}:${pad(t.getMinutes())}`;return e?`${r}:${pad(t.getSeconds())}`:r}export function toISODateTime(t,e=!1){return`${toISODate(t)}T${toISOTime(t,e)}`}const r=/* @__PURE__ */makeDate(2021,7,1);export function weekdayLabels(e,n,o="short"){const a=t(e,{weekday:o});return Array.from({length:7},(t,e)=>a.format(addDays(r,(n+e)%7)))}export function monthLabels(e,r="short"){const n=t(e,{month:r});return Array.from({length:12},(t,e)=>n.format(makeDate(2021,e,1)))}export function isMonthBeforeYear(e){const n=t(e,{year:"numeric",month:"long"}).formatToParts(r);return n.findIndex(t=>"month"===t.type)<n.findIndex(t=>"year"===t.type)}export function isHour12(e){const r=t(e,{hour:"numeric"}).resolvedOptions();return r.hourCycle?"h11"===r.hourCycle||"h12"===r.hourCycle:!0===r.hour12}export function meridiemLabels(e){const n=t(e,{hour:"numeric",hour12:!0}),read=t=>{const e=n.formatToParts(withTime(r,{hours:t})).find(t=>"dayPeriod"===t.type);return e?.value??(t<12?"AM":"PM")};return[read(9),read(21)]}export function localeWeekStart(t){try{const e=t??(new Intl.DateTimeFormat).resolvedOptions().locale,r=new Intl.Locale(e),n="function"==typeof r.getWeekInfo?r.getWeekInfo():r.weekInfo;if("number"==typeof n?.firstDay)return n.firstDay%7}catch{}return 0}
+import{dateFormatter as t}from"./format.js";export const YEAR_PAGE_SIZE=12;export function makeDate(t,e,n){const r=new Date(0);return r.setFullYear(t,e,n),r.setHours(0,0,0,0),r}export function isValidDate(t){return t instanceof Date&&!Number.isNaN(t.getTime())}export function startOfDay(t){const e=new Date(t.getTime());return e.setHours(0,0,0,0),e}export function startOfMonth(t){return makeDate(t.getFullYear(),t.getMonth(),1)}export function startOfYear(t){return makeDate(t.getFullYear(),0,1)}export function daysInMonth(t,e){return makeDate(t,e+1,0).getDate()}export function today(){return startOfDay(new Date)}export function addDays(t,e){const n=new Date(t.getTime());return n.setDate(n.getDate()+e),n}export function addMonths(t,e){const n=new Date(t.getTime()),r=makeDate(t.getFullYear(),t.getMonth()+e,1);return n.setFullYear(r.getFullYear(),r.getMonth(),Math.min(t.getDate(),daysInMonth(r.getFullYear(),r.getMonth()))),n}export function addYears(t,e){return addMonths(t,12*e)}export function compareDay(t,e){return startOfDay(t).getTime()-startOfDay(e).getTime()}export function isSameDay(t,e){return isValidDate(t)&&isValidDate(e)&&0===compareDay(t,e)}export function isSameMonth(t,e){return isValidDate(t)&&isValidDate(e)&&t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()}export function clampDate(t,e,n){return isValidDate(e)&&t.getTime()<e.getTime()?new Date(e.getTime()):isValidDate(n)&&t.getTime()>n.getTime()?new Date(n.getTime()):t}export function isDayOutside(t,e,n){return!!(isValidDate(e)&&compareDay(t,e)<0)||isValidDate(n)&&compareDay(t,n)>0}export function isMonthOutside(t,e,n){const r=t.getFullYear(),o=t.getMonth();return isDayOutside(makeDate(r,o,daysInMonth(r,o)),e,null)||isDayOutside(makeDate(r,o,1),null,n)}export function isYearOutside(t,e,n){const r=t.getFullYear();return isValidDate(e)&&r<e.getFullYear()||isValidDate(n)&&r>n.getFullYear()}export function secondsOfDay(t){return 3600*t.getHours()+60*t.getMinutes()+t.getSeconds()}export function timeUnitSpan(t,e){const n=secondsOfDay(e);if("hour"===t){const t=3600*Math.floor(n/3600);return[t,t+3599]}if("minute"===t){const t=60*Math.floor(n/60);return[t,t+59]}if("second"===t)return[n,n];const r=e.getHours()<12?0:43200;return[r,r+43200-1]}export function withTime(t,e){const n=new Date(t.getTime());return n.setHours(e.hours??n.getHours(),e.minutes??n.getMinutes(),e.seconds??n.getSeconds(),0),n}export function clampMoment(t,e,n,r){const o=r?1e3:6e4,floor=t=>withTime(t,{seconds:r?t.getSeconds():0});if(isValidDate(e)&&t.getTime()<e.getTime()){const t=floor(e),r=t.getTime()<e.getTime()?new Date(t.getTime()+o):t;return isValidDate(n)&&r.getTime()>n.getTime()?new Date(e.getTime()):r}if(isValidDate(n)&&t.getTime()>n.getTime()){const t=floor(n);return isValidDate(e)&&t.getTime()<e.getTime()?new Date(n.getTime()):t}return t}export function mergeDateAndTime(t,e){return withTime(startOfDay(t),{hours:e.getHours(),minutes:e.getMinutes(),seconds:e.getSeconds()})}export function calendarWeeks(t,e){const n=startOfMonth(t),r=(n.getDay()-e+7)%7,o=addDays(n,-r);return Array.from({length:6},(t,e)=>Array.from({length:7},(t,n)=>addDays(o,7*e+n)))}export function yearPageStart(t){return t-(t%12+12)%12}export function formatDate(e,n,r){return isValidDate(e)?t(n,r).format(e):""}const e=/* @__PURE__ */[...Array.from({length:24},(t,e)=>new Date(2027,e%12,21+e%7,e,58,58)),new Date(2027,0,22,12,58,58)];export function displaySamples(n,r){const o=t(n,r);return[...new Set(e.map(t=>o.format(t)))]}export function withPlaceholder(t,e){return"string"==typeof e&&""!==e?[...t,e]:t}export function toISODate(t){const pad=t=>String(t).padStart(2,"0");return`${String(t.getFullYear()).padStart(4,"0")}-${pad(t.getMonth()+1)}-${pad(t.getDate())}`}export function toISOMonth(t){return`${String(t.getFullYear()).padStart(4,"0")}-${String(t.getMonth()+1).padStart(2,"0")}`}export function toISOYear(t){return String(t.getFullYear()).padStart(4,"0")}export function toISOTime(t,e=!1){const pad=t=>String(t).padStart(2,"0"),n=`${pad(t.getHours())}:${pad(t.getMinutes())}`;return e?`${n}:${pad(t.getSeconds())}`:n}export function toISODateTime(t,e=!1){return`${toISODate(t)}T${toISOTime(t,e)}`}const n=/* @__PURE__ */makeDate(2021,7,1);export function weekdayLabels(e,r,o="short"){const a=t(e,{weekday:o});return Array.from({length:7},(t,e)=>a.format(addDays(n,(r+e)%7)))}export function monthLabels(e,n="short"){const r=t(e,{month:n});return Array.from({length:12},(t,e)=>r.format(makeDate(2021,e,1)))}export function isMonthBeforeYear(e){const r=t(e,{year:"numeric",month:"long"}).formatToParts(n);return r.findIndex(t=>"month"===t.type)<r.findIndex(t=>"year"===t.type)}export function isHour12(e){const n=t(e,{hour:"numeric"}).resolvedOptions();return n.hourCycle?"h11"===n.hourCycle||"h12"===n.hourCycle:!0===n.hour12}export function meridiemLabels(e){const r=t(e,{hour:"numeric",hour12:!0}),read=t=>{const e=r.formatToParts(withTime(n,{hours:t})).find(t=>"dayPeriod"===t.type);return e?.value??(t<12?"AM":"PM")};return[read(9),read(21)]}export function localeWeekStart(t){try{const e=t??(new Intl.DateTimeFormat).resolvedOptions().locale,n=new Intl.Locale(e),r="function"==typeof n.getWeekInfo?n.getWeekInfo():n.weekInfo;if("number"==typeof r?.firstDay)return r.firstDay%7}catch{}return 0}

package/dist/internal/drag.d.ts

@@ -14,6 +14,22 @@
  * nothing and cost a frame of latency on the one gesture where latency is the
  * whole feel of it.
  */
+/**
+ * The selection, taken for the length of a gesture.
+ *
+ * Written prefixed and through `setProperty` because WebKit implements only
+ * `-webkit-user-select`: `style.userSelect = 'none'` hangs a plain JavaScript
+ * property off the object, changes nothing, and Safari goes on selecting text
+ * through the whole drag. It is taken off the document rather than fixed with
+ * `preventDefault`, which would also stop the browser focusing what was
+ * pressed and leave every mouse press wearing a keyboard focus ring.
+ *
+ * Exported as well as used below, for the gesture that takes the selection at a
+ * moment of its own rather than at the press: `PlScrollZone` waits for the
+ * pointer to pass its threshold, because up to that point the press is still a
+ * click on a card and the reader is still allowed to select the text under it.
+ */
+export declare function takeSelection(): () => void;
 export interface PointerDragOptions {
     /**
      * The element the three listeners go on, and the one the pointer is captured

package/dist/internal/drag.js

@@ -1 +1 @@
-export function beginPointerDrag({target:e,pointerId:t,onMove:n,onEnd:r,selectable:o=!0,mark:s=!0}){const i=o?function takeSelection(){const e=document.body,t=e.style.getPropertyValue("-webkit-user-select");return e.style.setProperty("-webkit-user-select","none"),()=>{t?e.style.setProperty("-webkit-user-select",t):e.style.removeProperty("-webkit-user-select")}}():null;s&&(e.dataset.dragging="true"),e.setPointerCapture?.(t);let a=!0;const release=()=>{a&&(a=!1,e.removeEventListener("pointermove",n),e.removeEventListener("pointerup",end),e.removeEventListener("pointercancel",end),s&&delete e.dataset.dragging,i?.())},end=()=>{release(),r?.()};return e.addEventListener("pointermove",n),e.addEventListener("pointerup",end),e.addEventListener("pointercancel",end),release}
+export function takeSelection(){const e=document.body,t=e.style.getPropertyValue("-webkit-user-select");return e.style.setProperty("-webkit-user-select","none"),()=>{t?e.style.setProperty("-webkit-user-select",t):e.style.removeProperty("-webkit-user-select")}}export function beginPointerDrag({target:e,pointerId:t,onMove:n,onEnd:r,selectable:o=!0,mark:s=!0}){const i=o?takeSelection():null;s&&(e.dataset.dragging="true"),e.setPointerCapture?.(t);let a=!0;const release=()=>{a&&(a=!1,e.removeEventListener("pointermove",n),e.removeEventListener("pointerup",end),e.removeEventListener("pointercancel",end),s&&delete e.dataset.dragging,i?.())},end=()=>{release(),r?.()};return e.addEventListener("pointermove",n),e.addEventListener("pointerup",end),e.addEventListener("pointercancel",end),release}

package/dist/internal/focusable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Every element under `root` that the Tab key could land on, in document order.
+ *
+ * Anything inside an `inert` subtree is left out: it matches the selector and
+ * a browser still refuses to focus it, so handing the focus to one is handing
+ * it to the top of the document.
+ */
+export declare function focusablesIn(root: ParentNode): HTMLElement[];

package/dist/internal/focusable.js

@@ -0,0 +1 @@
+export function focusablesIn(e){return Array.from(e.querySelectorAll('a[href], button:not([disabled]), input:not([disabled]):not([type="hidden"]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])')).filter(e=>!e.closest("[inert]"))}

package/dist/internal/form.d.ts

@@ -0,0 +1,61 @@
+import * as React from 'react';
+/**
+ * How a control whose visible part is not an `<input>` takes part in a form.
+ *
+ * Base UI's `Form` validates, focuses and collects only the controls registered
+ * with a `Field`, and the one public way to register is `Field.Control`, which
+ * is an `<input>` holding a string. A picker's trigger is a button and a file
+ * picker's is a drop zone, so on their own they were invisible to a `PlForm`:
+ * missing from its values, never blocking a submit, and never showing the error
+ * it had for their `name`.
+ *
+ * `FormControl` is that input, kept off screen. It holds the value as a string,
+ * so `required` is the browser's own check, and it hands the focus a form moves
+ * to it on to the control a reader actually uses. What a string cannot carry —
+ * the two ends of a range, several selections, a list of files — is reported to
+ * the `PlForm` around it through `useFormReport`, and `PlForm` lays those over
+ * the values Base UI collected.
+ */
+/** Values reported to a `PlForm` by name, read when the form is submitted. */
+export type FormReport = Map<string, () => unknown>;
+export declare const FormReportContext: React.Context<FormReport | null>;
+/**
+ * Reports `read()` as the value of `name` to the `PlForm` around the caller,
+ * for as long as `enabled` holds. Outside a `PlForm` it does nothing.
+ */
+export declare function useFormReport(name: string | undefined, read: () => unknown, enabled?: boolean): void;
+/**
+ * Whether `element` is inside a disabled `<fieldset>`, re-rendering when a
+ * fieldset around it turns `disabled` on or off.
+ *
+ * The browser disables a native control inside one by itself. A control drawn
+ * as elements with a `tabIndex` is not a form control, so the fieldset never
+ * reaches it and it has to ask. The answer is the platform's: a disabled
+ * fieldset reaches everything inside it except what is in its first `<legend>`.
+ */
+export declare function useFieldsetDisabled(element: Element | null): boolean;
+/**
+ * Tells a `FormControl` the reader has left the control it stands behind, so a
+ * form that validates on blur checks it then. The input never has the focus
+ * itself, so the event it would have had is sent to it.
+ */
+export declare function leaveFormControl(input: HTMLInputElement | null): void;
+export interface FormControlProps {
+    /** The name the value submits under, and the key a form's `errors` use. */
+    name?: string;
+    /**
+     * The value as a form submits it: one string, or one entry per row. An empty
+     * string, a list with an empty entry and an empty list are no value, which is
+     * what `required` checks.
+     */
+    value: string | readonly string[];
+    required: boolean;
+    disabled: boolean;
+    /** The element a reader uses, which takes the focus a form moves here. */
+    standIn: () => HTMLElement | null | undefined;
+}
+/**
+ * The input a `Field` registers for a control that is not one. Renders inside a
+ * `Field.Root`.
+ */
+export declare const FormControl: React.ForwardRefExoticComponent<FormControlProps & React.RefAttributes<HTMLInputElement>>;

package/dist/internal/form.js

@@ -0,0 +1 @@
+import{jsx as e,Fragment as t,jsxs as r}from"react/jsx-runtime";import*as n from"react";import{Field as o}from"@base-ui/react/field";export const FormReportContext=/* @__PURE__ */n.createContext(null);export function useFormReport(e,t,r=!0){const o=n.useContext(FormReportContext),s=n.useRef(t);n.useEffect(()=>{s.current=t}),n.useEffect(()=>{if(!o||!e||!r)return;const entry=()=>s.current();return o.set(e,entry),()=>{o.get(e)===entry&&o.delete(e)}},[o,e,r])}function fieldsetsAround(e){const t=[];for(let r=e.parentElement?.closest("fieldset");r;r=r.parentElement?.closest("fieldset"))t.push(r);return t}export function useFieldsetDisabled(e){const t=n.useCallback(t=>{if(!e)return()=>{};const r=new MutationObserver(t);return fieldsetsAround(e).forEach(e=>r.observe(e,{attributes:!0,attributeFilter:["disabled"]})),()=>r.disconnect()},[e]);return n.useSyncExternalStore(t,()=>null!==e&&fieldsetsAround(e).some(t=>t.disabled&&!t.querySelector(":scope > legend")?.contains(e)),()=>!1)}export function leaveFormControl(e){e?.dispatchEvent(new FocusEvent("focusout",{bubbles:!0}))}export const FormControl=/* @__PURE__ */n.forwardRef(function FormControl({name:n,value:s,required:u,disabled:i,standIn:a},l){const c=Array.isArray(s),d=c?s.length>0&&s.every(e=>""!==e):""!==s;return useFormReport(n,()=>[...s],c&&!i),r(t,{children:[e(o.Control,{ref:l,name:n,value:c?d?s.join("\n"):"":s,required:u,disabled:i,tabIndex:-1,"aria-hidden":"true",autoComplete:"off",className:"pointer-events-none absolute size-px overflow-hidden opacity-0 [clip-path:inset(50%)]",onFocus:()=>a()?.focus(),render:c?t=>e("input",{...t,name:void 0}):void 0}),c&&n?s.map((t,r)=>e("input",{type:"hidden",name:n,value:t,disabled:i},r)):null]})});

package/dist/internal/gallery.d.ts

@@ -1,17 +1,3 @@
-/**
- * The arithmetic a `PlGallery` lays itself out with.
- *
- * It is here rather than in the component for the reason `internal/steps.ts`
- * is: **the Dart build needs the same answers.** A masonry that dealt its
- * columns differently on the two sides would be one gallery with two orders,
- * and the order is the only thing about a masonry a reader can check.
- *
- * Nothing in here measures anything. Every function takes the ratios the caller
- * declared, which is what lets the whole arrangement be right in the first
- * frame the browser paints and stay put as the files arrive — the bargain
- * `PlImage`'s own `ratio` makes, one level up, and the reason a gallery of
- * forty photographs does not reflow forty times.
- */
 /**
  * A tile's proportion as the number the layouts do arithmetic on.
  *
@@ -19,6 +5,23 @@
  * one and this library does not make a caller translate it.
  */
 export declare function ratioOf(value: number | string | undefined, fallback: number): number;
+/**
+ * Whether an item's picture is turned onto its side.
+ *
+ * The gallery and its viewer both ask, so they ask here: a tile laid out on its
+ * side that opened upright, or the other way round, would be one picture shown
+ * two ways.
+ */
+export declare function isTurned(rotate: number | undefined): boolean;
+/**
+ * The proportion an item is shown at: its file's own, or the inverse for a
+ * picture on its side.
+ *
+ * An item's `ratio` stays the stored file's proportion, which is what a caller
+ * has to hand, so every piece of layout arithmetic that runs before anything
+ * loads reads it through this.
+ */
+export declare function shownRatio(ratio: number, rotate: number | undefined): number;
 /**
  * The items dealt into columns, shortest column first.
  *
@@ -32,3 +35,46 @@ export declare function ratioOf(value: number | string | undefined, fallback: nu
  * this run on the server and hold still while the files arrive.
  */
 export declare function dealColumns(ratios: readonly number[], columns: number): number[][];
+/**
+ * One row track of a masonry: a share of the column width, the height of the
+ * captions that end there, or the gap.
+ */
+export type PlassMasonryTrack = number | 'caption' | 'gap';
+/** Where one tile sits in a masonry's grid, as `grid-column` and `grid-row` count. */
+export interface PlassMasonryTile {
+    /** The lane, from 1. */
+    column: number;
+    /** The row line the tile starts on. */
+    start: number;
+    /** The row line it ends on. */
+    end: number;
+}
+/**
+ * The same deal as `dealColumns`, written as the rows of one CSS grid rather
+ * than as a list per lane.
+ *
+ * A list per lane put the document in lane order: Tab went 1, 4, 7 through
+ * twelve pictures in three lanes, and a tile that changed lane when the count
+ * did was a new element, with its picture's state thrown away. Placed in one
+ * grid, every tile stays where it was given and only its placement changes.
+ * The web build needs this and the Dart build does not, because a Flutter
+ * layout is not a document.
+ *
+ * Every edge where a tile ends, in any lane, is a row line. The track up to it
+ * is a share, sized in `fr` by its distance from the edge before, in column
+ * widths. In a grid whose height is its content every `fr` then comes out one
+ * column width long, so a tile spanning its shares is exactly as tall as its
+ * picture. After the share come the captions that end on that edge, in a track
+ * of their own so their height is not spread over the pictures, and then the
+ * gap, when a tile starts there.
+ *
+ * What a stylesheet cannot know is where an edge in one lane falls among the
+ * edges of another once the gaps and captions are added, because that depends
+ * on the width. A tile that runs past the end of a tile in another lane spans
+ * that tile's caption and gap tracks as well, and is that much taller than its
+ * picture.
+ */
+export declare function masonryRows(ratios: readonly number[], columns: number, captions: boolean): {
+    tracks: PlassMasonryTrack[];
+    tiles: PlassMasonryTile[];
+};

package/dist/internal/gallery.js

@@ -1 +1 @@
-export function ratioOf(r,e){if(void 0===r)return e;if("number"==typeof r)return r>0?r:e;const[t,n]=r.split("/"),o=void 0===n?Number(t):Number(t)/Number(n);return Number.isFinite(o)&&o>0?o:e}export function dealColumns(r,e){const t=Array.from({length:e},()=>[]),n=new Array(e).fill(0);return r.forEach((r,o)=>{let u=0;for(let r=1;r<e;r+=1)n[r]<n[u]&&(u=r);t[u].push(o),n[u]+=1/r}),t}
+import{isSideways as t,quartersOf as r}from"./image.js";export function ratioOf(t,r){if(void 0===t)return r;if("number"==typeof t)return t>0?t:r;const[n,o]=t.split("/"),e=void 0===o?Number(n):Number(n)/Number(o);return Number.isFinite(e)&&e>0?e:r}export function isTurned(n){return void 0!==n&&t(r(n))}export function shownRatio(t,r){return isTurned(r)?1/t:t}export function dealColumns(t,r){const n=Array.from({length:r},()=>[]),o=new Array(r).fill(0);return t.forEach((t,e)=>{let s=0;for(let t=1;t<r;t+=1)o[t]<o[s]&&(s=t);n[s].push(e),o[s]+=1/t}),n}export function masonryRows(t,r,n){const o=dealColumns(t,r),e=[],s=[],u=[];o.forEach((r,n)=>{let o=0;r.forEach((i,a)=>{o+=1/t[i],e[i]=n,s[i]=o,u[i]=0===a?-1:r[a-1]})});const i=[],a=[];for(const r of t.map((t,r)=>r).sort((t,r)=>s[t]-s[r]))(0===i.length||s[r]-i[i.length-1]>.001)&&i.push(s[r]),a[r]=i.length-1;const f=new Set(u.filter(t=>-1!==t).map(t=>a[t])),c=[],l=[],p=[];i.forEach((t,r)=>{c.push(t-(0===r?0:i[r-1])),n&&c.push("caption"),l[r]=c.length+1,f.has(r)&&c.push("gap"),p[r]=c.length+1});const h=t.map((t,r)=>({column:e[r]+1,start:-1===u[r]?1:p[a[u[r]]],end:l[a[r]]}));return{tracks:c,tiles:h}}

package/dist/internal/glow.d.ts

@@ -0,0 +1,17 @@
+import type * as React from 'react';
+/**
+ * Moves `.plass-glow`'s light to where the pointer is on the surface.
+ *
+ * Written straight to the element as `--p-mx` and `--p-my` rather than held in
+ * state: it runs at pointer rate, and a `setState` here would re-render the
+ * tree on every mouse move. It also runs while a finger is down, which is what
+ * makes the light follow a drag on a touch screen, where there is no hover and
+ * the `:active` layer does the work.
+ *
+ * `offsetX` and `offsetY` cost nothing, but they are measured from whatever the
+ * pointer is over. On a surface whose own element is under the pointer — a
+ * button, whose icons ignore the pointer — that is the surface, and they are
+ * used as they are. On one that holds other elements the pointer can land on,
+ * the position is read against the surface's own box instead.
+ */
+export declare function followPointer(event: React.PointerEvent<HTMLElement>): void;

package/dist/internal/glow.js

@@ -0,0 +1 @@
+export function followPointer(t){const e=t.currentTarget;let n=t.nativeEvent.offsetX,o=t.nativeEvent.offsetY;if(t.target!==e){const r=e.getBoundingClientRect();n=t.clientX-r.left,o=t.clientY-r.top}e.style.setProperty("--p-mx",`${n}px`),e.style.setProperty("--p-my",`${o}px`)}

package/dist/internal/highlight.js

@@ -1 +1 @@
-const i={bash:()=>import("highlight.js/lib/languages/bash"),c:()=>import("highlight.js/lib/languages/c"),cpp:()=>import("highlight.js/lib/languages/cpp"),csharp:()=>import("highlight.js/lib/languages/csharp"),css:()=>import("highlight.js/lib/languages/css"),dart:()=>import("highlight.js/lib/languages/dart"),diff:()=>import("highlight.js/lib/languages/diff"),dockerfile:()=>import("highlight.js/lib/languages/dockerfile"),go:()=>import("highlight.js/lib/languages/go"),graphql:()=>import("highlight.js/lib/languages/graphql"),ini:()=>import("highlight.js/lib/languages/ini"),java:()=>import("highlight.js/lib/languages/java"),javascript:()=>import("highlight.js/lib/languages/javascript"),json:()=>import("highlight.js/lib/languages/json"),kotlin:()=>import("highlight.js/lib/languages/kotlin"),less:()=>import("highlight.js/lib/languages/less"),lua:()=>import("highlight.js/lib/languages/lua"),makefile:()=>import("highlight.js/lib/languages/makefile"),markdown:()=>import("highlight.js/lib/languages/markdown"),objectivec:()=>import("highlight.js/lib/languages/objectivec"),perl:()=>import("highlight.js/lib/languages/perl"),php:()=>import("highlight.js/lib/languages/php"),plaintext:()=>import("highlight.js/lib/languages/plaintext"),powershell:()=>import("highlight.js/lib/languages/powershell"),python:()=>import("highlight.js/lib/languages/python"),r:()=>import("highlight.js/lib/languages/r"),ruby:()=>import("highlight.js/lib/languages/ruby"),rust:()=>import("highlight.js/lib/languages/rust"),scss:()=>import("highlight.js/lib/languages/scss"),shell:()=>import("highlight.js/lib/languages/shell"),sql:()=>import("highlight.js/lib/languages/sql"),swift:()=>import("highlight.js/lib/languages/swift"),typescript:()=>import("highlight.js/lib/languages/typescript"),xml:()=>import("highlight.js/lib/languages/xml"),yaml:()=>import("highlight.js/lib/languages/yaml")},t={"c++":"cpp",cc:"cpp",cjs:"javascript",console:"bash",cs:"csharp",cts:"typescript",docker:"dockerfile",gql:"graphql",golang:"go",h:"cpp",hpp:"cpp",htm:"xml",html:"xml",js:"javascript",jsx:"javascript",kt:"kotlin",kts:"kotlin",md:"markdown",mdx:"markdown",mjs:"javascript",mm:"objectivec",mts:"typescript",mysql:"sql",node:"javascript",none:"plaintext",objc:"objectivec",plain:"plaintext",posh:"powershell",ps1:"powershell",psql:"sql",py:"python",rb:"ruby",rs:"rust",sh:"bash",svelte:"xml",svg:"xml",text:"plaintext",toml:"ini",ts:"typescript",tsx:"typescript",txt:"plaintext",vue:"xml",yml:"yaml",zsh:"bash"},l=new Map;export function registerLanguage(i,t){const g=i.toLowerCase();l.set(g,t),s.delete(g)}let g=null;const s=new Map;export function canonicalLanguage(i){if(!i)return null;const l=i.trim().toLowerCase();return l?t[l]??l:null}export async function highlight(t,a){let e=s.get(a);e||(e=async function prepare(t){const s=l.get(t),a=s?void 0:i[t];if(!s&&!a)return null;g??=import("highlight.js/lib/core").then(i=>i.default);const e=await g;return s?e.registerLanguage(t,s):e.getLanguage(t)||e.registerLanguage(t,(await a()).default),t}(a).catch(i=>{throw s.delete(a),i}),s.set(a,e));const h=await e;return h&&g?tokenize((await g).highlight(t,{language:h,ignoreIllegals:!0}).value):null}const a={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#x27;":"'"};export function tokenize(i){const t=[[]],l=[],g=/<span class="([^"]*)">|<\/span>/g;let s=0;const push=i=>{if(!i)return;const g=l[l.length-1];i.replace(/&(?:amp|lt|gt|quot|#x27);/g,i=>a[i]).split("\n").forEach((i,l)=>{l>0&&t.push([]),i&&t[t.length-1].push(g?{text:i,token:g}:{text:i})})};for(const t of i.matchAll(g))push(i.slice(s,t.index)),s=t.index+t[0].length,void 0===t[1]?l.pop():l.push(t[1]);return push(i.slice(s)),t}export function plainLines(i){return i.split("\n").map(i=>i?[{text:i}]:[])}
+const i={bash:()=>import("highlight.js/lib/languages/bash"),c:()=>import("highlight.js/lib/languages/c"),cpp:()=>import("highlight.js/lib/languages/cpp"),csharp:()=>import("highlight.js/lib/languages/csharp"),css:()=>import("highlight.js/lib/languages/css"),dart:()=>import("highlight.js/lib/languages/dart"),diff:()=>import("highlight.js/lib/languages/diff"),dockerfile:()=>import("highlight.js/lib/languages/dockerfile"),go:()=>import("highlight.js/lib/languages/go"),graphql:()=>import("highlight.js/lib/languages/graphql"),ini:()=>import("highlight.js/lib/languages/ini"),java:()=>import("highlight.js/lib/languages/java"),javascript:()=>import("highlight.js/lib/languages/javascript"),json:()=>import("highlight.js/lib/languages/json"),kotlin:()=>import("highlight.js/lib/languages/kotlin"),less:()=>import("highlight.js/lib/languages/less"),lua:()=>import("highlight.js/lib/languages/lua"),makefile:()=>import("highlight.js/lib/languages/makefile"),markdown:()=>import("highlight.js/lib/languages/markdown"),objectivec:()=>import("highlight.js/lib/languages/objectivec"),perl:()=>import("highlight.js/lib/languages/perl"),php:()=>import("highlight.js/lib/languages/php"),plaintext:()=>import("highlight.js/lib/languages/plaintext"),powershell:()=>import("highlight.js/lib/languages/powershell"),python:()=>import("highlight.js/lib/languages/python"),r:()=>import("highlight.js/lib/languages/r"),ruby:()=>import("highlight.js/lib/languages/ruby"),rust:()=>import("highlight.js/lib/languages/rust"),scss:()=>import("highlight.js/lib/languages/scss"),shell:()=>import("highlight.js/lib/languages/shell"),sql:()=>import("highlight.js/lib/languages/sql"),swift:()=>import("highlight.js/lib/languages/swift"),typescript:()=>import("highlight.js/lib/languages/typescript"),xml:()=>import("highlight.js/lib/languages/xml"),yaml:()=>import("highlight.js/lib/languages/yaml")},t={"c++":"cpp",cc:"cpp",cjs:"javascript",console:"bash",cs:"csharp",cts:"typescript",docker:"dockerfile",gql:"graphql",golang:"go",h:"cpp",hpp:"cpp",htm:"xml",html:"xml",js:"javascript",jsx:"javascript",kt:"kotlin",kts:"kotlin",md:"markdown",mdx:"markdown",mjs:"javascript",mm:"objectivec",mts:"typescript",mysql:"sql",node:"javascript",none:"plaintext",objc:"objectivec",plain:"plaintext",posh:"powershell",ps1:"powershell",psql:"sql",py:"python",rb:"ruby",rs:"rust",sh:"bash",svelte:"xml",svg:"xml",text:"plaintext",toml:"ini",ts:"typescript",tsx:"typescript",txt:"plaintext",vue:"xml",yml:"yaml",zsh:"bash"},l=new Map;export function registerLanguage(i,t){const g=i.toLowerCase();l.set(g,t),s.delete(g)}let g=null;const s=new Map;export function canonicalLanguage(i){if(!i)return null;const g=i.trim().toLowerCase();return g?l.has(g)?g:t[g]??g:null}export async function highlight(t,a){let e=s.get(a);e||(e=async function prepare(t){const s=l.get(t),a=s?void 0:i[t];if(!s&&!a)return null;g??=import("highlight.js/lib/core").then(i=>i.default);const e=await g;return s?e.registerLanguage(t,s):e.getLanguage(t)||e.registerLanguage(t,(await a()).default),t}(a).catch(i=>{throw s.delete(a),i}),s.set(a,e));const h=await e;return h&&g?tokenize((await g).highlight(t,{language:h,ignoreIllegals:!0}).value):null}const a={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#x27;":"'"};export function tokenize(i){const t=[[]],l=[],g=/<span class="([^"]*)">|<\/span>/g;let s=0;const push=i=>{if(!i)return;const g=l[l.length-1];i.replace(/&(?:amp|lt|gt|quot|#x27);/g,i=>a[i]).split("\n").forEach((i,l)=>{l>0&&t.push([]),i&&t[t.length-1].push(g?{text:i,token:g}:{text:i})})};for(const t of i.matchAll(g))push(i.slice(s,t.index)),s=t.index+t[0].length,void 0===t[1]?l.pop():l.push(t[1]);return push(i.slice(s)),t}export function plainLines(i){return i.split("\n").map(i=>i?[{text:i}]:[])}

package/dist/internal/image.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The arithmetic a `PlImage` turns, mirrors and places its picture with, and the
+ * declarations that draw the turn and the mirror.
+ *
+ * The arithmetic is here rather than in the component for the reason
+ * `internal/gallery.ts` is: **the Dart build needs the same answers.** A turn
+ * that rounded a stray `45` to a different quarter on the two sides would be one
+ * picture lying two different ways, and a crop that kept a different part of it
+ * would be two pictures. The declarations are here because the preview draws
+ * the same turn and mirror from a chunk of its own.
+ */
+import type * as React from 'react';
+/** A turn, as a count of clockwise quarters. */
+export type PlassQuarters = 0 | 1 | 2 | 3;
+/**
+ * Which way a picture is mirrored, along the axes it is shown on.
+ *
+ * Declared here rather than beside the component because the declarations
+ * below are written from it; `PlImageFlip` is this under the component's name.
+ */
+export type PlassImageFlip = 'none' | 'horizontal' | 'vertical' | 'both';
+/**
+ * A turn in degrees as a count of clockwise quarters, whatever number arrived.
+ *
+ * The type holds a TypeScript caller to `0`, `90`, `180` and `270`; this is for
+ * everyone else. `-90` is the `270` it means, `450` is `90`, anything between
+ * two quarters goes to the nearer one, and a number that is not finite is no
+ * turn at all.
+ */
+export declare function quartersOf(degrees: number): PlassQuarters;
+/** Whether a turn puts the picture on its side, swapping its width and height. */
+export declare function isSideways(quarters: PlassQuarters): boolean;
+/**
+ * The turn and the mirror, as the declarations that draw them.
+ *
+ * The individual `rotate` and `scale` properties rather than `transform`, which
+ * leaves `transform` to whoever else wants the picture: an inline `transform`
+ * here would silently beat a hover effect or a class of the caller's own.
+ *
+ * The two compose in a fixed order, and scale comes first: it acts on the
+ * element before the element is turned. So on a quarter turn, a mirror along one
+ * axis of the screen is a mirror along the other axis of the element, and the
+ * two are swapped here rather than making a caller think about it.
+ *
+ * On its side the picture is laid out at the box's height by the box's width
+ * and turned into place, and that is what lets `fit` work at all. `object-fit`
+ * fits the element's own box, and a picture turned inside the box it was given
+ * would overhang it on one axis and fall short on the other. The container
+ * units read the box, which is a size container only while this is the case;
+ * `maxWidth` is cleared because a reset caps an `<img>` at the width of its
+ * parent, and on a tall box that is shorter than the length the turned picture
+ * needs.
+ */
+export declare function poseStyle(quarters: PlassQuarters, flip: PlassImageFlip): React.CSSProperties | null;
+/**
+ * The geometry of a copy of the picture drawn underneath it: the same turn and
+ * mirror, over the same box grown by `bleed` on every side.
+ *
+ * A blur fades to transparent over about two of its radii at the element's
+ * edge, so a blurred copy drawn at the box's own size would show the page
+ * through a soft frame. Grown past the box, it has the fringe clipped off by the
+ * box's `overflow: hidden` instead.
+ */
+export declare function layerStyle(quarters: PlassQuarters, flip: PlassImageFlip, bleed: number): React.CSSProperties;
+/**
+ * A position as the fractions of the free space across and down, or `null` for
+ * anything past the keywords and percentages `PlImagePosition` offers.
+ *
+ * The part of CSS's grammar a caller writes. A keyword says its own axis, a
+ * percentage is across when it comes first and down when it comes second, and
+ * `center` says nothing, which leaves the axis at the middle. A length has no
+ * fraction to turn, so it is `null`.
+ */
+export declare function positionFractions(position: string): [number, number] | null;
+/**
+ * A place on the picture as it is shown, as the same place on the element that
+ * is actually turned and mirrored.
+ *
+ * `object-position` works in the element's own frame, before it is transformed,
+ * so `top` on a picture turned upside down would keep what ends up at the
+ * bottom. The mirror is undone first, because it acts on the axes of the screen
+ * after the turn. Then the turn, a quarter at a time: one quarter clockwise lays
+ * the element's left edge along the top of the screen, so what is across on the
+ * screen was down the element.
+ */
+export declare function elementFractions([shownAcross, shownDown]: readonly [number, number], quarters: PlassQuarters, mirrorAcross: boolean, mirrorDown: boolean): [number, number];
+/**
+ * The `object-position` that keeps `position` where the reader sees it.
+ *
+ * Always written as two percentages rounded to two decimals, which every engine
+ * serialises the same way. A string the parser cannot read is handed through as
+ * it was written.
+ */
+export declare function objectPosition(position: string, quarters: PlassQuarters, flip: PlassImageFlip): string;

package/dist/internal/image.js

@@ -0,0 +1 @@
+export function quartersOf(t){return Number.isFinite(t)?(Math.round(t/90)%4+4)%4:0}export function isSideways(t){return t%2==1}export function poseStyle(t,e){const o="horizontal"===e||"both"===e,n="vertical"===e||"both"===e;if(0===t&&!o&&!n)return null;const[i,r]=isSideways(t)?[n,o]:[o,n];return{scale:i||r?`${i?-1:1} ${r?-1:1}`:void 0,rotate:0===t?void 0:90*t+"deg",...isSideways(t)?{position:"absolute",top:"50%",left:"50%",width:"100cqh",height:"100cqw",maxWidth:"none",translate:"-50% -50%"}:null}}export function layerStyle(t,e,o){const grown=t=>0===o?t:`calc(${t} + ${2*o}px)`;return isSideways(t)?{...poseStyle(t,e),width:grown("100cqh"),height:grown("100cqw")}:{...poseStyle(t,e),position:"absolute",top:-o+"px",left:-o+"px",width:grown("100%"),height:grown("100%"),maxWidth:"none"}}export function positionFractions(t){const e=[.5,.5],o=t.trim().toLowerCase().split(/\s+/);for(let t=0;t<o.length;t+=1){const n=["left","top","right","bottom"].indexOf(o[t]);if(n>=0)e[n%2]=n>1?1:0;else if(/^-?\d*\.?\d+%$/.test(o[t]))e[0===t?0:1]=parseFloat(o[t])/100;else if("center"!==o[t])return null}return e}export function elementFractions([t,e],o,n,i){let r=n?1-t:t,s=i?1-e:e;for(let t=0;t<o;t+=1)[r,s]=[s,1-r];return[r,s]}export function objectPosition(t,e,o){const n=positionFractions(t);if(null===n)return t;const[i,r]=elementFractions(n,e,"horizontal"===o||"both"===o,"vertical"===o||"both"===o),percent=t=>Math.round(1e4*t)/100+"%";return`${percent(i)} ${percent(r)}`}

package/dist/internal/inert.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The value `inert` has to be written with for a given React to put it in the
+ * DOM.
+ *
+ * React 19 knows `inert` as a boolean attribute, writes `true` and drops an
+ * empty string. React 18 does not know it at all: it drops `true` with a warning
+ * and writes a string as it is. A dropped attribute leaves the subtree
+ * focusable and on the accessibility tree, which is exactly what the attribute
+ * was there to stop, and nothing on the page looks any different.
+ */
+export declare function inertValueFor(version: string): true | '';
+/**
+ * `inert` as props to spread onto an element, written the way the running React
+ * keeps it. Nothing at all when the element is not inert, so the attribute is
+ * absent rather than present and false.
+ */
+export declare function inertProps(inert: boolean): {
+    inert?: boolean;
+};

package/dist/internal/inert.js

@@ -0,0 +1 @@
+import*as r from"react";export function inertValueFor(r){return Number.parseInt(r,10)>=19||""}const e=inertValueFor(r.version);export function inertProps(r){return r?{inert:e}:{}}

package/dist/internal/keys.d.ts

@@ -43,11 +43,30 @@ export declare function canonicalKey(token: string): string;
  */
 export interface PlassKeyState {
     key: string;
+    /** The physical key, for when `key` is what a modifier turned it into. */
+    code?: string;
     metaKey: boolean;
     ctrlKey: boolean;
     shiftKey: boolean;
     altKey: boolean;
 }
+/**
+ * Whether the key belongs to text an input method is still composing.
+ *
+ * The Enter that commits a Korean syllable and the Escape that cancels a
+ * Japanese conversion are the input method's keys, not the page's: answering
+ * one fires a binding the reader did not press, and consuming it breaks the
+ * word they were typing. `229` is what a browser reports for such a key where
+ * `isComposing` is not set.
+ */
+export declare function isComposingKey(event: {
+    keyCode?: number;
+    isComposing?: boolean;
+} & {
+    nativeEvent?: {
+        isComposing?: boolean;
+    };
+}): boolean;
 /**
  * Does the chord carry a modifier a reader cannot type?
  *

package/dist/internal/keys.js

@@ -1 +1 @@
-export function detectOS(){if("undefined"==typeof navigator)return"windows";const e=navigator.userAgentData,t=`${e?.platform??""} ${navigator.platform??""} ${navigator.userAgent??""}`;return/mac|iphone|ipad|ipod/i.test(t)?"mac":/win/i.test(t)?"windows":"linux"}export const keyAliases={cmdorctrl:"mod",commandorcontrol:"mod",cmd:"meta",command:"meta",super:"meta",win:"meta",windows:"meta",control:"ctrl",option:"alt",opt:"alt",return:"enter",numpadenter:"enter",esc:"escape",del:"delete",caps:"capslock"};export function canonicalKey(e){const t=e.toLowerCase().replace(/[\s_-]/g,"");return keyAliases[t]??t}const e={up:"arrowup",down:"arrowdown",left:"arrowleft",right:"arrowright",space:" ",plus:"+"};export function hasHardModifier(e){return e.split("+").slice(0,-1).map(canonicalKey).some(e=>"mod"===e||"ctrl"===e||"meta"===e||"alt"===e)}const t=new Set(["enter","backspace","delete","arrowleft","arrowright","arrowup","arrowdown","home","end","pageup","pagedown"]);export function editsText(e){return 1===e.length||t.has(e.toLowerCase())}export function isTypingTarget(e){if(!(e instanceof HTMLElement))return!1;if(e.isContentEditable)return!0;if("TEXTAREA"===e.tagName||"SELECT"===e.tagName)return!0;if("INPUT"===e.tagName){const t=e.type;return!["button","checkbox","color","file","image","radio","range","reset","submit"].includes(t)}return!1}export function matchesHotKey(t,r){const o=r.split("+").map(canonicalKey),a=new Set(o.slice(0,-1)),n=o[o.length-1],i=e[n]??n,c="mac"===detectOS()?t.metaKey:t.ctrlKey;return a.has("mod")===c&&a.has("shift")===t.shiftKey&&a.has("alt")===t.altKey&&!!(a.has("mod")||a.has("ctrl")===t.ctrlKey&&a.has("meta")===t.metaKey)&&t.key.toLowerCase()===i}export function hotKeyHandler(e,t){if(e||t)return r=>{if(t?.(r),e&&!r.defaultPrevented)for(const t of Object.keys(e))if(matchesHotKey(r,t))return r.preventDefault(),r.stopPropagation(),void e[t]()}}
+export function detectOS(){if("undefined"==typeof navigator)return"windows";const e=navigator.userAgentData,t=`${e?.platform??""} ${navigator.platform??""} ${navigator.userAgent??""}`;return/mac|iphone|ipad|ipod/i.test(t)?"mac":/win/i.test(t)?"windows":"linux"}export const keyAliases={cmdorctrl:"mod",commandorcontrol:"mod",cmd:"meta",command:"meta",super:"meta",win:"meta",windows:"meta",control:"ctrl",option:"alt",opt:"alt",return:"enter",numpadenter:"enter",esc:"escape",del:"delete",caps:"capslock"};export function canonicalKey(e){const t=e.toLowerCase().replace(/[\s_-]/g,"");return keyAliases[t]??t}const e={up:"arrowup",down:"arrowdown",left:"arrowleft",right:"arrowright",space:" ",plus:"+"};export function isComposingKey(e){return Boolean(e.nativeEvent?.isComposing??e.isComposing)||229===e.keyCode}export function hasHardModifier(e){return e.split("+").slice(0,-1).map(canonicalKey).some(e=>"mod"===e||"ctrl"===e||"meta"===e||"alt"===e)}const t=new Set(["enter","backspace","delete","arrowleft","arrowright","arrowup","arrowdown","home","end","pageup","pagedown"]);export function editsText(e){return 1===e.length||t.has(e.toLowerCase())}export function isTypingTarget(e){if(!(e instanceof HTMLElement))return!1;if(e.isContentEditable)return!0;if("TEXTAREA"===e.tagName||"SELECT"===e.tagName)return!0;if("INPUT"===e.tagName){const t=e.type;return!["button","checkbox","color","file","image","radio","range","reset","submit"].includes(t)}return!1}export function matchesHotKey(t,o){const n=o.split("+").map(canonicalKey),r=new Set(n.slice(0,-1)),a=n[n.length-1],i=e[a]??a,s="mac"===detectOS()?t.metaKey:t.ctrlKey,c=!(1===i.length&&!/[a-z0-9]/.test(i)&&!r.has("shift"))&&t.shiftKey;if(r.has("mod")!==s)return!1;if(r.has("shift")!==c||r.has("alt")!==t.altKey)return!1;if(!r.has("mod")&&(r.has("ctrl")!==t.ctrlKey||r.has("meta")!==t.metaKey))return!1;const p=t.key.toLowerCase();return p===i||!(!/^[a-z0-9]$/.test(i)||/^[a-z0-9]$/.test(p)||!t.code)&&t.code===(/[a-z]/.test(i)?`Key${i.toUpperCase()}`:`Digit${i}`)}export function hotKeyHandler(e,t){if(e||t)return o=>{if(t?.(o),e&&!o.defaultPrevented&&!isComposingKey(o))for(const t of Object.keys(e))if(matchesHotKey(o,t))return o.preventDefault(),o.stopPropagation(),void e[t]()}}

package/dist/internal/labels.d.ts

@@ -5,6 +5,8 @@ export interface PlassLabels {
     cancel: string;
     /** The other one. */
     confirm: string;
+    /** The one button on a message that only needs to have been read. */
+    acknowledge: string;
     /** Empties a field, a picker, a search. */
     clear: string;
     /** Finishes with a picker, or with a tour. */
@@ -36,6 +38,8 @@ export interface PlassLabels {
     preview: string;
     /** What a list says when it has nothing in it. */
     empty: string;
+    /** Marks a step, or anything else, that may be left out. */
+    optional: string;
     /** The trail's landmark, and the button that opens the steps it folded away. */
     breadcrumb: string;
     breadcrumbExpand: string;
@@ -43,6 +47,9 @@ export interface PlassLabels {
     carousel: string;
     carouselPrevious: string;
     carouselNext: string;
+    /** What a slide is, said after its name: one slide's `aria-roledescription`.
+     * The reel's own is `carousel`. */
+    slide: string;
     /** The wall of pictures' own landmark. */
     gallery: string;
     /** What a drawing of numbers is called when the caller has not named it. */
@@ -56,6 +63,8 @@ export interface PlassLabels {
     commandPalettePlaceholder: string;
     /** What a sheet over the whole page is called when it has no name. */
     overlay: string;
+    /** The region the toasts are announced in. */
+    notifications: string;
     /** The pager's landmark and its four steppers, which move by a page. */
     pagination: string;
     paginationPrevious: string;
@@ -64,8 +73,10 @@ export interface PlassLabels {
     paginationLast: string;
     /** The stars' group. */
     rating: string;
-    /** The panel's landmark, the button that shuts it, and the handle that sizes it. */
+    /** The panel's landmark, the buttons that open and shut it, and the handle
+     * that sizes it. */
     sidebar: string;
+    sidebarOpen: string;
     sidebarClose: string;
     sidebarResize: string;
     /** The first link on a page, which jumps past the furniture. */
@@ -76,6 +87,16 @@ export interface PlassLabels {
     onThisPage: string;
     /** What a chat bubble says while somebody is still writing. */
     typing: string;
+    /** What a chat bubble's mark says about the message it is on. */
+    messageSending: string;
+    messageSent: string;
+    messageDelivered: string;
+    messageRead: string;
+    messageFailed: string;
+    /** What covers a spoiler until it is revealed. */
+    spoilerWarning: string;
+    /** What a file picker's drop zone says when the caller has not said. */
+    filePickerTitle: string;
     /** Read out after a link that leaves the page, and never drawn. */
     newTab: string;
     /** The two columns of a transfer, and the buttons between them. */
@@ -118,6 +139,29 @@ export interface PlassLabels {
     /** Which end of a range the calendar is currently asking for. */
     start: string;
     end: string;
+    /** A page button's name. */
+    paginationPage: (page: number) => string;
+    /** What the pager's live region says once the page has changed. */
+    paginationStatus: (page: number, count: number) => string;
+    /** What one star is called, and a read-only row with a score. The score can
+     * be a fraction, so a pack writes it the way its language writes a number:
+     * `2.5` in English, `2,5` in German. */
+    ratingValue: (value: number, count: number) => string;
+    /** And a read-only row with none. */
+    ratingNone: string;
+    /** One slide's name, which is also its dot's. */
+    carouselSlide: (index: number, count: number) => string;
+    /** Where a picture sits in a gallery: said after a tile's own words, and
+     * drawn as the viewer's counter. */
+    galleryItem: (index: number, total: number) => string;
+    /** A remove button named after what it takes away: a file, a chip. */
+    removeItem: (name: string) => string;
+    /** The row that offers what was typed as a value of its own. */
+    addCustom: (query: string) => string;
+    /** One slot of a code field, named by its place in the row. */
+    otpSlot: (index: number, count: number) => string;
+    /** What a transfer says once rows have moved, given how many and the list. */
+    transferMoved: (count: number, list: string) => string;
 }
 /**
  * English, and the reason the library needs no setup to read.

package/dist/internal/labels.js

@@ -1 +1 @@
-"use client";import*as e from"react";import{useDefaults as a}from"./defaults.js";export const defaultLabels={close:"Close",cancel:"Cancel",confirm:"Confirm",clear:"Clear",done:"Done",skip:"Skip",search:"Search",selectAll:"Select all",selectRow:"Select row",remove:"Remove",dismiss:"Dismiss",open:"Open",previous:"Previous",next:"Next",reveal:"Reveal",hide:"Hide",increase:"Increase",decrease:"Decrease",preview:"Preview",empty:"Nothing here",breadcrumb:"Breadcrumb",breadcrumbExpand:"Show the hidden steps",carousel:"Carousel",carouselPrevious:"Previous slide",carouselNext:"Next slide",commandPalette:"Command palette",commandPalettePlaceholder:"Search commands",gallery:"Gallery",chart:"Chart",minimize:"Minimize",maximize:"Maximize",restore:"Restore",resizeWindow:"Resize window",overlay:"Overlay",pagination:"Pagination",paginationPrevious:"Previous page",paginationNext:"Next page",paginationFirst:"First page",paginationLast:"Last page",rating:"Rating",sidebar:"Sidebar",sidebarClose:"Close sidebar",sidebarResize:"Resize sidebar",skipToContent:"Skip to content",backToTop:"Back to top",onThisPage:"On this page",typing:"Typing…",newTab:"(opens in a new tab)",transferAvailable:"Available",transferSelected:"Selected",transferToSelected:"Move to selected",transferToAvailable:"Move to available",copy:"Copy",copied:"Copied",copyFailed:"Could not copy",raw:"Raw",code:"Code",previousMonth:"Previous month",nextMonth:"Next month",previousYear:"Previous year",nextYear:"Next year",previousYears:"Previous years",nextYears:"Next years",chooseMonth:"Choose a month",chooseYear:"Choose a year",today:"Today",thisMonth:"This month",thisYear:"This year",now:"Now",hour:"Hour",minute:"Minute",second:"Second",meridiem:"AM/PM",start:"Start",end:"End"};export function useLabels(){const{labels:o}=a();return e.useMemo(()=>o?{...defaultLabels,...o}:defaultLabels,[o])}
+"use client";import*as e from"react";import{useDefaults as a}from"./defaults.js";export const defaultLabels={close:"Close",cancel:"Cancel",confirm:"Confirm",acknowledge:"OK",clear:"Clear",done:"Done",skip:"Skip",search:"Search",selectAll:"Select all",selectRow:"Select row",remove:"Remove",dismiss:"Dismiss",open:"Open",previous:"Previous",next:"Next",reveal:"Reveal",hide:"Hide",increase:"Increase",decrease:"Decrease",preview:"Preview",empty:"Nothing here",optional:"Optional",breadcrumb:"Breadcrumb",breadcrumbExpand:"Show the hidden steps",carousel:"Carousel",carouselPrevious:"Previous slide",carouselNext:"Next slide",slide:"slide",commandPalette:"Command palette",commandPalettePlaceholder:"Search commands",gallery:"Gallery",chart:"Chart",minimize:"Minimize",maximize:"Maximize",restore:"Restore",resizeWindow:"Resize window",overlay:"Overlay",notifications:"Notifications",pagination:"Pagination",paginationPrevious:"Previous page",paginationNext:"Next page",paginationFirst:"First page",paginationLast:"Last page",rating:"Rating",sidebar:"Sidebar",sidebarOpen:"Open sidebar",sidebarClose:"Close sidebar",sidebarResize:"Resize sidebar",skipToContent:"Skip to content",backToTop:"Back to top",onThisPage:"On this page",typing:"Typing…",messageSending:"Sending",messageSent:"Sent",messageDelivered:"Delivered",messageRead:"Read",messageFailed:"Not delivered",spoilerWarning:"This may contain spoilers",filePickerTitle:"Drop files here, or click to browse",newTab:"(opens in a new tab)",transferAvailable:"Available",transferSelected:"Selected",transferToSelected:"Move to selected",transferToAvailable:"Move to available",copy:"Copy",copied:"Copied",copyFailed:"Could not copy",raw:"Raw",code:"Code",previousMonth:"Previous month",nextMonth:"Next month",previousYear:"Previous year",nextYear:"Next year",previousYears:"Previous years",nextYears:"Next years",chooseMonth:"Choose a month",chooseYear:"Choose a year",today:"Today",thisMonth:"This month",thisYear:"This year",now:"Now",hour:"Hour",minute:"Minute",second:"Second",meridiem:"AM/PM",start:"Start",end:"End",paginationPage:e=>`Page ${e}`,paginationStatus:(e,a)=>`Page ${e} of ${a}`,ratingValue:(e,a)=>`${e.toLocaleString("en")} out of ${a}`,ratingNone:"No rating",carouselSlide:(e,a)=>`Slide ${e} of ${a}`,galleryItem:(e,a)=>`${e} of ${a}`,removeItem:e=>`Remove ${e}`,addCustom:e=>`Add “${e}”`,otpSlot:(e,a)=>`Character ${e} of ${a}`,transferMoved:(e,a)=>`${e} ${1===e?"item":"items"} moved to ${a}`};export function useLabels(){const{labels:o}=a();return e.useMemo(()=>o?{...defaultLabels,...o}:defaultLabels,[o])}

package/dist/internal/link.d.ts

@@ -16,3 +16,20 @@
  * that can drift, and the one that drifts is the one nobody reads.
  */
 export declare function safeRel(target: string | undefined, rel: string | undefined): string | undefined;
+/**
+ * Whether an address is one this library will point an `href` at.
+ *
+ * Relative addresses pass, and so do `http`, `https` and `mailto`. Everything
+ * else is turned down, which in practice means `javascript:` — an address that
+ * runs code instead of going somewhere. React 19 refuses to write one, but the
+ * peer range starts at React 18, which only warns and then writes it.
+ *
+ * The test is done on the address with tabs and line breaks taken out and the
+ * leading control characters and spaces trimmed, because that is the address the
+ * browser navigates to: a tab written into the middle of a scheme is gone by the
+ * time it counts. Only the scheme is read, so the rest is handed back untouched.
+ *
+ * Here beside `safeRel` for the same reason that one is here: which addresses a
+ * component will follow is one decision, and it belongs in one place.
+ */
+export declare function safeHref(href: string | undefined): string | undefined;

package/dist/internal/link.js

@@ -1 +1 @@
-export function safeRel(e,n){return void 0===e||""===e||"_self"===e?n:[...new Set([...(n??"").split(/\s+/).filter(Boolean),"noopener","noreferrer"])].join(" ")}
+export function safeRel(e,t){return void 0===e||""===e||"_self"===e?t:[...new Set([...(t??"").split(/\s+/).filter(Boolean),"noopener","noreferrer"])].join(" ")}const e=new Set(["http:","https:","mailto:"]),t=/^[a-z][a-z0-9+.-]*:/i;export function safeHref(r){if(void 0===r)return;const n=r.replace(/[\t\n\r]/g,"").replace(/^[\0- ]+/,""),o=t.exec(n);return null===o||e.has(o[0].toLowerCase())?r:void 0}