solid-js 1.1.7 → 1.2.2

package/dist/dev.cjs

@@ -455,6 +455,11 @@ function enableScheduling(scheduler = requestCallback) {
   Scheduler = scheduler;
 }
 function startTransition(fn, cb) {
+  if (Transition && Transition.running) {
+    fn();
+    cb && Transition.cb.push(cb);
+    return;
+  }
   queueMicrotask(() => {
     if (Scheduler || SuspenseContext) {
       Transition || (Transition = {
@@ -548,10 +553,11 @@ function getSuspenseContext() {
   return SuspenseContext || (SuspenseContext = createContext({}));
 }
 function readSignal() {
-  if (this.state && this.sources) {
+  const runningTransition = Transition && Transition.running;
+  if (this.sources && (!runningTransition && this.state || runningTransition && this.tState)) {
     const updates = Updates;
     Updates = null;
-    this.state === STALE || Transition && Transition.running && this.tState ? updateComputation(this) : lookDownstream(this);
+    !runningTransition && this.state === STALE || runningTransition && this.tState === STALE ? updateComputation(this) : lookDownstream(this);
     Updates = updates;
   }
   if (Listener) {
@@ -571,7 +577,7 @@ function readSignal() {
       this.observerSlots.push(Listener.sources.length - 1);
     }
   }
-  if (Transition && Transition.running && Transition.sources.has(this)) return this.tValue;
+  if (runningTransition && Transition.sources.has(this)) return this.tValue;
   return this.value;
 }
 function writeSignal(node, value, isComp) {
@@ -619,7 +625,7 @@ function updateComputation(node) {
         listener = Listener,
         time = ExecCount;
   Listener = Owner = node;
-  runComputation(node, node.value, time);
+  runComputation(node, Transition && Transition.running && Transition.sources.has(node) ? node.tValue : node.value, time);
   if (Transition && !Transition.running && Transition.sources.has(node)) {
     queueMicrotask(() => {
       runUpdates(() => {
@@ -684,7 +690,7 @@ function runTop(node) {
   const ancestors = [node];
   while ((node = node.owner) && (!node.updatedAt || node.updatedAt < ExecCount)) {
     if (runningTransition && Transition.disposed.has(node)) return;
-    if (node.state || runningTransition && node.tState) ancestors.push(node);
+    if (!runningTransition && node.state || runningTransition && node.tState) ancestors.push(node);
   }
   for (let i = ancestors.length - 1; i >= 0; i--) {
     node = ancestors[i];
@@ -695,9 +701,9 @@ function runTop(node) {
         if (Transition.disposed.has(top)) return;
       }
     }
-    if (node.state === STALE || runningTransition && node.tState === STALE) {
+    if (!runningTransition && node.state === STALE || runningTransition && node.tState === STALE) {
       updateComputation(node);
-    } else if (node.state === PENDING || runningTransition && node.tState === PENDING) {
+    } else if (!runningTransition && node.state === PENDING || runningTransition && node.tState === PENDING) {
       const updates = Updates;
       Updates = null;
       lookDownstream(node);
@@ -801,10 +807,11 @@ function runUserEffects(queue) {
 }
 function lookDownstream(node) {
   node.state = 0;
+  const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.sources.length; i += 1) {
     const source = node.sources[i];
     if (source.sources) {
-      if (source.state === STALE || Transition && Transition.running && source.tState) runTop(source);else if (source.state === PENDING) lookDownstream(source);
+      if (!runningTransition && source.state === STALE || runningTransition && source.tState === STALE) runTop(source);else if (!runningTransition && source.state === PENDING || runningTransition && source.tState === PENDING) lookDownstream(source);
     }
   }
 }
@@ -812,7 +819,7 @@ function markUpstream(node) {
   const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.observers.length; i += 1) {
     const o = node.observers[i];
-    if (!o.state || runningTransition && !o.tState) {
+    if (!runningTransition && !o.state || runningTransition && !o.tState) {
       if (runningTransition) o.tState = PENDING;else o.state = PENDING;
       if (o.pure) Updates.push(o);else Effects.push(o);
       o.observers && markUpstream(o);
@@ -1166,23 +1173,26 @@ const propTraps = {
     return _.keys();
   }
 };
+function resolveSource(s) {
+  return typeof s === "function" ? s() : s;
+}
 function mergeProps(...sources) {
   return new Proxy({
     get(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        const v = sources[i][property];
+        const v = resolveSource(sources[i])[property];
         if (v !== undefined) return v;
       }
     },
     has(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        if (property in sources[i]) return true;
+        if (property in resolveSource(sources[i])) return true;
       }
       return false;
     },
     keys() {
       const keys = [];
-      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(sources[i]));
+      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(resolveSource(sources[i])));
       return [...new Set(keys)];
     }
   }, propTraps);

package/dist/dev.js

@@ -451,6 +451,11 @@ function enableScheduling(scheduler = requestCallback) {
   Scheduler = scheduler;
 }
 function startTransition(fn, cb) {
+  if (Transition && Transition.running) {
+    fn();
+    cb && Transition.cb.push(cb);
+    return;
+  }
   queueMicrotask(() => {
     if (Scheduler || SuspenseContext) {
       Transition || (Transition = {
@@ -544,10 +549,11 @@ function getSuspenseContext() {
   return SuspenseContext || (SuspenseContext = createContext({}));
 }
 function readSignal() {
-  if (this.state && this.sources) {
+  const runningTransition = Transition && Transition.running;
+  if (this.sources && (!runningTransition && this.state || runningTransition && this.tState)) {
     const updates = Updates;
     Updates = null;
-    this.state === STALE || Transition && Transition.running && this.tState ? updateComputation(this) : lookDownstream(this);
+    !runningTransition && this.state === STALE || runningTransition && this.tState === STALE ? updateComputation(this) : lookDownstream(this);
     Updates = updates;
   }
   if (Listener) {
@@ -567,7 +573,7 @@ function readSignal() {
       this.observerSlots.push(Listener.sources.length - 1);
     }
   }
-  if (Transition && Transition.running && Transition.sources.has(this)) return this.tValue;
+  if (runningTransition && Transition.sources.has(this)) return this.tValue;
   return this.value;
 }
 function writeSignal(node, value, isComp) {
@@ -615,7 +621,7 @@ function updateComputation(node) {
         listener = Listener,
         time = ExecCount;
   Listener = Owner = node;
-  runComputation(node, node.value, time);
+  runComputation(node, Transition && Transition.running && Transition.sources.has(node) ? node.tValue : node.value, time);
   if (Transition && !Transition.running && Transition.sources.has(node)) {
     queueMicrotask(() => {
       runUpdates(() => {
@@ -680,7 +686,7 @@ function runTop(node) {
   const ancestors = [node];
   while ((node = node.owner) && (!node.updatedAt || node.updatedAt < ExecCount)) {
     if (runningTransition && Transition.disposed.has(node)) return;
-    if (node.state || runningTransition && node.tState) ancestors.push(node);
+    if (!runningTransition && node.state || runningTransition && node.tState) ancestors.push(node);
   }
   for (let i = ancestors.length - 1; i >= 0; i--) {
     node = ancestors[i];
@@ -691,9 +697,9 @@ function runTop(node) {
         if (Transition.disposed.has(top)) return;
       }
     }
-    if (node.state === STALE || runningTransition && node.tState === STALE) {
+    if (!runningTransition && node.state === STALE || runningTransition && node.tState === STALE) {
       updateComputation(node);
-    } else if (node.state === PENDING || runningTransition && node.tState === PENDING) {
+    } else if (!runningTransition && node.state === PENDING || runningTransition && node.tState === PENDING) {
       const updates = Updates;
       Updates = null;
       lookDownstream(node);
@@ -797,10 +803,11 @@ function runUserEffects(queue) {
 }
 function lookDownstream(node) {
   node.state = 0;
+  const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.sources.length; i += 1) {
     const source = node.sources[i];
     if (source.sources) {
-      if (source.state === STALE || Transition && Transition.running && source.tState) runTop(source);else if (source.state === PENDING) lookDownstream(source);
+      if (!runningTransition && source.state === STALE || runningTransition && source.tState === STALE) runTop(source);else if (!runningTransition && source.state === PENDING || runningTransition && source.tState === PENDING) lookDownstream(source);
     }
   }
 }
@@ -808,7 +815,7 @@ function markUpstream(node) {
   const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.observers.length; i += 1) {
     const o = node.observers[i];
-    if (!o.state || runningTransition && !o.tState) {
+    if (!runningTransition && !o.state || runningTransition && !o.tState) {
       if (runningTransition) o.tState = PENDING;else o.state = PENDING;
       if (o.pure) Updates.push(o);else Effects.push(o);
       o.observers && markUpstream(o);
@@ -1162,23 +1169,26 @@ const propTraps = {
     return _.keys();
   }
 };
+function resolveSource(s) {
+  return typeof s === "function" ? s() : s;
+}
 function mergeProps(...sources) {
   return new Proxy({
     get(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        const v = sources[i][property];
+        const v = resolveSource(sources[i])[property];
         if (v !== undefined) return v;
       }
     },
     has(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        if (property in sources[i]) return true;
+        if (property in resolveSource(sources[i])) return true;
       }
       return false;
     },
     keys() {
       const keys = [];
-      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(sources[i]));
+      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(resolveSource(sources[i])));
       return [...new Set(keys)];
     }
   }, propTraps);

package/dist/server.cjs

@@ -510,6 +510,7 @@ exports.SuspenseList = SuspenseList;
 exports.Switch = Switch;
 exports.awaitSuspense = awaitSuspense;
 exports.batch = batch;
+exports.children = children;
 exports.createComponent = createComponent;
 exports.createComputed = createComputed;
 exports.createContext = createContext;

package/dist/server.js

@@ -494,4 +494,4 @@ function awaitSuspense(fn) {
   });
 }
 
-export { $PROXY, DEV, ErrorBoundary, For, Index, Match, Show, Suspense, SuspenseList, Switch, awaitSuspense, batch, createComponent, createComputed, createContext, createDeferred, createEffect, createMemo, createRenderEffect, createResource, createRoot, createSelector, createSignal, createUniqueId, enableScheduling, equalFn, from, getListener, getOwner, lazy, mapArray, mergeProps, observable, on, onCleanup, onError, onMount, requestCallback, runWithOwner, sharedConfig, splitProps, startTransition, untrack, useContext, useTransition };
+export { $PROXY, DEV, ErrorBoundary, For, Index, Match, Show, Suspense, SuspenseList, Switch, awaitSuspense, batch, children, createComponent, createComputed, createContext, createDeferred, createEffect, createMemo, createRenderEffect, createResource, createRoot, createSelector, createSignal, createUniqueId, enableScheduling, equalFn, from, getListener, getOwner, lazy, mapArray, mergeProps, observable, on, onCleanup, onError, onMount, requestCallback, runWithOwner, sharedConfig, splitProps, startTransition, untrack, useContext, useTransition };

package/dist/solid.cjs

@@ -452,6 +452,11 @@ function enableScheduling(scheduler = requestCallback) {
   Scheduler = scheduler;
 }
 function startTransition(fn, cb) {
+  if (Transition && Transition.running) {
+    fn();
+    cb && Transition.cb.push(cb);
+    return;
+  }
   queueMicrotask(() => {
     if (Scheduler || SuspenseContext) {
       Transition || (Transition = {
@@ -497,10 +502,11 @@ function getSuspenseContext() {
   return SuspenseContext || (SuspenseContext = createContext({}));
 }
 function readSignal() {
-  if (this.state && this.sources) {
+  const runningTransition = Transition && Transition.running;
+  if (this.sources && (!runningTransition && this.state || runningTransition && this.tState)) {
     const updates = Updates;
     Updates = null;
-    this.state === STALE || Transition && Transition.running && this.tState ? updateComputation(this) : lookDownstream(this);
+    !runningTransition && this.state === STALE || runningTransition && this.tState === STALE ? updateComputation(this) : lookDownstream(this);
     Updates = updates;
   }
   if (Listener) {
@@ -520,7 +526,7 @@ function readSignal() {
       this.observerSlots.push(Listener.sources.length - 1);
     }
   }
-  if (Transition && Transition.running && Transition.sources.has(this)) return this.tValue;
+  if (runningTransition && Transition.sources.has(this)) return this.tValue;
   return this.value;
 }
 function writeSignal(node, value, isComp) {
@@ -568,7 +574,7 @@ function updateComputation(node) {
         listener = Listener,
         time = ExecCount;
   Listener = Owner = node;
-  runComputation(node, node.value, time);
+  runComputation(node, Transition && Transition.running && Transition.sources.has(node) ? node.tValue : node.value, time);
   if (Transition && !Transition.running && Transition.sources.has(node)) {
     queueMicrotask(() => {
       runUpdates(() => {
@@ -632,7 +638,7 @@ function runTop(node) {
   const ancestors = [node];
   while ((node = node.owner) && (!node.updatedAt || node.updatedAt < ExecCount)) {
     if (runningTransition && Transition.disposed.has(node)) return;
-    if (node.state || runningTransition && node.tState) ancestors.push(node);
+    if (!runningTransition && node.state || runningTransition && node.tState) ancestors.push(node);
   }
   for (let i = ancestors.length - 1; i >= 0; i--) {
     node = ancestors[i];
@@ -643,9 +649,9 @@ function runTop(node) {
         if (Transition.disposed.has(top)) return;
       }
     }
-    if (node.state === STALE || runningTransition && node.tState === STALE) {
+    if (!runningTransition && node.state === STALE || runningTransition && node.tState === STALE) {
       updateComputation(node);
-    } else if (node.state === PENDING || runningTransition && node.tState === PENDING) {
+    } else if (!runningTransition && node.state === PENDING || runningTransition && node.tState === PENDING) {
       const updates = Updates;
       Updates = null;
       lookDownstream(node);
@@ -748,10 +754,11 @@ function runUserEffects(queue) {
 }
 function lookDownstream(node) {
   node.state = 0;
+  const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.sources.length; i += 1) {
     const source = node.sources[i];
     if (source.sources) {
-      if (source.state === STALE || Transition && Transition.running && source.tState) runTop(source);else if (source.state === PENDING) lookDownstream(source);
+      if (!runningTransition && source.state === STALE || runningTransition && source.tState === STALE) runTop(source);else if (!runningTransition && source.state === PENDING || runningTransition && source.tState === PENDING) lookDownstream(source);
     }
   }
 }
@@ -759,7 +766,7 @@ function markUpstream(node) {
   const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.observers.length; i += 1) {
     const o = node.observers[i];
-    if (!o.state || runningTransition && !o.tState) {
+    if (!runningTransition && !o.state || runningTransition && !o.tState) {
       if (runningTransition) o.tState = PENDING;else o.state = PENDING;
       if (o.pure) Updates.push(o);else Effects.push(o);
       o.observers && markUpstream(o);
@@ -1090,23 +1097,26 @@ const propTraps = {
     return _.keys();
   }
 };
+function resolveSource(s) {
+  return typeof s === "function" ? s() : s;
+}
 function mergeProps(...sources) {
   return new Proxy({
     get(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        const v = sources[i][property];
+        const v = resolveSource(sources[i])[property];
         if (v !== undefined) return v;
       }
     },
     has(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        if (property in sources[i]) return true;
+        if (property in resolveSource(sources[i])) return true;
       }
       return false;
     },
     keys() {
       const keys = [];
-      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(sources[i]));
+      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(resolveSource(sources[i])));
       return [...new Set(keys)];
     }
   }, propTraps);

package/dist/solid.js

@@ -448,6 +448,11 @@ function enableScheduling(scheduler = requestCallback) {
   Scheduler = scheduler;
 }
 function startTransition(fn, cb) {
+  if (Transition && Transition.running) {
+    fn();
+    cb && Transition.cb.push(cb);
+    return;
+  }
   queueMicrotask(() => {
     if (Scheduler || SuspenseContext) {
       Transition || (Transition = {
@@ -493,10 +498,11 @@ function getSuspenseContext() {
   return SuspenseContext || (SuspenseContext = createContext({}));
 }
 function readSignal() {
-  if (this.state && this.sources) {
+  const runningTransition = Transition && Transition.running;
+  if (this.sources && (!runningTransition && this.state || runningTransition && this.tState)) {
     const updates = Updates;
     Updates = null;
-    this.state === STALE || Transition && Transition.running && this.tState ? updateComputation(this) : lookDownstream(this);
+    !runningTransition && this.state === STALE || runningTransition && this.tState === STALE ? updateComputation(this) : lookDownstream(this);
     Updates = updates;
   }
   if (Listener) {
@@ -516,7 +522,7 @@ function readSignal() {
       this.observerSlots.push(Listener.sources.length - 1);
     }
   }
-  if (Transition && Transition.running && Transition.sources.has(this)) return this.tValue;
+  if (runningTransition && Transition.sources.has(this)) return this.tValue;
   return this.value;
 }
 function writeSignal(node, value, isComp) {
@@ -564,7 +570,7 @@ function updateComputation(node) {
         listener = Listener,
         time = ExecCount;
   Listener = Owner = node;
-  runComputation(node, node.value, time);
+  runComputation(node, Transition && Transition.running && Transition.sources.has(node) ? node.tValue : node.value, time);
   if (Transition && !Transition.running && Transition.sources.has(node)) {
     queueMicrotask(() => {
       runUpdates(() => {
@@ -628,7 +634,7 @@ function runTop(node) {
   const ancestors = [node];
   while ((node = node.owner) && (!node.updatedAt || node.updatedAt < ExecCount)) {
     if (runningTransition && Transition.disposed.has(node)) return;
-    if (node.state || runningTransition && node.tState) ancestors.push(node);
+    if (!runningTransition && node.state || runningTransition && node.tState) ancestors.push(node);
   }
   for (let i = ancestors.length - 1; i >= 0; i--) {
     node = ancestors[i];
@@ -639,9 +645,9 @@ function runTop(node) {
         if (Transition.disposed.has(top)) return;
       }
     }
-    if (node.state === STALE || runningTransition && node.tState === STALE) {
+    if (!runningTransition && node.state === STALE || runningTransition && node.tState === STALE) {
       updateComputation(node);
-    } else if (node.state === PENDING || runningTransition && node.tState === PENDING) {
+    } else if (!runningTransition && node.state === PENDING || runningTransition && node.tState === PENDING) {
       const updates = Updates;
       Updates = null;
       lookDownstream(node);
@@ -744,10 +750,11 @@ function runUserEffects(queue) {
 }
 function lookDownstream(node) {
   node.state = 0;
+  const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.sources.length; i += 1) {
     const source = node.sources[i];
     if (source.sources) {
-      if (source.state === STALE || Transition && Transition.running && source.tState) runTop(source);else if (source.state === PENDING) lookDownstream(source);
+      if (!runningTransition && source.state === STALE || runningTransition && source.tState === STALE) runTop(source);else if (!runningTransition && source.state === PENDING || runningTransition && source.tState === PENDING) lookDownstream(source);
     }
   }
 }
@@ -755,7 +762,7 @@ function markUpstream(node) {
   const runningTransition = Transition && Transition.running;
   for (let i = 0; i < node.observers.length; i += 1) {
     const o = node.observers[i];
-    if (!o.state || runningTransition && !o.tState) {
+    if (!runningTransition && !o.state || runningTransition && !o.tState) {
       if (runningTransition) o.tState = PENDING;else o.state = PENDING;
       if (o.pure) Updates.push(o);else Effects.push(o);
       o.observers && markUpstream(o);
@@ -1086,23 +1093,26 @@ const propTraps = {
     return _.keys();
   }
 };
+function resolveSource(s) {
+  return typeof s === "function" ? s() : s;
+}
 function mergeProps(...sources) {
   return new Proxy({
     get(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        const v = sources[i][property];
+        const v = resolveSource(sources[i])[property];
         if (v !== undefined) return v;
       }
     },
     has(property) {
       for (let i = sources.length - 1; i >= 0; i--) {
-        if (property in sources[i]) return true;
+        if (property in resolveSource(sources[i])) return true;
       }
       return false;
     },
     keys() {
       const keys = [];
-      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(sources[i]));
+      for (let i = 0; i < sources.length; i++) keys.push(...Object.keys(resolveSource(sources[i])));
       return [...new Set(keys)];
     }
   }, propTraps);

package/h/README.md

@@ -0,0 +1,99 @@
+# Solid HyperScript
+
+This sub module provides a HyperScript method for Solid. This is useful to use Solid in non-compiled environments or in some environments where you can only use a standard JSX transform. This method can be used as the JSX factory function.
+
+HyperScript function takes a few forms. The 2nd props argument is optional. Children may be passed as either an array to the 2nd/3rd argument or as every argument past the 2nd.
+
+```js
+// create an element with a title attribute
+h("button", { title: "My button" }, "Click Me")
+
+// create a component with a title prop
+h(Button, { title: "My button" }, "Click Me")
+
+// create an element with many children
+h("div", { title: "My button" }, h("span", "1"), h("span", "2"), h("span", "3"))
+```
+
+This is the least efficient way to use Solid as it requires a slightly larger runtime that isn't treeshakebable, and cannot leverage anything in the way of analysis, so it requires manual wrapping of expressions and has a few other caveats (see below).
+
+## Example
+
+```js
+import { render } from "solid-js/web";
+import h from "solid-js/h";
+import { createSignal } from "solid-js";
+
+function Button(props) {
+  return h("button.btn-primary", props)
+}
+
+function Counter() {
+  const [count, setCount] = createSignal(0);
+  const increment = (e) => setCount(c => c + 1);
+
+  return h(Button, { type: "button", onClick: increment }, count);
+}
+
+render(Counter, document.getElementById("app"));
+```
+
+## Differences from JSX
+
+There are a few differences from Solid's JSX that are important to note. And also apply when attempting use any transformation that would compile to HyperScript.
+
+1. Reactive expression must be manually wrapped in functions to be reactive.
+
+```js
+// jsx
+<div id={props.id}>{firstName() + lastName()}</div>
+
+// hyperscript
+h("div", { id: () => props.id }, () => firstName() + lastName())
+```
+
+2. Merging spreads requires using the merge props helper to keep reactivity
+
+```js
+// jsx
+<div class={selectedClass()} {...props} />
+
+// hyperscript
+import { mergeProps } from "solid-js"
+
+h("div", mergeProps({ class: selectedClass }, props))
+```
+
+3. Events on components require explicit event in the arguments
+
+Solid's HyperScript automatically wraps functions passed to props of components with no arguments in getters so you need to provide one to prevent this. The same applies to render props like in the `<For>` component.
+
+```js
+// good
+h(Button, { onClick: (e) => console.log("Hi")});
+
+// bad
+h(Button, { onClick: () => console.log("Hi")})
+```
+
+4. All refs are callback form
+
+We can't do the compiled assigment trick so only the callback form is supported.
+
+```js
+let myEl;
+
+h(div, { ref: (el) => myEl = el });
+```
+
+5. There is a shorthand for static id and classes
+
+```js
+h("div#some-id.my-class")
+```
+
+6. Fragments are just arrays
+
+```js
+[h("span", "1"), h("span", "2")]
+```

package/html/README.md

@@ -0,0 +1,84 @@
+# Solid Tagged Template Literals
+
+This sub module provides a Tagged Template Literal `html` method for Solid. This is useful to use Solid in non-compiled environments. This method can be used as replacement for JSX.
+
+`html` uses `${}` to escape into JavaScript expressions. Components are closed with `<//>`
+
+```js
+// create an element with a title attribute
+html`<button title="My button">Click Me</button>`
+
+// create a component with a title prop
+html`<${Button} title="My button">Click me<//>`
+
+// create an element with dynamic attribute and spread
+html`<div title=${() => selectedClass()} ...${props} />`
+```
+
+Using `html` is slightly less efficient than JSX(but more than HyperScript), requires a larger runtime that isn't treeshakebable, and cannot leverage expression analysis, so it requires manual wrapping of expressions and has a few other caveats (see below).
+
+## Example
+
+```js
+import { render } from "solid-js/web";
+import html from "solid-js/html";
+import { createSignal } from "solid-js";
+
+function Button(props) {
+  return html`<button class="btn-primary" ...${props} />`;
+}
+
+function Counter() {
+  const [count, setCount] = createSignal(0);
+  const increment = (e) => setCount((c) => c + 1);
+
+  return html`<${Button} type="button" onClick=${increment}>${count}<//>`;
+}
+
+render(Counter, document.getElementById("app"));
+```
+
+## Differences from JSX
+
+There are a few differences from Solid's JSX that are important to note.
+
+1. Reactive expression must be manually wrapped in functions to be reactive.
+
+```js
+// jsx
+<div id={props.id}>{firstName() + lastName()}</div>
+
+// hyperscript
+html`<div id=${() => props.id}>${() => firstName() + lastName()}</div>`
+```
+
+2. Events on components require explicit event in the arguments
+
+Solid's Tagged Template Literals automatically wraps functions passed to props of components with no arguments in getters so you need to provide one to prevent this. The same applies to render props like in the `<For>` component.
+
+```js
+// good
+html`<${Button} onClick=${(e) => console.log("Hi")} />`;
+
+// bad
+html`<${Button} onClick=${() => console.log("Hi")} />`;
+```
+
+4. All refs are callback form
+
+We can't do the compiled assigment trick so only the callback form is supported.
+
+```js
+let myEl;
+html`<div ref=${(el) => myEl = el} />`;
+```
+
+5. There can be multiple top level elements
+
+No need for fragments just:
+```js
+html`
+  <div>1</div>
+  <div>2</div>
+`
+```