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

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

@@ -0,0 +1,6 @@
+import type { TElevatorFactory } from '@soxa-ui/setup';
+/**
+ * Фабрика лифтов сборки — одна на сборку, при инициализации компонента: у
+ * второй фабрики `up()` не знал бы опущенного первой.
+ */
+export declare function useElevator(): TElevatorFactory;

package/dist/adapter/elevator/useElevator.js

@@ -0,0 +1,9 @@
+import { TSvelteElevator } from './elevator.class';
+/**
+ * Фабрика лифтов сборки — одна на сборку, при инициализации компонента: у
+ * второй фабрики `up()` не знал бы опущенного первой.
+ */
+export function useElevator() {
+    const inherited = new Map();
+    return (key) => new TSvelteElevator(key.name, inherited);
+}

package/dist/adapter/index.d.ts

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

package/dist/adapter/index.js

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

package/dist/adapter/locale/LocaleProvider.svelte

@@ -0,0 +1,21 @@
+<script lang="ts">
+	import { untrack } from 'svelte'
+	import { TLocaleSource } from '@soxa-ui/plugins'
+	import { provideLocale } from './context'
+	import type { TLocaleProviderProps } from './types'
+
+	const props: TLocaleProviderProps = $props()
+
+	// С локалью первой отрисовки — имена нужны и на сервере; дальше — эффект
+	const source = new TLocaleSource(untrack(() => props.locale))
+
+	provideLocale(source)
+
+	// Тем же проходом, что и разметка; компоненты не перемонтируются
+	$effect.pre(() => {
+		source.locale = props.locale
+	})
+</script>
+
+<!-- Локаль поддерева: источник у провайдера свой, вложенный даёт поддереву свой. -->
+{@render props.children?.()}

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

@@ -0,0 +1,4 @@
+import type { TLocaleProviderProps } from './types';
+declare const LocaleProvider: import("svelte").Component<TLocaleProviderProps, {}, "">;
+type LocaleProvider = ReturnType<typeof LocaleProvider>;
+export default LocaleProvider;

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

@@ -0,0 +1,6 @@
+/** Локаль поддерева в контексте Svelte — ключ модуля, только эти две функции. */
+import { TLocaleSource } from '@soxa-ui/plugins';
+import type { ILocaleSource } from '@soxa-ui/plugins';
+export declare function provideLocale(source: TLocaleSource): void;
+/** Источник ближайшего `LocaleProvider`; нет его — `undefined`. */
+export declare function nearestLocale(): ILocaleSource | undefined;

package/dist/adapter/locale/context.js

@@ -0,0 +1,12 @@
+/** Локаль поддерева в контексте Svelte — ключ модуля, только эти две функции. */
+import { getContext, setContext } from 'svelte';
+import { TLocaleSource } from '@soxa-ui/plugins';
+const LOCALE_KEY = Symbol('soxa:locale');
+export function provideLocale(source) {
+    setContext(LOCALE_KEY, source);
+}
+/** Источник ближайшего `LocaleProvider`; нет его — `undefined`. */
+export function nearestLocale() {
+    const source = getContext(LOCALE_KEY);
+    return source instanceof TLocaleSource ? source : undefined;
+}

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

@@ -0,0 +1,2 @@
+export { default as LocaleProvider } from './LocaleProvider.svelte';
+export type { TLocaleProviderProps } from './types';

package/dist/adapter/locale/index.js

@@ -0,0 +1 @@
+export { default as LocaleProvider } from './LocaleProvider.svelte';

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

@@ -0,0 +1,7 @@
+import type { Snippet } from 'svelte';
+import type { TLocale } from '@soxa-ui/plugins';
+export type TLocaleProviderProps = {
+    /** Тег для Intl и строки библиотеки (`ruRU`, `extendLocale(...)`). */
+    locale: TLocale;
+    children?: Snippet;
+};

package/dist/adapter/locale/types.js

@@ -0,0 +1 @@
+export {};

