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

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

@@ -0,0 +1,149 @@
+/**
+ * Дескриптор Progress (TProgress) — индикатор выполнения, общая база линии и
+ * кольца.
+ *
+ * Наследует StylableDescriptor (rendered, visible, present, tag, direction,
+ * наборы, size, variant, плагины element/ready) и добавляет модель доли:
+ * значение, шкалу, флаг бега и плагин имени. Форму — ось, выход доли в своём
+ * виде — приносят наследники.
+ */
+import { TProgress } from '@soxa-ui/core';
+export declare const ProgressDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TProgress;
+    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: {
+            /** Сколько готово — число на шкале от `min` до `max`, по умолчанию 0 */
+            readonly value: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:value"];
+            };
+            readonly min: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:min"];
+            };
+            readonly max: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:max"];
+            };
+            /**
+             * Доля неизвестна — индикатор бежит. Главнее `value`: оно
+             * хранится и вернётся, когда бег снимут
+             */
+            readonly indeterminate: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:indeterminate"];
+            };
+        };
+        readonly events: readonly ["change:value", "change:min", "change:max", "change:indeterminate"];
+    };
+    readonly plugins: readonly [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/progress.descriptor.js

@@ -0,0 +1,53 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { AriaPluginDescriptor } from "../plugins/aria.plugin.js";
+import { StylableDescriptor } from "./stylable.descriptor.js";
+import { TProgress } from "@soxa-ui/core";
+//#region content/descriptors/components/progress.descriptor.ts
+/**
+* Дескриптор Progress (TProgress) — индикатор выполнения, общая база линии и
+* кольца.
+*
+* Наследует StylableDescriptor (rendered, visible, present, tag, direction,
+* наборы, size, variant, плагины element/ready) и добавляет модель доли:
+* значение, шкалу, флаг бега и плагин имени. Форму — ось, выход доли в своём
+* виде — приносят наследники.
+*/
+var ProgressDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TProgress,
+	extends: StylableDescriptor(),
+	contribution: {
+		props: {
+			/** Сколько готово — число на шкале от `min` до `max`, по умолчанию 0 */
+			value: {
+				type: Number,
+				triggers: ["change:value"]
+			},
+			min: {
+				type: Number,
+				triggers: ["change:min"]
+			},
+			max: {
+				type: Number,
+				triggers: ["change:max"]
+			},
+			/**
+			* Доля неизвестна — индикатор бежит. Главнее `value`: оно
+			* хранится и вернётся, когда бег снимут
+			*/
+			indeterminate: {
+				type: Boolean,
+				triggers: ["change:indeterminate"]
+			}
+		},
+		events: [
+			"change:value",
+			"change:min",
+			"change:max",
+			"change:indeterminate"
+		]
+	},
+	plugins: [AriaPluginDescriptor]
+}));
+//#endregion
+export { ProgressDescriptor };

