@chelone/core 0.9.0 → 0.11.0

package/dist/i18n/direction.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The writing direction a locale renders in — the rule behind the `dir` the
+ * adapters put on the app root. Framework-free because both adapters need the
+ * same answer: each reads the active locale and calls `getLocaleDirection`.
+ */
+/** The two values HTML's `dir` attribute takes. */
+export type TextDirection = "ltr" | "rtl";
+/**
+ * The direction `locale` renders in: `"rtl"` for Arabic, Hebrew, Persian…,
+ * `"ltr"` for everything else, including an empty or malformed tag.
+ *
+ * A tag is read as BCP 47 — `language[-script][-region][-variant…]`, with the
+ * `-u-`/`-x-` extensions cut off, so `en-US-u-nu-arab` (Arabic *digits*) is not
+ * mistaken for the Arabic script. The script subtag is the four-letter one right
+ * after the language, and it decides over the language: `pa-Arab` is rtl,
+ * `pa-Guru` is ltr. Underscore separators (POSIX/ICU tags) are accepted.
+ */
+export declare function getLocaleDirection(locale: string): TextDirection;

package/dist/i18n/direction.js

@@ -0,0 +1,72 @@
+// src/i18n/direction.ts
+/**
+* Languages whose DEFAULT script runs right to left, the script CLDR's likely
+* subtags give them (ar → Arabic, he → Hebrew, dv → Thaana, ckb → Arabic).
+*
+* A language whose default script is Latin is not here even when some of its
+* speakers write it another way: Turkmen (`tk`) and Kurmanji Kurdish (`ku`) are
+* ltr, and their Arabic-script forms arrive as `tk-Arab` / `ku-Arab`, which the
+* script list below decides. Sorani Kurdish is `ckb`, listed above.
+*
+* A script subtag in the tag always wins over this list, so `ar-Latn` (Arabic
+* in Latin letters) is ltr. A region alone changes nothing, as in CLDR: `fa-TJ`
+* is Persian in Arabic script, and Tajik in Cyrillic is `tg` or `fa-Cyrl-TJ`.
+*/
+var RTL_LANGUAGES = /* @__PURE__ */ new Set([
+	"ar",
+	"ckb",
+	"dv",
+	"fa",
+	"he",
+	"nqo",
+	"ps",
+	"sd",
+	"ug",
+	"ur",
+	"yi"
+]);
+/**
+* ISO 15924 script codes that run right to left. A tag's script subtag says how
+* a language is written, so this decides the languages the list above leaves
+* out: `pa-Arab` is Punjabi in Arabic script, `ku-Arab` Kurdish, `tk-Arab`
+* Turkmen. Historic scripts are left out: no app localizes to them.
+*/
+var RTL_SCRIPTS = /* @__PURE__ */ new Set([
+	"adlm",
+	"arab",
+	"hebr",
+	"mand",
+	"mend",
+	"nkoo",
+	"phnx",
+	"rohg",
+	"samr",
+	"syrc",
+	"thaa",
+	"yezi"
+]);
+/** Where the `-u-` (unicode) or `-x-` (private use) extension starts, or the tag's end. */
+function extensionIndex(subtags) {
+	const index = subtags.findIndex((subtag) => subtag.toLowerCase() === "u" || subtag.toLowerCase() === "x");
+	return index === -1 ? subtags.length : index;
+}
+/**
+* The direction `locale` renders in: `"rtl"` for Arabic, Hebrew, Persian…,
+* `"ltr"` for everything else, including an empty or malformed tag.
+*
+* A tag is read as BCP 47 — `language[-script][-region][-variant…]`, with the
+* `-u-`/`-x-` extensions cut off, so `en-US-u-nu-arab` (Arabic *digits*) is not
+* mistaken for the Arabic script. The script subtag is the four-letter one right
+* after the language, and it decides over the language: `pa-Arab` is rtl,
+* `pa-Guru` is ltr. Underscore separators (POSIX/ICU tags) are accepted.
+*/
+function getLocaleDirection(locale) {
+	const subtags = locale.split(/[-_]/);
+	const structural = subtags.slice(0, extensionIndex(subtags));
+	const language = (structural[0] ?? "").toLowerCase();
+	const second = structural[1];
+	const script = second !== void 0 && second.length === 4 ? second.toLowerCase() : void 0;
+	if (script !== void 0) return RTL_SCRIPTS.has(script) ? "rtl" : "ltr";
+	return RTL_LANGUAGES.has(language) ? "rtl" : "ltr";
+}
+export { getLocaleDirection };

