@verajs/renderer 0.1.5 → 0.2.1
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 +1063 -27
- package/dist/development/vera-renderer-hydrate.d.ts +32 -13
- package/dist/development/vera-renderer-hydrate.d.ts.map +1 -1
- package/dist/development/vera-renderer-hydrate.js +1959 -269
- package/dist/development/vera-renderer-hydrate.js.map +1 -1
- package/dist/development/vera-renderer-keyed.d.ts +17 -0
- package/dist/development/vera-renderer-keyed.d.ts.map +1 -0
- package/dist/development/vera-renderer-keyed.js +322 -0
- package/dist/development/vera-renderer-keyed.js.map +1 -0
- package/dist/development/vera-renderer-profiler.d.ts +57 -17
- package/dist/development/vera-renderer-profiler.d.ts.map +1 -1
- package/dist/development/vera-renderer-profiler.js +1592 -244
- package/dist/development/vera-renderer-profiler.js.map +1 -1
- package/dist/development/vera-renderer-slots.d.ts +103 -0
- package/dist/development/vera-renderer-slots.d.ts.map +1 -0
- package/dist/development/vera-renderer-slots.js +1387 -0
- package/dist/development/vera-renderer-slots.js.map +1 -0
- package/dist/development/vera-renderer-spread.d.ts +41 -0
- package/dist/development/vera-renderer-spread.d.ts.map +1 -0
- package/dist/development/vera-renderer-spread.js +633 -0
- package/dist/development/vera-renderer-spread.js.map +1 -0
- package/dist/development/vera-renderer-tag.d.ts +61 -0
- package/dist/development/vera-renderer-tag.d.ts.map +1 -0
- package/dist/development/vera-renderer-tag.js +829 -0
- package/dist/development/vera-renderer-tag.js.map +1 -0
- package/dist/development/vera-renderer.d.ts +41 -16
- package/dist/development/vera-renderer.d.ts.map +1 -1
- package/dist/development/vera-renderer.js +1522 -235
- package/dist/development/vera-renderer.js.map +1 -1
- package/dist/vera-renderer-hydrate.min.js +1 -1
- package/dist/vera-renderer-hydrate.min.js.map +1 -1
- package/dist/vera-renderer-keyed.min.js +2 -0
- package/dist/vera-renderer-keyed.min.js.map +1 -0
- package/dist/vera-renderer-slots.min.js +2 -0
- package/dist/vera-renderer-slots.min.js.map +1 -0
- package/dist/vera-renderer-spread.min.js +2 -0
- package/dist/vera-renderer-spread.min.js.map +1 -0
- package/dist/vera-renderer-tag.min.js +2 -0
- package/dist/vera-renderer-tag.min.js.map +1 -0
- package/dist/vera-renderer.min.js +1 -1
- package/dist/vera-renderer.min.js.map +1 -1
- package/package.json +24 -1
|
@@ -65,15 +65,6 @@ type TemplateResult = {
|
|
|
65
65
|
/** Set by `keyed()`; drives keyed list reconciliation. */
|
|
66
66
|
key?: unknown;
|
|
67
67
|
};
|
|
68
|
-
/**
|
|
69
|
-
* Marks a template result with a stable key so list reconciliation moves it instead of rewriting
|
|
70
|
-
* it. Key all items in a list or none — mixing is undefined behaviour, as are duplicate keys.
|
|
71
|
-
*
|
|
72
|
-
* ```js
|
|
73
|
-
* rows.map((r) => keyed(r.id, html`<tr>...</tr>`))
|
|
74
|
-
* ```
|
|
75
|
-
*/
|
|
76
|
-
declare const keyed: <T>(key: unknown, result: T) => T;
|
|
77
68
|
/**
|
|
78
69
|
* Preserves the DOM of templates a child position toggles away from, instead of destroying it —
|
|
79
70
|
* form values, scroll positions and media playback survive the round trip (lit-html calls this
|
|
@@ -82,18 +73,46 @@ declare const keyed: <T>(key: unknown, result: T) => T;
|
|
|
82
73
|
* ```js
|
|
83
74
|
* html`<div>${hold(editing ? editor() : viewer())}</div>`
|
|
84
75
|
* ```
|
|
76
|
+
*
|
|
77
|
+
* **Anything that is not a template passes straight through.** There is nothing to park for a
|
|
78
|
+
* string, a list, `null` or `false`, and the branch that produces one is the ordinary shape of the
|
|
79
|
+
* expression this wraps — `hold(editing && editor())`, `hold(row ?? null)`. Wrapping those handed
|
|
80
|
+
* the renderer a `{ $h }` carrying a non-template, which reached the held-commit path and threw on
|
|
81
|
+
* `result.strings`: a whole render lost, from a value the same expression renders happily one
|
|
82
|
+
* character to the left. Decided here rather than in the renderer so the hot path pays nothing.
|
|
85
83
|
*/
|
|
86
|
-
declare const hold: (result:
|
|
84
|
+
declare const hold: <T>(result: T) => T | {
|
|
87
85
|
$h: TemplateResult;
|
|
88
86
|
};
|
|
89
87
|
|
|
90
88
|
/**
|
|
91
89
|
* The hydrating `render`: a drop-in for the base entry's. The first render into a container that
|
|
92
|
-
* already has children adopts them; any mismatch clears (keeping `<style
|
|
90
|
+
* already has children adopts them; any mismatch clears (keeping `<style data-vm-sheet="styles">`) and falls
|
|
93
91
|
* through to a clean base render. After the first render, this IS the base render.
|
|
94
92
|
*/
|
|
95
|
-
declare const
|
|
93
|
+
declare const renderInto: (result: unknown, container: Node) => void;
|
|
94
|
+
/**
|
|
95
|
+
* This entry's `renderer` module, bound to the **hydrating** `renderInto`.
|
|
96
|
+
*
|
|
97
|
+
* It used to be a bare re-export of the base entry's descriptor, whose `fn` is the base,
|
|
98
|
+
* non-adopting render — so the natural `import { renderer } from '@verajs/renderer/hydrate';
|
|
99
|
+
* wire([renderer])` wired a renderer that never hydrated. The page still looked right (a first
|
|
100
|
+
* render into a full container clears it and renders fresh), which made the failure silent: every
|
|
101
|
+
* byte of server work discarded, nothing on screen to say so. The header's promise — point the
|
|
102
|
+
* importmap at this bundle "and nothing else changes" — is only true now that the descriptor
|
|
103
|
+
* carries this entry's own function. `connect` and the rest are shared deliberately: they operate
|
|
104
|
+
* on this bundle's copy of the renderer's module state, which both functions read.
|
|
105
|
+
*/
|
|
106
|
+
declare const renderer: {
|
|
107
|
+
fn: never;
|
|
108
|
+
name: string;
|
|
109
|
+
on: "render";
|
|
110
|
+
priority: number;
|
|
111
|
+
connect: (given: {
|
|
112
|
+
get(name: never): unknown;
|
|
113
|
+
}) => void;
|
|
114
|
+
};
|
|
96
115
|
|
|
97
|
-
export { hold,
|
|
116
|
+
export { hold, renderInto, renderer };
|
|
98
117
|
export type { TemplateResult };
|
|
99
118
|
//# sourceMappingURL=vera-renderer-hydrate.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vera-renderer-hydrate.d.ts","sources":["
|
|
1
|
+
{"version":3,"file":"vera-renderer-hydrate.d.ts","sources":["../../src/renderer.ts","../../src/hydrate.ts"],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DG;AAEH,KAAA,cAAS;AAYT;;;;;;;;;;;;;;;AAeG;AACH;AAEI;;AAGJ;;;AAGG;AACH,cAAA,IAAA;AACA,QAAM,cAAgB;AACtB;;;;;;;;;;;;;;;;;;ACjFG;AACH;AAwBA,cAAa;AAGb;AACA;AAEA;;;;AAIG;AACH;;;;","names":[]}
|