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

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

@@ -0,0 +1,156 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { defineType } from "../../../protected/define/prop-type.js";
+import { PopoverPointerPluginDescriptor } from "../plugins/popover-pointer.plugin.js";
+import { PopoverFocusPluginDescriptor } from "../plugins/popover-focus.plugin.js";
+import { SwipePluginDescriptor } from "../plugins/swipe.plugin.js";
+import { DismissPluginDescriptor } from "../plugins/dismiss.plugin.js";
+import { AriaPluginDescriptor } from "../plugins/aria.plugin.js";
+import { PopoverIdsPluginDescriptor } from "../plugins/popover-ids.plugin.js";
+import { PopoverNamesPluginDescriptor } from "../plugins/popover-names.plugin.js";
+import { ComponentViewDescriptor } from "./component-view.descriptor.js";
+import { TPopover } from "@soxa-ui/core";
+//#region content/descriptors/components/popover.descriptor.ts
+/**
+* Дескриптор Popover (TPopover) — панель с произвольным содержимым у триггера.
+*
+* Наследует ComponentViewDescriptor (rendered, visible, tag, наборы и плагины
+* element/ready) и добавляет открытость, кнопку закрытия, `lazyMount`,
+* сторону панели, жест, выходы для разметки и плагины: имя диалога, нажатие
+* мимо, клик по триггеру, модель фокуса, связки, имя кнопки закрытия от локали
+* и жест.
+*/
+var PopoverDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TPopover,
+	extends: ComponentViewDescriptor(),
+	contribution: {
+		/**
+		* Триггер — слот внутри корня, а не внешний элемент по ссылке: корень
+		* служит панели якорем, а нажатие по открытому триггеру остаётся
+		* нажатием внутри владельца, и панель не мигает. Своей ARIA у
+		* содержимого слота нет, поэтому сторону связки для него компонент
+		* отдаёт в scope — как `clear` у Select.
+		*/
+		slots: {
+			trigger: {
+				scope: {
+					triggerAria: defineType(Object),
+					triggerDataset: defineType(Object)
+				},
+				description: "Элемент, который открывает панель. ARIA и data-* для него — в scope"
+			},
+			default: { description: "Содержимое панели" },
+			"close-icon": { description: "Иконка кнопки закрытия" }
+		},
+		props: {
+			open: {
+				type: Boolean,
+				triggers: ["change:open"]
+			},
+			closable: {
+				type: Boolean,
+				triggers: ["change:closable"]
+			},
+			lazyMount: {
+				type: Boolean,
+				triggers: ["change:lazyMount"]
+			},
+			placement: {
+				type: String,
+				triggers: ["change:placement"]
+			},
+			/** Панель прижата к краю ближайшего позиционированного предка, а не встаёт у триггера. */
+			contained: {
+				type: Boolean,
+				triggers: ["change:contained"]
+			},
+			/**
+			* Край контейнера, к которому прижата панель внутри него: по нему же
+			* она уходит жестом, а полоса встаёт у противоположного края.
+			*/
+			edge: {
+				type: String,
+				triggers: ["change:edge"]
+			},
+			/** За что панель смахивают, чтобы закрыть. По умолчанию — ни за что. */
+			swipe: {
+				type: String,
+				triggers: ["change:swipe"]
+			},
+			/**
+			* Сторона триггера в связке с панелью и его вид «нажат». Вычисляют
+			* ядро и `TPopoverIdsPlugin` (`aria-controls`), шаблон раскладывает
+			* в scope слота `trigger`: оставь их в разметке — и формула
+			* повторится в каждом из шести адаптеров.
+			*/
+			triggerAria: {
+				type: Object,
+				protected: true,
+				triggers: ["change:triggerAria"]
+			},
+			triggerDataset: {
+				type: Object,
+				protected: true,
+				triggers: ["change:open"]
+			},
+			/**
+			* `data-*` панели: тянут ли её, а в контейнере — её край. Панель —
+			* Frame без экземпляра в ядре, и набор для неё — поповера, как
+			* `aria` панели. Открытость панели (`data-open`) пишет её слой.
+			*/
+			panelDataset: {
+				type: Object,
+				protected: true,
+				triggers: [
+					"change:swiping",
+					"change:contained",
+					"change:edge"
+				]
+			},
+			/**
+			* Набор кнопки закрытия: кнопка — сосед содержимого. Имя в него
+			* пишет `TPopoverNamesPlugin`.
+			*/
+			closeAria: {
+				type: Object,
+				protected: true,
+				triggers: ["change:closeAria"]
+			},
+			/** Смонтировано ли содержимое: `lazyMount` прячет его до первого открытия. */
+			contentRendered: {
+				type: Boolean,
+				protected: true,
+				triggers: ["change:open", "change:lazyMount"]
+			},
+			/**
+			* Рисовать ли полосу, за которую тянут. Вычисляет ядро: разметка
+			* без экземпляра формулу не повторяет.
+			*/
+			handleRendered: {
+				type: Boolean,
+				protected: true,
+				triggers: ["change:swipe"]
+			}
+		},
+		events: [
+			"change:open",
+			"change:closable",
+			"change:lazyMount",
+			"change:placement",
+			"change:contained",
+			"change:edge",
+			"change:swipe"
+		]
+	},
+	plugins: [
+		AriaPluginDescriptor,
+		DismissPluginDescriptor.with({ focusOutside: true }),
+		PopoverPointerPluginDescriptor,
+		PopoverFocusPluginDescriptor,
+		PopoverIdsPluginDescriptor,
+		PopoverNamesPluginDescriptor,
+		SwipePluginDescriptor
+	]
+}));
+//#endregion
+export { PopoverDescriptor };

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

