@soxa-ui/plugins 0.0.0-stage → 0.3.0-beta.1

package/dist/locale/locale.plugin.js

@@ -0,0 +1,35 @@
+import { TBasePlugin } from "../base/base.class.js";
+//#region src/locale/locale.plugin.ts
+/**
+* TLocalePlugin — язык монтирования компоненту: тег локали в `locale`.
+*
+* Пишет владельцу тег локали поддерева (`ctx.locale`) при установке,
+* синхронно, — поэтому подписи дат на языке приложения есть уже в первой
+* отрисовке, и в серверной тоже. Смену локали пишет на лету: компонент не
+* перемонтируется. Подписка на источник живёт, пока жив набор, — её снимает
+* `destroy()` базы.
+*
+* Язык — не строка разметки, а вход модели: календарь считает им сетку и
+* первый день недели, поле даты — порядок частей, таблица — сравнение строк,
+* пагинация — цифры номеров страниц. Поэтому он свойство ядра (без setup его
+* задаёт код), а пишет его плагин: язык знает место компонента в дереве, а не
+* экземпляр. Своего языка у компонента в разметке нет: плагин переписывает и
+* `locale` внешнего `ctrl`.
+*
+* Владельца плагин знает по контракту (`ILocaleOwner`), а не по классу:
+* календарь, поле даты, DatePicker, таблица и пагинация общего предка не
+* имеют.
+*/
+var TLocalePlugin = class extends TBasePlugin {
+	install(ctx, options) {
+		super.install(ctx, options);
+		const owner = ctx.getInstance();
+		if (!owner) return;
+		owner.locale = ctx.locale.locale.tag;
+		this._listenTo(ctx.locale.events, "change", (locale) => {
+			owner.locale = locale.tag;
+		});
+	}
+};
+//#endregion
+export { TLocalePlugin };

package/dist/locale/locales/ar.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Арабский (Египет). Египет, а не Саудовская Аравия: у `ar-SA` календарь Intl
+ * по умолчанию исламский, а сетка календаря — григорианская.
+ */
+export declare const arEG: import("..").TLocale;

package/dist/locale/locales/ar.js

