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

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

@@ -0,0 +1,164 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { defineType } from "../../../../protected/define/prop-type.js";
+import { LocalePluginDescriptor } from "../../plugins/locale.plugin.js";
+import { CollectionBundlesPluginDescriptor } from "../../plugins/collection-bundles.plugin.js";
+import { CollectionElementsPluginDescriptor } from "../../plugins/collection-elements.plugin.js";
+import { TableColumnReorderPluginDescriptor } from "../../plugins/table-column-reorder.plugin.js";
+import { TableGridPluginDescriptor } from "../../plugins/table-grid.plugin.js";
+import { TableLayoutPluginDescriptor } from "../../plugins/table-layout.plugin.js";
+import { TableNamesPluginDescriptor } from "../../plugins/table-names.plugin.js";
+import { ControlDescriptor } from "../control.descriptor.js";
+import { TTable } from "@soxa-ui/core";
+//#region content/descriptors/components/table/table.descriptor.ts
+/**
+* Дескриптор Table (TTable) — таблица по паттернам APG Table и Sortable Table.
+*
+* Наследует `ControlDescriptor` (disabled, focused, size, variant, имя
+* `aria_label` / `aria_labelledBy`, ...) и добавляет язык сортировки — тег
+* локали поддерева, его пишет плагин языка, — имя чекбокса «выбрать все» —
+* выход плагина имён (`names_selectAll`), — закреплённую шапку
+* (`stickyHead`): свойство вида таблицы, теме оно уходит `data-sticky-head`
+* в наборе `dataset` корня, — то, как колонки без своей ширины делят место
+* (`columnFit`): его читает раскладка колонок, а не тема. Место мерит плагин
+* раскладки — ширину окна таблицы, — и тема получает от ядра готовые ширины
+* колонок и признаки корня: `data-overflow` (колонки шире места) и
+* `data-sized` (ширина известна у каждой показанной колонки). И то, что идёт
+* за жестом перестановки колонки (`reorderPreview`): ничего, шапка или колонка
+* целиком, — его читает расширение колонок, и только в жесте `column` у корня
+* есть признак `data-reorder-preview`. Признаки жеста у корня ставит то же
+* расширение, и только на время жеста: `data-resizing` — тянут ручку
+* показанной колонки, `data-dragging` — переставляют колонку; по ним тема
+* держит курсор жеста на всей таблице. Строки, колонки, ячейки, выбор и
+* сортировка — коллекция и её расширения (`TableCollectionDescriptor`):
+* разметка только раскладывает то, что они отдали.
+*
+* Колонки и строки задаются только данными (`columns`, `items`): частей
+* разметкой у таблицы нет — заголовок колонки (`Table.Column`) и строку
+* (`Table.Row`) рисует она сама. Поэтому и слота по умолчанию у неё нет, а
+* содержимое заголовка и ячейки — статические слоты со scope: колонку
+* выбирают условием по `column.field`, как элемент коллекции по `item.value`
+* (AGENTS.md, «Слоты элементов»).
+*/
+var TableDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTable,
+	extends: ControlDescriptor(),
+	contribution: {
+		slots: {
+			/**
+			* Проброс слота заголовка колонки (`Table.Column`): его scope — текст
+			* и сортируемость колонки — плюс сама колонка.
+			*/
+			header: {
+				scope: {
+					column: defineType(Object),
+					text: defineType(String),
+					sortable: defineType(Boolean)
+				},
+				description: "Содержимое заголовка колонки. Без него — текст колонки"
+			},
+			/**
+			* `value` — поле записи под ключом колонки. Тип записи таблица не
+			* знает (`TTableRecord` — любой объект), поэтому значение —
+			* `unknown`, и сужает его потребитель.
+			*/
+			cell: {
+				scope: {
+					row: defineType(Object),
+					column: defineType(Object),
+					value: defineType(Object)
+				},
+				description: "Содержимое ячейки. Без него — значение текстом"
+			},
+			empty: { description: "Когда показанных строк нет" }
+		},
+		props: {
+			/**
+			* Язык сортировки — не вход: это тег локали поддерева, и пишет его
+			* плагин языка, как `size` элементам пишет владелец.
+			*/
+			locale: {
+				type: String,
+				protected: true,
+				triggers: ["change:locale"]
+			},
+			/**
+			* Шапка закреплена у верхнего края прокрутки, по умолчанию нет.
+			* Свойство таблицы, а не коллекции: строки и колонки от него не
+			* меняются, а закрепляет шапку тема по `data-sticky-head`.
+			*/
+			stickyHead: {
+				type: Boolean,
+				triggers: ["change:stickyHead"]
+			},
+			/**
+			* Как колонки без своей ширины делят место, по умолчанию `auto` —
+			* во всю ширину места. Значение библиотеки: его читает раскладка
+			* колонок, а теме оно не уходит.
+			*/
+			columnFit: {
+				type: String,
+				triggers: ["change:columnFit"]
+			},
+			/**
+			* Что идёт за жестом перестановки колонки: `none` — только взятый
+			* заголовок, соседи стоят, колонка встаёт на отпускании; по
+			* умолчанию `head` — шапка, а тело стоит до отпускания; `column` —
+			* и ячейки нарисованных строк. Модель от него не меняется. Значение читает
+			* расширение колонок, а не тема: в `column` оно ставит корню
+			* `data-reorder-preview` только на время жеста, и тело тема ведёт
+			* по этому признаку — на покое таблица за режим не платит.
+			*/
+			reorderPreview: {
+				type: String,
+				triggers: ["change:reorderPreview"]
+			},
+			/**
+			* Что идёт за протяжкой ручки ширины: по умолчанию `live` — сама
+			* колонка; `deferred` — призрак новой границы, а ширина пишется
+			* на отпускании. Значение читает ядро колонки, а теме уходит
+			* только признак отложенного жеста на заголовке.
+			*/
+			resizePreview: {
+				type: String,
+				triggers: ["change:resizePreview"]
+			},
+			/**
+			* Ручка ширины у колонок без своего `resizable`, по умолчанию нет.
+			* Своё значение колонки сильнее — исключение в обе стороны.
+			*/
+			resizable: {
+				type: Boolean,
+				triggers: ["change:resizable"]
+			},
+			/**
+			* Перестановка колонок без своего `reorderable`, по умолчанию нет.
+			* Своё значение колонки сильнее.
+			*/
+			reorderable: {
+				type: Boolean,
+				triggers: ["change:reorderable"]
+			}
+		},
+		events: [
+			"change:locale",
+			"change:stickyHead",
+			"change:columnFit",
+			"change:reorderPreview",
+			"change:resizePreview",
+			"change:resizable",
+			"change:reorderable"
+		]
+	},
+	plugins: [
+		LocalePluginDescriptor,
+		TableNamesPluginDescriptor,
+		CollectionBundlesPluginDescriptor,
+		CollectionElementsPluginDescriptor,
+		TableLayoutPluginDescriptor,
+		TableColumnReorderPluginDescriptor,
+		TableGridPluginDescriptor
+	]
+}));
+//#endregion
+export { TableDescriptor };

