@shadow-js/web 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +18 -0
- package/LICENSE +21 -0
- package/README.md +190 -2
- package/dist/dev/attributes.d.ts +88 -0
- package/dist/dev/attributes.js +195 -0
- package/dist/dev/attributes.js.map +1 -0
- package/dist/dev/autofocus.d.ts +30 -0
- package/dist/dev/autofocus.js +44 -0
- package/dist/dev/autofocus.js.map +1 -0
- package/dist/dev/class-style.d.ts +87 -0
- package/dist/dev/class-style.js +196 -0
- package/dist/dev/class-style.js.map +1 -0
- package/dist/dev/component.d.ts +21 -0
- package/dist/dev/component.js +41 -0
- package/dist/dev/component.js.map +1 -0
- package/dist/dev/control-flow/activity.d.ts +56 -0
- package/dist/dev/control-flow/activity.js +135 -0
- package/dist/dev/control-flow/activity.js.map +1 -0
- package/dist/dev/control-flow/branch.js +103 -0
- package/dist/dev/control-flow/branch.js.map +1 -0
- package/dist/dev/control-flow/client-only.d.ts +46 -0
- package/dist/dev/control-flow/client-only.js +49 -0
- package/dist/dev/control-flow/client-only.js.map +1 -0
- package/dist/dev/control-flow/dynamic.d.ts +80 -0
- package/dist/dev/control-flow/dynamic.js +133 -0
- package/dist/dev/control-flow/dynamic.js.map +1 -0
- package/dist/dev/control-flow/error-boundary.d.ts +70 -0
- package/dist/dev/control-flow/error-boundary.js +114 -0
- package/dist/dev/control-flow/error-boundary.js.map +1 -0
- package/dist/dev/control-flow/for.d.ts +78 -0
- package/dist/dev/control-flow/for.js +22 -0
- package/dist/dev/control-flow/for.js.map +1 -0
- package/dist/dev/control-flow/fragment.d.ts +36 -0
- package/dist/dev/control-flow/fragment.js +30 -0
- package/dist/dev/control-flow/fragment.js.map +1 -0
- package/dist/dev/control-flow/hot-link.js +63 -0
- package/dist/dev/control-flow/hot-link.js.map +1 -0
- package/dist/dev/control-flow/index-list.d.ts +46 -0
- package/dist/dev/control-flow/index-list.js +30 -0
- package/dist/dev/control-flow/index-list.js.map +1 -0
- package/dist/dev/control-flow/index.d.ts +15 -0
- package/dist/dev/control-flow/lazy.d.ts +56 -0
- package/dist/dev/control-flow/lazy.js +63 -0
- package/dist/dev/control-flow/lazy.js.map +1 -0
- package/dist/dev/control-flow/no-hydration.d.ts +37 -0
- package/dist/dev/control-flow/no-hydration.js +57 -0
- package/dist/dev/control-flow/no-hydration.js.map +1 -0
- package/dist/dev/control-flow/portal.d.ts +67 -0
- package/dist/dev/control-flow/portal.js +133 -0
- package/dist/dev/control-flow/portal.js.map +1 -0
- package/dist/dev/control-flow/root-errors.d.ts +23 -0
- package/dist/dev/control-flow/root-errors.js +32 -0
- package/dist/dev/control-flow/root-errors.js.map +1 -0
- package/dist/dev/control-flow/show.d.ts +99 -0
- package/dist/dev/control-flow/show.js +17 -0
- package/dist/dev/control-flow/show.js.map +1 -0
- package/dist/dev/control-flow/suspense-list.d.ts +63 -0
- package/dist/dev/control-flow/suspense-list.js +104 -0
- package/dist/dev/control-flow/suspense-list.js.map +1 -0
- package/dist/dev/control-flow/suspense.d.ts +51 -0
- package/dist/dev/control-flow/suspense.js +101 -0
- package/dist/dev/control-flow/suspense.js.map +1 -0
- package/dist/dev/control-flow/switch.d.ts +83 -0
- package/dist/dev/control-flow/switch.js +89 -0
- package/dist/dev/control-flow/switch.js.map +1 -0
- package/dist/dev/derived.d.ts +50 -0
- package/dist/dev/derived.js +33 -0
- package/dist/dev/derived.js.map +1 -0
- package/dist/dev/element.d.ts +38 -0
- package/dist/dev/element.js +104 -0
- package/dist/dev/element.js.map +1 -0
- package/dist/dev/events.d.ts +85 -0
- package/dist/dev/events.js +264 -0
- package/dist/dev/events.js.map +1 -0
- package/dist/dev/extend.d.ts +12 -0
- package/dist/dev/extend.js +12 -0
- package/dist/dev/head/components.d.ts +135 -0
- package/dist/dev/head/components.js +169 -0
- package/dist/dev/head/components.js.map +1 -0
- package/dist/dev/head/registry.js +67 -0
- package/dist/dev/head/registry.js.map +1 -0
- package/dist/dev/head/server-head.d.ts +52 -0
- package/dist/dev/head/server-head.js +75 -0
- package/dist/dev/head/server-head.js.map +1 -0
- package/dist/dev/head/sink.js +95 -0
- package/dist/dev/head/sink.js.map +1 -0
- package/dist/dev/head/use-head.d.ts +33 -0
- package/dist/dev/head/use-head.js +83 -0
- package/dist/dev/head/use-head.js.map +1 -0
- package/dist/dev/head/validate.d.ts +83 -0
- package/dist/dev/head/validate.js +267 -0
- package/dist/dev/head/validate.js.map +1 -0
- package/dist/dev/hmr.d.ts +80 -0
- package/dist/dev/hmr.js +123 -0
- package/dist/dev/hmr.js.map +1 -0
- package/dist/dev/hydration.d.ts +59 -0
- package/dist/dev/hydration.js +119 -0
- package/dist/dev/hydration.js.map +1 -0
- package/dist/dev/index.d.ts +45 -0
- package/dist/dev/index.js +34 -0
- package/dist/dev/insert.d.ts +95 -0
- package/dist/dev/insert.js +356 -0
- package/dist/dev/insert.js.map +1 -0
- package/dist/dev/internal/claim.d.ts +104 -0
- package/dist/dev/internal/claim.js +356 -0
- package/dist/dev/internal/claim.js.map +1 -0
- package/dist/dev/internal/css-units.js +25 -0
- package/dist/dev/internal/css-units.js.map +1 -0
- package/dist/dev/internal/diagnostics.d.ts +28 -0
- package/dist/dev/internal/diagnostics.js +37 -0
- package/dist/dev/internal/diagnostics.js.map +1 -0
- package/dist/dev/internal/early-events.js +75 -0
- package/dist/dev/internal/early-events.js.map +1 -0
- package/dist/dev/internal/hydration-hooks.d.ts +41 -0
- package/dist/dev/internal/hydration-hooks.js +26 -0
- package/dist/dev/internal/hydration-hooks.js.map +1 -0
- package/dist/dev/internal/hydration-scope.d.ts +129 -0
- package/dist/dev/internal/hydration-scope.js +155 -0
- package/dist/dev/internal/hydration-scope.js.map +1 -0
- package/dist/dev/internal/names.d.ts +31 -0
- package/dist/dev/internal/names.js +34 -0
- package/dist/dev/internal/names.js.map +1 -0
- package/dist/dev/internal/portal-context.d.ts +37 -0
- package/dist/dev/internal/portal-context.js +27 -0
- package/dist/dev/internal/portal-context.js.map +1 -0
- package/dist/dev/internal/react-names.js +115 -0
- package/dist/dev/internal/react-names.js.map +1 -0
- package/dist/dev/internal/reconcile.d.ts +38 -0
- package/dist/dev/internal/reconcile.js +121 -0
- package/dist/dev/internal/reconcile.js.map +1 -0
- package/dist/dev/internal/stream-context.d.ts +45 -0
- package/dist/dev/internal/stream-context.js +22 -0
- package/dist/dev/internal/stream-context.js.map +1 -0
- package/dist/dev/jsx/aria.d.ts +70 -0
- package/dist/dev/jsx/component.d.ts +87 -0
- package/dist/dev/jsx/events.d.ts +362 -0
- package/dist/dev/jsx/global.d.ts +209 -0
- package/dist/dev/jsx/html.d.ts +877 -0
- package/dist/dev/jsx/intrinsic.d.ts +57 -0
- package/dist/dev/jsx/mathml.d.ts +184 -0
- package/dist/dev/jsx/svg.d.ts +605 -0
- package/dist/dev/jsx/types.d.ts +174 -0
- package/dist/dev/jsx-dev-runtime.d.ts +10 -0
- package/dist/dev/jsx-dev-runtime.js +0 -0
- package/dist/dev/jsx-runtime.d.ts +92 -0
- package/dist/dev/jsx-runtime.js +0 -0
- package/dist/dev/reactive.d.ts +108 -0
- package/dist/dev/reactive.js +84 -0
- package/dist/dev/reactive.js.map +1 -0
- package/dist/dev/render.d.ts +34 -0
- package/dist/dev/render.js +51 -0
- package/dist/dev/render.js.map +1 -0
- package/dist/dev/resource-hints.d.ts +143 -0
- package/dist/dev/resource-hints.js +199 -0
- package/dist/dev/resource-hints.js.map +1 -0
- package/dist/dev/select-value.d.ts +22 -0
- package/dist/dev/select-value.js +50 -0
- package/dist/dev/select-value.js.map +1 -0
- package/dist/dev/server/attributes.d.ts +31 -0
- package/dist/dev/server/attributes.js +154 -0
- package/dist/dev/server/attributes.js.map +1 -0
- package/dist/dev/server/class-style.d.ts +44 -0
- package/dist/dev/server/class-style.js +172 -0
- package/dist/dev/server/class-style.js.map +1 -0
- package/dist/dev/server/component.d.ts +40 -0
- package/dist/dev/server/component.js +71 -0
- package/dist/dev/server/component.js.map +1 -0
- package/dist/dev/server/derived.d.ts +39 -0
- package/dist/dev/server/derived.js +25 -0
- package/dist/dev/server/derived.js.map +1 -0
- package/dist/dev/server/element.d.ts +87 -0
- package/dist/dev/server/element.js +215 -0
- package/dist/dev/server/element.js.map +1 -0
- package/dist/dev/server/errors.js +25 -0
- package/dist/dev/server/errors.js.map +1 -0
- package/dist/dev/server/escape.d.ts +28 -0
- package/dist/dev/server/escape.js +118 -0
- package/dist/dev/server/escape.js.map +1 -0
- package/dist/dev/server/form-controls.d.ts +48 -0
- package/dist/dev/server/form-controls.js +192 -0
- package/dist/dev/server/form-controls.js.map +1 -0
- package/dist/dev/server/hydration-script.d.ts +63 -0
- package/dist/dev/server/hydration-script.js +58 -0
- package/dist/dev/server/hydration-script.js.map +1 -0
- package/dist/dev/server/index.d.ts +16 -0
- package/dist/dev/server/index.js +16 -0
- package/dist/dev/server/node.d.ts +11 -0
- package/dist/dev/server/node.js +20 -0
- package/dist/dev/server/node.js.map +1 -0
- package/dist/dev/server/portals.d.ts +44 -0
- package/dist/dev/server/portals.js +98 -0
- package/dist/dev/server/portals.js.map +1 -0
- package/dist/dev/server/render.d.ts +127 -0
- package/dist/dev/server/render.js +255 -0
- package/dist/dev/server/render.js.map +1 -0
- package/dist/dev/server/serialize.d.ts +43 -0
- package/dist/dev/server/serialize.js +314 -0
- package/dist/dev/server/serialize.js.map +1 -0
- package/dist/dev/server/stream.d.ts +92 -0
- package/dist/dev/server/stream.js +234 -0
- package/dist/dev/server/stream.js.map +1 -0
- package/dist/dev/server.d.ts +16 -0
- package/dist/dev/server.js +16 -0
- package/dist/dev/spread.d.ts +47 -0
- package/dist/dev/spread.js +295 -0
- package/dist/dev/spread.js.map +1 -0
- package/dist/dev/template.d.ts +24 -0
- package/dist/dev/template.js +119 -0
- package/dist/dev/template.js.map +1 -0
- package/dist/dev/view-transition.d.ts +95 -0
- package/dist/dev/view-transition.js +120 -0
- package/dist/dev/view-transition.js.map +1 -0
- package/dist/prod/attributes.js +2 -0
- package/dist/prod/attributes.js.map +1 -0
- package/dist/prod/autofocus.js +2 -0
- package/dist/prod/autofocus.js.map +1 -0
- package/dist/prod/class-style.js +2 -0
- package/dist/prod/class-style.js.map +1 -0
- package/dist/prod/component.js +2 -0
- package/dist/prod/component.js.map +1 -0
- package/dist/prod/control-flow/activity.js +2 -0
- package/dist/prod/control-flow/activity.js.map +1 -0
- package/dist/prod/control-flow/branch.js +2 -0
- package/dist/prod/control-flow/branch.js.map +1 -0
- package/dist/prod/control-flow/client-only.js +2 -0
- package/dist/prod/control-flow/client-only.js.map +1 -0
- package/dist/prod/control-flow/dynamic.js +2 -0
- package/dist/prod/control-flow/dynamic.js.map +1 -0
- package/dist/prod/control-flow/error-boundary.js +2 -0
- package/dist/prod/control-flow/error-boundary.js.map +1 -0
- package/dist/prod/control-flow/for.js +2 -0
- package/dist/prod/control-flow/for.js.map +1 -0
- package/dist/prod/control-flow/fragment.js +2 -0
- package/dist/prod/control-flow/fragment.js.map +1 -0
- package/dist/prod/control-flow/hot-link.js +2 -0
- package/dist/prod/control-flow/hot-link.js.map +1 -0
- package/dist/prod/control-flow/index-list.js +2 -0
- package/dist/prod/control-flow/index-list.js.map +1 -0
- package/dist/prod/control-flow/lazy.js +2 -0
- package/dist/prod/control-flow/lazy.js.map +1 -0
- package/dist/prod/control-flow/no-hydration.js +2 -0
- package/dist/prod/control-flow/no-hydration.js.map +1 -0
- package/dist/prod/control-flow/portal.js +2 -0
- package/dist/prod/control-flow/portal.js.map +1 -0
- package/dist/prod/control-flow/root-errors.js +2 -0
- package/dist/prod/control-flow/root-errors.js.map +1 -0
- package/dist/prod/control-flow/show.js +2 -0
- package/dist/prod/control-flow/show.js.map +1 -0
- package/dist/prod/control-flow/suspense-list.js +2 -0
- package/dist/prod/control-flow/suspense-list.js.map +1 -0
- package/dist/prod/control-flow/suspense.js +2 -0
- package/dist/prod/control-flow/suspense.js.map +1 -0
- package/dist/prod/control-flow/switch.js +2 -0
- package/dist/prod/control-flow/switch.js.map +1 -0
- package/dist/prod/derived.js +2 -0
- package/dist/prod/derived.js.map +1 -0
- package/dist/prod/element.js +2 -0
- package/dist/prod/element.js.map +1 -0
- package/dist/prod/events.js +2 -0
- package/dist/prod/events.js.map +1 -0
- package/dist/prod/extend.js +1 -0
- package/dist/prod/head/components.js +2 -0
- package/dist/prod/head/components.js.map +1 -0
- package/dist/prod/head/registry.js +2 -0
- package/dist/prod/head/registry.js.map +1 -0
- package/dist/prod/head/server-head.js +2 -0
- package/dist/prod/head/server-head.js.map +1 -0
- package/dist/prod/head/sink.js +2 -0
- package/dist/prod/head/sink.js.map +1 -0
- package/dist/prod/head/use-head.js +2 -0
- package/dist/prod/head/use-head.js.map +1 -0
- package/dist/prod/head/validate.js +2 -0
- package/dist/prod/head/validate.js.map +1 -0
- package/dist/prod/hmr.js +2 -0
- package/dist/prod/hmr.js.map +1 -0
- package/dist/prod/hydration.js +2 -0
- package/dist/prod/hydration.js.map +1 -0
- package/dist/prod/index.js +1 -0
- package/dist/prod/insert.js +2 -0
- package/dist/prod/insert.js.map +1 -0
- package/dist/prod/internal/claim.js +2 -0
- package/dist/prod/internal/claim.js.map +1 -0
- package/dist/prod/internal/css-units.js +2 -0
- package/dist/prod/internal/css-units.js.map +1 -0
- package/dist/prod/internal/diagnostics.js +2 -0
- package/dist/prod/internal/diagnostics.js.map +1 -0
- package/dist/prod/internal/early-events.js +2 -0
- package/dist/prod/internal/early-events.js.map +1 -0
- package/dist/prod/internal/hydration-hooks.js +2 -0
- package/dist/prod/internal/hydration-hooks.js.map +1 -0
- package/dist/prod/internal/hydration-scope.js +2 -0
- package/dist/prod/internal/hydration-scope.js.map +1 -0
- package/dist/prod/internal/names.js +2 -0
- package/dist/prod/internal/names.js.map +1 -0
- package/dist/prod/internal/portal-context.js +2 -0
- package/dist/prod/internal/portal-context.js.map +1 -0
- package/dist/prod/internal/react-names.js +2 -0
- package/dist/prod/internal/react-names.js.map +1 -0
- package/dist/prod/internal/reconcile.js +2 -0
- package/dist/prod/internal/reconcile.js.map +1 -0
- package/dist/prod/internal/stream-context.js +2 -0
- package/dist/prod/internal/stream-context.js.map +1 -0
- package/dist/prod/jsx-dev-runtime.js +0 -0
- package/dist/prod/jsx-runtime.js +0 -0
- package/dist/prod/reactive.js +2 -0
- package/dist/prod/reactive.js.map +1 -0
- package/dist/prod/render.js +2 -0
- package/dist/prod/render.js.map +1 -0
- package/dist/prod/resource-hints.js +2 -0
- package/dist/prod/resource-hints.js.map +1 -0
- package/dist/prod/select-value.js +2 -0
- package/dist/prod/select-value.js.map +1 -0
- package/dist/prod/server/attributes.js +2 -0
- package/dist/prod/server/attributes.js.map +1 -0
- package/dist/prod/server/class-style.js +2 -0
- package/dist/prod/server/class-style.js.map +1 -0
- package/dist/prod/server/component.js +2 -0
- package/dist/prod/server/component.js.map +1 -0
- package/dist/prod/server/derived.js +2 -0
- package/dist/prod/server/derived.js.map +1 -0
- package/dist/prod/server/element.js +2 -0
- package/dist/prod/server/element.js.map +1 -0
- package/dist/prod/server/errors.js +2 -0
- package/dist/prod/server/errors.js.map +1 -0
- package/dist/prod/server/escape.js +2 -0
- package/dist/prod/server/escape.js.map +1 -0
- package/dist/prod/server/form-controls.js +3 -0
- package/dist/prod/server/form-controls.js.map +1 -0
- package/dist/prod/server/hydration-script.js +2 -0
- package/dist/prod/server/hydration-script.js.map +1 -0
- package/dist/prod/server/index.js +1 -0
- package/dist/prod/server/node.js +2 -0
- package/dist/prod/server/node.js.map +1 -0
- package/dist/prod/server/portals.js +2 -0
- package/dist/prod/server/portals.js.map +1 -0
- package/dist/prod/server/render.js +2 -0
- package/dist/prod/server/render.js.map +1 -0
- package/dist/prod/server/serialize.js +2 -0
- package/dist/prod/server/serialize.js.map +1 -0
- package/dist/prod/server/stream.js +2 -0
- package/dist/prod/server/stream.js.map +1 -0
- package/dist/prod/server.js +1 -0
- package/dist/prod/spread.js +2 -0
- package/dist/prod/spread.js.map +1 -0
- package/dist/prod/template.js +2 -0
- package/dist/prod/template.js.map +1 -0
- package/dist/prod/view-transition.js +2 -0
- package/dist/prod/view-transition.js.map +1 -0
- package/dist/server/attributes.js +2 -0
- package/dist/server/attributes.js.map +1 -0
- package/dist/server/autofocus.js +2 -0
- package/dist/server/autofocus.js.map +1 -0
- package/dist/server/class-style.js +2 -0
- package/dist/server/class-style.js.map +1 -0
- package/dist/server/component.js +2 -0
- package/dist/server/component.js.map +1 -0
- package/dist/server/control-flow/activity.js +2 -0
- package/dist/server/control-flow/activity.js.map +1 -0
- package/dist/server/control-flow/branch.js +2 -0
- package/dist/server/control-flow/branch.js.map +1 -0
- package/dist/server/control-flow/client-only.js +2 -0
- package/dist/server/control-flow/client-only.js.map +1 -0
- package/dist/server/control-flow/dynamic.js +2 -0
- package/dist/server/control-flow/dynamic.js.map +1 -0
- package/dist/server/control-flow/error-boundary.js +2 -0
- package/dist/server/control-flow/error-boundary.js.map +1 -0
- package/dist/server/control-flow/for.js +2 -0
- package/dist/server/control-flow/for.js.map +1 -0
- package/dist/server/control-flow/fragment.js +2 -0
- package/dist/server/control-flow/fragment.js.map +1 -0
- package/dist/server/control-flow/index-list.js +2 -0
- package/dist/server/control-flow/index-list.js.map +1 -0
- package/dist/server/control-flow/lazy.js +2 -0
- package/dist/server/control-flow/lazy.js.map +1 -0
- package/dist/server/control-flow/no-hydration.js +2 -0
- package/dist/server/control-flow/no-hydration.js.map +1 -0
- package/dist/server/control-flow/portal.js +2 -0
- package/dist/server/control-flow/portal.js.map +1 -0
- package/dist/server/control-flow/root-errors.js +2 -0
- package/dist/server/control-flow/root-errors.js.map +1 -0
- package/dist/server/control-flow/show.js +2 -0
- package/dist/server/control-flow/show.js.map +1 -0
- package/dist/server/control-flow/suspense-list.js +2 -0
- package/dist/server/control-flow/suspense-list.js.map +1 -0
- package/dist/server/control-flow/suspense.js +2 -0
- package/dist/server/control-flow/suspense.js.map +1 -0
- package/dist/server/control-flow/switch.js +2 -0
- package/dist/server/control-flow/switch.js.map +1 -0
- package/dist/server/derived.js +2 -0
- package/dist/server/derived.js.map +1 -0
- package/dist/server/element.js +2 -0
- package/dist/server/element.js.map +1 -0
- package/dist/server/events.js +2 -0
- package/dist/server/events.js.map +1 -0
- package/dist/server/extend.js +1 -0
- package/dist/server/head/components.js +2 -0
- package/dist/server/head/components.js.map +1 -0
- package/dist/server/head/registry.js +2 -0
- package/dist/server/head/registry.js.map +1 -0
- package/dist/server/head/server-head.js +2 -0
- package/dist/server/head/server-head.js.map +1 -0
- package/dist/server/head/sink.js +2 -0
- package/dist/server/head/sink.js.map +1 -0
- package/dist/server/head/use-head.js +2 -0
- package/dist/server/head/use-head.js.map +1 -0
- package/dist/server/head/validate.js +2 -0
- package/dist/server/head/validate.js.map +1 -0
- package/dist/server/hydration.js +2 -0
- package/dist/server/hydration.js.map +1 -0
- package/dist/server/index.js +1 -0
- package/dist/server/insert.js +2 -0
- package/dist/server/insert.js.map +1 -0
- package/dist/server/internal/claim.js +2 -0
- package/dist/server/internal/claim.js.map +1 -0
- package/dist/server/internal/css-units.js +2 -0
- package/dist/server/internal/css-units.js.map +1 -0
- package/dist/server/internal/diagnostics.js +2 -0
- package/dist/server/internal/diagnostics.js.map +1 -0
- package/dist/server/internal/early-events.js +2 -0
- package/dist/server/internal/early-events.js.map +1 -0
- package/dist/server/internal/hydration-hooks.js +2 -0
- package/dist/server/internal/hydration-hooks.js.map +1 -0
- package/dist/server/internal/hydration-scope.js +2 -0
- package/dist/server/internal/hydration-scope.js.map +1 -0
- package/dist/server/internal/names.js +2 -0
- package/dist/server/internal/names.js.map +1 -0
- package/dist/server/internal/portal-context.js +2 -0
- package/dist/server/internal/portal-context.js.map +1 -0
- package/dist/server/internal/react-names.js +2 -0
- package/dist/server/internal/react-names.js.map +1 -0
- package/dist/server/internal/reconcile.js +2 -0
- package/dist/server/internal/reconcile.js.map +1 -0
- package/dist/server/internal/stream-context.js +2 -0
- package/dist/server/internal/stream-context.js.map +1 -0
- package/dist/server/reactive.js +2 -0
- package/dist/server/reactive.js.map +1 -0
- package/dist/server/render.js +2 -0
- package/dist/server/render.js.map +1 -0
- package/dist/server/resource-hints.js +2 -0
- package/dist/server/resource-hints.js.map +1 -0
- package/dist/server/select-value.js +2 -0
- package/dist/server/select-value.js.map +1 -0
- package/dist/server/server/attributes.js +2 -0
- package/dist/server/server/attributes.js.map +1 -0
- package/dist/server/server/class-style.js +2 -0
- package/dist/server/server/class-style.js.map +1 -0
- package/dist/server/server/component.js +2 -0
- package/dist/server/server/component.js.map +1 -0
- package/dist/server/server/derived.js +2 -0
- package/dist/server/server/derived.js.map +1 -0
- package/dist/server/server/element.js +2 -0
- package/dist/server/server/element.js.map +1 -0
- package/dist/server/server/errors.js +2 -0
- package/dist/server/server/errors.js.map +1 -0
- package/dist/server/server/escape.js +2 -0
- package/dist/server/server/escape.js.map +1 -0
- package/dist/server/server/form-controls.js +3 -0
- package/dist/server/server/form-controls.js.map +1 -0
- package/dist/server/server/hydration-script.js +2 -0
- package/dist/server/server/hydration-script.js.map +1 -0
- package/dist/server/server/index.js +1 -0
- package/dist/server/server/node.js +2 -0
- package/dist/server/server/node.js.map +1 -0
- package/dist/server/server/portals.js +2 -0
- package/dist/server/server/portals.js.map +1 -0
- package/dist/server/server/render.js +2 -0
- package/dist/server/server/render.js.map +1 -0
- package/dist/server/server/serialize.js +2 -0
- package/dist/server/server/serialize.js.map +1 -0
- package/dist/server/server/stream.js +2 -0
- package/dist/server/server/stream.js.map +1 -0
- package/dist/server/server.js +1 -0
- package/dist/server/spread.js +2 -0
- package/dist/server/spread.js.map +1 -0
- package/dist/server/template.js +2 -0
- package/dist/server/template.js.map +1 -0
- package/dist/server/view-transition.js +2 -0
- package/dist/server/view-transition.js.map +1 -0
- package/dist/server-dev/attributes.js +195 -0
- package/dist/server-dev/attributes.js.map +1 -0
- package/dist/server-dev/autofocus.js +44 -0
- package/dist/server-dev/autofocus.js.map +1 -0
- package/dist/server-dev/class-style.js +196 -0
- package/dist/server-dev/class-style.js.map +1 -0
- package/dist/server-dev/component.js +41 -0
- package/dist/server-dev/component.js.map +1 -0
- package/dist/server-dev/control-flow/activity.js +40 -0
- package/dist/server-dev/control-flow/activity.js.map +1 -0
- package/dist/server-dev/control-flow/branch.js +103 -0
- package/dist/server-dev/control-flow/branch.js.map +1 -0
- package/dist/server-dev/control-flow/client-only.js +49 -0
- package/dist/server-dev/control-flow/client-only.js.map +1 -0
- package/dist/server-dev/control-flow/dynamic.js +105 -0
- package/dist/server-dev/control-flow/dynamic.js.map +1 -0
- package/dist/server-dev/control-flow/error-boundary.js +114 -0
- package/dist/server-dev/control-flow/error-boundary.js.map +1 -0
- package/dist/server-dev/control-flow/for.js +22 -0
- package/dist/server-dev/control-flow/for.js.map +1 -0
- package/dist/server-dev/control-flow/fragment.js +30 -0
- package/dist/server-dev/control-flow/fragment.js.map +1 -0
- package/dist/server-dev/control-flow/hot-link.js +56 -0
- package/dist/server-dev/control-flow/hot-link.js.map +1 -0
- package/dist/server-dev/control-flow/index-list.js +30 -0
- package/dist/server-dev/control-flow/index-list.js.map +1 -0
- package/dist/server-dev/control-flow/lazy.js +63 -0
- package/dist/server-dev/control-flow/lazy.js.map +1 -0
- package/dist/server-dev/control-flow/no-hydration.js +39 -0
- package/dist/server-dev/control-flow/no-hydration.js.map +1 -0
- package/dist/server-dev/control-flow/portal.js +133 -0
- package/dist/server-dev/control-flow/portal.js.map +1 -0
- package/dist/server-dev/control-flow/root-errors.js +32 -0
- package/dist/server-dev/control-flow/root-errors.js.map +1 -0
- package/dist/server-dev/control-flow/show.js +17 -0
- package/dist/server-dev/control-flow/show.js.map +1 -0
- package/dist/server-dev/control-flow/suspense-list.js +99 -0
- package/dist/server-dev/control-flow/suspense-list.js.map +1 -0
- package/dist/server-dev/control-flow/suspense.js +118 -0
- package/dist/server-dev/control-flow/suspense.js.map +1 -0
- package/dist/server-dev/control-flow/switch.js +89 -0
- package/dist/server-dev/control-flow/switch.js.map +1 -0
- package/dist/server-dev/derived.js +33 -0
- package/dist/server-dev/derived.js.map +1 -0
- package/dist/server-dev/element.js +65 -0
- package/dist/server-dev/element.js.map +1 -0
- package/dist/server-dev/events.js +264 -0
- package/dist/server-dev/events.js.map +1 -0
- package/dist/server-dev/extend.js +12 -0
- package/dist/server-dev/head/components.js +169 -0
- package/dist/server-dev/head/components.js.map +1 -0
- package/dist/server-dev/head/registry.js +67 -0
- package/dist/server-dev/head/registry.js.map +1 -0
- package/dist/server-dev/head/server-head.js +75 -0
- package/dist/server-dev/head/server-head.js.map +1 -0
- package/dist/server-dev/head/sink.js +95 -0
- package/dist/server-dev/head/sink.js.map +1 -0
- package/dist/server-dev/head/use-head.js +83 -0
- package/dist/server-dev/head/use-head.js.map +1 -0
- package/dist/server-dev/head/validate.js +267 -0
- package/dist/server-dev/head/validate.js.map +1 -0
- package/dist/server-dev/hydration.js +119 -0
- package/dist/server-dev/hydration.js.map +1 -0
- package/dist/server-dev/index.js +34 -0
- package/dist/server-dev/insert.js +356 -0
- package/dist/server-dev/insert.js.map +1 -0
- package/dist/server-dev/internal/claim.js +356 -0
- package/dist/server-dev/internal/claim.js.map +1 -0
- package/dist/server-dev/internal/css-units.js +25 -0
- package/dist/server-dev/internal/css-units.js.map +1 -0
- package/dist/server-dev/internal/diagnostics.js +37 -0
- package/dist/server-dev/internal/diagnostics.js.map +1 -0
- package/dist/server-dev/internal/early-events.js +75 -0
- package/dist/server-dev/internal/early-events.js.map +1 -0
- package/dist/server-dev/internal/hydration-hooks.js +26 -0
- package/dist/server-dev/internal/hydration-hooks.js.map +1 -0
- package/dist/server-dev/internal/hydration-scope.js +155 -0
- package/dist/server-dev/internal/hydration-scope.js.map +1 -0
- package/dist/server-dev/internal/names.js +34 -0
- package/dist/server-dev/internal/names.js.map +1 -0
- package/dist/server-dev/internal/portal-context.js +27 -0
- package/dist/server-dev/internal/portal-context.js.map +1 -0
- package/dist/server-dev/internal/react-names.js +115 -0
- package/dist/server-dev/internal/react-names.js.map +1 -0
- package/dist/server-dev/internal/reconcile.js +121 -0
- package/dist/server-dev/internal/reconcile.js.map +1 -0
- package/dist/server-dev/internal/stream-context.js +22 -0
- package/dist/server-dev/internal/stream-context.js.map +1 -0
- package/dist/server-dev/reactive.js +84 -0
- package/dist/server-dev/reactive.js.map +1 -0
- package/dist/server-dev/render.js +51 -0
- package/dist/server-dev/render.js.map +1 -0
- package/dist/server-dev/resource-hints.js +199 -0
- package/dist/server-dev/resource-hints.js.map +1 -0
- package/dist/server-dev/select-value.js +50 -0
- package/dist/server-dev/select-value.js.map +1 -0
- package/dist/server-dev/server/attributes.js +154 -0
- package/dist/server-dev/server/attributes.js.map +1 -0
- package/dist/server-dev/server/class-style.js +172 -0
- package/dist/server-dev/server/class-style.js.map +1 -0
- package/dist/server-dev/server/component.js +71 -0
- package/dist/server-dev/server/component.js.map +1 -0
- package/dist/server-dev/server/derived.js +25 -0
- package/dist/server-dev/server/derived.js.map +1 -0
- package/dist/server-dev/server/element.js +215 -0
- package/dist/server-dev/server/element.js.map +1 -0
- package/dist/server-dev/server/errors.js +25 -0
- package/dist/server-dev/server/errors.js.map +1 -0
- package/dist/server-dev/server/escape.js +118 -0
- package/dist/server-dev/server/escape.js.map +1 -0
- package/dist/server-dev/server/form-controls.js +192 -0
- package/dist/server-dev/server/form-controls.js.map +1 -0
- package/dist/server-dev/server/hydration-script.js +58 -0
- package/dist/server-dev/server/hydration-script.js.map +1 -0
- package/dist/server-dev/server/index.js +16 -0
- package/dist/server-dev/server/node.js +20 -0
- package/dist/server-dev/server/node.js.map +1 -0
- package/dist/server-dev/server/portals.js +98 -0
- package/dist/server-dev/server/portals.js.map +1 -0
- package/dist/server-dev/server/render.js +255 -0
- package/dist/server-dev/server/render.js.map +1 -0
- package/dist/server-dev/server/serialize.js +314 -0
- package/dist/server-dev/server/serialize.js.map +1 -0
- package/dist/server-dev/server/stream.js +234 -0
- package/dist/server-dev/server/stream.js.map +1 -0
- package/dist/server-dev/server.js +16 -0
- package/dist/server-dev/spread.js +295 -0
- package/dist/server-dev/spread.js.map +1 -0
- package/dist/server-dev/template.js +119 -0
- package/dist/server-dev/template.js.map +1 -0
- package/dist/server-dev/view-transition.js +89 -0
- package/dist/server-dev/view-transition.js.map +1 -0
- package/package.json +136 -4
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
import { batch, getOwner, onCleanup, untrack } from "@shadow-js/core";
|
|
2
|
+
// src/events.ts
|
|
3
|
+
/**
|
|
4
|
+
* Events that may be delegated: composed events, which leave a shadow root and reach the document.
|
|
5
|
+
* `change` is not composed, so it is bound on its element (see the note on `bindEvent`).
|
|
6
|
+
*/
|
|
7
|
+
const DELEGATED_EVENTS = /* @__PURE__ */ new Set([
|
|
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
|
+
]);
|
|
32
|
+
/** Documents that already carry the delegated listener for a given event name. */
|
|
33
|
+
const installed = /* @__PURE__ */ new WeakMap();
|
|
34
|
+
/** Calls `fn` with `this` = node, retargeting `currentTarget` for the duration of the call. */
|
|
35
|
+
function invoke(binding, node, event, args) {
|
|
36
|
+
Object.defineProperty(event, "currentTarget", {
|
|
37
|
+
configurable: true,
|
|
38
|
+
get: () => node
|
|
39
|
+
});
|
|
40
|
+
try {
|
|
41
|
+
untrack(() => binding.fn.call(node, ...args));
|
|
42
|
+
} finally {
|
|
43
|
+
Reflect.deleteProperty(event, "currentTarget");
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
/** Reads a compiler-style expando (`node.$$click`), if present. */
|
|
47
|
+
function expando(node, key) {
|
|
48
|
+
return Reflect.get(node, key);
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* The one listener per (document, event). It walks `composedPath()` from the target outward,
|
|
52
|
+
* calling `node.$$<type>` with `this = node`. Stops when a handler stops propagation.
|
|
53
|
+
*/
|
|
54
|
+
function dispatchDelegated(event) {
|
|
55
|
+
batch(() => dispatchPath(event));
|
|
56
|
+
}
|
|
57
|
+
function dispatchPath(event) {
|
|
58
|
+
const key = `$$${event.type}`;
|
|
59
|
+
const dataKey = `${key}Data`;
|
|
60
|
+
const errors = [];
|
|
61
|
+
for (const node of event.composedPath()) {
|
|
62
|
+
if (event.cancelBubble) break;
|
|
63
|
+
const fn = expando(node, key);
|
|
64
|
+
if (typeof fn !== "function") continue;
|
|
65
|
+
const data = expando(node, dataKey);
|
|
66
|
+
const binding = {
|
|
67
|
+
fn,
|
|
68
|
+
data,
|
|
69
|
+
tuple: data !== void 0
|
|
70
|
+
};
|
|
71
|
+
try {
|
|
72
|
+
invoke(binding, node, event, binding.tuple ? [data, event] : [event]);
|
|
73
|
+
} catch (error) {
|
|
74
|
+
errors.push(error);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
const [first] = errors;
|
|
78
|
+
if (errors.length === 1) throw first;
|
|
79
|
+
if (errors.length > 1) throw new AggregateError(errors, "Several event handlers threw.");
|
|
80
|
+
}
|
|
81
|
+
function isListenerObject(handler) {
|
|
82
|
+
return typeof handler === "object" && handler !== null && typeof handler.handleEvent === "function";
|
|
83
|
+
}
|
|
84
|
+
/** Binds a listener object natively (never delegated), honoring its options. */
|
|
85
|
+
function bindListenerObject(el, name, object, capture) {
|
|
86
|
+
const options = { capture: object.capture === true || capture };
|
|
87
|
+
if (object.once !== void 0) options.once = object.once;
|
|
88
|
+
if (object.passive !== void 0) options.passive = object.passive;
|
|
89
|
+
if (object.signal !== void 0) options.signal = object.signal;
|
|
90
|
+
const listener = (event) => {
|
|
91
|
+
batch(() => untrack(() => object.handleEvent(event)));
|
|
92
|
+
};
|
|
93
|
+
el.addEventListener(name, listener, options);
|
|
94
|
+
return () => {
|
|
95
|
+
el.removeEventListener(name, listener, options);
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/** Normalizes a handler value into a binding; throws for values that are neither. */
|
|
99
|
+
function toBinding(handler) {
|
|
100
|
+
if (typeof handler === "function") return {
|
|
101
|
+
fn: handler,
|
|
102
|
+
data: void 0,
|
|
103
|
+
tuple: false
|
|
104
|
+
};
|
|
105
|
+
if (Array.isArray(handler) && typeof handler[0] === "function") return {
|
|
106
|
+
fn: handler[0],
|
|
107
|
+
data: handler[1],
|
|
108
|
+
tuple: true
|
|
109
|
+
};
|
|
110
|
+
throw new TypeError("addEventListener(): the handler must be a function, [function, data] or an object with handleEvent.");
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Combines several handlers for one event name on one element into one handler that calls them in
|
|
114
|
+
* order with the same event. The compiler uses it when an element has, for example, both `onInput`
|
|
115
|
+
* and a text input's `onChange`: the delegated slot holds one function.
|
|
116
|
+
*
|
|
117
|
+
* @param handlers The handlers, in source order. None gives a handler that does nothing.
|
|
118
|
+
* @returns A handler that calls each of them with the same `this` and event. An error thrown by one
|
|
119
|
+
* handler propagates and the later handlers do not run.
|
|
120
|
+
* @example
|
|
121
|
+
* import { addEventListener, chainEvents } from "@shadow-js/web";
|
|
122
|
+
*
|
|
123
|
+
* const input = document.createElement("input");
|
|
124
|
+
* const onInput = chainEvents(
|
|
125
|
+
* (event) => console.log("validate", event.type),
|
|
126
|
+
* (event) => console.log("save", event.type),
|
|
127
|
+
* );
|
|
128
|
+
* addEventListener(input, "input", onInput);
|
|
129
|
+
* @since 1.0.0
|
|
130
|
+
*/
|
|
131
|
+
function chainEvents(...handlers) {
|
|
132
|
+
return function chained(event) {
|
|
133
|
+
for (const handler of handlers) handler.call(this, event);
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* Installs the document listener that runs delegated handlers for each event name, once per
|
|
138
|
+
* document and name; repeated calls do nothing. Compiled modules call it for the events they
|
|
139
|
+
* delegate, so application code rarely needs it. The listener walks `composedPath()` from the target
|
|
140
|
+
* outward and runs each element's delegated handler in one batch, stopping when a handler stops
|
|
141
|
+
* propagation. A non-composed event raised inside a shadow root never reaches the document, so bind
|
|
142
|
+
* such events natively.
|
|
143
|
+
*
|
|
144
|
+
* @param names Event names to delegate, such as `["click", "input"]`.
|
|
145
|
+
* @param target Document that receives the listeners. Default: the global `document`.
|
|
146
|
+
* @example
|
|
147
|
+
* import { delegateEvents } from "@shadow-js/web";
|
|
148
|
+
*
|
|
149
|
+
* delegateEvents(["click", "input"]);
|
|
150
|
+
* @see clearDelegatedEvents
|
|
151
|
+
* @since 1.0.0
|
|
152
|
+
*/
|
|
153
|
+
function delegateEvents(names, target = globalThis.document) {
|
|
154
|
+
let known = installed.get(target);
|
|
155
|
+
if (known === void 0) {
|
|
156
|
+
known = /* @__PURE__ */ new Set();
|
|
157
|
+
installed.set(target, known);
|
|
158
|
+
}
|
|
159
|
+
for (const name of names) {
|
|
160
|
+
if (known.has(name)) continue;
|
|
161
|
+
known.add(name);
|
|
162
|
+
target.addEventListener(name, dispatchDelegated);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* Removes the delegated listeners {@link delegateEvents} installed on `target`. Delegated handlers stop
|
|
167
|
+
* running until `delegateEvents` is called again (Solid's `clearDelegatedEvents`). Use it when a page
|
|
168
|
+
* unmounts ShadowJS entirely, for example a micro-frontend that hands the document back. A document
|
|
169
|
+
* without delegated listeners is left as is.
|
|
170
|
+
*
|
|
171
|
+
* @param target Document whose listeners are removed. Default: the global `document`.
|
|
172
|
+
* @example
|
|
173
|
+
* import { clearDelegatedEvents } from "@shadow-js/web";
|
|
174
|
+
*
|
|
175
|
+
* export function unmountApp(dispose: () => void): void {
|
|
176
|
+
* dispose();
|
|
177
|
+
* clearDelegatedEvents();
|
|
178
|
+
* }
|
|
179
|
+
* @see delegateEvents
|
|
180
|
+
* @since 1.0.0
|
|
181
|
+
*/
|
|
182
|
+
function clearDelegatedEvents(target = globalThis.document) {
|
|
183
|
+
const known = installed.get(target);
|
|
184
|
+
if (known === void 0) return;
|
|
185
|
+
for (const name of known) target.removeEventListener(name, dispatchDelegated);
|
|
186
|
+
installed.delete(target);
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* The document that must carry the delegated listener for `el`. A template clone is owned by the
|
|
190
|
+
* template's inert document (no window, never receives an event) until it is inserted, and handlers
|
|
191
|
+
* are bound before that: use the page's document then, which is where the element will live.
|
|
192
|
+
*/
|
|
193
|
+
function delegationDocument(el) {
|
|
194
|
+
const owner = el.ownerDocument;
|
|
195
|
+
return owner !== null && owner.defaultView !== null ? owner : globalThis.document;
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Binds one handler and returns the function that undoes it. A delegated event is stored on the
|
|
199
|
+
* element as an expando; the document listener picks it up. Other events get a native listener.
|
|
200
|
+
* Non-composed events (`change`, `select`, `load`, ...) never leave a shadow root, so they always get
|
|
201
|
+
* a native listener, whatever the caller asked for.
|
|
202
|
+
* @internal
|
|
203
|
+
*/
|
|
204
|
+
function bindEvent(el, name, handler, delegate, capture = false) {
|
|
205
|
+
if (handler === null || handler === void 0 || handler === false) return void 0;
|
|
206
|
+
if (isListenerObject(handler)) return bindListenerObject(el, name, handler, capture);
|
|
207
|
+
const binding = toBinding(handler);
|
|
208
|
+
const slot = `$$${name}`;
|
|
209
|
+
if (delegate && !capture && DELEGATED_EVENTS.has(name) && Reflect.get(el, slot) === void 0) {
|
|
210
|
+
delegateEvents([name], delegationDocument(el));
|
|
211
|
+
const dataKey = `${slot}Data`;
|
|
212
|
+
Reflect.set(el, slot, binding.fn);
|
|
213
|
+
if (binding.tuple) Reflect.set(el, dataKey, binding.data);
|
|
214
|
+
else Reflect.deleteProperty(el, dataKey);
|
|
215
|
+
return () => {
|
|
216
|
+
if (Reflect.get(el, slot) === binding.fn) {
|
|
217
|
+
Reflect.deleteProperty(el, slot);
|
|
218
|
+
Reflect.deleteProperty(el, dataKey);
|
|
219
|
+
}
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
const listener = (event) => {
|
|
223
|
+
const args = binding.tuple ? [binding.data, event] : [event];
|
|
224
|
+
batch(() => untrack(() => binding.fn.call(el, ...args)));
|
|
225
|
+
};
|
|
226
|
+
el.addEventListener(name, listener, capture);
|
|
227
|
+
return () => {
|
|
228
|
+
el.removeEventListener(name, listener, capture);
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
/**
|
|
232
|
+
* Binds an event handler to an element: the helper compiled templates call for `onX` and the `on:`
|
|
233
|
+
* and `oncapture:` prefixes. Handlers run batched and untracked, with `this` set to the element.
|
|
234
|
+
* Inside an owner, the listener is removed when the owner is disposed, even if the element outlives
|
|
235
|
+
* it.
|
|
236
|
+
*
|
|
237
|
+
* @param el Target element.
|
|
238
|
+
* @param name Event name, lowercase, such as `click`.
|
|
239
|
+
* @param handler A function (called with the event), a `[fn, data]` tuple (called as
|
|
240
|
+
* `fn(data, event)`), or a listener object `{ handleEvent, once, passive, capture, signal }`, which
|
|
241
|
+
* is always bound natively with those options. `null`, `undefined` and `false` bind nothing.
|
|
242
|
+
* @param delegate `true` stores the handler on the element for the document listener of
|
|
243
|
+
* {@link delegateEvents} (installed on demand) when `name` is a delegated event (`click`, `input`,
|
|
244
|
+
* `keydown`, pointer, mouse, touch and focus events, ...) and the element has no delegated handler
|
|
245
|
+
* for it yet. Otherwise, and when undefined, the handler gets a native listener.
|
|
246
|
+
* @param capture `true` listens in the capture phase, never delegated. Undefined means the bubble phase.
|
|
247
|
+
* @throws TypeError `SHADOW_EVENT_HANDLER` when `handler` is not a function, a tuple whose first item
|
|
248
|
+
* is a function, or a listener object.
|
|
249
|
+
* @example
|
|
250
|
+
* import { addEventListener } from "@shadow-js/web";
|
|
251
|
+
*
|
|
252
|
+
* const button = document.createElement("button");
|
|
253
|
+
* addEventListener(button, "click", () => console.log("pressed"), true);
|
|
254
|
+
* addEventListener(button, "focus", [(id: string, event: Event) => console.log(id, event.type), "save"]);
|
|
255
|
+
* @see delegateEvents
|
|
256
|
+
* @since 1.0.0
|
|
257
|
+
*/
|
|
258
|
+
function addEventListener(el, name, handler, delegate, capture) {
|
|
259
|
+
const unbind = bindEvent(el, name, handler, delegate === true, capture === true);
|
|
260
|
+
if (unbind !== void 0 && getOwner() !== null) onCleanup(unbind);
|
|
261
|
+
}
|
|
262
|
+
export { addEventListener, bindEvent, chainEvents, clearDelegatedEvents, delegateEvents };
|
|
263
|
+
|
|
264
|
+
//# sourceMappingURL=events.js.map
|
|
@@ -0,0 +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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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { isUnsafeUrlAttribute } from "./attributes.js";
|
|
2
|
+
import { element } from "./element.js";
|
|
3
|
+
import { Region, bindRegion, createRegion, removeRegion } from "./insert.js";
|
|
4
|
+
import { claimElement, claimPortal, isClaiming, takeRegion, withoutClaiming } from "./internal/claim.js";
|
|
5
|
+
import { WebWarningCode, warnOnce } from "./internal/diagnostics.js";
|
|
6
|
+
import { Claims, claims } from "./internal/hydration-hooks.js";
|
|
7
|
+
import { HydrationScope, childScope, createRootScope, currentScope, enterComponent, nextKey, resourceKey, withScope } from "./internal/hydration-scope.js";
|
|
8
|
+
import { HTML_NS, MATHML_NS, SVG_NS } from "./internal/names.js";
|
|
9
|
+
import { PortalContext, PortalSink } from "./internal/portal-context.js";
|
|
10
|
+
import { reconcileNodes } from "./internal/reconcile.js";
|
|
11
|
+
import { StreamBoundary, StreamContext, StreamSink } from "./internal/stream-context.js";
|
|
12
|
+
export { type Claims, HTML_NS, type HydrationScope, MATHML_NS, PortalContext, type PortalSink, type Region, SVG_NS, type StreamBoundary, StreamContext, type StreamSink, type WebWarningCode, bindRegion, childScope, claimElement, claimPortal, claims, createRegion, createRootScope, currentScope, element, enterComponent, isClaiming, isUnsafeUrlAttribute, nextKey, reconcileNodes, removeRegion, resourceKey, takeRegion, warnOnce, withScope, withoutClaiming };
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { warnOnce } from "./internal/diagnostics.js";
|
|
2
|
+
import { isUnsafeUrlAttribute } from "./attributes.js";
|
|
3
|
+
import { HTML_NS, MATHML_NS, SVG_NS } from "./internal/names.js";
|
|
4
|
+
import { childScope, createRootScope, currentScope, enterComponent, nextKey, resourceKey, withScope } from "./internal/hydration-scope.js";
|
|
5
|
+
import { claimElement, claimPortal, isClaiming, takeRegion, withoutClaiming } from "./internal/claim.js";
|
|
6
|
+
import { claims } from "./internal/hydration-hooks.js";
|
|
7
|
+
import { reconcileNodes } from "./internal/reconcile.js";
|
|
8
|
+
import { bindRegion, createRegion, removeRegion } from "./insert.js";
|
|
9
|
+
import { element } from "./element.js";
|
|
10
|
+
import { PortalContext } from "./internal/portal-context.js";
|
|
11
|
+
import { StreamContext } from "./internal/stream-context.js";
|
|
12
|
+
export { HTML_NS, MATHML_NS, PortalContext, SVG_NS, StreamContext, bindRegion, childScope, claimElement, claimPortal, claims, createRegion, createRootScope, currentScope, element, enterComponent, isClaiming, isUnsafeUrlAttribute, nextKey, reconcileNodes, removeRegion, resourceKey, takeRegion, warnOnce, withScope, withoutClaiming };
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Props of {@link Title}.
|
|
3
|
+
* @since 1.0.0
|
|
4
|
+
*/
|
|
5
|
+
export interface TitleProps {
|
|
6
|
+
/**
|
|
7
|
+
* The title text: a string, a number, an array of those, or an accessor returning them. `null`,
|
|
8
|
+
* `undefined` and `false` count as empty text; anything else throws a TypeError.
|
|
9
|
+
* @default undefined (the title is the empty string)
|
|
10
|
+
*/
|
|
11
|
+
readonly children?: unknown;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Props of {@link Meta}, {@link Link} and {@link Base}: every prop is an attribute, and a function
|
|
15
|
+
* value is read reactively.
|
|
16
|
+
* @since 1.0.0
|
|
17
|
+
*/
|
|
18
|
+
export interface HeadAttributeProps {
|
|
19
|
+
/**
|
|
20
|
+
* One attribute of the tag. A string or number is written as text, `true` as an empty attribute,
|
|
21
|
+
* and `false`, `null` or `undefined` omit it. Any other value throws a TypeError.
|
|
22
|
+
*/
|
|
23
|
+
readonly [attribute: string]: unknown;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Props of {@link Style}: the CSS text and an optional key that replaces an earlier style with the
|
|
27
|
+
* same key.
|
|
28
|
+
* @since 1.0.0
|
|
29
|
+
*/
|
|
30
|
+
export interface StyleProps {
|
|
31
|
+
/**
|
|
32
|
+
* The CSS text: a string, a number, an array of those, or an accessor returning them.
|
|
33
|
+
* @default undefined (the style has no text)
|
|
34
|
+
*/
|
|
35
|
+
readonly children?: unknown;
|
|
36
|
+
/**
|
|
37
|
+
* Identity of the style: a later style with the same key replaces an earlier one. Must be a
|
|
38
|
+
* non-empty string.
|
|
39
|
+
* @default undefined (the style has no identity and always stays)
|
|
40
|
+
*/
|
|
41
|
+
readonly key?: unknown;
|
|
42
|
+
/** One attribute of the `<style>` element, such as `media`, with the same rules as {@link HeadAttributeProps}. */
|
|
43
|
+
readonly [attribute: string]: unknown;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Sets the document title. The last registered Title wins; removing it restores the one below, or
|
|
47
|
+
* the original title when none is left.
|
|
48
|
+
*
|
|
49
|
+
* @param props The title text.
|
|
50
|
+
* @returns Always null: nothing is rendered in place.
|
|
51
|
+
* @throws TypeError (production message `SHADOW_HEAD_TITLE_TEXT`) when the children are not text.
|
|
52
|
+
* @example
|
|
53
|
+
* import { Title } from "@shadow-js/web";
|
|
54
|
+
*
|
|
55
|
+
* function Home() {
|
|
56
|
+
* return <Title>Home | Blog</Title>;
|
|
57
|
+
* }
|
|
58
|
+
* @see useHead
|
|
59
|
+
* @since 1.0.0
|
|
60
|
+
*/
|
|
61
|
+
export declare function Title(props: TitleProps): null;
|
|
62
|
+
/**
|
|
63
|
+
* Registers a `<meta>`. Identity follows name, property, http-equiv or charset, so the last
|
|
64
|
+
* description wins. Children are ignored: a meta carries no text.
|
|
65
|
+
*
|
|
66
|
+
* @param props Attributes, such as `name` and `content`.
|
|
67
|
+
* @returns Always null: nothing is rendered in place.
|
|
68
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
69
|
+
* is not a string, number or boolean, and for an invalid attribute name or an event attribute
|
|
70
|
+
* (see {@link normalizeTags}).
|
|
71
|
+
* @example
|
|
72
|
+
* import { Meta } from "@shadow-js/web";
|
|
73
|
+
*
|
|
74
|
+
* function About() {
|
|
75
|
+
* return <Meta name="description" content="About us" />;
|
|
76
|
+
* }
|
|
77
|
+
* @see useHead
|
|
78
|
+
* @since 1.0.0
|
|
79
|
+
*/
|
|
80
|
+
export declare function Meta(props: HeadAttributeProps): null;
|
|
81
|
+
/**
|
|
82
|
+
* Registers a `<link>`. Icons are keyed by rel, sizes and type; preloads and stylesheets by rel,
|
|
83
|
+
* href and as; other links are append-only.
|
|
84
|
+
*
|
|
85
|
+
* @param props Attributes, such as `rel` and `href`.
|
|
86
|
+
* @returns Always null: nothing is rendered in place.
|
|
87
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
88
|
+
* is not a string, number or boolean, and for an invalid attribute name or an event attribute
|
|
89
|
+
* (see {@link normalizeTags}).
|
|
90
|
+
* @example
|
|
91
|
+
* import { Link } from "@shadow-js/web";
|
|
92
|
+
*
|
|
93
|
+
* function Page() {
|
|
94
|
+
* return <Link rel="stylesheet" href="/site.css" />;
|
|
95
|
+
* }
|
|
96
|
+
* @see useHead
|
|
97
|
+
* @since 1.0.0
|
|
98
|
+
*/
|
|
99
|
+
export declare function Link(props: HeadAttributeProps): null;
|
|
100
|
+
/**
|
|
101
|
+
* Registers a `<style>` with the given CSS text. A `key` makes it replace an earlier style with the
|
|
102
|
+
* same key; without one, every style stays.
|
|
103
|
+
*
|
|
104
|
+
* @param props The CSS as `children`, an optional `key`, and attributes such as `media`.
|
|
105
|
+
* @returns Always null: nothing is rendered in place.
|
|
106
|
+
* @throws TypeError (production message `SHADOW_HEAD_KEY`) when `key` is not a non-empty string.
|
|
107
|
+
* @example
|
|
108
|
+
* import { Style } from "@shadow-js/web";
|
|
109
|
+
*
|
|
110
|
+
* function Theme() {
|
|
111
|
+
* return <Style key="theme">{"body { margin: 0 }"}</Style>;
|
|
112
|
+
* }
|
|
113
|
+
* @see useHead
|
|
114
|
+
* @since 1.0.0
|
|
115
|
+
*/
|
|
116
|
+
export declare function Style(props: StyleProps): null;
|
|
117
|
+
/**
|
|
118
|
+
* Registers the document `<base>`. There is one; the last registration wins. Base is placed first
|
|
119
|
+
* in the head, as browsers expect.
|
|
120
|
+
*
|
|
121
|
+
* @param props Attributes, such as `href`.
|
|
122
|
+
* @returns Always null: nothing is rendered in place.
|
|
123
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
124
|
+
* is not a string, number or boolean.
|
|
125
|
+
* @example
|
|
126
|
+
* import { Base } from "@shadow-js/web";
|
|
127
|
+
*
|
|
128
|
+
* function Shell() {
|
|
129
|
+
* return <Base href="/app/" />;
|
|
130
|
+
* }
|
|
131
|
+
* @see useHead
|
|
132
|
+
* @since 1.0.0
|
|
133
|
+
*/
|
|
134
|
+
export declare function Base(props: HeadAttributeProps): null;
|
|
135
|
+
//# sourceMappingURL=components.d.ts.map
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { useHead } from "./use-head.js";
|
|
2
|
+
// src/head/components.ts
|
|
3
|
+
/** Text of a value that may be an accessor. Anything but text or an array of text throws. */
|
|
4
|
+
function partText(value) {
|
|
5
|
+
if (typeof value === "string") return value;
|
|
6
|
+
if (typeof value === "number") return String(value);
|
|
7
|
+
if (value === void 0 || value === null || value === false) return "";
|
|
8
|
+
throw new TypeError("ShadowJS head: Title children must be text.");
|
|
9
|
+
}
|
|
10
|
+
/** The text a Title shows. An accessor is called once, so its reads are tracked by the caller. */
|
|
11
|
+
function textOf(value) {
|
|
12
|
+
const resolved = typeof value === "function" ? value() : value;
|
|
13
|
+
if (Array.isArray(resolved)) return resolved.map(partText).join("");
|
|
14
|
+
return partText(resolved);
|
|
15
|
+
}
|
|
16
|
+
/** The style key of a prop: absent stays absent, a non-empty string is kept, anything else throws. */
|
|
17
|
+
function keyOf(value) {
|
|
18
|
+
if (value === void 0 || value === null) return void 0;
|
|
19
|
+
if (typeof value === "string" && value !== "") return value;
|
|
20
|
+
throw new TypeError("ShadowJS head: a key must be a non-empty string.");
|
|
21
|
+
}
|
|
22
|
+
/** One attribute value from a prop: strings, numbers and booleans are kept, the rest is an error. */
|
|
23
|
+
function attributeValue(value) {
|
|
24
|
+
if (value === void 0 || value === null || value === false) return void 0;
|
|
25
|
+
if (value === true) return true;
|
|
26
|
+
if (typeof value === "string") return value;
|
|
27
|
+
if (typeof value === "number") return value;
|
|
28
|
+
throw new TypeError("ShadowJS head: attribute values must be strings, numbers or booleans.");
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* The attributes of a component's props, reading each prop (so a getter is tracked by the
|
|
32
|
+
* caller). `skip` lists props that are not attributes.
|
|
33
|
+
*/
|
|
34
|
+
function attributesOf(props, skip) {
|
|
35
|
+
const entries = [];
|
|
36
|
+
for (const key of Object.keys(props)) {
|
|
37
|
+
if (skip.includes(key)) continue;
|
|
38
|
+
entries.push([key, attributeValue(Reflect.get(props, key))]);
|
|
39
|
+
}
|
|
40
|
+
return Object.fromEntries(entries);
|
|
41
|
+
}
|
|
42
|
+
/** A tag with attributes and no text, of the given name. */
|
|
43
|
+
function attributeTag(tag, props, skip) {
|
|
44
|
+
return {
|
|
45
|
+
tag,
|
|
46
|
+
props: attributesOf(props, skip)
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Sets the document title. The last registered Title wins; removing it restores the one below, or
|
|
51
|
+
* the original title when none is left.
|
|
52
|
+
*
|
|
53
|
+
* @param props The title text.
|
|
54
|
+
* @returns Always null: nothing is rendered in place.
|
|
55
|
+
* @throws TypeError (production message `SHADOW_HEAD_TITLE_TEXT`) when the children are not text.
|
|
56
|
+
* @example
|
|
57
|
+
* import { Title } from "@shadow-js/web";
|
|
58
|
+
*
|
|
59
|
+
* function Home() {
|
|
60
|
+
* return <Title>Home | Blog</Title>;
|
|
61
|
+
* }
|
|
62
|
+
* @see useHead
|
|
63
|
+
* @since 1.0.0
|
|
64
|
+
*/
|
|
65
|
+
function Title(props) {
|
|
66
|
+
useHead(() => ({
|
|
67
|
+
tag: "title",
|
|
68
|
+
children: textOf(props.children)
|
|
69
|
+
}));
|
|
70
|
+
return null;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Registers a `<meta>`. Identity follows name, property, http-equiv or charset, so the last
|
|
74
|
+
* description wins. Children are ignored: a meta carries no text.
|
|
75
|
+
*
|
|
76
|
+
* @param props Attributes, such as `name` and `content`.
|
|
77
|
+
* @returns Always null: nothing is rendered in place.
|
|
78
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
79
|
+
* is not a string, number or boolean, and for an invalid attribute name or an event attribute
|
|
80
|
+
* (see {@link normalizeTags}).
|
|
81
|
+
* @example
|
|
82
|
+
* import { Meta } from "@shadow-js/web";
|
|
83
|
+
*
|
|
84
|
+
* function About() {
|
|
85
|
+
* return <Meta name="description" content="About us" />;
|
|
86
|
+
* }
|
|
87
|
+
* @see useHead
|
|
88
|
+
* @since 1.0.0
|
|
89
|
+
*/
|
|
90
|
+
function Meta(props) {
|
|
91
|
+
useHead(() => attributeTag("meta", props, ["children"]));
|
|
92
|
+
return null;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Registers a `<link>`. Icons are keyed by rel, sizes and type; preloads and stylesheets by rel,
|
|
96
|
+
* href and as; other links are append-only.
|
|
97
|
+
*
|
|
98
|
+
* @param props Attributes, such as `rel` and `href`.
|
|
99
|
+
* @returns Always null: nothing is rendered in place.
|
|
100
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
101
|
+
* is not a string, number or boolean, and for an invalid attribute name or an event attribute
|
|
102
|
+
* (see {@link normalizeTags}).
|
|
103
|
+
* @example
|
|
104
|
+
* import { Link } from "@shadow-js/web";
|
|
105
|
+
*
|
|
106
|
+
* function Page() {
|
|
107
|
+
* return <Link rel="stylesheet" href="/site.css" />;
|
|
108
|
+
* }
|
|
109
|
+
* @see useHead
|
|
110
|
+
* @since 1.0.0
|
|
111
|
+
*/
|
|
112
|
+
function Link(props) {
|
|
113
|
+
useHead(() => attributeTag("link", props, ["children"]));
|
|
114
|
+
return null;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Registers a `<style>` with the given CSS text. A `key` makes it replace an earlier style with the
|
|
118
|
+
* same key; without one, every style stays.
|
|
119
|
+
*
|
|
120
|
+
* @param props The CSS as `children`, an optional `key`, and attributes such as `media`.
|
|
121
|
+
* @returns Always null: nothing is rendered in place.
|
|
122
|
+
* @throws TypeError (production message `SHADOW_HEAD_KEY`) when `key` is not a non-empty string.
|
|
123
|
+
* @example
|
|
124
|
+
* import { Style } from "@shadow-js/web";
|
|
125
|
+
*
|
|
126
|
+
* function Theme() {
|
|
127
|
+
* return <Style key="theme">{"body { margin: 0 }"}</Style>;
|
|
128
|
+
* }
|
|
129
|
+
* @see useHead
|
|
130
|
+
* @since 1.0.0
|
|
131
|
+
*/
|
|
132
|
+
function Style(props) {
|
|
133
|
+
useHead(() => {
|
|
134
|
+
const attributes = attributesOf(props, ["children", "key"]);
|
|
135
|
+
const text = props.children === void 0 ? void 0 : textOf(props.children);
|
|
136
|
+
const key = keyOf(props.key);
|
|
137
|
+
return {
|
|
138
|
+
tag: "style",
|
|
139
|
+
props: attributes,
|
|
140
|
+
...text === void 0 ? {} : { children: text },
|
|
141
|
+
...key === void 0 ? {} : { key }
|
|
142
|
+
};
|
|
143
|
+
});
|
|
144
|
+
return null;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Registers the document `<base>`. There is one; the last registration wins. Base is placed first
|
|
148
|
+
* in the head, as browsers expect.
|
|
149
|
+
*
|
|
150
|
+
* @param props Attributes, such as `href`.
|
|
151
|
+
* @returns Always null: nothing is rendered in place.
|
|
152
|
+
* @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that
|
|
153
|
+
* is not a string, number or boolean.
|
|
154
|
+
* @example
|
|
155
|
+
* import { Base } from "@shadow-js/web";
|
|
156
|
+
*
|
|
157
|
+
* function Shell() {
|
|
158
|
+
* return <Base href="/app/" />;
|
|
159
|
+
* }
|
|
160
|
+
* @see useHead
|
|
161
|
+
* @since 1.0.0
|
|
162
|
+
*/
|
|
163
|
+
function Base(props) {
|
|
164
|
+
useHead(() => attributeTag("base", props, ["children"]));
|
|
165
|
+
return null;
|
|
166
|
+
}
|
|
167
|
+
export { Base, Link, Meta, Style, Title };
|
|
168
|
+
|
|
169
|
+
//# sourceMappingURL=components.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"components.js","names":[],"sources":["../../../src/head/components.ts"],"sourcesContent":["import { useHead } from \"./use-head\";\nimport type { HeadAttributeValue, HeadTag, HeadTagName } from \"./validate\";\n\n/**\n * Props of {@link Title}.\n * @since 1.0.0\n */\nexport interface TitleProps {\n /**\n * The title text: a string, a number, an array of those, or an accessor returning them. `null`,\n * `undefined` and `false` count as empty text; anything else throws a TypeError.\n * @default undefined (the title is the empty string)\n */\n readonly children?: unknown;\n}\n\n/**\n * Props of {@link Meta}, {@link Link} and {@link Base}: every prop is an attribute, and a function\n * value is read reactively.\n * @since 1.0.0\n */\nexport interface HeadAttributeProps {\n /**\n * One attribute of the tag. A string or number is written as text, `true` as an empty attribute,\n * and `false`, `null` or `undefined` omit it. Any other value throws a TypeError.\n */\n readonly [attribute: string]: unknown;\n}\n\n/**\n * Props of {@link Style}: the CSS text and an optional key that replaces an earlier style with the\n * same key.\n * @since 1.0.0\n */\nexport interface StyleProps {\n /**\n * The CSS text: a string, a number, an array of those, or an accessor returning them.\n * @default undefined (the style has no text)\n */\n readonly children?: unknown;\n /**\n * Identity of the style: a later style with the same key replaces an earlier one. Must be a\n * non-empty string.\n * @default undefined (the style has no identity and always stays)\n */\n readonly key?: unknown;\n /** One attribute of the `<style>` element, such as `media`, with the same rules as {@link HeadAttributeProps}. */\n readonly [attribute: string]: unknown;\n}\n\n/** Text of a value that may be an accessor. Anything but text or an array of text throws. */\nfunction partText(value: unknown): string {\n if (typeof value === \"string\") return value;\n if (typeof value === \"number\") return String(value);\n if (value === undefined || value === null || value === false) return \"\";\n throw new TypeError(\n __DEV__ ? \"ShadowJS head: Title children must be text.\" : \"SHADOW_HEAD_TITLE_TEXT\",\n );\n}\n\n/** The text a Title shows. An accessor is called once, so its reads are tracked by the caller. */\nfunction textOf(value: unknown): string {\n const resolved = typeof value === \"function\" ? (value as () => unknown)() : value;\n if (Array.isArray(resolved)) return (resolved as unknown[]).map(partText).join(\"\");\n return partText(resolved);\n}\n\n/** The style key of a prop: absent stays absent, a non-empty string is kept, anything else throws. */\nfunction keyOf(value: unknown): string | undefined {\n if (value === undefined || value === null) return undefined;\n if (typeof value === \"string\" && value !== \"\") return value;\n throw new TypeError(\n __DEV__ ? \"ShadowJS head: a key must be a non-empty string.\" : \"SHADOW_HEAD_KEY\",\n );\n}\n\n/** One attribute value from a prop: strings, numbers and booleans are kept, the rest is an error. */\nfunction attributeValue(value: unknown): HeadAttributeValue {\n if (value === undefined || value === null || value === false) return undefined;\n if (value === true) return true;\n if (typeof value === \"string\") return value;\n if (typeof value === \"number\") return value;\n throw new TypeError(\n __DEV__\n ? \"ShadowJS head: attribute values must be strings, numbers or booleans.\"\n : \"SHADOW_HEAD_ATTRIBUTE_VALUE\",\n );\n}\n\n/**\n * The attributes of a component's props, reading each prop (so a getter is tracked by the\n * caller). `skip` lists props that are not attributes.\n */\nfunction attributesOf(props: object, skip: readonly string[]): Record<string, HeadAttributeValue> {\n const entries: Array<[string, HeadAttributeValue]> = [];\n for (const key of Object.keys(props)) {\n if (skip.includes(key)) continue;\n entries.push([key, attributeValue(Reflect.get(props, key))]);\n }\n return Object.fromEntries(entries);\n}\n\n/** A tag with attributes and no text, of the given name. */\nfunction attributeTag(tag: HeadTagName, props: object, skip: readonly string[]): HeadTag {\n return { tag, props: attributesOf(props, skip) };\n}\n\n/**\n * Sets the document title. The last registered Title wins; removing it restores the one below, or\n * the original title when none is left.\n *\n * @param props The title text.\n * @returns Always null: nothing is rendered in place.\n * @throws TypeError (production message `SHADOW_HEAD_TITLE_TEXT`) when the children are not text.\n * @example\n * import { Title } from \"@shadow-js/web\";\n *\n * function Home() {\n * return <Title>Home | Blog</Title>;\n * }\n * @see useHead\n * @since 1.0.0\n */\nexport function Title(props: TitleProps): null {\n useHead((): HeadTag => ({ tag: \"title\", children: textOf(props.children) }));\n return null;\n}\n\n/**\n * Registers a `<meta>`. Identity follows name, property, http-equiv or charset, so the last\n * description wins. Children are ignored: a meta carries no text.\n *\n * @param props Attributes, such as `name` and `content`.\n * @returns Always null: nothing is rendered in place.\n * @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that\n * is not a string, number or boolean, and for an invalid attribute name or an event attribute\n * (see {@link normalizeTags}).\n * @example\n * import { Meta } from \"@shadow-js/web\";\n *\n * function About() {\n * return <Meta name=\"description\" content=\"About us\" />;\n * }\n * @see useHead\n * @since 1.0.0\n */\nexport function Meta(props: HeadAttributeProps): null {\n useHead(() => attributeTag(\"meta\", props, [\"children\"]));\n return null;\n}\n\n/**\n * Registers a `<link>`. Icons are keyed by rel, sizes and type; preloads and stylesheets by rel,\n * href and as; other links are append-only.\n *\n * @param props Attributes, such as `rel` and `href`.\n * @returns Always null: nothing is rendered in place.\n * @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that\n * is not a string, number or boolean, and for an invalid attribute name or an event attribute\n * (see {@link normalizeTags}).\n * @example\n * import { Link } from \"@shadow-js/web\";\n *\n * function Page() {\n * return <Link rel=\"stylesheet\" href=\"/site.css\" />;\n * }\n * @see useHead\n * @since 1.0.0\n */\nexport function Link(props: HeadAttributeProps): null {\n useHead(() => attributeTag(\"link\", props, [\"children\"]));\n return null;\n}\n\n/**\n * Registers a `<style>` with the given CSS text. A `key` makes it replace an earlier style with the\n * same key; without one, every style stays.\n *\n * @param props The CSS as `children`, an optional `key`, and attributes such as `media`.\n * @returns Always null: nothing is rendered in place.\n * @throws TypeError (production message `SHADOW_HEAD_KEY`) when `key` is not a non-empty string.\n * @example\n * import { Style } from \"@shadow-js/web\";\n *\n * function Theme() {\n * return <Style key=\"theme\">{\"body { margin: 0 }\"}</Style>;\n * }\n * @see useHead\n * @since 1.0.0\n */\nexport function Style(props: StyleProps): null {\n useHead((): HeadTag => {\n const attributes = attributesOf(props, [\"children\", \"key\"]);\n const text = props.children === undefined ? undefined : textOf(props.children);\n const key = keyOf(props.key);\n return {\n tag: \"style\",\n props: attributes,\n ...(text === undefined ? {} : { children: text }),\n ...(key === undefined ? {} : { key }),\n };\n });\n return null;\n}\n\n/**\n * Registers the document `<base>`. There is one; the last registration wins. Base is placed first\n * in the head, as browsers expect.\n *\n * @param props Attributes, such as `href`.\n * @returns Always null: nothing is rendered in place.\n * @throws TypeError (production message `SHADOW_HEAD_ATTRIBUTE_VALUE`) for an attribute value that\n * is not a string, number or boolean.\n * @example\n * import { Base } from \"@shadow-js/web\";\n *\n * function Shell() {\n * return <Base href=\"/app/\" />;\n * }\n * @see useHead\n * @since 1.0.0\n */\nexport function Base(props: HeadAttributeProps): null {\n useHead(() => attributeTag(\"base\", props, [\"children\"]));\n return null;\n}\n"],"mappings":";;;AAmDA,SAAS,SAAS,OAAwB;CACxC,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,KAAK;CAClD,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,OAAO,OAAO;CACrE,MAAM,IAAI,UACE,6CACZ;AACF;;AAGA,SAAS,OAAO,OAAwB;CACtC,MAAM,WAAW,OAAO,UAAU,aAAc,MAAwB,IAAI;CAC5E,IAAI,MAAM,QAAQ,QAAQ,GAAG,OAAQ,SAAuB,IAAI,QAAQ,CAAC,CAAC,KAAK,EAAE;CACjF,OAAO,SAAS,QAAQ;AAC1B;;AAGA,SAAS,MAAM,OAAoC;CACjD,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI,OAAO;CACtD,MAAM,IAAI,UACE,kDACZ;AACF;;AAGA,SAAS,eAAe,OAAoC;CAC1D,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,OAAO,OAAO,KAAA;CACrE,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,MAAM,IAAI,UAEJ,uEAEN;AACF;;;;;AAMA,SAAS,aAAa,OAAe,MAA6D;CAChG,MAAM,UAA+C,CAAC;CACtD,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EACpC,IAAI,KAAK,SAAS,GAAG,GAAG;EACxB,QAAQ,KAAK,CAAC,KAAK,eAAe,QAAQ,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;CAC7D;CACA,OAAO,OAAO,YAAY,OAAO;AACnC;;AAGA,SAAS,aAAa,KAAkB,OAAe,MAAkC;CACvF,OAAO;EAAE;EAAK,OAAO,aAAa,OAAO,IAAI;CAAE;AACjD;;;;;;;;;;;;;;;;;AAkBA,SAAgB,MAAM,OAAyB;CAC7C,eAAwB;EAAE,KAAK;EAAS,UAAU,OAAO,MAAM,QAAQ;CAAE,EAAE;CAC3E,OAAO;AACT;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,KAAK,OAAiC;CACpD,cAAc,aAAa,QAAQ,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD,OAAO;AACT;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,KAAK,OAAiC;CACpD,cAAc,aAAa,QAAQ,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,SAAgB,MAAM,OAAyB;CAC7C,cAAuB;EACrB,MAAM,aAAa,aAAa,OAAO,CAAC,YAAY,KAAK,CAAC;EAC1D,MAAM,OAAO,MAAM,aAAa,KAAA,IAAY,KAAA,IAAY,OAAO,MAAM,QAAQ;EAC7E,MAAM,MAAM,MAAM,MAAM,GAAG;EAC3B,OAAO;GACL,KAAK;GACL,OAAO;GACP,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,KAAK;GAC/C,GAAI,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,IAAI;EACrC;CACF,CAAC;CACD,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,KAAK,OAAiC;CACpD,cAAc,aAAa,QAAQ,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD,OAAO;AACT"}
|