@@ -0,0 +1,165 @@
+/**
+ * Дескриптор ProgressLinear (TProgressLinear) — индикатор выполнения линией.
+ *
+ * Наследует ProgressDescriptor (модель доли: значение, шкала, флаг бега,
+ * плагин имени — поверх StylableDescriptor) и добавляет ось и выход
+ * `percentStyle`.
+ */
+import { TProgressLinear } from '@soxa-ui/core';
+export declare const ProgressLinearDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TProgressLinear;
+    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+        readonly ctor: typeof import("@soxa-ui/core").TProgress;
+        readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+            readonly ctor: typeof import("@soxa-ui/core").TStylable;
+            readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                readonly ctor: typeof import("@soxa-ui/core").TComponentView;
+                readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                    readonly ctor: typeof import("@soxa-ui/core").TComponent;
+                    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                        readonly contribution: {
+                            readonly props: {
+                                readonly ctrl: {
+                                    readonly type: ObjectConstructor;
+                                };
+                                readonly embedded: {
+                                    readonly type: StringConstructor;
+                                };
+                                readonly pluginProps: {
+                                    readonly type: ObjectConstructor;
+                                };
+                            };
+                            readonly events: readonly ["bundle:create", "plugin:event"];
+                        };
+                    }>>;
+                    readonly contribution: {};
+                }>>;
+                readonly contribution: {
+                    readonly slots: {
+                        readonly default: {
+                            readonly description: "Содержимое компонента";
+                        };
+                    };
+                    readonly props: {
+                        readonly rendered: {
+                            readonly type: BooleanConstructor;
+                            readonly triggers: readonly ["change:rendered"];
+                        };
+                        readonly visible: {
+                            readonly type: BooleanConstructor;
+                            readonly triggers: readonly ["change:visible"];
+                        };
+                        readonly present: {
+                            readonly type: BooleanConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:rendered", "change:visible"];
+                        };
+                        readonly tag: {
+                            readonly type: readonly [StringConstructor, ObjectConstructor];
+                            readonly triggers: readonly ["change:tag"];
+                        };
+                        readonly direction: {
+                            readonly type: StringConstructor;
+                            readonly triggers: readonly ["change:direction"];
+                        };
+                        readonly classes: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:classes"];
+                        };
+                        readonly aria: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:aria"];
+                        };
+                        readonly dataset: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:dataset"];
+                        };
+                        readonly attrs: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:attrs"];
+                        };
+                    };
+                    readonly events: readonly ["show", "hide", "show:before", "hide:before", "ready", "change:rendered", "change:visible", "change:tag", "change:direction"];
+                };
+                readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TElementPlugin, "element", {
+                    readonly events: readonly ["ready", "removed"];
+                }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TReadyPlugin, "ready", import("../../..").IContribution>>];
+            }>>;
+            readonly contribution: {
+                readonly props: {
+                    readonly size: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:size"];
+                    };
+                    readonly variant: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:variant"];
+                    };
+                };
+                readonly events: readonly ["change:size", "change:variant"];
+            };
+        }>>;
+        readonly contribution: {
+            readonly props: {
+                readonly value: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:value"];
+                };
+                readonly min: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:min"];
+                };
+                readonly max: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:max"];
+                };
+                readonly indeterminate: {
+                    readonly type: BooleanConstructor;
+                    readonly triggers: readonly ["change:indeterminate"];
+                };
+            };
+            readonly events: readonly ["change:value", "change:min", "change:max", "change:indeterminate"];
+        };
+        readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TAriaPlugin, "aria", {
+            readonly props: {
+                readonly label: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:label"];
+                };
+                readonly labelledBy: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:labelledBy"];
+                };
+                readonly describedBy: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:describedBy"];
+                };
+            };
+            readonly events: readonly ["change:label", "change:labelledBy", "change:describedBy"];
+        }>>];
+    }>>;
+    readonly contribution: {
+        readonly props: {
+            /** Ось: `horizontal` (по умолчанию) или `vertical` — снизу вверх */
+            readonly orientation: {
+                readonly type: StringConstructor;
+                readonly triggers: readonly ["change:orientation"];
+            };
+            /**
+             * Доля готового — `--so-progress-linear-percent`. Считает ядро:
+             * в шести адаптерах одна формула была бы шесть раз. Пока полоса
+             * бежит, переменной нет — отсюда триггер флага.
+             */
+            readonly percentStyle: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:value", "change:min", "change:max", "change:indeterminate"];
+            };
+        };
+        readonly events: readonly ["change:orientation"];
+    };
+}>>;