package/dist/content/descriptors/components/tabs/collection.descriptor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Дескрипторы коллекционной части Tabs — фасады владельца и таба.
+ *
+ * Членство в коллекции отделено от собственных пропсов компонента
+ * (`TabsDescriptor`, `TabsItemDescriptor`): адаптер собирает компонент из обоих
+ * рантайм-списков.
+ */
+import { TTabsCollectionFacade, TTabsItemCollectionFacade } from '@soxa-ui/core';
+export declare const TabsCollectionDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTabsCollectionFacade;
+    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 владельца Tabs (выводятся фасадом TTabsCollectionFacade).
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly activeItem: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:activation"];
+            };
+        };
+        readonly events: readonly ["item:activated", "item:deactivated", "item:close", "change:activation"];
+    };
+}>>;
+export declare const TabsCollectionItemDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTabsItemCollectionFacade;
+    /**
+     * Item-level пропсы элемента Tabs (выводятся фасадом TTabsItemCollectionFacade).
+     */
+    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 tab_closable: {
+                readonly type: BooleanConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:closable"];
+            };
+        };
+        readonly events: readonly ["change:active", "change:order"];
+    };
+}>>;

package/dist/content/descriptors/components/tabs/collection.descriptor.js

@@ -0,0 +1,59 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { CollectionDescriptor } from "../collection/collection.descriptor.js";
+import { TTabsCollectionFacade, TTabsItemCollectionFacade } from "@soxa-ui/core";
+//#region content/descriptors/components/tabs/collection.descriptor.ts
+/**
+* Дескрипторы коллекционной части Tabs — фасады владельца и таба.
+*
+* Членство в коллекции отделено от собственных пропсов компонента
+* (`TabsDescriptor`, `TabsItemDescriptor`): адаптер собирает компонент из обоих
+* рантайм-списков.
+*/
+var TabsCollectionDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTabsCollectionFacade,
+	extends: CollectionDescriptor(),
+	/**
+	* Коллекционные props/events владельца Tabs (выводятся фасадом TTabsCollectionFacade).
+	*/
+	contribution: {
+		props: { activeItem: {
+			type: Object,
+			protected: true,
+			triggers: ["change:activation"]
+		} },
+		events: [
+			"item:activated",
+			"item:deactivated",
+			"item:close",
+			"change:activation"
+		]
+	}
+}));
+var TabsCollectionItemDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTabsItemCollectionFacade,
+	/**
+	* Item-level пропсы элемента Tabs (выводятся фасадом TTabsItemCollectionFacade).
+	*/
+	contribution: {
+		props: {
+			active: {
+				type: Boolean,
+				triggers: ["change:active"]
+			},
+			order: {
+				type: Number,
+				protected: true,
+				triggers: ["change:order"]
+			},
+			tab_closable: {
+				type: Boolean,
+				protected: true,
+				triggers: ["change:closable"]
+			}
+		},
+		events: ["change:active", "change:order"]
+	}
+}));
+//#endregion
+export { TabsCollectionDescriptor, TabsCollectionItemDescriptor };

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

