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

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

@@ -0,0 +1,109 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { FieldIdsPluginDescriptor } from "../plugins/field-ids.plugin.js";
+import { StylableDescriptor } from "./stylable.descriptor.js";
+import { TField } from "@soxa-ui/core";
+//#region content/descriptors/components/field.descriptor.ts
+/**
+* Дескриптор Field (TField) — поле формы: подпись, контрол, подсказка и
+* ошибка.
+*
+* Наследует StylableDescriptor (rendered, visible, tag, size, variant, наборы)
+* и добавляет тексты частей, ошибку поля, сторону подписи, наборы частей и
+* плагин связок. Своих состояний контрола у поля нет — ни `disabled`, ни
+* `required`: они у контрола, как у подписи `Label`.
+*
+* Части — разметка поля, а не компоненты: потребитель их не размещает и
+* пропсов им не задаёт (AGENTS.md, «Часть или слот»). Текст части — проп с её
+* именем, своя разметка вместо текста — слот `<часть>-content`: имя слота не
+* совпадает с именем пропа, как `text`/`content` у `Label`. Контрол — слот
+* `default`.
+*
+* С контролом поле связывает проводка адаптера (`TFieldExtension` у поля,
+* `TFieldControlExtension` у контрола): ошибку, `id` поля и ссылки на части
+* контрол берёт при сборке, о себе сообщает при приёме.
+*/
+var FieldDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TField,
+	extends: StylableDescriptor(),
+	contribution: {
+		slots: {
+			default: { description: "Контрол: Input, Select, CheckBox, Switch, DateInput, DatePicker, RadioGroup, Rating или Label с контролом" },
+			"label-content": { description: "Своя разметка подписи — только строчная. Рисуется, пока задан label" },
+			"helper-content": { description: "Своя разметка подсказки. Рисуется, пока задан helper и нет ошибки" },
+			"error-content": { description: "Своя разметка ошибки. Рисуется при invalid, пока задан error" }
+		},
+		props: {
+			label: {
+				type: String,
+				triggers: ["change:label"]
+			},
+			helper: {
+				type: String,
+				triggers: ["change:helper"]
+			},
+			error: {
+				type: String,
+				triggers: ["change:error"]
+			},
+			/**
+			* Ошибка поля: её видно, и контрол помечен ошибкой. Проверку и
+			* момент, когда её показывать, решает приложение.
+			*/
+			invalid: {
+				type: Boolean,
+				triggers: ["change:invalid"]
+			},
+			position: {
+				type: String,
+				triggers: ["change:position"]
+			},
+			/** Подсказку видно: текст есть, а ошибки не видно — она встаёт на её место. */
+			helperRendered: {
+				type: Boolean,
+				protected: true,
+				triggers: [
+					"change:helper",
+					"change:error",
+					"change:invalid"
+				]
+			},
+			/** Ошибку видно: поле невалидно, и текст ошибки есть. */
+			errorRendered: {
+				type: Boolean,
+				protected: true,
+				triggers: ["change:error", "change:invalid"]
+			},
+			/**
+			* Наборы частей — разметки без экземпляра, поэтому наборы поля, как
+			* `titleAria` у окна. `id` частей и `for` подписи пишет плагин
+			* связок.
+			*/
+			labelAria: {
+				type: Object,
+				protected: true,
+				triggers: ["change:labelAria"]
+			},
+			helperAria: {
+				type: Object,
+				protected: true,
+				triggers: ["change:helperAria"]
+			},
+			errorAria: {
+				type: Object,
+				protected: true,
+				triggers: ["change:errorAria"]
+			}
+		},
+		events: [
+			"change:label",
+			"change:helper",
+			"change:error",
+			"change:invalid",
+			"change:position"
+		]
+	},
+	plugins: [FieldIdsPluginDescriptor]
+}));
+//#endregion
+export { FieldDescriptor };

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

