sibujs 1.4.0 → 2.0.0
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/README.md +105 -119
- package/dist/browser.cjs +288 -80
- package/dist/browser.d.cts +19 -9
- package/dist/browser.d.ts +19 -9
- package/dist/browser.js +6 -6
- package/dist/build.cjs +1019 -313
- package/dist/build.d.cts +1 -1
- package/dist/build.d.ts +1 -1
- package/dist/build.js +15 -13
- package/dist/cdn.global.js +17 -16
- package/dist/chunk-2RA7SHDA.js +65 -0
- package/dist/chunk-2UPRY23K.js +80 -0
- package/dist/chunk-3JHCYHWN.js +125 -0
- package/dist/{chunk-ZWKZCBO6.js → chunk-3LR7GLWQ.js} +154 -33
- package/dist/{chunk-3AIRKM3B.js → chunk-3NSGB5JN.js} +115 -34
- package/dist/{chunk-3ARAQO7B.js → chunk-52YJLLRO.js} +29 -6
- package/dist/chunk-54EDRCEF.js +93 -0
- package/dist/chunk-7JDB7I65.js +1327 -0
- package/dist/{chunk-WZSPOOER.js → chunk-CC65Y57T.js} +8 -5
- package/dist/{chunk-23VV7YD3.js → chunk-DFPFITST.js} +25 -30
- package/dist/{chunk-WR5D4EGH.js → chunk-GTBNNBJ6.js} +14 -2
- package/dist/chunk-HB24TBAF.js +121 -0
- package/dist/{chunk-CZUGLNJS.js → chunk-ITX6OO3F.js} +3 -3
- package/dist/{chunk-JAKHTMQU.js → chunk-JA6667UN.js} +206 -46
- package/dist/{chunk-77L6NL3X.js → chunk-JXMMDLBY.js} +306 -183
- package/dist/{chunk-3X2YG6YM.js → chunk-JYD2PWXH.js} +59 -28
- package/dist/{chunk-F3FA4F32.js → chunk-KLRMB5ZS.js} +135 -79
- package/dist/{chunk-5X6PP2UK.js → chunk-LMLD24FC.js} +2 -2
- package/dist/{chunk-M4NLBH4I.js → chunk-LYTCUZ7H.js} +3 -2
- package/dist/{chunk-TSOKIX5Z.js → chunk-MIUAXB7K.js} +126 -74
- package/dist/{chunk-QWZG56ET.js → chunk-ND2664SF.js} +558 -190
- package/dist/{chunk-JCI5M6U6.js → chunk-O2MNQFLP.js} +261 -79
- package/dist/{chunk-EWFVA3TJ.js → chunk-R73P76YZ.js} +1 -1
- package/dist/{chunk-2BYQDGN3.js → chunk-SAHNHTFC.js} +234 -63
- package/dist/chunk-UCS6AMJ7.js +79 -0
- package/dist/{chunk-ZD6OAMTH.js → chunk-VLPPXTYG.js} +90 -35
- package/dist/{chunk-OUZZEE4S.js → chunk-WOMYAHHI.js} +17 -11
- package/dist/{contracts-xo5ckdRP.d.cts → contracts-ey_Qh8ef.d.cts} +7 -8
- package/dist/{contracts-xo5ckdRP.d.ts → contracts-ey_Qh8ef.d.ts} +7 -8
- package/dist/{customElement-D2DJp_xn.d.cts → customElement-CPfIrbvg.d.cts} +18 -9
- package/dist/{customElement-D2DJp_xn.d.ts → customElement-CPfIrbvg.d.ts} +18 -9
- package/dist/data.cjs +452 -100
- package/dist/data.d.cts +20 -2
- package/dist/data.d.ts +20 -2
- package/dist/data.js +11 -9
- package/dist/devtools.cjs +535 -247
- package/dist/devtools.d.cts +1 -1
- package/dist/devtools.d.ts +1 -1
- package/dist/devtools.js +34 -30
- package/dist/ecosystem.cjs +499 -143
- package/dist/ecosystem.d.cts +13 -11
- package/dist/ecosystem.d.ts +13 -11
- package/dist/ecosystem.js +12 -11
- package/dist/extras.cjs +3639 -1629
- package/dist/extras.d.cts +11 -11
- package/dist/extras.d.ts +11 -11
- package/dist/extras.js +58 -45
- package/dist/index.cjs +1023 -313
- package/dist/index.d.cts +128 -55
- package/dist/index.d.ts +128 -55
- package/dist/index.js +28 -16
- package/dist/{introspect-BumjnBKr.d.cts → introspect-BWNjNw64.d.cts} +22 -2
- package/dist/{introspect-CZrlcaYy.d.ts → introspect-cY2pg9pW.d.ts} +22 -2
- package/dist/motion.cjs +90 -36
- package/dist/motion.d.cts +1 -1
- package/dist/motion.d.ts +1 -1
- package/dist/motion.js +4 -4
- package/dist/patterns.cjs +414 -81
- package/dist/patterns.d.cts +53 -20
- package/dist/patterns.d.ts +53 -20
- package/dist/patterns.js +7 -7
- package/dist/performance.cjs +364 -108
- package/dist/performance.d.cts +29 -17
- package/dist/performance.d.ts +29 -17
- package/dist/performance.js +13 -6
- package/dist/plugin-D30wlGW5.d.cts +71 -0
- package/dist/plugin-D30wlGW5.d.ts +71 -0
- package/dist/plugins.cjs +652 -271
- package/dist/plugins.d.cts +13 -6
- package/dist/plugins.d.ts +13 -6
- package/dist/plugins.js +116 -50
- package/dist/{ssr-Do_SiVoL.d.cts → ssr-CrVNy6Pa.d.cts} +9 -15
- package/dist/{ssr-Do_SiVoL.d.ts → ssr-CrVNy6Pa.d.ts} +9 -15
- package/dist/{ssr-4PBXAOO3.js → ssr-FXD2PPMC.js} +4 -3
- package/dist/ssr.cjs +648 -219
- package/dist/ssr.d.cts +27 -7
- package/dist/ssr.d.ts +27 -7
- package/dist/ssr.js +12 -11
- package/dist/{tagFactory-DaJ0YWX6.d.ts → tagFactory-S17H2qxu.d.cts} +9 -1
- package/dist/{tagFactory-DaJ0YWX6.d.cts → tagFactory-S17H2qxu.d.ts} +9 -1
- package/dist/testing.cjs +252 -63
- package/dist/testing.d.cts +17 -4
- package/dist/testing.d.ts +17 -4
- package/dist/testing.js +100 -44
- package/dist/ui.cjs +576 -168
- package/dist/ui.d.cts +13 -16
- package/dist/ui.d.ts +13 -16
- package/dist/ui.js +20 -17
- package/dist/widgets.cjs +1001 -93
- package/dist/widgets.d.cts +104 -2
- package/dist/widgets.d.ts +104 -2
- package/dist/widgets.js +9 -7
- package/package.json +8 -2
- package/dist/chunk-32DY64NT.js +0 -282
- package/dist/chunk-3CRQALYP.js +0 -877
- package/dist/chunk-4EI4AG32.js +0 -482
- package/dist/chunk-4MYMUBRS.js +0 -21
- package/dist/chunk-6HLLIF3K.js +0 -398
- package/dist/chunk-6LSNVCS2.js +0 -937
- package/dist/chunk-6SA3QQES.js +0 -61
- package/dist/chunk-7BF6TK55.js +0 -1097
- package/dist/chunk-7TQKR4PP.js +0 -294
- package/dist/chunk-7V26P53V.js +0 -712
- package/dist/chunk-AZ3ISID5.js +0 -298
- package/dist/chunk-B7SWRFUT.js +0 -332
- package/dist/chunk-BGN5ZMP4.js +0 -26
- package/dist/chunk-BTU3TJDS.js +0 -365
- package/dist/chunk-BW3WT46K.js +0 -937
- package/dist/chunk-C6KFWOFV.js +0 -616
- package/dist/chunk-CHF5OHIA.js +0 -61
- package/dist/chunk-CHJ27IGK.js +0 -26
- package/dist/chunk-CMBFNA7L.js +0 -27
- package/dist/chunk-DAHRH4ON.js +0 -331
- package/dist/chunk-DKOHBI74.js +0 -924
- package/dist/chunk-DTCOOBMX.js +0 -725
- package/dist/chunk-EBGIRKQY.js +0 -616
- package/dist/chunk-EUZND3CB.js +0 -27
- package/dist/chunk-EVCZO745.js +0 -365
- package/dist/chunk-FGOEVHY3.js +0 -60
- package/dist/chunk-G3BOQPVO.js +0 -365
- package/dist/chunk-GCOK2LC3.js +0 -282
- package/dist/chunk-HGMJFBC7.js +0 -654
- package/dist/chunk-K5ZUMYVS.js +0 -89
- package/dist/chunk-KQPDEVVS.js +0 -398
- package/dist/chunk-L6JRBDNS.js +0 -60
- package/dist/chunk-LA6KQEDU.js +0 -712
- package/dist/chunk-MDVXJWFN.js +0 -304
- package/dist/chunk-MEZVEBPN.js +0 -2008
- package/dist/chunk-MK4ERFYL.js +0 -2249
- package/dist/chunk-MLKGABMK.js +0 -9
- package/dist/chunk-MQ5GOYPH.js +0 -2249
- package/dist/chunk-N6IZB6KJ.js +0 -567
- package/dist/chunk-NEKUBFPT.js +0 -60
- package/dist/chunk-NHUC2QWH.js +0 -282
- package/dist/chunk-NMRUZALC.js +0 -1097
- package/dist/chunk-NYVAC6P5.js +0 -37
- package/dist/chunk-OF7UZIVB.js +0 -725
- package/dist/chunk-P6W3STU4.js +0 -2249
- package/dist/chunk-PBHF5WKN.js +0 -616
- package/dist/chunk-PTQJDMRT.js +0 -146
- package/dist/chunk-PZEGYCF5.js +0 -61
- package/dist/chunk-QBMDLBU2.js +0 -975
- package/dist/chunk-RQGQSLQK.js +0 -725
- package/dist/chunk-SDLZDHKP.js +0 -107
- package/dist/chunk-TNQWPPE6.js +0 -37
- package/dist/chunk-UHNL42EF.js +0 -2730
- package/dist/chunk-UNXCEF6S.js +0 -21
- package/dist/chunk-V2XTI523.js +0 -347
- package/dist/chunk-VAU366PN.js +0 -2241
- package/dist/chunk-VMVDTCXB.js +0 -712
- package/dist/chunk-VRW3FULF.js +0 -725
- package/dist/chunk-WADYRCO2.js +0 -304
- package/dist/chunk-WILQZRO4.js +0 -282
- package/dist/chunk-WUHJISPP.js +0 -298
- package/dist/chunk-XYU6TZOW.js +0 -182
- package/dist/chunk-Y6GP4QGG.js +0 -276
- package/dist/chunk-YECR7UIA.js +0 -347
- package/dist/chunk-YUTWTI4B.js +0 -654
- package/dist/chunk-Z65KYU7I.js +0 -26
- package/dist/chunk-Z6POF5YC.js +0 -975
- package/dist/chunk-ZBJP6WFL.js +0 -482
- package/dist/contracts-DDrwxvJ-.d.cts +0 -245
- package/dist/contracts-DDrwxvJ-.d.ts +0 -245
- package/dist/contracts-DOrhwbke.d.cts +0 -245
- package/dist/contracts-DOrhwbke.d.ts +0 -245
- package/dist/customElement-BKQfbSZQ.d.cts +0 -262
- package/dist/customElement-BKQfbSZQ.d.ts +0 -262
- package/dist/customElement-yz8uyk-0.d.cts +0 -308
- package/dist/customElement-yz8uyk-0.d.ts +0 -308
- package/dist/introspect-Cb0zgpi2.d.cts +0 -477
- package/dist/introspect-Y2xNXGSf.d.ts +0 -477
- package/dist/plugin-Bek4RhJY.d.cts +0 -43
- package/dist/plugin-Bek4RhJY.d.ts +0 -43
- package/dist/ssr-3RXHP5ES.js +0 -38
- package/dist/ssr-6GIMY5MX.js +0 -38
- package/dist/ssr-BA6sxxUd.d.cts +0 -135
- package/dist/ssr-BA6sxxUd.d.ts +0 -135
- package/dist/ssr-WKUPVSSK.js +0 -36
- package/dist/tagFactory-Dl8QCLga.d.cts +0 -23
- package/dist/tagFactory-Dl8QCLga.d.ts +0 -23
package/dist/ssr-BA6sxxUd.d.cts
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Converts an HTMLElement tree to an HTML string for server-side rendering.
|
|
3
|
-
*/
|
|
4
|
-
declare function renderToString(element: HTMLElement | DocumentFragment | Node): string;
|
|
5
|
-
/**
|
|
6
|
-
* Hydrates a server-rendered DOM tree by attaching event listeners
|
|
7
|
-
* and activating reactive bindings.
|
|
8
|
-
*/
|
|
9
|
-
declare function hydrate(component: () => HTMLElement, container: HTMLElement): void;
|
|
10
|
-
/**
|
|
11
|
-
* Branded type for raw HTML that has been explicitly marked as trusted.
|
|
12
|
-
* Use `trustHTML()` to create a value of this type. This prevents
|
|
13
|
-
* accidental injection of unsanitized user input into `headExtra`.
|
|
14
|
-
*/
|
|
15
|
-
type TrustedHTML = string & {
|
|
16
|
-
readonly __brand: "TrustedHTML";
|
|
17
|
-
};
|
|
18
|
-
/**
|
|
19
|
-
* Mark an HTML string as trusted for use in contexts that accept raw HTML
|
|
20
|
-
* (e.g. `renderToDocument({ headExtra })`). Only call this on
|
|
21
|
-
* developer-controlled strings — never on user input.
|
|
22
|
-
*
|
|
23
|
-
* @example
|
|
24
|
-
* ```ts
|
|
25
|
-
* const extra = trustHTML('<link rel="preconnect" href="https://fonts.googleapis.com">');
|
|
26
|
-
* renderToDocument(App, { headExtra: extra });
|
|
27
|
-
* ```
|
|
28
|
-
*/
|
|
29
|
-
declare function trustHTML(html: string): TrustedHTML;
|
|
30
|
-
/**
|
|
31
|
-
* Renders a component to a full HTML document string.
|
|
32
|
-
*
|
|
33
|
-
* `headExtra` requires a `TrustedHTML` value created via `trustHTML()`.
|
|
34
|
-
* This prevents accidental injection of unsanitized user input.
|
|
35
|
-
*/
|
|
36
|
-
declare function renderToDocument(component: () => HTMLElement, options?: {
|
|
37
|
-
title?: string;
|
|
38
|
-
meta?: Record<string, string>[];
|
|
39
|
-
links?: Record<string, string>[];
|
|
40
|
-
scripts?: string[];
|
|
41
|
-
bodyAttrs?: Record<string, string>;
|
|
42
|
-
/**
|
|
43
|
-
* Raw HTML injected into `<head>`. Must be wrapped in `trustHTML()`
|
|
44
|
-
* to confirm the content is developer-controlled.
|
|
45
|
-
*/
|
|
46
|
-
headExtra?: TrustedHTML;
|
|
47
|
-
}): string;
|
|
48
|
-
/**
|
|
49
|
-
* Renders a component tree to an async iterable of HTML chunks.
|
|
50
|
-
* Enables progressive server-side rendering — the consumer can write
|
|
51
|
-
* each chunk to a response stream as it becomes available.
|
|
52
|
-
*/
|
|
53
|
-
declare function renderToStream(element: HTMLElement | DocumentFragment | Node): AsyncGenerator<string>;
|
|
54
|
-
/**
|
|
55
|
-
* Collects the full output of renderToStream into a string.
|
|
56
|
-
*/
|
|
57
|
-
declare function collectStream(stream: AsyncGenerator<string> | AsyncIterable<string>): Promise<string>;
|
|
58
|
-
/**
|
|
59
|
-
* Renders a component tree to a Web ReadableStream<string>.
|
|
60
|
-
* Compatible with Node 18+, Deno, and edge runtimes.
|
|
61
|
-
* Uses pull-based backpressure — chunks are produced on demand.
|
|
62
|
-
*/
|
|
63
|
-
declare function renderToReadableStream(element: HTMLElement | DocumentFragment | Node): ReadableStream<string>;
|
|
64
|
-
/**
|
|
65
|
-
* Marks an element as a hydration island. During partial hydration
|
|
66
|
-
* only elements marked with `data-sibu-island` will be hydrated.
|
|
67
|
-
*/
|
|
68
|
-
declare function island(id: string, component: () => HTMLElement): HTMLElement;
|
|
69
|
-
/**
|
|
70
|
-
* Hydrate only elements marked as islands (`data-sibu-island`).
|
|
71
|
-
* Non-island content keeps its server-rendered HTML untouched.
|
|
72
|
-
*/
|
|
73
|
-
declare function hydrateIslands(container: HTMLElement, islands: Record<string, () => HTMLElement>): void;
|
|
74
|
-
/**
|
|
75
|
-
* Progressively hydrate islands only when they enter the viewport.
|
|
76
|
-
* Uses IntersectionObserver to defer hydration of off-screen islands,
|
|
77
|
-
* reducing initial JavaScript execution cost.
|
|
78
|
-
*
|
|
79
|
-
* Returns a cleanup function that disconnects all observers.
|
|
80
|
-
*/
|
|
81
|
-
declare function hydrateProgressively(container: HTMLElement, islands: Record<string, () => HTMLElement>, options?: IntersectionObserverInit): () => void;
|
|
82
|
-
/**
|
|
83
|
-
* Reset SSR state between requests. Call at the start of each SSR render
|
|
84
|
-
* to prevent ID drift in long-lived server processes.
|
|
85
|
-
*/
|
|
86
|
-
declare function resetSSRState(): void;
|
|
87
|
-
/**
|
|
88
|
-
* Create a suspense boundary for SSR streaming.
|
|
89
|
-
* Renders fallback HTML inline and returns a promise for the resolved content.
|
|
90
|
-
*
|
|
91
|
-
* The returned element contains the fallback UI with a `data-sibu-suspense-id`
|
|
92
|
-
* marker. The promise resolves to `{ id, html }` once async content is ready.
|
|
93
|
-
*/
|
|
94
|
-
declare function ssrSuspense(props: {
|
|
95
|
-
fallback: () => HTMLElement;
|
|
96
|
-
content: () => Promise<HTMLElement>;
|
|
97
|
-
}): {
|
|
98
|
-
element: HTMLElement;
|
|
99
|
-
promise: Promise<{
|
|
100
|
-
id: string;
|
|
101
|
-
html: string;
|
|
102
|
-
}>;
|
|
103
|
-
};
|
|
104
|
-
/**
|
|
105
|
-
* Generate an inline script that swaps a suspense fallback with resolved content.
|
|
106
|
-
* The id is escaped for both JS string and HTML attribute contexts to prevent injection.
|
|
107
|
-
*/
|
|
108
|
-
declare function suspenseSwapScript(id: string, nonce?: string): string;
|
|
109
|
-
/**
|
|
110
|
-
* Renders a component tree with suspense boundaries as a stream.
|
|
111
|
-
* Yields the main tree HTML first (including fallback content for suspended
|
|
112
|
-
* boundaries), then flushes resolved content with inline swap scripts.
|
|
113
|
-
*/
|
|
114
|
-
declare function renderToSuspenseStream(element: HTMLElement | DocumentFragment | Node, pendingBoundaries?: Promise<{
|
|
115
|
-
id: string;
|
|
116
|
-
html: string;
|
|
117
|
-
}>[]): AsyncGenerator<string>;
|
|
118
|
-
/**
|
|
119
|
-
* Serialize application state into an HTML script tag for SSR.
|
|
120
|
-
* The serialized data is embedded in the document and picked up
|
|
121
|
-
* on the client with `deserializeState()`.
|
|
122
|
-
*/
|
|
123
|
-
declare function serializeState(state: Record<string, unknown>, nonce?: string): string;
|
|
124
|
-
/**
|
|
125
|
-
* Retrieve state that was embedded by `serializeState()` during SSR.
|
|
126
|
-
*
|
|
127
|
-
* When a `validate` function is provided, it acts as a type guard —
|
|
128
|
-
* only data that passes validation is returned. This prevents
|
|
129
|
-
* tampered SSR payloads from being trusted by the client.
|
|
130
|
-
*
|
|
131
|
-
* @param validate Optional type guard to verify data integrity
|
|
132
|
-
*/
|
|
133
|
-
declare function deserializeState<T = Record<string, unknown>>(validate?: (data: unknown) => data is T): T | undefined;
|
|
134
|
-
|
|
135
|
-
export { type TrustedHTML as T, hydrateIslands as a, hydrateProgressively as b, collectStream as c, deserializeState as d, renderToReadableStream as e, renderToStream as f, renderToString as g, hydrate as h, island as i, renderToSuspenseStream as j, resetSSRState as k, ssrSuspense as l, suspenseSwapScript as m, renderToDocument as r, serializeState as s, trustHTML as t };
|
package/dist/ssr-BA6sxxUd.d.ts
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Converts an HTMLElement tree to an HTML string for server-side rendering.
|
|
3
|
-
*/
|
|
4
|
-
declare function renderToString(element: HTMLElement | DocumentFragment | Node): string;
|
|
5
|
-
/**
|
|
6
|
-
* Hydrates a server-rendered DOM tree by attaching event listeners
|
|
7
|
-
* and activating reactive bindings.
|
|
8
|
-
*/
|
|
9
|
-
declare function hydrate(component: () => HTMLElement, container: HTMLElement): void;
|
|
10
|
-
/**
|
|
11
|
-
* Branded type for raw HTML that has been explicitly marked as trusted.
|
|
12
|
-
* Use `trustHTML()` to create a value of this type. This prevents
|
|
13
|
-
* accidental injection of unsanitized user input into `headExtra`.
|
|
14
|
-
*/
|
|
15
|
-
type TrustedHTML = string & {
|
|
16
|
-
readonly __brand: "TrustedHTML";
|
|
17
|
-
};
|
|
18
|
-
/**
|
|
19
|
-
* Mark an HTML string as trusted for use in contexts that accept raw HTML
|
|
20
|
-
* (e.g. `renderToDocument({ headExtra })`). Only call this on
|
|
21
|
-
* developer-controlled strings — never on user input.
|
|
22
|
-
*
|
|
23
|
-
* @example
|
|
24
|
-
* ```ts
|
|
25
|
-
* const extra = trustHTML('<link rel="preconnect" href="https://fonts.googleapis.com">');
|
|
26
|
-
* renderToDocument(App, { headExtra: extra });
|
|
27
|
-
* ```
|
|
28
|
-
*/
|
|
29
|
-
declare function trustHTML(html: string): TrustedHTML;
|
|
30
|
-
/**
|
|
31
|
-
* Renders a component to a full HTML document string.
|
|
32
|
-
*
|
|
33
|
-
* `headExtra` requires a `TrustedHTML` value created via `trustHTML()`.
|
|
34
|
-
* This prevents accidental injection of unsanitized user input.
|
|
35
|
-
*/
|
|
36
|
-
declare function renderToDocument(component: () => HTMLElement, options?: {
|
|
37
|
-
title?: string;
|
|
38
|
-
meta?: Record<string, string>[];
|
|
39
|
-
links?: Record<string, string>[];
|
|
40
|
-
scripts?: string[];
|
|
41
|
-
bodyAttrs?: Record<string, string>;
|
|
42
|
-
/**
|
|
43
|
-
* Raw HTML injected into `<head>`. Must be wrapped in `trustHTML()`
|
|
44
|
-
* to confirm the content is developer-controlled.
|
|
45
|
-
*/
|
|
46
|
-
headExtra?: TrustedHTML;
|
|
47
|
-
}): string;
|
|
48
|
-
/**
|
|
49
|
-
* Renders a component tree to an async iterable of HTML chunks.
|
|
50
|
-
* Enables progressive server-side rendering — the consumer can write
|
|
51
|
-
* each chunk to a response stream as it becomes available.
|
|
52
|
-
*/
|
|
53
|
-
declare function renderToStream(element: HTMLElement | DocumentFragment | Node): AsyncGenerator<string>;
|
|
54
|
-
/**
|
|
55
|
-
* Collects the full output of renderToStream into a string.
|
|
56
|
-
*/
|
|
57
|
-
declare function collectStream(stream: AsyncGenerator<string> | AsyncIterable<string>): Promise<string>;
|
|
58
|
-
/**
|
|
59
|
-
* Renders a component tree to a Web ReadableStream<string>.
|
|
60
|
-
* Compatible with Node 18+, Deno, and edge runtimes.
|
|
61
|
-
* Uses pull-based backpressure — chunks are produced on demand.
|
|
62
|
-
*/
|
|
63
|
-
declare function renderToReadableStream(element: HTMLElement | DocumentFragment | Node): ReadableStream<string>;
|
|
64
|
-
/**
|
|
65
|
-
* Marks an element as a hydration island. During partial hydration
|
|
66
|
-
* only elements marked with `data-sibu-island` will be hydrated.
|
|
67
|
-
*/
|
|
68
|
-
declare function island(id: string, component: () => HTMLElement): HTMLElement;
|
|
69
|
-
/**
|
|
70
|
-
* Hydrate only elements marked as islands (`data-sibu-island`).
|
|
71
|
-
* Non-island content keeps its server-rendered HTML untouched.
|
|
72
|
-
*/
|
|
73
|
-
declare function hydrateIslands(container: HTMLElement, islands: Record<string, () => HTMLElement>): void;
|
|
74
|
-
/**
|
|
75
|
-
* Progressively hydrate islands only when they enter the viewport.
|
|
76
|
-
* Uses IntersectionObserver to defer hydration of off-screen islands,
|
|
77
|
-
* reducing initial JavaScript execution cost.
|
|
78
|
-
*
|
|
79
|
-
* Returns a cleanup function that disconnects all observers.
|
|
80
|
-
*/
|
|
81
|
-
declare function hydrateProgressively(container: HTMLElement, islands: Record<string, () => HTMLElement>, options?: IntersectionObserverInit): () => void;
|
|
82
|
-
/**
|
|
83
|
-
* Reset SSR state between requests. Call at the start of each SSR render
|
|
84
|
-
* to prevent ID drift in long-lived server processes.
|
|
85
|
-
*/
|
|
86
|
-
declare function resetSSRState(): void;
|
|
87
|
-
/**
|
|
88
|
-
* Create a suspense boundary for SSR streaming.
|
|
89
|
-
* Renders fallback HTML inline and returns a promise for the resolved content.
|
|
90
|
-
*
|
|
91
|
-
* The returned element contains the fallback UI with a `data-sibu-suspense-id`
|
|
92
|
-
* marker. The promise resolves to `{ id, html }` once async content is ready.
|
|
93
|
-
*/
|
|
94
|
-
declare function ssrSuspense(props: {
|
|
95
|
-
fallback: () => HTMLElement;
|
|
96
|
-
content: () => Promise<HTMLElement>;
|
|
97
|
-
}): {
|
|
98
|
-
element: HTMLElement;
|
|
99
|
-
promise: Promise<{
|
|
100
|
-
id: string;
|
|
101
|
-
html: string;
|
|
102
|
-
}>;
|
|
103
|
-
};
|
|
104
|
-
/**
|
|
105
|
-
* Generate an inline script that swaps a suspense fallback with resolved content.
|
|
106
|
-
* The id is escaped for both JS string and HTML attribute contexts to prevent injection.
|
|
107
|
-
*/
|
|
108
|
-
declare function suspenseSwapScript(id: string, nonce?: string): string;
|
|
109
|
-
/**
|
|
110
|
-
* Renders a component tree with suspense boundaries as a stream.
|
|
111
|
-
* Yields the main tree HTML first (including fallback content for suspended
|
|
112
|
-
* boundaries), then flushes resolved content with inline swap scripts.
|
|
113
|
-
*/
|
|
114
|
-
declare function renderToSuspenseStream(element: HTMLElement | DocumentFragment | Node, pendingBoundaries?: Promise<{
|
|
115
|
-
id: string;
|
|
116
|
-
html: string;
|
|
117
|
-
}>[]): AsyncGenerator<string>;
|
|
118
|
-
/**
|
|
119
|
-
* Serialize application state into an HTML script tag for SSR.
|
|
120
|
-
* The serialized data is embedded in the document and picked up
|
|
121
|
-
* on the client with `deserializeState()`.
|
|
122
|
-
*/
|
|
123
|
-
declare function serializeState(state: Record<string, unknown>, nonce?: string): string;
|
|
124
|
-
/**
|
|
125
|
-
* Retrieve state that was embedded by `serializeState()` during SSR.
|
|
126
|
-
*
|
|
127
|
-
* When a `validate` function is provided, it acts as a type guard —
|
|
128
|
-
* only data that passes validation is returned. This prevents
|
|
129
|
-
* tampered SSR payloads from being trusted by the client.
|
|
130
|
-
*
|
|
131
|
-
* @param validate Optional type guard to verify data integrity
|
|
132
|
-
*/
|
|
133
|
-
declare function deserializeState<T = Record<string, unknown>>(validate?: (data: unknown) => data is T): T | undefined;
|
|
134
|
-
|
|
135
|
-
export { type TrustedHTML as T, hydrateIslands as a, hydrateProgressively as b, collectStream as c, deserializeState as d, renderToReadableStream as e, renderToStream as f, renderToString as g, hydrate as h, island as i, renderToSuspenseStream as j, resetSSRState as k, ssrSuspense as l, suspenseSwapScript as m, renderToDocument as r, serializeState as s, trustHTML as t };
|
package/dist/ssr-WKUPVSSK.js
DELETED
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
collectStream,
|
|
3
|
-
deserializeState,
|
|
4
|
-
hydrate,
|
|
5
|
-
hydrateIslands,
|
|
6
|
-
hydrateProgressively,
|
|
7
|
-
island,
|
|
8
|
-
renderToDocument,
|
|
9
|
-
renderToReadableStream,
|
|
10
|
-
renderToStream,
|
|
11
|
-
renderToString,
|
|
12
|
-
renderToSuspenseStream,
|
|
13
|
-
resetSSRState,
|
|
14
|
-
serializeState,
|
|
15
|
-
ssrSuspense,
|
|
16
|
-
suspenseSwapScript
|
|
17
|
-
} from "./chunk-7TQKR4PP.js";
|
|
18
|
-
import "./chunk-4MYMUBRS.js";
|
|
19
|
-
import "./chunk-MLKGABMK.js";
|
|
20
|
-
export {
|
|
21
|
-
collectStream,
|
|
22
|
-
deserializeState,
|
|
23
|
-
hydrate,
|
|
24
|
-
hydrateIslands,
|
|
25
|
-
hydrateProgressively,
|
|
26
|
-
island,
|
|
27
|
-
renderToDocument,
|
|
28
|
-
renderToReadableStream,
|
|
29
|
-
renderToStream,
|
|
30
|
-
renderToString,
|
|
31
|
-
renderToSuspenseStream,
|
|
32
|
-
resetSSRState,
|
|
33
|
-
serializeState,
|
|
34
|
-
ssrSuspense,
|
|
35
|
-
suspenseSwapScript
|
|
36
|
-
};
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
type NodeChild = Node | Element | Text | Comment | string | number | boolean | (() => NodeChild) | null | undefined;
|
|
2
|
-
type NodeChildren = NodeChild | NodeChild[] | NodeChild[][] | (() => NodeChild | NodeChild[]);
|
|
3
|
-
|
|
4
|
-
declare const SVG_NS = "http://www.w3.org/2000/svg";
|
|
5
|
-
interface TagProps {
|
|
6
|
-
id?: string;
|
|
7
|
-
class?: string | (() => string) | Record<string, boolean | (() => boolean)>;
|
|
8
|
-
style?: Record<string, string | number | (() => string | number)> | string | (() => string);
|
|
9
|
-
ref?: {
|
|
10
|
-
current: Element | null;
|
|
11
|
-
};
|
|
12
|
-
nodes?: NodeChildren;
|
|
13
|
-
on?: Record<string, (ev: Event) => void>;
|
|
14
|
-
/** Called with the element after creation — useful for imperative bindings */
|
|
15
|
-
onElement?: (el: HTMLElement) => void;
|
|
16
|
-
[attr: string]: unknown;
|
|
17
|
-
}
|
|
18
|
-
/**
|
|
19
|
-
* Factory for creating HTML or SVG elements with reactive props and nodes.
|
|
20
|
-
*/
|
|
21
|
-
declare const tagFactory: (tag: string, ns?: string) => (first?: TagProps | NodeChildren, second?: NodeChildren) => Element;
|
|
22
|
-
|
|
23
|
-
export { type NodeChildren as N, SVG_NS as S, type TagProps as T, type NodeChild as a, tagFactory as t };
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
type NodeChild = Node | Element | Text | Comment | string | number | boolean | (() => NodeChild) | null | undefined;
|
|
2
|
-
type NodeChildren = NodeChild | NodeChild[] | NodeChild[][] | (() => NodeChild | NodeChild[]);
|
|
3
|
-
|
|
4
|
-
declare const SVG_NS = "http://www.w3.org/2000/svg";
|
|
5
|
-
interface TagProps {
|
|
6
|
-
id?: string;
|
|
7
|
-
class?: string | (() => string) | Record<string, boolean | (() => boolean)>;
|
|
8
|
-
style?: Record<string, string | number | (() => string | number)> | string | (() => string);
|
|
9
|
-
ref?: {
|
|
10
|
-
current: Element | null;
|
|
11
|
-
};
|
|
12
|
-
nodes?: NodeChildren;
|
|
13
|
-
on?: Record<string, (ev: Event) => void>;
|
|
14
|
-
/** Called with the element after creation — useful for imperative bindings */
|
|
15
|
-
onElement?: (el: HTMLElement) => void;
|
|
16
|
-
[attr: string]: unknown;
|
|
17
|
-
}
|
|
18
|
-
/**
|
|
19
|
-
* Factory for creating HTML or SVG elements with reactive props and nodes.
|
|
20
|
-
*/
|
|
21
|
-
declare const tagFactory: (tag: string, ns?: string) => (first?: TagProps | NodeChildren, second?: NodeChildren) => Element;
|
|
22
|
-
|
|
23
|
-
export { type NodeChildren as N, SVG_NS as S, type TagProps as T, type NodeChild as a, tagFactory as t };
|