tutuca 0.9.52 → 0.9.54

package/README.md

@@ -3,7 +3,7 @@
 Zero-dependency batteries included SPA framework.
 
 - **Single file, no build, no dependencies, no setup** — a script tag is all you need
-- **Batteries included** — state management, side effects, automatic memoization, drag and drop and more
+- **Batteries included** — state management, side effects, automatic memoization, drag and drop, testing, CLI tooling, LLM skills and more
 - **Fits in your head** (and the context window)
 - **View source friendly** — step through the whole stack
 - **As much HTML as possible, as little JS as needed**

package/dist/tutuca-cli.js

@@ -3615,16 +3615,25 @@ function getFieldMethods(field) {
       name: `reset${uname}`,
       sig: `reset${uname}()`,
       desc: "Reset to default value"
-    },
+    }
+  ];
+  const truthy = [
     {
-      name: `is${uname}NotSet`,
-      sig: `is${uname}NotSet()`,
-      desc: "Check if null/undefined"
+      name: `is${uname}Truthy`,
+      sig: `is${uname}Truthy()`,
+      desc: "Check if value is truthy"
     },
     {
-      name: `is${uname}Set`,
-      sig: `is${uname}Set()`,
-      desc: "Check if not null/undefined"
+      name: `is${uname}Falsy`,
+      sig: `is${uname}Falsy()`,
+      desc: "Check if value is falsy"
+    }
+  ];
+  const nullable = [
+    {
+      name: `is${uname}Null`,
+      sig: `is${uname}Null()`,
+      desc: "Check if value is null/undefined"
     }
   ];
   switch (type3) {
@@ -3634,21 +3643,28 @@ function getFieldMethods(field) {
         name: `toggle${uname}`,
         sig: `toggle${uname}()`,
         desc: "Toggle boolean value"
-      });
+      }, ...truthy);
+      break;
+    case "int":
+    case "float":
+      methods.push(...truthy);
+      break;
+    case "any":
+      methods.push(...nullable, ...truthy);
       break;
     case "text":
       methods.push({
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if string is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get string length" });
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get string length" }, ...truthy);
       break;
     case "list":
       methods.push({
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if list is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get list size" }, {
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get list size" }, ...truthy, {
         name: `setIn${uname}At`,
         sig: `setIn${uname}At(i, v)`,
         desc: "Set item at index"
@@ -3689,7 +3705,7 @@ function getFieldMethods(field) {
         name: `${name}Len`,
         sig: `${name}Len()`,
         desc: `Get ${label} size`
-      }, {
+      }, ...truthy, {
         name: `setIn${uname}At`,
         sig: `setIn${uname}At(key, v)`,
         desc: "Set value at key"
@@ -3717,7 +3733,7 @@ function getFieldMethods(field) {
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if set is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get set size" }, {
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get set size" }, ...truthy, {
         name: `addIn${uname}`,
         sig: `addIn${uname}(v)`,
         desc: "Add value to set"
@@ -3739,6 +3755,9 @@ function getFieldMethods(field) {
         desc: "Toggle value in set"
       });
       break;
+    default:
+      methods.push(...nullable, ...truthy);
+      break;
   }
   return methods;
 }
@@ -5406,15 +5425,13 @@ class Components {
     return v?.[this.getComponentSymbol]?.() ?? null;
   }
   getOnEnterFor(v) {
-    const comp = this.getCompFor(v);
-    return comp ? comp.on.stackEnter : defaultOnStackEnter;
+    return this.getCompFor(v)?.on.stackEnter ?? defaultOnStackEnter;
   }
   getHandlerFor(v, name, key) {
     return this.getCompFor(v)?.[key][name] ?? null;
   }
   getRequestFor(v, name) {
-    const comp = this.getCompFor(v);
-    return comp ? comp.scope.lookupRequest(name) : null;
+    return this.getCompFor(v)?.scope.lookupRequest(name) ?? null;
   }
   compileStyles() {
     const styles2 = [];
@@ -13630,9 +13647,6 @@ class Renderer {
     this.comps = comps;
     this.cache = new WeakMapDomCache;
   }
-  getSeqInfo(seq) {
-    return isIndexed(seq) ? imIndexedIter : isKeyed(seq) ? imKeyedIter : seq?.[SEQ_INFO] ?? unkIter;
-  }
   renderTag(tag, attrs, childs) {
     return h(tag, attrs, childs);
   }
@@ -13690,7 +13704,7 @@ class Renderer {
     const { seq, filter, loopWith } = iterInfo.eval(stack);
     const r = [];
     const iterData = loopWith.call(stack.it, seq);
-    this.getSeqInfo(seq)(seq, (key, value, attrName) => {
+    getSeqInfo(seq)(seq, (key, value, attrName) => {
       if (filter.call(stack.it, key, value, iterData)) {
         const dom = this.renderIt(stack.enter(value, { key }, true), nodeId, key, viewName);
         this.pushEachEntry(r, nodeId, attrName, key, dom);
@@ -13703,7 +13717,7 @@ class Renderer {
     const r = [];
     const it = stack.it;
     const iterData = loopWith.call(it, seq);
-    this.getSeqInfo(seq)(seq, (key, value, attrName) => {
+    getSeqInfo(seq)(seq, (key, value, attrName) => {
       if (filter.call(it, key, value, iterData)) {
         const cachePath = enricher ? [it, value] : [value];
         const binds = { key, value };
@@ -13740,7 +13754,7 @@ class Renderer {
     return new VComment(`§${JSON.stringify(info)}§`);
   }
 }
-var DATASET_ATTRS, imIndexedIter = (seq, visit) => {
+var DATASET_ATTRS, getSeqInfo = (seq) => isIndexed(seq) ? imIndexedIter : isKeyed(seq) ? imKeyedIter : seq?.[SEQ_INFO] ?? unkIter, imIndexedIter = (seq, visit) => {
   let i = 0;
   for (const v of seq)
     visit(i++, v, "si");

package/dist/tutuca-dev.js

@@ -8510,15 +8510,13 @@ class Components {
     return v?.[this.getComponentSymbol]?.() ?? null;
   }
   getOnEnterFor(v) {
-    const comp = this.getCompFor(v);
-    return comp ? comp.on.stackEnter : defaultOnStackEnter;
+    return this.getCompFor(v)?.on.stackEnter ?? defaultOnStackEnter;
   }
   getHandlerFor(v, name, key) {
     return this.getCompFor(v)?.[key][name] ?? null;
   }
   getRequestFor(v, name) {
-    const comp = this.getCompFor(v);
-    return comp ? comp.scope.lookupRequest(name) : null;
+    return this.getCompFor(v)?.scope.lookupRequest(name) ?? null;
   }
   compileStyles() {
     const styles2 = [];
@@ -8603,8 +8601,7 @@ class DynamicAlias extends Dynamic {
     this.dynName = dynName;
   }
   _resolveSymbol(stack) {
-    const t = stack.lookupType(this.compName);
-    return t?.dynamic[this.dynName]?.symbol ?? null;
+    return stack.lookupType(this.compName)?.dynamic[this.dynName]?.symbol ?? null;
   }
   getSymbol(stack) {
     this.symbol ??= this._resolveSymbol(stack);
@@ -8652,9 +8649,8 @@ class Component {
       } else if (isString(dinfo?.default) && isString(dinfo?.for)) {
         const val = vp.parseDynamic(dinfo.default, this.views.main.ctx);
         const [compName, dynName] = dinfo.for.split(".");
-        if (isString(compName) && isString(dynName)) {
+        if (isString(compName) && isString(dynName))
           this.dynamic[key] = new DynamicAlias(key, val, compName, dynName);
-        }
       }
     }
     for (const name in this.views)
@@ -14601,9 +14597,6 @@ class Renderer {
     this.comps = comps;
     this.cache = new WeakMapDomCache;
   }
-  getSeqInfo(seq) {
-    return isIndexed(seq) ? imIndexedIter : isKeyed(seq) ? imKeyedIter : seq?.[SEQ_INFO] ?? unkIter;
-  }
   renderTag(tag, attrs, childs) {
     return h(tag, attrs, childs);
   }
@@ -14661,7 +14654,7 @@ class Renderer {
     const { seq, filter, loopWith } = iterInfo.eval(stack);
     const r = [];
     const iterData = loopWith.call(stack.it, seq);
-    this.getSeqInfo(seq)(seq, (key, value, attrName) => {
+    getSeqInfo(seq)(seq, (key, value, attrName) => {
       if (filter.call(stack.it, key, value, iterData)) {
         const dom = this.renderIt(stack.enter(value, { key }, true), nodeId, key, viewName);
         this.pushEachEntry(r, nodeId, attrName, key, dom);
@@ -14674,7 +14667,7 @@ class Renderer {
     const r = [];
     const it = stack.it;
     const iterData = loopWith.call(it, seq);
-    this.getSeqInfo(seq)(seq, (key, value, attrName) => {
+    getSeqInfo(seq)(seq, (key, value, attrName) => {
       if (filter.call(it, key, value, iterData)) {
         const cachePath = enricher ? [it, value] : [value];
         const binds = { key, value };
@@ -14711,6 +14704,7 @@ class Renderer {
     return new VComment(`§${JSON.stringify(info)}§`);
   }
 }
+var getSeqInfo = (seq) => isIndexed(seq) ? imIndexedIter : isKeyed(seq) ? imKeyedIter : seq?.[SEQ_INFO] ?? unkIter;
 var imIndexedIter = (seq, visit) => {
   let i = 0;
   for (const v of seq)
@@ -14871,16 +14865,25 @@ function getFieldMethods(field) {
       name: `reset${uname}`,
       sig: `reset${uname}()`,
       desc: "Reset to default value"
-    },
+    }
+  ];
+  const truthy = [
     {
-      name: `is${uname}NotSet`,
-      sig: `is${uname}NotSet()`,
-      desc: "Check if null/undefined"
+      name: `is${uname}Truthy`,
+      sig: `is${uname}Truthy()`,
+      desc: "Check if value is truthy"
     },
     {
-      name: `is${uname}Set`,
-      sig: `is${uname}Set()`,
-      desc: "Check if not null/undefined"
+      name: `is${uname}Falsy`,
+      sig: `is${uname}Falsy()`,
+      desc: "Check if value is falsy"
+    }
+  ];
+  const nullable = [
+    {
+      name: `is${uname}Null`,
+      sig: `is${uname}Null()`,
+      desc: "Check if value is null/undefined"
     }
   ];
   switch (type3) {
@@ -14890,21 +14893,28 @@ function getFieldMethods(field) {
         name: `toggle${uname}`,
         sig: `toggle${uname}()`,
         desc: "Toggle boolean value"
-      });
+      }, ...truthy);
+      break;
+    case "int":
+    case "float":
+      methods.push(...truthy);
+      break;
+    case "any":
+      methods.push(...nullable, ...truthy);
       break;
     case "text":
       methods.push({
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if string is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get string length" });
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get string length" }, ...truthy);
       break;
     case "list":
       methods.push({
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if list is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get list size" }, {
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get list size" }, ...truthy, {
         name: `setIn${uname}At`,
         sig: `setIn${uname}At(i, v)`,
         desc: "Set item at index"
@@ -14945,7 +14955,7 @@ function getFieldMethods(field) {
         name: `${name}Len`,
         sig: `${name}Len()`,
         desc: `Get ${label} size`
-      }, {
+      }, ...truthy, {
         name: `setIn${uname}At`,
         sig: `setIn${uname}At(key, v)`,
         desc: "Set value at key"
@@ -14973,7 +14983,7 @@ function getFieldMethods(field) {
         name: `is${uname}Empty`,
         sig: `is${uname}Empty()`,
         desc: "Check if set is empty"
-      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get set size" }, {
+      }, { name: `${name}Len`, sig: `${name}Len()`, desc: "Get set size" }, ...truthy, {
         name: `addIn${uname}`,
         sig: `addIn${uname}(v)`,
         desc: "Add value to set"
@@ -14995,6 +15005,9 @@ function getFieldMethods(field) {
         desc: "Toggle value in set"
       });
       break;
+    default:
+      methods.push(...nullable, ...truthy);
+      break;
   }
   return methods;
 }
@@ -15036,6 +15049,51 @@ function docComponents(normalized, { name = null } = {}) {
   const picked = name === null ? comps : comps.filter((c) => c.name === name);
   return new ComponentDocs({ items: getComponentsDocs(picked) });
 }
+// src/util/testing.js
+var filterAlwaysTrue2 = () => true;
+var nullLoopWith2 = (seq) => ({ seq });
+var plainArrayIter = (seq, visit) => {
+  for (let i = 0;i < seq.length; i++)
+    visit(i, seq[i]);
+};
+var plainMapIter = (seq, visit) => {
+  for (const [k, v] of seq.entries())
+    visit(k, v);
+};
+function pickIter(seq) {
+  if (Array.isArray(seq))
+    return plainArrayIter;
+  if (seq instanceof Map)
+    return plainMapIter;
+  return getSeqInfo(seq);
+}
+function resolveAlter(Comp, name) {
+  if (name == null)
+    return null;
+  const fn = Comp.alter?.[name];
+  if (typeof fn !== "function") {
+    throw new Error(`alter handler '${name}' not found on component '${Comp.name}'`);
+  }
+  return fn;
+}
+function collectIterBindings(Comp, compInstance, seq, opts = {}) {
+  const whenFn = resolveAlter(Comp, opts.when) ?? filterAlwaysTrue2;
+  const loopWithFn = resolveAlter(Comp, opts.loopWith) ?? nullLoopWith2;
+  const enrichFn = resolveAlter(Comp, opts.enrichWith);
+  const it = compInstance;
+  const iterData = loopWithFn.call(it, seq);
+  const out = [];
+  const iter = pickIter(seq);
+  iter(seq, (key, value) => {
+    if (!whenFn.call(it, key, value, iterData))
+      return;
+    const binds = { key, value };
+    if (enrichFn)
+      enrichFn.call(it, binds, key, value, iterData);
+    out.push(binds);
+  });
+  return out;
+}
 
 // dev.js
 async function test3(opts = {}) {
@@ -15156,6 +15214,7 @@ export {
   component,
   compileClassesToStyleText,
   compileClassesToStyle,
+  collectIterBindings,
   checkComponent,
   check,
   UNSUPPORTED_EXPR_SYNTAX,