tutuca 0.9.97 → 0.9.99

package/dist/tutuca-dev.ext.js

@@ -95,7 +95,6 @@ import {
   util
 } from "chai";
 chai.use(jestMatchers);
-
 // src/value.js
 import { is } from "immutable";
 
@@ -1842,37 +1841,47 @@ class Renderer {
   renderEach(stack, iterInfo, node, viewName) {
     const { seq, filter, loopWith } = iterInfo.eval(stack);
     const r = [];
-    const { iterData, start, end } = unpackLoopResult(loopWith.call(stack.it, seq), seq);
-    getSeqInfo(seq)(seq, (key, value, attrName) => {
-      if (filter.call(stack.it, key, value, iterData)) {
-        const dom = this.renderIt(stack.enter(value, { key }, true), node, key, viewName);
-        this.pushEachEntry(r, node.nodeId, attrName, key, dom);
-      }
-    }, start, end);
+    const { iterData, start, end, keys } = unpackLoopResult(loopWith.call(stack.it, seq, makeLoopCtx(stack, filter)), seq);
+    const renderOne = (key, value, attrName) => {
+      const dom = this.renderIt(stack.enter(value, { key }, true), node, key, viewName);
+      this.pushEachEntry(r, node.nodeId, attrName, key, dom);
+    };
+    if (keys)
+      imKeysIter(seq, renderOne, keys);
+    else
+      getSeqInfo(seq)(seq, (key, value, attrName) => {
+        if (filter.call(stack.it, key, value, iterData))
+          renderOne(key, value, attrName);
+      }, start, end);
     return r;
   }
   renderEachWhen(stack, iterInfo, view, nid) {
     const { seq, filter, loopWith, enricher } = iterInfo.eval(stack);
     const r = [];
     const it = stack.it;
-    const { iterData, start, end } = unpackLoopResult(loopWith.call(it, seq), seq);
-    getSeqInfo(seq)(seq, (key, value, attrName) => {
-      if (filter.call(it, key, value, iterData)) {
-        const cachePath = enricher ? [view, it, value] : [view, value];
-        const binds = { key, value };
-        const cacheKey = `${nid}-${key}`;
-        if (enricher)
-          enricher.call(it, binds, key, value, iterData);
-        const cachedNode = this.cache.get(cachePath, cacheKey);
-        if (cachedNode)
-          this.pushEachEntry(r, nid, attrName, key, cachedNode);
-        else {
-          const dom = this.renderView(view, stack.enter(value, binds, false));
-          this.pushEachEntry(r, nid, attrName, key, dom);
-          this.cache.set(cachePath, cacheKey, dom);
-        }
+    const { iterData, start, end, keys } = unpackLoopResult(loopWith.call(it, seq, makeLoopCtx(stack, filter)), seq);
+    const renderOne = (key, value, attrName) => {
+      const cachePath = enricher ? [view, it, value] : [view, value];
+      const binds = { key, value };
+      const cacheKey = `${nid}-${key}`;
+      if (enricher)
+        enricher.call(it, binds, key, value, iterData);
+      const cachedNode = this.cache.get(cachePath, cacheKey);
+      if (cachedNode)
+        this.pushEachEntry(r, nid, attrName, key, cachedNode);
+      else {
+        const dom = this.renderView(view, stack.enter(value, binds, false));
+        this.pushEachEntry(r, nid, attrName, key, dom);
+        this.cache.set(cachePath, cacheKey, dom);
       }
-    }, start, end);
+    };
+    if (keys)
+      imKeysIter(seq, renderOne, keys);
+    else
+      getSeqInfo(seq)(seq, (key, value, attrName) => {
+        if (filter.call(it, key, value, iterData))
+          renderOne(key, value, attrName);
+      }, start, end);
     return r;
   }
   renderView(view, stack) {
@@ -1908,8 +1917,17 @@ var filterAlwaysTrue = (_v, _k, _seq) => true;
 var nullLoopWith = (seq) => ({ iterData: { seq } });
 var unpackLoopResult = (result, seq) => {
   const r = result ?? {};
-  return { iterData: r.iterData ?? { seq }, start: r.start, end: r.end };
+  return { iterData: r.iterData ?? { seq }, start: r.start, end: r.end, keys: r.keys };
+};
+var imKeysIter = (seq, visit, keys) => {
+  const attrName = isIndexed(seq) ? "si" : "sk";
+  for (const key of keys)
+    visit(key, seq.get(key), attrName);
 };
+var makeLoopCtx = (stack, filter) => ({
+  lookup: (name) => stack.lookupBind(name),
+  filter: (key, value, iterData) => filter.call(stack.it, key, value, iterData)
+});
 var imIndexedIter = (seq, visit, start, end) => {
   const [s, e] = normalizeRange(start, end, seq.size);
   for (let i = s;i < e; i++)
@@ -2457,11 +2475,11 @@ class IterInfo {
     return { seq, filter, loopWith, enricher };
   }
   enrichBinds(stack, key) {
-    const { seq, loopWith, enricher } = this.eval(stack);
+    const { seq, filter, loopWith, enricher } = this.eval(stack);
     const value = seq?.get ? seq.get(key, null) : null;
     const binds = { key, value };
     if (enricher) {
-      const { iterData } = unpackLoopResult(loopWith.call(stack.it, seq), seq);
+      const { iterData } = unpackLoopResult(loopWith.call(stack.it, seq, makeLoopCtx(stack, filter)), seq);
       enricher.call(stack.it, binds, key, value, iterData);
     }
     return binds;
@@ -3470,7 +3488,6 @@ var RAW_TEXT_ELEMENTS = new Set([
   "xmp",
   "plaintext"
 ]);
-var RCDATA_ELEMENTS = new Set(["textarea", "title"]);
 var SPECIAL_ELEMENTS = new Set([
   "address",
   "applet",
@@ -3585,7 +3602,6 @@ var SCOPE_LIST_ITEM = new Set([...DEFAULT_SCOPE_BOUNDARIES, "ol", "ul"]);
 var SCOPE_BUTTON = new Set([...DEFAULT_SCOPE_BOUNDARIES, "button"]);
 var SCOPE_DEFAULT = DEFAULT_SCOPE_BOUNDARIES;
 var SCOPE_TABLE = new Set(["html", "table", "template"]);
-var SCOPE_SELECT = new Set;
 var STANDARD_SVG_CAMEL_ELEMENTS = new Set([
   "altGlyph",
   "altGlyphDef",
@@ -3737,7 +3753,6 @@ var FOREIGN_BREAKOUT_TAGS = new Set([
   "ul",
   "var"
 ]);
-var MATHML_TEXT_INTEGRATION_POINTS = new Set(["mi", "mo", "mn", "ms", "mtext"]);
 var BLOCK_LEVEL_AUTO_CLOSE_P = new Set([
   "address",
   "article",
@@ -3780,7 +3795,6 @@ var BLOCK_LEVEL_AUTO_CLOSE_P = new Set([
   "dd",
   "dt"
 ]);
-var SELECT_VALID_CHILDREN = new Set(["option", "optgroup", "hr", "script", "template"]);
 var SELECT_BREAKOUT_TAGS = new Set(["input", "keygen", "textarea", "select"]);
 var MODES = Object.freeze({
   inBody: "inBody",
@@ -6040,6 +6054,13 @@ function phaseOps(phase) {
 function resolveArgs(args, self) {
   return typeof args === "function" ? args(self) ?? [] : args ?? [];
 }
+function phaseHasBubble(phase) {
+  if (!phase)
+    return false;
+  if (phase.bubble?.length)
+    return true;
+  return (phase.do ?? []).some((op) => op.type === "bubble");
+}
 function dispatchPhase(dispatcher, targetPath, phase, self) {
   if (!phase)
     return;
@@ -6976,6 +6997,8 @@ async function driveStack(stack, value, phase, opts = {}) {
       const t = info?.transaction;
       opts.onMessage({ kind: t?.handlerProp ?? "input", name: t?.name, args: t?.args, path: t?.path }, old, val);
     });
+  if (phaseHasBubble(phase))
+    console.warn("drive(): a `bubble` action is a no-op here — drive originates at the root and bubbles travel child→parent, so there is no ancestor to receive it (and the root's own bubble handler is skipped). To exercise a bubble handler, call it directly.");
   dispatchPhase(rootDispatcher(transactor), new Path([]), phase, value);
   await transactor.settle();
   return transactor.state.val;
@@ -7964,7 +7987,8 @@ class FieldSet extends Field {
 }
 function mkCompField(field, scope, args) {
   const Comp = scope?.lookupComponent(field.type) ?? null;
-  console.assert(!scope || Comp !== null, "component not found", { field });
+  if (Comp === null)
+    console.warn(scope ? `component field "${field.name}": component "${field.type}" not found in scope` : `component field "${field.name}": cannot resolve component "${field.type}" — built without a registered scope (use ${field.type}.make({}) as the default, or build via a registered component)`);
   return Comp?.make({ ...field.args, ...args }, { scope }) ?? null;
 }
 
@@ -8138,13 +8162,30 @@ function resolveAlter(Comp, name) {
   }
   return fn;
 }
+var seqGet = (seq, key) => Array.isArray(seq) ? seq[key] : seq.get ? seq.get(key) : seq[key];
 function collectIterBindings(Comp, compInstance, seq, opts = {}) {
   const whenFn = resolveAlter(Comp, opts.when) ?? filterAlwaysTrue;
   const loopWithFn = resolveAlter(Comp, opts.loopWith) ?? nullLoopWith;
   const enrichFn = resolveAlter(Comp, opts.enrichWith);
+  const scopeEnrichFn = resolveAlter(Comp, opts.scopeEnrich);
   const it = compInstance;
-  const { iterData, start, end } = unpackLoopResult(loopWithFn.call(it, seq), seq);
+  const scope = scopeEnrichFn ? scopeEnrichFn.call(it) ?? {} : opts.scope ?? {};
+  const ctx = {
+    lookup: (name) => scope[name],
+    filter: (key, value, iterData2) => whenFn.call(it, key, value, iterData2)
+  };
+  const { iterData, start, end, keys } = unpackLoopResult(loopWithFn.call(it, seq, ctx), seq);
   const out = [];
+  if (keys) {
+    for (const key of keys) {
+      const value = seqGet(seq, key);
+      const binds = { key, value };
+      if (enrichFn)
+        enrichFn.call(it, binds, key, value, iterData);
+      out.push(binds);
+    }
+    return out;
+  }
   const iter = pickIter(seq);
   iter(seq, (key, value) => {
     if (!whenFn.call(it, key, value, iterData))
@@ -8333,20 +8374,23 @@ async function test2(opts = {}) {
   reportTestReportToConsole(report);
   return report;
 }
+function shadowCheckComponent(Comp) {
+  const shadowViews = {};
+  for (const name in Comp.views) {
+    const rawView = Comp.views[name].rawView;
+    const ctx = new LintParseContext;
+    ANode.parse(rawView, ctx);
+    ctx.compile(Comp.scope);
+    shadowViews[name] = { name, ctx, rawView };
+  }
+  const shadowComp = Object.create(Comp);
+  shadowComp.views = shadowViews;
+  return checkComponent(shadowComp).reports;
+}
 function check(app) {
   const counts = { error: 0, warn: 0, hint: 0 };
   for (const Comp of app.comps.byId.values()) {
-    const shadowViews = {};
-    for (const name in Comp.views) {
-      const rawView = Comp.views[name].rawView;
-      const ctx = new LintParseContext;
-      ANode.parse(rawView, ctx);
-      ctx.compile(Comp.scope);
-      shadowViews[name] = { name, ctx, rawView };
-    }
-    const shadowComp = Object.create(Comp);
-    shadowComp.views = shadowViews;
-    const { reports } = checkComponent(shadowComp);
+    const reports = shadowCheckComponent(Comp);
     if (reports.length === 0)
       continue;
     console.group(Comp.name);
@@ -8400,6 +8444,7 @@ export {
   tutuca,
   test2 as test,
   suggestionToMessage,
+  shadowCheckComponent,
   setIn,
   set,
   runTests,
@@ -8408,6 +8453,7 @@ export {
   removeIn,
   remove,
   phaseOps,
+  phaseHasBubble,
   mergeWith,
   mergeDeepWith,
   mergeDeep,
@@ -8443,6 +8489,7 @@ export {
   getComponentsDocs,
   get,
   fromJS,
+  expect,
   drive,
   docComponents,
   dispatchPhase,

package/dist/tutuca-dev.js

@@ -3376,7 +3376,6 @@ function jestMatchers(chai, utils) {
 
 // deps/chai.js
 use(jestMatchers);
-
 // deps/immutable.js
 function invariant(condition, error) {
   if (!condition)
@@ -9493,37 +9492,47 @@ class Renderer {
   renderEach(stack, iterInfo, node, viewName) {
     const { seq, filter, loopWith } = iterInfo.eval(stack);
     const r = [];
-    const { iterData, start, end } = unpackLoopResult(loopWith.call(stack.it, seq), seq);
-    getSeqInfo(seq)(seq, (key, value, attrName) => {
-      if (filter.call(stack.it, key, value, iterData)) {
-        const dom = this.renderIt(stack.enter(value, { key }, true), node, key, viewName);
-        this.pushEachEntry(r, node.nodeId, attrName, key, dom);
-      }
-    }, start, end);
+    const { iterData, start, end, keys } = unpackLoopResult(loopWith.call(stack.it, seq, makeLoopCtx(stack, filter)), seq);
+    const renderOne = (key, value, attrName) => {
+      const dom = this.renderIt(stack.enter(value, { key }, true), node, key, viewName);
+      this.pushEachEntry(r, node.nodeId, attrName, key, dom);
+    };
+    if (keys)
+      imKeysIter(seq, renderOne, keys);
+    else
+      getSeqInfo(seq)(seq, (key, value, attrName) => {
+        if (filter.call(stack.it, key, value, iterData))
+          renderOne(key, value, attrName);
+      }, start, end);
     return r;
   }
   renderEachWhen(stack, iterInfo, view, nid) {
     const { seq, filter, loopWith, enricher } = iterInfo.eval(stack);
     const r = [];
     const it = stack.it;
-    const { iterData, start, end } = unpackLoopResult(loopWith.call(it, seq), seq);
-    getSeqInfo(seq)(seq, (key, value, attrName) => {
-      if (filter.call(it, key, value, iterData)) {
-        const cachePath = enricher ? [view, it, value] : [view, value];
-        const binds = { key, value };
-        const cacheKey = `${nid}-${key}`;
-        if (enricher)
-          enricher.call(it, binds, key, value, iterData);
-        const cachedNode = this.cache.get(cachePath, cacheKey);
-        if (cachedNode)
-          this.pushEachEntry(r, nid, attrName, key, cachedNode);
-        else {
-          const dom = this.renderView(view, stack.enter(value, binds, false));
-          this.pushEachEntry(r, nid, attrName, key, dom);
-          this.cache.set(cachePath, cacheKey, dom);
-        }
+    const { iterData, start, end, keys } = unpackLoopResult(loopWith.call(it, seq, makeLoopCtx(stack, filter)), seq);
+    const renderOne = (key, value, attrName) => {
+      const cachePath = enricher ? [view, it, value] : [view, value];
+      const binds = { key, value };
+      const cacheKey = `${nid}-${key}`;
+      if (enricher)
+        enricher.call(it, binds, key, value, iterData);
+      const cachedNode = this.cache.get(cachePath, cacheKey);
+      if (cachedNode)
+        this.pushEachEntry(r, nid, attrName, key, cachedNode);
+      else {
+        const dom = this.renderView(view, stack.enter(value, binds, false));
+        this.pushEachEntry(r, nid, attrName, key, dom);
+        this.cache.set(cachePath, cacheKey, dom);
       }
-    }, start, end);
+    };
+    if (keys)
+      imKeysIter(seq, renderOne, keys);
+    else
+      getSeqInfo(seq)(seq, (key, value, attrName) => {
+        if (filter.call(it, key, value, iterData))
+          renderOne(key, value, attrName);
+      }, start, end);
     return r;
   }
   renderView(view, stack) {
@@ -9559,8 +9568,17 @@ var filterAlwaysTrue = (_v, _k, _seq) => true;
 var nullLoopWith = (seq) => ({ iterData: { seq } });
 var unpackLoopResult = (result, seq) => {
   const r = result ?? {};
-  return { iterData: r.iterData ?? { seq }, start: r.start, end: r.end };
+  return { iterData: r.iterData ?? { seq }, start: r.start, end: r.end, keys: r.keys };
+};
+var imKeysIter = (seq, visit, keys) => {
+  const attrName = isIndexed(seq) ? "si" : "sk";
+  for (const key of keys)
+    visit(key, seq.get(key), attrName);
 };
+var makeLoopCtx = (stack, filter) => ({
+  lookup: (name) => stack.lookupBind(name),
+  filter: (key, value, iterData) => filter.call(stack.it, key, value, iterData)
+});
 var imIndexedIter = (seq, visit, start, end) => {
   const [s, e] = normalizeRange(start, end, seq.size);
   for (let i = s;i < e; i++)
@@ -10108,11 +10126,11 @@ class IterInfo {
     return { seq, filter, loopWith, enricher };
   }
   enrichBinds(stack, key) {
-    const { seq, loopWith, enricher } = this.eval(stack);
+    const { seq, filter, loopWith, enricher } = this.eval(stack);
     const value = seq?.get ? seq.get(key, null) : null;
     const binds = { key, value };
     if (enricher) {
-      const { iterData } = unpackLoopResult(loopWith.call(stack.it, seq), seq);
+      const { iterData } = unpackLoopResult(loopWith.call(stack.it, seq, makeLoopCtx(stack, filter)), seq);
       enricher.call(stack.it, binds, key, value, iterData);
     }
     return binds;
@@ -11121,7 +11139,6 @@ var RAW_TEXT_ELEMENTS = new Set([
   "xmp",
   "plaintext"
 ]);
-var RCDATA_ELEMENTS = new Set(["textarea", "title"]);
 var SPECIAL_ELEMENTS = new Set([
   "address",
   "applet",
@@ -11236,7 +11253,6 @@ var SCOPE_LIST_ITEM = new Set([...DEFAULT_SCOPE_BOUNDARIES, "ol", "ul"]);
 var SCOPE_BUTTON = new Set([...DEFAULT_SCOPE_BOUNDARIES, "button"]);
 var SCOPE_DEFAULT = DEFAULT_SCOPE_BOUNDARIES;
 var SCOPE_TABLE = new Set(["html", "table", "template"]);
-var SCOPE_SELECT = new Set;
 var STANDARD_SVG_CAMEL_ELEMENTS = new Set([
   "altGlyph",
   "altGlyphDef",
@@ -11388,7 +11404,6 @@ var FOREIGN_BREAKOUT_TAGS = new Set([
   "ul",
   "var"
 ]);
-var MATHML_TEXT_INTEGRATION_POINTS = new Set(["mi", "mo", "mn", "ms", "mtext"]);
 var BLOCK_LEVEL_AUTO_CLOSE_P = new Set([
   "address",
   "article",
@@ -11431,7 +11446,6 @@ var BLOCK_LEVEL_AUTO_CLOSE_P = new Set([
   "dd",
   "dt"
 ]);
-var SELECT_VALID_CHILDREN = new Set(["option", "optgroup", "hr", "script", "template"]);
 var SELECT_BREAKOUT_TAGS = new Set(["input", "keygen", "textarea", "select"]);
 var MODES = Object.freeze({
   inBody: "inBody",
@@ -13691,6 +13705,13 @@ function phaseOps(phase) {
 function resolveArgs(args, self) {
   return typeof args === "function" ? args(self) ?? [] : args ?? [];
 }
+function phaseHasBubble(phase) {
+  if (!phase)
+    return false;
+  if (phase.bubble?.length)
+    return true;
+  return (phase.do ?? []).some((op) => op.type === "bubble");
+}
 function dispatchPhase(dispatcher, targetPath, phase, self) {
   if (!phase)
     return;
@@ -14627,6 +14648,8 @@ async function driveStack(stack, value, phase, opts = {}) {
       const t = info?.transaction;
       opts.onMessage({ kind: t?.handlerProp ?? "input", name: t?.name, args: t?.args, path: t?.path }, old, val);
     });
+  if (phaseHasBubble(phase))
+    console.warn("drive(): a `bubble` action is a no-op here — drive originates at the root and bubbles travel child→parent, so there is no ancestor to receive it (and the root's own bubble handler is skipped). To exercise a bubble handler, call it directly.");
   dispatchPhase(rootDispatcher(transactor), new Path([]), phase, value);
   await transactor.settle();
   return transactor.state.val;
@@ -15558,7 +15581,8 @@ class FieldSet extends Field {
 }
 function mkCompField(field, scope, args) {
   const Comp = scope?.lookupComponent(field.type) ?? null;
-  console.assert(!scope || Comp !== null, "component not found", { field });
+  if (Comp === null)
+    console.warn(scope ? `component field "${field.name}": component "${field.type}" not found in scope` : `component field "${field.name}": cannot resolve component "${field.type}" — built without a registered scope (use ${field.type}.make({}) as the default, or build via a registered component)`);
   return Comp?.make({ ...field.args, ...args }, { scope }) ?? null;
 }
 
@@ -15732,13 +15756,30 @@ function resolveAlter(Comp, name) {
   }
   return fn;
 }
+var seqGet = (seq, key) => Array.isArray(seq) ? seq[key] : seq.get ? seq.get(key) : seq[key];
 function collectIterBindings(Comp, compInstance, seq, opts = {}) {
   const whenFn = resolveAlter(Comp, opts.when) ?? filterAlwaysTrue;
   const loopWithFn = resolveAlter(Comp, opts.loopWith) ?? nullLoopWith;
   const enrichFn = resolveAlter(Comp, opts.enrichWith);
+  const scopeEnrichFn = resolveAlter(Comp, opts.scopeEnrich);
   const it = compInstance;
-  const { iterData, start, end } = unpackLoopResult(loopWithFn.call(it, seq), seq);
+  const scope = scopeEnrichFn ? scopeEnrichFn.call(it) ?? {} : opts.scope ?? {};
+  const ctx = {
+    lookup: (name) => scope[name],
+    filter: (key, value, iterData2) => whenFn.call(it, key, value, iterData2)
+  };
+  const { iterData, start, end, keys } = unpackLoopResult(loopWithFn.call(it, seq, ctx), seq);
   const out = [];
+  if (keys) {
+    for (const key of keys) {
+      const value = seqGet(seq, key);
+      const binds = { key, value };
+      if (enrichFn)
+        enrichFn.call(it, binds, key, value, iterData);
+      out.push(binds);
+    }
+    return out;
+  }
   const iter = pickIter(seq);
   iter(seq, (key, value) => {
     if (!whenFn.call(it, key, value, iterData))
@@ -15927,20 +15968,23 @@ async function test3(opts = {}) {
   reportTestReportToConsole(report);
   return report;
 }
+function shadowCheckComponent(Comp) {
+  const shadowViews = {};
+  for (const name in Comp.views) {
+    const rawView = Comp.views[name].rawView;
+    const ctx = new LintParseContext;
+    ANode.parse(rawView, ctx);
+    ctx.compile(Comp.scope);
+    shadowViews[name] = { name, ctx, rawView };
+  }
+  const shadowComp = Object.create(Comp);
+  shadowComp.views = shadowViews;
+  return checkComponent(shadowComp).reports;
+}
 function check(app) {
   const counts = { error: 0, warn: 0, hint: 0 };
   for (const Comp of app.comps.byId.values()) {
-    const shadowViews = {};
-    for (const name in Comp.views) {
-      const rawView = Comp.views[name].rawView;
-      const ctx = new LintParseContext;
-      ANode.parse(rawView, ctx);
-      ctx.compile(Comp.scope);
-      shadowViews[name] = { name, ctx, rawView };
-    }
-    const shadowComp = Object.create(Comp);
-    shadowComp.views = shadowViews;
-    const { reports } = checkComponent(shadowComp);
+    const reports = shadowCheckComponent(Comp);
     if (reports.length === 0)
       continue;
     console.group(Comp.name);
@@ -15994,6 +16038,7 @@ export {
   tutuca,
   test3 as test,
   suggestionToMessage,
+  shadowCheckComponent,
   setIn$1 as setIn,
   set2 as set,
   runTests,
@@ -16002,6 +16047,7 @@ export {
   removeIn,
   remove,
   phaseOps,
+  phaseHasBubble,
   mergeWith$1 as mergeWith,
   mergeDeepWith$1 as mergeDeepWith,
   mergeDeep$1 as mergeDeep,
@@ -16037,6 +16083,7 @@ export {
   getComponentsDocs,
   get2 as get,
   fromJS,
+  expect,
   drive,
   docComponents,
   dispatchPhase,