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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuri Soldatov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# @soxa-ui/setup
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**What all six adapters share: component descriptors, the assembly that runs on mount, and the
+exchange of values with a framework.**
+
+Part of [Soxa UI](https://github.com/youra-h/soxa-ui) — UI components with the logic written once: a
+framework-agnostic core and thin adapters that render it in Vue, React, Angular, Svelte, Solid and
+Web Components.
+
+A component contract — props, events and slots — is declared once, in a descriptor, and every
+adapter derives its API from it. Naming follows each framework's conventions, but the names, the
+defaults and the write rules are the same everywhere, because they live here.
+
+## Install
+
+```bash
+npm install @soxa-ui/setup
+```
+
+It comes with every adapter package, so an application installs it directly only to register
+plugins, extensions, a theme or an icon pack.
+
+## Usage
+
+Registering what the application adds to the library — the entry point:
+
+```ts
+import { useIcons, useTheme, usePlugins, useExtensions } from '@soxa-ui/setup'
+import * as material from '@soxa-ui/icons-material'
+import oren from '@soxa-ui/theme-oren/setup'
+
+useIcons(material) // icon roles: check, close, arrowDown, …
+useTheme(oren) // plugins and extensions the theme's CSS reads
+usePlugins(TButton, [TTimerPlugin]) // your plugin on every Button
+useExtensions(TTags, [(owner) => new TTagsHistoryExtension({ owner })])
+```
+
+Describing a component — a descriptor is the single record of its public surface:
+
+```ts
+import { defineComponent, defineDescriptor } from '@soxa-ui/setup'
+
+export const ButtonDescriptor = defineDescriptor(() =>
+  defineComponent({
+    ctor: TButton,
+    extends: TextableDescriptor(),
+    contribution: {
+      props: { view: { type: String, triggers: ['change:view'] } },
+      slots: { leading: {}, default: {}, trailing: {} },
+    },
+  }),
+)
+```
+
+## Documentation
+
+- [Soxa UI README](https://github.com/youra-h/soxa-ui#readme) — what the library is and how it is
+  put together.
+- [Architecture overview](https://github.com/youra-h/soxa-ui/blob/main/docs/architecture.md) —
+  layers, descriptors, plugins, collections, adapters.
+
+## License
+
+[MIT](https://github.com/youra-h/soxa-ui/blob/main/LICENSE)

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

@@ -0,0 +1,205 @@
+/**
+ * Дескриптор Accordion (TAccordion).
+ *
+ * Наследование:
+ * - ControlDescriptor (disabled, focused, size, variant, rendered, visible, present, tag, classes)
+ *
+ * Добавляет: view + плагины (коллекция + drag-and-drop).
+ */
+import { TAccordion } from '@soxa-ui/core';
+import type { IAccordionItem } from '@soxa-ui/core';
+export declare const AccordionDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TAccordion;
+    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: {
+        /**
+         * Слоты элементов статические и получают элемент через scope:
+         * динамические имена вида `item:<value>:leading` резолвит только Vue.
+         * Адресация конкретного элемента — условием внутри слота по `item.value`.
+         *
+         * Панель отдельным компонентом не стала: она лежит внутри элемента и
+         * отдельно от него не существует, поэтому осталась слотом `item-content`.
+         * Сравни с Tabs, где панель — сосед списка, пишется отдельно и
+         * связывается по `value`.
+         *
+         * Каждый слот элемента есть здесь как `item-<слот>`, и scope у него —
+         * scope слота элемента плюс сам элемент. Имена — по смыслу у владельца:
+         * заголовок элемента (`header`) — `item`, панель (`default`) —
+         * `item-content`.
+         */
+        readonly slots: {
+            readonly default: {
+                readonly description: "Элементы коллекции";
+            };
+            readonly item: {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<IAccordionItem<import("@soxa-ui/core").IAccordionItemProps, import("@soxa-ui/core").TAccordionItemEvents>>;
+                    readonly text: import("../../../..").TPropType<string>;
+                    readonly selected: import("../../../..").TPropType<boolean>;
+                };
+                readonly description: "Заголовок элемента при работе через проп items";
+            };
+            readonly 'item-arrow-icon': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<IAccordionItem<import("@soxa-ui/core").IAccordionItemProps, import("@soxa-ui/core").TAccordionItemEvents>>;
+                };
+                readonly description: "Стрелка заголовка элемента на стороне arrowPlacement";
+            };
+            readonly 'item-leading': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<IAccordionItem<import("@soxa-ui/core").IAccordionItemProps, import("@soxa-ui/core").TAccordionItemEvents>>;
+                };
+                readonly description: "Перед заголовком элемента";
+            };
+            readonly 'item-trailing': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<IAccordionItem<import("@soxa-ui/core").IAccordionItemProps, import("@soxa-ui/core").TAccordionItemEvents>>;
+                };
+                readonly description: "После заголовка элемента";
+            };
+            readonly 'item-content': {
+                readonly scope: {
+                    readonly item: import("../../../..").TPropType<IAccordionItem<import("@soxa-ui/core").IAccordionItemProps, import("@soxa-ui/core").TAccordionItemEvents>>;
+                };
+                readonly description: "Содержимое раскрывающейся панели";
+            };
+        };
+        readonly props: {
+            readonly view: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:view"];
+            };
+        };
+        readonly events: readonly ["change:view"];
+    };
+    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").TDragPlugin, "drag", import("../../../..").IContribution>>];
+}>>;

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

