@verajs/renderer 0.2.2 → 0.3.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.
Files changed (90) hide show
  1. package/README.md +757 -225
  2. package/dist/development/vera-renderer-elements.d.ts +39 -0
  3. package/dist/development/vera-renderer-elements.d.ts.map +1 -0
  4. package/dist/development/vera-renderer-elements.js +193 -0
  5. package/dist/development/vera-renderer-elements.js.map +1 -0
  6. package/dist/development/vera-renderer-hydrate-slots.d.ts +94 -0
  7. package/dist/development/vera-renderer-hydrate-slots.d.ts.map +1 -0
  8. package/dist/development/vera-renderer-hydrate-slots.js +325 -0
  9. package/dist/development/vera-renderer-hydrate-slots.js.map +1 -0
  10. package/dist/development/vera-renderer-hydration.d.ts +332 -0
  11. package/dist/development/vera-renderer-hydration.d.ts.map +1 -0
  12. package/dist/development/vera-renderer-hydration.js +902 -0
  13. package/dist/development/vera-renderer-hydration.js.map +1 -0
  14. package/dist/development/vera-renderer-keyed.d.ts +25 -8
  15. package/dist/development/vera-renderer-keyed.d.ts.map +1 -1
  16. package/dist/development/vera-renderer-keyed.js +843 -268
  17. package/dist/development/vera-renderer-keyed.js.map +1 -1
  18. package/dist/development/vera-renderer-multi-window.d.ts +5 -0
  19. package/dist/development/vera-renderer-multi-window.d.ts.map +1 -0
  20. package/dist/development/vera-renderer-multi-window.js +40 -0
  21. package/dist/development/vera-renderer-multi-window.js.map +1 -0
  22. package/dist/development/vera-renderer-namespaces.d.ts +64 -0
  23. package/dist/development/vera-renderer-namespaces.d.ts.map +1 -0
  24. package/dist/development/vera-renderer-namespaces.js +94 -0
  25. package/dist/development/vera-renderer-namespaces.js.map +1 -0
  26. package/dist/development/vera-renderer-native-elements.d.ts +13 -0
  27. package/dist/development/vera-renderer-native-elements.d.ts.map +1 -0
  28. package/dist/development/vera-renderer-native-elements.js +231 -0
  29. package/dist/development/vera-renderer-native-elements.js.map +1 -0
  30. package/dist/development/vera-renderer-portal.d.ts +29 -0
  31. package/dist/development/vera-renderer-portal.d.ts.map +1 -0
  32. package/dist/development/vera-renderer-portal.js +167 -0
  33. package/dist/development/vera-renderer-portal.js.map +1 -0
  34. package/dist/development/vera-renderer-profiler.d.ts +48 -96
  35. package/dist/development/vera-renderer-profiler.d.ts.map +1 -1
  36. package/dist/development/vera-renderer-profiler.js +2632 -2142
  37. package/dist/development/vera-renderer-profiler.js.map +1 -1
  38. package/dist/development/vera-renderer-slots.d.ts +88 -92
  39. package/dist/development/vera-renderer-slots.d.ts.map +1 -1
  40. package/dist/development/vera-renderer-slots.js +1834 -1237
  41. package/dist/development/vera-renderer-slots.js.map +1 -1
  42. package/dist/development/vera-renderer-spread.d.ts +7 -41
  43. package/dist/development/vera-renderer-spread.d.ts.map +1 -1
  44. package/dist/development/vera-renderer-spread.js +539 -477
  45. package/dist/development/vera-renderer-spread.js.map +1 -1
  46. package/dist/development/vera-renderer-tag.d.ts +12 -3
  47. package/dist/development/vera-renderer-tag.d.ts.map +1 -1
  48. package/dist/development/vera-renderer-tag.js +671 -513
  49. package/dist/development/vera-renderer-tag.js.map +1 -1
  50. package/dist/development/vera-renderer-until.d.ts +24 -0
  51. package/dist/development/vera-renderer-until.d.ts.map +1 -0
  52. package/dist/development/vera-renderer-until.js +83 -0
  53. package/dist/development/vera-renderer-until.js.map +1 -0
  54. package/dist/development/vera-renderer.d.ts +48 -96
  55. package/dist/development/vera-renderer.d.ts.map +1 -1
  56. package/dist/development/vera-renderer.js +2607 -2104
  57. package/dist/development/vera-renderer.js.map +1 -1
  58. package/dist/vera-renderer-elements.min.js +2 -0
  59. package/dist/vera-renderer-elements.min.js.map +1 -0
  60. package/dist/vera-renderer-hydrate-slots.min.js +2 -0
  61. package/dist/vera-renderer-hydrate-slots.min.js.map +1 -0
  62. package/dist/vera-renderer-hydration.min.js +3 -0
  63. package/dist/vera-renderer-hydration.min.js.map +1 -0
  64. package/dist/vera-renderer-keyed.min.js +1 -1
  65. package/dist/vera-renderer-keyed.min.js.map +1 -1
  66. package/dist/vera-renderer-multi-window.min.js +2 -0
  67. package/dist/vera-renderer-multi-window.min.js.map +1 -0
  68. package/dist/vera-renderer-namespaces.min.js +2 -0
  69. package/dist/vera-renderer-namespaces.min.js.map +1 -0
  70. package/dist/vera-renderer-native-elements.min.js +2 -0
  71. package/dist/vera-renderer-native-elements.min.js.map +1 -0
  72. package/dist/vera-renderer-portal.min.js +2 -0
  73. package/dist/vera-renderer-portal.min.js.map +1 -0
  74. package/dist/vera-renderer-slots.min.js +1 -1
  75. package/dist/vera-renderer-slots.min.js.map +1 -1
  76. package/dist/vera-renderer-spread.min.js +1 -1
  77. package/dist/vera-renderer-spread.min.js.map +1 -1
  78. package/dist/vera-renderer-tag.min.js +1 -1
  79. package/dist/vera-renderer-tag.min.js.map +1 -1
  80. package/dist/vera-renderer-until.min.js +2 -0
  81. package/dist/vera-renderer-until.min.js.map +1 -0
  82. package/dist/vera-renderer.min.js +1 -1
  83. package/dist/vera-renderer.min.js.map +1 -1
  84. package/package.json +52 -9
  85. package/dist/development/vera-renderer-hydrate.d.ts +0 -147
  86. package/dist/development/vera-renderer-hydrate.d.ts.map +0 -1
  87. package/dist/development/vera-renderer-hydrate.js +0 -3136
  88. package/dist/development/vera-renderer-hydrate.js.map +0 -1
  89. package/dist/vera-renderer-hydrate.min.js +0 -2
  90. package/dist/vera-renderer-hydrate.min.js.map +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@verajs/renderer",
