material-plus-ui 1.6.0 → 1.8.0

package/dist/internal/data-table.d.ts

@@ -0,0 +1,195 @@
+/**
+ * The arithmetic an `MPDataTable` is made of.
+ *
+ * Here rather than in the component for the reason `internal/mockup.tsx` gives:
+ * a component whose interesting fifty lines are buried in machinery is a
+ * component nobody can read. Ranking two rows, cutting a page out of a list,
+ * working out which rows a Shift-click covers and escaping a comma so a
+ * spreadsheet does not shift a column are four questions with plain answers, and
+ * a file that also has to draw a resize handle is not where they can be found.
+ *
+ * There is no React in this file and nothing in it knows what a column is.
+ * Everything takes plain values and returns plain values, which is also what
+ * makes it the half of the component that can be tested without a browser.
+ */
+/** Which way a column runs when it is sorted. */
+export type MPSortDirection = 'asc' | 'desc';
+/** One key of the sort, and its direction. A sort is a list of these. */
+export interface MPDataTableSort {
+    /** The column's `key`. */
+    key: string;
+    direction: MPSortDirection;
+}
+/**
+ * The default comparison, for the columns that do not bring one.
+ *
+ * Empty sorts last in **both** directions, which is the one asymmetry here and
+ * the one every spreadsheet has: a blank is not the smallest value, it is the
+ * absence of one, and a descending sort whose first screen is forty blanks has
+ * answered a question nobody asked.
+ *
+ * Numbers compare as numbers, dates as instants, booleans with `false` first,
+ * and everything else through the collator — which is `numeric`, so `item2`
+ * comes before `item10` rather than after it.
+ */
+export declare function compareValues(a: unknown, b: unknown, collator: Intl.Collator, descending?: boolean): number;
+/**
+ * Sorts by every key at once, the first key outermost.
+ *
+ * The sort is **stable** — `Array.prototype.sort` has been since ES2019 — which
+ * is what makes a multi-key sort composable: sorting by name and then adding
+ * date to the end of the list leaves rows with the same date in name order,
+ * because that is the order they were already in.
+ *
+ * **The direction goes to `comparatorFor` rather than being applied to what it
+ * hands back.** A machine that reversed the result would reverse everything in
+ * it, and a comparison has parts that must not turn over — an empty cell sorts
+ * last whichever way the column runs. Who reverses what is a policy, and this
+ * function has none.
+ *
+ * `comparatorFor` answers `null` for a key no column claims, so a sort left over
+ * from a column that has since gone is skipped rather than throwing.
+ */
+export declare function sortRows<T>(rows: readonly T[], sort: readonly MPDataTableSort[], comparatorFor: (key: string, direction: MPSortDirection) => ((a: T, b: T) => number) | null): T[];
+/**
+ * What pressing a heading does, given what the sort already says.
+ *
+ * Three states rather than two — ascending, descending, unsorted — because the
+ * order the rows arrived in is a state a reader cannot get back to by pressing
+ * anything if the cycle only has two. That is the opposite of the choice
+ * `MPTreeView`'s single select makes, and for the same reason read the other
+ * way: there, "nothing chosen" is reachable by pressing something else; here it
+ * is not.
+ *
+ * `additive` is what a Shift-press sets. It leaves the column where it already
+ * is in the list rather than moving it to the end, so flipping the second key of
+ * a two-key sort does not quietly make it the first.
+ */
+export declare function nextSort(current: readonly MPDataTableSort[], key: string, additive: boolean): MPDataTableSort[];
+/** Where one page starts and stops, and how many there are. */
+export interface MPPageBounds {
+    /** How many pages the rows come to. Never below `1`. */
+    pages: number;
+    /** The page actually shown, clamped into range. */
+    page: number;
+    /** Index of the first row on it. */
+    start: number;
+    /** One past the last. */
+    end: number;
+}
+/**
+ * The page arithmetic, with the clamp in it.
+ *
+ * The clamp is the whole reason this is a function rather than two expressions
+ * at the call site. A search that cuts a twenty-page table to three leaves the
+ * caller's `page` at fourteen, and a table that answers with an empty screen has
+ * told the reader their search found nothing. The page moves to the last one
+ * that exists instead.
+ */
+export declare function pageBounds(total: number, page: number, pageSize: number): MPPageBounds;
+/**
+ * Every key between two, inclusive, in the order the rows are currently in.
+ *
+ * "Currently" is the point. A Shift-press chooses what the reader can see
+ * between the two rows they pressed, so the range is taken from the sorted,
+ * searched order rather than from the order `items` arrived in — otherwise
+ * shift-pressing two adjacent rows of a sorted table would take in every row
+ * that happens to lie between them in the original array.
+ *
+ * Which of the two keys is the anchor does not matter: dragging up covers the
+ * same rows as dragging down. A key that is no longer in the list — a row the
+ * current search hides — yields nothing rather than the range from one end that
+ * an index of `-1` would quietly produce.
+ */
+export declare function keysBetween(order: readonly string[], from: string, to: string): string[];
+/**
+ * A value as something a query can be matched against.
+ *
+ * `toLocaleLowerCase` and nothing else, which is the fold `MPCombobox`,
+ * `MPCommandPalette` and `MPTreeSelect` already use. A collator that knew about
+ * diacritics would be a second answer to a question this library has answered
+ * one way — and a reader who has learned what the search box in one part of a
+ * product does should not have learned the wrong thing about the rest of it.
+ *
+ * A `Date` is deliberately not formatted. What a reader sees in a cell came out
+ * of the caller's own `render`, and guessing a format the search would agree
+ * with is how a table ends up not finding a date that is on the screen. A column
+ * whose dates should be searchable gives them a `value`.
+ */
+export declare function searchText(value: unknown): string;
+/** Every string a row can be found by, folded once and joined into one haystack. */
+export declare function searchHaystack(values: readonly unknown[]): string;
+/**
+ * One field, quoted only when it has to be, and defused when a spreadsheet would
+ * otherwise run it.
+ *
+ * The escaping is the whole job here and getting it wrong is silent: a comma
+ * inside a cell shifts every column after it by one, and nobody notices until a
+ * spreadsheet somewhere is off by a column. RFC 4180 is four rules and all four
+ * are in these six lines — a field is quoted if it holds the separator, a quote
+ * or a line break, and a quote inside a quoted field is written twice.
+ *
+ * ## Why a leading apostrophe
+ *
+ * RFC 4180 has nothing to say about the second problem, which is that a
+ * spreadsheet does not read a CSV as data. A cell that begins `=` or `@` or `+`
+ * is a **formula**, and `=HYPERLINK("https://…"&A1)` in a table of things other
+ * people typed is one click from posting a colleague's row to somebody else's
+ * server. It is the reader's own spreadsheet that runs it, so nothing this
+ * library does at render time can reach it — the file is where it has to be
+ * stopped.
+ *
+ * An apostrophe in front is the answer Excel, Sheets and LibreOffice all
+ * understand: it is their own marker for "the rest of this is text", and all
+ * three strip it on the way in. It is not free. A plain CSV parser — `pandas`,
+ * a `csv` module, a database loader — has no such rule and will see the
+ * apostrophe as part of the value, which is why `escapeFormulas` exists: a file
+ * going to a machine rather than to a person is a file nobody is going to open
+ * in a spreadsheet, and it should go out byte for byte.
+ *
+ * `null` and `undefined` are empty rather than the words "null" and "undefined",
+ * which is what `String()` would put in the cell.
+ */
+export declare function csvField(value: unknown, separator: string, escapeFormulas?: boolean): string;
+export interface MPCsvOptions {
+    /** What goes between fields. `;` for the locales whose spreadsheets expect it. */
+    separator?: string;
+    /**
+     * Writes a byte-order mark in front.
+     *
+     * On by default, and not as a nicety: Excel reads a UTF-8 CSV without one as
+     * the local code page, so every non-ASCII name in the file arrives as
+     * mojibake. Every other reader ignores the mark.
+     */
+    bom?: boolean;
+    /**
+     * Puts an apostrophe in front of a cell a spreadsheet would otherwise run as a
+     * formula.
+     *
+     * On by default, because the rows in a table are usually things other people
+     * typed and the file is usually going to be opened in a spreadsheet — which is
+     * the pair that makes a cell beginning `=` an attack rather than a curiosity.
+     * A number keeps its sign either way; `csvField` has the whole argument.
+     *
+     * Turn it off for a file going to a parser rather than to a person, where the
+     * apostrophe would arrive as part of the value.
+     * @default true
+     */
+    escapeFormulas?: boolean;
+}
+/** Rows of already-stringable values, as one CSV document. */
+export declare function toCsv(rows: readonly (readonly unknown[])[], options?: MPCsvOptions): string;
+/**
+ * Hands the file to the browser.
+ *
+ * A `blob:` URL and a synthesised press, which is the only way a page can
+ * produce a file the reader keeps. The URL is released on the next frame rather
+ * than straight away: some browsers have not finished reading it when the press
+ * returns, and releasing it too early is a download that silently produces
+ * nothing.
+ */
+export declare function downloadText(text: string, fileName: string, type: string): void;
+/** How wide a column is when neither the caller nor a drag has said. */
+export declare const DEFAULT_COLUMN_WIDTH = 160;
+/** How narrow a drag may make one. Below this the heading is a single letter. */
+export declare const MIN_COLUMN_WIDTH = 48;