@@ -0,0 +1,80 @@
+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 { DragPluginDescriptor } from "../../plugins/drag.plugin.js";
+import { ControlDescriptor } from "../control.descriptor.js";
+import { TAccordion } from "@soxa-ui/core";
+import { firstHeaderOf } from "@soxa-ui/plugins";
+//#region content/descriptors/components/accordion/accordion.descriptor.ts
+/**
+* Дескриптор Accordion (TAccordion).
+*
+* Наследование:
+* - ControlDescriptor (disabled, focused, size, variant, rendered, visible, present, tag, classes)
+*
+* Добавляет: view + плагины (коллекция + drag-and-drop).
+*/
+var AccordionDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TAccordion,
+	extends: ControlDescriptor(),
+	contribution: {
+		/**
+		* Слоты элементов статические и получают элемент через scope:
+		* динамические имена вида `item:<value>:leading` резолвит только Vue.
+		* Адресация конкретного элемента — условием внутри слота по `item.value`.
+		*
+		* Панель отдельным компонентом не стала: она лежит внутри элемента и
+		* отдельно от него не существует, поэтому осталась слотом `item-content`.
+		* Сравни с Tabs, где панель — сосед списка, пишется отдельно и
+		* связывается по `value`.
+		*
+		* Каждый слот элемента есть здесь как `item-<слот>`, и scope у него —
+		* scope слота элемента плюс сам элемент. Имена — по смыслу у владельца:
+		* заголовок элемента (`header`) — `item`, панель (`default`) —
+		* `item-content`.
+		*/
+		slots: {
+			default: { description: "Элементы коллекции" },
+			item: {
+				scope: {
+					item: defineType(Object),
+					text: defineType(String),
+					selected: defineType(Boolean)
+				},
+				description: "Заголовок элемента при работе через проп items"
+			},
+			"item-arrow-icon": {
+				scope: { item: defineType(Object) },
+				description: "Стрелка заголовка элемента на стороне arrowPlacement"
+			},
+			"item-leading": {
+				scope: { item: defineType(Object) },
+				description: "Перед заголовком элемента"
+			},
+			"item-trailing": {
+				scope: { item: defineType(Object) },
+				description: "После заголовка элемента"
+			},
+			"item-content": {
+				scope: { item: defineType(Object) },
+				description: "Содержимое раскрывающейся панели"
+			}
+		},
+		props: { view: {
+			type: String,
+			triggers: ["change:view"]
+		} },
+		events: ["change:view"]
+	},
+	plugins: [
+		ActionPluginDescriptor.with({ focusTarget: firstHeaderOf }),
+		CollectionBundlesPluginDescriptor,
+		CollectionElementsPluginDescriptor,
+		DragPluginDescriptor
+	]
+}));
+//#endregion
+export { AccordionDescriptor };

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

