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

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

@@ -0,0 +1,240 @@
+/**
+ * Дескриптор Tags (TTags).
+ *
+ * Наследует `ValueControlDescriptor` и добавляет `closable` плюс плагины
+ * коллекции и клавиатуру. Списочных плагинов ListBox (высота, подсветка,
+ * прокрутка) и drag-and-drop здесь нет: у ListBox фокус на контейнере, а у
+ * Tags с выбором он ходит по самим тегам — у каждого свой крестик. Модель —
+ * APG Listbox на roving tabindex, как у Tabs: весь набор — одна остановка
+ * Tab, стрелки между тегами (`TagsKeyboardPluginDescriptor`). Без выбора
+ * (`mode="none"`) набор — список без действия у строк, и клавиатура молчит.
+ * См. AGENTS, «Граница переиспользования» и «Готовые паттерны».
+ */
+import { TTags } from '@soxa-ui/core';
+import type { ITagsItem } from '@soxa-ui/core';
+export declare const TagsDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTags;
+    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: {
+        /**
+         * Tags — не список: заголовка и подвала ListBox здесь нет, потому что у
+         * задачи нет потребителя для них. Слоты элементов статические и
+         * получают элемент через scope (см. ListBox).
+         *
+         * `default` отдаёт показанные теги (`shown` — состав после отбора):
+         * своя разметка раскладывает их, как ей нужно, — в ленту `Scroller`,
+         * в ряд с хвостом в `Popover` за кнопкой. Своего замера и панели у
+         * набора нет, и раскладка сверх `wrap` и `scroll` — дело того, кто
+         * заполняет слот.
+         *
+         * Слоты тегов при работе через проп `items` — проброс слотов тега:
+         * `item-<слот>` (`default` — `item`), scope — scope слота тега плюс
+         * сам тег.
+         */
+        readonly slots: {
+            readonly default: {
+                readonly scope: {
+                    readonly shown: import("../../../..").TPropType<readonly ITagsItem<import("@soxa-ui/core").ITagsItemProps, import("@soxa-ui/core").TTagsItemEvents>[]>;
+                };
+                readonly description: "Теги — элементы коллекции; scope — показанные теги";
+            };
+            readonly item: {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<ITagsItem<import("@soxa-ui/core").ITagsItemProps, import("@soxa-ui/core").TTagsItemEvents>>;
+                    readonly text: import("../../../..").TPropType<string>;
+                    readonly selected: import("../../../..").TPropType<boolean>;
+                };
+                readonly description: "Содержимое тега при работе через проп items";
+            };
+            readonly 'item-leading': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<ITagsItem<import("@soxa-ui/core").ITagsItemProps, import("@soxa-ui/core").TTagsItemEvents>>;
+                };
+                readonly description: "Перед содержимым тега";
+            };
+            readonly 'item-trailing': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<ITagsItem<import("@soxa-ui/core").ITagsItemProps, import("@soxa-ui/core").TTagsItemEvents>>;
+                };
+                readonly description: "После содержимого тега";
+            };
+            readonly 'item-close-icon': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<ITagsItem<import("@soxa-ui/core").ITagsItemProps, import("@soxa-ui/core").TTagsItemEvents>>;
+                };
+                readonly description: "Иконка кнопки закрытия тега";
+            };
+        };
+        readonly props: {
+            readonly closable: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:closable"];
+            };
+            /**
+             * Внешний вид тегов — модификатор набора: по нему тема рисует
+             * пилюлю каждого тега целиком, вместе с кнопкой закрытия. Тегам
+             * значение не доставляется.
+             */
+            readonly view: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:view"];
+            };
+            /**
+             * Что делать с тегами, которым не хватило ширины ряда: переносить
+             * (`wrap`, по умолчанию) или прокручивать (`scroll`). Само значение
+             * уезжает в тему через `data-overflow`.
+             */
+            readonly overflow: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:overflow"];
+            };
+        };
+        readonly events: readonly ["change:closable", "change:view", "change:overflow"];
+    };
+    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").TCollectionBundlesPlugin, "bundles", import("../../../..").IContribution>>, import("../../../..").IPluginDefinition<import("../../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TCollectionElements, "elements", import("../../../..").IContribution>>, import("../../../..").IPluginDefinition<import("../../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TTagsKeyboardPlugin, "keyboard", import("../../../..").IContribution>>, import("../../../..").IPluginDefinition<import("../../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TTagsScrollPlugin, "scroll", import("../../../..").IContribution>>];
+}>>;

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

