@shadow-js/web 1.1.0 → 1.1.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 (222) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +1 -1
  3. package/dist/dev/attributes.d.ts +1 -2
  4. package/dist/dev/autofocus.d.ts +1 -2
  5. package/dist/dev/class-style.d.ts +1 -2
  6. package/dist/dev/component.d.ts +1 -2
  7. package/dist/dev/control-flow/activity.d.ts +1 -2
  8. package/dist/dev/control-flow/client-only.d.ts +1 -2
  9. package/dist/dev/control-flow/dynamic.d.ts +1 -2
  10. package/dist/dev/control-flow/error-boundary.d.ts +1 -2
  11. package/dist/dev/control-flow/for.d.ts +1 -2
  12. package/dist/dev/control-flow/fragment.d.ts +1 -2
  13. package/dist/dev/control-flow/index-list.d.ts +1 -2
  14. package/dist/dev/control-flow/lazy.d.ts +1 -2
  15. package/dist/dev/control-flow/no-hydration.d.ts +1 -2
  16. package/dist/dev/control-flow/portal.d.ts +1 -2
  17. package/dist/dev/control-flow/portal.js.map +1 -1
  18. package/dist/dev/control-flow/root-errors.d.ts +2 -3
  19. package/dist/dev/control-flow/show.d.ts +1 -2
  20. package/dist/dev/control-flow/suspense-list.d.ts +2 -3
  21. package/dist/dev/control-flow/suspense.d.ts +1 -2
  22. package/dist/dev/control-flow/switch.d.ts +1 -2
  23. package/dist/dev/derived.d.ts +1 -2
  24. package/dist/dev/element.d.ts +1 -2
  25. package/dist/dev/events.d.ts +1 -2
  26. package/dist/dev/extend.d.ts +9 -0
  27. package/dist/dev/head/components.d.ts +1 -2
  28. package/dist/dev/head/server-head.d.ts +2 -3
  29. package/dist/dev/head/use-head.d.ts +1 -2
  30. package/dist/dev/head/validate.d.ts +1 -2
  31. package/dist/dev/hmr.d.ts +1 -2
  32. package/dist/dev/hmr.js.map +1 -1
  33. package/dist/dev/hydration.d.ts +1 -2
  34. package/dist/dev/insert.d.ts +1 -2
  35. package/dist/dev/insert.js.map +1 -1
  36. package/dist/dev/internal/claim.d.ts +1 -2
  37. package/dist/dev/internal/diagnostics.d.ts +1 -2
  38. package/dist/dev/internal/hydration-hooks.d.ts +1 -2
  39. package/dist/dev/internal/hydration-scope.d.ts +1 -2
  40. package/dist/dev/internal/names.d.ts +1 -2
  41. package/dist/dev/internal/portal-context.d.ts +1 -2
  42. package/dist/dev/internal/reconcile.d.ts +1 -2
  43. package/dist/dev/internal/reconcile.js.map +1 -1
  44. package/dist/dev/internal/stream-context.d.ts +1 -2
  45. package/dist/dev/jsx/aria.d.ts +7 -2
  46. package/dist/dev/jsx/component.d.ts +7 -2
  47. package/dist/dev/jsx/events.d.ts +1 -2
  48. package/dist/dev/jsx/global.d.ts +11 -2
  49. package/dist/dev/jsx/html.d.ts +8 -2
  50. package/dist/dev/jsx/intrinsic.d.ts +10 -2
  51. package/dist/dev/jsx/mathml.d.ts +8 -2
  52. package/dist/dev/jsx/svg.d.ts +13 -2
  53. package/dist/dev/jsx/types.d.ts +1 -2
  54. package/dist/dev/jsx-dev-runtime.d.ts +6 -0
  55. package/dist/dev/jsx-runtime.d.ts +13 -2
  56. package/dist/dev/reactive.d.ts +1 -2
  57. package/dist/dev/render.d.ts +1 -2
  58. package/dist/dev/resource-hints.d.ts +1 -2
  59. package/dist/dev/select-value.d.ts +1 -2
  60. package/dist/dev/server/attributes.d.ts +1 -2
  61. package/dist/dev/server/class-style.d.ts +1 -2
  62. package/dist/dev/server/component.d.ts +1 -2
  63. package/dist/dev/server/derived.d.ts +1 -2
  64. package/dist/dev/server/element.d.ts +1 -2
  65. package/dist/dev/server/errors.js.map +1 -1
  66. package/dist/dev/server/escape.d.ts +1 -2
  67. package/dist/dev/server/form-controls.d.ts +1 -2
  68. package/dist/dev/server/hydration-script.d.ts +1 -2
  69. package/dist/dev/server/index.d.ts +7 -2
  70. package/dist/dev/server/index.js +2 -2
  71. package/dist/dev/server/node.d.ts +1 -2
  72. package/dist/dev/server/node.js.map +1 -1
  73. package/dist/dev/server/portals.d.ts +1 -2
  74. package/dist/dev/server/portals.js.map +1 -1
  75. package/dist/dev/server/raw-text.d.ts +1 -2
  76. package/dist/dev/server/render.d.ts +1 -2
  77. package/dist/dev/server/serialize.d.ts +1 -2
  78. package/dist/dev/server/stream.d.ts +1 -2
  79. package/dist/dev/server/stream.js.map +1 -1
  80. package/dist/dev/server.d.ts +1 -0
  81. package/dist/dev/spread.d.ts +1 -2
  82. package/dist/dev/template.d.ts +1 -2
  83. package/dist/dev/view-transition.d.ts +1 -2
  84. package/dist/prod/attributes.js.map +1 -1
  85. package/dist/prod/autofocus.js.map +1 -1
  86. package/dist/prod/class-style.js.map +1 -1
  87. package/dist/prod/component.js.map +1 -1
  88. package/dist/prod/control-flow/activity.js.map +1 -1
  89. package/dist/prod/control-flow/branch.js.map +1 -1
  90. package/dist/prod/control-flow/client-only.js.map +1 -1
  91. package/dist/prod/control-flow/dynamic.js.map +1 -1
  92. package/dist/prod/control-flow/error-boundary.js.map +1 -1
  93. package/dist/prod/control-flow/for.js.map +1 -1
  94. package/dist/prod/control-flow/fragment.js.map +1 -1
  95. package/dist/prod/control-flow/hot-link.js.map +1 -1
  96. package/dist/prod/control-flow/index-list.js.map +1 -1
  97. package/dist/prod/control-flow/lazy.js.map +1 -1
  98. package/dist/prod/control-flow/no-hydration.js.map +1 -1
  99. package/dist/prod/control-flow/portal.js.map +1 -1
  100. package/dist/prod/control-flow/root-errors.js.map +1 -1
  101. package/dist/prod/control-flow/show.js.map +1 -1
  102. package/dist/prod/control-flow/suspense-list.js.map +1 -1
  103. package/dist/prod/control-flow/suspense.js.map +1 -1
  104. package/dist/prod/control-flow/switch.js.map +1 -1
  105. package/dist/prod/derived.js.map +1 -1
  106. package/dist/prod/element.js.map +1 -1
  107. package/dist/prod/events.js.map +1 -1
  108. package/dist/prod/head/components.js.map +1 -1
  109. package/dist/prod/head/registry.js.map +1 -1
  110. package/dist/prod/head/server-head.js.map +1 -1
  111. package/dist/prod/head/sink.js.map +1 -1
  112. package/dist/prod/head/use-head.js.map +1 -1
  113. package/dist/prod/head/validate.js.map +1 -1
  114. package/dist/prod/hmr.js.map +1 -1
  115. package/dist/prod/hydration.js.map +1 -1
  116. package/dist/prod/insert.js.map +1 -1
  117. package/dist/prod/internal/accessor.js.map +1 -1
  118. package/dist/prod/internal/claim.js.map +1 -1
  119. package/dist/prod/internal/css-units.js.map +1 -1
  120. package/dist/prod/internal/diagnostics.js.map +1 -1
  121. package/dist/prod/internal/early-events.js.map +1 -1
  122. package/dist/prod/internal/hydration-hooks.js.map +1 -1
  123. package/dist/prod/internal/hydration-scope.js.map +1 -1
  124. package/dist/prod/internal/portal-context.js.map +1 -1
  125. package/dist/prod/internal/react-names.js.map +1 -1
  126. package/dist/prod/internal/reconcile.js.map +1 -1
  127. package/dist/prod/internal/stream-context.js.map +1 -1
  128. package/dist/prod/reactive.js.map +1 -1
  129. package/dist/prod/render.js.map +1 -1
  130. package/dist/prod/resource-hints.js.map +1 -1
  131. package/dist/prod/select-value.js.map +1 -1
  132. package/dist/prod/server/attributes.js.map +1 -1
  133. package/dist/prod/server/class-style.js.map +1 -1
  134. package/dist/prod/server/component.js.map +1 -1
  135. package/dist/prod/server/derived.js.map +1 -1
  136. package/dist/prod/server/element.js.map +1 -1
  137. package/dist/prod/server/errors.js.map +1 -1
  138. package/dist/prod/server/escape.js.map +1 -1
  139. package/dist/prod/server/form-controls.js.map +1 -1
  140. package/dist/prod/server/hydration-script.js.map +1 -1
  141. package/dist/prod/server/node.js.map +1 -1
  142. package/dist/prod/server/portals.js.map +1 -1
  143. package/dist/prod/server/raw-text.js.map +1 -1
  144. package/dist/prod/server/render.js.map +1 -1
  145. package/dist/prod/server/serialize.js.map +1 -1
  146. package/dist/prod/server/stream.js.map +1 -1
  147. package/dist/prod/spread.js.map +1 -1
  148. package/dist/prod/template.js.map +1 -1
  149. package/dist/prod/view-transition.js.map +1 -1
  150. package/dist/server/attributes.js.map +1 -1
  151. package/dist/server/autofocus.js.map +1 -1
  152. package/dist/server/class-style.js.map +1 -1
  153. package/dist/server/component.js.map +1 -1
  154. package/dist/server/control-flow/activity.js.map +1 -1
  155. package/dist/server/control-flow/branch.js.map +1 -1
  156. package/dist/server/control-flow/client-only.js.map +1 -1
  157. package/dist/server/control-flow/dynamic.js.map +1 -1
  158. package/dist/server/control-flow/error-boundary.js.map +1 -1
  159. package/dist/server/control-flow/for.js.map +1 -1
  160. package/dist/server/control-flow/fragment.js.map +1 -1
  161. package/dist/server/control-flow/index-list.js.map +1 -1
  162. package/dist/server/control-flow/lazy.js.map +1 -1
  163. package/dist/server/control-flow/no-hydration.js.map +1 -1
  164. package/dist/server/control-flow/portal.js.map +1 -1
  165. package/dist/server/control-flow/root-errors.js.map +1 -1
  166. package/dist/server/control-flow/show.js.map +1 -1
  167. package/dist/server/control-flow/suspense-list.js.map +1 -1
  168. package/dist/server/control-flow/suspense.js.map +1 -1
  169. package/dist/server/control-flow/switch.js.map +1 -1
  170. package/dist/server/derived.js.map +1 -1
  171. package/dist/server/element.js.map +1 -1
  172. package/dist/server/events.js.map +1 -1
  173. package/dist/server/head/components.js.map +1 -1
  174. package/dist/server/head/registry.js.map +1 -1
  175. package/dist/server/head/server-head.js.map +1 -1
  176. package/dist/server/head/sink.js.map +1 -1
  177. package/dist/server/head/use-head.js.map +1 -1
  178. package/dist/server/head/validate.js.map +1 -1
  179. package/dist/server/hydration.js.map +1 -1
  180. package/dist/server/insert.js.map +1 -1
  181. package/dist/server/internal/accessor.js.map +1 -1
  182. package/dist/server/internal/claim.js.map +1 -1
  183. package/dist/server/internal/css-units.js.map +1 -1
  184. package/dist/server/internal/diagnostics.js.map +1 -1
  185. package/dist/server/internal/early-events.js.map +1 -1
  186. package/dist/server/internal/hydration-hooks.js.map +1 -1
  187. package/dist/server/internal/hydration-scope.js.map +1 -1
  188. package/dist/server/internal/portal-context.js.map +1 -1
  189. package/dist/server/internal/react-names.js.map +1 -1
  190. package/dist/server/internal/reconcile.js.map +1 -1
  191. package/dist/server/internal/stream-context.js.map +1 -1
  192. package/dist/server/reactive.js.map +1 -1
  193. package/dist/server/render.js.map +1 -1
  194. package/dist/server/resource-hints.js.map +1 -1
  195. package/dist/server/select-value.js.map +1 -1
  196. package/dist/server/server/attributes.js.map +1 -1
  197. package/dist/server/server/class-style.js.map +1 -1
  198. package/dist/server/server/component.js.map +1 -1
  199. package/dist/server/server/derived.js.map +1 -1
  200. package/dist/server/server/element.js.map +1 -1
  201. package/dist/server/server/errors.js.map +1 -1
  202. package/dist/server/server/escape.js.map +1 -1
  203. package/dist/server/server/form-controls.js.map +1 -1
  204. package/dist/server/server/hydration-script.js.map +1 -1
  205. package/dist/server/server/node.js.map +1 -1
  206. package/dist/server/server/portals.js.map +1 -1
  207. package/dist/server/server/raw-text.js.map +1 -1
  208. package/dist/server/server/render.js.map +1 -1
  209. package/dist/server/server/serialize.js.map +1 -1
  210. package/dist/server/server/stream.js.map +1 -1
  211. package/dist/server/spread.js.map +1 -1
  212. package/dist/server/template.js.map +1 -1
  213. package/dist/server/view-transition.js.map +1 -1
  214. package/dist/server-dev/control-flow/portal.js.map +1 -1
  215. package/dist/server-dev/insert.js.map +1 -1
  216. package/dist/server-dev/internal/reconcile.js.map +1 -1
  217. package/dist/server-dev/server/errors.js.map +1 -1
  218. package/dist/server-dev/server/index.js +2 -2
  219. package/dist/server-dev/server/node.js.map +1 -1
  220. package/dist/server-dev/server/portals.js.map +1 -1
  221. package/dist/server-dev/server/stream.js.map +1 -1
  222. package/package.json +6 -6
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.1
4
+
5
+ ### Changed
6
+
7
+ - Released at 1.1.1 with the other packages. No change to this package.
8
+
3
9
  ## 1.1.0