3
- "version": "0.2.2",
3
+ "version": "0.3.1",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -25,16 +25,26 @@
25
25
  "development": "./dist/development/vera-renderer.js",
26
26
  "default": "./dist/vera-renderer.min.js"
27
27
  },
28
- "./hydrate": {
29
- "types": "./dist/development/vera-renderer-hydrate.d.ts",
30
- "development": "./dist/development/vera-renderer-hydrate.js",
31
- "default": "./dist/vera-renderer-hydrate.min.js"
28
+ "./hydration": {
29
+ "types": "./dist/development/vera-renderer-hydration.d.ts",
30
+ "development": "./dist/development/vera-renderer-hydration.js",
31
+ "default": "./dist/vera-renderer-hydration.min.js"
32
32
  },
33
33
  "./keyed": {
34
34
  "types": "./dist/development/vera-renderer-keyed.d.ts",
35
35
  "development": "./dist/development/vera-renderer-keyed.js",
36
36
  "default": "./dist/vera-renderer-keyed.min.js"
37
37
  },
38
+ "./native-elements": {
39
+ "types": "./dist/development/vera-renderer-native-elements.d.ts",
40
+ "development": "./dist/development/vera-renderer-native-elements.js",
41
+ "default": "./dist/vera-renderer-native-elements.min.js"
42
+ },
43
+ "./multi-window": {
44
+ "types": "./dist/development/vera-renderer-multi-window.d.ts",
45
+ "development": "./dist/development/vera-renderer-multi-window.js",
46
+ "default": "./dist/vera-renderer-multi-window.min.js"
47
+ },
38
48
  "./profiler": {
39
49
  "types": "./dist/development/vera-renderer-profiler.d.ts",
40
50
  "default": "./dist/development/vera-renderer-profiler.js"
@@ -53,6 +63,31 @@
53
63
  "types": "./dist/development/vera-renderer-slots.d.ts",
54
64
  "development": "./dist/development/vera-renderer-slots.js",
55
65
  "default": "./dist/vera-renderer-slots.min.js"
66
+ },
67
+ "./hydrate-slots": {
68
+ "types": "./dist/development/vera-renderer-hydrate-slots.d.ts",
69
+ "development": "./dist/development/vera-renderer-hydrate-slots.js",
70
+ "default": "./dist/vera-renderer-hydrate-slots.min.js"
71
+ },
72
+ "./elements": {
73
+ "types": "./dist/development/vera-renderer-elements.d.ts",
74
+ "development": "./dist/development/vera-renderer-elements.js",
75
+ "default": "./dist/vera-renderer-elements.min.js"
76
+ },
77
+ "./portal": {
78
+ "types": "./dist/development/vera-renderer-portal.d.ts",
79
+ "development": "./dist/development/vera-renderer-portal.js",
80
+ "default": "./dist/vera-renderer-portal.min.js"
81
+ },
82
+ "./until": {
83
+ "types": "./dist/development/vera-renderer-until.d.ts",
84
+ "development": "./dist/development/vera-renderer-until.js",
85
+ "default": "./dist/vera-renderer-until.min.js"
86
+ },
87
+ "./namespaces": {
88
+ "types": "./dist/development/vera-renderer-namespaces.d.ts",
89
+ "development": "./dist/development/vera-renderer-namespaces.js",
90
+ "default": "./dist/vera-renderer-namespaces.min.js"
56
91
  }
57
92
  },
