material-plus-ui 0.0.1 → 1.1.0

package/dist/internal/i18n.d.ts

@@ -0,0 +1,241 @@
+/**
+ * The words the library says on its own behalf.
+ *
+ * Almost nothing in Material Plus writes text a reader sees — a button says
+ * whatever it was handed, a dialog's title is the caller's. The exceptions are
+ * the strings a component has to invent because there is nowhere else for them
+ * to come from: the name on a calendar's back arrow, the word on the button that
+ * empties a picker, the label a screen reader hears for a column of minutes.
+ *
+ * Those are collected here rather than defaulted inside each component, because
+ * they are a *set*. A product in Korean does not want four pickers each
+ * defaulting to English and each needing eighteen override props; and the next
+ * component that needs a word should get it from the same place rather than
+ * starting a second table beside this one.
+ *
+ * What is *not* in here is anything `Intl` already knows. Month names, weekday
+ * names, AM/PM and number formats come from the platform, which speaks more
+ * languages than this file ever will — see `internal/date.ts`. This is only for
+ * the words the platform has no opinion about.
+ *
+ * Every component that reads this takes a `locale` and an override prop for the
+ * strings themselves, so an unsupported language is never a dead end: `locale`
+ * gets you a translation for free, `MPLocaleProvider` gets you one for the whole
+ * application at once, and the prop gets you one for anything else.
+ *
+ * Nothing here is exported from `src/index.ts` — the public surface is
+ * `MPLocaleProvider` and the per-component `labels` props.
+ */
+/**
+ * One namespace per component, rather than one flat list of keys.
+ *
+ * A namespace is what makes a partial translation possible: a locale supplies
+ * whatever it has and the rest falls back to English one namespace at a time, so
+ * adding a namespace here does not silently blank the strings in every language
+ * that has not caught up with it yet.
+ */
+export interface MPMessages {
+    /**
+     * The handful of words that are not any one component's.
+     *
+     * A namespace for the words rather than one per component that says them,
+     * because they are the same word: the × on a dialog, on a drawer, on a
+     * popover and on a snackbar is *close* four times, and four namespaces would
+     * be four chances for a translation to disagree with itself about it.
+     *
+     * Every one of these is drawn as a glyph and read out as a word, which is why
+     * they belong in this table at all — see the note at the top of the file. The
+     * components that use them each keep their own override prop for the case
+     * where a particular × means something more specific than "close".
+     */
+    common: {
+        /** The × in the corner of anything that can be dismissed. */
+        close: string;
+        /** The × that empties a control without closing it. */
+        clear: string;
+        /** The chevron that opens a list. */
+        open: string;
+        /** The × that takes one thing out of a set — a chip, a file, a tag. */
+        remove: string;
+        /**
+         * The same, named for what it removes. `{label}` is filled in by
+         * `fillMessage`.
+         *
+         * A second string rather than the bare verb with the name stuck on the end,
+         * because where the name goes is not the same in every language: German and
+         * Korean put it first, English and Spanish put it last. A row of five
+         * remove buttons all called "Remove" is a row a screen reader cannot tell
+         * apart, which is the whole reason this one exists.
+         */
+        removeNamed: string;
+        /** The spinner that replaces a button's leading glyph while it waits. */
+        loading: string;
+    };
+    /**
+     * MPTextField.
+     *
+     * Only the reveal toggle, which is the one part of a text field that has a
+     * name of its own to invent — everything else in it is the caller's.
+     */
+    textField: {
+        showPassword: string;
+        hidePassword: string;
+    };
+    /**
+     * MPEmpty.
+     *
+     * The one string in this table that is **drawn** rather than read out, which
+     * makes it the one that was most obviously wrong to leave in English: a
+     * Korean page with an empty list said "Nothing here" in the middle of it.
+     */
+    empty: {
+        title: string;
+    };
+    /**
+     * The four pickers.
+     *
+     * One namespace for all of them rather than one each, because they are one
+     * vocabulary: a caller who has translated "Previous month" for the date picker
+     * has translated it for the range picker in the same breath, and the clock's
+     * column names are shared by two components outright.
+     */
+    picker: {
+        /** The calendar's steppers, in day view. */
+        previousMonth: string;
+        nextMonth: string;
+        /** The same steppers in month view, where they move by a year. */
+        previousYear: string;
+        nextYear: string;
+        /** And in year view, where they move by a page of twelve. */
+        previousYears: string;
+        nextYears: string;
+        /** The two header buttons that open the month grid and the year grid. */
+        chooseMonth: string;
+        chooseYear: string;
+        /** The footer's actions. */
+        today: string;
+        now: string;
+        clear: string;
+        done: string;
+        /** The clock's columns, which are otherwise unlabelled lists of numbers. */
+        hour: string;
+        minute: string;
+        second: string;
+        meridiem: string;
+        /** Which end of a range the calendar is currently asking for. */
+        start: string;
+        end: string;
+    };
+    /** MPAlert. */
+    alert: {
+        /** The × in the corner, which has no text of its own. */
+        dismiss: string;
+    };
+    /**
+     * MPChatBubble.
+     *
+     * Every string here is read out and never drawn: a delivery state is a mark
+     * on the bubble, and the word behind it is for the readers the mark says
+     * nothing to. That is exactly why they belong in this table rather than in a
+     * prop — a thread is a column of forty of these, and a caller who had to hand
+     * over five words per message would hand over the English ones.
+     */
+    chat: {
+        /** On its way. */
+        sending: string;
+        /** It left. */
+        sent: string;
+        /** It arrived on their device. */
+        delivered: string;
+        /** They opened it. */
+        read: string;
+        /** It did not go — the one step that is not on the ladder. */
+        failed: string;
+        /** The three dots, which are a picture of somebody writing. */
+        typing: string;
+    };
+    /**
+     * MPPagination.
+     *
+     * Every string here is read out and never drawn: what a page button shows is a
+     * number, and what the two steppers show is a chevron. The words behind them
+     * are for the readers those say nothing to — which is exactly why they belong
+     * in this table rather than in props. A row of nine buttons whose caller had to
+     * supply nine names is a row of nine English names.
+     *
+     * `{page}` and `{total}` are filled in by `fillMessage`.
+     */
+    pagination: {
+        /** The name of the `<nav>` the row is inside. */
+        label: string;
+        /** One page button — the number is drawn, this is what is heard. */
+        page: string;
+        /** Announced after a move: where the reader now is, and how far it goes. */
+        status: string;
+        /** The two steppers that move by one page. */
+        previous: string;
+        next: string;
+        /** And the two that jump to an end. */
+        first: string;
+        last: string;
+    };
+    /**
+     * MPRating.
+     *
+     * Read out and never drawn, like the pagination's: a score is a row of stars,
+     * and the sentence behind it is the whole of what a reader who cannot see them
+     * gets. `{value}` and `{max}` are filled in by `fillMessage`.
+     */
+    rating: {
+        /** The name of the control itself. */
+        label: string;
+        /** A score — what one star is called, and what a read-only row announces. */
+        value: string;
+        /** Nothing chosen yet, which is not the same as a score of nought. */
+        empty: string;
+    };
+    /**
+     * MPSpoiler.
+     *
+     * The one namespace whose strings are *drawn* rather than only announced —
+     * they are the words on the cover, and a cover written in a language the page
+     * is not in is a cover nobody reads.
+     */
+    spoiler: {
+        /** The button that uncovers the content. */
+        reveal: string;
+        /** The button that covers it again, when the spoiler is reversible. */
+        hide: string;
+        /** The line above the button, saying why the content is covered. */
+        notice: string;
+    };
+}
+/**
+ * The strings for a locale, merged over English.
+ *
+ * `undefined` is English rather than the runtime's own locale, and that is
+ * deliberate: `navigator.language` differs between the server that renders the
+ * markup and the browser that hydrates it, and text that changes between those
+ * two is a hydration mismatch in the one part of the page a reader is looking
+ * at. A component that should follow the reader is *told* which language to
+ * follow — by its own `locale` prop, or by an `MPLocaleProvider` above it.
+ *
+ * Note that this is only about the words in the table. The dates themselves are
+ * formatted by `Intl` against the same tag, and `Intl` speaks every language the
+ * platform does whether or not there is an entry here.
+ */
+export declare function resolveMessages(locale?: string): MPMessages;
+/**
+ * A message with its placeholders filled in.
+ *
+ * `{page}`, `{total}`, `{value}` — named rather than positional, because the
+ * order of two numbers in a sentence is not the same in every language: English
+ * counts "page 3 of 20" and Turkish counts the total first. A translation that
+ * had to keep the arguments in one order would be a translation that reads
+ * wrongly in half of them.
+ *
+ * A placeholder with nothing to put in it is left as it was written rather than
+ * blanked. A visible `{page}` is a bug report; a sentence with a hole in it is a
+ * sentence somebody has to guess at.
+ */
+export declare function fillMessage(message: string, values: Record<string, string>): string;

