tutuca 0.9.89 → 0.9.90

package/dist/tutuca-cli.js

@@ -3422,12 +3422,20 @@ var init_chai2 = __esm(() => {
 
 // tools/core/module.js
 class Example {
-  constructor({ title, description = null, value, view = "main", componentName = null }) {
+  constructor({
+    title,
+    description = null,
+    value,
+    view = "main",
+    componentName = null,
+    requestHandlerNames = []
+  }) {
     this.title = title;
     this.description = description;
     this.value = value;
     this.view = view;
     this.componentName = componentName;
+    this.requestHandlerNames = requestHandlerNames;
   }
 }
 function resolveComponentName(value, components) {
@@ -3471,12 +3479,17 @@ function parseExample(raw, index, components, parentPath) {
   if (raw.value === undefined) {
     throw shapeError(`example at ${where} missing "value"`, where);
   }
+  const rh = raw.requestHandlers;
+  if (rh != null && (typeof rh !== "object" || Array.isArray(rh))) {
+    throw shapeError(`example at ${where} "requestHandlers" must be an object of functions`, where);
+  }
   return new Example({
     title: raw.title ?? `Example ${index + 1}`,
     description: raw.description ?? null,
     value: raw.value,
     view: raw.view ?? "main",
-    componentName: resolveComponentName(raw.value, components)
+    componentName: resolveComponentName(raw.value, components),
+    requestHandlerNames: rh ? Object.keys(rh) : []
   });
 }
 function parseSection(raw, components, where) {
@@ -8186,6 +8199,17 @@ class Path {
     }
     return curVal;
   }
+  resolveChain(root) {
+    const out = [root];
+    let curVal = root;
+    for (const step of this.steps) {
+      curVal = step.lookup(curVal, NONE);
+      if (curVal === NONE)
+        break;
+      out.push(curVal);
+    }
+    return out;
+  }
   setValue(root, v) {
     const intermediates = new Array(this.steps.length);
     let curVal = root;
@@ -13290,9 +13314,13 @@ function checkUnknownSpecKeys(lx, Comp, wellKnownExtras) {
     return;
   let candidates = null;
   for (const key of Object.keys(extra)) {
-    if (wellKnownExtras.has(key))
+    if (FRAMEWORK_WELL_KNOWN_EXTRAS.has(key) || wellKnownExtras.has(key))
       continue;
-    candidates ??= [...KNOWN_COMPONENT_SPEC_KEYS, ...wellKnownExtras];
+    candidates ??= [
+      ...KNOWN_COMPONENT_SPEC_KEYS,
+      ...FRAMEWORK_WELL_KNOWN_EXTRAS,
+      ...wellKnownExtras
+    ];
     lx.warn(UNKNOWN_COMPONENT_SPEC_KEY, { key }, replaceNameSuggestion(key, candidates));
   }
 }
@@ -13424,12 +13452,13 @@ 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", PROVIDE_NOT_ADDRESSABLE = "PROVIDE_NOT_ADDRESSABLE", LOOKUP_BAD_SHAPE = "LOOKUP_BAD_SHAPE", LOOKUP_TARGET_MALFORMED = "LOOKUP_TARGET_MALFORMED", 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", ASYNC_HANDLER = "ASYNC_HANDLER", 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, HANDLER_CHANNELS, ASYNC_HANDLER_HELP, KNOWN_LOOKUP_KEYS, LintParseContext;
+var KNOWN_COMPONENT_SPEC_KEYS, EMPTY_SET2, FRAMEWORK_WELL_KNOWN_EXTRAS, 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", PROVIDE_NOT_ADDRESSABLE = "PROVIDE_NOT_ADDRESSABLE", LOOKUP_BAD_SHAPE = "LOOKUP_BAD_SHAPE", LOOKUP_TARGET_MALFORMED = "LOOKUP_TARGET_MALFORMED", 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", ASYNC_HANDLER = "ASYNC_HANDLER", 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, HANDLER_CHANNELS, ASYNC_HANDLER_HELP, KNOWN_LOOKUP_KEYS, LintParseContext;
 var init_lint_check = __esm(() => {
   init_anode();
   init_htmllinter();
   KNOWN_COMPONENT_SPEC_KEYS = new Set("name view style commonStyle globalStyle input receive bubble response alter views provide lookup fields methods statics".split(" "));
   EMPTY_SET2 = new Set;
+  FRAMEWORK_WELL_KNOWN_EXTRAS = new Set(["requestOverridesField"]);
   KNOWN_DIRECTIVE_NAMES = new Set([
     "dangerouslysetinnerhtml",
     "slot",
@@ -13858,6 +13887,7 @@ class Transactor {
     const txnPath = path.toTransactionPath();
     const curLeaf = txnPath.lookup(curRoot);
     const handler = this.comps.getRequestFor(curLeaf, name) ?? mkReq404(name);
+    const reqCtx = new RequestContext(path, this, parent, curRoot);
     const resHandlerName = opts?.onResName ?? name;
     const resPath = opts?.livePath ? null : txnPath.pinKeys(curRoot);
     const push = (specificName, baseName, singleArg, result, error) => {
@@ -13866,7 +13896,7 @@ class Transactor {
       this.pushTransaction(t);
     };
     try {
-      const result = await handler.fn.apply(null, args);
+      const result = await handler.fn.apply(null, [...args, reqCtx]);
       push(opts?.onOkName, resHandlerName, result, result, null);
     } catch (error) {
       push(opts?.onErrorName, resHandlerName, error, null, error);
@@ -13983,10 +14013,20 @@ class Task {
 }
 
 class Dispatcher {
-  constructor(path, transactor, parentTransaction) {
+  constructor(path, transactor, parentTransaction, root = transactor.state.val) {
     this.path = path;
     this.transactor = transactor;
     this.parent = parentTransaction;
+    this.root = root;
+  }
+  walkPath(callback) {
+    const comps = this.transactor.comps;
+    const chain = this.path.toTransactionPath().resolveChain(this.root);
+    for (let i = chain.length - 1;i >= 0; i--) {
+      const comp = comps.getCompFor(chain[i]);
+      if (comp && callback(comp, chain[i]) === false)
+        return;
+    }
   }
   get at() {
     return new PathChanges(this);
@@ -14010,7 +14050,7 @@ class Dispatcher {
     return this.transactor.comps.getCompFor(inst).scope.lookupComponent(name);
   }
 }
-var toNullIfNaN = (v) => Number.isNaN(v) ? null : v, InputEvent, NameArgsTransaction, ResponseEvent, SendEvent, BubbleEvent, EventContext, PathChanges;
+var toNullIfNaN = (v) => Number.isNaN(v) ? null : v, InputEvent, NameArgsTransaction, ResponseEvent, SendEvent, BubbleEvent, EventContext, RequestContext, PathChanges;
 var init_transactor = __esm(() => {
   init_path();
   init_stack();
@@ -14146,6 +14186,8 @@ var init_transactor = __esm(() => {
       return this.parent.stopPropagation();
     }
   };
+  RequestContext = class RequestContext extends Dispatcher {
+  };
   PathChanges = class PathChanges extends PathBuilder {
     constructor(dispatcher) {
       super();
@@ -15858,7 +15900,8 @@ async function discoverModules(projectDir, devModuleUrls) {
           items: s.items.map((it) => ({
             title: it.title,
             view: it.view,
-            componentName: it.componentName
+            componentName: it.componentName,
+            requestHandlers: it.requestHandlerNames
           }))
         })),
         macros: normalized.macros ? Object.keys(normalized.macros) : [],

package/dist/tutuca-dev.ext.js

@@ -348,6 +348,17 @@ class Path {
     }
     return curVal;
   }
+  resolveChain(root) {
+    const out = [root];
+    let curVal = root;
+    for (const step of this.steps) {
+      curVal = step.lookup(curVal, NONE);
+      if (curVal === NONE)
+        break;
+      out.push(curVal);
+    }
+    return out;
+  }
   setValue(root, v) {
     const intermediates = new Array(this.steps.length);
     let curVal = root;
@@ -4971,6 +4982,7 @@ function closestName(name, candidates, maxDistance = 2) {
 // tools/core/lint-check.js
 var KNOWN_COMPONENT_SPEC_KEYS = new Set("name view style commonStyle globalStyle input receive bubble response alter views provide lookup fields methods statics".split(" "));
 var EMPTY_SET = new Set;
+var FRAMEWORK_WELL_KNOWN_EXTRAS = new Set(["requestOverridesField"]);
 var KNOWN_DIRECTIVE_NAMES = new Set([
   "dangerouslysetinnerhtml",
   "slot",
@@ -5565,9 +5577,13 @@ function checkUnknownSpecKeys(lx, Comp, wellKnownExtras) {
     return;
   let candidates = null;
   for (const key of Object.keys(extra)) {
-    if (wellKnownExtras.has(key))
+    if (FRAMEWORK_WELL_KNOWN_EXTRAS.has(key) || wellKnownExtras.has(key))
       continue;
-    candidates ??= [...KNOWN_COMPONENT_SPEC_KEYS, ...wellKnownExtras];
+    candidates ??= [
+      ...KNOWN_COMPONENT_SPEC_KEYS,
+      ...FRAMEWORK_WELL_KNOWN_EXTRAS,
+      ...wellKnownExtras
+    ];
     lx.warn(UNKNOWN_COMPONENT_SPEC_KEY, { key }, replaceNameSuggestion(key, candidates));
   }
 }
@@ -6776,6 +6792,7 @@ class Transactor {
     const txnPath = path.toTransactionPath();
     const curLeaf = txnPath.lookup(curRoot);
     const handler = this.comps.getRequestFor(curLeaf, name) ?? mkReq404(name);
+    const reqCtx = new RequestContext(path, this, parent, curRoot);
     const resHandlerName = opts?.onResName ?? name;
     const resPath = opts?.livePath ? null : txnPath.pinKeys(curRoot);
     const push = (specificName, baseName, singleArg, result, error) => {
@@ -6784,7 +6801,7 @@ class Transactor {
       this.pushTransaction(t);
     };
     try {
-      const result = await handler.fn.apply(null, args);
+      const result = await handler.fn.apply(null, [...args, reqCtx]);
       push(opts?.onOkName, resHandlerName, result, result, null);
     } catch (error) {
       push(opts?.onErrorName, resHandlerName, error, null, error);
@@ -7027,10 +7044,20 @@ class Task {
 }
 
 class Dispatcher {
-  constructor(path, transactor, parentTransaction) {
+  constructor(path, transactor, parentTransaction, root = transactor.state.val) {
     this.path = path;
     this.transactor = transactor;
     this.parent = parentTransaction;
+    this.root = root;
+  }
+  walkPath(callback) {
+    const comps = this.transactor.comps;
+    const chain = this.path.toTransactionPath().resolveChain(this.root);
+    for (let i = chain.length - 1;i >= 0; i--) {
+      const comp = comps.getCompFor(chain[i]);
+      if (comp && callback(comp, chain[i]) === false)
+        return;
+    }
   }
   get at() {
     return new PathChanges(this);
@@ -7067,6 +7094,9 @@ class EventContext extends Dispatcher {
   }
 }
 
+class RequestContext extends Dispatcher {
+}
+
 class PathChanges extends PathBuilder {
   constructor(dispatcher) {
     super();

package/dist/tutuca-dev.js

@@ -8002,6 +8002,17 @@ class Path {
     }
     return curVal;
   }
+  resolveChain(root) {
+    const out = [root];
+    let curVal = root;
+    for (const step of this.steps) {
+      curVal = step.lookup(curVal, NONE);
+      if (curVal === NONE)
+        break;
+      out.push(curVal);
+    }
+    return out;
+  }
   setValue(root, v) {
     const intermediates = new Array(this.steps.length);
     let curVal = root;
@@ -12622,6 +12633,7 @@ function closestName(name, candidates, maxDistance = 2) {
 // tools/core/lint-check.js
 var KNOWN_COMPONENT_SPEC_KEYS = new Set("name view style commonStyle globalStyle input receive bubble response alter views provide lookup fields methods statics".split(" "));
 var EMPTY_SET2 = new Set;
+var FRAMEWORK_WELL_KNOWN_EXTRAS = new Set(["requestOverridesField"]);
 var KNOWN_DIRECTIVE_NAMES = new Set([
   "dangerouslysetinnerhtml",
   "slot",
@@ -13216,9 +13228,13 @@ function checkUnknownSpecKeys(lx, Comp, wellKnownExtras) {
     return;
   let candidates = null;
   for (const key of Object.keys(extra)) {
-    if (wellKnownExtras.has(key))
+    if (FRAMEWORK_WELL_KNOWN_EXTRAS.has(key) || wellKnownExtras.has(key))
       continue;
-    candidates ??= [...KNOWN_COMPONENT_SPEC_KEYS, ...wellKnownExtras];
+    candidates ??= [
+      ...KNOWN_COMPONENT_SPEC_KEYS,
+      ...FRAMEWORK_WELL_KNOWN_EXTRAS,
+      ...wellKnownExtras
+    ];
     lx.warn(UNKNOWN_COMPONENT_SPEC_KEY, { key }, replaceNameSuggestion(key, candidates));
   }
 }
@@ -14427,6 +14443,7 @@ class Transactor {
     const txnPath = path.toTransactionPath();
     const curLeaf = txnPath.lookup(curRoot);
     const handler = this.comps.getRequestFor(curLeaf, name) ?? mkReq404(name);
+    const reqCtx = new RequestContext(path, this, parent, curRoot);
     const resHandlerName = opts?.onResName ?? name;
     const resPath = opts?.livePath ? null : txnPath.pinKeys(curRoot);
     const push = (specificName, baseName, singleArg, result, error) => {
@@ -14435,7 +14452,7 @@ class Transactor {
       this.pushTransaction(t);
     };
     try {
-      const result = await handler.fn.apply(null, args);
+      const result = await handler.fn.apply(null, [...args, reqCtx]);
       push(opts?.onOkName, resHandlerName, result, result, null);
     } catch (error) {
       push(opts?.onErrorName, resHandlerName, error, null, error);
@@ -14678,10 +14695,20 @@ class Task {
 }
 
 class Dispatcher {
-  constructor(path, transactor, parentTransaction) {
+  constructor(path, transactor, parentTransaction, root = transactor.state.val) {
     this.path = path;
     this.transactor = transactor;
     this.parent = parentTransaction;
+    this.root = root;
+  }
+  walkPath(callback) {
+    const comps = this.transactor.comps;
+    const chain = this.path.toTransactionPath().resolveChain(this.root);
+    for (let i = chain.length - 1;i >= 0; i--) {
+      const comp = comps.getCompFor(chain[i]);
+      if (comp && callback(comp, chain[i]) === false)
+        return;
+    }
   }
   get at() {
     return new PathChanges(this);
@@ -14718,6 +14745,9 @@ class EventContext extends Dispatcher {
   }
 }
 
+class RequestContext extends Dispatcher {
+}
+
 class PathChanges extends PathBuilder {
   constructor(dispatcher) {
     super();