package/dist/content/descriptors/components/progress-linear.descriptor.js

@@ -0,0 +1,43 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { ProgressDescriptor } from "./progress.descriptor.js";
+import { TProgressLinear } from "@soxa-ui/core";
+//#region content/descriptors/components/progress-linear.descriptor.ts
+/**
+* Дескриптор ProgressLinear (TProgressLinear) — индикатор выполнения линией.
+*
+* Наследует ProgressDescriptor (модель доли: значение, шкала, флаг бега,
+* плагин имени — поверх StylableDescriptor) и добавляет ось и выход
+* `percentStyle`.
+*/
+var ProgressLinearDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TProgressLinear,
+	extends: ProgressDescriptor(),
+	contribution: {
+		props: {
+			/** Ось: `horizontal` (по умолчанию) или `vertical` — снизу вверх */
+			orientation: {
+				type: String,
+				triggers: ["change:orientation"]
+			},
+			/**
+			* Доля готового — `--so-progress-linear-percent`. Считает ядро:
+			* в шести адаптерах одна формула была бы шесть раз. Пока полоса
+			* бежит, переменной нет — отсюда триггер флага.
+			*/
+			percentStyle: {
+				type: Object,
+				protected: true,
+				triggers: [
+					"change:value",
+					"change:min",
+					"change:max",
+					"change:indeterminate"
+				]
+			}
+		},
+		events: ["change:orientation"]
+	}
+}));
+//#endregion
+export { ProgressLinearDescriptor };

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