58
93
  "files": [
@@ -77,6 +112,7 @@
77
112
  },
78
113
  "files": [
79
114
  "src/**/*{.js,.ts}",
115
+ "../shared-utils/src/**/*{.js,.ts}",
80
116
  "tsconfig.json",
81
117
  "../../tsconfig.json",
82
118
  "rollup.config.js",
@@ -95,6 +131,7 @@
95
131
  },
96
132
  "files": [
97
133
  "src/**/*{.js,.ts}",
134
+ "../shared-utils/src/**/*{.js,.ts}",
98
135
  "tsconfig.json",
99
136
  "../../tsconfig.json",
100
137
  "rollup.config.js",
@@ -112,6 +149,7 @@
112
149
  },
113
150
  "files": [
114
151
  "src/**/*{.js,.ts}",
152
+ "../shared-utils/src/**/*{.js,.ts}",
115
153
  "tsconfig.json",
116
154
  "../../tsconfig.json",
117
155
  "rollup.config.js",
@@ -132,8 +170,13 @@
132
170
  "web-components",
133
171
  "buildless"
134
172
  ],
135
- "sideEffects": [
136
- "./dist/development/vera-renderer-hydrate.js",
137
- "./dist/vera-renderer-hydrate.min.js"
138
- ]
173
+ "sideEffects": false,
174
+ "peerDependencies": {
175
+ "@verajs/core": "^0.4.0"
176
+ },
177
+ "peerDependenciesMeta": {
178
+ "@verajs/core": {
179
+ "optional": true
180
+ }
181
+ }
139
182
  }
