marko 6.0.57 → 6.0.59

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.`
     );
   }
 }
@@ -3067,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()) {
@@ -3097,24 +3100,26 @@ 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;
@@ -3188,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"
     }
   ]
 };
@@ -4860,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,
@@ -5849,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);
@@ -5955,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"
@@ -6045,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);
@@ -6091,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"
@@ -6109,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)."
       );
     }
   },
@@ -6134,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"
@@ -6321,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);
@@ -7255,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) {
@@ -7465,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"
     }
   ]
 };
@@ -7895,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);
@@ -7956,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"
@@ -8032,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;
@@ -8199,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"
     }
   ]
 };
@@ -8577,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 = {};
@@ -8990,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 = {};
@@ -9042,32 +9069,58 @@ var id_default = {
   analyze(tag) {
     (0, import_babel_utils35.assertNoArgs)(tag);
     (0, import_babel_utils35.assertNoParams)(tag);
-    (0, import_babel_utils35.assertNoAttributes)(tag);
     assertNoBodyContent(tag);
     (0, import_babel_utils35.assertNoAttributeTags)(tag);
     const { node } = tag;
+    const [valueAttr] = node.attributes;
     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."
+      );
+    }
+    if (tag.node.attributes.length > 1 || tag.node.attributes.length === 1 && (!import_compiler41.types.isMarkoAttribute(valueAttr) || !valueAttr.default && valueAttr.name !== "value")) {
+      throw tag.get("name").buildCodeFrameError(
+        "The [`<id>` tag](https://next.markojs.com/docs/reference/core-tag#id) only supports the [`value=` attribute](https://next.markojs.com/docs/reference/language#shorthand-value)."
+      );
     }
     const binding = trackVarReferences(tag, 5 /* derived */);
     if (binding) {
-      setBindingDownstream(binding, false);
+      setBindingDownstream(binding, !!valueAttr && evaluate(valueAttr.value));
     }
   },
   translate: {
     exit(tag) {
       const { node } = tag;
       const id = isOutputHTML() ? callRuntime("nextTagId") : callRuntime("nextTagId", scopeIdentifier);
+      const [valueAttr] = tag.node.attributes;
       if (isOutputHTML()) {
         tag.replaceWith(
-          import_compiler41.types.variableDeclaration("const", [import_compiler41.types.variableDeclarator(node.var, id)])
+          import_compiler41.types.variableDeclaration("const", [
+            import_compiler41.types.variableDeclarator(
+              node.var,
+              valueAttr ? import_compiler41.types.logicalExpression("||", valueAttr.value, id) : id
+            )
+          ])
         );
       } else {
+        const section = getSection(tag);
         const source = initValue(node.var.extra.binding);
-        addValue(getSection(tag), void 0, source, id);
+        if (valueAttr) {
+          const { value } = valueAttr;
+          addValue(
+            section,
+            value.extra?.referencedBindings,
+            source,
+            import_compiler41.types.logicalExpression("||", value, id)
+          );
+        } else {
+          addValue(section, void 0, source, id);
+        }
         tag.remove();
       }
     }
@@ -9081,7 +9134,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"
@@ -9314,7 +9367,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"
     }
   ]
 };
@@ -9324,7 +9377,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"
     }
   ]
 };
@@ -9333,7 +9386,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"
     }
   ]
 };
@@ -9362,14 +9415,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).`
     );
   }
 }
@@ -9377,12 +9430,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 {
@@ -9400,7 +9455,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 {
@@ -9477,7 +9532,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 {
@@ -9495,14 +9550,18 @@ 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);
@@ -9566,7 +9625,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"
@@ -9597,13 +9656,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;
@@ -9648,7 +9707,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"
@@ -9665,11 +9724,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)."
       );
     }
   },
@@ -9700,7 +9761,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"
@@ -9709,7 +9770,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;
@@ -9720,7 +9781,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
           );
         }
@@ -9747,7 +9808,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;
@@ -9762,7 +9823,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
         );
       }
     }
@@ -9912,7 +9973,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);
@@ -9933,14 +9994,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
       );
     }
   },
@@ -10035,7 +10096,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"));
   },
@@ -10141,7 +10204,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"
@@ -10588,7 +10651,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."
+        );
       }
     }
   },
@@ -10626,11 +10691,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);
@@ -10969,11 +11034,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;
@@ -11854,9 +11919,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;
@@ -11932,6 +12004,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/package.json

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