@@ -0,0 +1,59 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/ar.ts
+/**
+* Арабский (Египет). Египет, а не Саудовская Аравия: у `ar-SA` календарь Intl
+* по умолчанию исламский, а сетка календаря — григорианская.
+*/
+var arEG = freezeLocale({
+	tag: "ar-EG",
+	translations: {
+		modal: { close: "إغلاق" },
+		dialog: { maximize: "تكبير" },
+		popover: { close: "إغلاق" },
+		tabs: { close: "إغلاق {name}" },
+		tags: { close: "إغلاق {name}" },
+		toasts: {
+			region: "الإشعارات (F8)",
+			close: "إغلاق {name}"
+		},
+		scroller: {
+			prev: "التمرير للخلف",
+			next: "التمرير للأمام"
+		},
+		pagination: {
+			prev: "الصفحة السابقة",
+			next: "الصفحة التالية"
+		},
+		field: { clear: "مسح {name}" },
+		numberInput: {
+			increment: "زيادة {name}",
+			decrement: "تقليل {name}"
+		},
+		table: {
+			selectAll: "تحديد الكل",
+			sort: "فرز حسب {name}"
+		},
+		calendar: {
+			prevMonth: "الشهر السابق",
+			nextMonth: "الشهر التالي",
+			prevYear: "السنة السابقة",
+			nextYear: "السنة التالية",
+			prevYears: "الـ 12 سنة السابقة",
+			nextYears: "الـ 12 سنة التالية"
+		},
+		datePicker: {
+			trigger: "اختيار التاريخ",
+			start: "تاريخ البدء",
+			end: "تاريخ الانتهاء",
+			confirm: "حسنًا",
+			cancel: "إلغاء"
+		},
+		rating: {
+			value: "{value} من {max}",
+			required: "يُرجى اختيار تقييم"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { arEG };

package/dist/locale/locales/en.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Английский (США) — локаль по умолчанию: её получает набор без провайдера.
+ *
+ * `en-US`, а не язык среды: сервер и браузер без заданной локали рисуют одно
+ * и то же.
+ */
+export declare const enUS: import("..").TLocale;

package/dist/locale/locales/en.js

@@ -0,0 +1,61 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/en.ts
+/**
+* Английский (США) — локаль по умолчанию: её получает набор без провайдера.
+*
+* `en-US`, а не язык среды: сервер и браузер без заданной локали рисуют одно
+* и то же.
+*/
+var enUS = freezeLocale({
+	tag: "en-US",
+	translations: {
+		modal: { close: "Close" },
+		dialog: { maximize: "Maximize" },
+		popover: { close: "Close" },
+		tabs: { close: "Close {name}" },
+		tags: { close: "Close {name}" },
+		toasts: {
+			region: "Notifications (F8)",
+			close: "Close {name}"
+		},
+		scroller: {
+			prev: "Scroll back",
+			next: "Scroll forward"
+		},
+		pagination: {
+			prev: "Previous page",
+			next: "Next page"
+		},
+		field: { clear: "Clear {name}" },
+		numberInput: {
+			increment: "Increase {name}",
+			decrement: "Decrease {name}"
+		},
+		table: {
+			selectAll: "Select all",
+			sort: "Sort by {name}"
+		},
+		calendar: {
+			prevMonth: "Previous month",
+			nextMonth: "Next month",
+			prevYear: "Previous year",
+			nextYear: "Next year",
+			prevYears: "Previous 12 years",
+			nextYears: "Next 12 years"
+		},
+		datePicker: {
+			trigger: "Choose date",
+			start: "Start date",
+			end: "End date",
+			confirm: "OK",
+			cancel: "Cancel"
+		},
+		rating: {
+			value: "{value} of {max}",
+			required: "Please select a rating"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { enUS };

package/dist/locale/locales/es.d.ts

@@ -0,0 +1,2 @@
+/** Испанский (Испания). Другой регион — `extendLocale(esES, { tag: 'es-MX' })`. */
+export declare const esES: import("..").TLocale;

package/dist/locale/locales/es.js

@@ -0,0 +1,56 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/es.ts
+/** Испанский (Испания). Другой регион — `extendLocale(esES, { tag: 'es-MX' })`. */
+var esES = freezeLocale({
+	tag: "es-ES",
+	translations: {
+		modal: { close: "Cerrar" },
+		dialog: { maximize: "Maximizar" },
+		popover: { close: "Cerrar" },
+		tabs: { close: "Cerrar {name}" },
+		tags: { close: "Cerrar {name}" },
+		toasts: {
+			region: "Notificaciones (F8)",
+			close: "Cerrar {name}"
+		},
+		scroller: {
+			prev: "Desplazar hacia atrás",
+			next: "Desplazar hacia adelante"
+		},
+		pagination: {
+			prev: "Página anterior",
+			next: "Página siguiente"
+		},
+		field: { clear: "Borrar {name}" },
+		numberInput: {
+			increment: "Aumentar {name}",
+			decrement: "Disminuir {name}"
+		},
+		table: {
+			selectAll: "Seleccionar todo",
+			sort: "Ordenar por {name}"
+		},
+		calendar: {
+			prevMonth: "Mes anterior",
+			nextMonth: "Mes siguiente",
+			prevYear: "Año anterior",
+			nextYear: "Año siguiente",
+			prevYears: "12 años anteriores",
+			nextYears: "12 años siguientes"
+		},
+		datePicker: {
+			trigger: "Elegir fecha",
+			start: "Fecha de inicio",
+			end: "Fecha de fin",
+			confirm: "Aceptar",
+			cancel: "Cancelar"
+		},
+		rating: {
+			value: "{value} de {max}",
+			required: "Selecciona una valoración"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { esES };

package/dist/locale/locales/fr.d.ts

@@ -0,0 +1,2 @@
+/** Французский (Франция). */
+export declare const frFR: import("..").TLocale;

package/dist/locale/locales/fr.js

@@ -0,0 +1,56 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/fr.ts
+/** Французский (Франция). */
+var frFR = freezeLocale({
+	tag: "fr-FR",
+	translations: {
+		modal: { close: "Fermer" },
+		dialog: { maximize: "Agrandir" },
+		popover: { close: "Fermer" },
+		tabs: { close: "Fermer {name}" },
+		tags: { close: "Fermer {name}" },
+		toasts: {
+			region: "Notifications (F8)",
+			close: "Fermer {name}"
+		},
+		scroller: {
+			prev: "Défiler vers l’arrière",
+			next: "Défiler vers l’avant"
+		},
+		pagination: {
+			prev: "Page précédente",
+			next: "Page suivante"
+		},
+		field: { clear: "Effacer {name}" },
+		numberInput: {
+			increment: "Augmenter {name}",
+			decrement: "Diminuer {name}"
+		},
+		table: {
+			selectAll: "Tout sélectionner",
+			sort: "Trier par {name}"
+		},
+		calendar: {
+			prevMonth: "Mois précédent",
+			nextMonth: "Mois suivant",
+			prevYear: "Année précédente",
+			nextYear: "Année suivante",
+			prevYears: "12 années précédentes",
+			nextYears: "12 années suivantes"
+		},
+		datePicker: {
+			trigger: "Choisir une date",
+			start: "Date de début",
+			end: "Date de fin",
+			confirm: "OK",
+			cancel: "Annuler"
+		},
+		rating: {
+			value: "{value} sur {max}",
+			required: "Veuillez choisir une note"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { frFR };

package/dist/locale/locales/index.d.ts

@@ -0,0 +1,6 @@
+export { enUS } from './en';
+export { ruRU } from './ru';
+export { zhCN } from './zh';
+export { frFR } from './fr';
+export { esES } from './es';
+export { arEG } from './ar';

package/dist/locale/locales/ru.d.ts

@@ -0,0 +1,2 @@
+/** Русский (Россия). */
+export declare const ruRU: import("..").TLocale;

package/dist/locale/locales/ru.js

@@ -0,0 +1,56 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/ru.ts
+/** Русский (Россия). */
+var ruRU = freezeLocale({
+	tag: "ru-RU",
+	translations: {
+		modal: { close: "Закрыть" },
+		dialog: { maximize: "Развернуть" },
+		popover: { close: "Закрыть" },
+		tabs: { close: "Закрыть {name}" },
+		tags: { close: "Закрыть {name}" },
+		toasts: {
+			region: "Уведомления (F8)",
+			close: "Закрыть {name}"
+		},
+		scroller: {
+			prev: "Прокрутить назад",
+			next: "Прокрутить вперёд"
+		},
+		pagination: {
+			prev: "Предыдущая страница",
+			next: "Следующая страница"
+		},
+		field: { clear: "Очистить {name}" },
+		numberInput: {
+			increment: "Увеличить {name}",
+			decrement: "Уменьшить {name}"
+		},
+		table: {
+			selectAll: "Выбрать все",
+			sort: "Сортировать по столбцу {name}"
+		},
+		calendar: {
+			prevMonth: "Предыдущий месяц",
+			nextMonth: "Следующий месяц",
+			prevYear: "Предыдущий год",
+			nextYear: "Следующий год",
+			prevYears: "Предыдущие 12 лет",
+			nextYears: "Следующие 12 лет"
+		},
+		datePicker: {
+			trigger: "Выбрать дату",
+			start: "Дата начала",
+			end: "Дата окончания",
+			confirm: "ОК",
+			cancel: "Отмена"
+		},
+		rating: {
+			value: "{value} из {max}",
+			required: "Поставьте оценку"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { ruRU };

package/dist/locale/locales/zh.d.ts

@@ -0,0 +1,2 @@
+/** Китайский (Китай, упрощённое письмо). */
+export declare const zhCN: import("..").TLocale;

package/dist/locale/locales/zh.js

@@ -0,0 +1,56 @@
+import { freezeLocale } from "../locale.js";
+//#region src/locale/locales/zh.ts
+/** Китайский (Китай, упрощённое письмо). */
+var zhCN = freezeLocale({
+	tag: "zh-CN",
+	translations: {
+		modal: { close: "关闭" },
+		dialog: { maximize: "最大化" },
+		popover: { close: "关闭" },
+		tabs: { close: "关闭{name}" },
+		tags: { close: "关闭{name}" },
+		toasts: {
+			region: "通知 (F8)",
+			close: "关闭{name}"
+		},
+		scroller: {
+			prev: "向前滚动",
+			next: "向后滚动"
+		},
+		pagination: {
+			prev: "上一页",
+			next: "下一页"
+		},
+		field: { clear: "清除{name}" },
+		numberInput: {
+			increment: "增加{name}",
+			decrement: "减少{name}"
+		},
+		table: {
+			selectAll: "全选",
+			sort: "按{name}排序"
+		},
+		calendar: {
+			prevMonth: "上个月",
+			nextMonth: "下个月",
+			prevYear: "上一年",
+			nextYear: "下一年",
+			prevYears: "前 12 年",
+			nextYears: "后 12 年"
+		},
+		datePicker: {
+			trigger: "选择日期",
+			start: "开始日期",
+			end: "结束日期",
+			confirm: "确定",
+			cancel: "取消"
+		},
+		rating: {
+			value: "{value} 分，满分 {max} 分",
+			required: "请选择评分"
+		},
+		textarea: { counter: "{count} / {max}" }
+	}
+});
+//#endregion
+export { zhCN };

package/dist/locale/names.plugin.d.ts

@@ -0,0 +1,32 @@
+import { TBasePlugin } from '../base';
+import type { IPluginContext, TPluginEvents } from '../base';
+import type { TTranslations } from './types';
+/**
+ * TNamesPlugin — база плагинов имён (неймспейс `names`): строки локали в
+ * наборы компонента.
+ *
+ * Имена кнопок без текста — закрыть, развернуть, листать, очистить — строки
+ * языка, а язык знает место компонента в дереве, а не экземпляр: локаль
+ * приходит от провайдера адаптера в контекст плагина (`ctx.locale`), как id
+ * монтирования приходит в `createId`. Поэтому ядро имён не строит — оно
+ * держит живые наборы частей (`closeAria`, `prevAria`…) и пишет в них то, что
+ * знает само (`tabindex`, `aria-pressed`), а имя пишет плагин имён своего
+ * компонента: при установке, синхронно, — имена на языке приложения есть уже
+ * в первой и серверной отрисовке, — и на каждую смену локали, на лету.
+ *
+ * База держит то, что у всех плагинов имён одно: владельца, первую запись и
+ * подписку на смену локали. Наследник пишет имена (`_name`) и, если имя
+ * зависит от свойства владельца — текста таба, имени поля, — подписывается на
+ * его смену (`_watch`). Подписки живут, пока жив набор: их снимает
+ * `destroy()` базы.
+ */
+export declare abstract class TNamesPlugin<TOwner extends object, TEvents extends TPluginEvents = TPluginEvents> extends TBasePlugin<TOwner, TEvents> {
+    install(ctx: IPluginContext, options?: unknown): void;
+    /** Записать имена владельцу по строкам локали. */
+    protected abstract _name(owner: TOwner, translations: TTranslations): void;
+    /**
+     * Свои поводы переписать имена сверх смены локали — смена свойства
+     * владельца, из которого собрано имя. По умолчанию их нет.
+     */
+    protected _watch(_owner: TOwner, _name: () => void, _ctx: IPluginContext): void;
+}

package/dist/locale/names.plugin.js

@@ -0,0 +1,39 @@
+import { TBasePlugin } from "../base/base.class.js";
+//#region src/locale/names.plugin.ts
+/**
+* TNamesPlugin — база плагинов имён (неймспейс `names`): строки локали в
+* наборы компонента.
+*
+* Имена кнопок без текста — закрыть, развернуть, листать, очистить — строки
+* языка, а язык знает место компонента в дереве, а не экземпляр: локаль
+* приходит от провайдера адаптера в контекст плагина (`ctx.locale`), как id
+* монтирования приходит в `createId`. Поэтому ядро имён не строит — оно
+* держит живые наборы частей (`closeAria`, `prevAria`…) и пишет в них то, что
+* знает само (`tabindex`, `aria-pressed`), а имя пишет плагин имён своего
+* компонента: при установке, синхронно, — имена на языке приложения есть уже
+* в первой и серверной отрисовке, — и на каждую смену локали, на лету.
+*
+* База держит то, что у всех плагинов имён одно: владельца, первую запись и
+* подписку на смену локали. Наследник пишет имена (`_name`) и, если имя
+* зависит от свойства владельца — текста таба, имени поля, — подписывается на
+* его смену (`_watch`). Подписки живут, пока жив набор: их снимает
+* `destroy()` базы.
+*/
+var TNamesPlugin = class extends TBasePlugin {
+	install(ctx, options) {
+		super.install(ctx, options);
+		const owner = ctx.getInstance();
+		if (!owner) return;
+		const name = () => this._name(owner, ctx.locale.locale.translations);
+		name();
+		this._listenTo(ctx.locale.events, "change", name);
+		this._watch(owner, name, ctx);
+	}
+	/**
+	* Свои поводы переписать имена сверх смены локали — смена свойства
+	* владельца, из которого собрано имя. По умолчанию их нет.
+	*/
+	_watch(_owner, _name, _ctx) {}
+};
+//#endregion
+export { TNamesPlugin };

package/dist/locale/source.class.d.ts

@@ -0,0 +1,22 @@
+import { TEvented } from '@soxa-ui/core';
+import type { ILocaleSource, TLocale, TLocaleSourceEvents } from './types';
+/**
+ * TLocaleSource — локаль одного поддерева: текущее значение и его смена.
+ *
+ * Создаёт его провайдер адаптера — по источнику на провайдер, а не один на
+ * процесс: сервер рисует параллельные запросы каждый на своём языке, а
+ * вложенный провайдер даёт поддереву свой. Адаптер отдаёт источник сборке
+ * (`createAdapterContext`, опция `locale`), а сборка — набору плагинов
+ * (`IPluginContext.locale`). Плагины читают локаль при установке и
+ * подписываются на смену — компонент не перемонтируется.
+ *
+ * Набор без провайдера получает свой источник с английской локалью.
+ */
+export declare class TLocaleSource implements ILocaleSource {
+    private _locale;
+    readonly events: TEvented<TLocaleSourceEvents>;
+    constructor(_locale: TLocale);
+    get locale(): TLocale;
+    /** Та же локаль — ничего не меняет. */
+    set locale(value: TLocale);
+}

package/dist/locale/source.class.js

@@ -0,0 +1,32 @@
+import { TEvented } from "@soxa-ui/core";
+//#region src/locale/source.class.ts
+/**
+* TLocaleSource — локаль одного поддерева: текущее значение и его смена.
+*
+* Создаёт его провайдер адаптера — по источнику на провайдер, а не один на
+* процесс: сервер рисует параллельные запросы каждый на своём языке, а
+* вложенный провайдер даёт поддереву свой. Адаптер отдаёт источник сборке
+* (`createAdapterContext`, опция `locale`), а сборка — набору плагинов
+* (`IPluginContext.locale`). Плагины читают локаль при установке и
+* подписываются на смену — компонент не перемонтируется.
+*
+* Набор без провайдера получает свой источник с английской локалью.
+*/
+var TLocaleSource = class {
+	_locale;
+	events = new TEvented();
+	constructor(_locale) {
+		this._locale = _locale;
+	}
+	get locale() {
+		return this._locale;
+	}
+	/** Та же локаль — ничего не меняет. */
+	set locale(value) {
+		if (this._locale === value) return;
+		this._locale = value;
+		this.events.emit("change", value);
+	}
+};
+//#endregion
+export { TLocaleSource };