@@ -0,0 +1,109 @@
+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 { CollectionBundlesPluginDescriptor } from "../../plugins/collection-bundles.plugin.js";
+import { CollectionElementsPluginDescriptor } from "../../plugins/collection-elements.plugin.js";
+import { TagsKeyboardPluginDescriptor } from "../../plugins/tags-keyboard.plugin.js";
+import { TagsScrollPluginDescriptor } from "../../plugins/tags-scroll.plugin.js";
+import { ValueControlDescriptor } from "../value-control.descriptor.js";
+import { TTags } from "@soxa-ui/core";
+import { tagStopOf } from "@soxa-ui/plugins";
+//#region content/descriptors/components/tags/tags.descriptor.ts
+/**
+* Дескриптор Tags (TTags).
+*
+* Наследует `ValueControlDescriptor` и добавляет `closable` плюс плагины
+* коллекции и клавиатуру. Списочных плагинов ListBox (высота, подсветка,
+* прокрутка) и drag-and-drop здесь нет: у ListBox фокус на контейнере, а у
+* Tags с выбором он ходит по самим тегам — у каждого свой крестик. Модель —
+* APG Listbox на roving tabindex, как у Tabs: весь набор — одна остановка
+* Tab, стрелки между тегами (`TagsKeyboardPluginDescriptor`). Без выбора
+* (`mode="none"`) набор — список без действия у строк, и клавиатура молчит.
+* См. AGENTS, «Граница переиспользования» и «Готовые паттерны».
+*/
+var TagsDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTags,
+	extends: ValueControlDescriptor(),
+	contribution: {
+		/**
+		* Tags — не список: заголовка и подвала ListBox здесь нет, потому что у
+		* задачи нет потребителя для них. Слоты элементов статические и
+		* получают элемент через scope (см. ListBox).
+		*
+		* `default` отдаёт показанные теги (`shown` — состав после отбора):
+		* своя разметка раскладывает их, как ей нужно, — в ленту `Scroller`,
+		* в ряд с хвостом в `Popover` за кнопкой. Своего замера и панели у
+		* набора нет, и раскладка сверх `wrap` и `scroll` — дело того, кто
+		* заполняет слот.
+		*
+		* Слоты тегов при работе через проп `items` — проброс слотов тега:
+		* `item-<слот>` (`default` — `item`), scope — scope слота тега плюс
+		* сам тег.
+		*/
+		slots: {
+			default: {
+				scope: { shown: defineType(Array) },
+				description: "Теги — элементы коллекции; scope — показанные теги"
+			},
+			item: {
+				scope: {
+					item: defineType(Object),
+					text: defineType(String),
+					selected: defineType(Boolean)
+				},
+				description: "Содержимое тега при работе через проп items"
+			},
+			"item-leading": {
+				scope: { item: defineType(Object) },
+				description: "Перед содержимым тега"
+			},
+			"item-trailing": {
+				scope: { item: defineType(Object) },
+				description: "После содержимого тега"
+			},
+			"item-close-icon": {
+				scope: { item: defineType(Object) },
+				description: "Иконка кнопки закрытия тега"
+			}
+		},
+		props: {
+			closable: {
+				type: Boolean,
+				triggers: ["change:closable"]
+			},
+			/**
+			* Внешний вид тегов — модификатор набора: по нему тема рисует
+			* пилюлю каждого тега целиком, вместе с кнопкой закрытия. Тегам
+			* значение не доставляется.
+			*/
+			view: {
+				type: String,
+				triggers: ["change:view"]
+			},
+			/**
+			* Что делать с тегами, которым не хватило ширины ряда: переносить
+			* (`wrap`, по умолчанию) или прокручивать (`scroll`). Само значение
+			* уезжает в тему через `data-overflow`.
+			*/
+			overflow: {
+				type: String,
+				triggers: ["change:overflow"]
+			}
+		},
+		events: [
+			"change:closable",
+			"change:view",
+			"change:overflow"
+		]
+	},
+	plugins: [
+		ActionPluginDescriptor.with({ focusTarget: tagStopOf }),
+		CollectionBundlesPluginDescriptor,
+		CollectionElementsPluginDescriptor,
+		TagsKeyboardPluginDescriptor,
+		TagsScrollPluginDescriptor
+	]
+}));
+//#endregion
+export { TagsDescriptor };

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

@@ -0,0 +1,147 @@
+/**
+ * Дескриптор Textable (TTextable).
+ *
+ * Наследует ControlDescriptor (disabled, focused, size, variant, ...)
+ * и добавляет text.
+ */
+import { TTextable } from '@soxa-ui/core';
+export declare const TextableDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTextable;
+    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 text: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:text"];
+            };
+        };
+        readonly events: readonly ["change:text"];
+    };
+}>>;

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

@@ -0,0 +1,24 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { ControlDescriptor } from "./control.descriptor.js";
+import { TTextable } from "@soxa-ui/core";
+//#region content/descriptors/components/textable.descriptor.ts
+/**
+* Дескриптор Textable (TTextable).
+*
+* Наследует ControlDescriptor (disabled, focused, size, variant, ...)
+* и добавляет text.
+*/
+var TextableDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTextable,
+	extends: ControlDescriptor(),
+	contribution: {
+		props: { text: {
+			type: String,
+			triggers: ["change:text"]
+		} },
+		events: ["change:text"]
+	}
+}));
+//#endregion
+export { TextableDescriptor };