package/dist/i18n/english-messages.d.ts

@@ -2,185 +2,180 @@
  * The English catalog an `<Admin>` with no `i18n` prop reads from, and the base
  * an app extends: spread it, then add or override entries.
  *
- * The ported shadcn components translate `ra.*` keys (the react-admin namespace
- * they were ported from): page titles, list pagination, the bulk-action bar,
- * menu a11y labels, boolean fields. Chelone's i18n never throws on a missing key
- * (it returns the key or a `_` fallback), so a partial catalog shows raw
- * `ra.page.list`-style keys.
+ * Every key is `chelone.<group>.<leaf>`: the ported shadcn components used to
+ * translate the react-admin `ra.*` keys they were ported from, and those keys
+ * were moved under `chelone.*` with their group names kept (`page`, `action`,
+ * `navigation`). Chelone's i18n never throws on a missing key (it returns the
+ * key or a `_` fallback), so a partial catalog shows raw
+ * `chelone.page.list`-style keys.
  *
  * Interpolation is single-brace `{name}` (not react-admin's `%{name}`). Plural
  * strings are `{ one, other }` objects keyed by Intl.PluralRules categories
  * (react-admin's `a |||| b` form).
  *
  * `defaultMessages` (the `chelone.*` keys the core controllers emit) and
- * `mapMessages` (the maps add-on's labels) sit underneath.
+ * `mapMessages` (the maps add-on's labels) sit underneath, and no entry here
+ * repeats one of them. Where a moved key landed on a controller key that says
+ * something different, the component's own key keeps the group and names the
+ * role: `access_denied_detail`, `authentication_error_detail`,
+ * `loading_detail` and `http_error_label` sit beside the controller's
+ * `access_denied`, `authentication_error`, `loading` and `http_error`.
  */
 export declare const englishMessages: {
-    readonly "ra.page.list": "{name}";
-    readonly "ra.page.create": "Create {name}";
-    readonly "ra.page.edit": "{name} {recordRepresentation}";
-    readonly "ra.page.show": "{name} {recordRepresentation}";
-    readonly "ra.page.dashboard": "Dashboard";
-    readonly "ra.page.error": "Something went wrong";
-    readonly "ra.page.not_found": "Not Found";
-    readonly "ra.page.loading": "Loading";
-    readonly "ra.page.empty": "No {name} yet.";
-    readonly "ra.page.access_denied": "Access denied";
-    readonly "ra.page.authentication_error": "Authentication error";
-    readonly "ra.action.add": "Add";
-    readonly "ra.action.add_filter": "Add filter";
-    readonly "ra.action.bulk_actions": {
+    readonly "chelone.page.list": "{name}";
+    readonly "chelone.page.create": "Create {name}";
+    readonly "chelone.page.edit": "{name} {recordRepresentation}";
+    readonly "chelone.page.show": "{name} {recordRepresentation}";
+    readonly "chelone.page.dashboard": "Dashboard";
+    readonly "chelone.page.error": "Something went wrong";
+    readonly "chelone.page.not_found": "Not Found";
+    readonly "chelone.page.loading": "Loading";
+    readonly "chelone.page.empty": "No {name} yet.";
+    readonly "chelone.page.access_denied": "Access denied";
+    readonly "chelone.page.authentication_error": "Authentication error";
+    readonly "chelone.action.add": "Add";
+    readonly "chelone.action.add_filter": "Add filter";
+    readonly "chelone.action.bulk_actions": {
         readonly one: "1 item selected";
         readonly other: "{count} items selected";
     };
-    readonly "ra.action.cancel": "Cancel";
-    readonly "ra.action.clear_input_value": "Clear value";
-    readonly "ra.action.clear_search": "Clear search";
-    readonly "ra.action.close": "Close";
-    readonly "ra.action.close_menu": "Close menu";
-    readonly "ra.action.confirm": "Confirm";
-    readonly "ra.action.create": "Create";
-    readonly "ra.action.delete": "Delete";
-    readonly "ra.action.edit": "Edit";
-    readonly "ra.action.export": "Export";
-    readonly "ra.action.list": "List";
-    readonly "ra.action.open_menu": "Open menu";
-    readonly "ra.action.refresh": "Refresh";
-    readonly "ra.action.remove": "Remove";
-    readonly "ra.action.remove_filter": "Remove this filter";
-    readonly "ra.action.save": "Save";
-    readonly "ra.action.search": "Search";
-    readonly "ra.action.select_all": "Select all";
-    readonly "ra.action.select_row": "Select this row";
-    readonly "ra.action.show": "Show";
-    readonly "ra.action.sort": "Sort";
-    readonly "ra.action.toggle_theme": "Toggle light/dark mode";
-    readonly "ra.action.undo": "Undo";
-    readonly "ra.action.unselect": "Unselect";
-    readonly "ra.action.update": "Update";
-    readonly "ra.boolean.true": "Yes";
-    readonly "ra.boolean.false": "No";
-    readonly "ra.boolean.null": " ";
-    readonly "ra.auth.logout": "Logout";
-    readonly "ra.auth.sign_in": "Sign in";
-    readonly "ra.auth.sign_in_error": "Authentication failed, please retry";
-    readonly "ra.auth.user_menu": "Profile";
-    readonly "ra.auth.username": "Username";
-    readonly "ra.auth.password": "Password";
-    readonly "ra.auth.auth_check_error": "Please login to continue";
-    readonly "ra.message.access_denied": "You don't have the right permissions to access this page";
-    readonly "ra.message.auth_error": "An error occurred while validating the authentication token.";
-    readonly "ra.message.authentication_error": "The authentication server returned an error and your credentials could not be checked.";
-    readonly "ra.message.error": "A client error occurred and your request couldn't be completed.";
-    readonly "ra.message.invalid_form": "The form is not valid. Please check for errors";
-    readonly "ra.message.loading": "Please wait";
-    readonly "ra.message.not_found": "Either you typed a wrong URL, or you followed a bad link.";
-    readonly "ra.navigation.next": "Go to next page";
-    readonly "ra.navigation.previous": "Go to previous page";
-    readonly "ra.navigation.first": "Go to first page";
-    readonly "ra.navigation.last": "Go to last page";
-    readonly "ra.navigation.no_results": "No results found";
-    readonly "ra.navigation.no_filtered_results": "No results found with the current filters.";
-    readonly "ra.navigation.page_range_info": "{offsetBegin}-{offsetEnd} of {total}";
-    readonly "ra.navigation.partial_page_range_info": "{offsetBegin}-{offsetEnd} of more than {offsetEnd}";
-    readonly "ra.navigation.page_rows_per_page": "Rows per page:";
-    readonly "ra.navigation.current_page": "Page {page}";
-    readonly "ra.navigation.skip_nav": "Skip to content";
-    readonly "ra.input.file.upload_several": "Drop some files to upload, or click to select one.";
-    readonly "ra.input.file.upload_single": "Drop a file to upload, or click to select it.";
-    readonly "ra.input.image.upload_several": "Drop some pictures to upload, or click to select one.";
-    readonly "ra.input.image.upload_single": "Drop a picture to upload, or click to select it.";
-    readonly "ra.input.password.toggle_visible": "Hide password";
-    readonly "ra.input.password.toggle_hidden": "Show password";
-    readonly "ra.theme.light": "Light";
-    readonly "ra.theme.dark": "Dark";
-    readonly "ra.theme.system": "System";
-    readonly "ra.validation.required": "Required";
-    readonly "ra.validation.minLength": "Must be {min} characters at least";
-    readonly "ra.validation.maxLength": "Must be {max} characters or less";
-    readonly "ra.validation.minValue": "Must be at least {min}";
-    readonly "ra.validation.maxValue": "Must be {max} or less";
-    readonly "ra.validation.number": "Must be a number";
-    readonly "ra.validation.email": "Must be a valid email";
-    readonly "ra.action.back": "Back";
-    readonly "ra.action.bulk_edit_apply": {
+    readonly "chelone.action.cancel": "Cancel";
+    readonly "chelone.action.clear_input_value": "Clear value";
+    readonly "chelone.action.clear_search": "Clear search";
+    readonly "chelone.action.close": "Close";
+    readonly "chelone.action.close_menu": "Close menu";
+    readonly "chelone.action.confirm": "Confirm";
+    readonly "chelone.action.create": "Create";
+    readonly "chelone.action.delete": "Delete";
+    readonly "chelone.action.edit": "Edit";
+    readonly "chelone.action.export": "Export";
+    readonly "chelone.action.list": "List";
+    readonly "chelone.action.open_menu": "Open menu";
+    readonly "chelone.action.refresh": "Refresh";
+    readonly "chelone.action.remove": "Remove";
+    readonly "chelone.action.remove_filter": "Remove this filter";
+    readonly "chelone.action.save": "Save";
+    readonly "chelone.action.search": "Search";
+    readonly "chelone.action.select_all": "Select all";
+    readonly "chelone.action.select_row": "Select this row";
+    readonly "chelone.action.show": "Show";
+    readonly "chelone.action.sort": "Sort";
+    readonly "chelone.action.toggle_theme": "Toggle light/dark mode";
+    readonly "chelone.action.undo": "Undo";
+    readonly "chelone.action.unselect": "Unselect";
+    readonly "chelone.action.update": "Update";
+    readonly "chelone.boolean.true": "Yes";
+    readonly "chelone.boolean.false": "No";
+    readonly "chelone.boolean.null": " ";
+    readonly "chelone.auth.sign_in": "Sign in";
+    readonly "chelone.auth.sign_in_error": "Authentication failed, please retry";
+    readonly "chelone.auth.user_menu": "Profile";
+    readonly "chelone.auth.username": "Username";
+    readonly "chelone.auth.password": "Password";
+    readonly "chelone.message.access_denied_detail": "You don't have the right permissions to access this page";
+    readonly "chelone.message.auth_error": "An error occurred while validating the authentication token.";
+    readonly "chelone.message.authentication_error_detail": "The authentication server returned an error and your credentials could not be checked.";
+    readonly "chelone.message.error": "A client error occurred and your request couldn't be completed.";
+    readonly "chelone.message.loading_detail": "Please wait";
+    readonly "chelone.navigation.next": "Go to next page";
+    readonly "chelone.navigation.previous": "Go to previous page";
+    readonly "chelone.navigation.first": "Go to first page";
+    readonly "chelone.navigation.last": "Go to last page";
+    readonly "chelone.navigation.no_results": "No results found";
+    readonly "chelone.navigation.no_filtered_results": "No results found with the current filters.";
+    readonly "chelone.navigation.page_range_info": "{offsetBegin}-{offsetEnd} of {total}";
+    readonly "chelone.navigation.partial_page_range_info": "{offsetBegin}-{offsetEnd} of more than {offsetEnd}";
+    readonly "chelone.navigation.page_rows_per_page": "Rows per page:";
+    readonly "chelone.navigation.current_page": "Page {page}";
+    readonly "chelone.navigation.skip_nav": "Skip to content";
+    readonly "chelone.input.file.upload_several": "Drop some files to upload, or click to select one.";
+    readonly "chelone.input.file.upload_single": "Drop a file to upload, or click to select it.";
+    readonly "chelone.input.image.upload_several": "Drop some pictures to upload, or click to select one.";
+    readonly "chelone.input.image.upload_single": "Drop a picture to upload, or click to select it.";
+    readonly "chelone.input.password.toggle_visible": "Hide password";
+    readonly "chelone.input.password.toggle_hidden": "Show password";
+    readonly "chelone.theme.light": "Light";
+    readonly "chelone.theme.dark": "Dark";
+    readonly "chelone.theme.system": "System";
+    readonly "chelone.action.back": "Back";
+    readonly "chelone.action.bulk_edit_apply": {
         readonly one: "Apply to 1 record";
         readonly other: "Apply to {count} records";
     };
-    readonly "ra.action.change_locale": "Change locale";
-    readonly "ra.action.clear_array_input": "Clear the array";
-    readonly "ra.action.clone": "Clone";
-    readonly "ra.action.collapse": "Collapse";
-    readonly "ra.action.expand": "Expand";
-    readonly "ra.action.move_column_down": "Move down";
-    readonly "ra.action.move_column_up": "Move up";
-    readonly "ra.action.move_down": "Move down";
-    readonly "ra.action.move_up": "Move up";
-    readonly "ra.action.reload": "Reload";
-    readonly "ra.action.remove_all_filters": "Remove all filters";
-    readonly "ra.action.reset": "Reset";
-    readonly "ra.action.reset_columns": "Reset";
-    readonly "ra.action.search_columns": "Search columns";
-    readonly "ra.action.select_columns": "Columns";
-    readonly "ra.auth.or": "or";
-    readonly "ra.calendar.agenda": "Agenda";
-    readonly "ra.calendar.month": "Month";
-    readonly "ra.calendar.week": "Week";
-    readonly "ra.calendar.next": "Next";
-    readonly "ra.calendar.previous": "Previous";
-    readonly "ra.calendar.today": "Today";
-    readonly "ra.calendar.view": "View";
-    readonly "ra.calendar.no_events": "No events";
-    readonly "ra.csv_import.back": "Back";
-    readonly "ra.csv_import.close": "Close";
-    readonly "ra.csv_import.complete": "Import complete";
-    readonly "ra.csv_import.counts": "{created} created · {failed} failed · {total} total";
-    readonly "ra.csv_import.download_errors": "Download error report";
-    readonly "ra.csv_import.drop": "Drop a CSV file here, or click to choose one";
-    readonly "ra.csv_import.import": "Import";
-    readonly "ra.csv_import.issues": "Issues";
-    readonly "ra.csv_import.next": "Next";
-    readonly "ra.csv_import.not_utf8": "This file is not UTF-8, so some letters may be wrong. Save it as CSV UTF-8 and try again.";
-    readonly "ra.csv_import.preview_summary": "{valid} valid · {errors} errors · {total} total";
-    readonly "ra.csv_import.required_unmapped": "Required fields are not mapped";
-    readonly "ra.csv_import.rows_parsed": "{count} rows parsed";
-    readonly "ra.csv_import.step.commit": "Importing";
-    readonly "ra.csv_import.step.map": "Map columns";
-    readonly "ra.csv_import.step.preview": "Preview";
-    readonly "ra.csv_import.step.upload": "Upload";
-    readonly "ra.csv_import.unmapped": "Not mapped";
-    readonly "ra.csv_import.wrong_file": "Choose a .csv file";
-    readonly "ra.message.bulk_delete_content": {
+    readonly "chelone.action.change_locale": "Change locale";
+    readonly "chelone.action.clear_array_input": "Clear the array";
+    readonly "chelone.action.clone": "Clone";
+    readonly "chelone.action.collapse": "Collapse";
+    readonly "chelone.action.expand": "Expand";
+    readonly "chelone.action.move_column_down": "Move down";
+    readonly "chelone.action.move_column_up": "Move up";
+    readonly "chelone.action.move_down": "Move down";
+    readonly "chelone.action.move_up": "Move up";
+    readonly "chelone.action.reload": "Reload";
+    readonly "chelone.action.remove_all_filters": "Remove all filters";
+    readonly "chelone.action.reset": "Reset";
+    readonly "chelone.action.reset_columns": "Reset";
+    readonly "chelone.action.search_columns": "Search columns";
+    readonly "chelone.action.select_columns": "Columns";
+    readonly "chelone.auth.or": "or";
+    readonly "chelone.calendar.agenda": "Agenda";
+    readonly "chelone.calendar.month": "Month";
+    readonly "chelone.calendar.week": "Week";
+    readonly "chelone.calendar.next": "Next";
+    readonly "chelone.calendar.previous": "Previous";
+    readonly "chelone.calendar.today": "Today";
+    readonly "chelone.calendar.view": "View";
+    readonly "chelone.calendar.no_events": "No events";
+    readonly "chelone.csv_import.back": "Back";
+    readonly "chelone.csv_import.close": "Close";
+    readonly "chelone.csv_import.complete": "Import complete";
+    readonly "chelone.csv_import.counts": "{created} created · {failed} failed · {total} total";
+    readonly "chelone.csv_import.download_errors": "Download error report";
+    readonly "chelone.csv_import.drop": "Drop a CSV file here, or click to choose one";
+    readonly "chelone.csv_import.import": "Import";
+    readonly "chelone.csv_import.issues": "Issues";
+    readonly "chelone.csv_import.next": "Next";
+    readonly "chelone.csv_import.not_utf8": "This file is not UTF-8, so some letters may be wrong. Save it as CSV UTF-8 and try again.";
+    readonly "chelone.csv_import.preview_summary": "{valid} valid · {errors} errors · {total} total";
+    readonly "chelone.csv_import.required_unmapped": "Required fields are not mapped";
+    readonly "chelone.csv_import.rows_parsed": "{count} rows parsed";
+    readonly "chelone.csv_import.step.commit": "Importing";
+    readonly "chelone.csv_import.step.map": "Map columns";
+    readonly "chelone.csv_import.step.preview": "Preview";
+    readonly "chelone.csv_import.step.upload": "Upload";
+    readonly "chelone.csv_import.unmapped": "Not mapped";
+    readonly "chelone.csv_import.wrong_file": "Choose a .csv file";
+    readonly "chelone.message.bulk_delete_content": {
         readonly one: "Are you sure you want to delete this item?";
         readonly other: "Are you sure you want to delete these {count} items?";
     };
-    readonly "ra.message.bulk_delete_title": {
+    readonly "chelone.message.bulk_delete_title": {
         readonly one: "Delete 1 item";
         readonly other: "Delete {count} items";
     };
-    readonly "ra.message.bulk_edit_description": {
+    readonly "chelone.message.bulk_edit_description": {
         readonly one: "Only the fields you change are applied to the selected record.";
         readonly other: "Only the fields you change are applied to the {count} selected records.";
     };
-    readonly "ra.message.bulk_edit_nested_source": "Bulk edit takes flat sources only, but {source} is nested.";
-    readonly "ra.message.bulk_update_content": {
+    readonly "chelone.message.bulk_edit_nested_source": "Bulk edit takes flat sources only, but {source} is nested.";
+    readonly "chelone.message.bulk_update_content": {
         readonly one: "Are you sure you want to update this item?";
         readonly other: "Are you sure you want to update these {count} items?";
     };
-    readonly "ra.message.bulk_update_title": {
+    readonly "chelone.message.bulk_update_title": {
         readonly one: "Update 1 item";
         readonly other: "Update {count} items";
     };
-    readonly "ra.message.clear_array_input": "Are you sure you want to clear the whole array?";
-    readonly "ra.message.delete_content": "Are you sure you want to delete this item?";
-    readonly "ra.message.delete_title": "Delete {name} {recordRepresentation}";
-    readonly "ra.navigation.clear_filters": "Clear filters";
-    readonly "ra.notification.application_update_available": "A new version of the application is available";
-    readonly "ra.notification.http_error": "Error";
-    readonly "ra.notification.offline": "You are offline";
-    readonly "ra.saved_queries.new_label": "Save current query";
-    readonly "ra.saved_queries.query_name": "Query name";
-    readonly "ra.saved_queries.remove_label_with_name": "Remove saved query \"{name}\"";
+    readonly "chelone.message.clear_array_input": "Are you sure you want to clear the whole array?";
+    readonly "chelone.message.delete_content": "Are you sure you want to delete this item?";
+    readonly "chelone.message.delete_title": "Delete {name} {recordRepresentation}";
+    readonly "chelone.navigation.clear_filters": "Clear filters";
+    readonly "chelone.notification.application_update_available": "A new version of the application is available";
+    readonly "chelone.notification.http_error_label": "Error";
+    readonly "chelone.notification.offline": "You are offline";
+    readonly "chelone.saved_queries.new_label": "Save current query";
+    readonly "chelone.saved_queries.query_name": "Query name";
+    readonly "chelone.saved_queries.remove_label_with_name": "Remove saved query \"{name}\"";
     readonly "chelone.assistant.close": "Close";
     readonly "chelone.assistant.confirm": "Run {name}?";
     readonly "chelone.assistant.error": "Something went wrong.";