@@ -1,147 +0,0 @@
1
- /**
2
- * The renderer's cross-file and public types — one `types.ts` at the import-graph root, per
3
- * CODE-PRINCIPLES §1.
4
- *
5
- * **What is here and what deliberately is not.** Everything in this file is a pure data shape: it
6
- * names no runtime value, so it can sit upstream of every module in the package and nothing here
7
- * can pull a class into the import graph. The renderer's remaining cross-file types — `Item`,
8
- * `ListStrategy`, `KeyedResult` — name the `Instance` and `ChildPart` CLASSES in their definitions,
9
- * which puts them structurally downstream of `renderer.ts`; they stay beside those classes, and
10
- * §1's "one file at the import-graph root" records that limit rather than pretending otherwise.
11
- * Restating a class's shape here to satisfy the letter of the rule would create exactly the twin
12
- * §1 forbids.
13
- *
14
- * Moving `ProfileReport` and `OverlayOptions` here dissolved a real cycle: `profiler.ts` imported
15
- * `OverlayOptions` from `overlay.ts` while `overlay.ts` imported `ProfileReport` back from
16
- * `profiler.ts`. Type-only, so it was erased and never a runtime cycle — but it is the shape this
17
- * file's position in the graph exists to make impossible.
18
- */
19
- /**
20
- * What a template tag (`html`, `svg`, `mathml`) produces — the compiled shape every renderer entry
21
- * point accepts, and the one type a consumer normally names.
22
- *
23
- * `strings` is the template literal's own `strings` array and is the TEMPLATE'S IDENTITY: the
24
- * engine interns it per call site, so two literals with identical text are two templates and
25
- * rendering one after the other is a teardown, not an update. Anything building these by hand must
26
- * hand back the same array to get an update.
27
- */
28
- type TemplateResult = {
29
- /** 1 = html, 2 = svg, 3 = mathml — the markers core's built-in tags produce. */
30
- _$litType$?: number;
31
- strings: TemplateStringsArray;
32
- values: unknown[];
33
- /** Set by `keyed()`; drives keyed list reconciliation. */
34
- key?: unknown;
35
- };
36
-
37
- /**
38
- * @verajs/renderer — a ground-up, keyed, template-identity renderer.
39
- *
40
- * Replaces the Reef-derived renderer, which flattened every template to an HTML string and
41
- * re-parsed it on each change — O(whole template) work for a one-row edit, measured at 85 ms for a
42
- * two-row swap that lit-html does in 3.5 ms.
43
- *
44
- * The architecture here is the one that wins that benchmark:
45
- *
46
- * 1. A tagged template literal's `strings` array is frozen and IDENTICAL for every call from the
47
- * same call site, so it is a cache key for the template's static shape. The shape is parsed
48
- * ONCE into a `<template>` element with markers where the expressions go.
49
- * 2. Rendering clones that template and binds "parts" to the marker positions. Every later render
50
- * of the same shape only compares and commits the dynamic values — static content is never
51
- * touched again.
52
- * 3. Arrays reconcile KEYED (see `keyed()`), with head/tail fast paths and map-based moves, so a
53
- * reorder moves nodes instead of rebuilding them.
54
- *
55
- * Built in, where lit-html requires directive imports: keyed list reconciliation (`keyed`),
56
- * element refs (element-position expressions), toggled-DOM preservation (`hold`), and a
57
- * whole-range fast clear — one `textContent = ''` where lit removes thousands of nodes one at a
58
- * time. Like-for-like (lit-html + repeat + ref + cache: 5 021 B gzip), this file is ~28% smaller.
59
- *
60
- * What it deliberately does NOT have, which is why it is smaller than lit-html: no directive
61
- * protocol, no `noChange`/`nothing` sentinels (in a single-expression attribute, `null`/`undefined`
62
- * REMOVE the attribute; in a child, they clear it), no sanitizer indirection, no async parts, no
63
- * dev-mode branches.
64
- *
65
- * Known limits, deliberate and shared with lit-html's envelope: no bindings inside comments (the
66
- * value is consumed and ignored), no dynamic tag names, and nested `<template>` elements' contents
67
- * are not traversed.
68
- *
69
- * CONTRACTS THE SPEED PAYS FOR — these are the trade, documented rather than discovered:
70
- *
71
- * - **The renderer owns its container below the mount point.** The whole-range fast clear wipes
72
- * everything in a parent the part fully owns, including nodes user code appended there by hand
73
- * (lit-html would preserve them). Same contract as mounting Vue or React into a container.
74
- * - **Do not call `Node.normalize()` on rendered content.** Child anchors are text nodes, and
75
- * normalize merges adjacent text — lit-html's comment anchors are immune to this; ours are not.
76
- * - **A plain string renders as text, never as HTML.** The Reef renderer parsed strings as markup;
77
- * this one has no innerHTML sink at all (an XSS class removed). The deliberate escape hatch for
78
- * trusted markup is a property binding: `.innerHTML=${trusted}`.
79
- * - **Hydration is automatic and markerless.** The first render into a container that already has
80
- * children adopts them as server output of the same template (statics matched byte-for-byte,
81
- * anchors installed by splitting live text at known value positions), falling back to a clean
82
- * render on any mismatch. Requires the initial client render to match server state — same
83
- * contract as React/Vue hydration.
84
- * - **No directive protocol.** The template language itself is closed to extension — Vera extends
85
- * at the framework layer (inserts) and through element refs, not inside the renderer's value
86
- * handling.
87
- * - Event handlers are invoked with `this` bound to the ELEMENT (lit binds its host).
88
- *
89
- * NAMING NOTE: internal class fields and methods are `_`-prefixed because the production build
90
- * mangles properties matching /^_[a-z]/ (see defaultRollupConfig). That is what lets this file use
91
- * full descriptive names while still shipping one-letter properties — locals and top-level names
92
- * are mangled by default anyway, but property names are not. `_$litType$` and `handleEvent`
93
- * deliberately do not match the pattern: the first is an interop wire format, the second is called
94
- * by the DOM itself.
95
- */
96
-
97
- /**
98
- * Preserves the DOM of templates a child position toggles away from, instead of destroying it —
99
- * form values, scroll positions and media playback survive the round trip (lit-html calls this
100
- * `cache`). Stashed DOM is parked in its instance's own fragment and re-adopted on return.
101
- *
102
- * ```js
103
- * html`<div>${hold(editing ? editor() : viewer())}</div>`
104
- * ```
105
- *
106
- * **Anything that is not a template passes straight through.** There is nothing to park for a
107
- * string, a list, `null` or `false`, and the branch that produces one is the ordinary shape of the
108
- * expression this wraps — `hold(editing && editor())`, `hold(row ?? null)`. Wrapping those handed
109
- * the renderer a `{ $h }` carrying a non-template, which reached the held-commit path and threw on
110
- * `result.strings`: a whole render lost, from a value the same expression renders happily one
111
- * character to the left. Decided here rather than in the renderer so the hot path pays nothing.
112
- */
113
- declare const hold: <T>(result: T) => T | {
114
- $h: TemplateResult;
115
- };
116
-
117
- /**
118
- * The hydrating `render`: a drop-in for the base entry's. The first render into a container that
119
- * already has children adopts them; any mismatch clears (keeping `<style data-vm-sheet="styles">`) and falls
120
- * through to a clean base render. After the first render, this IS the base render.
121
- */
122
- declare const renderInto: (result: unknown, container: Node) => void;
123
- /**
124
- * This entry's `renderer` module, bound to the **hydrating** `renderInto`.
125
- *
126
- * It used to be a bare re-export of the base entry's descriptor, whose `fn` is the base,
127
- * non-adopting render — so the natural `import { renderer } from '@verajs/renderer/hydrate';
128
- * wire([renderer])` wired a renderer that never hydrated. The page still looked right (a first
129
- * render into a full container clears it and renders fresh), which made the failure silent: every
130
- * byte of server work discarded, nothing on screen to say so. The header's promise — point the
131
- * importmap at this bundle "and nothing else changes" — is only true now that the descriptor
132
- * carries this entry's own function. `connect` and the rest are shared deliberately: they operate
133
- * on this bundle's copy of the renderer's module state, which both functions read.
134
- */
135
- declare const renderer: {
136
- fn: never;
137
- name: string;
138
- on: "render";
139
- priority: number;
140
- connect: (given: {
141
- get(name: never): unknown;
142
- }) => void;
143
- };
144
-
145
- export { hold, renderInto, renderer };
146
- export type { TemplateResult };
147
- //# sourceMappingURL=vera-renderer-hydrate.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"vera-renderer-hydrate.d.ts","sources":["../../src/types.ts","../../src/renderer.ts","../../src/hydrate.ts"],"mappings":"AAAA;;;;;;;;;;;;;;;;;AAiBG;;;;;;;;;;;;;;;;;;;ACjBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DG;;;;;;;;;;;;;;;;AAwBA;AACH;AAEI,kBAAgC;sBACvB;AAEb;;;;;;;;;;;;;;;;;;ACtEG;AACH;AAyBA,cAAa;AAGb;AACA;AAEA;;;;AAIG;AACH;;;;","names":[]}