@@ -0,0 +1,76 @@
+/**
+ * Дескрипторы коллекционной части Accordion — фасады владельца и элемента.
+ *
+ * Членство в коллекции отделено от собственных пропсов компонента
+ * (`AccordionDescriptor`, `AccordionItemDescriptor`): адаптер собирает компонент
+ * из обоих рантайм-списков.
+ */
+import { TAccordionCollectionFacade, TAccordionItemCollectionFacade } from '@soxa-ui/core';
+export declare const AccordionCollectionDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TAccordionCollectionFacade;
+    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 владельца Accordion (выводятся фасадом TAccordionCollectionFacade).
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly mode: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:mode"];
+            };
+            readonly selected: {
+                readonly type: ArrayConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:selection"];
+            };
+        };
+        readonly events: readonly ["change:mode", "change:selection"];
+    };
+}>>;
+export declare const AccordionCollectionItemDescriptor: () => import("../../../..").IComponentDescriptor<import("../../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TAccordionItemCollectionFacade;
+    /**
+     * Item-level пропсы элемента Accordion (выводятся фасадом TAccordionItemCollectionFacade).
+     */
+    readonly contribution: {
+        readonly props: {
+            readonly selected: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:selected"];
+            };
+            readonly order: {
+                readonly type: NumberConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:order"];
+            };
+            readonly view: {
+                readonly type: StringConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:view"];
+            };
+        };
+        readonly events: readonly ["change:selected", "change:order"];
+    };
+}>>;

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

@@ -0,0 +1,60 @@
+import { defineComponent } from "../../../../protected/define/component.js";
+import { defineDescriptor } from "../../../../protected/define/descriptor.js";
+import { CollectionDescriptor } from "../collection/collection.descriptor.js";
+import { TAccordionCollectionFacade, TAccordionItemCollectionFacade } from "@soxa-ui/core";
+//#region content/descriptors/components/accordion/collection.descriptor.ts
+/**
+* Дескрипторы коллекционной части Accordion — фасады владельца и элемента.
+*
+* Членство в коллекции отделено от собственных пропсов компонента
+* (`AccordionDescriptor`, `AccordionItemDescriptor`): адаптер собирает компонент
+* из обоих рантайм-списков.
+*/
+var AccordionCollectionDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TAccordionCollectionFacade,
+	extends: CollectionDescriptor(),
+	/**
+	* Коллекционные props/events владельца Accordion (выводятся фасадом TAccordionCollectionFacade).
+	*/
+	contribution: {
+		props: {
+			mode: {
+				type: String,
+				triggers: ["change:mode"]
+			},
+			selected: {
+				type: Array,
+				protected: true,
+				triggers: ["change:selection"]
+			}
+		},
+		events: ["change:mode", "change:selection"]
+	}
+}));
+var AccordionCollectionItemDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TAccordionItemCollectionFacade,
+	/**
+	* Item-level пропсы элемента Accordion (выводятся фасадом TAccordionItemCollectionFacade).
+	*/
+	contribution: {
+		props: {
+			selected: {
+				type: Boolean,
+				triggers: ["change:selected"]
+			},
+			order: {
+				type: Number,
+				protected: true,
+				triggers: ["change:order"]
+			},
+			view: {
+				type: String,
+				protected: true,
+				triggers: ["change:view"]
+			}
+		},
+		events: ["change:selected", "change:order"]
+	}
+}));
+//#endregion
+export { AccordionCollectionDescriptor, AccordionCollectionItemDescriptor };

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

@@ -0,0 +1,3 @@
+export { AccordionDescriptor } from './accordion.descriptor';
+export { AccordionItemDescriptor } from './item.descriptor';
+export { AccordionCollectionDescriptor, AccordionCollectionItemDescriptor, } from './collection.descriptor';