@@ -0,0 +1,191 @@
+/**
+ * Frame descriptor, extending LayerDescriptor with coordinates, dimensions,
+ * positioning strategy, contained layout and a default slot.
+ * Layer supplies visibility, teleport target and the shared stacking order;
+ * plugins supply layout, anchoring and the accessible name.
+ */
+import { TFrame } from '@soxa-ui/core';
+export declare const FrameDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TFrame;
+    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+        readonly ctor: typeof import("@soxa-ui/core").TLayer;
+        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 target: {
+                    readonly type: readonly [ObjectConstructor, StringConstructor];
+                    readonly triggers: readonly ["change:target"];
+                };
+            };
+            readonly events: readonly ["change:zIndex", "change:target"];
+        };
+    }>>;
+    readonly contribution: {
+        readonly slots: {
+            readonly default: {
+                readonly description: "Содержимое панели";
+            };
+        };
+        readonly props: {
+            readonly x: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:x"];
+            };
+            readonly y: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:y"];
+            };
+            readonly width: {
+                readonly type: readonly [NumberConstructor, StringConstructor];
+                readonly triggers: readonly ["change:width"];
+            };
+            readonly height: {
+                readonly type: readonly [NumberConstructor, StringConstructor];
+                readonly triggers: readonly ["change:height"];
+            };
+            readonly strategy: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:strategy"];
+            };
+            /**
+             * Панель внутри контейнера: разметка не телепортирует её, раскладка
+             * ставит `absolute` без координат, якорь не двигает.
+             */
+            readonly contained: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:contained"];
+            };
+        };
+        readonly events: readonly ["change:x", "change:y", "change:width", "change:height", "change:strategy", "change:contained"];
+    };
+    readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TFrameLayoutPlugin, "layout", {
+        readonly props: {
+            readonly styles: {
+                readonly protected: true;
+                readonly triggers: readonly ["change:styles"];
+            };
+        };
+    }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TAnchorPlugin, "anchor", {
+        readonly props: {
+            readonly anchor: {
+                readonly type: ObjectConstructor;
+                readonly triggers: readonly ["change:anchor"];
+                readonly get: (plugin: import("@soxa-ui/plugins").TAnchorPlugin) => Element | null;
+                readonly set: (plugin: import("@soxa-ui/plugins").TAnchorPlugin, value: Element | null) => void;
+            };
+            readonly point: {
+                readonly type: ObjectConstructor;
+                readonly triggers: readonly ["change:point"];
+            };
+            readonly placement: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:placement"];
+            };
+            readonly matchWidth: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:matchWidth"];
+            };
+            readonly flip: {
+                readonly type: BooleanConstructor;
+                readonly triggers: readonly ["change:flip"];
+            };
+            readonly offset: {
+                readonly type: NumberConstructor;
+                readonly triggers: readonly ["change:offset"];
+            };
+        };
+        readonly events: readonly ["change:anchor", "change:point", "change:placement", "change:matchWidth", "change:flip", "change:offset"];
+    }>>, 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/frame.descriptor.js

@@ -0,0 +1,66 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { AnchorPluginDescriptor } from "../plugins/anchor.plugin.js";
+import { AriaPluginDescriptor } from "../plugins/aria.plugin.js";
+import { FrameLayoutPluginDescriptor } from "../plugins/frame-layout.plugin.js";
+import { LayerDescriptor } from "./layer.descriptor.js";
+import { TFrame } from "@soxa-ui/core";
+//#region content/descriptors/components/frame.descriptor.ts
+/**
+* Frame descriptor, extending LayerDescriptor with coordinates, dimensions,
+* positioning strategy, contained layout and a default slot.
+* Layer supplies visibility, teleport target and the shared stacking order;
+* plugins supply layout, anchoring and the accessible name.
+*/
+var FrameDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TFrame,
+	extends: LayerDescriptor(),
+	contribution: {
+		slots: { default: { description: "Содержимое панели" } },
+		props: {
+			x: {
+				type: Number,
+				triggers: ["change:x"]
+			},
+			y: {
+				type: Number,
+				triggers: ["change:y"]
+			},
+			width: {
+				type: [Number, String],
+				triggers: ["change:width"]
+			},
+			height: {
+				type: [Number, String],
+				triggers: ["change:height"]
+			},
+			strategy: {
+				type: String,
+				triggers: ["change:strategy"]
+			},
+			/**
+			* Панель внутри контейнера: разметка не телепортирует её, раскладка
+			* ставит `absolute` без координат, якорь не двигает.
+			*/
+			contained: {
+				type: Boolean,
+				triggers: ["change:contained"]
+			}
+		},
+		events: [
+			"change:x",
+			"change:y",
+			"change:width",
+			"change:height",
+			"change:strategy",
+			"change:contained"
+		]
+	},
+	plugins: [
+		FrameLayoutPluginDescriptor,
+		AnchorPluginDescriptor,
+		AriaPluginDescriptor
+	]
+}));
+//#endregion
+export { FrameDescriptor };

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

