@wildwinter/expr-editor 0.15.3 → 0.16.0

package/README.md

@@ -35,6 +35,12 @@ Notable options beyond the basics:
   multi-step flow (e.g. tag → operator → threshold) with no editor changes.
   Templates without a wizard insert-then-refine: the editor auto-opens the
   first unfilled slot of the inserted clause.
+- `otherEngineScopes`: scopes another engine owns (a product family's shared
+  vocabulary, such as `patter` in a Storylets card). Their names never appear in
+  the host's catalogue, because the other engine checks them, so a reference into
+  one renders as an ordinary property pill with a tip saying whose it is, instead
+  of an unknown property. Accepted by the expression editor, the effects editor,
+  and the previews.
 - **Qualities** (the `quality` property type) need nothing from the host beyond a
   catalogue entry carrying `stages` — the ladder, in order. The editor then offers
   the property in a comparison clause, gives it the **ordering** operators (a

package/dist/index.cjs

@@ -309,6 +309,20 @@ function searchCatalogue(entries, query, defaultScope) {
   if (!q) return [...entries];
   return entries.filter((e) => displayName(e, defaultScope).toLowerCase().includes(q) || (e.purpose ?? "").toLowerCase().includes(q));
 }
+function otherEngineTip(label) {
+  return `${label} belongs to another engine, which checks it`;
+}
+function propertyPillNote(entry, scope, label, otherEngineScopes) {
+  if (entry) {
+    const title = propertyTip(entry);
+    return title ? { title } : {};
+  }
+  if (otherEngineScopes?.includes(scope)) return { title: otherEngineTip(label) };
+  return { issue: `Unknown property ${label}` };
+}
+function scopeOfRef(ref) {
+  return /^@([^.\s]+)\./.exec(ref)?.[1];
+}
 function groupByScope(entries, scopeOrder = []) {
   const byScope = /* @__PURE__ */ new Map();
   for (const e of entries) {
@@ -482,11 +496,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 note = propertyPillNote(entry, node.scope, label, ctx.otherEngineScopes);
       const varPill = pill(
         "var",
         label,
         (b) => variableEditor(ctx, path, node, b),
-        { issue: issue ?? (entry ? void 0 : `Unknown property ${label}`), title: propertyTip(entry) }
+        { issue: issue ?? note.issue, title: note.title }
       );
       attachPropertyMenu(ctx, node, varPill);
       return varPill;
@@ -1167,6 +1182,7 @@ function mountExpressionEditor(host, opts) {
       catalogue: opts.catalogue,
       scopeOrder: opts.scopeOrder ?? [],
       functions: opts.functions ?? [],
+      ...opts.otherEngineScopes ? { otherEngineScopes: opts.otherEngineScopes } : {},
       byPath: v.byPath,
       getAst: () => ast,
       apply: (next) => emit(toSrc(next)),
@@ -1608,6 +1624,7 @@ function mountEffectsEditor(host, opts) {
       scopeOrder: opts.scopeOrder,
       functions: opts.functions,
       mode: "flat",
+      ...opts.otherEngineScopes ? { otherEngineScopes: opts.otherEngineScopes } : {},
       // 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
@@ -1667,7 +1684,8 @@ function mountEffectsEditor(host, opts) {
       });
     }, "change the target property");
     const targetEntry = entryForTarget(opts.catalogue, eff.target, defaultScope);
-    const tip = propertyTip(targetEntry);
+    const targetScope = targetEntry ? void 0 : scopeOfRef(eff.target);
+    const tip = targetScope !== void 0 && opts.otherEngineScopes?.includes(targetScope) ? otherEngineTip(eff.target) : propertyTip(targetEntry);
     if (tip) targetBtn.title = tip;
     if (targetEntry && opts.propertyActions) {
       const actions = opts.propertyActions({ scope: targetEntry.scope, name: targetEntry.name });
@@ -1811,6 +1829,7 @@ function frozenCtx(src, o, selfAdvanceRef) {
     catalogue: o.catalogue,
     scopeOrder: o.scopeOrder ?? [],
     functions: [],
+    ...o.otherEngineScopes ? { otherEngineScopes: o.otherEngineScopes } : {},
     compact: true,
     byPath: v.byPath,
     getAst: () => v.ast,
@@ -1843,7 +1862,11 @@ function renderConditionPreview(src, o) {
 function targetPill(ref, o) {
   const pill2 = el("span", "exed-pill exed-pill-prop", [ref || "(property)"]);
   const entry = o.catalogue.find((e) => refOf(e, o.dialect.defaultScope) === ref);
-  if (!entry) return pill2;
+  if (!entry) {
+    const scope = scopeOfRef(ref);
+    if (scope !== void 0 && o.otherEngineScopes?.includes(scope)) pill2.title = otherEngineTip(ref);
+    return pill2;
+  }
   const tip = propertyTip(entry);
   if (tip) pill2.title = tip;
   const actions = o.propertyActions?.({ scope: entry.scope, name: entry.name }) ?? [];
@@ -1924,8 +1947,10 @@ exports.normaliseRef = normaliseRef;
 exports.notNode = notNode;
 exports.numLit = numLit;
 exports.opSwapGroup = opSwapGroup;
+exports.otherEngineTip = otherEngineTip;
 exports.pathKey = pathKey;
 exports.placeholderForOp = placeholderForOp;
+exports.propertyPillNote = propertyPillNote;
 exports.propertyTip = propertyTip;
 exports.redirectDeleteForPlaceholderSibling = redirectDeleteForPlaceholderSibling;
 exports.refOf = refOf;
@@ -1934,6 +1959,7 @@ exports.removeAt = removeAt;
 exports.renderConditionPreview = renderConditionPreview;
 exports.renderEffectsPreview = renderEffectsPreview;
 exports.rhsTypesFor = rhsTypesFor;
+exports.scopeOfRef = scopeOfRef;
 exports.scopedVar = scopedVar;
 exports.searchCatalogue = searchCatalogue;
 exports.seedValueSrc = seedValueSrc;