@shadow-js/web 0.0.0-stage → 1.0.0
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 +12 -0
- package/LICENSE +21 -0
- package/README.md +190 -2
- package/dist/dev/attributes.d.ts +90 -0
- package/dist/dev/attributes.js +196 -0
- package/dist/dev/attributes.js.map +1 -0
- package/dist/dev/autofocus.d.ts +32 -0
- package/dist/dev/autofocus.js +45 -0
- package/dist/dev/autofocus.js.map +1 -0
- package/dist/dev/class-style.d.ts +89 -0
- package/dist/dev/class-style.js +197 -0
- package/dist/dev/class-style.js.map +1 -0
- package/dist/dev/component.d.ts +23 -0
- package/dist/dev/component.js +42 -0
- package/dist/dev/component.js.map +1 -0
- package/dist/dev/control-flow/activity.d.ts +58 -0
- package/dist/dev/control-flow/activity.js +136 -0
- package/dist/dev/control-flow/activity.js.map +1 -0
- package/dist/dev/control-flow/branch.js +104 -0
- package/dist/dev/control-flow/branch.js.map +1 -0
- package/dist/dev/control-flow/client-only.d.ts +48 -0
- package/dist/dev/control-flow/client-only.js +50 -0
- package/dist/dev/control-flow/client-only.js.map +1 -0
- package/dist/dev/control-flow/dynamic.d.ts +82 -0
- package/dist/dev/control-flow/dynamic.js +134 -0
- package/dist/dev/control-flow/dynamic.js.map +1 -0
- package/dist/dev/control-flow/error-boundary.d.ts +72 -0
- package/dist/dev/control-flow/error-boundary.js +115 -0
- package/dist/dev/control-flow/error-boundary.js.map +1 -0
- package/dist/dev/control-flow/for.d.ts +80 -0
- package/dist/dev/control-flow/for.js +23 -0
- package/dist/dev/control-flow/for.js.map +1 -0
- package/dist/dev/control-flow/fragment.d.ts +38 -0
- package/dist/dev/control-flow/fragment.js +31 -0
- package/dist/dev/control-flow/fragment.js.map +1 -0
- package/dist/dev/control-flow/hot-link.js +64 -0
- package/dist/dev/control-flow/hot-link.js.map +1 -0
- package/dist/dev/control-flow/index-list.d.ts +48 -0
- package/dist/dev/control-flow/index-list.js +31 -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 +58 -0
- package/dist/dev/control-flow/lazy.js +64 -0
- package/dist/dev/control-flow/lazy.js.map +1 -0
- package/dist/dev/control-flow/no-hydration.d.ts +39 -0
- package/dist/dev/control-flow/no-hydration.js +58 -0
- package/dist/dev/control-flow/no-hydration.js.map +1 -0
- package/dist/dev/control-flow/portal.d.ts +69 -0
- package/dist/dev/control-flow/portal.js +134 -0
- package/dist/dev/control-flow/portal.js.map +1 -0
- package/dist/dev/control-flow/root-errors.d.ts +25 -0
- package/dist/dev/control-flow/root-errors.js +33 -0
- package/dist/dev/control-flow/root-errors.js.map +1 -0
- package/dist/dev/control-flow/show.d.ts +101 -0
- package/dist/dev/control-flow/show.js +18 -0
- package/dist/dev/control-flow/show.js.map +1 -0
- package/dist/dev/control-flow/suspense-list.d.ts +65 -0
- package/dist/dev/control-flow/suspense-list.js +105 -0
- package/dist/dev/control-flow/suspense-list.js.map +1 -0
- package/dist/dev/control-flow/suspense.d.ts +53 -0
- package/dist/dev/control-flow/suspense.js +102 -0
- package/dist/dev/control-flow/suspense.js.map +1 -0
- package/dist/dev/control-flow/switch.d.ts +85 -0
- package/dist/dev/control-flow/switch.js +90 -0
- package/dist/dev/control-flow/switch.js.map +1 -0
- package/dist/dev/derived.d.ts +52 -0
- package/dist/dev/derived.js +34 -0
- package/dist/dev/derived.js.map +1 -0
- package/dist/dev/element.d.ts +40 -0
- package/dist/dev/element.js +105 -0
- package/dist/dev/element.js.map +1 -0
- package/dist/dev/events.d.ts +87 -0
- package/dist/dev/events.js +265 -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 +137 -0
- package/dist/dev/head/components.js +170 -0
- package/dist/dev/head/components.js.map +1 -0
- package/dist/dev/head/registry.js +68 -0
- package/dist/dev/head/registry.js.map +1 -0
- package/dist/dev/head/server-head.d.ts +54 -0
- package/dist/dev/head/server-head.js +76 -0
- package/dist/dev/head/server-head.js.map +1 -0
- package/dist/dev/head/sink.js +96 -0
- package/dist/dev/head/sink.js.map +1 -0
- package/dist/dev/head/use-head.d.ts +35 -0
- package/dist/dev/head/use-head.js +84 -0
- package/dist/dev/head/use-head.js.map +1 -0
- package/dist/dev/head/validate.d.ts +85 -0
- package/dist/dev/head/validate.js +268 -0
- package/dist/dev/head/validate.js.map +1 -0
- package/dist/dev/hmr.d.ts +82 -0
- package/dist/dev/hmr.js +124 -0
- package/dist/dev/hmr.js.map +1 -0
- package/dist/dev/hydration.d.ts +61 -0
- package/dist/dev/hydration.js +120 -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 +97 -0
- package/dist/dev/insert.js +357 -0
- package/dist/dev/insert.js.map +1 -0
- package/dist/dev/internal/claim.d.ts +106 -0
- package/dist/dev/internal/claim.js +357 -0
- package/dist/dev/internal/claim.js.map +1 -0
- package/dist/dev/internal/css-units.js +26 -0
- package/dist/dev/internal/css-units.js.map +1 -0
- package/dist/dev/internal/diagnostics.d.ts +30 -0
- package/dist/dev/internal/diagnostics.js +38 -0
- package/dist/dev/internal/diagnostics.js.map +1 -0
- package/dist/dev/internal/early-events.js +76 -0
- package/dist/dev/internal/early-events.js.map +1 -0
- package/dist/dev/internal/hydration-hooks.d.ts +43 -0
- package/dist/dev/internal/hydration-hooks.js +27 -0
- package/dist/dev/internal/hydration-hooks.js.map +1 -0
- package/dist/dev/internal/hydration-scope.d.ts +131 -0
- package/dist/dev/internal/hydration-scope.js +156 -0
- package/dist/dev/internal/hydration-scope.js.map +1 -0
- package/dist/dev/internal/names.d.ts +33 -0
- package/dist/dev/internal/names.js +35 -0
- package/dist/dev/internal/names.js.map +1 -0
- package/dist/dev/internal/portal-context.d.ts +39 -0
- package/dist/dev/internal/portal-context.js +28 -0
- package/dist/dev/internal/portal-context.js.map +1 -0
- package/dist/dev/internal/react-names.js +116 -0
- package/dist/dev/internal/react-names.js.map +1 -0
- package/dist/dev/internal/reconcile.d.ts +40 -0
- package/dist/dev/internal/reconcile.js +122 -0
- package/dist/dev/internal/reconcile.js.map +1 -0
- package/dist/dev/internal/stream-context.d.ts +47 -0
- package/dist/dev/internal/stream-context.js +23 -0
- package/dist/dev/internal/stream-context.js.map +1 -0
- package/dist/dev/jsx/aria.d.ts +72 -0
- package/dist/dev/jsx/component.d.ts +89 -0
- package/dist/dev/jsx/events.d.ts +364 -0
- package/dist/dev/jsx/global.d.ts +211 -0
- package/dist/dev/jsx/html.d.ts +879 -0
- package/dist/dev/jsx/intrinsic.d.ts +59 -0
- package/dist/dev/jsx/mathml.d.ts +186 -0
- package/dist/dev/jsx/svg.d.ts +607 -0
- package/dist/dev/jsx/types.d.ts +176 -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 +94 -0
- package/dist/dev/jsx-runtime.js +0 -0
- package/dist/dev/reactive.d.ts +110 -0
- package/dist/dev/reactive.js +85 -0
- package/dist/dev/reactive.js.map +1 -0
- package/dist/dev/render.d.ts +36 -0
- package/dist/dev/render.js +52 -0
- package/dist/dev/render.js.map +1 -0
- package/dist/dev/resource-hints.d.ts +145 -0
- package/dist/dev/resource-hints.js +200 -0
- package/dist/dev/resource-hints.js.map +1 -0
- package/dist/dev/select-value.d.ts +24 -0
- package/dist/dev/select-value.js +51 -0
- package/dist/dev/select-value.js.map +1 -0
- package/dist/dev/server/attributes.d.ts +33 -0
- package/dist/dev/server/attributes.js +155 -0
- package/dist/dev/server/attributes.js.map +1 -0
- package/dist/dev/server/class-style.d.ts +46 -0
- package/dist/dev/server/class-style.js +173 -0
- package/dist/dev/server/class-style.js.map +1 -0
- package/dist/dev/server/component.d.ts +42 -0
- package/dist/dev/server/component.js +72 -0
- package/dist/dev/server/component.js.map +1 -0
- package/dist/dev/server/derived.d.ts +41 -0
- package/dist/dev/server/derived.js +26 -0
- package/dist/dev/server/derived.js.map +1 -0
- package/dist/dev/server/element.d.ts +89 -0
- package/dist/dev/server/element.js +216 -0
- package/dist/dev/server/element.js.map +1 -0
- package/dist/dev/server/errors.js +26 -0
- package/dist/dev/server/errors.js.map +1 -0
- package/dist/dev/server/escape.d.ts +30 -0
- package/dist/dev/server/escape.js +119 -0
- package/dist/dev/server/escape.js.map +1 -0
- package/dist/dev/server/form-controls.d.ts +50 -0
- package/dist/dev/server/form-controls.js +193 -0
- package/dist/dev/server/form-controls.js.map +1 -0
- package/dist/dev/server/hydration-script.d.ts +65 -0
- package/dist/dev/server/hydration-script.js +59 -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 +13 -0
- package/dist/dev/server/node.js +21 -0
- package/dist/dev/server/node.js.map +1 -0
- package/dist/dev/server/portals.d.ts +46 -0
- package/dist/dev/server/portals.js +99 -0
- package/dist/dev/server/portals.js.map +1 -0
- package/dist/dev/server/render.d.ts +129 -0
- package/dist/dev/server/render.js +256 -0
- package/dist/dev/server/render.js.map +1 -0
- package/dist/dev/server/serialize.d.ts +45 -0
- package/dist/dev/server/serialize.js +315 -0
- package/dist/dev/server/serialize.js.map +1 -0
- package/dist/dev/server/stream.d.ts +94 -0
- package/dist/dev/server/stream.js +235 -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 +49 -0
- package/dist/dev/spread.js +296 -0
- package/dist/dev/spread.js.map +1 -0
- package/dist/dev/template.d.ts +26 -0
- package/dist/dev/template.js +120 -0
- package/dist/dev/template.js.map +1 -0
- package/dist/dev/view-transition.d.ts +97 -0
- package/dist/dev/view-transition.js +121 -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 +196 -0
- package/dist/server-dev/attributes.js.map +1 -0
- package/dist/server-dev/autofocus.js +45 -0
- package/dist/server-dev/autofocus.js.map +1 -0
- package/dist/server-dev/class-style.js +197 -0
- package/dist/server-dev/class-style.js.map +1 -0
- package/dist/server-dev/component.js +42 -0
- package/dist/server-dev/component.js.map +1 -0
- package/dist/server-dev/control-flow/activity.js +41 -0
- package/dist/server-dev/control-flow/activity.js.map +1 -0
- package/dist/server-dev/control-flow/branch.js +104 -0
- package/dist/server-dev/control-flow/branch.js.map +1 -0
- package/dist/server-dev/control-flow/client-only.js +50 -0
- package/dist/server-dev/control-flow/client-only.js.map +1 -0
- package/dist/server-dev/control-flow/dynamic.js +106 -0
- package/dist/server-dev/control-flow/dynamic.js.map +1 -0
- package/dist/server-dev/control-flow/error-boundary.js +115 -0
- package/dist/server-dev/control-flow/error-boundary.js.map +1 -0
- package/dist/server-dev/control-flow/for.js +23 -0
- package/dist/server-dev/control-flow/for.js.map +1 -0
- package/dist/server-dev/control-flow/fragment.js +31 -0
- package/dist/server-dev/control-flow/fragment.js.map +1 -0
- package/dist/server-dev/control-flow/hot-link.js +57 -0
- package/dist/server-dev/control-flow/hot-link.js.map +1 -0
- package/dist/server-dev/control-flow/index-list.js +31 -0
- package/dist/server-dev/control-flow/index-list.js.map +1 -0
- package/dist/server-dev/control-flow/lazy.js +64 -0
- package/dist/server-dev/control-flow/lazy.js.map +1 -0
- package/dist/server-dev/control-flow/no-hydration.js +40 -0
- package/dist/server-dev/control-flow/no-hydration.js.map +1 -0
- package/dist/server-dev/control-flow/portal.js +134 -0
- package/dist/server-dev/control-flow/portal.js.map +1 -0
- package/dist/server-dev/control-flow/root-errors.js +33 -0
- package/dist/server-dev/control-flow/root-errors.js.map +1 -0
- package/dist/server-dev/control-flow/show.js +18 -0
- package/dist/server-dev/control-flow/show.js.map +1 -0
- package/dist/server-dev/control-flow/suspense-list.js +100 -0
- package/dist/server-dev/control-flow/suspense-list.js.map +1 -0
- package/dist/server-dev/control-flow/suspense.js +119 -0
- package/dist/server-dev/control-flow/suspense.js.map +1 -0
- package/dist/server-dev/control-flow/switch.js +90 -0
- package/dist/server-dev/control-flow/switch.js.map +1 -0
- package/dist/server-dev/derived.js +34 -0
- package/dist/server-dev/derived.js.map +1 -0
- package/dist/server-dev/element.js +66 -0
- package/dist/server-dev/element.js.map +1 -0
- package/dist/server-dev/events.js +265 -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 +170 -0
- package/dist/server-dev/head/components.js.map +1 -0
- package/dist/server-dev/head/registry.js +68 -0
- package/dist/server-dev/head/registry.js.map +1 -0
- package/dist/server-dev/head/server-head.js +76 -0
- package/dist/server-dev/head/server-head.js.map +1 -0
- package/dist/server-dev/head/sink.js +96 -0
- package/dist/server-dev/head/sink.js.map +1 -0
- package/dist/server-dev/head/use-head.js +84 -0
- package/dist/server-dev/head/use-head.js.map +1 -0
- package/dist/server-dev/head/validate.js +268 -0
- package/dist/server-dev/head/validate.js.map +1 -0
- package/dist/server-dev/hydration.js +120 -0
- package/dist/server-dev/hydration.js.map +1 -0
- package/dist/server-dev/index.js +34 -0
- package/dist/server-dev/insert.js +357 -0
- package/dist/server-dev/insert.js.map +1 -0
- package/dist/server-dev/internal/claim.js +357 -0
- package/dist/server-dev/internal/claim.js.map +1 -0
- package/dist/server-dev/internal/css-units.js +26 -0
- package/dist/server-dev/internal/css-units.js.map +1 -0
- package/dist/server-dev/internal/diagnostics.js +38 -0
- package/dist/server-dev/internal/diagnostics.js.map +1 -0
- package/dist/server-dev/internal/early-events.js +76 -0
- package/dist/server-dev/internal/early-events.js.map +1 -0
- package/dist/server-dev/internal/hydration-hooks.js +27 -0
- package/dist/server-dev/internal/hydration-hooks.js.map +1 -0
- package/dist/server-dev/internal/hydration-scope.js +156 -0
- package/dist/server-dev/internal/hydration-scope.js.map +1 -0
- package/dist/server-dev/internal/names.js +35 -0
- package/dist/server-dev/internal/names.js.map +1 -0
- package/dist/server-dev/internal/portal-context.js +28 -0
- package/dist/server-dev/internal/portal-context.js.map +1 -0
- package/dist/server-dev/internal/react-names.js +116 -0
- package/dist/server-dev/internal/react-names.js.map +1 -0
- package/dist/server-dev/internal/reconcile.js +122 -0
- package/dist/server-dev/internal/reconcile.js.map +1 -0
- package/dist/server-dev/internal/stream-context.js +23 -0
- package/dist/server-dev/internal/stream-context.js.map +1 -0
- package/dist/server-dev/reactive.js +85 -0
- package/dist/server-dev/reactive.js.map +1 -0
- package/dist/server-dev/render.js +52 -0
- package/dist/server-dev/render.js.map +1 -0
- package/dist/server-dev/resource-hints.js +200 -0
- package/dist/server-dev/resource-hints.js.map +1 -0
- package/dist/server-dev/select-value.js +51 -0
- package/dist/server-dev/select-value.js.map +1 -0
- package/dist/server-dev/server/attributes.js +155 -0
- package/dist/server-dev/server/attributes.js.map +1 -0
- package/dist/server-dev/server/class-style.js +173 -0
- package/dist/server-dev/server/class-style.js.map +1 -0
- package/dist/server-dev/server/component.js +72 -0
- package/dist/server-dev/server/component.js.map +1 -0
- package/dist/server-dev/server/derived.js +26 -0
- package/dist/server-dev/server/derived.js.map +1 -0
- package/dist/server-dev/server/element.js +216 -0
- package/dist/server-dev/server/element.js.map +1 -0
- package/dist/server-dev/server/errors.js +26 -0
- package/dist/server-dev/server/errors.js.map +1 -0
- package/dist/server-dev/server/escape.js +119 -0
- package/dist/server-dev/server/escape.js.map +1 -0
- package/dist/server-dev/server/form-controls.js +193 -0
- package/dist/server-dev/server/form-controls.js.map +1 -0
- package/dist/server-dev/server/hydration-script.js +59 -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 +21 -0
- package/dist/server-dev/server/node.js.map +1 -0
- package/dist/server-dev/server/portals.js +99 -0
- package/dist/server-dev/server/portals.js.map +1 -0
- package/dist/server-dev/server/render.js +256 -0
- package/dist/server-dev/server/render.js.map +1 -0
- package/dist/server-dev/server/serialize.js +315 -0
- package/dist/server-dev/server/serialize.js.map +1 -0
- package/dist/server-dev/server/stream.js +235 -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 +296 -0
- package/dist/server-dev/spread.js.map +1 -0
- package/dist/server-dev/template.js +120 -0
- package/dist/server-dev/template.js.map +1 -0
- package/dist/server-dev/view-transition.js +90 -0
- package/dist/server-dev/view-transition.js.map +1 -0
- package/package.json +136 -4
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
//#region src/jsx/types.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Shared value types for ShadowJS JSX. Everything here is a type: this module emits no code.
|
|
4
|
+
*
|
|
5
|
+
* Attribute values follow the DOM runtime contract: `null` and
|
|
6
|
+
* `undefined` remove an attribute, so every attribute type accepts them.
|
|
7
|
+
*
|
|
8
|
+
* @since 1.0.0
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* A value that may be absent at runtime. `null` and `undefined` remove the attribute or property.
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* import type { Maybe } from "@shadow-js/web";
|
|
15
|
+
*
|
|
16
|
+
* function linkTarget(external: boolean): Maybe<string> {
|
|
17
|
+
* return external ? "_blank" : undefined; // undefined: no target attribute
|
|
18
|
+
* }
|
|
19
|
+
* const link = <a href="/docs" target={linkTarget(true)}>Docs</a>;
|
|
20
|
+
* @since 1.0.0
|
|
21
|
+
*/
|
|
22
|
+
export type Maybe<T> = T | null | undefined;
|
|
23
|
+
/**
|
|
24
|
+
* Booleans written either as `true`/`false` or as the strings the DOM enumerates: the value type of
|
|
25
|
+
* enumerated attributes such as `draggable`, `spellcheck` and the `aria-*` flags.
|
|
26
|
+
*
|
|
27
|
+
* @example
|
|
28
|
+
* import type { Booleanish } from "@shadow-js/web";
|
|
29
|
+
*
|
|
30
|
+
* const expanded: Booleanish = "false";
|
|
31
|
+
* const toggle = <button aria-expanded={expanded}>Menu</button>;
|
|
32
|
+
* @since 1.0.0
|
|
33
|
+
*/
|
|
34
|
+
export type Booleanish = boolean | "true" | "false";
|
|
35
|
+
/**
|
|
36
|
+
* A literal union that still accepts any other string. Keeps editor completions for the known
|
|
37
|
+
* values without rejecting future ones.
|
|
38
|
+
*
|
|
39
|
+
* @since 1.0.0
|
|
40
|
+
* @internal
|
|
41
|
+
*/
|
|
42
|
+
export type LooseString<T extends string> = T | (string & Record<never, never>);
|
|
43
|
+
/**
|
|
44
|
+
* Everything a JSX expression can produce or a child can be: DOM nodes, text, numbers, booleans,
|
|
45
|
+
* nothing, accessors (`() => child`, re-run when their dependencies change) and nested arrays.
|
|
46
|
+
* `JSX.Element` is this type.
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* import type { JsxChild } from "@shadow-js/web";
|
|
50
|
+
*
|
|
51
|
+
* function list(items: readonly string[]): JsxChild {
|
|
52
|
+
* return items.length === 0 ? "Nothing yet" : items.map((item) => <li>{item}</li>);
|
|
53
|
+
* }
|
|
54
|
+
* @since 1.0.0
|
|
55
|
+
*/
|
|
56
|
+
export type JsxChild = Node | string | number | boolean | null | undefined | (() => JsxChild) | readonly JsxChild[];
|
|
57
|
+
/**
|
|
58
|
+
* Children of elements whose content is text only: `textarea`, `option`, `script`, `style`.
|
|
59
|
+
* Accessors are allowed because the runtime inserts text nodes reactively.
|
|
60
|
+
*
|
|
61
|
+
* @example
|
|
62
|
+
* import { useSignal } from "@shadow-js/core";
|
|
63
|
+
* import type { TextChild } from "@shadow-js/web";
|
|
64
|
+
*
|
|
65
|
+
* const [draft] = useSignal("Hello");
|
|
66
|
+
* const content: TextChild = draft;
|
|
67
|
+
* const editor = <textarea>{content}</textarea>;
|
|
68
|
+
* @since 1.0.0
|
|
69
|
+
*/
|
|
70
|
+
export type TextChild = string | number | null | undefined | (() => string | number | null | undefined);
|
|
71
|
+
/**
|
|
72
|
+
* A class value in the clsx style the runtime understands: strings, numbers (0 is dropped), booleans,
|
|
73
|
+
* nested arrays and objects whose truthy keys become class names. `null`, `undefined` and `false`
|
|
74
|
+
* remove the `class` attribute.
|
|
75
|
+
*
|
|
76
|
+
* @example
|
|
77
|
+
* import type { ClassValue } from "@shadow-js/web";
|
|
78
|
+
*
|
|
79
|
+
* const active = true;
|
|
80
|
+
* const classes: ClassValue = ["card", { "card--active": active }, undefined];
|
|
81
|
+
* const card = <div class={classes} />;
|
|
82
|
+
* @since 1.0.0
|
|
83
|
+
*/
|
|
84
|
+
export type ClassValue = string | number | boolean | null | undefined | ClassArray | ClassDictionary;
|
|
85
|
+
/** A nested class list. @since 1.0.0 */
|
|
86
|
+
export type ClassArray = readonly ClassValue[];
|
|
87
|
+
/** A class map: each truthy key contributes its class names. @since 1.0.0 */
|
|
88
|
+
export type ClassDictionary = Readonly<Record<string, unknown>>;
|
|
89
|
+
/**
|
|
90
|
+
* A value for one CSS property: a string, a number (in pixels, as in React, unless the property is
|
|
91
|
+
* unitless such as `opacity`, and `0` is `0`), or `null` or `undefined` (removes the property).
|
|
92
|
+
*
|
|
93
|
+
* @since 1.0.0
|
|
94
|
+
*/
|
|
95
|
+
export type CSSPropertyValue = string | number | null | undefined;
|
|
96
|
+
/** `backgroundColor` to `background-color`; `WebkitX` to `-webkit-x`. @internal */
|
|
97
|
+
type KebabCase<S extends string> = S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${KebabCase<Tail>}` : `-${Lowercase<Head>}${KebabCase<Tail>}` : S;
|
|
98
|
+
/**
|
|
99
|
+
* The string-valued properties of the DOM's `CSSStyleDeclaration`. Written against that interface
|
|
100
|
+
* alone, so it resolves the same on every TypeScript that ships the DOM library, 5.4 through 7.x.
|
|
101
|
+
* (`CSSStyleProperties` and `CSSStyleDeclarationBase` exist only in some of those versions.)
|
|
102
|
+
* @internal
|
|
103
|
+
*/
|
|
104
|
+
type StyleStringKey = Extract<{ [K in keyof CSSStyleDeclaration]-?: CSSStyleDeclaration[K] extends string ? K : never; }[keyof CSSStyleDeclaration], string>;
|
|
105
|
+
/** The React spelling of a vendor property: `webkitTransition` is also `WebkitTransition`. @internal */
|
|
106
|
+
type VendorSpelling<K extends string> = K extends `webkit${infer Rest}` ? `Webkit${Capitalize<Rest>}` : never;
|
|
107
|
+
/** The standard CSS property names of the platform, in camelCase, plus React's `Webkit` spellings. @internal */
|
|
108
|
+
type CSSPropertyName = Exclude<StyleStringKey, "cssText"> | VendorSpelling<StyleStringKey>;
|
|
109
|
+
/**
|
|
110
|
+
* Inline style declarations for `style={...}`: every standard CSS property in camelCase or in
|
|
111
|
+
* kebab-case (derived from the DOM library's `CSSStyleProperties`, so it tracks the platform), plus
|
|
112
|
+
* CSS custom properties (`--name`). Values are strings or numbers; no per-property value unions.
|
|
113
|
+
*
|
|
114
|
+
* @example
|
|
115
|
+
* import type { CSSProperties } from "@shadow-js/web";
|
|
116
|
+
*
|
|
117
|
+
* const accent = "rebeccapurple";
|
|
118
|
+
* const style: CSSProperties = { backgroundColor: "red", "margin-top": 4, "--accent": accent };
|
|
119
|
+
* const box = <div style={style} />;
|
|
120
|
+
* @since 1.0.0
|
|
121
|
+
*/
|
|
122
|
+
export type CSSProperties = { [K in CSSPropertyName]?: CSSPropertyValue; } & { [K in CSSPropertyName as KebabCase<K>]?: CSSPropertyValue; } & {
|
|
123
|
+
/** A CSS custom property (`--accent`), written as is; a number is not given a unit. */
|
|
124
|
+
[name: `--${string}`]: CSSPropertyValue;
|
|
125
|
+
};
|
|
126
|
+
/**
|
|
127
|
+
* A ref: a variable that receives the element (`ref={el}` assigns it), a callback that runs once with
|
|
128
|
+
* the element, or a `{ current }` object that receives it (React's `useRef` shape; `current` is cleared
|
|
129
|
+
* when the element's owner is disposed).
|
|
130
|
+
*
|
|
131
|
+
* @example
|
|
132
|
+
* import type { Ref } from "@shadow-js/web";
|
|
133
|
+
*
|
|
134
|
+
* let input: HTMLInputElement | undefined;
|
|
135
|
+
* const plain = <input ref={input} />; // the compiler assigns the element to `input`
|
|
136
|
+
* const focused = <input ref={(el) => el.focus()} />;
|
|
137
|
+
* const box: Ref<HTMLDivElement> = { current: null };
|
|
138
|
+
* const panel = <div ref={box} />;
|
|
139
|
+
* @since 1.0.0
|
|
140
|
+
*/
|
|
141
|
+
export type Ref<T> = T | ((element: T) => void) | {
|
|
142
|
+
current: T | null | undefined;
|
|
143
|
+
} | undefined;
|
|
144
|
+
/**
|
|
145
|
+
* A value or an accessor returning it. Use it for function parameters that should accept a plain
|
|
146
|
+
* value or a signal-like getter; the accessor is read where it is needed.
|
|
147
|
+
*
|
|
148
|
+
* @example
|
|
149
|
+
* import type { MaybeAccessor } from "@shadow-js/web";
|
|
150
|
+
*
|
|
151
|
+
* function label(text: MaybeAccessor<string>): string {
|
|
152
|
+
* return typeof text === "function" ? text() : text;
|
|
153
|
+
* }
|
|
154
|
+
* @since 1.0.0
|
|
155
|
+
*/
|
|
156
|
+
export type MaybeAccessor<T> = T | (() => T);
|
|
157
|
+
/**
|
|
158
|
+
* The MathML element for a tag. Some TypeScript versions' DOM library omits a few MathML tags from
|
|
159
|
+
* `MathMLElementTagNameMap` (`a`, for one); those fall back to the generic `MathMLElement`.
|
|
160
|
+
*
|
|
161
|
+
* @typeParam K A MathML tag name.
|
|
162
|
+
* @internal
|
|
163
|
+
*/
|
|
164
|
+
export type MathMLTagElement<K extends string> = K extends keyof MathMLElementTagNameMap ? MathMLElementTagNameMap[K] : MathMLElement;
|
|
165
|
+
/**
|
|
166
|
+
* The element type a props object accepts in `ref`, e.g. `HTMLInputElement` for an `input`.
|
|
167
|
+
*
|
|
168
|
+
* @typeParam Props An element props type.
|
|
169
|
+
* @since 1.0.0
|
|
170
|
+
*/
|
|
171
|
+
export type RefOf<Props> = Props extends {
|
|
172
|
+
ref?: infer R;
|
|
173
|
+
} ? Extract<NonNullable<R>, Element> : never;
|
|
174
|
+
//#endregion
|
|
175
|
+
export {};
|
|
176
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { Booleanish, CSSProperties, ClassValue, JsxChild, Maybe, MaybeAccessor, Ref, TextChild } from "./jsx/types.js";
|
|
2
|
+
import { Component, FlowComponent, ParentComponent, ParentProps, VoidComponent, VoidProps } from "./jsx/component.js";
|
|
3
|
+
import { BoundEventHandler, EventHandler, EventHandlerProp, ListenerObject } from "./jsx/events.js";
|
|
4
|
+
import { AriaAttributes, AriaRole } from "./jsx/aria.js";
|
|
5
|
+
import { HTMLIntrinsicElements } from "./jsx/html.js";
|
|
6
|
+
import { MathMLIntrinsicElements } from "./jsx/mathml.js";
|
|
7
|
+
import { SVGIntrinsicElements } from "./jsx/svg.js";
|
|
8
|
+
import { CustomElementProps, IntrinsicElementMap } from "./jsx/intrinsic.js";
|
|
9
|
+
import { ComponentProps, CustomEvents, Directives, JSX, ValidComponent } from "./jsx-runtime.js";
|
|
10
|
+
export type { AriaAttributes, AriaRole, Booleanish, BoundEventHandler, CSSProperties, ClassValue, Component, ComponentProps, CustomElementProps, CustomEvents, Directives, EventHandler, EventHandlerProp, FlowComponent, HTMLIntrinsicElements, IntrinsicElementMap, JSX, JsxChild, ListenerObject, MathMLIntrinsicElements, Maybe, MaybeAccessor, ParentComponent, ParentProps, Ref, SVGIntrinsicElements, TextChild, ValidComponent, VoidComponent, VoidProps };
|
|
File without changes
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { Booleanish, CSSProperties, ClassValue, JsxChild, Maybe, MaybeAccessor, Ref, RefOf, TextChild } from "./jsx/types.js";
|
|
2
|
+
import { Component, FlowComponent, ParentComponent, ParentProps, VoidComponent, VoidProps } from "./jsx/component.js";
|
|
3
|
+
import { BoundEventHandler, CustomEventProps, EventHandler, EventHandlerProp, ListenerObject } from "./jsx/events.js";
|
|
4
|
+
import { AriaAttributes, AriaRole } from "./jsx/aria.js";
|
|
5
|
+
import { DirectiveProps } from "./jsx/global.js";
|
|
6
|
+
import { HTMLIntrinsicElements } from "./jsx/html.js";
|
|
7
|
+
import { MathMLIntrinsicElements } from "./jsx/mathml.js";
|
|
8
|
+
import { SVGIntrinsicElements } from "./jsx/svg.js";
|
|
9
|
+
import { CustomElementProps, IntrinsicElementMap } from "./jsx/intrinsic.js";
|
|
10
|
+
//#region src/jsx-runtime.d.ts
|
|
11
|
+
/**
|
|
12
|
+
* The app's custom events, by name, for the `on:` and `oncapture:` prefixes: declaration-merge it so
|
|
13
|
+
* `on:toast={...}` receives a typed event. Empty by default; a name without an entry is not accepted
|
|
14
|
+
* after `on:`.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* import type { JSX } from "@shadow-js/web/jsx-runtime";
|
|
18
|
+
*
|
|
19
|
+
* declare module "@shadow-js/web/jsx-runtime" {
|
|
20
|
+
* interface CustomEvents {
|
|
21
|
+
* toast: CustomEvent<{ message: string }>;
|
|
22
|
+
* }
|
|
23
|
+
* }
|
|
24
|
+
* const banner: JSX.Element = <div on:toast={(event) => console.log(event.detail.message)} />;
|
|
25
|
+
* @since 1.0.0
|
|
26
|
+
*/
|
|
27
|
+
export interface CustomEvents {}
|
|
28
|
+
/**
|
|
29
|
+
* The app's directives, by name, typed by their argument: declaration-merge it so
|
|
30
|
+
* `use:name={argument}` checks the argument. Empty by default; a name without an entry accepts any
|
|
31
|
+
* argument.
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* import type { JSX } from "@shadow-js/web/jsx-runtime";
|
|
35
|
+
*
|
|
36
|
+
* declare module "@shadow-js/web/jsx-runtime" {
|
|
37
|
+
* interface Directives {
|
|
38
|
+
* tooltip: string;
|
|
39
|
+
* }
|
|
40
|
+
* }
|
|
41
|
+
* const save: JSX.Element = <button use:tooltip={"Save the draft"}>Save</button>;
|
|
42
|
+
* @since 1.0.0
|
|
43
|
+
*/
|
|
44
|
+
export interface Directives {}
|
|
45
|
+
/** What every intrinsic element gains from the app: its custom events and directives. @internal */
|
|
46
|
+
type AppProps<P> = CustomEventProps<RefOf<P>, CustomEvents> & DirectiveProps<Directives>;
|
|
47
|
+
/**
|
|
48
|
+
* The JSX namespace TypeScript reads through `jsxImportSource`. It is exported from this module only,
|
|
49
|
+
* so it never leaks into the global scope.
|
|
50
|
+
*
|
|
51
|
+
* @since 1.0.0
|
|
52
|
+
*/
|
|
53
|
+
export declare namespace JSX {
|
|
54
|
+
type Element = JsxChild;
|
|
55
|
+
interface ElementChildrenAttribute {
|
|
56
|
+
children: unknown;
|
|
57
|
+
}
|
|
58
|
+
interface IntrinsicAttributes {
|
|
59
|
+
/**
|
|
60
|
+
* React's list identity; a component reads it as `props.key`.
|
|
61
|
+
* @default undefined (the component receives no `key` prop)
|
|
62
|
+
*/
|
|
63
|
+
key?: unknown;
|
|
64
|
+
}
|
|
65
|
+
type ElementClass = never;
|
|
66
|
+
type ElementType = keyof IntrinsicElements | ((props: never) => unknown);
|
|
67
|
+
type IntrinsicElements = { [K in keyof IntrinsicElementMap]: IntrinsicElementMap[K] & AppProps<IntrinsicElementMap[K]>; };
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Anything that can be used as a JSX tag: an intrinsic element name or a component function. Use it
|
|
71
|
+
* to type a prop that takes either.
|
|
72
|
+
*
|
|
73
|
+
* @since 1.0.0
|
|
74
|
+
*/
|
|
75
|
+
export type ValidComponent = keyof JSX.IntrinsicElements | Component<never>;
|
|
76
|
+
/**
|
|
77
|
+
* The props type of a component, or of an intrinsic element tag name: use it to wrap or forward the
|
|
78
|
+
* props of an element or another component.
|
|
79
|
+
*
|
|
80
|
+
* @typeParam T A tag name (`"div"`) or a component type.
|
|
81
|
+
* @example
|
|
82
|
+
* import type { ComponentProps, JSX } from "@shadow-js/web";
|
|
83
|
+
*
|
|
84
|
+
* function Card(props: { title: string }): JSX.Element {
|
|
85
|
+
* return <h2>{props.title}</h2>;
|
|
86
|
+
* }
|
|
87
|
+
* type InputProps = ComponentProps<"input">; // the attributes of <input>
|
|
88
|
+
* type CardProps = ComponentProps<typeof Card>; // { title: string }
|
|
89
|
+
* @since 1.0.0
|
|
90
|
+
*/
|
|
91
|
+
export type ComponentProps<T extends ValidComponent> = T extends keyof JSX.IntrinsicElements ? JSX.IntrinsicElements[T] : T extends ((props: infer P) => unknown) ? P : never;
|
|
92
|
+
//#endregion
|
|
93
|
+
export type { AriaAttributes, AriaRole, Booleanish, BoundEventHandler, CSSProperties, ClassValue, Component, CustomElementProps, EventHandler, EventHandlerProp, FlowComponent, HTMLIntrinsicElements, IntrinsicElementMap, JsxChild, ListenerObject, MathMLIntrinsicElements, Maybe, MaybeAccessor, ParentComponent, ParentProps, Ref, SVGIntrinsicElements, TextChild, VoidComponent, VoidProps };
|
|
94
|
+
//# sourceMappingURL=jsx-runtime.d.ts.map
|
|
File without changes
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { Cleanup } from "@shadow-js/core";
|
|
2
|
+
//#region src/reactive.d.ts
|
|
3
|
+
/**
|
|
4
|
+
* Runs `fn` as a render effect: synchronously when created, and again when the signals it reads
|
|
5
|
+
* change. It is the effect the compiler emits for DOM bindings; application code usually prefers
|
|
6
|
+
* `useEffect`. A function returned by `fn` is its cleanup, run before the next run and when the
|
|
7
|
+
* owner disposes. It never runs on the server, and in development an effect created outside an
|
|
8
|
+
* owner warns `NO_OWNER_EFFECT`.
|
|
9
|
+
*
|
|
10
|
+
* @param fn Tracked body. Returns an optional cleanup function.
|
|
11
|
+
* @example
|
|
12
|
+
* import { createRoot, useSignal } from "@shadow-js/core";
|
|
13
|
+
* import { effect } from "@shadow-js/web";
|
|
14
|
+
*
|
|
15
|
+
* const label = document.createElement("span");
|
|
16
|
+
* createRoot(() => {
|
|
17
|
+
* const [name] = useSignal("Ada");
|
|
18
|
+
* effect(() => {
|
|
19
|
+
* label.textContent = name(); // runs now, and again when name changes
|
|
20
|
+
* });
|
|
21
|
+
* });
|
|
22
|
+
* @see memo
|
|
23
|
+
* @since 1.0.0
|
|
24
|
+
*/
|
|
25
|
+
export declare function effect(fn: () => void | Cleanup): void;
|
|
26
|
+
/**
|
|
27
|
+
* Two-form render effect: `compute` is tracked and `apply` runs untracked with the new and the
|
|
28
|
+
* previous value. A function returned by `apply` is its cleanup. Use it to keep the tracked reads
|
|
29
|
+
* apart from the code that writes the DOM.
|
|
30
|
+
*
|
|
31
|
+
* @param compute Tracked. Its result is passed to `apply`.
|
|
32
|
+
* @param apply Untracked. Receives the value and the previous value (`undefined` on the first run)
|
|
33
|
+
* and returns an optional cleanup function.
|
|
34
|
+
* @example
|
|
35
|
+
* import { createRoot, useSignal } from "@shadow-js/core";
|
|
36
|
+
* import { effect } from "@shadow-js/web";
|
|
37
|
+
*
|
|
38
|
+
* const title = document.createElement("h1");
|
|
39
|
+
* createRoot(() => {
|
|
40
|
+
* const [text] = useSignal("Hello");
|
|
41
|
+
* effect(text, (value, previous) => {
|
|
42
|
+
* title.textContent = value;
|
|
43
|
+
* console.log(previous); // undefined on the first run
|
|
44
|
+
* });
|
|
45
|
+
* });
|
|
46
|
+
* @see memo
|
|
47
|
+
* @since 1.0.0
|
|
48
|
+
*/
|
|
49
|
+
export declare function effect<T>(compute: () => T, apply: (value: T, previous: T | undefined) => void | Cleanup): void;
|
|
50
|
+
/**
|
|
51
|
+
* Creates a cached derivation that recomputes only when the signals it reads change. It is core's
|
|
52
|
+
* `useMemo` under the short name the compiler emits.
|
|
53
|
+
*
|
|
54
|
+
* @param fn The computation. Tracked; its result is cached until a dependency changes.
|
|
55
|
+
* @returns An accessor for the current value.
|
|
56
|
+
* @example
|
|
57
|
+
* import { useSignal } from "@shadow-js/core";
|
|
58
|
+
* import { memo } from "@shadow-js/web";
|
|
59
|
+
*
|
|
60
|
+
* function setup() {
|
|
61
|
+
* const [count, setCount] = useSignal(2);
|
|
62
|
+
* const doubled = memo(() => count() * 2);
|
|
63
|
+
* setCount(4);
|
|
64
|
+
* console.log(doubled()); // 8
|
|
65
|
+
* }
|
|
66
|
+
* @see effect
|
|
67
|
+
* @since 1.0.0
|
|
68
|
+
*/
|
|
69
|
+
export declare function memo<T>(fn: () => T): () => T;
|
|
70
|
+
/**
|
|
71
|
+
* Applies a directive: calls `fn(el, arg)` untracked, so a directive or a ref never subscribes the
|
|
72
|
+
* surrounding effect to what it reads. A function returned by `fn` is a cleanup, run when the owner
|
|
73
|
+
* disposes.
|
|
74
|
+
*
|
|
75
|
+
* @param fn The directive. Receives the element and the accessor of its argument.
|
|
76
|
+
* @param el The element the directive applies to.
|
|
77
|
+
* @param arg Accessor for the directive's argument. Undefined passes `undefined` through; the
|
|
78
|
+
* directive reads the accessor where it wants to track it.
|
|
79
|
+
* @example
|
|
80
|
+
* import { use } from "@shadow-js/web";
|
|
81
|
+
*
|
|
82
|
+
* function tooltip(el: Element, text: () => string) {
|
|
83
|
+
* el.setAttribute("title", text());
|
|
84
|
+
* }
|
|
85
|
+
* const button = document.createElement("button");
|
|
86
|
+
* use(tooltip, button, () => "Save the draft");
|
|
87
|
+
* @see refTo
|
|
88
|
+
* @since 1.0.0
|
|
89
|
+
*/
|
|
90
|
+
export declare function use<T>(fn: (el: Element, arg: () => T) => unknown, el: Element, arg?: () => T): void;
|
|
91
|
+
/**
|
|
92
|
+
* Fills a ref of any form the compiler accepts. A callback is called with the element (its returned
|
|
93
|
+
* cleanup runs when the owner disposes). A `{ current }` object gets the element as `current`, and
|
|
94
|
+
* `null` once the owner is disposed, as React's `useRef` objects do. Any other value is ignored.
|
|
95
|
+
*
|
|
96
|
+
* @param target The ref value: a callback, a `{ current }` object, or anything else (ignored).
|
|
97
|
+
* @param el The element the ref receives.
|
|
98
|
+
* @example
|
|
99
|
+
* import { refTo } from "@shadow-js/web";
|
|
100
|
+
*
|
|
101
|
+
* const box = { current: null as HTMLDivElement | null };
|
|
102
|
+
* const div = document.createElement("div");
|
|
103
|
+
* refTo(box, div);
|
|
104
|
+
* console.log(box.current === div); // true
|
|
105
|
+
* @see use
|
|
106
|
+
* @since 1.0.0
|
|
107
|
+
*/
|
|
108
|
+
export declare function refTo(target: unknown, el: Element): void;
|
|
109
|
+
//#endregion
|
|
110
|
+
//# sourceMappingURL=reactive.d.ts.map
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { getOwner, onCleanup, untrack, useMemo, useRenderEffect } from "@shadow-js/core";
|
|
2
|
+
//#region src/reactive.ts
|
|
3
|
+
function effect(compute, apply) {
|
|
4
|
+
if (apply === void 0) useRenderEffect(compute);
|
|
5
|
+
else useRenderEffect(compute, apply);
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Creates a cached derivation that recomputes only when the signals it reads change. It is core's
|
|
9
|
+
* `useMemo` under the short name the compiler emits.
|
|
10
|
+
*
|
|
11
|
+
* @param fn The computation. Tracked; its result is cached until a dependency changes.
|
|
12
|
+
* @returns An accessor for the current value.
|
|
13
|
+
* @example
|
|
14
|
+
* import { useSignal } from "@shadow-js/core";
|
|
15
|
+
* import { memo } from "@shadow-js/web";
|
|
16
|
+
*
|
|
17
|
+
* function setup() {
|
|
18
|
+
* const [count, setCount] = useSignal(2);
|
|
19
|
+
* const doubled = memo(() => count() * 2);
|
|
20
|
+
* setCount(4);
|
|
21
|
+
* console.log(doubled()); // 8
|
|
22
|
+
* }
|
|
23
|
+
* @see effect
|
|
24
|
+
* @since 1.0.0
|
|
25
|
+
*/
|
|
26
|
+
function memo(fn) {
|
|
27
|
+
return useMemo(fn);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Applies a directive: calls `fn(el, arg)` untracked, so a directive or a ref never subscribes the
|
|
31
|
+
* surrounding effect to what it reads. A function returned by `fn` is a cleanup, run when the owner
|
|
32
|
+
* disposes.
|
|
33
|
+
*
|
|
34
|
+
* @param fn The directive. Receives the element and the accessor of its argument.
|
|
35
|
+
* @param el The element the directive applies to.
|
|
36
|
+
* @param arg Accessor for the directive's argument. Undefined passes `undefined` through; the
|
|
37
|
+
* directive reads the accessor where it wants to track it.
|
|
38
|
+
* @example
|
|
39
|
+
* import { use } from "@shadow-js/web";
|
|
40
|
+
*
|
|
41
|
+
* function tooltip(el: Element, text: () => string) {
|
|
42
|
+
* el.setAttribute("title", text());
|
|
43
|
+
* }
|
|
44
|
+
* const button = document.createElement("button");
|
|
45
|
+
* use(tooltip, button, () => "Save the draft");
|
|
46
|
+
* @see refTo
|
|
47
|
+
* @since 1.0.0
|
|
48
|
+
*/
|
|
49
|
+
function use(fn, el, arg) {
|
|
50
|
+
const cleanup = untrack(() => fn(el, arg));
|
|
51
|
+
if (typeof cleanup === "function") onCleanup(cleanup);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Fills a ref of any form the compiler accepts. A callback is called with the element (its returned
|
|
55
|
+
* cleanup runs when the owner disposes). A `{ current }` object gets the element as `current`, and
|
|
56
|
+
* `null` once the owner is disposed, as React's `useRef` objects do. Any other value is ignored.
|
|
57
|
+
*
|
|
58
|
+
* @param target The ref value: a callback, a `{ current }` object, or anything else (ignored).
|
|
59
|
+
* @param el The element the ref receives.
|
|
60
|
+
* @example
|
|
61
|
+
* import { refTo } from "@shadow-js/web";
|
|
62
|
+
*
|
|
63
|
+
* const box = { current: null as HTMLDivElement | null };
|
|
64
|
+
* const div = document.createElement("div");
|
|
65
|
+
* refTo(box, div);
|
|
66
|
+
* console.log(box.current === div); // true
|
|
67
|
+
* @see use
|
|
68
|
+
* @since 1.0.0
|
|
69
|
+
*/
|
|
70
|
+
function refTo(target, el) {
|
|
71
|
+
if (typeof target === "function") {
|
|
72
|
+
use(target, el);
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
if (target === null || typeof target !== "object" || !("current" in target)) return;
|
|
76
|
+
const holder = target;
|
|
77
|
+
holder.current = el;
|
|
78
|
+
if (getOwner() !== null) onCleanup(() => {
|
|
79
|
+
holder.current = null;
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
//#endregion
|
|
83
|
+
export { effect, memo, refTo, use };
|
|
84
|
+
|
|
85
|
+
//# sourceMappingURL=reactive.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reactive.js","names":[],"sources":["../../src/reactive.ts"],"sourcesContent":["import {\n type Cleanup,\n getOwner,\n onCleanup,\n untrack,\n useMemo,\n useRenderEffect,\n} from \"@shadow-js/core\";\n\n/**\n * Runs `fn` as a render effect: synchronously when created, and again when the signals it reads\n * change. It is the effect the compiler emits for DOM bindings; application code usually prefers\n * `useEffect`. A function returned by `fn` is its cleanup, run before the next run and when the\n * owner disposes. It never runs on the server, and in development an effect created outside an\n * owner warns `NO_OWNER_EFFECT`.\n *\n * @param fn Tracked body. Returns an optional cleanup function.\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { effect } from \"@shadow-js/web\";\n *\n * const label = document.createElement(\"span\");\n * createRoot(() => {\n * const [name] = useSignal(\"Ada\");\n * effect(() => {\n * label.textContent = name(); // runs now, and again when name changes\n * });\n * });\n * @see memo\n * @since 1.0.0\n */\nexport function effect(fn: () => void | Cleanup): void;\n/**\n * Two-form render effect: `compute` is tracked and `apply` runs untracked with the new and the\n * previous value. A function returned by `apply` is its cleanup. Use it to keep the tracked reads\n * apart from the code that writes the DOM.\n *\n * @param compute Tracked. Its result is passed to `apply`.\n * @param apply Untracked. Receives the value and the previous value (`undefined` on the first run)\n * and returns an optional cleanup function.\n * @example\n * import { createRoot, useSignal } from \"@shadow-js/core\";\n * import { effect } from \"@shadow-js/web\";\n *\n * const title = document.createElement(\"h1\");\n * createRoot(() => {\n * const [text] = useSignal(\"Hello\");\n * effect(text, (value, previous) => {\n * title.textContent = value;\n * console.log(previous); // undefined on the first run\n * });\n * });\n * @see memo\n * @since 1.0.0\n */\nexport function effect<T>(\n compute: () => T,\n apply: (value: T, previous: T | undefined) => void | Cleanup,\n): void;\nexport function effect<T>(\n compute: () => T,\n apply?: (value: T, previous: T | undefined) => void | Cleanup,\n): void {\n if (apply === undefined) useRenderEffect(compute);\n else useRenderEffect(compute, apply);\n}\n\n/**\n * Creates a cached derivation that recomputes only when the signals it reads change. It is core's\n * `useMemo` under the short name the compiler emits.\n *\n * @param fn The computation. Tracked; its result is cached until a dependency changes.\n * @returns An accessor for the current value.\n * @example\n * import { useSignal } from \"@shadow-js/core\";\n * import { memo } from \"@shadow-js/web\";\n *\n * function setup() {\n * const [count, setCount] = useSignal(2);\n * const doubled = memo(() => count() * 2);\n * setCount(4);\n * console.log(doubled()); // 8\n * }\n * @see effect\n * @since 1.0.0\n */\nexport function memo<T>(fn: () => T): () => T {\n return useMemo<T>(fn);\n}\n\n/**\n * Applies a directive: calls `fn(el, arg)` untracked, so a directive or a ref never subscribes the\n * surrounding effect to what it reads. A function returned by `fn` is a cleanup, run when the owner\n * disposes.\n *\n * @param fn The directive. Receives the element and the accessor of its argument.\n * @param el The element the directive applies to.\n * @param arg Accessor for the directive's argument. Undefined passes `undefined` through; the\n * directive reads the accessor where it wants to track it.\n * @example\n * import { use } from \"@shadow-js/web\";\n *\n * function tooltip(el: Element, text: () => string) {\n * el.setAttribute(\"title\", text());\n * }\n * const button = document.createElement(\"button\");\n * use(tooltip, button, () => \"Save the draft\");\n * @see refTo\n * @since 1.0.0\n */\nexport function use<T>(\n fn: (el: Element, arg: () => T) => unknown,\n el: Element,\n arg?: () => T,\n): void {\n const cleanup = untrack(() => fn(el, arg as () => T));\n // A ref callback may return a cleanup (React 19): it runs when the owner of the element is disposed.\n if (typeof cleanup === \"function\") onCleanup(cleanup as Cleanup);\n}\n\n/**\n * Fills a ref of any form the compiler accepts. A callback is called with the element (its returned\n * cleanup runs when the owner disposes). A `{ current }` object gets the element as `current`, and\n * `null` once the owner is disposed, as React's `useRef` objects do. Any other value is ignored.\n *\n * @param target The ref value: a callback, a `{ current }` object, or anything else (ignored).\n * @param el The element the ref receives.\n * @example\n * import { refTo } from \"@shadow-js/web\";\n *\n * const box = { current: null as HTMLDivElement | null };\n * const div = document.createElement(\"div\");\n * refTo(box, div);\n * console.log(box.current === div); // true\n * @see use\n * @since 1.0.0\n */\nexport function refTo(target: unknown, el: Element): void {\n if (typeof target === \"function\") {\n use(target as (node: Element, arg: () => unknown) => unknown, el);\n return;\n }\n if (target === null || typeof target !== \"object\" || !(\"current\" in target)) return;\n const holder = target as { current: unknown };\n holder.current = el;\n if (getOwner() !== null) {\n onCleanup(() => {\n holder.current = null;\n });\n }\n}\n"],"mappings":";;AA2DA,SAAgB,OACd,SACA,OACM;CACN,IAAI,UAAU,KAAA,GAAW,gBAAgB,OAAO;MAC3C,gBAAgB,SAAS,KAAK;AACrC;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,KAAQ,IAAsB;CAC5C,OAAO,QAAW,EAAE;AACtB;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,IACd,IACA,IACA,KACM;CACN,MAAM,UAAU,cAAc,GAAG,IAAI,GAAc,CAAC;CAEpD,IAAI,OAAO,YAAY,YAAY,UAAU,OAAkB;AACjE;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,MAAM,QAAiB,IAAmB;CACxD,IAAI,OAAO,WAAW,YAAY;EAChC,IAAI,QAA0D,EAAE;EAChE;CACF;CACA,IAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,EAAE,aAAa,SAAS;CAC7E,MAAM,SAAS;CACf,OAAO,UAAU;CACjB,IAAI,SAAS,MAAM,MACjB,gBAAgB;EACd,OAAO,UAAU;CACnB,CAAC;AAEL"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { RootErrorOptions } from "./control-flow/root-errors.js";
|
|
2
|
+
//#region src/render.d.ts
|
|
3
|
+
/**
|
|
4
|
+
* Options of {@link render}: the error reporters of the root.
|
|
5
|
+
* @since 1.0.0
|
|
6
|
+
*/
|
|
7
|
+
export type RenderOptions = RootErrorOptions;
|
|
8
|
+
/**
|
|
9
|
+
* Mounts `code` into `container`. Creates an owner, inserts the output, flushes the effects, and
|
|
10
|
+
* returns a dispose function that stops the owner and removes the nodes this call inserted. A
|
|
11
|
+
* second render into the same container appends after the first.
|
|
12
|
+
*
|
|
13
|
+
* @param code Runs once, untracked, to build the tree (a component call, a node, text or an array).
|
|
14
|
+
* Return an accessor (for example `() => count`) from it to make the root content reactive.
|
|
15
|
+
* @param container Element, Document or DocumentFragment that receives the output.
|
|
16
|
+
* @param options The root's error reporters (`onUncaughtError`, `onCaughtError`). Undefined sets
|
|
17
|
+
* no reporter.
|
|
18
|
+
* @returns A dispose function, safe to call more than once.
|
|
19
|
+
* @example
|
|
20
|
+
* import { createComponent, render } from "@shadow-js/web";
|
|
21
|
+
*
|
|
22
|
+
* function App() {
|
|
23
|
+
* return "Hello";
|
|
24
|
+
* }
|
|
25
|
+
*
|
|
26
|
+
* const dispose = render(
|
|
27
|
+
* () => createComponent(App, {}),
|
|
28
|
+
* document.getElementById("root") as Element,
|
|
29
|
+
* );
|
|
30
|
+
* dispose(); // stops the root and removes the text it inserted
|
|
31
|
+
* @see hydrate
|
|
32
|
+
* @since 1.0.0
|
|
33
|
+
*/
|
|
34
|
+
export declare function render(code: () => unknown, container: Element | Document | DocumentFragment, options?: RenderOptions): () => void;
|
|
35
|
+
//#endregion
|
|
36
|
+
//# sourceMappingURL=render.d.ts.map
|
|
@@ -0,0 +1,52 @@
|
|
|
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
|
+
//#region 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
|
+
//#endregion
|
|
50
|
+
export { render };
|
|
51
|
+
|
|
52
|
+
//# 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"}
|