package/dist/adapter/runtime/Dynamic.svelte

@@ -0,0 +1,54 @@
+<script lang="ts">
+	import { untrack, type Snippet } from 'svelte'
+	import { createAttachmentKey, type Attachment } from 'svelte/attachments'
+	import { TRoleIcon } from '../common/icon'
+	import RoleIcon from '../common/RoleIcon.svelte'
+	import type { TRootAttributes } from '../common/root'
+	import { rootStyle, toNodeAttributes } from './root-style.svelte'
+	import { isTagComponent } from './tag'
+
+	type TDynamicProps = {
+		/**
+		 * Whether the root is mounted — `state.rendered` of the component. A root
+		 * that a block of the template already mounts by its own condition (inside
+		 * Teleport, the window of Table) passes `true`.
+		 */
+		rendered: boolean | undefined
+		/** Name of an element, a Svelte component or a role icon mark (`roleIcon`). */
+		tag: string | object | undefined
+		/** Attributes of the root — `toRootProps` of the component. */
+		attributes: TRootAttributes
+		/** `binding.attachElement`; the wrapper of a root takes `consumerRef`, the root in it — `bindRef`. */
+		attach: Attachment<Element>
+		/**
+		 * The markup of the component inside `<Dynamic>`: fixed for the instance,
+		 * it is read once.
+		 */
+		children?: Snippet
+	}
+
+	const { rendered, tag, attributes, attach, children }: TDynamicProps = $props()
+
+	// One per component: a new one on the same node would take other properties for its own
+	const style = { [createAttachmentKey()]: rootStyle(() => attributes.style) }
+	const node = $derived(toNodeAttributes(attributes, style))
+
+	// Svelte compiles the markup inside `<Dynamic>` to one function of the
+	// parent instance; read once, it is rendered by a call, not by a block
+	const content = untrack(() => children)
+</script>
+
+<!--
+	The root by `tag`, like `<component :is>` of Vue: `<svelte:element>` takes only a string, so
+	there are three branches. A component from `tag` has to put the attributes and attachments on
+	its root (`TTagComponent`). `rendered` is a condition of the same branches: one block per root,
+	not a block of every template around it.
+-->
+{#if rendered && typeof tag === 'string'}
+	<svelte:element this={tag} {...node} {@attach attach}>{@render content?.()}</svelte:element>
+{:else if rendered && tag instanceof TRoleIcon}
+	<RoleIcon icon={tag} attributes={node} {attach} />
+{:else if rendered && isTagComponent(tag)}
+	{@const Tag = tag}
+	<Tag {...node} {@attach attach}>{@render content?.()}</Tag>
+{/if}

package/dist/adapter/runtime/Dynamic.svelte.d.ts

@@ -0,0 +1,25 @@
+import { type Snippet } from 'svelte';
+import { type Attachment } from 'svelte/attachments';
+import type { TRootAttributes } from '../common/root';
+type TDynamicProps = {
+    /**
+     * Whether the root is mounted — `state.rendered` of the component. A root
+     * that a block of the template already mounts by its own condition (inside
+     * Teleport, the window of Table) passes `true`.
+     */
+    rendered: boolean | undefined;
+    /** Name of an element, a Svelte component or a role icon mark (`roleIcon`). */
+    tag: string | object | undefined;
+    /** Attributes of the root — `toRootProps` of the component. */
+    attributes: TRootAttributes;
+    /** `binding.attachElement`; the wrapper of a root takes `consumerRef`, the root in it — `bindRef`. */
+    attach: Attachment<Element>;
+    /**
+     * The markup of the component inside `<Dynamic>`: fixed for the instance,
+     * it is read once.
+     */
+    children?: Snippet;
+};
+declare const Dynamic: import("svelte").Component<TDynamicProps, {}, "">;
+type Dynamic = ReturnType<typeof Dynamic>;
+export default Dynamic;

package/dist/adapter/runtime/Teleport.svelte

@@ -0,0 +1,96 @@
+<script lang="ts">
+	import { getAllContexts, mount, unmount, untrack } from 'svelte'
+	import Teleport from './Teleport.svelte'
+	import type { TTeleportProps } from './types'
+
+	const props: TTeleportProps = $props()
+
+	/** Фаза только растёт: нет → на месте → в обёртке. */
+	type TPhase = 'none' | 'placed' | 'wrapped'
+
+	// Корень в обёртке получает контексты места: локаль и лифт — как у триггера
+	const context = getAllContexts()
+
+	// Первая отрисовка одна на сервере и в браузере
+	let phase: TPhase = $state(untrack(() => props.disabled) ? 'placed' : 'none')
+
+	/** Одна на всё монтирование, заводится в браузере, когда впервые нужна. */
+	let wrapper: HTMLDivElement | null = null
+
+	function wrapperNode(): HTMLDivElement {
+		if (!wrapper) {
+			wrapper = document.createElement('div')
+			wrapper.style.display = 'contents'
+		}
+
+		return wrapper
+	}
+
+	function targetOf(selector: string | undefined): Element | null {
+		return selector ? document.querySelector(selector) : null
+	}
+
+	/** Вынуть обёртку из `parent`, если она ещё там. */
+	function takeFrom(parent: Element): void {
+		if (wrapper && wrapper.parentNode === parent) wrapper.remove()
+	}
+
+	// До отрисовки: содержимое на месте уходит раньше, чем смонтируется корень
+	$effect.pre(() => {
+		if (phase === 'wrapped') return
+
+		const { to, disabled } = props
+
+		if (phase === 'placed' ? !disabled : disabled || targetOf(to) !== null) {
+			phase = 'wrapped'
+		}
+	})
+
+	// С `disabled` обёртку держит узел места; цели нет — она вне документа
+	$effect(() => {
+		if (phase !== 'wrapped' || props.disabled) return
+
+		const target = targetOf(props.to)
+
+		if (!target) return
+
+		target.appendChild(wrapperNode())
+
+		return () => takeFrom(target)
+	})
+
+	// Корень — в обёртку, один раз (заново — на смену `children`): тот же
+	// Teleport, выключенный с первой отрисовки, рисует содержимое на месте
+	$effect(() => {
+		if (phase !== 'wrapped') return
+
+		const content = mount(Teleport, {
+			target: wrapperNode(),
+			props: { to: undefined, disabled: true, children: props.children },
+			context,
+		})
+
+		return () => {
+			void unmount(content)
+		}
+	})
+
+	/** Узел места: обёртку — в него, при снятии — вон. */
+	function place(node: Element): () => void {
+		node.appendChild(wrapperNode())
+
+		return () => takeFrom(node)
+	}
+</script>
+
+<!--
+	Портал, как `<teleport :to>` у Vue: содержимое — отдельный корень (`mount`)
+	в обёртке `display: contents`, а Teleport двигает саму обёртку — в цель, в
+	узел места или вон из документа, — и набранное в панели остаётся.
+	AGENTS.md (Svelte), «Teleport».
+-->
+{#if phase === 'placed'}
+	{@render props.children?.()}
+{:else if phase === 'wrapped' && props.disabled}
+	<div style="display: contents" {@attach place}></div>
+{/if}

package/dist/adapter/runtime/Teleport.svelte.d.ts

@@ -0,0 +1,5 @@
+import Teleport from './Teleport.svelte';
+import type { TTeleportProps } from './types';
+declare const Teleport: import("svelte").Component<TTeleportProps, {}, "">;
+type Teleport = ReturnType<typeof Teleport>;
+export default Teleport;

package/dist/adapter/runtime/TextSpan.svelte

@@ -0,0 +1,28 @@
+<script lang="ts">
+	import { BROWSER } from 'esm-env'
+	import type { Attachment } from 'svelte/attachments'
+	import type { HTMLAttributes } from 'svelte/elements'
+
+	type TTextSpanProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {
+		/** Текст узла целиком; `undefined` — пусто. */
+		text: string | undefined
+	}
+
+	const { text, ...attributes }: TTextSpanProps = $props()
+
+	/** Пишет текст, только когда он разошёлся с узлом; перечитывает на смену. */
+	const write: Attachment<HTMLSpanElement> = (node) => {
+		const content = text ?? ''
+
+		if (node.textContent !== content) node.textContent = content
+	}
+</script>
+
+<!--
+	`span`, чей текст пишет только он сам, `textContent`, — часть поля даты:
+	её правит браузер, и текстовый узел Svelte оказался бы вне документа.
+	На сервере текст — содержимое. AGENTS.md (Svelte), «Текст поля».
+-->
+{#if BROWSER}<span {...attributes} {@attach write}></span>{:else}<span {...attributes}
+		>{text}</span
+	>{/if}

package/dist/adapter/runtime/TextSpan.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { HTMLAttributes } from 'svelte/elements';
+type TTextSpanProps = Omit<HTMLAttributes<HTMLSpanElement>, 'children'> & {
+    /** Текст узла целиком; `undefined` — пусто. */
+    text: string | undefined;
+};
+declare const TextSpan: import("svelte").Component<TTextSpanProps, {}, "">;
+type TextSpan = ReturnType<typeof TextSpan>;
+export default TextSpan;

package/dist/adapter/runtime/field-text.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Текст поля на узле — свойством и только когда он разошёлся с узлом, как
+ * `:value` у Vue: в спреде Svelte писал бы `value` на каждую смену, и запись
+ * снимала бы с поля пометку «изменено пользователем». На сервере текст —
+ * атрибутом `value`, у `<textarea>` — содержимым. AGENTS.md (Svelte),
+ * «Текст поля».
+ */
+import { type Attachment } from 'svelte/attachments';
+/** Спредом на `<input>`: в браузере — attachment, на сервере — `value`. */
+export type TFieldText = {
+    readonly [key: symbol]: Attachment<HTMLInputElement>;
+} | {
+    readonly value: string | undefined;
+};
+export type TTextareaText = {
+    /** Спредом на поле, последним: в браузере — attachment, на сервере — ничего. */
+    readonly attributes: {
+        readonly [key: symbol]: Attachment<HTMLTextAreaElement>;
+    };
+    /** Атрибутом `value` в разметке: на сервере — текст, в браузере — `undefined`. */
+    readonly value: string | undefined;
+};
+/** Один раз на компонент: тот же ключ и та же функция узел не переставляют. */
+export declare function fieldText(getText: () => string | undefined): TFieldText;
+/**
+ * У `<textarea>` содержимым сервер Svelte делает только `value`, написанный в
+ * разметке, а не в спреде, поэтому текст — отдельной частью.
+ */
+export declare function textareaText(getText: () => string | undefined): TTextareaText;

package/dist/adapter/runtime/field-text.js

@@ -0,0 +1,45 @@
+/**
+ * Текст поля на узле — свойством и только когда он разошёлся с узлом, как
+ * `:value` у Vue: в спреде Svelte писал бы `value` на каждую смену, и запись
+ * снимала бы с поля пометку «изменено пользователем». На сервере текст —
+ * атрибутом `value`, у `<textarea>` — содержимым. AGENTS.md (Svelte),
+ * «Текст поля».
+ */
+import { BROWSER } from 'esm-env';
+import { createAttachmentKey } from 'svelte/attachments';
+function textAttachment(getText) {
+    return (node) => {
+        const text = getText() ?? '';
+        if (node.value !== text)
+            node.value = text;
+    };
+}
+/** Один раз на компонент: тот же ключ и та же функция узел не переставляют. */
+export function fieldText(getText) {
+    if (!BROWSER) {
+        return {
+            get value() {
+                return getText();
+            },
+        };
+    }
+    return { [createAttachmentKey()]: textAttachment(getText) };
+}
+/**
+ * У `<textarea>` содержимым сервер Svelte делает только `value`, написанный в
+ * разметке, а не в спреде, поэтому текст — отдельной частью.
+ */
+export function textareaText(getText) {
+    if (!BROWSER) {
+        return {
+            attributes: {},
+            get value() {
+                return getText();
+            },
+        };
+    }
+    return {
+        attributes: { [createAttachmentKey()]: textAttachment(getText) },
+        value: undefined,
+    };
+}

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

@@ -0,0 +1,8 @@
+export { useAdapter, useCollectionAdapter, joinBindings, type TBinding, type TCollectionBinding, type TRootReceiver, } from './useAdapter.svelte';
+export { default as Dynamic } from './Dynamic.svelte';
+export { default as Teleport } from './Teleport.svelte';
+export { default as TextSpan } from './TextSpan.svelte';
+export { isTagComponent, type TTagComponent } from './tag';
+export { runsOf, type TRun } from './runs';
+export { fieldText, textareaText, type TFieldText, type TTextareaText } from './field-text';
+export type { TTeleportProps } from './types';

package/dist/adapter/runtime/index.js

@@ -0,0 +1,7 @@
+export { useAdapter, useCollectionAdapter, joinBindings, } from './useAdapter.svelte';
+export { default as Dynamic } from './Dynamic.svelte';
+export { default as Teleport } from './Teleport.svelte';
+export { default as TextSpan } from './TextSpan.svelte';
+export { isTagComponent } from './tag';
+export { runsOf } from './runs';
+export { fieldText, textareaText } from './field-text';

package/dist/adapter/runtime/root-style.svelte.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Стиль корня на узле — по свойствам, как у Vue и React: атрибут `style`
+ * Svelte пишет целиком и стирал бы то, что плагины ставят на узел сами.
+ * В браузере его ставит attachment, на сервере — строка атрибута (`BROWSER`
+ * из `esm-env`). AGENTS.md (Svelte), «Стиль корня».
+ */
+import type { Attachment } from 'svelte/attachments';
+import { type TRootAttributes, type TRootNodeAttributes, type TRootStyleLayers } from '../common/root';
+/** Attachment стиля корня под своим ключом (`createAttachmentKey`). */
+export type TRootStyleAttachment = {
+    readonly [key: symbol]: Attachment<Element>;
+};
+/**
+ * Атрибуты узла корня. В браузере `style` нет: его ставит attachment, первым
+ * среди attachment-ов спреда — раньше потребительских.
+ */
+export declare function toNodeAttributes(attributes: TRootAttributes, style: TRootStyleAttachment): TRootNodeAttributes;
+/**
+ * Sets the properties of the layers as a difference with what it set itself;
+ * foreign ones it leaves alone. Created once per component: a new one on the
+ * same node would take foreign properties for its own. What stands on the node
+ * from the start is the server's style on hydration.
+ *
+ * One effect: the consumer's style is parsed again only when its string
+ * changed — two `$derived` for that were a reaction graph on every root.
+ */
+export declare function rootStyle(getStyle: () => TRootStyleLayers): Attachment<Element>;

package/dist/adapter/runtime/root-style.svelte.js

@@ -0,0 +1,105 @@
+/**
+ * Стиль корня на узле — по свойствам, как у Vue и React: атрибут `style`
+ * Svelte пишет целиком и стирал бы то, что плагины ставят на узел сами.
+ * В браузере его ставит attachment, на сервере — строка атрибута (`BROWSER`
+ * из `esm-env`). AGENTS.md (Svelte), «Стиль корня».
+ */
+import { BROWSER } from 'esm-env';
+import { toStyleAttribute, } from '../common/root';
+const EMPTY = new Map();
+/**
+ * Атрибуты узла корня. В браузере `style` нет: его ставит attachment, первым
+ * среди attachment-ов спреда — раньше потребительских.
+ */
+export function toNodeAttributes(attributes, style) {
+    const { style: layers, ...node } = attributes;
+    return BROWSER ? { ...style, ...node } : { ...node, style: toStyleAttribute(layers) };
+}
+/**
+ * Sets the properties of the layers as a difference with what it set itself;
+ * foreign ones it leaves alone. Created once per component: a new one on the
+ * same node would take foreign properties for its own. What stands on the node
+ * from the start is the server's style on hydration.
+ *
+ * One effect: the consumer's style is parsed again only when its string
+ * changed — two `$derived` for that were a reaction graph on every root.
+ */
+export function rootStyle(getStyle) {
+    return (node) => {
+        if (!hasInlineStyle(node))
+            return;
+        const { style } = node;
+        let applied = readDeclarations(style);
+        let forward;
+        let parsed = EMPTY;
+        $effect(() => {
+            const layers = getStyle();
+            if (layers.forward !== forward) {
+                forward = layers.forward;
+                parsed = parseStyle(forward, node.ownerDocument);
+            }
+            const next = toDeclarations(layers, parsed);
+            applyDeclarations(style, applied, next);
+            applied = next;
+        });
+    };
+}
+/** Узел со своим инлайновым стилем — HTML, SVG и MathML. */
+function hasInlineStyle(node) {
+    return 'style' in node;
+}
+/** The properties of an inline style; none — the shared empty map. */
+function readDeclarations(style) {
+    if (style.length === 0)
+        return EMPTY;
+    const declarations = new Map();
+    for (let index = 0; index < style.length; index++) {
+        const name = style.item(index);
+        declarations.set(name, {
+            value: style.getPropertyValue(name),
+            priority: style.getPropertyPriority(name),
+        });
+    }
+    return declarations;
+}
+/** Стиль потребителя свойствами — разбирает браузер, отсоединённым узлом. */
+function parseStyle(text, document) {
+    if (!text)
+        return EMPTY;
+    const probe = document.createElement('div');
+    probe.style.cssText = text;
+    return readDeclarations(probe.style);
+}
+/**
+ * The properties of the layers from the bottom up: of the same name the upper
+ * one acts. No properties — the shared empty map: the root keeps the last
+ * declarations, and most roots have none.
+ */
+function toDeclarations(layers, forward) {
+    const declarations = new Map();
+    for (const [name, value] of Object.entries(layers.below)) {
+        declarations.set(name, { value, priority: '' });
+    }
+    for (const [name, declaration] of forward)
+        declarations.set(name, declaration);
+    for (const [name, value] of Object.entries(layers.above)) {
+        declarations.set(name, { value, priority: '' });
+    }
+    return declarations.size > 0 ? declarations : EMPTY;
+}
+/** Пропавшие свойства — снять, новые и сменившиеся — поставить; остальное не трогать. */
+function applyDeclarations(style, previous, next) {
+    for (const name of previous.keys()) {
+        if (!next.has(name))
+            style.removeProperty(name);
+    }
+    for (const [name, declaration] of next) {
+        if (!isSame(previous.get(name), declaration)) {
+            style.setProperty(name, declaration.value, declaration.priority);
+        }
+    }
+}
+/** То же значение с тем же приоритетом. */
+function isSame(previous, next) {
+    return previous?.value === next.value && previous.priority === next.priority;
+}

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

@@ -0,0 +1,13 @@
+/** Серия подряд идущих элементов списка с одним значением признака. */
+export type TRun<T, TValue> = {
+    readonly value: TValue;
+    readonly items: readonly T[];
+};
+/**
+ * Список сериями подряд идущих элементов с одним значением признака `key`:
+ * `{#each runsOf(cells, 'rowHeader') as run}`, в серии — ветка по `run.value` и
+ * петля по `run.items`. Ветка Svelte — блок с менеджером веток, эффектами и
+ * якорем, и ветка по признаку в каждом элементе стоила бы их на элемент, а
+ * сериями — на серию. Тот же приём, что пайп `soRuns` адаптера Angular.
+ */
+export declare function runsOf<T, K extends keyof T>(items: readonly T[], key: K): TRun<T, T[K]>[];

package/dist/adapter/runtime/runs.js

@@ -0,0 +1,20 @@
+/**
+ * Список сериями подряд идущих элементов с одним значением признака `key`:
+ * `{#each runsOf(cells, 'rowHeader') as run}`, в серии — ветка по `run.value` и
+ * петля по `run.items`. Ветка Svelte — блок с менеджером веток, эффектами и
+ * якорем, и ветка по признаку в каждом элементе стоила бы их на элемент, а
+ * сериями — на серию. Тот же приём, что пайп `soRuns` адаптера Angular.
+ */
+export function runsOf(items, key) {
+    const runs = [];
+    let run;
+    for (const item of items) {
+        const value = item[key];
+        if (!run || !Object.is(run.value, value)) {
+            run = { value, items: [] };
+            runs.push(run);
+        }
+        run.items.push(item);
+    }
+    return runs;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Состояние двух контекстов — одним видом: прокси, которое читает свойство у
+ * состояния на каждое чтение, а не спред, который прочёл бы их один раз при
+ * сборке. AGENTS.md (Svelte), «Коллекция: два контекста — одна связка».
+ */
+/** Одноимённое свойство берётся из верхнего состояния. */
+export type TJoinedState<TBelow extends object, TAbove extends object> = Omit<TBelow, keyof TAbove> & TAbove;
+export declare function joinState<TBelow extends object, TAbove extends object>(below: TBelow, above: TAbove): TJoinedState<TBelow, TAbove>;

package/dist/adapter/runtime/state.js

@@ -0,0 +1,28 @@
+/**
+ * Состояние двух контекстов — одним видом: прокси, которое читает свойство у
+ * состояния на каждое чтение, а не спред, который прочёл бы их один раз при
+ * сборке. AGENTS.md (Svelte), «Коллекция: два контекста — одна связка».
+ */
+/** Состояние, у которого свойство берётся: верхнее, если оно у него есть. */
+function sourceOf({ below, above }, key) {
+    return Reflect.has(above, key) ? above : below;
+}
+/**
+ * Обработчик один на все виды: геттер на каждое имя обоих состояний —
+ * замыкание, его область и пара аксессоров — у строки таблицы стоил килобайты
+ * (benchmarks/table/svelte.md).
+ */
+const JOINED = {
+    get: (states, key) => Reflect.get(sourceOf(states, key), key),
+    has: ({ below, above }, key) => Reflect.has(above, key) || Reflect.has(below, key),
+    ownKeys: ({ below, above }) => [
+        ...new Set([...Reflect.ownKeys(below), ...Reflect.ownKeys(above)]),
+    ],
+    getOwnPropertyDescriptor: (states, key) => Reflect.getOwnPropertyDescriptor(sourceOf(states, key), key),
+};
+export function joinState(below, above) {
+    const joined = new Proxy({ below, above }, JOINED);
+    // Граница рантайма и типа, как `toInstanceState`: прокси отдаёт каждое
+    // свойство обоих состояний, но связь по именам TypeScript не видит
+    return joined;
+}

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

@@ -0,0 +1,11 @@
+import type { Component, Snippet } from 'svelte';
+import type { TRootNodeAttributes } from '../common/root';
+/**
+ * Компонент в `tag`: атрибуты корня — пропсами, вместе с attachment-ами
+ * адаптера под ключами-символами; он кладёт их спредом на свой корень.
+ */
+export type TTagComponent = Component<TRootNodeAttributes & {
+    children?: Snippet;
+}>;
+/** Компонент Svelte 5 — функция; других функций в `tag` ядро не ждёт. */
+export declare function isTagComponent(tag: unknown): tag is TTagComponent;

package/dist/adapter/runtime/tag.js

@@ -0,0 +1,4 @@
+/** Компонент Svelte 5 — функция; других функций в `tag` ядро не ждёт. */
+export function isTagComponent(tag) {
+    return typeof tag === 'function';
+}