tutuca 0.9.69 → 0.9.71

package/dist/tutuca-cli.js

@@ -8763,9 +8763,10 @@ function checkParseIssues(lx, view) {
   if (!issues)
     return;
   for (const { kind, info } of issues) {
-    const id = PARSE_ISSUE_KIND_TO_LINT_ID[kind];
-    if (!id)
+    const rule = PARSE_ISSUES[kind];
+    if (!rule)
       continue;
+    const id = rule.id;
     if (kind === "bad-value") {
       const detected = classifyBadValue(info.value);
       if (detected) {
@@ -8773,15 +8774,13 @@ function checkParseIssues(lx, view) {
         continue;
       }
     }
-    const atPrefixKnown = AT_PREFIX_HINT_KNOWN_BY_KIND[kind];
+    const atPrefixKnown = rule.atPrefix;
     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);
+    } else if (rule.candidates) {
+      suggestion = replaceNameSuggestion(info.name, rule.candidates);
     }
     lx.error(id, info, suggestion);
     if (isAtPrefixedTypo) {
@@ -8930,70 +8929,15 @@ function checkEventHandlersHaveImpls(lx, Comp, referencedInputs) {
     });
   }
 }
+function reportUnknownName(lx, code, name, candidates, info) {
+  lx.error(code, { ...info, name }, replaceNameSuggestion(name, candidates));
+}
 function checkConsistentAttrVal(lx, val, env, skipNameVal = false, errCtx = null) {
-  const { fields, proto, scope, alter } = env;
-  const valName = val?.constructor.name;
-  if (valName === "FieldVal") {
-    const { name } = val;
-    if (fields[name] === undefined) {
-      if (proto[name] !== undefined) {
-        lx.error(FIELD_VAL_IS_METHOD, { ...errCtx, val, name }, { kind: "rewrite", from: `.${name}`, to: `$${name}` });
-      } else {
-        lx.error(FIELD_VAL_NOT_DEFINED, { ...errCtx, val, name }, replaceNameSuggestion(name, Object.keys(fields)));
-      }
-    }
-  } else if (valName === "MethodVal") {
-    const { name } = val;
-    if (proto[name] === undefined) {
-      if (fields[name] !== undefined) {
-        lx.error(METHOD_VAL_IS_FIELD, { ...errCtx, val, name }, { kind: "rewrite", from: `$${name}`, to: `.${name}` });
-      } else {
-        lx.error(METHOD_VAL_NOT_DEFINED, { ...errCtx, val, name }, replaceNameSuggestion(name, collectProtoMethodNames(proto)));
-      }
-    }
-  } else if (valName === "SeqAccessVal") {
-    checkConsistentAttrVal(lx, val.seqVal, env, skipNameVal, errCtx);
-    checkConsistentAttrVal(lx, val.keyVal, env, skipNameVal, errCtx);
-  } else if (valName === "RequestVal") {
-    if (scope.lookupRequest(val.name) === null) {
-      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 }, 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 }, replaceNameSuggestion(val.name, KNOWN_HANDLER_NAMES));
-    }
-  } else if (valName === "StrTplVal") {
-    const vs = val.vals;
-    const literal = val.toLiteralSource();
-    if (literal !== null) {
-      lx.hint(PLACEHOLDERLESS_TEMPLATE_STRING, { ...errCtx, literal }, { kind: "rewrite", from: `$${literal}`, to: literal });
-    } else if (vs.length === 1) {
-      const simpler = String(vs[0]);
-      lx.warn(REDUNDANT_TEMPLATE_STRING, { ...errCtx, simpler }, { kind: "rewrite", from: `$'{${simpler}}'`, to: simpler });
-    }
-    for (const subVal of vs) {
-      checkConsistentAttrVal(lx, subVal, env, skipNameVal, errCtx);
-    }
-  } else if (valName === "HandlerNameVal") {
-    env.referencedAlters?.add(val.name);
-    if (alter[val.name] === undefined) {
-      lx.error(ALT_HANDLER_NOT_DEFINED, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, Object.keys(alter)));
-    }
-  } else if (valName === "PredicateVal") {
-    for (const arg of val.args)
-      checkConsistentAttrVal(lx, arg, env, skipNameVal, errCtx);
-  } else if (valName === "DynVal") {
-    env.referencedDynamics?.add(val.name);
-    if (env.dynamicMap[val.name] === undefined) {
-      lx.error(DYN_VAL_NOT_DEFINED, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, Object.keys(env.dynamicMap)));
-    }
-  } else if (valName !== "ConstVal" && valName !== "BindVal") {
-    console.log(val);
-  }
+  const check = ATTR_VAL_CHECKERS[val?.constructor.name];
+  if (check === undefined)
+    return;
+  const recurse = (sub) => checkConsistentAttrVal(lx, sub, env, skipNameVal, errCtx);
+  check({ lx, val, env, errCtx, skipNameVal, recurse });
 }
 function nodeCtxForNode(nodeKind) {
   return NODE_KIND_TO_CTX[nodeKind] ?? null;
@@ -9016,6 +8960,23 @@ function attrOriginAttr(attr) {
     return "@dangerouslysetinnerhtml";
   return `:${attr.name}`;
 }
+function checkHostBareDirectives(lx, attrs, tag, isMacroCall) {
+  if (isMacroCall || !attrs)
+    return;
+  const kind = attrs.constructor.name;
+  let names;
+  if (kind === "ConstAttrs")
+    names = Object.keys(attrs.items);
+  else if (kind === "DynAttrs")
+    names = attrs.items.map((a) => a?.name);
+  else
+    return;
+  for (const name of names) {
+    if (HOST_DIRECTIVE_ONLY_NAMES.has(name)) {
+      lx.hint(MAYBE_ADD_AT_PREFIX, { name, tag, suggestion: `@${name}` }, { kind: "add-prefix", from: name, to: `@${name}` });
+    }
+  }
+}
 function checkConsistentAttrs(lx, Comp, referencedAlters, referencedDynamics) {
   const { views } = Comp;
   const env = mkAttrValEnv(Comp, referencedAlters, referencedDynamics);
@@ -9024,6 +8985,7 @@ function checkConsistentAttrs(lx, Comp, referencedAlters, referencedDynamics) {
       const view = views[viewName];
       for (const entry of view.ctx.attrs) {
         const { attrs, wrapperAttrs, textChild, isMacroCall, tag } = entry;
+        checkHostBareDirectives(lx, attrs, tag, isMacroCall);
         if (attrs?.constructor.name === "DynAttrs") {
           const sourcesByName = new Map;
           for (const attr of attrs.items) {
@@ -9200,7 +9162,7 @@ class LintContext {
     this.reports.push({ id, info, level, context: { ...this.frame }, suggestion });
   }
 }
-var KNOWN_COMPONENT_SPEC_KEYS, EMPTY_SET2, KNOWN_DIRECTIVE_NAMES, ALT_HANDLER_NOT_DEFINED = "ALT_HANDLER_NOT_DEFINED", ALT_HANDLER_NOT_REFERENCED = "ALT_HANDLER_NOT_REFERENCED", DYN_VAL_NOT_DEFINED = "DYN_VAL_NOT_DEFINED", DYN_ALIAS_NOT_REFERENCED = "DYN_ALIAS_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", FIELD_VAL_IS_METHOD = "FIELD_VAL_IS_METHOD", METHOD_VAL_NOT_DEFINED = "METHOD_VAL_NOT_DEFINED", METHOD_VAL_IS_FIELD = "METHOD_VAL_IS_FIELD", 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", UNSUPPORTED_EXPR_SYNTAX = "UNSUPPORTED_EXPR_SYNTAX", REDUNDANT_TEMPLATE_STRING = "REDUNDANT_TEMPLATE_STRING", PLACEHOLDERLESS_TEMPLATE_STRING = "PLACEHOLDERLESS_TEMPLATE_STRING", UNKNOWN_COMPONENT_SPEC_KEY = "UNKNOWN_COMPONENT_SPEC_KEY", COMP_FIELD_BAD_SHAPE = "COMP_FIELD_BAD_SHAPE", 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, UNSUPPORTED_EXPR_GUIDANCE, HTML_LINT_OPTS, NO_WRAPPERS, KNOWN_HANDLER_NAMES, NODE_KIND_TO_CTX, LintParseContext;
+var KNOWN_COMPONENT_SPEC_KEYS, EMPTY_SET2, KNOWN_DIRECTIVE_NAMES, ALT_HANDLER_NOT_DEFINED = "ALT_HANDLER_NOT_DEFINED", ALT_HANDLER_NOT_REFERENCED = "ALT_HANDLER_NOT_REFERENCED", DYN_VAL_NOT_DEFINED = "DYN_VAL_NOT_DEFINED", DYN_ALIAS_NOT_REFERENCED = "DYN_ALIAS_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", FIELD_VAL_IS_METHOD = "FIELD_VAL_IS_METHOD", METHOD_VAL_NOT_DEFINED = "METHOD_VAL_NOT_DEFINED", METHOD_VAL_IS_FIELD = "METHOD_VAL_IS_FIELD", 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", MAYBE_ADD_AT_PREFIX = "MAYBE_ADD_AT_PREFIX", BAD_VALUE = "BAD_VALUE", UNSUPPORTED_EXPR_SYNTAX = "UNSUPPORTED_EXPR_SYNTAX", REDUNDANT_TEMPLATE_STRING = "REDUNDANT_TEMPLATE_STRING", PLACEHOLDERLESS_TEMPLATE_STRING = "PLACEHOLDERLESS_TEMPLATE_STRING", UNKNOWN_COMPONENT_SPEC_KEY = "UNKNOWN_COMPONENT_SPEC_KEY", COMP_FIELD_BAD_SHAPE = "COMP_FIELD_BAD_SHAPE", X_KNOWN_OP_NAMES, X_KNOWN_ATTR_NAMES, HOST_DIRECTIVE_ONLY_NAMES, LEVEL_WARN2 = "warn", LEVEL_ERROR2 = "error", LEVEL_HINT = "hint", PARSE_ISSUES, UNSUPPORTED_EXPR_GUIDANCE, HTML_LINT_OPTS, NO_WRAPPERS, KNOWN_HANDLER_NAMES, fixTo = (from, to) => ({ kind: "rewrite", from, to }), ATTR_VAL_CHECKERS, NODE_KIND_TO_CTX, LintParseContext;
 var init_lint_check = __esm(() => {
   init_anode();
   init_htmllinter();
@@ -9220,12 +9182,6 @@ var init_lint_check = __esm(() => {
     "then",
     "else"
   ]);
-  PARSE_ISSUE_KIND_TO_LINT_ID = {
-    "unknown-directive": UNKNOWN_DIRECTIVE,
-    "unknown-x-op": UNKNOWN_X_OP,
-    "unknown-x-attr": UNKNOWN_X_ATTR,
-    "bad-value": BAD_VALUE
-  };
   X_KNOWN_OP_NAMES = new Set([
     "slot",
     "text",
@@ -9236,14 +9192,16 @@ var init_lint_check = __esm(() => {
     "hide"
   ]);
   X_KNOWN_ATTR_NAMES = new Set(["as", "when", "loop-with", "show", "hide"]);
-  AT_PREFIX_HINT_KNOWN_BY_KIND = {
-    "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
+  HOST_DIRECTIVE_ONLY_NAMES = new Set(["when", "enrich-with", "loop-with", "show", "hide"]);
+  PARSE_ISSUES = {
+    "unknown-directive": { id: UNKNOWN_DIRECTIVE, candidates: KNOWN_DIRECTIVE_NAMES },
+    "unknown-x-op": { id: UNKNOWN_X_OP, candidates: X_KNOWN_OP_NAMES, atPrefix: X_KNOWN_OP_NAMES },
+    "unknown-x-attr": {
+      id: UNKNOWN_X_ATTR,
+      candidates: X_KNOWN_ATTR_NAMES,
+      atPrefix: X_KNOWN_ATTR_NAMES
+    },
+    "bad-value": { id: BAD_VALUE }
   };
   UNSUPPORTED_EXPR_GUIDANCE = {
     "legacy-template": "Unquoted {...} string templates are no longer supported. Wrap the value in $'...', e.g. $'flex {.color}'.",
@@ -9277,6 +9235,73 @@ var init_lint_check = __esm(() => {
     "ctx",
     "dragInfo"
   ]);
+  ATTR_VAL_CHECKERS = {
+    FieldVal({ lx, val, env, errCtx }) {
+      const { fields, proto } = env;
+      const { name } = val;
+      if (fields[name] !== undefined)
+        return;
+      if (proto[name] !== undefined)
+        lx.error(FIELD_VAL_IS_METHOD, { ...errCtx, val, name }, fixTo(`.${name}`, `$${name}`));
+      else
+        reportUnknownName(lx, FIELD_VAL_NOT_DEFINED, name, Object.keys(fields), { ...errCtx, val });
+    },
+    MethodVal({ lx, val, env, errCtx }) {
+      const { fields, proto } = env;
+      const { name } = val;
+      if (proto[name] !== undefined)
+        return;
+      if (fields[name] !== undefined)
+        lx.error(METHOD_VAL_IS_FIELD, { ...errCtx, val, name }, fixTo(`$${name}`, `.${name}`));
+      else
+        reportUnknownName(lx, METHOD_VAL_NOT_DEFINED, name, collectProtoMethodNames(proto), {
+          ...errCtx,
+          val
+        });
+    },
+    SeqAccessVal({ val, recurse }) {
+      recurse(val.seqVal);
+      recurse(val.keyVal);
+    },
+    RequestVal({ lx, val, env, errCtx }) {
+      if (env.scope.lookupRequest(val.name) === null)
+        reportUnknownName(lx, UNKNOWN_REQUEST_NAME, val.name, scopeKeysAlong(env.scope, "reqsByName"), errCtx);
+    },
+    TypeVal({ lx, val, env, errCtx }) {
+      if (env.scope.lookupComponent(val.name) === null)
+        reportUnknownName(lx, UNKNOWN_COMPONENT_NAME, val.name, scopeKeysAlong(env.scope, "byName"), errCtx);
+    },
+    NameVal({ lx, val, errCtx, skipNameVal }) {
+      if (!skipNameVal && !isKnownHandlerName(val.name))
+        reportUnknownName(lx, UNKNOWN_HANDLER_ARG_NAME, val.name, KNOWN_HANDLER_NAMES, errCtx);
+    },
+    StrTplVal({ lx, val, errCtx, recurse }) {
+      const vs = val.vals;
+      const literal = val.toLiteralSource();
+      if (literal !== null) {
+        lx.hint(PLACEHOLDERLESS_TEMPLATE_STRING, { ...errCtx, literal }, fixTo(`$${literal}`, literal));
+      } else if (vs.length === 1) {
+        const simpler = String(vs[0]);
+        lx.warn(REDUNDANT_TEMPLATE_STRING, { ...errCtx, simpler }, fixTo(`$'{${simpler}}'`, simpler));
+      }
+      for (const subVal of vs)
+        recurse(subVal);
+    },
+    HandlerNameVal({ lx, val, env, errCtx }) {
+      env.referencedAlters?.add(val.name);
+      if (env.alter[val.name] === undefined)
+        reportUnknownName(lx, ALT_HANDLER_NOT_DEFINED, val.name, Object.keys(env.alter), errCtx);
+    },
+    PredicateVal({ val, recurse }) {
+      for (const arg of val.args)
+        recurse(arg);
+    },
+    DynVal({ lx, val, env, errCtx }) {
+      env.referencedDynamics?.add(val.name);
+      if (env.dynamicMap[val.name] === undefined)
+        reportUnknownName(lx, DYN_VAL_NOT_DEFINED, val.name, Object.keys(env.dynamicMap), errCtx);
+    }
+  };
   NODE_KIND_TO_CTX = {
     RenderTextNode: { originAttr: "<x text>" },
     RenderNode: { originAttr: "<x render>" },
@@ -9453,6 +9478,12 @@ var init_lint_rules = __esm(() => {
       group: "Templates / events",
       summary: "An `<x>` op/attr was written with a leading `@` like a directive."
     },
+    {
+      code: MAYBE_ADD_AT_PREFIX,
+      level: "hint",
+      group: "Templates / events",
+      summary: "A directive name (`when`/`enrich-with`/`loop-with`/`show`/`hide`) was written as a plain attribute on a host element — add the `@` prefix."
+    },
     {
       code: BAD_VALUE,
       level: "error",
@@ -14919,6 +14950,8 @@ function lintIdToMessage(id, info) {
       const written = info.value !== undefined ? `${info.name}=${JSON.stringify(info.value)}` : info.name;
       return `'${written}' on <x> looks like a directive but is actually an x op/attr written with a leading '@'`;
     }
+    case "MAYBE_ADD_AT_PREFIX":
+      return `'${info.name}' on <${(info.tag ?? "").toLowerCase()}> is a plain attribute, but '@${info.name}' is a directive — add the leading '@'`;
     case "BAD_VALUE":
       return `${badValueMessage(info)}${fmtTagSuffix(info)}`;
     case "UNSUPPORTED_EXPR_SYNTAX":
@@ -14929,6 +14962,8 @@ function lintIdToMessage(id, info) {
       return `Template string has no dynamic parts — use the string literal ${info.literal} instead${fmtOriginSuffix(info)}`;
     case "UNKNOWN_COMPONENT_SPEC_KEY":
       return `Unknown component spec key '${info.key}' — value will be ignored at runtime`;
+    case "COMP_FIELD_BAD_SHAPE":
+      return info.kind === "args-not-object" ? `Field '${info.fieldName}': in { component, args }, 'args' must be a plain object, got ${info.got}` : `Field '${info.fieldName}': in { component, args }, 'component' must be the component name as a string, got ${info.gotName ? `the ${info.gotName} class` : info.got}`;
     case "HTML_TAG_NAME_HAS_UPPERCASE":
       return `Tag <${info.raw}> will be lowercased to <${info.lowercased}>${fmtLocationSuffix(info)}`;
     case "HTML_SVG_TAG_WILL_LOWERCASE":

package/dist/tutuca-dev.ext.js

@@ -89,6 +89,7 @@ __export(exports_dev, {
   METHOD_VAL_NOT_DEFINED: () => METHOD_VAL_NOT_DEFINED,
   METHOD_VAL_IS_FIELD: () => METHOD_VAL_IS_FIELD,
   MAYBE_DROP_AT_PREFIX: () => MAYBE_DROP_AT_PREFIX,
+  MAYBE_ADD_AT_PREFIX: () => MAYBE_ADD_AT_PREFIX,
   LintReport: () => LintReport,
   LintParseContext: () => LintParseContext,
   LintFinding: () => LintFinding,
@@ -5854,6 +5855,7 @@ __export(exports_lint_check, {
   METHOD_VAL_NOT_DEFINED: () => METHOD_VAL_NOT_DEFINED,
   METHOD_VAL_IS_FIELD: () => METHOD_VAL_IS_FIELD,
   MAYBE_DROP_AT_PREFIX: () => MAYBE_DROP_AT_PREFIX,
+  MAYBE_ADD_AT_PREFIX: () => MAYBE_ADD_AT_PREFIX,
   LintParseContext: () => LintParseContext,
   LintContext: () => LintContext,
   INPUT_HANDLER_NOT_REFERENCED: () => INPUT_HANDLER_NOT_REFERENCED,
@@ -8174,18 +8176,13 @@ var UNKNOWN_DIRECTIVE = "UNKNOWN_DIRECTIVE";
 var UNKNOWN_X_OP = "UNKNOWN_X_OP";
 var UNKNOWN_X_ATTR = "UNKNOWN_X_ATTR";
 var MAYBE_DROP_AT_PREFIX = "MAYBE_DROP_AT_PREFIX";
+var MAYBE_ADD_AT_PREFIX = "MAYBE_ADD_AT_PREFIX";
 var BAD_VALUE = "BAD_VALUE";
 var UNSUPPORTED_EXPR_SYNTAX = "UNSUPPORTED_EXPR_SYNTAX";
 var REDUNDANT_TEMPLATE_STRING = "REDUNDANT_TEMPLATE_STRING";
 var PLACEHOLDERLESS_TEMPLATE_STRING = "PLACEHOLDERLESS_TEMPLATE_STRING";
 var UNKNOWN_COMPONENT_SPEC_KEY = "UNKNOWN_COMPONENT_SPEC_KEY";
 var COMP_FIELD_BAD_SHAPE = "COMP_FIELD_BAD_SHAPE";
-var PARSE_ISSUE_KIND_TO_LINT_ID = {
-  "unknown-directive": UNKNOWN_DIRECTIVE,
-  "unknown-x-op": UNKNOWN_X_OP,
-  "unknown-x-attr": UNKNOWN_X_ATTR,
-  "bad-value": BAD_VALUE
-};
 var X_KNOWN_OP_NAMES = new Set([
   "slot",
   "text",
@@ -8196,17 +8193,19 @@ var X_KNOWN_OP_NAMES = new Set([
   "hide"
 ]);
 var X_KNOWN_ATTR_NAMES = new Set(["as", "when", "loop-with", "show", "hide"]);
-var AT_PREFIX_HINT_KNOWN_BY_KIND = {
-  "unknown-x-op": X_KNOWN_OP_NAMES,
-  "unknown-x-attr": X_KNOWN_ATTR_NAMES
-};
+var HOST_DIRECTIVE_ONLY_NAMES = new Set(["when", "enrich-with", "loop-with", "show", "hide"]);
 var LEVEL_WARN2 = "warn";
 var LEVEL_ERROR2 = "error";
 var LEVEL_HINT = "hint";
-var 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
+var PARSE_ISSUES = {
+  "unknown-directive": { id: UNKNOWN_DIRECTIVE, candidates: KNOWN_DIRECTIVE_NAMES },
+  "unknown-x-op": { id: UNKNOWN_X_OP, candidates: X_KNOWN_OP_NAMES, atPrefix: X_KNOWN_OP_NAMES },
+  "unknown-x-attr": {
+    id: UNKNOWN_X_ATTR,
+    candidates: X_KNOWN_ATTR_NAMES,
+    atPrefix: X_KNOWN_ATTR_NAMES
+  },
+  "bad-value": { id: BAD_VALUE }
 };
 function collectProtoMethodNames(proto) {
   const out = [];
@@ -8301,9 +8300,10 @@ function checkParseIssues(lx, view) {
   if (!issues)
     return;
   for (const { kind, info } of issues) {
-    const id = PARSE_ISSUE_KIND_TO_LINT_ID[kind];
-    if (!id)
+    const rule = PARSE_ISSUES[kind];
+    if (!rule)
       continue;
+    const id = rule.id;
     if (kind === "bad-value") {
       const detected = classifyBadValue(info.value);
       if (detected) {
@@ -8311,15 +8311,13 @@ function checkParseIssues(lx, view) {
         continue;
       }
     }
-    const atPrefixKnown = AT_PREFIX_HINT_KNOWN_BY_KIND[kind];
+    const atPrefixKnown = rule.atPrefix;
     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);
+    } else if (rule.candidates) {
+      suggestion = replaceNameSuggestion(info.name, rule.candidates);
     }
     lx.error(id, info, suggestion);
     if (isAtPrefixedTypo) {
@@ -8489,70 +8487,83 @@ function checkEventHandlersHaveImpls(lx, Comp, referencedInputs) {
     });
   }
 }
-function checkConsistentAttrVal(lx, val, env, skipNameVal = false, errCtx = null) {
-  const { fields, proto, scope, alter } = env;
-  const valName = val?.constructor.name;
-  if (valName === "FieldVal") {
+var fixTo = (from, to) => ({ kind: "rewrite", from, to });
+function reportUnknownName(lx, code, name, candidates, info) {
+  lx.error(code, { ...info, name }, replaceNameSuggestion(name, candidates));
+}
+var ATTR_VAL_CHECKERS = {
+  FieldVal({ lx, val, env, errCtx }) {
+    const { fields, proto } = env;
     const { name } = val;
-    if (fields[name] === undefined) {
-      if (proto[name] !== undefined) {
-        lx.error(FIELD_VAL_IS_METHOD, { ...errCtx, val, name }, { kind: "rewrite", from: `.${name}`, to: `$${name}` });
-      } else {
-        lx.error(FIELD_VAL_NOT_DEFINED, { ...errCtx, val, name }, replaceNameSuggestion(name, Object.keys(fields)));
-      }
-    }
-  } else if (valName === "MethodVal") {
+    if (fields[name] !== undefined)
+      return;
+    if (proto[name] !== undefined)
+      lx.error(FIELD_VAL_IS_METHOD, { ...errCtx, val, name }, fixTo(`.${name}`, `$${name}`));
+    else
+      reportUnknownName(lx, FIELD_VAL_NOT_DEFINED, name, Object.keys(fields), { ...errCtx, val });
+  },
+  MethodVal({ lx, val, env, errCtx }) {
+    const { fields, proto } = env;
     const { name } = val;
-    if (proto[name] === undefined) {
-      if (fields[name] !== undefined) {
-        lx.error(METHOD_VAL_IS_FIELD, { ...errCtx, val, name }, { kind: "rewrite", from: `$${name}`, to: `.${name}` });
-      } else {
-        lx.error(METHOD_VAL_NOT_DEFINED, { ...errCtx, val, name }, replaceNameSuggestion(name, collectProtoMethodNames(proto)));
-      }
-    }
-  } else if (valName === "SeqAccessVal") {
-    checkConsistentAttrVal(lx, val.seqVal, env, skipNameVal, errCtx);
-    checkConsistentAttrVal(lx, val.keyVal, env, skipNameVal, errCtx);
-  } else if (valName === "RequestVal") {
-    if (scope.lookupRequest(val.name) === null) {
-      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 }, 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 }, replaceNameSuggestion(val.name, KNOWN_HANDLER_NAMES));
-    }
-  } else if (valName === "StrTplVal") {
+    if (proto[name] !== undefined)
+      return;
+    if (fields[name] !== undefined)
+      lx.error(METHOD_VAL_IS_FIELD, { ...errCtx, val, name }, fixTo(`$${name}`, `.${name}`));
+    else
+      reportUnknownName(lx, METHOD_VAL_NOT_DEFINED, name, collectProtoMethodNames(proto), {
+        ...errCtx,
+        val
+      });
+  },
+  SeqAccessVal({ val, recurse }) {
+    recurse(val.seqVal);
+    recurse(val.keyVal);
+  },
+  RequestVal({ lx, val, env, errCtx }) {
+    if (env.scope.lookupRequest(val.name) === null)
+      reportUnknownName(lx, UNKNOWN_REQUEST_NAME, val.name, scopeKeysAlong(env.scope, "reqsByName"), errCtx);
+  },
+  TypeVal({ lx, val, env, errCtx }) {
+    if (env.scope.lookupComponent(val.name) === null)
+      reportUnknownName(lx, UNKNOWN_COMPONENT_NAME, val.name, scopeKeysAlong(env.scope, "byName"), errCtx);
+  },
+  NameVal({ lx, val, errCtx, skipNameVal }) {
+    if (!skipNameVal && !isKnownHandlerName(val.name))
+      reportUnknownName(lx, UNKNOWN_HANDLER_ARG_NAME, val.name, KNOWN_HANDLER_NAMES, errCtx);
+  },
+  StrTplVal({ lx, val, errCtx, recurse }) {
     const vs = val.vals;
     const literal = val.toLiteralSource();
     if (literal !== null) {
-      lx.hint(PLACEHOLDERLESS_TEMPLATE_STRING, { ...errCtx, literal }, { kind: "rewrite", from: `$${literal}`, to: literal });
+      lx.hint(PLACEHOLDERLESS_TEMPLATE_STRING, { ...errCtx, literal }, fixTo(`$${literal}`, literal));
     } else if (vs.length === 1) {
       const simpler = String(vs[0]);
-      lx.warn(REDUNDANT_TEMPLATE_STRING, { ...errCtx, simpler }, { kind: "rewrite", from: `$'{${simpler}}'`, to: simpler });
-    }
-    for (const subVal of vs) {
-      checkConsistentAttrVal(lx, subVal, env, skipNameVal, errCtx);
+      lx.warn(REDUNDANT_TEMPLATE_STRING, { ...errCtx, simpler }, fixTo(`$'{${simpler}}'`, simpler));
     }
-  } else if (valName === "HandlerNameVal") {
+    for (const subVal of vs)
+      recurse(subVal);
+  },
+  HandlerNameVal({ lx, val, env, errCtx }) {
     env.referencedAlters?.add(val.name);
-    if (alter[val.name] === undefined) {
-      lx.error(ALT_HANDLER_NOT_DEFINED, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, Object.keys(alter)));
-    }
-  } else if (valName === "PredicateVal") {
+    if (env.alter[val.name] === undefined)
+      reportUnknownName(lx, ALT_HANDLER_NOT_DEFINED, val.name, Object.keys(env.alter), errCtx);
+  },
+  PredicateVal({ val, recurse }) {
     for (const arg of val.args)
-      checkConsistentAttrVal(lx, arg, env, skipNameVal, errCtx);
-  } else if (valName === "DynVal") {
+      recurse(arg);
+  },
+  DynVal({ lx, val, env, errCtx }) {
     env.referencedDynamics?.add(val.name);
-    if (env.dynamicMap[val.name] === undefined) {
-      lx.error(DYN_VAL_NOT_DEFINED, { ...errCtx, name: val.name }, replaceNameSuggestion(val.name, Object.keys(env.dynamicMap)));
-    }
-  } else if (valName !== "ConstVal" && valName !== "BindVal") {
-    console.log(val);
+    if (env.dynamicMap[val.name] === undefined)
+      reportUnknownName(lx, DYN_VAL_NOT_DEFINED, val.name, Object.keys(env.dynamicMap), errCtx);
   }
+};
+function checkConsistentAttrVal(lx, val, env, skipNameVal = false, errCtx = null) {
+  const check = ATTR_VAL_CHECKERS[val?.constructor.name];
+  if (check === undefined)
+    return;
+  const recurse = (sub) => checkConsistentAttrVal(lx, sub, env, skipNameVal, errCtx);
+  check({ lx, val, env, errCtx, skipNameVal, recurse });
 }
 var NODE_KIND_TO_CTX = {
   RenderTextNode: { originAttr: "<x text>" },
@@ -8584,6 +8595,23 @@ function attrOriginAttr(attr) {
     return "@dangerouslysetinnerhtml";
   return `:${attr.name}`;
 }
+function checkHostBareDirectives(lx, attrs, tag, isMacroCall) {
+  if (isMacroCall || !attrs)
+    return;
+  const kind = attrs.constructor.name;
+  let names;
+  if (kind === "ConstAttrs")
+    names = Object.keys(attrs.items);
+  else if (kind === "DynAttrs")
+    names = attrs.items.map((a) => a?.name);
+  else
+    return;
+  for (const name of names) {
+    if (HOST_DIRECTIVE_ONLY_NAMES.has(name)) {
+      lx.hint(MAYBE_ADD_AT_PREFIX, { name, tag, suggestion: `@${name}` }, { kind: "add-prefix", from: name, to: `@${name}` });
+    }
+  }
+}
 function checkConsistentAttrs(lx, Comp, referencedAlters, referencedDynamics) {
   const { views } = Comp;
   const env = mkAttrValEnv(Comp, referencedAlters, referencedDynamics);
@@ -8592,6 +8620,7 @@ function checkConsistentAttrs(lx, Comp, referencedAlters, referencedDynamics) {
       const view = views[viewName];
       for (const entry of view.ctx.attrs) {
         const { attrs, wrapperAttrs, textChild, isMacroCall, tag } = entry;
+        checkHostBareDirectives(lx, attrs, tag, isMacroCall);
         if (attrs?.constructor.name === "DynAttrs") {
           const sourcesByName = new Map;
           for (const attr of attrs.items) {
@@ -9393,6 +9422,8 @@ function lintIdToMessage(id, info) {
       const written = info.value !== undefined ? `${info.name}=${JSON.stringify(info.value)}` : info.name;
       return `'${written}' on <x> looks like a directive but is actually an x op/attr written with a leading '@'`;
     }
+    case "MAYBE_ADD_AT_PREFIX":
+      return `'${info.name}' on <${(info.tag ?? "").toLowerCase()}> is a plain attribute, but '@${info.name}' is a directive — add the leading '@'`;
     case "BAD_VALUE":
       return `${badValueMessage(info)}${fmtTagSuffix(info)}`;
     case "UNSUPPORTED_EXPR_SYNTAX":
@@ -9403,6 +9434,8 @@ function lintIdToMessage(id, info) {
       return `Template string has no dynamic parts — use the string literal ${info.literal} instead${fmtOriginSuffix(info)}`;
     case "UNKNOWN_COMPONENT_SPEC_KEY":
       return `Unknown component spec key '${info.key}' — value will be ignored at runtime`;
+    case "COMP_FIELD_BAD_SHAPE":
+      return info.kind === "args-not-object" ? `Field '${info.fieldName}': in { component, args }, 'args' must be a plain object, got ${info.got}` : `Field '${info.fieldName}': in { component, args }, 'component' must be the component name as a string, got ${info.gotName ? `the ${info.gotName} class` : info.got}`;
     case "HTML_TAG_NAME_HAS_UPPERCASE":
       return `Tag <${info.raw}> will be lowercased to <${info.lowercased}>${fmtLocationSuffix(info)}`;
     case "HTML_SVG_TAG_WILL_LOWERCASE":
@@ -11622,6 +11655,7 @@ export {
   METHOD_VAL_NOT_DEFINED,
   METHOD_VAL_IS_FIELD,
   MAYBE_DROP_AT_PREFIX,
+  MAYBE_ADD_AT_PREFIX,
   LintReport,
   LintParseContext,
   LintFinding,