package/dist/internal/data-table.js

@@ -0,0 +1 @@
+export function compareValues(e,t,n,o=!1){const r=null==e||""===e,i=null==t||""===t;if(r||i)return r&&i?0:r?1:-1;const a=o?-1:1;return"number"==typeof e&&"number"==typeof t?Number.isNaN(e)||Number.isNaN(t)?Number.isNaN(e)&&Number.isNaN(t)?0:Number.isNaN(e)?1:-1:a*(e-t):"boolean"==typeof e&&"boolean"==typeof t?a*(Number(e)-Number(t)):e instanceof Date&&t instanceof Date?a*(e.getTime()-t.getTime()):a*n.compare(String(e),String(t))}export function sortRows(e,t,n){const o=[];for(const e of t){const t=n(e.key,e.direction);t&&o.push(t)}return 0===o.length?e:[...e].sort((e,t)=>{for(const n of o){const o=n(e,t);if(0!==o)return o}return 0})}export function nextSort(e,t,n){const o=e.find(e=>e.key===t),r=void 0===o?"asc":"asc"===o.direction?"desc":null;return n?null===r?e.filter(e=>e.key!==t):void 0===o?[...e,{key:t,direction:r}]:e.map(e=>e.key===t?{key:t,direction:r}:e):null===r?[]:[{key:t,direction:r}]}export function pageBounds(e,t,n){const o=Math.max(1,Math.floor(n)),r=Math.max(1,Math.ceil(e/o)),i=Math.min(Math.max(Math.floor(t),1),r),a=(i-1)*o;return{pages:r,page:i,start:a,end:Math.min(a+o,e)}}export function keysBetween(e,t,n){const o=e.indexOf(t),r=e.indexOf(n);return-1===o||-1===r?[]:e.slice(Math.min(o,r),Math.max(o,r)+1)}export function searchText(e){return null==e||"object"==typeof e?"":String(e).toLocaleLowerCase()}export function searchHaystack(e){return e.map(searchText).join("\0")}const e=/^[=+\-@\t\r]/,t=/^[+-]?[\d.,\u00a0\u202f ]*\d[\d.,\u00a0\u202f ]*$/;export function csvField(n,o,r=!0){if(null==n)return"";const i=n instanceof Date?n.toISOString():"object"==typeof n?JSON.stringify(n):String(n),a=r&&function(n){return!!e.test(n)&&!t.test(n)&&!Number.isFinite(Number(n))}(i)?`'${i}`:i;return/["\r\n]/.test(a)||a.includes(o)?`"${a.replaceAll('"','""')}"`:a}export function toCsv(e,t={}){const{separator:n=",",bom:o=!0,escapeFormulas:r=!0}=t,i=e.map(e=>e.map(e=>csvField(e,n,r)).join(n)).join("\r\n");return o?`\ufeff${i}`:i}export function downloadText(e,t,n){const o=URL.createObjectURL(new Blob([e],{type:n})),r=document.createElement("a");r.href=o,r.download=t,r.rel="noopener",r.style.display="none",document.body.append(r),r.click(),r.remove(),requestAnimationFrame(()=>URL.revokeObjectURL(o))}export const DEFAULT_COLUMN_WIDTH=160;export const MIN_COLUMN_WIDTH=48;

package/dist/internal/date.d.ts

@@ -54,10 +54,6 @@ export declare function isValidDate(value: unknown): value is Date;
 export declare function startOfDay(date: Date): Date;
 /** The first day of the month this date is in, at midnight. */
 export declare function startOfMonth(date: Date): Date;
-/** The first day of the year this date is in, at midnight. */
-export declare function startOfYear(date: Date): Date;
-/** How many days a month has, leap years included. */
-export declare function daysInMonth(year: number, month: number): number;
 /**
  * The first instant of the day, month or year a date falls in.
  *
@@ -68,8 +64,6 @@ export declare function daysInMonth(year: number, month: number): number;
  * another.
  */
 export declare function startOfUnit(date: Date, unit: MPCalendarView): Date;
-/** The last day of that same unit, at midnight — the other end of its span. */
-export declare function endOfUnit(date: Date, unit: MPCalendarView): Date;
 /** Today, at midnight. The one place the pickers read the clock for a *date*. */
 export declare function today(): Date;
 export declare function addDays(date: Date, amount: number): Date;
@@ -146,7 +140,14 @@ export declare function mergeDateAndTime(date: Date, time: Date): Date;
 export declare function calendarWeeks(month: Date, weekStartsOn: MPWeekday): Date[][];
 /** The first year on the page a given year falls on. 2026 → 2016 at 12 a page. */
 export declare function yearPageStart(year: number): number;
-/** A memoised `Intl.DateTimeFormat`. `undefined` locale means the runtime's own. */
+/**
+ * A memoised `Intl.DateTimeFormat`. `undefined` locale means the runtime's own.
+ *
+ * The cache itself lives in `internal/intl.ts`, along with the bound it keeps
+ * and the two other `Intl` constructors the library asks for. This name stays
+ * because it is what the pickers call and because it says which formatter is
+ * meant, but it is now the shared cache underneath rather than a second one.
+ */
 export declare function dateFormatter(locale: string | undefined, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
 /** Formats a date, tolerating the `null` a cleared picker holds. */
 export declare function formatDate(date: Date | null | undefined, locale: string | undefined, options: Intl.DateTimeFormatOptions): string;
@@ -185,6 +186,20 @@ export declare function withPlaceholder(samples: string[], placeholder: unknown)
 export declare function toISOYear(date: Date): string;
 export declare function toISOMonth(date: Date): string;
 export declare function toISODate(date: Date): string;
+/**
+ * The spelling a given precision submits, as a table to look up.
+ *
+ * `MPCalendar` and `MPDatePicker` each kept this, identically, and each said in
+ * its own comment that the two had to agree — which is the argument for there
+ * being one of it. A calendar and a picker that submitted the same day two
+ * different ways would be two answers to one question.
+ *
+ * `YYYY-MM-DD` and `YYYY-MM` are what `<input type="date">` and
+ * `<input type="month">` submit. A year on its own has no input type behind it
+ * and is simply `YYYY` — the same string with the parts nobody chose taken off,
+ * rather than a day the server would have to know to ignore.
+ */
+export declare const TO_ISO: Record<MPDatePrecision, (date: Date) => string>;
 export declare function toISOTime(date: Date, withSeconds?: boolean): string;
 export declare function toISODateTime(date: Date, withSeconds?: boolean): string;
 /**
@@ -209,18 +224,7 @@ export declare function monthLabels(locale: string | undefined, month?: 'short'
  * it is wrong for.
  */
 export declare function isMonthBeforeYear(locale: string | undefined): boolean;
-/** Does this locale put a clock on a 12-hour dial? */
 export declare function isHour12(locale: string | undefined): boolean;
 /** What this locale calls AM and PM. */
 export declare function meridiemLabels(locale: string | undefined): [string, string];
-/**
- * Which day the week starts on here — Sunday in the US and Korea, Monday across
- * most of Europe, Saturday in much of the Middle East.
- *
- * `Intl.Locale`'s week info is the right source and is also the least evenly
- * implemented corner of `Intl`: it is a getter in some engines, a method in
- * others, and absent in the rest. All three are handled, and the fallback is
- * Sunday rather than a throw — a calendar that renders starting on the wrong day
- * is a small annoyance, and a calendar that renders nothing is not.
- */
 export declare function localeWeekStart(locale: string | undefined): MPWeekday;

package/dist/internal/date.js

@@ -1 +1 @@
-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 startOfUnit(t,e){return"year"===e?startOfYear(t):"month"===e?startOfMonth(t):startOfDay(t)}export function endOfUnit(t,e){return"year"===e?makeDate(t.getFullYear(),11,31):"month"===e?makeDate(t.getFullYear(),t.getMonth()+1,0):startOfDay(t)}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 isDayOutside(t,e,r){return!!(isValidDate(e)&&compareDay(t,e)<0)||isValidDate(r)&&compareDay(t,r)>0}export function isUnitOutside(t,e,r,n){return"day"===e?isDayOutside(t,r,n):!!(isValidDate(r)&&compareDay(endOfUnit(t,e),r)<0)||isValidDate(n)&&compareDay(startOfUnit(t,e),n)>0}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}function t(t,e,r){if(t.set(e,r),t.size>64){const e=t.keys().next();e.done||t.delete(e.value)}return r}const e=new Map;export function dateFormatter(r,n){const o=`${r??""}\0${JSON.stringify(n)}`,a=e.get(o);return a||t(e,o,new Intl.DateTimeFormat(r,n))}export function formatDate(t,e,r){return isValidDate(t)?dateFormatter(e,r).format(t):""}const r=Array.from({length:24},(t,e)=>new Date(2027,e%12,21+e%7,e,58,58));export function displaySamples(t,e){const n=dateFormatter(t,e);return[...new Set(r.map(t=>n.format(t)))]}export function withPlaceholder(t,e){return"string"==typeof e&&""!==e?[...t,e]:t}export function toISOYear(t){return String(t.getFullYear()).padStart(4,"0")}export function toISOMonth(t){return`${toISOYear(t)}-${String(t.getMonth()+1).padStart(2,"0")}`}export function toISODate(t){return`${toISOMonth(t)}-${String(t.getDate()).padStart(2,"0")}`}export function toISOTime(t,e=!1){const r=t=>String(t).padStart(2,"0"),n=`${r(t.getHours())}:${r(t.getMinutes())}`;return e?`${n}:${r(t.getSeconds())}`:n}export function toISODateTime(t,e=!1){return`${toISODate(t)}T${toISOTime(t,e)}`}const n=makeDate(2021,7,1),o=new Map;export function weekdayLabels(e,r,a="narrow"){const i=`w ${e??""} ${r} ${a}`,u=o.get(i);if(u)return u;const s=dateFormatter(e,{weekday:a});return t(o,i,Array.from({length:7},(t,e)=>s.format(addDays(n,(r+e)%7))))}export function monthLabels(e,r="short"){const n=`m ${e??""} ${r}`,a=o.get(n);if(a)return a;const i=dateFormatter(e,{month:r});return t(o,n,Array.from({length:12},(t,e)=>i.format(makeDate(2021,e,1))))}export function isMonthBeforeYear(t){const e=dateFormatter(t,{year:"numeric",month:"long"}).formatToParts(n);return e.findIndex(t=>"month"===t.type)<e.findIndex(t=>"year"===t.type)}export function isHour12(t){const e=dateFormatter(t,{hour:"numeric"}).resolvedOptions();return e.hourCycle?"h11"===e.hourCycle||"h12"===e.hourCycle:!0===e.hour12}export function meridiemLabels(t){const e=dateFormatter(t,{hour:"numeric",hour12:!0}),r=t=>{const r=e.formatToParts(withTime(n,{hours:t})).find(t=>"dayPeriod"===t.type);return r?.value??(t<12?"AM":"PM")};return[r(9),r(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{dateTimeFormatter as t,remember as e}from"./intl.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 startOfUnit(t,e){return"year"===e?function(t){return makeDate(t.getFullYear(),0,1)}(t):"month"===e?startOfMonth(t):startOfDay(t)}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);var o,a;return r.setFullYear(n.getFullYear(),n.getMonth(),Math.min(t.getDate(),(o=n.getFullYear(),a=n.getMonth(),makeDate(o,a+1,0).getDate()))),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 isDayOutside(t,e,r){return!!(isValidDate(e)&&compareDay(t,e)<0)||isValidDate(r)&&compareDay(t,r)>0}export function isUnitOutside(t,e,r,n){return"day"===e?isDayOutside(t,r,n):!!(isValidDate(r)&&compareDay(function(t,e){return"year"===e?makeDate(t.getFullYear(),11,31):"month"===e?makeDate(t.getFullYear(),t.getMonth()+1,0):startOfDay(t)}(t,e),r)<0)||isValidDate(n)&&compareDay(startOfUnit(t,e),n)>0}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 dateFormatter(e,r){return t(e,r)}export function formatDate(t,e,r){return isValidDate(t)?dateFormatter(e,r).format(t):""}const r=Array.from({length:24},(t,e)=>new Date(2027,e%12,21+e%7,e,58,58));export function displaySamples(t,e){const n=dateFormatter(t,e);return[...new Set(r.map(t=>n.format(t)))]}export function withPlaceholder(t,e){return"string"==typeof e&&""!==e?[...t,e]:t}export function toISOYear(t){return String(t.getFullYear()).padStart(4,"0")}export function toISOMonth(t){return`${toISOYear(t)}-${String(t.getMonth()+1).padStart(2,"0")}`}export function toISODate(t){return`${toISOMonth(t)}-${String(t.getDate()).padStart(2,"0")}`}export const TO_ISO={day:toISODate,month:toISOMonth,year:toISOYear};export function toISOTime(t,e=!1){const r=t=>String(t).padStart(2,"0"),n=`${r(t.getHours())}:${r(t.getMinutes())}`;return e?`${n}:${r(t.getSeconds())}`:n}export function toISODateTime(t,e=!1){return`${toISODate(t)}T${toISOTime(t,e)}`}const n=makeDate(2021,7,1),o=new Map;export function weekdayLabels(t,r,a="narrow"){const i=`w ${t??""} ${r} ${a}`,u=o.get(i);if(u)return u;const s=dateFormatter(t,{weekday:a});return e(o,i,Array.from({length:7},(t,e)=>s.format(addDays(n,(r+e)%7))))}export function monthLabels(t,r="short"){const n=`m ${t??""} ${r}`,a=o.get(n);if(a)return a;const i=dateFormatter(t,{month:r});return e(o,n,Array.from({length:12},(t,e)=>i.format(makeDate(2021,e,1))))}export function isMonthBeforeYear(t){const e=dateFormatter(t,{year:"numeric",month:"long"}).formatToParts(n);return e.findIndex(t=>"month"===t.type)<e.findIndex(t=>"year"===t.type)}const a=new Map;export function isHour12(t){const r=t??"",n=a.get(r);if(void 0!==n)return n;const o=dateFormatter(t,{hour:"numeric"}).resolvedOptions(),i=o.hourCycle?"h11"===o.hourCycle||"h12"===o.hourCycle:!0===o.hour12;return e(a,r,i)}export function meridiemLabels(t){const e=dateFormatter(t,{hour:"numeric",hour12:!0}),r=t=>{const r=e.formatToParts(withTime(n,{hours:t})).find(t=>"dayPeriod"===t.type);return r?.value??(t<12?"AM":"PM")};return[r(9),r(21)]}const i=new Map;export function localeWeekStart(t){const r=t??"",n=i.get(r);return void 0!==n?n:e(i,r,function(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}(t))}

package/dist/internal/density.d.ts

@@ -0,0 +1,9 @@
+import type { MPDensity, MPSize } from '../types.js';
+/** The control height at a rung, tightened by a density step. */
+export declare function controlHeight(size: MPSize, density?: MPDensity): string;
+/** The room inside a sheet at a rung, tightened by a density step. */
+export declare function sheetPad(size: MPSize, density?: MPDensity): string;
+/** The same, sideways only. */
+export declare function sheetPadX(size: MPSize, density?: MPDensity): string;
+/** And the other axis. */
+export declare function sheetPadY(size: MPSize, density?: MPDensity): string;

package/dist/internal/density.js

@@ -0,0 +1 @@
+import{CONTROL_HEIGHT as p,SHEET_PAD as x,SHEET_PAD_X as t,SHEET_PAD_Y as h}from"./scale.js";const e={xs:["h-7","h-6","h-6"],sm:["h-9","h-8","h-7"],md:["h-13","h-12","h-11"],lg:["h-15","h-14","h-13"],xl:["h-17","h-16","h-15"]};export function controlHeight(x,t=0){return 0===t?p[x]:e[x][-t-1]}const n={xs:["p-2","p-1.5","p-1.5"],sm:["p-2.5","p-2","p-1.5"],md:["p-3.5","p-3","p-2.5"],lg:["p-4.5","p-4","p-3.5"],xl:["p-5.5","p-5","p-4.5"]},r={xs:["px-2","px-1.5","px-1.5"],sm:["px-2.5","px-2","px-1.5"],md:["px-3.5","px-3","px-2.5"],lg:["px-4.5","px-4","px-3.5"],xl:["px-5.5","px-5","px-4.5"]},s={xs:["py-2","py-1.5","py-1.5"],sm:["py-2.5","py-2","py-1.5"],md:["py-3.5","py-3","py-2.5"],lg:["py-4.5","py-4","py-3.5"],xl:["py-5.5","py-5","py-4.5"]};export function sheetPad(p,t=0){return 0===t?x[p]:n[p][-t-1]}export function sheetPadX(p,x=0){return 0===x?t[p]:r[p][-x-1]}export function sheetPadY(p,x=0){return 0===x?h[p]:s[p][-x-1]}

package/dist/internal/elevation.d.ts

@@ -0,0 +1,26 @@
+import type { MPElevation, MPVariant } from '../types.js';
+/**
+ * The five weights of `CONTAINER_SURFACE` said as a height instead, one row per
+ * MD3 level.
+ *
+ * A tone **and** a shadow per row, which is what makes an `elevation` prop
+ * possible at all. The `elevated` row of the variant table is this table's level
+ * 1, written twice because the two props are two different questions and neither
+ * should have to resolve the other to answer its own.
+ *
+ * Levels 4 and 5 share `surface-container-high` and `surface-container-highest`
+ * with the levels under them because the specification runs out of container
+ * roles before it runs out of levels. Inventing a sixth tone to keep the columns
+ * tidy would be inventing a colour role.
+ */
+export declare const ELEVATION_SURFACE: Record<MPElevation, string>;
+/**
+ * What a container paints, from whichever of the two props answered.
+ *
+ * A level wins where one was given, and takes the tone with it — so `variant` is
+ * left holding only what a level does not describe, which is the hairline. Two
+ * props writing one `background-color` would otherwise be settled by the order
+ * two class names happened to reach the generated stylesheet, which is not a
+ * decision anybody made.
+ */
+export declare function containerSurface(variant: MPVariant, elevation: MPElevation | undefined): string;

package/dist/internal/elevation.js

@@ -0,0 +1 @@
+import{CONTAINER_SURFACE as o}from"./surface.js";export const ELEVATION_SURFACE={0:"bg-mp-surface shadow-none",1:"shadow-mp-1 bg-mp-surface-container-low",2:"shadow-mp-2 bg-mp-surface-container",3:"shadow-mp-3 bg-mp-surface-container-high",4:"shadow-mp-4 bg-mp-surface-container-high",5:"shadow-mp-5 bg-mp-surface-container-highest"};export function containerSurface(r,e){return void 0===e?o[r]:"outlined"===r?`border-mp-outline-variant border ${ELEVATION_SURFACE[e]}`:ELEVATION_SURFACE[e]}

package/dist/internal/highlight.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The grammar engine behind `MPCodeBlock`, and the only thing in this library
+ * that is *loaded* rather than imported.
+ *
+ * highlight.js is the second runtime dependency the package has, and it is here
+ * for a reason no amount of hand-written regex answers: colouring a language
+ * means knowing that language, and there are thirty-four of them here. It is
+ * reached through `highlight.js/lib/core` plus one module per language, never
+ * through the package root — which is all hundred and ninety at once.
+ *
+ * **Every one of those specifiers sits behind an `import()`, and that is the
+ * whole design.** A bundler resolves it at build time and emits it as its own
+ * chunk, so a page that renders an `MPCodeBlock` with `highlight={false}`
+ * downloads none of it, and a page that colours TypeScript downloads the core
+ * and TypeScript and not the other thirty-three. Done with a static import the
+ * component would spend forty kilobytes before drawing a character.
+ *
+ * It is a real `dependencies` entry rather than an optional peer because a
+ * specifier a bundler cannot resolve fails the **whole** build rather than the
+ * part that would have used it: the bundler walks and resolves this module
+ * while it is still deciding whether to keep it. An optional peer would mean
+ * `import { MPButton } from 'material-plus-ui'` breaking for anyone who had not
+ * installed a syntax highlighter.
+ *
+ * What comes back out of here is not HTML. highlight.js emits a string of
+ * nested `<span>`s, and the block needs *lines* — a line is what carries a
+ * number, a prompt and a place in the scroll — so `tokenize` turns that string
+ * into runs of text with a class on them, split at every newline. Which is also
+ * why nothing in this library ever writes `dangerouslySetInnerHTML`.
+ */
+/** One run of text with a single colour: the innermost span highlight.js drew. */
+export interface MPCodeToken {
+    text: string;
+    /** The class it was drawn under — `hljs-keyword`, `hljs-title function_`. */
+    token?: string;
+}
+/** One line of code, as the runs it is made of. An empty array is a blank line. */
+export type MPCodeLine = MPCodeToken[];
+/** The core, and what it hands `registerMPLanguage`. Opaque here; only hljs reads them. */
+type Hljs = typeof import('highlight.js/lib/core').default;
+type LanguageDefinition = Parameters<Hljs['registerLanguage']>[1];
+/**
+ * Teaches `MPCodeBlock` a language the built-in set does not have.
+ *
+ * The same arrangement `registerMPMessages` makes for the eighteen languages
+ * the library does not ship, and for the same reason: highlight.js knows a
+ * hundred and ninety grammars, a documentation site uses six, and the
+ * thirty-four here are a guess at which six. Registering is how an Elixir
+ * project or a Nix flake gets coloured without the other hundred and fifty
+ * being in anybody's build.
+ *
+ * ```ts
+ * import { registerMPLanguage } from 'material-plus-ui';
+ * import elixir from 'highlight.js/lib/languages/elixir';
+ *
+ * registerMPLanguage('elixir', elixir);
+ * ```
+ *
+ * Call it at module scope. A language registered after a block has drawn does
+ * not repaint that block — nothing here re-renders on its own — but every block
+ * mounted after it sees it.
+ *
+ * @param name What `language` will be written as. Registering a name the
+ *   library already has replaces it.
+ * @param definition The default export of a `highlight.js/lib/languages/*`
+ *   module.
+ */
+export declare function registerMPLanguage(name: string, definition: LanguageDefinition): void;
+/** The canonical name a caller's spelling means, whether or not it can be loaded. */
+export declare function canonicalLanguage(language: string | undefined): string | null;
+/**
+ * Colours `code`, or answers `null` when the language is unknown.
+ *
+ * The block is coloured whole and split afterwards, never a line at a time: a
+ * block comment, a template literal and a heredoc all span lines, and a
+ * highlighter handed one line at a time reads the second line of a comment as
+ * code.
+ */
+export declare function highlightCode(code: string, language: string): Promise<MPCodeLine[] | null>;
+/**
+ * highlight.js's own markup, as lines of coloured runs.
+ *
+ * The output is a strictly nested tree of `<span class="…">` with escaped text
+ * between, and a span may cross a newline — which is exactly why this exists
+ * rather than a `split('\n')` over the string. Walking it keeps the open class
+ * across the break and reopens it on the next line.
+ *
+ * Only the innermost class survives a nesting. In the browser that is the one
+ * on the element the text actually sits in, so it is the one whose colour
+ * applies; keeping the ancestors would put two equally specific rules on one
+ * run and let stylesheet order decide the colour.
+ */
+export declare function tokenize(html: string): MPCodeLine[];
+/** The same shape with no colour in it: what a block draws before its chunk lands. */
+export declare function plainLines(code: string): MPCodeLine[];
+export {};

package/dist/internal/highlight.js

@@ -0,0 +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"),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",golang:"go",gql:"graphql",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;let g=null;const s=new Map;export function registerMPLanguage(i,t){const g=i.toLowerCase();l.set(g,t),s.delete(g)}export function canonicalLanguage(i){if(!i)return null;const l=i.trim().toLowerCase();return l?t[l]??l:null}export async function highlightCode(t,a){let e=s.get(a);e||(e=async function(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;if(!h||!g)return null;return tokenize((await g).highlight(t,{language:h,ignoreIllegals:!0}).value)}const a={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#x27;":"'"};export function tokenize(i){const t=[[]],l=[],g=/<span class="([^"]*)">|<\/span>/g;let s=0;const e=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))e(i.slice(s,t.index)),s=t.index+t[0].length,void 0===t[1]?l.pop():l.push(t[1]);return e(i.slice(s)),t}export function plainLines(i){return i.split("\n").map(i=>i?[{text:i}]:[])}