@@ -0,0 +1,136 @@
+/**
+ * Дескрипторы панели таба (`TabsContent`).
+ *
+ * Две штуки — как у элемента: собственный (props панели) и коллекционный
+ * (активность и ARIA-связка, выводятся фасадом). Смешивать нельзя: core
+ * отвечает за props и events, коллекционная часть — за членство в коллекции.
+ */
+import { TTabsContent, TTabsContentCollectionFacade } from '@soxa-ui/core';
+export declare const TabsContentDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTabsContent;
+    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>>];
+    }>>;
+    /** Собственные props панели (выводятся классом TTabsContent). */
+    readonly contribution: {
+        readonly props: {
+            readonly value: {
+                readonly type: readonly [StringConstructor, NumberConstructor];
+                readonly triggers: readonly ["change:value"];
+            };
+        };
+        readonly slots: {
+            readonly default: {
+                readonly description: "Содержимое панели";
+            };
+        };
+        readonly events: readonly ["change:value"];
+    };
+    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"];
+    }>>, import("../../../..").IPluginDefinition<import("../../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TTabsContentWarnPlugin, "contentWarn", import("../../../..").IContribution>>];
+}>>;
+export declare const TabsCollectionContentDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TTabsContentCollectionFacade;
+    /**
+     * Коллекционные props панели (выводятся фасадом TTabsContentCollectionFacade).
+     *
+     * Отделены от собственных ровно как у элемента (`TabsCollectionItemDescriptor`):
+     * активность — свойство членства в коллекции, а не панели.
+     *
+     * ARIA-связки здесь нет: `id` и `aria-labelledby` пишет прямо в `aria`
+     * панели `TTabsContentBindingExtension` — то единственное место, где
+     * известно, что панель и таб нашли друг друга. `role` и `tabindex` панель
+     * пишет себе сама.
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly active: {
+                readonly type: BooleanConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:active"];
+            };
+        };
+        readonly events: readonly ["change:active"];
+    };
+}>>;

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

@@ -0,0 +1,52 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { IdPluginDescriptor } from "../../plugins/id.plugin.js";
+import { TabsContentWarnPluginDescriptor } from "../../plugins/tabs-content-warn.plugin.js";
+import { ComponentViewDescriptor } from "../component-view.descriptor.js";
+import { TTabsContent, TTabsContentCollectionFacade } from "@soxa-ui/core";
+//#region content/descriptors/components/tabs/content.descriptor.ts
+/**
+* Дескрипторы панели таба (`TabsContent`).
+*
+* Две штуки — как у элемента: собственный (props панели) и коллекционный
+* (активность и ARIA-связка, выводятся фасадом). Смешивать нельзя: core
+* отвечает за props и events, коллекционная часть — за членство в коллекции.
+*/
+var TabsContentDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTabsContent,
+	extends: ComponentViewDescriptor(),
+	/** Собственные props панели (выводятся классом TTabsContent). */
+	contribution: {
+		props: { value: {
+			type: [String, Number],
+			triggers: ["change:value"]
+		} },
+		slots: { default: { description: "Содержимое панели" } },
+		events: ["change:value"]
+	},
+	plugins: [IdPluginDescriptor, TabsContentWarnPluginDescriptor]
+}));
+var TabsCollectionContentDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TTabsContentCollectionFacade,
+	/**
+	* Коллекционные props панели (выводятся фасадом TTabsContentCollectionFacade).
+	*
+	* Отделены от собственных ровно как у элемента (`TabsCollectionItemDescriptor`):
+	* активность — свойство членства в коллекции, а не панели.
+	*
+	* ARIA-связки здесь нет: `id` и `aria-labelledby` пишет прямо в `aria`
+	* панели `TTabsContentBindingExtension` — то единственное место, где
+	* известно, что панель и таб нашли друг друга. `role` и `tabindex` панель
+	* пишет себе сама.
+	*/
+	contribution: {
+		props: { active: {
+			type: Boolean,
+			protected: true,
+			triggers: ["change:active"]
+		} },
+		events: ["change:active"]
+	}
+}));
+//#endregion
+export { TabsCollectionContentDescriptor, TabsContentDescriptor };

package/dist/content/descriptors/components/tabs/index.d.ts

@@ -0,0 +1,4 @@
+export { TabsDescriptor } from './tabs.descriptor';
+export { TabsItemDescriptor } from './item.descriptor';
+export { TabsContentDescriptor, TabsCollectionContentDescriptor } from './content.descriptor';
+export { TabsCollectionDescriptor, TabsCollectionItemDescriptor } from './collection.descriptor';