@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,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Replaces the whole `class` of an element: the helper compiled templates call for `class` and
|
|
3
|
+
* `className`. HTML elements are written through `className`; SVG and MathML elements (whose
|
|
4
|
+
* `className` is not a plain string) through the `class` attribute. The DOM is touched only when
|
|
5
|
+
* the text changes.
|
|
6
|
+
*
|
|
7
|
+
* @param el Target element.
|
|
8
|
+
* @param value A string is used as is. Arrays and objects are clsx-style: non-empty strings,
|
|
9
|
+
* numbers other than `0` and `NaN`, nested arrays, and the keys of objects whose value is truthy,
|
|
10
|
+
* joined with spaces. `null`, `undefined` and `false` remove the attribute.
|
|
11
|
+
* @throws TypeError `SHADOW_CLASS_CYCLE` when an array contains itself (directly or through a nested
|
|
12
|
+
* array).
|
|
13
|
+
* @example
|
|
14
|
+
* import { className } from "@shadow-js/web";
|
|
15
|
+
*
|
|
16
|
+
* const card = document.createElement("div");
|
|
17
|
+
* className(card, ["card", { "card--active": true, "card--muted": false }]);
|
|
18
|
+
* card.className; // "card card--active"
|
|
19
|
+
* @see classList
|
|
20
|
+
* @since 1.0.0
|
|
21
|
+
*/
|
|
22
|
+
export declare function className(el: Element, value: unknown): void;
|
|
23
|
+
/**
|
|
24
|
+
* Toggles individual classes from an object: the helper compiled templates call for `classList`.
|
|
25
|
+
* Unlike {@link className}, it leaves classes it did not set alone: only keys whose truthiness
|
|
26
|
+
* changed relative to `prev` are touched. A key may hold several space-separated names. Keys that
|
|
27
|
+
* disappeared from `value` are switched off.
|
|
28
|
+
*
|
|
29
|
+
* @param el Target element.
|
|
30
|
+
* @param value Map from class names to truthiness. `undefined` switches off every class `prev` had on.
|
|
31
|
+
* @param prev The map returned by the previous call. Undefined (the first call) means no class was
|
|
32
|
+
* on yet.
|
|
33
|
+
* @returns The map now in effect (`value`, or `{}` for undefined), to pass back as `prev` next time.
|
|
34
|
+
* @example
|
|
35
|
+
* import { classList } from "@shadow-js/web";
|
|
36
|
+
*
|
|
37
|
+
* const el = document.createElement("li");
|
|
38
|
+
* let prev = classList(el, { active: true, "is-new pulse": true });
|
|
39
|
+
* prev = classList(el, { active: false }, prev); // removes active, is-new and pulse
|
|
40
|
+
* @see className
|
|
41
|
+
* @since 1.0.0
|
|
42
|
+
*/
|
|
43
|
+
export declare function classList(el: Element, value: Record<string, unknown> | undefined, prev?: Record<string, unknown>): Record<string, unknown>;
|
|
44
|
+
/**
|
|
45
|
+
* Sets or removes one inline style property: the helper compiled templates call for the `style:`
|
|
46
|
+
* prefix. Other inline properties are left alone.
|
|
47
|
+
*
|
|
48
|
+
* @param el HTML or SVG element.
|
|
49
|
+
* @param name CSS property in camelCase (`backgroundColor`, `msTransform` gives `-ms-transform`) or
|
|
50
|
+
* kebab-case, or a custom property (`--accent`, kept as is).
|
|
51
|
+
* @param value `null`, `undefined` and `false` remove the property. A number is in pixels, as in
|
|
52
|
+
* React, unless it is `0`, the property is unitless (`opacity`, `zIndex`, `flexGrow`, `lineHeight`,
|
|
53
|
+
* ...) or a custom property. Any other value is written as `String(value)`.
|
|
54
|
+
* @example
|
|
55
|
+
* import { setStyleProperty } from "@shadow-js/web";
|
|
56
|
+
*
|
|
57
|
+
* const el = document.createElement("div");
|
|
58
|
+
* setStyleProperty(el, "marginTop", 8); // margin-top: 8px
|
|
59
|
+
* setStyleProperty(el, "--accent", "rebeccapurple");
|
|
60
|
+
* setStyleProperty(el, "opacity", 0.5); // unitless
|
|
61
|
+
* @see style
|
|
62
|
+
* @since 1.0.0
|
|
63
|
+
*/
|
|
64
|
+
export declare function setStyleProperty(el: HTMLElement | SVGElement, name: string, value: unknown): void;
|
|
65
|
+
/**
|
|
66
|
+
* Sets the inline style of an element: the helper compiled templates call for a `style` attribute.
|
|
67
|
+
* An object is diffed against `prev` so that only changed properties are written, each with the
|
|
68
|
+
* rules of {@link setStyleProperty}; properties that disappeared are removed.
|
|
69
|
+
*
|
|
70
|
+
* @param el HTML or SVG element.
|
|
71
|
+
* @param value An object of properties (camelCase, kebab-case or custom names). A string replaces
|
|
72
|
+
* `cssText`. `null`, `undefined` and `false` remove the `style` attribute.
|
|
73
|
+
* @param prev The value returned by the previous call. Undefined (the first call) diffs against an
|
|
74
|
+
* empty style. When it is a string, `cssText` is cleared before the object is written.
|
|
75
|
+
* @returns What to pass back as `prev` next time: a shallow copy of an object value, otherwise
|
|
76
|
+
* `value` itself.
|
|
77
|
+
* @example
|
|
78
|
+
* import { style } from "@shadow-js/web";
|
|
79
|
+
*
|
|
80
|
+
* const el = document.createElement("div");
|
|
81
|
+
* let prev = style(el, { color: "red", width: 120 }); // width: 120px
|
|
82
|
+
* prev = style(el, { color: "blue" }, prev); // writes color, removes width
|
|
83
|
+
* @see setStyleProperty
|
|
84
|
+
* @since 1.0.0
|
|
85
|
+
*/
|
|
86
|
+
export declare function style(el: HTMLElement | SVGElement, value: unknown, prev?: unknown): unknown;
|
|
87
|
+
//# sourceMappingURL=class-style.d.ts.map
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import { cssValueText } from "./internal/css-units.js";
|
|
2
|
+
import { HTML_NS } from "./internal/names.js";
|
|
3
|
+
// src/class-style.ts
|
|
4
|
+
/** Appends the truthy class names of `value` (strings, numbers, nested arrays, objects) to `parts`. */
|
|
5
|
+
function collectClasses(root, parts) {
|
|
6
|
+
const frames = [[root]];
|
|
7
|
+
const cursors = [0];
|
|
8
|
+
const active = /* @__PURE__ */ new Set();
|
|
9
|
+
while (frames.length > 0) {
|
|
10
|
+
const top = frames.length - 1;
|
|
11
|
+
const frame = frames[top];
|
|
12
|
+
const cursor = cursors[top] ?? 0;
|
|
13
|
+
if (frame === void 0 || cursor >= frame.length) {
|
|
14
|
+
const done = frames.pop();
|
|
15
|
+
if (done !== void 0) active.delete(done);
|
|
16
|
+
cursors.pop();
|
|
17
|
+
continue;
|
|
18
|
+
}
|
|
19
|
+
cursors[top] = cursor + 1;
|
|
20
|
+
const item = frame[cursor];
|
|
21
|
+
if (Array.isArray(item)) {
|
|
22
|
+
if (active.has(item)) throw new TypeError("className(): a class array contains itself.");
|
|
23
|
+
active.add(item);
|
|
24
|
+
frames.push(item);
|
|
25
|
+
cursors.push(0);
|
|
26
|
+
} else if (typeof item === "string") {
|
|
27
|
+
if (item !== "") parts.push(item);
|
|
28
|
+
} else if (typeof item === "number") {
|
|
29
|
+
if (item !== 0 && !Number.isNaN(item)) parts.push(String(item));
|
|
30
|
+
} else if (item !== null && typeof item === "object") {
|
|
31
|
+
const record = item;
|
|
32
|
+
for (const key of Object.keys(record)) if (record[key] && key !== "") parts.push(key);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/** Class text for `value`, or null when the class attribute must be removed. */
|
|
37
|
+
function classText(value) {
|
|
38
|
+
if (typeof value === "string") return value;
|
|
39
|
+
if (value === null || value === void 0 || value === false) return null;
|
|
40
|
+
const parts = [];
|
|
41
|
+
collectClasses(value, parts);
|
|
42
|
+
return parts.join(" ");
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Writes a class value. `svg` selects the attribute path, which SVG and MathML need because their
|
|
46
|
+
* `className` is not a plain string.
|
|
47
|
+
* @internal
|
|
48
|
+
*/
|
|
49
|
+
function applyClass(el, value, svg) {
|
|
50
|
+
const text = classText(value);
|
|
51
|
+
if (text === null) {
|
|
52
|
+
el.removeAttribute("class");
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
if (svg) {
|
|
56
|
+
if (el.getAttribute("class") !== text) el.setAttribute("class", text);
|
|
57
|
+
} else if (el.className !== text) el.className = text;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Replaces the whole `class` of an element: the helper compiled templates call for `class` and
|
|
61
|
+
* `className`. HTML elements are written through `className`; SVG and MathML elements (whose
|
|
62
|
+
* `className` is not a plain string) through the `class` attribute. The DOM is touched only when
|
|
63
|
+
* the text changes.
|
|
64
|
+
*
|
|
65
|
+
* @param el Target element.
|
|
66
|
+
* @param value A string is used as is. Arrays and objects are clsx-style: non-empty strings,
|
|
67
|
+
* numbers other than `0` and `NaN`, nested arrays, and the keys of objects whose value is truthy,
|
|
68
|
+
* joined with spaces. `null`, `undefined` and `false` remove the attribute.
|
|
69
|
+
* @throws TypeError `SHADOW_CLASS_CYCLE` when an array contains itself (directly or through a nested
|
|
70
|
+
* array).
|
|
71
|
+
* @example
|
|
72
|
+
* import { className } from "@shadow-js/web";
|
|
73
|
+
*
|
|
74
|
+
* const card = document.createElement("div");
|
|
75
|
+
* className(card, ["card", { "card--active": true, "card--muted": false }]);
|
|
76
|
+
* card.className; // "card card--active"
|
|
77
|
+
* @see classList
|
|
78
|
+
* @since 1.0.0
|
|
79
|
+
*/
|
|
80
|
+
function className(el, value) {
|
|
81
|
+
applyClass(el, value, el.namespaceURI !== HTML_NS);
|
|
82
|
+
}
|
|
83
|
+
/** Narrows an object value to a record of keys; arrays and primitives are not class maps. */
|
|
84
|
+
function asRecord(value) {
|
|
85
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
|
|
86
|
+
return value;
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Toggles individual classes from an object: the helper compiled templates call for `classList`.
|
|
90
|
+
* Unlike {@link className}, it leaves classes it did not set alone: only keys whose truthiness
|
|
91
|
+
* changed relative to `prev` are touched. A key may hold several space-separated names. Keys that
|
|
92
|
+
* disappeared from `value` are switched off.
|
|
93
|
+
*
|
|
94
|
+
* @param el Target element.
|
|
95
|
+
* @param value Map from class names to truthiness. `undefined` switches off every class `prev` had on.
|
|
96
|
+
* @param prev The map returned by the previous call. Undefined (the first call) means no class was
|
|
97
|
+
* on yet.
|
|
98
|
+
* @returns The map now in effect (`value`, or `{}` for undefined), to pass back as `prev` next time.
|
|
99
|
+
* @example
|
|
100
|
+
* import { classList } from "@shadow-js/web";
|
|
101
|
+
*
|
|
102
|
+
* const el = document.createElement("li");
|
|
103
|
+
* let prev = classList(el, { active: true, "is-new pulse": true });
|
|
104
|
+
* prev = classList(el, { active: false }, prev); // removes active, is-new and pulse
|
|
105
|
+
* @see className
|
|
106
|
+
* @since 1.0.0
|
|
107
|
+
*/
|
|
108
|
+
function classList(el, value, prev) {
|
|
109
|
+
const next = value ?? {};
|
|
110
|
+
const before = prev ?? {};
|
|
111
|
+
const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(next)]);
|
|
112
|
+
for (const key of keys) {
|
|
113
|
+
const now = Boolean(next[key]);
|
|
114
|
+
if (now === Boolean(before[key])) continue;
|
|
115
|
+
for (const token of key.split(/\s+/)) if (token !== "") el.classList.toggle(token, now);
|
|
116
|
+
}
|
|
117
|
+
return next;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Converts a camelCase style name to a CSS property name. Custom properties are kept as they are,
|
|
121
|
+
* and vendor prefixes map to `-webkit-` and `-ms-`.
|
|
122
|
+
* @internal
|
|
123
|
+
*/
|
|
124
|
+
function toCssProperty(name) {
|
|
125
|
+
if (name.startsWith("--")) return name;
|
|
126
|
+
const kebab = name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
|
|
127
|
+
return kebab.startsWith("ms-") ? `-${kebab}` : kebab;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Sets or removes one inline style property: the helper compiled templates call for the `style:`
|
|
131
|
+
* prefix. Other inline properties are left alone.
|
|
132
|
+
*
|
|
133
|
+
* @param el HTML or SVG element.
|
|
134
|
+
* @param name CSS property in camelCase (`backgroundColor`, `msTransform` gives `-ms-transform`) or
|
|
135
|
+
* kebab-case, or a custom property (`--accent`, kept as is).
|
|
136
|
+
* @param value `null`, `undefined` and `false` remove the property. A number is in pixels, as in
|
|
137
|
+
* React, unless it is `0`, the property is unitless (`opacity`, `zIndex`, `flexGrow`, `lineHeight`,
|
|
138
|
+
* ...) or a custom property. Any other value is written as `String(value)`.
|
|
139
|
+
* @example
|
|
140
|
+
* import { setStyleProperty } from "@shadow-js/web";
|
|
141
|
+
*
|
|
142
|
+
* const el = document.createElement("div");
|
|
143
|
+
* setStyleProperty(el, "marginTop", 8); // margin-top: 8px
|
|
144
|
+
* setStyleProperty(el, "--accent", "rebeccapurple");
|
|
145
|
+
* setStyleProperty(el, "opacity", 0.5); // unitless
|
|
146
|
+
* @see style
|
|
147
|
+
* @since 1.0.0
|
|
148
|
+
*/
|
|
149
|
+
function setStyleProperty(el, name, value) {
|
|
150
|
+
const property = toCssProperty(name);
|
|
151
|
+
if (value === null || value === void 0 || value === false) el.style.removeProperty(property);
|
|
152
|
+
else el.style.setProperty(property, cssValueText(property, value));
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* Sets the inline style of an element: the helper compiled templates call for a `style` attribute.
|
|
156
|
+
* An object is diffed against `prev` so that only changed properties are written, each with the
|
|
157
|
+
* rules of {@link setStyleProperty}; properties that disappeared are removed.
|
|
158
|
+
*
|
|
159
|
+
* @param el HTML or SVG element.
|
|
160
|
+
* @param value An object of properties (camelCase, kebab-case or custom names). A string replaces
|
|
161
|
+
* `cssText`. `null`, `undefined` and `false` remove the `style` attribute.
|
|
162
|
+
* @param prev The value returned by the previous call. Undefined (the first call) diffs against an
|
|
163
|
+
* empty style. When it is a string, `cssText` is cleared before the object is written.
|
|
164
|
+
* @returns What to pass back as `prev` next time: a shallow copy of an object value, otherwise
|
|
165
|
+
* `value` itself.
|
|
166
|
+
* @example
|
|
167
|
+
* import { style } from "@shadow-js/web";
|
|
168
|
+
*
|
|
169
|
+
* const el = document.createElement("div");
|
|
170
|
+
* let prev = style(el, { color: "red", width: 120 }); // width: 120px
|
|
171
|
+
* prev = style(el, { color: "blue" }, prev); // writes color, removes width
|
|
172
|
+
* @see setStyleProperty
|
|
173
|
+
* @since 1.0.0
|
|
174
|
+
*/
|
|
175
|
+
function style(el, value, prev) {
|
|
176
|
+
if (value === null || value === void 0 || value === false) {
|
|
177
|
+
el.removeAttribute("style");
|
|
178
|
+
return value;
|
|
179
|
+
}
|
|
180
|
+
if (typeof value !== "object") {
|
|
181
|
+
el.style.cssText = String(value);
|
|
182
|
+
return value;
|
|
183
|
+
}
|
|
184
|
+
const next = { ...value };
|
|
185
|
+
const before = asRecord(prev) ?? {};
|
|
186
|
+
if (typeof prev === "string") el.style.cssText = "";
|
|
187
|
+
const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(next)]);
|
|
188
|
+
for (const key of keys) {
|
|
189
|
+
if (Object.is(before[key], next[key])) continue;
|
|
190
|
+
setStyleProperty(el, key, next[key]);
|
|
191
|
+
}
|
|
192
|
+
return next;
|
|
193
|
+
}
|
|
194
|
+
export { applyClass, classList, className, setStyleProperty, style, toCssProperty };
|
|
195
|
+
|
|
196
|
+
//# sourceMappingURL=class-style.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"class-style.js","names":[],"sources":["../../src/class-style.ts"],"sourcesContent":["import { cssValueText } from \"./internal/css-units\";\nimport { HTML_NS } from \"./internal/names\";\n\n/** Appends the truthy class names of `value` (strings, numbers, nested arrays, objects) to `parts`. */\nfunction collectClasses(root: unknown, parts: string[]): void {\n // Explicit frames instead of recursion: array nesting depth is controlled by the user.\n const frames: unknown[][] = [[root]];\n const cursors: number[] = [0];\n const active = new Set<unknown[]>();\n while (frames.length > 0) {\n const top = frames.length - 1;\n const frame = frames[top];\n const cursor = cursors[top] ?? 0;\n if (frame === undefined || cursor >= frame.length) {\n const done = frames.pop();\n if (done !== undefined) active.delete(done);\n cursors.pop();\n continue;\n }\n cursors[top] = cursor + 1;\n const item = frame[cursor];\n if (Array.isArray(item)) {\n if (active.has(item))\n throw new TypeError(\n __DEV__ ? \"className(): a class array contains itself.\" : \"SHADOW_CLASS_CYCLE\",\n );\n active.add(item);\n frames.push(item);\n cursors.push(0);\n } else if (typeof item === \"string\") {\n if (item !== \"\") parts.push(item);\n } else if (typeof item === \"number\") {\n if (item !== 0 && !Number.isNaN(item)) parts.push(String(item));\n } else if (item !== null && typeof item === \"object\") {\n const record = item as Record<string, unknown>;\n for (const key of Object.keys(record)) {\n if (record[key] && key !== \"\") parts.push(key);\n }\n }\n }\n}\n\n/** Class text for `value`, or null when the class attribute must be removed. */\nfunction classText(value: unknown): string | null {\n if (typeof value === \"string\") return value;\n if (value === null || value === undefined || value === false) return null;\n const parts: string[] = [];\n collectClasses(value, parts);\n return parts.join(\" \");\n}\n\n/**\n * Writes a class value. `svg` selects the attribute path, which SVG and MathML need because their\n * `className` is not a plain string.\n * @internal\n */\nexport function applyClass(el: Element, value: unknown, svg: boolean): void {\n const text = classText(value);\n if (text === null) {\n el.removeAttribute(\"class\");\n return;\n }\n if (svg) {\n if (el.getAttribute(\"class\") !== text) el.setAttribute(\"class\", text);\n } else if (el.className !== text) {\n el.className = text;\n }\n}\n\n/**\n * Replaces the whole `class` of an element: the helper compiled templates call for `class` and\n * `className`. HTML elements are written through `className`; SVG and MathML elements (whose\n * `className` is not a plain string) through the `class` attribute. The DOM is touched only when\n * the text changes.\n *\n * @param el Target element.\n * @param value A string is used as is. Arrays and objects are clsx-style: non-empty strings,\n * numbers other than `0` and `NaN`, nested arrays, and the keys of objects whose value is truthy,\n * joined with spaces. `null`, `undefined` and `false` remove the attribute.\n * @throws TypeError `SHADOW_CLASS_CYCLE` when an array contains itself (directly or through a nested\n * array).\n * @example\n * import { className } from \"@shadow-js/web\";\n *\n * const card = document.createElement(\"div\");\n * className(card, [\"card\", { \"card--active\": true, \"card--muted\": false }]);\n * card.className; // \"card card--active\"\n * @see classList\n * @since 1.0.0\n */\nexport function className(el: Element, value: unknown): void {\n applyClass(el, value, el.namespaceURI !== HTML_NS);\n}\n\n/** Narrows an object value to a record of keys; arrays and primitives are not class maps. */\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n if (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n return value as Record<string, unknown>;\n}\n\n/**\n * Toggles individual classes from an object: the helper compiled templates call for `classList`.\n * Unlike {@link className}, it leaves classes it did not set alone: only keys whose truthiness\n * changed relative to `prev` are touched. A key may hold several space-separated names. Keys that\n * disappeared from `value` are switched off.\n *\n * @param el Target element.\n * @param value Map from class names to truthiness. `undefined` switches off every class `prev` had on.\n * @param prev The map returned by the previous call. Undefined (the first call) means no class was\n * on yet.\n * @returns The map now in effect (`value`, or `{}` for undefined), to pass back as `prev` next time.\n * @example\n * import { classList } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"li\");\n * let prev = classList(el, { active: true, \"is-new pulse\": true });\n * prev = classList(el, { active: false }, prev); // removes active, is-new and pulse\n * @see className\n * @since 1.0.0\n */\nexport function classList(\n el: Element,\n value: Record<string, unknown> | undefined,\n prev?: Record<string, unknown>,\n): Record<string, unknown> {\n const next: Record<string, unknown> = value ?? {};\n const before: Record<string, unknown> = prev ?? {};\n const keys = new Set([...Object.keys(before), ...Object.keys(next)]);\n for (const key of keys) {\n const now = Boolean(next[key]);\n const was = Boolean(before[key]);\n if (now === was) continue;\n for (const token of key.split(/\\s+/)) {\n if (token !== \"\") el.classList.toggle(token, now);\n }\n }\n return next;\n}\n\n/**\n * Converts a camelCase style name to a CSS property name. Custom properties are kept as they are,\n * and vendor prefixes map to `-webkit-` and `-ms-`.\n * @internal\n */\nexport function toCssProperty(name: string): string {\n if (name.startsWith(\"--\")) return name;\n const kebab = name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);\n return kebab.startsWith(\"ms-\") ? `-${kebab}` : kebab;\n}\n\n/**\n * Sets or removes one inline style property: the helper compiled templates call for the `style:`\n * prefix. Other inline properties are left alone.\n *\n * @param el HTML or SVG element.\n * @param name CSS property in camelCase (`backgroundColor`, `msTransform` gives `-ms-transform`) or\n * kebab-case, or a custom property (`--accent`, kept as is).\n * @param value `null`, `undefined` and `false` remove the property. A number is in pixels, as in\n * React, unless it is `0`, the property is unitless (`opacity`, `zIndex`, `flexGrow`, `lineHeight`,\n * ...) or a custom property. Any other value is written as `String(value)`.\n * @example\n * import { setStyleProperty } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"div\");\n * setStyleProperty(el, \"marginTop\", 8); // margin-top: 8px\n * setStyleProperty(el, \"--accent\", \"rebeccapurple\");\n * setStyleProperty(el, \"opacity\", 0.5); // unitless\n * @see style\n * @since 1.0.0\n */\nexport function setStyleProperty(el: HTMLElement | SVGElement, name: string, value: unknown): void {\n const property = toCssProperty(name);\n if (value === null || value === undefined || value === false) {\n el.style.removeProperty(property);\n } else {\n el.style.setProperty(property, cssValueText(property, value));\n }\n}\n\n/**\n * Sets the inline style of an element: the helper compiled templates call for a `style` attribute.\n * An object is diffed against `prev` so that only changed properties are written, each with the\n * rules of {@link setStyleProperty}; properties that disappeared are removed.\n *\n * @param el HTML or SVG element.\n * @param value An object of properties (camelCase, kebab-case or custom names). A string replaces\n * `cssText`. `null`, `undefined` and `false` remove the `style` attribute.\n * @param prev The value returned by the previous call. Undefined (the first call) diffs against an\n * empty style. When it is a string, `cssText` is cleared before the object is written.\n * @returns What to pass back as `prev` next time: a shallow copy of an object value, otherwise\n * `value` itself.\n * @example\n * import { style } from \"@shadow-js/web\";\n *\n * const el = document.createElement(\"div\");\n * let prev = style(el, { color: \"red\", width: 120 }); // width: 120px\n * prev = style(el, { color: \"blue\" }, prev); // writes color, removes width\n * @see setStyleProperty\n * @since 1.0.0\n */\nexport function style(el: HTMLElement | SVGElement, value: unknown, prev?: unknown): unknown {\n if (value === null || value === undefined || value === false) {\n el.removeAttribute(\"style\");\n return value;\n }\n if (typeof value !== \"object\") {\n el.style.cssText = String(value);\n return value;\n }\n const next = { ...(value as Record<string, unknown>) };\n const before = asRecord(prev) ?? {};\n if (typeof prev === \"string\") el.style.cssText = \"\";\n const keys = new Set([...Object.keys(before), ...Object.keys(next)]);\n for (const key of keys) {\n if (Object.is(before[key], next[key])) continue;\n setStyleProperty(el, key, next[key]);\n }\n return next;\n}\n"],"mappings":";;;;AAIA,SAAS,eAAe,MAAe,OAAuB;CAE5D,MAAM,SAAsB,CAAC,CAAC,IAAI,CAAC;CACnC,MAAM,UAAoB,CAAC,CAAC;CAC5B,MAAM,yBAAS,IAAI,IAAe;CAClC,OAAO,OAAO,SAAS,GAAG;EACxB,MAAM,MAAM,OAAO,SAAS;EAC5B,MAAM,QAAQ,OAAO;EACrB,MAAM,SAAS,QAAQ,QAAQ;EAC/B,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,QAAQ;GACjD,MAAM,OAAO,OAAO,IAAI;GACxB,IAAI,SAAS,KAAA,GAAW,OAAO,OAAO,IAAI;GAC1C,QAAQ,IAAI;GACZ;EACF;EACA,QAAQ,OAAO,SAAS;EACxB,MAAM,OAAO,MAAM;EACnB,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,IAAI,OAAO,IAAI,IAAI,GACjB,MAAM,IAAI,UACE,6CACZ;GACF,OAAO,IAAI,IAAI;GACf,OAAO,KAAK,IAAI;GAChB,QAAQ,KAAK,CAAC;EAChB,OAAO,IAAI,OAAO,SAAS,UACrB;OAAA,SAAS,IAAI,MAAM,KAAK,IAAI;EAAA,OAC3B,IAAI,OAAO,SAAS,UACrB;OAAA,SAAS,KAAK,CAAC,OAAO,MAAM,IAAI,GAAG,MAAM,KAAK,OAAO,IAAI,CAAC;EAAA,OACzD,IAAI,SAAS,QAAQ,OAAO,SAAS,UAAU;GACpD,MAAM,SAAS;GACf,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,IAAI,OAAO,QAAQ,QAAQ,IAAI,MAAM,KAAK,GAAG;EAEjD;CACF;AACF;;AAGA,SAAS,UAAU,OAA+B;CAChD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OAAO,OAAO;CACrE,MAAM,QAAkB,CAAC;CACzB,eAAe,OAAO,KAAK;CAC3B,OAAO,MAAM,KAAK,GAAG;AACvB;;;;;;AAOA,SAAgB,WAAW,IAAa,OAAgB,KAAoB;CAC1E,MAAM,OAAO,UAAU,KAAK;CAC5B,IAAI,SAAS,MAAM;EACjB,GAAG,gBAAgB,OAAO;EAC1B;CACF;CACA,IAAI,KACE;MAAA,GAAG,aAAa,OAAO,MAAM,MAAM,GAAG,aAAa,SAAS,IAAI;CAAA,OAC/D,IAAI,GAAG,cAAc,MAC1B,GAAG,YAAY;AAEnB;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,UAAU,IAAa,OAAsB;CAC3D,WAAW,IAAI,OAAO,GAAG,iBAAiB,OAAO;AACnD;;AAGA,SAAS,SAAS,OAAqD;CACrE,IAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAA;CAChF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACd,IACA,OACA,MACyB;CACzB,MAAM,OAAgC,SAAS,CAAC;CAChD,MAAM,SAAkC,QAAQ,CAAC;CACjD,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;CACnE,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,MAAM,QAAQ,KAAK,IAAI;EAE7B,IAAI,QADQ,QAAQ,OAAO,IACb,GAAG;EACjB,KAAK,MAAM,SAAS,IAAI,MAAM,KAAK,GACjC,IAAI,UAAU,IAAI,GAAG,UAAU,OAAO,OAAO,GAAG;CAEpD;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,cAAc,MAAsB;CAClD,IAAI,KAAK,WAAW,IAAI,GAAG,OAAO;CAClC,MAAM,QAAQ,KAAK,QAAQ,WAAW,WAAW,IAAI,OAAO,YAAY,GAAG;CAC3E,OAAO,MAAM,WAAW,KAAK,IAAI,IAAI,UAAU;AACjD;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,iBAAiB,IAA8B,MAAc,OAAsB;CACjG,MAAM,WAAW,cAAc,IAAI;CACnC,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OACrD,GAAG,MAAM,eAAe,QAAQ;MAEhC,GAAG,MAAM,YAAY,UAAU,aAAa,UAAU,KAAK,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,MAAM,IAA8B,OAAgB,MAAyB;CAC3F,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,OAAO;EAC5D,GAAG,gBAAgB,OAAO;EAC1B,OAAO;CACT;CACA,IAAI,OAAO,UAAU,UAAU;EAC7B,GAAG,MAAM,UAAU,OAAO,KAAK;EAC/B,OAAO;CACT;CACA,MAAM,OAAO,EAAE,GAAI,MAAkC;CACrD,MAAM,SAAS,SAAS,IAAI,KAAK,CAAC;CAClC,IAAI,OAAO,SAAS,UAAU,GAAG,MAAM,UAAU;CACjD,MAAM,uBAAO,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;CACnE,KAAK,MAAM,OAAO,MAAM;EACtB,IAAI,OAAO,GAAG,OAAO,MAAM,KAAK,IAAI,GAAG;EACvC,iBAAiB,IAAI,KAAK,KAAK,IAAI;CACrC;CACA,OAAO;AACT"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Calls a component untracked, under a new owner that is a child of the current one: cleanups and
|
|
3
|
+
* effects it creates are disposed with the enclosing scope. The name, given in development builds,
|
|
4
|
+
* is recorded for devtools.
|
|
5
|
+
*
|
|
6
|
+
* @param component The component function.
|
|
7
|
+
* @param props The props object (usually with getters for reactive props).
|
|
8
|
+
* @param name Optional devtools name.
|
|
9
|
+
* @returns Whatever the component returns.
|
|
10
|
+
* @example
|
|
11
|
+
* import { createComponent } from "@shadow-js/web";
|
|
12
|
+
*
|
|
13
|
+
* function Counter(props: { start: number }) {
|
|
14
|
+
* return `Count: ${props.start}`;
|
|
15
|
+
* }
|
|
16
|
+
*
|
|
17
|
+
* const view = createComponent(Counter, { start: 0 }, "Counter");
|
|
18
|
+
* @since 1.0.0
|
|
19
|
+
*/
|
|
20
|
+
export declare function createComponent<P>(component: (props: P) => unknown, props: P, name?: string): unknown;
|
|
21
|
+
//# sourceMappingURL=component.d.ts.map
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { currentScope, enterComponent } from "./internal/hydration-scope.js";
|
|
2
|
+
import { DEVTOOLS_EVENT, addCleanup, createOwner, devtoolsReport, runInScope } from "@shadow-js/core/extend";
|
|
3
|
+
// src/component.ts
|
|
4
|
+
/** Dev-only: the name each component was created with, for devtools. Weak, so components are not kept alive. */
|
|
5
|
+
const componentNames = /* @__PURE__ */ new WeakMap();
|
|
6
|
+
/**
|
|
7
|
+
* Calls a component untracked, under a new owner that is a child of the current one: cleanups and
|
|
8
|
+
* effects it creates are disposed with the enclosing scope. The name, given in development builds,
|
|
9
|
+
* is recorded for devtools.
|
|
10
|
+
*
|
|
11
|
+
* @param component The component function.
|
|
12
|
+
* @param props The props object (usually with getters for reactive props).
|
|
13
|
+
* @param name Optional devtools name.
|
|
14
|
+
* @returns Whatever the component returns.
|
|
15
|
+
* @example
|
|
16
|
+
* import { createComponent } from "@shadow-js/web";
|
|
17
|
+
*
|
|
18
|
+
* function Counter(props: { start: number }) {
|
|
19
|
+
* return `Count: ${props.start}`;
|
|
20
|
+
* }
|
|
21
|
+
*
|
|
22
|
+
* const view = createComponent(Counter, { start: 0 }, "Counter");
|
|
23
|
+
* @since 1.0.0
|
|
24
|
+
*/
|
|
25
|
+
function createComponent(component, props, name) {
|
|
26
|
+
if (name !== void 0) componentNames.set(component, name);
|
|
27
|
+
return enterComponent(() => {
|
|
28
|
+
const owner = createOwner();
|
|
29
|
+
owner.idPrefix = currentScope()?.id;
|
|
30
|
+
const result = runInScope({
|
|
31
|
+
owner,
|
|
32
|
+
listener: null
|
|
33
|
+
}, () => component(props));
|
|
34
|
+
devtoolsReport(DEVTOOLS_EVENT.COMPONENT_MOUNTED, owner, componentNames.get(component), result);
|
|
35
|
+
addCleanup(owner, () => devtoolsReport(DEVTOOLS_EVENT.COMPONENT_UNMOUNTED, owner));
|
|
36
|
+
return result;
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
export { createComponent };
|
|
40
|
+
|
|
41
|
+
//# sourceMappingURL=component.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"component.js","names":[],"sources":["../../src/component.ts"],"sourcesContent":["import {\n addCleanup,\n createOwner,\n DEVTOOLS_EVENT,\n devtoolsReport,\n runInScope,\n} from \"@shadow-js/core/extend\";\nimport { currentScope, enterComponent } from \"./internal/hydration-scope\";\n\n/** Dev-only: the name each component was created with, for devtools. Weak, so components are not kept alive. */\nconst componentNames = new WeakMap<object, string>();\n\n/**\n * Calls a component untracked, under a new owner that is a child of the current one: cleanups and\n * effects it creates are disposed with the enclosing scope. The name, given in development builds,\n * is recorded for devtools.\n *\n * @param component The component function.\n * @param props The props object (usually with getters for reactive props).\n * @param name Optional devtools name.\n * @returns Whatever the component returns.\n * @example\n * import { createComponent } from \"@shadow-js/web\";\n *\n * function Counter(props: { start: number }) {\n * return `Count: ${props.start}`;\n * }\n *\n * const view = createComponent(Counter, { start: 0 }, \"Counter\");\n * @since 1.0.0\n */\nexport function createComponent<P>(\n component: (props: P) => unknown,\n props: P,\n name?: string,\n): unknown {\n if (__DEV__ && name !== undefined) componentNames.set(component, name);\n return enterComponent(() => {\n // Every component runs under an owner of its own: devtools attribute updates to it, and\n // `useId` uses its hydration-scope key as a prefix, so ids agree between server and browser\n // even though the browser creates more owners (effects) than the server does.\n const owner = createOwner();\n owner.idPrefix = currentScope()?.id;\n // One scope switch (owner in, listener off): deep component trees are bounded by the call stack.\n const result = runInScope({ owner, listener: null }, () => component(props));\n if (__DEV__) {\n devtoolsReport(\n DEVTOOLS_EVENT.COMPONENT_MOUNTED,\n owner,\n componentNames.get(component),\n result,\n );\n addCleanup(owner, () => devtoolsReport(DEVTOOLS_EVENT.COMPONENT_UNMOUNTED, owner));\n }\n return result;\n });\n}\n\n/**\n * The devtools name recorded for a component in development builds, if any.\n * @internal\n */\nexport function componentName(component: object): string | undefined {\n return componentNames.get(component);\n}\n"],"mappings":";;;;AAUA,MAAM,iCAAiB,IAAI,QAAwB;;;;;;;;;;;;;;;;;;;;AAqBnD,SAAgB,gBACd,WACA,OACA,MACS;CACT,IAAe,SAAS,KAAA,GAAW,eAAe,IAAI,WAAW,IAAI;CACrE,OAAO,qBAAqB;EAI1B,MAAM,QAAQ,YAAY;EAC1B,MAAM,WAAW,aAAa,CAAC,EAAE;EAEjC,MAAM,SAAS,WAAW;GAAE;GAAO,UAAU;EAAK,SAAS,UAAU,KAAK,CAAC;EAEzE,eACE,eAAe,mBACf,OACA,eAAe,IAAI,SAAS,GAC5B,MACF;EACA,WAAW,aAAa,eAAe,eAAe,qBAAqB,KAAK,CAAC;EAEnF,OAAO;CACT,CAAC;AACH"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { Accessor } from "@shadow-js/core";
|
|
2
|
+
/**
|
|
3
|
+
* `visible` shows the children; `hidden` keeps them alive (state, DOM and focus) but out of sight.
|
|
4
|
+
* @since 1.0.0
|
|
5
|
+
*/
|
|
6
|
+
export type ActivityMode = "visible" | "hidden";
|
|
7
|
+
/**
|
|
8
|
+
* Props of {@link Activity}.
|
|
9
|
+
* @since 1.0.0
|
|
10
|
+
*/
|
|
11
|
+
export interface ActivityProps {
|
|
12
|
+
/**
|
|
13
|
+
* `"visible"` shows the children; `"hidden"` keeps them alive but out of sight. Changing it
|
|
14
|
+
* does not rebuild the children and may be reactive.
|
|
15
|
+
* @default "visible"
|
|
16
|
+
*/
|
|
17
|
+
readonly mode?: ActivityMode;
|
|
18
|
+
/**
|
|
19
|
+
* The content. Built once, when the parent first renders the Activity.
|
|
20
|
+
* @default undefined (the Activity renders nothing)
|
|
21
|
+
*/
|
|
22
|
+
readonly children?: unknown;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Keeps its children alive while hidden: `mode="hidden"` removes them from sight but keeps their state,
|
|
26
|
+
* their DOM nodes and their focus and scroll position. Hidden content is paused: its effects run their
|
|
27
|
+
* cleanups and wait, its memos keep their last value, and its DOM does not update. Updates that arrive
|
|
28
|
+
* while hidden are applied once, when the content is shown again.
|
|
29
|
+
*
|
|
30
|
+
* Use it for tabs, wizards and routes you want back instantly. A hidden Activity mounted hidden renders
|
|
31
|
+
* its DOM once (so it is ready to show) and runs no effects until it is shown. The server renders the
|
|
32
|
+
* children without hiding them; the client hides them once it hydrates.
|
|
33
|
+
*
|
|
34
|
+
* @param props See {@link ActivityProps}.
|
|
35
|
+
* @returns An accessor of the content (two anchors and the children).
|
|
36
|
+
* @example
|
|
37
|
+
* import { useSignal } from "@shadow-js/core";
|
|
38
|
+
* import { Activity } from "@shadow-js/web";
|
|
39
|
+
*
|
|
40
|
+
* function Chat() {
|
|
41
|
+
* return <p>Chat</p>;
|
|
42
|
+
* }
|
|
43
|
+
*
|
|
44
|
+
* function Tabs() {
|
|
45
|
+
* const [tab] = useSignal("chat");
|
|
46
|
+
* return (
|
|
47
|
+
* <Activity mode={tab() === "chat" ? "visible" : "hidden"}>
|
|
48
|
+
* <Chat />
|
|
49
|
+
* </Activity>
|
|
50
|
+
* );
|
|
51
|
+
* }
|
|
52
|
+
* @see Show
|
|
53
|
+
* @since 1.0.0
|
|
54
|
+
*/
|
|
55
|
+
export declare function Activity(props: ActivityProps): Accessor<unknown>;
|
|
56
|
+
//# sourceMappingURL=activity.d.ts.map
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { runWithOwner, untrack, useEffect, useRenderEffect, useSignal } from "@shadow-js/core";
|
|
2
|
+
import { createOwner, pauseOwner, resumeOwner } from "@shadow-js/core/extend";
|
|
3
|
+
// src/control-flow/activity.ts
|
|
4
|
+
/**
|
|
5
|
+
* Hides the nodes between two anchors without removing them. Top-level elements get
|
|
6
|
+
* `display: none` (their own state, subtree and listeners are untouched). Top-level text nodes are
|
|
7
|
+
* detached (a text node cannot be hidden) and put back in order when shown. Scroll offsets and the
|
|
8
|
+
* focused element are remembered, because `display: none` loses both.
|
|
9
|
+
*/
|
|
10
|
+
function stashBetween(start, end) {
|
|
11
|
+
const parent = start.parentNode;
|
|
12
|
+
if (parent === null) return void 0;
|
|
13
|
+
const elements = [];
|
|
14
|
+
const texts = [];
|
|
15
|
+
const scrolls = [];
|
|
16
|
+
const active = document.activeElement;
|
|
17
|
+
let focus = null;
|
|
18
|
+
let node = start.nextSibling;
|
|
19
|
+
while (node !== null && node !== end) {
|
|
20
|
+
const next = node.nextSibling;
|
|
21
|
+
if (node.nodeType === 1) {
|
|
22
|
+
const element = node;
|
|
23
|
+
elements.push([element, element.style.display]);
|
|
24
|
+
element.style.display = "none";
|
|
25
|
+
for (const scrollable of [element, ...Array.from(element.querySelectorAll("*"))]) if (scrollable.scrollTop !== 0 || scrollable.scrollLeft !== 0) scrolls.push([
|
|
26
|
+
scrollable,
|
|
27
|
+
scrollable.scrollTop,
|
|
28
|
+
scrollable.scrollLeft
|
|
29
|
+
]);
|
|
30
|
+
if (active !== null && element.contains(active)) focus = active;
|
|
31
|
+
} else if (node.nodeType === 3) {
|
|
32
|
+
texts.push({
|
|
33
|
+
text: node,
|
|
34
|
+
parent,
|
|
35
|
+
next
|
|
36
|
+
});
|
|
37
|
+
parent.removeChild(node);
|
|
38
|
+
}
|
|
39
|
+
node = next;
|
|
40
|
+
}
|
|
41
|
+
return {
|
|
42
|
+
elements,
|
|
43
|
+
texts,
|
|
44
|
+
scrolls,
|
|
45
|
+
focus
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
/** Puts back what {@link stashBetween} changed. Texts are restored last-to-first, so each finds its next. */
|
|
49
|
+
function restore(stash, end) {
|
|
50
|
+
for (let i = stash.texts.length - 1; i >= 0; i -= 1) {
|
|
51
|
+
const entry = stash.texts[i];
|
|
52
|
+
if (entry === void 0 || entry.text.parentNode !== null) continue;
|
|
53
|
+
const before = entry.next !== null && entry.next.parentNode === entry.parent ? entry.next : end;
|
|
54
|
+
entry.parent.insertBefore(entry.text, before);
|
|
55
|
+
}
|
|
56
|
+
for (const [element, display] of stash.elements) element.style.display = display;
|
|
57
|
+
for (const [element, top, left] of stash.scrolls) {
|
|
58
|
+
element.scrollTop = top;
|
|
59
|
+
element.scrollLeft = left;
|
|
60
|
+
}
|
|
61
|
+
const focus = stash.focus;
|
|
62
|
+
if (focus instanceof HTMLElement && focus.isConnected) focus.focus({ preventScroll: true });
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Keeps its children alive while hidden: `mode="hidden"` removes them from sight but keeps their state,
|
|
66
|
+
* their DOM nodes and their focus and scroll position. Hidden content is paused: its effects run their
|
|
67
|
+
* cleanups and wait, its memos keep their last value, and its DOM does not update. Updates that arrive
|
|
68
|
+
* while hidden are applied once, when the content is shown again.
|
|
69
|
+
*
|
|
70
|
+
* Use it for tabs, wizards and routes you want back instantly. A hidden Activity mounted hidden renders
|
|
71
|
+
* its DOM once (so it is ready to show) and runs no effects until it is shown. The server renders the
|
|
72
|
+
* children without hiding them; the client hides them once it hydrates.
|
|
73
|
+
*
|
|
74
|
+
* @param props See {@link ActivityProps}.
|
|
75
|
+
* @returns An accessor of the content (two anchors and the children).
|
|
76
|
+
* @example
|
|
77
|
+
* import { useSignal } from "@shadow-js/core";
|
|
78
|
+
* import { Activity } from "@shadow-js/web";
|
|
79
|
+
*
|
|
80
|
+
* function Chat() {
|
|
81
|
+
* return <p>Chat</p>;
|
|
82
|
+
* }
|
|
83
|
+
*
|
|
84
|
+
* function Tabs() {
|
|
85
|
+
* const [tab] = useSignal("chat");
|
|
86
|
+
* return (
|
|
87
|
+
* <Activity mode={tab() === "chat" ? "visible" : "hidden"}>
|
|
88
|
+
* <Chat />
|
|
89
|
+
* </Activity>
|
|
90
|
+
* );
|
|
91
|
+
* }
|
|
92
|
+
* @see Show
|
|
93
|
+
* @since 1.0.0
|
|
94
|
+
*/
|
|
95
|
+
function Activity(props) {
|
|
96
|
+
const content = createOwner();
|
|
97
|
+
let built;
|
|
98
|
+
let ready = false;
|
|
99
|
+
const contentValue = () => {
|
|
100
|
+
if (!ready) {
|
|
101
|
+
ready = true;
|
|
102
|
+
built = runWithOwner(content, () => untrack(() => props.children));
|
|
103
|
+
}
|
|
104
|
+
return built;
|
|
105
|
+
};
|
|
106
|
+
const start = document.createTextNode("");
|
|
107
|
+
const end = document.createTextNode("");
|
|
108
|
+
const [hidden, setHidden] = useSignal(false);
|
|
109
|
+
let paused = false;
|
|
110
|
+
useRenderEffect(() => props.mode === "hidden", (isHidden) => {
|
|
111
|
+
if (isHidden === paused) return;
|
|
112
|
+
paused = isHidden;
|
|
113
|
+
if (isHidden) pauseOwner(content);
|
|
114
|
+
else resumeOwner(content);
|
|
115
|
+
setHidden(isHidden);
|
|
116
|
+
});
|
|
117
|
+
let stash;
|
|
118
|
+
useEffect(() => {
|
|
119
|
+
if (hidden()) {
|
|
120
|
+
if (stash === void 0) stash = stashBetween(start, end);
|
|
121
|
+
} else if (stash !== void 0) {
|
|
122
|
+
const previous = stash;
|
|
123
|
+
stash = void 0;
|
|
124
|
+
restore(previous, end);
|
|
125
|
+
}
|
|
126
|
+
});
|
|
127
|
+
return () => [
|
|
128
|
+
start,
|
|
129
|
+
contentValue(),
|
|
130
|
+
end
|
|
131
|
+
];
|
|
132
|
+
}
|
|
133
|
+
export { Activity };
|
|
134
|
+
|
|
135
|
+
//# sourceMappingURL=activity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"activity.js","names":[],"sources":["../../../src/control-flow/activity.ts"],"sourcesContent":["import {\n type Accessor,\n runWithOwner,\n untrack,\n useEffect,\n useRenderEffect,\n useSignal,\n} from \"@shadow-js/core\";\nimport { createOwner, pauseOwner, resumeOwner } from \"@shadow-js/core/extend\";\n\n/**\n * `visible` shows the children; `hidden` keeps them alive (state, DOM and focus) but out of sight.\n * @since 1.0.0\n */\nexport type ActivityMode = \"visible\" | \"hidden\";\n\n/**\n * Props of {@link Activity}.\n * @since 1.0.0\n */\nexport interface ActivityProps {\n /**\n * `\"visible\"` shows the children; `\"hidden\"` keeps them alive but out of sight. Changing it\n * does not rebuild the children and may be reactive.\n * @default \"visible\"\n */\n readonly mode?: ActivityMode;\n /**\n * The content. Built once, when the parent first renders the Activity.\n * @default undefined (the Activity renders nothing)\n */\n readonly children?: unknown;\n}\n\n/** What a hidden Activity changed in the DOM, so showing it restores exactly that. */\ninterface Stash {\n readonly elements: Array<readonly [HTMLElement, string]>;\n readonly texts: Array<{ readonly text: Text; readonly parent: Node; readonly next: Node | null }>;\n readonly scrolls: Array<readonly [Element, number, number]>;\n readonly focus: Element | null;\n}\n\n/**\n * Hides the nodes between two anchors without removing them. Top-level elements get\n * `display: none` (their own state, subtree and listeners are untouched). Top-level text nodes are\n * detached (a text node cannot be hidden) and put back in order when shown. Scroll offsets and the\n * focused element are remembered, because `display: none` loses both.\n */\nfunction stashBetween(start: Node, end: Node): Stash | undefined {\n const parent = start.parentNode;\n if (parent === null) return undefined;\n const elements: Array<readonly [HTMLElement, string]> = [];\n const texts: Stash[\"texts\"][number][] = [];\n const scrolls: Array<readonly [Element, number, number]> = [];\n const active = document.activeElement;\n let focus: Element | null = null;\n let node: Node | null = start.nextSibling;\n while (node !== null && node !== end) {\n const next: Node | null = node.nextSibling;\n if (node.nodeType === 1) {\n const element = node as HTMLElement;\n elements.push([element, element.style.display]);\n element.style.display = \"none\";\n for (const scrollable of [element, ...Array.from(element.querySelectorAll(\"*\"))]) {\n if (scrollable.scrollTop !== 0 || scrollable.scrollLeft !== 0) {\n scrolls.push([scrollable, scrollable.scrollTop, scrollable.scrollLeft]);\n }\n }\n if (active !== null && element.contains(active)) focus = active;\n } else if (node.nodeType === 3) {\n texts.push({ text: node as Text, parent, next });\n parent.removeChild(node);\n }\n node = next;\n }\n return { elements, texts, scrolls, focus };\n}\n\n/** Puts back what {@link stashBetween} changed. Texts are restored last-to-first, so each finds its next. */\nfunction restore(stash: Stash, end: Node): void {\n for (let i = stash.texts.length - 1; i >= 0; i -= 1) {\n const entry = stash.texts[i];\n if (entry === undefined || entry.text.parentNode !== null) continue;\n const before = entry.next !== null && entry.next.parentNode === entry.parent ? entry.next : end;\n entry.parent.insertBefore(entry.text, before);\n }\n for (const [element, display] of stash.elements) element.style.display = display;\n for (const [element, top, left] of stash.scrolls) {\n element.scrollTop = top;\n element.scrollLeft = left;\n }\n const focus = stash.focus;\n if (focus instanceof HTMLElement && focus.isConnected) focus.focus({ preventScroll: true });\n}\n\n/**\n * Keeps its children alive while hidden: `mode=\"hidden\"` removes them from sight but keeps their state,\n * their DOM nodes and their focus and scroll position. Hidden content is paused: its effects run their\n * cleanups and wait, its memos keep their last value, and its DOM does not update. Updates that arrive\n * while hidden are applied once, when the content is shown again.\n *\n * Use it for tabs, wizards and routes you want back instantly. A hidden Activity mounted hidden renders\n * its DOM once (so it is ready to show) and runs no effects until it is shown. The server renders the\n * children without hiding them; the client hides them once it hydrates.\n *\n * @param props See {@link ActivityProps}.\n * @returns An accessor of the content (two anchors and the children).\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { Activity } from \"@shadow-js/web\";\n *\n * function Chat() {\n * return <p>Chat</p>;\n * }\n *\n * function Tabs() {\n * const [tab] = useSignal(\"chat\");\n * return (\n * <Activity mode={tab() === \"chat\" ? \"visible\" : \"hidden\"}>\n * <Chat />\n * </Activity>\n * );\n * }\n * @see Show\n * @since 1.0.0\n */\nexport function Activity(props: ActivityProps): Accessor<unknown> {\n if (__SERVER__) return () => props.children;\n // The content lives under its own owner, so pausing it reaches every effect and memo it created.\n const content = createOwner();\n // Built when the parent first reads it, not here: the server builds children at the same point of the\n // render, which keeps hydration keys equal on both sides.\n let built: unknown;\n let ready = false;\n const contentValue = (): unknown => {\n if (!ready) {\n ready = true;\n built = runWithOwner(content, () => untrack(() => props.children));\n }\n return built;\n };\n // Empty text anchors bound the content: the DOM range the visibility code hides and shows.\n const start = document.createTextNode(\"\");\n const end = document.createTextNode(\"\");\n const [hidden, setHidden] = useSignal(false);\n let paused = false;\n // Pausing happens in the render phase, before the content's own effects can run.\n useRenderEffect(\n () => props.mode === \"hidden\",\n (isHidden) => {\n if (isHidden === paused) return;\n paused = isHidden;\n if (isHidden) pauseOwner(content);\n else resumeOwner(content);\n setHidden(isHidden);\n },\n );\n // Runs after the DOM is committed (a user effect), so the nodes it hides exist.\n let stash: Stash | undefined;\n useEffect(() => {\n if (hidden()) {\n if (stash === undefined) stash = stashBetween(start, end);\n } else if (stash !== undefined) {\n const previous = stash;\n stash = undefined;\n restore(previous, end);\n }\n });\n return () => [start, contentValue(), end];\n}\n"],"mappings":";;;;;;;;;AAgDA,SAAS,aAAa,OAAa,KAA8B;CAC/D,MAAM,SAAS,MAAM;CACrB,IAAI,WAAW,MAAM,OAAO,KAAA;CAC5B,MAAM,WAAkD,CAAC;CACzD,MAAM,QAAkC,CAAC;CACzC,MAAM,UAAqD,CAAC;CAC5D,MAAM,SAAS,SAAS;CACxB,IAAI,QAAwB;CAC5B,IAAI,OAAoB,MAAM;CAC9B,OAAO,SAAS,QAAQ,SAAS,KAAK;EACpC,MAAM,OAAoB,KAAK;EAC/B,IAAI,KAAK,aAAa,GAAG;GACvB,MAAM,UAAU;GAChB,SAAS,KAAK,CAAC,SAAS,QAAQ,MAAM,OAAO,CAAC;GAC9C,QAAQ,MAAM,UAAU;GACxB,KAAK,MAAM,cAAc,CAAC,SAAS,GAAG,MAAM,KAAK,QAAQ,iBAAiB,GAAG,CAAC,CAAC,GAC7E,IAAI,WAAW,cAAc,KAAK,WAAW,eAAe,GAC1D,QAAQ,KAAK;IAAC;IAAY,WAAW;IAAW,WAAW;GAAU,CAAC;GAG1E,IAAI,WAAW,QAAQ,QAAQ,SAAS,MAAM,GAAG,QAAQ;EAC3D,OAAO,IAAI,KAAK,aAAa,GAAG;GAC9B,MAAM,KAAK;IAAE,MAAM;IAAc;IAAQ;GAAK,CAAC;GAC/C,OAAO,YAAY,IAAI;EACzB;EACA,OAAO;CACT;CACA,OAAO;EAAE;EAAU;EAAO;EAAS;CAAM;AAC3C;;AAGA,SAAS,QAAQ,OAAc,KAAiB;CAC9C,KAAK,IAAI,IAAI,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EACnD,MAAM,QAAQ,MAAM,MAAM;EAC1B,IAAI,UAAU,KAAA,KAAa,MAAM,KAAK,eAAe,MAAM;EAC3D,MAAM,SAAS,MAAM,SAAS,QAAQ,MAAM,KAAK,eAAe,MAAM,SAAS,MAAM,OAAO;EAC5F,MAAM,OAAO,aAAa,MAAM,MAAM,MAAM;CAC9C;CACA,KAAK,MAAM,CAAC,SAAS,YAAY,MAAM,UAAU,QAAQ,MAAM,UAAU;CACzE,KAAK,MAAM,CAAC,SAAS,KAAK,SAAS,MAAM,SAAS;EAChD,QAAQ,YAAY;EACpB,QAAQ,aAAa;CACvB;CACA,MAAM,QAAQ,MAAM;CACpB,IAAI,iBAAiB,eAAe,MAAM,aAAa,MAAM,MAAM,EAAE,eAAe,KAAK,CAAC;AAC5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,SAAS,OAAyC;CAGhE,MAAM,UAAU,YAAY;CAG5B,IAAI;CACJ,IAAI,QAAQ;CACZ,MAAM,qBAA8B;EAClC,IAAI,CAAC,OAAO;GACV,QAAQ;GACR,QAAQ,aAAa,eAAe,cAAc,MAAM,QAAQ,CAAC;EACnE;EACA,OAAO;CACT;CAEA,MAAM,QAAQ,SAAS,eAAe,EAAE;CACxC,MAAM,MAAM,SAAS,eAAe,EAAE;CACtC,MAAM,CAAC,QAAQ,aAAa,UAAU,KAAK;CAC3C,IAAI,SAAS;CAEb,sBACQ,MAAM,SAAS,WACpB,aAAa;EACZ,IAAI,aAAa,QAAQ;EACzB,SAAS;EACT,IAAI,UAAU,WAAW,OAAO;OAC3B,YAAY,OAAO;EACxB,UAAU,QAAQ;CACpB,CACF;CAEA,IAAI;CACJ,gBAAgB;EACd,IAAI,OAAO,GACL;OAAA,UAAU,KAAA,GAAW,QAAQ,aAAa,OAAO,GAAG;EAAA,OACnD,IAAI,UAAU,KAAA,GAAW;GAC9B,MAAM,WAAW;GACjB,QAAQ,KAAA;GACR,QAAQ,UAAU,GAAG;EACvB;CACF,CAAC;CACD,aAAa;EAAC;EAAO,aAAa;EAAG;CAAG;AAC1C"}
|