package/dist/content/descriptors/components/radio-group/collection.descriptor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Дескрипторы коллекционной части RadioGroup — фасады владельца и радио.
+ *
+ * Членство в коллекции отделено от собственных пропсов компонента
+ * (`RadioGroupDescriptor`, `RadioGroupItemDescriptor`): адаптер собирает
+ * компонент из обоих рантайм-списков.
+ */
+import { TRadioGroupCollectionFacade, TRadioGroupItemCollectionFacade } from '@soxa-ui/core';
+export declare const RadioGroupCollectionDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TRadioGroupCollectionFacade;
+    readonly extends: import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+        readonly contribution: {
+            readonly props: {
+                readonly engine: {
+                    readonly type: ObjectConstructor;
+                };
+                readonly items: {
+                    readonly type: ArrayConstructor;
+                    readonly triggers: readonly ["change:items"];
+                };
+                readonly shown: {
+                    readonly type: ArrayConstructor;
+                    readonly protected: true;
+                    readonly triggers: readonly ["change:shown"];
+                };
+                readonly trackBy: {
+                    readonly type: FunctionConstructor;
+                    readonly triggers: readonly ["change:trackBy"];
+                };
+            };
+            readonly events: readonly ["engine:create", "item:add:before", "item:added", "item:remove:before", "item:removed", "item:update:before", "item:updated", "item:move:before", "item:moved", "items:clear:before", "change:count", "reset", "items:added", "items:removed", "change:shown", "change:items", "change:trackBy"];
+        };
+    }>>;
+    /**
+     * Коллекционные props/events владельца RadioGroup — то, что выводит фасад
+     * `TRadioGroupCollectionFacade`: отмеченное радио. Наружу значение
+     * отдаёт `value` группы, поэтому `activeItem` только на чтение.
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly activeItem: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:activation"];
+            };
+        };
+        readonly events: readonly ["item:activated", "item:deactivated", "change:activation"];
+    };
+}>>;
+export declare const RadioGroupCollectionItemDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TRadioGroupItemCollectionFacade;
+    /**
+     * Item-level пропсы радио — то, что выводит фасад
+     * `TRadioGroupItemCollectionFacade`: отмечено ли радио и его порядок.
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly active: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:active"];
+            };
+            readonly order: {
+                readonly type: NumberConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:order"];
+            };
+        };
+        readonly events: readonly ["change:active", "change:order"];
+    };
+}>>;

package/dist/content/descriptors/components/radio-group/collection.descriptor.js

@@ -0,0 +1,56 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { CollectionDescriptor } from "../collection/collection.descriptor.js";
+import { TRadioGroupCollectionFacade, TRadioGroupItemCollectionFacade } from "@soxa-ui/core";
+//#region content/descriptors/components/radio-group/collection.descriptor.ts
+/**
+* Дескрипторы коллекционной части RadioGroup — фасады владельца и радио.
+*
+* Членство в коллекции отделено от собственных пропсов компонента
+* (`RadioGroupDescriptor`, `RadioGroupItemDescriptor`): адаптер собирает
+* компонент из обоих рантайм-списков.
+*/
+var RadioGroupCollectionDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TRadioGroupCollectionFacade,
+	extends: CollectionDescriptor(),
+	/**
+	* Коллекционные props/events владельца RadioGroup — то, что выводит фасад
+	* `TRadioGroupCollectionFacade`: отмеченное радио. Наружу значение
+	* отдаёт `value` группы, поэтому `activeItem` только на чтение.
+	*/
+	contribution: {
+		props: { activeItem: {
+			type: Object,
+			protected: true,
+			triggers: ["change:activation"]
+		} },
+		events: [
+			"item:activated",
+			"item:deactivated",
+			"change:activation"
+		]
+	}
+}));
+var RadioGroupCollectionItemDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TRadioGroupItemCollectionFacade,
+	/**
+	* Item-level пропсы радио — то, что выводит фасад
+	* `TRadioGroupItemCollectionFacade`: отмечено ли радио и его порядок.
+	*/
+	contribution: {
+		props: {
+			active: {
+				type: Boolean,
+				triggers: ["change:active"]
+			},
+			order: {
+				type: Number,
+				protected: true,
+				triggers: ["change:order"]
+			}
+		},
+		events: ["change:active", "change:order"]
+	}
+}));
+//#endregion
+export { RadioGroupCollectionDescriptor, RadioGroupCollectionItemDescriptor };

package/dist/content/descriptors/components/radio-group/index.d.ts

@@ -0,0 +1,3 @@
+export { RadioGroupDescriptor } from './radio-group.descriptor';
+export { RadioGroupItemDescriptor } from './item.descriptor';
+export { RadioGroupCollectionDescriptor, RadioGroupCollectionItemDescriptor, } from './collection.descriptor';

