tutuca 0.9.48 → 0.9.50

package/README.md

@@ -73,11 +73,9 @@ in the storybook shape `{ title, description?, items: [{ title, description?, va
 
 ```sh
 npm install --save-dev tutuca
-# prettier is optional, only needed for --pretty
-npm install --save-dev prettier
 ```
 
-The package exposes `tutuca` via `bin`, so `npx tutuca` (or a global `npm i -g tutuca`) just works. `jsdom` ships as a regular dependency (it's needed by `render` and `lint`) and is installed automatically.
+The package exposes `tutuca` via `bin`, so `npx tutuca` (or a global `npm i -g tutuca`) just works. `jsdom` (needed by `render` and `lint`) and `prettier` (used by `--pretty`) ship as regular dependencies and are installed automatically.
 
 ### Commands
 

package/dist/tutuca-cli.js

@@ -3344,11 +3344,12 @@ class ComponentDocs {
 }
 
 class LintFinding {
-  constructor({ id, level, info, context = {} }) {
+  constructor({ id, level, info, context = {}, suggestion = null }) {
     this.id = id;
     this.level = level;
     this.info = info;
     this.context = context;
+    this.suggestion = suggestion;
   }
 }
 
@@ -6633,10 +6634,7 @@ class LinterCtx {
     a.quote = quote;
     const dup = this.currentAttrs.find((x) => x.name === a.name);
     if (dup) {
-      this.report(HTML_DUPLICATE_ATTRIBUTE, LEVEL_WARN, a.nameStart, {
-        name: a.name,
-        firstAt: dup.nameStart
-      });
+      this.report(HTML_DUPLICATE_ATTRIBUTE, LEVEL_WARN, a.nameStart, { name: a.name, firstAt: dup.nameStart }, { kind: "remove", what: `the duplicate '${a.name}' attribute` });
     } else {
       this.currentAttrs.push(a);
     }
@@ -6686,12 +6684,12 @@ class LinterCtx {
           }
         }
         if (firstNonWs < 0) {
-          this.report(HTML_SELF_CLOSING_END_TAG, LEVEL_WARN, start, { tag: name });
+          this.report(HTML_SELF_CLOSING_END_TAG, LEVEL_WARN, start, { tag: name }, { kind: "rewrite", from: `</${name}/>`, to: `</${name}>` });
         } else {
-          this.report(HTML_ATTRIBUTES_ON_END_TAG, LEVEL_WARN, start, { tag: name });
+          this.report(HTML_ATTRIBUTES_ON_END_TAG, LEVEL_WARN, start, { tag: name }, { kind: "remove", what: `attributes from </${name}>` });
         }
       } else {
-        this.report(HTML_ATTRIBUTES_ON_END_TAG, LEVEL_WARN, start, { tag: name });
+        this.report(HTML_ATTRIBUTES_ON_END_TAG, LEVEL_WARN, start, { tag: name }, { kind: "remove", what: `attributes from </${name}>` });
       }
     }
     this.handleEndTag(name, start);
@@ -6724,14 +6722,15 @@ class LinterCtx {
     return this.currentNamespace() !== NS.html;
   }
   onend() {}
-  report(id, level, offset, info) {
+  report(id, level, offset, info, suggestion = null) {
     this.findingCount++;
     const { line, column } = offsetToLineCol(this.lineStarts, offset);
     this.onFinding({
       id,
       level,
       info,
-      location: { start: offset, end: offset + (info.tag?.length ?? 0), line, column }
+      location: { start: offset, end: offset + (info.tag?.length ?? 0), line, column },
+      suggestion
     });
   }
   currentNode() {
@@ -6840,17 +6839,11 @@ class LinterCtx {
     const ns = this.currentNamespace();
     if (ns === NS.html) {
       if (raw !== name) {
-        this.report(HTML_TAG_NAME_HAS_UPPERCASE, LEVEL_ERROR, start, {
-          raw,
-          lowercased: name
-        });
+        this.report(HTML_TAG_NAME_HAS_UPPERCASE, LEVEL_ERROR, start, { raw, lowercased: name }, { kind: "rewrite", from: `<${raw}>`, to: `<${name}>` });
       }
     } else if (ns === NS.svg) {
       if (raw !== raw.toLowerCase() && !this.svgCamelElements.has(raw)) {
-        this.report(HTML_SVG_TAG_WILL_LOWERCASE, LEVEL_ERROR, start, {
-          raw,
-          lowercased: name
-        });
+        this.report(HTML_SVG_TAG_WILL_LOWERCASE, LEVEL_ERROR, start, { raw, lowercased: name }, { kind: "rewrite", from: `<${raw}>`, to: `<${name}>` });
       }
     }
     const targetNs = ns !== NS.html ? ns : name === "svg" ? NS.svg : name === "math" ? NS.math : NS.html;
@@ -6858,20 +6851,14 @@ class LinterCtx {
       for (const a of this.currentAttrs) {
         const canonical = SVG_ATTR_LOWERCASE_TO_CAMEL.get(a.name);
         if (canonical && a.rawName !== canonical) {
-          this.report(HTML_SVG_ATTR_WILL_LOWERCASE, LEVEL_ERROR, a.nameStart, {
-            raw: a.rawName,
-            canonical
-          });
+          this.report(HTML_SVG_ATTR_WILL_LOWERCASE, LEVEL_ERROR, a.nameStart, { raw: a.rawName, canonical }, { kind: "rewrite", from: a.rawName, to: canonical });
         }
       }
     } else if (targetNs === NS.math) {
       for (const a of this.currentAttrs) {
         const canonical = MATHML_ATTR_LOWERCASE_TO_CAMEL.get(a.name);
         if (canonical && a.rawName !== canonical) {
-          this.report(HTML_MATHML_ATTR_WILL_LOWERCASE, LEVEL_ERROR, a.nameStart, {
-            raw: a.rawName,
-            canonical
-          });
+          this.report(HTML_MATHML_ATTR_WILL_LOWERCASE, LEVEL_ERROR, a.nameStart, { raw: a.rawName, canonical }, { kind: "rewrite", from: a.rawName, to: canonical });
         }
       }
     }
@@ -6986,10 +6973,7 @@ class LinterCtx {
     }
     if (name === "form") {
       if (this.openElementsHas("form") && !this.openElementsHas("template")) {
-        this.report(HTML_DUPLICATE_FORM, LEVEL_ERROR, start, {
-          tag: raw,
-          mode: this.insertionMode
-        });
+        this.report(HTML_DUPLICATE_FORM, LEVEL_ERROR, start, { tag: raw, mode: this.insertionMode }, { kind: "remove", what: "the inner <form>" });
         return;
       }
       if (this.hasInButtonScope("p"))
@@ -7551,10 +7535,7 @@ class LinterCtx {
       }
     }
     if (VOID_ELEMENTS.has(name)) {
-      this.report(HTML_VOID_ELEMENT_HAS_CLOSE_TAG, LEVEL_WARN, start, {
-        tag: name,
-        mode: this.insertionMode
-      });
+      this.report(HTML_VOID_ELEMENT_HAS_CLOSE_TAG, LEVEL_WARN, start, { tag: name, mode: this.insertionMode }, { kind: "remove", what: `the </${name}>` });
       return;
     }
     if (FORMATTING_ELEMENTS.has(name)) {
@@ -7691,7 +7672,89 @@ var init_htmllinter = __esm(() => {
   ]);
 });
 
+// tools/core/util/closest-name.js
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  const la = a.length;
+  const lb = b.length;
+  if (la === 0)
+    return lb;
+  if (lb === 0)
+    return la;
+  const prev2 = new Array(lb + 1);
+  const prev1 = new Array(lb + 1);
+  const curr = new Array(lb + 1);
+  for (let j = 0;j <= lb; j++)
+    prev1[j] = j;
+  for (let i = 1;i <= la; i++) {
+    curr[0] = i;
+    const ca = a.charCodeAt(i - 1);
+    for (let j = 1;j <= lb; j++) {
+      const cb = b.charCodeAt(j - 1);
+      const cost = ca === cb ? 0 : 1;
+      let v = Math.min(curr[j - 1] + 1, prev1[j] + 1, prev1[j - 1] + cost);
+      if (i > 1 && j > 1 && ca === b.charCodeAt(j - 2) && a.charCodeAt(i - 2) === cb) {
+        v = Math.min(v, prev2[j - 2] + 1);
+      }
+      curr[j] = v;
+    }
+    for (let j = 0;j <= lb; j++) {
+      prev2[j] = prev1[j];
+      prev1[j] = curr[j];
+    }
+  }
+  return prev1[lb];
+}
+function closestName(name, candidates, maxDistance = 2) {
+  if (!name)
+    return null;
+  const lower = name.toLowerCase();
+  let best = null;
+  let bestDist = maxDistance + 1;
+  for (const cand of candidates) {
+    if (cand === name)
+      return null;
+    if (cand.toLowerCase() === lower)
+      return cand;
+    const d = editDistance(name, cand);
+    if (d < bestDist) {
+      best = cand;
+      bestDist = d;
+    }
+  }
+  return bestDist <= maxDistance ? best : null;
+}
+
 // tools/core/lint-check.js
+function collectProtoMethodNames(proto) {
+  const out = [];
+  let cursor = proto;
+  while (cursor && cursor !== Object.prototype) {
+    for (const key of Object.getOwnPropertyNames(cursor)) {
+      if (key === "constructor")
+        continue;
+      out.push(key);
+    }
+    cursor = Object.getPrototypeOf(cursor);
+  }
+  return out;
+}
+function scopeKeysAlong(scope, mapKey) {
+  const out = [];
+  for (let cursor = scope;cursor; cursor = cursor.parent) {
+    const map = cursor[mapKey];
+    if (!map)
+      continue;
+    for (const key of Object.keys(map))
+      out.push(key);
+  }
+  return out;
+}
+function replaceNameSuggestion(name, candidates) {
+  const close = closestName(name, candidates);
+  return close ? { kind: "replace-name", from: name, to: close } : null;
+}
 function checkComponent(Comp, lx = new LintContext) {
   return lx.push({ componentName: Comp.name }, () => {
     const referencedAlters = new Set;
@@ -7717,7 +7780,7 @@ function checkView(lx, view, Comp, referencedAlters) {
 function checkHtmlStructure(lx, view) {
   if (typeof view.rawView !== "string" || !view.rawView)
     return;
-  lintHtml(view.rawView, (f) => lx.report(f.id, { ...f.info, location: f.location }, f.level), HTML_LINT_OPTS);
+  lintHtml(view.rawView, (f) => lx.report(f.id, { ...f.info, location: f.location }, f.level, f.suggestion ?? null), HTML_LINT_OPTS);
 }
 function checkParseIssues(lx, view) {
   const issues = view.ctx.parseIssues;
@@ -7727,12 +7790,19 @@ function checkParseIssues(lx, view) {
     const id = PARSE_ISSUE_KIND_TO_LINT_ID[kind];
     if (!id)
       continue;
-    lx.error(id, info);
-    const known = AT_PREFIX_HINT_KNOWN_BY_KIND[kind];
-    if (known && info.name?.startsWith("@")) {
-      const suggestion = info.name.slice(1);
-      if (known.has(suggestion))
-        lx.hint(MAYBE_DROP_AT_PREFIX, { ...info, suggestion });
+    const atPrefixKnown = AT_PREFIX_HINT_KNOWN_BY_KIND[kind];
+    const isAtPrefixedTypo = atPrefixKnown && info.name?.startsWith("@") && atPrefixKnown.has(info.name.slice(1));
+    let suggestion = null;
+    if (isAtPrefixedTypo) {
+      suggestion = { kind: "drop-prefix", from: info.name, to: info.name.slice(1) };
+    } else {
+      const candidates = PARSE_ISSUE_KIND_TO_KNOWN_NAMES[kind];
+      if (candidates)
+        suggestion = replaceNameSuggestion(info.name, candidates);
+    }
+    lx.error(id, info, suggestion);
+    if (isAtPrefixedTypo) {
+      lx.hint(MAYBE_DROP_AT_PREFIX, { ...info, suggestion: info.name.slice(1) }, { kind: "drop-prefix", from: info.name, to: info.name.slice(1) });
     }
   }
 }
@@ -7745,11 +7815,7 @@ function checkMacroCallArgs(lx, view, Comp) {
     const { defaults } = macro;
     for (const argName in macroNode.attrs) {
       if (!(argName in defaults)) {
-        lx.error(UNKNOWN_MACRO_ARG, {
-          name: argName,
-          macroName: macroNode.name,
-          tag: `x:${macroNode.name}`
-        });
+        lx.error(UNKNOWN_MACRO_ARG, { name: argName, macroName: macroNode.name, tag: `x:${macroNode.name}` }, replaceNameSuggestion(argName, Object.keys(defaults)));
       }
     }
   }
@@ -7771,8 +7837,9 @@ function walkForRenderIt(lx, node, loopDepth) {
     return;
   switch (node.constructor.name) {
     case "RenderItNode":
-      if (loopDepth === 0)
-        lx.error(RENDER_IT_OUTSIDE_OF_LOOP, { node });
+      if (loopDepth === 0) {
+        lx.error(RENDER_IT_OUTSIDE_OF_LOOP, { node }, { kind: "wrap", from: "<x render-it>", to: "<x render-each>" });
+      }
       return;
     case "EachNode":
       walkForRenderIt(lx, node.node, loopDepth + 1);
@@ -7802,13 +7869,14 @@ function checkEventModifiers(lx, view) {
       const modWrappers = MOD_WRAPPERS_BY_EVENT[name] ?? NO_WRAPPERS;
       for (const modifier of modifiers) {
         if (modWrappers[modifier] === undefined) {
+          const close = closestName(modifier, Object.keys(modWrappers));
           lx.error(UNKNOWN_EVENT_MODIFIER, {
             name,
             modifier,
             handler,
             event,
             originAttr: `@on.${name}+${modifiers.join("+")}`
-          });
+          }, close ? { kind: "replace-name", from: `+${modifier}`, to: `+${close}` } : null);
         }
       }
     }
@@ -7854,42 +7922,22 @@ function checkEventHandlersHaveImpls(lx, Comp, referencedInputs) {
           const originAttr = `@on.${eventName}`;
           if (hvName === "InputHandlerNameVal") {
             referencedInputs?.add(handlerVal.name);
-            if (input[handlerVal.name] === undefined) {
-              lx.error(INPUT_HANDLER_NOT_IMPLEMENTED, {
-                name: handlerVal.name,
-                handler,
-                event,
-                eventName,
-                originAttr
-              });
-              if (proto[handlerVal.name] !== undefined) {
-                lx.hint(INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER, {
-                  name: handlerVal.name,
-                  handler,
-                  event,
-                  eventName,
-                  originAttr
-                });
+            const { name } = handlerVal;
+            if (input[name] === undefined) {
+              const isMethodFix = proto[name] !== undefined;
+              lx.error(INPUT_HANDLER_NOT_IMPLEMENTED, { name, handler, event, eventName, originAttr }, isMethodFix ? { kind: "add-prefix", from: name, to: `.${name}` } : replaceNameSuggestion(name, Object.keys(input)));
+              if (isMethodFix) {
+                lx.hint(INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER, { name, handler, event, eventName, originAttr }, { kind: "add-prefix", from: name, to: `.${name}` });
               }
             }
           } else if (hvName === "RawFieldVal") {
             referencedInputs?.add(handlerVal.name);
-            if (proto[handlerVal.name] === undefined) {
-              lx.error(INPUT_HANDLER_METHOD_NOT_IMPLEMENTED, {
-                name: handlerVal.name,
-                handler,
-                event,
-                eventName,
-                originAttr
-              });
-              if (input[handlerVal.name] !== undefined) {
-                lx.hint(INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD, {
-                  name: handlerVal.name,
-                  handler,
-                  event,
-                  eventName,
-                  originAttr
-                });
+            const { name } = handlerVal;
+            if (proto[name] === undefined) {
+              const isInputFix = input[name] !== undefined;
+              lx.error(INPUT_HANDLER_METHOD_NOT_IMPLEMENTED, { name, handler, event, eventName, originAttr }, isInputFix ? { kind: "drop-prefix", from: `.${name}`, to: name } : replaceNameSuggestion(name, collectProtoMethodNames(proto)));
+              if (isInputFix) {
+                lx.hint(INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD, { name, handler, event, eventName, originAttr }, { kind: "drop-prefix", from: `.${name}`, to: name });
               }
             }
           }
@@ -7903,22 +7951,23 @@ function checkConsistentAttrVal(lx, val, fields, proto, scope, alter, referenced
   if (valName === "FieldVal" || valName === "RawFieldVal") {
     const { name } = val;
     if (fields[name] === undefined && proto[name] === undefined) {
-      lx.error(FIELD_VAL_NOT_DEFINED, { ...errCtx, val, name });
+      const candidates = [...Object.keys(fields), ...collectProtoMethodNames(proto)];
+      lx.error(FIELD_VAL_NOT_DEFINED, { ...errCtx, val, name }, replaceNameSuggestion(name, candidates));
     }
   } else if (valName === "SeqAccessVal") {
     checkConsistentAttrVal(lx, val.seqVal, fields, proto, scope, alter, referencedAlters, skipNameVal, errCtx);
     checkConsistentAttrVal(lx, val.keyVal, fields, proto, scope, alter, referencedAlters, skipNameVal, errCtx);
   } else if (valName === "RequestVal") {
     if (scope.lookupRequest(val.name) === null) {
-      lx.error(UNKNOWN_REQUEST_NAME, { ...errCtx, name: val.name });
+      lx.error(UNKNOWN_REQUEST_NAME, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, scopeKeysAlong(scope, "reqsByName")));
     }
   } else if (valName === "TypeVal") {
     if (scope.lookupComponent(val.name) === null) {
-      lx.error(UNKNOWN_COMPONENT_NAME, { ...errCtx, name: val.name });
+      lx.error(UNKNOWN_COMPONENT_NAME, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, scopeKeysAlong(scope, "byName")));
     }
   } else if (valName === "NameVal") {
     if (!skipNameVal && !isKnownHandlerName(val.name)) {
-      lx.error(UNKNOWN_HANDLER_ARG_NAME, { ...errCtx, name: val.name });
+      lx.error(UNKNOWN_HANDLER_ARG_NAME, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, KNOWN_HANDLER_NAMES));
     }
   } else if (valName === "StrTplVal") {
     for (const subVal of val.vals) {
@@ -7927,7 +7976,7 @@ function checkConsistentAttrVal(lx, val, fields, proto, scope, alter, referenced
   } else if (valName === "AlterHandlerNameVal") {
     referencedAlters?.add(val.name);
     if (alter[val.name] === undefined) {
-      lx.error(ALT_HANDLER_NOT_DEFINED, { ...errCtx, name: val.name });
+      lx.error(ALT_HANDLER_NOT_DEFINED, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, Object.keys(alter)));
     }
   } else if (valName !== "ConstVal" && valName !== "BindVal" && valName !== "DynVal") {
     console.log(val);
@@ -8064,23 +8113,37 @@ class LintContext {
       this.frame = prev;
     }
   }
-  error(id, info) {
-    this.report(id, info, LEVEL_ERROR2);
+  error(id, info, suggestion = null) {
+    this.report(id, info, LEVEL_ERROR2, suggestion);
   }
-  warn(id, info) {
-    this.report(id, info, LEVEL_WARN2);
+  warn(id, info, suggestion = null) {
+    this.report(id, info, LEVEL_WARN2, suggestion);
   }
-  hint(id, info) {
-    this.report(id, info, LEVEL_HINT);
+  hint(id, info, suggestion = null) {
+    this.report(id, info, LEVEL_HINT, suggestion);
   }
-  report(id, info = {}, level = LEVEL_ERROR2) {
-    this.reports.push({ id, info, level, context: { ...this.frame } });
+  report(id, info = {}, level = LEVEL_ERROR2, suggestion = null) {
+    this.reports.push({ id, info, level, context: { ...this.frame }, suggestion });
   }
 }
-var ALT_HANDLER_NOT_DEFINED = "ALT_HANDLER_NOT_DEFINED", ALT_HANDLER_NOT_REFERENCED = "ALT_HANDLER_NOT_REFERENCED", RENDER_IT_OUTSIDE_OF_LOOP = "RENDER_IT_OUTSIDE_OF_LOOP", UNKNOWN_EVENT_MODIFIER = "UNKNOWN_EVENT_MODIFIER", UNKNOWN_HANDLER_ARG_NAME = "UNKNOWN_HANDLER_ARG_NAME", INPUT_HANDLER_NOT_IMPLEMENTED = "INPUT_HANDLER_NOT_IMPLEMENTED", INPUT_HANDLER_NOT_REFERENCED = "INPUT_HANDLER_NOT_REFERENCED", INPUT_HANDLER_METHOD_NOT_IMPLEMENTED = "INPUT_HANDLER_METHOD_NOT_IMPLEMENTED", INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD = "INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD", INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER = "INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER", FIELD_VAL_NOT_DEFINED = "FIELD_VAL_NOT_DEFINED", DUPLICATE_ATTR_DEFINITION = "DUPLICATE_ATTR_DEFINITION", IF_NO_BRANCH_SET = "IF_NO_BRANCH_SET", UNKNOWN_REQUEST_NAME = "UNKNOWN_REQUEST_NAME", UNKNOWN_COMPONENT_NAME = "UNKNOWN_COMPONENT_NAME", UNKNOWN_MACRO_ARG = "UNKNOWN_MACRO_ARG", UNKNOWN_DIRECTIVE = "UNKNOWN_DIRECTIVE", UNKNOWN_X_OP = "UNKNOWN_X_OP", UNKNOWN_X_ATTR = "UNKNOWN_X_ATTR", MAYBE_DROP_AT_PREFIX = "MAYBE_DROP_AT_PREFIX", BAD_VALUE = "BAD_VALUE", PARSE_ISSUE_KIND_TO_LINT_ID, X_KNOWN_OP_NAMES, X_KNOWN_ATTR_NAMES, AT_PREFIX_HINT_KNOWN_BY_KIND, LEVEL_WARN2 = "warn", LEVEL_ERROR2 = "error", LEVEL_HINT = "hint", HTML_LINT_OPTS, NO_WRAPPERS, KNOWN_HANDLER_NAMES, NODE_KIND_TO_CTX, LintParseContext;
+var KNOWN_DIRECTIVE_NAMES, ALT_HANDLER_NOT_DEFINED = "ALT_HANDLER_NOT_DEFINED", ALT_HANDLER_NOT_REFERENCED = "ALT_HANDLER_NOT_REFERENCED", RENDER_IT_OUTSIDE_OF_LOOP = "RENDER_IT_OUTSIDE_OF_LOOP", UNKNOWN_EVENT_MODIFIER = "UNKNOWN_EVENT_MODIFIER", UNKNOWN_HANDLER_ARG_NAME = "UNKNOWN_HANDLER_ARG_NAME", INPUT_HANDLER_NOT_IMPLEMENTED = "INPUT_HANDLER_NOT_IMPLEMENTED", INPUT_HANDLER_NOT_REFERENCED = "INPUT_HANDLER_NOT_REFERENCED", INPUT_HANDLER_METHOD_NOT_IMPLEMENTED = "INPUT_HANDLER_METHOD_NOT_IMPLEMENTED", INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD = "INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD", INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER = "INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER", FIELD_VAL_NOT_DEFINED = "FIELD_VAL_NOT_DEFINED", DUPLICATE_ATTR_DEFINITION = "DUPLICATE_ATTR_DEFINITION", IF_NO_BRANCH_SET = "IF_NO_BRANCH_SET", UNKNOWN_REQUEST_NAME = "UNKNOWN_REQUEST_NAME", UNKNOWN_COMPONENT_NAME = "UNKNOWN_COMPONENT_NAME", UNKNOWN_MACRO_ARG = "UNKNOWN_MACRO_ARG", UNKNOWN_DIRECTIVE = "UNKNOWN_DIRECTIVE", UNKNOWN_X_OP = "UNKNOWN_X_OP", UNKNOWN_X_ATTR = "UNKNOWN_X_ATTR", MAYBE_DROP_AT_PREFIX = "MAYBE_DROP_AT_PREFIX", BAD_VALUE = "BAD_VALUE", PARSE_ISSUE_KIND_TO_LINT_ID, X_KNOWN_OP_NAMES, X_KNOWN_ATTR_NAMES, AT_PREFIX_HINT_KNOWN_BY_KIND, LEVEL_WARN2 = "warn", LEVEL_ERROR2 = "error", LEVEL_HINT = "hint", PARSE_ISSUE_KIND_TO_KNOWN_NAMES, HTML_LINT_OPTS, NO_WRAPPERS, KNOWN_HANDLER_NAMES, NODE_KIND_TO_CTX, LintParseContext;
 var init_lint_check = __esm(() => {
   init_anode();
   init_htmllinter();
+  KNOWN_DIRECTIVE_NAMES = new Set([
+    "dangerouslysetinnerhtml",
+    "slot",
+    "push-view",
+    "text",
+    "show",
+    "hide",
+    "each",
+    "enrich-with",
+    "when",
+    "loop-with",
+    "then",
+    "else"
+  ]);
   PARSE_ISSUE_KIND_TO_LINT_ID = {
     "unknown-directive": UNKNOWN_DIRECTIVE,
     "unknown-x-op": UNKNOWN_X_OP,
@@ -8101,6 +8164,11 @@ var init_lint_check = __esm(() => {
     "unknown-x-op": X_KNOWN_OP_NAMES,
     "unknown-x-attr": X_KNOWN_ATTR_NAMES
   };
+  PARSE_ISSUE_KIND_TO_KNOWN_NAMES = {
+    "unknown-directive": KNOWN_DIRECTIVE_NAMES,
+    "unknown-x-op": X_KNOWN_OP_NAMES,
+    "unknown-x-attr": X_KNOWN_ATTR_NAMES
+  };
   HTML_LINT_OPTS = {
     fragmentContext: "template",
     transparentTagPrefixes: ["x"]
@@ -14268,7 +14336,6 @@ GLOBAL FLAGS
   -o, --output <file>        Write to <file> instead of stdout.
       --pretty               Pretty-print HTML (md/html formats) via
                              prettier; JSON formatter uses indent 2.
-                             Requires \`prettier\` to be installed.
   -h, --help                 Show this help.
       --module <path>        Alternative to first-positional module path.
 
@@ -14279,9 +14346,6 @@ EXIT CODES
   3   render crash
   4   test failures
 
-ENVIRONMENT
-  \`prettier\` is an optional peer dep, only used by --pretty.
-
 EXAMPLES
   # Inspect a module
   tutuca ./src/components.js info
@@ -14456,7 +14520,7 @@ function fmtEventSuffix(info) {
 function lintIdToMessage(id, info) {
   switch (id) {
     case "RENDER_IT_OUTSIDE_OF_LOOP":
-      return "render-it used outside of a loop";
+      return "<x render-it> used outside of a loop";
     case "UNKNOWN_EVENT_MODIFIER": {
       const mods = info.handler?.modifiers ?? [info.modifier];
       const written = `@on.${info.name}+${mods.join("+")}`;
@@ -14467,13 +14531,13 @@ function lintIdToMessage(id, info) {
     case "INPUT_HANDLER_NOT_IMPLEMENTED":
       return `Input handler '${info.name}' is not implemented${fmtEventSuffix(info)}`;
     case "INPUT_HANDLER_NOT_REFERENCED":
-      return `Input handler '${info.name}' is defined but not referenced`;
+      return `Input handler '${info.name}' is defined but never used — remove it or wire it to an @on.* event`;
     case "INPUT_HANDLER_METHOD_NOT_IMPLEMENTED":
       return `Method '.${info.name}' is not implemented${fmtEventSuffix(info)}`;
     case "INPUT_HANDLER_FOR_INPUT_HANDLER_METHOD":
-      return `'${info.name}' exists as input handler — use without '.' prefix${fmtEventSuffix(info)}`;
+      return `'.${info.name}' is a method reference, but '${info.name}' is defined as an input handler${fmtEventSuffix(info)}`;
     case "INPUT_HANDLER_METHOD_FOR_INPUT_HANDLER":
-      return `'${info.name}' exists as method — use with '.' prefix${fmtEventSuffix(info)}`;
+      return `'${info.name}' is an input handler reference, but '${info.name}' is defined as a method${fmtEventSuffix(info)}`;
     case "FIELD_VAL_NOT_DEFINED":
       return `Field '.${info.name}' is not defined${fmtOriginSuffix(info)}`;
     case "DUPLICATE_ATTR_DEFINITION": {
@@ -14482,7 +14546,7 @@ function lintIdToMessage(id, info) {
       return `Attribute '${info.name}' is set ${info.sources?.length ?? "multiple"} times${sources}${tag}`;
     }
     case "IF_NO_BRANCH_SET":
-      return `'@if.${info.attr}' has no '@then' or '@else' branch — at least one must be set${fmtTagSuffix(info)}`;
+      return `'@if.${info.attr}' has no '@then' or '@else' branch — add '@then="…"' or '@else="…"' (or both)${fmtTagSuffix(info)}`;
     case "UNKNOWN_REQUEST_NAME":
       return `Unknown request '!${info.name}'${fmtOriginSuffix(info)}`;
     case "UNKNOWN_COMPONENT_NAME":
@@ -14490,7 +14554,7 @@ function lintIdToMessage(id, info) {
     case "ALT_HANDLER_NOT_DEFINED":
       return `Alter handler '${info.name}' is not defined${fmtOriginSuffix(info)}`;
     case "ALT_HANDLER_NOT_REFERENCED":
-      return `Alter handler '${info.name}' is defined but not referenced`;
+      return `Alter handler '${info.name}' is defined but never used — remove it or reference it from @when, @enrich-with, or @loop-with`;
     case "UNKNOWN_MACRO_ARG":
       return `Argument '${info.name}' is not declared in macro '${info.macroName}'`;
     case "UNKNOWN_DIRECTIVE":
@@ -14501,7 +14565,7 @@ function lintIdToMessage(id, info) {
       return `Unknown attribute '${info.name}=${JSON.stringify(info.value)}' on <x ${info.op}>${fmtTagSuffix(info)}`;
     case "MAYBE_DROP_AT_PREFIX": {
       const written = info.value !== undefined ? `${info.name}=${JSON.stringify(info.value)}` : info.name;
-      return `Did you mean '${info.suggestion}'? Drop the '@' from '${written}' on <x>.`;
+      return `'${written}' on <x> looks like a directive but is actually an x op/attr written with a leading '@'`;
     }
     case "BAD_VALUE":
       return `${badValueMessage(info)}${fmtTagSuffix(info)}`;
@@ -14510,7 +14574,7 @@ function lintIdToMessage(id, info) {
     case "HTML_SVG_TAG_WILL_LOWERCASE":
       return `SVG tag <${info.raw}> is not in the WHATWG case-correction list — will be lowercased to <${info.lowercased}>${fmtLocationSuffix(info)}`;
     case "HTML_TAG_NOT_ALLOWED_IN_PARENT":
-      return `<${info.tag}> not allowed under <${info.parent ?? "?"}> in ${info.mode} (action: ${info.action})${fmtLocationSuffix(info)}`;
+      return `<${info.tag}> not allowed under <${info.parent ?? "?"}> in ${info.mode} — ${htmlActionPhrase(info.action, info.tag, info.parent)}${fmtLocationSuffix(info)}`;
     case "HTML_TEXT_NOT_ALLOWED_IN_PARENT":
       return `Non-whitespace text not allowed in ${info.mode}: ${JSON.stringify(info.snippet)}${fmtLocationSuffix(info)}`;
     case "HTML_VOID_ELEMENT_HAS_CLOSE_TAG":
@@ -14547,11 +14611,47 @@ function lintIdToMessage(id, info) {
       return id;
   }
 }
+function suggestionToMessage(suggestion) {
+  if (!suggestion)
+    return null;
+  switch (suggestion.kind) {
+    case "replace-name":
+      return `did you mean '${suggestion.to}'?`;
+    case "drop-prefix":
+      return `did you mean '${suggestion.to}'? (drop the leading '${suggestion.from.slice(0, suggestion.from.length - suggestion.to.length)}')`;
+    case "add-prefix":
+      return `did you mean '${suggestion.to}'? (add the leading '${suggestion.to.slice(0, suggestion.to.length - suggestion.from.length)}')`;
+    case "remove":
+      return `remove ${suggestion.what}`;
+    case "rewrite":
+      return `use '${suggestion.to}' instead of '${suggestion.from}'`;
+    case "wrap":
+      return `wrap it in ${suggestion.to}`;
+    default:
+      return null;
+  }
+}
 function fmtLocationSuffix(info) {
   const loc = info?.location;
   if (!loc)
     return "";
-  return ` at L${loc.line}:C${loc.column}`;
+  return ` at line ${loc.line}, col ${loc.column}`;
+}
+function htmlActionPhrase(action, tag, parent) {
+  switch (action) {
+    case "ignored":
+      return `the parser will drop this <${tag}>`;
+    case "drop":
+      return `the parser will drop this <${tag}>`;
+    case "auto-close-implicit":
+      return `the parser will close <${parent ?? "?"}> first, then place <${tag}> as a sibling`;
+    case "foster-parent":
+      return `the parser will move <${tag}> outside <${parent ?? "?"}> (foster-parenting)`;
+    case "foreign-breakout":
+      return `the parser will exit foreign content and re-process <${tag}> in HTML mode`;
+    default:
+      return `parser action: ${action}`;
+  }
 }
 
 // tools/format/cli.js
@@ -14636,7 +14736,9 @@ function fmtLintReport(rep) {
     for (const f of c.findings) {
       const tag = f.level.toUpperCase();
       const view = f.context?.viewName ? ` [view=${f.context.viewName}]` : "";
-      lines.push(`  [${tag}]${view} ${lintIdToMessage(f.id, f.info)}`);
+      const tail = suggestionToMessage(f.suggestion);
+      const suffix = tail ? ` — ${tail}` : "";
+      lines.push(`  [${tag}]${view} ${lintIdToMessage(f.id, f.info)}${suffix}`);
     }
   }
   lines.push("");
@@ -14817,7 +14919,9 @@ function fmtLintReport2(rep) {
     }
     for (const f of c.findings) {
       const view = f.context?.viewName ? ` _(view: \`${f.context.viewName}\`)_` : "";
-      lines.push(`- **${f.level.toUpperCase()}** ${lintIdToMessage(f.id, f.info)}${view}`);
+      const tail = suggestionToMessage(f.suggestion);
+      const suffix = tail ? ` — ${tail}` : "";
+      lines.push(`- **${f.level.toUpperCase()}** ${lintIdToMessage(f.id, f.info)}${suffix}${view}`);
     }
     lines.push("");
   }