@@ -0,0 +1,129 @@
+/**
+ * Дескриптор Icon (TIcon).
+ *
+ * Наследует ComponentViewDescriptor (rendered, visible, present, tag, classes, element, instance)
+ * и добавляет size, width, height + плагин IconStyle.
+ */
+import { TIcon } from '@soxa-ui/core';
+export declare const IconDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TIcon;
+    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 width: {
+                readonly type: readonly [StringConstructor, NumberConstructor];
+                readonly triggers: readonly ["change:width"];
+            };
+            readonly height: {
+                readonly type: readonly [StringConstructor, NumberConstructor];
+                readonly triggers: readonly ["change:height"];
+            };
+        };
+        readonly events: readonly ["change:size", "change:width", "change:height"];
+    };
+    readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TIconLayoutPlugin, "layout", {
+        readonly props: {
+            readonly styles: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:styles"];
+            };
+        };
+    }>>, 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/icon.descriptor.js

@@ -0,0 +1,41 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { AriaPluginDescriptor } from "../plugins/aria.plugin.js";
+import { IconLayoutPluginDescriptor } from "../plugins/icon-layout.plugin.js";
+import { ComponentViewDescriptor } from "./component-view.descriptor.js";
+import { TIcon } from "@soxa-ui/core";
+//#region content/descriptors/components/icon.descriptor.ts
+/**
+* Дескриптор Icon (TIcon).
+*
+* Наследует ComponentViewDescriptor (rendered, visible, present, tag, classes, element, instance)
+* и добавляет size, width, height + плагин IconStyle.
+*/
+var IconDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TIcon,
+	extends: ComponentViewDescriptor(),
+	contribution: {
+		props: {
+			size: {
+				type: String,
+				triggers: ["change:size"]
+			},
+			width: {
+				type: [String, Number],
+				triggers: ["change:width"]
+			},
+			height: {
+				type: [String, Number],
+				triggers: ["change:height"]
+			}
+		},
+		events: [
+			"change:size",
+			"change:width",
+			"change:height"
+		]
+	},
+	plugins: [IconLayoutPluginDescriptor, AriaPluginDescriptor.with({ role: "img" })]
+}));
+//#endregion
+export { IconDescriptor };

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

@@ -0,0 +1,50 @@
+export { LayerDescriptor } from './layer.descriptor';
+export { ModalLayerDescriptor } from './modal-layer.descriptor';
+export { FrameDescriptor } from './frame.descriptor';
+export { DialogDescriptor } from './dialog.descriptor';
+export { DrawerDescriptor } from './drawer.descriptor';
+export { SkeletonDescriptor } from './skeleton.descriptor';
+export { DragAndDropDescriptor } from './drag-and-drop.descriptor';
+export { VirtualDescriptor } from './virtual.descriptor';
+export { ButtonDescriptor } from './button.descriptor';
+export { ItemRowDescriptor } from './item-row.descriptor';
+export { SwitchDescriptor } from './switch.descriptor';
+export { CheckBoxDescriptor } from './check-box.descriptor';
+export { LabelDescriptor } from './label.descriptor';
+export { FieldDescriptor } from './field.descriptor';
+export { PopoverDescriptor } from './popover.descriptor';
+export { TooltipDescriptor } from './tooltip.descriptor';
+export { ScrollerDescriptor } from './scroller.descriptor';
+export { SliderDescriptor } from './slider.descriptor';
+export { RatingDescriptor } from './rating.descriptor';
+export { InputDescriptor } from './input.descriptor';
+export { NumberInputDescriptor } from './number-input.descriptor';
+export { TextareaDescriptor } from './textarea.descriptor';
+export { DateInputDescriptor } from './date-input.descriptor';
+export { DatePickerDescriptor } from './date-picker.descriptor';
+export { InputControlDescriptor } from './input-control.descriptor';
+export { ClearableDescriptor } from './clearable.descriptor';
+export { TextableDescriptor } from './textable.descriptor';
+export { ValueControlDescriptor } from './value-control.descriptor';
+export { InteractiveDescriptor } from './interactive.descriptor';
+export { ComponentDescriptor } from './component.descriptor';
+export { ComponentViewDescriptor } from './component-view.descriptor';
+export { ItemGroupDescriptor } from './item-group.descriptor';
+export { StylableDescriptor } from './stylable.descriptor';
+export { ControlDescriptor } from './control.descriptor';
+export { IconDescriptor } from './icon.descriptor';
+export { ProgressDescriptor } from './progress.descriptor';
+export { ProgressLinearDescriptor } from './progress-linear.descriptor';
+export { ProgressSpinnerDescriptor } from './progress-spinner.descriptor';
+export * from './tabs';
+export * from './accordion';
+export * from './collection';
+export * from './list-box';
+export * from './menu';
+export * from './tags';
+export * from './toasts';
+export * from './pagination';
+export * from './radio-group';
+export * from './select';
+export * from './calendar';
+export * from './table';