@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,67 @@
|
|
|
1
|
+
// src/head/registry.ts
|
|
2
|
+
const noop = () => void 0;
|
|
3
|
+
/**
|
|
4
|
+
* Creates an empty head registry. `onChange` runs after every effective add or removal, so the
|
|
5
|
+
* owner of the DOM can schedule one update for a whole batch.
|
|
6
|
+
*
|
|
7
|
+
* @param onChange Called after the registry changes.
|
|
8
|
+
* @returns A registry with no winners.
|
|
9
|
+
* @internal
|
|
10
|
+
* @since 1.0.0
|
|
11
|
+
*/
|
|
12
|
+
function createHeadRegistry(onChange) {
|
|
13
|
+
const stacks = /* @__PURE__ */ new Map();
|
|
14
|
+
let appendOnly = 0;
|
|
15
|
+
return {
|
|
16
|
+
add(tags) {
|
|
17
|
+
if (tags.length === 0) return noop;
|
|
18
|
+
const entries = [];
|
|
19
|
+
for (const tag of tags) {
|
|
20
|
+
let slot = tag.identity;
|
|
21
|
+
if (slot === void 0) {
|
|
22
|
+
slot = `#${appendOnly}`;
|
|
23
|
+
appendOnly += 1;
|
|
24
|
+
}
|
|
25
|
+
let stack = stacks.get(slot);
|
|
26
|
+
if (stack === void 0) {
|
|
27
|
+
stack = [];
|
|
28
|
+
stacks.set(slot, stack);
|
|
29
|
+
}
|
|
30
|
+
const entry = {
|
|
31
|
+
slot,
|
|
32
|
+
tag
|
|
33
|
+
};
|
|
34
|
+
stack.push(entry);
|
|
35
|
+
entries.push(entry);
|
|
36
|
+
}
|
|
37
|
+
onChange();
|
|
38
|
+
let removed = false;
|
|
39
|
+
return () => {
|
|
40
|
+
if (removed) return;
|
|
41
|
+
removed = true;
|
|
42
|
+
for (const entry of entries) {
|
|
43
|
+
const stack = stacks.get(entry.slot);
|
|
44
|
+
if (stack === void 0) continue;
|
|
45
|
+
const index = stack.indexOf(entry);
|
|
46
|
+
if (index !== -1) stack.splice(index, 1);
|
|
47
|
+
if (stack.length === 0) stacks.delete(entry.slot);
|
|
48
|
+
}
|
|
49
|
+
onChange();
|
|
50
|
+
};
|
|
51
|
+
},
|
|
52
|
+
winners() {
|
|
53
|
+
const winners = [];
|
|
54
|
+
for (const [slot, stack] of stacks) {
|
|
55
|
+
const top = stack[stack.length - 1];
|
|
56
|
+
if (top !== void 0) winners.push({
|
|
57
|
+
slot,
|
|
58
|
+
tag: top.tag
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
return winners;
|
|
62
|
+
}
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
export { createHeadRegistry };
|
|
66
|
+
|
|
67
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","names":[],"sources":["../../../src/head/registry.ts"],"sourcesContent":["import type { NormalizedTag } from \"./validate\";\n\n/**\n * One rendered head element: the slot it occupies (its identity, or a unique key for an\n * append-only tag) and the tag that currently wins that slot.\n * @internal\n */\nexport interface HeadWinner {\n readonly slot: string;\n readonly tag: NormalizedTag;\n}\n\n/**\n * The pure head registry: no DOM, no signals. Every registration joins the stack of its identity;\n * the top of each stack is the winner. Removing a registration takes it out of its stack, so the\n * one below it wins again.\n * @internal\n */\nexport interface HeadRegistry {\n /**\n * Registers a group of tags. The returned function removes them again; calling it twice is a\n * no-op.\n */\n add(tags: readonly NormalizedTag[]): () => void;\n /** The winning tag of every slot, in the order each slot first appeared. */\n winners(): HeadWinner[];\n}\n\ninterface Entry {\n readonly slot: string;\n readonly tag: NormalizedTag;\n}\n\nconst noop = (): void => undefined;\n\n/**\n * Creates an empty head registry. `onChange` runs after every effective add or removal, so the\n * owner of the DOM can schedule one update for a whole batch.\n *\n * @param onChange Called after the registry changes.\n * @returns A registry with no winners.\n * @internal\n * @since 1.0.0\n */\nexport function createHeadRegistry(onChange: () => void): HeadRegistry {\n const stacks = new Map<string, Entry[]>();\n let appendOnly = 0;\n return {\n add(tags: readonly NormalizedTag[]): () => void {\n if (tags.length === 0) return noop;\n const entries: Entry[] = [];\n for (const tag of tags) {\n let slot = tag.identity;\n if (slot === undefined) {\n slot = `#${appendOnly}`;\n appendOnly += 1;\n }\n let stack = stacks.get(slot);\n if (stack === undefined) {\n stack = [];\n stacks.set(slot, stack);\n }\n const entry: Entry = { slot, tag };\n stack.push(entry);\n entries.push(entry);\n }\n onChange();\n let removed = false;\n return (): void => {\n if (removed) return;\n removed = true;\n for (const entry of entries) {\n const stack = stacks.get(entry.slot);\n if (stack === undefined) continue;\n const index = stack.indexOf(entry);\n if (index !== -1) stack.splice(index, 1);\n if (stack.length === 0) stacks.delete(entry.slot);\n }\n onChange();\n };\n },\n winners(): HeadWinner[] {\n const winners: HeadWinner[] = [];\n for (const [slot, stack] of stacks) {\n const top = stack[stack.length - 1];\n if (top !== undefined) winners.push({ slot, tag: top.tag });\n }\n return winners;\n },\n };\n}\n"],"mappings":";AAiCA,MAAM,aAAmB,KAAA;;;;;;;;;;AAWzB,SAAgB,mBAAmB,UAAoC;CACrE,MAAM,yBAAS,IAAI,IAAqB;CACxC,IAAI,aAAa;CACjB,OAAO;EACL,IAAI,MAA4C;GAC9C,IAAI,KAAK,WAAW,GAAG,OAAO;GAC9B,MAAM,UAAmB,CAAC;GAC1B,KAAK,MAAM,OAAO,MAAM;IACtB,IAAI,OAAO,IAAI;IACf,IAAI,SAAS,KAAA,GAAW;KACtB,OAAO,IAAI;KACX,cAAc;IAChB;IACA,IAAI,QAAQ,OAAO,IAAI,IAAI;IAC3B,IAAI,UAAU,KAAA,GAAW;KACvB,QAAQ,CAAC;KACT,OAAO,IAAI,MAAM,KAAK;IACxB;IACA,MAAM,QAAe;KAAE;KAAM;IAAI;IACjC,MAAM,KAAK,KAAK;IAChB,QAAQ,KAAK,KAAK;GACpB;GACA,SAAS;GACT,IAAI,UAAU;GACd,aAAmB;IACjB,IAAI,SAAS;IACb,UAAU;IACV,KAAK,MAAM,SAAS,SAAS;KAC3B,MAAM,QAAQ,OAAO,IAAI,MAAM,IAAI;KACnC,IAAI,UAAU,KAAA,GAAW;KACzB,MAAM,QAAQ,MAAM,QAAQ,KAAK;KACjC,IAAI,UAAU,IAAI,MAAM,OAAO,OAAO,CAAC;KACvC,IAAI,MAAM,WAAW,GAAG,OAAO,OAAO,MAAM,IAAI;IAClD;IACA,SAAS;GACX;EACF;EACA,UAAwB;GACtB,MAAM,UAAwB,CAAC;GAC/B,KAAK,MAAM,CAAC,MAAM,UAAU,QAAQ;IAClC,MAAM,MAAM,MAAM,MAAM,SAAS;IACjC,IAAI,QAAQ,KAAA,GAAW,QAAQ,KAAK;KAAE;KAAM,KAAK,IAAI;IAAI,CAAC;GAC5D;GACA,OAAO;EACT;CACF;AACF"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { NormalizedTag } from "./validate.js";
|
|
2
|
+
import { Context } from "@shadow-js/core";
|
|
3
|
+
/**
|
|
4
|
+
* The head of one server render: what `useHead`, `<Title>`, `<Meta>`, `<Link>`, `<Style>` and
|
|
5
|
+
* `<Base>` registered while the app rendered. Pass it to a render function through its `head`
|
|
6
|
+
* option, then write {@link ServerHead.html} into the document's `<head>`.
|
|
7
|
+
*
|
|
8
|
+
* Tags follow the same rules as in the browser: the last registration of an identity wins
|
|
9
|
+
* (`title`, `meta` by name, ...), append-only tags all stay. Every tag carries the marker the
|
|
10
|
+
* browser's head sink looks for, so the client adopts the server's elements instead of adding
|
|
11
|
+
* duplicates.
|
|
12
|
+
* @since 1.0.0
|
|
13
|
+
*/
|
|
14
|
+
export interface ServerHead {
|
|
15
|
+
/** Registers tags. Used by `useHead`; the returned function removes them again. */
|
|
16
|
+
add(tags: readonly NormalizedTag[]): () => void;
|
|
17
|
+
/** Forgets every registration. Multi-pass renders call this before each pass. */
|
|
18
|
+
clear(): void;
|
|
19
|
+
/**
|
|
20
|
+
* The markup of the winning tags, in registration order. With a `nonce`, every `<style>` carries
|
|
21
|
+
* it, so the page's Content-Security-Policy (`style-src 'nonce-...'`) accepts the styles. Throws a
|
|
22
|
+
* TypeError when the text of a style contains a closing style tag.
|
|
23
|
+
*
|
|
24
|
+
* @param options `nonce` is added to every `<style>`. Default: no options, so no nonce.
|
|
25
|
+
*/
|
|
26
|
+
html(options?: {
|
|
27
|
+
readonly nonce?: string;
|
|
28
|
+
}): string;
|
|
29
|
+
/** The winning tags, for hosts that build the head themselves. */
|
|
30
|
+
tags(): readonly NormalizedTag[];
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Creates an empty server head collector.
|
|
34
|
+
*
|
|
35
|
+
* @returns A collector to pass as the `head` option of `renderToString`, `renderToStringAsync` or
|
|
36
|
+
* `renderToStream`.
|
|
37
|
+
* @example
|
|
38
|
+
* import { createComponent, Title } from "@shadow-js/web";
|
|
39
|
+
* import { createServerHead, renderToString } from "@shadow-js/web/server";
|
|
40
|
+
*
|
|
41
|
+
* function App() {
|
|
42
|
+
* return Title({ children: "Home" });
|
|
43
|
+
* }
|
|
44
|
+
*
|
|
45
|
+
* const head = createServerHead();
|
|
46
|
+
* const html = renderToString(() => createComponent(App, {}), { head });
|
|
47
|
+
* const page = `<!doctype html><head>${head.html()}</head><body>${html}</body>`;
|
|
48
|
+
* @see useHead
|
|
49
|
+
* @since 1.0.0
|
|
50
|
+
*/
|
|
51
|
+
export declare function createServerHead(): ServerHead;
|
|
52
|
+
//# sourceMappingURL=server-head.d.ts.map
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { escapeHtml } from "../server/escape.js";
|
|
2
|
+
import { createHeadRegistry } from "./registry.js";
|
|
3
|
+
import { HEAD_KEY, HEAD_MARKER } from "./validate.js";
|
|
4
|
+
import { createContext } from "@shadow-js/core";
|
|
5
|
+
// src/head/server-head.ts
|
|
6
|
+
/** Elements that never have content or a closing tag. */
|
|
7
|
+
const VOID_TAGS = /* @__PURE__ */ new Set([
|
|
8
|
+
"meta",
|
|
9
|
+
"link",
|
|
10
|
+
"base"
|
|
11
|
+
]);
|
|
12
|
+
/** The collector `useHead` writes to while a render is running; null outside a render with `head`. @internal */
|
|
13
|
+
const ServerHeadContext = /* @__PURE__ */ createContext(null, { name: "ServerHead" });
|
|
14
|
+
/** Markup of one tag. Text and attribute values are escaped; `</style` cannot appear in a style. */
|
|
15
|
+
function tagHtml(tag, nonce) {
|
|
16
|
+
let attributes = ` ${HEAD_MARKER}`;
|
|
17
|
+
if (tag.key !== void 0) attributes += ` ${HEAD_KEY}="${escapeHtml(tag.key)}"`;
|
|
18
|
+
for (const [name, value] of tag.attributes) attributes += value === "" ? ` ${name}` : ` ${name}="${escapeHtml(value)}"`;
|
|
19
|
+
if (VOID_TAGS.has(tag.tag)) return `<${tag.tag}${attributes}>`;
|
|
20
|
+
const text = tag.text ?? "";
|
|
21
|
+
if (tag.tag === "style") {
|
|
22
|
+
if (/<\/style/i.test(text)) throw new TypeError("ShadowJS head: style text may not contain a closing style tag.");
|
|
23
|
+
return `<style${nonce === void 0 ? attributes : `${attributes} nonce="${escapeHtml(nonce)}"`}>${text}</style>`;
|
|
24
|
+
}
|
|
25
|
+
return `<${tag.tag}${attributes}>${escapeHtml(text)}</${tag.tag}>`;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Creates an empty server head collector.
|
|
29
|
+
*
|
|
30
|
+
* @returns A collector to pass as the `head` option of `renderToString`, `renderToStringAsync` or
|
|
31
|
+
* `renderToStream`.
|
|
32
|
+
* @example
|
|
33
|
+
* import { createComponent, Title } from "@shadow-js/web";
|
|
34
|
+
* import { createServerHead, renderToString } from "@shadow-js/web/server";
|
|
35
|
+
*
|
|
36
|
+
* function App() {
|
|
37
|
+
* return Title({ children: "Home" });
|
|
38
|
+
* }
|
|
39
|
+
*
|
|
40
|
+
* const head = createServerHead();
|
|
41
|
+
* const html = renderToString(() => createComponent(App, {}), { head });
|
|
42
|
+
* const page = `<!doctype html><head>${head.html()}</head><body>${html}</body>`;
|
|
43
|
+
* @see useHead
|
|
44
|
+
* @since 1.0.0
|
|
45
|
+
*/
|
|
46
|
+
function createServerHead() {
|
|
47
|
+
let registry = createHeadRegistry(() => void 0);
|
|
48
|
+
return {
|
|
49
|
+
add: (tags) => registry.add(tags),
|
|
50
|
+
clear() {
|
|
51
|
+
registry = createHeadRegistry(() => void 0);
|
|
52
|
+
},
|
|
53
|
+
html: (options) => registry.winners().map((winner) => tagHtml(winner.tag, options?.nonce)).join(""),
|
|
54
|
+
tags: () => registry.winners().map((winner) => winner.tag)
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Runs `fn` with `head` as the collector `useHead` writes to. Server renderers call it around the
|
|
59
|
+
* app; with no collector `fn` runs as is. @internal
|
|
60
|
+
*/
|
|
61
|
+
function runWithServerHead(head, fn) {
|
|
62
|
+
if (head === void 0) return fn();
|
|
63
|
+
const holder = {};
|
|
64
|
+
ServerHeadContext({
|
|
65
|
+
value: head,
|
|
66
|
+
get children() {
|
|
67
|
+
holder.value = fn();
|
|
68
|
+
return null;
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
return holder.value;
|
|
72
|
+
}
|
|
73
|
+
export { ServerHeadContext, createServerHead, runWithServerHead };
|
|
74
|
+
|
|
75
|
+
//# sourceMappingURL=server-head.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server-head.js","names":[],"sources":["../../../src/head/server-head.ts"],"sourcesContent":["import { type Context, createContext } from \"@shadow-js/core\";\nimport { escapeHtml } from \"../server/escape\";\nimport { createHeadRegistry, type HeadRegistry } from \"./registry\";\nimport { HEAD_KEY, HEAD_MARKER, type NormalizedTag } from \"./validate\";\n\n/** Elements that never have content or a closing tag. */\nconst VOID_TAGS: ReadonlySet<string> = new Set([\"meta\", \"link\", \"base\"]);\n\n/**\n * The head of one server render: what `useHead`, `<Title>`, `<Meta>`, `<Link>`, `<Style>` and\n * `<Base>` registered while the app rendered. Pass it to a render function through its `head`\n * option, then write {@link ServerHead.html} into the document's `<head>`.\n *\n * Tags follow the same rules as in the browser: the last registration of an identity wins\n * (`title`, `meta` by name, ...), append-only tags all stay. Every tag carries the marker the\n * browser's head sink looks for, so the client adopts the server's elements instead of adding\n * duplicates.\n * @since 1.0.0\n */\nexport interface ServerHead {\n /** Registers tags. Used by `useHead`; the returned function removes them again. */\n add(tags: readonly NormalizedTag[]): () => void;\n /** Forgets every registration. Multi-pass renders call this before each pass. */\n clear(): void;\n /**\n * The markup of the winning tags, in registration order. With a `nonce`, every `<style>` carries\n * it, so the page's Content-Security-Policy (`style-src 'nonce-...'`) accepts the styles. Throws a\n * TypeError when the text of a style contains a closing style tag.\n *\n * @param options `nonce` is added to every `<style>`. Default: no options, so no nonce.\n */\n html(options?: { readonly nonce?: string }): string;\n /** The winning tags, for hosts that build the head themselves. */\n tags(): readonly NormalizedTag[];\n}\n\n/** The collector `useHead` writes to while a render is running; null outside a render with `head`. @internal */\nexport const ServerHeadContext: Context<ServerHead | null> =\n /* @__PURE__ */ createContext<ServerHead | null>(null, { name: \"ServerHead\" });\n\n/** Markup of one tag. Text and attribute values are escaped; `</style` cannot appear in a style. */\nfunction tagHtml(tag: NormalizedTag, nonce: string | undefined): string {\n let attributes = ` ${HEAD_MARKER}`;\n if (tag.key !== undefined) attributes += ` ${HEAD_KEY}=\"${escapeHtml(tag.key)}\"`;\n for (const [name, value] of tag.attributes) {\n attributes += value === \"\" ? ` ${name}` : ` ${name}=\"${escapeHtml(value)}\"`;\n }\n if (VOID_TAGS.has(tag.tag)) return `<${tag.tag}${attributes}>`;\n const text = tag.text ?? \"\";\n if (tag.tag === \"style\") {\n if (/<\\/style/i.test(text)) {\n throw new TypeError(\"ShadowJS head: style text may not contain a closing style tag.\");\n }\n const withNonce =\n nonce === undefined ? attributes : `${attributes} nonce=\"${escapeHtml(nonce)}\"`;\n return `<style${withNonce}>${text}</style>`;\n }\n return `<${tag.tag}${attributes}>${escapeHtml(text)}</${tag.tag}>`;\n}\n\n/**\n * Creates an empty server head collector.\n *\n * @returns A collector to pass as the `head` option of `renderToString`, `renderToStringAsync` or\n * `renderToStream`.\n * @example\n * import { createComponent, Title } from \"@shadow-js/web\";\n * import { createServerHead, renderToString } from \"@shadow-js/web/server\";\n *\n * function App() {\n * return Title({ children: \"Home\" });\n * }\n *\n * const head = createServerHead();\n * const html = renderToString(() => createComponent(App, {}), { head });\n * const page = `<!doctype html><head>${head.html()}</head><body>${html}</body>`;\n * @see useHead\n * @since 1.0.0\n */\nexport function createServerHead(): ServerHead {\n let registry: HeadRegistry = createHeadRegistry(() => undefined);\n return {\n add: (tags) => registry.add(tags),\n clear() {\n registry = createHeadRegistry(() => undefined);\n },\n html: (options) =>\n registry\n .winners()\n .map((winner) => tagHtml(winner.tag, options?.nonce))\n .join(\"\"),\n tags: () => registry.winners().map((winner) => winner.tag),\n };\n}\n\n/**\n * Runs `fn` with `head` as the collector `useHead` writes to. Server renderers call it around the\n * app; with no collector `fn` runs as is. @internal\n */\nexport function runWithServerHead<T>(head: ServerHead | undefined, fn: () => T): T {\n if (head === undefined) return fn();\n const holder: { value?: T } = {};\n ServerHeadContext({\n value: head,\n get children() {\n holder.value = fn();\n return null;\n },\n });\n return holder.value as T;\n}\n"],"mappings":";;;;;;AAMA,MAAM,4BAAiC,IAAI,IAAI;CAAC;CAAQ;CAAQ;AAAM,CAAC;;AA+BvE,MAAa,oBACK,8BAAiC,MAAM,EAAE,MAAM,aAAa,CAAC;;AAG/E,SAAS,QAAQ,KAAoB,OAAmC;CACtE,IAAI,aAAa,IAAI;CACrB,IAAI,IAAI,QAAQ,KAAA,GAAW,cAAc,IAAI,SAAS,IAAI,WAAW,IAAI,GAAG,EAAE;CAC9E,KAAK,MAAM,CAAC,MAAM,UAAU,IAAI,YAC9B,cAAc,UAAU,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,WAAW,KAAK,EAAE;CAE3E,IAAI,UAAU,IAAI,IAAI,GAAG,GAAG,OAAO,IAAI,IAAI,MAAM,WAAW;CAC5D,MAAM,OAAO,IAAI,QAAQ;CACzB,IAAI,IAAI,QAAQ,SAAS;EACvB,IAAI,YAAY,KAAK,IAAI,GACvB,MAAM,IAAI,UAAU,gEAAgE;EAItF,OAAO,SADL,UAAU,KAAA,IAAY,aAAa,GAAG,WAAW,UAAU,WAAW,KAAK,EAAE,GACrD,GAAG,KAAK;CACpC;CACA,OAAO,IAAI,IAAI,MAAM,WAAW,GAAG,WAAW,IAAI,EAAE,IAAI,IAAI,IAAI;AAClE;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAA+B;CAC7C,IAAI,WAAyB,yBAAyB,KAAA,CAAS;CAC/D,OAAO;EACL,MAAM,SAAS,SAAS,IAAI,IAAI;EAChC,QAAQ;GACN,WAAW,yBAAyB,KAAA,CAAS;EAC/C;EACA,OAAO,YACL,SACG,QAAQ,CAAC,CACT,KAAK,WAAW,QAAQ,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,CACpD,KAAK,EAAE;EACZ,YAAY,SAAS,QAAQ,CAAC,CAAC,KAAK,WAAW,OAAO,GAAG;CAC3D;AACF;;;;;AAMA,SAAgB,kBAAqB,MAA8B,IAAgB;CACjF,IAAI,SAAS,KAAA,GAAW,OAAO,GAAG;CAClC,MAAM,SAAwB,CAAC;CAC/B,kBAAkB;EAChB,OAAO;EACP,IAAI,WAAW;GACb,OAAO,QAAQ,GAAG;GAClB,OAAO;EACT;CACF,CAAC;CACD,OAAO,OAAO;AAChB"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { HEAD_KEY, HEAD_MARKER, identityOfElement } from "./validate.js";
|
|
2
|
+
// src/head/sink.ts
|
|
3
|
+
/** Removes or restores one element the sink owned. Elements already gone are ignored. */
|
|
4
|
+
function release(head, record) {
|
|
5
|
+
const el = record.el;
|
|
6
|
+
if (el.parentNode !== head) return;
|
|
7
|
+
if (el.localName === "title" && !record.created) {
|
|
8
|
+
if (record.restoreText !== void 0 && el.textContent !== record.restoreText) el.textContent = record.restoreText;
|
|
9
|
+
return;
|
|
10
|
+
}
|
|
11
|
+
el.remove();
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Finds an element to adopt for a slot, or returns undefined. Only identity-keyed slots adopt. A
|
|
15
|
+
* server-rendered element carries the marker, and a page title or base is adopted even without it,
|
|
16
|
+
* because the browser shows that one, so it must be the one that changes.
|
|
17
|
+
*/
|
|
18
|
+
function adoptable(head, slot, tag, claimed) {
|
|
19
|
+
if (tag.identity === void 0) return void 0;
|
|
20
|
+
for (const candidate of Array.from(head.querySelectorAll(tag.tag))) {
|
|
21
|
+
if (claimed.has(candidate)) continue;
|
|
22
|
+
if (identityOfElement(candidate) !== slot) continue;
|
|
23
|
+
if (candidate.hasAttribute("data-shadow-head") || tag.tag === "title") return candidate;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/** Takes over an existing element for a slot, or creates and marks a new one. */
|
|
27
|
+
function acquire(doc, slot, tag, claimed) {
|
|
28
|
+
const head = doc.head;
|
|
29
|
+
const existing = adoptable(head, slot, tag, claimed);
|
|
30
|
+
if (existing !== void 0) return {
|
|
31
|
+
el: existing,
|
|
32
|
+
created: false,
|
|
33
|
+
restoreText: tag.tag === "title" ? existing.textContent : void 0,
|
|
34
|
+
attributes: []
|
|
35
|
+
};
|
|
36
|
+
const el = doc.createElement(tag.tag);
|
|
37
|
+
el.setAttribute(HEAD_MARKER, "");
|
|
38
|
+
if (tag.key !== void 0) el.setAttribute(HEAD_KEY, tag.key);
|
|
39
|
+
if (tag.tag === "base") head.insertBefore(el, head.firstChild);
|
|
40
|
+
else head.appendChild(el);
|
|
41
|
+
return {
|
|
42
|
+
el,
|
|
43
|
+
created: true,
|
|
44
|
+
restoreText: void 0,
|
|
45
|
+
attributes: []
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
/** Writes the attributes and text of `tag` to its element, touching only what changed. */
|
|
49
|
+
function sync(record, tag) {
|
|
50
|
+
const el = record.el;
|
|
51
|
+
const wanted = new Map(tag.attributes);
|
|
52
|
+
for (const [name] of record.attributes) if (!wanted.has(name)) el.removeAttribute(name);
|
|
53
|
+
for (const [name, value] of tag.attributes) if (el.getAttribute(name) !== value) el.setAttribute(name, value);
|
|
54
|
+
record.attributes = tag.attributes;
|
|
55
|
+
if (tag.tag === "title" || tag.tag === "style") {
|
|
56
|
+
const text = tag.text ?? "";
|
|
57
|
+
if (el.textContent !== text) el.textContent = text;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Creates the DOM sink for one document. The returned function makes `document.head` show the
|
|
62
|
+
* given winners: it releases elements whose slot is gone, adopts or creates the rest and updates
|
|
63
|
+
* them in place. It is called once per batch of registrations, so one call is one DOM pass.
|
|
64
|
+
*
|
|
65
|
+
* @param doc The document whose head is written.
|
|
66
|
+
* @returns A function that applies a list of winners.
|
|
67
|
+
* @internal
|
|
68
|
+
* @since 1.0.0
|
|
69
|
+
*/
|
|
70
|
+
function createDomHeadSink(doc) {
|
|
71
|
+
const owned = /* @__PURE__ */ new Map();
|
|
72
|
+
return (winners) => {
|
|
73
|
+
const head = doc.head;
|
|
74
|
+
const wanted = new Set(winners.map((winner) => winner.slot));
|
|
75
|
+
for (const [slot, record] of owned) {
|
|
76
|
+
if (wanted.has(slot) && record.el.parentNode === head) continue;
|
|
77
|
+
owned.delete(slot);
|
|
78
|
+
release(head, record);
|
|
79
|
+
}
|
|
80
|
+
const claimed = /* @__PURE__ */ new Set();
|
|
81
|
+
for (const record of owned.values()) claimed.add(record.el);
|
|
82
|
+
for (const winner of winners) {
|
|
83
|
+
let record = owned.get(winner.slot);
|
|
84
|
+
if (record === void 0) {
|
|
85
|
+
record = acquire(doc, winner.slot, winner.tag, claimed);
|
|
86
|
+
owned.set(winner.slot, record);
|
|
87
|
+
claimed.add(record.el);
|
|
88
|
+
}
|
|
89
|
+
sync(record, winner.tag);
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
export { createDomHeadSink };
|
|
94
|
+
|
|
95
|
+
//# sourceMappingURL=sink.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sink.js","names":[],"sources":["../../../src/head/sink.ts"],"sourcesContent":["import type { HeadWinner } from \"./registry\";\nimport { HEAD_KEY, HEAD_MARKER, identityOfElement, type NormalizedTag } from \"./validate\";\n\n/**\n * What the sink knows about one element it writes. `created` elements are removed on release;\n * adopted ones are removed too unless they are titles, where the original text comes back.\n */\ninterface Owned {\n readonly el: Element;\n readonly created: boolean;\n /** Text an adopted title had before the sink took it over. */\n readonly restoreText: string | undefined;\n /** Attributes last written, so the next write can remove the ones that disappeared. */\n attributes: ReadonlyArray<readonly [string, string]>;\n}\n\n/** Removes or restores one element the sink owned. Elements already gone are ignored. */\nfunction release(head: HTMLHeadElement, record: Owned): void {\n const el = record.el;\n if (el.parentNode !== head) return;\n if (el.localName === \"title\" && !record.created) {\n if (record.restoreText !== undefined && el.textContent !== record.restoreText) {\n el.textContent = record.restoreText;\n }\n return;\n }\n el.remove();\n}\n\n/**\n * Finds an element to adopt for a slot, or returns undefined. Only identity-keyed slots adopt. A\n * server-rendered element carries the marker, and a page title or base is adopted even without it,\n * because the browser shows that one, so it must be the one that changes.\n */\nfunction adoptable(\n head: HTMLHeadElement,\n slot: string,\n tag: NormalizedTag,\n claimed: Set<Element>,\n): Element | undefined {\n if (tag.identity === undefined) return undefined;\n for (const candidate of Array.from(head.querySelectorAll(tag.tag))) {\n if (claimed.has(candidate)) continue;\n if (identityOfElement(candidate) !== slot) continue;\n if (candidate.hasAttribute(HEAD_MARKER) || tag.tag === \"title\") return candidate;\n }\n return undefined;\n}\n\n/** Takes over an existing element for a slot, or creates and marks a new one. */\nfunction acquire(doc: Document, slot: string, tag: NormalizedTag, claimed: Set<Element>): Owned {\n const head = doc.head;\n const existing = adoptable(head, slot, tag, claimed);\n if (existing !== undefined) {\n const restoreText = tag.tag === \"title\" ? existing.textContent : undefined;\n return { el: existing, created: false, restoreText, attributes: [] };\n }\n const el = doc.createElement(tag.tag);\n el.setAttribute(HEAD_MARKER, \"\");\n if (tag.key !== undefined) el.setAttribute(HEAD_KEY, tag.key);\n if (tag.tag === \"base\") head.insertBefore(el, head.firstChild);\n else head.appendChild(el);\n return { el, created: true, restoreText: undefined, attributes: [] };\n}\n\n/** Writes the attributes and text of `tag` to its element, touching only what changed. */\nfunction sync(record: Owned, tag: NormalizedTag): void {\n const el = record.el;\n const wanted = new Map<string, string>(tag.attributes);\n for (const [name] of record.attributes) {\n if (!wanted.has(name)) el.removeAttribute(name);\n }\n for (const [name, value] of tag.attributes) {\n if (el.getAttribute(name) !== value) el.setAttribute(name, value);\n }\n record.attributes = tag.attributes;\n if (tag.tag === \"title\" || tag.tag === \"style\") {\n const text = tag.text ?? \"\";\n if (el.textContent !== text) el.textContent = text;\n }\n}\n\n/**\n * Creates the DOM sink for one document. The returned function makes `document.head` show the\n * given winners: it releases elements whose slot is gone, adopts or creates the rest and updates\n * them in place. It is called once per batch of registrations, so one call is one DOM pass.\n *\n * @param doc The document whose head is written.\n * @returns A function that applies a list of winners.\n * @internal\n * @since 1.0.0\n */\nexport function createDomHeadSink(doc: Document): (winners: readonly HeadWinner[]) => void {\n const owned = new Map<string, Owned>();\n return (winners: readonly HeadWinner[]): void => {\n const head = doc.head;\n const wanted = new Set(winners.map((winner) => winner.slot));\n for (const [slot, record] of owned) {\n if (wanted.has(slot) && record.el.parentNode === head) continue;\n owned.delete(slot);\n release(head, record);\n }\n const claimed = new Set<Element>();\n for (const record of owned.values()) claimed.add(record.el);\n for (const winner of winners) {\n let record = owned.get(winner.slot);\n if (record === undefined) {\n record = acquire(doc, winner.slot, winner.tag, claimed);\n owned.set(winner.slot, record);\n claimed.add(record.el);\n }\n sync(record, winner.tag);\n }\n };\n}\n"],"mappings":";;;AAiBA,SAAS,QAAQ,MAAuB,QAAqB;CAC3D,MAAM,KAAK,OAAO;CAClB,IAAI,GAAG,eAAe,MAAM;CAC5B,IAAI,GAAG,cAAc,WAAW,CAAC,OAAO,SAAS;EAC/C,IAAI,OAAO,gBAAgB,KAAA,KAAa,GAAG,gBAAgB,OAAO,aAChE,GAAG,cAAc,OAAO;EAE1B;CACF;CACA,GAAG,OAAO;AACZ;;;;;;AAOA,SAAS,UACP,MACA,MACA,KACA,SACqB;CACrB,IAAI,IAAI,aAAa,KAAA,GAAW,OAAO,KAAA;CACvC,KAAK,MAAM,aAAa,MAAM,KAAK,KAAK,iBAAiB,IAAI,GAAG,CAAC,GAAG;EAClE,IAAI,QAAQ,IAAI,SAAS,GAAG;EAC5B,IAAI,kBAAkB,SAAS,MAAM,MAAM;EAC3C,IAAI,UAAU,aAAA,kBAAwB,KAAK,IAAI,QAAQ,SAAS,OAAO;CACzE;AAEF;;AAGA,SAAS,QAAQ,KAAe,MAAc,KAAoB,SAA8B;CAC9F,MAAM,OAAO,IAAI;CACjB,MAAM,WAAW,UAAU,MAAM,MAAM,KAAK,OAAO;CACnD,IAAI,aAAa,KAAA,GAEf,OAAO;EAAE,IAAI;EAAU,SAAS;EAAO,aADnB,IAAI,QAAQ,UAAU,SAAS,cAAc,KAAA;EACb,YAAY,CAAC;CAAE;CAErE,MAAM,KAAK,IAAI,cAAc,IAAI,GAAG;CACpC,GAAG,aAAa,aAAa,EAAE;CAC/B,IAAI,IAAI,QAAQ,KAAA,GAAW,GAAG,aAAa,UAAU,IAAI,GAAG;CAC5D,IAAI,IAAI,QAAQ,QAAQ,KAAK,aAAa,IAAI,KAAK,UAAU;MACxD,KAAK,YAAY,EAAE;CACxB,OAAO;EAAE;EAAI,SAAS;EAAM,aAAa,KAAA;EAAW,YAAY,CAAC;CAAE;AACrE;;AAGA,SAAS,KAAK,QAAe,KAA0B;CACrD,MAAM,KAAK,OAAO;CAClB,MAAM,SAAS,IAAI,IAAoB,IAAI,UAAU;CACrD,KAAK,MAAM,CAAC,SAAS,OAAO,YAC1B,IAAI,CAAC,OAAO,IAAI,IAAI,GAAG,GAAG,gBAAgB,IAAI;CAEhD,KAAK,MAAM,CAAC,MAAM,UAAU,IAAI,YAC9B,IAAI,GAAG,aAAa,IAAI,MAAM,OAAO,GAAG,aAAa,MAAM,KAAK;CAElE,OAAO,aAAa,IAAI;CACxB,IAAI,IAAI,QAAQ,WAAW,IAAI,QAAQ,SAAS;EAC9C,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,GAAG,gBAAgB,MAAM,GAAG,cAAc;CAChD;AACF;;;;;;;;;;;AAYA,SAAgB,kBAAkB,KAAyD;CACzF,MAAM,wBAAQ,IAAI,IAAmB;CACrC,QAAQ,YAAyC;EAC/C,MAAM,OAAO,IAAI;EACjB,MAAM,SAAS,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC;EAC3D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO;GAClC,IAAI,OAAO,IAAI,IAAI,KAAK,OAAO,GAAG,eAAe,MAAM;GACvD,MAAM,OAAO,IAAI;GACjB,QAAQ,MAAM,MAAM;EACtB;EACA,MAAM,0BAAU,IAAI,IAAa;EACjC,KAAK,MAAM,UAAU,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE;EAC1D,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,SAAS,MAAM,IAAI,OAAO,IAAI;GAClC,IAAI,WAAW,KAAA,GAAW;IACxB,SAAS,QAAQ,KAAK,OAAO,MAAM,OAAO,KAAK,OAAO;IACtD,MAAM,IAAI,OAAO,MAAM,MAAM;IAC7B,QAAQ,IAAI,OAAO,EAAE;GACvB;GACA,KAAK,QAAQ,OAAO,GAAG;EACzB;CACF;AACF"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { HeadInput } from "./validate.js";
|
|
2
|
+
/**
|
|
3
|
+
* Registers head tags for the lifetime of the current owner. Each registration joins the stack of
|
|
4
|
+
* its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,
|
|
5
|
+
* http-equiv or charset (and media), icons by rel, sizes and type, resource links by rel, href and
|
|
6
|
+
* as, and styles by key. The last registration of an identity wins; disposing it restores the one
|
|
7
|
+
* below. Append-only tags (no identity) all stay. Passing a function re-registers when its
|
|
8
|
+
* dependencies change. On the client the registrations are written to `document.head` after the
|
|
9
|
+
* render phase of a flush, in one pass per flush. On the server the tags go to the render's `head`
|
|
10
|
+
* collector (see `createServerHead`), read once; without one, or outside an owner, nothing is
|
|
11
|
+
* registered.
|
|
12
|
+
*
|
|
13
|
+
* @param input One tag, several tags, or a function returning them. `null`, `undefined` and `false`
|
|
14
|
+
* register nothing.
|
|
15
|
+
* @throws TypeError for an invalid tag description (see {@link normalizeTags}); on the client the
|
|
16
|
+
* error is raised in the registration's render effect and goes to the owner's error handler.
|
|
17
|
+
* In development builds, calling it on the client with no owner does not throw: it warns
|
|
18
|
+
* `HEAD_OUTSIDE_OWNER` and registers nothing.
|
|
19
|
+
* @example
|
|
20
|
+
* import { useSignal } from "@shadow-js/core";
|
|
21
|
+
* import { useHead } from "@shadow-js/web";
|
|
22
|
+
*
|
|
23
|
+
* function Post() {
|
|
24
|
+
* const [post] = useSignal({ title: "Hello" });
|
|
25
|
+
* useHead(() => ({ tag: "title", children: `${post().title} | Blog` }));
|
|
26
|
+
* return null;
|
|
27
|
+
* }
|
|
28
|
+
* @see Title
|
|
29
|
+
* @see Meta
|
|
30
|
+
* @since 1.0.0
|
|
31
|
+
*/
|
|
32
|
+
export declare function useHead(input: HeadInput | (() => HeadInput)): void;
|
|
33
|
+
//# sourceMappingURL=use-head.d.ts.map
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { createHeadRegistry } from "./registry.js";
|
|
2
|
+
import { normalizeTags } from "./validate.js";
|
|
3
|
+
import { ServerHeadContext } from "./server-head.js";
|
|
4
|
+
import { createDomHeadSink } from "./sink.js";
|
|
5
|
+
import { createRoot, getOwner, isServer, untrack, useContext, useEffect, useRenderEffect, useSignal } from "@shadow-js/core";
|
|
6
|
+
// src/head/use-head.ts
|
|
7
|
+
/** One registry per document, shared by every `useHead` call on it. */
|
|
8
|
+
const registries = /* @__PURE__ */ new WeakMap();
|
|
9
|
+
/**
|
|
10
|
+
* Creates the registry for a document and the deferred effect that writes it to the head. The
|
|
11
|
+
* effect is detached: it lives as long as the document, not as long as the first caller. It runs
|
|
12
|
+
* in the user-effect queue, so every registration made in one flush produces one DOM pass.
|
|
13
|
+
*/
|
|
14
|
+
function createRegistryFor(doc) {
|
|
15
|
+
return createRoot(() => {
|
|
16
|
+
const [version, bump] = useSignal(0);
|
|
17
|
+
const registry = createHeadRegistry(() => {
|
|
18
|
+
bump((count) => count + 1);
|
|
19
|
+
});
|
|
20
|
+
const apply = createDomHeadSink(doc);
|
|
21
|
+
useEffect(() => {
|
|
22
|
+
version();
|
|
23
|
+
return registry.winners();
|
|
24
|
+
}, (winners) => {
|
|
25
|
+
apply(winners);
|
|
26
|
+
});
|
|
27
|
+
return registry;
|
|
28
|
+
}, { detached: true });
|
|
29
|
+
}
|
|
30
|
+
/** The registry of a document, created on first use. */
|
|
31
|
+
function registryFor(doc) {
|
|
32
|
+
const known = registries.get(doc);
|
|
33
|
+
if (known !== void 0) return known;
|
|
34
|
+
const registry = createRegistryFor(doc);
|
|
35
|
+
registries.set(doc, registry);
|
|
36
|
+
return registry;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Registers head tags for the lifetime of the current owner. Each registration joins the stack of
|
|
40
|
+
* its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,
|
|
41
|
+
* http-equiv or charset (and media), icons by rel, sizes and type, resource links by rel, href and
|
|
42
|
+
* as, and styles by key. The last registration of an identity wins; disposing it restores the one
|
|
43
|
+
* below. Append-only tags (no identity) all stay. Passing a function re-registers when its
|
|
44
|
+
* dependencies change. On the client the registrations are written to `document.head` after the
|
|
45
|
+
* render phase of a flush, in one pass per flush. On the server the tags go to the render's `head`
|
|
46
|
+
* collector (see `createServerHead`), read once; without one, or outside an owner, nothing is
|
|
47
|
+
* registered.
|
|
48
|
+
*
|
|
49
|
+
* @param input One tag, several tags, or a function returning them. `null`, `undefined` and `false`
|
|
50
|
+
* register nothing.
|
|
51
|
+
* @throws TypeError for an invalid tag description (see {@link normalizeTags}); on the client the
|
|
52
|
+
* error is raised in the registration's render effect and goes to the owner's error handler.
|
|
53
|
+
* In development builds, calling it on the client with no owner does not throw: it warns
|
|
54
|
+
* `HEAD_OUTSIDE_OWNER` and registers nothing.
|
|
55
|
+
* @example
|
|
56
|
+
* import { useSignal } from "@shadow-js/core";
|
|
57
|
+
* import { useHead } from "@shadow-js/web";
|
|
58
|
+
*
|
|
59
|
+
* function Post() {
|
|
60
|
+
* const [post] = useSignal({ title: "Hello" });
|
|
61
|
+
* useHead(() => ({ tag: "title", children: `${post().title} | Blog` }));
|
|
62
|
+
* return null;
|
|
63
|
+
* }
|
|
64
|
+
* @see Title
|
|
65
|
+
* @see Meta
|
|
66
|
+
* @since 1.0.0
|
|
67
|
+
*/
|
|
68
|
+
function useHead(input) {
|
|
69
|
+
if (isServer) {
|
|
70
|
+
const collector = getOwner() === null ? null : useContext(ServerHeadContext);
|
|
71
|
+
if (collector !== null) collector.add(normalizeTags(untrack(() => typeof input === "function" ? input() : input)));
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
if (getOwner() === null) {
|
|
75
|
+
console.warn("[shadow HEAD_OUTSIDE_OWNER] useHead() needs an owner; nothing was registered.");
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
const registry = registryFor(document);
|
|
79
|
+
useRenderEffect(() => normalizeTags(typeof input === "function" ? input() : input), (tags) => registry.add(tags));
|
|
80
|
+
}
|
|
81
|
+
export { useHead };
|
|
82
|
+
|
|
83
|
+
//# sourceMappingURL=use-head.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-head.js","names":[],"sources":["../../../src/head/use-head.ts"],"sourcesContent":["import {\n createRoot,\n getOwner,\n isServer,\n untrack,\n useContext,\n useEffect,\n useRenderEffect,\n useSignal,\n} from \"@shadow-js/core\";\nimport { createHeadRegistry, type HeadRegistry } from \"./registry\";\nimport { ServerHeadContext } from \"./server-head\";\nimport { createDomHeadSink } from \"./sink\";\nimport { type HeadInput, normalizeTags } from \"./validate\";\n\n/** One registry per document, shared by every `useHead` call on it. */\nconst registries = new WeakMap<Document, HeadRegistry>();\n\n/**\n * Creates the registry for a document and the deferred effect that writes it to the head. The\n * effect is detached: it lives as long as the document, not as long as the first caller. It runs\n * in the user-effect queue, so every registration made in one flush produces one DOM pass.\n */\nfunction createRegistryFor(doc: Document): HeadRegistry {\n return createRoot(\n (): HeadRegistry => {\n const [version, bump] = useSignal(0);\n const registry = createHeadRegistry(() => {\n bump((count) => count + 1);\n });\n const apply = createDomHeadSink(doc);\n useEffect(\n () => {\n version();\n return registry.winners();\n },\n (winners) => {\n apply(winners);\n },\n );\n return registry;\n },\n { detached: true },\n );\n}\n\n/** The registry of a document, created on first use. */\nfunction registryFor(doc: Document): HeadRegistry {\n const known = registries.get(doc);\n if (known !== undefined) return known;\n const registry = createRegistryFor(doc);\n registries.set(doc, registry);\n return registry;\n}\n\n/**\n * Registers head tags for the lifetime of the current owner. Each registration joins the stack of\n * its identity: `title` and `base` are singletons, `meta` is keyed by its name, property,\n * http-equiv or charset (and media), icons by rel, sizes and type, resource links by rel, href and\n * as, and styles by key. The last registration of an identity wins; disposing it restores the one\n * below. Append-only tags (no identity) all stay. Passing a function re-registers when its\n * dependencies change. On the client the registrations are written to `document.head` after the\n * render phase of a flush, in one pass per flush. On the server the tags go to the render's `head`\n * collector (see `createServerHead`), read once; without one, or outside an owner, nothing is\n * registered.\n *\n * @param input One tag, several tags, or a function returning them. `null`, `undefined` and `false`\n * register nothing.\n * @throws TypeError for an invalid tag description (see {@link normalizeTags}); on the client the\n * error is raised in the registration's render effect and goes to the owner's error handler.\n * In development builds, calling it on the client with no owner does not throw: it warns\n * `HEAD_OUTSIDE_OWNER` and registers nothing.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { useHead } from \"@shadow-js/web\";\n *\n * function Post() {\n * const [post] = useSignal({ title: \"Hello\" });\n * useHead(() => ({ tag: \"title\", children: `${post().title} | Blog` }));\n * return null;\n * }\n * @see Title\n * @see Meta\n * @since 1.0.0\n */\nexport function useHead(input: HeadInput | (() => HeadInput)): void {\n if (isServer) {\n const collector = getOwner() === null ? null : useContext(ServerHeadContext);\n if (collector !== null) {\n collector.add(normalizeTags(untrack(() => (typeof input === \"function\" ? input() : input))));\n }\n return;\n }\n if (getOwner() === null) {\n if (__DEV__) {\n console.warn(\"[shadow HEAD_OUTSIDE_OWNER] useHead() needs an owner; nothing was registered.\");\n }\n return;\n }\n const registry = registryFor(document);\n useRenderEffect(\n () => normalizeTags(typeof input === \"function\" ? input() : input),\n (tags) => registry.add(tags),\n );\n}\n"],"mappings":";;;;;;;AAgBA,MAAM,6BAAa,IAAI,QAAgC;;;;;;AAOvD,SAAS,kBAAkB,KAA6B;CACtD,OAAO,iBACe;EAClB,MAAM,CAAC,SAAS,QAAQ,UAAU,CAAC;EACnC,MAAM,WAAW,yBAAyB;GACxC,MAAM,UAAU,QAAQ,CAAC;EAC3B,CAAC;EACD,MAAM,QAAQ,kBAAkB,GAAG;EACnC,gBACQ;GACJ,QAAQ;GACR,OAAO,SAAS,QAAQ;EAC1B,IACC,YAAY;GACX,MAAM,OAAO;EACf,CACF;EACA,OAAO;CACT,GACA,EAAE,UAAU,KAAK,CACnB;AACF;;AAGA,SAAS,YAAY,KAA6B;CAChD,MAAM,QAAQ,WAAW,IAAI,GAAG;CAChC,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,WAAW,kBAAkB,GAAG;CACtC,WAAW,IAAI,KAAK,QAAQ;CAC5B,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,QAAQ,OAA4C;CAClE,IAAI,UAAU;EACZ,MAAM,YAAY,SAAS,MAAM,OAAO,OAAO,WAAW,iBAAiB;EAC3E,IAAI,cAAc,MAChB,UAAU,IAAI,cAAc,cAAe,OAAO,UAAU,aAAa,MAAM,IAAI,KAAM,CAAC,CAAC;EAE7F;CACF;CACA,IAAI,SAAS,MAAM,MAAM;EAErB,QAAQ,KAAK,+EAA+E;EAE9F;CACF;CACA,MAAM,WAAW,YAAY,QAAQ;CACrC,sBACQ,cAAc,OAAO,UAAU,aAAa,MAAM,IAAI,KAAK,IAChE,SAAS,SAAS,IAAI,IAAI,CAC7B;AACF"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Head elements the registry manages. `script` and `noscript` are refused: a head-registered
|
|
3
|
+
* script would bypass CSP nonces and Trusted Types, so scripts come only from the asset pipeline.
|
|
4
|
+
* @since 1.0.0
|
|
5
|
+
*/
|
|
6
|
+
export type HeadTagName = "title" | "meta" | "link" | "style" | "base";
|
|
7
|
+
/**
|
|
8
|
+
* One attribute value: a string is written as is, `true` as an empty attribute, `false` and
|
|
9
|
+
* `undefined` omit it, and a number is written as text.
|
|
10
|
+
* @since 1.0.0
|
|
11
|
+
*/
|
|
12
|
+
export type HeadAttributeValue = string | number | boolean | undefined;
|
|
13
|
+
/**
|
|
14
|
+
* Describes one head element. `key` identifies a `style` for replacement; other tags use their
|
|
15
|
+
* own identity (see {@link useHead}).
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* import type { HeadTag } from "@shadow-js/web";
|
|
19
|
+
*
|
|
20
|
+
* const description: HeadTag = { tag: "meta", props: { name: "description", content: "Docs" } };
|
|
21
|
+
* @since 1.0.0
|
|
22
|
+
*/
|
|
23
|
+
export interface HeadTag {
|
|
24
|
+
/** The element to register: `title`, `meta`, `link`, `style` or `base`. Any other name throws. */
|
|
25
|
+
readonly tag: HeadTagName;
|
|
26
|
+
/**
|
|
27
|
+
* The attributes of the element. Names are case-insensitive, must be valid attribute names, and
|
|
28
|
+
* may not start with `on`.
|
|
29
|
+
* @default undefined (the element has no attributes)
|
|
30
|
+
*/
|
|
31
|
+
readonly props?: Readonly<Record<string, HeadAttributeValue>>;
|
|
32
|
+
/**
|
|
33
|
+
* The text of a `title` or `style`. Other tags take no text and throw when it is given.
|
|
34
|
+
* @default undefined (no text)
|
|
35
|
+
*/
|
|
36
|
+
readonly children?: string;
|
|
37
|
+
/**
|
|
38
|
+
* Identity of a `style`: a later style with the same key replaces an earlier one. Only `style`
|
|
39
|
+
* takes a key.
|
|
40
|
+
* @default undefined (the style has no identity and always stays)
|
|
41
|
+
*/
|
|
42
|
+
readonly key?: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* What {@link useHead} accepts: one tag, several tags, or nothing (which registers nothing).
|
|
46
|
+
* @since 1.0.0
|
|
47
|
+
*/
|
|
48
|
+
export type HeadInput = HeadTag | readonly HeadTag[] | null | undefined | false;
|
|
49
|
+
/**
|
|
50
|
+
* A validated tag: lower-case attribute names, the text it carries, and its identity. Produced
|
|
51
|
+
* only by {@link normalizeTag}, so the registry and the DOM sink never see unchecked input.
|
|
52
|
+
* @internal
|
|
53
|
+
*/
|
|
54
|
+
export interface NormalizedTag {
|
|
55
|
+
readonly tag: HeadTagName;
|
|
56
|
+
readonly attributes: ReadonlyArray<readonly [string, string]>;
|
|
57
|
+
readonly text: string | undefined;
|
|
58
|
+
readonly key: string | undefined;
|
|
59
|
+
/** Identity that replaces earlier registrations; undefined for append-only tags. */
|
|
60
|
+
readonly identity: string | undefined;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Normalizes what {@link useHead} receives: one description, a list, or nothing.
|
|
64
|
+
*
|
|
65
|
+
* @param input A description, a list of them, or null, undefined or false for none.
|
|
66
|
+
* @returns The normalized tags, in order.
|
|
67
|
+
* @throws TypeError when any description is invalid: an unknown tag (including `script`), an
|
|
68
|
+
* attribute name that is not valid or starts with `on`, a reserved marker attribute, an attribute
|
|
69
|
+
* value that is not a string, number or boolean, children on a tag other than `title` and `style`,
|
|
70
|
+
* or a key on anything but a `style`. The production messages start with `SHADOW_HEAD_`.
|
|
71
|
+
* @example
|
|
72
|
+
* import { normalizeTags } from "@shadow-js/web/server";
|
|
73
|
+
*
|
|
74
|
+
* const tags = normalizeTags([
|
|
75
|
+
* { tag: "title", children: "A" },
|
|
76
|
+
* { tag: "base", props: { href: "/" } },
|
|
77
|
+
* ]);
|
|
78
|
+
* console.log(tags.length); // 2
|
|
79
|
+
* @see useHead
|
|
80
|
+
* @since 1.0.0
|
|
81
|
+
*/
|
|
82
|
+
export declare function normalizeTags(input: unknown): NormalizedTag[];
|
|
83
|
+
//# sourceMappingURL=validate.d.ts.map
|