4
10
 
5
11
  ### Changed
package/README.md CHANGED
@@ -175,7 +175,7 @@ type tests are in `packages/web/test-types`.
175
175
  ## Dependencies
176
176
 
177
177
  - Runtime: none.
178
- - Peers: `@shadow-js/core` `^1.1.0`: the reactive primitives the renderer is built on.
178
+ - Peers: `@shadow-js/core` `^1.1.1`: the reactive primitives the renderer is built on.
179
179
 
180
180
  ## Types
181
181
 
@@ -91,5 +91,4 @@ export declare function setAttributeNS(el: Element, namespace: string, name: str
91
91
  * @see setAttribute
92
92
  * @since 1.0.0
93
93
  */
94
- export declare function setBoolAttribute(el: Element, name: string, value: unknown): void;
95
- //# sourceMappingURL=attributes.d.ts.map
94
+ export declare function setBoolAttribute(el: Element, name: string, value: unknown): void;
@@ -26,5 +26,4 @@
26
26
  * }, document.body);
27
27
  * @since 1.0.0
28
28
  */
29
- export declare function autoFocus(el: Element, enabled: unknown): void;
30
- //# sourceMappingURL=autofocus.d.ts.map
29
+ export declare function autoFocus(el: Element, enabled: unknown): void;
@@ -92,5 +92,4 @@ export declare function setStyleProperty(el: HTMLElement | SVGElement, name: str
92
92
  * @see setStyleProperty
93
93
  * @since 1.0.0
94
94
  */
95
- export declare function style(el: HTMLElement | SVGElement, value: unknown, prev?: unknown): unknown;
96
- //# sourceMappingURL=class-style.d.ts.map
95
+ export declare function style(el: HTMLElement | SVGElement, value: unknown, prev?: unknown): unknown;
@@ -17,5 +17,4 @@
17
17
  * const view = createComponent(Counter, { start: 0 }, "Counter");
18
18
  * @since 1.0.0
19
19
  */
20
- export declare function createComponent<P>(component: (props: P) => unknown, props: P, name?: string): unknown;
21
- //# sourceMappingURL=component.d.ts.map
20
+ export declare function createComponent<P>(component: (props: P) => unknown, props: P, name?: string): unknown;
@@ -52,5 +52,4 @@ export interface ActivityProps {
52
52
  * @see Show
53
53
  * @since 1.0.0
54
54
  */
55
- export declare function Activity(props: ActivityProps): Accessor<unknown>;
56
- //# sourceMappingURL=activity.d.ts.map
55
+ export declare function Activity(props: ActivityProps): Accessor<unknown>;
@@ -42,5 +42,4 @@ export interface ClientOnlyProps {
42
42
  * @see Show
43
43
  * @since 1.0.0
44
44
  */
45
- export declare function ClientOnly(props: ClientOnlyProps): Accessor<unknown>;
46
- //# sourceMappingURL=client-only.d.ts.map
45
+ export declare function ClientOnly(props: ClientOnlyProps): Accessor<unknown>;
@@ -85,5 +85,4 @@ export declare function Dynamic<C extends DynamicTarget>(props: DynamicProps<C>)
85
85
  * @see Dynamic
86
86
  * @since 1.0.0
87
87
  */
88
- export declare function createDynamic<C extends DynamicTarget>(component: () => C, props?: object): () => unknown;
89
- //# sourceMappingURL=dynamic.d.ts.map
88
+ export declare function createDynamic<C extends DynamicTarget>(component: () => C, props?: object): () => unknown;
@@ -66,5 +66,4 @@ export interface ErrorBoundaryLooseProps {
66
66
  * @since 1.0.0
67
67
  */
68
68
  export declare function ErrorBoundary(props: ErrorBoundaryProps): Accessor<unknown>;
69
- export declare function ErrorBoundary(props: ErrorBoundaryLooseProps): Accessor<unknown>;
70
- //# sourceMappingURL=error-boundary.d.ts.map
69
+ export declare function ErrorBoundary(props: ErrorBoundaryLooseProps): Accessor<unknown>;
@@ -74,5 +74,4 @@ export type ForProps<T> = ForUnkeyedProps<T> | ForKeyedProps<T>;
74
74
  * @since 1.0.0
75
75
  */
76
76
  export declare function For<T>(props: ForKeyedProps<T>): Accessor<unknown[]>;
77
- export declare function For<T>(props: ForUnkeyedProps<T>): Accessor<unknown[]>;
78
- //# sourceMappingURL=for.d.ts.map
77
+ export declare function For<T>(props: ForUnkeyedProps<T>): Accessor<unknown[]>;
@@ -32,5 +32,4 @@ export interface FragmentProps {
32
32
  * }
33
33
  * @since 1.0.0
34
34
  */
35
- export declare function Fragment(props: FragmentProps): unknown;
36
- //# sourceMappingURL=fragment.d.ts.map
35
+ export declare function Fragment(props: FragmentProps): unknown;
@@ -42,5 +42,4 @@ export interface IndexProps<T> {
42
42
  * @see For
43
43
  * @since 1.0.0
44
44
  */
45
- export declare function Index<T>(props: IndexProps<T>): Accessor<unknown[]>;
46
- //# sourceMappingURL=index-list.d.ts.map
45
+ export declare function Index<T>(props: IndexProps<T>): Accessor<unknown[]>;
@@ -52,5 +52,4 @@ export interface LazyComponent<P> {
52
52
  export declare function lazy<P>(loader: () => Promise<{
53
53
  default: ComponentFunction<P>;
54
54
  }>): LazyComponent<P>;
55
- export {};
56
- //# sourceMappingURL=lazy.d.ts.map
55
+ export {};
@@ -33,5 +33,4 @@ export interface NoHydrationProps {
33
33
  * @see ClientOnly
34
34
  * @since 1.0.0
35
35
  */
36
- export declare function NoHydration(props: NoHydrationProps): Accessor<unknown>;
37
- //# sourceMappingURL=no-hydration.d.ts.map
36
+ export declare function NoHydration(props: NoHydrationProps): Accessor<unknown>;
@@ -63,5 +63,4 @@ export interface PortalProps {
63
63
  * @see Dynamic
64
64
  * @since 1.0.0
65
65
  */
66
- export declare function Portal(props: PortalProps): null;
67
- //# sourceMappingURL=portal.d.ts.map
66
+ export declare function Portal(props: PortalProps): null;
@@ -1 +1 @@
1
- {"version":3,"file":"portal.js","names":[],"sources":["../../../src/control-flow/portal.ts"],"sourcesContent":["import {\n createRoot,\n getOwner,\n isServer,\n onCleanup,\n runWithOwner,\n useContext,\n useRenderEffect,\n} from \"@shadow-js/core\";\nimport {\n bindRegion,\n childScope,\n claims,\n createRegion,\n moveRegion,\n nextKey,\n PortalContext,\n type Region,\n removeRegion,\n withScope,\n} from \"../extend\";\n\n/**\n * Props of {@link Portal}.\n * @since 1.0.0\n */\nexport interface PortalProps {\n /**\n * The element that receives the content, or a function returning it (read reactively). A null\n * target, or a function that returns null or undefined, renders nothing and warns once in\n * development (`PORTAL_TARGET_MISSING`).\n * @default document.body (when the prop is omitted)\n */\n readonly mount?: Element | null | (() => Element | null | undefined);\n /**\n * Put the content in a shadow root of the mount, created once and reused. A portal with a shadow\n * root is not server-rendered; the browser creates it.\n * @default false\n */\n readonly useShadow?: boolean;\n /**\n * Reserved for namespace handling. Nodes are inserted as they were created, so the flag does not\n * change the output yet.\n * @default false\n */\n readonly isSVG?: boolean;\n /**\n * The content: a node, text, an array, or an accessor returning them.\n * @default undefined (nothing is rendered)\n */\n readonly children?: unknown;\n}\n\n/** What the portal holds while content is mounted: where it is, its region, and its effects. */\ninterface Mounted {\n readonly host: Node;\n readonly region: Region;\n /** Stops the content's effects. The nodes stay where they are. */\n readonly stopEffects: () => void;\n}\n\n/**\n * How the content of a mount is built. `claimed`: the server markup is adopted (the templates claim\n * it). `unclaimed`: hydrating, but the server sent nothing for this portal, so it is built fresh.\n */\ntype MountMode = \"plain\" | \"claimed\" | \"unclaimed\";\n\n/** A node that can be moved in place (`Element.prototype.moveBefore`, where implemented). */\ninterface MovableNode extends Node {\n moveBefore(node: Node, child: Node | null): void;\n}\n\n/** Appends `node` to `target`, moving it in place when the target supports `moveBefore`. */\nfunction appendMoved(target: Node, node: Node): void {\n if (typeof (target as Partial<MovableNode>).moveBefore === \"function\") {\n (target as MovableNode).moveBefore(node, null);\n } else {\n target.appendChild(node);\n }\n}\n\n/** The shadow root of an element, attached once when the element has none. */\nfunction shadowRootOf(host: Element): ShadowRoot {\n return host.shadowRoot ?? host.attachShadow({ mode: \"open\" });\n}\n\n/** The mount target of a `mount` prop: the default body, the element, or the function's result. */\nfunction resolveMount(mount: PortalProps[\"mount\"]): Element | null {\n if (mount === undefined) return document.body;\n const value = typeof mount === \"function\" ? mount() : mount;\n return value ?? null;\n}\n\n/**\n * Renders `children` into another part of the document, without a wrapper: the content nodes are\n * inserted directly into the mount element (or its shadow root). Nothing is left at the call site.\n * Disposing the owner removes exactly the nodes the portal inserted; nodes that were already in the\n * mount stay. A reactive `mount` moves the content: the children are built once, and\n * their nodes and effects keep their identity while they move.\n *\n * On the server the content is rendered into the render's `portals` collector (see\n * `createServerPortals`), and the document emits it at the end of `<body>`. When the browser hydrates\n * the portal it adopts that markup instead of creating it again, moving it into the mount if the mount\n * is not `body`. A portal with `useShadow` is not server-rendered; the browser creates it.\n *\n * Events follow the DOM tree. Delegated handlers inside the content fire when the mount is in the\n * document, because the document listener sees the event bubble past the mount. Handlers on\n * elements that wrap the call site do not fire.\n *\n * @param props See {@link PortalProps}.\n * @returns Always null: the portal renders nothing in place.\n * @example\n * import { Portal } from \"@shadow-js/web\";\n *\n * function Modal() {\n * return <div role=\"dialog\">Hello</div>;\n * }\n *\n * function App() {\n * return (\n * <Portal mount={document.getElementById(\"modal-root\")}>\n * <Modal />\n * </Portal>\n * );\n * }\n * @see Dynamic\n * @since 1.0.0\n */\nexport function Portal(props: PortalProps): null {\n // The key of this portal's server block, taken at the call site on the server and in the browser\n // alike. The content renders in a scope of its own (`childScope`), so the keys of the siblings do\n // not depend on whether the content rendered.\n const key = nextKey();\n // A server render provides the portal collector (`renderToString` and friends), so it is recognized\n // by the collector as well as by the build's `isServer` flag: the same server code runs in both.\n const sink = useContext(PortalContext);\n if (isServer || sink !== null) {\n if (props.useShadow !== true) sink?.render?.(key, () => props.children);\n return null;\n }\n // The content is built under the portal's own owner, not under the effect that picks the mount:\n // that effect runs again for each new mount and would dispose what it owns.\n const owner = getOwner();\n let mounted: Mounted | undefined;\n let warned = false;\n // The server block of this portal, taken out of the markers while hydrating; used by the first mount.\n let adopted: Node[] | undefined = claims.current.claimPortal(key);\n\n /** Stops the content's effects, then removes its nodes. Safe to call when nothing is mounted. */\n const unmount = (): void => {\n const current = mounted;\n if (current === undefined) return;\n mounted = undefined;\n current.stopEffects();\n removeRegion(current.region);\n };\n\n /** Creates the content region in `host`, adopting the nodes that are already there. */\n const mountInto = (host: Node, initial: Node[], mode: MountMode): Mounted => {\n const region = createRegion(host, null, initial);\n const stopEffects = runWithOwner(owner, () =>\n createRoot((dispose) => {\n const bind = (): void => {\n bindRegion(region, () => props.children);\n };\n if (mode === \"plain\") bind();\n else if (mode === \"claimed\") withScope(childScope(key), bind);\n else claims.current.withoutClaiming(() => withScope(childScope(key), bind));\n return dispose;\n }),\n );\n return { host, region, stopEffects };\n };\n\n /** Mounts the content in `target` the first time, and moves it there afterward. */\n const moveTo = (target: Node): void => {\n const previous = mounted;\n if (previous === undefined) {\n const initial = adopted ?? [];\n let mode: MountMode = \"plain\";\n if (adopted !== undefined) mode = \"claimed\";\n else if (key !== undefined && claims.current.isClaiming()) mode = \"unclaimed\";\n adopted = undefined;\n for (const node of initial) {\n if (node.parentNode !== target) appendMoved(target, node);\n }\n mounted = mountInto(target, initial, mode);\n return;\n }\n // The children were built once, under an owner that stays: the nodes and their effects move, so\n // an input keeps what was typed and a component is neither disposed nor set up again.\n moveRegion(previous.region, target, (node) => appendMoved(target, node));\n mounted = { host: target, region: previous.region, stopEffects: previous.stopEffects };\n };\n\n useRenderEffect(\n () => {\n const host = resolveMount(props.mount);\n const shadow = props.useShadow === true;\n return { host, shadow };\n },\n ({ host, shadow }) => {\n if (host === null) {\n unmount();\n // The server block was adopted at the call site but has nowhere to live: leaving it would show\n // content the client does not render (stripLeftovers removes the blocks nobody claimed).\n for (const node of adopted ?? []) node.parentNode?.removeChild(node);\n adopted = undefined;\n if (__DEV__ && !warned) {\n warned = true;\n console.warn(\n \"[shadow PORTAL_TARGET_MISSING] Portal has no mount element; nothing is rendered.\",\n );\n }\n return;\n }\n const target: Node = shadow ? shadowRootOf(host) : host;\n if (mounted !== undefined && mounted.host === target) return;\n moveTo(target);\n },\n );\n onCleanup(unmount);\n return null;\n}\n"],"mappings":";;;;;;;AAyEA,SAAS,YAAY,QAAc,MAAkB;CACnD,IAAI,OAAQ,OAAgC,eAAe,YACzD,OAAwB,WAAW,MAAM,IAAI;MAE7C,OAAO,YAAY,IAAI;AAE3B;;AAGA,SAAS,aAAa,MAA2B;CAC/C,OAAO,KAAK,cAAc,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAC9D;;AAGA,SAAS,aAAa,OAA6C;CACjE,IAAI,UAAU,KAAA,GAAW,OAAO,SAAS;CAEzC,QADc,OAAO,UAAU,aAAa,MAAM,IAAI,UACtC;AAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,OAAO,OAA0B;CAI/C,MAAM,MAAM,QAAQ;CAGpB,MAAM,OAAO,WAAW,aAAa;CACrC,IAAI,YAAY,SAAS,MAAM;EAC7B,IAAI,MAAM,cAAc,MAAM,MAAM,SAAS,WAAW,MAAM,QAAQ;EACtE,OAAO;CACT;CAGA,MAAM,QAAQ,SAAS;CACvB,IAAI;CACJ,IAAI,SAAS;CAEb,IAAI,UAA8B,OAAO,QAAQ,YAAY,GAAG;;CAGhE,MAAM,gBAAsB;EAC1B,MAAM,UAAU;EAChB,IAAI,YAAY,KAAA,GAAW;EAC3B,UAAU,KAAA;EACV,QAAQ,YAAY;EACpB,aAAa,QAAQ,MAAM;CAC7B;;CAGA,MAAM,aAAa,MAAY,SAAiB,SAA6B;EAC3E,MAAM,SAAS,aAAa,MAAM,MAAM,OAAO;EAY/C,OAAO;GAAE;GAAM;GAAQ,aAXH,aAAa,aAC/B,YAAY,YAAY;IACtB,MAAM,aAAmB;KACvB,WAAW,cAAc,MAAM,QAAQ;IACzC;IACA,IAAI,SAAS,SAAS,KAAK;SACtB,IAAI,SAAS,WAAW,UAAU,WAAW,GAAG,GAAG,IAAI;SACvD,OAAO,QAAQ,sBAAsB,UAAU,WAAW,GAAG,GAAG,IAAI,CAAC;IAC1E,OAAO;GACT,CAAC,CAE8B;EAAE;CACrC;;CAGA,MAAM,UAAU,WAAuB;EACrC,MAAM,WAAW;EACjB,IAAI,aAAa,KAAA,GAAW;GAC1B,MAAM,UAAU,WAAW,CAAC;GAC5B,IAAI,OAAkB;GACtB,IAAI,YAAY,KAAA,GAAW,OAAO;QAC7B,IAAI,QAAQ,KAAA,KAAa,OAAO,QAAQ,WAAW,GAAG,OAAO;GAClE,UAAU,KAAA;GACV,KAAK,MAAM,QAAQ,SACjB,IAAI,KAAK,eAAe,QAAQ,YAAY,QAAQ,IAAI;GAE1D,UAAU,UAAU,QAAQ,SAAS,IAAI;GACzC;EACF;EAGA,WAAW,SAAS,QAAQ,SAAS,SAAS,YAAY,QAAQ,IAAI,CAAC;EACvE,UAAU;GAAE,MAAM;GAAQ,QAAQ,SAAS;GAAQ,aAAa,SAAS;EAAY;CACvF;CAEA,sBACQ;EAGJ,OAAO;GAAE,MAFI,aAAa,MAAM,KAEpB;GAAG,QADA,MAAM,cAAc;EACb;CACxB,IACC,EAAE,MAAM,aAAa;EACpB,IAAI,SAAS,MAAM;GACjB,QAAQ;GAGR,KAAK,MAAM,QAAQ,WAAW,CAAC,GAAG,KAAK,YAAY,YAAY,IAAI;GACnE,UAAU,KAAA;GACV,IAAe,CAAC,QAAQ;IACtB,SAAS;IACT,QAAQ,KACN,kFACF;GACF;GACA;EACF;EACA,MAAM,SAAe,SAAS,aAAa,IAAI,IAAI;EACnD,IAAI,YAAY,KAAA,KAAa,QAAQ,SAAS,QAAQ;EACtD,OAAO,MAAM;CACf,CACF;CACA,UAAU,OAAO;CACjB,OAAO;AACT"}
1
+ {"version":3,"file":"portal.js","names":[],"sources":["../../../src/control-flow/portal.ts"],"sourcesContent":["import {\n createRoot,\n getOwner,\n isServer,\n onCleanup,\n runWithOwner,\n useContext,\n useRenderEffect,\n} from \"@shadow-js/core\";\nimport {\n bindRegion,\n childScope,\n claims,\n createRegion,\n moveRegion,\n nextKey,\n PortalContext,\n type Region,\n removeRegion,\n withScope,\n} from \"../extend\";\n\n/**\n * Props of {@link Portal}.\n * @since 1.0.0\n */\nexport interface PortalProps {\n /**\n * The element that receives the content, or a function returning it (read reactively). A null\n * target, or a function that returns null or undefined, renders nothing and warns once in\n * development (`PORTAL_TARGET_MISSING`).\n * @default document.body (when the prop is omitted)\n */\n readonly mount?: Element | null | (() => Element | null | undefined);\n /**\n * Put the content in a shadow root of the mount, created once and reused. A portal with a shadow\n * root is not server-rendered; the browser creates it.\n * @default false\n */\n readonly useShadow?: boolean;\n /**\n * Reserved for namespace handling. Nodes are inserted as they were created, so the flag does not\n * change the output yet.\n * @default false\n */\n readonly isSVG?: boolean;\n /**\n * The content: a node, text, an array, or an accessor returning them.\n * @default undefined (nothing is rendered)\n */\n readonly children?: unknown;\n}\n\n/** What the portal holds while content is mounted: where it is, its region, and its effects. */\ninterface Mounted {\n readonly host: Node;\n readonly region: Region;\n /** Stops the content's effects. The nodes stay where they are. */\n readonly stopEffects: () => void;\n}\n\n/**\n * How the content of a mount is built. `claimed`: the server markup is adopted (the templates claim\n * it). `unclaimed`: hydrating, but the server sent nothing for this portal, so it is built fresh.\n */\ntype MountMode = \"plain\" | \"claimed\" | \"unclaimed\";\n\n/** A node that can be moved in place (`Element.prototype.moveBefore`, where implemented). */\ninterface MovableNode extends Node {\n moveBefore(node: Node, child: Node | null): void;\n}\n\n/** Appends `node` to `target`, moving it in place when the target supports `moveBefore`. */\nfunction appendMoved(target: Node, node: Node): void {\n if (typeof (target as Partial<MovableNode>).moveBefore === \"function\") {\n (target as MovableNode).moveBefore(node, null);\n } else {\n target.appendChild(node);\n }\n}\n\n/** The shadow root of an element, attached once when the element has none. */\nfunction shadowRootOf(host: Element): ShadowRoot {\n return host.shadowRoot ?? host.attachShadow({ mode: \"open\" });\n}\n\n/** The mount target of a `mount` prop: the default body, the element, or the function's result. */\nfunction resolveMount(mount: PortalProps[\"mount\"]): Element | null {\n if (mount === undefined) return document.body;\n const value = typeof mount === \"function\" ? mount() : mount;\n return value ?? null;\n}\n\n/**\n * Renders `children` into another part of the document, without a wrapper: the content nodes are\n * inserted directly into the mount element (or its shadow root). Nothing is left at the call site.\n * Disposing the owner removes exactly the nodes the portal inserted; nodes that were already in the\n * mount stay. A reactive `mount` moves the content: the children are built once, and\n * their nodes and effects keep their identity while they move.\n *\n * On the server the content is rendered into the render's `portals` collector (see\n * `createServerPortals`), and the document emits it at the end of `<body>`. When the browser hydrates\n * the portal it adopts that markup instead of creating it again, moving it into the mount if the mount\n * is not `body`. A portal with `useShadow` is not server-rendered; the browser creates it.\n *\n * Events follow the DOM tree. Delegated handlers inside the content fire when the mount is in the\n * document, because the document listener sees the event bubble past the mount. Handlers on\n * elements that wrap the call site do not fire.\n *\n * @param props See {@link PortalProps}.\n * @returns Always null: the portal renders nothing in place.\n * @example\n * import { Portal } from \"@shadow-js/web\";\n *\n * function Modal() {\n * return <div role=\"dialog\">Hello</div>;\n * }\n *\n * function App() {\n * return (\n * <Portal mount={document.getElementById(\"modal-root\")}>\n * <Modal />\n * </Portal>\n * );\n * }\n * @see Dynamic\n * @since 1.0.0\n */\nexport function Portal(props: PortalProps): null {\n // The key of this portal's server block, taken at the call site on the server and in the browser\n // alike. The content renders in a scope of its own (`childScope`), so the keys of the siblings do\n // not depend on whether the content rendered.\n const key = nextKey();\n // A server render provides the portal collector (`renderToString` and friends), so it is recognized\n // by the collector as well as by the build's `isServer` flag: the same server code runs in both.\n const sink = useContext(PortalContext);\n if (isServer || sink !== null) {\n if (props.useShadow !== true) sink?.render?.(key, () => props.children);\n return null;\n }\n // The content is built under the portal's own owner, not under the effect that picks the mount:\n // that effect runs again for each new mount and would dispose what it owns.\n const owner = getOwner();\n let mounted: Mounted | undefined;\n let warned = false;\n // The server block of this portal, taken out of the markers while hydrating; used by the first mount.\n let adopted: Node[] | undefined = claims.current.claimPortal(key);\n\n /** Stops the content's effects, then removes its nodes. Safe to call when nothing is mounted. */\n const unmount = (): void => {\n const current = mounted;\n if (current === undefined) return;\n mounted = undefined;\n current.stopEffects();\n removeRegion(current.region);\n };\n\n /** Creates the content region in `host`, adopting the nodes that are already there. */\n const mountInto = (host: Node, initial: Node[], mode: MountMode): Mounted => {\n const region = createRegion(host, null, initial);\n const stopEffects = runWithOwner(owner, () =>\n createRoot((dispose) => {\n const bind = (): void => {\n bindRegion(region, () => props.children);\n };\n if (mode === \"plain\") bind();\n else if (mode === \"claimed\") withScope(childScope(key), bind);\n else claims.current.withoutClaiming(() => withScope(childScope(key), bind));\n return dispose;\n }),\n );\n return { host, region, stopEffects };\n };\n\n /** Mounts the content in `target` the first time, and moves it there afterward. */\n const moveTo = (target: Node): void => {\n const previous = mounted;\n if (previous === undefined) {\n const initial = adopted ?? [];\n let mode: MountMode = \"plain\";\n if (adopted !== undefined) mode = \"claimed\";\n else if (key !== undefined && claims.current.isClaiming()) mode = \"unclaimed\";\n adopted = undefined;\n for (const node of initial) {\n if (node.parentNode !== target) appendMoved(target, node);\n }\n mounted = mountInto(target, initial, mode);\n return;\n }\n // The children were built once, under an owner that stays: the nodes and their effects move, so\n // an input keeps what was typed and a component is neither disposed nor set up again.\n moveRegion(previous.region, target, (node) => appendMoved(target, node));\n mounted = { host: target, region: previous.region, stopEffects: previous.stopEffects };\n };\n\n useRenderEffect(\n () => {\n const host = resolveMount(props.mount);\n const shadow = props.useShadow === true;\n return { host, shadow };\n },\n ({ host, shadow }) => {\n if (host === null) {\n unmount();\n // The server block was adopted at the call site but has nowhere to live: leaving it would show\n // content the client does not render (stripLeftovers removes the blocks nobody claimed).\n for (const node of adopted ?? []) node.parentNode?.removeChild(node);\n adopted = undefined;\n if (__DEV__ && !warned) {\n warned = true;\n console.warn(\n \"[shadow PORTAL_TARGET_MISSING] Portal has no mount element; nothing is rendered.\",\n );\n }\n return;\n }\n const target: Node = shadow ? shadowRootOf(host) : host;\n if (mounted !== undefined && mounted.host === target) return;\n moveTo(target);\n },\n );\n onCleanup(unmount);\n return null;\n}\n"],"mappings":";;;;;;;AAyEA,SAAS,YAAY,QAAc,MAAkB;CACnD,IAAI,OAAQ,OAAgC,eAAe,YACxD,OAAuB,WAAW,MAAM,IAAI;MAE7C,OAAO,YAAY,IAAI;AAE3B;;AAGA,SAAS,aAAa,MAA2B;CAC/C,OAAO,KAAK,cAAc,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAC9D;;AAGA,SAAS,aAAa,OAA6C;CACjE,IAAI,UAAU,KAAA,GAAW,OAAO,SAAS;CAEzC,QADc,OAAO,UAAU,aAAa,MAAM,IAAI,UACtC;AAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,OAAO,OAA0B;CAI/C,MAAM,MAAM,QAAQ;CAGpB,MAAM,OAAO,WAAW,aAAa;CACrC,IAAI,YAAY,SAAS,MAAM;EAC7B,IAAI,MAAM,cAAc,MAAM,MAAM,SAAS,WAAW,MAAM,QAAQ;EACtE,OAAO;CACT;CAGA,MAAM,QAAQ,SAAS;CACvB,IAAI;CACJ,IAAI,SAAS;CAEb,IAAI,UAA8B,OAAO,QAAQ,YAAY,GAAG;;CAGhE,MAAM,gBAAsB;EAC1B,MAAM,UAAU;EAChB,IAAI,YAAY,KAAA,GAAW;EAC3B,UAAU,KAAA;EACV,QAAQ,YAAY;EACpB,aAAa,QAAQ,MAAM;CAC7B;;CAGA,MAAM,aAAa,MAAY,SAAiB,SAA6B;EAC3E,MAAM,SAAS,aAAa,MAAM,MAAM,OAAO;EAY/C,OAAO;GAAE;GAAM;GAAQ,aAXH,aAAa,aAC/B,YAAY,YAAY;IACtB,MAAM,aAAmB;KACvB,WAAW,cAAc,MAAM,QAAQ;IACzC;IACA,IAAI,SAAS,SAAS,KAAK;SACtB,IAAI,SAAS,WAAW,UAAU,WAAW,GAAG,GAAG,IAAI;SACvD,OAAO,QAAQ,sBAAsB,UAAU,WAAW,GAAG,GAAG,IAAI,CAAC;IAC1E,OAAO;GACT,CAAC,CAE8B;EAAE;CACrC;;CAGA,MAAM,UAAU,WAAuB;EACrC,MAAM,WAAW;EACjB,IAAI,aAAa,KAAA,GAAW;GAC1B,MAAM,UAAU,WAAW,CAAC;GAC5B,IAAI,OAAkB;GACtB,IAAI,YAAY,KAAA,GAAW,OAAO;QAC7B,IAAI,QAAQ,KAAA,KAAa,OAAO,QAAQ,WAAW,GAAG,OAAO;GAClE,UAAU,KAAA;GACV,KAAK,MAAM,QAAQ,SACjB,IAAI,KAAK,eAAe,QAAQ,YAAY,QAAQ,IAAI;GAE1D,UAAU,UAAU,QAAQ,SAAS,IAAI;GACzC;EACF;EAGA,WAAW,SAAS,QAAQ,SAAS,SAAS,YAAY,QAAQ,IAAI,CAAC;EACvE,UAAU;GAAE,MAAM;GAAQ,QAAQ,SAAS;GAAQ,aAAa,SAAS;EAAY;CACvF;CAEA,sBACQ;EAGJ,OAAO;GAAE,MAFI,aAAa,MAAM,KAEpB;GAAG,QADA,MAAM,cAAc;EACb;CACxB,IACC,EAAE,MAAM,aAAa;EACpB,IAAI,SAAS,MAAM;GACjB,QAAQ;GAGR,KAAK,MAAM,QAAQ,WAAW,CAAC,GAAG,KAAK,YAAY,YAAY,IAAI;GACnE,UAAU,KAAA;GACV,IAAe,CAAC,QAAQ;IACtB,SAAS;IACT,QAAQ,KACN,kFACF;GACF;GACA;EACF;EACA,MAAM,SAAe,SAAS,aAAa,IAAI,IAAI;EACnD,IAAI,YAAY,KAAA,KAAa,QAAQ,SAAS,QAAQ;EACtD,OAAO,MAAM;CACf,CACF;CACA,UAAU,OAAO;CACjB,OAAO;AACT"}
@@ -1,4 +1,4 @@
1
- import { Owner } from "@shadow-js/core";
1
+ import "@shadow-js/core";
2
2
  /**
3
3
  * The error reporters a root was rendered or hydrated with (see `RenderOptions` and `HydrateOptions`).
4
4
  * @since 1.0.0
@@ -19,5 +19,4 @@ export interface RootErrorOptions {
19
19
  * @default undefined (no reporter)
20
20
  */
21
21
  readonly onRecoverableError?: (error: unknown) => void;
22
- }
23
- //# sourceMappingURL=root-errors.d.ts.map
22
+ }
@@ -95,5 +95,4 @@ export interface ShowLooseProps<T> extends ShowBaseProps<T> {
95
95
  */
96
96
  export declare function Show<T>(props: ShowProps<T>): Accessor<unknown>;
97
97
  export declare function Show<T>(props: ShowLooseProps<T>): Accessor<unknown>;
98
- export {};
99
- //# sourceMappingURL=show.d.ts.map
98
+ export {};
@@ -1,4 +1,4 @@
1
- import { Accessor, Context } from "@shadow-js/core";
1
+ import { Accessor } from "@shadow-js/core";
2
2
  /**
3
3
  * Props of {@link SuspenseList}.
4
4
  * @since 1.0.0
@@ -59,5 +59,4 @@ export interface SuspenseListProps {
59
59
  * @see Suspense
60
60
  * @since 1.0.0
61
61
  */
62
- export declare function SuspenseList(props: SuspenseListProps): Accessor<unknown>;
63
- //# sourceMappingURL=suspense-list.d.ts.map
62
+ export declare function SuspenseList(props: SuspenseListProps): Accessor<unknown>;
@@ -47,5 +47,4 @@ export interface SuspenseProps {
47
47
  * @see ErrorBoundary
48
48
  * @since 1.0.0
49
49
  */
50
- export declare function Suspense(props: SuspenseProps): Accessor<unknown>;
51
- //# sourceMappingURL=suspense.d.ts.map
50
+ export declare function Suspense(props: SuspenseProps): Accessor<unknown>;
@@ -79,5 +79,4 @@ export interface SwitchProps {
79
79
  * @see Show
80
80
  * @since 1.0.0
81
81
  */
82
- export declare function Switch(props: SwitchProps): Accessor<unknown>;
83
- //# sourceMappingURL=switch.d.ts.map
82
+ export declare function Switch(props: SwitchProps): Accessor<unknown>;
@@ -46,5 +46,4 @@ export interface Derived<T> {
46
46
  * @see Derived
47
47
  * @since 1.0.0
48
48
  */
49
- export declare function derived<T>(compute: () => T): Derived<T>;
50
- //# sourceMappingURL=derived.d.ts.map
49
+ export declare function derived<T>(compute: () => T): Derived<T>;
@@ -34,5 +34,4 @@
34
34
  * @see spread
35
35
  * @since 1.0.0
36
36
  */
37
- export declare function element(tag: string, props: object): unknown;
38
- //# sourceMappingURL=element.d.ts.map
37
+ export declare function element(tag: string, props: object): unknown;
@@ -81,5 +81,4 @@ export declare function clearDelegatedEvents(target?: Document): void;
81
81
  * @see delegateEvents
82
82
  * @since 1.0.0
83
83
  */
84
- export declare function addEventListener(el: Element, name: string, handler: unknown, delegate?: boolean, capture?: boolean): void;
85
- //# sourceMappingURL=events.d.ts.map
84
+ export declare function addEventListener(el: Element, name: string, handler: unknown, delegate?: boolean, capture?: boolean): void;
@@ -1,3 +1,12 @@
1
+ /**
2
+ * The renderer extension API of `@shadow-js/web`: the building blocks `Show`, `For`, `Portal`,
3
+ * `Dynamic`, `Suspense`, head tags and hydration are made from. Use them to write custom
4
+ * components and renderers with the same behavior as the built-ins (zero comment nodes, region
5
+ * adoption during hydration, identity-preserving reconciliation, URL and attribute safety).
6
+ *
7
+ * Import from `@shadow-js/web/extend`.
8
+ * @packageDocumentation
9
+ */
1
10
  import { isUnsafeUrlAttribute } from "./attributes.js";
2
11
  import { element } from "./element.js";
3
12
  import { Region, bindRegion, createRegion, moveRegion, removeRegion } from "./insert.js";
@@ -131,5 +131,4 @@ export declare function Style(props: StyleProps): null;
131
131
  * @see useHead
132
132
  * @since 1.0.0
133
133
  */
134
- export declare function Base(props: HeadAttributeProps): null;
135
- //# sourceMappingURL=components.d.ts.map
134
+ export declare function Base(props: HeadAttributeProps): null;
@@ -1,5 +1,5 @@
1
1
  import { NormalizedTag } from "./validate.js";
2
- import { Context } from "@shadow-js/core";
2
+ import "@shadow-js/core";
3
3
  /**
4
4
  * The head of one server render: what `useHead`, `<Title>`, `<Meta>`, `<Link>`, `<Style>` and
5
5
  * `<Base>` registered while the app rendered. Pass it to a render function through its `head`
@@ -48,5 +48,4 @@ export interface ServerHead {
48
48
  * @see useHead
49
49
  * @since 1.0.0
50
50
  */
51
- export declare function createServerHead(): ServerHead;
52
- //# sourceMappingURL=server-head.d.ts.map
51
+ export declare function createServerHead(): ServerHead;
@@ -29,5 +29,4 @@ import { HeadInput } from "./validate.js";
29
29
  * @see Meta
30
30
  * @since 1.0.0
31
31
  */
32
- export declare function useHead(input: HeadInput | (() => HeadInput)): void;
33
- //# sourceMappingURL=use-head.d.ts.map
32
+ export declare function useHead(input: HeadInput | (() => HeadInput)): void;
@@ -79,5 +79,4 @@ export interface NormalizedTag {
79
79
  * @see useHead
80
80
  * @since 1.0.0
81
81
  */
82
- export declare function normalizeTags(input: unknown): NormalizedTag[];
83
- //# sourceMappingURL=validate.d.ts.map
82
+ export declare function normalizeTags(input: unknown): NormalizedTag[];
package/dist/dev/hmr.d.ts CHANGED
@@ -76,5 +76,4 @@ export declare function component<P>(reg: ModuleRegistry, name: string, implemen
76
76
  * @internal
77
77
  */
78
78
  export declare function accept(hot: HotContext | undefined, reg: ModuleRegistry): void;
79
- export {};
80
- //# sourceMappingURL=hmr.d.ts.map
79
+ export {};
@@ -1 +1 @@
1
- {"version":3,"file":"hmr.js","names":[],"sources":["../../src/hmr.ts"],"sourcesContent":["import { batch, getOwner, untrack, useSignal } from \"@shadow-js/core\";\nimport { createComputation, readComputation } from \"@shadow-js/core/extend\";\nimport { hotModulesOf } from \"./control-flow/hot-link\";\n\n/**\n * The subset of Vite's `import.meta.hot` the runtime uses. The compiled output passes\n * `import.meta.hot` to `registry`, so any object with these three members works (a test runner can\n * supply its own).\n * @since 1.0.0\n */\nexport interface HotContext {\n /** Data kept across hot updates of the module: values stored in a `dispose` callback arrive here. */\n readonly data: Record<string, unknown>;\n /** Declares that the module accepts its own update, so the page is not reloaded. */\n accept(): void;\n /** Registers a callback that runs before the module is replaced and may store values in `data`. */\n dispose(callback: (data: Record<string, unknown>) => void): void;\n}\n\ntype ComponentFunction = (props: never) => unknown;\n\ninterface Entry {\n implementation: ComponentFunction;\n readonly version: () => number;\n readonly bump: () => void;\n readonly proxy: ComponentFunction;\n dirty: boolean;\n}\n\nconst REGISTRY_KEY = \"shadowjs:hmr-registry\";\n\n/**\n * The components of one module, kept across hot updates. Instances are created through a stable\n * proxy that follows the current implementation, so an edit re-renders only the edited component's\n * instances; parents and siblings keep their state. Produced by `registry`; the compiled output\n * of a development build is its only user.\n *\n * @example\n * import { type HotContext, registry } from \"@shadow-js/web/hmr\";\n *\n * declare const hot: HotContext | undefined;\n * const modules = registry(hot, \"src/app.tsx\");\n * console.log(modules.managed); // false when there is no hot context (production, server)\n * @see registry\n * @since 1.0.0\n */\nexport class ModuleRegistry {\n /** The components of the module by name, each with the proxy instances are created through. */\n readonly entries: Map<string, Entry> = new Map<string, Entry>();\n /** True when the module can hot update (a hot context was given); false makes the registry inert. */\n readonly managed: boolean;\n /**\n * Told after each update of this module, once its components are re-rendered. An error boundary\n * that shows its fallback listens here, so the edit that fixes its error rebuilds its children.\n */\n readonly listeners: Set<() => void> = new Set<() => void>();\n\n /**\n * Creates an empty registry.\n *\n * @param managed Whether the module can hot update. When false, `component` returns each\n * implementation unchanged.\n */\n constructor(managed: boolean) {\n this.managed = managed;\n }\n\n /**\n * Re-renders every instance of the components replaced during the last module evaluation, then tells\n * the listeners. The listeners are read before the re-render: a boundary that starts listening because\n * this very update failed is not reset by it.\n */\n commit(): void {\n const listening = [...this.listeners];\n batch(() => {\n for (const entry of this.entries.values()) {\n if (!entry.dirty) continue;\n entry.dirty = false;\n entry.bump();\n }\n });\n for (const listener of listening) listener();\n }\n}\n\n/**\n * Returns the registry of the module identified by `hot`, reusing the one from the previous\n * evaluation of the same module. Without `hot` (production, server) the registry is inert.\n * @internal\n */\nexport function registry(hot: HotContext | undefined, _id: string): ModuleRegistry {\n // A test runner may define `import.meta.hot` without a `data` bag: nothing can hot update there.\n if (hot === undefined || typeof hot.data !== \"object\" || hot.data === null) {\n return new ModuleRegistry(false);\n }\n const previous = hot.data[REGISTRY_KEY];\n if (previous instanceof ModuleRegistry) return previous;\n const created = new ModuleRegistry(true);\n hot.dispose((data) => {\n data[REGISTRY_KEY] = created;\n });\n return created;\n}\n\n/**\n * Registers a component implementation and returns the function to use in its place. On the first\n * evaluation that is a proxy; on later evaluations the same proxy, now backed by the new code.\n * @internal\n */\nexport function component<P>(\n reg: ModuleRegistry,\n name: string,\n implementation: (props: P) => unknown,\n): (props: P) => unknown {\n if (!reg.managed) return implementation;\n const existing = reg.entries.get(name);\n if (existing !== undefined) {\n existing.implementation = implementation as ComponentFunction;\n existing.dirty = true;\n return existing.proxy as (props: P) => unknown;\n }\n const [version, setVersion] = useSignal(0);\n const entry: Entry = {\n implementation: implementation as ComponentFunction,\n version,\n bump: () => {\n setVersion((n) => n + 1);\n },\n proxy: undefined as unknown as ComponentFunction,\n dirty: false,\n };\n const proxy = (props: P): (() => unknown) => {\n // The error boundary above this instance (if any) learns that its children come from this module.\n hotModulesOf(getOwner())?.add(reg);\n // A memo per instance: an update re-renders this component only, not the arrays or regions\n // that merely contain it. It runs component setup, which may write state it owns.\n const node = createComputation({\n kind: \"memo\",\n allowWrites: true,\n fn: () => {\n entry.version();\n return untrack(() => (entry.implementation as (props: P) => unknown)(props));\n },\n });\n return () => readComputation<unknown>(node);\n };\n Object.defineProperty(proxy, \"name\", { value: name });\n (entry as { proxy: ComponentFunction }).proxy = proxy as unknown as ComponentFunction;\n reg.entries.set(name, entry);\n return proxy;\n}\n\n/**\n * Marks the module as able to update itself and applies the replaced components.\n * @internal\n */\nexport function accept(hot: HotContext | undefined, reg: ModuleRegistry): void {\n if (hot === undefined || !reg.managed) return;\n hot.accept();\n reg.commit();\n}\n"],"mappings":";;;;AA6BA,MAAM,eAAe;;;;;;;;;;;;;;;;AAiBrB,IAAa,iBAAb,MAA4B;;CAE1B,0BAAuC,IAAI,IAAmB;;CAE9D;;;;;CAKA,4BAAsC,IAAI,IAAgB;;;;;;;CAQ1D,YAAY,SAAkB;EAC5B,KAAK,UAAU;CACjB;;;;;;CAOA,SAAe;EACb,MAAM,YAAY,CAAC,GAAG,KAAK,SAAS;EACpC,YAAY;GACV,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;IACzC,IAAI,CAAC,MAAM,OAAO;IAClB,MAAM,QAAQ;IACd,MAAM,KAAK;GACb;EACF,CAAC;EACD,KAAK,MAAM,YAAY,WAAW,SAAS;CAC7C;AACF;;;;;;AAOA,SAAgB,SAAS,KAA6B,KAA6B;CAEjF,IAAI,QAAQ,KAAA,KAAa,OAAO,IAAI,SAAS,YAAY,IAAI,SAAS,MACpE,OAAO,IAAI,eAAe,KAAK;CAEjC,MAAM,WAAW,IAAI,KAAK;CAC1B,IAAI,oBAAoB,gBAAgB,OAAO;CAC/C,MAAM,UAAU,IAAI,eAAe,IAAI;CACvC,IAAI,SAAS,SAAS;EACpB,KAAK,gBAAgB;CACvB,CAAC;CACD,OAAO;AACT;;;;;;AAOA,SAAgB,UACd,KACA,MACA,gBACuB;CACvB,IAAI,CAAC,IAAI,SAAS,OAAO;CACzB,MAAM,WAAW,IAAI,QAAQ,IAAI,IAAI;CACrC,IAAI,aAAa,KAAA,GAAW;EAC1B,SAAS,iBAAiB;EAC1B,SAAS,QAAQ;EACjB,OAAO,SAAS;CAClB;CACA,MAAM,CAAC,SAAS,cAAc,UAAU,CAAC;CACzC,MAAM,QAAe;EACH;EAChB;EACA,YAAY;GACV,YAAY,MAAM,IAAI,CAAC;EACzB;EACA,OAAO,KAAA;EACP,OAAO;CACT;CACA,MAAM,SAAS,UAA8B;EAE3C,aAAa,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG;EAGjC,MAAM,OAAO,kBAAkB;GAC7B,MAAM;GACN,aAAa;GACb,UAAU;IACR,MAAM,QAAQ;IACd,OAAO,cAAe,MAAM,eAAyC,KAAK,CAAC;GAC7E;EACF,CAAC;EACD,aAAa,gBAAyB,IAAI;CAC5C;CACA,OAAO,eAAe,OAAO,QAAQ,EAAE,OAAO,KAAK,CAAC;CACpD,MAAwC,QAAQ;CAChD,IAAI,QAAQ,IAAI,MAAM,KAAK;CAC3B,OAAO;AACT;;;;;AAMA,SAAgB,OAAO,KAA6B,KAA2B;CAC7E,IAAI,QAAQ,KAAA,KAAa,CAAC,IAAI,SAAS;CACvC,IAAI,OAAO;CACX,IAAI,OAAO;AACb"}
1
+ {"version":3,"file":"hmr.js","names":[],"sources":["../../src/hmr.ts"],"sourcesContent":["import { batch, getOwner, untrack, useSignal } from \"@shadow-js/core\";\nimport { createComputation, readComputation } from \"@shadow-js/core/extend\";\nimport { hotModulesOf } from \"./control-flow/hot-link\";\n\n/**\n * The subset of Vite's `import.meta.hot` the runtime uses. The compiled output passes\n * `import.meta.hot` to `registry`, so any object with these three members works (a test runner can\n * supply its own).\n * @since 1.0.0\n */\nexport interface HotContext {\n /** Data kept across hot updates of the module: values stored in a `dispose` callback arrive here. */\n readonly data: Record<string, unknown>;\n /** Declares that the module accepts its own update, so the page is not reloaded. */\n accept(): void;\n /** Registers a callback that runs before the module is replaced and may store values in `data`. */\n dispose(callback: (data: Record<string, unknown>) => void): void;\n}\n\ntype ComponentFunction = (props: never) => unknown;\n\ninterface Entry {\n implementation: ComponentFunction;\n readonly version: () => number;\n readonly bump: () => void;\n readonly proxy: ComponentFunction;\n dirty: boolean;\n}\n\nconst REGISTRY_KEY = \"shadowjs:hmr-registry\";\n\n/**\n * The components of one module, kept across hot updates. Instances are created through a stable\n * proxy that follows the current implementation, so an edit re-renders only the edited component's\n * instances; parents and siblings keep their state. Produced by `registry`; the compiled output\n * of a development build is its only user.\n *\n * @example\n * import { type HotContext, registry } from \"@shadow-js/web/hmr\";\n *\n * declare const hot: HotContext | undefined;\n * const modules = registry(hot, \"src/app.tsx\");\n * console.log(modules.managed); // false when there is no hot context (production, server)\n * @see registry\n * @since 1.0.0\n */\nexport class ModuleRegistry {\n /** The components of the module by name, each with the proxy instances are created through. */\n readonly entries: Map<string, Entry> = new Map<string, Entry>();\n /** True when the module can hot update (a hot context was given); false makes the registry inert. */\n readonly managed: boolean;\n /**\n * Told after each update of this module, once its components are re-rendered. An error boundary\n * that shows its fallback listens here, so the edit that fixes its error rebuilds its children.\n */\n readonly listeners: Set<() => void> = new Set<() => void>();\n\n /**\n * Creates an empty registry.\n *\n * @param managed Whether the module can hot update. When false, `component` returns each\n * implementation unchanged.\n */\n constructor(managed: boolean) {\n this.managed = managed;\n }\n\n /**\n * Re-renders every instance of the components replaced during the last module evaluation, then tells\n * the listeners. The listeners are read before the re-render: a boundary that starts listening because\n * this very update failed is not reset by it.\n */\n commit(): void {\n const listening = [...this.listeners];\n batch(() => {\n for (const entry of this.entries.values()) {\n if (!entry.dirty) continue;\n entry.dirty = false;\n entry.bump();\n }\n });\n for (const listener of listening) listener();\n }\n}\n\n/**\n * Returns the registry of the module identified by `hot`, reusing the one from the previous\n * evaluation of the same module. Without `hot` (production, server) the registry is inert.\n * @internal\n */\nexport function registry(hot: HotContext | undefined, _id: string): ModuleRegistry {\n // A test runner may define `import.meta.hot` without a `data` bag: nothing can hot update there.\n if (hot === undefined || typeof hot.data !== \"object\" || hot.data === null) {\n return new ModuleRegistry(false);\n }\n const previous = hot.data[REGISTRY_KEY];\n if (previous instanceof ModuleRegistry) return previous;\n const created = new ModuleRegistry(true);\n hot.dispose((data) => {\n data[REGISTRY_KEY] = created;\n });\n return created;\n}\n\n/**\n * Registers a component implementation and returns the function to use in its place. On the first\n * evaluation that is a proxy; on later evaluations the same proxy, now backed by the new code.\n * @internal\n */\nexport function component<P>(\n reg: ModuleRegistry,\n name: string,\n implementation: (props: P) => unknown,\n): (props: P) => unknown {\n if (!reg.managed) return implementation;\n const existing = reg.entries.get(name);\n if (existing !== undefined) {\n existing.implementation = implementation as ComponentFunction;\n existing.dirty = true;\n return existing.proxy as (props: P) => unknown;\n }\n const [version, setVersion] = useSignal(0);\n const entry: Entry = {\n implementation: implementation as ComponentFunction,\n version,\n bump: () => {\n setVersion((n) => n + 1);\n },\n proxy: undefined as unknown as ComponentFunction,\n dirty: false,\n };\n const proxy = (props: P): (() => unknown) => {\n // The error boundary above this instance (if any) learns that its children come from this module.\n hotModulesOf(getOwner())?.add(reg);\n // A memo per instance: an update re-renders this component only, not the arrays or regions\n // that merely contain it. It runs component setup, which may write state it owns.\n const node = createComputation({\n kind: \"memo\",\n allowWrites: true,\n fn: () => {\n entry.version();\n return untrack(() => (entry.implementation as (props: P) => unknown)(props));\n },\n });\n return () => readComputation<unknown>(node);\n };\n Object.defineProperty(proxy, \"name\", { value: name });\n (entry as { proxy: ComponentFunction }).proxy = proxy as unknown as ComponentFunction;\n reg.entries.set(name, entry);\n return proxy;\n}\n\n/**\n * Marks the module as able to update itself and applies the replaced components.\n * @internal\n */\nexport function accept(hot: HotContext | undefined, reg: ModuleRegistry): void {\n if (hot === undefined || !reg.managed) return;\n hot.accept();\n reg.commit();\n}\n"],"mappings":";;;;AA6BA,MAAM,eAAe;;;;;;;;;;;;;;;;AAiBrB,IAAa,iBAAb,MAA4B;;CAEjB,0BAA8B,IAAI,IAAmB;;CAErD;;;;;CAKA,4BAA6B,IAAI,IAAgB;;;;;;;CAQ1D,YAAY,SAAkB;EAC5B,KAAK,UAAU;CACjB;;;;;;CAOA,SAAe;EACb,MAAM,YAAY,CAAC,GAAG,KAAK,SAAS;EACpC,YAAY;GACV,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;IACzC,IAAI,CAAC,MAAM,OAAO;IAClB,MAAM,QAAQ;IACd,MAAM,KAAK;GACb;EACF,CAAC;EACD,KAAK,MAAM,YAAY,WAAW,SAAS;CAC7C;AACF;;;;;;AAOA,SAAgB,SAAS,KAA6B,KAA6B;CAEjF,IAAI,QAAQ,KAAA,KAAa,OAAO,IAAI,SAAS,YAAY,IAAI,SAAS,MACpE,OAAO,IAAI,eAAe,KAAK;CAEjC,MAAM,WAAW,IAAI,KAAK;CAC1B,IAAI,oBAAoB,gBAAgB,OAAO;CAC/C,MAAM,UAAU,IAAI,eAAe,IAAI;CACvC,IAAI,SAAS,SAAS;EACpB,KAAK,gBAAgB;CACvB,CAAC;CACD,OAAO;AACT;;;;;;AAOA,SAAgB,UACd,KACA,MACA,gBACuB;CACvB,IAAI,CAAC,IAAI,SAAS,OAAO;CACzB,MAAM,WAAW,IAAI,QAAQ,IAAI,IAAI;CACrC,IAAI,aAAa,KAAA,GAAW;EAC1B,SAAS,iBAAiB;EAC1B,SAAS,QAAQ;EACjB,OAAO,SAAS;CAClB;CACA,MAAM,CAAC,SAAS,cAAc,UAAU,CAAC;CACzC,MAAM,QAAe;EACH;EAChB;EACA,YAAY;GACV,YAAY,MAAM,IAAI,CAAC;EACzB;EACA,OAAO,KAAA;EACP,OAAO;CACT;CACA,MAAM,SAAS,UAA8B;EAE3C,aAAa,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG;EAGjC,MAAM,OAAO,kBAAkB;GAC7B,MAAM;GACN,aAAa;GACb,UAAU;IACR,MAAM,QAAQ;IACd,OAAO,cAAe,MAAM,eAAyC,KAAK,CAAC;GAC7E;EACF,CAAC;EACD,aAAa,gBAAyB,IAAI;CAC5C;CACA,OAAO,eAAe,OAAO,QAAQ,EAAE,OAAO,KAAK,CAAC;CACnD,MAAuC,QAAQ;CAChD,IAAI,QAAQ,IAAI,MAAM,KAAK;CAC3B,OAAO;AACT;;;;;AAMA,SAAgB,OAAO,KAA6B,KAA2B;CAC7E,IAAI,QAAQ,KAAA,KAAa,CAAC,IAAI,SAAS;CACvC,IAAI,OAAO;CACX,IAAI,OAAO;AACb"}
@@ -55,5 +55,4 @@ export interface HydrateOptions extends RootErrorOptions {
55
55
  * @see render
56
56
  * @since 1.0.0
57
57
  */
58
- export declare function hydrate(code: () => unknown, container: Element | Document, options?: HydrateOptions): () => void;
59
- //# sourceMappingURL=hydration.d.ts.map
58
+ export declare function hydrate(code: () => unknown, container: Element | Document, options?: HydrateOptions): () => void;
@@ -112,5 +112,4 @@ export declare function anchor(parent: Node, before: Node | null): Text;
112
112
  * @see anchor
113
113
  * @since 1.0.0
114
114
  */
115
- export declare function insert(parent: Node, value: unknown, anchorNode?: Node | null, initial?: unknown): unknown;
116
- //# sourceMappingURL=insert.d.ts.map
115
+ export declare function insert(parent: Node, value: unknown, anchorNode?: Node | null, initial?: unknown): unknown;
@@ -1 +1 @@
1
- {"version":3,"file":"insert.js","names":[],"sources":["../../src/insert.ts"],"sourcesContent":["import { onCleanup, useRenderEffect } from \"@shadow-js/core\";\nimport {\n addCleanup,\n type ComputationNode,\n createComputation,\n currentOwner,\n disposeOwner,\n type Owner,\n readComputation,\n} from \"@shadow-js/core/extend\";\nimport { leaves } from \"./internal/accessor\";\nimport { checkClaimedText } from \"./internal/claim\";\nimport { claims } from \"./internal/hydration-hooks\";\nimport { keepFocus, reconcileNodes } from \"./internal/reconcile\";\n\n/** One piece of a value after flattening: a DOM node, or text to be turned into a Text node. */\ntype Part = Node | string;\n\n/**\n * State of one dynamic child region. `nodes` are the DOM nodes the region owns, in order. When\n * `anchor` is set, content goes before it. Without one, an empty region is placed after `marker`\n * (the node that preceded it), so it keeps its position while it is empty. A marker can be a node\n * another region owns and later replaces, so the region created right behind another one on the same parent\n * gives that one an anchor of its own (see `linkRegion`): the marker of every region is then either static\n * content or an anchor nobody replaces.\n * @internal\n */\nexport interface Region {\n readonly parent: Node;\n anchor: Node | null;\n marker: Node | null;\n /** The owner of the effect that keeps a reactive region up to date; unset until then (and for a static region). */\n owner?: Owner | null;\n nodes: Node[];\n /**\n * Text nodes this region created or adopted; only these may be reused by string updates. Null for none, the node\n * itself for one (the usual region: a single dynamic text), a Set for more, so most regions allocate no Set.\n */\n texts: Text | Set<Text> | null;\n /**\n * Development only: the server nodes a hydration pass handed this region, kept until its first\n * commit compares their text with the value (`checkClaimedText`).\n */\n claimed?: readonly Node[] | undefined;\n}\n\n/** The newest reactive unanchored region of each parent: the one the next such region may have to give an anchor. */\nconst tails = new WeakMap<Node, Region>();\n\n/** The document a node belongs to (a Document is its own document). */\nfunction documentOf(node: Node): Document {\n return node instanceof Document ? node : (node.ownerDocument ?? document);\n}\n\n/** True when the region created or adopted `node`. */\nfunction ownsText(region: Region, node: Node): boolean {\n const texts = region.texts;\n return texts === node || (texts instanceof Set && texts.has(node as Text));\n}\n\n/** Records that the region owns `text`. */\nfunction addText(region: Region, text: Text): void {\n const texts = region.texts;\n if (texts === null) region.texts = text;\n else if (texts instanceof Set) texts.add(text);\n else if (texts !== text) region.texts = new Set([texts, text]);\n}\n\n/** Forgets the Text nodes of the region that are not in `keep`. */\nfunction pruneTexts(region: Region, keep: readonly Node[]): void {\n const texts = region.texts;\n if (texts === null) return;\n if (texts instanceof Set) {\n const kept = new Set<Node>(keep);\n for (const text of texts) {\n if (!kept.has(text)) texts.delete(text);\n }\n } else if (!keep.includes(texts)) region.texts = null;\n}\n\n/**\n * The children a fragment held when it was first inserted. Inserting empties a fragment, and an effect\n * that runs again flattens the same fragment value once more: it must still give those nodes.\n */\nconst fragmentChildren = new WeakMap<DocumentFragment, Node[]>();\n\n/**\n * Flattens a value into parts without recursion. Functions are called (and their results unwrapped)\n * through `call`, which runs inside the render effect that owns the value, so reads are tracked.\n */\nfunction flatten(root: unknown, call?: (fn: () => unknown) => unknown): Part[] {\n const parts: Part[] = [];\n const cycle = __DEV__ ? \"insert(): a value contains itself.\" : \"SHADOW_INSERT_CYCLE\";\n for (const item of leaves(root, cycle, call)) {\n if (item === null || item === undefined || typeof item === \"boolean\") continue;\n if (item instanceof DocumentFragment) {\n const kids = fragmentChildren.get(item) ?? [...item.childNodes];\n fragmentChildren.set(item, kids);\n for (const child of kids) parts.push(child);\n } else parts.push(item instanceof Node ? item : String(item)); // strings, numbers and anything else that is text\n }\n return parts;\n}\n\n/** Text nodes the region currently owns, keyed by their data, for reuse by equal strings. */\nfunction reusablePool(region: Region): Map<string, Text[]> {\n const pool = new Map<string, Text[]>();\n for (const node of region.nodes) {\n if (!(node instanceof Text) || !ownsText(region, node)) continue;\n const list = pool.get(node.data);\n if (list === undefined) pool.set(node.data, [node]);\n else list.push(node);\n }\n return pool;\n}\n\n/** Turns parts into the nodes the region should hold, reusing its own Text nodes where possible. */\nfunction materialize(region: Region, parts: readonly Part[]): Node[] {\n const only = parts.length === 1 ? parts[0] : undefined;\n if (typeof only === \"string\") {\n const current = region.nodes.length === 1 ? region.nodes[0] : undefined;\n if (current instanceof Text && ownsText(region, current)) {\n if (current.data !== only) current.data = only;\n return [current];\n }\n }\n // Sized to the parts: `[]` and `push` would reserve room for sixteen nodes in every dynamic child (a row has two).\n const nodes: Node[] = new Array<Node>(parts.length);\n let count = 0;\n const seen = new Set<Node>();\n let pool: Map<string, Text[]> | undefined;\n for (const part of parts) {\n if (typeof part === \"string\") {\n pool ??= reusablePool(region);\n const reused = pool.get(part)?.pop();\n let text = reused;\n if (text === undefined) {\n text = documentOf(region.parent).createTextNode(part);\n addText(region, text);\n }\n seen.add(text);\n nodes[count] = text;\n count += 1;\n } else if (!seen.has(part)) {\n seen.add(part);\n nodes[count] = part;\n count += 1;\n }\n }\n nodes.length = count;\n return nodes;\n}\n\n/** The node after the region: its anchor, or the node after its last attached child (`last`), or its marker. */\nfunction endOf(region: Region, last: Node | undefined): Node | null {\n if (region.anchor !== null) return region.anchor;\n if (last !== undefined) return last.nextSibling;\n const marker = region.marker;\n if (marker === null) return region.parent.firstChild;\n if (marker.parentNode !== region.parent) return null;\n return marker.nextSibling;\n}\n\n/** Callbacks to run after a region of a parent has committed (see `watchCommits`). */\nconst commitWatchers = new WeakMap<Node, Set<() => void>>();\n\n/**\n * Runs `run` after every commit to a region of `parent`, so code that depends on which nodes the\n * parent holds (a name on the first element of a content region) can follow a change of content.\n * The watch ends with the owner that is current when this is called.\n * @internal\n */\nexport function watchCommits(parent: Node, run: () => void): void {\n const set = commitWatchers.get(parent) ?? new Set<() => void>();\n commitWatchers.set(parent, set.add(run));\n onCleanup(() => {\n set.delete(run);\n });\n}\n\n/**\n * Like {@link watchCommits}, for a watch that lives as long as `parent` does: it is not tied to the owner that is\n * current, so a binding that runs again does not end it. The select's value (see `setSelectValue`) uses it.\n * @internal\n */\nexport function keepWatchingCommits(parent: Node, run: () => void): void {\n commitWatchers.set(parent, (commitWatchers.get(parent) ?? new Set<() => void>()).add(run));\n}\n\n/** Applies a flattened value to a region. */\nfunction commit(region: Region, parts: readonly Part[]): void {\n if (__DEV__ && region.claimed !== undefined) {\n // Only the first commit of a claimed region is compared; later changes are ordinary updates.\n checkClaimedText(region.claimed, parts);\n region.claimed = undefined;\n }\n // Makes the DOM show the new nodes for this region.\n const next = materialize(region, parts);\n const parent = region.parent;\n const attached = region.nodes.filter((node) => node.parentNode === parent);\n const first = attached[0];\n const end = endOf(region, attached.at(-1));\n if (next.length === 0 && first !== undefined) region.marker = first.previousSibling;\n reconcileNodes(parent, attached, next, end);\n region.nodes = next;\n pruneTexts(region, next);\n commitWatchers.get(parent)?.forEach((run) => {\n run();\n });\n // The options of an optgroup are the select's options.\n if (parent.nodeName === \"OPTGROUP\" && parent.parentNode !== null) {\n commitWatchers.get(parent.parentNode)?.forEach((run) => {\n run();\n });\n }\n}\n\n/**\n * Applies a resolved value to a region. A string or number is the common case (a dynamic text): when the region\n * already shows its own Text node only the data is rewritten, and an empty region gets one new Text node, with none of\n * the flattening and reconciling a general value needs.\n */\nfunction commitValue(region: Region, raw: unknown): void {\n if ((typeof raw === \"string\" || typeof raw === \"number\") && !(__DEV__ && region.claimed)) {\n const nodes = region.nodes;\n const text = String(raw);\n if (nodes.length === 1) {\n const current = nodes[0];\n if (\n current instanceof Text &&\n current.parentNode === region.parent &&\n ownsText(region, current)\n ) {\n if (current.data !== text) current.data = text;\n return;\n }\n } else if (nodes.length === 0) {\n const created = documentOf(region.parent).createTextNode(text);\n addText(region, created);\n region.parent.insertBefore(created, endOf(region, undefined));\n region.nodes = [created];\n return;\n }\n }\n commit(region, flatten(raw));\n}\n\n/**\n * Creates the state of a region in `parent`. `anchorNode` (null to append) and `initial` (nodes\n * already in the DOM, from hydration or splitText) are both optional.\n * @internal\n */\nexport function createRegion(parent: Node, anchorNode: Node | null, initial: unknown): Region {\n // The nodes of `initial` (already in the parent) that the region adopts as its current content.\n const nodes: Node[] = [];\n if (initial !== undefined) {\n const seen = new Set<Node>();\n for (const part of flatten(initial)) {\n if (typeof part === \"string\" || seen.has(part) || part.parentNode !== parent) continue;\n seen.add(part);\n nodes.push(part);\n }\n }\n const marker = nodes.length > 0 ? (nodes[0] as Node).previousSibling : parent.lastChild;\n const region: Region = {\n parent,\n anchor: anchorNode,\n marker,\n nodes,\n texts: null,\n };\n for (const node of nodes) if (node instanceof Text) addText(region, node);\n // A region that adopts server nodes during a hydration pass is checked against its first commit.\n if (__DEV__ && initial !== undefined && claims.current.isClaiming()) region.claimed = nodes;\n return region;\n}\n\n/**\n * Called for a region that keeps changing and has no anchor. When the previous such region of the parent is alive\n * and ends exactly where this one starts, that region gets an empty Text node there as its anchor. Its content then\n * always goes before that node, and this region's marker is the node, so no region has a marker that a sibling\n * region can replace: the order of the calls holds however the regions change. A region with static content\n * between it and this one needs nothing, because its marker and its end are the static nodes. (A function of its\n * own, so the cleanup it registers holds nothing but the anchor: a closure made inside `bindRegion` would keep\n * the regions of that call alive as long as the parent's owner.)\n */\nfunction linkRegion(region: Region): void {\n const parent = region.parent;\n const tail = tails.get(parent);\n region.owner = currentOwner();\n tails.set(parent, region);\n const start = region.nodes[0] ?? null;\n if (tail === undefined || tail.owner?.disposed || endOf(tail, tail.nodes.at(-1)) !== start)\n return;\n const text = anchor(parent, start);\n tail.anchor = region.marker = text;\n // The anchor is the tail's alone and goes with it, so a region replaced by another one over and over adds\n // nothing to the parent. The region behind it, if empty, is then placed at the end like any region whose marker\n // is gone.\n if (tail.owner) addCleanup(tail.owner, () => text.remove());\n}\n\n/**\n * True when a function appears anywhere in `root`, at any array depth. Scans without calling\n * anything; `seen` stops it from looping on cyclic arrays (flatten reports those).\n */\nfunction containsFunction(root: unknown): boolean {\n if (typeof root === \"function\") return true;\n if (!Array.isArray(root)) return false;\n const stack: unknown[][] = [root];\n const seen = new Set<unknown[]>([root]);\n while (stack.length > 0) {\n const frame = stack.pop() as unknown[];\n for (const item of frame) {\n if (typeof item === \"function\") return true;\n if (Array.isArray(item) && !seen.has(item)) {\n seen.add(item);\n stack.push(item);\n }\n }\n }\n return false;\n}\n\n/**\n * Keeps a region in sync with `value`. A value that is or contains a function (an accessor, or an\n * array with accessor members) runs inside a render effect, so its reads are tracked. Anything\n * else is inserted once. `ordered` is for `insert()` without an anchor: a region that keeps changing then keeps\n * its place among the other such regions of its parent (see `linkRegion`).\n * @internal\n */\nexport function bindRegion(region: Region, value: unknown, ordered?: boolean): unknown {\n if (!containsFunction(value)) {\n commitValue(region, value);\n return value instanceof DocumentFragment ? [...region.nodes] : value;\n }\n let latest: unknown;\n if (ordered === true) linkRegion(region);\n const accessor = typeof value === \"function\" ? (value as () => unknown) : () => value;\n // Every accessor met while resolving the result is evaluated by a memo of its own, kept between\n // runs. An accessor that builds components (`() => show() ? <Late /> : null`) then runs again\n // only when what it reads changes, not whenever something it returned (the component's own\n // accessor, reading its own data) does.\n // Two stages. The outer effect runs the expression and tracks only what the expression itself\n // reads. When the result holds accessors (a component returned one, or `props.children` did),\n // a nested effect resolves them, so a change inside the result re-renders the result but never\n // re-runs the expression: re-running `() => props.children` would build the child components\n // again, discarding their state.\n useRenderEffect(accessor, (raw) => {\n latest = raw;\n if (containsFunction(raw)) {\n // One memo per accessor function, owned by this effect (the effect that evaluates the region's expression,\n // so a new result drops them all; the effect that resolves the result runs many times and must not own\n // them). The memos of accessors the last run did not meet are disposed, which bounds the cache by what the\n // region currently shows.\n const owner = currentOwner();\n const memos = new Map<() => unknown, ComputationNode>();\n let touched = new Set<() => unknown>();\n const call = (fn: () => unknown): unknown => {\n touched.add(fn);\n let node = memos.get(fn);\n if (node === undefined) {\n // Component setup runs inside these memos, which may write the state it owns.\n node = createComputation({ kind: \"memo\", fn: () => fn(), allowWrites: true, owner });\n memos.set(fn, node);\n }\n return readComputation(node);\n };\n useRenderEffect(\n () => {\n touched = new Set();\n const parts = flatten(raw, call);\n for (const [fn, node] of memos) {\n if (touched.has(fn)) continue;\n memos.delete(fn);\n disposeOwner(node);\n }\n return parts;\n },\n (parts) => {\n commit(region, parts);\n },\n );\n } else {\n commitValue(region, raw);\n }\n });\n return latest;\n}\n\n/**\n * Moves a region to a new parent: its nodes still in the old parent go through `move` (which puts\n * each at the end of `parent`), and later commits reconcile there. The region keeps its effects, so\n * what it shows is not built again. Only for a region without an anchor.\n * @param region The region to move.\n * @param parent The node that receives the region's nodes.\n * @param move Puts one node at the end of `parent` (`appendChild`, or `moveBefore` where it exists).\n * @since 1.0.3\n * @internal\n */\nexport function moveRegion(region: Region, parent: Node, move: (node: Node) => void): void {\n const attached = region.nodes.filter((node) => node.parentNode === region.parent);\n // A move that is not in place (appendChild) blurs a focused input: it gets the focus back.\n keepFocus(region.parent, () => {\n for (const node of attached) move(node);\n });\n // Read-only for everyone else: only a move changes where a region lives.\n (region as { parent: Node }).parent = parent;\n region.marker = attached[0]?.previousSibling ?? parent.lastChild;\n}\n\n/**\n * Removes a region's nodes from its parent. Anchors and nodes that were moved elsewhere are not\n * touched.\n * @internal\n */\nexport function removeRegion(region: Region): void {\n for (const node of region.nodes) {\n if (node.parentNode === region.parent) region.parent.removeChild(node);\n }\n region.nodes = [];\n region.texts = null;\n}\n\n/**\n * Creates a text anchor: an empty Text node placed before `before` (appended when null). Use it as\n * the stable insertion point between two dynamic regions; it is never removed by the runtime.\n *\n * @param parent Node that receives the anchor.\n * @param before Node the anchor goes before, or null to append.\n * @returns The new empty Text node.\n * @example\n * import { anchor, insert } from \"@shadow-js/web\";\n *\n * const list = document.createElement(\"ul\");\n * const slot = anchor(list, null);\n * insert(list, \"first\", slot); // goes before the anchor\n * @see insert\n * @since 1.0.0\n */\nexport function anchor(parent: Node, before: Node | null): Text {\n const text = documentOf(parent).createTextNode(\"\");\n parent.insertBefore(text, before);\n return text;\n}\n\n/**\n * Reactive child insertion: keeps the content of a region in sync with `value`.\n *\n * - A function is an accessor, wrapped in a render effect; it re-runs when its dependencies change.\n * - `null`, `undefined`, booleans render nothing. Strings and numbers become one Text node, reused\n * when the region already holds one. A Node is inserted itself. A DocumentFragment inserts a\n * snapshot of its children. Arrays are flattened, nested arrays included.\n * - Content goes before `anchorNode`, or at the end when it is null or omitted. Regions without an\n * anchor on one parent keep the order of the calls, whatever they show and however often a sibling\n * region replaces its nodes: when a reactive region is created right where the previous one ends, the\n * previous one gets an empty Text node as its anchor there (removed again when that region is disposed).\n * - Arrays are reconciled in place: nodes that remain are never removed and re-added.\n * - `initial` lists nodes already in the DOM (from hydration or splitText) so nothing is recreated.\n * - During `hydrate()`, a region that adopted server text is compared with its first commit: in\n * development, different text warns `HYDRATION_TEXT_MISMATCH` (on the console and in devtools) and\n * the region shows the value computed by the client.\n *\n * @param parent Node that holds the region.\n * @param value The value or an accessor returning it.\n * @param anchorNode Node the content goes before; null or omitted appends.\n * @param initial Nodes already in place for this region. Undefined adopts the server's nodes while\n * hydrating and starts empty otherwise.\n * @returns The value as accepted (a fragment yields the array of its nodes).\n * @throws TypeError (production message `SHADOW_INSERT_CYCLE`) when an array contains itself, and\n * (`SHADOW_INSERT_DEPTH`) when an accessor returns accessors more than 10,000 levels deep. When the\n * value is reactive, the error is raised inside its render effect and goes to the owner's error\n * handler, like any effect error.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { anchor, insert } from \"@shadow-js/web\";\n *\n * const list = document.createElement(\"ul\");\n * const end = anchor(list, null);\n * const [items] = useSignal([\"a\", \"b\"]);\n * insert(list, () => items().map((name) => document.createTextNode(name)), end);\n * @see anchor\n * @since 1.0.0\n */\nexport function insert(\n parent: Node,\n value: unknown,\n anchorNode?: Node | null,\n initial?: unknown,\n): unknown {\n const resolvedAnchor = anchorNode ?? null;\n const adopted =\n initial === undefined ? claims.current.takeRegion(parent, resolvedAnchor) : initial;\n const region = createRegion(parent, resolvedAnchor, adopted);\n return bindRegion(region, value, resolvedAnchor === null);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"insert.js","names":[],"sources":["../../src/insert.ts"],"sourcesContent":["import { onCleanup, useRenderEffect } from \"@shadow-js/core\";\nimport {\n addCleanup,\n type ComputationNode,\n createComputation,\n currentOwner,\n disposeOwner,\n type Owner,\n readComputation,\n} from \"@shadow-js/core/extend\";\nimport { leaves } from \"./internal/accessor\";\nimport { checkClaimedText } from \"./internal/claim\";\nimport { claims } from \"./internal/hydration-hooks\";\nimport { keepFocus, reconcileNodes } from \"./internal/reconcile\";\n\n/** One piece of a value after flattening: a DOM node, or text to be turned into a Text node. */\ntype Part = Node | string;\n\n/**\n * State of one dynamic child region. `nodes` are the DOM nodes the region owns, in order. When\n * `anchor` is set, content goes before it. Without one, an empty region is placed after `marker`\n * (the node that preceded it), so it keeps its position while it is empty. A marker can be a node\n * another region owns and later replaces, so the region created right behind another one on the same parent\n * gives that one an anchor of its own (see `linkRegion`): the marker of every region is then either static\n * content or an anchor nobody replaces.\n * @internal\n */\nexport interface Region {\n readonly parent: Node;\n anchor: Node | null;\n marker: Node | null;\n /** The owner of the effect that keeps a reactive region up to date; unset until then (and for a static region). */\n owner?: Owner | null;\n nodes: Node[];\n /**\n * Text nodes this region created or adopted; only these may be reused by string updates. Null for none, the node\n * itself for one (the usual region: a single dynamic text), a Set for more, so most regions allocate no Set.\n */\n texts: Text | Set<Text> | null;\n /**\n * Development only: the server nodes a hydration pass handed this region, kept until its first\n * commit compares their text with the value (`checkClaimedText`).\n */\n claimed?: readonly Node[] | undefined;\n}\n\n/** The newest reactive unanchored region of each parent: the one the next such region may have to give an anchor. */\nconst tails = new WeakMap<Node, Region>();\n\n/** The document a node belongs to (a Document is its own document). */\nfunction documentOf(node: Node): Document {\n return node instanceof Document ? node : (node.ownerDocument ?? document);\n}\n\n/** True when the region created or adopted `node`. */\nfunction ownsText(region: Region, node: Node): boolean {\n const texts = region.texts;\n return texts === node || (texts instanceof Set && texts.has(node as Text));\n}\n\n/** Records that the region owns `text`. */\nfunction addText(region: Region, text: Text): void {\n const texts = region.texts;\n if (texts === null) region.texts = text;\n else if (texts instanceof Set) texts.add(text);\n else if (texts !== text) region.texts = new Set([texts, text]);\n}\n\n/** Forgets the Text nodes of the region that are not in `keep`. */\nfunction pruneTexts(region: Region, keep: readonly Node[]): void {\n const texts = region.texts;\n if (texts === null) return;\n if (texts instanceof Set) {\n const kept = new Set<Node>(keep);\n for (const text of texts) {\n if (!kept.has(text)) texts.delete(text);\n }\n } else if (!keep.includes(texts)) region.texts = null;\n}\n\n/**\n * The children a fragment held when it was first inserted. Inserting empties a fragment, and an effect\n * that runs again flattens the same fragment value once more: it must still give those nodes.\n */\nconst fragmentChildren = new WeakMap<DocumentFragment, Node[]>();\n\n/**\n * Flattens a value into parts without recursion. Functions are called (and their results unwrapped)\n * through `call`, which runs inside the render effect that owns the value, so reads are tracked.\n */\nfunction flatten(root: unknown, call?: (fn: () => unknown) => unknown): Part[] {\n const parts: Part[] = [];\n const cycle = __DEV__ ? \"insert(): a value contains itself.\" : \"SHADOW_INSERT_CYCLE\";\n for (const item of leaves(root, cycle, call)) {\n if (item === null || item === undefined || typeof item === \"boolean\") continue;\n if (item instanceof DocumentFragment) {\n const kids = fragmentChildren.get(item) ?? [...item.childNodes];\n fragmentChildren.set(item, kids);\n for (const child of kids) parts.push(child);\n } else parts.push(item instanceof Node ? item : String(item)); // strings, numbers and anything else that is text\n }\n return parts;\n}\n\n/** Text nodes the region currently owns, keyed by their data, for reuse by equal strings. */\nfunction reusablePool(region: Region): Map<string, Text[]> {\n const pool = new Map<string, Text[]>();\n for (const node of region.nodes) {\n if (!(node instanceof Text) || !ownsText(region, node)) continue;\n const list = pool.get(node.data);\n if (list === undefined) pool.set(node.data, [node]);\n else list.push(node);\n }\n return pool;\n}\n\n/** Turns parts into the nodes the region should hold, reusing its own Text nodes where possible. */\nfunction materialize(region: Region, parts: readonly Part[]): Node[] {\n const only = parts.length === 1 ? parts[0] : undefined;\n if (typeof only === \"string\") {\n const current = region.nodes.length === 1 ? region.nodes[0] : undefined;\n if (current instanceof Text && ownsText(region, current)) {\n if (current.data !== only) current.data = only;\n return [current];\n }\n }\n // Sized to the parts: `[]` and `push` would reserve room for sixteen nodes in every dynamic child (a row has two).\n const nodes: Node[] = new Array<Node>(parts.length);\n let count = 0;\n const seen = new Set<Node>();\n let pool: Map<string, Text[]> | undefined;\n for (const part of parts) {\n if (typeof part === \"string\") {\n pool ??= reusablePool(region);\n const reused = pool.get(part)?.pop();\n let text = reused;\n if (text === undefined) {\n text = documentOf(region.parent).createTextNode(part);\n addText(region, text);\n }\n seen.add(text);\n nodes[count] = text;\n count += 1;\n } else if (!seen.has(part)) {\n seen.add(part);\n nodes[count] = part;\n count += 1;\n }\n }\n nodes.length = count;\n return nodes;\n}\n\n/** The node after the region: its anchor, or the node after its last attached child (`last`), or its marker. */\nfunction endOf(region: Region, last: Node | undefined): Node | null {\n if (region.anchor !== null) return region.anchor;\n if (last !== undefined) return last.nextSibling;\n const marker = region.marker;\n if (marker === null) return region.parent.firstChild;\n if (marker.parentNode !== region.parent) return null;\n return marker.nextSibling;\n}\n\n/** Callbacks to run after a region of a parent has committed (see `watchCommits`). */\nconst commitWatchers = new WeakMap<Node, Set<() => void>>();\n\n/**\n * Runs `run` after every commit to a region of `parent`, so code that depends on which nodes the\n * parent holds (a name on the first element of a content region) can follow a change of content.\n * The watch ends with the owner that is current when this is called.\n * @internal\n */\nexport function watchCommits(parent: Node, run: () => void): void {\n const set = commitWatchers.get(parent) ?? new Set<() => void>();\n commitWatchers.set(parent, set.add(run));\n onCleanup(() => {\n set.delete(run);\n });\n}\n\n/**\n * Like {@link watchCommits}, for a watch that lives as long as `parent` does: it is not tied to the owner that is\n * current, so a binding that runs again does not end it. The select's value (see `setSelectValue`) uses it.\n * @internal\n */\nexport function keepWatchingCommits(parent: Node, run: () => void): void {\n commitWatchers.set(parent, (commitWatchers.get(parent) ?? new Set<() => void>()).add(run));\n}\n\n/** Applies a flattened value to a region. */\nfunction commit(region: Region, parts: readonly Part[]): void {\n if (__DEV__ && region.claimed !== undefined) {\n // Only the first commit of a claimed region is compared; later changes are ordinary updates.\n checkClaimedText(region.claimed, parts);\n region.claimed = undefined;\n }\n // Makes the DOM show the new nodes for this region.\n const next = materialize(region, parts);\n const parent = region.parent;\n const attached = region.nodes.filter((node) => node.parentNode === parent);\n const first = attached[0];\n const end = endOf(region, attached.at(-1));\n if (next.length === 0 && first !== undefined) region.marker = first.previousSibling;\n reconcileNodes(parent, attached, next, end);\n region.nodes = next;\n pruneTexts(region, next);\n commitWatchers.get(parent)?.forEach((run) => {\n run();\n });\n // The options of an optgroup are the select's options.\n if (parent.nodeName === \"OPTGROUP\" && parent.parentNode !== null) {\n commitWatchers.get(parent.parentNode)?.forEach((run) => {\n run();\n });\n }\n}\n\n/**\n * Applies a resolved value to a region. A string or number is the common case (a dynamic text): when the region\n * already shows its own Text node only the data is rewritten, and an empty region gets one new Text node, with none of\n * the flattening and reconciling a general value needs.\n */\nfunction commitValue(region: Region, raw: unknown): void {\n if ((typeof raw === \"string\" || typeof raw === \"number\") && !(__DEV__ && region.claimed)) {\n const nodes = region.nodes;\n const text = String(raw);\n if (nodes.length === 1) {\n const current = nodes[0];\n if (\n current instanceof Text &&\n current.parentNode === region.parent &&\n ownsText(region, current)\n ) {\n if (current.data !== text) current.data = text;\n return;\n }\n } else if (nodes.length === 0) {\n const created = documentOf(region.parent).createTextNode(text);\n addText(region, created);\n region.parent.insertBefore(created, endOf(region, undefined));\n region.nodes = [created];\n return;\n }\n }\n commit(region, flatten(raw));\n}\n\n/**\n * Creates the state of a region in `parent`. `anchorNode` (null to append) and `initial` (nodes\n * already in the DOM, from hydration or splitText) are both optional.\n * @internal\n */\nexport function createRegion(parent: Node, anchorNode: Node | null, initial: unknown): Region {\n // The nodes of `initial` (already in the parent) that the region adopts as its current content.\n const nodes: Node[] = [];\n if (initial !== undefined) {\n const seen = new Set<Node>();\n for (const part of flatten(initial)) {\n if (typeof part === \"string\" || seen.has(part) || part.parentNode !== parent) continue;\n seen.add(part);\n nodes.push(part);\n }\n }\n const marker = nodes.length > 0 ? (nodes[0] as Node).previousSibling : parent.lastChild;\n const region: Region = {\n parent,\n anchor: anchorNode,\n marker,\n nodes,\n texts: null,\n };\n for (const node of nodes) if (node instanceof Text) addText(region, node);\n // A region that adopts server nodes during a hydration pass is checked against its first commit.\n if (__DEV__ && initial !== undefined && claims.current.isClaiming()) region.claimed = nodes;\n return region;\n}\n\n/**\n * Called for a region that keeps changing and has no anchor. When the previous such region of the parent is alive\n * and ends exactly where this one starts, that region gets an empty Text node there as its anchor. Its content then\n * always goes before that node, and this region's marker is the node, so no region has a marker that a sibling\n * region can replace: the order of the calls holds however the regions change. A region with static content\n * between it and this one needs nothing, because its marker and its end are the static nodes. (A function of its\n * own, so the cleanup it registers holds nothing but the anchor: a closure made inside `bindRegion` would keep\n * the regions of that call alive as long as the parent's owner.)\n */\nfunction linkRegion(region: Region): void {\n const parent = region.parent;\n const tail = tails.get(parent);\n region.owner = currentOwner();\n tails.set(parent, region);\n const start = region.nodes[0] ?? null;\n if (tail === undefined || tail.owner?.disposed || endOf(tail, tail.nodes.at(-1)) !== start)\n return;\n const text = anchor(parent, start);\n tail.anchor = region.marker = text;\n // The anchor is the tail's alone and goes with it, so a region replaced by another one over and over adds\n // nothing to the parent. The region behind it, if empty, is then placed at the end like any region whose marker\n // is gone.\n if (tail.owner) addCleanup(tail.owner, () => text.remove());\n}\n\n/**\n * True when a function appears anywhere in `root`, at any array depth. Scans without calling\n * anything; `seen` stops it from looping on cyclic arrays (flatten reports those).\n */\nfunction containsFunction(root: unknown): boolean {\n if (typeof root === \"function\") return true;\n if (!Array.isArray(root)) return false;\n const stack: unknown[][] = [root];\n const seen = new Set<unknown[]>([root]);\n while (stack.length > 0) {\n const frame = stack.pop() as unknown[];\n for (const item of frame) {\n if (typeof item === \"function\") return true;\n if (Array.isArray(item) && !seen.has(item)) {\n seen.add(item);\n stack.push(item);\n }\n }\n }\n return false;\n}\n\n/**\n * Keeps a region in sync with `value`. A value that is or contains a function (an accessor, or an\n * array with accessor members) runs inside a render effect, so its reads are tracked. Anything\n * else is inserted once. `ordered` is for `insert()` without an anchor: a region that keeps changing then keeps\n * its place among the other such regions of its parent (see `linkRegion`).\n * @internal\n */\nexport function bindRegion(region: Region, value: unknown, ordered?: boolean): unknown {\n if (!containsFunction(value)) {\n commitValue(region, value);\n return value instanceof DocumentFragment ? [...region.nodes] : value;\n }\n let latest: unknown;\n if (ordered === true) linkRegion(region);\n const accessor = typeof value === \"function\" ? (value as () => unknown) : () => value;\n // Every accessor met while resolving the result is evaluated by a memo of its own, kept between\n // runs. An accessor that builds components (`() => show() ? <Late /> : null`) then runs again\n // only when what it reads changes, not whenever something it returned (the component's own\n // accessor, reading its own data) does.\n // Two stages. The outer effect runs the expression and tracks only what the expression itself\n // reads. When the result holds accessors (a component returned one, or `props.children` did),\n // a nested effect resolves them, so a change inside the result re-renders the result but never\n // re-runs the expression: re-running `() => props.children` would build the child components\n // again, discarding their state.\n useRenderEffect(accessor, (raw) => {\n latest = raw;\n if (containsFunction(raw)) {\n // One memo per accessor function, owned by this effect (the effect that evaluates the region's expression,\n // so a new result drops them all; the effect that resolves the result runs many times and must not own\n // them). The memos of accessors the last run did not meet are disposed, which bounds the cache by what the\n // region currently shows.\n const owner = currentOwner();\n const memos = new Map<() => unknown, ComputationNode>();\n let touched = new Set<() => unknown>();\n const call = (fn: () => unknown): unknown => {\n touched.add(fn);\n let node = memos.get(fn);\n if (node === undefined) {\n // Component setup runs inside these memos, which may write the state it owns.\n node = createComputation({ kind: \"memo\", fn: () => fn(), allowWrites: true, owner });\n memos.set(fn, node);\n }\n return readComputation(node);\n };\n useRenderEffect(\n () => {\n touched = new Set();\n const parts = flatten(raw, call);\n for (const [fn, node] of memos) {\n if (touched.has(fn)) continue;\n memos.delete(fn);\n disposeOwner(node);\n }\n return parts;\n },\n (parts) => {\n commit(region, parts);\n },\n );\n } else {\n commitValue(region, raw);\n }\n });\n return latest;\n}\n\n/**\n * Moves a region to a new parent: its nodes still in the old parent go through `move` (which puts\n * each at the end of `parent`), and later commits reconcile there. The region keeps its effects, so\n * what it shows is not built again. Only for a region without an anchor.\n * @param region The region to move.\n * @param parent The node that receives the region's nodes.\n * @param move Puts one node at the end of `parent` (`appendChild`, or `moveBefore` where it exists).\n * @since 1.0.3\n * @internal\n */\nexport function moveRegion(region: Region, parent: Node, move: (node: Node) => void): void {\n const attached = region.nodes.filter((node) => node.parentNode === region.parent);\n // A move that is not in place (appendChild) blurs a focused input: it gets the focus back.\n keepFocus(region.parent, () => {\n for (const node of attached) move(node);\n });\n // Read-only for everyone else: only a move changes where a region lives.\n (region as { parent: Node }).parent = parent;\n region.marker = attached[0]?.previousSibling ?? parent.lastChild;\n}\n\n/**\n * Removes a region's nodes from its parent. Anchors and nodes that were moved elsewhere are not\n * touched.\n * @internal\n */\nexport function removeRegion(region: Region): void {\n for (const node of region.nodes) {\n if (node.parentNode === region.parent) region.parent.removeChild(node);\n }\n region.nodes = [];\n region.texts = null;\n}\n\n/**\n * Creates a text anchor: an empty Text node placed before `before` (appended when null). Use it as\n * the stable insertion point between two dynamic regions; it is never removed by the runtime.\n *\n * @param parent Node that receives the anchor.\n * @param before Node the anchor goes before, or null to append.\n * @returns The new empty Text node.\n * @example\n * import { anchor, insert } from \"@shadow-js/web\";\n *\n * const list = document.createElement(\"ul\");\n * const slot = anchor(list, null);\n * insert(list, \"first\", slot); // goes before the anchor\n * @see insert\n * @since 1.0.0\n */\nexport function anchor(parent: Node, before: Node | null): Text {\n const text = documentOf(parent).createTextNode(\"\");\n parent.insertBefore(text, before);\n return text;\n}\n\n/**\n * Reactive child insertion: keeps the content of a region in sync with `value`.\n *\n * - A function is an accessor, wrapped in a render effect; it re-runs when its dependencies change.\n * - `null`, `undefined`, booleans render nothing. Strings and numbers become one Text node, reused\n * when the region already holds one. A Node is inserted itself. A DocumentFragment inserts a\n * snapshot of its children. Arrays are flattened, nested arrays included.\n * - Content goes before `anchorNode`, or at the end when it is null or omitted. Regions without an\n * anchor on one parent keep the order of the calls, whatever they show and however often a sibling\n * region replaces its nodes: when a reactive region is created right where the previous one ends, the\n * previous one gets an empty Text node as its anchor there (removed again when that region is disposed).\n * - Arrays are reconciled in place: nodes that remain are never removed and re-added.\n * - `initial` lists nodes already in the DOM (from hydration or splitText) so nothing is recreated.\n * - During `hydrate()`, a region that adopted server text is compared with its first commit: in\n * development, different text warns `HYDRATION_TEXT_MISMATCH` (on the console and in devtools) and\n * the region shows the value computed by the client.\n *\n * @param parent Node that holds the region.\n * @param value The value or an accessor returning it.\n * @param anchorNode Node the content goes before; null or omitted appends.\n * @param initial Nodes already in place for this region. Undefined adopts the server's nodes while\n * hydrating and starts empty otherwise.\n * @returns The value as accepted (a fragment yields the array of its nodes).\n * @throws TypeError (production message `SHADOW_INSERT_CYCLE`) when an array contains itself, and\n * (`SHADOW_INSERT_DEPTH`) when an accessor returns accessors more than 10,000 levels deep. When the\n * value is reactive, the error is raised inside its render effect and goes to the owner's error\n * handler, like any effect error.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { anchor, insert } from \"@shadow-js/web\";\n *\n * const list = document.createElement(\"ul\");\n * const end = anchor(list, null);\n * const [items] = useSignal([\"a\", \"b\"]);\n * insert(list, () => items().map((name) => document.createTextNode(name)), end);\n * @see anchor\n * @since 1.0.0\n */\nexport function insert(\n parent: Node,\n value: unknown,\n anchorNode?: Node | null,\n initial?: unknown,\n): unknown {\n const resolvedAnchor = anchorNode ?? null;\n const adopted =\n initial === undefined ? claims.current.takeRegion(parent, resolvedAnchor) : initial;\n const region = createRegion(parent, resolvedAnchor, adopted);\n return bindRegion(region, value, resolvedAnchor === null);\n}\n"],"mappings":"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"}
@@ -101,5 +101,4 @@ export declare function withoutClaiming<T>(fn: () => T): T;
101
101
  * }
102
102
  * @since 1.0.0
103
103
  */
104
- export declare function claimPortal(key: string | undefined): Node[] | undefined;
105
- //# sourceMappingURL=claim.d.ts.map
104
+ export declare function claimPortal(key: string | undefined): Node[] | undefined;
@@ -28,5 +28,4 @@ export type WebWarningCode = "UNSAFE_URL_BLOCKED" | "INVALID_ATTRIBUTE_NAME" | "
28
28
  * }
29
29
  * @since 1.0.0
30
30
  */
31
- export declare function warnOnce(code: WebWarningCode, detail: string, key?: string): void;
32
- //# sourceMappingURL=diagnostics.d.ts.map
31
+ export declare function warnOnce(code: WebWarningCode, detail: string, key?: string): void;
@@ -37,5 +37,4 @@ export interface Claims {
37
37
  */
38
38
  export declare const claims: {
39
39
  current: Claims;
40
- };
41
- //# sourceMappingURL=hydration-hooks.d.ts.map
40
+ };
@@ -125,5 +125,4 @@ export declare function resourceKey(explicit: string | undefined): string;
125
125
  * @see withScope
126
126
  * @since 1.0.0
127
127
  */
128
- export declare function childScope(key: string | undefined): HydrationScope | null;
129
- //# sourceMappingURL=hydration-scope.d.ts.map
128
+ export declare function childScope(key: string | undefined): HydrationScope | null;
@@ -27,5 +27,4 @@ export declare const SVG_NS = "http://www.w3.org/2000/svg";
27
27
  * const fraction = document.createElementNS(MATHML_NS, "mfrac");
28
28
  * @since 1.0.0
29
29
  */
30
- export declare const MATHML_NS = "http://www.w3.org/1998/Math/MathML";
31
- //# sourceMappingURL=names.d.ts.map
30
+ export declare const MATHML_NS = "http://www.w3.org/1998/Math/MathML";
@@ -42,5 +42,4 @@ export interface PortalSink {
42
42
  * @see claimPortal
43
43
  * @since 1.0.0
44
44
  */
45
- export declare const PortalContext: Context<PortalSink | null>;
46
- //# sourceMappingURL=portal-context.d.ts.map
45
+ export declare const PortalContext: Context<PortalSink | null>;
@@ -35,5 +35,4 @@
35
35
  * reconcileNodes(list, [a, b, c], [c, a], null); // removes b, moves c before a
36
36
  * @since 1.0.0
37
37
  */
38
- export declare function reconcileNodes(parent: Node, prev: readonly Node[], next: readonly Node[], end: Node | null): void;
39
- //# sourceMappingURL=reconcile.d.ts.map
38
+ export declare function reconcileNodes(parent: Node, prev: readonly Node[], next: readonly Node[], end: Node | null): void;