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

package/dist/adapter/common/attributes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Атрибуты и пропсы ядра. Атрибут — всегда строка, и значение приводится по
+ * `type` декларации: типы по порядку, значение даёт первый, который строку
+ * принимает, — спор строки и булева решает порядок, как во Vue. Снятый
+ * атрибут у булева пропа — `false`, у остальных — «проп не задан».
+ */
+import { type IComponentDescriptor } from '@soxa-ui/setup';
+export interface IAttributeBinding {
+    prop: string;
+    /** Конструктор или массив конструкторов, порядок значим. */
+    type: unknown;
+    isBoolean: boolean;
+}
+/** Пропы без атрибута и свойства: тег корня задан разметкой, база отдаёт ядру `localName`. */
+export declare const HOST_PROPS: readonly ["tag"];
+export type THostProp = (typeof HOST_PROPS)[number];
+export declare function isHostProp(prop: string): boolean;
+/** `borderWidth` → `border-width`. */
+export declare function toAttributeName(propName: string): string;
+/** Имя атрибута → проп; один раз на класс, кодогенерация не нужна. */
+export declare function buildAttributeMap(descriptor: IComponentDescriptor): Map<string, IAttributeBinding>;
+export declare function coerceAttribute(raw: string | null, binding: IAttributeBinding): unknown;

package/dist/adapter/common/attributes.js