package/dist/internal/i18n.js

@@ -0,0 +1 @@
+const e={common:{close:"Close",clear:"Clear",open:"Open",remove:"Remove",removeNamed:"Remove {label}",loading:"Loading"},textField:{showPassword:"Show the password",hidePassword:"Hide the password"},empty:{title:"Nothing here"},picker:{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",now:"Now",clear:"Clear",done:"Done",hour:"Hour",minute:"Minute",second:"Second",meridiem:"AM/PM",start:"Start",end:"End"},alert:{dismiss:"Dismiss"},chat:{sending:"Sending",sent:"Sent",delivered:"Delivered",read:"Read",failed:"Not sent",typing:"Typing"},spoiler:{reveal:"Reveal",hide:"Hide",notice:"Hidden so it is not read by accident"},pagination:{label:"Pagination",page:"Page {page}",status:"Page {page} of {total}",previous:"Previous page",next:"Next page",first:"First page",last:"Last page"},rating:{label:"Rating",value:"{value} out of {max}",empty:"Not rated"}},a={ko:{common:{close:"닫기",clear:"지우기",open:"열기",remove:"제거",removeNamed:"{label} 제거",loading:"불러오는 중"},textField:{showPassword:"비밀번호 표시",hidePassword:"비밀번호 숨기기"},empty:{title:"아무것도 없습니다"},picker:{previousMonth:"이전 달",nextMonth:"다음 달",previousYear:"이전 해",nextYear:"다음 해",previousYears:"이전 연도 목록",nextYears:"다음 연도 목록",chooseMonth:"월 선택",chooseYear:"연도 선택",today:"오늘",now:"지금",clear:"지우기",done:"완료",hour:"시",minute:"분",second:"초",meridiem:"오전/오후",start:"시작",end:"종료"},alert:{dismiss:"닫기"},chat:{sending:"보내는 중",sent:"보냄",delivered:"전달됨",read:"읽음",failed:"전송 실패",typing:"입력 중"},spoiler:{reveal:"보기",hide:"가리기",notice:"실수로 읽지 않도록 가려 두었습니다"},pagination:{label:"페이지 매기기",page:"{page}페이지",status:"{total}페이지 중 {page}페이지",previous:"이전 페이지",next:"다음 페이지",first:"첫 페이지",last:"마지막 페이지"},rating:{label:"별점",value:"{max}점 만점에 {value}점",empty:"평가 없음"}},ja:{common:{close:"閉じる",clear:"クリア",open:"開く",remove:"削除",removeNamed:"{label} を削除",loading:"読み込み中"},textField:{showPassword:"パスワードを表示",hidePassword:"パスワードを非表示"},empty:{title:"何もありません"},picker:{previousMonth:"前の月",nextMonth:"次の月",previousYear:"前の年",nextYear:"次の年",previousYears:"前の年の一覧",nextYears:"次の年の一覧",chooseMonth:"月を選択",chooseYear:"年を選択",today:"今日",now:"現在",clear:"クリア",done:"完了",hour:"時",minute:"分",second:"秒",meridiem:"午前/午後",start:"開始",end:"終了"},alert:{dismiss:"閉じる"},chat:{sending:"送信中",sent:"送信済み",delivered:"配信済み",read:"既読",failed:"送信できませんでした",typing:"入力中"},spoiler:{reveal:"表示する",hide:"隠す",notice:"うっかり読まないように隠してあります"},pagination:{label:"ページ送り",page:"{page}ページ",status:"{total}ページ中{page}ページ",previous:"前のページ",next:"次のページ",first:"最初のページ",last:"最後のページ"},rating:{label:"評価",value:"{max}段階中{value}",empty:"未評価"}},"zh-hans":{common:{close:"关闭",clear:"清除",open:"打开",remove:"移除",removeNamed:"移除 {label}",loading:"加载中"},textField:{showPassword:"显示密码",hidePassword:"隐藏密码"},empty:{title:"暂无内容"},picker:{previousMonth:"上个月",nextMonth:"下个月",previousYear:"上一年",nextYear:"下一年",previousYears:"上一页年份",nextYears:"下一页年份",chooseMonth:"选择月份",chooseYear:"选择年份",today:"今天",now:"此刻",clear:"清除",done:"完成",hour:"小时",minute:"分钟",second:"秒",meridiem:"上午/下午",start:"开始",end:"结束"},alert:{dismiss:"关闭"},chat:{sending:"发送中",sent:"已发送",delivered:"已送达",read:"已读",failed:"未发送",typing:"正在输入"},spoiler:{reveal:"显示",hide:"隐藏",notice:"已隐藏，以免不小心读到"},pagination:{label:"分页",page:"第 {page} 页",status:"第 {page} 页，共 {total} 页",previous:"上一页",next:"下一页",first:"第一页",last:"最后一页"},rating:{label:"评分",value:"{max} 分中的 {value} 分",empty:"未评分"}},"zh-hant":{common:{close:"關閉",clear:"清除",open:"開啟",remove:"移除",removeNamed:"移除 {label}",loading:"載入中"},textField:{showPassword:"顯示密碼",hidePassword:"隱藏密碼"},empty:{title:"暫無內容"},picker:{previousMonth:"上個月",nextMonth:"下個月",previousYear:"上一年",nextYear:"下一年",previousYears:"上一頁年份",nextYears:"下一頁年份",chooseMonth:"選擇月份",chooseYear:"選擇年份",today:"今天",now:"此刻",clear:"清除",done:"完成",hour:"小時",minute:"分鐘",second:"秒",meridiem:"上午/下午",start:"開始",end:"結束"},alert:{dismiss:"關閉"},chat:{sending:"傳送中",sent:"已傳送",delivered:"已送達",read:"已讀",failed:"未傳送",typing:"正在輸入"},spoiler:{reveal:"顯示",hide:"隱藏",notice:"已隱藏，以免不小心讀到"},pagination:{label:"分頁",page:"第 {page} 頁",status:"第 {page} 頁，共 {total} 頁",previous:"上一頁",next:"下一頁",first:"第一頁",last:"最後一頁"},rating:{label:"評分",value:"{max} 分中的 {value} 分",empty:"未評分"}},es:{common:{close:"Cerrar",clear:"Borrar",open:"Abrir",remove:"Quitar",removeNamed:"Quitar {label}",loading:"Cargando"},textField:{showPassword:"Mostrar la contraseña",hidePassword:"Ocultar la contraseña"},empty:{title:"No hay nada aquí"},picker:{previousMonth:"Mes anterior",nextMonth:"Mes siguiente",previousYear:"Año anterior",nextYear:"Año siguiente",previousYears:"Años anteriores",nextYears:"Años siguientes",chooseMonth:"Elegir un mes",chooseYear:"Elegir un año",today:"Hoy",now:"Ahora",clear:"Borrar",done:"Listo",hour:"Hora",minute:"Minuto",second:"Segundo",meridiem:"a. m./p. m.",start:"Inicio",end:"Fin"},alert:{dismiss:"Cerrar"},chat:{sending:"Enviando",sent:"Enviado",delivered:"Entregado",read:"Leído",failed:"No enviado",typing:"Escribiendo"},spoiler:{reveal:"Mostrar",hide:"Ocultar",notice:"Oculto para que no se lea por accidente"},pagination:{label:"Paginación",page:"Página {page}",status:"Página {page} de {total}",previous:"Página anterior",next:"Página siguiente",first:"Primera página",last:"Última página"},rating:{label:"Valoración",value:"{value} de {max}",empty:"Sin valorar"}},pt:{common:{close:"Fechar",clear:"Limpar",open:"Abrir",remove:"Remover",removeNamed:"Remover {label}",loading:"Carregando"},textField:{showPassword:"Mostrar a senha",hidePassword:"Ocultar a senha"},empty:{title:"Não há nada aqui"},picker:{previousMonth:"Mês anterior",nextMonth:"Próximo mês",previousYear:"Ano anterior",nextYear:"Próximo ano",previousYears:"Anos anteriores",nextYears:"Próximos anos",chooseMonth:"Escolher um mês",chooseYear:"Escolher um ano",today:"Hoje",now:"Agora",clear:"Limpar",done:"Concluído",hour:"Hora",minute:"Minuto",second:"Segundo",meridiem:"AM/PM",start:"Início",end:"Fim"},alert:{dismiss:"Fechar"},chat:{sending:"Enviando",sent:"Enviado",delivered:"Entregue",read:"Lido",failed:"Não enviado",typing:"Digitando"},spoiler:{reveal:"Mostrar",hide:"Ocultar",notice:"Oculto para não ser lido por acidente"},pagination:{label:"Paginação",page:"Página {page}",status:"Página {page} de {total}",previous:"Página anterior",next:"Próxima página",first:"Primeira página",last:"Última página"},rating:{label:"Avaliação",value:"{value} de {max}",empty:"Sem avaliação"}},fr:{common:{close:"Fermer",clear:"Effacer",open:"Ouvrir",remove:"Supprimer",removeNamed:"Supprimer {label}",loading:"Chargement"},textField:{showPassword:"Afficher le mot de passe",hidePassword:"Masquer le mot de passe"},empty:{title:"Il n'y a rien ici"},picker:{previousMonth:"Mois précédent",nextMonth:"Mois suivant",previousYear:"Année précédente",nextYear:"Année suivante",previousYears:"Années précédentes",nextYears:"Années suivantes",chooseMonth:"Choisir un mois",chooseYear:"Choisir une année",today:"Aujourd'hui",now:"Maintenant",clear:"Effacer",done:"Terminé",hour:"Heure",minute:"Minute",second:"Seconde",meridiem:"AM/PM",start:"Début",end:"Fin"},alert:{dismiss:"Fermer"},chat:{sending:"Envoi en cours",sent:"Envoyé",delivered:"Distribué",read:"Lu",failed:"Non envoyé",typing:"En train d'écrire"},spoiler:{reveal:"Afficher",hide:"Masquer",notice:"Masqué pour ne pas être lu par accident"},pagination:{label:"Pagination",page:"Page {page}",status:"Page {page} sur {total}",previous:"Page précédente",next:"Page suivante",first:"Première page",last:"Dernière page"},rating:{label:"Note",value:"{value} sur {max}",empty:"Non noté"}},de:{common:{close:"Schließen",clear:"Löschen",open:"Öffnen",remove:"Entfernen",removeNamed:"{label} entfernen",loading:"Wird geladen"},textField:{showPassword:"Passwort anzeigen",hidePassword:"Passwort verbergen"},empty:{title:"Nichts vorhanden"},picker:{previousMonth:"Voriger Monat",nextMonth:"Nächster Monat",previousYear:"Voriges Jahr",nextYear:"Nächstes Jahr",previousYears:"Vorige Jahre",nextYears:"Nächste Jahre",chooseMonth:"Monat auswählen",chooseYear:"Jahr auswählen",today:"Heute",now:"Jetzt",clear:"Löschen",done:"Fertig",hour:"Stunde",minute:"Minute",second:"Sekunde",meridiem:"AM/PM",start:"Beginn",end:"Ende"},alert:{dismiss:"Schließen"},chat:{sending:"Wird gesendet",sent:"Gesendet",delivered:"Zugestellt",read:"Gelesen",failed:"Nicht gesendet",typing:"Schreibt"},spoiler:{reveal:"Anzeigen",hide:"Verbergen",notice:"Verborgen, damit es nicht versehentlich gelesen wird"},pagination:{label:"Seitennummerierung",page:"Seite {page}",status:"Seite {page} von {total}",previous:"Vorherige Seite",next:"Nächste Seite",first:"Erste Seite",last:"Letzte Seite"},rating:{label:"Bewertung",value:"{value} von {max}",empty:"Nicht bewertet"}},it:{common:{close:"Chiudi",clear:"Cancella",open:"Apri",remove:"Rimuovi",removeNamed:"Rimuovi {label}",loading:"Caricamento"},textField:{showPassword:"Mostra la password",hidePassword:"Nascondi la password"},empty:{title:"Non c'è nulla qui"},picker:{previousMonth:"Mese precedente",nextMonth:"Mese successivo",previousYear:"Anno precedente",nextYear:"Anno successivo",previousYears:"Anni precedenti",nextYears:"Anni successivi",chooseMonth:"Scegli un mese",chooseYear:"Scegli un anno",today:"Oggi",now:"Adesso",clear:"Cancella",done:"Fatto",hour:"Ora",minute:"Minuto",second:"Secondo",meridiem:"AM/PM",start:"Inizio",end:"Fine"},alert:{dismiss:"Chiudi"},chat:{sending:"Invio in corso",sent:"Inviato",delivered:"Consegnato",read:"Letto",failed:"Non inviato",typing:"Sta scrivendo"},spoiler:{reveal:"Mostra",hide:"Nascondi",notice:"Nascosto per non essere letto per sbaglio"},pagination:{label:"Impaginazione",page:"Pagina {page}",status:"Pagina {page} di {total}",previous:"Pagina precedente",next:"Pagina successiva",first:"Prima pagina",last:"Ultima pagina"},rating:{label:"Valutazione",value:"{value} su {max}",empty:"Non valutato"}},nl:{common:{close:"Sluiten",clear:"Wissen",open:"Openen",remove:"Verwijderen",removeNamed:"{label} verwijderen",loading:"Laden"},textField:{showPassword:"Wachtwoord tonen",hidePassword:"Wachtwoord verbergen"},empty:{title:"Hier is niets"},picker:{previousMonth:"Vorige maand",nextMonth:"Volgende maand",previousYear:"Vorig jaar",nextYear:"Volgend jaar",previousYears:"Vorige jaren",nextYears:"Volgende jaren",chooseMonth:"Kies een maand",chooseYear:"Kies een jaar",today:"Vandaag",now:"Nu",clear:"Wissen",done:"Klaar",hour:"Uur",minute:"Minuut",second:"Seconde",meridiem:"AM/PM",start:"Begin",end:"Einde"},alert:{dismiss:"Sluiten"},chat:{sending:"Verzenden",sent:"Verzonden",delivered:"Bezorgd",read:"Gelezen",failed:"Niet verzonden",typing:"Aan het typen"},spoiler:{reveal:"Tonen",hide:"Verbergen",notice:"Verborgen zodat het niet per ongeluk wordt gelezen"},pagination:{label:"Paginering",page:"Pagina {page}",status:"Pagina {page} van {total}",previous:"Vorige pagina",next:"Volgende pagina",first:"Eerste pagina",last:"Laatste pagina"},rating:{label:"Beoordeling",value:"{value} van {max}",empty:"Niet beoordeeld"}},pl:{common:{close:"Zamknij",clear:"Wyczyść",open:"Otwórz",remove:"Usuń",removeNamed:"Usuń {label}",loading:"Ładowanie"},textField:{showPassword:"Pokaż hasło",hidePassword:"Ukryj hasło"},empty:{title:"Nic tu nie ma"},picker:{previousMonth:"Poprzedni miesiąc",nextMonth:"Następny miesiąc",previousYear:"Poprzedni rok",nextYear:"Następny rok",previousYears:"Poprzednie lata",nextYears:"Następne lata",chooseMonth:"Wybierz miesiąc",chooseYear:"Wybierz rok",today:"Dzisiaj",now:"Teraz",clear:"Wyczyść",done:"Gotowe",hour:"Godzina",minute:"Minuta",second:"Sekunda",meridiem:"AM/PM",start:"Początek",end:"Koniec"},alert:{dismiss:"Zamknij"},chat:{sending:"Wysyłanie",sent:"Wysłano",delivered:"Dostarczono",read:"Przeczytano",failed:"Nie wysłano",typing:"Pisze"},spoiler:{reveal:"Pokaż",hide:"Ukryj",notice:"Ukryte, aby nie przeczytać przez przypadek"},pagination:{label:"Paginacja",page:"Strona {page}",status:"Strona {page} z {total}",previous:"Poprzednia strona",next:"Następna strona",first:"Pierwsza strona",last:"Ostatnia strona"},rating:{label:"Ocena",value:"{value} z {max}",empty:"Brak oceny"}},ru:{common:{close:"Закрыть",clear:"Очистить",open:"Открыть",remove:"Удалить",removeNamed:"Удалить {label}",loading:"Загрузка"},textField:{showPassword:"Показать пароль",hidePassword:"Скрыть пароль"},empty:{title:"Здесь ничего нет"},picker:{previousMonth:"Предыдущий месяц",nextMonth:"Следующий месяц",previousYear:"Предыдущий год",nextYear:"Следующий год",previousYears:"Предыдущие годы",nextYears:"Следующие годы",chooseMonth:"Выбрать месяц",chooseYear:"Выбрать год",today:"Сегодня",now:"Сейчас",clear:"Очистить",done:"Готово",hour:"Часы",minute:"Минуты",second:"Секунды",meridiem:"ДП/ПП",start:"Начало",end:"Конец"},alert:{dismiss:"Закрыть"},chat:{sending:"Отправка",sent:"Отправлено",delivered:"Доставлено",read:"Прочитано",failed:"Не отправлено",typing:"Печатает"},spoiler:{reveal:"Показать",hide:"Скрыть",notice:"Скрыто, чтобы не прочитать случайно"},pagination:{label:"Постраничная навигация",page:"Страница {page}",status:"Страница {page} из {total}",previous:"Предыдущая страница",next:"Следующая страница",first:"Первая страница",last:"Последняя страница"},rating:{label:"Оценка",value:"{value} из {max}",empty:"Без оценки"}},tr:{common:{close:"Kapat",clear:"Temizle",open:"Aç",remove:"Kaldır",removeNamed:"{label} kaldır",loading:"Yükleniyor"},textField:{showPassword:"Parolayı göster",hidePassword:"Parolayı gizle"},empty:{title:"Burada bir şey yok"},picker:{previousMonth:"Önceki ay",nextMonth:"Sonraki ay",previousYear:"Önceki yıl",nextYear:"Sonraki yıl",previousYears:"Önceki yıllar",nextYears:"Sonraki yıllar",chooseMonth:"Ay seçin",chooseYear:"Yıl seçin",today:"Bugün",now:"Şimdi",clear:"Temizle",done:"Tamam",hour:"Saat",minute:"Dakika",second:"Saniye",meridiem:"ÖÖ/ÖS",start:"Başlangıç",end:"Bitiş"},alert:{dismiss:"Kapat"},chat:{sending:"Gönderiliyor",sent:"Gönderildi",delivered:"İletildi",read:"Okundu",failed:"Gönderilemedi",typing:"Yazıyor"},spoiler:{reveal:"Göster",hide:"Gizle",notice:"Yanlışlıkla okunmasın diye gizlendi"},pagination:{label:"Sayfalama",page:"Sayfa {page}",status:"{total} sayfadan {page}. sayfa",previous:"Önceki sayfa",next:"Sonraki sayfa",first:"İlk sayfa",last:"Son sayfa"},rating:{label:"Değerlendirme",value:"{max} üzerinden {value}",empty:"Değerlendirilmedi"}},ar:{common:{close:"إغلاق",clear:"مسح",open:"فتح",remove:"إزالة",removeNamed:"إزالة {label}",loading:"جارٍ التحميل"},textField:{showPassword:"إظهار كلمة المرور",hidePassword:"إخفاء كلمة المرور"},empty:{title:"لا يوجد شيء هنا"},picker:{previousMonth:"الشهر السابق",nextMonth:"الشهر التالي",previousYear:"السنة السابقة",nextYear:"السنة التالية",previousYears:"السنوات السابقة",nextYears:"السنوات التالية",chooseMonth:"اختيار شهر",chooseYear:"اختيار سنة",today:"اليوم",now:"الآن",clear:"مسح",done:"تم",hour:"الساعة",minute:"الدقيقة",second:"الثانية",meridiem:"ص/م",start:"البداية",end:"النهاية"},alert:{dismiss:"إغلاق"},chat:{sending:"جارٍ الإرسال",sent:"تم الإرسال",delivered:"تم التسليم",read:"تمت القراءة",failed:"لم يتم الإرسال",typing:"يكتب الآن"},spoiler:{reveal:"إظهار",hide:"إخفاء",notice:"مخفي حتى لا يُقرأ بالخطأ"},pagination:{label:"ترقيم الصفحات",page:"الصفحة {page}",status:"الصفحة {page} من {total}",previous:"الصفحة السابقة",next:"الصفحة التالية",first:"الصفحة الأولى",last:"الصفحة الأخيرة"},rating:{label:"التقييم",value:"{value} من {max}",empty:"بدون تقييم"}},hi:{common:{close:"बंद करें",clear:"हटाएँ",open:"खोलें",remove:"निकालें",removeNamed:"{label} निकालें",loading:"लोड हो रहा है"},textField:{showPassword:"पासवर्ड दिखाएँ",hidePassword:"पासवर्ड छिपाएँ"},empty:{title:"यहाँ कुछ नहीं है"},picker:{previousMonth:"पिछला महीना",nextMonth:"अगला महीना",previousYear:"पिछला वर्ष",nextYear:"अगला वर्ष",previousYears:"पिछले वर्ष",nextYears:"अगले वर्ष",chooseMonth:"महीना चुनें",chooseYear:"वर्ष चुनें",today:"आज",now:"अभी",clear:"हटाएँ",done:"हो गया",hour:"घंटा",minute:"मिनट",second:"सेकंड",meridiem:"AM/PM",start:"प्रारंभ",end:"समाप्ति"},alert:{dismiss:"बंद करें"},chat:{sending:"भेजा जा रहा है",sent:"भेजा गया",delivered:"पहुँच गया",read:"पढ़ लिया गया",failed:"नहीं भेजा गया",typing:"टाइप कर रहे हैं"},spoiler:{reveal:"दिखाएँ",hide:"छिपाएँ",notice:"गलती से न पढ़ लिया जाए इसलिए छिपाया गया है"},pagination:{label:"पृष्ठ क्रमांकन",page:"पृष्ठ {page}",status:"{total} में से पृष्ठ {page}",previous:"पिछला पृष्ठ",next:"अगला पृष्ठ",first:"पहला पृष्ठ",last:"अंतिम पृष्ठ"},rating:{label:"रेटिंग",value:"{max} में से {value}",empty:"रेटिंग नहीं दी गई"}},id:{common:{close:"Tutup",clear:"Bersihkan",open:"Buka",remove:"Hapus",removeNamed:"Hapus {label}",loading:"Memuat"},textField:{showPassword:"Tampilkan kata sandi",hidePassword:"Sembunyikan kata sandi"},empty:{title:"Tidak ada apa-apa di sini"},picker:{previousMonth:"Bulan sebelumnya",nextMonth:"Bulan berikutnya",previousYear:"Tahun sebelumnya",nextYear:"Tahun berikutnya",previousYears:"Tahun-tahun sebelumnya",nextYears:"Tahun-tahun berikutnya",chooseMonth:"Pilih bulan",chooseYear:"Pilih tahun",today:"Hari ini",now:"Sekarang",clear:"Hapus",done:"Selesai",hour:"Jam",minute:"Menit",second:"Detik",meridiem:"AM/PM",start:"Mulai",end:"Akhir"},alert:{dismiss:"Tutup"},chat:{sending:"Mengirim",sent:"Terkirim",delivered:"Diterima",read:"Dibaca",failed:"Gagal terkirim",typing:"Sedang mengetik"},spoiler:{reveal:"Tampilkan",hide:"Sembunyikan",notice:"Disembunyikan agar tidak terbaca tanpa sengaja"},pagination:{label:"Penomoran halaman",page:"Halaman {page}",status:"Halaman {page} dari {total}",previous:"Halaman sebelumnya",next:"Halaman berikutnya",first:"Halaman pertama",last:"Halaman terakhir"},rating:{label:"Peringkat",value:"{value} dari {max}",empty:"Belum dinilai"}},vi:{common:{close:"Đóng",clear:"Xóa",open:"Mở",remove:"Gỡ bỏ",removeNamed:"Gỡ bỏ {label}",loading:"Đang tải"},textField:{showPassword:"Hiện mật khẩu",hidePassword:"Ẩn mật khẩu"},empty:{title:"Không có gì ở đây"},picker:{previousMonth:"Tháng trước",nextMonth:"Tháng sau",previousYear:"Năm trước",nextYear:"Năm sau",previousYears:"Các năm trước",nextYears:"Các năm sau",chooseMonth:"Chọn tháng",chooseYear:"Chọn năm",today:"Hôm nay",now:"Bây giờ",clear:"Xóa",done:"Xong",hour:"Giờ",minute:"Phút",second:"Giây",meridiem:"SA/CH",start:"Bắt đầu",end:"Kết thúc"},alert:{dismiss:"Đóng"},chat:{sending:"Đang gửi",sent:"Đã gửi",delivered:"Đã nhận",read:"Đã đọc",failed:"Chưa gửi được",typing:"Đang nhập"},spoiler:{reveal:"Hiện",hide:"Ẩn",notice:"Đã ẩn để không vô tình đọc phải"},pagination:{label:"Phân trang",page:"Trang {page}",status:"Trang {page} trên {total}",previous:"Trang trước",next:"Trang sau",first:"Trang đầu",last:"Trang cuối"},rating:{label:"Đánh giá",value:"{value} trên {max}",empty:"Chưa đánh giá"}},th:{common:{close:"ปิด",clear:"ล้าง",open:"เปิด",remove:"ลบ",removeNamed:"ลบ {label}",loading:"กำลังโหลด"},textField:{showPassword:"แสดงรหัสผ่าน",hidePassword:"ซ่อนรหัสผ่าน"},empty:{title:"ไม่มีอะไรที่นี่"},picker:{previousMonth:"เดือนก่อนหน้า",nextMonth:"เดือนถัดไป",previousYear:"ปีก่อนหน้า",nextYear:"ปีถัดไป",previousYears:"ชุดปีก่อนหน้า",nextYears:"ชุดปีถัดไป",chooseMonth:"เลือกเดือน",chooseYear:"เลือกปี",today:"วันนี้",now:"ตอนนี้",clear:"ล้าง",done:"เสร็จสิ้น",hour:"ชั่วโมง",minute:"นาที",second:"วินาที",meridiem:"AM/PM",start:"เริ่ม",end:"สิ้นสุด"},alert:{dismiss:"ปิด"},chat:{sending:"กำลังส่ง",sent:"ส่งแล้ว",delivered:"ส่งถึงแล้ว",read:"อ่านแล้ว",failed:"ส่งไม่สำเร็จ",typing:"กำลังพิมพ์"},spoiler:{reveal:"แสดง",hide:"ซ่อน",notice:"ซ่อนไว้เพื่อไม่ให้อ่านโดยบังเอิญ"},pagination:{label:"การแบ่งหน้า",page:"หน้า {page}",status:"หน้า {page} จาก {total}",previous:"หน้าก่อนหน้า",next:"หน้าถัดไป",first:"หน้าแรก",last:"หน้าสุดท้าย"},rating:{label:"คะแนน",value:"{value} จาก {max}",empty:"ยังไม่ได้ให้คะแนน"}}},n={zh:"zh-hans","zh-cn":"zh-hans","zh-my":"zh-hans","zh-sg":"zh-hans","zh-hk":"zh-hant","zh-mo":"zh-hant","zh-tw":"zh-hant"};const i=new Map([["",e]]);export function resolveMessages(t){const o=t?.trim()??"",r=i.get(o);if(r)return r;const s=function(e){const a=e.toLowerCase().split(/[-_]/).filter(Boolean),n=a[0];if(!n)return[];const i=a.slice(1),t=i.find(e=>/^[a-z]{4}$/.test(e)),o=i.find(e=>/^([a-z]{2}|\d{3})$/.test(e));return[t?`${n}-${t}`:"",o?`${n}-${o}`:"",n].filter(Boolean)}(o).map(e=>a[e]??a[n[e]??""]).find(Boolean),l=s?{common:{...e.common,...s.common},textField:{...e.textField,...s.textField},empty:{...e.empty,...s.empty},picker:{...e.picker,...s.picker},alert:{...e.alert,...s.alert},chat:{...e.chat,...s.chat},pagination:{...e.pagination,...s.pagination},rating:{...e.rating,...s.rating},spoiler:{...e.spoiler,...s.spoiler}}:e;return i.set(o,l),l}export function fillMessage(e,a){return e.replace(/\{(\w+)\}/g,(e,n)=>a[n]??e)}

package/dist/internal/inert.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `{ inert }` when the subtree should be unreachable, and nothing at all when it
+ * should not.
+ *
+ * Nothing rather than `inert={false}`, because React 18 warns about a `false`
+ * on an attribute it does not know — and an attribute that is absent is already
+ * the whole of what "not inert" means.
+ */
+export declare function inertProps(inert: boolean): {
+    inert?: boolean;
+};

package/dist/internal/inert.js

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

package/dist/internal/locale.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Which language the components speak, and where that answer comes from.
+ *
+ * Two sources, in this order, and the order is the whole design:
+ *
+ * 1. **The component's own `locale` prop.** One control in a different language
+ *    from the page around it is a real thing — an admin editing a Japanese
+ *    listing from a Korean dashboard — and a component library that cannot draw
+ *    it has decided the page's language on the caller's behalf.
+ * 2. **`MPLocaleProvider`, above it in the tree.** Which is what an application
+ *    actually has: one language, set once, at the root.
+ *
+ * There is deliberately no third source. `navigator.language` is *not* consulted
+ * as a fallback, and that is not an oversight — see the note on
+ * `resolveMessages` in `internal/i18n.ts`. The runtime's own locale differs
+ * between the server that renders the markup and the browser that hydrates it,
+ * so reading it would put a hydration mismatch in the one part of the page a
+ * reader is looking at. `undefined` therefore means "the platform's default",
+ * which `Intl` resolves consistently in both places.
+ */
+import * as React from 'react';
+import { type MPMessages } from './i18n';
+/**
+ * `undefined` rather than `'en'`, and the distinction matters.
+ *
+ * With no provider the pickers hand `undefined` to `Intl`, which formats dates
+ * in whatever the platform is set to — so a page that never mentions a locale
+ * still writes dates the way its reader expects. It is only the words in the
+ * table that fall back to English, because those are the ones the platform has
+ * no opinion about.
+ */
+export declare const MPLocaleContext: React.Context<string | undefined>;
+/** The locale in force here: the prop if there is one, otherwise the provider's. */
+export declare function useMPLocale(locale?: string): string | undefined;
+/**
+ * A namespace's strings with a caller's overrides on top.
+ *
+ * The overrides win over the translation, which wins over English. That order is
+ * what makes an unsupported language a partial answer rather than a dead end: a
+ * caller supplies the handful of words they care about and everything else is
+ * still translated, or still English, rather than blank.
+ */
+export declare function useMPMessages<Namespace extends keyof MPMessages>(namespace: Namespace, locale: string | undefined, overrides?: Partial<MPMessages[Namespace]>): MPMessages[Namespace];

package/dist/internal/locale.js

@@ -0,0 +1 @@
+import*as e from"react";import{resolveMessages as t}from"./i18n";export const MPLocaleContext=e.createContext(void 0);export function useMPLocale(t){const o=e.useContext(MPLocaleContext);return t??o}export function useMPMessages(o,n,r){return e.useMemo(()=>{const e=t(n)[o];return r?{...e,...r}:e},[o,n,r])}

package/dist/internal/menu.d.ts

@@ -0,0 +1,23 @@
+/**
+ * What a menu row inherits from the menu around it.
+ *
+ * The same arrangement `MPButtonGroup` uses, and for the same reason: `size` and
+ * `color` are properties of the *menu*, not of any one row in it, and passing
+ * them per row would be two chances per row to get one wrong — with a silent
+ * failure, a menu whose fourth item is a size bigger than the three above it.
+ *
+ * It lives in `internal/` rather than in `MPMenu.tsx` because a submenu is a menu
+ * inside a menu and a context menu is the same rows hung off a right-click, so
+ * three components read this and none of them should have to import the others.
+ *
+ * Unlike the button group's context this one is never `null`: a row rendered
+ * outside a menu is a bug Base UI will report first, and defaulting here keeps
+ * every row from having to answer "what if there is no menu".
+ */
+import * as React from 'react';
+import type { MPColor, MPSize } from '../types';
+export interface MPMenuContextValue {
+    size: MPSize;
+    color: MPColor;
+}
+export declare const MPMenuContext: React.Context<MPMenuContextValue>;

package/dist/internal/menu.js

@@ -0,0 +1 @@
+import*as t from"react";export const MPMenuContext=t.createContext({size:"md",color:"primary"});

package/dist/internal/progress.d.ts

@@ -0,0 +1,126 @@
+/**
+ * What the three progress indicators share.
+ *
+ * `MPProgressLinear`, `MPProgressCircular` and `MPProgressBox` are three shapes
+ * answering one question — how far along is this, and is it moving at all — so
+ * everything that is *not* the shape lives here: the props, the ladders and the
+ * arithmetic that turns `value`/`min`/`max` into a fraction.
+ *
+ * The shapes themselves are all that is left in each component, which is the
+ * point: they are the only thing that genuinely differs. A `value` of `null` has
+ * to mean the same thing on a bar, a ring and a row of segments, or the trio is
+ * three components that happen to share a prefix.
+ *
+ * Every class string here is a literal, for the reason `scale.ts` gives:
+ * Tailwind finds classes by scanning source text, so an interpolated `h-${n}`
+ * generates no rule at all.
+ */
+import type * as React from 'react';
+import type { MPSize } from '../types';
+/**
+ * The props all three indicators take.
+ *
+ * Declared once and extended rather than copied three times. `color` and `size`
+ * are deliberately *not* here — they are on `MPStyleProps` for every other
+ * component and each indicator documents what its own `size` means, which is a
+ * different quantity on a bar (thickness), a ring (diameter) and a row of
+ * segments (one segment).
+ */
+export interface MPProgressProps {
+    /**
+     * How far along, between `min` and `max`.
+     *
+     * `null` — the default — is the indeterminate case: something is happening and
+     * nobody knows how much of it is left. That is the default on purpose. An
+     * indicator that has not been told a value should say so rather than draw an
+     * empty track, which is a claim that no progress has been made.
+     * @default null
+     */
+    value?: number | null;
+    /** @default 0 */
+    min?: number;
+    /** @default 100 */
+    max?: number;
+    /** A name for what is loading. Read out with the value by a screen reader. */
+    label?: React.ReactNode;
+    /**
+     * Shows the value as text beside the shape. A percentage of the range unless
+     * `format` says otherwise.
+     * @default false
+     */
+    showValue?: boolean;
+    /**
+     * How the value is written when it is shown — `Intl.NumberFormat` options, so
+     * bytes and currencies work as well as plain numbers. Without it the value is
+     * a percentage of `min`…`max`, which is the only formatting that holds for a
+     * range nobody described.
+     */
+    format?: Intl.NumberFormatOptions;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * How thick the linear track is.
+ *
+ * Its own ladder rather than a step off `CONTROL_HEIGHT`: a bar is not a control
+ * with a label inside it. `md` is MD3's own 4dp, and the ladder is centred on it
+ * the same way every other one is centred on its spec value.
+ */
+export declare const BAR_THICKNESS: Record<MPSize, string>;
+/**
+ * The diameter of the ring, in CSS pixels.
+ *
+ * Numbers rather than classes because the same value has to reach the SVG's
+ * `viewBox` arithmetic, and a ring is one of the few things in this library that
+ * a Tailwind class cannot describe on its own.
+ *
+ * `md` is MD3's own 48dp, and every rung sits inside the control height at the
+ * same step — a 48px ring inside a 56px field — so a spinner dropped into a
+ * button, a field or a table row never makes the row taller than it was.
+ */
+export declare const RING_DIAMETER: Record<MPSize, number>;
+/** The ring's stroke, MD3's 4dp at `md`, thickening so the hole stays in proportion. */
+export declare const RING_STROKE: Record<MPSize, number>;
+/** One segment of an `MPProgressBox`. An indicator, so its own ladder again. */
+export declare const SEGMENT_SIZE: Record<MPSize, string>;
+/**
+ * The corner cut off a segment.
+ *
+ * `corner-extra-small` from `md` up, which is the spec's smallest corner and the
+ * right one for a tile this size. The two rungs below it cap it, because 4px on
+ * an 8px box is not a cut corner — it is a circle.
+ *
+ * A cap rather than the literal 3px it used to be, so the tiles still follow the
+ * token in the one direction the cap does not block: under a squarer theme these
+ * go square with everything else, and under a rounder one they hold at 3px,
+ * which is the whole point of capping them.
+ */
+export declare const SEGMENT_RADIUS: Record<MPSize, string>;
+/** Between the segments. Tight — they are one object, not a row of squares. */
+export declare const SEGMENT_GAP: Record<MPSize, string>;
+/**
+ * `value` as a fraction of the range, or `null` when there is nothing to say.
+ *
+ * The clamp is not defensive programming for its own sake — `value` usually
+ * arrives from a division somewhere, and a bar that renders 140% wide because
+ * one request finished twice is a worse bug than a bar that sits full.
+ */
+export declare function progressFraction(value: number | null | undefined, min: number, max: number): number | null;
+/**
+ * What the value reads as, both on screen and to a screen reader.
+ *
+ * Base UI's own default is `${value}%`, which is right only when the range
+ * happens to be 0–100 — "3%" for step 3 of 4 is worse than saying nothing. So
+ * the percentage is computed from the fraction, and a caller who passed `format`
+ * gets Base UI's formatted string instead, because at that point they have said
+ * what the number means.
+ */
+export declare function progressText(fraction: number | null, formatted: string | null, hasFormat: boolean): string | null;
+/**
+ * The same string, shaped for Base UI's `getAriaValueText`.
+ *
+ * `undefined` when there is no value, which hands the indeterminate case back to
+ * Base UI — it already announces indeterminate progress, and re-inventing that
+ * here would be one more English string the library has to own.
+ */
+export declare function progressAriaText(fraction: number | null, hasFormat: boolean): ((formatted: string | null) => string) | undefined;

package/dist/internal/progress.js

@@ -0,0 +1 @@
+export const BAR_THICKNESS={xs:"h-0.5",sm:"h-[3px]",md:"h-1",lg:"h-1.5",xl:"h-2"};export const RING_DIAMETER={xs:24,sm:32,md:48,lg:56,xl:64};export const RING_STROKE={xs:2.5,sm:3,md:4,lg:4.5,xl:5};export const SEGMENT_SIZE={xs:"size-2",sm:"size-2.5",md:"size-3",lg:"size-4",xl:"size-5"};export const SEGMENT_RADIUS={xs:"rounded-[min(var(--mp-sys-shape-corner-extra-small),3px)]",sm:"rounded-[min(var(--mp-sys-shape-corner-extra-small),3px)]",md:"rounded-mp-xs",lg:"rounded-mp-xs",xl:"rounded-mp-sm"};export const SEGMENT_GAP={xs:"gap-1",sm:"gap-1",md:"gap-1.5",lg:"gap-1.5",xl:"gap-2"};export function progressFraction(s,r,e){return null==s||Number.isNaN(s)||e<=r?null:Math.min(1,Math.max(0,(s-r)/(e-r)))}export function progressText(s,r,e){return null===s?null:e?r:`${Math.round(100*s)}%`}export function progressAriaText(s,r){if(null!==s)return e=>progressText(s,e,r)??""}