package/dist/content/descriptors/components/radio-group/item.descriptor.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Дескриптор RadioGroupItem (TRadioGroupItem).
+ *
+ * Наследует `ValueControlDescriptor` (value, name, disabled, focused, size,
+ * variant, ...) и добавляет `view`. Текста у радио нет — это голый контрол,
+ * как CheckBox: подпись кладут слотом, а без неё имя дают `aria_label` или
+ * `aria_labelledBy`.
+ *
+ * `size`, `variant`, `view` и `name` раздаёт группа — и только она, поэтому
+ * входами разметки они у радио не объявлены: `size` и `variant` сняты общим
+ * фрагментом, `view` объявлен защищённым сразу, `name` — переобъявлением
+ * унаследованного (см. `TComponentDescriptor`, «переобъявление пропа»). Своё
+ * `name` вдобавок ломало браузерную группировку радио: стрелки по кругу и
+ * одна остановка Tab работают по общему имени.
+ */
+import { TRadioGroupItem } from '@soxa-ui/core';
+export declare const RadioGroupItemDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TRadioGroupItem;
+    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 events: readonly ["change:view"];
+        readonly slots: {
+            readonly default: {
+                readonly scope: {
+                    readonly active: import("../../../..").TPropType<boolean>;
+                };
+                readonly description: "Подпись радио";
+            };
+        };
+        readonly props: {
+            readonly view: {
+                readonly type: StringConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:view"];
+            };
+            readonly name: {
+                readonly protected: true;
+            };
+            readonly size: {
+                readonly protected: true;
+            };
+            readonly variant: {
+                readonly protected: true;
+            };
+        };
+    };
+    readonly plugins: readonly [import("../../../..").IPluginDefinition<import("../../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TActionPlugin, "action", {
+        readonly events: readonly ["press", "click", "focus", "blur"];
+    }>>];
+}>>;

package/dist/content/descriptors/components/radio-group/item.descriptor.js

@@ -0,0 +1,47 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { defineType } from "../../../../protected/define/prop-type.js";
+import { ActionPluginDescriptor } from "../../plugins/action.plugin.js";
+import { OWNER_STYLE_PROPS } from "../stylable.descriptor.js";
+import { ValueControlDescriptor } from "../value-control.descriptor.js";
+import { TRadioGroupItem } from "@soxa-ui/core";
+import { fieldOf } from "@soxa-ui/plugins";
+//#region content/descriptors/components/radio-group/item.descriptor.ts
+/**
+* Дескриптор RadioGroupItem (TRadioGroupItem).
+*
+* Наследует `ValueControlDescriptor` (value, name, disabled, focused, size,
+* variant, ...) и добавляет `view`. Текста у радио нет — это голый контрол,
+* как CheckBox: подпись кладут слотом, а без неё имя дают `aria_label` или
+* `aria_labelledBy`.
+*
+* `size`, `variant`, `view` и `name` раздаёт группа — и только она, поэтому
+* входами разметки они у радио не объявлены: `size` и `variant` сняты общим
+* фрагментом, `view` объявлен защищённым сразу, `name` — переобъявлением
+* унаследованного (см. `TComponentDescriptor`, «переобъявление пропа»). Своё
+* `name` вдобавок ломало браузерную группировку радио: стрелки по кругу и
+* одна остановка Tab работают по общему имени.
+*/
+var RadioGroupItemDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TRadioGroupItem,
+	extends: ValueControlDescriptor(),
+	contribution: {
+		events: ["change:view"],
+		slots: { default: {
+			scope: { active: defineType(Boolean) },
+			description: "Подпись радио"
+		} },
+		props: {
+			...OWNER_STYLE_PROPS,
+			view: {
+				type: String,
+				protected: true,
+				triggers: ["change:view"]
+			},
+			name: { protected: true }
+		}
+	},
+	plugins: [ActionPluginDescriptor.with({ focusTarget: fieldOf })]
+}));
+//#endregion
+export { RadioGroupItemDescriptor };