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

package/dist/content/descriptors/components/control.descriptor.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Дескриптор Control (TControl).
+ *
+ * Наследует StylableDescriptor (size, variant, rendered, visible, present, tag, classes, element, instance)
+ * и добавляет disabled, focused.
+ */
+import { TControl } from '@soxa-ui/core';
+export declare const ControlDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TControl;
+    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+        readonly ctor: typeof import("@soxa-ui/core").TStylable;
+        readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+            readonly ctor: typeof import("@soxa-ui/core").TComponentView;
+            readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                readonly ctor: typeof import("@soxa-ui/core").TComponent;
+                readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                    readonly contribution: {
+                        readonly props: {
+                            readonly ctrl: {
+                                readonly type: ObjectConstructor;
+                            };
+                            readonly embedded: {
+                                readonly type: StringConstructor;
+                            };
+                            readonly pluginProps: {
+                                readonly type: ObjectConstructor;
+                            };
+                        };
+                        readonly events: readonly ["bundle:create", "plugin:event"];
+                    };
+                }>>;
+                readonly contribution: {};
+            }>>;
+            readonly contribution: {
+                readonly slots: {
+                    readonly default: {
+                        readonly description: "Содержимое компонента";
+                    };
+                };
+                readonly props: {
+                    readonly rendered: {
+                        readonly type: BooleanConstructor;
+                        readonly triggers: readonly ["change:rendered"];
+                    };
+                    readonly visible: {
+                        readonly type: BooleanConstructor;
+                        readonly triggers: readonly ["change:visible"];
+                    };
+                    readonly present: {
+                        readonly type: BooleanConstructor;
+                        readonly protected: true;
+                        readonly triggers: readonly ["change:rendered", "change:visible"];
+                    };
+                    readonly tag: {
+                        readonly type: readonly [StringConstructor, ObjectConstructor];
+                        readonly triggers: readonly ["change:tag"];
+                    };
+                    readonly direction: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:direction"];
+                    };
+                    readonly classes: {
+                        readonly type: ObjectConstructor;
+                        readonly protected: true;
+                        readonly triggers: readonly ["change:classes"];
+                    };
+                    readonly aria: {
+                        readonly type: ObjectConstructor;
+                        readonly protected: true;
+                        readonly triggers: readonly ["change:aria"];
+                    };
+                    readonly dataset: {
+                        readonly type: ObjectConstructor;
+                        readonly protected: true;
+                        readonly triggers: readonly ["change:dataset"];
+                    };
+                    readonly attrs: {
+                        readonly type: ObjectConstructor;
+                        readonly protected: true;
+                        readonly triggers: readonly ["change:attrs"];
+                    };
+                };
+                readonly events: readonly ["show", "hide", "show:before", "hide:before", "ready", "change:rendered", "change:visible", "change:tag", "change:direction"];
+            };
+            readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TElementPlugin, "element", {
+                readonly events: readonly ["ready", "removed"];
+            }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TReadyPlugin, "ready", import("../../..").IContribution>>];
+        }>>;
+        readonly contribution: {
+            readonly props: {
+                readonly size: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:size"];
+                };
+                readonly variant: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:variant"];
+                };
+            };
+            readonly events: readonly ["change:size", "change:variant"];
+        };
+    }>>;
+    readonly contribution: {
+        readonly props: {
+            readonly disabled: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:disabled"];
+            };
+            readonly focused: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:focused"];
+            };
+        };
+        readonly events: readonly ["change:disabled", "change:focused"];
+    };
+    readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TActionPlugin, "action", {
+        readonly events: readonly ["press", "click", "focus", "blur"];
+    }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TAriaPlugin, "aria", {
+        readonly props: {
+            readonly label: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:label"];
+            };
+            readonly labelledBy: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:labelledBy"];
+            };
+            readonly describedBy: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:describedBy"];
+            };
+        };
+        readonly events: readonly ["change:label", "change:labelledBy", "change:describedBy"];
+    }>>];
+}>>;

package/dist/content/descriptors/components/control.descriptor.js

