@shadow-js/web 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +29 -0
- package/dist/dev/attributes.d.ts +10 -5
- package/dist/dev/attributes.js +28 -51
- package/dist/dev/attributes.js.map +1 -1
- package/dist/dev/autofocus.d.ts +0 -2
- package/dist/dev/autofocus.js +1 -2
- package/dist/dev/class-style.d.ts +6 -4
- package/dist/dev/class-style.js +25 -9
- package/dist/dev/class-style.js.map +1 -1
- package/dist/dev/component.d.ts +0 -2
- package/dist/dev/component.js +1 -2
- package/dist/dev/control-flow/activity.d.ts +0 -2
- package/dist/dev/control-flow/activity.js +1 -2
- package/dist/dev/control-flow/branch.js +0 -1
- package/dist/dev/control-flow/client-only.d.ts +0 -2
- package/dist/dev/control-flow/client-only.js +1 -2
- package/dist/dev/control-flow/dynamic.d.ts +11 -4
- package/dist/dev/control-flow/dynamic.js +57 -41
- package/dist/dev/control-flow/dynamic.js.map +1 -1
- package/dist/dev/control-flow/error-boundary.d.ts +0 -2
- package/dist/dev/control-flow/error-boundary.js +1 -2
- package/dist/dev/control-flow/for.d.ts +0 -2
- package/dist/dev/control-flow/for.js +1 -2
- package/dist/dev/control-flow/fragment.d.ts +0 -2
- package/dist/dev/control-flow/fragment.js +1 -2
- package/dist/dev/control-flow/hot-link.js +1 -2
- package/dist/dev/control-flow/index-list.d.ts +0 -2
- package/dist/dev/control-flow/index-list.js +1 -2
- package/dist/dev/control-flow/lazy.d.ts +0 -2
- package/dist/dev/control-flow/lazy.js +1 -2
- package/dist/dev/control-flow/no-hydration.d.ts +0 -2
- package/dist/dev/control-flow/no-hydration.js +1 -2
- package/dist/dev/control-flow/portal.d.ts +0 -2
- package/dist/dev/control-flow/portal.js +3 -2
- package/dist/dev/control-flow/portal.js.map +1 -1
- package/dist/dev/control-flow/root-errors.d.ts +0 -2
- package/dist/dev/control-flow/root-errors.js +1 -2
- package/dist/dev/control-flow/show.d.ts +0 -2
- package/dist/dev/control-flow/show.js +1 -2
- package/dist/dev/control-flow/suspense-list.d.ts +0 -2
- package/dist/dev/control-flow/suspense-list.js +1 -2
- package/dist/dev/control-flow/suspense.d.ts +0 -2
- package/dist/dev/control-flow/suspense.js +1 -2
- package/dist/dev/control-flow/switch.d.ts +0 -2
- package/dist/dev/control-flow/switch.js +1 -2
- package/dist/dev/derived.d.ts +0 -2
- package/dist/dev/derived.js +1 -2
- package/dist/dev/element.d.ts +0 -2
- package/dist/dev/element.js +2 -3
- package/dist/dev/element.js.map +1 -1
- package/dist/dev/events.d.ts +0 -2
- package/dist/dev/events.js +16 -46
- package/dist/dev/events.js.map +1 -1
- package/dist/dev/head/components.d.ts +0 -2
- package/dist/dev/head/components.js +1 -2
- package/dist/dev/head/registry.js +1 -2
- package/dist/dev/head/server-head.d.ts +0 -2
- package/dist/dev/head/server-head.js +1 -2
- package/dist/dev/head/sink.js +1 -2
- package/dist/dev/head/use-head.d.ts +0 -2
- package/dist/dev/head/use-head.js +1 -2
- package/dist/dev/head/validate.d.ts +0 -2
- package/dist/dev/head/validate.js +1 -2
- package/dist/dev/hmr.d.ts +0 -2
- package/dist/dev/hmr.js +1 -2
- package/dist/dev/hydration.d.ts +0 -2
- package/dist/dev/hydration.js +1 -2
- package/dist/dev/insert.d.ts +15 -7
- package/dist/dev/insert.js +36 -15
- package/dist/dev/insert.js.map +1 -1
- package/dist/dev/internal/claim.d.ts +2 -3
- package/dist/dev/internal/claim.js +19 -4
- package/dist/dev/internal/claim.js.map +1 -1
- package/dist/dev/internal/css-units.js +1 -2
- package/dist/dev/internal/diagnostics.d.ts +7 -5
- package/dist/dev/internal/diagnostics.js +15 -6
- package/dist/dev/internal/diagnostics.js.map +1 -1
- package/dist/dev/internal/early-events.js +21 -4
- package/dist/dev/internal/early-events.js.map +1 -1
- package/dist/dev/internal/hydration-hooks.d.ts +0 -2
- package/dist/dev/internal/hydration-hooks.js +0 -1
- package/dist/dev/internal/hydration-scope.d.ts +0 -2
- package/dist/dev/internal/hydration-scope.js +1 -2
- package/dist/dev/internal/names.d.ts +0 -2
- package/dist/dev/internal/names.js +1 -2
- package/dist/dev/internal/portal-context.d.ts +0 -2
- package/dist/dev/internal/portal-context.js +1 -2
- package/dist/dev/internal/react-names.js +26 -63
- package/dist/dev/internal/react-names.js.map +1 -1
- package/dist/dev/internal/reconcile.d.ts +0 -2
- package/dist/dev/internal/reconcile.js +4 -8
- package/dist/dev/internal/reconcile.js.map +1 -1
- package/dist/dev/internal/stream-context.d.ts +0 -2
- package/dist/dev/internal/stream-context.js +1 -2
- package/dist/dev/jsx/aria.d.ts +0 -2
- package/dist/dev/jsx/component.d.ts +0 -2
- package/dist/dev/jsx/events.d.ts +0 -2
- package/dist/dev/jsx/global.d.ts +5 -4
- package/dist/dev/jsx/html.d.ts +1 -2
- package/dist/dev/jsx/intrinsic.d.ts +0 -2
- package/dist/dev/jsx/mathml.d.ts +0 -2
- package/dist/dev/jsx/svg.d.ts +0 -2
- package/dist/dev/jsx/types.d.ts +0 -2
- package/dist/dev/jsx-runtime.d.ts +0 -2
- package/dist/dev/reactive.d.ts +0 -2
- package/dist/dev/reactive.js +1 -2
- package/dist/dev/render.d.ts +0 -2
- package/dist/dev/render.js +1 -2
- package/dist/dev/resource-hints.d.ts +0 -2
- package/dist/dev/resource-hints.js +5 -4
- package/dist/dev/resource-hints.js.map +1 -1
- package/dist/dev/select-value.d.ts +0 -2
- package/dist/dev/select-value.js +6 -17
- package/dist/dev/select-value.js.map +1 -1
- package/dist/dev/server/attributes.d.ts +3 -2
- package/dist/dev/server/attributes.js +6 -3
- package/dist/dev/server/attributes.js.map +1 -1
- package/dist/dev/server/class-style.d.ts +0 -2
- package/dist/dev/server/class-style.js +1 -2
- package/dist/dev/server/component.d.ts +0 -2
- package/dist/dev/server/component.js +1 -2
- package/dist/dev/server/derived.d.ts +0 -2
- package/dist/dev/server/derived.js +1 -2
- package/dist/dev/server/element.d.ts +0 -2
- package/dist/dev/server/element.js +9 -6
- package/dist/dev/server/element.js.map +1 -1
- package/dist/dev/server/errors.js +8 -3
- package/dist/dev/server/errors.js.map +1 -1
- package/dist/dev/server/escape.d.ts +0 -2
- package/dist/dev/server/escape.js +15 -8
- package/dist/dev/server/escape.js.map +1 -1
- package/dist/dev/server/form-controls.d.ts +0 -2
- package/dist/dev/server/form-controls.js +6 -4
- package/dist/dev/server/form-controls.js.map +1 -1
- package/dist/dev/server/hydration-script.d.ts +0 -2
- package/dist/dev/server/hydration-script.js +1 -2
- package/dist/dev/server/index.d.ts +2 -1
- package/dist/dev/server/index.js +2 -1
- package/dist/dev/server/node.d.ts +0 -2
- package/dist/dev/server/node.js +1 -2
- package/dist/dev/server/portals.d.ts +0 -2
- package/dist/dev/server/portals.js +0 -1
- package/dist/dev/server/raw-text.d.ts +28 -0
- package/dist/dev/server/raw-text.js +66 -0
- package/dist/dev/server/raw-text.js.map +1 -0
- package/dist/dev/server/render.d.ts +2 -3
- package/dist/dev/server/render.js +3 -4
- package/dist/dev/server/render.js.map +1 -1
- package/dist/dev/server/serialize.d.ts +0 -2
- package/dist/dev/server/serialize.js +1 -2
- package/dist/dev/server/stream.d.ts +1 -3
- package/dist/dev/server/stream.js +3 -4
- package/dist/dev/server/stream.js.map +1 -1
- package/dist/dev/server.d.ts +2 -1
- package/dist/dev/server.js +2 -1
- package/dist/dev/spread.d.ts +0 -2
- package/dist/dev/spread.js +8 -56
- package/dist/dev/spread.js.map +1 -1
- package/dist/dev/template.d.ts +0 -2
- package/dist/dev/template.js +1 -2
- package/dist/dev/view-transition.d.ts +0 -2
- package/dist/dev/view-transition.js +1 -2
- package/dist/prod/attributes.js +1 -1
- package/dist/prod/attributes.js.map +1 -1
- package/dist/prod/class-style.js +1 -1
- package/dist/prod/class-style.js.map +1 -1
- package/dist/prod/control-flow/dynamic.js +1 -1
- package/dist/prod/control-flow/dynamic.js.map +1 -1
- package/dist/prod/control-flow/portal.js +1 -1
- package/dist/prod/control-flow/portal.js.map +1 -1
- package/dist/prod/element.js +1 -1
- package/dist/prod/element.js.map +1 -1
- package/dist/prod/events.js +1 -1
- package/dist/prod/events.js.map +1 -1
- package/dist/prod/insert.js +1 -1
- package/dist/prod/insert.js.map +1 -1
- package/dist/prod/internal/claim.js +1 -1
- package/dist/prod/internal/claim.js.map +1 -1
- package/dist/prod/internal/diagnostics.js +1 -1
- package/dist/prod/internal/diagnostics.js.map +1 -1
- package/dist/prod/internal/early-events.js +1 -1
- package/dist/prod/internal/early-events.js.map +1 -1
- package/dist/prod/internal/react-names.js +1 -1
- package/dist/prod/internal/react-names.js.map +1 -1
- package/dist/prod/internal/reconcile.js +1 -1
- package/dist/prod/internal/reconcile.js.map +1 -1
- package/dist/prod/resource-hints.js +1 -1
- package/dist/prod/resource-hints.js.map +1 -1
- package/dist/prod/select-value.js +1 -1
- package/dist/prod/select-value.js.map +1 -1
- package/dist/prod/server/attributes.js +1 -1
- package/dist/prod/server/attributes.js.map +1 -1
- package/dist/prod/server/element.js +1 -1
- package/dist/prod/server/element.js.map +1 -1
- package/dist/prod/server/errors.js +1 -1
- package/dist/prod/server/errors.js.map +1 -1
- package/dist/prod/server/escape.js +1 -1
- package/dist/prod/server/escape.js.map +1 -1
- package/dist/prod/server/form-controls.js +2 -2
- package/dist/prod/server/form-controls.js.map +1 -1
- package/dist/prod/server/index.js +1 -1
- package/dist/prod/server/raw-text.js +2 -0
- package/dist/prod/server/raw-text.js.map +1 -0
- package/dist/prod/server/render.js +1 -1
- package/dist/prod/server/render.js.map +1 -1
- package/dist/prod/server/stream.js +1 -1
- package/dist/prod/server/stream.js.map +1 -1
- package/dist/prod/server.js +1 -1
- package/dist/prod/spread.js +1 -1
- package/dist/prod/spread.js.map +1 -1
- package/dist/server/attributes.js +1 -1
- package/dist/server/attributes.js.map +1 -1
- package/dist/server/class-style.js +1 -1
- package/dist/server/class-style.js.map +1 -1
- package/dist/server/control-flow/dynamic.js +1 -1
- package/dist/server/control-flow/dynamic.js.map +1 -1
- package/dist/server/control-flow/portal.js +1 -1
- package/dist/server/control-flow/portal.js.map +1 -1
- package/dist/server/element.js +1 -1
- package/dist/server/element.js.map +1 -1
- package/dist/server/events.js +1 -1
- package/dist/server/events.js.map +1 -1
- package/dist/server/insert.js +1 -1
- package/dist/server/insert.js.map +1 -1
- package/dist/server/internal/claim.js +1 -1
- package/dist/server/internal/claim.js.map +1 -1
- package/dist/server/internal/diagnostics.js +1 -1
- package/dist/server/internal/diagnostics.js.map +1 -1
- package/dist/server/internal/early-events.js +1 -1
- package/dist/server/internal/early-events.js.map +1 -1
- package/dist/server/internal/react-names.js +1 -1
- package/dist/server/internal/react-names.js.map +1 -1
- package/dist/server/internal/reconcile.js +1 -1
- package/dist/server/internal/reconcile.js.map +1 -1
- package/dist/server/resource-hints.js +1 -1
- package/dist/server/resource-hints.js.map +1 -1
- package/dist/server/select-value.js +1 -1
- package/dist/server/select-value.js.map +1 -1
- package/dist/server/server/attributes.js +1 -1
- package/dist/server/server/attributes.js.map +1 -1
- package/dist/server/server/element.js +1 -1
- package/dist/server/server/element.js.map +1 -1
- package/dist/server/server/errors.js +1 -1
- package/dist/server/server/errors.js.map +1 -1
- package/dist/server/server/escape.js +1 -1
- package/dist/server/server/escape.js.map +1 -1
- package/dist/server/server/form-controls.js +2 -2
- package/dist/server/server/form-controls.js.map +1 -1
- package/dist/server/server/index.js +1 -1
- package/dist/server/server/raw-text.js +2 -0
- package/dist/server/server/raw-text.js.map +1 -0
- package/dist/server/server/render.js +1 -1
- package/dist/server/server/render.js.map +1 -1
- package/dist/server/server/stream.js +1 -1
- package/dist/server/server/stream.js.map +1 -1
- package/dist/server/server.js +1 -1
- package/dist/server/spread.js +1 -1
- package/dist/server/spread.js.map +1 -1
- package/dist/server-dev/attributes.js +28 -51
- package/dist/server-dev/attributes.js.map +1 -1
- package/dist/server-dev/autofocus.js +1 -2
- package/dist/server-dev/class-style.js +25 -9
- package/dist/server-dev/class-style.js.map +1 -1
- package/dist/server-dev/component.js +1 -2
- package/dist/server-dev/control-flow/activity.js +1 -2
- package/dist/server-dev/control-flow/branch.js +0 -1
- package/dist/server-dev/control-flow/client-only.js +1 -2
- package/dist/server-dev/control-flow/dynamic.js +23 -12
- package/dist/server-dev/control-flow/dynamic.js.map +1 -1
- package/dist/server-dev/control-flow/error-boundary.js +1 -2
- package/dist/server-dev/control-flow/for.js +1 -2
- package/dist/server-dev/control-flow/fragment.js +1 -2
- package/dist/server-dev/control-flow/hot-link.js +1 -2
- package/dist/server-dev/control-flow/index-list.js +1 -2
- package/dist/server-dev/control-flow/lazy.js +1 -2
- package/dist/server-dev/control-flow/no-hydration.js +1 -2
- package/dist/server-dev/control-flow/portal.js +3 -2
- package/dist/server-dev/control-flow/portal.js.map +1 -1
- package/dist/server-dev/control-flow/root-errors.js +1 -2
- package/dist/server-dev/control-flow/show.js +1 -2
- package/dist/server-dev/control-flow/suspense-list.js +1 -2
- package/dist/server-dev/control-flow/suspense.js +1 -2
- package/dist/server-dev/control-flow/switch.js +1 -2
- package/dist/server-dev/derived.js +1 -2
- package/dist/server-dev/element.js +4 -3
- package/dist/server-dev/element.js.map +1 -1
- package/dist/server-dev/events.js +16 -46
- package/dist/server-dev/events.js.map +1 -1
- package/dist/server-dev/head/components.js +1 -2
- package/dist/server-dev/head/registry.js +1 -2
- package/dist/server-dev/head/server-head.js +1 -2
- package/dist/server-dev/head/sink.js +1 -2
- package/dist/server-dev/head/use-head.js +1 -2
- package/dist/server-dev/head/validate.js +1 -2
- package/dist/server-dev/hydration.js +1 -2
- package/dist/server-dev/insert.js +36 -15
- package/dist/server-dev/insert.js.map +1 -1
- package/dist/server-dev/internal/claim.js +19 -4
- package/dist/server-dev/internal/claim.js.map +1 -1
- package/dist/server-dev/internal/css-units.js +1 -2
- package/dist/server-dev/internal/diagnostics.js +15 -6
- package/dist/server-dev/internal/diagnostics.js.map +1 -1
- package/dist/server-dev/internal/early-events.js +21 -4
- package/dist/server-dev/internal/early-events.js.map +1 -1
- package/dist/server-dev/internal/hydration-hooks.js +0 -1
- package/dist/server-dev/internal/hydration-scope.js +1 -2
- package/dist/server-dev/internal/names.js +1 -2
- package/dist/server-dev/internal/portal-context.js +1 -2
- package/dist/server-dev/internal/react-names.js +26 -63
- package/dist/server-dev/internal/react-names.js.map +1 -1
- package/dist/server-dev/internal/reconcile.js +4 -8
- package/dist/server-dev/internal/reconcile.js.map +1 -1
- package/dist/server-dev/internal/stream-context.js +1 -2
- package/dist/server-dev/reactive.js +1 -2
- package/dist/server-dev/render.js +1 -2
- package/dist/server-dev/resource-hints.js +5 -4
- package/dist/server-dev/resource-hints.js.map +1 -1
- package/dist/server-dev/select-value.js +6 -17
- package/dist/server-dev/select-value.js.map +1 -1
- package/dist/server-dev/server/attributes.js +6 -3
- package/dist/server-dev/server/attributes.js.map +1 -1
- package/dist/server-dev/server/class-style.js +1 -2
- package/dist/server-dev/server/component.js +1 -2
- package/dist/server-dev/server/derived.js +1 -2
- package/dist/server-dev/server/element.js +9 -6
- package/dist/server-dev/server/element.js.map +1 -1
- package/dist/server-dev/server/errors.js +8 -3
- package/dist/server-dev/server/errors.js.map +1 -1
- package/dist/server-dev/server/escape.js +15 -8
- package/dist/server-dev/server/escape.js.map +1 -1
- package/dist/server-dev/server/form-controls.js +6 -4
- package/dist/server-dev/server/form-controls.js.map +1 -1
- package/dist/server-dev/server/hydration-script.js +1 -2
- package/dist/server-dev/server/index.js +2 -1
- package/dist/server-dev/server/node.js +1 -2
- package/dist/server-dev/server/portals.js +0 -1
- package/dist/server-dev/server/raw-text.js +86 -0
- package/dist/server-dev/server/raw-text.js.map +1 -0
- package/dist/server-dev/server/render.js +3 -4
- package/dist/server-dev/server/render.js.map +1 -1
- package/dist/server-dev/server/serialize.js +1 -2
- package/dist/server-dev/server/stream.js +3 -4
- package/dist/server-dev/server/stream.js.map +1 -1
- package/dist/server-dev/server.js +2 -1
- package/dist/server-dev/spread.js +8 -56
- package/dist/server-dev/spread.js.map +1 -1
- package/dist/server-dev/template.js +1 -2
- package/dist/server-dev/view-transition.js +1 -2
- package/package.json +3 -2
package/dist/dev/derived.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { useMemo } from "@shadow-js/core";
|
|
2
|
-
|
|
2
|
+
// src/derived.ts
|
|
3
3
|
/**
|
|
4
4
|
* Wraps a computation as a {@link Derived} value that recomputes only when the signals it reads
|
|
5
5
|
* change. The compiler emits it for `const x = <expression reading signals>` inside components; it
|
|
@@ -28,7 +28,6 @@ function derived(compute) {
|
|
|
28
28
|
Object.defineProperty(read, "value", { get: memo });
|
|
29
29
|
return read;
|
|
30
30
|
}
|
|
31
|
-
//#endregion
|
|
32
31
|
export { derived };
|
|
33
32
|
|
|
34
33
|
//# sourceMappingURL=derived.js.map
|
package/dist/dev/element.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
//#region src/element.d.ts
|
|
2
1
|
/**
|
|
3
2
|
* Creates one HTML element from a tag name and a props object, without the generic prop runtime of
|
|
4
3
|
* `spread` and `Dynamic`: for a library that renders one fixed element (a link, a button) and wants
|
|
@@ -36,5 +35,4 @@
|
|
|
36
35
|
* @since 1.0.0
|
|
37
36
|
*/
|
|
38
37
|
export declare function element(tag: string, props: object): unknown;
|
|
39
|
-
//#endregion
|
|
40
38
|
//# sourceMappingURL=element.d.ts.map
|
package/dist/dev/element.js
CHANGED
|
@@ -5,7 +5,7 @@ import { checkClaimedTag } from "./internal/claim.js";
|
|
|
5
5
|
import { claims } from "./internal/hydration-hooks.js";
|
|
6
6
|
import { insert } from "./insert.js";
|
|
7
7
|
import { batch, untrack, useRenderEffect } from "@shadow-js/core";
|
|
8
|
-
|
|
8
|
+
// src/element.ts
|
|
9
9
|
/**
|
|
10
10
|
* The slim element primitive: one HTML element with attributes, event listeners, `ref` and children,
|
|
11
11
|
* and no generic prop runtime. `Dynamic` and `spread` cover every prop shape; this covers the common
|
|
@@ -95,11 +95,10 @@ function element(tag, props) {
|
|
|
95
95
|
});
|
|
96
96
|
}
|
|
97
97
|
const ref = read["ref"];
|
|
98
|
-
if (typeof ref === "function") ref(el);
|
|
98
|
+
if (typeof ref === "function") untrack(() => ref(el));
|
|
99
99
|
insert(el, () => read["children"]);
|
|
100
100
|
return el;
|
|
101
101
|
}
|
|
102
|
-
//#endregion
|
|
103
102
|
export { element };
|
|
104
103
|
|
|
105
104
|
//# sourceMappingURL=element.js.map
|
package/dist/dev/element.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"element.js","names":[],"sources":["../../src/element.ts"],"sourcesContent":["import { batch, untrack, useRenderEffect } from \"@shadow-js/core\";\nimport { setAttribute } from \"./attributes\";\nimport { style } from \"./class-style\";\nimport { insert } from \"./insert\";\nimport { checkClaimedTag } from \"./internal/claim\";\nimport { claims } from \"./internal/hydration-hooks\";\nimport { nextKey } from \"./internal/hydration-scope\";\nimport { ssrElement, ssrRaw } from \"./server/element\";\n\n/**\n * The slim element primitive: one HTML element with attributes, event listeners, `ref` and children,\n * and no generic prop runtime. `Dynamic` and `spread` cover every prop shape; this covers the common\n * ones, so a library that renders one fixed element (a link, a button) pays for what it binds.\n *\n * It keeps the renderer's contracts: the hydration key is drawn when the element is created, so it\n * claims the server's element and adopts its children; on the server it writes the same markup `Dynamic`\n * writes for the tag.\n */\n\n/** Tag shape that `Dynamic` accepts. `script` is refused for the same reason. */\nconst TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;\n\n/** `onClick` to `click`, when the key is an event handler name. */\nfunction eventNameOf(key: string): string | undefined {\n return key.length > 2 && key.startsWith(\"on\") && /^[A-Z]/.test(key.charAt(2))\n ? key.slice(2).toLowerCase()\n : undefined;\n}\n\n/**\n * Binds one listener, read once. A function runs with the element as `this`; a `[fn, data]` tuple\n * receives `data` first. `null`, `undefined` and `false` bind nothing. Handlers run in a batch and\n * untracked, as the event binding of `Dynamic` runs them.\n */\nfunction bindListener(el: Element, name: string, handler: unknown): void {\n let call: ((event: Event) => unknown) | undefined;\n if (typeof handler === \"function\") {\n call = (event: Event): unknown => handler.call(el, event);\n } else if (Array.isArray(handler)) {\n const [fn, data] = handler as [unknown, unknown];\n if (typeof fn === \"function\") call = (event: Event): unknown => fn.call(el, data, event);\n }\n if (call === undefined) return;\n const run = call;\n el.addEventListener(name, (event: Event): void => {\n batch(() => untrack(() => run(event)));\n });\n}\n\n/**\n * Creates one HTML element from a tag name and a props object, without the generic prop runtime of\n * `spread` and `Dynamic`: for a library that renders one fixed element (a link, a button) and wants\n * to pay only for what it binds. It draws a hydration key, so during `hydrate()` it adopts the\n * server's element and its children; on the server it returns the markup `Dynamic` writes for the tag.\n *\n * Each prop other than `children`, `ref` and `onX` is read in a render effect, so a getter prop\n * updates the element in place. `class` and the other attributes follow {@link setAttribute} (URL\n * attributes that would run script are refused); `style` follows {@link style}. Use `Dynamic` when the\n * tag is not known in advance, or for SVG, `classList`, delegated events or React prop names.\n *\n * @param tag An HTML tag name matching `[a-z][a-z0-9-]*` (any case), such as `\"a\"`. `script` is\n * refused.\n * @param props The element's props. `onX` keys whose third letter is uppercase are native listeners,\n * read once: the rest of the key lowercased is the event (`onClick` is `click`), and the value is a\n * function (called with the element as `this`) or a `[fn, data]` tuple (called as `fn(data, event)`);\n * handlers run batched and untracked. `ref` is called once with the element. `children` is inserted\n * (a getter keeps it reactive). `class` takes a string; `style` a string or an object.\n * @returns The element on the client; its server markup when rendering on the server.\n * @throws TypeError `SHADOW_ELEMENT_TAG` when `tag` is not an allowed tag name.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { element } from \"@shadow-js/web\";\n *\n * function HomeLink() {\n * const [active] = useSignal(true);\n * return element(\"a\", {\n * href: \"/\",\n * get \"aria-current\"() { return active() ? \"page\" : undefined; },\n * onClick: (event: MouseEvent) => console.log(event.type),\n * children: \"Home\",\n * });\n * }\n * @see spread\n * @since 1.0.0\n */\nexport function element(tag: string, props: object): unknown {\n if (!TAG_PATTERN.test(tag) || tag.toLowerCase() === \"script\") {\n throw new TypeError(__DEV__ ? \"ShadowJS element: invalid tag\" : \"SHADOW_ELEMENT_TAG\");\n }\n const read = props as Readonly<Record<string, unknown>>;\n if (__SERVER__) {\n // The children are read after the hydration key is drawn, in the order the client claims them.\n return ssrElement(\n tag,\n props,\n () => {\n const children = read[\"children\"];\n
|
|
1
|
+
{"version":3,"file":"element.js","names":[],"sources":["../../src/element.ts"],"sourcesContent":["import { batch, untrack, useRenderEffect } from \"@shadow-js/core\";\nimport { setAttribute } from \"./attributes\";\nimport { style } from \"./class-style\";\nimport { insert } from \"./insert\";\nimport { checkClaimedTag } from \"./internal/claim\";\nimport { claims } from \"./internal/hydration-hooks\";\nimport { nextKey } from \"./internal/hydration-scope\";\nimport { ssrElement, ssrRaw } from \"./server/element\";\nimport { isTextOnlyElement } from \"./server/raw-text\";\n\n/**\n * The slim element primitive: one HTML element with attributes, event listeners, `ref` and children,\n * and no generic prop runtime. `Dynamic` and `spread` cover every prop shape; this covers the common\n * ones, so a library that renders one fixed element (a link, a button) pays for what it binds.\n *\n * It keeps the renderer's contracts: the hydration key is drawn when the element is created, so it\n * claims the server's element and adopts its children; on the server it writes the same markup `Dynamic`\n * writes for the tag.\n */\n\n/** Tag shape that `Dynamic` accepts. `script` is refused for the same reason. */\nconst TAG_PATTERN = /^[a-z][a-z0-9-]*$/i;\n\n/** `onClick` to `click`, when the key is an event handler name. */\nfunction eventNameOf(key: string): string | undefined {\n return key.length > 2 && key.startsWith(\"on\") && /^[A-Z]/.test(key.charAt(2))\n ? key.slice(2).toLowerCase()\n : undefined;\n}\n\n/**\n * Binds one listener, read once. A function runs with the element as `this`; a `[fn, data]` tuple\n * receives `data` first. `null`, `undefined` and `false` bind nothing. Handlers run in a batch and\n * untracked, as the event binding of `Dynamic` runs them.\n */\nfunction bindListener(el: Element, name: string, handler: unknown): void {\n let call: ((event: Event) => unknown) | undefined;\n if (typeof handler === \"function\") {\n call = (event: Event): unknown => handler.call(el, event);\n } else if (Array.isArray(handler)) {\n const [fn, data] = handler as [unknown, unknown];\n if (typeof fn === \"function\") call = (event: Event): unknown => fn.call(el, data, event);\n }\n if (call === undefined) return;\n const run = call;\n el.addEventListener(name, (event: Event): void => {\n batch(() => untrack(() => run(event)));\n });\n}\n\n/**\n * Creates one HTML element from a tag name and a props object, without the generic prop runtime of\n * `spread` and `Dynamic`: for a library that renders one fixed element (a link, a button) and wants\n * to pay only for what it binds. It draws a hydration key, so during `hydrate()` it adopts the\n * server's element and its children; on the server it returns the markup `Dynamic` writes for the tag.\n *\n * Each prop other than `children`, `ref` and `onX` is read in a render effect, so a getter prop\n * updates the element in place. `class` and the other attributes follow {@link setAttribute} (URL\n * attributes that would run script are refused); `style` follows {@link style}. Use `Dynamic` when the\n * tag is not known in advance, or for SVG, `classList`, delegated events or React prop names.\n *\n * @param tag An HTML tag name matching `[a-z][a-z0-9-]*` (any case), such as `\"a\"`. `script` is\n * refused.\n * @param props The element's props. `onX` keys whose third letter is uppercase are native listeners,\n * read once: the rest of the key lowercased is the event (`onClick` is `click`), and the value is a\n * function (called with the element as `this`) or a `[fn, data]` tuple (called as `fn(data, event)`);\n * handlers run batched and untracked. `ref` is called once with the element. `children` is inserted\n * (a getter keeps it reactive). `class` takes a string; `style` a string or an object.\n * @returns The element on the client; its server markup when rendering on the server.\n * @throws TypeError `SHADOW_ELEMENT_TAG` when `tag` is not an allowed tag name.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { element } from \"@shadow-js/web\";\n *\n * function HomeLink() {\n * const [active] = useSignal(true);\n * return element(\"a\", {\n * href: \"/\",\n * get \"aria-current\"() { return active() ? \"page\" : undefined; },\n * onClick: (event: MouseEvent) => console.log(event.type),\n * children: \"Home\",\n * });\n * }\n * @see spread\n * @since 1.0.0\n */\nexport function element(tag: string, props: object): unknown {\n if (!TAG_PATTERN.test(tag) || tag.toLowerCase() === \"script\") {\n throw new TypeError(__DEV__ ? \"ShadowJS element: invalid tag\" : \"SHADOW_ELEMENT_TAG\");\n }\n const read = props as Readonly<Record<string, unknown>>;\n if (__SERVER__) {\n // The children are read after the hydration key is drawn, in the order the client claims them.\n return ssrElement(\n tag,\n props,\n () => {\n const children = read[\"children\"];\n // The content of a style or a title is text the parser reads whole: no markers can go in it.\n if (children === undefined || isTextOnlyElement(tag)) return children;\n return [ssrRaw(\"<!--[-->\"), children, ssrRaw(\"<!--]-->\")];\n },\n true,\n );\n }\n const claimed = claims.current.claimElement(nextKey());\n if (claimed !== null && __DEV__) checkClaimedTag(claimed, tag);\n const el = claimed ?? document.createElement(tag);\n for (const key of Object.keys(props)) {\n if (key === \"children\" || key === \"ref\") continue;\n const event = eventNameOf(key);\n if (event !== undefined) {\n bindListener(el, event, read[key]);\n } else if (key === \"style\") {\n // The last value written, so a property that leaves the style object is removed (as spread does).\n let applied: unknown;\n useRenderEffect(\n () => read[key],\n (value) => {\n applied = style(el as HTMLElement, value, applied);\n },\n );\n } else {\n useRenderEffect(\n () => read[key],\n (value) => {\n setAttribute(el, key, value);\n },\n );\n }\n }\n const ref = read[\"ref\"];\n if (typeof ref === \"function\") untrack(() => ref(el));\n insert(el, () => read[\"children\"]);\n return el;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,cAAc;;AAGpB,SAAS,YAAY,KAAiC;CACpD,OAAO,IAAI,SAAS,KAAK,IAAI,WAAW,IAAI,KAAK,SAAS,KAAK,IAAI,OAAO,CAAC,CAAC,IACxE,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,IACzB,KAAA;AACN;;;;;;AAOA,SAAS,aAAa,IAAa,MAAc,SAAwB;CACvE,IAAI;CACJ,IAAI,OAAO,YAAY,YACrB,QAAQ,UAA0B,QAAQ,KAAK,IAAI,KAAK;MACnD,IAAI,MAAM,QAAQ,OAAO,GAAG;EACjC,MAAM,CAAC,IAAI,QAAQ;EACnB,IAAI,OAAO,OAAO,YAAY,QAAQ,UAA0B,GAAG,KAAK,IAAI,MAAM,KAAK;CACzF;CACA,IAAI,SAAS,KAAA,GAAW;CACxB,MAAM,MAAM;CACZ,GAAG,iBAAiB,OAAO,UAAuB;EAChD,YAAY,cAAc,IAAI,KAAK,CAAC,CAAC;CACvC,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,QAAQ,KAAa,OAAwB;CAC3D,IAAI,CAAC,YAAY,KAAK,GAAG,KAAK,IAAI,YAAY,MAAM,UAClD,MAAM,IAAI,UAAoB,+BAAsD;CAEtF,MAAM,OAAO;CAeb,MAAM,UAAU,OAAO,QAAQ,aAAa,QAAQ,CAAC;CACrD,IAAI,YAAY,QAAA,MAAiB,gBAAgB,SAAS,GAAG;CAC7D,MAAM,KAAK,WAAW,SAAS,cAAc,GAAG;CAChD,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EACpC,IAAI,QAAQ,cAAc,QAAQ,OAAO;EACzC,MAAM,QAAQ,YAAY,GAAG;EAC7B,IAAI,UAAU,KAAA,GACZ,aAAa,IAAI,OAAO,KAAK,IAAI;OAC5B,IAAI,QAAQ,SAAS;GAE1B,IAAI;GACJ,sBACQ,KAAK,OACV,UAAU;IACT,UAAU,MAAM,IAAmB,OAAO,OAAO;GACnD,CACF;EACF,OACE,sBACQ,KAAK,OACV,UAAU;GACT,aAAa,IAAI,KAAK,KAAK;EAC7B,CACF;CAEJ;CACA,MAAM,MAAM,KAAK;CACjB,IAAI,OAAO,QAAQ,YAAY,cAAc,IAAI,EAAE,CAAC;CACpD,OAAO,UAAU,KAAK,WAAW;CACjC,OAAO;AACT"}
|
package/dist/dev/events.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
//#region src/events.d.ts
|
|
2
1
|
/**
|
|
3
2
|
* Combines several handlers for one event name on one element into one handler that calls them in
|
|
4
3
|
* order with the same event. The compiler uses it when an element has, for example, both `onInput`
|
|
@@ -83,5 +82,4 @@ export declare function clearDelegatedEvents(target?: Document): void;
|
|
|
83
82
|
* @since 1.0.0
|
|
84
83
|
*/
|
|
85
84
|
export declare function addEventListener(el: Element, name: string, handler: unknown, delegate?: boolean, capture?: boolean): void;
|
|
86
|
-
//#endregion
|
|
87
85
|
//# sourceMappingURL=events.d.ts.map
|
package/dist/dev/events.js
CHANGED
|
@@ -1,52 +1,24 @@
|
|
|
1
1
|
import { batch, getOwner, onCleanup, untrack } from "@shadow-js/core";
|
|
2
|
-
|
|
2
|
+
// src/events.ts
|
|
3
3
|
/**
|
|
4
4
|
* Events that may be delegated: composed events, which leave a shadow root and reach the document.
|
|
5
5
|
* `change` is not composed, so it is bound on its element (see the note on `bindEvent`).
|
|
6
6
|
*/
|
|
7
|
-
const DELEGATED_EVENTS =
|
|
8
|
-
"click",
|
|
9
|
-
"dblclick",
|
|
10
|
-
"input",
|
|
11
|
-
"keydown",
|
|
12
|
-
"keyup",
|
|
13
|
-
"keypress",
|
|
14
|
-
"pointerdown",
|
|
15
|
-
"pointerup",
|
|
16
|
-
"pointermove",
|
|
17
|
-
"mousedown",
|
|
18
|
-
"mouseup",
|
|
19
|
-
"mousemove",
|
|
20
|
-
"focusin",
|
|
21
|
-
"focusout",
|
|
22
|
-
"beforeinput",
|
|
23
|
-
"touchstart",
|
|
24
|
-
"touchend",
|
|
25
|
-
"touchmove",
|
|
26
|
-
"contextmenu",
|
|
27
|
-
"mouseover",
|
|
28
|
-
"mouseout",
|
|
29
|
-
"pointerover",
|
|
30
|
-
"pointerout"
|
|
31
|
-
]);
|
|
7
|
+
const DELEGATED_EVENTS = /^(?:click|dblclick|input|beforeinput|contextmenu|key(?:down|up|press)|(?:pointer|mouse)(?:down|up|move|over|out)|focus(?:in|out)|touch(?:start|end|move))$/;
|
|
32
8
|
/** Documents that already carry the delegated listener for a given event name. */
|
|
33
9
|
const installed = /* @__PURE__ */ new WeakMap();
|
|
34
10
|
/** Calls `fn` with `this` = node, retargeting `currentTarget` for the duration of the call. */
|
|
35
|
-
function invoke(
|
|
11
|
+
function invoke(fn, node, event, args) {
|
|
36
12
|
Object.defineProperty(event, "currentTarget", {
|
|
37
13
|
configurable: true,
|
|
38
14
|
get: () => node
|
|
39
15
|
});
|
|
40
16
|
try {
|
|
41
|
-
untrack(() =>
|
|
17
|
+
untrack(() => fn.call(node, ...args));
|
|
42
18
|
} finally {
|
|
43
19
|
Reflect.deleteProperty(event, "currentTarget");
|
|
44
20
|
}
|
|
45
21
|
}
|
|
46
|
-
/** Reads a compiler-style expando (`node.$$click`), if present. */
|
|
47
|
-
function expando(node, key) {
|
|
48
|
-
return Reflect.get(node, key);
|
|
49
|
-
}
|
|
50
22
|
/**
|
|
51
23
|
* The one listener per (document, event). It walks `composedPath()` from the target outward,
|
|
52
24
|
* calling `node.$$<type>` with `this = node`. Stops when a handler stops propagation.
|
|
@@ -60,16 +32,11 @@ function dispatchPath(event) {
|
|
|
60
32
|
const errors = [];
|
|
61
33
|
for (const node of event.composedPath()) {
|
|
62
34
|
if (event.cancelBubble) break;
|
|
63
|
-
const fn =
|
|
35
|
+
const fn = Reflect.get(node, key);
|
|
64
36
|
if (typeof fn !== "function") continue;
|
|
65
|
-
const data =
|
|
66
|
-
const binding = {
|
|
67
|
-
fn,
|
|
68
|
-
data,
|
|
69
|
-
tuple: data !== void 0
|
|
70
|
-
};
|
|
37
|
+
const data = Reflect.get(node, dataKey);
|
|
71
38
|
try {
|
|
72
|
-
invoke(
|
|
39
|
+
invoke(fn, node, event, data === void 0 ? [event] : [data, event]);
|
|
73
40
|
} catch (error) {
|
|
74
41
|
errors.push(error);
|
|
75
42
|
}
|
|
@@ -83,10 +50,13 @@ function isListenerObject(handler) {
|
|
|
83
50
|
}
|
|
84
51
|
/** Binds a listener object natively (never delegated), honoring its options. */
|
|
85
52
|
function bindListenerObject(el, name, object, capture) {
|
|
86
|
-
const
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
53
|
+
const { once, passive, signal } = object;
|
|
54
|
+
const options = {
|
|
55
|
+
capture: object.capture === true || capture,
|
|
56
|
+
once,
|
|
57
|
+
passive,
|
|
58
|
+
signal
|
|
59
|
+
};
|
|
90
60
|
const listener = (event) => {
|
|
91
61
|
batch(() => untrack(() => object.handleEvent(event)));
|
|
92
62
|
};
|
|
@@ -206,7 +176,8 @@ function bindEvent(el, name, handler, delegate, capture = false) {
|
|
|
206
176
|
if (isListenerObject(handler)) return bindListenerObject(el, name, handler, capture);
|
|
207
177
|
const binding = toBinding(handler);
|
|
208
178
|
const slot = `$$${name}`;
|
|
209
|
-
|
|
179
|
+
const plain = !binding.tuple || binding.data !== void 0;
|
|
180
|
+
if (delegate && plain && !capture && DELEGATED_EVENTS.test(name) && Reflect.get(el, slot) === void 0) {
|
|
210
181
|
delegateEvents([name], delegationDocument(el));
|
|
211
182
|
const dataKey = `${slot}Data`;
|
|
212
183
|
Reflect.set(el, slot, binding.fn);
|
|
@@ -259,7 +230,6 @@ function addEventListener(el, name, handler, delegate, capture) {
|
|
|
259
230
|
const unbind = bindEvent(el, name, handler, delegate === true, capture === true);
|
|
260
231
|
if (unbind !== void 0 && getOwner() !== null) onCleanup(unbind);
|
|
261
232
|
}
|
|
262
|
-
//#endregion
|
|
263
233
|
export { addEventListener, bindEvent, chainEvents, clearDelegatedEvents, delegateEvents };
|
|
264
234
|
|
|
265
235
|
//# sourceMappingURL=events.js.map
|
package/dist/dev/events.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"events.js","names":["holder"],"sources":["../../src/events.ts"],"sourcesContent":["import { batch, getOwner, onCleanup, untrack } from \"@shadow-js/core\";\n\n/**\n * Events that may be delegated: composed events, which leave a shadow root and reach the document.\n * `change` is not composed, so it is bound on its element (see the note on `bindEvent`).\n */\nconst DELEGATED_EVENTS = new Set([\n \"click\",\n \"dblclick\",\n \"input\",\n \"keydown\",\n \"keyup\",\n \"keypress\",\n \"pointerdown\",\n \"pointerup\",\n \"pointermove\",\n \"mousedown\",\n \"mouseup\",\n \"mousemove\",\n \"focusin\",\n \"focusout\",\n \"beforeinput\",\n \"touchstart\",\n \"touchend\",\n \"touchmove\",\n \"contextmenu\",\n \"mouseover\",\n \"mouseout\",\n \"pointerover\",\n \"pointerout\",\n]);\n\n/** Documents that already carry the delegated listener for a given event name. */\nconst installed = new WeakMap<Document, Set<string>>();\n\n/** A handler together with its optional data; `tuple` records the `[fn, data]` form. */\ninterface Binding {\n readonly fn: (this: EventTarget, ...args: unknown[]) => unknown;\n readonly data: unknown;\n readonly tuple: boolean;\n}\n\n/** Calls `fn` with `this` = node, retargeting `currentTarget` for the duration of the call. */\nfunction invoke(binding: Binding, node: EventTarget, event: Event, args: unknown[]): void {\n Object.defineProperty(event, \"currentTarget\", { configurable: true, get: () => node });\n try {\n untrack(() => binding.fn.call(node, ...args));\n } finally {\n Reflect.deleteProperty(event, \"currentTarget\");\n }\n}\n\n/** Reads a compiler-style expando (`node.$$click`), if present. */\nfunction expando(node: EventTarget, key: string): unknown {\n const holder: object = node;\n return Reflect.get(holder, key);\n}\n\n/**\n * The one listener per (document, event). It walks `composedPath()` from the target outward,\n * calling `node.$$<type>` with `this = node`. Stops when a handler stops propagation.\n */\nfunction dispatchDelegated(event: Event): void {\n // One batch per event: every handler on the path runs first, then the effects, so the DOM is\n // current when the event finishes (ADR-007).\n batch(() => dispatchPath(event));\n}\n\nfunction dispatchPath(event: Event): void {\n const key = `$$${event.type}`;\n const dataKey = `${key}Data`;\n const errors: unknown[] = [];\n for (const node of event.composedPath()) {\n if (event.cancelBubble) break;\n const fn = expando(node, key);\n if (typeof fn !== \"function\") continue;\n const data = expando(node, dataKey);\n const binding: Binding = {\n fn: fn as (this: EventTarget, ...args: unknown[]) => unknown,\n data,\n tuple: data !== undefined,\n };\n try {\n invoke(binding, node, event, binding.tuple ? [data, event] : [event]);\n } catch (error) {\n errors.push(error);\n }\n }\n const [first] = errors;\n if (errors.length === 1) throw first;\n if (errors.length > 1)\n throw new AggregateError(\n errors,\n __DEV__ ? \"Several event handlers threw.\" : \"SHADOW_EVENT_ERRORS\",\n );\n}\n\n/** A DOM-style listener object: `handleEvent` plus the `addEventListener` options. */\ninterface ListenerObject {\n handleEvent(event: Event): unknown;\n once?: boolean;\n passive?: boolean;\n capture?: boolean;\n signal?: AbortSignal;\n}\n\nfunction isListenerObject(handler: unknown): handler is ListenerObject {\n return (\n typeof handler === \"object\" &&\n handler !== null &&\n typeof (handler as { handleEvent?: unknown }).handleEvent === \"function\"\n );\n}\n\n/** Binds a listener object natively (never delegated), honoring its options. */\nfunction bindListenerObject(\n el: Element,\n name: string,\n object: ListenerObject,\n capture: boolean,\n): () => void {\n const options: AddEventListenerOptions = { capture: object.capture === true || capture };\n if (object.once !== undefined) options.once = object.once;\n if (object.passive !== undefined) options.passive = object.passive;\n if (object.signal !== undefined) options.signal = object.signal;\n const listener = (event: Event): void => {\n batch(() => untrack(() => object.handleEvent(event)));\n };\n el.addEventListener(name, listener, options);\n return () => {\n el.removeEventListener(name, listener, options);\n };\n}\n\n/** Normalizes a handler value into a binding; throws for values that are neither. */\nfunction toBinding(handler: unknown): Binding {\n if (typeof handler === \"function\") {\n return { fn: handler as Binding[\"fn\"], data: undefined, tuple: false };\n }\n if (Array.isArray(handler) && typeof handler[0] === \"function\") {\n return { fn: handler[0] as Binding[\"fn\"], data: handler[1], tuple: true };\n }\n throw new TypeError(\n __DEV__\n ? \"addEventListener(): the handler must be a function, [function, data] or an object with handleEvent.\"\n : \"SHADOW_EVENT_HANDLER\",\n );\n}\n\n/**\n * Combines several handlers for one event name on one element into one handler that calls them in\n * order with the same event. The compiler uses it when an element has, for example, both `onInput`\n * and a text input's `onChange`: the delegated slot holds one function.\n *\n * @param handlers The handlers, in source order. None gives a handler that does nothing.\n * @returns A handler that calls each of them with the same `this` and event. An error thrown by one\n * handler propagates and the later handlers do not run.\n * @example\n * import { addEventListener, chainEvents } from \"@shadow-js/web\";\n *\n * const input = document.createElement(\"input\");\n * const onInput = chainEvents(\n * (event) => console.log(\"validate\", event.type),\n * (event) => console.log(\"save\", event.type),\n * );\n * addEventListener(input, \"input\", onInput);\n * @since 1.0.0\n */\nexport function chainEvents(\n ...handlers: Array<(this: EventTarget, event: Event) => unknown>\n): (this: EventTarget, event: Event) => void {\n return function chained(this: EventTarget, event: Event): void {\n for (const handler of handlers) handler.call(this, event);\n };\n}\n\n/**\n * Installs the document listener that runs delegated handlers for each event name, once per\n * document and name; repeated calls do nothing. Compiled modules call it for the events they\n * delegate, so application code rarely needs it. The listener walks `composedPath()` from the target\n * outward and runs each element's delegated handler in one batch, stopping when a handler stops\n * propagation. A non-composed event raised inside a shadow root never reaches the document, so bind\n * such events natively.\n *\n * @param names Event names to delegate, such as `[\"click\", \"input\"]`.\n * @param target Document that receives the listeners. Default: the global `document`.\n * @example\n * import { delegateEvents } from \"@shadow-js/web\";\n *\n * delegateEvents([\"click\", \"input\"]);\n * @see clearDelegatedEvents\n * @since 1.0.0\n */\nexport function delegateEvents(names: string[], target: Document = globalThis.document): void {\n let known = installed.get(target);\n if (known === undefined) {\n known = new Set<string>();\n installed.set(target, known);\n }\n for (const name of names) {\n if (known.has(name)) continue;\n known.add(name);\n target.addEventListener(name, dispatchDelegated);\n }\n}\n\n/**\n * Removes the delegated listeners {@link delegateEvents} installed on `target`. Delegated handlers stop\n * running until `delegateEvents` is called again (Solid's `clearDelegatedEvents`). Use it when a page\n * unmounts ShadowJS entirely, for example a micro-frontend that hands the document back. A document\n * without delegated listeners is left as is.\n *\n * @param target Document whose listeners are removed. Default: the global `document`.\n * @example\n * import { clearDelegatedEvents } from \"@shadow-js/web\";\n *\n * export function unmountApp(dispose: () => void): void {\n * dispose();\n * clearDelegatedEvents();\n * }\n * @see delegateEvents\n * @since 1.0.0\n */\nexport function clearDelegatedEvents(target: Document = globalThis.document): void {\n const known = installed.get(target);\n if (known === undefined) return;\n for (const name of known) target.removeEventListener(name, dispatchDelegated);\n installed.delete(target);\n}\n\n/**\n * The document that must carry the delegated listener for `el`. A template clone is owned by the\n * template's inert document (no window, never receives an event) until it is inserted, and handlers\n * are bound before that: use the page's document then, which is where the element will live.\n */\nfunction delegationDocument(el: Element): Document {\n const owner = el.ownerDocument;\n return owner !== null && owner.defaultView !== null ? owner : globalThis.document;\n}\n\n/**\n * Binds one handler and returns the function that undoes it. A delegated event is stored on the\n * element as an expando; the document listener picks it up. Other events get a native listener.\n * Non-composed events (`change`, `select`, `load`, ...) never leave a shadow root, so they always get\n * a native listener, whatever the caller asked for.\n * @internal\n */\nexport function bindEvent(\n el: Element,\n name: string,\n handler: unknown,\n delegate: boolean,\n capture = false,\n): (() => void) | undefined {\n if (handler === null || handler === undefined || handler === false) return undefined;\n if (isListenerObject(handler)) return bindListenerObject(el, name, handler, capture);\n const binding = toBinding(handler);\n // One delegated slot per event name: a second handler for the same name on this element (React's\n // onInput and onChange on one text input) binds natively, so both run.\n const slot = `$$${name}`;\n if (delegate && !capture && DELEGATED_EVENTS.has(name) && Reflect.get(el, slot) === undefined) {\n delegateEvents([name], delegationDocument(el));\n const dataKey = `${slot}Data`;\n Reflect.set(el, slot, binding.fn);\n if (binding.tuple) Reflect.set(el, dataKey, binding.data);\n else Reflect.deleteProperty(el, dataKey);\n return () => {\n if (Reflect.get(el, slot) === binding.fn) {\n Reflect.deleteProperty(el, slot);\n Reflect.deleteProperty(el, dataKey);\n }\n };\n }\n const listener = (event: Event): void => {\n const args: unknown[] = binding.tuple ? [binding.data, event] : [event];\n batch(() => untrack(() => binding.fn.call(el, ...args)));\n };\n el.addEventListener(name, listener, capture);\n return () => {\n el.removeEventListener(name, listener, capture);\n };\n}\n\n/**\n * Binds an event handler to an element: the helper compiled templates call for `onX` and the `on:`\n * and `oncapture:` prefixes. Handlers run batched and untracked, with `this` set to the element.\n * Inside an owner, the listener is removed when the owner is disposed, even if the element outlives\n * it.\n *\n * @param el Target element.\n * @param name Event name, lowercase, such as `click`.\n * @param handler A function (called with the event), a `[fn, data]` tuple (called as\n * `fn(data, event)`), or a listener object `{ handleEvent, once, passive, capture, signal }`, which\n * is always bound natively with those options. `null`, `undefined` and `false` bind nothing.\n * @param delegate `true` stores the handler on the element for the document listener of\n * {@link delegateEvents} (installed on demand) when `name` is a delegated event (`click`, `input`,\n * `keydown`, pointer, mouse, touch and focus events, ...) and the element has no delegated handler\n * for it yet. Otherwise, and when undefined, the handler gets a native listener.\n * @param capture `true` listens in the capture phase, never delegated. Undefined means the bubble phase.\n * @throws TypeError `SHADOW_EVENT_HANDLER` when `handler` is not a function, a tuple whose first item\n * is a function, or a listener object.\n * @example\n * import { addEventListener } from \"@shadow-js/web\";\n *\n * const button = document.createElement(\"button\");\n * addEventListener(button, \"click\", () => console.log(\"pressed\"), true);\n * addEventListener(button, \"focus\", [(id: string, event: Event) => console.log(id, event.type), \"save\"]);\n * @see delegateEvents\n * @since 1.0.0\n */\nexport function addEventListener(\n el: Element,\n name: string,\n handler: unknown,\n delegate?: boolean,\n capture?: boolean,\n): void {\n const unbind = bindEvent(el, name, handler, delegate === true, capture === true);\n // The listener goes when the owner does, even if the element outlives it (moved, portaled, reused).\n if (unbind !== undefined && getOwner() !== null) onCleanup(unbind);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"events.js","names":[],"sources":["../../src/events.ts"],"sourcesContent":["import { batch, getOwner, onCleanup, untrack } from \"@shadow-js/core\";\n\n/**\n * Events that may be delegated: composed events, which leave a shadow root and reach the document.\n * `change` is not composed, so it is bound on its element (see the note on `bindEvent`).\n */\nconst DELEGATED_EVENTS =\n /^(?:click|dblclick|input|beforeinput|contextmenu|key(?:down|up|press)|(?:pointer|mouse)(?:down|up|move|over|out)|focus(?:in|out)|touch(?:start|end|move))$/;\n\n/** Documents that already carry the delegated listener for a given event name. */\nconst installed = new WeakMap<Document, Set<string>>();\n\n/** A handler together with its optional data; `tuple` records the `[fn, data]` form. */\ninterface Binding {\n readonly fn: (this: EventTarget, ...args: unknown[]) => unknown;\n readonly data: unknown;\n readonly tuple: boolean;\n}\n\n/** Calls `fn` with `this` = node, retargeting `currentTarget` for the duration of the call. */\nfunction invoke(fn: Binding[\"fn\"], node: EventTarget, event: Event, args: unknown[]): void {\n Object.defineProperty(event, \"currentTarget\", { configurable: true, get: () => node });\n try {\n untrack(() => fn.call(node, ...args));\n } finally {\n Reflect.deleteProperty(event, \"currentTarget\");\n }\n}\n\n/**\n * The one listener per (document, event). It walks `composedPath()` from the target outward,\n * calling `node.$$<type>` with `this = node`. Stops when a handler stops propagation.\n */\nfunction dispatchDelegated(event: Event): void {\n // One batch per event: every handler on the path runs first, then the effects, so the DOM is\n // current when the event finishes (ADR-007).\n batch(() => dispatchPath(event));\n}\n\nfunction dispatchPath(event: Event): void {\n const key = `$$${event.type}`;\n const dataKey = `${key}Data`;\n const errors: unknown[] = [];\n for (const node of event.composedPath()) {\n if (event.cancelBubble) break;\n const fn = Reflect.get(node, key);\n if (typeof fn !== \"function\") continue;\n const data = Reflect.get(node, dataKey);\n try {\n invoke(fn as Binding[\"fn\"], node, event, data === undefined ? [event] : [data, event]);\n } catch (error) {\n errors.push(error);\n }\n }\n const [first] = errors;\n if (errors.length === 1) throw first;\n if (errors.length > 1)\n throw new AggregateError(\n errors,\n __DEV__ ? \"Several event handlers threw.\" : \"SHADOW_EVENT_ERRORS\",\n );\n}\n\n/** A DOM-style listener object: `handleEvent` plus the `addEventListener` options. */\ninterface ListenerObject {\n handleEvent(event: Event): unknown;\n once?: boolean;\n passive?: boolean;\n capture?: boolean;\n signal?: AbortSignal;\n}\n\nfunction isListenerObject(handler: unknown): handler is ListenerObject {\n return (\n typeof handler === \"object\" &&\n handler !== null &&\n typeof (handler as { handleEvent?: unknown }).handleEvent === \"function\"\n );\n}\n\n/** Binds a listener object natively (never delegated), honoring its options. */\nfunction bindListenerObject(\n el: Element,\n name: string,\n object: ListenerObject,\n capture: boolean,\n): () => void {\n const { once, passive, signal } = object;\n // A member that is `undefined` counts as absent to the DOM, so none of them needs a check.\n const options = {\n capture: object.capture === true || capture,\n once,\n passive,\n signal,\n } as AddEventListenerOptions;\n const listener = (event: Event): void => {\n batch(() => untrack(() => object.handleEvent(event)));\n };\n el.addEventListener(name, listener, options);\n return () => {\n el.removeEventListener(name, listener, options);\n };\n}\n\n/** Normalizes a handler value into a binding; throws for values that are neither. */\nfunction toBinding(handler: unknown): Binding {\n if (typeof handler === \"function\") {\n return { fn: handler as Binding[\"fn\"], data: undefined, tuple: false };\n }\n if (Array.isArray(handler) && typeof handler[0] === \"function\") {\n return { fn: handler[0] as Binding[\"fn\"], data: handler[1], tuple: true };\n }\n throw new TypeError(\n __DEV__\n ? \"addEventListener(): the handler must be a function, [function, data] or an object with handleEvent.\"\n : \"SHADOW_EVENT_HANDLER\",\n );\n}\n\n/**\n * Combines several handlers for one event name on one element into one handler that calls them in\n * order with the same event. The compiler uses it when an element has, for example, both `onInput`\n * and a text input's `onChange`: the delegated slot holds one function.\n *\n * @param handlers The handlers, in source order. None gives a handler that does nothing.\n * @returns A handler that calls each of them with the same `this` and event. An error thrown by one\n * handler propagates and the later handlers do not run.\n * @example\n * import { addEventListener, chainEvents } from \"@shadow-js/web\";\n *\n * const input = document.createElement(\"input\");\n * const onInput = chainEvents(\n * (event) => console.log(\"validate\", event.type),\n * (event) => console.log(\"save\", event.type),\n * );\n * addEventListener(input, \"input\", onInput);\n * @since 1.0.0\n */\nexport function chainEvents(\n ...handlers: Array<(this: EventTarget, event: Event) => unknown>\n): (this: EventTarget, event: Event) => void {\n return function chained(this: EventTarget, event: Event): void {\n for (const handler of handlers) handler.call(this, event);\n };\n}\n\n/**\n * Installs the document listener that runs delegated handlers for each event name, once per\n * document and name; repeated calls do nothing. Compiled modules call it for the events they\n * delegate, so application code rarely needs it. The listener walks `composedPath()` from the target\n * outward and runs each element's delegated handler in one batch, stopping when a handler stops\n * propagation. A non-composed event raised inside a shadow root never reaches the document, so bind\n * such events natively.\n *\n * @param names Event names to delegate, such as `[\"click\", \"input\"]`.\n * @param target Document that receives the listeners. Default: the global `document`.\n * @example\n * import { delegateEvents } from \"@shadow-js/web\";\n *\n * delegateEvents([\"click\", \"input\"]);\n * @see clearDelegatedEvents\n * @since 1.0.0\n */\nexport function delegateEvents(names: string[], target: Document = globalThis.document): void {\n let known = installed.get(target);\n if (known === undefined) {\n known = new Set<string>();\n installed.set(target, known);\n }\n for (const name of names) {\n if (known.has(name)) continue;\n known.add(name);\n target.addEventListener(name, dispatchDelegated);\n }\n}\n\n/**\n * Removes the delegated listeners {@link delegateEvents} installed on `target`. Delegated handlers stop\n * running until `delegateEvents` is called again (Solid's `clearDelegatedEvents`). Use it when a page\n * unmounts ShadowJS entirely, for example a micro-frontend that hands the document back. A document\n * without delegated listeners is left as is.\n *\n * @param target Document whose listeners are removed. Default: the global `document`.\n * @example\n * import { clearDelegatedEvents } from \"@shadow-js/web\";\n *\n * export function unmountApp(dispose: () => void): void {\n * dispose();\n * clearDelegatedEvents();\n * }\n * @see delegateEvents\n * @since 1.0.0\n */\nexport function clearDelegatedEvents(target: Document = globalThis.document): void {\n const known = installed.get(target);\n if (known === undefined) return;\n for (const name of known) target.removeEventListener(name, dispatchDelegated);\n installed.delete(target);\n}\n\n/**\n * The document that must carry the delegated listener for `el`. A template clone is owned by the\n * template's inert document (no window, never receives an event) until it is inserted, and handlers\n * are bound before that: use the page's document then, which is where the element will live.\n */\nfunction delegationDocument(el: Element): Document {\n const owner = el.ownerDocument;\n return owner !== null && owner.defaultView !== null ? owner : globalThis.document;\n}\n\n/**\n * Binds one handler and returns the function that undoes it. A delegated event is stored on the\n * element as an expando; the document listener picks it up. Other events get a native listener.\n * Non-composed events (`change`, `select`, `load`, ...) never leave a shadow root, so they always get\n * a native listener, whatever the caller asked for.\n * @internal\n */\nexport function bindEvent(\n el: Element,\n name: string,\n handler: unknown,\n delegate: boolean,\n capture = false,\n): (() => void) | undefined {\n if (handler === null || handler === undefined || handler === false) return undefined;\n if (isListenerObject(handler)) return bindListenerObject(el, name, handler, capture);\n const binding = toBinding(handler);\n // One delegated slot per event name: a second handler for the same name on this element (React's\n // onInput and onChange on one text input) binds natively, so both run.\n const slot = `$$${name}`;\n // The delegated slot tells a tuple from a plain handler by its data being defined, so a tuple whose\n // data is undefined is bound natively, where it still receives `(undefined, event)`.\n const plain = !binding.tuple || binding.data !== undefined;\n if (\n delegate &&\n plain &&\n !capture &&\n DELEGATED_EVENTS.test(name) &&\n Reflect.get(el, slot) === undefined\n ) {\n delegateEvents([name], delegationDocument(el));\n const dataKey = `${slot}Data`;\n Reflect.set(el, slot, binding.fn);\n if (binding.tuple) Reflect.set(el, dataKey, binding.data);\n else Reflect.deleteProperty(el, dataKey);\n return () => {\n if (Reflect.get(el, slot) === binding.fn) {\n Reflect.deleteProperty(el, slot);\n Reflect.deleteProperty(el, dataKey);\n }\n };\n }\n const listener = (event: Event): void => {\n const args: unknown[] = binding.tuple ? [binding.data, event] : [event];\n batch(() => untrack(() => binding.fn.call(el, ...args)));\n };\n el.addEventListener(name, listener, capture);\n return () => {\n el.removeEventListener(name, listener, capture);\n };\n}\n\n/**\n * Binds an event handler to an element: the helper compiled templates call for `onX` and the `on:`\n * and `oncapture:` prefixes. Handlers run batched and untracked, with `this` set to the element.\n * Inside an owner, the listener is removed when the owner is disposed, even if the element outlives\n * it.\n *\n * @param el Target element.\n * @param name Event name, lowercase, such as `click`.\n * @param handler A function (called with the event), a `[fn, data]` tuple (called as\n * `fn(data, event)`), or a listener object `{ handleEvent, once, passive, capture, signal }`, which\n * is always bound natively with those options. `null`, `undefined` and `false` bind nothing.\n * @param delegate `true` stores the handler on the element for the document listener of\n * {@link delegateEvents} (installed on demand) when `name` is a delegated event (`click`, `input`,\n * `keydown`, pointer, mouse, touch and focus events, ...) and the element has no delegated handler\n * for it yet. Otherwise, and when undefined, the handler gets a native listener.\n * @param capture `true` listens in the capture phase, never delegated. Undefined means the bubble phase.\n * @throws TypeError `SHADOW_EVENT_HANDLER` when `handler` is not a function, a tuple whose first item\n * is a function, or a listener object.\n * @example\n * import { addEventListener } from \"@shadow-js/web\";\n *\n * const button = document.createElement(\"button\");\n * addEventListener(button, \"click\", () => console.log(\"pressed\"), true);\n * addEventListener(button, \"focus\", [(id: string, event: Event) => console.log(id, event.type), \"save\"]);\n * @see delegateEvents\n * @since 1.0.0\n */\nexport function addEventListener(\n el: Element,\n name: string,\n handler: unknown,\n delegate?: boolean,\n capture?: boolean,\n): void {\n const unbind = bindEvent(el, name, handler, delegate === true, capture === true);\n // The listener goes when the owner does, even if the element outlives it (moved, portaled, reused).\n if (unbind !== undefined && getOwner() !== null) onCleanup(unbind);\n}\n"],"mappings":"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"}
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
//#region src/head/components.d.ts
|
|
2
1
|
/**
|
|
3
2
|
* Props of {@link Title}.
|
|
4
3
|
* @since 1.0.0
|
|
@@ -133,5 +132,4 @@ export declare function Style(props: StyleProps): null;
|
|
|
133
132
|
* @since 1.0.0
|
|
134
133
|
*/
|
|
135
134
|
export declare function Base(props: HeadAttributeProps): null;
|
|
136
|
-
//#endregion
|
|
137
135
|
//# sourceMappingURL=components.d.ts.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { useHead } from "./use-head.js";
|
|
2
|
-
|
|
2
|
+
// src/head/components.ts
|
|
3
3
|
/** Text of a value that may be an accessor. Anything but text or an array of text throws. */
|
|
4
4
|
function partText(value) {
|
|
5
5
|
if (typeof value === "string") return value;
|
|
@@ -164,7 +164,6 @@ function Base(props) {
|
|
|
164
164
|
useHead(() => attributeTag("base", props, ["children"]));
|
|
165
165
|
return null;
|
|
166
166
|
}
|
|
167
|
-
//#endregion
|
|
168
167
|
export { Base, Link, Meta, Style, Title };
|
|
169
168
|
|
|
170
169
|
//# sourceMappingURL=components.js.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/head/registry.ts
|
|
2
2
|
const noop = () => void 0;
|
|
3
3
|
/**
|
|
4
4
|
* Creates an empty head registry. `onChange` runs after every effective add or removal, so the
|
|
@@ -62,7 +62,6 @@ function createHeadRegistry(onChange) {
|
|
|
62
62
|
}
|
|
63
63
|
};
|
|
64
64
|
}
|
|
65
|
-
//#endregion
|
|
66
65
|
export { createHeadRegistry };
|
|
67
66
|
|
|
68
67
|
//# sourceMappingURL=registry.js.map
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { NormalizedTag } from "./validate.js";
|
|
2
2
|
import { Context } from "@shadow-js/core";
|
|
3
|
-
//#region src/head/server-head.d.ts
|
|
4
3
|
/**
|
|
5
4
|
* The head of one server render: what `useHead`, `<Title>`, `<Meta>`, `<Link>`, `<Style>` and
|
|
6
5
|
* `<Base>` registered while the app rendered. Pass it to a render function through its `head`
|
|
@@ -50,5 +49,4 @@ export interface ServerHead {
|
|
|
50
49
|
* @since 1.0.0
|
|
51
50
|
*/
|
|
52
51
|
export declare function createServerHead(): ServerHead;
|
|
53
|
-
//#endregion
|
|
54
52
|
//# sourceMappingURL=server-head.d.ts.map
|
|
@@ -2,7 +2,7 @@ import { escapeHtml } from "../server/escape.js";
|
|
|
2
2
|
import { createHeadRegistry } from "./registry.js";
|
|
3
3
|
import { HEAD_KEY, HEAD_MARKER } from "./validate.js";
|
|
4
4
|
import { createContext } from "@shadow-js/core";
|
|
5
|
-
|
|
5
|
+
// src/head/server-head.ts
|
|
6
6
|
/** Elements that never have content or a closing tag. */
|
|
7
7
|
const VOID_TAGS = /* @__PURE__ */ new Set([
|
|
8
8
|
"meta",
|
|
@@ -70,7 +70,6 @@ function runWithServerHead(head, fn) {
|
|
|
70
70
|
});
|
|
71
71
|
return holder.value;
|
|
72
72
|
}
|
|
73
|
-
//#endregion
|
|
74
73
|
export { ServerHeadContext, createServerHead, runWithServerHead };
|
|
75
74
|
|
|
76
75
|
//# sourceMappingURL=server-head.js.map
|
package/dist/dev/head/sink.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { HEAD_KEY, HEAD_MARKER, identityOfElement } from "./validate.js";
|
|
2
|
-
|
|
2
|
+
// src/head/sink.ts
|
|
3
3
|
/** Removes or restores one element the sink owned. Elements already gone are ignored. */
|
|
4
4
|
function release(head, record) {
|
|
5
5
|
const el = record.el;
|
|
@@ -90,7 +90,6 @@ function createDomHeadSink(doc) {
|
|
|
90
90
|
}
|
|
91
91
|
};
|
|
92
92
|
}
|
|
93
|
-
//#endregion
|
|
94
93
|
export { createDomHeadSink };
|
|
95
94
|
|
|
96
95
|
//# sourceMappingURL=sink.js.map
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import { HeadInput } from "./validate.js";
|
|
2
|
-
//#region src/head/use-head.d.ts
|
|
3
2
|
/**
|
|
4
3
|
* Registers head tags for the lifetime of the current owner. Each registration joins the stack of
|
|
5
4
|
* its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,
|
|
@@ -31,5 +30,4 @@ import { HeadInput } from "./validate.js";
|
|
|
31
30
|
* @since 1.0.0
|
|
32
31
|
*/
|
|
33
32
|
export declare function useHead(input: HeadInput | (() => HeadInput)): void;
|
|
34
|
-
//#endregion
|
|
35
33
|
//# sourceMappingURL=use-head.d.ts.map
|
|
@@ -3,7 +3,7 @@ import { normalizeTags } from "./validate.js";
|
|
|
3
3
|
import { ServerHeadContext } from "./server-head.js";
|
|
4
4
|
import { createDomHeadSink } from "./sink.js";
|
|
5
5
|
import { createRoot, getOwner, isServer, untrack, useContext, useEffect, useRenderEffect, useSignal } from "@shadow-js/core";
|
|
6
|
-
|
|
6
|
+
// src/head/use-head.ts
|
|
7
7
|
/** One registry per document, shared by every `useHead` call on it. */
|
|
8
8
|
const registries = /* @__PURE__ */ new WeakMap();
|
|
9
9
|
/**
|
|
@@ -78,7 +78,6 @@ function useHead(input) {
|
|
|
78
78
|
const registry = registryFor(document);
|
|
79
79
|
useRenderEffect(() => normalizeTags(typeof input === "function" ? input() : input), (tags) => registry.add(tags));
|
|
80
80
|
}
|
|
81
|
-
//#endregion
|
|
82
81
|
export { useHead };
|
|
83
82
|
|
|
84
83
|
//# sourceMappingURL=use-head.js.map
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
//#region src/head/validate.d.ts
|
|
2
1
|
/**
|
|
3
2
|
* Head elements the registry manages. `script` and `noscript` are refused: a head-registered
|
|
4
3
|
* script would bypass CSP nonces and Trusted Types, so scripts come only from the asset pipeline.
|
|
@@ -81,5 +80,4 @@ export interface NormalizedTag {
|
|
|
81
80
|
* @since 1.0.0
|
|
82
81
|
*/
|
|
83
82
|
export declare function normalizeTags(input: unknown): NormalizedTag[];
|
|
84
|
-
//#endregion
|
|
85
83
|
//# sourceMappingURL=validate.d.ts.map
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { warnOnce } from "../internal/diagnostics.js";
|
|
2
2
|
import { isUnsafeUrlAttribute } from "../attributes.js";
|
|
3
|
-
|
|
3
|
+
// src/head/validate.ts
|
|
4
4
|
/** Marks every element the sink created or adopted. Callers may not supply it. @internal */
|
|
5
5
|
const HEAD_MARKER = "data-shadow-head";
|
|
6
6
|
/** Carries a style's key so a server-rendered style can be adopted. @internal */
|
|
@@ -262,7 +262,6 @@ function identityOfElement(element) {
|
|
|
262
262
|
}
|
|
263
263
|
return identityOf(name, lookup, element.getAttribute("data-shadow-key") ?? void 0);
|
|
264
264
|
}
|
|
265
|
-
//#endregion
|
|
266
265
|
export { HEAD_KEY, HEAD_MARKER, identityOf, identityOfElement, isHeadTagName, normalizeTag, normalizeTags };
|
|
267
266
|
|
|
268
267
|
//# sourceMappingURL=validate.js.map
|
package/dist/dev/hmr.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
//#region src/hmr.d.ts
|
|
2
1
|
/**
|
|
3
2
|
* The subset of Vite's `import.meta.hot` the runtime uses. The compiled output passes
|
|
4
3
|
* `import.meta.hot` to `registry`, so any object with these three members works (a test runner can
|
|
@@ -77,6 +76,5 @@ export declare function component<P>(reg: ModuleRegistry, name: string, implemen
|
|
|
77
76
|
* @internal
|
|
78
77
|
*/
|
|
79
78
|
export declare function accept(hot: HotContext | undefined, reg: ModuleRegistry): void;
|
|
80
|
-
//#endregion
|
|
81
79
|
export {};
|
|
82
80
|
//# sourceMappingURL=hmr.d.ts.map
|
package/dist/dev/hmr.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { hotModulesOf } from "./control-flow/hot-link.js";
|
|
2
2
|
import { batch, getOwner, untrack, useSignal } from "@shadow-js/core";
|
|
3
3
|
import { createComputation, readComputation } from "@shadow-js/core/extend";
|
|
4
|
-
|
|
4
|
+
// src/hmr.ts
|
|
5
5
|
const REGISTRY_KEY = "shadowjs:hmr-registry";
|
|
6
6
|
/**
|
|
7
7
|
* The components of one module, kept across hot updates. Instances are created through a stable
|
|
@@ -118,7 +118,6 @@ function accept(hot, reg) {
|
|
|
118
118
|
hot.accept();
|
|
119
119
|
reg.commit();
|
|
120
120
|
}
|
|
121
|
-
//#endregion
|
|
122
121
|
export { ModuleRegistry, accept, component, registry };
|
|
123
122
|
|
|
124
123
|
//# sourceMappingURL=hmr.js.map
|
package/dist/dev/hydration.d.ts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { RootErrorOptions } from "./control-flow/root-errors.js";
|
|
2
2
|
import { Owner } from "@shadow-js/core";
|
|
3
|
-
//#region src/hydration.d.ts
|
|
4
3
|
/**
|
|
5
4
|
* Options of {@link hydrate}: the server render it continues, the root's owner, and the error
|
|
6
5
|
* reporters it inherits from `RootErrorOptions` (`onUncaughtError`, `onCaughtError`,
|
|
@@ -57,5 +56,4 @@ export interface HydrateOptions extends RootErrorOptions {
|
|
|
57
56
|
* @since 1.0.0
|
|
58
57
|
*/
|
|
59
58
|
export declare function hydrate(code: () => unknown, container: Element | Document, options?: HydrateOptions): () => void;
|
|
60
|
-
//#endregion
|
|
61
59
|
//# sourceMappingURL=hydration.d.ts.map
|
package/dist/dev/hydration.js
CHANGED
|
@@ -6,7 +6,7 @@ import { attachRootErrors } from "./control-flow/root-errors.js";
|
|
|
6
6
|
import { replayEarlyEvents } from "./internal/early-events.js";
|
|
7
7
|
import { ResourceCacheContext, batch, createRoot, flushSync, runWithOwner, untrack } from "@shadow-js/core";
|
|
8
8
|
import { withHydration } from "@shadow-js/core/extend";
|
|
9
|
-
|
|
9
|
+
// src/hydration.ts
|
|
10
10
|
function dataCache(data) {
|
|
11
11
|
const used = /* @__PURE__ */ new Set();
|
|
12
12
|
return {
|
|
@@ -114,7 +114,6 @@ function hydrate(code, container, options = {}) {
|
|
|
114
114
|
removeRegion(region);
|
|
115
115
|
};
|
|
116
116
|
}
|
|
117
|
-
//#endregion
|
|
118
117
|
export { hydrate };
|
|
119
118
|
|
|
120
119
|
//# sourceMappingURL=hydration.js.map
|
package/dist/dev/insert.d.ts
CHANGED
|
@@ -1,14 +1,19 @@
|
|
|
1
|
-
|
|
1
|
+
import { Owner } from "@shadow-js/core/extend";
|
|
2
2
|
/**
|
|
3
3
|
* State of one dynamic child region. `nodes` are the DOM nodes the region owns, in order. When
|
|
4
4
|
* `anchor` is set, content goes before it. Without one, an empty region is placed after `marker`
|
|
5
|
-
* (the node that preceded it), so it keeps its position while it is empty.
|
|
5
|
+
* (the node that preceded it), so it keeps its position while it is empty. A marker can be a node
|
|
6
|
+
* another region owns and later replaces, so the region created right behind another one on the same parent
|
|
7
|
+
* gives that one an anchor of its own (see `linkRegion`): the marker of every region is then either static
|
|
8
|
+
* content or an anchor nobody replaces.
|
|
6
9
|
* @internal
|
|
7
10
|
*/
|
|
8
11
|
export interface Region {
|
|
9
12
|
readonly parent: Node;
|
|
10
|
-
|
|
13
|
+
anchor: Node | null;
|
|
11
14
|
marker: Node | null;
|
|
15
|
+
/** The owner of the effect that keeps a reactive region up to date; unset until then (and for a static region). */
|
|
16
|
+
owner?: Owner | null;
|
|
12
17
|
nodes: Node[];
|
|
13
18
|
/**
|
|
14
19
|
* Text nodes this region created or adopted; only these may be reused by string updates. Null for none, the node
|
|
@@ -30,10 +35,11 @@ export declare function createRegion(parent: Node, anchorNode: Node | null, init
|
|
|
30
35
|
/**
|
|
31
36
|
* Keeps a region in sync with `value`. A value that is or contains a function (an accessor, or an
|
|
32
37
|
* array with accessor members) runs inside a render effect, so its reads are tracked. Anything
|
|
33
|
-
* else is inserted once.
|
|
38
|
+
* else is inserted once. `ordered` is for `insert()` without an anchor: a region that keeps changing then keeps
|
|
39
|
+
* its place among the other such regions of its parent (see `linkRegion`).
|
|
34
40
|
* @internal
|
|
35
41
|
*/
|
|
36
|
-
export declare function bindRegion(region: Region, value: unknown): unknown;
|
|
42
|
+
export declare function bindRegion(region: Region, value: unknown, ordered?: boolean): unknown;
|
|
37
43
|
/**
|
|
38
44
|
* Removes a region's nodes from its parent. Anchors and nodes that were moved elsewhere are not
|
|
39
45
|
* touched.
|
|
@@ -64,7 +70,10 @@ export declare function anchor(parent: Node, before: Node | null): Text;
|
|
|
64
70
|
* - `null`, `undefined`, booleans render nothing. Strings and numbers become one Text node, reused
|
|
65
71
|
* when the region already holds one. A Node is inserted itself. A DocumentFragment inserts a
|
|
66
72
|
* snapshot of its children. Arrays are flattened, nested arrays included.
|
|
67
|
-
* - Content goes before `anchorNode`, or at the end when it is null or omitted.
|
|
73
|
+
* - Content goes before `anchorNode`, or at the end when it is null or omitted. Regions without an
|
|
74
|
+
* anchor on one parent keep the order of the calls, whatever they show and however often a sibling
|
|
75
|
+
* region replaces its nodes: when a reactive region is created right where the previous one ends, the
|
|
76
|
+
* previous one gets an empty Text node as its anchor there (removed again when that region is disposed).
|
|
68
77
|
* - Arrays are reconciled in place: nodes that remain are never removed and re-added.
|
|
69
78
|
* - `initial` lists nodes already in the DOM (from hydration or splitText) so nothing is recreated.
|
|
70
79
|
* - During `hydrate()`, a region that adopted server text is compared with its first commit: in
|
|
@@ -93,5 +102,4 @@ export declare function anchor(parent: Node, before: Node | null): Text;
|
|
|
93
102
|
* @since 1.0.0
|
|
94
103
|
*/
|
|
95
104
|
export declare function insert(parent: Node, value: unknown, anchorNode?: Node | null, initial?: unknown): unknown;
|
|
96
|
-
//#endregion
|
|
97
105
|
//# sourceMappingURL=insert.d.ts.map
|