@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,51 @@
|
|
|
1
|
+
import { withScope } from "./internal/hydration-scope.js";
|
|
2
|
+
import { claims } from "./internal/hydration-hooks.js";
|
|
3
|
+
import { bindRegion, createRegion, removeRegion } from "./insert.js";
|
|
4
|
+
import { attachRootErrors } from "./control-flow/root-errors.js";
|
|
5
|
+
import { batch, createRoot, flushSync, untrack } from "@shadow-js/core";
|
|
6
|
+
// src/render.ts
|
|
7
|
+
/**
|
|
8
|
+
* Mounts `code` into `container`. Creates an owner, inserts the output, flushes the effects, and
|
|
9
|
+
* returns a dispose function that stops the owner and removes the nodes this call inserted. A
|
|
10
|
+
* second render into the same container appends after the first.
|
|
11
|
+
*
|
|
12
|
+
* @param code Runs once, untracked, to build the tree (a component call, a node, text or an array).
|
|
13
|
+
* Return an accessor (for example `() => count`) from it to make the root content reactive.
|
|
14
|
+
* @param container Element, Document or DocumentFragment that receives the output.
|
|
15
|
+
* @param options The root's error reporters (`onUncaughtError`, `onCaughtError`). Undefined sets
|
|
16
|
+
* no reporter.
|
|
17
|
+
* @returns A dispose function, safe to call more than once.
|
|
18
|
+
* @example
|
|
19
|
+
* import { createComponent, render } from "@shadow-js/web";
|
|
20
|
+
*
|
|
21
|
+
* function App() {
|
|
22
|
+
* return "Hello";
|
|
23
|
+
* }
|
|
24
|
+
*
|
|
25
|
+
* const dispose = render(
|
|
26
|
+
* () => createComponent(App, {}),
|
|
27
|
+
* document.getElementById("root") as Element,
|
|
28
|
+
* );
|
|
29
|
+
* dispose(); // stops the root and removes the text it inserted
|
|
30
|
+
* @see hydrate
|
|
31
|
+
* @since 1.0.0
|
|
32
|
+
*/
|
|
33
|
+
function render(code, container, options) {
|
|
34
|
+
const region = createRegion(container, null, void 0);
|
|
35
|
+
const stop = claims.current.withoutClaiming(() => withScope(null, () => batch(() => createRoot((dispose) => {
|
|
36
|
+
if (options !== void 0) attachRootErrors(options);
|
|
37
|
+
bindRegion(region, untrack(code));
|
|
38
|
+
return dispose;
|
|
39
|
+
}))));
|
|
40
|
+
flushSync();
|
|
41
|
+
let disposed = false;
|
|
42
|
+
return () => {
|
|
43
|
+
if (disposed) return;
|
|
44
|
+
disposed = true;
|
|
45
|
+
stop();
|
|
46
|
+
removeRegion(region);
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
export { render };
|
|
50
|
+
|
|
51
|
+
//# sourceMappingURL=render.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render.js","names":[],"sources":["../../src/render.ts"],"sourcesContent":["import { batch, createRoot, flushSync, untrack } from \"@shadow-js/core\";\nimport { attachRootErrors, type RootErrorOptions } from \"./control-flow/root-errors\";\nimport { bindRegion, createRegion, removeRegion } from \"./insert\";\nimport { claims } from \"./internal/hydration-hooks\";\nimport { withScope } from \"./internal/hydration-scope\";\n\n/**\n * Options of {@link render}: the error reporters of the root.\n * @since 1.0.0\n */\nexport type RenderOptions = RootErrorOptions;\n\n/**\n * Mounts `code` into `container`. Creates an owner, inserts the output, flushes the effects, and\n * returns a dispose function that stops the owner and removes the nodes this call inserted. A\n * second render into the same container appends after the first.\n *\n * @param code Runs once, untracked, to build the tree (a component call, a node, text or an array).\n * Return an accessor (for example `() => count`) from it to make the root content reactive.\n * @param container Element, Document or DocumentFragment that receives the output.\n * @param options The root's error reporters (`onUncaughtError`, `onCaughtError`). Undefined sets\n * no reporter.\n * @returns A dispose function, safe to call more than once.\n * @example\n * import { createComponent, render } from \"@shadow-js/web\";\n *\n * function App() {\n * return \"Hello\";\n * }\n *\n * const dispose = render(\n * () => createComponent(App, {}),\n * document.getElementById(\"root\") as Element,\n * );\n * dispose(); // stops the root and removes the text it inserted\n * @see hydrate\n * @since 1.0.0\n */\nexport function render(\n code: () => unknown,\n container: Element | Document | DocumentFragment,\n options?: RenderOptions,\n): () => void {\n const region = createRegion(container, null, undefined);\n // One batch around the build: effects (and anything a resource's batch would flush mid-build)\n // wait until the whole tree exists, so a Suspense boundary knows what is pending before its\n // content's effects are considered.\n // A fresh root never consumes the enclosing hydration pass's nodes or key sequence.\n const stop = claims.current.withoutClaiming(() =>\n withScope(null, () =>\n batch(() =>\n createRoot((dispose) => {\n // An error nothing else took ends here; with onUncaughtError it is reported instead of thrown.\n if (options !== undefined) attachRootErrors(options);\n // The component tree is built once; only accessors inside the result stay reactive.\n bindRegion(region, untrack(code));\n return dispose;\n }),\n ),\n ),\n );\n flushSync();\n let disposed = false;\n return () => {\n if (disposed) return;\n disposed = true;\n stop();\n removeRegion(region);\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,OACd,MACA,WACA,SACY;CACZ,MAAM,SAAS,aAAa,WAAW,MAAM,KAAA,CAAS;CAKtD,MAAM,OAAO,OAAO,QAAQ,sBAC1B,UAAU,YACR,YACE,YAAY,YAAY;EAEtB,IAAI,YAAY,KAAA,GAAW,iBAAiB,OAAO;EAEnD,WAAW,QAAQ,QAAQ,IAAI,CAAC;EAChC,OAAO;CACT,CAAC,CACH,CACF,CACF;CACA,UAAU;CACV,IAAI,WAAW;CACf,aAAa;EACX,IAAI,UAAU;EACd,WAAW;EACX,KAAK;EACL,aAAa,MAAM;CACrB;AACF"}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { useHead } from "./head/use-head.js";
|
|
2
|
+
import { isServer } from "@shadow-js/core";
|
|
3
|
+
// src/resource-hints.ts
|
|
4
|
+
/** Hints are page-level and only ever use http(s) URLs; anything else throws, like head tags do. */
|
|
5
|
+
function checkUrl(href) {
|
|
6
|
+
const url = new URL(href, "https://base.invalid");
|
|
7
|
+
if (url.protocol !== "https:" && url.protocol !== "http:") throw new TypeError(`resource hint: "${href}" must be an http(s) or relative URL`);
|
|
8
|
+
}
|
|
9
|
+
/** Whether an element already carries every attribute of a hint (so the hint is already there). */
|
|
10
|
+
function carries(element, attributes) {
|
|
11
|
+
for (const [name, value] of Object.entries(attributes)) if (element.getAttribute(name) !== value) return false;
|
|
12
|
+
return true;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Inserts a hint element once: an identical element already in the head (server-rendered or added
|
|
16
|
+
* earlier) is kept. On the server the hint joins the render's head collector, when there is one.
|
|
17
|
+
*/
|
|
18
|
+
function hint(tag, attributes, serverTag = () => void 0) {
|
|
19
|
+
if (isServer) {
|
|
20
|
+
serverTag();
|
|
21
|
+
return;
|
|
22
|
+
}
|
|
23
|
+
if (typeof document === "undefined") return;
|
|
24
|
+
for (const existing of document.head.querySelectorAll(tag)) if (carries(existing, attributes)) return;
|
|
25
|
+
const element = document.createElement(tag);
|
|
26
|
+
for (const [name, value] of Object.entries(attributes)) element.setAttribute(name, value);
|
|
27
|
+
document.head.append(element);
|
|
28
|
+
}
|
|
29
|
+
/** Server form of a hint: a head link (scripts cannot be head tags, see {@link preinitModule}). */
|
|
30
|
+
function serverLink(attributes) {
|
|
31
|
+
return () => useHead({
|
|
32
|
+
tag: "link",
|
|
33
|
+
props: attributes
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Tells the browser to open a connection (DNS, TCP, TLS) to an origin the page will use soon.
|
|
38
|
+
* React's `preconnect`. Calling it again for the same origin adds nothing. Works in a component, in
|
|
39
|
+
* an event handler, or at module scope on the client.
|
|
40
|
+
*
|
|
41
|
+
* @param href An http(s) origin or URL.
|
|
42
|
+
* @param options CORS mode (needed for fonts and fetch with credentials). Undefined adds no
|
|
43
|
+
* `crossorigin` attribute.
|
|
44
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or
|
|
45
|
+
* relative.
|
|
46
|
+
* @example
|
|
47
|
+
* import { preconnect } from "@shadow-js/web";
|
|
48
|
+
*
|
|
49
|
+
* preconnect("https://fonts.example.com", { crossOrigin: "anonymous" });
|
|
50
|
+
* @see prefetchDNS
|
|
51
|
+
* @see preload
|
|
52
|
+
* @since 1.0.0
|
|
53
|
+
*/
|
|
54
|
+
function preconnect(href, options) {
|
|
55
|
+
checkUrl(href);
|
|
56
|
+
const attributes = {
|
|
57
|
+
rel: "preconnect",
|
|
58
|
+
href,
|
|
59
|
+
...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
60
|
+
};
|
|
61
|
+
hint("link", attributes, serverLink(attributes));
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Resolves an origin's DNS ahead of use. Cheaper than {@link preconnect}; React's `prefetchDNS`.
|
|
65
|
+
* @param href An http(s) origin or URL.
|
|
66
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
|
|
67
|
+
* @example
|
|
68
|
+
* import { prefetchDNS } from "@shadow-js/web";
|
|
69
|
+
*
|
|
70
|
+
* prefetchDNS("https://api.example.com");
|
|
71
|
+
* @see preconnect
|
|
72
|
+
* @since 1.0.0
|
|
73
|
+
*/
|
|
74
|
+
function prefetchDNS(href) {
|
|
75
|
+
checkUrl(href);
|
|
76
|
+
const attributes = {
|
|
77
|
+
rel: "dns-prefetch",
|
|
78
|
+
href
|
|
79
|
+
};
|
|
80
|
+
hint("link", attributes, serverLink(attributes));
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Starts fetching a resource the page will need, at high priority. The browser stores it for the
|
|
84
|
+
* later request with the same URL and destination (React's `preload`).
|
|
85
|
+
*
|
|
86
|
+
* @param href An http(s) or relative URL.
|
|
87
|
+
* @param options The destination (`as`, required) and the optional type, media and CORS mode.
|
|
88
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
|
|
89
|
+
* @example
|
|
90
|
+
* import { preload } from "@shadow-js/web";
|
|
91
|
+
*
|
|
92
|
+
* preload("/fonts/inter.woff2", { as: "font", type: "font/woff2", crossOrigin: "anonymous" });
|
|
93
|
+
* @see preloadModule
|
|
94
|
+
* @see preinit
|
|
95
|
+
* @since 1.0.0
|
|
96
|
+
*/
|
|
97
|
+
function preload(href, options) {
|
|
98
|
+
checkUrl(href);
|
|
99
|
+
const attributes = {
|
|
100
|
+
rel: "preload",
|
|
101
|
+
href,
|
|
102
|
+
as: options.as,
|
|
103
|
+
...options.type === void 0 ? {} : { type: options.type },
|
|
104
|
+
...options.media === void 0 ? {} : { media: options.media },
|
|
105
|
+
...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
106
|
+
};
|
|
107
|
+
hint("link", attributes, serverLink(attributes));
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Starts loading an ES module the page will import, so the import does not wait for the module
|
|
111
|
+
* graph to be discovered. React's `preloadModule`.
|
|
112
|
+
* @param href An http(s) or relative URL of the module.
|
|
113
|
+
* @param options CORS mode. Undefined adds no `crossorigin` attribute.
|
|
114
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
|
|
115
|
+
* @example
|
|
116
|
+
* import { preloadModule } from "@shadow-js/web";
|
|
117
|
+
*
|
|
118
|
+
* preloadModule("/chunks/editor.js");
|
|
119
|
+
* @see preinitModule
|
|
120
|
+
* @see preload
|
|
121
|
+
* @since 1.0.0
|
|
122
|
+
*/
|
|
123
|
+
function preloadModule(href, options) {
|
|
124
|
+
checkUrl(href);
|
|
125
|
+
const attributes = {
|
|
126
|
+
rel: "modulepreload",
|
|
127
|
+
href,
|
|
128
|
+
...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
129
|
+
};
|
|
130
|
+
hint("link", attributes, serverLink(attributes));
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Loads a stylesheet or script now, and keeps it applied or executed (React's `preinit`). A
|
|
134
|
+
* stylesheet becomes a `<link rel="stylesheet">`; a script becomes an async `<script>` in the head.
|
|
135
|
+
* On the server a script can only be hinted as a preload, because head tags cannot be scripts.
|
|
136
|
+
*
|
|
137
|
+
* @param href An http(s) or relative URL.
|
|
138
|
+
* @param options What to load (`style` or `script`, required) and the CORS mode.
|
|
139
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
|
|
140
|
+
* @example
|
|
141
|
+
* import { preinit } from "@shadow-js/web";
|
|
142
|
+
*
|
|
143
|
+
* preinit("/theme.css", { as: "style" });
|
|
144
|
+
* @see preload
|
|
145
|
+
* @see preinitModule
|
|
146
|
+
* @since 1.0.0
|
|
147
|
+
*/
|
|
148
|
+
function preinit(href, options) {
|
|
149
|
+
checkUrl(href);
|
|
150
|
+
if (options.as === "style") {
|
|
151
|
+
const attributes = {
|
|
152
|
+
rel: "stylesheet",
|
|
153
|
+
href,
|
|
154
|
+
...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
155
|
+
};
|
|
156
|
+
hint("link", attributes, serverLink(attributes));
|
|
157
|
+
return;
|
|
158
|
+
}
|
|
159
|
+
hint("script", {
|
|
160
|
+
src: href,
|
|
161
|
+
async: "",
|
|
162
|
+
...options.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
163
|
+
}, serverLink({
|
|
164
|
+
rel: "preload",
|
|
165
|
+
href,
|
|
166
|
+
as: "script"
|
|
167
|
+
}));
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* Loads and runs an ES module now (React's `preinitModule`). On the client it inserts a
|
|
171
|
+
* `<script type="module">`; on the server it hints the module with `modulepreload`, since the
|
|
172
|
+
* script itself is loaded by the page.
|
|
173
|
+
*
|
|
174
|
+
* @param href An http(s) or relative URL of the module.
|
|
175
|
+
* @param options CORS mode. Undefined adds no `crossorigin` attribute.
|
|
176
|
+
* @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.
|
|
177
|
+
* @example
|
|
178
|
+
* import { preinitModule } from "@shadow-js/web";
|
|
179
|
+
*
|
|
180
|
+
* preinitModule("/chunks/app.js");
|
|
181
|
+
* @see preloadModule
|
|
182
|
+
* @see preinit
|
|
183
|
+
* @since 1.0.0
|
|
184
|
+
*/
|
|
185
|
+
function preinitModule(href, options) {
|
|
186
|
+
checkUrl(href);
|
|
187
|
+
hint("script", {
|
|
188
|
+
src: href,
|
|
189
|
+
type: "module",
|
|
190
|
+
...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
191
|
+
}, serverLink({
|
|
192
|
+
rel: "modulepreload",
|
|
193
|
+
href,
|
|
194
|
+
...options?.crossOrigin === void 0 ? {} : { crossorigin: options.crossOrigin }
|
|
195
|
+
}));
|
|
196
|
+
}
|
|
197
|
+
export { preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule };
|
|
198
|
+
|
|
199
|
+
//# sourceMappingURL=resource-hints.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resource-hints.js","names":[],"sources":["../../src/resource-hints.ts"],"sourcesContent":["import { isServer } from \"@shadow-js/core\";\nimport { useHead } from \"./head/use-head\";\nimport type { HeadAttributeValue } from \"./head/validate\";\n\n/**\n * Options of {@link preconnect}, {@link preloadModule} and {@link preinitModule}.\n * @since 1.0.0\n */\nexport interface CrossOriginOptions {\n /**\n * CORS mode of the connection or request: `\"anonymous\"` sends no credentials, `\"use-credentials\"`\n * sends cookies and client certificates. Fonts and `fetch` preloads need one of them.\n * @default undefined (no `crossorigin` attribute; the browser's default for the resource applies)\n */\n readonly crossOrigin?: \"anonymous\" | \"use-credentials\";\n}\n\n/**\n * Options of {@link preload}: the destination is required, as the browser needs it to pick the\n * right request.\n * @since 1.0.0\n */\nexport interface PreloadOptions extends CrossOriginOptions {\n /**\n * The destination of the request, which the browser uses to pick its priority and headers. It\n * must match how the resource is used later, or the preloaded copy is not reused.\n */\n readonly as:\n | \"audio\"\n | \"document\"\n | \"embed\"\n | \"fetch\"\n | \"font\"\n | \"image\"\n | \"object\"\n | \"script\"\n | \"style\"\n | \"track\"\n | \"video\"\n | \"worker\";\n /**\n * MIME type, so the browser can skip unsupported formats (for example `font/woff2`).\n * @default undefined (no `type` attribute)\n */\n readonly type?: string;\n /**\n * Media query the hint applies to (for example `(min-width: 800px)`); the browser skips the\n * preload when it does not match.\n * @default undefined (no `media` attribute; the hint always applies)\n */\n readonly media?: string;\n}\n\n/**\n * Options of {@link preinit}.\n * @since 1.0.0\n */\nexport interface PreinitOptions extends CrossOriginOptions {\n /**\n * What to load: `\"style\"` inserts a stylesheet, `\"script\"` inserts an async script. Required, as\n * the two produce different elements.\n */\n readonly as: \"style\" | \"script\";\n}\n\ntype Attributes = Readonly<Record<string, string>>;\n\n/** Hints are page-level and only ever use http(s) URLs; anything else throws, like head tags do. */\nfunction checkUrl(href: string): void {\n const url = new URL(href, \"https://base.invalid\");\n if (url.protocol !== \"https:\" && url.protocol !== \"http:\") {\n throw new TypeError(\n __DEV__\n ? `resource hint: \"${href}\" must be an http(s) or relative URL`\n : \"SHADOW_RESOURCE_HINT_URL\",\n );\n }\n}\n\n/** Whether an element already carries every attribute of a hint (so the hint is already there). */\nfunction carries(element: Element, attributes: Attributes): boolean {\n for (const [name, value] of Object.entries(attributes)) {\n if (element.getAttribute(name) !== value) return false;\n }\n return true;\n}\n\n/**\n * Inserts a hint element once: an identical element already in the head (server-rendered or added\n * earlier) is kept. On the server the hint joins the render's head collector, when there is one.\n */\nfunction hint(\n tag: \"link\" | \"script\",\n attributes: Attributes,\n serverTag: () => void = () => undefined,\n): void {\n if (isServer) {\n serverTag();\n return;\n }\n if (typeof document === \"undefined\") return;\n for (const existing of document.head.querySelectorAll(tag)) {\n if (carries(existing, attributes)) return;\n }\n const element = document.createElement(tag);\n for (const [name, value] of Object.entries(attributes)) element.setAttribute(name, value);\n document.head.append(element);\n}\n\n/** Server form of a hint: a head link (scripts cannot be head tags, see {@link preinitModule}). */\nfunction serverLink(attributes: Readonly<Record<string, HeadAttributeValue>>): () => void {\n return () => useHead({ tag: \"link\", props: attributes });\n}\n\n/**\n * Tells the browser to open a connection (DNS, TCP, TLS) to an origin the page will use soon.\n * React's `preconnect`. Calling it again for the same origin adds nothing. Works in a component, in\n * an event handler, or at module scope on the client.\n *\n * @param href An http(s) origin or URL.\n * @param options CORS mode (needed for fonts and fetch with credentials). Undefined adds no\n * `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or\n * relative.\n * @example\n * import { preconnect } from \"@shadow-js/web\";\n *\n * preconnect(\"https://fonts.example.com\", { crossOrigin: \"anonymous\" });\n * @see prefetchDNS\n * @see preload\n * @since 1.0.0\n */\nexport function preconnect(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"preconnect\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Resolves an origin's DNS ahead of use. Cheaper than {@link preconnect}; React's `prefetchDNS`.\n * @param href An http(s) origin or URL.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { prefetchDNS } from \"@shadow-js/web\";\n *\n * prefetchDNS(\"https://api.example.com\");\n * @see preconnect\n * @since 1.0.0\n */\nexport function prefetchDNS(href: string): void {\n checkUrl(href);\n const attributes: Attributes = { rel: \"dns-prefetch\", href };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Starts fetching a resource the page will need, at high priority. The browser stores it for the\n * later request with the same URL and destination (React's `preload`).\n *\n * @param href An http(s) or relative URL.\n * @param options The destination (`as`, required) and the optional type, media and CORS mode.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preload } from \"@shadow-js/web\";\n *\n * preload(\"/fonts/inter.woff2\", { as: \"font\", type: \"font/woff2\", crossOrigin: \"anonymous\" });\n * @see preloadModule\n * @see preinit\n * @since 1.0.0\n */\nexport function preload(href: string, options: PreloadOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"preload\",\n href,\n as: options.as,\n ...(options.type === undefined ? {} : { type: options.type }),\n ...(options.media === undefined ? {} : { media: options.media }),\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Starts loading an ES module the page will import, so the import does not wait for the module\n * graph to be discovered. React's `preloadModule`.\n * @param href An http(s) or relative URL of the module.\n * @param options CORS mode. Undefined adds no `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preloadModule } from \"@shadow-js/web\";\n *\n * preloadModule(\"/chunks/editor.js\");\n * @see preinitModule\n * @see preload\n * @since 1.0.0\n */\nexport function preloadModule(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n rel: \"modulepreload\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n}\n\n/**\n * Loads a stylesheet or script now, and keeps it applied or executed (React's `preinit`). A\n * stylesheet becomes a `<link rel=\"stylesheet\">`; a script becomes an async `<script>` in the head.\n * On the server a script can only be hinted as a preload, because head tags cannot be scripts.\n *\n * @param href An http(s) or relative URL.\n * @param options What to load (`style` or `script`, required) and the CORS mode.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preinit } from \"@shadow-js/web\";\n *\n * preinit(\"/theme.css\", { as: \"style\" });\n * @see preload\n * @see preinitModule\n * @since 1.0.0\n */\nexport function preinit(href: string, options: PreinitOptions): void {\n checkUrl(href);\n if (options.as === \"style\") {\n const attributes: Attributes = {\n rel: \"stylesheet\",\n href,\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"link\", attributes, serverLink(attributes));\n return;\n }\n const attributes: Attributes = {\n src: href,\n async: \"\",\n ...(options.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\"script\", attributes, serverLink({ rel: \"preload\", href, as: \"script\" }));\n}\n\n/**\n * Loads and runs an ES module now (React's `preinitModule`). On the client it inserts a\n * `<script type=\"module\">`; on the server it hints the module with `modulepreload`, since the\n * script itself is loaded by the page.\n *\n * @param href An http(s) or relative URL of the module.\n * @param options CORS mode. Undefined adds no `crossorigin` attribute.\n * @throws TypeError (production message `SHADOW_RESOURCE_HINT_URL`) for a URL that is not http(s) or relative.\n * @example\n * import { preinitModule } from \"@shadow-js/web\";\n *\n * preinitModule(\"/chunks/app.js\");\n * @see preloadModule\n * @see preinit\n * @since 1.0.0\n */\nexport function preinitModule(href: string, options?: CrossOriginOptions): void {\n checkUrl(href);\n const attributes: Attributes = {\n src: href,\n type: \"module\",\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n };\n hint(\n \"script\",\n attributes,\n serverLink({\n rel: \"modulepreload\",\n href,\n ...(options?.crossOrigin === undefined ? {} : { crossorigin: options.crossOrigin }),\n }),\n );\n}\n"],"mappings":";;;;AAoEA,SAAS,SAAS,MAAoB;CACpC,MAAM,MAAM,IAAI,IAAI,MAAM,sBAAsB;CAChD,IAAI,IAAI,aAAa,YAAY,IAAI,aAAa,SAChD,MAAM,IAAI,UAEJ,mBAAmB,KAAK,qCAE9B;AAEJ;;AAGA,SAAS,QAAQ,SAAkB,YAAiC;CAClE,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GACnD,IAAI,QAAQ,aAAa,IAAI,MAAM,OAAO,OAAO;CAEnD,OAAO;AACT;;;;;AAMA,SAAS,KACP,KACA,YACA,kBAA8B,KAAA,GACxB;CACN,IAAI,UAAU;EACZ,UAAU;EACV;CACF;CACA,IAAI,OAAO,aAAa,aAAa;CACrC,KAAK,MAAM,YAAY,SAAS,KAAK,iBAAiB,GAAG,GACvD,IAAI,QAAQ,UAAU,UAAU,GAAG;CAErC,MAAM,UAAU,SAAS,cAAc,GAAG;CAC1C,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GAAG,QAAQ,aAAa,MAAM,KAAK;CACxF,SAAS,KAAK,OAAO,OAAO;AAC9B;;AAGA,SAAS,WAAW,YAAsE;CACxF,aAAa,QAAQ;EAAE,KAAK;EAAQ,OAAO;CAAW,CAAC;AACzD;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,WAAW,MAAc,SAAoC;CAC3E,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;AAaA,SAAgB,YAAY,MAAoB;CAC9C,SAAS,IAAI;CACb,MAAM,aAAyB;EAAE,KAAK;EAAgB;CAAK;CAC3D,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;;AAiBA,SAAgB,QAAQ,MAAc,SAA+B;CACnE,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,IAAI,QAAQ;EACZ,GAAI,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;EAC3D,GAAI,QAAQ,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;EAC9D,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAClF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,MAAc,SAAoC;CAC9E,SAAS,IAAI;CACb,MAAM,aAAyB;EAC7B,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF;CACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;AACjD;;;;;;;;;;;;;;;;;AAkBA,SAAgB,QAAQ,MAAc,SAA+B;CACnE,SAAS,IAAI;CACb,IAAI,QAAQ,OAAO,SAAS;EAC1B,MAAM,aAAyB;GAC7B,KAAK;GACL;GACA,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;EAClF;EACA,KAAK,QAAQ,YAAY,WAAW,UAAU,CAAC;EAC/C;CACF;CAMA,KAAK,UAAU;EAJb,KAAK;EACL,OAAO;EACP,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAE1D,GAAG,WAAW;EAAE,KAAK;EAAW;EAAM,IAAI;CAAS,CAAC,CAAC;AAC/E;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cAAc,MAAc,SAAoC;CAC9E,SAAS,IAAI;CAMb,KACE,UACA;EANA,KAAK;EACL,MAAM;EACN,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAIxE,GACT,WAAW;EACT,KAAK;EACL;EACA,GAAI,SAAS,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CACnF,CAAC,CACH;AACF"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
// src/select-value.ts
|
|
2
|
+
/** The values an array stands for, as strings; null and undefined entries are skipped. */
|
|
3
|
+
function listed(value) {
|
|
4
|
+
const values = /* @__PURE__ */ new Set();
|
|
5
|
+
for (const item of value) if (item !== null && item !== void 0) values.add(String(item));
|
|
6
|
+
return values;
|
|
7
|
+
}
|
|
8
|
+
/** The string a single value assigns to `select.value`; null and undefined clear the choice. */
|
|
9
|
+
function single(value) {
|
|
10
|
+
return value === null || value === void 0 ? "" : String(value);
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Selects the options a `value` stands for. The compiler calls it for `<select value={...}>`. A
|
|
14
|
+
* single value behaves like `select.value = value` (`null` and `undefined` are the empty string).
|
|
15
|
+
* On a `<select multiple>` an array selects exactly the options whose value it lists and clears
|
|
16
|
+
* the others. The server writes the same state as `selected` on the options (`ssrSelectValue`).
|
|
17
|
+
*
|
|
18
|
+
* @param select The select element; its options must already be in it.
|
|
19
|
+
* @param value A string or number (written as `String(value)`), or `null`/`undefined` (written as
|
|
20
|
+
* `""`: an option with an empty value is selected, otherwise none). For a `multiple` select, an array of them: `null` and `undefined`
|
|
21
|
+
* entries are skipped. An array on a single select is written as `String(array)`.
|
|
22
|
+
* @example
|
|
23
|
+
* import { setSelectValue } from "@shadow-js/web";
|
|
24
|
+
*
|
|
25
|
+
* const select = document.createElement("select");
|
|
26
|
+
* select.multiple = true;
|
|
27
|
+
* select.append(new Option("A", "a"), new Option("B", "b"), new Option("C", "c"));
|
|
28
|
+
* setSelectValue(select, ["a", "c"]); // A and C selected, B cleared
|
|
29
|
+
* @see ssrSelectValue
|
|
30
|
+
* @since 1.0.0
|
|
31
|
+
*/
|
|
32
|
+
function setSelectValue(select, value) {
|
|
33
|
+
if (select.multiple && Array.isArray(value)) {
|
|
34
|
+
const wanted = listed(value);
|
|
35
|
+
for (const option of Array.from(select.options)) option.selected = wanted.has(option.value);
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
select.value = single(value);
|
|
39
|
+
}
|
|
40
|
+
/** True when the select already shows `value` the way {@link setSelectValue} would leave it. @internal */
|
|
41
|
+
function selectShows(select, value) {
|
|
42
|
+
if (select.multiple && Array.isArray(value)) {
|
|
43
|
+
const wanted = listed(value);
|
|
44
|
+
return Array.from(select.options).every((option) => option.selected === wanted.has(option.value));
|
|
45
|
+
}
|
|
46
|
+
return select.value === single(value);
|
|
47
|
+
}
|
|
48
|
+
export { selectShows, setSelectValue };
|
|
49
|
+
|
|
50
|
+
//# sourceMappingURL=select-value.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"select-value.js","names":[],"sources":["../../src/select-value.ts"],"sourcesContent":["/** The values an array stands for, as strings; null and undefined entries are skipped. */\nfunction listed(value: readonly unknown[]): Set<string> {\n const values = new Set<string>();\n for (const item of value) {\n if (item !== null && item !== undefined) values.add(String(item));\n }\n return values;\n}\n\n/** The string a single value assigns to `select.value`; null and undefined clear the choice. */\nfunction single(value: unknown): string {\n return value === null || value === undefined ? \"\" : String(value);\n}\n\n/**\n * Selects the options a `value` stands for. The compiler calls it for `<select value={...}>`. A\n * single value behaves like `select.value = value` (`null` and `undefined` are the empty string).\n * On a `<select multiple>` an array selects exactly the options whose value it lists and clears\n * the others. The server writes the same state as `selected` on the options (`ssrSelectValue`).\n *\n * @param select The select element; its options must already be in it.\n * @param value A string or number (written as `String(value)`), or `null`/`undefined` (written as\n * `\"\"`: an option with an empty value is selected, otherwise none). For a `multiple` select, an array of them: `null` and `undefined`\n * entries are skipped. An array on a single select is written as `String(array)`.\n * @example\n * import { setSelectValue } from \"@shadow-js/web\";\n *\n * const select = document.createElement(\"select\");\n * select.multiple = true;\n * select.append(new Option(\"A\", \"a\"), new Option(\"B\", \"b\"), new Option(\"C\", \"c\"));\n * setSelectValue(select, [\"a\", \"c\"]); // A and C selected, B cleared\n * @see ssrSelectValue\n * @since 1.0.0\n */\nexport function setSelectValue(select: HTMLSelectElement, value: unknown): void {\n if (select.multiple && Array.isArray(value)) {\n const wanted = listed(value);\n for (const option of Array.from(select.options)) option.selected = wanted.has(option.value);\n return;\n }\n select.value = single(value);\n}\n\n/** True when the select already shows `value` the way {@link setSelectValue} would leave it. @internal */\nexport function selectShows(select: HTMLSelectElement, value: unknown): boolean {\n if (select.multiple && Array.isArray(value)) {\n const wanted = listed(value);\n return Array.from(select.options).every(\n (option) => option.selected === wanted.has(option.value),\n );\n }\n return select.value === single(value);\n}\n"],"mappings":";;AACA,SAAS,OAAO,OAAwC;CACtD,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,QAAQ,OACjB,IAAI,SAAS,QAAQ,SAAS,KAAA,GAAW,OAAO,IAAI,OAAO,IAAI,CAAC;CAElE,OAAO;AACT;;AAGA,SAAS,OAAO,OAAwB;CACtC,OAAO,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAK,OAAO,KAAK;AAClE;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,eAAe,QAA2B,OAAsB;CAC9E,IAAI,OAAO,YAAY,MAAM,QAAQ,KAAK,GAAG;EAC3C,MAAM,SAAS,OAAO,KAAK;EAC3B,KAAK,MAAM,UAAU,MAAM,KAAK,OAAO,OAAO,GAAG,OAAO,WAAW,OAAO,IAAI,OAAO,KAAK;EAC1F;CACF;CACA,OAAO,QAAQ,OAAO,KAAK;AAC7B;;AAGA,SAAgB,YAAY,QAA2B,OAAyB;CAC9E,IAAI,OAAO,YAAY,MAAM,QAAQ,KAAK,GAAG;EAC3C,MAAM,SAAS,OAAO,KAAK;EAC3B,OAAO,MAAM,KAAK,OAAO,OAAO,CAAC,CAAC,OAC/B,WAAW,OAAO,aAAa,OAAO,IAAI,OAAO,KAAK,CACzD;CACF;CACA,OAAO,OAAO,UAAU,OAAO,KAAK;AACtC"}
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
import { invalid } from "./errors.js";
|
|
2
|
+
import { escapeHtml, resolveValue } from "./escape.js";
|
|
3
|
+
// src/server/attributes.ts
|
|
4
|
+
/** Names that can appear in markup: an XML-name subset without `@` or whitespace. Same as the client. */
|
|
5
|
+
const ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
|
|
6
|
+
/** Attributes whose value is a URL and is therefore checked for script schemes. Same as the client. */
|
|
7
|
+
const URL_ATTRIBUTES = /* @__PURE__ */ new Set([
|
|
8
|
+
"href",
|
|
9
|
+
"src",
|
|
10
|
+
"action",
|
|
11
|
+
"formaction",
|
|
12
|
+
"xlink:href",
|
|
13
|
+
"srcdoc",
|
|
14
|
+
"poster",
|
|
15
|
+
"data"
|
|
16
|
+
]);
|
|
17
|
+
/**
|
|
18
|
+
* SVG animation attributes (`animate`, `set`): with `attributeName="href"` they write an `href` by animation, so their value
|
|
19
|
+
* is checked like one. `values` is a `;` list and every entry is checked. Same as the client.
|
|
20
|
+
*/
|
|
21
|
+
const ANIMATION_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
|
|
22
|
+
"values",
|
|
23
|
+
"from",
|
|
24
|
+
"to",
|
|
25
|
+
"by"
|
|
26
|
+
]);
|
|
27
|
+
/** Enumerated attributes where `false` is a real value ("false") rather than an absence. */
|
|
28
|
+
const ENUMERATED_ATTRIBUTES = /* @__PURE__ */ new Set([
|
|
29
|
+
"draggable",
|
|
30
|
+
"spellcheck",
|
|
31
|
+
"contenteditable"
|
|
32
|
+
]);
|
|
33
|
+
/**
|
|
34
|
+
* Boolean attributes that a props object writes as presence flags (`disabled: true` gives a bare
|
|
35
|
+
* `disabled`). Lower-case names only.
|
|
36
|
+
* @internal
|
|
37
|
+
*/
|
|
38
|
+
const BOOLEAN_ATTRIBUTES = /* @__PURE__ */ new Set([
|
|
39
|
+
"async",
|
|
40
|
+
"autofocus",
|
|
41
|
+
"autoplay",
|
|
42
|
+
"checked",
|
|
43
|
+
"controls",
|
|
44
|
+
"default",
|
|
45
|
+
"defer",
|
|
46
|
+
"disabled",
|
|
47
|
+
"formnovalidate",
|
|
48
|
+
"hidden",
|
|
49
|
+
"inert",
|
|
50
|
+
"ismap",
|
|
51
|
+
"loop",
|
|
52
|
+
"multiple",
|
|
53
|
+
"muted",
|
|
54
|
+
"nomodule",
|
|
55
|
+
"novalidate",
|
|
56
|
+
"open",
|
|
57
|
+
"playsinline",
|
|
58
|
+
"readonly",
|
|
59
|
+
"required",
|
|
60
|
+
"reversed",
|
|
61
|
+
"selected"
|
|
62
|
+
]);
|
|
63
|
+
/** URL prefixes (after normalization) that are never written. Same as the client. */
|
|
64
|
+
const UNSAFE_URL_PREFIXES = [
|
|
65
|
+
"javascript:",
|
|
66
|
+
"data:text/html",
|
|
67
|
+
"vbscript:"
|
|
68
|
+
];
|
|
69
|
+
/** Throws a TypeError unless `name` can be written as an attribute name. @internal */
|
|
70
|
+
function assertAttributeName(name) {
|
|
71
|
+
if (!ATTRIBUTE_NAME.test(name)) throw invalid("INVALID_ATTRIBUTE_NAME", `"${name}" is not a valid attribute name.`);
|
|
72
|
+
}
|
|
73
|
+
/** True for `on*` names, which never reach markup. Length matches the client's event test. @internal */
|
|
74
|
+
function isEventName(lowerName) {
|
|
75
|
+
return lowerName.length > 2 && lowerName.startsWith("on");
|
|
76
|
+
}
|
|
77
|
+
/** True for `aria-*`, `data-*` and the enumerated attributes: their booleans are strings. */
|
|
78
|
+
function isStringValued(lowerName) {
|
|
79
|
+
return lowerName.startsWith("aria-") || lowerName.startsWith("data-") || ENUMERATED_ATTRIBUTES.has(lowerName);
|
|
80
|
+
}
|
|
81
|
+
/** Removes C0 and C1 control characters, which browsers ignore inside a URL scheme. */
|
|
82
|
+
function stripControls(text) {
|
|
83
|
+
let kept = "";
|
|
84
|
+
for (const char of text) {
|
|
85
|
+
const code = char.charCodeAt(0);
|
|
86
|
+
if (code > 31 && (code < 127 || code > 159)) kept += char;
|
|
87
|
+
}
|
|
88
|
+
return kept;
|
|
89
|
+
}
|
|
90
|
+
/** True when the URL would run script, after the normalization browsers apply. @internal */
|
|
91
|
+
function isUnsafeUrl(value) {
|
|
92
|
+
const normalized = stripControls(value).trim().toLowerCase();
|
|
93
|
+
return UNSAFE_URL_PREFIXES.some((prefix) => normalized.startsWith(prefix));
|
|
94
|
+
}
|
|
95
|
+
/** True when `lowerName` carries a URL (or an animated one) and `value` would run script. */
|
|
96
|
+
function isUnsafeAttributeValue(lowerName, value) {
|
|
97
|
+
if (URL_ATTRIBUTES.has(lowerName)) return isUnsafeUrl(value);
|
|
98
|
+
return ANIMATION_VALUE_ATTRIBUTES.has(lowerName) && value.split(";").some(isUnsafeUrl);
|
|
99
|
+
}
|
|
100
|
+
/** Text to write for `value`, or null when the attribute is removed. Same rules as the client. @internal */
|
|
101
|
+
function attributeText(lowerName, value) {
|
|
102
|
+
if (value === null || value === void 0) return null;
|
|
103
|
+
if (value === false) return isStringValued(lowerName) ? "false" : null;
|
|
104
|
+
if (value === true) return isStringValued(lowerName) ? "true" : "";
|
|
105
|
+
return String(value);
|
|
106
|
+
}
|
|
107
|
+
/** Refuses symbols, which have no markup form and would otherwise be coerced silently. */
|
|
108
|
+
function assertNotSymbol(value) {
|
|
109
|
+
if (typeof value === "symbol") throw invalid("UNRECOGNIZED_INSERT_VALUE", "A symbol cannot be an attribute value.");
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Renders one attribute as markup with a leading space, or `""` when the attribute is absent: the
|
|
113
|
+
* helper the compiler's server output calls for a dynamic attribute. It applies the client's value
|
|
114
|
+
* rules and URL check, so server and client agree on what is written.
|
|
115
|
+
*
|
|
116
|
+
* - `null`, `undefined` and `false` give `""` (except `false` on `aria-*`, `data-*`, `draggable`,
|
|
117
|
+
* `spellcheck` and `contenteditable`, which is written as `"false"`); `true` writes `=""` (or
|
|
118
|
+
* `"true"` for those same names). Other values are written as `String(value)`, HTML-escaped.
|
|
119
|
+
* - URL attributes whose value would run script are dropped, with the check of
|
|
120
|
+
* `isUnsafeUrlAttribute` (including the SVG animation attributes `values`, `from`, `to`, `by`).
|
|
121
|
+
* - `on*` names are dropped: event handlers never reach markup.
|
|
122
|
+
* - Accessors are called (untracked) until a plain value remains.
|
|
123
|
+
*
|
|
124
|
+
* @param name Attribute name, matching `[A-Za-z_:][A-Za-z0-9_:.-]*`. It is validated before
|
|
125
|
+
* anything else, so an invalid name always throws.
|
|
126
|
+
* @param value The value, or an accessor of it.
|
|
127
|
+
* @param isBoolean `true` for a presence attribute such as `disabled`: a truthy value writes the bare
|
|
128
|
+
* name, a falsy one writes nothing. Default: `false`.
|
|
129
|
+
* @returns Markup such as `' title="a&b"'`, or `""`.
|
|
130
|
+
* @throws TypeError `INVALID_ATTRIBUTE_NAME` for an invalid name, and `UNRECOGNIZED_INSERT_VALUE`
|
|
131
|
+
* when the value is a symbol.
|
|
132
|
+
* @example
|
|
133
|
+
* import { ssrAttribute } from "@shadow-js/web/server";
|
|
134
|
+
*
|
|
135
|
+
* ssrAttribute("title", "Tom & Jerry"); // ' title="Tom & Jerry"'
|
|
136
|
+
* ssrAttribute("disabled", true, true); // " disabled"
|
|
137
|
+
* ssrAttribute("href", "javascript:alert(1)"); // ""
|
|
138
|
+
* @since 1.0.0
|
|
139
|
+
*/
|
|
140
|
+
function ssrAttribute(name, value, isBoolean = false) {
|
|
141
|
+
assertAttributeName(name);
|
|
142
|
+
const lowerName = name.toLowerCase();
|
|
143
|
+
if (isEventName(lowerName)) return "";
|
|
144
|
+
const resolved = resolveValue(value);
|
|
145
|
+
assertNotSymbol(resolved);
|
|
146
|
+
if (isBoolean) return resolved ? ` ${name}` : "";
|
|
147
|
+
const text = attributeText(lowerName, resolved);
|
|
148
|
+
if (text === null) return "";
|
|
149
|
+
if (isUnsafeAttributeValue(lowerName, text)) return "";
|
|
150
|
+
return ` ${name}="${escapeHtml(text)}"`;
|
|
151
|
+
}
|
|
152
|
+
export { BOOLEAN_ATTRIBUTES, assertAttributeName, attributeText, isEventName, isUnsafeUrl, ssrAttribute };
|
|
153
|
+
|
|
154
|
+
//# sourceMappingURL=attributes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"attributes.js","names":[],"sources":["../../../src/server/attributes.ts"],"sourcesContent":["import { invalid } from \"./errors\";\nimport { escapeHtml, resolveValue } from \"./escape\";\n\n/** Names that can appear in markup: an XML-name subset without `@` or whitespace. Same as the client. */\nconst ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;\n\n/** Attributes whose value is a URL and is therefore checked for script schemes. Same as the client. */\nconst URL_ATTRIBUTES: ReadonlySet<string> = new Set([\n \"href\",\n \"src\",\n \"action\",\n \"formaction\",\n \"xlink:href\",\n \"srcdoc\",\n \"poster\",\n \"data\",\n]);\n\n/**\n * SVG animation attributes (`animate`, `set`): with `attributeName=\"href\"` they write an `href` by animation, so their value\n * is checked like one. `values` is a `;` list and every entry is checked. Same as the client.\n */\nconst ANIMATION_VALUE_ATTRIBUTES: ReadonlySet<string> = new Set([\"values\", \"from\", \"to\", \"by\"]);\n\n/** Enumerated attributes where `false` is a real value (\"false\") rather than an absence. */\nconst ENUMERATED_ATTRIBUTES: ReadonlySet<string> = new Set([\n \"draggable\",\n \"spellcheck\",\n \"contenteditable\",\n]);\n\n/**\n * Boolean attributes that a props object writes as presence flags (`disabled: true` gives a bare\n * `disabled`). Lower-case names only.\n * @internal\n */\nexport const BOOLEAN_ATTRIBUTES: ReadonlySet<string> = new Set([\n \"async\",\n \"autofocus\",\n \"autoplay\",\n \"checked\",\n \"controls\",\n \"default\",\n \"defer\",\n \"disabled\",\n \"formnovalidate\",\n \"hidden\",\n \"inert\",\n \"ismap\",\n \"loop\",\n \"multiple\",\n \"muted\",\n \"nomodule\",\n \"novalidate\",\n \"open\",\n \"playsinline\",\n \"readonly\",\n \"required\",\n \"reversed\",\n \"selected\",\n]);\n\n/** URL prefixes (after normalization) that are never written. Same as the client. */\nconst UNSAFE_URL_PREFIXES: readonly string[] = [\"javascript:\", \"data:text/html\", \"vbscript:\"];\n\n/** Throws a TypeError unless `name` can be written as an attribute name. @internal */\nexport function assertAttributeName(name: string): void {\n if (!ATTRIBUTE_NAME.test(name)) {\n throw invalid(\"INVALID_ATTRIBUTE_NAME\", `\"${name}\" is not a valid attribute name.`);\n }\n}\n\n/** True for `on*` names, which never reach markup. Length matches the client's event test. @internal */\nexport function isEventName(lowerName: string): boolean {\n return lowerName.length > 2 && lowerName.startsWith(\"on\");\n}\n\n/** True for `aria-*`, `data-*` and the enumerated attributes: their booleans are strings. */\nfunction isStringValued(lowerName: string): boolean {\n return (\n lowerName.startsWith(\"aria-\") ||\n lowerName.startsWith(\"data-\") ||\n ENUMERATED_ATTRIBUTES.has(lowerName)\n );\n}\n\n/** Removes C0 and C1 control characters, which browsers ignore inside a URL scheme. */\nfunction stripControls(text: string): string {\n let kept = \"\";\n for (const char of text) {\n const code = char.charCodeAt(0);\n if (code > 0x1f && (code < 0x7f || code > 0x9f)) kept += char;\n }\n return kept;\n}\n\n/** True when the URL would run script, after the normalization browsers apply. @internal */\nexport function isUnsafeUrl(value: string): boolean {\n const normalized = stripControls(value).trim().toLowerCase();\n return UNSAFE_URL_PREFIXES.some((prefix) => normalized.startsWith(prefix));\n}\n\n/** True when `lowerName` carries a URL (or an animated one) and `value` would run script. */\nfunction isUnsafeAttributeValue(lowerName: string, value: string): boolean {\n if (URL_ATTRIBUTES.has(lowerName)) return isUnsafeUrl(value);\n return ANIMATION_VALUE_ATTRIBUTES.has(lowerName) && value.split(\";\").some(isUnsafeUrl);\n}\n\n/** Text to write for `value`, or null when the attribute is removed. Same rules as the client. @internal */\nexport function attributeText(lowerName: string, value: unknown): string | null {\n if (value === null || value === undefined) return null;\n if (value === false) return isStringValued(lowerName) ? \"false\" : null;\n if (value === true) return isStringValued(lowerName) ? \"true\" : \"\";\n return String(value);\n}\n\n/** Refuses symbols, which have no markup form and would otherwise be coerced silently. */\nfunction assertNotSymbol(value: unknown): void {\n if (typeof value === \"symbol\") {\n throw invalid(\"UNRECOGNIZED_INSERT_VALUE\", \"A symbol cannot be an attribute value.\");\n }\n}\n\n/**\n * Renders one attribute as markup with a leading space, or `\"\"` when the attribute is absent: the\n * helper the compiler's server output calls for a dynamic attribute. It applies the client's value\n * rules and URL check, so server and client agree on what is written.\n *\n * - `null`, `undefined` and `false` give `\"\"` (except `false` on `aria-*`, `data-*`, `draggable`,\n * `spellcheck` and `contenteditable`, which is written as `\"false\"`); `true` writes `=\"\"` (or\n * `\"true\"` for those same names). Other values are written as `String(value)`, HTML-escaped.\n * - URL attributes whose value would run script are dropped, with the check of\n * `isUnsafeUrlAttribute` (including the SVG animation attributes `values`, `from`, `to`, `by`).\n * - `on*` names are dropped: event handlers never reach markup.\n * - Accessors are called (untracked) until a plain value remains.\n *\n * @param name Attribute name, matching `[A-Za-z_:][A-Za-z0-9_:.-]*`. It is validated before\n * anything else, so an invalid name always throws.\n * @param value The value, or an accessor of it.\n * @param isBoolean `true` for a presence attribute such as `disabled`: a truthy value writes the bare\n * name, a falsy one writes nothing. Default: `false`.\n * @returns Markup such as `' title=\"a&b\"'`, or `\"\"`.\n * @throws TypeError `INVALID_ATTRIBUTE_NAME` for an invalid name, and `UNRECOGNIZED_INSERT_VALUE`\n * when the value is a symbol.\n * @example\n * import { ssrAttribute } from \"@shadow-js/web/server\";\n *\n * ssrAttribute(\"title\", \"Tom & Jerry\"); // ' title=\"Tom & Jerry\"'\n * ssrAttribute(\"disabled\", true, true); // \" disabled\"\n * ssrAttribute(\"href\", \"javascript:alert(1)\"); // \"\"\n * @since 1.0.0\n */\nexport function ssrAttribute(name: string, value: unknown, isBoolean = false): string {\n assertAttributeName(name);\n const lowerName = name.toLowerCase();\n if (isEventName(lowerName)) return \"\";\n const resolved = resolveValue(value);\n assertNotSymbol(resolved);\n if (isBoolean) return resolved ? ` ${name}` : \"\";\n const text = attributeText(lowerName, resolved);\n if (text === null) return \"\";\n if (isUnsafeAttributeValue(lowerName, text)) return \"\";\n return ` ${name}=\"${escapeHtml(text)}\"`;\n}\n"],"mappings":";;;;AAIA,MAAM,iBAAiB;;AAGvB,MAAM,iCAAsC,IAAI,IAAI;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;AAMD,MAAM,6CAAkD,IAAI,IAAI;CAAC;CAAU;CAAQ;CAAM;AAAI,CAAC;;AAG9F,MAAM,wCAA6C,IAAI,IAAI;CACzD;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,qCAA0C,IAAI,IAAI;CAC7D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,sBAAyC;CAAC;CAAe;CAAkB;AAAW;;AAG5F,SAAgB,oBAAoB,MAAoB;CACtD,IAAI,CAAC,eAAe,KAAK,IAAI,GAC3B,MAAM,QAAQ,0BAA0B,IAAI,KAAK,iCAAiC;AAEtF;;AAGA,SAAgB,YAAY,WAA4B;CACtD,OAAO,UAAU,SAAS,KAAK,UAAU,WAAW,IAAI;AAC1D;;AAGA,SAAS,eAAe,WAA4B;CAClD,OACE,UAAU,WAAW,OAAO,KAC5B,UAAU,WAAW,OAAO,KAC5B,sBAAsB,IAAI,SAAS;AAEvC;;AAGA,SAAS,cAAc,MAAsB;CAC3C,IAAI,OAAO;CACX,KAAK,MAAM,QAAQ,MAAM;EACvB,MAAM,OAAO,KAAK,WAAW,CAAC;EAC9B,IAAI,OAAO,OAAS,OAAO,OAAQ,OAAO,MAAO,QAAQ;CAC3D;CACA,OAAO;AACT;;AAGA,SAAgB,YAAY,OAAwB;CAClD,MAAM,aAAa,cAAc,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY;CAC3D,OAAO,oBAAoB,MAAM,WAAW,WAAW,WAAW,MAAM,CAAC;AAC3E;;AAGA,SAAS,uBAAuB,WAAmB,OAAwB;CACzE,IAAI,eAAe,IAAI,SAAS,GAAG,OAAO,YAAY,KAAK;CAC3D,OAAO,2BAA2B,IAAI,SAAS,KAAK,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,WAAW;AACvF;;AAGA,SAAgB,cAAc,WAAmB,OAA+B;CAC9E,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO;CAClD,IAAI,UAAU,OAAO,OAAO,eAAe,SAAS,IAAI,UAAU;CAClE,IAAI,UAAU,MAAM,OAAO,eAAe,SAAS,IAAI,SAAS;CAChE,OAAO,OAAO,KAAK;AACrB;;AAGA,SAAS,gBAAgB,OAAsB;CAC7C,IAAI,OAAO,UAAU,UACnB,MAAM,QAAQ,6BAA6B,wCAAwC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,aAAa,MAAc,OAAgB,YAAY,OAAe;CACpF,oBAAoB,IAAI;CACxB,MAAM,YAAY,KAAK,YAAY;CACnC,IAAI,YAAY,SAAS,GAAG,OAAO;CACnC,MAAM,WAAW,aAAa,KAAK;CACnC,gBAAgB,QAAQ;CACxB,IAAI,WAAW,OAAO,WAAW,IAAI,SAAS;CAC9C,MAAM,OAAO,cAAc,WAAW,QAAQ;CAC9C,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,uBAAuB,WAAW,IAAI,GAAG,OAAO;CACpD,OAAO,IAAI,KAAK,IAAI,WAAW,IAAI,EAAE;AACvC"}
|