@@ -0,0 +1,74 @@
+import { WebcProfile } from "./profile.js";
+import { TSurface } from "@soxa-ui/setup";
+//#region src/adapter/common/attributes.ts
+/**
+* Атрибуты и пропсы ядра. Атрибут — всегда строка, и значение приводится по
+* `type` декларации: типы по порядку, значение даёт первый, который строку
+* принимает, — спор строки и булева решает порядок, как во Vue. Снятый
+* атрибут у булева пропа — `false`, у остальных — «проп не задан».
+*/
+/** Пропы без атрибута и свойства: тег корня задан разметкой, база отдаёт ядру `localName`. */
+var HOST_PROPS = ["tag"];
+var HOST_PROP_NAMES = new Set(HOST_PROPS);
+function isHostProp(prop) {
+	return HOST_PROP_NAMES.has(prop);
+}
+/** `borderWidth` → `border-width`. */
+function toAttributeName(propName) {
+	return propName.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+/** Проп без типа принимает строку атрибута как есть. */
+function typesOf(type) {
+	if (type === void 0) return [String];
+	return Array.isArray(type) ? type : [type];
+}
+function parseJson(raw) {
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+/** `undefined` — тип строку не принимает: из строки его не даёт ни один тип. */
+function acceptAs(type, raw) {
+	switch (type) {
+		case String: return raw;
+		case Boolean: return true;
+		case Number: {
+			if (raw.trim() === "") return void 0;
+			const value = Number(raw);
+			return Number.isNaN(value) ? void 0 : value;
+		}
+		case Object: {
+			const value = parseJson(raw);
+			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+		}
+		case Array: {
+			const value = parseJson(raw);
+			return Array.isArray(value) ? value : void 0;
+		}
+		default: return;
+	}
+}
+/** Имя атрибута → проп; один раз на класс, кодогенерация не нужна. */
+function buildAttributeMap(descriptor) {
+	const map = /* @__PURE__ */ new Map();
+	for (const [prop, { type }] of Object.entries(TSurface.of(descriptor, WebcProfile).exportProps)) {
+		if (isHostProp(prop)) continue;
+		map.set(toAttributeName(prop), {
+			prop,
+			type,
+			isBoolean: typesOf(type)[0] === Boolean
+		});
+	}
+	return map;
+}
+function coerceAttribute(raw, binding) {
+	if (raw === null) return binding.isBoolean ? false : void 0;
+	for (const type of typesOf(binding.type)) {
+		const value = acceptAs(type, raw);
+		if (value !== void 0) return value;
+	}
+}
+//#endregion
+export { HOST_PROPS, buildAttributeMap, coerceAttribute, isHostProp, toAttributeName };

package/dist/adapter/common/createWebcAdapterContext.d.ts

@@ -0,0 +1,8 @@
+import type { IAdapterContext, IAdapterContextConfig, IAdapterContextOptions, IComponentDescriptor, IPluginsContract, TContextContract } from '@soxa-ui/setup';
+/**
+ * Сборка элемента: локаль — ближайшего `<so-locale-provider>` вверх от хоста.
+ * Зовётся на каждое подключение, поэтому переставленный элемент берёт локаль
+ * нового места. Id монтирования не нужен: серверной разметки у Custom
+ * Elements нет.
+ */
+export declare function createWebcAdapterContext<TInstance extends object, TPlugins extends IPluginsContract>(host: Element, descriptor: IComponentDescriptor<TContextContract<TInstance, TPlugins>>, options: IAdapterContextOptions<TInstance>, config?: IAdapterContextConfig): IAdapterContext<TContextContract<TInstance, TPlugins>>;

package/dist/adapter/common/createWebcAdapterContext.js

@@ -0,0 +1,17 @@
+import { nearestLocale } from "../locale/context.js";
+import { createAdapterContext } from "@soxa-ui/setup";
+//#region src/adapter/common/createWebcAdapterContext.ts
+/**
+* Сборка элемента: локаль — ближайшего `<so-locale-provider>` вверх от хоста.
+* Зовётся на каждое подключение, поэтому переставленный элемент берёт локаль
+* нового места. Id монтирования не нужен: серверной разметки у Custom
+* Elements нет.
+*/
+function createWebcAdapterContext(host, descriptor, options, config) {
+	return createAdapterContext(descriptor, {
+		...options,
+		locale: options.locale ?? nearestLocale(host)
+	}, config);
+}
+//#endregion
+export { createWebcAdapterContext };

package/dist/adapter/common/icon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Рисунок иконки роли на `<svg>`: `viewBox` и содержимое из реестра. Роль
+ * резолвится при отрисовке — `useIcons()` может прийти после импорта, — а та
+ * же иконка второй раз не пишется. Содержимое — `innerHTML` в пространстве
+ * имён SVG; источник доверенный — пакет иконок приложения.
+ */
+export declare function drawRoleIcon(svg: SVGSVGElement, role: string): void;
+/** Голый `<svg>` с рисунком роли — для разметки, где иконка не компонент (отметка CheckBox). */
+export declare function roleIcon(role: string): SVGSVGElement;

package/dist/adapter/common/icon.js

@@ -0,0 +1,25 @@
+import { getIcon } from "@soxa-ui/setup";
+//#region src/adapter/common/icon.ts
+/**
+* Рисунок иконки роли на `<svg>`: `viewBox` и содержимое из реестра. Роль
+* резолвится при отрисовке — `useIcons()` может прийти после импорта, — а та
+* же иконка второй раз не пишется. Содержимое — `innerHTML` в пространстве
+* имён SVG; источник доверенный — пакет иконок приложения.
+*/
+var SVG = "http://www.w3.org/2000/svg";
+var drawn = /* @__PURE__ */ new WeakMap();
+function drawRoleIcon(svg, role) {
+	const icon = getIcon(role);
+	if (drawn.get(svg) === icon) return;
+	svg.setAttribute("viewBox", icon.viewBox);
+	svg.innerHTML = icon.body;
+	drawn.set(svg, icon);
+}
+/** Голый `<svg>` с рисунком роли — для разметки, где иконка не компонент (отметка CheckBox). */
+function roleIcon(role) {
+	const svg = document.createElementNS(SVG, "svg");
+	drawRoleIcon(svg, role);
+	return svg;
+}
+//#endregion
+export { drawRoleIcon, roleIcon };

package/dist/adapter/common/index.d.ts

@@ -0,0 +1,5 @@
+export { WebcProfile } from './profile';
+export { WebcNaming } from './naming';
+export { createWebcAdapterContext } from './createWebcAdapterContext';
+export { drawRoleIcon, roleIcon } from './icon';
+export { HOST_PROPS, isHostProp, toAttributeName, coerceAttribute, buildAttributeMap, type IAttributeBinding, type THostProp, } from './attributes';

package/dist/adapter/common/index.js

@@ -0,0 +1,6 @@
+import "./naming.js";
+import { WebcProfile } from "./profile.js";
+import { createWebcAdapterContext } from "./createWebcAdapterContext.js";
+import { drawRoleIcon, roleIcon } from "./icon.js";
+import { buildAttributeMap, coerceAttribute, isHostProp, toAttributeName } from "./attributes.js";
+export { WebcProfile, buildAttributeMap, coerceAttribute, createWebcAdapterContext, drawRoleIcon, isHostProp, roleIcon, toAttributeName };

package/dist/adapter/common/naming.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Имена поверхности: пропсы — общим правилом, события — `so:` и полное имя
+ * ядра, у каждого события (`so:show`, `so:show:before`): событие всплывает в
+ * общий канал DOM, и префикс говорит, чьё оно.
+ */
+import type { INamingStrategy } from '@soxa-ui/setup';
+export declare const WebcNaming: INamingStrategy;

package/dist/adapter/common/naming.js

@@ -0,0 +1,9 @@
+import { underscorePropNaming } from "@soxa-ui/setup";
+//#region src/adapter/common/naming.ts
+var EVENT_PREFIX = "so:";
+var WebcNaming = {
+	prop: underscorePropNaming,
+	event: (name) => EVENT_PREFIX + name.getName()
+};
+//#endregion
+export { WebcNaming };

package/dist/adapter/common/profile.d.ts

@@ -0,0 +1,3 @@
+import type { IAdapterProfile } from '@soxa-ui/setup';
+/** Одна поверхность на класс элемента (атрибуты, свойства) и на связку. */
+export declare const WebcProfile: IAdapterProfile;

package/dist/adapter/common/profile.js

@@ -0,0 +1,6 @@
+import { WebcNaming } from "./naming.js";
+//#region src/adapter/common/profile.ts
+/** Одна поверхность на класс элемента (атрибуты, свойства) и на связку. */
+var WebcProfile = { naming: WebcNaming };
+//#endregion
+export { WebcProfile };

package/dist/adapter/context/index.d.ts

@@ -0,0 +1 @@
+export { TPlaceContext } from './place-context.class';

package/dist/adapter/context/place-context.class.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Контекст места — значение, привязанное к элементу, для всего, что стоит ниже
+ * него по документу: у Custom Elements своего дерева нет, и провайдер отдаёт
+ * значение элементу, а компонент синхронно ищет ближайшее вверх. AGENTS.md
+ * (Web Components), «Контекст места».
+ */
+export declare class TPlaceContext<T> {
+    /** Увезённый корень → якорь на его месте. Пишет телепорт до переноса. */
+    private static readonly _anchors;
+    static anchor(root: Node, anchor: Node): void;
+    static unanchor(root: Node): void;
+    /** Узел на месте `node` в документе: у увезённого корня — его якорь. */
+    static placeOf(node: Node): Node;
+    /** Выше по месту: родитель, из теневого корня — хост, у увезённого корня — родитель якоря. */
+    static above(node: Node): Node | null;
+    /** Узлы выше по месту, от ближайшего; сам узел не в счёт. */
+    static ancestors(node: Node): Generator<Node>;
+    private readonly _values;
+    provide(element: Element, value: T): void;
+    /** Значение ближайшего места выше `node`; сам узел не в счёт. */
+    nearest(node: Node): T | undefined;
+}

package/dist/adapter/context/place-context.class.js

@@ -0,0 +1,40 @@
+//#region src/adapter/context/place-context.class.ts
+/**
+* Контекст места — значение, привязанное к элементу, для всего, что стоит ниже
+* него по документу: у Custom Elements своего дерева нет, и провайдер отдаёт
+* значение элементу, а компонент синхронно ищет ближайшее вверх. AGENTS.md
+* (Web Components), «Контекст места».
+*/
+var TPlaceContext = class TPlaceContext {
+	/** Увезённый корень → якорь на его месте. Пишет телепорт до переноса. */
+	static _anchors = /* @__PURE__ */ new WeakMap();
+	static anchor(root, anchor) {
+		TPlaceContext._anchors.set(root, anchor);
+	}
+	static unanchor(root) {
+		TPlaceContext._anchors.delete(root);
+	}
+	/** Узел на месте `node` в документе: у увезённого корня — его якорь. */
+	static placeOf(node) {
+		return TPlaceContext._anchors.get(node) ?? node;
+	}
+	/** Выше по месту: родитель, из теневого корня — хост, у увезённого корня — родитель якоря. */
+	static above(node) {
+		const parent = TPlaceContext.placeOf(node).parentNode;
+		return parent instanceof ShadowRoot ? parent.host : parent;
+	}
+	/** Узлы выше по месту, от ближайшего; сам узел не в счёт. */
+	static *ancestors(node) {
+		for (let place = TPlaceContext.above(node); place; place = TPlaceContext.above(place)) yield place;
+	}
+	_values = /* @__PURE__ */ new WeakMap();
+	provide(element, value) {
+		this._values.set(element, value);
+	}
+	/** Значение ближайшего места выше `node`; сам узел не в счёт. */
+	nearest(node) {
+		for (const place of TPlaceContext.ancestors(node)) if (place instanceof Element && this._values.has(place)) return this._values.get(place);
+	}
+};
+//#endregion
+export { TPlaceContext };

package/dist/adapter/elevator/elevator.class.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Лифт одного ключа на контексте места: `down` отдаёт значение хосту — его
+ * видит всё ниже по документу, `up` ищет ближайшее выше, сам хост не в счёт,
+ * как `inject` у Vue. Связка новая на каждое подключение, и переставленный
+ * элемент находит нового владельца.
+ */
+import { TElevator } from '@soxa-ui/setup';
+export declare class TWebcElevator<T = unknown> extends TElevator<T> {
+    private readonly _host;
+    constructor(key: string | symbol, _host: Element);
+    down(value: T): void;
+    up(): T | undefined;
+}

package/dist/adapter/elevator/elevator.class.js

@@ -0,0 +1,34 @@
+import { TPlaceContext } from "../context/place-context.class.js";
+import { TElevator } from "@soxa-ui/setup";
+//#region src/adapter/elevator/elevator.class.ts
+/**
+* Лифт одного ключа на контексте места: `down` отдаёт значение хосту — его
+* видит всё ниже по документу, `up` ищет ближайшее выше, сам хост не в счёт,
+* как `inject` у Vue. Связка новая на каждое подключение, и переставленный
+* элемент находит нового владельца.
+*/
+/** Тип значения у ключа один, а карта общая — в ней он стёрт. */
+var PLACES = /* @__PURE__ */ new Map();
+function placeOf(key) {
+	let place = PLACES.get(key);
+	if (!place) {
+		place = new TPlaceContext();
+		PLACES.set(key, place);
+	}
+	return place;
+}
+var TWebcElevator = class extends TElevator {
+	_host;
+	constructor(key, _host) {
+		super(key);
+		this._host = _host;
+	}
+	down(value) {
+		placeOf(this._key).provide(this._host, value);
+	}
+	up() {
+		return placeOf(this._key).nearest(this._host);
+	}
+};
+//#endregion
+export { TWebcElevator };

package/dist/adapter/elevator/factory.d.ts

@@ -0,0 +1,3 @@
+import type { TElevatorFactory } from '@soxa-ui/setup';
+/** Фабрика на хост: место значения у Web Components — сам элемент. */
+export declare function createWebcElevator(host: Element): TElevatorFactory;

package/dist/adapter/elevator/factory.js

@@ -0,0 +1,8 @@
+import { TWebcElevator } from "./elevator.class.js";
+//#region src/adapter/elevator/factory.ts
+/** Фабрика на хост: место значения у Web Components — сам элемент. */
+function createWebcElevator(host) {
+	return (key) => new TWebcElevator(key.name, host);
+}
+//#endregion
+export { createWebcElevator };

package/dist/adapter/elevator/index.d.ts

@@ -0,0 +1,2 @@
+export { TWebcElevator } from './elevator.class';
+export { createWebcElevator } from './factory';

package/dist/adapter/elevator/index.js

@@ -0,0 +1,2 @@
+import "./elevator.class.js";
+export { createWebcElevator } from "./factory.js";

package/dist/adapter/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common';
+export * from './template';
+export * from './runtime';
+export * from './locale';
+export * from './toasts';

package/dist/adapter/index.js

@@ -0,0 +1,21 @@
+import "./common/naming.js";
+import { WebcProfile } from "./common/profile.js";
+import { createWebcAdapterContext } from "./common/createWebcAdapterContext.js";
+import { drawRoleIcon, roleIcon } from "./common/icon.js";
+import { buildAttributeMap, coerceAttribute, isHostProp, toAttributeName } from "./common/attributes.js";
+import "./common/index.js";
+import { bind } from "./template/types.js";
+import { ownerAttributes, ownerClasses, ownerStyles } from "./template/owner.js";
+import { lend, lendBefore, lendMark } from "./template/lend.js";
+import { defineElement } from "./runtime/defineElement.js";
+import { createDetail, createItem, lendSamples, lendTemplates, patch, sampleOf } from "./template/parts.js";
+import { TKeyedLoop } from "./template/loop.js";
+import "./template/index.js";
+import { joinBindings, useAdapter, useCollectionAdapter } from "./runtime/useAdapter.js";
+import { ElementBase } from "./runtime/element.base.js";
+import "./runtime/index.js";
+import { TLocaleProviderElement } from "./locale/LocaleProvider.element.js";
+import "./locale/index.js";
+import { isToastRender, toastsOf } from "./toasts/toastsOf.js";
+import "./toasts/index.js";
+export { ElementBase, TKeyedLoop, TLocaleProviderElement, WebcProfile, bind, buildAttributeMap, coerceAttribute, createDetail, createItem, createWebcAdapterContext, defineElement, drawRoleIcon, isHostProp, isToastRender, joinBindings, lend, lendBefore, lendMark, lendSamples, lendTemplates, ownerAttributes, ownerClasses, ownerStyles, patch, roleIcon, sampleOf, toAttributeName, toastsOf, useAdapter, useCollectionAdapter };

package/dist/adapter/locale/LocaleProvider.element.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `<so-locale-provider>` — локаль поддерева, как контекст у фреймворков.
+ * Источник свой у каждого провайдера и сразу уходит контекстом места; локаль
+ * — свойство из кода, плагины переписывают тег и имена на лету, без
+ * пересборки. Автономный элемент без коробки (`displayContents`).
+ *
+ * ```html
+ * <so-locale-provider>
+ * 	<button is="so-button" text="Сохранить"></button>
+ * </so-locale-provider>
+ * <script type="module">
+ * 	import { ruRU } from '@soxa-ui/plugins'
+ *
+ * 	document.querySelector('so-locale-provider').locale = ruRU
+ * </script>
+ * ```
+ */
+import type { TLocale } from '@soxa-ui/plugins';
+export declare class TLocaleProviderElement extends HTMLElement {
+    private readonly _source;
+    constructor();
+    get locale(): TLocale;
+    set locale(value: TLocale);
+    /** Записанное до апгрейда — собственное свойство: оно заслоняет свойство класса. */
+    private _upgradeLocale;
+}

package/dist/adapter/locale/LocaleProvider.element.js

@@ -0,0 +1,51 @@
+import { provideLocale } from "./context.js";
+import { defineAutonomousElement } from "../runtime/defineElement.js";
+import { displayContents } from "../runtime/display-contents.js";
+import { TLocaleSource, enUS } from "@soxa-ui/plugins";
+//#region src/adapter/locale/LocaleProvider.element.ts
+/**
+* `<so-locale-provider>` — локаль поддерева, как контекст у фреймворков.
+* Источник свой у каждого провайдера и сразу уходит контекстом места; локаль
+* — свойство из кода, плагины переписывают тег и имена на лету, без
+* пересборки. Автономный элемент без коробки (`displayContents`).
+*
+* ```html
+* <so-locale-provider>
+* 	<button is="so-button" text="Сохранить"></button>
+* </so-locale-provider>
+* <script type="module">
+* 	import { ruRU } from '@soxa-ui/plugins'
+*
+* 	document.querySelector('so-locale-provider').locale = ruRU
+* <\/script>
+* ```
+*/
+/** Записанное до апгрейда было обычным свойством, и тип ему никто не проверял. */
+function isLocale(value) {
+	return typeof value === "object" && value !== null && "tag" in value && typeof value.tag === "string" && "translations" in value && typeof value.translations === "object" && value.translations !== null;
+}
+var TLocaleProviderElement = class extends HTMLElement {
+	_source = new TLocaleSource(enUS);
+	constructor() {
+		super();
+		provideLocale(this, this._source);
+		this._upgradeLocale();
+		displayContents(this);
+	}
+	get locale() {
+		return this._source.locale;
+	}
+	set locale(value) {
+		this._source.locale = value;
+	}
+	/** Записанное до апгрейда — собственное свойство: оно заслоняет свойство класса. */
+	_upgradeLocale() {
+		if (!Object.hasOwn(this, "locale")) return;
+		const value = Reflect.get(this, "locale");
+		Reflect.deleteProperty(this, "locale");
+		if (isLocale(value)) this.locale = value;
+	}
+};
+defineAutonomousElement("so-locale-provider", TLocaleProviderElement);
+//#endregion
+export { TLocaleProviderElement };

package/dist/adapter/locale/context.d.ts

@@ -0,0 +1,4 @@
+import type { ILocaleSource } from '@soxa-ui/plugins';
+export declare function provideLocale(provider: Element, source: ILocaleSource): void;
+/** Провайдера нет — `undefined`, и у набора своя английская. */
+export declare function nearestLocale(node: Node): ILocaleSource | undefined;

package/dist/adapter/locale/context.js

@@ -0,0 +1,12 @@
+import { TPlaceContext } from "../context/place-context.class.js";
+//#region src/adapter/locale/context.ts
+var LOCALE = new TPlaceContext();
+function provideLocale(provider, source) {
+	LOCALE.provide(provider, source);
+}
+/** Провайдера нет — `undefined`, и у набора своя английская. */
+function nearestLocale(node) {
+	return LOCALE.nearest(node);
+}
+//#endregion
+export { nearestLocale, provideLocale };

package/dist/adapter/locale/index.d.ts

@@ -0,0 +1,2 @@
+/** Application API for this element entry. */
+export { TLocaleProviderElement } from './LocaleProvider.element';

package/dist/adapter/locale/index.js

@@ -0,0 +1 @@
+export { TLocaleProviderElement } from "./LocaleProvider.element.js";

package/dist/adapter/runtime/content.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Содержимое ли узел света: элемент, якорь увезённого корня или текст не из
+ * одних пробелов. Слот без содержимого не задан — пробелы вокруг
+ * `<svg slot="leading">` не глушат проп `text`, как и у компилятора Vue.
+ */
+export declare function isContent(node: Node): boolean;

package/dist/adapter/runtime/content.js

@@ -0,0 +1,13 @@
+import { TTeleport } from "./teleport.js";
+//#region src/adapter/runtime/content.ts
+/**
+* Содержимое ли узел света: элемент, якорь увезённого корня или текст не из
+* одних пробелов. Слот без содержимого не задан — пробелы вокруг
+* `<svg slot="leading">` не глушат проп `text`, как и у компилятора Vue.
+*/
+function isContent(node) {
+	if (node instanceof Element || TTeleport.rootAt(node)) return true;
+	return node instanceof Text && node.data.trim() !== "";
+}
+//#endregion
+export { isContent };

package/dist/adapter/runtime/deferral.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Отсрочка: первая сборка разметки, которой собираться рано, идёт позже и по
+ * месту — элемент не раньше того, кто ждёт над ним, соседи в порядке
+ * документа, теневое дерево хоста раньше его света. AGENTS.md (Web
+ * Components), «Отсрочка первой сборки».
+ */
+export declare class TDeferral {
+    private static readonly _waiting;
+    private static readonly _parsing;
+    /** Разметка, ожившая при регистрации; собирает её `defineElement`, когда оживлять некого. */
+    static readonly registration: TDeferral;
+    /** Очередь документа, пока он разбирается: собирается на `DOMContentLoaded`. */
+    static parsing(owner: Document): TDeferral;
+    /** Очередь элемента, который ждёт выше `node` по месту. */
+    static above(node: Node): TDeferral | undefined;
+    private _deferred;
+    defer(element: Element, resume: () => void): void;
+    /** Раундами: порядок раунда считается в его начале, пришедшее во время — следующим. */
+    release(): void;
+    private _rounds;
+    private _take;
+}

package/dist/adapter/runtime/deferral.js

@@ -0,0 +1,100 @@
+import { TPlaceContext } from "../context/place-context.class.js";
+import { runAll } from "./waiting.js";
+//#region src/adapter/runtime/deferral.ts
+/**
+* Отсрочка: первая сборка разметки, которой собираться рано, идёт позже и по
+* месту — элемент не раньше того, кто ждёт над ним, соседи в порядке
+* документа, теневое дерево хоста раньше его света. AGENTS.md (Web
+* Components), «Отсрочка первой сборки».
+*/
+/** Путь места — от корня дерева до самого узла. */
+function pathOf(node) {
+	return [...TPlaceContext.ancestors(node)].reverse().concat(node);
+}
+/**
+* Два узла под общим местом: рядом — порядок документа; один в теневом дереве
+* общего хоста, другой в его свете — теневое раньше. Голый
+* `compareDocumentPosition` через теневую границу порядка не обещает.
+*/
+function siblingOrder(a, b) {
+	const placeA = TPlaceContext.placeOf(a);
+	const placeB = TPlaceContext.placeOf(b);
+	if (placeA.parentNode === placeB.parentNode) return placeA.compareDocumentPosition(placeB) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1;
+	return placeA.parentNode instanceof ShadowRoot ? -1 : 1;
+}
+function compare(a, b) {
+	const length = Math.min(a.length, b.length);
+	for (let index = 1; index < length; index += 1) if (a[index] !== b[index]) return siblingOrder(a[index], b[index]);
+	return a.length - b.length;
+}
+/**
+* Раунд по месту. Деревьев больше одного, только если элемент сняли до его
+* раунда: такие идут в порядке прихода первого из каждого.
+*/
+function byPlace(deferred) {
+	const trees = /* @__PURE__ */ new Map();
+	for (const each of deferred) {
+		const path = pathOf(each.element);
+		const tree = trees.get(path[0]);
+		if (tree) tree.push({
+			deferred: each,
+			path
+		});
+		else trees.set(path[0], [{
+			deferred: each,
+			path
+		}]);
+	}
+	return [...trees.values()].flatMap((tree) => tree.sort((a, b) => compare(a.path, b.path)).map((placed) => placed.deferred));
+}
+var TDeferral = class TDeferral {
+	static _waiting = /* @__PURE__ */ new Map();
+	static _parsing = /* @__PURE__ */ new WeakMap();
+	/** Разметка, ожившая при регистрации; собирает её `defineElement`, когда оживлять некого. */
+	static registration = new TDeferral();
+	/** Очередь документа, пока он разбирается: собирается на `DOMContentLoaded`. */
+	static parsing(owner) {
+		const ready = TDeferral._parsing.get(owner);
+		if (ready !== void 0) return ready;
+		const deferral = new TDeferral();
+		TDeferral._parsing.set(owner, deferral);
+		owner.addEventListener("DOMContentLoaded", () => {
+			TDeferral._parsing.delete(owner);
+			deferral.release();
+		}, { once: true });
+		return deferral;
+	}
+	/** Очередь элемента, который ждёт выше `node` по месту. */
+	static above(node) {
+		if (TDeferral._waiting.size === 0) return void 0;
+		for (const place of TPlaceContext.ancestors(node)) {
+			const deferral = TDeferral._waiting.get(place);
+			if (deferral !== void 0) return deferral;
+		}
+	}
+	_deferred = [];
+	defer(element, resume) {
+		TDeferral._waiting.set(element, this);
+		this._deferred.push({
+			element,
+			resume
+		});
+	}
+	/** Раундами: порядок раунда считается в его начале, пришедшее во время — следующим. */
+	release() {
+		runAll(this._rounds());
+	}
+	*_rounds() {
+		for (let round = this._take(); round.length > 0; round = this._take()) for (const { element, resume } of round) yield () => {
+			TDeferral._waiting.delete(element);
+			resume();
+		};
+	}
+	_take() {
+		const deferred = this._deferred;
+		this._deferred = [];
+		return byPlace(deferred);
+	}
+};
+//#endregion
+export { TDeferral };