@timeax/digital-service-engine 0.2.7 → 0.2.9

package/dist/react/index.js

@@ -1260,13 +1260,7 @@ function resolveRootTags(tags) {
   const roots = tags.filter((t) => !t.bind_id);
   return roots.length ? roots : tags.slice(0, 1);
 }
-function isEffectfulTrigger(v, trigger) {
-  var _a, _b, _c, _d, _e, _f;
-  const inc = (_a = v.props.includes_for_buttons) != null ? _a : {};
-  const exc = (_b = v.props.excludes_for_buttons) != null ? _b : {};
-  return ((_d = (_c = inc[trigger]) == null ? void 0 : _c.length) != null ? _d : 0) > 0 || ((_f = (_e = exc[trigger]) == null ? void 0 : _e.length) != null ? _f : 0) > 0;
-}
-function collectSelectableTriggersInContext(v, tagId, selectedKeys, onlyEffectful) {
+function collectSelectableTriggersInContext(v, tagId, selectedKeys, effectfulKeys) {
   var _a;
   const visible = visibleFieldsUnder(v.props, tagId, {
     selectedKeys
@@ -1275,11 +1269,11 @@ function collectSelectableTriggersInContext(v, tagId, selectedKeys, onlyEffectfu
   for (const f of visible) {
     if (f.button === true) {
       const t = f.id;
-      if (!onlyEffectful || isEffectfulTrigger(v, t)) triggers.push(t);
+      if (effectfulKeys.has(t)) triggers.push(t);
     }
     for (const o of (_a = f.options) != null ? _a : []) {
-      const t = `${f.id}::${o.id}`;
-      if (!onlyEffectful || isEffectfulTrigger(v, t)) triggers.push(t);
+      const t = o.id;
+      if (effectfulKeys.has(t)) triggers.push(t);
     }
   }
   triggers.sort();
@@ -1379,20 +1373,38 @@ function dedupeErrorsInPlace(v, startIndex) {
   v.errors.splice(startIndex, v.errors.length - startIndex, ...kept);
 }
 function validateVisibility(v, options = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e;
+  v.simulatedVisibilityContexts = [];
   const simulate = options.simulate === true;
   if (!simulate) {
     runVisibilityRulesOnce(v);
+    for (const tag of v.tags) {
+      v.simulatedVisibilityContexts.push({
+        tagId: tag.id,
+        selectedKeys: Array.from(v.selectedKeys),
+        visibleFieldIds: v.fieldsVisibleUnder(tag.id).map((f) => f.id)
+      });
+    }
     return;
   }
   const maxStates = Math.max(1, (_a = options.maxStates) != null ? _a : 500);
   const maxDepth = Math.max(0, (_b = options.maxDepth) != null ? _b : 6);
   const onlyEffectful = options.onlyEffectfulTriggers !== false;
+  const effectfulKeys = /* @__PURE__ */ new Set();
+  if (onlyEffectful) {
+    for (const key of Object.keys((_c = v.props.includes_for_buttons) != null ? _c : {})) {
+      effectfulKeys.add(key);
+    }
+    for (const key of Object.keys((_d = v.props.excludes_for_buttons) != null ? _d : {})) {
+      effectfulKeys.add(key);
+    }
+  }
   const roots = resolveRootTags(v.tags);
   const rootTags = options.simulateAllRoots ? roots : roots.slice(0, 1);
-  const originalSelected = new Set((_c = v.selectedKeys) != null ? _c : []);
+  const originalSelected = new Set((_e = v.selectedKeys) != null ? _e : []);
   const errorsStart = v.errors.length;
   const visited = /* @__PURE__ */ new Set();
+  const seenContexts = /* @__PURE__ */ new Set();
   const stack = [];
   for (const rt of rootTags) {
     stack.push({
@@ -1405,10 +1417,27 @@ function validateVisibility(v, options = {}) {
   while (stack.length) {
     if (validatedStates >= maxStates) break;
     const state = stack.pop();
-    const sig = stableKeyOfSelection(state.selected);
+    const sig = `${state.rootTagId}::${stableKeyOfSelection(state.selected)}`;
     if (visited.has(sig)) continue;
     visited.add(sig);
     v.selectedKeys = state.selected;
+    const visibleNow = visibleFieldsUnder(v.props, state.rootTagId, {
+      selectedKeys: state.selected
+    }).map((f) => f.id);
+    const context = {
+      tagId: state.rootTagId,
+      selectedKeys: Array.from(state.selected),
+      visibleFieldIds: visibleNow
+    };
+    const contextKey = [
+      context.tagId,
+      [...context.selectedKeys].sort().join("|"),
+      [...context.visibleFieldIds].sort().join("|")
+    ].join("::");
+    if (!seenContexts.has(contextKey)) {
+      seenContexts.add(contextKey);
+      v.simulatedVisibilityContexts.push(context);
+    }
     validatedStates++;
     runVisibilityRulesOnce(v);
     if (state.depth >= maxDepth) continue;
@@ -1416,7 +1445,7 @@ function validateVisibility(v, options = {}) {
       v,
       state.rootTagId,
       state.selected,
-      onlyEffectful
+      effectfulKeys
     );
     for (let i = triggers.length - 1; i >= 0; i--) {
       const trig = triggers[i];
@@ -1658,8 +1687,8 @@ function validateOptionMaps(v) {
         };
       }
       if (ref.kind === "field") {
-        const isButton2 = ref.node.button === true;
-        if (!isButton2)
+        const isButton = ref.node.button === true;
+        if (!isButton)
           return { ok: false, nodeId: ref.id, affected: [ref.id] };
         return { ok: true, nodeId: ref.id, affected: [ref.id] };
       }
@@ -1850,9 +1879,9 @@ function validateServiceVsUserInput(v) {
   for (const f of v.fields) {
     const anySvc = hasAnyServiceOption(f);
     const hasName = !!(f.name && f.name.trim());
-    const isButton2 = f.button === true;
+    const isButton = f.button === true;
     const hasFieldService = f.service_id !== void 0 && f.service_id !== null;
-    const hasTriggerMap = isButton2 && hasButtonTriggerMap(v, f.id);
+    const hasTriggerMap = isButton && hasButtonTriggerMap(v, f.id);
     if (f.type === "custom" && anySvc) {
       v.errors.push({
         code: "user_input_field_has_service_option",
@@ -1869,7 +1898,7 @@ function validateServiceVsUserInput(v) {
       v.errors.push({
         code: "service_field_missing_service_id",
         severity: "error",
-        message: isButton2 ? `Button field "${f.id}" has no "name", no "service_id", and no includes/excludes trigger map. Add a name, attach a service_id, or configure includes_for_buttons/excludes_for_buttons.` : `Service-backed field "${f.id}" has no "name" and must provide at least one option with a service_id.`,
+        message: isButton ? `Button field "${f.id}" has no "name", no "service_id", and no includes/excludes trigger map. Add a name, attach a service_id, or configure includes_for_buttons/excludes_for_buttons.` : `Service-backed field "${f.id}" has no "name" and must provide at least one option with a service_id.`,
         nodeId: f.id
       });
     } else {
@@ -2188,6 +2217,324 @@ function validateRates(v) {
   }
 }
 
+// src/core/rate-coherence.ts
+function buildTriggerEffectMap(props) {
+  var _a, _b;
+  const map = /* @__PURE__ */ new Map();
+  const ensure = (key) => {
+    let item = map.get(key);
+    if (!item) {
+      item = { includes: /* @__PURE__ */ new Set(), excludes: /* @__PURE__ */ new Set() };
+      map.set(key, item);
+    }
+    return item;
+  };
+  for (const [key, ids] of Object.entries((_a = props.includes_for_buttons) != null ? _a : {})) {
+    const item = ensure(key);
+    for (const id of ids != null ? ids : []) item.includes.add(id);
+  }
+  for (const [key, ids] of Object.entries((_b = props.excludes_for_buttons) != null ? _b : {})) {
+    const item = ensure(key);
+    for (const id of ids != null ? ids : []) item.excludes.add(id);
+  }
+  return map;
+}
+function isRefExcludedBySelectedKeys(ref, selectedKeys, effectMap) {
+  for (const key of selectedKeys) {
+    const effects = effectMap.get(key);
+    if (!effects) continue;
+    if (ref.fieldId && effects.excludes.has(ref.fieldId) || effects.excludes.has(ref.nodeId)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// src/core/validate/steps/rate-coherence.ts
+function normalizeRole(role, fallback) {
+  return role === "base" || role === "utility" ? role : fallback;
+}
+function uniqueStrings(values) {
+  const out = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (!value) continue;
+    out.add(value);
+  }
+  return Array.from(out);
+}
+function getRate(serviceMap, serviceId) {
+  const cap = getServiceCapability(serviceMap, serviceId);
+  const rate = cap == null ? void 0 : cap.rate;
+  if (typeof rate !== "number" || !Number.isFinite(rate)) return void 0;
+  return rate;
+}
+function collectContextRefs(tag, visibleFields, serviceMap) {
+  var _a, _b, _c, _d, _e;
+  const serviceRefs = [];
+  let tagDefault;
+  if (tag.service_id !== void 0 && tag.service_id !== null) {
+    const tagRate = getRate(serviceMap, tag.service_id);
+    if (tagRate != null) {
+      tagDefault = {
+        key: tag.id,
+        nodeId: tag.id,
+        nodeKind: "tag",
+        serviceId: tag.service_id,
+        rate: tagRate,
+        label: (_a = tag.label) != null ? _a : tag.id,
+        pricingRole: "base"
+      };
+    }
+  }
+  for (const field of visibleFields) {
+    const fieldRole = normalizeRole(field.pricing_role, "base");
+    if (field.service_id !== void 0 && field.service_id !== null) {
+      const rate = getRate(serviceMap, field.service_id);
+      if (rate != null) {
+        serviceRefs.push({
+          key: field.id,
+          nodeId: field.id,
+          fieldId: field.id,
+          nodeKind: "button",
+          serviceId: field.service_id,
+          rate,
+          label: (_b = field.label) != null ? _b : field.id,
+          pricingRole: fieldRole
+        });
+      }
+    }
+    for (const option of (_c = field.options) != null ? _c : []) {
+      if (option.service_id === void 0 || option.service_id === null) continue;
+      const rate = getRate(serviceMap, option.service_id);
+      if (rate == null) continue;
+      serviceRefs.push({
+        key: option.id,
+        nodeId: option.id,
+        fieldId: field.id,
+        nodeKind: "option",
+        serviceId: option.service_id,
+        rate,
+        label: (_d = option.label) != null ? _d : option.id,
+        pricingRole: normalizeRole((_e = option.pricing_role) != null ? _e : field.pricing_role, "base")
+      });
+    }
+  }
+  return { tagDefault, serviceRefs };
+}
+function pickHighestRatePrimary(refs) {
+  return refs.reduce((best, cur) => {
+    if (!best) return cur;
+    if (cur.rate > best.rate) return cur;
+    if (cur.rate < best.rate) return best;
+    return cur.nodeId < best.nodeId ? cur : best;
+  }, void 0);
+}
+function validateRateCoherenceForVisibleContext(params) {
+  const { v, tagId, selectedKeys, visibleFieldIds, effectMap, seen } = params;
+  const tag = v.tagById.get(tagId);
+  if (!tag) return;
+  const visibleFields = visibleFieldIds.map((id) => v.fieldById.get(id)).filter(Boolean);
+  const { tagDefault, serviceRefs: allServiceRefs } = collectContextRefs(
+    tag,
+    visibleFields,
+    v.serviceMap
+  );
+  const baseRefs = allServiceRefs.filter((ref) => ref.pricingRole === "base");
+  if (baseRefs.length === 0 && !tagDefault) return;
+  const ratePolicy = normalizeRatePolicy(v.options.ratePolicy);
+  const visibleInvalidFieldIds = visibleFieldIds.filter(
+    (fieldId) => v.invalidRateFieldIds.has(fieldId)
+  );
+  for (const fieldId of visibleInvalidFieldIds) {
+    const internalKey = [
+      "rate-coherence-internal",
+      tagId,
+      [...selectedKeys].sort().join("|"),
+      fieldId
+    ].join("::");
+    if (seen.has(internalKey)) continue;
+    seen.add(internalKey);
+    v.errors.push({
+      code: "rate_coherence_violation",
+      severity: "error",
+      nodeId: fieldId,
+      message: `Field "${fieldId}" is internally invalid under rate policy "${ratePolicy.kind}".`,
+      details: {
+        kind: "internal_field",
+        tagId,
+        selectedKeys: [...selectedKeys],
+        visibleFieldIds: [...visibleFieldIds],
+        fieldId,
+        invalidFieldIds: [fieldId],
+        affectedIds: uniqueStrings([tagId, ...selectedKeys, fieldId])
+      }
+    });
+  }
+  const selectedSet = new Set(selectedKeys);
+  const selectedServiceRefs = baseRefs.filter((ref) => selectedSet.has(ref.key));
+  if (baseRefs.length === 0) return;
+  for (let i = 0; i < baseRefs.length; i++) {
+    for (let j = i + 1; j < baseRefs.length; j++) {
+      const left = baseRefs[i];
+      const right = baseRefs[j];
+      const hypotheticalKeys = [...selectedKeys, left.key, right.key];
+      const survivingRefs = baseRefs.filter(
+        (ref) => !isRefExcludedBySelectedKeys(
+          { fieldId: ref.fieldId, nodeId: ref.nodeId },
+          hypotheticalKeys,
+          effectMap
+        )
+      );
+      const survivingSet = new Set(survivingRefs.map((ref) => ref.nodeId));
+      if (!survivingSet.has(left.nodeId) || !survivingSet.has(right.nodeId)) {
+        continue;
+      }
+      if (survivingRefs.length <= 1) continue;
+      const survivingSelected = survivingRefs.filter(
+        (ref) => selectedSet.has(ref.key)
+      );
+      const tagIsCompeting = survivingSelected.length === 0;
+      const primary = pickHighestRatePrimary(survivingRefs);
+      if (!primary) continue;
+      const comparePool = survivingRefs.filter((ref) => ref.nodeId !== primary.nodeId);
+      for (const candidate of comparePool) {
+        if (passesRatePolicy(ratePolicy, primary.rate, candidate.rate)) continue;
+        const issueKey = [
+          "rate-coherence-context",
+          tagId,
+          [...selectedKeys].sort().join("|"),
+          [...survivingRefs.map((r) => r.nodeId).sort()].join("|"),
+          primary.nodeId,
+          candidate.nodeId,
+          ratePolicy.kind,
+          "pct" in ratePolicy ? String(ratePolicy.pct) : ""
+        ].join("::");
+        if (seen.has(issueKey)) continue;
+        seen.add(issueKey);
+        v.errors.push({
+          code: "rate_coherence_violation",
+          severity: "error",
+          nodeId: candidate.nodeId,
+          message: "Visible service context contains incompatible base service rates.",
+          details: {
+            kind: "selected_context",
+            tagId,
+            selectedKeys: [...selectedKeys],
+            visibleFieldIds: [...visibleFieldIds],
+            primary: {
+              nodeId: primary.nodeId,
+              fieldId: primary.fieldId,
+              service_id: primary.serviceId,
+              serviceId: primary.serviceId,
+              rate: primary.rate
+            },
+            candidate: {
+              nodeId: candidate.nodeId,
+              fieldId: candidate.fieldId,
+              service_id: candidate.serviceId,
+              serviceId: candidate.serviceId,
+              rate: candidate.rate
+            },
+            policy: ratePolicy.kind,
+            policyPct: "pct" in ratePolicy ? ratePolicy.pct : void 0,
+            invalidFieldIds: visibleInvalidFieldIds,
+            affectedIds: uniqueStrings([
+              tagId,
+              ...selectedKeys,
+              primary.nodeId,
+              primary.fieldId,
+              candidate.nodeId,
+              candidate.fieldId,
+              tagIsCompeting ? tagDefault == null ? void 0 : tagDefault.nodeId : void 0
+            ]),
+            affectedServiceIds: uniqueStrings([
+              String(primary.serviceId),
+              String(candidate.serviceId)
+            ])
+          }
+        });
+      }
+    }
+  }
+  if (selectedServiceRefs.length === 0 && tagDefault && baseRefs.length > 0) {
+    const survivingByDefault = baseRefs.filter(
+      (ref) => !isRefExcludedBySelectedKeys(
+        { fieldId: ref.fieldId, nodeId: ref.nodeId },
+        selectedKeys,
+        effectMap
+      )
+    );
+    for (const candidate of survivingByDefault) {
+      if (passesRatePolicy(ratePolicy, tagDefault.rate, candidate.rate)) continue;
+      const issueKey = [
+        "rate-coherence-default",
+        tagId,
+        [...selectedKeys].sort().join("|"),
+        tagDefault.nodeId,
+        candidate.nodeId,
+        ratePolicy.kind,
+        "pct" in ratePolicy ? String(ratePolicy.pct) : ""
+      ].join("::");
+      if (seen.has(issueKey)) continue;
+      seen.add(issueKey);
+      v.errors.push({
+        code: "rate_coherence_violation",
+        severity: "error",
+        nodeId: candidate.nodeId,
+        message: "Visible service context contains incompatible base service rates.",
+        details: {
+          kind: "selected_context",
+          tagId,
+          selectedKeys: [...selectedKeys],
+          visibleFieldIds: [...visibleFieldIds],
+          primary: {
+            nodeId: tagDefault.nodeId,
+            service_id: tagDefault.serviceId,
+            serviceId: tagDefault.serviceId,
+            rate: tagDefault.rate
+          },
+          candidate: {
+            nodeId: candidate.nodeId,
+            fieldId: candidate.fieldId,
+            service_id: candidate.serviceId,
+            serviceId: candidate.serviceId,
+            rate: candidate.rate
+          },
+          policy: ratePolicy.kind,
+          policyPct: "pct" in ratePolicy ? ratePolicy.pct : void 0,
+          invalidFieldIds: visibleInvalidFieldIds,
+          affectedIds: uniqueStrings([
+            tagId,
+            ...selectedKeys,
+            tagDefault.nodeId,
+            candidate.nodeId,
+            candidate.fieldId
+          ]),
+          affectedServiceIds: uniqueStrings([
+            String(tagDefault.serviceId),
+            String(candidate.serviceId)
+          ])
+        }
+      });
+    }
+  }
+}
+function validateRateCoherence(v) {
+  if (Object.keys(v.serviceMap).length === 0 || v.tags.length === 0) return;
+  const effectMap = buildTriggerEffectMap(v.props);
+  const seen = /* @__PURE__ */ new Set();
+  for (const context of v.simulatedVisibilityContexts) {
+    validateRateCoherenceForVisibleContext({
+      v,
+      tagId: context.tagId,
+      selectedKeys: context.selectedKeys,
+      visibleFieldIds: context.visibleFieldIds,
+      effectMap,
+      seen
+    });
+  }
+}
+
 // src/core/validate/steps/constraints.ts
 function constraintKeysInChain(v, tagId) {
   const keys = [];
@@ -2944,6 +3291,84 @@ function mergeValidatorOptions(defaults = {}, overrides = {}) {
   };
 }
 
+// src/core/validate/index.ts
+function readVisibilitySimOpts(ctx) {
+  const c = ctx;
+  const simulate = c.simulateVisibility === true || c.visibilitySimulate === true || c.simulate === true;
+  const maxStates = typeof c.maxVisibilityStates === "number" ? c.maxVisibilityStates : typeof c.visibilityMaxStates === "number" ? c.visibilityMaxStates : typeof c.maxStates === "number" ? c.maxStates : void 0;
+  const maxDepth = typeof c.maxVisibilityDepth === "number" ? c.maxVisibilityDepth : typeof c.visibilityMaxDepth === "number" ? c.visibilityMaxDepth : typeof c.maxDepth === "number" ? c.maxDepth : void 0;
+  const simulateAllRoots = c.simulateAllRoots === true || c.visibilitySimulateAllRoots === true;
+  const onlyEffectfulTriggers = c.onlyEffectfulTriggers === false ? false : c.visibilityOnlyEffectfulTriggers !== false;
+  return {
+    simulate,
+    maxStates,
+    maxDepth,
+    simulateAllRoots,
+    onlyEffectfulTriggers
+  };
+}
+function validate(props, ctx = {}) {
+  var _a, _b, _c;
+  const options = mergeValidatorOptions({}, ctx);
+  const fallbackSettings = resolveFallbackSettings(options);
+  const ratePolicy = resolveGlobalRatePolicy(options);
+  const errors = [];
+  const serviceMap = (_a = options.serviceMap) != null ? _a : {};
+  const selectedKeys = new Set(
+    (_b = options.selectedOptionKeys) != null ? _b : []
+  );
+  const tags = Array.isArray(props.filters) ? props.filters : [];
+  const fields = Array.isArray(props.fields) ? props.fields : [];
+  const tagById = /* @__PURE__ */ new Map();
+  const fieldById = /* @__PURE__ */ new Map();
+  for (const t of tags) tagById.set(t.id, t);
+  for (const f of fields) fieldById.set(f.id, f);
+  const v = {
+    props,
+    nodeMap: (_c = options.nodeMap) != null ? _c : buildNodeMap(props),
+    options: {
+      ...options,
+      ratePolicy,
+      fallbackSettings
+    },
+    errors,
+    serviceMap,
+    selectedKeys,
+    tags,
+    fields,
+    invalidRateFieldIds: /* @__PURE__ */ new Set(),
+    tagById,
+    fieldById,
+    fieldsVisibleUnder: (_tagId) => [],
+    simulatedVisibilityContexts: []
+  };
+  validateStructure(v);
+  validateIdentity(v);
+  validateOptionMaps(v);
+  validateOrderKinds(v);
+  v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
+  const visSim = readVisibilitySimOpts(options);
+  validateVisibility(v, visSim);
+  applyPolicies(
+    v.errors,
+    v.props,
+    v.serviceMap,
+    v.options.policies,
+    v.fieldsVisibleUnder,
+    v.tags
+  );
+  validateServiceVsUserInput(v);
+  validateUtilityMarkers(v);
+  validateRates(v);
+  validateRateCoherence(v);
+  validateConstraints(v);
+  validateCustomFields(v);
+  validateGlobalUtilityGuard(v);
+  validateUnboundFields(v);
+  validateFallbacks(v);
+  return v.errors;
+}
+
 // src/core/builder.ts
 import { cloneDeep as cloneDeep2 } from "lodash-es";
 function createBuilder(opts = {}) {
@@ -3226,344 +3651,6 @@ function toStringSet(v) {
   return new Set(v.map(String));
 }
 
-// src/core/rate-coherence.ts
-function validateRateCoherenceDeep(params) {
-  var _a, _b, _c;
-  const { builder, services, tagId } = params;
-  const ratePolicy = normalizeRatePolicy(params.ratePolicy);
-  const props = builder.getProps();
-  const invalidFieldIds = new Set((_a = params.invalidFieldIds) != null ? _a : []);
-  const fields = (_b = props.fields) != null ? _b : [];
-  const fieldById = new Map(fields.map((f) => [f.id, f]));
-  const tagById = new Map(((_c = props.filters) != null ? _c : []).map((t) => [t.id, t]));
-  const tag = tagById.get(tagId);
-  const baselineFieldIds = builder.visibleFields(tagId, []);
-  const baselineFields = baselineFieldIds.map((fid) => fieldById.get(fid)).filter(Boolean);
-  const anchors = collectAnchors(baselineFields);
-  const diagnostics = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const anchor of anchors) {
-    const selectedKeys = anchor.kind === "option" ? [`${anchor.fieldId}::${anchor.id}`] : [anchor.fieldId];
-    const visibleFields = builder.visibleFields(tagId, selectedKeys).map((fid) => fieldById.get(fid)).filter(Boolean);
-    const visibleInvalidFieldIds = visibleFields.map((field) => field.id).filter((fieldId) => invalidFieldIds.has(fieldId));
-    for (const fieldId of visibleInvalidFieldIds) {
-      const key = `internal|${tagId}|${fieldId}`;
-      if (seen.has(key)) continue;
-      seen.add(key);
-      diagnostics.push({
-        kind: "internal_field",
-        scope: "visible_group",
-        tagId,
-        fieldId,
-        nodeId: fieldId,
-        message: `Field "${fieldId}" is internally invalid under rate policy "${ratePolicy.kind}".`,
-        simulationAnchor: {
-          kind: anchor.kind,
-          id: anchor.id,
-          fieldId: anchor.fieldId,
-          label: anchor.label
-        },
-        invalidFieldIds: [fieldId]
-      });
-    }
-    const references = visibleFields.flatMap(
-      (field) => collectFieldReferences(field, services)
-    );
-    if (references.length <= 1) continue;
-    const primary = references.reduce((best, current) => {
-      if (current.rate !== best.rate) {
-        return current.rate > best.rate ? current : best;
-      }
-      const bestKey = `${best.fieldId}|${best.nodeId}`;
-      const currentKey = `${current.fieldId}|${current.nodeId}`;
-      return currentKey < bestKey ? current : best;
-    });
-    for (const candidate of references) {
-      if (candidate.nodeId === primary.nodeId) continue;
-      if (candidate.fieldId === primary.fieldId) continue;
-      if (passesRatePolicy(ratePolicy, primary.rate, candidate.rate)) {
-        continue;
-      }
-      const key = contextualKey(tagId, primary, candidate, ratePolicy);
-      if (seen.has(key)) continue;
-      seen.add(key);
-      diagnostics.push({
-        kind: "contextual",
-        scope: "visible_group",
-        tagId,
-        nodeId: candidate.nodeId,
-        primary: toDiagnosticRef(primary),
-        offender: toDiagnosticRef(candidate),
-        policy: ratePolicy.kind,
-        policyPct: "pct" in ratePolicy ? ratePolicy.pct : void 0,
-        message: explainRateMismatch(
-          ratePolicy,
-          primary,
-          candidate,
-          describeLabel(tag)
-        ),
-        simulationAnchor: {
-          kind: anchor.kind,
-          id: anchor.id,
-          fieldId: anchor.fieldId,
-          label: anchor.label
-        },
-        invalidFieldIds: visibleInvalidFieldIds
-      });
-    }
-  }
-  return diagnostics;
-}
-function collectAnchors(fields) {
-  var _a, _b;
-  const anchors = [];
-  for (const field of fields) {
-    if (!isButton(field)) continue;
-    if (Array.isArray(field.options) && field.options.length > 0) {
-      for (const option of field.options) {
-        anchors.push({
-          kind: "option",
-          id: option.id,
-          fieldId: field.id,
-          label: (_a = option.label) != null ? _a : option.id
-        });
-      }
-      continue;
-    }
-    anchors.push({
-      kind: "field",
-      id: field.id,
-      fieldId: field.id,
-      label: (_b = field.label) != null ? _b : field.id
-    });
-  }
-  return anchors;
-}
-function collectFieldReferences(field, services) {
-  var _a;
-  const members = collectBaseMembers(field, services);
-  if (members.length === 0) return [];
-  if (isMultiField(field)) {
-    const averageRate = members.reduce((sum, member) => sum + member.rate, 0) / members.length;
-    return [
-      {
-        refKind: "multi",
-        nodeId: field.id,
-        fieldId: field.id,
-        label: (_a = field.label) != null ? _a : field.id,
-        rate: averageRate,
-        members
-      }
-    ];
-  }
-  return members.map((member) => ({
-    refKind: "single",
-    nodeId: member.id,
-    fieldId: field.id,
-    label: member.label,
-    rate: member.rate,
-    service_id: member.service_id,
-    members: [member]
-  }));
-}
-function collectBaseMembers(field, services) {
-  var _a, _b, _c;
-  const members = [];
-  if (Array.isArray(field.options) && field.options.length > 0) {
-    for (const option of field.options) {
-      const role2 = normalizeRole((_a = option.pricing_role) != null ? _a : field.pricing_role, "base");
-      if (role2 !== "base") continue;
-      if (option.service_id === void 0 || option.service_id === null) {
-        continue;
-      }
-      const cap2 = getServiceCapability(services, option.service_id);
-      if (!cap2 || typeof cap2.rate !== "number" || !Number.isFinite(cap2.rate)) {
-        continue;
-      }
-      members.push({
-        kind: "option",
-        id: option.id,
-        fieldId: field.id,
-        label: (_b = option.label) != null ? _b : option.id,
-        service_id: option.service_id,
-        rate: cap2.rate
-      });
-    }
-    return members;
-  }
-  const role = normalizeRole(field.pricing_role, "base");
-  if (role !== "base") return members;
-  if (field.service_id === void 0 || field.service_id === null) return members;
-  const cap = getServiceCapability(services, field.service_id);
-  if (!cap || typeof cap.rate !== "number" || !Number.isFinite(cap.rate)) {
-    return members;
-  }
-  members.push({
-    kind: "field",
-    id: field.id,
-    fieldId: field.id,
-    label: (_c = field.label) != null ? _c : field.id,
-    service_id: field.service_id,
-    rate: cap.rate
-  });
-  return members;
-}
-function isButton(field) {
-  if (field.button === true) return true;
-  return Array.isArray(field.options) && field.options.length > 0;
-}
-function normalizeRole(role, fallback) {
-  return role === "base" || role === "utility" ? role : fallback;
-}
-function toDiagnosticRef(reference) {
-  return {
-    nodeId: reference.nodeId,
-    fieldId: reference.fieldId,
-    label: reference.label,
-    refKind: reference.refKind,
-    service_id: reference.service_id,
-    rate: reference.rate
-  };
-}
-function contextualKey(tagId, primary, candidate, ratePolicy) {
-  const pctKey = "pct" in ratePolicy ? `:${ratePolicy.pct}` : "";
-  return [
-    "contextual",
-    tagId,
-    primary.fieldId,
-    primary.nodeId,
-    candidate.fieldId,
-    candidate.nodeId,
-    `${ratePolicy.kind}${pctKey}`
-  ].join("|");
-}
-function describeLabel(tag) {
-  var _a, _b;
-  return (_b = (_a = tag == null ? void 0 : tag.label) != null ? _a : tag == null ? void 0 : tag.id) != null ? _b : "tag";
-}
-function explainRateMismatch(policy, primary, candidate, where) {
-  var _a, _b;
-  const primaryLabel = `${(_a = primary.label) != null ? _a : primary.nodeId} (${primary.rate})`;
-  const candidateLabel = `${(_b = candidate.label) != null ? _b : candidate.nodeId} (${candidate.rate})`;
-  switch (policy.kind) {
-    case "eq_primary":
-      return `Rate coherence failed (${where}): ${candidateLabel} must exactly match ${primaryLabel}.`;
-    case "lte_primary":
-      return `Rate coherence failed (${where}): ${candidateLabel} must stay within ${policy.pct}% below and never above ${primaryLabel}.`;
-    case "within_pct":
-      return `Rate coherence failed (${where}): ${candidateLabel} must be within ${policy.pct}% of ${primaryLabel}.`;
-    case "at_least_pct_lower":
-      return `Rate coherence failed (${where}): ${candidateLabel} must be at least ${policy.pct}% lower than ${primaryLabel}.`;
-  }
-}
-
-// src/core/validate/index.ts
-function readVisibilitySimOpts(ctx) {
-  const c = ctx;
-  const simulate = c.simulateVisibility === true || c.visibilitySimulate === true || c.simulate === true;
-  const maxStates = typeof c.maxVisibilityStates === "number" ? c.maxVisibilityStates : typeof c.visibilityMaxStates === "number" ? c.visibilityMaxStates : typeof c.maxStates === "number" ? c.maxStates : void 0;
-  const maxDepth = typeof c.maxVisibilityDepth === "number" ? c.maxVisibilityDepth : typeof c.visibilityMaxDepth === "number" ? c.visibilityMaxDepth : typeof c.maxDepth === "number" ? c.maxDepth : void 0;
-  const simulateAllRoots = c.simulateAllRoots === true || c.visibilitySimulateAllRoots === true;
-  const onlyEffectfulTriggers = c.onlyEffectfulTriggers === false ? false : c.visibilityOnlyEffectfulTriggers !== false;
-  return {
-    simulate,
-    maxStates,
-    maxDepth,
-    simulateAllRoots,
-    onlyEffectfulTriggers
-  };
-}
-function validate(props, ctx = {}) {
-  var _a, _b, _c;
-  const options = mergeValidatorOptions({}, ctx);
-  const fallbackSettings = resolveFallbackSettings(options);
-  const ratePolicy = resolveGlobalRatePolicy(options);
-  const errors = [];
-  const serviceMap = (_a = options.serviceMap) != null ? _a : {};
-  const selectedKeys = new Set(
-    (_b = options.selectedOptionKeys) != null ? _b : []
-  );
-  const tags = Array.isArray(props.filters) ? props.filters : [];
-  const fields = Array.isArray(props.fields) ? props.fields : [];
-  const tagById = /* @__PURE__ */ new Map();
-  const fieldById = /* @__PURE__ */ new Map();
-  for (const t of tags) tagById.set(t.id, t);
-  for (const f of fields) fieldById.set(f.id, f);
-  const v = {
-    props,
-    nodeMap: (_c = options.nodeMap) != null ? _c : buildNodeMap(props),
-    options: {
-      ...options,
-      ratePolicy,
-      fallbackSettings
-    },
-    errors,
-    serviceMap,
-    selectedKeys,
-    tags,
-    fields,
-    invalidRateFieldIds: /* @__PURE__ */ new Set(),
-    tagById,
-    fieldById,
-    fieldsVisibleUnder: (_tagId) => []
-  };
-  validateStructure(v);
-  validateIdentity(v);
-  validateOptionMaps(v);
-  validateOrderKinds(v);
-  v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
-  const visSim = readVisibilitySimOpts(options);
-  validateVisibility(v, visSim);
-  applyPolicies(
-    v.errors,
-    v.props,
-    v.serviceMap,
-    v.options.policies,
-    v.fieldsVisibleUnder,
-    v.tags
-  );
-  validateServiceVsUserInput(v);
-  validateUtilityMarkers(v);
-  validateRates(v);
-  if (Object.keys(serviceMap).length > 0 && tags.length > 0) {
-    const builder = createBuilder({ serviceMap });
-    builder.load(props);
-    for (const tag of tags) {
-      const diags = validateRateCoherenceDeep({
-        builder,
-        services: serviceMap,
-        tagId: tag.id,
-        ratePolicy,
-        invalidFieldIds: v.invalidRateFieldIds
-      });
-      for (const diag of diags) {
-        if (diag.kind !== "contextual") continue;
-        errors.push({
-          code: "rate_coherence_violation",
-          severity: "error",
-          message: diag.message,
-          nodeId: diag.nodeId,
-          details: {
-            tagId: diag.tagId,
-            simulationAnchor: diag.simulationAnchor,
-            primary: diag.primary,
-            offender: diag.offender,
-            policy: diag.policy,
-            policyPct: diag.policyPct,
-            invalidFieldIds: diag.invalidFieldIds
-          }
-        });
-      }
-    }
-  }
-  validateConstraints(v);
-  validateCustomFields(v);
-  validateGlobalUtilityGuard(v);
-  validateUnboundFields(v);
-  validateFallbacks(v);
-  return v.errors;
-}
-
 // src/core/fallback.ts
 var DEFAULT_SETTINGS = {
   requireConstraintFit: true,
@@ -4142,9 +4229,9 @@ function createNodeIndex(builder) {
     if (cached) return cached;
     const raw = fieldById.get(id);
     if (!raw) return void 0;
-    const isButton2 = raw.button === true;
-    const includes = isButton2 ? Object.freeze(new Set((_b2 = (_a2 = props.includes_for_buttons) == null ? void 0 : _a2[id]) != null ? _b2 : [])) : emptySet;
-    const excludes = isButton2 ? Object.freeze(new Set((_d2 = (_c2 = props.excludes_for_buttons) == null ? void 0 : _c2[id]) != null ? _d2 : [])) : emptySet;
+    const isButton = raw.button === true;
+    const includes = isButton ? Object.freeze(new Set((_b2 = (_a2 = props.includes_for_buttons) == null ? void 0 : _a2[id]) != null ? _b2 : [])) : emptySet;
+    const excludes = isButton ? Object.freeze(new Set((_d2 = (_c2 = props.excludes_for_buttons) == null ? void 0 : _c2[id]) != null ? _d2 : [])) : emptySet;
     const bindIds = () => {
       const cachedBind = fieldBindIdsCache.get(id);
       if (cachedBind) return cachedBind;
@@ -4181,7 +4268,7 @@ function createNodeIndex(builder) {
         );
       },
       getDescendants(tagId) {
-        return resolveDescendants(id, includes, tagId, !isButton2);
+        return resolveDescendants(id, includes, tagId, !isButton);
       }
     };
     fieldNodeCache.set(id, node);
@@ -4518,23 +4605,20 @@ function compilePolicies(raw) {
 
 // src/core/service-filter.ts
 function filterServicesForVisibleGroup(input, deps) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
   const svcMap = (_c = (_b = (_a = deps.builder).getServiceMap) == null ? void 0 : _b.call(_a)) != null ? _c : {};
   const builderOptions = (_e = (_d = deps.builder).getOptions) == null ? void 0 : _e.call(_d);
   const { context } = input;
   const usedSet = new Set(context.usedServiceIds.map(String));
-  const primary = context.usedServiceIds[0];
   const explicitFallbackSettings = (_f = context.fallbackSettings) != null ? _f : context.fallback;
   const resolvedRatePolicy = normalizeRatePolicy(
     (_h = (_g = context.ratePolicy) != null ? _g : explicitFallbackSettings == null ? void 0 : explicitFallbackSettings.ratePolicy) != null ? _h : builderOptions == null ? void 0 : builderOptions.ratePolicy
   );
-  const fallbackSettingsSource = explicitFallbackSettings != null ? explicitFallbackSettings : builderOptions == null ? void 0 : builderOptions.fallbackSettings;
-  const fb = {
-    ...DEFAULT_FALLBACK_SETTINGS,
-    ...fallbackSettingsSource != null ? fallbackSettingsSource : {},
-    ratePolicy: resolvedRatePolicy
-  };
   const policySource = (_j = (_i = context.policies) != null ? _i : builderOptions == null ? void 0 : builderOptions.policies) != null ? _j : [];
+  const resolvedCustomPrimaryRate = resolveCustomPrimaryRate(
+    context.rateContext,
+    svcMap
+  );
   const visibleServiceIds = context.selectedButtons === void 0 ? void 0 : collectVisibleServiceIds(
     deps.builder,
     context.tagId,
@@ -4561,7 +4645,19 @@ function filterServicesForVisibleGroup(input, deps) {
       cap.id,
       (_k = context.effectiveConstraints) != null ? _k : {}
     );
-    const passesRate2 = primary == null ? true : rateOk(svcMap, id, primary, fb);
+    const passesRate2 = resolvedCustomPrimaryRate != null ? passesRatePolicy(
+      resolvedRatePolicy,
+      resolvedCustomPrimaryRate,
+      toFiniteNumber(cap.rate)
+    ) : candidatePassesRateCoherence(
+      deps.builder,
+      svcMap,
+      context.tagId,
+      (_l = context.selectedButtons) != null ? _l : [],
+      context.usedServiceIds,
+      id,
+      resolvedRatePolicy
+    );
     const polRes = evaluatePoliciesRaw(
       policySource,
       [...context.usedServiceIds, id],
@@ -4593,6 +4689,17 @@ function filterServicesForVisibleGroup(input, deps) {
     diagnostics: lastDiagnostics && lastDiagnostics.length ? lastDiagnostics : void 0
   };
 }
+function resolveCustomPrimaryRate(rateContext, serviceMap) {
+  if (!rateContext || rateContext.mode !== "custom_primary_rate") {
+    return void 0;
+  }
+  if (rateContext.source === "manual") {
+    return toFiniteNumber(rateContext.primaryRate);
+  }
+  if (rateContext.primaryServiceId == null) return void 0;
+  const cap = getServiceCapability(serviceMap, rateContext.primaryServiceId);
+  return toFiniteNumber(cap == null ? void 0 : cap.rate);
+}
 function evaluatePoliciesRaw(raw, serviceIds, svcMap, tagId, visibleServiceIds) {
   const compiled = compilePolicies(raw);
   const evaluated = evaluateServicePolicies(
@@ -4680,7 +4787,9 @@ function collectVisibleServiceIds(builder, tagId, selectedButtons) {
   const fields = (_b = props.fields) != null ? _b : [];
   const tag = tags.find((t) => t.id === tagId);
   if ((tag == null ? void 0 : tag.service_id) != null) out.add(String(tag.service_id));
-  const visibleFieldIds = new Set(builder.visibleFields(tagId, selectedButtons));
+  const visibleFieldIds = new Set(
+    builder.visibleFields(tagId, selectedButtons)
+  );
   for (const field of fields) {
     if (!visibleFieldIds.has(field.id)) continue;
     if (field.service_id != null) {
@@ -4703,8 +4812,7 @@ function matchesRuleFilter(cap, rule, tagId) {
   if (!cap) return false;
   const f = rule.filter;
   if (!f) return true;
-  if (f.tag_id && !toStrSet(f.tag_id).has(String(tagId))) return false;
-  return true;
+  return !(f.tag_id && !toStrSet(f.tag_id).has(String(tagId)));
 }
 function toStrSet(v) {
   const arr = Array.isArray(v) ? v : [v];
@@ -4712,6 +4820,107 @@ function toStrSet(v) {
   for (const x of arr) s.add(String(x));
   return s;
 }
+function candidatePassesRateCoherence(builder, serviceMap, tagId, selectedKeys, usedServiceIds, candidateId, ratePolicy) {
+  var _a, _b, _c, _d;
+  if (usedServiceIds.length === 0) return true;
+  const props = builder.getProps();
+  const baseFields = (_a = props.fields) != null ? _a : [];
+  const candidateFieldId = syntheticServiceFieldId("candidate", candidateId, 0);
+  const syntheticFields = [
+    ...usedServiceIds.map((serviceId, index) => ({
+      id: syntheticServiceFieldId("used", serviceId, index),
+      label: `Used service ${String(serviceId)}`,
+      type: "custom",
+      button: true,
+      service_id: serviceId,
+      pricing_role: "base"
+    })),
+    {
+      id: candidateFieldId,
+      label: `Candidate ${String(candidateId)}`,
+      type: "custom",
+      button: true,
+      service_id: candidateId,
+      pricing_role: "base"
+    }
+  ];
+  const fields = [...baseFields, ...syntheticFields];
+  const visibleFieldIds = [
+    ...builder.visibleFields(tagId, selectedKeys),
+    ...syntheticFields.map((field) => field.id)
+  ];
+  const anchoredFilters = ((_b = props.filters) != null ? _b : []).map(
+    (tag) => tag.id === tagId && usedServiceIds[0] != null ? { ...tag, service_id: usedServiceIds[0] } : tag
+  );
+  const validationProps = {
+    ...props,
+    filters: anchoredFilters,
+    fields
+  };
+  const errors = [];
+  const tags = (_c = validationProps.filters) != null ? _c : [];
+  const fieldById = new Map(fields.map((field) => [field.id, field]));
+  const tagById = new Map(tags.map((tag) => [tag.id, tag]));
+  const v = {
+    props: validationProps,
+    nodeMap: buildNodeMap(validationProps),
+    options: {
+      ...(_d = builder.getOptions) == null ? void 0 : _d.call(builder),
+      serviceMap,
+      ratePolicy
+    },
+    errors,
+    serviceMap,
+    selectedKeys: new Set(selectedKeys),
+    tags,
+    fields,
+    invalidRateFieldIds: /* @__PURE__ */ new Set(),
+    tagById,
+    fieldById,
+    fieldsVisibleUnder: () => [],
+    simulatedVisibilityContexts: []
+  };
+  validateRateCoherenceForVisibleContext({
+    v,
+    tagId,
+    selectedKeys,
+    visibleFieldIds,
+    effectMap: buildTriggerEffectMap(validationProps),
+    seen: /* @__PURE__ */ new Set()
+  });
+  return !errors.some(
+    (error) => rateIssueAffectsCandidate(
+      error,
+      candidateId,
+      candidateFieldId,
+      usedServiceIds[0]
+    )
+  );
+}
+function syntheticServiceFieldId(kind, serviceId, index) {
+  return `__service_filter_${kind}__:${index}:${String(serviceId)}`;
+}
+function rateIssueAffectsCandidate(error, candidateId, candidateFieldId, primaryAnchorId) {
+  var _a, _b, _c, _d;
+  if (error.code !== "rate_coherence_violation") return false;
+  const candidateKey = String(candidateId);
+  const details = (_a = error.details) != null ? _a : {};
+  const anchorKey = primaryAnchorId == null ? void 0 : String(primaryAnchorId);
+  const primaryMatchesAnchor = anchorKey == null || String((_b = details.primary) == null ? void 0 : _b.serviceId) === anchorKey || String((_c = details.primary) == null ? void 0 : _c.service_id) === anchorKey;
+  if (primaryMatchesAnchor && ((_d = details.affectedServiceIds) == null ? void 0 : _d.some(
+    (serviceId) => String(serviceId) === candidateKey
+  ))) {
+    return true;
+  }
+  if (primaryMatchesAnchor && String(error.nodeId) === candidateFieldId) {
+    return true;
+  }
+  return [details.primary, details.candidate].some((ref) => {
+    if (!ref) return false;
+    if (!primaryMatchesAnchor) return false;
+    return String(ref.serviceId) === candidateKey || String(ref.service_id) === candidateKey || String(ref.fieldId) === candidateFieldId || String(ref.nodeId) === candidateFieldId;
+  });
+}
 
 // src/utils/prune-fallbacks.ts
 function pruneInvalidNodeFallbacks(props, services, settings) {
@@ -6442,7 +6651,7 @@ function setService(ctx, id, input) {
         );
       }
       const isOptionBased2 = Array.isArray(f.options) && f.options.length > 0;
-      const isButton2 = !!f.button;
+      const isButton = !!f.button;
       if (nextRole) {
         f.pricing_role = nextRole;
       }
@@ -6458,7 +6667,7 @@ function setService(ctx, id, input) {
         if ("service_id" in f) delete f.service_id;
         return;
       }
-      if (!isButton2) {
+      if (!isButton) {
         if (hasSidKey) {
           ctx.api.emit("error", {
             message: "Only button fields (without options) can have a service_id.",
@@ -7482,7 +7691,8 @@ function filterServicesForVisibleGroup2(ctx, candidates, input) {
       policies: input.policies,
       ratePolicy: input.ratePolicy,
       fallbackSettings: input.fallbackSettings,
-      fallback: input.fallback
+      fallback: input.fallback,
+      rateContext: input.rateContext
     }
   };
   const result = filterServicesForVisibleGroup(coreInput, {