@wildwinter/expr-editor 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -288,6 +288,13 @@ var choicesOf = (e) => {
   if (e.type === "enum") return e.enumValues;
   return void 0;
 };
+var propertyTip = (e) => {
+  if (!e) return void 0;
+  const lines = [];
+  if (e.purpose) lines.push(e.purpose);
+  if (e.type === "quality" && e.stages?.length) lines.push(`Stages: ${e.stages.join(" \u2192 ")}`);
+  return lines.length ? lines.join("\n") : void 0;
+};
 var refOf = (e, defaultScope) => e.scope === defaultScope ? `@${e.name}` : `@${e.scope}.${e.name}`;
 var displayName = (e, defaultScope) => e.scope === defaultScope ? e.name : `${e.scope}.${e.name}`;
 function filterCatalogue(entries, filter = {}) {
@@ -459,7 +466,12 @@ function renderNode(node, path, ctx, parentOp, side) {
     case "scopedvar": {
       const entry = lookup(ctx.catalogue, node.scope, node.name);
       const label = displayName({ scope: node.scope, name: node.name }, ctx.defaultScope);
-      const varPill = pill("var", label, (b) => variableEditor(ctx, path, node, b), { issue: issue ?? (entry ? void 0 : `Unknown property ${label}`) });
+      const varPill = pill(
+        "var",
+        label,
+        (b) => variableEditor(ctx, path, node, b),
+        { issue: issue ?? (entry ? void 0 : `Unknown property ${label}`), title: propertyTip(entry) }
+      );
       attachPropertyMenu(ctx, node, varPill);
       return varPill;
     }
@@ -1545,8 +1557,14 @@ function mountEffectsEditor(host, opts) {
       scopeOrder: opts.scopeOrder,
       functions: opts.functions,
       mode: "flat",
+      // Every editor here holds a VALUE (a set's value, an emit's argument), never a condition. Say
+      // so, or emptying one falls back to the condition empty state and an outcome row reads
+      // "always / + Add your first condition" - condition vocabulary, offering clauses where a value
+      // belongs, and no way back to a value. `valueField` renders an editable empty literal instead.
+      valueField: true,
       ...addTerm ? { addTerm } : {},
       ...selfAdvanceRef ? { selfAdvanceRef } : {},
+      ...opts.propertyActions ? { propertyActions: opts.propertyActions } : {},
       ...opts.popoverContainer ? { popoverContainer: opts.popoverContainer } : {},
       text: textMode,
       onChange
@@ -1597,6 +1615,24 @@ function mountEffectsEditor(host, opts) {
         commit(updateAt(effects, i, { target: refOf(entry, defaultScope), value: initialValueFor(entry, defaultScope).src }));
       });
     }, "change the target property");
+    const targetEntry = opts.catalogue.find((e) => refOf(e, defaultScope) === eff.target);
+    const tip = propertyTip(targetEntry);
+    if (tip) targetBtn.title = tip;
+    if (targetEntry && opts.propertyActions) {
+      const actions = opts.propertyActions({ scope: targetEntry.scope, name: targetEntry.name });
+      if (actions.length) targetBtn.addEventListener("contextmenu", (e) => {
+        e.preventDefault();
+        closePopover();
+        popover = openPopover(targetBtn, (close) => {
+          const wrap = el("div", "exed-menu");
+          for (const a of actions) wrap.append(button("exed-opt", a.label, () => {
+            a.run();
+            close();
+          }));
+          return wrap;
+        }, { container: opts.popoverContainer });
+      });
+    }
     const advances = isSelfAdvance(eff, defaultScope, opts.dialect);
     row.append(targetBtn);
     if (!advances) row.append(el("span", "exed-effect-eq", ["="]));
@@ -1832,6 +1868,7 @@ exports.numLit = numLit;
 exports.opSwapGroup = opSwapGroup;
 exports.pathKey = pathKey;
 exports.placeholderForOp = placeholderForOp;
+exports.propertyTip = propertyTip;
 exports.redirectDeleteForPlaceholderSibling = redirectDeleteForPlaceholderSibling;
 exports.refOf = refOf;
 exports.removeArgAt = removeArgAt;