marko 6.0.56 → 6.0.58

package/dist/translator/index.js

@@ -56,16 +56,19 @@ var import_babel_utils = require("@marko/compiler/babel-utils");
 function assertNoSpreadAttrs(tag) {
   for (const attr2 of tag.get("attributes")) {
     if (attr2.isMarkoSpreadAttribute()) {
+      const tagName = tag.get("name").node.value;
       throw attr2.buildCodeFrameError(
-        `The \`${tag.get("name").node.value}\` tag does not support \`...spread\` attributes.`
+        `The [\`<${tagName}>\`](https://next.markojs.com/docs/reference/core-tag#${tagName}) tag does not support \`...spread\` attributes.`
       );
     }
   }
 }
 function assertNoBodyContent(tag) {
   if (tag.node.body.body.length) {
-    throw tag.get("name").buildCodeFrameError(
-      `The \`${tag.get("name").node.value}\` tag does not support body content.`
+    const tagName = tag.get("name");
+    const tagNameLiteral = tagName.node.value;
+    throw tagName.buildCodeFrameError(
+      `The [\`<${tagNameLiteral}>\`](https://next.markojs.com/docs/reference/core-tag#${tagNameLiteral}) tag does not support body content.`
     );
   }
 }
@@ -1880,13 +1883,9 @@ var function_default = {
 };
 function finalizeFunctionRegistry() {
   for (const [fnExtra, exprExtras] of getReferencesByFn()) {
-    const seenExtras = /* @__PURE__ */ new Set();
     let shouldRegister = false;
     for (const exprExtra of exprExtras) {
-      const refExtra = getCanonicalExtra(exprExtra);
-      if (seenExtras.has(refExtra)) continue;
-      seenExtras.add(refExtra);
-      if (couldSerializeDownstream(refExtra.downstream)) {
+      if (couldSerializeExtra(getCanonicalExtra(exprExtra))) {
         shouldRegister = true;
         break;
       }
@@ -1896,36 +1895,6 @@ function finalizeFunctionRegistry() {
     }
   }
 }
-function couldSerializeDownstream(downstream) {
-  if (downstream) {
-    return Array.isArray(downstream.bindings) ? downstream.bindings.some((binding) => couldSerializeBinding(binding)) : couldSerializeBinding(
-      downstream.bindings,
-      downstream.excludeProperties
-    );
-  }
-  return false;
-}
-function couldSerializeBinding(binding, excludeProperties) {
-  if (getBindingSerializeReason(binding.section, binding)) {
-    return true;
-  }
-  for (const expr of binding.downstreamExpressions) {
-    if (expr.isEffect || couldSerializeDownstream(expr.downstream)) {
-      return true;
-    }
-  }
-  for (const alias of binding.aliases) {
-    if (couldSerializeBinding(alias)) {
-      return true;
-    }
-  }
-  for (const [name2, propBinding] of binding.propertyAliases) {
-    if (!excludeProperties?.has(name2) && couldSerializeBinding(propBinding)) {
-      return true;
-    }
-  }
-  return false;
-}
 function canIgnoreRegister(markoRoot, exprRoot) {
   return (
     // bail within a placeholder
@@ -3101,7 +3070,7 @@ function getSectionMeta(section) {
 function markNode(path5, nodeBinding, reason) {
   if (nodeBinding.type !== 0 /* dom */) {
     throw path5.buildCodeFrameError(
-      "Tried to mark a node that was not determined to need a mark during analyze."
+      "POTENTIAL MARKO BUG: Tried to mark a node that was not determined to need a mark during analyze."
     );
   }
   if (isOutputHTML()) {
@@ -3131,26 +3100,29 @@ var return_default = {
     if (parentTag) {
       if ((0, import_babel_utils15.isNativeTag)(parentTag)) {
         throw tag.get("name").buildCodeFrameError(
-          "The `return` tag can not be used in a native tag."
+          "The [`<return>` tag](https://next.markojs.com/docs/reference/core-tag#return) can not be used in a [native tag](https://next.markojs.com/docs/reference/native-tag)."
         );
       } else if (isControlFlowTag(parentTag)) {
         throw tag.get("name").buildCodeFrameError(
-          `The \`return\` tag can not be used under an \`${parentTag.get("name").toString()}\` tag.`
+          `The [\`<return>\` tag](https://next.markojs.com/docs/reference/core-tag#return) can not be used under the \`<${parentTag.get("name").toString()}>\` tag.`
         );
       }
     }
     if (tagsWithReturn.has(tag.parentPath)) {
       throw tag.get("name").buildCodeFrameError(
-        `Cannot have multiple \`return\` tags ${tag.parent.type === "Program" ? "for the template" : "within a tag's body content"}.`
+        `Cannot have multiple [\`<return>\` tags](https://next.markojs.com/docs/reference/core-tag#return) ${tag.parent.type === "Program" ? "for the template" : "within a tag's body content"}.`
       );
     } else {
       tagsWithReturn.add(tag.parentPath);
     }
     const attrs2 = getKnownAttrValues(tag.node);
     if (!attrs2.value) {
-      throw tag.get("name").buildCodeFrameError("The `return` tag requires a value.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<return>` tag](https://next.markojs.com/docs/reference/core-tag#return) requires a [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
+      );
     }
     if (attrs2.valueChange) {
+      (attrs2.valueChange.extra ??= {}).isEffect = true;
       forceSectionSerialize(
         getOrCreateSection(tag),
         getAccessorProp().TagVariableChange
@@ -3221,7 +3193,7 @@ var return_default = {
       displayText: "return=<value>",
       description: "Provides a value for use in a parent template.",
       snippet: "return=${1:value}",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#return"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#return"
     }
   ]
 };
@@ -3569,7 +3541,7 @@ function getSignalFn(signal) {
   }
   if (isIntersection && signal.renderReferencedBindings) {
     signal.render.unshift(
-      import_compiler21.types.variableDeclaration("const", [
+      import_compiler21.types.variableDeclaration("let", [
         import_compiler21.types.variableDeclarator(
           createScopeReadPattern(section, signal.renderReferencedBindings),
           scopeIdentifier
@@ -4893,7 +4865,7 @@ function trackAssignment(assignment, binding) {
         const changePropName = binding.property + "Change";
         const changeBinding = binding.upstreamAlias.propertyAliases.get(changePropName) || createBinding(
           generateUid(changePropName),
-          5 /* derived */,
+          binding.type === 2 /* input */ ? binding.type : 5 /* derived */,
           binding.section,
           binding.upstreamAlias,
           changePropName,
@@ -5040,10 +5012,10 @@ function createBindingsAndTrackReferences(lVal, type, scope, section, upstreamAl
         void 0
       );
       if (lVal.left.extra?.binding) {
-        (lVal.right.extra ??= {}).downstream = {
-          bindings: lVal.left.extra.binding,
-          excludeProperties: void 0
-        };
+        setBindingDownstream(
+          lVal.left.extra.binding,
+          lVal.right.extra ??= {}
+        );
       }
       break;
   }
@@ -5147,17 +5119,6 @@ function finalizeReferences() {
       });
     }
   }
-  for (const [fn, reads] of readsByFn) {
-    fn.referencedBindingsInFunction = resolveReferencedBindings(
-      fn,
-      reads,
-      intersectionsBySection
-    );
-    forEach(
-      fn.referencedBindingsInFunction,
-      (binding) => forceBindingSerialize(binding.section, binding)
-    );
-  }
   for (const binding of bindings) {
     if (binding.type !== 0 /* dom */ && !binding.upstreamAlias) {
       pruneBinding(bindings, binding);
@@ -5417,6 +5378,19 @@ function finalizeReferences() {
     }
   });
   finalizeFunctionRegistry();
+  for (const [fn, reads] of readsByFn) {
+    fn.referencedBindingsInFunction = resolveReferencedBindings(
+      fn,
+      reads,
+      intersectionsBySection
+    );
+    if (fn.registerId) {
+      forEach(
+        fn.referencedBindingsInFunction,
+        (binding) => forceBindingSerialize(binding.section, binding)
+      );
+    }
+  }
   mergedReferences.clear();
   readsByExpression.clear();
   readsByFn.clear();
@@ -5437,8 +5411,13 @@ function getMaxOwnSourceOffset(intersection, section) {
   return scopeOffset;
 }
 var intersectionMeta = /* @__PURE__ */ new WeakMap();
-function setBindingValueExpr(binding, valueExpr) {
-  bindingValueExprs.set(binding, valueExpr || false);
+function setBindingDownstream(binding, expr) {
+  bindingValueExprs.set(binding, expr || false);
+  if (expr && expr !== true) {
+    forEach(expr, (expr2) => {
+      expr2.downstream = bindingUtil.add(expr2.downstream, binding);
+    });
+  }
 }
 var resolvedSources = /* @__PURE__ */ new WeakSet();
 var bindingValueExprs = /* @__PURE__ */ new WeakMap();
@@ -5805,6 +5784,50 @@ function getCanonicalExtra(extra) {
   }
   return extra;
 }
+var couldSerializeLookup = /* @__PURE__ */ new WeakMap();
+function couldSerializeExtra(extra) {
+  let couldSerialize = couldSerializeLookup.get(extra);
+  if (couldSerialize === void 0) {
+    couldSerializeLookup.set(
+      extra,
+      couldSerialize = extra === (0, import_babel_utils19.getProgram)().node.extra?.returnValueExpr || !!find(extra.downstream, couldSerializeBinding)
+    );
+  }
+  return couldSerialize;
+}
+function couldSerializeBinding(binding) {
+  let couldSerialize = couldSerializeLookup.get(binding);
+  if (couldSerialize === void 0) {
+    if (getBindingSerializeReason(binding.section, binding)) {
+      couldSerialize = true;
+    } else {
+      for (const expr of binding.downstreamExpressions) {
+        if (expr.isEffect || couldSerializeExtra(expr)) {
+          couldSerialize = true;
+          break;
+        }
+      }
+      if (!couldSerialize) {
+        for (const alias of binding.aliases) {
+          if (couldSerializeBinding(alias)) {
+            couldSerialize = true;
+            break;
+          }
+        }
+        if (!couldSerialize) {
+          for (const [, propBinding] of binding.propertyAliases) {
+            if (couldSerializeBinding(propBinding)) {
+              couldSerialize = true;
+              break;
+            }
+          }
+        }
+      }
+    }
+    couldSerializeLookup.set(binding, couldSerialize ??= false);
+  }
+  return couldSerialize;
+}
 function setCanonicalExtra(extra, merged) {
   extra.merged = merged;
 }
@@ -5831,19 +5854,23 @@ var await_default = {
     const tagExtra = tag.node.extra ??= {};
     tagExtra[kDOMBinding] = createBinding("#text", 0 /* dom */, section);
     if (!valueAttr) {
-      throw tag.get("name").buildCodeFrameError("The `await` tag requires a value.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<await>` tag](https://next.markojs.com/docs/reference/core-tag#await) requires a [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
+      );
     }
     if (node.attributes.length > 1 || !import_compiler26.types.isMarkoAttribute(valueAttr) || valueAttr.name !== "value") {
       throw tag.get("name").buildCodeFrameError(
-        "The `await` tag only supports the `value` attribute."
+        "The [`<await>` tag](https://next.markojs.com/docs/reference/core-tag#await) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
       );
     }
     if (!node.body.body.length) {
-      throw tag.get("name").buildCodeFrameError("The `await` tag requires body content.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<await>` tag](https://next.markojs.com/docs/reference/core-tag#await) requires [content](https://next.markojs.com/docs/reference/language#tag-content)."
+      );
     }
     if (node.body.params.length && (node.body.params.length > 1 || import_compiler26.types.isSpreadElement(node.body.params[0]))) {
       throw tag.get("name").buildCodeFrameError(
-        "The `await` tag only supports a single parameter."
+        "The [`<await>` tag](https://next.markojs.com/docs/reference/core-tag#await) only supports a single parameter."
       );
     }
     const bodySection = startSection(tagBody);
@@ -5851,7 +5878,7 @@ var await_default = {
     getOrCreateSection(tag);
     const paramsBinding = trackParamsReferences(tagBody, 3 /* param */);
     if (paramsBinding) {
-      setBindingValueExpr(paramsBinding, valueExtra);
+      setBindingDownstream(paramsBinding, valueExtra);
     }
     bodySection.upstreamExpression = valueAttr.value.extra;
   },
@@ -5937,7 +5964,7 @@ var await_default = {
   autocomplete: [
     {
       description: "Use to consume asynchronous an data.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#await"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#await"
     }
   ],
   types: runtime_info_default.name + "/tags/await.d.marko"
@@ -6027,14 +6054,18 @@ var const_default = {
     const { node } = tag;
     const [valueAttr] = node.attributes;
     if (!node.var) {
-      throw tag.get("name").buildCodeFrameError("The `const` tag requires a tag variable.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<const>` tag](https://next.markojs.com/docs/reference/core-tag#const) requires a [tag variable](https://next.markojs.com/docs/reference/language#tag-variables)."
+      );
     }
     if (!valueAttr) {
-      throw tag.get("name").buildCodeFrameError("The `const` tag requires a value.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<const>` tag](https://next.markojs.com/docs/reference/core-tag#const) requires a [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
+      );
     }
     if (node.attributes.length > 1 || !import_compiler29.types.isMarkoAttribute(valueAttr) || !valueAttr.default && valueAttr.name !== "value") {
       throw tag.get("name").buildCodeFrameError(
-        "The `const` tag only supports the `value` attribute."
+        "The [`<const>` tag](https://next.markojs.com/docs/reference/core-tag#const) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
       );
     }
     const valueExtra = evaluate(valueAttr.value);
@@ -6045,11 +6076,7 @@ var const_default = {
     const binding = trackVarReferences(tag, 5 /* derived */, upstreamAlias);
     if (binding) {
       if (!valueExtra.nullable) binding.nullable = false;
-      setBindingValueExpr(binding, valueExtra);
-      valueExtra.downstream = {
-        bindings: binding,
-        excludeProperties: void 0
-      };
+      setBindingDownstream(binding, valueExtra);
     }
   },
   translate: {
@@ -6077,7 +6104,7 @@ var const_default = {
   autocomplete: [
     {
       description: "Use to create an constant binding.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#const"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#const"
     }
   ],
   types: runtime_info_default.name + "/tags/const.d.marko"
@@ -6095,7 +6122,7 @@ var debug_default = {
     assertNoBodyContent(tag);
     if (tag.node.attributes.length > 1 || tag.node.attributes.length === 1 && (!import_compiler30.types.isMarkoAttribute(valueAttr) || !valueAttr.default && valueAttr.name !== "value")) {
       throw tag.get("name").buildCodeFrameError(
-        "The `debug` tag only supports the `value` attribute."
+        "The [`<debug>` tag](https://next.markojs.com/docs/reference/core-tag#debug) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
       );
     }
   },
@@ -6120,7 +6147,7 @@ var debug_default = {
   autocomplete: [
     {
       description: "Debug on value change.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#debug"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#debug"
     }
   ],
   types: runtime_info_default.name + "/tags/debug.d.marko"
@@ -6307,7 +6334,7 @@ var native_tag_default = {
       const { node } = tag;
       if (node.var && !import_compiler32.types.isIdentifier(node.var)) {
         throw tag.get("var").buildCodeFrameError(
-          "Tag variables on native elements cannot be destructured."
+          "Tag variables on [native tags](https://next.markojs.com/docs/reference/native-tag) cannot be destructured."
         );
       }
       const tagName = getTagName(tag);
@@ -7241,7 +7268,7 @@ var for_default = {
         break;
       default:
         throw tag.buildCodeFrameError(
-          "Invalid `for` tag, missing an `of=`, `in=`, `to=` attribute."
+          "The [`<for>` tag](https://next.markojs.com/docs/reference/core-tag#for) requires an `of=`, `in=`, or `to=` attribute."
         );
     }
     if (!isAttrTag) {
@@ -7261,7 +7288,7 @@ var for_default = {
       getAllTagReferenceNodes(tag.node)
     );
     if (paramsBinding) {
-      setBindingValueExpr(paramsBinding, tagExtra);
+      setBindingDownstream(paramsBinding, tagExtra);
     }
     bodySection.sectionAccessor = {
       binding: nodeBinding,
@@ -7451,15 +7478,15 @@ var for_default = {
     {
       snippet: "for|${1:value, index}| of=${3:array}",
       description: "Use to iterate over lists, object properties, or between ranges.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#iterating-over-a-list"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#for"
     },
     {
       snippet: "for|${1:name, value}| in=${3:object}",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#iterating-over-an-objects-properties"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#for"
     },
     {
       snippet: "for|${1:index}| to=${2:number}",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#iterating-between-a-range-of-numbers"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#for"
     }
   ]
 };
@@ -7881,7 +7908,9 @@ var define_default = {
   analyze(tag) {
     (0, import_babel_utils29.assertNoArgs)(tag);
     if (!tag.node.var) {
-      throw tag.get("name").buildCodeFrameError("The `define` tag requires a tag variable.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<define>` tag](https://next.markojs.com/docs/reference/core-tag#define) requires a [tag variable](https://next.markojs.com/docs/reference/language#tag-variables)."
+      );
     }
     const tagBody = tag.get("body");
     const bodySection = startSection(tagBody);
@@ -7899,11 +7928,7 @@ var define_default = {
       getAllTagReferenceNodes(tag.node)
     );
     if (varBinding) {
-      setBindingValueExpr(varBinding, tagExtra);
-      tagExtra.downstream = {
-        bindings: varBinding,
-        excludeProperties: void 0
-      };
+      setBindingDownstream(varBinding, tagExtra);
     }
   },
   translate: {
@@ -7946,7 +7971,7 @@ var define_default = {
   autocomplete: [
     {
       description: "Use to create a constant object binding that can be rendered.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#define"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#define"
     }
   ],
   types: runtime_info_default.name + "/tags/define.d.marko"
@@ -8022,7 +8047,7 @@ var html_comment_default = {
     if (tagVar) {
       if (!import_compiler38.types.isIdentifier(tagVar)) {
         throw tag.get("var").buildCodeFrameError(
-          "The `html-comment` tag variable cannot be destructured."
+          "The [`<html-comment>` tag](https://next.markojs.com/docs/reference/core-tag#html-comment) tag variable cannot be destructured."
         );
       }
       needsBinding = true;
@@ -8189,7 +8214,7 @@ var html_comment_default = {
   autocomplete: [
     {
       description: "Use to create an html comment that is not stripped from the output.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#html-comment"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#html-comment"
     }
   ]
 };
@@ -8567,7 +8592,13 @@ var html_script_default = {
   parseOptions: {
     text: true,
     preserveWhitespace: true
-  }
+  },
+  autocomplete: [
+    {
+      description: "Use instead of `<script>` to render a native tag directly, without processing by Marko.",
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#html-script--html-style"
+    }
+  ]
 };
 function getUsedAttrs2(tag) {
   const seen = {};
@@ -8980,7 +9011,13 @@ var html_style_default = {
   parseOptions: {
     text: true,
     preserveWhitespace: true
-  }
+  },
+  autocomplete: [
+    {
+      description: "Use instead of `<style>` to render a native tag directly, without processing by Marko.",
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#html-script--html-style"
+    }
+  ]
 };
 function getUsedAttrs3(tag) {
   const seen = {};
@@ -9037,14 +9074,18 @@ var id_default = {
     (0, import_babel_utils35.assertNoAttributeTags)(tag);
     const { node } = tag;
     if (!node.var) {
-      throw tag.get("name").buildCodeFrameError("The `id` tag requires a tag variable.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<id>` tag](https://next.markojs.com/docs/reference/core-tag#id) requires a [tag variable](https://next.markojs.com/docs/reference/language#tag-variables)."
+      );
     }
     if (!import_compiler41.types.isIdentifier(node.var)) {
-      throw tag.get("var").buildCodeFrameError("The `id` tag cannot be destructured");
+      throw tag.get("var").buildCodeFrameError(
+        "The [`<id>` tag](https://next.markojs.com/docs/reference/core-tag#id) cannot be destructured."
+      );
     }
     const binding = trackVarReferences(tag, 5 /* derived */);
     if (binding) {
-      setBindingValueExpr(binding, false);
+      setBindingDownstream(binding, false);
     }
   },
   translate: {
@@ -9071,7 +9112,7 @@ var id_default = {
       displayText: "id/<name>",
       description: "Use to create a unique identifier.",
       snippet: "id/${1:name}",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#id"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#id"
     }
   ],
   types: runtime_info_default.name + "/tags/id.d.marko"
@@ -9304,7 +9345,7 @@ var IfTag = {
     {
       snippet: "if=${1:condition}",
       description: "Use to display content only if the condition is met.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#if-else-if-else"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#if--else"
     }
   ]
 };
@@ -9314,7 +9355,7 @@ var ElseIfTag = {
     {
       snippet: "else-if=${1:condition}",
       description: "Use after an <if> or <else-if> tag to display content if those conditions do not match and this one does.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#if-else-if-else"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#if--else"
     }
   ]
 };
@@ -9323,7 +9364,7 @@ var ElseTag = {
   autocomplete: [
     {
       description: "Use after an <if> or <else-if> tag to display content if those conditions do not match.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#if-else-if-else"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#if--else"
     }
   ]
 };
@@ -9352,14 +9393,14 @@ function assertHasPrecedingCondition(tag) {
   while (prev.node && prev.isMarkoComment()) prev = prev.getPrevSibling();
   if (!isConditionTag(prev) || getTagName(prev) !== "else" && !prev.node.attributes.length) {
     throw tag.buildCodeFrameError(
-      `The \`<${getTagName(tag)}>\` must have a preceding \`<if=cond>\`, \`<else-if=cond>\`, or \`<else if=cond>\`.`
+      `The [\`<${getTagName(tag)}>\` tag](https://next.markojs.com/docs/reference/core-tag#if--else) must have a preceding \`<if=cond>\` or \`<else if=cond>\`.`
     );
   }
 }
 function assertHasBody(tag) {
   if (!(tag.node.body.body.length || tag.node.attributeTags.length)) {
     throw tag.get("name").buildCodeFrameError(
-      `The \`${getTagName(tag)}\` tag requires body content.`
+      `The [\`${getTagName(tag)}\` tag](https://next.markojs.com/docs/reference/core-tag#if--else) requires [body content](https://next.markojs.com/docs/reference/language#tag-content).`
     );
   }
 }
@@ -9367,12 +9408,14 @@ function assertHasValueAttribute(tag) {
   const { node } = tag;
   const [valueAttr] = node.attributes;
   if (!import_compiler43.types.isMarkoAttribute(valueAttr) || !valueAttr.default) {
-    throw tag.get("name").buildCodeFrameError(`The \`${getTagName(tag)}\` tag requires a value.`);
+    throw tag.get("name").buildCodeFrameError(
+      `The [\`${getTagName(tag)}\` tag](https://next.markojs.com/docs/reference/core-tag#if--else) requires a [\`value=\` attribute](https://next.markojs.com/docs/reference/language#shorthand-value).`
+    );
   }
   if (node.attributes.length > 1) {
     const start = node.attributes[1].loc?.start;
     const end = node.attributes[node.attributes.length - 1].loc?.end;
-    const msg = `The \`${getTagName(tag)}\` tag only supports the \`value\` attribute.`;
+    const msg = `The [\`${getTagName(tag)}\` tag](https://next.markojs.com/docs/reference/core-tag#if--else) only supports the [\`value=\` attribute](https://next.markojs.com/docs/reference/language#shorthand-value).`;
     if (start == null || end == null) {
       throw tag.get("name").buildCodeFrameError(msg);
     } else {
@@ -9390,7 +9433,7 @@ function assertOptionalIfAttribute(tag) {
   if (node.attributes.length > 1 || ifAttr && ifAttr.name !== "if") {
     const start = node.attributes[1].loc?.start;
     const end = node.attributes[node.attributes.length - 1].loc?.end;
-    const msg = `The \`${getTagName(tag)}\` tag only supports an \`if=\` attribute.`;
+    const msg = `The [\`${getTagName(tag)}\` tag](https://next.markojs.com/docs/reference/core-tag#if--else) only supports an \`if=\` attribute.`;
     if (start == null || end == null) {
       throw tag.get("name").buildCodeFrameError(msg);
     } else {
@@ -9467,7 +9510,7 @@ var let_default = {
         } else {
           const start = attr2.loc?.start;
           const end = attr2.loc?.end;
-          const msg = "The `let` tag only supports the `value` attribute and its change handler.";
+          const msg = "The [`<let>` tag](https://next.markojs.com/docs/reference/core-tag#let) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value) and its change handler.";
           if (start == null || end == null) {
             throw tag.get("name").buildCodeFrameError(msg);
           } else {
@@ -9485,19 +9528,23 @@ var let_default = {
     assertNoBodyContent(tag);
     assertNoSpreadAttrs(tag);
     if (!tagVar) {
-      throw tag.get("name").buildCodeFrameError("The `let` tag requires a tag variable.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<let>` tag](https://next.markojs.com/docs/reference/core-tag#let) requires a [tag variable](https://next.markojs.com/docs/reference/language#tag-variables)."
+      );
     }
     if (!import_compiler44.types.isIdentifier(tagVar)) {
-      throw tag.get("var").buildCodeFrameError("The `let` tag variable cannot be destructured.");
+      throw tag.get("var").buildCodeFrameError(
+        "The [`<let>` tag](https://next.markojs.com/docs/reference/core-tag#let) variable cannot be destructured."
+      );
     }
     if (valueChangeAttr && (0, import_babel_utils38.computeNode)(valueChangeAttr.value)) {
       throw tag.get("attributes").find((attr2) => attr2.node === valueChangeAttr).get("value").buildCodeFrameError(
-        "The `let` tag `valueChange` attribute must be a function."
+        "The [`<let>` tag](https://next.markojs.com/docs/reference/core-tag#let) [`valueChange=` attribute](https://next.markojs.com/docs/reference/core-tag#controllable-let) must be a function."
       );
     }
     const tagSection = getOrCreateSection(tag);
     const binding = trackVarReferences(tag, 1 /* let */);
-    setBindingValueExpr(
+    setBindingDownstream(
       binding,
       mergeReferences(tagSection, tag.node, [
         valueAttr?.value,
@@ -9556,7 +9603,7 @@ var let_default = {
   autocomplete: [
     {
       description: "Use to create a mutable binding.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#let"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#let"
     }
   ],
   types: runtime_info_default.name + "/tags/let.d.marko"
@@ -9587,13 +9634,13 @@ var lifecycle_default = {
     binding.downstreamExpressions.add(tagExtra);
     if (node.attributes.length === 0) {
       throw tag.get("name").buildCodeFrameError(
-        "The `lifecycle` tag requires at least one attribute."
+        "The [`<lifecycle>` tag](https://next.markojs.com/docs/reference/core-tag#lifecycle) requires at least one attribute."
       );
     }
     for (const attr2 of node.attributes) {
       if (import_compiler45.types.isMarkoSpreadAttribute(attr2)) {
         throw tag.get("name").buildCodeFrameError(
-          "The `lifecycle` tag does not support `...spread` attributes."
+          "The [`<lifecycle>` tag](https://next.markojs.com/docs/reference/core-tag#lifecycle) does not support [`...spread` attributes](https://next.markojs.com/docs/reference/language#spread-attributes)."
         );
       }
       (attr2.value.extra ??= {}).isEffect = true;
@@ -9638,7 +9685,7 @@ var lifecycle_default = {
   autocomplete: [
     {
       description: "Use to create a side effects.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#effect"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#lifecycle"
     }
   ],
   types: runtime_info_default.name + "/tags/lifecycle.d.marko"
@@ -9655,11 +9702,13 @@ var log_default = {
     (0, import_babel_utils40.assertNoParams)(tag);
     assertNoBodyContent(tag);
     if (!valueAttr) {
-      throw tag.get("name").buildCodeFrameError("The `log` tag requires a value.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<log>` tag](https://next.markojs.com/docs/reference/core-tag#log) requires a [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
+      );
     }
     if (tag.node.attributes.length > 1 || !import_compiler46.types.isMarkoAttribute(valueAttr) || !valueAttr.default && valueAttr.name !== "value") {
       throw tag.get("name").buildCodeFrameError(
-        "The `log` tag only supports the `value` attribute."
+        "The [`<log>` tag](https://next.markojs.com/docs/reference/core-tag#log) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
       );
     }
   },
@@ -9690,7 +9739,7 @@ var log_default = {
   autocomplete: [
     {
       description: "Use to log a value to the console.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#log"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#log"
     }
   ],
   types: runtime_info_default.name + "/tags/log.d.marko"
@@ -9699,7 +9748,7 @@ var log_default = {
 // src/translator/core/script.ts
 var import_compiler47 = require("@marko/compiler");
 var import_babel_utils41 = require("@marko/compiler/babel-utils");
-var htmlScriptTagAlternateMsg = " For a native html `script` tag use the `html-script` core tag instead.";
+var htmlScriptTagAlternateMsg = " For a native html [`<script>` tag](https://next.markojs.com/docs/reference/core-tag#script) use the `html-script` core tag instead.";
 var script_default = {
   parse(tag) {
     const { node } = tag;
@@ -9710,7 +9759,7 @@ var script_default = {
         if (child.type !== "MarkoText") {
           throw tag.hub.file.hub.buildError(
             child,
-            "Unexpected content in `script` tag. Only javascript and typescript is supported." + htmlScriptTagAlternateMsg,
+            "Unexpected content in [`<script>` tag](https://next.markojs.com/docs/reference/core-tag#script). Only javascript and typescript is supported." + htmlScriptTagAlternateMsg,
             SyntaxError
           );
         }
@@ -9737,7 +9786,7 @@ var script_default = {
     if (node.var) {
       throw tag.hub.buildError(
         node.var,
-        "The `script` tag does not support a tag variable reference." + htmlScriptTagAlternateMsg
+        "The [`<script>` tag](https://next.markojs.com/docs/reference/core-tag#script) does not support a tag variable reference." + htmlScriptTagAlternateMsg
       );
     }
     let seenValueAttr = false;
@@ -9752,7 +9801,7 @@ var script_default = {
       } else {
         throw tag.hub.buildError(
           attr2,
-          "The `script` tag does not support html attributes." + htmlScriptTagAlternateMsg
+          "The [`<script>` tag](https://next.markojs.com/docs/reference/core-tag#script) does not support html attributes." + htmlScriptTagAlternateMsg
         );
       }
     }
@@ -9902,7 +9951,7 @@ var import_babel_utils44 = require("@marko/compiler/babel-utils");
 var import_magic_string = __toESM(require("magic-string"));
 var import_path3 = __toESM(require("path"));
 var STYLE_EXT_REG = /^style((?:\.[a-zA-Z0-9$_-]+)+)?/;
-var htmlStyleTagAlternateMsg = " For a native html `style` tag use the `html-style` core tag instead.";
+var htmlStyleTagAlternateMsg = " For a native html [`<style>` tag](https://next.markojs.com/docs/reference/core-tag#style) use the `html-style` core tag instead.";
 var style_default = {
   analyze(tag) {
     (0, import_babel_utils44.assertNoArgs)(tag);
@@ -9923,14 +9972,14 @@ var style_default = {
       if (child.type !== "MarkoText") {
         throw tag.hub.buildError(
           child,
-          "The `style` tag currently only supports static content." + htmlStyleTagAlternateMsg
+          "The [`<style>` tag](https://next.markojs.com/docs/reference/core-tag#style) currently only supports static content." + htmlStyleTagAlternateMsg
         );
       }
     }
     if (node.body.body.length > 1) {
       throw tag.hub.buildError(
         node.name,
-        "The `style` tag currently only supports static content." + htmlStyleTagAlternateMsg
+        "The [`<style>` tag](https://next.markojs.com/docs/reference/core-tag#style) currently only supports static content." + htmlStyleTagAlternateMsg
       );
     }
   },
@@ -10025,7 +10074,9 @@ var try_default = {
     );
     tagExtra[kDOMBinding2] = createBinding("#text", 0 /* dom */, section);
     if (!tag.node.body.body.length) {
-      throw tag.get("name").buildCodeFrameError("The `try` tag requires body content.");
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<try>` tag](https://next.markojs.com/docs/reference/core-tag#try) requires [body content](https://next.markojs.com/docs/reference/language#tag-content)."
+      );
     }
     startSection(tag.get("body"));
   },
@@ -10131,7 +10182,7 @@ var try_default = {
   autocomplete: [
     {
       description: "Used to capture errors and display placeholders for nested content.",
-      descriptionMoreURL: "https://markojs.com/docs/core-tags/#try"
+      descriptionMoreURL: "https://next.markojs.com/docs/reference/core-tag#try"
     }
   ],
   types: runtime_info_default.name + "/tags/try.d.marko"
@@ -10578,7 +10629,9 @@ var attribute_tag_default = {
       startSection(body);
       trackParamsReferences(body, 3 /* param */);
       if (!(0, import_babel_utils48.findParentTag)(tag)) {
-        throw tag.get("name").buildCodeFrameError("@tags must be nested within another tag.");
+        throw tag.get("name").buildCodeFrameError(
+          "[Attribute tags](https://next.markojs.com/docs/reference/language#attribute-tags) must be nested within another tag."
+        );
       }
     }
   },
@@ -10616,11 +10669,11 @@ var custom_tag_default = {
         const tagName = getTagName(tag);
         if (tagName && tag.scope.hasBinding(tagName)) {
           throw tag.get("name").buildCodeFrameError(
-            `Local variables must be in a dynamic tag unless they are PascalCase. Use \`<\${${tagName}}/>\` or rename to \`${tagName.charAt(0).toUpperCase() + tagName.slice(1)}\`.`
+            `Local variables must be in a [dynamic tag](https://next.markojs.com/docs/reference/language#dynamic-tags) unless they are PascalCase. Use \`<\${${tagName}}/>\` or rename to \`${tagName.charAt(0).toUpperCase() + tagName.slice(1)}\`.`
           );
         }
         throw tag.get("name").buildCodeFrameError(
-          `Unable to find entry point for custom tag \`<${tagName}>\`.`
+          `Unable to find entry point for [custom tag](https://next.markojs.com/docs/reference/custom-tag#relative-custom-tags) \`<${tagName}>\`.`
         );
       }
       const section = getOrCreateSection(tag);
@@ -10646,7 +10699,7 @@ var custom_tag_default = {
         mergeReferences(section, tag.node, getAllTagReferenceNodes(tag.node));
         if (varBinding) {
           const varSerializeReason = (0, import_babel_utils49.getProgram)().node.extra.returnValueExpr;
-          setBindingValueExpr(varBinding, varSerializeReason);
+          setBindingDownstream(varBinding, varSerializeReason);
           addBindingSerializeReasonExpr(
             section,
             childScopeBinding,
@@ -10672,7 +10725,7 @@ var custom_tag_default = {
             childInputBinding,
             inputExpr
           );
-          setBindingValueExpr(varBinding, varSerializeReason);
+          setBindingDownstream(varBinding, varSerializeReason);
           addBindingSerializeReasonExpr(
             section,
             childScopeBinding,
@@ -10959,11 +11012,11 @@ function getTagRelativePath(tag) {
     const tagName = getTagName(tag);
     if (tagName && tag.scope.hasBinding(tagName)) {
       throw tag.get("name").buildCodeFrameError(
-        `Local variables must be in a dynamic tag unless they are PascalCase. Use \`<\${${tagName}}/>\` or rename to \`${tagName.charAt(0).toUpperCase() + tagName.slice(1)}\`.`
+        `Local variables must be in a [dynamic tag](https://next.markojs.com/docs/reference/language#dynamic-tags) unless they are PascalCase. Use \`<\${${tagName}}/>\` or rename to \`${tagName.charAt(0).toUpperCase() + tagName.slice(1)}\`.`
       );
     }
     throw tag.get("name").buildCodeFrameError(
-      `Unable to find entry point for custom tag \`<${tagName}>\`.`
+      `Unable to find entry point for [custom tag](https://next.markojs.com/docs/reference/custom-tag#relative-custom-tags) \`<${tagName}>\`.`
     );
   }
   return relativePath;
@@ -10979,10 +11032,7 @@ function analyzeAttrs(rootTagExtra, section, tag, templateExport, rootAttrExprs,
       tag.node,
       getAllTagReferenceNodes(tag.node)
     );
-    extra.downstream = {
-      bindings: templateExport.binding,
-      excludeProperties: void 0
-    };
+    setBindingDownstream(templateExport.binding, extra);
     return;
   }
   const known = inputExpr.known = {};
@@ -11065,10 +11115,9 @@ function analyzeAttrs(rootTagExtra, section, tag, templateExport, rootAttrExprs,
         bindings = bindingUtil.add(bindings, templateExportAttr.binding);
       }
       if (bindings) {
-        groupExtra.downstream = {
-          bindings,
-          excludeProperties: void 0
-        };
+        forEach(bindings, (binding) => {
+          setBindingDownstream(binding, groupExtra);
+        });
       }
       for (const name2 of group) {
         known[attrTagLookup[name2].name] = groupKnownValue;
@@ -11094,10 +11143,10 @@ function analyzeAttrs(rootTagExtra, section, tag, templateExport, rootAttrExprs,
         continue;
       }
       seen.add(attr2.name);
-      (attr2.value.extra ??= {}).downstream = {
-        bindings: templateExportAttr.binding,
-        excludeProperties: void 0
-      };
+      setBindingDownstream(
+        templateExportAttr.binding,
+        attr2.value.extra ??= {}
+      );
     }
     if (spreadReferenceNodes) {
       spreadReferenceNodes.push(attr2.value);
@@ -11115,10 +11164,20 @@ function analyzeAttrs(rootTagExtra, section, tag, templateExport, rootAttrExprs,
       tag.node,
       spreadReferenceNodes
     );
-    extra.downstream = {
-      bindings: templateExport.binding,
-      excludeProperties: seen
-    };
+    let spreadBinding = templateExport.binding;
+    if (seen.size) {
+      spreadBinding = createBinding(
+        generateUid(`${getTagName(tag)}_attrs`),
+        spreadBinding.type,
+        spreadBinding.section,
+        spreadBinding,
+        void 0,
+        fromIter(seen),
+        spreadReferenceNodes[0].loc,
+        true
+      );
+    }
+    setBindingDownstream(spreadBinding, extra);
   }
 }
 function writeAttrsToExports(tag, templateExport, importAlias, info) {
@@ -11606,7 +11665,7 @@ var dynamic_tag_default = {
             ])
           );
           statements.push(
-            import_compiler57.types.variableDeclaration("const", [
+            import_compiler57.types.variableDeclaration("let", [
               import_compiler57.types.variableDeclarator(node.var, dynamicTagExpr)
             ]),
             import_compiler57.types.expressionStatement(
@@ -11838,9 +11897,16 @@ function getChangeHandler(tag, attr2) {
       );
     const existingChangedAttr = BINDING_CHANGE_HANDLER.get(binding.identifier);
     if (!existingChangedAttr) {
+      const bindingIdentifierPath = binding.path.getOuterBindingIdentifierPaths()[binding.identifier.name];
+      const changeAttrExpr = bindingIdentifierPath ? bindingIdentifierPath.parentPath === binding.path ? buildChangeHandlerFunction(attr2.value) : bindingIdentifierPath.parentPath.isObjectProperty() ? getChangeHandlerFromObjectPattern(
+        bindingIdentifierPath.parentPath
+      ) : void 0 : void 0;
+      if (!changeAttrExpr) {
+        throw tag.hub.buildError(attr2.value, "Unable to bind to value.");
+      }
       const changeHandlerAttr = import_compiler58.types.markoAttribute(
         changeAttrName,
-        buildChangeHandlerFunction(attr2.value)
+        changeAttrExpr
       );
       BINDING_CHANGE_HANDLER.set(binding.identifier, changeHandlerAttr);
       return changeHandlerAttr;
@@ -11916,6 +11982,51 @@ function buildChangeHandlerFunction(id) {
     ])
   );
 }
+function getChangeHandlerFromObjectPattern(parent) {
+  let changeKey;
+  const pattern = parent.parentPath;
+  if (parent.node.computed) {
+    changeKey = generateUidIdentifier(`dynamicChange`);
+    pattern.pushContainer(
+      "properties",
+      import_compiler58.types.objectProperty(
+        import_compiler58.types.binaryExpression(
+          "+",
+          parent.get("key").node,
+          import_compiler58.types.stringLiteral("Change")
+        ),
+        changeKey,
+        true
+      )
+    );
+  } else {
+    const key = parent.get("key");
+    const searchKey = `${getStringOrIdentifierValue(key)}Change`;
+    for (const prop of pattern.get("properties")) {
+      if (prop.isObjectProperty()) {
+        const propKey = prop.get("key");
+        const propValue = prop.get("value");
+        if (!prop.node.computed && getStringOrIdentifierValue(propKey) === searchKey && propValue.isIdentifier()) {
+          changeKey = propValue.node;
+          break;
+        }
+      }
+    }
+    if (!changeKey) {
+      pattern.unshiftContainer(
+        "properties",
+        import_compiler58.types.objectProperty(
+          import_compiler58.types.stringLiteral(searchKey),
+          changeKey = generateUidIdentifier(searchKey)
+        )
+      );
+    }
+  }
+  return changeKey;
+}
+function getStringOrIdentifierValue(path5) {
+  return path5.isStringLiteral() ? path5.node.value : path5.node.name;
+}
 
 // src/translator/visitors/text.ts
 var import_compiler59 = require("@marko/compiler");

package/dist/translator/util/references.d.ts

@@ -1,5 +1,5 @@
 import { types as t } from "@marko/compiler";
-import { type Many, type OneMany, type Opt, Sorted } from "./optional";
+import { type Many, type Opt, Sorted } from "./optional";
 import { type Section } from "./sections";
 declare const kIsInvoked: unique symbol;
 export declare const kBranchSerializeReason: unique symbol;
@@ -52,10 +52,7 @@ declare module "@marko/compiler/dist/types" {
     interface NodeExtra {
         section?: Section;
         referencedBindings?: ReferencedBindings;
-        downstream?: {
-            bindings: OneMany<Binding>;
-            excludeProperties: undefined | Set<string>;
-        };
+        downstream?: Opt<Binding>;
         binding?: Binding;
         assignment?: Binding;
         assignmentTo?: Binding;
@@ -89,7 +86,7 @@ export declare const intersectionMeta: WeakMap<Intersection, {
     id: number;
     scopeOffset: Binding | undefined;
 }>;
-export declare function setBindingValueExpr(binding: Binding, valueExpr: boolean | Opt<t.NodeExtra>): void;
+export declare function setBindingDownstream(binding: Binding, expr: boolean | Opt<t.NodeExtra>): void;
 export declare function createSources(state: Sources["state"], input: Sources["input"]): Sources;
 export declare function compareSources(a: Sources, b: Sources): number;
 export declare function mergeSources(a: undefined | Sources, b: undefined | Sources): Sources | undefined;
@@ -125,4 +122,6 @@ export interface RegisteredFnExtra extends ReferencedExtra {
 }
 export declare function isRegisteredFnExtra(extra: t.NodeExtra | undefined): extra is RegisteredFnExtra;
 export declare function getCanonicalExtra<T extends t.NodeExtra>(extra: T): T;
+export declare function couldSerializeExtra(extra: t.NodeExtra): boolean;
+export declare function couldSerializeBinding(binding: Binding): boolean;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marko",
-  "version": "6.0.56",
+  "version": "6.0.58",
   "description": "Optimized runtime for Marko templates.",
   "keywords": [
     "api",