@@ -0,0 +1,161 @@
+/**
+ * Дескриптор ProgressSpinner (TProgressSpinner) — индикатор выполнения
+ * кольцом.
+ *
+ * Наследует ProgressDescriptor (модель доли: значение, шкала, флаг бега,
+ * плагин имени — поверх StylableDescriptor) и добавляет выход
+ * `fractionStyle`. Своих входов у кольца нет: оси у него нет, толщину даёт
+ * тема по размеру.
+ */
+import { TProgressSpinner } from '@soxa-ui/core';
+export declare const ProgressSpinnerDescriptor: () => import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+    readonly ctor: typeof TProgressSpinner;
+    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+        readonly ctor: typeof import("@soxa-ui/core").TProgress;
+        readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+            readonly ctor: typeof import("@soxa-ui/core").TStylable;
+            readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                readonly ctor: typeof import("@soxa-ui/core").TComponentView;
+                readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                    readonly ctor: typeof import("@soxa-ui/core").TComponent;
+                    readonly extends: import("../../..").IComponentDescriptor<import("../../../protected/define/inference.types").TContractFrom<{
+                        readonly contribution: {
+                            readonly props: {
+                                readonly ctrl: {
+                                    readonly type: ObjectConstructor;
+                                };
+                                readonly embedded: {
+                                    readonly type: StringConstructor;
+                                };
+                                readonly pluginProps: {
+                                    readonly type: ObjectConstructor;
+                                };
+                            };
+                            readonly events: readonly ["bundle:create", "plugin:event"];
+                        };
+                    }>>;
+                    readonly contribution: {};
+                }>>;
+                readonly contribution: {
+                    readonly slots: {
+                        readonly default: {
+                            readonly description: "Содержимое компонента";
+                        };
+                    };
+                    readonly props: {
+                        readonly rendered: {
+                            readonly type: BooleanConstructor;
+                            readonly triggers: readonly ["change:rendered"];
+                        };
+                        readonly visible: {
+                            readonly type: BooleanConstructor;
+                            readonly triggers: readonly ["change:visible"];
+                        };
+                        readonly present: {
+                            readonly type: BooleanConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:rendered", "change:visible"];
+                        };
+                        readonly tag: {
+                            readonly type: readonly [StringConstructor, ObjectConstructor];
+                            readonly triggers: readonly ["change:tag"];
+                        };
+                        readonly direction: {
+                            readonly type: StringConstructor;
+                            readonly triggers: readonly ["change:direction"];
+                        };
+                        readonly classes: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:classes"];
+                        };
+                        readonly aria: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:aria"];
+                        };
+                        readonly dataset: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:dataset"];
+                        };
+                        readonly attrs: {
+                            readonly type: ObjectConstructor;
+                            readonly protected: true;
+                            readonly triggers: readonly ["change:attrs"];
+                        };
+                    };
+                    readonly events: readonly ["show", "hide", "show:before", "hide:before", "ready", "change:rendered", "change:visible", "change:tag", "change:direction"];
+                };
+                readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TElementPlugin, "element", {
+                    readonly events: readonly ["ready", "removed"];
+                }>>, import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TReadyPlugin, "ready", import("../../..").IContribution>>];
+            }>>;
+            readonly contribution: {
+                readonly props: {
+                    readonly size: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:size"];
+                    };
+                    readonly variant: {
+                        readonly type: StringConstructor;
+                        readonly triggers: readonly ["change:variant"];
+                    };
+                };
+                readonly events: readonly ["change:size", "change:variant"];
+            };
+        }>>;
+        readonly contribution: {
+            readonly props: {
+                readonly value: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:value"];
+                };
+                readonly min: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:min"];
+                };
+                readonly max: {
+                    readonly type: NumberConstructor;
+                    readonly triggers: readonly ["change:max"];
+                };
+                readonly indeterminate: {
+                    readonly type: BooleanConstructor;
+                    readonly triggers: readonly ["change:indeterminate"];
+                };
+            };
+            readonly events: readonly ["change:value", "change:min", "change:max", "change:indeterminate"];
+        };
+        readonly plugins: readonly [import("../../..").IPluginDefinition<import("../../../protected/define/inference.types").TPluginContractFrom<import("@soxa-ui/plugins").TAriaPlugin, "aria", {
+            readonly props: {
+                readonly label: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:label"];
+                };
+                readonly labelledBy: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:labelledBy"];
+                };
+                readonly describedBy: {
+                    readonly type: StringConstructor;
+                    readonly triggers: readonly ["change:describedBy"];
+                };
+            };
+            readonly events: readonly ["change:label", "change:labelledBy", "change:describedBy"];
+        }>>];
+    }>>;
+    readonly contribution: {
+        readonly props: {
+            /**
+             * Доля готового — `--so-progress-spinner-fraction`, числом от 0
+             * до 1. Считает ядро, как `percentStyle` у линии. Пока кольцо
+             * бежит, переменной нет — отсюда триггер флага.
+             */
+            readonly fractionStyle: {
+                readonly type: ObjectConstructor;
+                readonly protected: true;
+                readonly triggers: readonly ["change:value", "change:min", "change:max", "change:indeterminate"];
+            };
+        };
+    };
+}>>;

package/dist/content/descriptors/components/progress-spinner.descriptor.js

@@ -0,0 +1,36 @@
+import { defineComponent } from "../../../protected/define/component.js";
+import { defineDescriptor } from "../../../protected/define/descriptor.js";
+import { ProgressDescriptor } from "./progress.descriptor.js";
+import { TProgressSpinner } from "@soxa-ui/core";
+//#region content/descriptors/components/progress-spinner.descriptor.ts
+/**
+* Дескриптор ProgressSpinner (TProgressSpinner) — индикатор выполнения
+* кольцом.
+*
+* Наследует ProgressDescriptor (модель доли: значение, шкала, флаг бега,
+* плагин имени — поверх StylableDescriptor) и добавляет выход
+* `fractionStyle`. Своих входов у кольца нет: оси у него нет, толщину даёт
+* тема по размеру.
+*/
+var ProgressSpinnerDescriptor = defineDescriptor(() => defineComponent({
+	ctor: TProgressSpinner,
+	extends: ProgressDescriptor(),
+	contribution: { props: { 
+	/**
+	* Доля готового — `--so-progress-spinner-fraction`, числом от 0
+	* до 1. Считает ядро, как `percentStyle` у линии. Пока кольцо
+	* бежит, переменной нет — отсюда триггер флага.
+	*/
+fractionStyle: {
+		type: Object,
+		protected: true,
+		triggers: [
+			"change:value",
+			"change:min",
+			"change:max",
+			"change:indeterminate"
+		]
+	} } }
+}));
+//#endregion
+export { ProgressSpinnerDescriptor };