@ivlev-dev/silent-server 0.0.0-stage → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ivlev-dev
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,163 @@
1
- # Temporary Holding Version
1
+ # @ivlev-dev/silent-server
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ SSR для Silent Framework без jsdom и linkedom: собственный мини-DOM, асинхронные ViewModel и гидрация серверной разметки.
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@ivlev-dev/silent-server)](https://www.npmjs.com/package/@ivlev-dev/silent-server)
6
+ [![license](https://img.shields.io/npm/l/@ivlev-dev/silent-server)](https://github.com/ivlev-dev/silent-framework/blob/main/LICENSE)
7
+ [![node](https://img.shields.io/node/v/@ivlev-dev/silent-server)](https://www.npmjs.com/package/@ivlev-dev/silent-server)
8
+
9
+ ## Возможности
10
+
11
+ - `renderToString` возвращает `{ html, head }`: разметку приложения и метаданные для `<head>`.
12
+ - Собственный мини-DOM: парсер шаблонов компилятора, документ, `TreeWalker` и сериализатор без внешних DOM-зависимостей.
13
+ - Асинхронные ViewModel, `Suspense` и `lazy` дожидаются до сериализации — в результат попадает итоговое содержимое.
14
+ - `<title>` из любого компонента выносится из дерева в `RenderResult.head`, как в React 19.
15
+ - Серверные якоря и маркеры `data-silent-a-*` сохраняются для адоптации узлов при `hydrate`.
16
+ - Вызовы сериализуются внутренней очередью, а DOM-глобалы живут только на время рендера.
17
+
18
+ ## Установка
19
+
20
+ ```bash
21
+ pnpm add @ivlev-dev/silent-server
22
+ ```
23
+
24
+ ```bash
25
+ npm install @ivlev-dev/silent-server
26
+ ```
27
+
28
+ ```bash
29
+ yarn add @ivlev-dev/silent-server
30
+ ```
31
+
32
+ Пакет поставляется как ESM с объявлениями типов и требует Node.js 22 или новее.
33
+
34
+ ## Быстрый старт
35
+
36
+ ```ts
37
+ import { createServer } from "node:http";
38
+ import { renderToString } from "@ivlev-dev/silent-server";
39
+ import { App } from "./app.js";
40
+
41
+ createServer(async (request, response) => {
42
+ try {
43
+ const { html, head } = await renderToString(App, {
44
+ props: { title: "Silent Framework" },
45
+ });
46
+
47
+ const page = `<!doctype html>
48
+ <html lang="ru">
49
+ <head>
50
+ <meta charset="utf-8" />
51
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
52
+ ${head}
53
+ </head>
54
+ <body>
55
+ <div id="app">${html}</div>
56
+ <script type="module" src="/client.js"></script>
57
+ </body>
58
+ </html>`;
59
+
60
+ response.setHeader("content-type", "text/html; charset=utf-8");
61
+ response.end(page);
62
+ } catch (error) {
63
+ response.statusCode = 500;
64
+ response.end("Internal Server Error");
65
+ console.error(error);
66
+ }
67
+ }).listen(3000);
68
+ ```
69
+
70
+ `html` не содержит `<title>`: заголовок уже находится в `head`. Приложение должно быть собрано компилятором Silent Framework — например, плагином `@ivlev-dev/silent-vite` — так же, как для клиентского рендера.
71
+
72
+ ## Гидрация на клиенте
73
+
74
+ Клиентский вход использует `hydrate` из `@ivlev-dev/silent-core` вместо `mount` и получает те же `props`, что и сервер:
75
+
76
+ ```ts
77
+ import { hydrate } from "@ivlev-dev/silent-core";
78
+ import { App } from "./app.js";
79
+
80
+ const target = document.querySelector("#app");
81
+ if (target === null) {
82
+ throw new Error("#app not found");
83
+ }
84
+
85
+ void hydrate(target, App, {
86
+ props: { title: "Silent Framework" },
87
+ onMismatch: (error) => console.warn(error.message),
88
+ });
89
+ ```
90
+
91
+ `hydrate` не перерисовывает приложение заново: view находит свои маркеры, `templateHoles` занимает существующие узлы, а `For`, `Show`, `Suspense`, `lazy` и `fragment` адоптируют свои якоря и регионы. Маркеры `data-silent-a-*` снимаются с адоптированных элементов, значения применяются заново. Пока асинхронные ViewModel не завершились, серверная разметка остаётся видимой, а прелоадеры не показываются.
92
+
93
+ Заголовок страницы в серверной разметке отсутствует: клиент создаёт `<title>` заново и вставляет его в `document.head`. При несовпадении формы узла бросается `HydrationMismatchError`, ближайший view откатывается на клиентский рендер, а ошибка приходит в `onMismatch`.
94
+
95
+ ## Асинхронные ViewModel
96
+
97
+ `renderToString` создаёт корневой компонент и ждёт его `ready`, `whenIdle` и `flushSync`, поэтому асинхронное разрешение ViewModel через DI, границы `Suspense` и загрузка `lazy` завершаются до сериализации:
98
+
99
+ ```tsx
100
+ import { lazy, Suspense } from "@ivlev-dev/silent-core";
101
+
102
+ const Profile = lazy<{ id: number }>(() => import("./profile.js"));
103
+
104
+ export function App() {
105
+ return (
106
+ <Suspense fallback={<span>Загрузка...</span>}>
107
+ <Profile id={1} />
108
+ </Suspense>
109
+ );
110
+ }
111
+ ```
112
+
113
+ Сервер дожидается загрузки модуля и асинхронных view внутри границы, после чего сериализует итоговое содержимое. Опция `preloader` задаёт прелоадер на время рендера, `container` — DI-контейнер корневого view, а `onError` перехватывает ошибки компонентов: без обработчика первая ошибка отклоняет промис `renderToString`.
114
+
115
+ ## API
116
+
117
+ | Символ | Назначение |
118
+ | --- | --- |
119
+ | `renderToString(app, options?)` | Рендерит корневой компонент в `Promise<RenderResult>`; вызовы сериализуются внутренней очередью. |
120
+ | `RenderResult` | Результат рендера: `{ html, head }`. |
121
+ | `RenderResult.html` | Сериализованная разметка приложения без `<title>`, с якорями и маркерами для гидрации. |
122
+ | `RenderResult.head` | HTML метаданных, вынесенных из дерева, в первую очередь `<title>`. |
123
+ | `RenderOptions` | Опции рендера. |
124
+ | `RenderOptions.props` | Props корневого компонента. |
125
+ | `RenderOptions.container` | DI-контейнер корневого view; по умолчанию корневой контейнер `@ivlev-dev/silent-di`. |
126
+ | `RenderOptions.preloader` | Прелоадер на время рендера. |
127
+ | `RenderOptions.onError` | Обработчик ошибок компонентов; если не задан, первая ошибка отклоняет промис. |
128
+
129
+ ## Ограничения и совместимость
130
+
131
+ - Только ESM и Node.js `>=22`; пакет не содержит CommonJS-сборки.
132
+ - Мини-DOM реализует подмножество, необходимое шаблонам компилятора; произвольные браузерные API внутри компонентов недоступны.
133
+ - DOM-глобалы общие на процесс, поэтому параллелизм SSR внутри процесса ограничен внутренней очередью `renderToString`.
134
+ - В Vite-сборке держите рантайм внешним, иначе приложение и `renderToString` получат разные экземпляры модулей:
135
+
136
+ ```ts
137
+ export default defineConfig({
138
+ plugins: [silent()],
139
+ ssr: {
140
+ external: [
141
+ "@ivlev-dev/silent-core",
142
+ "@ivlev-dev/silent-di",
143
+ "@ivlev-dev/silent-reactivity",
144
+ "@ivlev-dev/silent-server",
145
+ ],
146
+ },
147
+ });
148
+ ```
149
+
150
+ - Гидрация адоптирует только значения, созданные через `template()`/`templateHoles()`; DOM, собранный вручную, рендерится клиентски.
151
+ - `<title>` должен быть прямым потомком корневого элемента шаблона view; вложенные глубже заголовки вызывают откат к клиентскому рендеру.
152
+ - Несколько заголовков одновременно не дедуплицируются — рендерите один `<title>`. Заголовки внутри `<svg>` и с `itemProp` не выносятся в `head`.
153
+
154
+ ## Ссылки
155
+
156
+ - Репозиторий: https://github.com/ivlev-dev/silent-framework
157
+ - Документация: https://github.com/ivlev-dev/silent-framework/blob/main/docs/api/core.md
158
+ - CHANGELOG: https://github.com/ivlev-dev/silent-framework/blob/main/CHANGELOG.md
159
+ - Issues: https://github.com/ivlev-dev/silent-framework/issues
160
+
161
+ ---
162
+
163
+ MIT © ivlev-dev
@@ -0,0 +1,13 @@
1
+ import type { DomAttr, DomAttributes } from "./types.js";
2
+ export declare class AttributesImpl implements DomAttributes {
3
+ private readonly entries;
4
+ get length(): number;
5
+ item(index: number): DomAttr | null;
6
+ [Symbol.iterator](): IterableIterator<DomAttr>;
7
+ get(name: string): string | undefined;
8
+ set(name: string, value: string): void;
9
+ has(name: string): boolean;
10
+ delete(name: string): void;
11
+ clone(): AttributesImpl;
12
+ }
13
+ //# sourceMappingURL=attributes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/dom/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOzD,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAElC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAE7C;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOrC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKzB;IAED,KAAK,IAAI,cAAc,CAMtB;CACF"}
@@ -0,0 +1,41 @@
1
+ export class AttributesImpl {
2
+ entries = [];
3
+ get length() {
4
+ return this.entries.length;
5
+ }
6
+ item(index) {
7
+ return this.entries[index] ?? null;
8
+ }
9
+ [Symbol.iterator]() {
10
+ return this.entries[Symbol.iterator]();
11
+ }
12
+ get(name) {
13
+ const entry = this.entries.find((item) => item.name === name);
14
+ return entry?.value;
15
+ }
16
+ set(name, value) {
17
+ const entry = this.entries.find((item) => item.name === name);
18
+ if (entry !== undefined) {
19
+ entry.value = value;
20
+ return;
21
+ }
22
+ this.entries.push({ name, value });
23
+ }
24
+ has(name) {
25
+ return this.entries.some((item) => item.name === name);
26
+ }
27
+ delete(name) {
28
+ const index = this.entries.findIndex((item) => item.name === name);
29
+ if (index !== -1) {
30
+ this.entries.splice(index, 1);
31
+ }
32
+ }
33
+ clone() {
34
+ const clone = new AttributesImpl();
35
+ for (const entry of this.entries) {
36
+ clone.set(entry.name, entry.value);
37
+ }
38
+ return clone;
39
+ }
40
+ }
41
+ //# sourceMappingURL=attributes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/dom/attributes.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IACR,OAAO,GAAkB,EAAE,CAAC;IAE7C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9D,OAAO,KAAK,EAAE,KAAK,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,KAAa;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACnE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,cAAc,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}
@@ -0,0 +1,24 @@
1
+ import type { DomDocument, DomNode, DomTreeWalker } from "./types.js";
2
+ import { CommentImpl, DocumentFragmentImpl, ElementImpl, TextImpl } from "./node.js";
3
+ export declare class TreeWalkerImpl implements DomTreeWalker {
4
+ currentNode: DomNode;
5
+ private readonly root;
6
+ private readonly whatToShow;
7
+ constructor(root: DomNode, whatToShow: number);
8
+ nextNode(): DomNode | null;
9
+ parentNode(): DomNode | null;
10
+ private accepts;
11
+ private nextInOrder;
12
+ }
13
+ export declare class DocumentImpl implements DomDocument {
14
+ readonly nodeType = 9;
15
+ createElement(tag: string): ElementImpl;
16
+ createElementNS(namespace: string, tag: string): ElementImpl;
17
+ createComment(data: string): CommentImpl;
18
+ createTextNode(data: string): TextImpl;
19
+ createDocumentFragment(): DocumentFragmentImpl;
20
+ createTreeWalker(root: DomNode, whatToShow: number): TreeWalkerImpl;
21
+ }
22
+ export declare function createDocument(): DocumentImpl;
23
+ export declare function installDomGlobals(document?: DocumentImpl): () => void;
24
+ //# sourceMappingURL=document.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/dom/document.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,WAAW,EAGX,QAAQ,EACT,MAAM,WAAW,CAAC;AAGnB,qBAAa,cAAe,YAAW,aAAa;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAAY,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAI5C;IAED,QAAQ,IAAI,OAAO,GAAG,IAAI,CAUzB;IAED,UAAU,IAAI,OAAO,GAAG,IAAI,CAgB3B;IAED,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,WAAW;CAkBpB;AAED,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,QAAQ,KAAiB;IAElC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAKtC;IAED,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAK3D;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAEvC;IAED,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAErC;IAED,sBAAsB,IAAI,oBAAoB,CAE7C;IAED,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAElE;CACF;AAED,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AA4BD,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,YAA+B,GAAG,MAAM,IAAI,CA+BvF"}
@@ -0,0 +1,151 @@
1
+ import { NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_ELEMENT, NODE_TEXT, SHOW_ALL, SHOW_COMMENT, SHOW_ELEMENT, SVG_NAMESPACE, } from "./types.js";
2
+ import { CommentImpl, DocumentFragmentImpl, ElementImpl, NodeImpl, SvgElementImpl, TextImpl, } from "./node.js";
3
+ import { TemplateElementImpl } from "./parser.js";
4
+ export class TreeWalkerImpl {
5
+ currentNode;
6
+ root;
7
+ whatToShow;
8
+ constructor(root, whatToShow) {
9
+ this.root = root;
10
+ this.currentNode = root;
11
+ this.whatToShow = whatToShow;
12
+ }
13
+ nextNode() {
14
+ let candidate = this.nextInOrder(this.currentNode);
15
+ while (candidate !== null) {
16
+ if (this.accepts(candidate)) {
17
+ this.currentNode = candidate;
18
+ return candidate;
19
+ }
20
+ candidate = this.nextInOrder(candidate);
21
+ }
22
+ return null;
23
+ }
24
+ parentNode() {
25
+ if (this.currentNode === this.root) {
26
+ return null;
27
+ }
28
+ let candidate = this.currentNode.parentNode;
29
+ while (candidate !== null) {
30
+ if (this.accepts(candidate)) {
31
+ this.currentNode = candidate;
32
+ return candidate;
33
+ }
34
+ if (candidate === this.root) {
35
+ return null;
36
+ }
37
+ candidate = candidate.parentNode;
38
+ }
39
+ return null;
40
+ }
41
+ accepts(node) {
42
+ if (node.nodeType <= 0 || node.nodeType > 32) {
43
+ return false;
44
+ }
45
+ return (this.whatToShow & (1 << (node.nodeType - 1))) !== 0;
46
+ }
47
+ nextInOrder(node) {
48
+ if (node.firstChild !== null) {
49
+ return node.firstChild;
50
+ }
51
+ let current = node;
52
+ while (current !== this.root) {
53
+ const sibling = current.nextSibling;
54
+ if (sibling !== null) {
55
+ return sibling;
56
+ }
57
+ const parent = current.parentNode;
58
+ if (parent === null) {
59
+ return null;
60
+ }
61
+ current = parent;
62
+ }
63
+ return null;
64
+ }
65
+ }
66
+ export class DocumentImpl {
67
+ nodeType = NODE_DOCUMENT;
68
+ createElement(tag) {
69
+ if (tag.toLowerCase() === "template") {
70
+ return new TemplateElementImpl(this);
71
+ }
72
+ return new ElementImpl(tag);
73
+ }
74
+ createElementNS(namespace, tag) {
75
+ if (namespace === SVG_NAMESPACE) {
76
+ return new SvgElementImpl(tag);
77
+ }
78
+ return new ElementImpl(tag, namespace);
79
+ }
80
+ createComment(data) {
81
+ return new CommentImpl(data);
82
+ }
83
+ createTextNode(data) {
84
+ return new TextImpl(data);
85
+ }
86
+ createDocumentFragment() {
87
+ return new DocumentFragmentImpl();
88
+ }
89
+ createTreeWalker(root, whatToShow) {
90
+ return new TreeWalkerImpl(root, whatToShow);
91
+ }
92
+ }
93
+ export function createDocument() {
94
+ return new DocumentImpl();
95
+ }
96
+ const NODE_CONSTANTS = [
97
+ ["ELEMENT_NODE", NODE_ELEMENT],
98
+ ["TEXT_NODE", NODE_TEXT],
99
+ ["COMMENT_NODE", NODE_COMMENT],
100
+ ["DOCUMENT_NODE", NODE_DOCUMENT],
101
+ ["DOCUMENT_FRAGMENT_NODE", NODE_DOCUMENT_FRAGMENT],
102
+ ];
103
+ const GLOBAL_VALUES = [
104
+ ["Element", ElementImpl],
105
+ ["SVGElement", SvgElementImpl],
106
+ ["DocumentFragment", DocumentFragmentImpl],
107
+ ["Text", TextImpl],
108
+ ["Comment", CommentImpl],
109
+ ["HTMLTemplateElement", TemplateElementImpl],
110
+ ["NodeFilter", { SHOW_ALL, SHOW_ELEMENT, SHOW_COMMENT }],
111
+ ];
112
+ function defineNodeConstants() {
113
+ for (const [name, value] of NODE_CONSTANTS) {
114
+ if (!(name in NodeImpl)) {
115
+ Object.defineProperty(NodeImpl, name, { configurable: true, writable: false, value });
116
+ }
117
+ }
118
+ }
119
+ export function installDomGlobals(document = createDocument()) {
120
+ defineNodeConstants();
121
+ const values = [
122
+ ["document", document],
123
+ ["Node", NodeImpl],
124
+ ...GLOBAL_VALUES,
125
+ ];
126
+ const saved = new Map();
127
+ for (const [name, value] of values) {
128
+ saved.set(name, Object.getOwnPropertyDescriptor(globalThis, name));
129
+ Object.defineProperty(globalThis, name, {
130
+ configurable: true,
131
+ writable: true,
132
+ enumerable: true,
133
+ value,
134
+ });
135
+ }
136
+ let restored = false;
137
+ return () => {
138
+ if (restored) {
139
+ return;
140
+ }
141
+ restored = true;
142
+ for (const [name, descriptor] of saved) {
143
+ if (descriptor === undefined) {
144
+ Reflect.deleteProperty(globalThis, name);
145
+ continue;
146
+ }
147
+ Object.defineProperty(globalThis, name, descriptor);
148
+ }
149
+ };
150
+ }
151
+ //# sourceMappingURL=document.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/dom/document.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,77 @@
1
+ import type { DomCharacterData, DomDocument, DomDocumentFragment, DomElement, DomNode } from "./types.js";
2
+ import { AttributesImpl } from "./attributes.js";
3
+ import { StyleImpl } from "./style.js";
4
+ type InnerHtmlParser = (document: DomDocument, html: string) => DomNode[];
5
+ export declare function setInnerHtmlParser(parser: InnerHtmlParser): void;
6
+ export declare class NodeImpl implements DomNode {
7
+ readonly nodeType: number;
8
+ protected readonly childList: NodeImpl[];
9
+ protected parent: NodeImpl | null;
10
+ protected next: NodeImpl | null;
11
+ protected previous: NodeImpl | null;
12
+ constructor(nodeType: number);
13
+ get parentNode(): NodeImpl | null;
14
+ get firstChild(): NodeImpl | null;
15
+ get lastChild(): NodeImpl | null;
16
+ get nextSibling(): NodeImpl | null;
17
+ get previousSibling(): NodeImpl | null;
18
+ get childNodes(): readonly NodeImpl[];
19
+ get textContent(): string | null;
20
+ set textContent(value: string | null);
21
+ appendChild<T extends DomNode>(node: T): T;
22
+ insertBefore<T extends DomNode>(node: T, reference: DomNode | null): T;
23
+ removeChild<T extends DomNode>(node: T): T;
24
+ remove(): void;
25
+ addEventListener(_type: string, _listener: unknown, _options?: unknown): void;
26
+ removeEventListener(_type: string, _listener: unknown, _options?: unknown): void;
27
+ dispatchEvent(_event: unknown): boolean;
28
+ cloneNode(deep?: boolean): NodeImpl;
29
+ protected createShallowClone(): NodeImpl;
30
+ private insertSingle;
31
+ private detachFromParent;
32
+ }
33
+ export declare class TextImpl extends NodeImpl implements DomCharacterData {
34
+ readonly nodeType: number;
35
+ data: string;
36
+ constructor(data: string);
37
+ protected createShallowClone(): TextImpl;
38
+ }
39
+ export declare class CommentImpl extends TextImpl {
40
+ readonly nodeType: number;
41
+ constructor(data: string);
42
+ protected createShallowClone(): CommentImpl;
43
+ }
44
+ export declare class DocumentFragmentImpl extends NodeImpl implements DomDocumentFragment {
45
+ readonly nodeType = 11;
46
+ constructor();
47
+ protected createShallowClone(): DocumentFragmentImpl;
48
+ }
49
+ export declare class ElementImpl extends NodeImpl implements DomElement {
50
+ readonly nodeType = 1;
51
+ readonly tagName: string;
52
+ readonly nodeName: string;
53
+ readonly namespaceURI: string;
54
+ readonly attributes: AttributesImpl;
55
+ readonly style: StyleImpl;
56
+ private valueState;
57
+ constructor(tagName: string, namespaceURI?: string);
58
+ getAttribute(name: string): string | null;
59
+ setAttribute(name: string, value: string): void;
60
+ hasAttribute(name: string): boolean;
61
+ removeAttribute(name: string): void;
62
+ get value(): string;
63
+ set value(next: string | number | boolean | null | undefined);
64
+ get innerHTML(): string;
65
+ set innerHTML(value: string);
66
+ protected createShallowClone(): ElementImpl;
67
+ protected createEmptyClone(): ElementImpl;
68
+ private syncStyle;
69
+ private normalizeName;
70
+ }
71
+ export declare class SvgElementImpl extends ElementImpl {
72
+ constructor(tagName: string);
73
+ protected createEmptyClone(): SvgElementImpl;
74
+ }
75
+ export declare function isElementNode(node: DomNode): node is ElementImpl;
76
+ export {};
77
+ //# sourceMappingURL=node.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/dom/node.ts"],"names":[],"mappings":"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"}