@@ -0,0 +1,33 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { AriaPluginDescriptor } from "../plugins/aria.plugin.js";
+import { ActionPluginDescriptor } from "../plugins/action.plugin.js";
+import { StylableDescriptor } from "./stylable.descriptor.js";
+import { TControl } from "@soxa-ui/core";
+//#region content/descriptors/components/control.descriptor.ts
+/**
+* Дескриптор Control (TControl).
+*
+* Наследует StylableDescriptor (size, variant, rendered, visible, present, tag, classes, element, instance)
+* и добавляет disabled, focused.
+*/
+var ControlDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TControl,
+	extends: StylableDescriptor(),
+	contribution: {
+		props: {
+			disabled: {
+				type: Boolean,
+				triggers: ["change:disabled"]
+			},
+			focused: {
+				type: Boolean,
+				triggers: ["change:focused"]
+			}
+		},
+		events: ["change:disabled", "change:focused"]
+	},
+	plugins: [ActionPluginDescriptor, AriaPluginDescriptor]
+}));
+//#endregion
+export { ControlDescriptor };

package/dist/content/descriptors/components/date-input.descriptor.d.ts

@@ -0,0 +1,319 @@
+/**
+ * Дескриптор DateInput (TDateInput).
+ *
+ * Наследует `ClearableDescriptor` (кнопка очистки — clearable, clearAria — поверх
+ * value, name, readonly, required, id, disabled, size, variant, ...) и
+ * добавляет слоты `leading`, `clear` и `trailing`, границы и недоступные дни,
+ * вид поля — дата или дата со временем — и точность времени: до минуты или до
+ * секунды. Язык формата — тег локали поддерева: его пишет плагин языка, имя
+ * кнопки очистки — плагин имён поля.
+ * Значение вводится по частям в формате локали, а всё оно выделяется,
+ * копируется и удаляется, как текст: на компьютере части нередактируемые, их
+ * клавиши, указатель и буфер обмена переводят в команды ядра плагины поля.
+ * Касание пальцем или пером делает части редактируемыми — для экранной
+ * клавиатуры (сенсорный плагин).
+ *
+ * Разметка: корень — группа (`role="group"`, имя — `aria_label` или
+ * `aria_labelledBy`), в нём ряд частей — `spinbutton` с остановкой Tab у
+ * каждой — и скрытое поле формы. См. AGENTS.md, «Даты» и «Готовые паттерны».
+ */
+import { TDateInput } from '@soxa-ui/core';
+import type { IDateInput } from '@soxa-ui/core';
+export declare const DateInputDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TDateInput;
+    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+        readonly ctor: typeof import("@soxa-ui/core").TClearable;
+        readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+            readonly ctor: typeof import("@soxa-ui/core").TInputControl;
+            readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                readonly ctor: typeof import("@soxa-ui/core").TValueControl;
+                readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                    readonly ctor: typeof import("@soxa-ui/core").TControl;
+                    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                        readonly ctor: typeof import("@soxa-ui/core").TStylable;
+                        readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                            readonly ctor: typeof import("@soxa-ui/core").TComponentView;
+                            readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                                readonly ctor: typeof import("@soxa-ui/core").TComponent;
+                                readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                                    readonly contribution: {
+                                        readonly props: {
+                                            readonly ctrl: {
+                                                readonly type: ObjectConstructor;
+                                            };
+                                            readonly embedded: {
+                                                readonly type: StringConstructor;
+                                            };
+                                            readonly pluginProps: {
+                                                readonly type: ObjectConstructor;
+                                            };
+                                        };
+                                        readonly events: readonly ["bundle:create", "plugin:event"];
+                                    };
+                                }>>;
+                                readonly contribution: {};
+                            }>>;
+                            readonly contribution: {
+                                readonly slots: {
+                                    readonly default: {
+                                        readonly description: "Содержимое компонента";
+                                    };
+                                };
+                                readonly props: {
+                                    readonly rendered: {
+                                        readonly type: BooleanConstructor;
+                                        readonly triggers: readonly ["change:rendered"];
+                                    };
+                                    readonly visible: {
+                                        readonly type: BooleanConstructor;
+                                        readonly triggers: readonly ["change:visible"];
+                                    };
+                                    readonly present: {
+                                        readonly type: BooleanConstructor;
+                                        readonly protected: true;
+                                        readonly triggers: readonly ["change:rendered", "change:visible"];
+                                    };
+                                    readonly tag: {
+                                        readonly type: readonly [StringConstructor, ObjectConstructor];
+                                        readonly triggers: readonly ["change:tag"];
+                                    };
+                                    readonly direction: {
+                                        readonly type: StringConstructor;
+                                        readonly triggers: readonly ["change:direction"];
+                                    };
+                                    readonly classes: {
+                                        readonly type: ObjectConstructor;
+                                        readonly protected: true;
+                                        readonly triggers: readonly ["change:classes"];
+                                    };
+                                    readonly aria: {
+                                        readonly type: ObjectConstructor;
+                                        readonly protected: true;
+                                        readonly triggers: readonly ["change:aria"];
+                                    };
+                                    readonly dataset: {
+                                        readonly type: ObjectConstructor;
+                                        readonly protected: true;
+                                        readonly triggers: readonly ["change:dataset"];
+                                    };
+                                    readonly attrs: {
+                                        readonly type: ObjectConstructor;
+                                        readonly protected: true;
+                                        readonly triggers: readonly ["change:attrs"];
+                                    };
+                                };
+                                readonly events: readonly ["show", "hide", "show:before", "hide:before", "ready", "change:rendered", "change:visible", "change:tag", "change:direction"];
+                            };
+                            readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TElementPlugin, "element", {
+                                readonly events: readonly ["ready", "removed"];
+                            }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TReadyPlugin, "ready", import("../../..").IContribution>>];
+                        }>>;
+                        readonly contribution: {
+                            readonly props: {
+                                readonly size: {
+                                    readonly type: StringConstructor;
+                                    readonly triggers: readonly ["change:size"];
+                                };
+                                readonly variant: {
+                                    readonly type: StringConstructor;
+                                    readonly triggers: readonly ["change:variant"];
+                                };
+                            };
+                            readonly events: readonly ["change:size", "change:variant"];
+                        };
+                    }>>;
+                    readonly contribution: {
+                        readonly props: {
+                            readonly disabled: {
+                                readonly type: BooleanConstructor;
+                                readonly triggers: readonly ["change:disabled"];
+                            };
+                            readonly focused: {
+                                readonly type: BooleanConstructor;
+                                readonly triggers: readonly ["change:focused"];
+                            };
+                        };
+                        readonly events: readonly ["change:disabled", "change:focused"];
+                    };
+                    readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TActionPlugin, "action", {
+                        readonly events: readonly ["press", "click", "focus", "blur"];
+                    }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TAriaPlugin, "aria", {
+                        readonly props: {
+                            readonly label: {
+                                readonly type: StringConstructor;
+                                readonly triggers: readonly ["change:label"];
+                            };
+                            readonly labelledBy: {
+                                readonly type: StringConstructor;
+                                readonly triggers: readonly ["change:labelledBy"];
+                            };
+                            readonly describedBy: {
+                                readonly type: StringConstructor;
+                                readonly triggers: readonly ["change:describedBy"];
+                            };
+                        };
+                        readonly events: readonly ["change:label", "change:labelledBy", "change:describedBy"];
+                    }>>];
+                }>>;
+                readonly contribution: {
+                    readonly props: {
+                        readonly value: {
+                            readonly type: readonly [StringConstructor, NumberConstructor, BooleanConstructor, ObjectConstructor, ArrayConstructor];
+                            readonly triggers: readonly ["change:value"];
+                        };
+                        readonly name: {
+                            readonly type: StringConstructor;
+                            readonly triggers: readonly ["change:name"];
+                        };
+                    };
+                    readonly events: readonly ["change:value", "change:name"];
+                };
+            }>>;
+            readonly contribution: {
+                readonly props: {
+                    readonly readonly: {
+                        readonly type: BooleanConstructor;
+                        readonly triggers: readonly ["change:readonly"];
+                    };
+                    readonly required: {
+                        readonly type: BooleanConstructor;
+                        readonly triggers: readonly ["change:required"];
+                    };
+                };
+                readonly events: readonly ["change:readonly", "change:required"];
+            };
+            readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TIdPlugin, undefined, {
+                readonly props: {
+                    readonly id: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:id"];
+                    };
+                };
+                readonly events: readonly ["change:id"];
+            }>>];
+        }>>;
+        readonly contribution: {
+            readonly props: {
+                readonly clearable: {
+                    readonly type: BooleanConstructor;
+                    readonly triggers: readonly ["change:clearable"];
+                };
+                readonly clearAria: {
+                    readonly type: ObjectConstructor;
+                    readonly protected: true;
+                    readonly triggers: readonly ["change:clearAria"];
+                };
+            };
+            readonly events: readonly ["change:clearable"];
+        };
+    }>>;
+    readonly contribution: {
+        /**
+         * Слоты стоят по сторонам ряда частей, как у Input: в `trailing`
+         * DatePicker ставит кнопку календаря. Содержимое получает сам инстанс
+         * поля — кнопке рядом нужны его значение и команды. Кнопка очистки
+         * стоит в обёртке `trailing` перед его содержимым.
+         *
+         * Своя кнопка очистки (`clear`) заменяет встроенную целиком и
+         * рисуется, когда задана, без `clearable`. Scope — команда поля
+         * `clear`, привязанная к инстансу: кнопка зовёт её голой функцией.
+         */
+        readonly slots: {
+            readonly leading: {
+                readonly scope: {
+                    readonly ctrl: import("../../..").TPropType<IDateInput>;
+                };
+                readonly description: "Перед датой";
+            };
+            readonly clear: {
+                readonly scope: {
+                    readonly clear: import("../../..").TPropType<() => void>;
+                };
+                readonly description: "Кнопка очистки значения";
+            };
+            readonly trailing: {
+                readonly scope: {
+                    readonly ctrl: import("../../..").TPropType<IDateInput>;
+                };
+                readonly description: "После даты: кнопка календаря";
+            };
+        };
+        readonly props: {
+            /**
+             * Строкой: дата `YYYY-MM-DD` или, у поля даты и времени, дата со
+             * временем `YYYY-MM-DDTHH:mm`, с точностью до секунды —
+             * `YYYY-MM-DDTHH:mm:ss`. Другого значения у поля нет.
+             */
+            readonly value: {
+                readonly type: StringConstructor;
+            };
+            readonly min: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:min"];
+            };
+            readonly max: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:max"];
+            };
+            /**
+             * Недоступные дни — та же функция, что у календаря: день значения,
+             * который она отвергает, поле помечает ошибкой, как дату вне
+             * границ. Зовётся без якоря.
+             */
+            readonly unavailable: {
+                readonly type: FunctionConstructor;
+                readonly triggers: readonly ["change:unavailable"];
+            };
+            /**
+             * Язык формата — не вход: его задаёт приложение на всю библиотеку,
+             * и пишет плагин языка.
+             */
+            readonly locale: {
+                readonly type: StringConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:locale"];
+            };
+            /** `date` — дата, `datetime` — ещё час, минута и период суток по циклу локали. */
+            readonly kind: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:kind"];
+            };
+            /** `minute` — время до минуты, `second` — ещё секунда. У поля даты ничего не меняет. */
+            readonly timePrecision: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:timePrecision"];
+            };
+            /**
+             * Проверка набора: «00» у дня и месяца не записывается, часть ждёт
+             * следующей цифры. Выключена — верна ли дата, решает приложение.
+             */
+            readonly validate: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:validate"];
+            };
+            /**
+             * Части и разделители в порядке формата. Перечитываются на правку
+             * частей и наборов частей (`change:segments`) и на всё, что пишет
+             * их наборы ядро: локаль, вид поля и точность времени — текст,
+             * имена, порядок и состав частей, `disabled` — остановки Tab,
+             * `readonly` и `required` — `aria-readonly` и `aria-required`,
+             * границы и недоступные дни — `aria-invalid`.
+             */
+            readonly segments: {
+                readonly type: ArrayConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:segments", "change:locale", "change:kind", "change:timePrecision", "change:disabled", "change:readonly", "change:required", "change:min", "change:max", "change:unavailable"];
+            };
+            /** `dir` и `lang` ряда частей — по формату локали, виду поля и точности. */
+            readonly segmentsAttrs: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:locale", "change:kind", "change:timePrecision"];
+            };
+        };
+        readonly events: readonly ["change:min", "change:max", "change:unavailable", "change:locale", "change:kind", "change:timePrecision", "change:validate"];
+    };
+    readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TActionPlugin, "action", {
+        readonly events: readonly ["press", "click", "focus", "blur"];
+    }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TClearableNamesPlugin<import("@soxa-ui/core").IClearable<any, any, any>, import("@soxa-ui/plugins").TPluginEvents>, "names", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TLocalePlugin, "locale", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TDateInputKeyboardPlugin, "keyboard", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TDateInputPointerPlugin, "pointer", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TDateInputClipboardPlugin, "clipboard", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TDateInputTouchPlugin, "touch", import("../../..").IContribution>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TDateInputIdsPlugin, "ids", import("../../..").IContribution>>];
+}>>;