tutuca 0.9.70 → 0.9.72

package/dist/tutuca-cli.js

@@ -8960,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);
@@ -8968,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) {
@@ -9144,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", X_KNOWN_OP_NAMES, X_KNOWN_ATTR_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 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();
@@ -9174,6 +9192,7 @@ var init_lint_check = __esm(() => {
     "hide"
   ]);
   X_KNOWN_ATTR_NAMES = new Set(["as", "when", "loop-with", "show", "hide"]);
+  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 },
@@ -9459,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",
@@ -12806,6 +12831,111 @@ var init_chai = __esm(() => {
   __name(use, "use");
 });
 
+// src/chai-jest.js
+function jestMatchers(chai, utils) {
+  const A = chai.Assertion;
+  const m = (name, fn) => A.addMethod(name, fn);
+  m("toBe", function(expected) {
+    this.assert(Object.is(this._obj, expected), "expected #{this} to be #{exp}", "expected #{this} not to be #{exp}", expected, this._obj);
+  });
+  m("toEqual", function(expected) {
+    this.assert(utils.eql(this._obj, expected), "expected #{this} to deeply equal #{exp}", "expected #{this} not to deeply equal #{exp}", expected, this._obj, true);
+  });
+  m("toBeTruthy", function() {
+    this.assert(Boolean(this._obj), "expected #{this} to be truthy", "expected #{this} not to be truthy");
+  });
+  m("toBeFalsy", function() {
+    this.assert(!this._obj, "expected #{this} to be falsy", "expected #{this} not to be falsy");
+  });
+  m("toBeNull", function() {
+    this.assert(this._obj === null, "expected #{this} to be null", "expected #{this} not to be null");
+  });
+  m("toBeUndefined", function() {
+    this.assert(this._obj === undefined, "expected #{this} to be undefined", "expected #{this} not to be undefined");
+  });
+  m("toBeDefined", function() {
+    this.assert(this._obj !== undefined, "expected #{this} to be defined", "expected #{this} to be undefined");
+  });
+  m("toBeNaN", function() {
+    this.assert(Number.isNaN(this._obj), "expected #{this} to be NaN", "expected #{this} not to be NaN");
+  });
+  const compare = (name, op, word) => m(name, function(expected) {
+    this.assert(op(this._obj, expected), `expected #{this} to be ${word} #{exp}`, `expected #{this} not to be ${word} #{exp}`, expected);
+  });
+  compare("toBeGreaterThan", (a, b) => a > b, "greater than");
+  compare("toBeGreaterThanOrEqual", (a, b) => a >= b, "greater than or equal to");
+  compare("toBeLessThan", (a, b) => a < b, "less than");
+  compare("toBeLessThanOrEqual", (a, b) => a <= b, "less than or equal to");
+  m("toBeCloseTo", function(expected, numDigits = 2) {
+    const pass = Math.abs(expected - this._obj) < 10 ** -numDigits / 2;
+    this.assert(pass, `expected #{this} to be close to #{exp} (${numDigits} digits)`, `expected #{this} not to be close to #{exp} (${numDigits} digits)`, expected);
+  });
+  m("toContain", function(item) {
+    const obj = this._obj;
+    const ok = typeof obj === "string" ? obj.includes(item) : Array.from(obj).includes(item);
+    this.assert(ok, "expected #{this} to contain #{exp}", "expected #{this} not to contain #{exp}", item);
+  });
+  m("toHaveLength", function(length) {
+    const actual = this._obj == null ? undefined : this._obj.length;
+    this.assert(actual === length, "expected #{this} to have length #{exp}", "expected #{this} not to have length #{exp}", length, actual);
+  });
+  m("toMatch", function(expected) {
+    const obj = this._obj;
+    const ok = expected instanceof RegExp ? expected.test(obj) : String(obj).includes(expected);
+    this.assert(ok, "expected #{this} to match #{exp}", "expected #{this} not to match #{exp}", expected);
+  });
+  m("toHaveProperty", function(path, ...rest) {
+    const keys = Array.isArray(path) ? path : String(path).split(".");
+    let cur = this._obj;
+    let found = true;
+    for (const k of keys) {
+      if (cur != null && k in Object(cur))
+        cur = cur[k];
+      else {
+        found = false;
+        break;
+      }
+    }
+    const pass = found && (rest.length === 0 || utils.eql(cur, rest[0]));
+    this.assert(pass, "expected #{this} to have property #{exp}", "expected #{this} not to have property #{exp}", path);
+  });
+  m("toBeInstanceOf", function(ctor) {
+    this.assert(this._obj instanceof ctor, "expected #{this} to be an instance of #{exp}", "expected #{this} not to be an instance of #{exp}", ctor.name ?? ctor);
+  });
+  m("toThrow", function(expected) {
+    const a = new chai.Assertion(this._obj);
+    if (utils.flag(this, "negate")) {
+      expected === undefined ? a.to.not.throw() : a.to.not.throw(expected);
+    } else {
+      expected === undefined ? a.to.throw() : a.to.throw(expected);
+    }
+  });
+}
+var JEST_MATCHERS;
+var init_chai_jest = __esm(() => {
+  JEST_MATCHERS = [
+    "toBe",
+    "toEqual",
+    "toBeTruthy",
+    "toBeFalsy",
+    "toBeNull",
+    "toBeUndefined",
+    "toBeDefined",
+    "toBeNaN",
+    "toBeGreaterThan",
+    "toBeGreaterThanOrEqual",
+    "toBeLessThan",
+    "toBeLessThanOrEqual",
+    "toBeCloseTo",
+    "toContain",
+    "toHaveLength",
+    "toMatch",
+    "toHaveProperty",
+    "toBeInstanceOf",
+    "toThrow"
+  ];
+});
+
 // tools/core/results.js
 class ModuleInfo {
   constructor({ path = null, present = new Set, counts = {}, warnings = [] }) {
@@ -14718,12 +14848,14 @@ function parseLimit(raw) {
 var COMMANDS;
 var init__registry = __esm(() => {
   init_chai();
+  init_chai_jest();
   init_describe();
   init_docs();
   init_list();
   init_lint();
   init_render2();
   init_test();
+  use(jestMatchers);
   COMMANDS = {
     get: {
       describe: "Summarize the module's exports and counts.",
@@ -14925,6 +15057,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":
@@ -14935,6 +15069,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":
@@ -15589,6 +15725,7 @@ init__registry();
 init_feedback();
 
 // tools/cli/commands/help.js
+init_chai_jest();
 var exports_help = {};
 __export(exports_help, {
   run: () => run4,
@@ -15641,7 +15778,9 @@ MODULE CONVENTION
         describe(title, fn)               // untagged
         describe(title, { component }, fn)// explicit tag with custom title
       and   test(title, fn)               // fn may be async
-      and   expect comes from chai
+      and   expect is chai, with jest-style matchers added:
+            ${JEST_MATCHERS.join(", ")}
+            (chai's BDD chain like .to.equal also works; use .not to negate)
 
     export function getRoot()             // optional; returned by info